환경 변수

Claude Code 동작을 제어하는 환경 변수에 대한 완전한 참조입니다.

Claude Code는 다음 환경 변수를 지원하여 동작을 제어합니다. claude를 실행하기 전에 셸에서 설정하거나, settings.json의 env 키 아래에서 구성하여 모든 세션에 적용하거나 팀 전체에 배포할 수 있습니다.

변수	목적
`ANTHROPIC_API_KEY`	`X-Api-Key` 헤더로 전송되는 API 키입니다. 설정하면 로그인되어 있더라도 Claude Pro, Max, Team 또는 Enterprise 구독 대신 이 키가 사용됩니다. 비대화형 모드(`-p`)에서는 키가 있을 때 항상 사용됩니다. 대화형 모드에서는 키가 구독을 재정의하기 전에 한 번 승인하도록 프롬프트됩니다. 구독을 대신 사용하려면 `unset ANTHROPIC_API_KEY`를 실행합니다.
`ANTHROPIC_AUTH_TOKEN`	`Authorization` 헤더의 사용자 정의 값(여기서 설정한 값 앞에 `Bearer` 가 붙습니다).
`ANTHROPIC_BASE_URL`	API 엔드포인트를 재정의하여 프록시 또는 게이트웨이를 통해 요청을 라우팅합니다. 비자사 호스트로 설정하면 MCP 도구 검색이 기본적으로 비활성화됩니다. 프록시가 `tool_reference` 블록을 전달하면 `ENABLE_TOOL_SEARCH=true`로 설정합니다.
`ANTHROPIC_BEDROCK_BASE_URL`	Bedrock 엔드포인트 URL을 재정의합니다. 사용자 정의 Bedrock 엔드포인트 또는 LLM 게이트웨이를 통해 라우팅할 때 사용합니다. Amazon Bedrock 참조
`ANTHROPIC_BEDROCK_MANTLE_BASE_URL`	Bedrock Mantle 엔드포인트 URL을 재정의합니다. Mantle 엔드포인트 참조
`ANTHROPIC_BEDROCK_SERVICE_TIER`	Bedrock 서비스 계층(`default`, `flex`, 또는 `priority`). `X-Amzn-Bedrock-Service-Tier` 헤더로 전송됩니다. Amazon Bedrock 참조
`ANTHROPIC_BETAS`	API 요청에 포함할 추가 `anthropic-beta` 헤더 값의 쉼표로 구분된 목록입니다. Claude Code는 이미 필요한 베타 헤더를 전송합니다. Claude Code가 기본 지원을 추가하기 전에 Anthropic API 베타에 옵트인하려면 이를 사용합니다. API 키 인증이 필요한 `--betas` 플래그와 달리 이 변수는 Claude.ai 구독을 포함한 모든 인증 방법에서 작동합니다.
`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_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES`	모델 구성 참조
`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_KEY`	Microsoft Foundry 인증용 API 키(Microsoft Foundry 참조)
`ANTHROPIC_FOUNDRY_BASE_URL`	Foundry 리소스의 전체 기본 URL(예: `https://my-resource.services.ai.azure.com/anthropic`). `ANTHROPIC_FOUNDRY_RESOURCE`의 대안(Microsoft Foundry 참조)
`ANTHROPIC_FOUNDRY_RESOURCE`	Foundry 리소스 이름(예: `my-resource`). `ANTHROPIC_FOUNDRY_BASE_URL`이 설정되지 않은 경우 필수(Microsoft Foundry 참조)
`ANTHROPIC_MODEL`	사용할 모델 설정의 이름(모델 구성 참조)
`ANTHROPIC_SMALL_FAST_MODEL`	[더 이상 사용되지 않음] 백그라운드 작업용 Haiku 클래스 모델의 이름
`ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION`	Bedrock 또는 Bedrock Mantle 사용 시 Haiku 클래스 모델의 AWS 리전 재정의
`ANTHROPIC_VERTEX_BASE_URL`	Vertex AI 엔드포인트 URL을 재정의합니다. 사용자 정의 Vertex 엔드포인트 또는 LLM 게이트웨이를 통해 라우팅할 때 사용합니다. Google Vertex AI 참조
`ANTHROPIC_VERTEX_PROJECT_ID`	Vertex AI 요청용 GCP 프로젝트 ID입니다. `GCLOUD_PROJECT`, `GOOGLE_CLOUD_PROJECT` 또는 `GOOGLE_APPLICATION_CREDENTIALS` 자격 증명 파일의 프로젝트로 재정의됩니다. Google Vertex AI 참조
`API_TIMEOUT_MS`	API 요청의 타임아웃(밀리초)(기본값: 600000, 또는 10분; 최대: 2147483647). 느린 네트워크에서 요청이 시간 초과되거나 프록시를 통해 라우팅할 때 이를 증가시킵니다. 최대값을 초과하는 값은 기본 타이머를 오버플로우하여 요청이 즉시 실패하게 합니다.
`AWS_BEARER_TOKEN_BEDROCK`	인증용 Bedrock API 키(Bedrock API 키 참조)
`BASH_DEFAULT_TIMEOUT_MS`	장시간 실행되는 bash 명령의 기본 타임아웃(기본값: 120000, 또는 2분)
`BASH_MAX_OUTPUT_LENGTH`	bash 출력이 중간 잘림되기 전의 최대 문자 수
`BASH_MAX_TIMEOUT_MS`	모델이 장시간 실행되는 bash 명령에 대해 설정할 수 있는 최대 타임아웃(기본값: 600000, 또는 10분)
`CCR_FORCE_BUNDLE`	GitHub 액세스가 가능한 경우에도 `claude --remote`가 로컬 리포지토리를 번들로 제공하고 업로드하도록 강제하려면 `1`로 설정합니다.
`CLAUDECODE`	Claude Code가 생성하는 셸 환경(Bash 도구, tmux 세션)에서 `1`로 설정합니다. 훅 또는 상태 줄 명령에서는 설정되지 않습니다. Claude Code가 생성한 셸 내에서 스크립트가 실행 중인지 감지하는 데 사용합니다.
`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`	모든 기본 제공 subagent 유형(예: Explore 및 Plan)을 비활성화하려면 `1`로 설정합니다. 비대화형 모드(`-p` 플래그)에만 적용됩니다. SDK 사용자가 백지 상태를 원할 때 유용합니다.
`CLAUDE_AGENT_SDK_MCP_NO_PREFIX`	SDK에서 생성한 MCP 서버의 도구 이름에서 `mcp__<server>__` 접두사를 건너뛰려면 `1`로 설정합니다. 도구는 원래 이름을 사용합니다. SDK 사용만 해당
`CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`	백그라운드 subagent의 정체 타임아웃(밀리초). 기본값 `600000`(10분). 타이머는 각 스트리밍 진행 이벤트에서 재설정됩니다. 윈도우 내에 진행이 도착하지 않으면 subagent가 중단되고 작업이 실패로 표시되며 부분 결과가 부모에게 표시됩니다.
`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`	자동 압축이 트리거되는 컨텍스트 용량의 백분율(1-100)을 설정합니다. 기본적으로 자동 압축은 약 95% 용량에서 트리거됩니다. `50`과 같은 낮은 값을 사용하여 더 일찍 압축합니다. 기본 임계값보다 높은 값은 효과가 없습니다. 주 대화와 subagent 모두에 적용됩니다. 이 백분율은 상태 줄에서 사용 가능한 `context_window.used_percentage` 필드와 일치합니다.
`CLAUDE_AUTO_BACKGROUND_TASKS`	장시간 실행되는 에이전트 작업의 자동 백그라운드 처리를 강제로 활성화하려면 `1`로 설정합니다. 활성화되면 subagent는 약 2분 동안 실행한 후 백그라운드로 이동합니다.
`CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR`	주 세션에서 각 Bash 또는 PowerShell 명령 후 원래 작업 디렉토리로 돌아갑니다.
`CLAUDE_CODE_ACCESSIBILITY`	기본 터미널 커서를 표시하고 반전된 텍스트 커서 표시기를 비활성화하려면 `1`로 설정합니다. macOS Zoom과 같은 화면 확대기가 커서 위치를 추적할 수 있습니다.
`CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD`	`--add-dir`로 지정된 디렉토리에서 메모리 파일을 로드하려면 `1`로 설정합니다. `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md`, `CLAUDE.local.md`를 로드합니다. 기본적으로 추가 디렉토리는 메모리 파일을 로드하지 않습니다.
`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`	자격 증명을 새로 고쳐야 하는 간격(밀리초)(`apiKeyHelper` 사용 시)
`CLAUDE_CODE_ATTRIBUTION_HEADER`	시스템 프롬프트의 시작 부분에서 속성 블록(클라이언트 버전 및 프롬프트 지문)을 생략하려면 `0`으로 설정합니다. 비활성화하면 LLM 게이트웨이를 통해 라우팅할 때 프롬프트 캐시 히트율이 향상됩니다. Anthropic API 캐싱은 영향을 받지 않습니다.
`CLAUDE_CODE_AUTO_COMPACT_WINDOW`	자동 압축 계산에 사용되는 컨텍스트 용량을 토큰 단위로 설정합니다. 기본값은 모델의 컨텍스트 윈도우입니다: 표준 모델의 경우 200K 또는 확장 컨텍스트 모델의 경우 1M입니다. 1M 모델에서 `500000`과 같은 낮은 값을 사용하여 압축 목적상 윈도우를 500K로 취급합니다. 값은 모델의 실제 컨텍스트 윈도우로 제한됩니다. `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`는 이 값의 백분율로 적용됩니다. 이 변수를 설정하면 압축 임계값이 상태 줄의 `used_percentage`에서 분리되며, 이는 항상 모델의 전체 컨텍스트 윈도우를 사용합니다.
`CLAUDE_CODE_AUTO_CONNECT_IDE`	자동 IDE 연결을 재정의합니다. 기본적으로 Claude Code는 지원되는 IDE의 통합 터미널 내에서 실행될 때 자동으로 연결됩니다. 이를 방지하려면 `false`로 설정합니다. tmux가 부모 터미널을 가리는 경우와 같이 자동 감지가 실패할 때 연결을 강제하려면 `true`로 설정합니다. `autoConnectIde` 전역 구성 설정보다 우선합니다.
`CLAUDE_CODE_CERT_STORE`	TLS 연결을 위한 CA 인증서 소스의 쉼표로 구분된 목록입니다. `bundled`는 Claude Code와 함께 제공되는 Mozilla CA 세트입니다. `system`은 운영 체제 신뢰 저장소입니다. 기본값은 `bundled,system`입니다.
`CLAUDE_CODE_CLIENT_CERT`	mTLS 인증용 클라이언트 인증서 파일의 경로
`CLAUDE_CODE_CLIENT_KEY`	mTLS 인증용 클라이언트 개인 키 파일의 경로
`CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`	암호화된 CLAUDE_CODE_CLIENT_KEY의 암호(선택 사항)
`CLAUDE_CODE_DEBUG_LOGS_DIR`	디버그 로그 파일 경로를 재정의합니다. 이름과 달리 이는 디렉토리가 아닌 파일 경로입니다. 디버그 모드를 `--debug` 또는 `/debug`를 통해 별도로 활성화해야 합니다. 이 변수만 설정해도 로깅이 활성화되지 않습니다. `--debug-file` 플래그는 둘 다 한 번에 수행합니다. 기본값은 `~/.claude/debug/<session-id>.txt`입니다.
`CLAUDE_CODE_DEBUG_LOG_LEVEL`	디버그 로그 파일에 기록되는 최소 로그 수준입니다. 값: `verbose`, `debug`(기본값), `info`, `warn`, `error`. 전체 상태 줄 명령 출력과 같은 대용량 진단을 포함하려면 `verbose`로 설정하거나, 노이즈를 줄이려면 `error`로 올립니다.
`CLAUDE_CODE_DISABLE_1M_CONTEXT`	1M 컨텍스트 윈도우 지원을 비활성화하려면 `1`로 설정합니다. 설정하면 1M 모델 변형을 모델 선택기에서 사용할 수 없습니다. 규정 준수 요구 사항이 있는 엔터프라이즈 환경에 유용합니다.
`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`	Opus 4.6 및 Sonnet 4.6에 대해 적응형 추론을 비활성화하려면 `1`로 설정합니다. `MAX_THINKING_TOKENS`로 제어되는 고정 사고 예산으로 돌아갑니다. Opus 4.7에는 효과가 없으며, 항상 적응형 추론을 사용합니다.
`CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN`	전체 화면 렌더링을 비활성화하려면 `1`로 설정합니다. 대화가 터미널의 기본 스크롤백에 남아 있으므로 `Cmd+f` 및 tmux 복사 모드가 평소처럼 작동합니다. `CLAUDE_CODE_NO_FLICKER` 및 `tui` 설정보다 우선합니다. `/tui default`로도 전환할 수 있습니다.
`CLAUDE_CODE_DISABLE_ATTACHMENTS`	첨부 파일 처리를 비활성화하려면 `1`로 설정합니다. `@` 구문이 있는 파일 언급은 파일 내용으로 확장되지 않고 일반 텍스트로 전송됩니다.
`CLAUDE_CODE_DISABLE_AUTO_MEMORY`	자동 메모리를 비활성화하려면 `1`로 설정합니다. `0`으로 설정하여 `--bare` 모드 또는 `autoMemoryEnabled: false`가 그렇지 않으면 비활성화할 때에도 자동 메모리를 강제로 켭니다. 비활성화되면 Claude는 자동 메모리 파일을 생성하거나 로드하지 않습니다.
`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`	Bash 및 subagent 도구의 `run_in_background` 매개변수, 자동 백그라운드 처리, Ctrl+B 단축키를 포함한 모든 백그라운드 작업 기능을 비활성화하려면 `1`로 설정합니다.
`CLAUDE_CODE_DISABLE_CLAUDE_MDS`	사용자, 프로젝트, 자동 메모리 파일을 포함한 모든 CLAUDE.md 메모리 파일을 컨텍스트에 로드하지 않으려면 `1`로 설정합니다.
`CLAUDE_CODE_DISABLE_CRON`	예약된 작업을 비활성화하려면 `1`로 설정합니다. `/loop` skill과 cron 도구를 사용할 수 없게 되고 이미 예약된 모든 작업이 중지되며, 세션 중에 이미 실행 중인 작업을 포함한 모든 작업이 실행되지 않습니다.
`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`	Anthropic 특정 `anthropic-beta` 요청 헤더 및 베타 도구 스키마 필드(`defer_loading` 및 `eager_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`이 설정되면 설문조사도 비활성화됩니다. 설문조사 샘플 레이트를 설정하려면 `feedbackSurveyRate` 설정을 사용합니다. 세션 품질 설문조사 참조
`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`	파일 체크포인팅을 비활성화하려면 `1`로 설정합니다. `/rewind` 명령이 코드 변경 사항을 복원할 수 없습니다.
`CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS`	Claude의 시스템 프롬프트에서 기본 제공 커밋 및 PR 워크플로우 지침과 git 상태 스냅샷을 제거하려면 `1`로 설정합니다. 자신의 git 워크플로우 skill을 사용할 때 유용합니다. 설정하면 `includeGitInstructions` 설정보다 우선합니다.
`CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP`	Anthropic API에서 Opus 4.0 및 4.1을 현재 Opus 버전으로 자동 재매핑하지 않으려면 `1`로 설정합니다. 의도적으로 이전 모델을 고정하려는 경우 사용합니다. 재매핑은 Bedrock, Vertex 또는 Foundry에서 실행되지 않습니다.
`CLAUDE_CODE_DISABLE_MOUSE`	전체 화면 렌더링에서 마우스 추적을 비활성화하려면 `1`로 설정합니다. `PgUp` 및 `PgDn`을 사용한 키보드 스크롤은 계속 작동합니다. 터미널의 기본 선택 시 복사 동작을 유지하려면 이를 사용합니다.
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	`DISABLE_AUTOUPDATER`, `DISABLE_FEEDBACK_COMMAND`, `DISABLE_ERROR_REPORTING`, `DISABLE_TELEMETRY` 설정과 동일합니다.
`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK`	스트리밍 요청이 중간에 실패할 때 비스트리밍 폴백을 비활성화하려면 `1`로 설정합니다. 스트리밍 오류는 재시도 계층으로 전파됩니다. 프록시 또는 게이트웨이가 폴백으로 인해 중복 도구 실행을 생성할 때 유용합니다.
`CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`	첫 실행 시 공식 플러그인 마켓플레이스의 자동 추가를 건너뛰려면 `1`로 설정합니다.
`CLAUDE_CODE_DISABLE_POLICY_SKILLS`	시스템 전체 관리 skill 디렉토리에서 skill을 로드하지 않으려면 `1`로 설정합니다. 운영자가 프로비저닝한 skill을 로드하지 않아야 하는 컨테이너 또는 CI 세션에 유용합니다.
`CLAUDE_CODE_DISABLE_TERMINAL_TITLE`	대화 컨텍스트를 기반으로 자동 터미널 제목 업데이트를 비활성화하려면 `1`로 설정합니다.
`CLAUDE_CODE_DISABLE_THINKING`	모델 지원 또는 기타 설정과 관계없이 확장 사고를 강제로 비활성화하려면 `1`로 설정합니다. `MAX_THINKING_TOKENS=0`보다 더 직접적입니다.
`CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL`	전체 화면 렌더링에서 가상 스크롤을 비활성화하려면 `1`로 설정합니다. 전체 화면 모드에서 스크롤이 메시지가 나타나야 할 위치에 빈 영역을 표시하면 이를 사용합니다.
`CLAUDE_CODE_EFFORT_LEVEL`	지원되는 모델의 노력 수준을 설정합니다. 값: `low`, `medium`, `high`, `xhigh`, `max`, 또는 `auto`(모델 기본값 사용). 사용 가능한 수준은 모델에 따라 다릅니다. `/effort` 및 `effortLevel` 설정보다 우선합니다. 노력 수준 조정 참조
`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`	세션 요약 가용성을 재정의합니다. 재개를 강제로 끄려면 `0`으로 설정합니다. `awaySummaryEnabled`가 `false`일 때 재개를 강제로 켜려면 `1`로 설정합니다. 설정 및 `/config` 토글보다 우선합니다.
`CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH`	비대화형 모드에서 백그라운드 설치가 완료된 후 턴 경계에서 플러그인 상태를 새로 고치려면 `1`로 설정합니다. 새로 고침이 세션 중간에 시스템 프롬프트를 변경하여 해당 턴의 프롬프트 캐싱을 무효화하므로 기본적으로 꺼져 있습니다.
`CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING`	도구 호출 입력이 Claude가 생성할 때 API에서 스트리밍되는지 여부를 제어합니다. 이 없으면 파일 쓰기와 같은 큰 도구 입력이 Claude가 생성을 완료한 후에만 도착하므로 중단된 것처럼 보일 수 있습니다. Anthropic API에 대해 기본적으로 활성화됩니다. Bedrock 및 Vertex에서는 배포된 컨테이너가 지원하는 모델별로 활성화됩니다. 옵트아웃하려면 `0`으로 설정합니다. `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` 또는 `ANTHROPIC_BEDROCK_BASE_URL`을 통해 프록시로 라우팅할 때 강제로 활성화하려면 `1`로 설정합니다. Foundry 및 게이트웨이 연결에는 기본적으로 꺼져 있습니다.
`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY`	`ANTHROPIC_BASE_URL`이 LiteLLM, Kong 또는 내부 프록시와 같은 Anthropic 호환 게이트웨이를 가리킬 때 게이트웨이의 `/v1/models` 엔드포인트에서 `/model` 선택기를 채우려면 `1`로 설정합니다. 공유 API 키로 지원되는 게이트웨이는 그렇지 않으면 모든 사용자에게 키가 액세스할 수 있는 모든 모델을 표시하므로 기본적으로 꺼져 있습니다. 검색된 모델은 여전히 `availableModels` 허용 목록으로 필터링됩니다.
`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`	프롬프트 제안을 비활성화하려면 `false`로 설정합니다(`/config`의 "프롬프트 제안" 토글). 이는 Claude가 응답한 후 프롬프트 입력에 나타나는 회색으로 표시된 예측입니다. 프롬프트 제안 참조
`CLAUDE_CODE_ENABLE_TASKS`	비대화형 모드(`-p` 플래그)에서 작업 추적 시스템을 활성화하려면 `1`로 설정합니다. 작업은 대화형 모드에서 기본적으로 켜져 있습니다. 작업 목록 참조
`CLAUDE_CODE_ENABLE_TELEMETRY`	메트릭 및 로깅을 위한 OpenTelemetry 데이터 수집을 활성화하려면 `1`로 설정합니다. OTel 내보내기를 구성하기 전에 필수입니다. 모니터링 참조
`CLAUDE_CODE_EXIT_AFTER_STOP_DELAY`	쿼리 루프가 유휴 상태가 된 후 자동으로 종료되기 전에 대기할 시간(밀리초). SDK 모드를 사용하는 자동화된 워크플로우 및 스크립트에 유용합니다.
`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS`	에이전트 팀을 활성화하려면 `1`로 설정합니다. 에이전트 팀은 실험적이며 기본적으로 비활성화됩니다.
`CLAUDE_CODE_EXTRA_BODY`	모든 API 요청 본문의 최상위 수준으로 병합할 JSON 객체입니다. Claude Code가 직접 노출하지 않는 공급자 특정 매개변수를 전달하는 데 유용합니다.
`CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS`	파일 읽기의 기본 토큰 제한을 재정의합니다. 전체 파일을 읽어야 할 때 유용합니다.
`CLAUDE_CODE_FORCE_SYNC_OUTPUT`	터미널이 지원하지만 자동 감지되지 않을 때 DEC 개인 모드 2026 동기화된 출력을 강제로 활성화하려면 `1`로 설정합니다. Emacs `eat`과 같은 BSU/ESU를 구현하지만 기능 프로브에 응답하지 않는 에뮬레이터에 유용합니다. tmux에서는 효과가 없습니다.
`CLAUDE_CODE_FORK_SUBAGENT`	포크된 subagent를 활성화하려면 `1`로 설정합니다. 포크된 subagent는 새로 시작하는 대신 주 세션에서 전체 대화 컨텍스트를 상속합니다. 활성화되면 `/fork`는 `/branch`의 별칭으로 작동하는 대신 포크된 subagent를 생성하며, 모든 subagent 생성은 백그라운드에서 실행됩니다. 대화형 모드와 SDK 또는 `claude -p`를 통해 작동합니다.
`CLAUDE_CODE_GIT_BASH_PATH`	Windows 전용: Git Bash 실행 파일(`bash.exe`)의 경로입니다. Git Bash가 설치되었지만 PATH에 없을 때 사용합니다. Windows 설정 참조
`CLAUDE_CODE_GLOB_HIDDEN`	Claude가 Glob 도구를 호출할 때 결과에서 dotfile을 제외하려면 `false`로 설정합니다. 기본적으로 포함됩니다. `@` 파일 자동 완성, `ls`, Grep 또는 Read에는 영향을 주지 않습니다.
`CLAUDE_CODE_GLOB_NO_IGNORE`	Glob 도구가 `.gitignore` 패턴을 존중하도록 하려면 `false`로 설정합니다. 기본적으로 Glob은 gitignored된 파일을 포함한 모든 일치하는 파일을 반환합니다. `@` 파일 자동 완성에는 영향을 주지 않으며, 이는 자체 `respectGitignore` 설정을 가집니다.
`CLAUDE_CODE_GLOB_TIMEOUT_SECONDS`	Glob 도구 파일 검색의 타임아웃(초). 대부분의 플랫폼에서 기본값은 20초이고 WSL에서는 60초입니다.
`CLAUDE_CODE_HIDE_CWD`	시작 로고에서 작업 디렉토리를 숨기려면 `1`로 설정합니다. 경로가 OS 사용자명을 노출하는 화면 공유 또는 녹화에 유용합니다.
`CLAUDE_CODE_IDE_HOST_OVERRIDE`	IDE 확장에 연결하는 데 사용되는 호스트 주소를 재정의합니다. 기본적으로 Claude Code는 WSL-to-Windows 라우팅을 포함한 올바른 주소를 자동 감지합니다.
`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`	IDE 확장의 자동 설치를 건너뜁니다. `autoInstallIdeExtension`을 `false`로 설정하는 것과 동일합니다.
`CLAUDE_CODE_IDE_SKIP_VALID_CHECK`	연결 중 IDE 잠금 파일 항목의 유효성 검사를 건너뛰려면 `1`로 설정합니다. 자동 연결이 실행 중인 IDE를 찾지 못할 때 사용합니다.
`CLAUDE_CODE_MAX_CONTEXT_TOKENS`	Claude Code가 활성 모델에 대해 가정하는 컨텍스트 윈도우 크기를 재정의합니다. `DISABLE_COMPACT`도 설정되어 있을 때만 적용됩니다. `ANTHROPIC_BASE_URL`을 통해 이름의 기본 제공 크기와 일치하지 않는 컨텍스트 윈도우를 가진 모델로 라우팅할 때 사용합니다.
`CLAUDE_CODE_MAX_OUTPUT_TOKENS`	대부분의 요청에 대한 최대 출력 토큰 수를 설정합니다. 기본값 및 상한은 모델에 따라 다릅니다. 최대 출력 토큰 참조. 이 값을 증가시키면 자동 압축이 트리거되기 전에 사용 가능한 효과적인 컨텍스트 윈도우가 감소합니다.
`CLAUDE_CODE_MAX_RETRIES`	실패한 API 요청을 재시도할 횟수를 재정의합니다(기본값: 10)
`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`	병렬로 실행할 수 있는 읽기 전용 도구 및 subagent의 최대 수(기본값: 10). 더 높은 값은 병렬 처리를 증가시키지만 더 많은 리소스를 소비합니다.
`CLAUDE_CODE_MCP_ALLOWLIST_ENV`	stdio MCP 서버를 안전한 기본 환경과 서버의 구성된 `env`만으로 생성하려면 `1`로 설정합니다. 셸 환경을 상속하지 않습니다.
`CLAUDE_CODE_NEW_INIT`	`/init`이 대화형 설정 흐름을 실행하도록 하려면 `1`로 설정합니다. 흐름은 코드베이스를 탐색하고 작성하기 전에 CLAUDE.md, skill 및 훅을 포함하여 생성할 파일을 묻습니다. 이 변수가 없으면 `/init`은 프롬프트 없이 자동으로 CLAUDE.md를 생성합니다.
`CLAUDE_CODE_NO_FLICKER`	전체 화면 렌더링을 활성화하려면 `1`로 설정합니다. 이는 깜박임을 줄이고 긴 대화에서 메모리를 평탄하게 유지하는 연구 미리보기입니다. `tui` 설정과 동일합니다. `/tui fullscreen`으로도 전환할 수 있습니다.
`CLAUDE_CODE_OAUTH_REFRESH_TOKEN`	Claude.ai 인증용 OAuth 새로 고침 토큰입니다. 설정하면 `claude auth login`이 브라우저를 열지 않고 이 토큰을 직접 교환합니다. `CLAUDE_CODE_OAUTH_SCOPES`가 필요합니다. 자동화된 환경에서 인증을 프로비저닝하는 데 유용합니다.
`CLAUDE_CODE_OAUTH_SCOPES`	새로 고침 토큰이 발급된 공백으로 구분된 OAuth 범위(예: `"user:profile user:inference user:sessions:claude_code"`). `CLAUDE_CODE_OAUTH_REFRESH_TOKEN`이 설정되면 필수입니다.
`CLAUDE_CODE_OAUTH_TOKEN`	Claude.ai 인증용 OAuth 액세스 토큰입니다. `/login`의 대안으로 SDK 및 자동화된 환경에 사용됩니다. 키체인 저장 자격 증명보다 우선합니다. `claude setup-token`으로 생성합니다.
`CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS`	보류 중인 OpenTelemetry 스팬을 플러시하는 타임아웃(밀리초)(기본값: 5000). 모니터링 참조
`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`	동적 OpenTelemetry 헤더를 새로 고치는 간격(밀리초)(기본값: 1740000 / 29분). 동적 헤더 참조
`CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS`	종료 시 OpenTelemetry 내보내기가 완료되는 타임아웃(밀리초)(기본값: 2000). 메트릭이 종료 시 삭제되면 증가시킵니다. 모니터링 참조
`CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE`	새 버전을 사용할 수 있을 때 Claude Code가 백그라운드에서 패키지 관리자의 업그레이드 명령을 실행하도록 하려면 `1`로 설정합니다. Homebrew 및 WinGet 설치에 적용됩니다. 다른 패키지 관리자는 업그레이드 명령을 실행하지 않고 계속 표시합니다. 자동 업데이트 참조
`CLAUDE_CODE_PERFORCE_MODE`	Perforce 인식 쓰기 보호를 활성화하려면 `1`로 설정합니다. 설정하면 대상 파일이 소유자 쓰기 비트가 없으면 Edit, Write, NotebookEdit이 `p4 edit <file>` 힌트와 함께 실패합니다. Perforce는 `p4 edit`이 파일을 열 때까지 동기화된 파일에서 이를 지웁니다. 이는 Claude Code가 Perforce 변경 추적을 우회하지 않도록 방지합니다.
`CLAUDE_CODE_PLUGIN_CACHE_DIR`	플러그인 루트 디렉토리를 재정의합니다. 이름과 달리 이는 캐시 자체가 아닌 부모 디렉토리를 설정합니다: 마켓플레이스 및 플러그인 캐시는 이 경로 아래의 하위 디렉토리에 있습니다. 기본값은 `~/.claude/plugins`입니다.
`CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS`	플러그인을 설치하거나 업데이트할 때 git 작업의 타임아웃(밀리초)(기본값: 120000). 큰 리포지토리 또는 느린 네트워크 연결의 경우 이 값을 증가시킵니다. Git 작업 시간 초과 참조
`CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE`	`git pull`이 실패할 때 기존 마켓플레이스 캐시를 유지하려면 `1`로 설정합니다. 다시 복제하면 같은 방식으로 실패할 오프라인 또는 에어갭 환경에서 유용합니다. 오프라인 환경에서 마켓플레이스 업데이트 실패 참조
`CLAUDE_CODE_PLUGIN_SEED_DIR`	하나 이상의 읽기 전용 플러그인 시드 디렉토리의 경로이며, Unix에서는 `:`로, Windows에서는 `;`로 구분됩니다. 이를 사용하여 사전 채워진 플러그인 디렉토리를 컨테이너 이미지에 번들로 제공합니다. Claude Code는 시작 시 이러한 디렉토리에서 마켓플레이스를 등록하고 다시 복제하지 않고 사전 캐시된 플러그인을 사용합니다. 컨테이너용 플러그인 사전 채우기 참조
`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`	Claude Code를 포함하고 대신 모델 공급자 라우팅을 관리하는 호스트 플랫폼에서 설정합니다. 설정하면 설정 파일의 `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL`, `ANTHROPIC_API_KEY`와 같은 공급자 선택, 엔드포인트, 인증 변수가 무시되므로 사용자 설정이 호스트의 라우팅을 재정의할 수 없습니다. Bedrock, Vertex, Foundry에 대한 자동 원격 분석 옵트아웃도 건너뛰므로 원격 분석은 표준 `DISABLE_TELEMETRY` 옵트아웃을 따릅니다. API 공급자별 기본 동작 참조
`CLAUDE_CODE_PROXY_RESOLVES_HOSTS`	호출자 대신 프록시가 DNS 해석을 수행하도록 허용하려면 `1`로 설정합니다. 프록시가 호스트명 해석을 처리해야 하는 환경에 대해 옵트인합니다.
`CLAUDE_CODE_REMOTE`	Claude Code가 클라우드 세션으로 실행 중일 때 자동으로 `true`로 설정됩니다. 훅 또는 설정 스크립트에서 이를 읽어 클라우드 환경에 있는지 감지합니다.
`CLAUDE_CODE_REMOTE_SESSION_ID`	클라우드 세션에서 현재 세션의 ID로 자동으로 설정됩니다. 세션 트랜스크립트로 다시 연결하는 링크를 구성하려면 이를 읽습니다. 세션으로 아티팩트 다시 연결 참조
`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`	이전 세션이 중간에 끝난 경우 자동으로 재개하려면 `1`로 설정합니다. SDK 모드에서 사용되므로 모델이 SDK가 프롬프트를 다시 전송할 필요 없이 계속됩니다.
`CLAUDE_CODE_SCRIPT_CAPS`	`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`이 설정되었을 때 세션당 특정 스크립트를 호출할 수 있는 횟수를 제한하는 JSON 객체입니다. 키는 명령 텍스트에 대해 일치하는 부분 문자열입니다. 값은 정수 호출 제한입니다. 예를 들어 `{"deploy.sh": 2}`는 `deploy.sh`를 최대 2번 호출할 수 있습니다. 일치는 부분 문자열 기반이므로 `./scripts/deploy.sh $(evil)`과 같은 셸 확장 트릭도 여전히 제한에 포함됩니다. `xargs` 또는 `find -exec`을 통한 런타임 팬아웃은 감지되지 않습니다. 이는 심층 방어 제어입니다.
`CLAUDE_CODE_SCROLL_SPEED`	전체 화면 렌더링에서 마우스 휠 스크롤 배수를 설정합니다. 1부터 20까지의 값을 허용합니다. 터미널이 증폭 없이 노치당 하나의 휠 이벤트를 보내는 경우 `vim`과 일치하도록 `3`으로 설정합니다. JetBrains IDE 터미널에서는 무시되며, Claude Code는 자체 스크롤 처리를 사용합니다.
`CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS`	SessionEnd 훅의 시간 예산(밀리초)을 재정의합니다. 세션 종료, `/clear`, 대화형 `/resume`을 통한 세션 전환에 적용됩니다. 기본적으로 예산은 1.5초이며, 설정 파일에서 구성된 가장 높은 훅별 `timeout`으로 자동으로 올라가며, 최대 60초입니다. 플러그인 제공 훅의 타임아웃은 예산을 올리지 않습니다.
`CLAUDE_CODE_SESSION_ID`	Bash 및 PowerShell 도구 subprocess에서 현재 세션 ID로 자동으로 설정됩니다. 훅에 전달된 `session_id` 필드와 일치합니다. `/clear`에서 업데이트됩니다. 스크립트 및 외부 도구를 Claude Code 세션과 연관시키는 데 사용합니다.
`CLAUDE_CODE_SHELL`	자동 셸 감지를 재정의합니다. 로그인 셸이 선호하는 작업 셸과 다를 때 유용합니다(예: `bash` vs `zsh`).
`CLAUDE_CODE_SHELL_PREFIX`	Claude Code가 생성하는 모든 셸 명령을 래핑할 명령 접두사: Bash 도구 호출, 훅 명령, stdio MCP 서버 시작 명령. 로깅 또는 감사에 유용합니다. 예: `/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_SIMPLE_SYSTEM_PROMPT`	Opus 4.7에서 최소 시스템 프롬프트 및 축소된 도구 설명을 사용하려면 `1`로 설정합니다. 다른 모델에는 효과가 없습니다. 전체 도구 세트, 훅, MCP 서버, CLAUDE.md 검색은 계속 활성화됩니다.
`CLAUDE_CODE_SKIP_BEDROCK_AUTH`	Bedrock에 대한 AWS 인증을 건너뜁니다(예: LLM 게이트웨이를 사용할 때).
`CLAUDE_CODE_SKIP_FOUNDRY_AUTH`	Microsoft Foundry에 대한 Azure 인증을 건너뜁니다(예: LLM 게이트웨이를 사용할 때).
`CLAUDE_CODE_SKIP_MANTLE_AUTH`	Bedrock Mantle에 대한 AWS 인증을 건너뜁니다(예: LLM 게이트웨이를 사용할 때).
`CLAUDE_CODE_SKIP_PROMPT_HISTORY`	프롬프트 기록 및 세션 트랜스크립트를 디스크에 쓰지 않으려면 `1`로 설정합니다. 이 변수로 시작된 세션은 `--resume`, `--continue` 또는 위쪽 화살표 기록에 나타나지 않습니다. 임시 스크립트 세션에 유용합니다.
`CLAUDE_CODE_SKIP_VERTEX_AUTH`	Vertex에 대한 Google 인증을 건너뜁니다(예: LLM 게이트웨이를 사용할 때).
`CLAUDE_CODE_SUBAGENT_MODEL`	모델 구성 참조
`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`	Anthropic 및 클라우드 공급자 자격 증명을 subprocess 환경(Bash 도구, 훅, MCP stdio 서버)에서 제거하려면 `1`로 설정합니다. 부모 Claude 프로세스는 API 호출을 위해 이러한 자격 증명을 유지하지만 자식 프로세스는 이를 읽을 수 없으므로 셸 확장을 통해 비밀을 유출하려는 프롬프트 주입 공격에 대한 노출을 줄입니다. Linux에서는 Bash subprocess를 격리된 PID 네임스페이스에서도 실행하므로 `/proc`을 통해 호스트 프로세스 환경을 읽을 수 없습니다. 부작용으로 `ps`, `pgrep`, `kill`은 호스트 프로세스를 보거나 신호할 수 없습니다. `allowed_non_write_users`가 구성되면 `claude-code-action`이 자동으로 이를 설정합니다.
`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`	비대화형 모드(`-p` 플래그)에서 첫 번째 쿼리 전에 플러그인 설치가 완료될 때까지 대기하려면 `1`로 설정합니다. 이 없으면 플러그인이 백그라운드에서 설치되고 첫 번째 턴에서 사용하지 못할 수 있습니다. `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS`와 결합하여 대기를 제한합니다.
`CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS`	동기 플러그인 설치의 타임아웃(밀리초). 초과되면 Claude Code는 플러그인 없이 진행하고 오류를 기록합니다. 기본값 없음: 이 변수가 없으면 동기 설치는 완료될 때까지 대기합니다.
`CLAUDE_CODE_SYNTAX_HIGHLIGHT`	diff 출력에서 구문 강조를 비활성화하려면 `false`로 설정합니다. 색상이 터미널 설정을 방해할 때 유용합니다. 코드 블록 및 파일 미리보기에서 강조를 비활성화하려면 `syntaxHighlightingDisabled` 설정을 사용합니다.
`CLAUDE_CODE_TASK_LIST_ID`	세션 간에 작업 목록을 공유합니다. 여러 Claude Code 인스턴스에서 동일한 ID를 설정하여 공유 작업 목록에서 조정합니다. 작업 목록 참조
`CLAUDE_CODE_TEAM_NAME`	이 팀원이 속한 에이전트 팀의 이름입니다. 에이전트 팀 멤버에서 자동으로 설정됩니다.
`CLAUDE_CODE_TMPDIR`	내부 임시 파일에 사용되는 임시 디렉토리를 재정의합니다. Claude Code는 이 경로에 `/claude-{uid}/`(Unix) 또는 `/claude/`(Windows)를 추가합니다. 기본값: macOS의 경우 `/tmp`, Linux/Windows의 경우 `os.tmpdir()`
`CLAUDE_CODE_TMUX_TRUECOLOR`	tmux 내에서 24비트 truecolor 출력을 허용하려면 `1`로 설정합니다. 기본적으로 `$TMUX`가 설정되면 Claude Code는 256색으로 제한합니다. tmux는 구성되지 않으면 truecolor 이스케이프 시퀀스를 통과하지 않기 때문입니다. `~/.tmux.conf`에 `set -ga terminal-overrides ',*:Tc'`를 추가한 후 이를 설정합니다. 터미널 구성에서 다른 tmux 설정을 참조합니다.
`CLAUDE_CODE_USE_BEDROCK`	Bedrock 사용
`CLAUDE_CODE_USE_FOUNDRY`	Microsoft Foundry 사용
`CLAUDE_CODE_USE_MANTLE`	Bedrock Mantle 엔드포인트 사용
`CLAUDE_CODE_USE_NATIVE_FILE_SEARCH`	Node.js 파일 API를 사용하여 사용자 정의 명령, subagent, 출력 스타일을 검색하려면 `1`로 설정합니다. 번들 ripgrep 바이너리를 사용할 수 없거나 환경에서 차단된 경우 이를 설정합니다. Grep 또는 파일 검색 도구에는 영향을 주지 않습니다.
`CLAUDE_CODE_USE_POWERSHELL_TOOL`	PowerShell 도구를 제어합니다. Windows에서 Git Bash가 없으면 도구가 자동으로 활성화됩니다. `0`으로 설정하여 비활성화합니다. Windows에 Git Bash가 설치되어 있으면 도구가 점진적으로 롤아웃됩니다: 옵트인하려면 `1`로 설정하거나 옵트아웃하려면 `0`으로 설정합니다. Linux, macOS, WSL에서는 `1`로 설정하여 활성화합니다. PATH에 `pwsh`가 필요합니다. Windows에서 활성화되면 Claude는 Git Bash를 통해 라우팅하는 대신 PowerShell 명령을 기본적으로 실행할 수 있습니다. PowerShell 도구 참조
`CLAUDE_CODE_USE_VERTEX`	Vertex 사용
`CLAUDE_CONFIG_DIR`	구성 디렉토리를 재정의합니다(기본값: `~/.claude`). 모든 설정, 자격 증명, 세션 기록 및 플러그인이 이 경로 아래에 저장됩니다. 여러 계정을 나란히 실행하는 데 유용합니다: 예를 들어 `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`
`CLAUDE_EFFORT`	Bash 도구 subprocess 및 훅 명령에서 활성 노력 수준으로 자동으로 설정됩니다: `low`, `medium`, `high`, `xhigh`, 또는 `max`. 훅에 전달된 `effort.level` 필드와 일치합니다. 현재 모델이 노력 매개변수를 지원할 때만 설정됩니다.
`CLAUDE_ENABLE_BYTE_WATCHDOG`	바이트 수준 스트리밍 유휴 감시견을 강제로 활성화하려면 `1`로 설정하거나, 강제로 비활성화하려면 `0`으로 설정합니다. 설정하지 않으면 감시견은 Anthropic API 연결에 대해 기본적으로 활성화됩니다. 바이트 감시견은 `CLAUDE_STREAM_IDLE_TIMEOUT_MS`로 설정된 기간 동안 와이어에 바이트가 도착하지 않으면 연결을 중단합니다. 최소 5분이며 이벤트 수준 감시견과 독립적입니다.
`CLAUDE_ENABLE_STREAM_WATCHDOG`	이벤트 수준 스트리밍 유휴 감시견을 활성화하려면 `1`로 설정합니다. 기본적으로 꺼져 있습니다. Bedrock, Vertex, Foundry의 경우 이것이 유일한 유휴 감시견입니다. `CLAUDE_STREAM_IDLE_TIMEOUT_MS`로 타임아웃을 구성합니다.
`CLAUDE_ENV_FILE`	Claude Code가 각 Bash 명령 전에 같은 셸 프로세스에서 실행하는 셸 스크립트의 경로이므로 파일의 내보내기가 명령에 표시됩니다. virtualenv 또는 conda 활성화를 명령 간에 유지하는 데 사용합니다. SessionStart, Setup, CwdChanged, FileChanged 훅으로도 동적으로 채워집니다.
`CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX`	명시적 이름이 제공되지 않을 때 자동 생성된 Remote Control 세션 이름의 접두사입니다. 기본값은 머신의 호스트명이며, `myhost-graceful-unicorn`과 같은 이름을 생성합니다. `--remote-control-session-name-prefix` CLI 플래그는 단일 호출에 대해 동일한 값을 설정합니다.
`CLAUDE_STREAM_IDLE_TIMEOUT_MS`	스트리밍 유휴 감시견이 정체된 연결을 닫기 전의 타임아웃(밀리초). 바이트 수준 및 이벤트 수준 감시견 모두에 대해 기본값 및 최소 `300000`(5분). 낮은 값은 확장 사고 일시 중지 및 프록시 버퍼링을 흡수하도록 자동으로 제한됩니다. 타사 공급자의 경우 `CLAUDE_ENABLE_STREAM_WATCHDOG=1`이 필요합니다.
`DISABLE_AUTOUPDATER`	자동 업데이트를 비활성화하려면 `1`로 설정합니다. 수동 `claude update`는 계속 작동합니다. `DISABLE_UPDATES`를 사용하여 둘 다 차단합니다.
`DISABLE_AUTO_COMPACT`	컨텍스트 제한에 접근할 때 자동 압축을 비활성화하려면 `1`로 설정합니다. 수동 `/compact` 명령은 계속 사용 가능합니다. 압축이 발생하는 시기를 명시적으로 제어하려는 경우 사용합니다.
`DISABLE_COMPACT`	자동 압축과 수동 `/compact` 명령을 포함한 모든 압축을 비활성화하려면 `1`로 설정합니다.
`DISABLE_COST_WARNINGS`	비용 경고 메시지를 비활성화하려면 `1`로 설정합니다.
`DISABLE_DOCTOR_COMMAND`	`/doctor` 명령을 숨기려면 `1`로 설정합니다. 사용자가 설치 진단을 실행하지 않아야 하는 관리형 배포에 유용합니다.
`DISABLE_ERROR_REPORTING`	Sentry 오류 보고를 거부하려면 `1`로 설정합니다.
`DISABLE_EXTRA_USAGE_COMMAND`	사용자가 속도 제한을 초과하여 추가 사용량을 구매할 수 있는 `/extra-usage` 명령을 숨기려면 `1`로 설정합니다.
`DISABLE_FEEDBACK_COMMAND`	`/feedback` 명령을 비활성화하려면 `1`로 설정합니다. 이전 이름 `DISABLE_BUG_COMMAND`도 허용됩니다.
`DISABLE_GROWTHBOOK`	GrowthBook 기능 플래그 가져오기를 비활성화하려면 `1`로 설정합니다. 모든 플래그에 대해 코드 기본값을 사용합니다. 원격 분석 이벤트 로깅은 `DISABLE_TELEMETRY`도 설정되지 않으면 계속됩니다.
`DISABLE_INSTALLATION_CHECKS`	설치 경고를 비활성화하려면 `1`로 설정합니다. 표준 설치의 문제를 숨길 수 있으므로 설치 위치를 수동으로 관리할 때만 사용합니다.
`DISABLE_INSTALL_GITHUB_APP_COMMAND`	`/install-github-app` 명령을 숨기려면 `1`로 설정합니다. 타사 공급자(Bedrock, Vertex 또는 Foundry)를 사용할 때 이미 숨겨집니다.
`DISABLE_INTERLEAVED_THINKING`	interleaved-thinking 베타 헤더 전송을 방지하려면 `1`로 설정합니다. LLM 게이트웨이 또는 공급자가 interleaved thinking을 지원하지 않을 때 유용합니다.
`DISABLE_LOGIN_COMMAND`	`/login` 명령을 숨기려면 `1`로 설정합니다. API 키 또는 `apiKeyHelper`를 통해 인증이 외부에서 처리될 때 유용합니다.
`DISABLE_LOGOUT_COMMAND`	`/logout` 명령을 숨기려면 `1`로 설정합니다.
`DISABLE_PROMPT_CACHING`	모든 모델에 대해 프롬프트 캐싱을 비활성화하려면 `1`로 설정합니다(모델별 설정보다 우선).
`DISABLE_PROMPT_CACHING_HAIKU`	Haiku 모델에 대해 프롬프트 캐싱을 비활성화하려면 `1`로 설정합니다.
`DISABLE_PROMPT_CACHING_OPUS`	Opus 모델에 대해 프롬프트 캐싱을 비활성화하려면 `1`로 설정합니다.
`DISABLE_PROMPT_CACHING_SONNET`	Sonnet 모델에 대해 프롬프트 캐싱을 비활성화하려면 `1`로 설정합니다.
`DISABLE_TELEMETRY`	원격 분석을 거부하려면 `1`로 설정합니다. 원격 분석 이벤트에는 코드, 파일 경로 또는 bash 명령과 같은 사용자 데이터가 포함되지 않습니다.
`DISABLE_UPDATES`	수동 `claude update` 및 `claude install`을 포함한 모든 업데이트를 차단하려면 `1`로 설정합니다. `DISABLE_AUTOUPDATER`보다 더 엄격합니다. 자신의 채널을 통해 Claude Code를 배포하고 사용자가 자체 업데이트하지 않아야 할 때 사용합니다.
`DISABLE_UPGRADE_COMMAND`	`/upgrade` 명령을 숨기려면 `1`로 설정합니다.
`ENABLE_CLAUDEAI_MCP_SERVERS`	Claude Code에서 claude.ai MCP 서버를 비활성화하려면 `false`로 설정합니다. 로그인한 사용자의 경우 기본적으로 활성화됩니다.
`ENABLE_PROMPT_CACHING_1H`	API 키, Bedrock, Vertex, Foundry 사용자를 위해 기본 5분 대신 1시간 프롬프트 캐시 TTL을 요청하려면 `1`로 설정합니다. 구독 사용자는 자동으로 1시간 TTL을 받습니다. 1시간 캐시 쓰기는 더 높은 요금으로 청구됩니다.
`ENABLE_PROMPT_CACHING_1H_BEDROCK`	더 이상 사용되지 않음. 대신 `ENABLE_PROMPT_CACHING_1H` 사용
`ENABLE_TOOL_SEARCH`	MCP 도구 검색을 제어합니다. 설정 해제: 모든 MCP 도구는 기본적으로 연기되지만 Vertex AI에서 또는 `ANTHROPIC_BASE_URL`이 비자사 호스트를 가리킬 때 미리 로드됩니다. 값: `true`(프록시 포함 항상 연기), `auto`(임계값 모드: 도구가 컨텍스트의 10% 이내에 맞으면 미리 로드), `auto:N`(사용자 정의 임계값, 예: 5%의 경우 `auto:5`), `false`(모두 미리 로드)
`FALLBACK_FOR_ALL_PRIMARY_MODELS`	모든 기본 모델에서 반복된 과부하 오류 후 `--fallback-model`로 폴백을 트리거하려면 비어 있지 않은 값으로 설정합니다. 기본적으로 Opus 모델만 폴백을 트리거합니다.
`FORCE_AUTOUPDATE_PLUGINS`	`DISABLE_AUTOUPDATER`를 통해 주 자동 업데이터가 비활성화된 경우에도 플러그인 자동 업데이트를 강제하려면 `1`로 설정합니다.
`FORCE_PROMPT_CACHING_5M`	1시간 TTL이 적용되는 경우에도 5분 프롬프트 캐시 TTL을 강제하려면 `1`로 설정합니다. `ENABLE_PROMPT_CACHING_1H` 재정의
`HTTP_PROXY`	네트워크 연결을 위한 HTTP 프록시 서버를 지정합니다.
`HTTPS_PROXY`	네트워크 연결을 위한 HTTPS 프록시 서버를 지정합니다.
`IS_DEMO`	데모 모드를 활성화하려면 `1`로 설정합니다: 헤더 및 `/status` 출력에서 이메일 및 조직 이름을 숨기고 온보딩을 건너뜁니다. 세션을 스트리밍하거나 녹화할 때 유용합니다.
`MAX_MCP_OUTPUT_TOKENS`	MCP 도구 응답에서 허용되는 최대 토큰 수입니다. Claude Code는 출력이 10,000 토큰을 초과할 때 경고를 표시합니다. 도구가 `anthropic/maxResultSizeChars`를 선언하면 텍스트 내용에 대해 해당 문자 제한을 사용하지만, 해당 도구의 이미지 내용은 여전히 이 변수의 영향을 받습니다(기본값: 25000).
`MAX_STRUCTURED_OUTPUT_RETRIES`	비대화형 모드(`-p` 플래그)에서 모델의 응답이 `--json-schema`에 대한 유효성 검사에 실패할 때 재시도할 횟수입니다. 기본값은 5입니다.
`MAX_THINKING_TOKENS`	확장 사고 토큰 예산을 재정의합니다. 상한은 모델의 최대 출력 토큰에서 1을 뺀 값입니다. 사고를 완전히 비활성화하려면 `0`으로 설정합니다. 적응형 추론이 있는 모델에서는 `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`을 통해 적응형 추론이 비활성화되지 않으면 예산이 무시됩니다.
`MCP_CLIENT_SECRET`	사전 구성된 자격 증명이 필요한 MCP 서버의 OAuth 클라이언트 시크릿입니다. `--client-secret`으로 서버를 추가할 때 대화형 프롬프트를 방지합니다.
`MCP_CONNECTION_NONBLOCKING`	비대화형 모드(`-p`)에서 MCP 연결 대기를 완전히 건너뛰려면 `true`로 설정합니다. MCP 도구가 필요하지 않은 스크립트 파이프라인에 유용합니다. 이 변수가 없으면 첫 번째 쿼리는 `--mcp-config` 서버 연결을 위해 최대 5초 동안 대기합니다. `alwaysLoad: true`로 구성된 서버는 도구가 첫 번째 프롬프트를 빌드할 때 존재해야 하므로 이 변수와 관계없이 항상 시작을 차단합니다.
`MCP_CONNECT_TIMEOUT_MS`	첫 번째 쿼리가 MCP 연결 배치를 기다리는 시간(밀리초)을 설정하고 도구 목록을 스냅샷하기 전입니다(기본값: 5000). 마감 시점에 여전히 보류 중인 서버는 백그라운드에서 계속 연결되지만 다음 쿼리까지 나타나지 않습니다. `MCP_TIMEOUT`과 다르며, 이는 개별 서버의 연결 시도를 제한합니다. 단일 쿼리를 발급하고 느리게 연결되는 서버가 표시되어야 하는 비대화형 세션과 가장 관련이 있습니다.
`MCP_OAUTH_CALLBACK_PORT`	사전 구성된 자격 증명으로 MCP 서버를 추가할 때 `--callback-port`의 대안으로 OAuth 리디렉션 콜백의 고정 포트입니다.
`MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE`	시작 중에 병렬로 연결할 원격 MCP 서버(HTTP/SSE)의 최대 수(기본값: 20)
`MCP_SERVER_CONNECTION_BATCH_SIZE`	시작 중에 병렬로 연결할 로컬 MCP 서버(stdio)의 최대 수(기본값: 3)
`MCP_TIMEOUT`	MCP 서버 시작의 타임아웃(밀리초)(기본값: 30000, 또는 30초)
`MCP_TOOL_TIMEOUT`	MCP 도구 실행의 타임아웃(밀리초)(기본값: 100000000, 약 28시간)
`NO_PROXY`	프록시를 우회하여 직접 발급될 요청의 도메인 및 IP 목록
`OTEL_LOG_RAW_API_BODIES`	전체 Anthropic Messages API 요청 및 응답 JSON을 OpenTelemetry 로그 이벤트(`api_request_body`, `api_response_body`)로 내보냅니다. 60KB에서 잘린 인라인 본문의 경우 `1`로 설정하거나, 잘리지 않은 본문을 디스크에 쓰고 `body_ref` 경로를 내보내려면 `file:<dir>`로 설정합니다. 기본적으로 비활성화됩니다. 본문에는 전체 대화 기록이 포함됩니다. 모니터링 참조
`OTEL_LOG_TOOL_CONTENT`	도구 입력 및 출력 내용을 OpenTelemetry 스팬 이벤트에 포함하려면 `1`로 설정합니다. 민감한 데이터를 보호하기 위해 기본적으로 비활성화됩니다. 모니터링 참조
`OTEL_LOG_TOOL_DETAILS`	도구 입력 인수, MCP 서버 이름, 도구 세부 정보를 OpenTelemetry 추적 및 로그에 포함하려면 `1`로 설정합니다. PII를 보호하기 위해 기본적으로 비활성화됩니다. 모니터링 참조
`OTEL_LOG_USER_PROMPTS`	사용자 프롬프트 텍스트를 OpenTelemetry 추적 및 로그에 포함하려면 `1`로 설정합니다. 기본적으로 비활성화됩니다(프롬프트는 수정됨). 모니터링 참조
`OTEL_METRICS_INCLUDE_ACCOUNT_UUID`	메트릭 속성에서 계정 UUID를 제외하려면 `false`로 설정합니다(기본값: 포함). 모니터링 참조
`OTEL_METRICS_INCLUDE_SESSION_ID`	메트릭 속성에서 세션 ID를 제외하려면 `false`로 설정합니다(기본값: 포함). 모니터링 참조
`OTEL_METRICS_INCLUDE_VERSION`	메트릭 속성에 Claude Code 버전을 포함하려면 `true`로 설정합니다(기본값: 제외). 모니터링 참조
`SLASH_COMMAND_TOOL_CHAR_BUDGET`	Skill 도구에 표시되는 skill 메타데이터의 문자 예산을 재정의합니다. 예산은 컨텍스트 윈도우의 1%에서 동적으로 확장되며, 8,000자의 폴백이 있습니다. 이전 버전과의 호환성을 위해 레거시 이름이 유지됩니다.
`TASK_MAX_OUTPUT_LENGTH`	잘림 전 subagent 출력의 최대 문자 수(기본값: 32000, 최대: 160000). 잘림 시 전체 출력이 디스크에 저장되고 경로가 잘린 응답에 포함됩니다.
`USE_BUILTIN_RIPGREP`	Claude Code에 포함된 `rg` 대신 시스템 설치 `rg`를 사용하려면 `0`으로 설정합니다.
`VERTEX_REGION_CLAUDE_3_5_HAIKU`	Vertex AI 사용 시 Claude 3.5 Haiku의 리전을 재정의합니다.
`VERTEX_REGION_CLAUDE_3_5_SONNET`	Vertex AI 사용 시 Claude 3.5 Sonnet의 리전을 재정의합니다.
`VERTEX_REGION_CLAUDE_3_7_SONNET`	Vertex AI 사용 시 Claude 3.7 Sonnet의 리전을 재정의합니다.
`VERTEX_REGION_CLAUDE_4_0_OPUS`	Vertex AI 사용 시 Claude 4.0 Opus의 리전을 재정의합니다.
`VERTEX_REGION_CLAUDE_4_0_SONNET`	Vertex AI 사용 시 Claude 4.0 Sonnet의 리전을 재정의합니다.
`VERTEX_REGION_CLAUDE_4_1_OPUS`	Vertex AI 사용 시 Claude 4.1 Opus의 리전을 재정의합니다.
`VERTEX_REGION_CLAUDE_4_5_OPUS`	Vertex AI 사용 시 Claude Opus 4.5의 리전을 재정의합니다.
`VERTEX_REGION_CLAUDE_4_5_SONNET`	Vertex AI 사용 시 Claude Sonnet 4.5의 리전을 재정의합니다.
`VERTEX_REGION_CLAUDE_4_6_OPUS`	Vertex AI 사용 시 Claude Opus 4.6의 리전을 재정의합니다.
`VERTEX_REGION_CLAUDE_4_6_SONNET`	Vertex AI 사용 시 Claude Sonnet 4.6의 리전을 재정의합니다.
`VERTEX_REGION_CLAUDE_4_7_OPUS`	Vertex AI 사용 시 Claude Opus 4.7의 리전을 재정의합니다.
`VERTEX_REGION_CLAUDE_HAIKU_4_5`	Vertex AI 사용 시 Claude Haiku 4.5의 리전을 재정의합니다.

표준 OpenTelemetry 내보내기 변수(OTEL_METRICS_EXPORTER, OTEL_LOGS_EXPORTER, OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_PROTOCOL, OTEL_EXPORTER_OTLP_HEADERS, OTEL_METRIC_EXPORT_INTERVAL, OTEL_RESOURCE_ATTRIBUTES 및 신호별 변형)도 지원됩니다. 구성 세부 정보는 모니터링을 참조합니다.

참고 항목

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

env-vars.md +4 −2

92| `CLAUDE_CODE_EFFORT_LEVEL` | 지원되는 모델의 노력 수준을 설정합니다. 값: `low`, `medium`, `high`, `xhigh`, `max`, 또는 `auto`(모델 기본값 사용). 사용 가능한 수준은 모델에 따라 다릅니다. `/effort` 및 `effortLevel` 설정보다 우선합니다. [노력 수준 조정](/ko/model-config#adjust-effort-level) 참조 |92| `CLAUDE_CODE_EFFORT_LEVEL` | 지원되는 모델의 노력 수준을 설정합니다. 값: `low`, `medium`, `high`, `xhigh`, `max`, 또는 `auto`(모델 기본값 사용). 사용 가능한 수준은 모델에 따라 다릅니다. `/effort` 및 `effortLevel` 설정보다 우선합니다. [노력 수준 조정](/ko/model-config#adjust-effort-level) 참조 |

93| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | [세션 요약](/ko/interactive-mode#session-recap) 가용성을 재정의합니다. 재개를 강제로 끄려면 `0`으로 설정합니다. [`awaySummaryEnabled`](/ko/settings#available-settings)가 `false`일 때 재개를 강제로 켜려면 `1`로 설정합니다. 설정 및 `/config` 토글보다 우선합니다. |93| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | [세션 요약](/ko/interactive-mode#session-recap) 가용성을 재정의합니다. 재개를 강제로 끄려면 `0`으로 설정합니다. [`awaySummaryEnabled`](/ko/settings#available-settings)가 `false`일 때 재개를 강제로 켜려면 `1`로 설정합니다. 설정 및 `/config` 토글보다 우선합니다. |

94| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | [비대화형 모드](/ko/headless)에서 백그라운드 설치가 완료된 후 턴 경계에서 플러그인 상태를 새로 고치려면 `1`로 설정합니다. 새로 고침이 세션 중간에 시스템 프롬프트를 변경하여 해당 턴의 [프롬프트 캐싱](https://platform.claude.com/docs/en/build-with-claude/prompt-caching)을 무효화하므로 기본적으로 꺼져 있습니다. |94| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | [비대화형 모드](/ko/headless)에서 백그라운드 설치가 완료된 후 턴 경계에서 플러그인 상태를 새로 고치려면 `1`로 설정합니다. 새로 고침이 세션 중간에 시스템 프롬프트를 변경하여 해당 턴의 [프롬프트 캐싱](https://platform.claude.com/docs/en/build-with-claude/prompt-caching)을 무효화하므로 기본적으로 꺼져 있습니다. |

95| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | 도구 호출 입력이 Claude가 생성할 때 API에서 스트리밍되는지 여부를 제어합니다. 이 없으면 파일 쓰기와 같은 큰 도구 입력이 Claude가 생성을 완료한 후에만 도착하므로 중단된 것처럼 보일 수 있습니다. 직접 Anthropic API 연결에 대해 기본적으로 활성화됩니다. 옵트아웃하려면 `0`으로 설정합니다. 서버 측 기본값이 꺼져 있을 때에도 강제로 활성화하려면 `1`로 설정합니다. Bedrock, Vertex, Foundry 또는 [게이트웨이](/ko/llm-gateway) 연결에는 효과가 없습니다. |95| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | 도구 호출 입력이 Claude가 생성할 때 API에서 스트리밍되는지 여부를 제어합니다. 이 없으면 파일 쓰기와 같은 큰 도구 입력이 Claude가 생성을 완료한 후에만 도착하므로 중단된 것처럼 보일 수 있습니다. Anthropic API에 대해 기본적으로 활성화됩니다. Bedrock 및 Vertex에서는 배포된 컨테이너가 지원하는 모델별로 활성화됩니다. 옵트아웃하려면 `0`으로 설정합니다. `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` 또는 `ANTHROPIC_BEDROCK_BASE_URL`을 통해 프록시로 라우팅할 때 강제로 활성화하려면 `1`로 설정합니다. Foundry 및 [게이트웨이](/ko/llm-gateway) 연결에는 기본적으로 꺼져 있습니다. |

96| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | `ANTHROPIC_BASE_URL`이 LiteLLM, Kong 또는 내부 프록시와 같은 Anthropic 호환 게이트웨이를 가리킬 때 게이트웨이의 `/v1/models` 엔드포인트에서 `/model` 선택기를 채우려면 `1`로 설정합니다. 공유 API 키로 지원되는 게이트웨이는 그렇지 않으면 모든 사용자에게 키가 액세스할 수 있는 모든 모델을 표시하므로 기본적으로 꺼져 있습니다. 검색된 모델은 여전히 [`availableModels`](/ko/settings#available-settings) 허용 목록으로 필터링됩니다. |96| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | `ANTHROPIC_BASE_URL`이 LiteLLM, Kong 또는 내부 프록시와 같은 Anthropic 호환 게이트웨이를 가리킬 때 게이트웨이의 `/v1/models` 엔드포인트에서 `/model` 선택기를 채우려면 `1`로 설정합니다. 공유 API 키로 지원되는 게이트웨이는 그렇지 않으면 모든 사용자에게 키가 액세스할 수 있는 모든 모델을 표시하므로 기본적으로 꺼져 있습니다. 검색된 모델은 여전히 [`availableModels`](/ko/settings#available-settings) 허용 목록으로 필터링됩니다. |

97| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | 프롬프트 제안을 비활성화하려면 `false`로 설정합니다(`/config`의 "프롬프트 제안" 토글). 이는 Claude가 응답한 후 프롬프트 입력에 나타나는 회색으로 표시된 예측입니다. [프롬프트 제안](/ko/interactive-mode#prompt-suggestions) 참조 |97| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | 프롬프트 제안을 비활성화하려면 `false`로 설정합니다(`/config`의 "프롬프트 제안" 토글). 이는 Claude가 응답한 후 프롬프트 입력에 나타나는 회색으로 표시된 예측입니다. [프롬프트 제안](/ko/interactive-mode#prompt-suggestions) 참조 |

98| `CLAUDE_CODE_ENABLE_TASKS` | 비대화형 모드(`-p` 플래그)에서 작업 추적 시스템을 활성화하려면 `1`로 설정합니다. 작업은 대화형 모드에서 기본적으로 켜져 있습니다. [작업 목록](/ko/interactive-mode#task-list) 참조 |98| `CLAUDE_CODE_ENABLE_TASKS` | 비대화형 모드(`-p` 플래그)에서 작업 추적 시스템을 활성화하려면 `1`로 설정합니다. 작업은 대화형 모드에서 기본적으로 켜져 있습니다. [작업 목록](/ko/interactive-mode#task-list) 참조 |

164| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | PowerShell 도구를 제어합니다. Windows에서 Git Bash가 없으면 도구가 자동으로 활성화됩니다. `0`으로 설정하여 비활성화합니다. Windows에 Git Bash가 설치되어 있으면 도구가 점진적으로 롤아웃됩니다: 옵트인하려면 `1`로 설정하거나 옵트아웃하려면 `0`으로 설정합니다. Linux, macOS, WSL에서는 `1`로 설정하여 활성화합니다. PATH에 `pwsh`가 필요합니다. Windows에서 활성화되면 Claude는 Git Bash를 통해 라우팅하는 대신 PowerShell 명령을 기본적으로 실행할 수 있습니다. [PowerShell 도구](/ko/tools-reference#powershell-tool) 참조 |164| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | PowerShell 도구를 제어합니다. Windows에서 Git Bash가 없으면 도구가 자동으로 활성화됩니다. `0`으로 설정하여 비활성화합니다. Windows에 Git Bash가 설치되어 있으면 도구가 점진적으로 롤아웃됩니다: 옵트인하려면 `1`로 설정하거나 옵트아웃하려면 `0`으로 설정합니다. Linux, macOS, WSL에서는 `1`로 설정하여 활성화합니다. PATH에 `pwsh`가 필요합니다. Windows에서 활성화되면 Claude는 Git Bash를 통해 라우팅하는 대신 PowerShell 명령을 기본적으로 실행할 수 있습니다. [PowerShell 도구](/ko/tools-reference#powershell-tool) 참조 |

166| `CLAUDE_CONFIG_DIR` | 구성 디렉토리를 재정의합니다(기본값: `~/.claude`). 모든 설정, 자격 증명, 세션 기록 및 플러그인이 이 경로 아래에 저장됩니다. 여러 계정을 나란히 실행하는 데 유용합니다: 예를 들어 `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |166| `CLAUDE_CONFIG_DIR` | 구성 디렉토리를 재정의합니다(기본값: `~/.claude`). 모든 설정, 자격 증명, 세션 기록 및 플러그인이 이 경로 아래에 저장됩니다. 여러 계정을 나란히 실행하는 데 유용합니다: 예를 들어 `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |

167| `CLAUDE_EFFORT` | Bash 도구 subprocess 및 훅 명령에서 활성 [노력 수준](/ko/model-config#adjust-effort-level)으로 자동으로 설정됩니다: `low`, `medium`, `high`, `xhigh`, 또는 `max`. [훅](/ko/hooks)에 전달된 `effort.level` 필드와 일치합니다. 현재 모델이 노력 매개변수를 지원할 때만 설정됩니다. |

167| `CLAUDE_ENABLE_BYTE_WATCHDOG` | 바이트 수준 스트리밍 유휴 감시견을 강제로 활성화하려면 `1`로 설정하거나, 강제로 비활성화하려면 `0`으로 설정합니다. 설정하지 않으면 감시견은 Anthropic API 연결에 대해 기본적으로 활성화됩니다. 바이트 감시견은 `CLAUDE_STREAM_IDLE_TIMEOUT_MS`로 설정된 기간 동안 와이어에 바이트가 도착하지 않으면 연결을 중단합니다. 최소 5분이며 이벤트 수준 감시견과 독립적입니다. |168| `CLAUDE_ENABLE_BYTE_WATCHDOG` | 바이트 수준 스트리밍 유휴 감시견을 강제로 활성화하려면 `1`로 설정하거나, 강제로 비활성화하려면 `0`으로 설정합니다. 설정하지 않으면 감시견은 Anthropic API 연결에 대해 기본적으로 활성화됩니다. 바이트 감시견은 `CLAUDE_STREAM_IDLE_TIMEOUT_MS`로 설정된 기간 동안 와이어에 바이트가 도착하지 않으면 연결을 중단합니다. 최소 5분이며 이벤트 수준 감시견과 독립적입니다. |

168| `CLAUDE_ENABLE_STREAM_WATCHDOG` | 이벤트 수준 스트리밍 유휴 감시견을 활성화하려면 `1`로 설정합니다. 기본적으로 꺼져 있습니다. Bedrock, Vertex, Foundry의 경우 이것이 유일한 유휴 감시견입니다. `CLAUDE_STREAM_IDLE_TIMEOUT_MS`로 타임아웃을 구성합니다. |169| `CLAUDE_ENABLE_STREAM_WATCHDOG` | 이벤트 수준 스트리밍 유휴 감시견을 활성화하려면 `1`로 설정합니다. 기본적으로 꺼져 있습니다. Bedrock, Vertex, Foundry의 경우 이것이 유일한 유휴 감시견입니다. `CLAUDE_STREAM_IDLE_TIMEOUT_MS`로 타임아웃을 구성합니다. |

169| `CLAUDE_ENV_FILE` | Claude Code가 각 Bash 명령 전에 같은 셸 프로세스에서 실행하는 셸 스크립트의 경로이므로 파일의 내보내기가 명령에 표시됩니다. virtualenv 또는 conda 활성화를 명령 간에 유지하는 데 사용합니다. [SessionStart](/ko/hooks#persist-environment-variables), [Setup](/ko/hooks#setup), [CwdChanged](/ko/hooks#cwdchanged), [FileChanged](/ko/hooks#filechanged) 훅으로도 동적으로 채워집니다. |170| `CLAUDE_ENV_FILE` | Claude Code가 각 Bash 명령 전에 같은 셸 프로세스에서 실행하는 셸 스크립트의 경로이므로 파일의 내보내기가 명령에 표시됩니다. virtualenv 또는 conda 활성화를 명령 간에 유지하는 데 사용합니다. [SessionStart](/ko/hooks#persist-environment-variables), [Setup](/ko/hooks#setup), [CwdChanged](/ko/hooks#cwdchanged), [FileChanged](/ko/hooks#filechanged) 훅으로도 동적으로 채워집니다. |

204| `MAX_STRUCTURED_OUTPUT_RETRIES` | 비대화형 모드(`-p` 플래그)에서 모델의 응답이 [`--json-schema`](/ko/cli-reference#cli-flags)에 대한 유효성 검사에 실패할 때 재시도할 횟수입니다. 기본값은 5입니다. |205| `MAX_STRUCTURED_OUTPUT_RETRIES` | 비대화형 모드(`-p` 플래그)에서 모델의 응답이 [`--json-schema`](/ko/cli-reference#cli-flags)에 대한 유효성 검사에 실패할 때 재시도할 횟수입니다. 기본값은 5입니다. |

205| `MAX_THINKING_TOKENS` | [확장 사고](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) 토큰 예산을 재정의합니다. 상한은 모델의 [최대 출력 토큰](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison)에서 1을 뺀 값입니다. 사고를 완전히 비활성화하려면 `0`으로 설정합니다. [적응형 추론](/ko/model-config#adjust-effort-level)이 있는 모델에서는 `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`을 통해 적응형 추론이 비활성화되지 않으면 예산이 무시됩니다. |206| `MAX_THINKING_TOKENS` | [확장 사고](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) 토큰 예산을 재정의합니다. 상한은 모델의 [최대 출력 토큰](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison)에서 1을 뺀 값입니다. 사고를 완전히 비활성화하려면 `0`으로 설정합니다. [적응형 추론](/ko/model-config#adjust-effort-level)이 있는 모델에서는 `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`을 통해 적응형 추론이 비활성화되지 않으면 예산이 무시됩니다. |

206| `MCP_CLIENT_SECRET` | [사전 구성된 자격 증명](/ko/mcp#use-pre-configured-oauth-credentials)이 필요한 MCP 서버의 OAuth 클라이언트 시크릿입니다. `--client-secret`으로 서버를 추가할 때 대화형 프롬프트를 방지합니다. |207| `MCP_CLIENT_SECRET` | [사전 구성된 자격 증명](/ko/mcp#use-pre-configured-oauth-credentials)이 필요한 MCP 서버의 OAuth 클라이언트 시크릿입니다. `--client-secret`으로 서버를 추가할 때 대화형 프롬프트를 방지합니다. |

207| `MCP_CONNECTION_NONBLOCKING` | 비대화형 모드(`-p`)에서 MCP 연결 대기를 완전히 건너뛰려면 `true`로 설정합니다. MCP 도구가 필요하지 않은 스크립트 파이프라인에 유용합니다. 이 변수가 없으면 첫 번째 쿼리는 `--mcp-config` 서버 연결을 위해 최대 5초 동안 대기합니다. |208| `MCP_CONNECTION_NONBLOCKING` | 비대화형 모드(`-p`)에서 MCP 연결 대기를 완전히 건너뛰려면 `true`로 설정합니다. MCP 도구가 필요하지 않은 스크립트 파이프라인에 유용합니다. 이 변수가 없으면 첫 번째 쿼리는 `--mcp-config` 서버 연결을 위해 최대 5초 동안 대기합니다. [`alwaysLoad: true`](/ko/mcp#exempt-a-server-from-deferral)로 구성된 서버는 도구가 첫 번째 프롬프트를 빌드할 때 존재해야 하므로 이 변수와 관계없이 항상 시작을 차단합니다. |

209| `MCP_CONNECT_TIMEOUT_MS` | 첫 번째 쿼리가 MCP 연결 배치를 기다리는 시간(밀리초)을 설정하고 도구 목록을 스냅샷하기 전입니다(기본값: 5000). 마감 시점에 여전히 보류 중인 서버는 백그라운드에서 계속 연결되지만 다음 쿼리까지 나타나지 않습니다. `MCP_TIMEOUT`과 다르며, 이는 개별 서버의 연결 시도를 제한합니다. 단일 쿼리를 발급하고 느리게 연결되는 서버가 표시되어야 하는 비대화형 세션과 가장 관련이 있습니다. |

208| `MCP_OAUTH_CALLBACK_PORT` | [사전 구성된 자격 증명](/ko/mcp#use-pre-configured-oauth-credentials)으로 MCP 서버를 추가할 때 `--callback-port`의 대안으로 OAuth 리디렉션 콜백의 고정 포트입니다. |210| `MCP_OAUTH_CALLBACK_PORT` | [사전 구성된 자격 증명](/ko/mcp#use-pre-configured-oauth-credentials)으로 MCP 서버를 추가할 때 `--callback-port`의 대안으로 OAuth 리디렉션 콜백의 고정 포트입니다. |

env-vars.md 2026-05-07 22:59 UTC to 2026-05-08 22:00 UTC

환경 변수

참고 항목