배포
기업 프록시 구성
환경 변수 구성, 인증, SSL/TLS 인증서 처리를 포함하여 Claude Code가 기업 프록시 서버와 작동하도록 구성하는 방법을 알아보세요.
Claude Code는 환경 변수를 통한 표준 HTTP/HTTPS 프록시 구성을 지원합니다. 이를 통해 보안, 규정 준수 및 모니터링 목적으로 모든 Claude Code 트래픽을 조직의 프록시 서버를 통해 라우팅할 수 있습니다.
기본 프록시 구성
환경 변수
Claude Code는 표준 프록시 환경 변수를 준수합니다:
Claude Code는 현재 NO_PROXY
환경 변수를 지원하지 않습니다. 모든 트래픽은 구성된 프록시를 통해 라우팅됩니다.
Claude Code는 SOCKS 프록시를 지원하지 않습니다.
인증
기본 인증
프록시에서 기본 인증이 필요한 경우, 프록시 URL에 자격 증명을 포함하세요:
스크립트에 비밀번호를 하드코딩하지 마세요. 대신 환경 변수나 보안 자격 증명 저장소를 사용하세요.
고급 인증(NTLM, Kerberos 등)이 필요한 프록시의 경우, 인증 방법을 지원하는 LLM Gateway 서비스 사용을 고려하세요.
SSL 인증서 문제
프록시에서 사용자 정의 SSL 인증서를 사용하는 경우 인증서 오류가 발생할 수 있습니다.
올바른 인증서 번들 경로를 설정했는지 확인하세요:
네트워크 액세스 요구 사항
Claude Code는 다음 URL에 대한 액세스가 필요합니다:
api.anthropic.com
- Claude API 엔드포인트statsig.anthropic.com
- 텔레메트리 및 메트릭sentry.io
- 오류 보고
프록시 구성 및 방화벽 규칙에서 이러한 URL이 허용 목록에 있는지 확인하세요. 이는 컨테이너화되거나 제한된 네트워크 환경에서 Claude Code를 사용할 때 특히 중요합니다.