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 리전 재정의 |
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 출력이 전체 출력이 파일에 저장되고 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-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_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 | Opus 4.7에서 최소 시스템 프롬프트 및 축소된 도구 설명을 사용하려면 1로 설정합니다. 다른 모델에는 효과가 없습니다. 전체 도구 세트, 훅, 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이 필요합니다. |
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 및 신호별 변형)도 지원됩니다. 구성 세부 정보는 모니터링을 참조합니다.