메인 콘텐츠로 건너뛰기
Claude Code는 다음 환경 변수를 지원하여 동작을 제어합니다. claude를 실행하기 전에 셸에서 설정하거나, settings.jsonenv 키 아래에서 구성하여 모든 세션에 적용하거나 팀 전체에 배포할 수 있습니다.
변수목적
ANTHROPIC_API_KEYX-Api-Key 헤더로 전송되는 API 키입니다. 설정하면 로그인되어 있더라도 Claude Pro, Max, Team 또는 Enterprise 구독 대신 이 키가 사용됩니다. 비대화형 모드(-p)에서는 키가 있을 때 항상 사용됩니다. 대화형 모드에서는 키가 구독을 재정의하기 전에 한 번 승인하도록 프롬프트됩니다. 구독을 대신 사용하려면 unset ANTHROPIC_API_KEY를 실행합니다.
ANTHROPIC_AUTH_TOKENAuthorization 헤더의 사용자 정의 값(여기서 설정한 값 앞에 Bearer 가 붙습니다).
ANTHROPIC_BASE_URLAPI 엔드포인트를 재정의하여 프록시 또는 게이트웨이를 통해 요청을 라우팅합니다. 비자사 호스트로 설정하면 MCP 도구 검색이 기본적으로 비활성화됩니다. 프록시가 tool_reference 블록을 전달하면 ENABLE_TOOL_SEARCH=true로 설정합니다.
ANTHROPIC_CUSTOM_HEADERS요청에 추가할 사용자 정의 헤더(Name: Value 형식, 여러 헤더의 경우 줄바꿈으로 구분)
ANTHROPIC_CUSTOM_MODEL_OPTION/model 선택기에 사용자 정의 항목으로 추가할 모델 ID입니다. 기본 제공 별칭을 대체하지 않고 비표준 또는 게이트웨이 특정 모델을 선택 가능하게 만드는 데 사용합니다. 모델 구성 참조
ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION/model 선택기의 사용자 정의 모델 항목에 대한 표시 설명입니다. 설정하지 않으면 Custom model (<model-id>)로 기본값이 설정됩니다.
ANTHROPIC_CUSTOM_MODEL_OPTION_NAME/model 선택기의 사용자 정의 모델 항목에 대한 표시 이름입니다. 설정하지 않으면 모델 ID로 기본값이 설정됩니다.
ANTHROPIC_DEFAULT_HAIKU_MODEL모델 구성 참조
ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION모델 구성 참조
ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME모델 구성 참조
ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES모델 구성 참조
ANTHROPIC_DEFAULT_OPUS_MODEL모델 구성 참조
ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION모델 구성 참조
ANTHROPIC_DEFAULT_OPUS_MODEL_NAME모델 구성 참조
ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES모델 구성 참조
ANTHROPIC_DEFAULT_SONNET_MODEL모델 구성 참조
ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION모델 구성 참조
ANTHROPIC_DEFAULT_SONNET_MODEL_NAME모델 구성 참조
ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES모델 구성 참조
ANTHROPIC_FOUNDRY_API_KEYMicrosoft Foundry 인증용 API 키(Microsoft Foundry 참조)
ANTHROPIC_FOUNDRY_BASE_URLFoundry 리소스의 전체 기본 URL(예: https://my-resource.services.ai.azure.com/anthropic). ANTHROPIC_FOUNDRY_RESOURCE의 대안(Microsoft Foundry 참조)
ANTHROPIC_FOUNDRY_RESOURCEFoundry 리소스 이름(예: my-resource). ANTHROPIC_FOUNDRY_BASE_URL이 설정되지 않은 경우 필수(Microsoft Foundry 참조)
ANTHROPIC_MODEL사용할 모델 설정의 이름(모델 구성 참조)
ANTHROPIC_SMALL_FAST_MODEL[더 이상 사용되지 않음] 백그라운드 작업용 Haiku 클래스 모델의 이름
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGIONBedrock 사용 시 Haiku 클래스 모델의 AWS 리전 재정의
AWS_BEARER_TOKEN_BEDROCK인증용 Bedrock API 키(Bedrock API 키 참조)
BASH_DEFAULT_TIMEOUT_MS장시간 실행되는 bash 명령의 기본 타임아웃
BASH_MAX_OUTPUT_LENGTHbash 출력이 중간 잘림되기 전의 최대 문자 수
BASH_MAX_TIMEOUT_MS모델이 장시간 실행되는 bash 명령에 대해 설정할 수 있는 최대 타임아웃
CLAUDECODEClaude Code가 생성하는 셸 환경(Bash 도구, tmux 세션)에서 1로 설정합니다. 또는 상태 줄 명령에서는 설정되지 않습니다. Claude Code가 생성한 셸 내에서 스크립트가 실행 중인지 감지하는 데 사용합니다.
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE자동 압축이 트리거되는 컨텍스트 용량의 백분율(1-100)을 설정합니다. 기본적으로 자동 압축은 약 95% 용량에서 트리거됩니다. 50과 같은 낮은 값을 사용하여 더 일찍 압축합니다. 기본 임계값보다 높은 값은 효과가 없습니다. 주 대화와 subagent 모두에 적용됩니다. 이 백분율은 상태 줄에서 사용 가능한 context_window.used_percentage 필드와 일치합니다.
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR각 Bash 명령 후 원래 작업 디렉토리로 돌아갑니다.
CLAUDE_CODE_ACCOUNT_UUID인증된 사용자의 계정 UUID입니다. SDK 호출자가 계정 정보를 동기적으로 제공하여 초기 원격 분석 이벤트에 계정 메타데이터가 없는 경합 조건을 방지하는 데 사용됩니다. CLAUDE_CODE_USER_EMAILCLAUDE_CODE_ORGANIZATION_UUID도 설정되어야 합니다.
CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD--add-dir로 지정된 디렉토리에서 CLAUDE.md 파일을 로드하려면 1로 설정합니다. 기본적으로 추가 디렉토리는 메모리 파일을 로드하지 않습니다.
CLAUDE_CODE_AUTO_COMPACT_WINDOW자동 압축 계산에 사용되는 컨텍스트 용량을 토큰 단위로 설정합니다. 기본값은 모델의 컨텍스트 윈도우입니다: 표준 모델의 경우 200K 또는 확장 컨텍스트 모델의 경우 1M입니다. 1M 모델에서 500000과 같은 낮은 값을 사용하여 압축 목적상 윈도우를 500K로 취급합니다. 값은 모델의 실제 컨텍스트 윈도우로 제한됩니다. CLAUDE_AUTOCOMPACT_PCT_OVERRIDE는 이 값의 백분율로 적용됩니다. 이 변수를 설정하면 압축 임계값이 상태 줄의 used_percentage에서 분리되며, 이는 항상 모델의 전체 컨텍스트 윈도우를 사용합니다.
CLAUDE_CODE_API_KEY_HELPER_TTL_MS자격 증명을 새로 고쳐야 하는 간격(밀리초)(apiKeyHelper 사용 시)
CLAUDE_CODE_CLIENT_CERTmTLS 인증용 클라이언트 인증서 파일의 경로
CLAUDE_CODE_CLIENT_KEYmTLS 인증용 클라이언트 개인 키 파일의 경로
CLAUDE_CODE_CLIENT_KEY_PASSPHRASE암호화된 CLAUDE_CODE_CLIENT_KEY의 암호(선택 사항)
CLAUDE_CODE_DISABLE_1M_CONTEXT1M 컨텍스트 윈도우 지원을 비활성화하려면 1로 설정합니다. 설정하면 1M 모델 변형을 모델 선택기에서 사용할 수 없습니다. 규정 준수 요구 사항이 있는 엔터프라이즈 환경에 유용합니다.
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKINGOpus 4.6 및 Sonnet 4.6에 대해 적응형 추론을 비활성화하려면 1로 설정합니다. 비활성화되면 이러한 모델은 MAX_THINKING_TOKENS로 제어되는 고정 사고 예산으로 돌아갑니다.
CLAUDE_CODE_DISABLE_AUTO_MEMORY자동 메모리를 비활성화하려면 1로 설정합니다. 점진적 롤아웃 중에 자동 메모리를 강제로 켜려면 0으로 설정합니다. 비활성화되면 Claude는 자동 메모리 파일을 생성하거나 로드하지 않습니다.
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONSClaude의 시스템 프롬프트에서 기본 제공 커밋 및 PR 워크플로우 지침과 git 상태 스냅샷을 제거하려면 1로 설정합니다. 자신의 git 워크플로우 skill을 사용할 때 유용합니다. 설정하면 includeGitInstructions 설정보다 우선합니다.
CLAUDE_CODE_DISABLE_BACKGROUND_TASKSBash 및 subagent 도구의 run_in_background 매개변수, 자동 백그라운드 처리, Ctrl+B 단축키를 포함한 모든 백그라운드 작업 기능을 비활성화하려면 1로 설정합니다.
CLAUDE_CODE_DISABLE_CRON예약된 작업을 비활성화하려면 1로 설정합니다. /loop skill과 cron 도구를 사용할 수 없게 되고 이미 예약된 모든 작업이 중지되며, 세션 중에 이미 실행 중인 작업을 포함한 모든 작업이 실행되지 않습니다.
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETASAnthropic 특정 anthropic-beta 요청 헤더 및 베타 도구 스키마 필드(defer_loadingeager_input_streaming 등)를 API 요청에서 제거하려면 1로 설정합니다. 프록시 게이트웨이가 “Unexpected value(s) for the anthropic-beta header” 또는 “Extra inputs are not permitted”와 같은 오류로 요청을 거부할 때 사용합니다. 표준 필드(name, description, input_schema, cache_control)는 유지됩니다.
CLAUDE_CODE_DISABLE_FAST_MODE빠른 모드를 비활성화하려면 1로 설정합니다.
CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY”Claude가 어떻게 하고 있나요?” 세션 품질 설문조사를 비활성화하려면 1로 설정합니다. DISABLE_TELEMETRY 또는 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC이 설정되면 설문조사도 비활성화됩니다. 세션 품질 설문조사 참조
CLAUDE_CODE_DISABLE_MOUSE전체 화면 렌더링에서 마우스 추적을 비활성화하려면 1로 설정합니다. PgUpPgDn을 사용한 키보드 스크롤은 계속 작동합니다. 터미널의 기본 선택 시 복사 동작을 유지하려면 이를 사용합니다.
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICDISABLE_AUTOUPDATER, DISABLE_FEEDBACK_COMMAND, DISABLE_ERROR_REPORTING, DISABLE_TELEMETRY 설정과 동일합니다.
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK스트리밍 요청이 중간에 실패할 때 비스트리밍 폴백을 비활성화하려면 1로 설정합니다. 스트리밍 오류는 재시도 계층으로 전파됩니다. 프록시 또는 게이트웨이가 폴백으로 인해 중복 도구 실행을 생성할 때 유용합니다.
CLAUDE_CODE_DISABLE_TERMINAL_TITLE대화 컨텍스트를 기반으로 자동 터미널 제목 업데이트를 비활성화하려면 1로 설정합니다.
CLAUDE_CODE_EFFORT_LEVEL지원되는 모델의 노력 수준을 설정합니다. 값: low, medium, high, max(Opus 4.6 전용) 또는 auto(모델 기본값 사용). /efforteffortLevel 설정보다 우선합니다. 노력 수준 조정 참조
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION프롬프트 제안을 비활성화하려면 false로 설정합니다(/config의 “프롬프트 제안” 토글). 이는 Claude가 응답한 후 프롬프트 입력에 나타나는 회색으로 표시된 예측입니다. 프롬프트 제안 참조
CLAUDE_CODE_ENABLE_TASKS비대화형 모드(-p 플래그)에서 작업 추적 시스템을 활성화하려면 true로 설정합니다. 작업은 대화형 모드에서 기본적으로 켜져 있습니다. 작업 목록 참조
CLAUDE_CODE_ENABLE_TELEMETRY메트릭 및 로깅을 위한 OpenTelemetry 데이터 수집을 활성화하려면 1로 설정합니다. OTel 내보내기를 구성하기 전에 필수입니다. 모니터링 참조
CLAUDE_CODE_EXIT_AFTER_STOP_DELAY쿼리 루프가 유휴 상태가 된 후 자동으로 종료되기 전에 대기할 시간(밀리초). SDK 모드를 사용하는 자동화된 워크플로우 및 스크립트에 유용합니다.
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS에이전트 팀을 활성화하려면 1로 설정합니다. 에이전트 팀은 실험적이며 기본적으로 비활성화됩니다.
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS파일 읽기의 기본 토큰 제한을 재정의합니다. 전체 파일을 읽어야 할 때 유용합니다.
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALLIDE 확장의 자동 설치를 건너뜁니다. autoInstallIdeExtensionfalse로 설정하는 것과 동일합니다.
CLAUDE_CODE_MAX_OUTPUT_TOKENS대부분의 요청에 대한 최대 출력 토큰 수를 설정합니다. 기본값 및 상한은 모델에 따라 다릅니다. 최대 출력 토큰 참조. 이 값을 증가시키면 자동 압축이 트리거되기 전에 사용 가능한 효과적인 컨텍스트 윈도우가 감소합니다.
CLAUDE_CODE_NEW_INIT/init이 대화형 설정 흐름을 실행하도록 하려면 true로 설정합니다. 흐름은 코드베이스를 탐색하고 작성하기 전에 CLAUDE.md, skill 및 훅을 포함하여 생성할 파일을 묻습니다. 이 변수가 없으면 /init은 프롬프트 없이 자동으로 CLAUDE.md를 생성합니다.
CLAUDE_CODE_NO_FLICKER전체 화면 렌더링을 활성화하려면 1로 설정합니다. 이는 깜박임을 줄이고 긴 대화에서 메모리를 평탄하게 유지하는 연구 미리보기입니다.
CLAUDE_CODE_ORGANIZATION_UUID인증된 사용자의 조직 UUID입니다. SDK 호출자가 계정 정보를 동기적으로 제공하는 데 사용됩니다. CLAUDE_CODE_ACCOUNT_UUIDCLAUDE_CODE_USER_EMAIL도 설정되어야 합니다.
CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS동적 OpenTelemetry 헤더를 새로 고치는 간격(밀리초)(기본값: 1740000 / 29분). 동적 헤더 참조
CLAUDE_CODE_PLAN_MODE_REQUIRED에이전트 팀 팀원이 계획 승인을 요구하는 경우 자동으로 true로 설정됩니다. 읽기 전용: Claude Code가 팀원을 생성할 때 설정됩니다. 팀원에 대한 계획 승인 요구 참조
CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS플러그인을 설치하거나 업데이트할 때 git 작업의 타임아웃(밀리초)(기본값: 120000). 큰 리포지토리 또는 느린 네트워크 연결의 경우 이 값을 증가시킵니다. Git 작업 시간 초과 참조
CLAUDE_CODE_PLUGIN_SEED_DIR하나 이상의 읽기 전용 플러그인 시드 디렉토리의 경로이며, Unix에서는 :로, Windows에서는 ;로 구분됩니다. 이를 사용하여 사전 채워진 플러그인 디렉토리를 컨테이너 이미지에 번들로 제공합니다. Claude Code는 시작 시 이러한 디렉토리에서 마켓플레이스를 등록하고 다시 복제하지 않고 사전 캐시된 플러그인을 사용합니다. 컨테이너용 플러그인 사전 채우기 참조
CLAUDE_CODE_PROXY_RESOLVES_HOSTS호출자 대신 프록시가 DNS 해석을 수행하도록 허용하려면 true로 설정합니다. 프록시가 호스트명 해석을 처리해야 하는 환경에 대해 옵트인합니다.
CLAUDE_CODE_SCROLL_SPEED전체 화면 렌더링에서 마우스 휠 스크롤 배수를 설정합니다. 1부터 20까지의 값을 허용합니다. 터미널이 증폭 없이 노치당 하나의 휠 이벤트를 보내는 경우 vim과 일치하도록 3으로 설정합니다.
CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MSSessionEnd 훅이 완료되는 최대 시간(밀리초)(기본값: 1500). 세션 종료, /clear, 대화형 /resume을 통한 세션 전환에 적용됩니다. 훅별 timeout 값도 이 예산으로 제한됩니다.
CLAUDE_CODE_SHELL자동 셸 감지를 재정의합니다. 로그인 셸이 선호하는 작업 셸과 다를 때 유용합니다(예: bash vs zsh).
CLAUDE_CODE_SHELL_PREFIX모든 bash 명령을 래핑할 명령 접두사(예: 로깅 또는 감사용). 예: /path/to/logger.sh/path/to/logger.sh <command>를 실행합니다.
CLAUDE_CODE_SIMPLE최소 시스템 프롬프트 및 Bash, 파일 읽기, 파일 편집 도구만으로 실행하려면 1로 설정합니다. --mcp-config의 MCP 도구는 계속 사용 가능합니다. 훅, skill, 플러그인, MCP 서버, 자동 메모리, CLAUDE.md의 자동 검색을 비활성화합니다. --bare CLI 플래그가 이를 설정합니다.
CLAUDE_CODE_SKIP_BEDROCK_AUTHBedrock에 대한 AWS 인증을 건너뜁니다(예: LLM 게이트웨이를 사용할 때).
CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS조직 상태 확인이 네트워크 오류로 실패할 때 빠른 모드를 허용하려면 1로 설정합니다. 기업 프록시가 상태 엔드포인트를 차단하는 경우에 유용합니다. API는 조직 수준 비활성화를 계속 별도로 적용합니다.
CLAUDE_CODE_SKIP_FOUNDRY_AUTHMicrosoft Foundry에 대한 Azure 인증을 건너뜁니다(예: LLM 게이트웨이를 사용할 때).
CLAUDE_CODE_SKIP_VERTEX_AUTHVertex에 대한 Google 인증을 건너뜁니다(예: LLM 게이트웨이를 사용할 때).
CLAUDE_CODE_SUBAGENT_MODEL모델 구성 참조
CLAUDE_CODE_SUBPROCESS_ENV_SCRUBAnthropic 및 클라우드 공급자 자격 증명을 subprocess 환경(Bash 도구, 훅, MCP stdio 서버)에서 제거하려면 1로 설정합니다. 부모 Claude 프로세스는 API 호출을 위해 이러한 자격 증명을 유지하지만 자식 프로세스는 이를 읽을 수 없으므로 셸 확장을 통해 비밀을 유출하려는 프롬프트 주입 공격에 대한 노출을 줄입니다. allowed_non_write_users가 구성되면 claude-code-action이 자동으로 이를 설정합니다.
CLAUDE_CODE_TASK_LIST_ID세션 간에 작업 목록을 공유합니다. 여러 Claude Code 인스턴스에서 동일한 ID를 설정하여 공유 작업 목록에서 조정합니다. 작업 목록 참조
CLAUDE_CODE_TEAM_NAME이 팀원이 속한 에이전트 팀의 이름입니다. 에이전트 팀 멤버에서 자동으로 설정됩니다.
CLAUDE_CODE_TMPDIR내부 임시 파일에 사용되는 임시 디렉토리를 재정의합니다. Claude Code는 이 경로에 /claude/를 추가합니다. 기본값: Unix/macOS의 경우 /tmp, Windows의 경우 os.tmpdir()
CLAUDE_CODE_USER_EMAIL인증된 사용자의 이메일 주소입니다. SDK 호출자가 계정 정보를 동기적으로 제공하는 데 사용됩니다. CLAUDE_CODE_ACCOUNT_UUIDCLAUDE_CODE_ORGANIZATION_UUID도 설정되어야 합니다.
CLAUDE_CODE_USE_BEDROCKBedrock 사용
CLAUDE_CODE_USE_FOUNDRYMicrosoft Foundry 사용
CLAUDE_CODE_USE_POWERSHELL_TOOLWindows에서 PowerShell 도구를 활성화하려면 1로 설정합니다(옵트인 미리보기). 활성화되면 Claude는 Git Bash를 통해 라우팅하는 대신 PowerShell 명령을 기본적으로 실행할 수 있습니다. 네이티브 Windows에서만 지원되며 WSL에서는 지원되지 않습니다. PowerShell 도구 참조
CLAUDE_CODE_USE_VERTEXVertex 사용
CLAUDE_CONFIG_DIRClaude Code가 구성 및 데이터 파일을 저장하는 위치를 사용자 정의합니다.
CLAUDE_ENV_FILEClaude Code가 각 Bash 명령 전에 소싱하는 셸 스크립트의 경로입니다. virtualenv 또는 conda 활성화를 명령 간에 유지하는 데 사용합니다. SessionStart, CwdChanged, FileChanged 훅으로도 동적으로 채워집니다.
CLAUDE_STREAM_IDLE_TIMEOUT_MS스트리밍 유휴 감시견이 정체된 연결을 닫기 전의 타임아웃(밀리초). 기본값: 90000(90초). 장시간 실행되는 도구 또는 느린 네트워크로 인한 조기 타임아웃 오류가 발생하면 이 값을 증가시킵니다.
DISABLE_AUTOUPDATER자동 업데이트를 비활성화하려면 1로 설정합니다.
DISABLE_COST_WARNINGS비용 경고 메시지를 비활성화하려면 1로 설정합니다.
DISABLE_ERROR_REPORTINGSentry 오류 보고를 거부하려면 1로 설정합니다.
DISABLE_FEEDBACK_COMMAND/feedback 명령을 비활성화하려면 1로 설정합니다. 이전 이름 DISABLE_BUG_COMMAND도 허용됩니다.
DISABLE_INSTALLATION_CHECKS설치 경고를 비활성화하려면 1로 설정합니다. 표준 설치의 문제를 숨길 수 있으므로 설치 위치를 수동으로 관리할 때만 사용합니다.
DISABLE_PROMPT_CACHING모든 모델에 대해 프롬프트 캐싱을 비활성화하려면 1로 설정합니다(모델별 설정보다 우선).
DISABLE_PROMPT_CACHING_HAIKUHaiku 모델에 대해 프롬프트 캐싱을 비활성화하려면 1로 설정합니다.
DISABLE_PROMPT_CACHING_OPUSOpus 모델에 대해 프롬프트 캐싱을 비활성화하려면 1로 설정합니다.
DISABLE_PROMPT_CACHING_SONNETSonnet 모델에 대해 프롬프트 캐싱을 비활성화하려면 1로 설정합니다.
DISABLE_TELEMETRYStatsig 원격 분석을 거부하려면 1로 설정합니다(Statsig 이벤트에는 코드, 파일 경로 또는 bash 명령과 같은 사용자 데이터가 포함되지 않음).
ENABLE_CLAUDEAI_MCP_SERVERSClaude Code에서 claude.ai MCP 서버를 비활성화하려면 false로 설정합니다. 로그인한 사용자의 경우 기본적으로 활성화됩니다.
ENABLE_TOOL_SEARCHMCP 도구 검색을 제어합니다. 설정 해제: 모든 MCP 도구는 기본적으로 연기되지만 ANTHROPIC_BASE_URL이 비자사 호스트를 가리킬 때 미리 로드됩니다. 값: true(프록시 포함 항상 연기), auto(임계값 모드: 도구가 컨텍스트의 10% 이내에 맞으면 미리 로드), auto:N(사용자 정의 임계값, 예: 5%의 경우 auto:5), false(모두 미리 로드)
FORCE_AUTOUPDATE_PLUGINSDISABLE_AUTOUPDATER를 통해 주 자동 업데이터가 비활성화된 경우에도 플러그인 자동 업데이트를 강제하려면 true로 설정합니다.
HTTP_PROXY네트워크 연결을 위한 HTTP 프록시 서버를 지정합니다.
HTTPS_PROXY네트워크 연결을 위한 HTTPS 프록시 서버를 지정합니다.
IS_DEMO데모 모드를 활성화하려면 true로 설정합니다: UI에서 이메일 및 조직을 숨기고, 온보딩을 건너뛰고, 내부 명령을 숨깁니다. 스트리밍 또는 세션 녹화에 유용합니다.
MAX_MCP_OUTPUT_TOKENSMCP 도구 응답에서 허용되는 최대 토큰 수입니다. Claude Code는 출력이 10,000 토큰을 초과할 때 경고를 표시합니다(기본값: 25000).
MAX_THINKING_TOKENS확장 사고 토큰 예산을 재정의합니다. 상한은 모델의 최대 출력 토큰에서 1을 뺀 값입니다. 사고를 완전히 비활성화하려면 0으로 설정합니다. 적응형 추론이 있는 모델(Opus 4.6, Sonnet 4.6)에서는 CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING을 통해 적응형 추론이 비활성화되지 않는 한 예산이 무시됩니다.
MCP_CLIENT_SECRET사전 구성된 자격 증명이 필요한 MCP 서버의 OAuth 클라이언트 시크릿입니다. --client-secret으로 서버를 추가할 때 대화형 프롬프트를 방지합니다.
MCP_OAUTH_CALLBACK_PORT사전 구성된 자격 증명으로 MCP 서버를 추가할 때 --callback-port의 대안으로 OAuth 리디렉션 콜백의 고정 포트입니다.
MCP_TIMEOUTMCP 서버 시작의 타임아웃(밀리초)
MCP_TOOL_TIMEOUTMCP 도구 실행의 타임아웃(밀리초)
NO_PROXY프록시를 우회하여 직접 발급될 요청의 도메인 및 IP 목록
SLASH_COMMAND_TOOL_CHAR_BUDGETSkill 도구에 표시되는 skill 메타데이터의 문자 예산을 재정의합니다. 예산은 컨텍스트 윈도우의 1%에서 동적으로 확장되며, 8,000자의 폴백이 있습니다. 이전 버전과의 호환성을 위해 레거시 이름이 유지됩니다.
USE_BUILTIN_RIPGREPClaude Code에 포함된 rg 대신 시스템 설치 rg를 사용하려면 0으로 설정합니다.
VERTEX_REGION_CLAUDE_3_5_HAIKUVertex AI 사용 시 Claude 3.5 Haiku의 리전을 재정의합니다.
VERTEX_REGION_CLAUDE_3_7_SONNETVertex AI 사용 시 Claude 3.7 Sonnet의 리전을 재정의합니다.
VERTEX_REGION_CLAUDE_4_0_OPUSVertex AI 사용 시 Claude 4.0 Opus의 리전을 재정의합니다.
VERTEX_REGION_CLAUDE_4_0_SONNETVertex AI 사용 시 Claude 4.0 Sonnet의 리전을 재정의합니다.
VERTEX_REGION_CLAUDE_4_1_OPUSVertex AI 사용 시 Claude 4.1 Opus의 리전을 재정의합니다.

참고 항목

  • 설정: 모든 세션에 적용되도록 settings.json에서 환경 변수를 구성합니다.
  • CLI 참조: 실행 시간 플래그
  • 네트워크 구성: 프록시 및 TLS 설정