37. 엔터프라이즈 네트워크 구성
프록시·CA 인증서·mTLS·URL 허용 목록 등 엔터프라이즈 네트워크 설정 가이드
엔터프라이즈 네트워크 구성
프록시 서버, 커스텀 인증 기관(CA), 상호 전송 계층 보안(mTLS) 인증이 있는 엔터프라이즈 환경에서 Claude Code를 구성합니다.
Claude Code는 환경 변수를 통해 다양한 엔터프라이즈 네트워크 및 보안 구성을 지원합니다. 여기에는 기업 프록시 서버를 통한 트래픽 라우팅, 커스텀 인증 기관(CA) 신뢰, 강화된 보안을 위한 상호 전송 계층 보안(mTLS) 인증서 인증이 포함됩니다.
참고: 이 페이지에 표시된 모든 환경 변수는
settings.json에서도 구성할 수 있습니다.
프록시 구성
환경 변수
Claude Code는 표준 프록시 환경 변수를 따릅니다:
# HTTPS proxy (recommended)
export HTTPS_PROXY=https://proxy.example.com:8080
# HTTP proxy (if HTTPS not available)
export HTTP_PROXY=http://proxy.example.com:8080
# Bypass proxy for specific requests - space-separated format
export NO_PROXY="localhost 192.168.1.1 example.com .example.com"
# Bypass proxy for specific requests - comma-separated format
export NO_PROXY="localhost,192.168.1.1,example.com,.example.com"
# Bypass proxy for all requests
export NO_PROXY="*"
참고: Claude Code는 SOCKS 프록시를 지원하지 않습니다.
기본 인증
프록시에 기본 인증이 필요한 경우 프록시 URL에 자격 증명을 포함하세요:
export HTTPS_PROXY=http://username:[email protected]:8080
주의: 스크립트에 비밀번호를 하드코딩하지 마세요. 대신 환경 변수나 안전한 자격 증명 저장소를 사용하세요.
팁: 고급 인증(NTLM, Kerberos 등)이 필요한 프록시의 경우 해당 인증 방식을 지원하는 LLM Gateway 서비스를 사용하는 것을 고려하세요.
커스텀 CA 인증서
엔터프라이즈 환경에서 HTTPS 연결(프록시를 통하든 직접 API 접근이든)에 커스텀 CA를 사용하는 경우 Claude Code가 이를 신뢰하도록 구성하세요:
export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem
mTLS 인증
클라이언트 인증서 인증이 필요한 엔터프라이즈 환경의 경우:
# Client certificate for authentication
export CLAUDE_CODE_CLIENT_CERT=/path/to/client-cert.pem
# Client private key
export CLAUDE_CODE_CLIENT_KEY=/path/to/client-key.pem
# Optional: Passphrase for encrypted private key
export CLAUDE_CODE_CLIENT_KEY_PASSPHRASE="your-passphrase"
네트워크 접근 요구 사항
Claude Code는 다음 URL에 대한 접근이 필요합니다:
api.anthropic.com: Claude API 엔드포인트claude.ai: claude.ai 계정 인증platform.claude.com: Anthropic Console 계정 인증
프록시 구성과 방화벽 규칙에서 이러한 URL이 허용 목록에 포함되어 있는지 확인하세요. 이는 컨테이너화된 환경이나 제한된 네트워크 환경에서 Claude Code를 사용할 때 특히 중요합니다.