Skip to main content
Claude Code는 환경 변수를 통해 다양한 엔터프라이즈 네트워크 및 보안 구성을 지원합니다. 여기에는 회사 프록시 서버를 통한 트래픽 라우팅, 사용자 정의 인증 기관(CA) 신뢰, 향상된 보안을 위한 상호 전송 계층 보안(mTLS) 인증서를 사용한 인증이 포함됩니다. Claude Code를 시작하기 전에 이러한 환경 변수를 설정합니다. 셸에서 내보낸 변수는 시작 시 한 번만 읽혀지므로, 실행 중인 세션은 나중에 셸 환경에 대한 변경 사항을 선택하지 않습니다.
이 페이지에 표시된 모든 환경 변수는 settings.json에서도 구성할 수 있습니다.

프록시 구성

환경 변수

Claude Code는 표준 프록시 환경 변수를 준수합니다. Claude Desktop 세션에서 앱이 공급자 연결을 관리하는 경우, Claude Code는 관리되는 설정 및 ~/.claude/settings.json에서만 읽습니다. 범위 규칙은 mTLS 인증을 참조하십시오.
소문자 변형도 작동하며, Claude Code는 https_proxy, HTTPS_PROXY, http_proxy, HTTP_PROXY 순서로 설정된 첫 번째 변수를 사용합니다. Claude Code는 localhost, ::1 또는 127.0.0.0/8에 대한 WebSocket 연결을 프록시를 통해 보내지 않으므로 NO_PROXY에 루프백 항목을 추가할 필요가 없습니다.
Claude Code는 SOCKS 프록시를 지원하지 않습니다.

기본 인증

프록시에 기본 인증이 필요한 경우 프록시 URL에 자격 증명을 포함합니다:
스크립트에 암호를 하드코딩하지 마십시오. 대신 환경 변수 또는 보안 자격 증명 저장소를 사용하십시오.
고급 인증(NTLM, Kerberos 등)이 필요한 프록시의 경우 인증 방법을 지원하는 LLM Gateway 서비스 사용을 고려하십시오.

CA 인증서 저장소

기본적으로 Claude Code는 번들로 제공되는 Mozilla CA 인증서와 운영 체제의 인증서 저장소를 모두 신뢰합니다. OS 저장소를 읽으려면 tls.getCACertificates가 있는 런타임이 필요합니다. 네이티브 설치 프로그램은 항상 이를 포함하고 있으며, npm 설치는 Node 22.15 이상이 필요합니다. 이전 Node 버전에서는 번들로 제공되는 세트와 NODE_EXTRA_CA_CERTS만 적용됩니다. 엔터프라이즈 TLS 검사 프록시는 루트 인증서가 OS 신뢰 저장소에 설치되어 있고 런타임이 이를 읽을 수 있을 때 추가 구성 없이 작동합니다. 이러한 프록시가 gzip으로 압축된 요청 본문을 제대로 처리하지 못하는 경우 CLAUDE_CODE_GZIP_REQUEST_BODIES=0을 설정하여 Claude API, 텔레메트리, 아티팩트 게시 요청에 대한 압축을 끄십시오. CLAUDE_CODE_CERT_STORE는 쉼표로 구분된 소스 목록을 허용합니다. 인식되는 값은 Claude Code와 함께 제공되는 Mozilla CA 세트의 경우 bundled, 운영 체제 신뢰 저장소의 경우 system입니다. 기본값은 bundled,system입니다. 번들로 제공되는 Mozilla CA 세트만 신뢰하려면:
OS 인증서 저장소만 신뢰하려면:
CLAUDE_CODE_CERT_STORE에는 전용 settings.json 스키마 키가 없습니다. ~/.claude/settings.json의 env 블록에서 또는 프로세스 환경에서 직접 설정합니다.

사용자 정의 CA 인증서

엔터프라이즈 환경에서 사용자 정의 CA를 사용하는 경우 Claude Code를 구성하여 이를 직접 신뢰하도록 합니다: