Claude Code는 다음 환경 변수를 지원하여 동작을 제어합니다.Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
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_AWS_API_KEY | Claude Platform on AWS의 워크스페이스 API 키이며, AWS 콘솔에서 생성됩니다. x-api-key로 전송되며 AWS SigV4보다 우선합니다. |
ANTHROPIC_AWS_BASE_URL | Claude Platform on AWS 엔드포인트 URL을 재정의합니다. 사용자 정의 리전 또는 LLM 게이트웨이를 통해 라우팅할 때 사용합니다. 기본값은 https://aws-external-anthropic.{AWS_REGION}.api.aws입니다. |
ANTHROPIC_AWS_WORKSPACE_ID | Claude Platform on AWS에 필수입니다. 모든 요청에서 anthropic-workspace-id 헤더로 전송됩니다. |
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 리전을 재정의합니다. Bedrock에서는 ANTHROPIC_DEFAULT_HAIKU_MODEL 또는 더 이상 사용되지 않는 ANTHROPIC_SMALL_FAST_MODEL도 설정되어 있을 때만 적용됩니다. Bedrock은 그렇지 않으면 백그라운드 작업에 기본 모델을 사용하기 때문입니다. |
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 참조 |
ANTHROPIC_WORKSPACE_ID | 워크로드 ID 페더레이션용 워크스페이스 ID입니다. 페더레이션 규칙이 둘 이상의 워크스페이스로 범위가 지정되어 있을 때 토큰 교환이 어느 워크스페이스를 대상으로 할지 알 수 있도록 이를 설정합니다. |
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 출력이 전체 출력이 파일에 저장되고 Claude가 경로와 짧은 미리보기를 받기 전의 최대 문자 수입니다. 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 환경 변수를 통해 별도로 활성화해야 합니다. 이 변수만 설정해도 로깅이 활성화되지 않습니다. --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_AGENT_VIEW | 백그라운드 에이전트 및 에이전트 보기를 끄려면 1로 설정합니다: claude agents, --bg, /background, 온디맨드 감독자. disableAgentView 설정과 동일합니다. |
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, DO_NOT_TRACK, 또는 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC이 설정되면 설문조사도 비활성화됩니다. CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL이 다시 옵트인하지 않으면 설문조사 샘플 레이트를 설정하려면 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_FEEDBACK_SURVEY_FOR_OTEL | Anthropic 바운드 비필수 트래픽이 차단될 때 “Claude가 어떻게 하고 있나요?” 세션 품질 설문조사를 자신의 OpenTelemetry 수집기로 라우팅하려면 1로 설정합니다. 설문조사 등급은 구성된 수집기에 OTEL 이벤트로만 내보내집니다. 이 모드에서는 설문조사 데이터가 Anthropic으로 전송되지 않습니다. CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, DISABLE_TELEMETRY, 또는 DO_NOT_TRACK이 설정되었을 때 적용되며, 그렇지 않으면 효과가 없습니다. CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY 및 조직 제품 피드백 정책이 우선합니다. |
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_OPUS_4_7_FAST_MODE | 빠른 모드를 Claude Opus 4.7에서 실행하려면 1로 설정합니다. Opus 4.6 대신 변수를 설정하면 /fast가 Opus 4.7로 전환됩니다. 변수가 없으면 /fast는 계속 Opus 4.6을 사용합니다. |
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_MAX_TURNS | 명시적 제한이 전달되지 않을 때 에이전트 턴 수를 제한합니다. --max-turns 전달과 동일하며, 둘 다 설정되면 우선합니다. 양의 정수가 아닌 값은 제한이 없는 것으로 취급되지 않고 오류와 함께 시작 시 거부됩니다. |
CLAUDE_CODE_MCP_ALLOWLIST_ENV | stdio MCP 서버를 안전한 기본 환경과 서버의 구성된 env만으로 생성하려면 1로 설정합니다. 셸 환경을 상속하지 않습니다. |
CLAUDE_CODE_NATIVE_CURSOR | 터미널의 자체 커서를 입력 캐럿에서 그려진 블록 대신 표시하려면 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_OPUS_4_6_FAST_MODE_OVERRIDE | 빠른 모드를 Claude Opus 4.6에서 유지하려면 1로 설정합니다. CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE보다 우선하므로, 기본값이 어떻게 변경되든 Opus 4.6을 고정해야 하는 경우 이를 설정합니다. |
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_PREFER_HTTPS | GitHub owner/repo 플러그인 소스를 SSH 대신 HTTPS를 통해 복제하려면 1로 설정합니다. CI 러너, 컨테이너 또는 github.com에 대해 구성된 SSH 키가 없는 모든 환경에서 유용합니다. |
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_RESUME_PROMPT | 세션이 중간에 끝난 후 재개할 때 주입되는 계속 메시지를 재정의합니다. 기본값은 Continue from where you left off.입니다. 장시간 실행되는 에이전트의 스폰 스크립트는 이를 더 지시적인 부팅 메시지로 설정할 수 있습니다. 빈 문자열은 기본값을 사용합니다. |
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 | 모든 모델에서 더 짧은 시스템 프롬프트 및 축소된 도구 설명을 사용하려면 1로 설정합니다. 0, false, no, 또는 off로 설정하여 실험 또는 서버 구성이 그렇지 않으면 활성화할 때에도 옵트아웃합니다. 전체 도구 세트, 훅, MCP 서버, CLAUDE.md 검색은 계속 활성화됩니다. |
CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH | Claude Platform on AWS에 대한 클라이언트 측 인증을 건너뜁니다. 게이트웨이가 요청에 자체 서명하는 경우 |
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_ANTHROPIC_AWS | Claude Platform on AWS 사용 |
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이 필요합니다. |
DEBUG | 디버그 모드를 활성화하려면 1로 설정합니다. --debug로 실행하는 것과 동일합니다. 디버그 로그는 ~/.claude/debug/<session-id>.txt에 기록되거나 CLAUDE_CODE_DEBUG_LOGS_DIR로 설정된 경로에 기록됩니다. 1, true, yes, on의 참 값만 디버그 모드를 활성화하므로 다른 도구에 대해 설정된 DEBUG=express:*와 같은 네임스페이스 패턴은 이를 트리거하지 않습니다. |
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로 설정합니다. |
DO_NOT_TRACK | 원격 분석을 거부하려면 1로 설정합니다. DISABLE_TELEMETRY 설정과 동일합니다. 표준 교차 도구 규칙로 인정됩니다. |
ENABLE_CLAUDEAI_MCP_SERVERS | Claude Code에서 claude.ai MCP 서버를 비활성화하려면 false로 설정합니다. 로그인한 사용자의 경우 기본적으로 활성화됩니다. |
ENABLE_PROMPT_CACHING_1H | API 키, Bedrock, Vertex, Foundry, Claude Platform on AWS 사용자를 위해 기본 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(항상 연기 및 베타 헤더 전송, Vertex AI 또는 tool_reference를 지원하지 않는 프록시에서 요청 실패), 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의 리전을 재정의합니다. |
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 및 신호별 변형)도 지원됩니다. 구성 세부 정보는 모니터링을 참조합니다.