Claude Code는 환경 변수를 통해 다양한 엔터프라이즈 네트워크 및 보안 구성을 지원합니다. 여기에는 기업 프록시 서버를 통한 트래픽 라우팅, 사용자 정의 인증 기관(CA) 신뢰, 향상된 보안을 위한 상호 전송 계층 보안(mTLS) 인증서를 통한 인증이 포함됩니다.
이 페이지에 표시된 모든 환경 변수는 settings.json에서도 구성할 수 있습니다.

프록시 구성

환경 변수

Claude Code는 표준 프록시 환경 변수를 준수합니다:
# HTTPS 프록시 (권장)
export HTTPS_PROXY=https://proxy.example.com:8080

# HTTP 프록시 (HTTPS를 사용할 수 없는 경우)
export HTTP_PROXY=http://proxy.example.com:8080

# 특정 요청에 대한 프록시 우회 - 공백으로 구분된 형식
export NO_PROXY="localhost 192.168.1.1 example.com .example.com"
# 특정 요청에 대한 프록시 우회 - 쉼표로 구분된 형식
export NO_PROXY="localhost,192.168.1.1,example.com,.example.com"
# 모든 요청에 대한 프록시 우회
export NO_PROXY="*"
Claude Code는 SOCKS 프록시를 지원하지 않습니다.

기본 인증

프록시에서 기본 인증이 필요한 경우, 프록시 URL에 자격 증명을 포함하세요:
export HTTPS_PROXY=http://username:password@proxy.example.com:8080
스크립트에 비밀번호를 하드코딩하지 마세요. 대신 환경 변수나 보안 자격 증명 저장소를 사용하세요.
고급 인증(NTLM, Kerberos 등)이 필요한 프록시의 경우, 해당 인증 방법을 지원하는 LLM Gateway 서비스 사용을 고려하세요.

사용자 정의 CA 인증서

엔터프라이즈 환경에서 HTTPS 연결(프록시를 통하든 직접 API 액세스를 통하든)에 사용자 정의 CA를 사용하는 경우, Claude Code가 이를 신뢰하도록 구성하세요:
export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem

mTLS 인증

클라이언트 인증서 인증이 필요한 엔터프라이즈 환경의 경우:
# 인증을 위한 클라이언트 인증서
export CLAUDE_CODE_CLIENT_CERT=/path/to/client-cert.pem

# 클라이언트 개인 키
export CLAUDE_CODE_CLIENT_KEY=/path/to/client-key.pem

# 선택사항: 암호화된 개인 키의 암호문
export CLAUDE_CODE_CLIENT_KEY_PASSPHRASE="your-passphrase"

네트워크 액세스 요구사항

Claude Code는 다음 URL에 대한 액세스가 필요합니다:
  • api.anthropic.com - Claude API 엔드포인트
  • claude.ai - WebFetch 보안 장치
  • statsig.anthropic.com - 원격 측정 및 메트릭
  • sentry.io - 오류 보고
프록시 구성 및 방화벽 규칙에서 이러한 URL이 허용 목록에 있는지 확인하세요. 이는 컨테이너화되거나 제한된 네트워크 환경에서 Claude Code를 사용할 때 특히 중요합니다.

추가 리소스