환경 변수

Claude Code 동작을 제어하는 환경 변수에 대한 참고 자료입니다.

환경 변수는 모델 선택, 인증, 요청 라우팅 및 기능 토글과 같은 Claude Code 동작을 제어할 수 있습니다. 동일한 동작의 대부분은 설정 파일 필드, CLI 플래그 또는 /model과 같은 세션 내 명령을 통해서도 구성할 수 있습니다.

이 페이지에서는 다음을 다룹니다:

환경 변수 설정 방법 (셸 또는 설정 파일에서)
동작을 설정할 수 있는 방법이 여러 개일 때 어떤 값이 적용되는지 확인
Claude Code가 읽는 변수 조회
변수가 기능 플래그 가져오기를 끄면 어떤 기능이 작동을 멈추는지 확인

환경 변수 설정

셸에서 설정한 변수는 해당 터미널 세션 동안만 유지되며, 설정 파일의 변수는 claude가 실행될 때마다 적용됩니다.

셸에서

claude를 실행하기 전에 변수를 설정합니다:

export API_TIMEOUT_MS="1200000"
claude

모든 세션에서 설정하려면 ~/.bashrc, ~/.zshrc 또는 셸의 프로필 파일에 export 줄을 추가합니다.

$env:API_TIMEOUT_MS = "1200000"
claude

모든 세션에서 설정하려면 [Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", "1200000", "User")를 실행하고 새 터미널을 엽니다.

set API_TIMEOUT_MS=1200000
claude

모든 세션에서 설정하려면 setx API_TIMEOUT_MS "1200000"을 실행하고 새 터미널을 엽니다.

할당 줄은 성공 시 아무것도 출력하지 않으므로, claude를 실행하기 전에 같은 셸에서 변수를 출력하여 설정되었는지 확인합니다:

echo $API_TIMEOUT_MS

echo $env:API_TIMEOUT_MS

echo %API_TIMEOUT_MS%

설정 파일에서

settings.json 파일의 env 키 아래에 변수를 추가하고, 파일이 없으면 생성합니다. Claude Code는 파일에서 직접 읽으므로 claude가 어떻게 실행되었는지와 관계없이 적용됩니다. 실행 중인 세션은 파일을 저장할 때 새로운 값과 변경된 값을 환경에 적용하지만, OpenTelemetry 모니터링과 같이 시작 시 변수를 한 번만 읽는 기능은 다시 실행할 때까지 시작 값을 유지합니다. 파일에서 변수를 제거해도 실행 중인 세션에서 설정 해제되지 않으며, 제거는 다음 번 claude를 실행할 때 적용됩니다.

{
  "env": {
    "API_TIMEOUT_MS": "1200000",
    "BASH_DEFAULT_TIMEOUT_MS": "300000"
  }
}

선택한 파일은 변수가 적용되는 대상을 제어합니다:

파일	적용 대상
`~/.claude/settings.json`	모든 프로젝트에서 사용자
`.claude/settings.json`	소스 제어에 체크인된 프로젝트에서 작업하는 모든 사람
`.claude/settings.local.json`	이 프로젝트에서만 사용자, Claude Code가 설정을 저장할 때 gitignored됨; 직접 생성하는 경우 gitignore에 추가합니다
관리되는 설정	관리자가 배포한 조직의 모든 사람

각 파일이 있는 위치는 설정 파일을 참조하고, 둘 이상이 같은 변수를 설정할 때 결합되는 방식은 설정 우선순위를 참조합니다.

우선순위

일부 동작은 환경 변수와 전용 설정 키 모두를 가지고 있으며, Claude Code가 어느 것을 먼저 읽는지는 키마다 다릅니다. ANTHROPIC_MODEL과 CLAUDE_CODE_AUTO_CONNECT_IDE의 경우, Claude Code는 변수를 먼저 읽고 변수가 설정되지 않았을 때만 model 또는 autoConnectIde 설정을 사용합니다. 설정하려는 쌍의 경우, 아래의 변수 행과 설정 참조의 키 항목을 확인하십시오.

동일한 변수가 셸과 설정 파일 env 블록 모두에 설정된 경우, 설정 파일 값이 적용됩니다. Claude Code는 각 env 항목을 프로세스 환경에 기록하여 셸에서 상속된 값을 대체합니다. env 설정은 언제 적용되는지를 나타냅니다. 몇 가지 변수는 특별하게 처리됩니다. env 설정은 예외를 나열합니다.

설정 파일에서 변수를 설정할 수 있지만 제거할 수는 없습니다. 제어하지 않는 셸 프로필에서 내보낸 CLAUDE_CODE_USE_VERTEX와 같이 설정 해제할 수 없는 변수를 재정의하려면, env 블록에서 빈 문자열로 설정하십시오: "CLAUDE_CODE_USE_VERTEX": "". Claude Code는 빈 값을 공급자 선택을 위해 설정 해제된 것으로 취급합니다. 하위 프로세스는 여전히 빈 값을 상속합니다.

설정 파일 간에 env 값은 설정 우선순위를 따르므로, 관리되는 설정 항목이 사용자 또는 프로젝트 설정의 동일한 변수를 재정의합니다.

환경 변수가 CLI 플래그 및 세션 내 명령과 상호 작용하는 방식은 기능마다 다릅니다: --model과 /model은 ANTHROPIC_MODEL을 재정의하고, CLAUDE_CODE_EFFORT_LEVEL은 --effort와 /effort를 재정의합니다. 변수가 다른 구성 소스와 상호 작용할 때, 변수 목록의 해당 행은 우선순위를 나타내거나 이를 문서화하는 페이지로 연결됩니다.

Claude Code는 시작 시 셸 환경 변수를 읽으므로, 이에 대한 변경 사항은 다음에 claude를 시작할 때 적용됩니다. 설정 파일의 env 키 아래에 설정된 변수는 파일이 변경될 때 실행 중인 세션에 다시 적용되며, 설정 파일에서에 설명된 시작 전용 예외가 있습니다.

변수

숫자 변수(예: 타임아웃, 토큰 예산, 재시도 횟수)는 일반 숫자 외에도 과학 표기법과 숫자 구분 기호 표기법을 허용합니다. 단, 변수의 행에서 일반 숫자만 사용한다고 명시한 경우는 제외됩니다. 예를 들어 Claude Code는 2e3을 2000으로, 64_000을 64000으로 읽습니다. v2.1.211 이전에는 이러한 표기법이 타임아웃을 1로 설정하는 1e6과 같이 훨씬 작은 값을 자동으로 설정할 수 있었습니다.

변수	목적
`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`	AWS의 Claude Platform용 워크스페이스 API 키이며, AWS 콘솔에서 생성됩니다. `x-api-key`로 전송되며 AWS SigV4보다 우선합니다
`ANTHROPIC_AWS_BASE_URL`	AWS의 Claude Platform 엔드포인트 URL을 재정의합니다. 사용자 정의 리전이나 LLM 게이트웨이를 통한 라우팅에 사용합니다. 기본값은 `https://aws-external-anthropic.{region}.api.aws`입니다. Claude Code는 Amazon Bedrock과 동일한 우선순위로 리전을 확인합니다
`ANTHROPIC_AWS_WORKSPACE_ID`	AWS의 Claude Platform에 필수입니다. 모든 요청에서 `anthropic-workspace-id` 헤더로 전송됩니다
`ANTHROPIC_BASE_URL`	API 엔드포인트를 재정의하여 프록시 또는 게이트웨이를 통해 요청을 라우팅합니다. 비자사 호스트로 설정되면, MCP 도구 검색이 기본적으로 비활성화됩니다. 프록시가 `tool_reference` 블록을 전달하면 `ENABLE_TOOL_SEARCH=true`를 설정하세요. v2.1.196부터 원격 제어는 이것이 `api.anthropic.com` 이외의 호스트를 가리킬 때 비활성화되며, Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry의 동작과 일치합니다
`ANTHROPIC_BEDROCK_BASE_URL`	Amazon Bedrock 엔드포인트 URL을 재정의합니다. 사용자 정의 Amazon Bedrock 엔드포인트나 LLM 게이트웨이를 통한 라우팅에 사용합니다. Amazon Bedrock을 참조하세요
`ANTHROPIC_BEDROCK_MANTLE_BASE_URL`	Amazon Bedrock Mantle 엔드포인트 URL을 재정의합니다. Mantle 엔드포인트를 참조하세요
`ANTHROPIC_BEDROCK_REGION_PREFIX`	교차 리전 추론 프로필 접두사(`us`, `eu`, `apac`, `jp`, `au`, 또는 `global`) Claude Code가 AWS 리전에서 파생된 것 대신 먼저 시도합니다. AWS GovCloud 리전에서는 무시됩니다. Claude Code v2.1.224 이상이 필요합니다. Amazon Bedrock을 참조하세요
`ANTHROPIC_BEDROCK_SERVICE_TIER`	Amazon 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` 형식, 여러 헤더의 경우 줄바꿈으로 구분). 이름이나 값에 곡선 따옴표나 너비가 0인 공백과 같이 HTTP 헤더가 전달할 수 없는 문자가 포함되면, 요청이 쌍을 위치로 식별하는 오류로 실패합니다. Claude Code v2.1.227 이상이 필요합니다. 잘못된 요청 헤더 값은 정확한 문자 집합과 검사가 실행되는 위치를 나열합니다. 자격 증명, 조직 또는 테넌트, 라우팅 또는 API 동작 헤더(예: `Authorization` 또는 `Host`)를 설정하는 값은 서버 관리 설정이 전달할 때 승인이 필요한 설정으로 계산됩니다. 프로젝트 또는 로컬 설정에서 이러한 값은 `env` 값이 적용되는 시기에 대한 규칙을 따릅니다
`ANTHROPIC_CUSTOM_MODEL_OPTION`	`/model` 선택기에 사용자 정의 항목으로 추가할 모델 ID입니다. 기본 제공 별칭을 대체하지 않고 비표준 또는 게이트웨이 특정 모델을 선택 가능하게 만드는 데 사용합니다. 모델 구성을 참조하세요
`ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION`	`/model` 선택기의 사용자 정의 모델 항목에 대한 표시 설명입니다. 설정되지 않으면 `Custom model (<model-id>)`로 기본값이 설정됩니다
`ANTHROPIC_CUSTOM_MODEL_OPTION_NAME`	`/model` 선택기의 사용자 정의 모델 항목에 대한 표시 이름입니다. 설정되지 않으면, Claude Code가 ID를 인식하면 항목에 모델의 이름이 표시되고, 그렇지 않으면 모델 ID가 표시됩니다
`ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES`	사용자 정의 모델이 지원하는 기능의 쉼표로 구분된 목록입니다(예: `effort,thinking`). 모델 구성을 참조하세요
`ANTHROPIC_DEFAULT_FABLE_MODEL`	`fable` 별칭이 확인되는 모델 ID이며, Claude Code가 타사 제공자에서 자동 모델 폴백을 위해 Fable 모델로 인식하는 ID입니다. 모델 구성을 참조하세요
`ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION`	`/model` 선택기에서 고정된 Fable 모델에 대한 표시 설명입니다. 설정되지 않으면, 행에 `Custom Fable model`로 시작하는 기본 설명이 표시됩니다. 모델 구성을 참조하세요
`ANTHROPIC_DEFAULT_FABLE_MODEL_NAME`	`/model` 선택기에서 고정된 Fable 모델에 대한 표시 이름입니다. 설정되지 않으면, Claude Code가 고정된 ID를 인식하면 행에 모델의 이름이 표시되고, 그렇지 않으면 고정된 ID가 표시됩니다. 모델 구성을 참조하세요
`ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES`	고정된 Fable 모델이 지원하는 기능의 쉼표로 구분된 목록입니다(예: `effort,thinking`). 모델 구성을 참조하세요
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	`haiku` 별칭이 확인되는 모델 ID이며, 배경 기능에도 사용됩니다. 모델 구성을 참조하세요
`ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION`	`/model` 선택기에서 고정된 Haiku 모델에 대한 표시 설명입니다. 설정되지 않으면, 행에 `Custom Haiku model`로 시작하는 기본 설명이 표시됩니다. 모델 구성을 참조하세요
`ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME`	`/model` 선택기에서 고정된 Haiku 모델에 대한 표시 이름입니다. 설정되지 않으면, Claude Code가 고정된 ID를 인식하면 행에 모델의 이름이 표시되고, 그렇지 않으면 고정된 ID가 표시됩니다. 모델 구성을 참조하세요
`ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES`	고정된 Haiku 모델이 지원하는 기능의 쉼표로 구분된 목록입니다(예: `effort,thinking`). 모델 구성을 참조하세요
`ANTHROPIC_DEFAULT_MODEL`	새 세션이 기본적으로 시작되는 모델입니다. Claude Code v2.1.236 이상이 필요합니다. 새 세션의 기본 모델 설정을 참조하세요
`ANTHROPIC_DEFAULT_OPUS_MODEL`	`opus` 별칭이 확인되는 모델 ID이며, Plan Mode가 활성화되어 있을 때 `opusplan`이 사용하는 ID입니다. 모델 구성을 참조하세요
`ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION`	`/model` 선택기에서 고정된 Opus 모델에 대한 표시 설명입니다. 설정되지 않으면, 행에 `Custom Opus model`로 시작하는 기본 설명이 표시됩니다. 모델 구성을 참조하세요
`ANTHROPIC_DEFAULT_OPUS_MODEL_NAME`	`/model` 선택기에서 고정된 Opus 모델에 대한 표시 이름입니다. 설정되지 않으면, Claude Code가 고정된 ID를 인식하면 행에 모델의 이름이 표시되고, 그렇지 않으면 고정된 ID가 표시됩니다. 모델 구성을 참조하세요
`ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES`	고정된 Opus 모델이 지원하는 기능의 쉼표로 구분된 목록입니다(예: `effort,thinking`). 모델 구성을 참조하세요
`ANTHROPIC_DEFAULT_SONNET_MODEL`	`sonnet` 별칭이 확인되는 모델 ID이며, Plan Mode가 활성화되지 않았을 때 `opusplan`이 사용하는 ID입니다. 모델 구성을 참조하세요
`ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION`	`/model` 선택기에서 고정된 Sonnet 모델에 대한 표시 설명입니다. 설정되지 않으면, 행에 `Custom Sonnet model`로 시작하는 기본 설명이 표시됩니다. 모델 구성을 참조하세요
`ANTHROPIC_DEFAULT_SONNET_MODEL_NAME`	`/model` 선택기에서 고정된 Sonnet 모델에 대한 표시 이름입니다. 설정되지 않으면, Claude Code가 고정된 ID를 인식하면 행에 모델의 이름이 표시되고, 그렇지 않으면 고정된 ID가 표시됩니다. 모델 구성을 참조하세요
`ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES`	고정된 Sonnet 모델이 지원하는 기능의 쉼표로 구분된 목록입니다(예: `effort,thinking`). 모델 구성을 참조하세요
`ANTHROPIC_FEDERATION_RULE_ID`	워크로드 ID 페더레이션을 위한 페더레이션 규칙 ID입니다. `ANTHROPIC_ORGANIZATION_ID`와 함께 설정하면, Claude Code는 페더레이션 자격 증명을 선택하며, 이는 `/login` 자격 증명보다 우선합니다. 인증 우선순위를 참조하세요
`ANTHROPIC_FOUNDRY_API_KEY`	Microsoft Foundry 인증용 API 키입니다(Microsoft Foundry 참조)
`ANTHROPIC_FOUNDRY_AUTH_TOKEN`	Microsoft Foundry 인증용 Bearer 토큰입니다(예: Microsoft Entra 액세스 토큰). Claude Code는 이를 `Authorization: Bearer` 헤더로 전송합니다. `ANTHROPIC_FOUNDRY_API_KEY`와 Azure 기본 자격 증명 체인보다 우선합니다. Microsoft Foundry를 참조하세요. Claude Code v2.1.203 이상이 필요합니다
`ANTHROPIC_FOUNDRY_BASE_URL`	Microsoft Foundry 리소스의 전체 기본 URL입니다(예: `https://my-resource.services.ai.azure.com/anthropic`). `ANTHROPIC_FOUNDRY_RESOURCE`의 대안입니다(Microsoft Foundry 참조)
`ANTHROPIC_FOUNDRY_RESOURCE`	Microsoft Foundry 리소스 이름입니다(예: `my-resource`). `ANTHROPIC_FOUNDRY_BASE_URL`이 설정되지 않으면 필수입니다(Microsoft Foundry 참조)
`ANTHROPIC_MODEL`	사용할 모델 설정의 이름입니다(모델 구성 참조)
`ANTHROPIC_ORGANIZATION_ID`	워크로드 ID 페더레이션을 위한 조직 ID입니다. `ANTHROPIC_FEDERATION_RULE_ID`와 함께 설정하세요. 인증 우선순위를 참조하세요
`ANTHROPIC_PROFILE`	인증할 Anthropic 프로필의 이름입니다(예: `ant auth login`으로 생성되거나 API 키 없이 Console 계정에 로그인하여 생성된 프로필). 인증 우선순위를 참조하세요
`ANTHROPIC_SMALL_FAST_MODEL`	[더 이상 사용되지 않음] 배경 작업용 Haiku 클래스 모델의 이름입니다
`ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION`	Amazon Bedrock 또는 Amazon Bedrock Mantle을 사용할 때 Haiku 클래스 모델의 AWS 리전을 재정의합니다. Amazon Bedrock에서는 `ANTHROPIC_DEFAULT_HAIKU_MODEL` 또는 더 이상 사용되지 않는 `ANTHROPIC_SMALL_FAST_MODEL`도 설정되어 있을 때만 적용됩니다. Amazon Bedrock은 그렇지 않으면 기본 Sonnet 모델 또는 세션 리전의 기본 모델에서 배경 작업을 실행하기 때문입니다
`ANTHROPIC_VERTEX_BASE_URL`	Google Cloud의 Agent Platform 엔드포인트 URL을 재정의합니다. 사용자 정의 Google Cloud의 Agent Platform 엔드포인트나 LLM 게이트웨이를 통한 라우팅에 사용합니다. Google Cloud의 Agent Platform을 참조하세요
`ANTHROPIC_VERTEX_PROJECT_ID`	Google Cloud의 Agent Platform 요청이 주소 지정되는 GCP 프로젝트 ID입니다. GCP 자격 증명 구성을 참조하세요
`ANTHROPIC_WORKSPACE_ID`	워크로드 ID 페더레이션을 위한 워크스페이스 ID입니다. 페더레이션 규칙이 둘 이상의 워크스페이스로 범위가 지정되어 있을 때 설정하여 토큰 교환이 어느 워크스페이스를 대상으로 할지 알 수 있도록 합니다
`API_FORCE_IDLE_TIMEOUT`	바이트가 도착하지 않을 때 스트리밍 모델 응답을 중단하는 5분 본문 유휴 타임아웃을 재정의합니다. 느린 게이트웨이 또는 로컬 모델이 청크 사이에 5분 이상 일시 중지되는 경우 `0`으로 설정하여 타임아웃을 끕니다. 또는 모든 제공자에 대해 켜려면 `1`로 설정합니다. 설정되지 않으면, 타임아웃은 직접 Anthropic API 및 AWS의 Claude Platform 이외의 제공자에서 활성화됩니다. 스트림 감시견은 독립적으로 실행되며 여기서 `0`을 설정해도 긴 침묵을 중단합니다
`API_TIMEOUT_MS`	API 요청의 타임아웃(밀리초)(기본값: 600000, 또는 10분; 최대값: 2147483647). 느린 네트워크에서 요청이 타임아웃되거나 프록시를 통해 라우팅할 때 이를 증가시킵니다. 최대값 이상의 값은 기본 타이머를 오버플로우하여 요청이 즉시 실패합니다
`AWS_BEARER_TOKEN_BEDROCK`	Amazon Bedrock 인증용 API 키입니다(Amazon Bedrock API 키 참조)
`BASH_DEFAULT_TIMEOUT_MS`	장시간 실행되는 bash 명령의 기본 타임아웃입니다(기본값: 120000, 또는 2분)
`BASH_MAX_OUTPUT_LENGTH`	Claude Code가 명령 결과로 다시 읽는 bash 출력의 최대 문자 수입니다(기본값: 30000; 최대값: 150000). `bashOutputMaxChars` 설정을 설정하면, Claude Code는 이 변수를 무시합니다. 출력 제한을 참조하세요
`BASH_MAX_TIMEOUT_MS`	모델이 장시간 실행되는 bash 명령에 대해 설정할 수 있는 최대 타임아웃입니다(기본값: 600000, 또는 10분). 유효한 상한은 이것과 `BASH_DEFAULT_TIMEOUT_MS` 중 더 큰 값입니다
`BETA_TRACING_ENDPOINT`	상세 베타 추적을 위한 OTLP 엔드포인트입니다: `ENABLE_BETA_TRACING_DETAILED=1`을 사용하면, 로그와 추적이 구성된 내보내기 대신 여기로 이동합니다. 셸, 사용자 설정 또는 관리 설정에서 설정하세요. 프로젝트 및 로컬 설정에서는 무시됩니다
`CCR_FORCE_BUNDLE`	`claude --cloud`가 원격에서 복제하는 대신 로컬 리포지토리를 번들로 묶고 업로드하도록 강제하려면 `1`로 설정하세요
`CLAUDECODE`	Claude Code가 생성하는 서브프로세스(Bash 및 PowerShell 도구, tmux 세션, 훅 명령, 상태 줄 명령, stdio MCP 서버 서브프로세스)에서 `1`로 설정합니다. IDE 확장도 통합 터미널에서 이를 설정합니다. 스크립트가 Claude Code에서 생성한 서브프로세스 내에서 실행 중인지 감지하는 데 사용합니다. 도구 호출 또는 훅에 의해 직접 생성된 현재 프로세스인지, 아니면 Claude Code가 시작한 stdio MCP 서버 내부인지 확인하려면 `CLAUDE_CODE_CHILD_SESSION`을 대신 사용하세요
`CLAUDE_AFK_COUNTDOWN_MS`	자동 계속 전에 응답하지 않은 `AskUserQuestion` 대화 상자에 화면상 카운트다운이 나타나기 전의 밀리초 수입니다. 기본값 `20000`(20초), 자동 계속 타임아웃으로 제한됩니다. 자동 계속이 켜져 있지 않으면 효과가 없습니다. `askUserQuestionTimeout` 설정 및 `CLAUDE_AFK_TIMEOUT_MS`를 참조하세요. Claude Code v2.1.198 이상이 필요합니다
`CLAUDE_AFK_TIMEOUT_MS`	응답하지 않은 `AskUserQuestion` 대화 상자가 자동으로 계속되기 전의 유휴 시간(밀리초)입니다. 자동 계속은 기본적으로 꺼져 있습니다. `askUserQuestionTimeout` 설정으로 옵트인하세요. 이 변수는 데모 및 자동화된 테스트를 위한 재정의입니다: 설정되면 해당 설정보다 우선하고 설정이 설정 해제되거나 `never`인 경우에도 자동 계속을 켭니다. `0`을 설정해도 타임아웃이 꺼지지 않습니다. 대화 상자가 즉시 닫힙니다. v2.1.198 및 v2.1.199에서는 자동 계속이 기본적으로 켜져 있었고 `60000`(60초) 타임아웃이 있었습니다. Claude Code v2.1.198 이상이 필요합니다
`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`	모든 기본 제공 서브에이전트 유형(예: Explore 및 Plan)을 비활성화하려면 `1`로 설정하세요. 비대화형 모드(`-p` 플래그)에만 적용됩니다. SDK 사용자가 깨끗한 상태를 원할 때 유용합니다. 이는 또한 `general-purpose`를 제거합니다. 이는 Agent 도구 호출이 `subagent_type`을 생략할 때 Claude Code가 실행하는 서브에이전트입니다. 그러한 호출은 `subagent_type is required`로 실패합니다
`CLAUDE_AGENT_SDK_MCP_NO_PREFIX`	SDK에서 생성한 MCP 서버의 도구 이름에서 `mcp__<server>__` 접두사를 건너뛰려면 `1`로 설정하세요. 도구는 원래 이름을 사용합니다. SDK 사용만 해당
`CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`	서브에이전트의 밀리초 단위 정지 타임아웃입니다. 기본값 `600000`(10분); `CLAUDE_STREAM_IDLE_TIMEOUT_MS`를 높이고 스트림 감시견이 켜져 있으면, 기본값이 함께 올라갑니다. 느리거나 정지된 API 응답 처리에서 설명합니다. 타이머는 각 스트리밍 진행 이벤트에서 재설정됩니다. 창 내에 진행이 도착하지 않으면, Claude Code는 서브에이전트를 중단하고 정지를 부모에 보고합니다
`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`	자동 압축이 트리거되는 자동 압축 창의 백분율(1-100)을 설정합니다. `50`과 같은 낮은 값을 사용하여 더 일찍 압축합니다. 변수는 임계값을 높일 수 없으므로 기본 백분율 이상의 값은 무시됩니다. 모델의 컨텍스트 제한 전에 압축하는 세션에만 적용됩니다. 주 대화 및 서브에이전트 모두에 적용됩니다
`CLAUDE_AUTO_BACKGROUND_TASKS`	장시간 실행되는 에이전트 작업의 자동 백그라운드 처리를 강제로 활성화하려면 `1`로 설정하세요. 활성화되면, 서브에이전트는 약 2분 동안 실행한 후 백그라운드로 이동합니다. 또한 Claude Code v2.1.212 이상의 비대화형 모드에서 장시간 MCP 도구 호출의 자동 백그라운드 처리를 활성화합니다
`CLAUDE_AX_PREPARK_MS`	화면 판독기 모드에서, Claude Code가 커서를 줄의 시작에 두고 새로운 또는 변경된 줄을 쓰기 전에 대기하는 밀리초 수입니다. 기본값 `50`. 즉시 쓰려면 `0`으로 설정하세요. Claude Code는 대기를 `5000`으로 제한합니다. Claude Code v2.1.233 이상이 필요합니다
`CLAUDE_AX_SCREEN_READER`	화면 판독기 친화적 출력을 렌더링하려면 `1`로 설정하세요: 장식 테두리나 애니메이션 없는 평면 텍스트입니다. `axScreenReader`가 `true`인 경우에도 화면 판독기 모드를 강제로 끄려면 `0`으로 설정하세요. `--ax-screen-reader` 플래그가 우선합니다. Claude Code v2.1.181 이상이 필요합니다
`CLAUDE_AX_STARTUP_QUIET_MS`	화면 판독기 모드에서, Claude Code가 시작 확인 줄 후 첫 번째 인터페이스 렌더링을 보유하는 밀리초 수이므로 화면 판독기가 새 출력이 중단되기 전에 줄을 완전히 말할 수 있습니다. 기본값 `3000`. 즉시 렌더링하려면 `0`으로 설정하세요. Claude Code는 보유를 `600000`(10분)으로 제한합니다. 첫 번째 키 입력이 보유를 조기에 끝냅니다. Claude Code v2.1.217 이상이 필요합니다
`CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR`	주 세션에서 각 Bash 또는 PowerShell 명령 후 원래 작업 디렉토리로 돌아갑니다
`CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS`	바이트 수준 스트리밍 유휴 감시견의 밀리초 단위 타임아웃입니다. 설정되면, 해당 감시견에 대해 `CLAUDE_STREAM_IDLE_TIMEOUT_MS`보다 우선하고 이벤트 수준 감시견은 변경하지 않습니다. Claude Code는 이 변수를 10초에서 30분 사이로 제한합니다. Claude Code v2.1.210 이상이 필요합니다
`CLAUDE_CLIENT_PRESENCE_FILE`	화면 잠금 수신기와 같은 외부 도구가 화면을 잠금 해제할 때 생성하고 잠금할 때 삭제하는 파일의 경로입니다. 파일이 존재하는 동안, Claude Code는 원격 제어 모바일 푸시 알림을 건너뜁니다. 따라서 컴퓨터를 적극적으로 사용하는 동안 푸시를 받지 않습니다. 파일이 없거나 읽을 수 없으면, 알림이 정상적으로 전송됩니다. Claude Code는 파일을 폴링하지 않고 푸시 트리거 이벤트당 한 번 확인합니다. Claude Code v2.1.181 이상이 필요합니다
`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_ALT_SCREEN_FULL_REPAINT`	전체 화면 렌더링에서 증분 업데이트를 보내는 대신 모든 프레임에서 전체 화면을 다시 칠하려면 `1`로 설정하세요. 전체 화면 모드에서 오래되거나 잘못 배치된 텍스트 조각이 표시되면 이를 사용하세요. Claude Code는 Windows의 백그라운드 세션 및 에이전트 보기에 대해 자동으로 이를 활성화합니다
`CLAUDE_CODE_ALWAYS_ENABLE_EFFORT`	Claude Code가 모델 ID를 노력 가능으로 인식하지 않더라도 모든 요청과 함께 노력 매개변수를 보내려면 `1`로 설정하세요. LLM 게이트웨이 또는 사용자 정의 식별자로 모델을 제공하는 타사 제공자를 통해 라우팅할 때 사용합니다. Claude 3 모델, Sonnet 4.0 및 4.5, Opus 4.0 및 4.1, Haiku 4.5를 포함하여 API에서 노력 매개변수를 거부하는 모델은 요청이 실패하지 않도록 제외됩니다
`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`	자격 증명을 새로 고쳐야 하는 간격(밀리초)입니다(`apiKeyHelper` 사용 시)
`CLAUDE_CODE_ARTIFACT_AUTO_OPEN`	새 아티팩트가 게시될 때 Claude Code가 브라우저를 자동으로 열지 않도록 하려면 `0`으로 설정하세요
`CLAUDE_CODE_ARTIFACT_COMMENTS`	Claude가 아티팩트에 대한 댓글을 읽고 회신하지 않도록 하려면 `0`으로 설정하세요. `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`이 아티팩트를 꺼도록 설정되었을 때는 효과가 없습니다. Claude Code v2.1.221 이상이 필요합니다
`CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT`	Claude가 자신에게 전송된 댓글에 자동으로 회신하지 않도록 하려면 `0`으로 설정하세요. Claude Code v2.1.228 이상이 필요합니다
`CLAUDE_CODE_ATTRIBUTION_HEADER`	클라이언트 버전과 프롬프트 지문을 전달하는 속성 블록을 시스템 프롬프트의 시작에서 생략하려면 `0`으로 설정하세요. Anthropic API에 대한 직접 연결의 캐싱은 어느 쪽이든 영향을 받지 않습니다. 일부 직접 연결 설정에서, Claude Code는 `0`을 설정한 경우에도 자동 모드 분류기 요청에서 블록을 유지합니다. 시스템 프롬프트 속성 블록에서 이것이 적용되는 연결과 자격 증명을 확인하세요. v2.1.181 이전에는 블록이 사용자 정의 기본 URL 및 Microsoft Foundry 연결에 대한 요청당 토큰을 포함했으므로, 해당 버전에서는 LLM 게이트웨이가 요청 본문에 캐시하거나 요청을 타사 제공자에게 전달할 때, 또는 Microsoft Foundry에 직접 연결할 때 `0`으로 설정하세요
`CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS`	`CLAUDE_AUTO_BACKGROUND_TASKS`가 활성화되면, Claude에 여전히 실행 중인 백그라운드 서브에이전트를 확인하도록 상기시키는 간격(초)입니다. `1`에서 `86400`까지의 일반 정수만 허용합니다. 다른 값이나 표기법은 설정 해제로 읽힙니다. 설정되지 않으면 체크인 알림이 없습니다. Claude Code v2.1.248 이상이 필요합니다
`CLAUDE_CODE_AUTO_COMPACT_WINDOW`	자동 압축 창을 토큰 단위로 설정합니다(`100000`에서 `1000000`). `500000`과 같은 일반 정수만 허용합니다: `500k`와 같은 값은 `500`으로 읽고 100K 최소값으로 제한됩니다. 유효한 창은 또한 모델의 컨텍스트 창으로 제한됩니다. `/autocompact` 명령, `--autocompact` 플래그, `autoCompactWindow` 설정보다 우선합니다. 상태 줄의 `used_percentage`는 항상 모델의 전체 컨텍스트 창에 대해 측정되므로, 이 변수가 설정되면 해당 백분율은 더 이상 압축이 실행될 때를 나타내지 않습니다
`CLAUDE_CODE_AUTO_CONNECT_IDE`	자동 IDE 연결을 재정의합니다. 기본적으로 Claude Code는 지원되는 IDE의 통합 터미널 내에서 시작될 때 자동으로 연결됩니다. 이를 방지하려면 `false`로 설정하세요. tmux가 부모 터미널을 숨기는 경우와 같이 자동 감지가 실패할 때 연결 시도를 강제하려면 `true`로 설정하세요. `autoConnectIde` 전역 구성 설정보다 우선합니다
`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`	Claude Code가 AWS 기본 자격 증명 제공자 체인이 자격 증명을 생성할 때까지 대기하는 시간(밀리초)입니다. 요청이 `AWS default-chain credential resolve timed out`으로 실패하기 전입니다(기본값: `60000`). MFA를 사용한 브라우저 기반 SSO 로그인과 같이 체인의 단계가 합법적으로 더 오래 필요한 경우 이를 높이세요. `aws-vault`와 같은 래퍼를 통해 적용됩니다. Amazon Bedrock, AWS의 Claude Platform, Mantle 엔드포인트에서 Claude Code가 기본 체인으로 서명하는 모든 곳에 적용됩니다. Claude Code v2.1.207 이상이 필요합니다
`CLAUDE_CODE_BRIDGE_SESSION_ID`	세션에 활성 원격 제어 연결이 있는 동안 Bash 도구 및 훅 명령 서브프로세스에서 자동으로 설정되며, 연결이 끝나면 제거됩니다. 값은 `session_` 형식의 세션 ID이며, 세션의 `claude.ai/code` URL에 나타나는 동일한 식별자이므로 스크립트가 이를 실행한 세션으로 다시 연결할 수 있습니다. Claude Code v2.1.199 이상이 필요합니다. 클라우드 세션에서는 대신 `CLAUDE_CODE_REMOTE_SESSION_ID`를 읽으세요
`CLAUDE_CODE_BS_AS_CTRL_BACKSPACE`	Claude Code가 `0x08` 바이트(`^H`로도 작성됨)를 일반 백스페이스로 읽도록 하려면 `0`으로 설정하거나, Ctrl+백스페이스로 읽도록 하려면 `1`로 설정하세요. 어느 값이든 플랫폼 기본값을 대체합니다. 기본적으로 Claude Code는 `TERM_PROGRAM`이 `mintty`이거나 `TERM`이 `cygwin`인 경우를 제외하고 Windows에서 Ctrl+백스페이스로, macOS 및 Linux에서 일반 백스페이스로 읽습니다. Windows 터미널에서 `0`을 설정하세요. 백스페이스가 전체 단어를 삭제
`CLAUDE_CODE_CERT_STORE`	TLS 연결을 위한 CA 인증서 소스의 쉼표로 구분된 목록입니다. `bundled`는 Claude Code와 함께 제공되는 Mozilla CA 집합입니다. `system`은 운영 체제 신뢰 저장소이며, `tls.getCACertificates`가 있는 런타임에서만 읽습니다: 기본 바이너리 또는 npm 설치의 경우 Node 22.15 이상입니다. CA 인증서 저장소를 참조하세요. 기본값은 `bundled,system`입니다
`CLAUDE_CODE_CHILD_SESSION`	Bash, PowerShell, Monitor 도구, 훅 명령, 상태 줄 명령을 통해 Claude Code가 생성하는 서브프로세스에서 `1`로 설정됩니다. stdio MCP 서버 서브프로세스에는 설정되지 않습니다. 이는 장시간 실행되고 이를 생성한 세션보다 오래 지속됩니다. `CLAUDECODE`와 달리, 이는 Claude Code 자체가 서브프로세스를 시작할 때만 설정되며 IDE 확장에 의해 설정되지 않으므로, IDE 통합 터미널에서 시작된 최상위 `claude`와 중첩된 세션을 안정적으로 구분합니다. 이 방식으로 시작된 중첩된 대화형 `claude` TUI는 `--resume`, `--continue`, 위쪽 화살표 기록, `claude agents` 목록에서 자동으로 제외됩니다. 비대화형 `claude -p` 세션은 여전히 지속됩니다. `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1`을 설정하여 이 제외를 재정의하세요. Claude Code v2.1.172 이상이 필요합니다
`CLAUDE_CODE_CLIENT_CERT`	mTLS 인증을 위한 클라이언트 인증서 파일의 경로입니다
`CLAUDE_CODE_CLIENT_KEY`	mTLS 인증을 위한 클라이언트 개인 키 파일의 경로입니다
`CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`	암호화된 CLAUDE_CODE_CLIENT_KEY의 암호(선택 사항)
`CLAUDE_CODE_CONNECT_TIMEOUT_MS`	v2.1.186에서 제거되었으며 이제 작동하지 않습니다. 이전에는 스트리밍 API 요청의 연결, TLS, 응답 헤더 단계에 대해 별도의 타임아웃을 설정했습니다. 요청당 타임아웃에는 `API_TIMEOUT_MS`를 사용하세요. 스트리밍 요청의 응답 헤더 단계에는 `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`를 참조하세요
`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는 Sonnet 5와 Fable 모델과 같이 기본 1M 창을 가진 모델의 세션을 200K 창으로 유지합니다. 확장 컨텍스트에서 보유가 어떻게 적용되는지 참조하세요. 규정 준수 요구 사항이 있는 엔터프라이즈 환경에 유용합니다. 인식되지 않은 `[1m]` 모델 ID에 대한 창을 수정하는 역할에 대해서는 게이트웨이 또는 사용자 정의 모델 ID에 대한 창 수정을 참조하세요
`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`	Opus 4.6 및 Sonnet 4.6에서 적응형 추론을 비활성화하고 `MAX_THINKING_TOKENS`로 제어되는 고정 사고 예산으로 폴백하려면 `1`로 설정하세요. Fable 모델, Sonnet 5, Opus 4.7 이상에는 효과가 없습니다. 이들은 항상 적응형 추론을 사용합니다
`CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION`	Claude Code가 관리 설정 `env` 블록을 관리 소스 전체에서 키별로 병합하지 않도록 하려면 `1`로 설정하세요. v2.1.223 이전처럼 최고 우선순위 소스의 전체 `env` 블록만 적용됩니다. Claude Code를 시작하는 환경에서 설정하세요. Claude Code는 설정 `env` 블록을 통해 전달된 복사본을 무시합니다. Claude Code v2.1.223 이상이 필요합니다
`CLAUDE_CODE_DISABLE_ADVISOR_TOOL`	어드바이저 도구를 비활성화하려면 `1`로 설정하세요. `/advisor` 명령을 사용할 수 없게 되고, 구성된 `advisorModel`은 무시되며, `--advisor` 플래그는 허용되지만 효과가 없으므로 기존 스크립트가 오류 없이 계속 작동합니다
`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_ARTIFACT`	아티팩트 도구를 끄려면 `1`로 설정하세요. 이는 세션 출력을 claude.ai의 비공개 웹 페이지로 게시합니다. 설정되면, 설정 파일이 도구를 다시 켜지 않습니다. 대신 설정 파일에서 도구를 끄려면 `enableArtifact`를 `false`로 설정하세요. 더 이상 사용되지 않는 `disableArtifact` 키도 끕니다
`CLAUDE_CODE_DISABLE_ATTACHMENTS`	첨부 파일 처리를 비활성화하려면 `1`로 설정하세요. `@` 구문이 있는 파일 언급은 파일 내용으로 확장되지 않고 일반 텍스트로 전송됩니다
`CLAUDE_CODE_DISABLE_AUTO_MEMORY`	자동 메모리를 비활성화하려면 `1`로 설정하세요. `--bare` 모드 또는 `autoMemoryEnabled: false`가 그렇지 않으면 비활성화하더라도 자동 메모리를 강제로 켜려면 `0`으로 설정하세요. 비활성화되면, Claude는 자동 메모리 파일을 생성하거나 로드하지 않습니다
`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`	모든 백그라운드 작업 기능을 비활성화하려면 `1`로 설정하세요. Bash 및 서브에이전트 도구의 `run_in_background` 매개변수, 자동 백그라운드 처리, Ctrl+B 단축키 포함
`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT`	Claude Code가 Amazon Bedrock 스트리밍 응답을 누락되거나 빈 `Content-Type` 헤더가 있는 Amazon Bedrock의 이진 이벤트 스트림으로 처리하지 않도록 하려면 `1`로 설정하세요. 기본적으로 Claude Code는 게이트웨이가 그렇지 않으면 수정되지 않은 응답에서 헤더를 삭제했다고 가정하므로 본문을 디코딩하고 스트리밍이 계속 작동합니다. 게이트웨이가 스트림을 서버 전송 이벤트로 다시 내보내는 경우에만 설정하세요. Claude Code는 헤더 없는 본문을 서버 전송 이벤트로 읽습니다. Claude Code v2.1.239 이상이 필요합니다
`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD`	Amazon Bedrock 스트리밍 응답이 `application/vnd.amazon.eventstream` 콘텐츠 유형을 전달하는지 확인하는 것을 건너뛰려면 `1`로 설정하세요. 이 변수가 없으면, 응답이 다른 콘텐츠 유형을 전달할 때, Claude Code는 해당 유형을 명명하는 오류로 요청을 실패합니다. 이는 게이트웨이 또는 프록시가 응답을 변환하고 있음을 의미합니다. 이 변수를 설정하는 대신 게이트웨이를 구성하여 `Content-Type` 헤더와 본문을 수정되지 않은 상태로 전달하세요. Claude Code v2.1.208 이상이 필요합니다
`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`	백그라운드 세션의 실행 중인 백그라운드 셸 명령, 동적 워크플로우, v2.1.198부터 백그라운드 서브에이전트가 감독자가 해당 세션의 프로세스를 중지, 재시작 또는 업데이트할 때 다음 프로세스로 전달되지 않도록 하려면 `1`로 설정하세요. 해당 전달에만 영향을 미칩니다: `←` 또는 `/background`로 세션을 백그라운드 처리하면 여전히 진행 중인 작업을 전달하고, `CLAUDE_DISABLE_ADOPT`는 둘 다 끕니다. Claude Code v2.1.196 이상이 필요합니다
`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`	Claude Code가 운영 체제가 메모리 압력을 보고할 때 백그라운드 셸 명령을 종료하지 않도록 하려면 `1`로 설정하세요. 기본적으로 macOS 및 Linux에서 Claude Code는 세션이 30분 동안 유휴 상태이고 턴이나 서브에이전트가 실행 중이 아닐 때 메모리 압력 신호에서 주 세션에서 시작된 백그라운드 셸을 종료합니다. Windows에는 메모리 압력 신호가 없으므로 이 변수는 효과가 없습니다. Claude Code v2.1.193 이상이 필요합니다
`CLAUDE_CODE_DISABLE_BUNDLED_SKILLS`	Claude Code에 포함된 기술 및 워크플로우를 비활성화하려면 `1`로 설정하세요: 번들 기술 및 워크플로우는 완전히 제거되고, `/init`과 같은 기본 제공 명령은 입력 가능하지만 모델에서 숨겨집니다. `/doctor`는 기본 제공 명령처럼 입력 가능합니다. `DISABLE_DOCTOR_COMMAND`로 숨기세요. 플러그인, `.claude/skills/`, `.claude/commands/`의 기술은 영향을 받지 않습니다. `disableBundledSkills` 설정과 동일합니다
`CLAUDE_CODE_DISABLE_CFC_PROMPT`	Chrome의 Claude 브라우저 도구를 사용 가능하게 유지하면서 시스템 프롬프트의 Chrome 섹션과 `/claude-in-chrome` 번들 기술을 생략하려면 `1`로 설정하세요. Claude Code를 포함하고 자체 브라우저 지침을 제공하는 호스트용입니다. Claude Code v2.1.257 이상이 필요합니다
`CLAUDE_CODE_DISABLE_CLAUDE_MDS`	사용자, 프로젝트, 자동 메모리 파일을 포함한 CLAUDE.md 메모리 파일을 컨텍스트에 로드하지 않으려면 `1`로 설정하세요
`CLAUDE_CODE_DISABLE_CRON`	예약된 작업을 비활성화하려면 `1`로 설정하세요. `/loop` 기술 및 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`)는 보존됩니다. MCP 도구 검색이 비활성화되고 모든 MCP 도구가 미리 로드됩니다. 도구 검색이 설정되어 있더라도 마찬가지입니다. Claude Code v2.1.227 이상에서는 관리 설정이 도구 검색을 켜 둘 수 있습니다. 사전 릴리스 기능 비활성화에서 재정의가 적용되는 위치를 확인하세요
`CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS`	기본 제공 Explore 및 Plan 서브에이전트를 비활성화하려면 `1`로 설정하세요. Claude는 검색 도구 또는 범용 서브에이전트로 탐색하고, 계획 모드는 Explore 및 Plan 에이전트를 시작하는 대신 파일을 직접 읽습니다. `Explore` 또는 `Plan`이라는 사용자 정의 서브에이전트는 영향을 받지 않습니다. Agent SDK 또는 비대화형 모드에서 모든 기본 제공 서브에이전트 유형을 제거하려면 `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`를 대신 사용하세요. Claude Code v2.1.198 이상이 필요합니다
`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` 명령이 코드 변경을 복원할 수 없습니다. `fileCheckpointingEnabled` 설정을 재정의합니다
`CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS`	Claude의 시스템 프롬프트에서 기본 제공 커밋 및 PR 워크플로우 지침과 git 상태 스냅샷을 제거하려면 `1`로 설정하세요. 자신의 git 워크플로우 기술을 사용할 때 유용합니다. 설정되면 `includeGitInstructions` 설정보다 우선합니다
`CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP`	Anthropic API에서 Opus 4.0 및 4.1을 현재 Opus 버전으로 자동 재매핑하지 않으려면 `1`로 설정하세요. 의도적으로 이전 모델을 고정하려고 할 때 사용합니다. 재매핑은 Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry에서 실행되지 않습니다
`CLAUDE_CODE_DISABLE_MOUSE`	전체 화면 렌더링에서 마우스 추적을 비활성화하려면 `1`로 설정하세요. `PgUp` 및 `PgDn`을 사용한 키보드 스크롤은 여전히 작동합니다. 터미널의 기본 선택 시 복사 동작을 유지하려면 이를 사용하세요
`CLAUDE_CODE_DISABLE_MOUSE_CLICKS`	전체 화면 렌더링에서 클릭, 드래그, 호버 처리를 비활성화하면서 마우스 휠 스크롤을 유지하려면 `1`로 설정하세요. Claude Code 내에서 휠 스크롤이 작동하기를 원하지만 클릭이 커서를 배치하거나, 도구 출력을 확장하거나, 링크를 열지 않기를 원할 때 사용합니다. 둘 다 설정되면 `CLAUDE_CODE_DISABLE_MOUSE`가 우선합니다. Claude Code v2.1.195 이상이 필요합니다
`CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION`	Claude Code가 API 요청이 연결 재설정 또는 TLS 핸드셰이크 오류와 같은 연결 수준 오류로 실패할 때 mTLS 클라이언트 인증서 및 키를 다시 읽지 않도록 하려면 `1`로 설정하세요. 다시 로드가 비활성화되면, Claude Code는 다음에 설정을 적용하거나 다음 시작 시에만 회전된 파일을 로드합니다. Claude Code v2.1.232 이상이 필요합니다
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	비필수 네트워크 트래픽을 비활성화하려면 `1`과 같은 비어있지 않은 값으로 설정하세요: 자동 업데이트, 원격 분석, 오류 보고, `/feedback` 명령, Claude 작성 피드백, 릴리스 노트, PR 및 MR 상태 배지 확인, 빠른 모드 확인과 같은 가용성 확인. 또한 플러그인 `command` 소스의 백그라운드 실행을 중지합니다. 이는 네트워크 트래픽이 아니라 로컬 명령이지만 종속성 설치를 트리거할 수 있습니다. `0` 또는 `false`로 설정해도 이 트래픽이 비활성화됩니다. 대부분의 온/오프 변수와 달리 변수를 설정 해제하여 다시 허용하세요. 또한 기능 플래그 가져오기를 비활성화하여 원격 제어 및 기타 기능 플래그 가져오기가 필요한 기능을 사용할 수 없게 만듭니다. 공식 플러그인 마켓플레이스 자동 설치는 포함되지 않습니다. `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`로 비활성화하세요. 게이트웨이 모델 검색에는 영향을 주지 않습니다. 이는 자체 옵트인입니다
`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK`	스트리밍 요청이 스트림 중간에 실패할 때 비스트리밍 폴백을 비활성화하려면 `1`로 설정하세요. 스트리밍 오류는 재시도 계층으로 전파됩니다. 프록시 또는 게이트웨이가 폴백으로 인해 중복 도구 실행을 생성할 때 유용합니다
`CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK`	터미널에 입력하거나 포커스할 때도 `PushNotification` 도구의 데스크톱 알림을 보내려면 `1`로 설정하세요. 기본적으로 도구는 최근 키보드 활동 또는 터미널 포커스를 감지할 때 데스크톱 알림과 모바일 푸시를 모두 건너뜁니다. 이 변수는 로컬 확인만 비활성화하므로 서버는 활동을 감지할 때 모바일 푸시를 여전히 억제할 수 있습니다. Claude Code v2.1.193 이상이 필요합니다
`CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`	공식 플러그인 마켓플레이스의 자동 등록을 비활성화하려면 `1`로 설정하세요. Claude Code는 마켓플레이스를 등록하려고 할 때 변수를 읽습니다. 보통 머신의 첫 대화형 시작 중입니다. 그 시점에서 변수가 설정되면, Claude Code는 등록을 영구적으로 건너뜁니다. 나중에 변수를 설정 해제해도 건너뛰기가 취소되지 않습니다. 언제든지 `claude plugin marketplace add anthropics/claude-plugins-official`을 실행하여 마켓플레이스를 등록하세요
`CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS`	Claude Code가 Claude Desktop 및 VS Code 확장이 Claude Code를 호스팅하는 방식인 Agent SDK의 `canUseTool` 콜백으로 보내는 세션에서 응답하지 않은 권한 요청에 대한 `Notification` 훅을 실행하지 않도록 하려면 `1`로 설정하세요. 터미널 세션에는 효과가 없습니다. Claude Code v2.1.233 이상이 필요합니다
`CLAUDE_CODE_DISABLE_POLICY_SKILLS`	시스템 전체 관리 기술 디렉토리에서 기술 로드를 건너뛰려면 `1`로 설정하세요. 컨테이너 또는 CI 세션이 운영자 제공 기술을 로드하지 않아야 할 때 유용합니다
`CLAUDE_CODE_DISABLE_TERMINAL_TITLE`	대화 컨텍스트를 기반으로 자동 터미널 제목 업데이트를 비활성화하려면 `1`로 설정하세요. Agent SDK 및 `claude -p` 세션에서는 세션 제목을 생성하는 백그라운드 소형/빠른 모델 요청도 건너뜁니다
`CLAUDE_CODE_DISABLE_THINKING`	API 요청에서 `thinking` 매개변수를 완전히 생략하려면 `1`로 설정하세요. 이는 매개변수를 거부하는 프록시 및 게이트웨이를 위한 호환성 옵션입니다. 기본적으로 생각하는 모델에서 매개변수를 생략하면 모델이 여전히 생각할 수 있습니다. Anthropic API에서 확장 사고를 명시적으로 비활성화하려면 `MAX_THINKING_TOKENS=0`을 대신 사용하세요. 어느 변수도 Fable 모델에서 사고를 끄지 않습니다. 이는 사고를 끌 수 없습니다. 타사 제공자에서 `MAX_THINKING_TOKENS=0`은 마찬가지로 매개변수를 생략하므로 두 변수가 동일하게 작동합니다
`CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT`	Claude Code가 모델 ID를 인식하지 못할 때(예: LLM 게이트웨이 별칭) 사전 자동 압축을 건너뛰려면 `1`로 설정하세요. 이 변수가 없으면, Claude Code는 ID에 대해 가정하는 컨텍스트 창에서 압축합니다. `CLAUDE_CODE_MAX_CONTEXT_TOKENS`은 대신 가정된 창을 수정할 수 있습니다. 게이트웨이 또는 사용자 정의 모델 ID에 대한 창 수정에서 각 변수가 적용되는 시기를 참조하세요. Claude Code v2.1.223 이상이 필요합니다
`CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL`	전체 화면 렌더링에서 가상 스크롤을 비활성화하고 대화 기록의 모든 메시지를 렌더링하려면 `1`로 설정하세요. 전체 화면 모드에서 스크롤이 메시지가 나타나야 할 위치에 빈 영역을 표시하면 이를 사용하세요
`CLAUDE_CODE_DISABLE_WORKFLOWS`	워크플로우를 비활성화하려면 `1`로 설정하세요. `disableWorkflows` 설정과 동일합니다
`CLAUDE_CODE_EFFORT_LEVEL`	지원되는 모델의 노력 수준을 설정합니다. 값: `low`, `medium`, `high`, `xhigh`, `max`, 또는 `auto`(모델 기본값 사용). 사용 가능한 수준은 모델에 따라 다릅니다. `--effort`, `/effort`, `modelSettings` 및 `effortLevel` 설정보다 우선합니다. `maxEffortLevel` 상한이 여전히 적용됩니다. 노력 수준 조정을 참조하세요
`CLAUDE_CODE_ENABLE_APPEND_SUBAGENT_PROMPT`	포크된 서브에이전트를 제외한 모든 서브에이전트의 시스템 프롬프트 끝에 추가 텍스트를 추가하는 것을 활성화하려면 `1`로 설정하세요. `--append-subagent-system-prompt` 및 `--append-subagent-system-prompt-file` 플래그는 추가된 텍스트를 제공하고 이 변수를 자동으로 설정하므로 직접 설정할 필요가 없습니다. Claude Code v2.1.205 이상이 필요합니다
`CLAUDE_CODE_ENABLE_AUTO_MODE`	호환성을 위해 허용되며 효과가 없습니다. 자동 모드는 Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry, 서명된 Claude 앱 게이트웨이 세션을 포함한 모든 제공자에서 기본적으로 사용 가능합니다. v2.1.158부터 v2.1.206까지, 이를 `1`로 설정하는 것이 해당 제공자에서 자동 모드를 사용 가능하게 하는 데 필요했습니다
`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`	세션 요약 가용성을 재정의합니다. `/config` 토글에 관계없이 요약을 강제로 끄려면 `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에서 기본적으로 활성화됩니다. Amazon Bedrock 및 Google Cloud의 Agent Platform에서는 배포된 컨테이너가 지원하는 모델별로 활성화됩니다. 옵트아웃하려면 `0`으로 설정하세요. `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL`, 또는 `ANTHROPIC_BEDROCK_BASE_URL`을 통해 프록시를 통해 라우팅할 때 강제로 켜려면 `1`로 설정하세요. Microsoft Foundry 및 게이트웨이 연결에서는 기본적으로 꺼져 있습니다
`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY`	`ANTHROPIC_BASE_URL`이 LiteLLM, Kong, 내부 프록시와 같은 Anthropic 호환 게이트웨이의 `/v1/models` 엔드포인트에서 `/model` 선택기를 채우려면 `1`로 설정하세요. 기본적으로 꺼져 있습니다. 공유 API 키로 지원되는 게이트웨이는 그렇지 않으면 모든 사용자에게 키가 액세스할 수 있는 모든 모델을 표시하기 때문입니다. 검색된 모델은 여전히 세션이 수신하는 `availableModels` 허용 목록으로 필터링됩니다. MDM 또는 관리 설정 파일을 통해 목록을 전달하세요. 서버 관리 전달은 게이트웨이 구성에서 사용할 수 없습니다
`CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE`	v2.1.142에서 제거되었습니다. 빠른 모드 기본값이 Opus 4.6에서 Opus 4.7로 이동했을 때
`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`	프롬프트 입력에 나타나는 회색 예측인 프롬프트 제안을 끄려면 `false`로 설정하세요. `promptSuggestionEnabled` 설정보다 우선합니다. 이는 `/config`의 프롬프트 제안 토글이 작성하는 것입니다. Claude Code는 또한 계정이 사용 제한에 가까워지거나 도달할 때 제안을 일시 중지합니다. 제한에 도달할 때까지 켜 두려면 `true`로 설정하세요. Claude Code v2.1.238 이상이 필요합니다. 프롬프트 제안을 참조하세요
`CLAUDE_CODE_ENABLE_TASKS`	이를 가진 세션에서 Claude Code가 제공하는 작업 추적 도구를 선택합니다. 기본적으로 Claude Code는 Task 도구 `TaskCreate`, `TaskUpdate`, `TaskGet`, `TaskList`를 제공합니다. 대신 레거시 `TodoWrite` 도구를 얻으려면 `0`으로 설정하세요. 작업 목록을 참조하세요
`CLAUDE_CODE_ENABLE_TELEMETRY`	OpenTelemetry 데이터 수집을 메트릭 및 로깅에 대해 활성화하려면 `1`로 설정하세요. OTel 내보내기를 구성하기 전에 필수입니다. 모니터링을 참조하세요
`CLAUDE_CODE_ENABLE_TODO_TOOLS`	모든 모델에서 작업 추적 도구를 얻으려면 `1`로 설정하세요. 이것이 없으면, Claude Code는 기본적으로 작업 도구 가용성에 나열된 모델에서만 제공합니다. `CLAUDE_CODE_ENABLE_TASKS`는 여전히 Task 도구 또는 `TodoWrite`를 선택합니다. Claude Code v2.1.233 이상이 필요합니다
`CLAUDE_CODE_EXIT_AFTER_STOP_DELAY`	쿼리 루프가 유휴 상태가 된 후 자동으로 종료되기 전에 대기할 시간(밀리초)입니다. SDK 모드를 사용하는 자동화된 워크플로우 및 스크립트에 유용합니다
`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS`	에이전트 팀을 활성화하려면 `1`로 설정하세요. 에이전트 팀은 실험적이며 기본적으로 비활성화됩니다
`CLAUDE_CODE_EXTRA_BODY`	모든 API 요청 본문의 최상위 수준으로 병합할 JSON 객체입니다. Claude Code가 직접 노출하지 않는 제공자 특정 매개변수를 전달하는 데 유용합니다. 셸에서 내보낸 값은 `claude agents` 또는 `--bg`로 디스패치하는 백그라운드 세션에도 적용됩니다. v2.1.206 이전에는 백그라운드 세션이 셸 내보낸 값을 무시하고 백그라운드 감독자 프로세스가 상속한 복사본을 사용했습니다
`CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS`	파일 읽기의 기본 토큰 제한을 재정의합니다. 전체 파일을 읽어야 할 때 유용합니다
`CLAUDE_CODE_FORCE_SESSION_PERSISTENCE`	다른 Claude Code 세션 내에서 시작된 경우에도 대화 기록 지속성, 프롬프트 기록, `claude agents` 등록을 강제하려면 `1`로 설정하세요. 상속된 `CLAUDE_CODE_CHILD_SESSION` 값(예: `screen` 세션 또는 Claude Code의 Bash 도구에 의해 먼저 시작된 백그라운드 런처)이 진정한 최상위 세션을 중첩된 것으로 잘못 분류할 때 사용합니다. v2.1.178부터 Claude Code는 tmux 경우를 자동으로 감지하고 상속된 마커를 무시하므로 tmux는 더 이상 이 변수가 필요하지 않습니다. 또한 v2.1.169 이하에서도 인정됩니다. v2.1.170 및 v2.1.171에서는 효과가 없습니다. 이는 중첩된 세션 감지가 제거되었습니다
`CLAUDE_CODE_FORCE_STRIKETHROUGH`	터미널이 지원하지만 SSH를 통해 `TERM_PROGRAM`이 전달되지 않는 경우와 같이 자동 감지되지 않을 때 Claude의 응답에서 `~~text~~`에 대한 취소선 렌더링을 강제하려면 `1`로 설정하세요. 이것이 없으면, 감지되지 않은 터미널은 취소선으로 렌더링하는 대신 리터럴 `~~` 마커를 표시합니다. Claude Code v2.1.186 이상이 필요합니다
`CLAUDE_CODE_FORCE_SYNC_OUTPUT`	터미널이 지원하지만 자동 감지되지 않을 때 DEC 개인 모드 2026 동기화된 출력을 강제로 활성화하려면 `1`로 설정하세요. Emacs `eat`와 같이 BSU/ESU를 구현하지만 기능 프로브에 응답하지 않는 에뮬레이터에 유용합니다. tmux에서는 효과가 없습니다. `CLAUDE_CODE_NO_FLICKER`와 달리, 이는 전체 화면 렌더링으로 전환하지 않습니다. 렌더러를 변경하지 않습니다
`CLAUDE_CODE_FORK_SUBAGENT`	포크 모드를 제어합니다. 이는 Claude가 포크된 서브에이전트를 자신이 생성하도록 하며 대화형 세션에서만 기본적으로 켜져 있습니다. `claude -p` 및 Agent SDK에서도 켜려면 `1`로 설정하거나, 모든 종류의 세션에서 끄려면 `0`으로 설정하세요. 포크 모드가 켜져 있는지 여부에 관계없이 `/subtask`를 실행할 수 있습니다. 대화형 기본값에는 Claude Code v2.1.232 이상이 필요합니다. 이전 버전에서는 포크 모드를 켜려면 변수를 `1`로 설정하세요
`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`	서브에이전트 텍스트 및 사고 블록을 `claude -p --output-format stream-json` 출력에 내보내려면 `1`로 설정하세요. `--forward-subagent-text` 플래그와 동일한 동작입니다. 하네스가 `claude`를 호출하고 플래그 자체를 전달할 수 없을 때 변수를 사용합니다. 플래그와 달리, 비대화형 모드에서 stream-json 출력 외부에서 오류로 종료되는 변수는 중첩된 호출이 설정되었을 때 계속 작동하도록 무시됩니다. Claude Code v2.1.211 이상이 필요합니다
`CLAUDE_CODE_GIT_BASH_PATH`	Windows만 해당: Git Bash 실행 파일(`bash.exe`)의 경로입니다. Git Bash가 설치되었지만 PATH에 없을 때 사용합니다. 경로가 존재하지 않거나 파일이 `bash.exe`, `sh.exe`, `bash`, 또는 `sh`라는 이름이 아니면, Claude Code는 변수를 무시하고 `--debug`로 볼 수 있는 경고를 기록하면서 Git Bash를 자동 감지합니다. v2.1.219 이전에는 경로가 존재하지 않으면 Claude Code가 시작 시 종료되었고, bash 또는 sh인지 확인하지 않고 기존 파일을 셸로 사용했습니다. Windows 설정을 참조하세요
`CLAUDE_CODE_GLOB_HIDDEN`	Claude가 Glob 도구를 호출할 때 결과에서 숨김 파일을 제외하려면 `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_GOAL_CHECKIN_MINUTES`	백그라운드 작업이 활성 목표를 대기 상태로 유지할 수 있는 시간(분)입니다. Claude Code가 이를 확인하도록 요청하기 전입니다. 기본값 `30`. 체크인을 끄려면 `0`으로 설정하세요. 일반 숫자로 전체 분을 제공하세요. 최대 `10080`(1주). Claude Code는 다른 값을 기본값으로 취급합니다. Claude Code v2.1.234 이상이 필요합니다
`CLAUDE_CODE_HIDE_CWD`	시작 로고에서 작업 디렉토리를 숨기려면 `1`로 설정하세요. 경로가 OS 사용자 이름을 노출하는 화면 공유 또는 녹화에 유용합니다
`CLAUDE_CODE_IDE_HOST_OVERRIDE`	IDE 확장에 연결하는 데 사용되는 호스트 주소를 재정의합니다. 기본적으로 Claude Code는 WSL-to-Windows 라우팅을 포함한 올바른 주소를 자동 감지합니다
`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`	IDE 확장의 자동 설치를 건너뛰려면 `1`로 설정하세요. `autoInstallIdeExtension`을 `false`로 설정하는 것과 동일합니다
`CLAUDE_CODE_IDE_SKIP_VALID_CHECK`	연결 중에 IDE 잠금 파일 항목의 유효성 검사를 건너뛰려면 `1`로 설정하세요. 자동 연결이 실행 중인 IDE를 찾지 못할 때 사용합니다
`CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS`	한 세션에서 서브에이전트가 실행될 수 있는 최대 개수입니다. Agent 도구가 다른 것을 생성하기를 거부하기 전입니다(기본값: 20). 일반 숫자로 양의 정수를 허용합니다. 다른 것은 무시되므로 변수는 상한을 조정할 수 있지만 비활성화할 수 없습니다. Claude Code v2.1.217 이상이 필요합니다
`CLAUDE_CODE_MAX_CONTEXT_TOKENS`	Claude Code가 활성 모델에 대해 가정하는 컨텍스트 창 크기를 재정의합니다. v2.1.193부터, 이것이 적용되는 방식은 Claude Code가 모델 ID를 확인하는 방식에 따라 다릅니다. 게이트웨이 또는 사용자 정의 모델 ID에 대한 창 수정을 참조하세요. `ANTHROPIC_BASE_URL`을 통해 컨텍스트 창이 이름의 기본 제공 크기와 일치하지 않는 모델로 라우팅할 때 사용합니다
`CLAUDE_CODE_MAX_OUTPUT_TOKENS`	대부분의 요청에 대한 최대 출력 토큰 수를 설정합니다. 기본값 및 상한은 모델에 따라 다릅니다. 최대 출력 토큰을 참조하세요. Claude Code는 인식하지 못하는 모델 ID(예: 게이트웨이 특정 이름)에 대해 기본값 32000을 설정하고 모델의 상한 이상의 값을 상한으로 낮춥니다. 이 값을 증가시키면 자동 압축이 트리거되기 전에 사용 가능한 유효 컨텍스트 창이 감소합니다
`CLAUDE_CODE_MAX_RETRIES`	실패한 API 요청을 재시도할 횟수를 재정의합니다(기본값: 10). v2.1.186부터 15로 제한됩니다. v2.1.199부터 `CLAUDE_CODE_RETRY_WATCHDOG`이 기본값을 올리고 상한을 제거합니다. 더 긴 중단을 기다려야 하는 무인 세션의 경우 대신 `CLAUDE_CODE_RETRY_WATCHDOG`을 설정하세요
`CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION`	v2.1.224에서 제거되었으며 이제 작동하지 않습니다. 이전에는 한 세션에서 Agent 도구로 Claude가 생성할 수 있는 서브에이전트의 총 개수를 제한했습니다(기본값: 200). 상한을 초과하여 생성하면 `Subagent spawn limit reached`로 실패했습니다. 동시 서브에이전트 제한 및 깊이 제한은 여전히 적용됩니다
`CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH`	서브에이전트 계층의 수입니다. 주 대화 아래에서 허용됩니다 (기본값: 3). 기본값에서 서브에이전트는 자신의 서브에이전트를 생성할 수 있고, 세 번째 계층의 서브에이전트는 더 이상 생성할 수 없습니다. 중첩을 끄려면 `1`로 설정하세요. v2.1.217부터 v2.1.218까지 기본값은 1이었으므로 서브에이전트는 제한을 높이지 않으면 자신의 것을 생성할 수 없었습니다. v2.1.219는 기본값을 3으로 올렸습니다. 일반 숫자로 양의 정수를 허용합니다. 다른 것은 무시되므로 제한을 조정할 수 있지만 제거할 수 없습니다. Claude Code v2.1.217 이상이 필요합니다
`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`	읽기 전용 도구 및 서브에이전트가 병렬로 실행될 수 있는 최대 개수입니다(기본값: 10). 더 높은 값은 병렬 처리를 증가시키지만 더 많은 리소스를 소비합니다
`CLAUDE_CODE_MAX_TURNS`	명시적 제한이 전달되지 않을 때 에이전트 턴 수를 제한합니다. `--max-turns`를 전달하는 것과 동일합니다. 둘 다 설정되면 플래그가 우선합니다. 양의 정수가 아닌 값은 상한이 없는 것으로 취급되지 않고 시작 시 오류로 거부됩니다
`CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION`	한 세션이 만들 수 있는 WebSearch 호출의 총 개수에 대한 상한입니다(기본값: 200). Claude가 상한에 도달하면, 추가 WebSearch 호출은 이미 수집한 정보로 계속하도록 지시하는 알림을 반환합니다. 상한 없이 양의 정수를 허용합니다. 다른 것은 무시되고 기본값이 적용되므로 상한을 올릴 수 있지만 끌 수 없습니다. Claude Code v2.1.212 이상이 필요합니다
`CLAUDE_CODE_MCP_ALLOWLIST_ENV`	stdio MCP 서버를 안전한 기본 환경과 서버의 구성된 `env`만으로 생성하려면 `1`로 설정하세요. 셸 환경을 상속하지 않습니다
`CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS`	여전히 실행 중인 MCP 도구 호출이 백그라운드 작업으로 이동하기 전의 경과 시간(밀리초)입니다(기본값: 120000, 또는 2분). 자동 백그라운드 처리를 끄려면 `0`으로 설정하세요. Claude Code v2.1.212 이상이 필요합니다
`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`	MCP 도구 호출의 밀리초 단위 유휴 타임아웃입니다. stdio, HTTP, SSE, WebSocket, 또는 claude.ai 커넥터 MCP 서버가 이 시간 동안 응답이나 진행 알림을 보내지 않으면, 도구 호출은 전체 `MCP_TOOL_TIMEOUT`을 기다리는 대신 오류로 중단됩니다. 네트워크 서버의 300000(5분) 및 stdio 서버의 1800000(30분)의 전송별 기본값을 재정의합니다. 유휴 확인을 비활성화하려면 `0`으로 설정하세요. 1000 미만의 값은 1초로 올라가고, 값은 유효한 `MCP_TOOL_TIMEOUT`으로 제한됩니다. `.mcp.json`의 서버별 `timeout`이 최소 1000이면 해당 서버의 유휴 창을 최소 `timeout` 값으로 올립니다. IDE 서버 또는 SDK 인프로세스 서버에는 적용되지 않습니다. Claude Code v2.1.187 이상이 필요합니다. v2.1.203 이전에는 stdio 서버가 유휴 타임아웃에서 제외되었습니다
`CLAUDE_CODE_MESSAGING_SOCKET`	Claude Code에 의해 설정됨. 당신이 설정하지 않습니다: 수신함 소켓을 바인드하는 세션에서, Claude Code는 훅 및 Bash 명령에 해당 소켓의 경로를 내보냅니다. 메시징이 켜진 상태로 시작하는 세션에서 Claude Code는 훅이 실행되기 전에 소켓을 바인드합니다. 머신의 다른 세션이 이 경로로 메시지를 전달합니다. 각 세션은 부모에서 상속된 것이 아니라 자신의 소켓을 내보내고, 도착하는 메시지는 세션의 인바운드 제어를 통과합니다. 설정 `env` 블록은 이를 설정할 수 없습니다. Claude Code v2.1.224 이상이 필요합니다
`CLAUDE_CODE_MESSAGING_TOKEN`	Claude Code에 의해 설정됨. 당신이 설정하지 않습니다: 수신함 소켓을 바인드하는 세션에서, Claude Code는 이 세션별 토큰을 훅 및 Bash 명령과 함께 내보냅니다. 소켓에 게시하는 스크립트는 `{"type":"auth","token":"<token>"}` 첫 번째 줄로 세션에 속함을 증명할 수 있습니다. 기본 Windows에서 Claude Code는 이 줄을 요구하고 유효한 것으로 열지 않는 모든 연결을 닫습니다. 자신의 자식 규칙은 Claude Code가 토큰을 참조하는 시기를 말합니다. 각 세션은 부모 세션에서 상속된 것이 아니라 자신의 토큰을 내보냅니다. 설정 `env` 블록은 이를 설정할 수 없습니다. Claude Code v2.1.228 이상이 필요합니다
`CLAUDE_CODE_NATIVE_CURSOR`	입력 캐럿에서 터미널의 자체 커서를 그려진 블록 대신 표시하려면 `1`로 설정하세요. 커서는 터미널의 깜박임, 모양, 포커스 설정을 존중합니다
`CLAUDE_CODE_NEW_INIT`	`/init`이 대화형 설정 흐름을 실행하도록 하려면 `1`로 설정하세요. 흐름은 CLAUDE.md, 기술, 훅을 포함하여 생성할 파일을 묻고 코드베이스를 탐색한 후 작성합니다. 이 변수가 없으면 `/init`은 프롬프트 없이 CLAUDE.md를 자동으로 생성합니다
`CLAUDE_CODE_NONBLOCKING_STDOUT`	터미널 출력을 두 번째 비차단 파일 설명자를 통해 작성하려면 `1`로 설정하세요. 일시 중지된 tmux 제어 모드 창이나 정지된 SSH 연결과 같이 읽기를 중지하는 터미널이 세션 중간에 Claude Code를 동결할 수 없습니다. macOS, Linux, WSL에서 stdout이 터미널일 때 적용됩니다. Claude Code v2.1.261 이상이 필요합니다
`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 액세스 토큰입니다. SDK 및 자동화된 환경의 `/login`에 대한 대안입니다. 키체인 저장 자격 증명보다 우선합니다. `claude setup-token`으로 생성하세요. `/login`을 실행하지 않으면, Claude Code는 전체 세션에 대해 설정한 토큰을 사용합니다. 만료된 토큰을 교체하려면 새 토큰을 생성하고 다시 시작하세요
`CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE`	v2.1.160에서 제거되었으며 이제 작동하지 않습니다. 이전에는 빠른 모드를 현재 기본값 대신 Claude Opus 4.6으로 고정했습니다. Opus 4.6은 더 이상 빠른 모드를 지원하지 않습니다
`CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`	콘텐츠 베어링 OpenTelemetry 속성(모델 응답, 도구 콘텐츠, 시스템 프롬프트, 원본 API 본문)의 최대 길이입니다. 잘림 마커 포함. UTF-16 코드 단위(기본값: 61440, 즉 60KB). 원격 분석 백엔드가 64KB보다 큰 속성 값을 허용하는 경우에만 올리거나, 원격 분석 볼륨을 줄이려면 낮추세요. Claude Code v2.1.214 이상이 필요합니다. 모니터링을 참조하세요
`CLAUDE_CODE_OTEL_DIAG_STDERR`	OpenTelemetry 내보내기 진단 오류를 stderr에 작성하려면 `1`로 설정하세요. 기본적으로 이러한 오류는 `--debug`에서만 나타나므로 Prometheus 포트 충돌과 같이 잘못 구성된 내보내기는 그렇지 않으면 자동으로 실패합니다. Claude Code v2.1.179 이상이 필요합니다. 모니터링을 참조하세요
`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`로 설정하세요. 플러그인 설치 및 업데이트, `/plugin marketplace add` 및 `update`에 적용됩니다. CI 러너, 컨테이너, 또는 `github.com`에 대해 구성된 SSH 키가 없는 환경에서 유용합니다
`CLAUDE_CODE_PLUGIN_SEED_DIR`	하나 이상의 읽기 전용 플러그인 시드 디렉토리의 경로입니다. Unix에서는 `:`로, Windows에서는 `;`로 구분됩니다. 미리 채워진 플러그인 디렉토리를 컨테이너 이미지에 번들로 묶으려면 이를 사용합니다. Claude Code는 시작 시 이러한 디렉토리에서 마켓플레이스를 등록하고 다시 복제하지 않고 미리 캐시된 플러그인을 사용합니다. 컨테이너용 플러그인 미리 채우기를 참조하세요
`CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY`	도구 호출, 훅, 상태 줄 명령을 위해 PowerShell을 생성할 때 Claude Code가 `-ExecutionPolicy Bypass`를 전달하지 않도록 하려면 `1`로 설정하세요. 대신 머신의 유효한 실행 정책을 존중합니다. 기본적으로 Claude Code는 프로세스 범위에서 실행 정책을 우회하므로 `.ps1` 스크립트 및 모듈 가져오기가 기본 제한 Windows 설치에서 작동합니다. 프로세스 범위 우회는 이 설정에 관계없이 Group Policy `MachinePolicy` 또는 `UserPolicy`를 재정의하지 않습니다
`CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS`	비대화형 모드에서 `-p` 플래그를 사용한 최종 턴 후 백그라운드 서브에이전트 및 워크플로우를 기다리는 유휴 대기의 밀리초 단위 상한입니다. 유휴 대기는 Claude가 백그라운드 결과를 처리하기 위해 턴을 할 때마다 다시 시작됩니다. 기본값: `600000`, 또는 10분. 유휴 대기가 상한에 도달하면, Claude Code는 나머지 백그라운드 작업을 기다리는 것을 중지하고 종료합니다. 무한정 기다리려면 `0`으로 설정하세요. 이 상한은 일반 백그라운드 셸에 적용되는 5초 유예 기간과는 별개입니다. Claude Code v2.1.182 이상이 필요합니다
`CLAUDE_CODE_PROCESS_WRAPPER`	에이전트 보기를 호스팅하는 백그라운드 서비스와 같이 Claude Code가 자신의 바이너리에서 시작하는 프로세스를 `/opt/corp/launcher`와 같은 argv 접두사로 주어진 기업 런처를 통해 시작하려면 설정하세요. 사용자 또는 관리 설정의 `env` 블록에서 설정하세요. 프로젝트 및 로컬 설정은 이를 설정할 수 없습니다. `processWrapper` 설정과 동등합니다. Claude Code v2.1.210 이상이 필요합니다. 둘 다 설정되면 이 변수가 우선합니다. VS Code 확장은 자신의 `claudeProcessWrapper` 설정을 통해 자신의 런처를 별도로 구성합니다. Windows에서는 무시됩니다. 기업 런처 뒤에서 Claude Code 실행에서 값 형식, 런처가 적용되는 것, 런처가 만족해야 하는 계약을 참조하세요. Claude Code v2.1.208 이상이 필요합니다
`CLAUDE_CODE_PROJECT_DIR_NAME`	`CLAUDE_CONFIG_DIR`과 함께 설정하여 Claude Code가 해당 세션의 대화 기록 및 자동 메모리를 저장하는 `projects/` 디렉토리 이름을 선택합니다. 작업 디렉토리 경로에서 파생된 것 대신입니다. 예를 들어, `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude`로 Claude Code를 시작하면 `/srv/tenant-a/projects/work/` 아래에 저장합니다. `CLAUDE_CONFIG_DIR`이 설정되지 않으면 Claude Code는 이 변수를 무시합니다. `claude`를 시작하는 환경에서만 읽습니다. 설정 파일 `env` 블록에서는 읽지 않습니다. 프로젝트 디렉토리 이름 직접 지정을 참조하세요. Claude Code v2.1.234 이상이 필요합니다
`CLAUDE_CODE_PROMPT_CACHE_TTL`	`5m` 또는 `1h`를 설정합니다. Claude Code가 허용하는 유일한 값입니다. 주 대화에 대한 프롬프트 캐시 TTL을 선택합니다: 대화형, `-p`, SDK 턴, 그리고 이들과 함께 인라인으로 실행되는 도우미. `promptCacheTtl` 설정 및 `ENABLE_PROMPT_CACHING_1H`보다 우선합니다. `FORCE_PROMPT_CACHING_5M`이 이를 재정의합니다. API는 1시간 캐시 쓰기를 더 높은 속도로 청구합니다. Claude Code v2.1.242 이상이 필요합니다
`CLAUDE_CODE_PROPAGATE_TRACEPARENT`	`ANTHROPIC_BASE_URL`이 사용자 정의 프록시를 가리킬 때 W3C 추적 컨텍스트를 전파하려면 `1`로 설정하세요. 전파는 모델 및 HTTP MCP 요청의 `traceparent` 헤더와 Bash, PowerShell, 훅 서브프로세스의 `TRACEPARENT` 환경 변수를 포함합니다. 기본적으로 전파는 Anthropic API에 직접 연결할 때만 활성화됩니다. v2.1.152에서 추가되었습니다. 추적(베타)을 참조하세요
`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`	Claude Code를 포함하고 자신을 대신하여 모델 제공자 라우팅을 관리하는 호스트 플랫폼에 의해 설정됩니다. 설정되면, Claude Code는 설정 파일에서 `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL`, `ANTHROPIC_API_KEY`와 같은 제공자 선택, 엔드포인트, 인증 변수를 무시합니다. 사용자 설정이 호스트의 라우팅을 재정의할 수 없습니다. Claude Code는 또한 관리 설정에서 `model`, `fallbackModel`, `modelOverrides`와 같은 모델 선택 키를 무시합니다. 어느 관리 소스가 전달하든 호스트의 모델 구성이 오래된 관리 모델 핀보다 우선합니다. Claude Code는 또한 관리 `env` 블록에서 `ANTHROPIC_MODEL` 및 `ANTHROPIC_DEFAULT_*_MODEL` 계열과 같은 모델 선택 변수를 무시합니다. 관리 설정의 `availableModels` 허용 목록은 호스트가 자신의 것을 제공하지 않으면 여전히 적용됩니다. Claude Code는 또한 Amazon Bedrock, AWS의 Claude Platform, Google Cloud의 Agent Platform, Microsoft 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_RESTRICTED`	세션을 제한된 모드로 시작하려면 `1`로 설정하세요. `--restricted`를 전달하는 것과 동일합니다. Claude Code는 설정 파일의 `env` 블록에서 이 변수를 무시합니다. Claude Code v2.1.248 이상이 필요합니다
`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`	이전 세션이 턴 중간에 끝났으면 자동으로 재개하려면 `1`로 설정하세요. SDK 모드에서 사용되므로 모델이 SDK가 프롬프트를 다시 보낼 필요 없이 계속됩니다. 이를 끄려면 변수를 설정 해제하거나 `0`으로 설정하세요. v2.1.221 이전에는 Claude Code가 `0` 및 기타 거짓 값을 무시했으므로 비대화형 모드에서 `0`을 설정하면 여전히 재개가 트리거되었고 변수를 설정 해제하는 것이 끄는 유일한 방법이었습니다
`CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS`	턴 중간에 끝난 세션이 재개 시 자동으로 계속되기 위한 마지막 대화 기록 메시지의 최대 나이(밀리초)입니다. 마지막 메시지가 이 경계보다 오래되면, Claude Code는 `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` 자동 재개와 주입된 `CLAUDE_CODE_RESUME_PROMPT` 계속 메시지를 모두 건너뜁니다. 세션은 유휴 상태로 시작되므로 명시적으로 계속합니다. 설정 해제 또는 `0`은 경계가 없음을 의미합니다. 음수 또는 숫자가 아닌 값은 1시간 경계를 적용합니다. 장시간 실행되는 에이전트의 스폰 스크립트는 이를 설정할 수 있으므로 오래된 대화 기록에 대한 재시작이 오래된 프롬프트를 다시 실행하지 않습니다. Claude Code는 에이전트 보기 세션이 대화형 세션에서 상속된 대화를 재시작할 때 자신이 1시간 경계를 설정합니다. Claude Code v2.1.211 이상이 필요합니다
`CLAUDE_CODE_RESUME_PROMPT`	턴 중간에 끝난 세션을 재개할 때 주입되는 계속 메시지를 재정의합니다. 기본값은 `Continue from where you left off.`입니다. 장시간 실행되는 에이전트의 스폰 스크립트는 이를 더 지시적인 부팅 메시지로 설정할 수 있습니다. 빈 문자열은 기본값을 사용합니다
`CLAUDE_CODE_RETRY_WATCHDOG`	평가 하네스, CI 작업, 원격 작업자와 같은 무인 세션의 경우 `1`로 설정하세요. `429` 및 `529` 용량 오류를 `CLAUDE_CODE_MAX_RETRIES` 시도 후 실패하는 대신 무한정 재시도합니다. Claude Code는 지출 제한 또는 소진된 사용 크레딧을 보고하는 `429`에서 즉시 실패합니다. 일정에 따라 재설정되는 게이트웨이 지출 상한의 경우에도 마찬가지입니다. v2.1.239 이전에는 감시견이 이들을 무한정 재시도했습니다. 감시견은 시도 사이에 최대 5분까지 백오프하거나 응답이 속도 제한 재설정 시간을 전달할 때까지 백오프합니다. 따라서 사용 제한에 도달한 세션은 남은 창을 기다립니다. v2.1.199 이상에서는 서버 오류, 타임아웃, 끊어진 연결과 같은 다른 일시적 오류에 대한 기본 재시도 횟수를 300으로 올립니다. 대략 3시간의 백오프이며, `CLAUDE_CODE_MAX_RETRIES`를 명시적으로 설정하면 15의 상한을 제거합니다. Claude Code v2.1.186 이상이 필요합니다
`CLAUDE_CODE_SAFE_MODE`	안전 모드로 시작하려면 `1`로 설정하세요: CLAUDE.md, 기술, 플러그인, 훅, MCP 서버, 사용자 정의 명령 및 에이전트, 출력 스타일, 워크플로우, 사용자 정의 테마, 사용자 정의 키 바인딩, 상태 줄 및 파일 제안 명령, LSP 서버, 자동 메모리는 로드되지 않습니다. 손상된 구성 문제 해결용입니다. 관리 설정 정책은 여전히 적용됩니다. 정책 구성 훅, 상태 줄, 파일 제안 명령 포함; 관리 플러그인, 관리 기술, 관리 CLAUDE.md, 정책 구성 MCP 서버는 로드되지 않습니다. `--safe-mode`를 전달하는 것과 동등합니다. 직접 생성된 자식 프로세스는 변수를 상속합니다
`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`	전체 화면 렌더링에서 마우스 휠 스크롤 배수를 설정합니다. `0.5`와 같이 1 미만의 분수 값을 포함하여 1에서 20까지의 양의 값을 허용합니다. 터미널이 이미 휠 이벤트를 증폭하는 경우 가속 트랙패드 및 휠 스크롤을 느리게 합니다. 터미널이 증폭 없이 노치당 하나의 휠 이벤트를 보내면 `vim`과 일치하도록 `3`으로 설정합니다. JetBrains IDE 터미널에서는 무시됩니다. Claude Code는 자신의 스크롤 처리를 사용합니다
`CLAUDE_CODE_SEND_FEEDBACK`	세션에 대해 Claude 작성 피드백을 끄려면 `0`으로 설정하세요. 계정이 이미 액세스 권한이 있는 경우 켜려면 `1`로 설정하세요. 변수는 액세스 자체를 부여할 수 없으며, `DISABLE_FEEDBACK_COMMAND` 및 `feedbackDrafts` 설정의 `off` 값과 같이 피드백을 끄는 다른 스위치가 여전히 적용됩니다
`CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS`	SessionEnd 훅의 시간 예산(밀리초)을 재정의합니다. 세션 종료, `/clear`, 대화형 `/resume`을 통한 세션 전환에 적용됩니다. 기본적으로 예산은 1.5초이며, 설정 파일에서 구성된 가장 높은 훅별 `timeout`으로 자동으로 올라갑니다. 최대 60초입니다. 플러그인 제공 훅의 타임아웃은 예산을 올리지 않습니다
`CLAUDE_CODE_SESSION_ID`	Bash 및 PowerShell 도구 서브프로세스, 훅 명령 서브프로세스, stdio MCP 서버 서브프로세스에서 현재 세션 ID로 자동으로 설정됩니다. Bash, PowerShell, 훅의 경우 이는 훅 JSON 입력의 `session_id` 필드와 일치하며 `/clear`에서 업데이트됩니다. MCP 서버 서브프로세스는 생성된 ID를 유지합니다. `--resume <session-id>`에서 재개된 ID를 수신합니다. 일치하는 훅 및 Bash입니다. `--continue` 또는 명시적 ID 없이 `--resume`에서 초기 시작 ID를 대신 수신할 수 있습니다. 스크립트 및 외부 도구를 이를 시작한 Claude Code 세션과 상관시키려면 사용합니다
`CLAUDE_CODE_SHELL`	Claude Code가 Bash 도구 명령을 실행하는 데 사용하는 셸을 설정합니다. `/opt/homebrew/bin/bash`와 같은 `bash` 또는 `zsh` 바이너리의 경로를 허용합니다. `fish`와 같은 다른 셸은 지원되지 않습니다. 값이 작동하는 `bash` 또는 `zsh` 경로가 아니면, Claude Code는 이를 무시하고 자동 감지로 폴백합니다. 자동 감지는 `bash` 또는 `zsh`를 가리킬 때 `$SHELL`을 사용합니다. 그렇지 않으면 PATH 및 표준 설치 위치에서 찾은 첫 번째 작동 `zsh`를 선택한 후 `bash`를 선택합니다
`CLAUDE_CODE_SHELL_PREFIX`	Claude Code가 생성하는 셸 명령을 래핑하는 명령 접두사입니다: Bash 도구 호출, 훅 명령, 상태 줄 명령, stdio MCP 서버 시작 명령. PowerShell 훅 및 exec 형식 훅은 접두사 없이 실행됩니다. 로깅 또는 감사에 유용합니다. `/path/to/logger.sh`와 같은 실행 파일 경로를 설정하면 각 명령이 `/path/to/logger.sh '<command>'`로 실행됩니다. 래퍼는 `$1`에서 명령줄을 단일 셸 인용 인수로 수신하므로 래퍼는 `exec bash -c "$1"`과 같이 `$1`을 다시 평가해야 합니다. `$1`을 실행 파일 경로로 취급하면 `npx -y <package>`와 같은 인수를 전달하는 stdio MCP 서버가 손상됩니다. Bash 도구 호출의 경우, `$1`은 Claude Code가 조립하는 전체 셸 호출을 포함합니다. 실행한 명령만이 아닙니다
`CLAUDE_CODE_SIMPLE`	최소 시스템 프롬프트 및 Bash, 파일 읽기, 파일 편집 도구만으로 실행하려면 `1`로 설정하세요. `--mcp-config`의 MCP 도구는 여전히 사용 가능합니다. 훅, 기술, 사용자 정의 명령, 서브에이전트, 플러그인, MCP 서버, 자동 메모리, CLAUDE.md의 자동 검색을 비활성화합니다. 기술은 `--add-dir`로 전달하는 디렉토리에서 여전히 로드됩니다. OAuth 토큰 및 키체인 자격 증명은 읽지 않으므로 Anthropic 인증은 `ANTHROPIC_API_KEY` 또는 `--settings`의 `apiKeyHelper`에서 와야 합니다. `--bare`를 전달하는 것과 동등합니다
`CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT`	모든 모델에서 더 짧은 시스템 프롬프트 및 축약된 도구 설명을 사용하려면 `1`로 설정하세요. 실험 또는 서버 구성이 그렇지 않으면 활성화하더라도 옵트아웃하려면 `0`, `false`, `no`, 또는 `off`로 설정하세요. 전체 도구 집합, 훅, MCP 서버, CLAUDE.md 검색은 활성화된 상태로 유지됩니다
`CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH`	AWS의 Claude Platform에 대한 클라이언트 측 인증을 건너뛰려면 설정하세요. 게이트웨이가 자신을 대신하여 요청에 서명하는 경우
`CLAUDE_CODE_SKIP_AWS_CRED_CACHE`	AWS 기본 자격 증명 제공자 체인의 인프로세스 캐시를 끄려면 `1`로 설정하세요. Claude Code는 모든 API 요청에서 체인을 확인합니다. 캐시가 꺼져 있으면, SSO 지원 프로필은 모든 요청에서 IAM Identity Center에 자격 증명을 요청합니다. 자격 증명 캐싱 및 확인 타임아웃을 참조하세요. Claude Code v2.1.207 이상이 필요합니다
`CLAUDE_CODE_SKIP_BEDROCK_AUTH`	Amazon Bedrock에 대한 AWS 인증을 건너뛰려면 설정하세요(예: LLM 게이트웨이 사용 시)
`CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS`	빠른 모드 가용성 확인이 실패한 것을 사용 가능한 것으로 취급하려면 `1`로 설정하세요. 네트워크가 확인의 직접 요청을 `api.anthropic.com`으로 차단하는 경우입니다. Claude Code는 여전히 "조직에서 빠른 모드가 비활성화됨" 응답을 존중합니다
`CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK`	클라이언트 측 빠른 모드 가용성 확인을 건너뛰려면 `1`로 설정하세요. 프록시가 확인의 요청을 거부하는 대신 가로채는 경우입니다. API는 조직이 빠른 모드를 비활성화했을 때 빠른 모드 요청을 여전히 거부합니다
`CLAUDE_CODE_SKIP_FOUNDRY_AUTH`	Microsoft Foundry에 대한 Azure 인증을 건너뛰려면 설정하세요. 프록시 또는 게이트웨이가 자신의 `Authorization` 헤더를 주입하는 경우입니다. Claude Code는 Azure 자격 증명 없이 요청을 보내고 `ANTHROPIC_CUSTOM_HEADERS`를 통해 제공하는 것과 같이 제공하는 `Authorization` 헤더를 보존합니다. `ANTHROPIC_FOUNDRY_API_KEY` 또는 `ANTHROPIC_FOUNDRY_AUTH_TOKEN`이 설정되면 무시됩니다. v2.1.203 이전에는 이 변수가 API 키도 설정되지 않으면 Microsoft Foundry 클라이언트가 요청을 보낼 수 없게 했습니다
`CLAUDE_CODE_SKIP_MANTLE_AUTH`	Amazon Bedrock Mantle에 대한 AWS 인증을 건너뛰려면 설정하세요(예: LLM 게이트웨이 사용 시)
`CLAUDE_CODE_SKIP_PROMPT_HISTORY`	프롬프트 기록 및 세션 대화 기록을 디스크에 작성하지 않으려면 `1`로 설정하세요. 이 변수로 시작된 세션은 `--resume`, `--continue`, 위쪽 화살표 기록에 나타나지 않습니다. 임시 스크립트 세션에 유용합니다
`CLAUDE_CODE_SKIP_VERTEX_AUTH`	Google Cloud의 Agent Platform에 대한 Google 인증을 건너뛰려면 설정하세요(예: LLM 게이트웨이 사용 시)
`CLAUDE_CODE_STOP_HOOK_BLOCK_CAP`	Stop 또는 SubagentStop 훅이 Claude Code가 어쨌든 턴을 끝내기 전에 턴이 끝나는 것을 차단할 수 있는 최대 연속 횟수입니다(기본값: 8). 상한을 비활성화하려면 `0`으로 설정하세요. 훅이 합법적으로 더 많은 반복이 필요하면 이를 올리세요
`CLAUDE_CODE_SUBAGENT_MODEL`	서브에이전트, 에이전트 팀 팀원, 워크플로우 에이전트의 기본 모델입니다. 다른 방식으로 모델이 할당되지 않은 경우입니다. `haiku`와 같은 별칭 또는 전체 모델 이름을 허용합니다. 두 소스가 이를 우선합니다: Claude가 에이전트를 생성할 때 전달하는 모델, 에이전트 정의의 `model` 필드(예: `inherit` 포함). 이를 변경하려면 `CLAUDE_CODE_SUBAGENT_MODEL_FORCE`를 설정하세요. 모델 선택에서 전체 순서를 참조하세요. `inherit`로 설정하는 것은 설정 해제하는 것과 동일합니다. v2.1.251 이전에는 이 변수가 호출별 모델과 정의의 `model` 필드를 모두 재정의했습니다
`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`	서브에이전트, 팀원, 워크플로우 에이전트에 하나의 모델을 강제하려면 `1`로 설정하세요. 모든 서브에이전트를 하나의 모델에서 실행에서 그 모델이 무엇인지 말합니다. Claude Code v2.1.257 이상이 필요합니다
`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`	`5m` 또는 `1h`를 설정합니다. Claude Code가 허용하는 유일한 값입니다. 서브에이전트, 워크플로우, 백그라운드 작업과 같은 주 대화 외부의 요청에 대한 프롬프트 캐시 TTL을 선택합니다. `subagentPromptCacheTtl` 설정 및 `ENABLE_PROMPT_CACHING_1H`보다 우선합니다. `FORCE_PROMPT_CACHING_5M`이 이를 재정의합니다. API는 1시간 캐시 쓰기를 더 높은 속도로 청구합니다. Claude Code v2.1.242 이상이 필요합니다
`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`	서브프로세스 환경에서 자격 증명을 제거하려면 `1`로 설정하세요(Bash 도구, 훅, MCP stdio 서버): Anthropic 및 클라우드 제공자 자격 증명, Claude Code가 자격 증명으로 인식하는 다른 변수, 패키지 레지스트리 URL에 포함된 자격 증명. 부모 Claude 프로세스는 API 호출을 위해 이러한 자격 증명을 유지하지만 자식 프로세스는 이를 읽을 수 없습니다. 셸 확장을 통해 비밀을 유출하려는 프롬프트 주입 공격에 대한 노출을 줄입니다. Linux에서는 Bash 서브프로세스를 격리된 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_SYNC_SKILLS`	활성화된 claude.ai 기술을 `~/.claude/skills/synced/`로 다운로드하고 10분마다 재동기화하려면 `1`로 설정하세요. 첫 번째 쿼리를 실행하기 전에 Claude Code는 기술 목록을 기다립니다. 최대 `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`까지 기다립니다. 다운로드 자체는 백그라운드에서 완료되고, Claude는 기술을 호출할 때 기술의 다운로드를 기다립니다. `synced` 폴더 이름은 이 다운로드를 위해 예약되어 있습니다. v2.1.227 이전에는 기술이 `~/.claude/skills/`로 직접 다운로드되었습니다. `-p` 플래그를 사용한 비대화형 모드에만 적용됩니다. claude.ai 인증이 필요합니다. 웹의 Claude Code 세션은 활성화된 claude.ai 기술을 자동으로 수신합니다. 여기서 설정할 필요가 없습니다. Claude Code는 다운로드된 기술에 적용되는 추가 규칙을 적용합니다. 예를 들어 머신에서 `!` 명령을 실행하지 않습니다
`CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS`	`CLAUDE_CODE_SYNC_SKILLS`가 설정되었을 때 세션 중간 기술 재동기화의 타임아웃(밀리초)(기본값: 30000). 호스트가 세션 중간에 기술 다시 로드를 요청할 때 트리거되는 다운로드를 제한합니다. 초과되면 재동기화가 중지되고 나머지 다운로드는 백그라운드에서 계속됩니다
`CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`	`CLAUDE_CODE_SYNC_SKILLS`가 설정되었을 때 첫 번째 쿼리가 초기 기술 목록을 기다리는 타임아웃(밀리초)(기본값: 5000). 초과되면 첫 번째 쿼리는 도착한 기술로 실행됩니다. 어느 쪽이든 다운로드는 백그라운드에서 완료되고, Claude는 기술을 호출할 때 기술의 다운로드를 기다립니다
`CLAUDE_CODE_SYNTAX_HIGHLIGHT`	diff 출력에서 구문 강조를 비활성화하려면 `false`로 설정하세요. 색상이 터미널 설정을 방해할 때 유용합니다. 코드 블록 및 파일 미리보기에서도 강조를 비활성화하려면 `syntaxHighlightingDisabled` 설정을 사용하세요
`CLAUDE_CODE_TASK_LIST_ID`	세션 간에 작업 목록을 공유합니다. 여러 Claude Code 인스턴스에서 동일한 ID를 설정하여 Task 도구가 있는 세션에서 공유 작업 목록을 조정합니다. 작업 목록을 참조하세요
`CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS`	비대화형 세션이 에이전트 팀 분해가 완료될 때까지 종료 시 대기하는 시간(밀리초)을 재정의합니다. 1000에서 60000을 허용합니다. 범위를 벗어난 값은 무시되고 기본값 10000이 적용됩니다. Claude Code v2.1.206 이상이 필요합니다
`CLAUDE_CODE_TMPDIR`	내부 임시 파일에 사용되는 임시 디렉토리를 재정의합니다. Claude Code는 Unix에서 이 경로에 `/claude-{uid}/`를 추가하거나 Windows에서 `/claude/`를 추가합니다. 기본값: macOS에서 `/tmp`, Linux 및 Windows에서 `os.tmpdir()`. macOS 및 Linux에서 샌드박스 Bash 서브프로세스는 재정의가 긴 경로인 경우 시스템 기본값 아래에서 짧은 폴백 `$TMPDIR`을 수신합니다. 일부 도구는 임시 경로가 너무 길면 실패합니다. 샌드박스되지 않은 Bash 명령은 셸의 `$TMPDIR`을 변경되지 않은 상태로 상속합니다. Claude Code의 자체 임시 파일은 항상 재정의를 사용합니다. 셸, 사용자 설정, 관리 설정에서 설정하세요. 프로젝트 및 로컬 설정에서는 무시됩니다
`CLAUDE_CODE_TMUX_TRUECOLOR`	tmux 내에서 24비트 truecolor 출력을 허용하려면 `1`과 같은 비어있지 않은 값으로 설정하세요. `0` 또는 `false`로 설정해도 truecolor가 허용됩니다. 대부분의 온/오프 변수와 달리 변수를 설정 해제하여 256색 제한을 복원하세요. 기본적으로 `$TMUX`가 설정되면 Claude Code는 256색으로 제한합니다. tmux는 구성되지 않으면 truecolor 이스케이프 시퀀스를 통과하지 않기 때문입니다. `~/.tmux.conf`에 `set -ga terminal-overrides ',*:Tc'`를 추가한 후 설정하세요. 터미널 구성에서 다른 tmux 설정을 참조하세요
`CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE`	Linux 및 WSL에서, Claude Code가 도구 메모리 상한에서 제외하는 프로세스 종류의 쉼표로 구분된 목록입니다(예: `mcp` 또는 `lsp`). 모든 종류를 제한하려면 `none`으로 설정하거나, Bash, PowerShell, Monitor 도구 명령만 제한하려면 `all-new`로 설정하세요. Claude Code는 나열한 것에 관계없이 Bash, PowerShell, Monitor 도구 명령을 상한 아래로 유지합니다. Claude Code v2.1.246 이상이 필요합니다
`CLAUDE_CODE_TOOL_MEMORY_LIMIT`	Linux 및 WSL에서, Bash 및 PowerShell 도구 명령이 사용할 수 있는 메모리를 제한하려면 `4G`와 같은 크기로 설정합니다. v2.1.246 이상에서 Monitor 도구 명령입니다. 바이트 수의 경우 일반 숫자만 작성하거나 `K`, `M`, `G`, 또는 `T` 접미사를 사용합니다. 상한을 끄려면 `0` 또는 `off`로 설정하세요. 첫 번째 프로세스 Claude Code가 상한을 켜거나 끈 후, 변경된 값은 다음에 `claude`를 시작할 때 적용됩니다. Claude Code v2.1.233 이상이 필요합니다
`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`	Claude Code가 원격 제어 또는 SDK 호스트와 같은 원격 클라이언트로 전달하는 대화 상자의 마감일(밀리초)입니다. 또는 보유된 교차 세션 메시지의 승인 대화 상자입니다. 권한 프롬프트 및 `AskUserQuestion` 질문은 자신의 흐름을 사용하며 이에 의해 관리되지 않습니다. Claude Code v2.1.236 이상에서는 무인 상태로 실행될 수 있는 세션의 세션 중간 Fable 사용 크레딧 동의 프롬프트도 제한합니다. 인바운드 메시지 제어 및 비대화형 세션은 마감일이 적용되지 않는 경우를 포함한 전체 보유 메시지 만료 규칙을 다룹니다. `dialogExpiry` 설정을 재정의합니다. `0` 또는 음수 값은 마감일을 비활성화합니다
`CLAUDE_CODE_USE_ANTHROPIC_AWS`	AWS의 Claude Platform을 사용합니다
`CLAUDE_CODE_USE_BEDROCK`	Amazon Bedrock을 사용합니다
`CLAUDE_CODE_USE_FOUNDRY`	Microsoft Foundry를 사용합니다
`CLAUDE_CODE_USE_MANTLE`	Amazon Bedrock Mantle 엔드포인트를 사용합니다
`CLAUDE_CODE_USE_NATIVE_FILE_SEARCH`	사용자 정의 명령, 서브에이전트, 출력 스타일을 ripgrep 대신 Node.js 파일 API를 사용하여 검색하려면 `1`로 설정하세요. 번들 ripgrep 바이너리를 사용할 수 없거나 환경에서 차단되는 경우 설정합니다. Grep 또는 파일 검색 도구에는 영향을 주지 않습니다
`CLAUDE_CODE_USE_POWERSHELL_TOOL`	PowerShell 도구를 제어합니다. Git Bash가 없는 Windows에서는 도구가 자동으로 활성화됩니다. `0`으로 설정하여 비활성화합니다. Git Bash가 설치된 Windows에서는 도구가 claude.ai 및 Console 계정에 대해 기본적으로 켜져 있습니다. Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry 세션에서 활성화하려면 `1`로 설정하거나, 끄려면 `0`으로 설정합니다. Linux, macOS, WSL에서는 `1`로 설정하여 활성화합니다. PATH에 `pwsh`가 필요합니다. Windows에서 활성화되면, Claude는 Git Bash를 통해 라우팅하는 대신 PowerShell 명령을 기본적으로 실행할 수 있습니다. PowerShell 도구를 참조하세요
`CLAUDE_CODE_USE_VERTEX`	Google Cloud의 Agent Platform을 사용합니다
`CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS`	WebFetch가 각 가져온 URL의 응답을 캐시하는 시간(밀리초)을 설정합니다. 기본값은 `900000`입니다. 15분입니다. 일반 숫자만 허용합니다. `0`, 소수, 다른 표기법은 기본값을 유지합니다. Claude Code는 시작당 한 번 값을 읽으므로 설정 `env` 블록의 변경은 다음에 `claude`를 시작할 때 적용됩니다. Claude Code v2.1.233 이상이 필요합니다
`CLAUDE_CODE_WEBFETCH_DEADLINE_MS`	WebFetch가 페이지 다운로드를 기다리는 시간(밀리초)의 상한입니다. 따라가는 리다이렉트 포함입니다. 그 시간까지 다운로드가 완료되지 않으면 마감일 오류로 실패합니다. 기본값은 `300000`입니다. 5분입니다. 제한을 제거하려면 `0`으로 설정하세요. 일반 숫자만 허용합니다. 소수 또는 다른 표기법은 기본값을 유지합니다. Claude Code v2.1.268 이상이 필요합니다
`CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS`	워크플로우 에이전트가 같은 접두사 형제의 첫 번째 응답이 시작되기를 기다리는 시간(밀리초)의 상한입니다. 팬아웃이 프롬프트 캐시 접두사를 공유하는 여러 에이전트를 시작할 때입니다. Claude Code는 첫 번째 에이전트를 제외한 모든 에이전트를 이 시간 동안 보유하므로 나머지는 캐시되지 않은 접두사를 각각 처리하는 대신 캐시된 접두사를 읽습니다. 기본값 `5000`. 대기를 비활성화하려면 `0`으로 설정하세요. `DISABLE_PROMPT_CACHING`이 설정되면 에이전트는 절대 기다리지 않습니다. Claude Code v2.1.229 이상이 필요합니다
`CLAUDE_CONFIG_DIR`	구성 디렉토리를 재정의합니다(기본값: `~/.claude`). 모든 설정, 세션 기록, 플러그인이 이 경로 아래에 저장됩니다. 자격 증명의 경우 Claude Code가 자격 증명을 저장하는 위치를 참조하세요. 여러 계정을 나란히 실행하는 데 유용합니다: 예를 들어, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. 셸, 사용자 설정, 관리 설정에서 설정하세요. 프로젝트 및 로컬 설정에서는 무시됩니다
`CLAUDE_DISABLE_ADOPT`	`←` 또는 `/background`를 눌러 세션을 백그라운드 처리할 때 진행 중인 백그라운드 작업을 계속하는 대신 중지하려면 `1`로 설정하세요. Claude Code는 백그라운드 처리 전에 확인하도록 요청한 후 계속될 작업을 중지합니다. Claude Code v2.1.195 이상이 필요합니다
`CLAUDE_EFFORT`	서브프로세스가 시작될 때 적용되는 노력 수준으로 Bash 도구 서브프로세스 및 훅 명령에서 자동으로 설정됩니다: `low`, `medium`, `high`, `xhigh`, 또는 `max`. Ultracode는 별개의 수준이 아니며 `xhigh`로 보고됩니다. 훅에 전달된 `effort.level` 필드와 일치합니다. 현재 모델이 노력 매개변수를 지원할 때만 설정됩니다
`CLAUDE_ENABLE_BYTE_WATCHDOG`	바이트 수준 스트리밍 유휴 감시견을 강제로 활성화하려면 `1`로 설정하거나, 강제로 비활성화하려면 `0`으로 설정하세요. `0`은 또한 해당 감시견이 실행되는 연결에서 첫 번째 바이트 마감일을 끕니다. 설정되지 않으면, 감시견은 직접 Anthropic API 및 AWS의 Claude Platform 연결에 대해 기본적으로 활성화되고, `ANTHROPIC_BASE_URL` 또는 `ANTHROPIC_AWS_BASE_URL`을 통해 도달한 게이트웨이 연결의 스트리밍 응답에 대해 활성화됩니다. v2.1.222 이전에는 해당 게이트웨이 연결에서 실행되지 않았으므로 이벤트 수준 감시견이 keep-alive 핑이 도착하는 동안에도 정지를 보고할 수 있었습니다. 타임아웃 및 타이머 상호 작용 방식에 대해서는 스트리밍 유휴 감시견을 참조하세요
`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK`	Amazon Bedrock `vnd.amazon.eventstream` 응답에서 바이트 수준 스트리밍 유휴 감시견을 활성화하려면 `1`로 설정하세요. 이는 또한 Bedrock 스트리밍 요청에서 첫 번째 바이트 마감일을 활성화합니다. 기본적으로 꺼져 있습니다. `CLAUDE_STREAM_IDLE_TIMEOUT_MS`로 타임아웃을 구성하세요
`CLAUDE_ENABLE_STREAM_WATCHDOG`	이벤트 수준 스트리밍 유휴 감시견을 강제로 비활성화하려면 `0`으로 설정하거나, 강제로 활성화하려면 `1`로 설정하세요. 설정되지 않으면, 감시견은 모든 제공자에 대해 기본적으로 켜져 있습니다. v2.1.196 이전에는 설정되지 않은 기본값이 직접 Anthropic API에서 서버 제어되었고 다른 제공자에서는 꺼져 있었습니다. `CLAUDE_STREAM_IDLE_TIMEOUT_MS`로 타임아웃을 구성하세요. 이와 함께 실행되는 다른 정지 타이머에 대해서는 스트리밍 유휴 감시견을 참조하세요
`CLAUDE_ENV_FILE`	Claude Code가 같은 셸 프로세스에서 각 Bash 명령 전에 실행하는 셸 스크립트의 경로입니다. 파일의 내보내기가 명령에 표시됩니다. virtualenv 또는 conda 활성화를 명령 간에 유지하는 데 사용합니다. 또한 SessionStart, Setup, CwdChanged, FileChanged 훅에 의해 동적으로 채워집니다
`CLAUDE_JOB_DIR`	Claude Code가 각 백그라운드 세션에서 해당 세션의 `~/.claude/jobs/<id>` 디렉토리로 설정합니다. 세션이 실행하는 셸 명령이 이를 상속합니다. 스크래치 파일을 `$CLAUDE_JOB_DIR/tmp`에 작성합니다. Claude의 `Write` 및 `Edit` 호출은 거기서 권한을 요청하지 않으며, 디렉토리는 세션이 삭제될 때 제거됩니다
`CLAUDE_PID`	Claude Code는 이를 생성하는 서브프로세스에서 자신의 프로세스 ID로 설정합니다: Bash 및 PowerShell 도구 명령 및 훅 명령입니다. Linux에서 Bash 도구의 셸 통합은 이를 사용하여 Claude Code 프로세스 자체와 일치하는 `pkill` 패턴을 거부합니다. 오류 참조를 참조하세요. 자신의 스크립트에서 읽어 부모 Claude Code 프로세스를 의도적으로 식별하거나 신호합니다. Claude Code v2.1.214 이상이 필요합니다
`CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX`	명시적 이름이 제공되지 않을 때 자동 생성된 원격 제어 세션 이름의 접두사입니다. 기본값은 머신의 호스트 이름이며, `myhost-graceful-unicorn`과 같은 이름을 생성합니다. `--remote-control-session-name-prefix` CLI 플래그는 단일 호출에 대해 동일한 값을 설정합니다
`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`	첫 번째 바이트 마감일이 실행되는 연결에서 스트리밍 요청의 첫 번째 응답 바이트의 마감일(밀리초)입니다. Claude Code가 이를 제한하는 방식, 큰 요청 본문에 추가하는 추가 시간, 설정하지 않을 때 마감일을 선택하는 방식에 대해서는 API의 응답 없음을 참조하세요. Claude Code v2.1.242 이상이 필요합니다
`CLAUDE_STREAM_IDLE_TIMEOUT_MS`	이벤트 및 바이트 수준 스트리밍 유휴 감시견이 정지된 연결을 닫기 전의 타임아웃(밀리초)입니다. 이 변수를 명시적으로 설정하면, 최소값은 `300000`(5분)입니다. 낮은 값은 확장 사고 일시 중지 및 프록시 버퍼링을 흡수하기 위해 자동으로 제한되고, 바이트 수준 감시견은 값을 30분으로 제한합니다. `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS`는 바이트 수준 감시견에 대해 이 변수보다 우선합니다. 감시견별 설정 해제 기본값에 대해서는 스트리밍 유휴 감시견을 참조하세요
`CLAUDE_SUBAGENT_BG_SHELL_MAX_MS`	v2.1.260에서 제거되었으며 이제 작동하지 않습니다. 이전에는 서브에이전트가 시작한 백그라운드 셸 명령이 실행될 수 있는 최대 시간(밀리초)을 제한했습니다. 기본값 60분입니다. 백그라운드 명령 수명 규칙을 참조하세요
`DEBUG`	디버그 모드를 활성화하려면 `1`로 설정하세요. `--debug`로 시작하는 것과 동등합니다. 디버그 로그는 `~/.claude/debug/<session-id>.txt`에 작성되거나 `CLAUDE_CODE_DEBUG_LOGS_DIR`으로 설정된 경로에 작성됩니다. `DEBUG=express:*`와 같은 네임스페이스 패턴이 다른 도구에 대해 설정되지 않으므로 `1`, `true`, `yes`, `on`의 참 값만 디버그 모드를 활성화합니다
`DISABLE_AUTOUPDATER`	자동 백그라운드 업데이트를 비활성화하려면 `1`로 설정하세요. 수동 `claude update`는 여전히 작동합니다. 둘 다 차단하려면 `DISABLE_UPDATES`를 사용하세요
`DISABLE_AUTO_COMPACT`	컨텍스트 제한에 접근할 때 자동 압축을 비활성화하려면 `1`로 설정하세요. 수동 `/compact` 명령은 계속 사용 가능합니다. 압축이 발생할 때를 명시적으로 제어하려고 할 때 사용합니다. `autoCompactEnabled` 설정을 재정의합니다
`DISABLE_COMPACT`	모든 압축을 비활성화하려면 `1`로 설정하세요: 자동 압축 및 수동 `/compact` 명령 모두
`DISABLE_COST_WARNINGS`	비용 경고 메시지를 비활성화하려면 `1`로 설정하세요
`DISABLE_DOCTOR_COMMAND`	`/doctor` 설정 체크업 기술 및 `/checkup` 별칭을 숨기려면 `1`로 설정하세요. 사용자가 세션에서 설정 진단을 실행하지 않아야 하는 관리 배포에 유용합니다. `claude doctor` 터미널 명령에는 영향을 주지 않습니다. v2.1.205 이전에는 이 변수가 `/doctor` 진단 화면 명령을 숨겼습니다
`DISABLE_ERROR_REPORTING`	오류 보고를 옵트아웃하려면 `1`과 같은 비어있지 않은 값으로 설정하세요. `0` 또는 `false`로 설정해도 옵트아웃됩니다. 대부분의 온/오프 변수와 달리 변수를 설정 해제하여 오류 보고를 다시 켜세요
`DISABLE_EXTRA_USAGE_COMMAND`	사용자가 속도 제한을 초과하여 추가 사용을 구매할 수 있는 `/usage-credits` 명령을 숨기려면 `1`로 설정하세요
`DISABLE_FEEDBACK_COMMAND`	`/feedback` 명령 및 Claude 작성 피드백을 비활성화하려면 `1`로 설정하세요. 또한 `/bug` 및 `/share`를 비활성화합니다. 이들은 동일한 경로를 통해 보고합니다. v2.1.212 이전에는 `/feedback`의 별칭이었으므로 명령이 모든 이름 아래에서 비활성화되었습니다. 더 이전 이름 `DISABLE_BUG_COMMAND`도 허용됩니다
`DISABLE_GROWTHBOOK`	GrowthBook 기능 플래그 가져오기를 비활성화하고 모든 플래그에 대해 코드 기본값을 사용하려면 `1` 또는 `true`로 설정하세요. 이는 원격 제어 및 기타 기능 플래그 가져오기가 필요한 기능을 사용할 수 없게 만듭니다. `0` 또는 `false`로 설정하면 가져오기가 켜집니다. 원격 분석 이벤트 로깅은 `DISABLE_TELEMETRY`도 설정되지 않으면 켜집니다
`DISABLE_INSTALLATION_CHECKS`	설치 경고를 비활성화하려면 `1`로 설정하세요. 설치 위치를 수동으로 관리할 때만 사용하세요. 표준 설치의 문제를 마스킹할 수 있습니다
`DISABLE_INSTALL_GITHUB_APP_COMMAND`	`/install-github-app` 명령을 숨기려면 `1`로 설정하세요. 타사 제공자(Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry)를 사용할 때 이미 숨겨져 있습니다
`DISABLE_INTERLEAVED_THINKING`	인터리브된 사고 베타 헤더를 보내지 않으려면 `1`로 설정하세요. LLM 게이트웨이 또는 제공자가 인터리브된 사고를 지원하지 않을 때 유용합니다
`DISABLE_LOGIN_COMMAND`	`/login` 명령을 숨기려면 `1`로 설정하세요. 인증이 API 키 또는 `apiKeyHelper`를 통해 외부적으로 처리될 때 유용합니다
`DISABLE_LOGOUT_COMMAND`	`/logout` 명령을 숨기려면 `1`로 설정하세요
`DISABLE_PROMPT_CACHING`	모든 모델에 대해 프롬프트 캐싱을 비활성화하려면 `1`로 설정하세요(모델별 설정보다 우선)
`DISABLE_PROMPT_CACHING_FABLE`	Fable 모델에 대해 프롬프트 캐싱을 비활성화하려면 `1`로 설정하세요
`DISABLE_PROMPT_CACHING_HAIKU`	Haiku 모델에 대해 프롬프트 캐싱을 비활성화하려면 `1`로 설정하세요
`DISABLE_PROMPT_CACHING_OPUS`	Opus 모델에 대해 프롬프트 캐싱을 비활성화하려면 `1`로 설정하세요
`DISABLE_PROMPT_CACHING_SONNET`	Sonnet 모델에 대해 프롬프트 캐싱을 비활성화하려면 `1`로 설정하세요
`DISABLE_TELEMETRY`	원격 분석을 옵트아웃하려면 `1`과 같은 비어있지 않은 값으로 설정하세요. `0` 또는 `false`로 설정해도 옵트아웃됩니다. 대부분의 온/오프 변수와 달리 변수를 설정 해제하여 원격 분석을 다시 켜세요. 원격 분석 이벤트는 코드, 파일 경로, bash 명령과 같은 사용자 데이터를 포함하지 않습니다. 또한 `DISABLE_GROWTHBOOK`과 동일한 효과로 기능 플래그 가져오기를 비활성화합니다. 이는 원격 제어 및 기타 기능 플래그 가져오기가 필요한 기능을 사용할 수 없게 만듭니다. 조직의 원격 분석 끄기를 참조하세요
`DISABLE_UPDATES`	수동 `claude update` 및 `claude install`을 포함한 모든 업데이트를 차단하려면 `1`로 설정하세요. `DISABLE_AUTOUPDATER`보다 더 엄격합니다. 자신의 채널을 통해 Claude Code를 배포하고 사용자가 자동 업데이트하지 않아야 할 때 사용합니다
`DISABLE_UPGRADE_COMMAND`	`/upgrade` 명령을 숨기려면 `1`로 설정하세요
`DO_NOT_TRACK`	`DISABLE_TELEMETRY`와 동일한 효과로 원격 분석을 옵트아웃하려면 `1`로 설정하세요. 원격 제어 및 기타 기능 플래그 가져오기가 필요한 기능을 사용할 수 없게 만듭니다. Claude Code는 이 변수를 표준 부울로 읽으므로 `0`은 원격 분석을 켜고, 많은 개발자 CLI에서 인식하는 교차 도구 규칙을 존중합니다
`ENABLE_BETA_TRACING_DETAILED`	`BETA_TRACING_ENDPOINT`와 함께 상세 베타 추적을 켜려면 `1`로 설정하세요. 콘텐츠 베어링 스팬 속성 및 `claude_code.hook` 스팬을 추가합니다. 대화형 CLI 세션도 조직이 베타에 대해 허용 목록에 있어야 합니다. 두 변수 모두 프로젝트 및 로컬 설정에서는 무시됩니다
`ENABLE_CLAUDEAI_MCP_SERVERS`	로그인한 사용자에 대해 기본적으로 활성화된 claude.ai MCP 서버를 가져오지 않도록 하려면 `false`로 설정하세요. 프로젝트 또는 조직별로 비활성화하려면 설정에서 `disableClaudeAiConnectors`를 설정하세요
`ENABLE_PROMPT_CACHING_1H`	기본 5분 대신 1시간 프롬프트 캐시 TTL을 요청하려면 `1`로 설정하세요. API 키, Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry, AWS의 Claude Platform 사용자를 위한 것입니다. 포함된 사용량 내의 구독 사용자는 주 대화에서 자동으로 1시간 TTL을 받습니다. 사용 크레딧을 사용하는 구독 사용자는 1시간 TTL을 유지하도록 설정할 수 있습니다. 1시간 캐시 쓰기는 더 높은 속도로 청구됩니다. 요청 버킷별로 TTL을 선택하려면 `CLAUDE_CODE_PROMPT_CACHE_TTL` 및 `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`을 사용하세요. 이들이 이 변수보다 우선합니다
`ENABLE_PROMPT_CACHING_1H_BEDROCK`	더 이상 사용되지 않습니다. 대신 `ENABLE_PROMPT_CACHING_1H`을 사용하세요
`ENABLE_TOOL_SEARCH`	MCP 도구 검색을 제어합니다. 설정되지 않으면, Claude Code는 기본적으로 모든 MCP 도구를 연기합니다. 그러나 Claude 4.5 세대보다 이전인 Google Cloud의 Agent Platform 모델, Azure에서 호스팅되는 Microsoft Foundry 배포, `ANTHROPIC_BASE_URL`이 비자사 호스트를 가리킬 때는 미리 로드합니다. `true`는 항상 연기하고 베타 헤더를 보냅니다. 예외는 동일한 Agent Platform 모델 및 Microsoft Foundry 배포입니다. 요청이 `tool_reference`를 지원하지 않는 프록시에서 실패합니다. `auto`는 도구 정의가 컨텍스트의 10% 이내에 맞을 때 미리 로드합니다. `auto:N`은 사용자 정의 임계값을 설정합니다(예: `auto:5`는 5%). `false`는 모든 도구를 미리 로드합니다. 자신이 설정한 값은 `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`가 설정되면 무시됩니다. v2.1.221 이전에는 Claude Code가 설정하지 않으면 Google Cloud의 Agent Platform의 모든 모델에 대해 도구 검색을 비활성화했습니다
`FALLBACK_FOR_ALL_PRIMARY_MODELS`	폴백 모델이 구성되지 않았을 때 반복된 과부하 오류에 대해 모든 모델의 재시도를 중지하도록 하려면 `1`과 같은 비어있지 않은 값으로 설정하세요. `0` 또는 `false`로 설정해도 이를 활성화합니다. 대부분의 온/오프 변수와 달리 변수를 설정 해제하여 기본 재시도 동작을 복원하세요. 이것이 없으면, Claude Code는 API 키 또는 타사 제공자를 사용하여 인증할 때 Opus, Fable, Mythos 모델로 인식하는 모델에 대해 이 방식으로 재시도를 중지합니다. Claude 구독을 사용하는 경우는 아닙니다. Claude Code v2.1.160 이상에서 Claude Code는 반복된 과부하 오류에 대해 모든 기본 모델에 대해 구성된 폴백 모델 체인으로 전환하므로 이 변수는 폴백 모델로의 전환에 영향을 주지 않습니다
`FORCE_AUTOUPDATE_PLUGINS`	주 자동 업데이트가 `DISABLE_AUTOUPDATER`를 통해 비활성화되었을 때도 플러그인 자동 업데이트를 강제하려면 `1`로 설정하세요
`FORCE_HYPERLINK`	터미널이 지원하지만 자동 감지되지 않을 때 클릭 가능한 OSC 8 하이퍼링크를 활성화하려면 `1`로 설정하거나, 비활성화하려면 `0`으로 설정하세요. 설정되지 않으면, Claude Code는 터미널 지원을 감지할 때만 하이퍼링크를 활성화합니다. Claude Code는 이 값을 부울이 아닌 숫자로 구문 분석하므로 `false`, `no`, `off`와 같은 값은 하이퍼링크를 비활성화하는 대신 활성화합니다. 바닥글 PR 또는 병합 요청 배지는 Claude Code가 터미널 지원을 감지할 수 없을 때(예: SSH를 통해)도 하이퍼링크로 렌더링됩니다. 배지를 일반 텍스트로 렌더링하려면 `0`으로 설정하세요
`FORCE_PROMPT_CACHING_5M`	1시간 TTL이 그렇지 않으면 적용되더라도 5분 프롬프트 캐시 TTL을 강제하려면 `1`로 설정하세요. `CLAUDE_CODE_PROMPT_CACHE_TTL`, `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, `ENABLE_PROMPT_CACHING_1H`, `promptCacheTtl` 및 `subagentPromptCacheTtl` 설정을 재정의합니다
`HTTP_PROXY`	네트워크 연결을 위한 HTTP 프록시 서버를 지정합니다
`HTTPS_PROXY`	네트워크 연결을 위한 HTTPS 프록시 서버를 지정합니다
`IS_DEMO`	데모 모드를 활성화하려면 `1`과 같은 비어있지 않은 값으로 설정하세요: 헤더 및 `/status` 출력에서 이메일 및 조직 이름을 숨기고 온보딩을 건너뜁니다. `0` 또는 `false`로 설정해도 데모 모드가 활성화됩니다. 대부분의 온/오프 변수와 달리 변수를 설정 해제하여 끄세요. 세션을 스트리밍하거나 녹화할 때 유용합니다
`MAX_MCP_OUTPUT_TOKENS`	MCP 도구 응답에서 허용되는 최대 토큰 수입니다. Claude Code는 출력이 10,000 토큰을 초과할 때 경고를 표시합니다. `anthropic/maxResultSizeChars`를 선언하는 도구는 텍스트 콘텐츠에 대해 해당 문자 제한을 대신 사용하지만, 해당 도구의 이미지 콘텐츠는 여전히 이 변수의 영향을 받습니다(기본값: 25000)
`MAX_STRUCTURED_OUTPUT_RETRIES`	비대화형 모드에서 `-p` 플래그를 사용한 `--json-schema`에 대한 유효성 검사에 실패할 때 Claude Code가 허용하는 시도 횟수입니다. 그 이후 유효한 출력이 없으면 실행이 실패합니다. 워크플로우 서브에이전트의 구조화된 출력이 유효성 검사에 실패할 때도 동일한 상한이 적용됩니다. 기본값 5, 첫 번째 시도 및 4번의 재시도
`MAX_THINKING_TOKENS`	확장 사고의 고정 토큰 예산입니다. Claude Code는 요청의 최대 출력 토큰보다 1개 토큰 아래로 제한하고 1,024 이상으로 제한하지 않습니다. `CLAUDE_CODE_MAX_OUTPUT_TOKENS`에서 해당 제한이 설정되는 방식을 참조하세요. 설정되지 않고 사고가 활성화되면, 적응형 추론을 가진 모델은 자신의 사고 깊이를 선택하고, 다른 모델은 상한을 사용합니다. Anthropic API에서 사고를 비활성화하려면 `0`으로 설정하세요. Fable 모델은 예외입니다. 이들은 사고를 끌 수 없습니다. 타사 제공자에서 `0`은 대신 `thinking` 매개변수를 생략합니다. Anthropic API에서 사고가 꺼져 있으면, Claude Code는 Opus 5와 같이 해당 조합을 받지 않는 모델에 노력 `high`를 대신 보냅니다. Claude Code는 적응형 추론 모델의 0이 아닌 값을 무시합니다. 적응형 추론을 끄는 모델은 예외입니다. `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`이 적응형 추론을 끕니다
`MCP_CLIENT_SECRET`	사전 구성된 자격 증명이 필요한 MCP 서버를 위한 OAuth 클라이언트 비밀입니다. 서버를 `--client-secret`으로 추가할 때 대화형 프롬프트를 피합니다
`MCP_CONNECTION_NONBLOCKING`	MCP 서버가 첫 번째 쿼리 전에 연결될 때까지 시작이 대기하는지 여부를 제어합니다. MCP 시작은 기본적으로 비차단입니다: 서버는 백그라운드에서 연결되고 도구는 완료되면 사용 가능해집니다. 첫 번째 쿼리 전에 서버가 연결될 때까지 기다리려면 `0`으로 설정하세요. `alwaysLoad: true`로 구성된 서버는 여전히 시작을 기다리게 합니다. 예외는 검색 캐시에서 제공되는 경우입니다. 도구가 첫 번째 프롬프트를 구성할 때 존재해야 하기 때문입니다. 비대화형 모드(`-p`)에서 Claude Code는 여전히 첫 번째 턴 전에 보류 중인 서버를 기다립니다. 이 변수에 관계없이 더 긴 마감일이 있습니다. `--mcp-config`를 명시적으로 전달할 때 캐시된 서버 예외를 참조하세요
`MCP_CONNECT_TIMEOUT_MS`	차단 MCP 시작이 도구 목록을 스냅샷하기 전에 연결 배치를 기다리는 시간(밀리초)(기본값: 5000). `MCP_CONNECTION_NONBLOCKING=0`이거나 `alwaysLoad: true`로 표시된 서버에 적용됩니다. 서버는 마감일에서 보류 중인 상태로 백그라운드에서 계속 연결됩니다. `MCP_TIMEOUT`과는 다릅니다. 이는 개별 서버의 연결 시도를 제한합니다
`MCP_DISCOVERY_CACHE`	MCP 검색 캐시를 켜거나 끕니다. 캐시가 켜져 있으면, 이전에 사용한 원격 HTTP 또는 SSE 서버가 `cached` 상태를 표시할 수 있고, Claude Code는 시작 시 대신 첫 번째 도구 호출에서 연결합니다. 캐시는 기본적으로 꺼져 있습니다. 점진적 롤아웃이 계정에 대해 활성화하지 않으면 말입니다. 켜려면 `1`로 설정하거나, 롤아웃이 활성화했을 때도 꺼두려면 `0`으로 설정하세요. v2.1.238 이전에는 캐시가 기본적으로 켜져 있었습니다. `cached` 상태에는 Claude Code v2.1.221 이상이 필요합니다
`MCP_DISCOVERY_CACHE_MAX_STALE_S`	검색 캐시 항목의 최대 나이(초)입니다 (기본값: 14400, 또는 4시간). 항목이 그보다 오래된 시작에서 Claude Code는 이를 버리고 시작 시 서버를 연결합니다. 캐시가 꺼져 있을 때처럼 말입니다. Claude Code는 값을 7일로 제한합니다. v2.1.238 이전에는 기본값이 86400(24시간)이었고 Claude Code는 값을 제한하지 않았습니다
`MCP_DISCOVERY_CACHE_STRIKES`	검색 캐시 항목이 `MCP_DISCOVERY_CACHE_TTL_S`보다 오래된 시작에서 Claude Code는 백그라운드에서 새로 고칩니다. 이 변수는 새로 고침이 연속으로 실패할 수 있는 횟수를 설정합니다. 그 후 Claude Code는 항목을 버리고 다음 시작에서 서버를 대신 연결합니다(기본값: 1). 네트워크 연결이 가끔 끊어지면 이를 올리세요. 하나의 실패한 새로 고침이 항목을 버리지 않도록 합니다. Claude Code v2.1.238 이상이 필요합니다
`MCP_DISCOVERY_CACHE_TTL_S`	Claude Code가 검색 캐시 항목을 새로 고치지 않고 사용하는 시간(초)(기본값: 900). 항목이 그보다 오래된 시작에서 Claude Code는 여전히 사용하지만 백그라운드에서 새로 고칩니다. 항목이 `MCP_DISCOVERY_CACHE_MAX_STALE_S`보다 오래되면 Claude Code는 버립니다. Claude Code는 값을 `MCP_DISCOVERY_CACHE_MAX_STALE_S`로 제한합니다. 기본값은 4시간입니다. v2.1.238 이전에는 Claude Code가 값을 제한하지 않았습니다
`MCP_OAUTH_CALLBACK_PORT`	사전 구성된 자격 증명을 사용하여 MCP 서버를 추가할 때 `--callback-port`의 대안으로 OAuth 리다이렉트 콜백의 고정 포트입니다
`MCP_PROTOCOL_NEGOTIATION`	v2 MCP 클라이언트 런타임에서만, Claude Code가 MCP 프로토콜 개정 2026-07-28에 대해 서버를 탐사하는지 여부입니다. HTTP, claude.ai 커넥터, stdio 서버를 탐사하려면 `auto`로 설정하세요. 탐사에 응답하지 않는 서버는 이전 프로토콜에서 연결됩니다. SSE 및 WebSocket 서버는 항상 그렇게 합니다. 모든 서버에 대해 탐사를 건너뛰려면 `legacy`로 설정하세요. 변수가 없으면, Claude Code는 Claude Code v2.1.232 이상에서 HTTP 및 claude.ai 커넥터 서버를 탐사합니다. MCP 클라이언트 런타임 섹션이 나열하는 예외가 있습니다. 다른 값은 무시되고 디버그 로그에 경고가 표시됩니다. Claude Code는 프로세스당 한 번 값을 읽습니다. Claude Code v2.1.221 이상이 필요합니다
`MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE`	시작 중에 병렬로 연결할 원격 MCP 서버(HTTP/SSE)의 최대 개수입니다(기본값: 20)
`MCP_SDK_GENERATION`	이 프로세스가 MCP 서버에 연결하는 MCP 클라이언트 런타임을 고정합니다: `v1`(MCP TypeScript SDK 1.x 기반) 또는 `v2`(MCP TypeScript SDK 2.0 기반). 변수가 없으면, Claude Code는 Claude Code v2.1.232 이상에서 v2를 사용합니다. 해당 섹션이 v1을 사용한다고 말하는 경우는 제외합니다. Claude Code v2.1.221 이상에서 v2 런타임은 MCP OAuth 서버가 인증 응답에서 반환하는 발급자를 확인하고 일치하지 않으면 `Issuer mismatch in authorization response`로 시작하는 오류로 로그인을 실패합니다. v1 런타임은 이 확인을 실행하지 않습니다. 인식되지 않은 값을 설정하면 Claude Code는 무시하고 디버그 로그에 경고를 작성합니다. Claude Code는 프로세스당 한 번 값을 읽습니다. Claude Code v2.1.218 이상이 필요합니다
`MCP_SERVER_CONNECTION_BATCH_SIZE`	시작 중에 병렬로 연결할 로컬 MCP 서버(stdio)의 최대 개수입니다(기본값: 3)
`MCP_TIMEOUT`	MCP 서버 시작의 타임아웃(밀리초)(기본값: 30000, 또는 30초)
`MCP_TOOL_TIMEOUT`	MCP 도구 실행의 타임아웃(밀리초)(기본값: 100000000, 약 28시간). HTTP, SSE, claude.ai 커넥터 서버의 경우, 각 요청도 기본적으로 60초 후 타임아웃됩니다. 이 변수를 설정하거나 서버별 `timeout`을 60000 이상으로 설정하여 요청당 제한을 올리세요. 더 낮은 값은 여전히 전체 도구 실행 타임아웃을 단축하지만 요청당 제한을 60초로 유지합니다. Stdio 및 WebSocket 서버에는 요청당 타이머가 없습니다. `.mcp.json`의 서버별 `timeout` 필드가 이를 재정의합니다. 서버별 `timeout`이 최소 1000이면 해당 서버의 도구 호출에 대한 최소 유휴 창도 설정합니다. `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`이 더 일찍 중단하지 않습니다. 이 바닥은 Claude Code v2.1.203 이상이 필요합니다. 변수의 경우 1000 미만의 값은 1초로 올라갑니다. 서버별 필드의 경우 1000 미만의 값은 무시됩니다
`NO_PROXY`	프록시를 우회하고 직접 요청이 발급될 도메인 및 IP의 목록입니다
`OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT`	속성 값 길이에 대한 표준 OpenTelemetry SDK 제한입니다. Claude Code는 콘텐츠 베어링 원격 분석 속성을 이것과 `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`의 더 작은 값으로 제한하므로 잘림 마커가 SDK 제한 내에 유지됩니다. Claude Code는 `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` 및 `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT` 변형을 동일하게 읽고, 설정된 가장 작은 값이 모든 신호에 적용됩니다. Claude Code v2.1.214 이상이 필요합니다. 모니터링을 참조하세요
`OTEL_LOG_ASSISTANT_RESPONSES`	`assistant_response` OpenTelemetry 로그 이벤트에 모델의 응답 텍스트를 포함하려면 `1`로 설정하세요. 설정되지 않으면 `OTEL_LOG_USER_PROMPTS`의 값이 대신 사용됩니다. `OTEL_LOG_USER_PROMPTS`가 설정되었을 때도 응답을 편집된 상태로 유지하려면 `0`으로 설정하세요. Claude Code v2.1.193 이상이 필요합니다. 모니터링을 참조하세요
`OTEL_LOG_RAW_API_BODIES`	Anthropic Messages API 요청 및 응답 JSON을 `api_request_body` / `api_response_body` 로그 이벤트로 내보냅니다. 콘텐츠 제한으로 잘린 인라인 본문의 경우 `1`로 설정하거나, 잘리지 않은 본문을 디스크에 작성하고 `body_ref` 경로를 내보내려면 `file:<dir>`로 설정하세요. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`는 콘텐츠 제한을 구성합니다. 기본값 60KB입니다. 기본적으로 비활성화됩니다. 본문은 전체 대화 기록을 포함합니다. 셸, 사용자 설정, 관리 설정에서 설정하세요. 프로젝트 및 로컬 설정에서는 무시됩니다. 모니터링을 참조하세요
`OTEL_LOG_TOOL_CONTENT`	OpenTelemetry 스팬 이벤트에 도구 입력 및 출력 콘텐츠를 포함하려면 `1`로 설정하세요. 기본적으로 비활성화되어 민감한 데이터를 보호합니다. 모니터링을 참조하세요
`OTEL_LOG_TOOL_DETAILS`	OpenTelemetry 추적 및 로그에 도구 입력 인수, MCP 서버 이름, 사용자 작성 워크플로우 이름, 도구 실패 시 원본 오류 문자열, `api_refusal` 이벤트의 거부 `category`, 기타 도구 세부 정보를 포함하려면 `1`로 설정하세요. 기본적으로 비활성화되어 PII를 보호합니다. 모니터링을 참조하세요
`OTEL_LOG_USER_PROMPTS`	OpenTelemetry 추적 및 로그에 사용자 프롬프트 텍스트를 포함하려면 `1`로 설정하세요. 기본적으로 비활성화됩니다(프롬프트는 편집됨). 모니터링을 참조하세요
`OTEL_METRICS_INCLUDE_ACCOUNT_UUID`	메트릭 속성에서 계정 UUID를 제외하려면 `false`로 설정하세요(기본값: 포함). 모니터링을 참조하세요
`OTEL_METRICS_INCLUDE_ENTRYPOINT`	메트릭 속성에 세션 진입점을 포함하려면 `true`로 설정하세요(기본값: 제외). v2.1.152에서 추가되었습니다. 모니터링을 참조하세요
`OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES`	v2.1.161부터 Claude Code는 `OTEL_RESOURCE_ATTRIBUTES` 키를 메트릭 데이터포인트 레이블에 첨부합니다. 제외하려면 `false`로 설정하세요(기본값: 포함). 모니터링을 참조하세요
`OTEL_METRICS_INCLUDE_SESSION_ID`	메트릭 속성에서 세션 ID를 제외하려면 `false`로 설정하세요(기본값: 포함). 모니터링을 참조하세요
`OTEL_METRICS_INCLUDE_VERSION`	메트릭 속성에 Claude Code 버전을 포함하려면 `true`로 설정하세요(기본값: 제외). 모니터링을 참조하세요
`SLASH_COMMAND_TOOL_CHAR_BUDGET`	Skill 도구에 표시되는 기술 메타데이터의 문자 예산을 재정의합니다. 예산은 컨텍스트 창의 1%에서 동적으로 확장되며, 폴백은 8,000자입니다. 이전 호환성을 위해 레거시 이름이 유지됩니다
`TASK_MAX_OUTPUT_LENGTH`	백그라운드 작업의 출력 중 `TaskOutput` 도구가 유지하는 최대 문자 수입니다(기본값: 32000; 최대값: 160000). `taskOutputMaxChars` 설정을 설정하면, Claude Code는 이 변수를 무시합니다
`USE_BUILTIN_RIPGREP`	포함된 `rg` 대신 시스템 설치 `rg`를 사용하려면 `0`으로 설정하세요
`VERTEX_REGION_CLAUDE_3_5_HAIKU`	Google Cloud의 Agent Platform을 사용할 때 Claude 3.5 Haiku의 리전을 재정의합니다
`VERTEX_REGION_CLAUDE_3_5_SONNET`	Google Cloud의 Agent Platform을 사용할 때 Claude 3.5 Sonnet의 리전을 재정의합니다
`VERTEX_REGION_CLAUDE_3_7_SONNET`	Google Cloud의 Agent Platform을 사용할 때 Claude 3.7 Sonnet의 리전을 재정의합니다
`VERTEX_REGION_CLAUDE_4_0_OPUS`	Google Cloud의 Agent Platform을 사용할 때 Claude 4.0 Opus의 리전을 재정의합니다
`VERTEX_REGION_CLAUDE_4_0_SONNET`	Google Cloud의 Agent Platform을 사용할 때 Claude 4.0 Sonnet의 리전을 재정의합니다
`VERTEX_REGION_CLAUDE_4_1_OPUS`	Google Cloud의 Agent Platform을 사용할 때 Claude 4.1 Opus의 리전을 재정의합니다
`VERTEX_REGION_CLAUDE_4_5_OPUS`	Google Cloud의 Agent Platform을 사용할 때 Claude Opus 4.5의 리전을 재정의합니다
`VERTEX_REGION_CLAUDE_4_5_SONNET`	Google Cloud의 Agent Platform을 사용할 때 Claude Sonnet 4.5의 리전을 재정의합니다
`VERTEX_REGION_CLAUDE_4_6_OPUS`	Google Cloud의 Agent Platform을 사용할 때 Claude Opus 4.6의 리전을 재정의합니다
`VERTEX_REGION_CLAUDE_4_6_SONNET`	Google Cloud의 Agent Platform을 사용할 때 Claude Sonnet 4.6의 리전을 재정의합니다
`VERTEX_REGION_CLAUDE_4_7_OPUS`	Google Cloud의 Agent Platform을 사용할 때 Claude Opus 4.7의 리전을 재정의합니다
`VERTEX_REGION_CLAUDE_4_8_OPUS`	Google Cloud의 Agent Platform을 사용할 때 Claude Opus 4.8의 리전을 재정의합니다
`VERTEX_REGION_CLAUDE_5_OPUS`	Google Cloud의 Agent Platform을 사용할 때 Claude Opus 5의 리전을 재정의합니다. v2.1.219에서 추가되었습니다
`VERTEX_REGION_CLAUDE_5_SONNET`	Google Cloud의 Agent Platform을 사용할 때 Claude Sonnet 5의 리전을 재정의합니다. v2.1.197에서 추가되었습니다
`VERTEX_REGION_CLAUDE_FABLE_5`	Google Cloud의 Agent Platform을 사용할 때 Claude Fable 5의 리전을 재정의합니다. v2.1.170에서 추가되었습니다
`VERTEX_REGION_CLAUDE_FABLE_5_1`	Google Cloud의 Agent Platform을 사용할 때 Claude Fable 5.1의 리전을 재정의합니다. v2.1.257에서 추가되었습니다
`VERTEX_REGION_CLAUDE_HAIKU_4_5`	Google Cloud의 Agent Platform을 사용할 때 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, 신호 특정 변형)도 지원됩니다. 구성 세부 정보는 모니터링을 참조하세요.

기능 플래그 가져오기가 필요한 기능

Claude Code는 Anthropic에서 가져오는 기능 플래그를 통해 일부 기능을 활성화합니다. Claude Code는 다음 세션에서 해당 가져오기를 건너뜁니다:

DISABLE_GROWTHBOOK, DISABLE_TELEMETRY, DO_NOT_TRACK 또는 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC을 설정한 세션; 변수 테이블의 각 변수 행에서 어떤 값이 가져오기를 비활성화하는지 나타냅니다
Amazon Bedrock, Claude Platform on AWS, Google Cloud의 Agent Platform 또는 Microsoft Foundry와 같은 타사 제공자의 세션(Claude Code를 포함하는 호스트 플랫폼이 CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST를 설정하지 않은 경우)
Claude 앱 게이트웨이 세션

가져오기가 비활성화된 경우 다음을 수행할 수 없습니다:

Pro, Max 및 Team 플랜에서 기본적으로 자동 모드로 세션 시작
VS Code 확장이 시작 권한 모드에 대한 설정 파일 읽기
/auto-mode-setup을 실행하여 autoMode.environment 항목 작성
원격 제어 사용
이 머신을 넘어 세션에 메시지 전송; 이 머신의 세션 간 메시징은 가져오기가 비활성화된 상태에서 작동합니다
claude import 또는 /import 명령 실행
/skill-doctor 실행 또는 /plugin Stats 탭에서 보고서 열기
어드바이저 도구 사용
아티팩트의 댓글 읽기 또는 답글 달기
MCP_SDK_GENERATION 및 MCP_PROTOCOL_NEGOTIATION을 설정하지 않고 v2 MCP 클라이언트 런타임 및 해당 프로토콜 프로브 가져오기; Claude Code는 MCP_SDK_GENERATION=v2를 설정하지 않으면 v1 런타임을 사용하고, MCP_PROTOCOL_NEGOTIATION=auto를 설정하지 않으면 프로브를 건너뜁니다
Git Bash가 설치된 Windows의 claude.ai 및 Console 계정에 대해 기본적으로 PowerShell 도구 가져오기; Claude Code는 CLAUDE_CODE_USE_POWERSHELL_TOOL=1을 설정하지 않으면 Git Bash를 통해 셸 명령을 라우팅합니다. Git Bash가 없는 Windows에서는 도구가 활성화된 상태로 유지됩니다
Claude가 작성한 피드백 가져오기(Claude Code는 가져온 플래그를 통해 활성화)
Claude Code가 API가 거부할 입력 스키마를 가진 MCP 도구 제외; 스키마를 어쨌든 전송하고, 이를 포함하는 요청은 도구를 위치로 이름 지정하는 400 오류로 실패합니다

설치 또는 업그레이드 후 첫 번째 세션

Claude Code를 설치한 후 또는 기능을 추가하는 버전으로 업그레이드한 후 첫 번째 세션에서 플래그 게이트된 기능이 누락될 수 있으며, 세션은 자동 모드로 시작하는 플랜에서 수동 모드로 시작할 수 있습니다. Claude Code는 해당 세션 중에 플래그를 가져오므로 다음 세션에서 둘 다 있습니다.

새로 설치한 후 claude -p, Agent SDK 또는 VS Code 확장과 같은 비대화형 세션에서 Claude Code는 시작 권한 모드를 선택하기 전에 플래그를 선택할 수 있습니다.

참고 항목

설정: 모든 settings.json 구성(예: env 키)
CLI 참조: 실행 시간 플래그
네트워크 구성: 프록시 및 TLS 설정
모니터링: OpenTelemetry 구성

env-vars.md +451 −316

4 4

5# 환경 변수5# 환경 변수

6 6

~~7> Claude Code 동작을 제어하는 환경 변수에 대한 참조입니다.~~7> Claude Code 동작을 제어하는 환경 변수에 대한 참고 자료입니다.

8 8

9환경 변수는 모델 선택, 인증, 요청 라우팅, 기능 토글과 같은 Claude Code 동작을 제어할 수 있습니다. 동일한 동작의 대부분은 [설정 파일](/docs/ko/settings) 필드, [CLI 플래그](/docs/ko/cli-reference), 또는 `/model`과 같은 세션 내 명령을 통해서도 구성할 수 있습니다.9환경 변수는 모델 선택, 인증, 요청 라우팅 및 기능 토글과 같은 Claude Code 동작을 제어할 수 있습니다. 동일한 동작의 대부분은 [설정 파일](/docs/ko/settings) 필드, [CLI 플래그](/docs/ko/cli-reference) 또는 `/model`과 같은 세션 내 명령을 통해서도 구성할 수 있습니다.

10 10

11이 페이지에서는 다음을 다룹니다:11이 페이지에서는 다음을 다룹니다:

12 12

~~13* [환경 변수 설정](#set-environment-variables) - 셸 또는 설정 파일에서~~13* [환경 변수 설정](#set-environment-variables) 방법 (셸 또는 설정 파일에서)

~~14* [어떤 값이 적용되는지 확인](#precedence) - 동작을 여러 방법으로 설정할 수 있을 때~~14* [동작을 설정할 수 있는 방법이 여러 개일 때 어떤 값이 적용되는지](#precedence) 확인

15* [Claude Code가 읽는 변수 조회](#variables)15* [Claude Code가 읽는 변수 조회](#variables)

16* [변수가 기능 플래그 가져오기를 끄면 어떤 기능이 작동을 멈추는지](#features-that-need-feature-flag-fetching) 확인

16 17

17<h2 id="set-environment-variables">18<h2 id="set-environment-variables">

18 환경 변수 설정19 환경 변수 설정

19</h2>20</h2>

20 21

~~21셸에서 설정한 변수는 해당 터미널 세션 동안만 지속되지만, 설정 파일의 변수는 `claude`가 실행될 때마다 적용됩니다.~~22셸에서 설정한 변수는 해당 터미널 세션 동안만 유지되며, 설정 파일의 변수는 `claude`가 실행될 때마다 적용됩니다.

22 23

23<h3 id="in-your-shell">24<h3 id="in-your-shell">

24 셸에서25 셸에서

33 claude34 claude

34 ```35 ```

35 36

~~36 모든 세션에 대해 설정하려면 `export` 줄을 `~/.bashrc`, `~/.zshrc`, 또는 셸의 프로필 파일에 추가합니다.~~37 모든 세션에서 설정하려면 `~/.bashrc`, `~/.zshrc` 또는 셸의 프로필 파일에 `export` 줄을 추가합니다.

37 </Tab>38 </Tab>

38 39

39 <Tab title="Windows PowerShell">40 <Tab title="Windows PowerShell">

42 claude43 claude

43 ```44 ```

44 45

~~45 모든 세션에 대해 설정하려면 `[Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", "1200000", "User")`를 실행하고 새 터미널을 엽니다.~~46 모든 세션에서 설정하려면 `[Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", "1200000", "User")`를 실행하고 새 터미널을 엽니다.

46 </Tab>47 </Tab>

47 48

48 <Tab title="Windows CMD">49 <Tab title="Windows CMD">

51 claude52 claude

52 ```53 ```

53 54

~~54 모든 세션에 대해 설정하려면 `setx API_TIMEOUT_MS "1200000"`을 실행하고 새 터미널을 엽니다.~~55 모든 세션에서 설정하려면 `setx API_TIMEOUT_MS "1200000"`을 실행하고 새 터미널을 엽니다.

56 </Tab>

57</Tabs>

59할당 줄은 성공 시 아무것도 출력하지 않으므로, `claude`를 실행하기 전에 같은 셸에서 변수를 출력하여 설정되었는지 확인합니다:

61<Tabs>

62 <Tab title="macOS, Linux, WSL">

63 ```bash theme={null}

64 echo $API_TIMEOUT_MS

65 ```

66 </Tab>

68 <Tab title="Windows PowerShell">

69 ```powershell theme={null}

70 echo $env:API_TIMEOUT_MS

71 ```

72 </Tab>

74 <Tab title="Windows CMD">

75 ```batch theme={null}

76 echo %API_TIMEOUT_MS%

77 ```

55 </Tab>78 </Tab>

56</Tabs>79</Tabs>

57 80

59 설정 파일에서82 설정 파일에서

60</h3>83</h3>

61 84

62`settings.json` 파일의 `env` 키 아래에 변수를 추가합니다. Claude Code는 시작 시 파일에서 직접 읽으므로 `claude`가 어떻게 실행되었는지와 관계없이 적용됩니다.85`settings.json` 파일의 `env` 키 아래에 변수를 추가하고, 파일이 없으면 생성합니다. Claude Code는 파일에서 직접 읽으므로 `claude`가 어떻게 실행되었는지와 관계없이 적용됩니다. 실행 중인 세션은 파일을 저장할 때 새로운 값과 변경된 값을 환경에 적용하지만, [OpenTelemetry 모니터링](/docs/ko/monitoring-usage)과 같이 시작 시 변수를 한 번만 읽는 기능은 다시 실행할 때까지 시작 값을 유지합니다. 파일에서 변수를 제거해도 실행 중인 세션에서 설정 해제되지 않으며, 제거는 다음 번 `claude`를 실행할 때 적용됩니다.

63 86

64```json ~/.claude/settings.json theme={null}87```json ~/.claude/settings.json theme={null}

65{88{

70}93}

71```94```

72 95

~~73선택한 파일이 변수가 적용되는 대상을 제어합니다:~~96선택한 파일은 변수가 적용되는 대상을 제어합니다:

74 97

75| 파일 | 적용 대상 |98| 파일 | 적용 대상 |

~~76| :---------------------------- | :-------------------------------------- |~~99| :---------------------------- | :----------------------------------------------------------------------------- |

~~80| 관리형 설정 | 조직의 모든 사람, 관리자가 배포 |~~103| 관리되는 설정 | 관리자가 배포한 조직의 모든 사람 |

81 104

82각 파일이 있는 위치는 [설정 파일](/docs/ko/settings#settings-files)을 참조하고, 둘 이상이 동일한 변수를 설정할 때 결합되는 방식은 [설정 우선순위](/docs/ko/settings#settings-precedence)를 참조합니다.105각 파일이 있는 위치는 [설정 파일](/docs/ko/settings#where-settings-live)을 참조하고, 둘 이상이 같은 변수를 설정할 때 결합되는 방식은 [설정 우선순위](/docs/ko/settings#settings-precedence)를 참조합니다.

83 106

84<h2 id="precedence">107<h2 id="precedence">

85 우선순위108 우선순위

86</h2>109</h2>

87 110

88동일한 동작에 환경 변수와 설정 필드가 모두 있는 경우, 환경 변수가 우선합니다. 예를 들어 `ANTHROPIC_MODEL`은 `model` 설정을 재정의하고, `CLAUDE_CODE_AUTO_CONNECT_IDE`는 `autoConnectIde`를 재정의합니다. 환경 변수가 설정되지 않으면 설정 필드가 적용됩니다.111일부 동작은 환경 변수와 전용 설정 키 모두를 가지고 있으며, Claude Code가 어느 것을 먼저 읽는지는 키마다 다릅니다. `ANTHROPIC_MODEL`과 `CLAUDE_CODE_AUTO_CONNECT_IDE`의 경우, Claude Code는 변수를 먼저 읽고 변수가 설정되지 않았을 때만 `model` 또는 `autoConnectIde` 설정을 사용합니다. 설정하려는 쌍의 경우, 아래의 변수 행과 [설정 참조](/docs/ko/settings-reference)의 키 항목을 확인하십시오.

112

113동일한 변수가 셸과 설정 파일 `env` 블록 모두에 설정된 경우, 설정 파일 값이 적용됩니다. Claude Code는 각 `env` 항목을 프로세스 환경에 기록하여 셸에서 상속된 값을 대체합니다. [`env` 설정](/docs/ko/settings-reference#when-claude-code-applies-env-values)은 언제 적용되는지를 나타냅니다. 몇 가지 변수는 특별하게 처리됩니다. [`env` 설정](/docs/ko/settings-reference#env)은 예외를 나열합니다.

89 114

90셸과 설정 파일 `env` 블록 모두에서 동일한 변수가 설정된 경우, 설정 파일 값이 적용됩니다. Claude Code는 시작 시 각 `env` 항목을 프로세스 환경에 기록하여 셸에서 상속된 값을 대체합니다. 몇 가지 변수는 특별하게 처리되며, [`env` 설정](/docs/ko/settings#available-settings)에서 예외를 나열합니다.115설정 파일에서 변수를 설정할 수 있지만 제거할 수는 없습니다. 제어하지 않는 셸 프로필에서 내보낸 `CLAUDE_CODE_USE_VERTEX`와 같이 설정 해제할 수 없는 변수를 재정의하려면, `env` 블록에서 빈 문자열로 설정하십시오: `"CLAUDE_CODE_USE_VERTEX": ""`. Claude Code는 빈 값을 공급자 선택을 위해 설정 해제된 것으로 취급합니다. 하위 프로세스는 여전히 빈 값을 상속합니다.

91 116

92설정 파일 간에 `env` 값은 [설정 우선순위](/docs/ko/settings#settings-precedence)를 따르므로, 관리되는 설정 항목이 사용자 또는 프로젝트 설정의 동일한 변수를 재정의합니다.117설정 파일 간에 `env` 값은 [설정 우선순위](/docs/ko/settings#settings-precedence)를 따르므로, 관리되는 설정 항목이 사용자 또는 프로젝트 설정의 동일한 변수를 재정의합니다.

93 118

94환경 변수가 CLI 플래그 및 세션 내 명령과 상호작용하는 방식은 기능별로 다릅니다: `--model` 및 `/model`은 `ANTHROPIC_MODEL`을 재정의하지만, `CLAUDE_CODE_EFFORT_LEVEL`은 `/effort`를 재정의합니다. 변수가 다른 구성 소스와 상호작용할 때, [변수](#variables) 목록의 행에서 우선순위를 명시하거나 이를 문서화하는 페이지로 연결합니다.119환경 변수가 CLI 플래그 및 세션 내 명령과 상호 작용하는 방식은 기능마다 다릅니다: `--model`과 `/model`은 `ANTHROPIC_MODEL`을 재정의하고, `CLAUDE_CODE_EFFORT_LEVEL`은 `--effort`와 `/effort`를 재정의합니다. 변수가 다른 구성 소스와 상호 작용할 때, [변수](#variables) 목록의 해당 행은 우선순위를 나타내거나 이를 문서화하는 페이지로 연결됩니다.

95 120

~~96Claude Code는 시작 시 환경 변수를 읽으므로 변경 사항은 다음에 `claude`를 실행할 때 적용됩니다.~~121Claude Code는 시작 시 셸 환경 변수를 읽으므로, 이에 대한 변경 사항은 다음에 `claude`를 시작할 때 적용됩니다. 설정 파일의 `env` 키 아래에 설정된 변수는 파일이 변경될 때 실행 중인 세션에 다시 적용되며, [설정 파일에서](#in-settings-files)에 설명된 시작 전용 예외가 있습니다.

97 122

98<h2 id="variables">123<h2 id="variables">

99 변수124 변수

100</h2>125</h2>

101 126

127숫자 변수(예: 타임아웃, 토큰 예산, 재시도 횟수)는 일반 숫자 외에도 과학 표기법과 숫자 구분 기호 표기법을 허용합니다. 단, 변수의 행에서 일반 숫자만 사용한다고 명시한 경우는 제외됩니다. 예를 들어 Claude Code는 `2e3`을 2000으로, `64_000`을 64000으로 읽습니다. v2.1.211 이전에는 이러한 표기법이 타임아웃을 1로 설정하는 `1e6`과 같이 훨씬 작은 값을 자동으로 설정할 수 있었습니다.

128

129<Note>

130 동작을 켜거나 끄는 변수의 경우, `1` 또는 `true`를 설정하여 켜고 `0` 또는 `false`를 설정하여 끕니다(대소문자 구분 없음).

131

132 일부 변수는 설정 여부만 읽으므로, `0`을 포함한 모든 비어있지 않은 값이 동작을 켜고, 변수를 설정 해제하거나 빈 값으로 설정하여 동작을 끕니다. 이러한 변수들은 다음과 같습니다:

133

134 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`

135 * `DISABLE_TELEMETRY`

136 * `DISABLE_ERROR_REPORTING`

137 * `CLAUDE_CODE_TMUX_TRUECOLOR`

138 * `FALLBACK_FOR_ALL_PRIMARY_MODELS`

139 * `IS_DEMO`

140

141 다른 하나의 변수는 자체 규칙을 가집니다: `FORCE_HYPERLINK`는 숫자를 읽으므로 `0`만 끕니다. 각 변수의 행에도 자체 규칙이 명시되어 있습니다.

142</Note>

143

102| 변수 | 목적 |144| 변수 | 목적 |

103| :------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |145| :------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

104| `ANTHROPIC_API_KEY` | `X-Api-Key` 헤더로 전송되는 API 키입니다. 설정하면 로그인되어 있더라도 Claude Pro, Max, Team 또는 Enterprise 구독 대신 이 키가 사용됩니다. 비대화형 모드(`-p`)에서는 키가 있을 때 항상 사용됩니다. 대화형 모드에서는 키가 구독을 재정의하기 전에 한 번 승인하도록 프롬프트됩니다. 구독을 대신 사용하려면 `unset ANTHROPIC_API_KEY`를 실행합니다. |146| `ANTHROPIC_API_KEY` | `X-Api-Key` 헤더로 전송되는 API 키입니다. 설정되면, 로그인되어 있더라도 이 키가 Claude Pro, Max, Team 또는 Enterprise 구독 대신 사용됩니다. 비대화형 모드(`-p`)에서는 키가 있을 때 항상 사용됩니다. 대화형 모드에서는 키가 구독을 재정의하기 전에 한 번 승인하도록 요청됩니다. 구독을 대신 사용하려면 `unset ANTHROPIC_API_KEY`를 실행하세요 |

106| `ANTHROPIC_AWS_API_KEY` | [Claude Platform on AWS](/docs/ko/claude-platform-on-aws)의 워크스페이스 API 키이며, AWS 콘솔에서 생성됩니다. `x-api-key`로 전송되며 AWS SigV4보다 우선합니다. |148| `ANTHROPIC_AWS_API_KEY` | [AWS의 Claude Platform](/docs/ko/claude-platform-on-aws)용 워크스페이스 API 키이며, AWS 콘솔에서 생성됩니다. `x-api-key`로 전송되며 AWS SigV4보다 우선합니다 |

107| `ANTHROPIC_AWS_BASE_URL` | [Claude Platform on AWS](/docs/ko/claude-platform-on-aws) 엔드포인트 URL을 재정의합니다. 사용자 정의 리전 또는 [LLM 게이트웨이](/docs/ko/llm-gateway)를 통해 라우팅할 때 사용합니다. 기본값은 `https://aws-external-anthropic.{AWS_REGION}.api.aws`입니다. |149| `ANTHROPIC_AWS_BASE_URL` | [AWS의 Claude Platform](/docs/ko/claude-platform-on-aws) 엔드포인트 URL을 재정의합니다. 사용자 정의 리전이나 [LLM 게이트웨이](/docs/ko/llm-gateway)를 통한 라우팅에 사용합니다. 기본값은 `https://aws-external-anthropic.{region}.api.aws`입니다. Claude Code는 [Amazon Bedrock과 동일한 우선순위로 리전을 확인합니다](/docs/ko/amazon-bedrock#3-configure-claude-code) |

108| `ANTHROPIC_AWS_WORKSPACE_ID` | [Claude Platform on AWS](/docs/ko/claude-platform-on-aws)에 필수입니다. 모든 요청에서 `anthropic-workspace-id` 헤더로 전송됩니다. |150| `ANTHROPIC_AWS_WORKSPACE_ID` | [AWS의 Claude Platform](/docs/ko/claude-platform-on-aws)에 필수입니다. 모든 요청에서 `anthropic-workspace-id` 헤더로 전송됩니다 |

109| `ANTHROPIC_BASE_URL` | API 엔드포인트를 재정의하여 프록시 또는 게이트웨이를 통해 요청을 라우팅합니다. 비자사 호스트로 설정하면 [MCP 도구 검색](/docs/ko/mcp#scale-with-mcp-tool-search)이 기본적으로 비활성화됩니다. 프록시가 `tool_reference` 블록을 전달하면 `ENABLE_TOOL_SEARCH=true`로 설정합니다. v2.1.196부터 [Remote Control](/docs/ko/remote-control#requirements)은 이것이 `api.anthropic.com` 이외의 호스트를 가리킬 때 비활성화되며, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry의 동작과 일치합니다. |151| `ANTHROPIC_BASE_URL` | API 엔드포인트를 재정의하여 프록시 또는 게이트웨이를 통해 요청을 라우팅합니다. 비자사 호스트로 설정되면, [MCP 도구 검색](/docs/ko/mcp#scale-with-mcp-tool-search)이 기본적으로 비활성화됩니다. 프록시가 `tool_reference` 블록을 전달하면 `ENABLE_TOOL_SEARCH=true`를 설정하세요. v2.1.196부터 [원격 제어](/docs/ko/remote-control#requirements)는 이것이 `api.anthropic.com` 이외의 호스트를 가리킬 때 비활성화되며, Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry의 동작과 일치합니다 |

110| `ANTHROPIC_BEDROCK_BASE_URL` | Amazon Bedrock 엔드포인트 URL을 재정의합니다. 사용자 정의 Amazon Bedrock 엔드포인트 또는 [LLM 게이트웨이](/docs/ko/llm-gateway)를 통해 라우팅할 때 사용합니다. [Amazon Bedrock](/docs/ko/amazon-bedrock) 참조 |152| `ANTHROPIC_BEDROCK_BASE_URL` | Amazon Bedrock 엔드포인트 URL을 재정의합니다. 사용자 정의 Amazon Bedrock 엔드포인트나 [LLM 게이트웨이](/docs/ko/llm-gateway)를 통한 라우팅에 사용합니다. [Amazon Bedrock](/docs/ko/amazon-bedrock)을 참조하세요 |

111| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Amazon Bedrock Mantle 엔드포인트 URL을 재정의합니다. [Mantle 엔드포인트](/docs/ko/amazon-bedrock#use-the-mantle-endpoint) 참조 |153| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Amazon Bedrock Mantle 엔드포인트 URL을 재정의합니다. [Mantle 엔드포인트](/docs/ko/amazon-bedrock#use-the-mantle-endpoint)를 참조하세요 |

112| `ANTHROPIC_BEDROCK_SERVICE_TIER` | Amazon Bedrock [서비스 계층](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html)(`default`, `flex`, 또는 `priority`). `X-Amzn-Bedrock-Service-Tier` 헤더로 전송됩니다. [Amazon Bedrock](/docs/ko/amazon-bedrock#service-tiers) 참조 |154| `ANTHROPIC_BEDROCK_REGION_PREFIX` | 교차 리전 추론 프로필 접두사(`us`, `eu`, `apac`, `jp`, `au`, 또는 `global`) Claude Code가 AWS 리전에서 파생된 것 대신 먼저 시도합니다. AWS GovCloud 리전에서는 무시됩니다. Claude Code v2.1.224 이상이 필요합니다. [Amazon Bedrock](/docs/ko/amazon-bedrock#cross-region-inference-profile-prefixes)을 참조하세요 |

113| `ANTHROPIC_BETAS` | API 요청에 포함할 추가 `anthropic-beta` 헤더 값의 쉼표로 구분된 목록입니다. Claude Code는 이미 필요한 베타 헤더를 전송합니다. Claude Code가 기본 지원을 추가하기 전에 [Anthropic API 베타](https://platform.claude.com/docs/en/api/beta-headers)에 옵트인하려면 이를 사용합니다. API 키 인증이 필요한 [`--betas` 플래그](/docs/ko/cli-reference#cli-flags)와 달리 이 변수는 Claude.ai 구독을 포함한 모든 인증 방법에서 작동합니다. |155| `ANTHROPIC_BEDROCK_SERVICE_TIER` | Amazon Bedrock [서비스 계층](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html)(`default`, `flex`, 또는 `priority`)입니다. `X-Amzn-Bedrock-Service-Tier` 헤더로 전송됩니다. [Amazon Bedrock](/docs/ko/amazon-bedrock#service-tiers)을 참조하세요 |

114| `ANTHROPIC_CUSTOM_HEADERS` | 요청에 추가할 사용자 정의 헤더(`Name: Value` 형식, 여러 헤더의 경우 줄바꿈으로 구분) |156| `ANTHROPIC_BETAS` | API 요청에 포함할 추가 `anthropic-beta` 헤더 값의 쉼표로 구분된 목록입니다. Claude Code는 이미 필요한 베타 헤더를 전송합니다. Claude Code가 기본 지원을 추가하기 전에 [Anthropic API 베타](https://platform.claude.com/docs/en/api/beta-headers)에 옵트인하려면 이를 사용하세요. API 키 인증이 필요한 [`--betas` 플래그](/docs/ko/cli-reference#cli-flags)와 달리, 이 변수는 Claude.ai 구독을 포함한 모든 인증 방법에서 작동합니다 |

115| `ANTHROPIC_CUSTOM_MODEL_OPTION` | `/model` 선택기에 사용자 정의 항목으로 추가할 모델 ID입니다. 기본 제공 별칭을 대체하지 않고 비표준 또는 게이트웨이 특정 모델을 선택 가능하게 만드는 데 사용합니다. [모델 구성](/docs/ko/model-config#add-a-custom-model-option) 참조 |157| `ANTHROPIC_CUSTOM_HEADERS` | 요청에 추가할 사용자 정의 헤더입니다(`Name: Value` 형식, 여러 헤더의 경우 줄바꿈으로 구분). 이름이나 값에 곡선 따옴표나 너비가 0인 공백과 같이 HTTP 헤더가 전달할 수 없는 문자가 포함되면, 요청이 쌍을 위치로 식별하는 오류로 실패합니다. Claude Code v2.1.227 이상이 필요합니다. [잘못된 요청 헤더 값](/docs/ko/errors#invalid-request-header-value)은 정확한 문자 집합과 검사가 실행되는 위치를 나열합니다. 자격 증명, 조직 또는 테넌트, 라우팅 또는 API 동작 헤더(예: `Authorization` 또는 `Host`)를 설정하는 값은 서버 관리 설정이 전달할 때 [승인이 필요한 설정](/docs/ko/server-managed-settings#environment-variables-and-the-approval-dialog)으로 계산됩니다. 프로젝트 또는 로컬 설정에서 이러한 값은 [`env` 값이 적용되는 시기에 대한 규칙](/docs/ko/settings-reference#when-claude-code-applies-env-values)을 따릅니다 |

116| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | `/model` 선택기의 사용자 정의 모델 항목에 대한 표시 설명입니다. 설정하지 않으면 `Custom model (<model-id>)`로 기본값이 설정됩니다. |158| `ANTHROPIC_CUSTOM_MODEL_OPTION` | `/model` 선택기에 사용자 정의 항목으로 추가할 모델 ID입니다. 기본 제공 별칭을 대체하지 않고 비표준 또는 게이트웨이 특정 모델을 선택 가능하게 만드는 데 사용합니다. [모델 구성](/docs/ko/model-config#add-a-custom-model-option)을 참조하세요 |

117| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | `/model` 선택기의 사용자 정의 모델 항목에 대한 표시 이름입니다. 설정하지 않으면 모델 ID로 기본값이 설정됩니다. |159| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | `/model` 선택기의 사용자 정의 모델 항목에 대한 표시 설명입니다. 설정되지 않으면 `Custom model (<model-id>)`로 기본값이 설정됩니다 |

118| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities) 참조 |160| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | `/model` 선택기의 사용자 정의 모델 항목에 대한 표시 이름입니다. 설정되지 않으면, Claude Code가 [ID를 인식](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)하면 항목에 모델의 이름이 표시되고, 그렇지 않으면 모델 ID가 표시됩니다 |

119| `ANTHROPIC_DEFAULT_FABLE_MODEL` | [모델 구성](/docs/ko/model-config#environment-variables) 참조 |161| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | 사용자 정의 모델이 지원하는 [기능](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)의 쉼표로 구분된 목록입니다(예: `effort,thinking`). [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하세요 |

120| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities) 참조 |162| `ANTHROPIC_DEFAULT_FABLE_MODEL` | `fable` 별칭이 확인되는 모델 ID이며, Claude Code가 타사 제공자에서 [자동 모델 폴백](/docs/ko/model-config#automatic-model-fallback)을 위해 Fable 모델로 인식하는 ID입니다. [모델 구성](/docs/ko/model-config#environment-variables)을 참조하세요 |

121| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities) 참조 |163| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | `/model` 선택기에서 고정된 Fable 모델에 대한 표시 설명입니다. 설정되지 않으면, 행에 `Custom Fable model`로 시작하는 기본 설명이 표시됩니다. [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하세요 |

122| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities) 참조 |164| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | `/model` 선택기에서 고정된 Fable 모델에 대한 표시 이름입니다. 설정되지 않으면, Claude Code가 고정된 ID를 인식하면 행에 모델의 이름이 표시되고, 그렇지 않으면 고정된 ID가 표시됩니다. [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하세요 |

123| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | [모델 구성](/docs/ko/model-config#environment-variables) 참조 |165| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | 고정된 Fable 모델이 지원하는 [기능](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)의 쉼표로 구분된 목록입니다(예: `effort,thinking`). [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하세요 |

124| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities) 참조 |166| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | `haiku` 별칭이 확인되는 모델 ID이며, [배경 기능](/docs/ko/costs#background-token-usage)에도 사용됩니다. [모델 구성](/docs/ko/model-config#environment-variables)을 참조하세요 |

125| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities) 참조 |167| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | `/model` 선택기에서 고정된 Haiku 모델에 대한 표시 설명입니다. 설정되지 않으면, 행에 `Custom Haiku model`로 시작하는 기본 설명이 표시됩니다. [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하세요 |

126| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities) 참조 |168| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | `/model` 선택기에서 고정된 Haiku 모델에 대한 표시 이름입니다. 설정되지 않으면, Claude Code가 고정된 ID를 인식하면 행에 모델의 이름이 표시되고, 그렇지 않으면 고정된 ID가 표시됩니다. [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하세요 |

127| `ANTHROPIC_DEFAULT_OPUS_MODEL` | [모델 구성](/docs/ko/model-config#environment-variables) 참조 |169| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | 고정된 Haiku 모델이 지원하는 [기능](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)의 쉼표로 구분된 목록입니다(예: `effort,thinking`). [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하세요 |

128| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities) 참조 |170| `ANTHROPIC_DEFAULT_MODEL` | 새 세션이 기본적으로 시작되는 모델입니다. Claude Code v2.1.236 이상이 필요합니다. [새 세션의 기본 모델 설정](/docs/ko/model-config#set-a-default-model-for-new-sessions)을 참조하세요 |

129| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities) 참조 |171| `ANTHROPIC_DEFAULT_OPUS_MODEL` | `opus` 별칭이 확인되는 모델 ID이며, Plan Mode가 활성화되어 있을 때 `opusplan`이 사용하는 ID입니다. [모델 구성](/docs/ko/model-config#environment-variables)을 참조하세요 |

130| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities) 참조 |172| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | `/model` 선택기에서 고정된 Opus 모델에 대한 표시 설명입니다. 설정되지 않으면, 행에 `Custom Opus model`로 시작하는 기본 설명이 표시됩니다. [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하세요 |

131| `ANTHROPIC_DEFAULT_SONNET_MODEL` | [모델 구성](/docs/ko/model-config#environment-variables) 참조 |173| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | `/model` 선택기에서 고정된 Opus 모델에 대한 표시 이름입니다. 설정되지 않으면, Claude Code가 고정된 ID를 인식하면 행에 모델의 이름이 표시되고, 그렇지 않으면 고정된 ID가 표시됩니다. [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하세요 |

132| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities) 참조 |174| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | 고정된 Opus 모델이 지원하는 [기능](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)의 쉼표로 구분된 목록입니다(예: `effort,thinking`). [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하세요 |

133| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities) 참조 |175| `ANTHROPIC_DEFAULT_SONNET_MODEL` | `sonnet` 별칭이 확인되는 모델 ID이며, Plan Mode가 활성화되지 않았을 때 `opusplan`이 사용하는 ID입니다. [모델 구성](/docs/ko/model-config#environment-variables)을 참조하세요 |

134| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities) 참조 |176| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | `/model` 선택기에서 고정된 Sonnet 모델에 대한 표시 설명입니다. 설정되지 않으면, 행에 `Custom Sonnet model`로 시작하는 기본 설명이 표시됩니다. [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하세요 |

135| `ANTHROPIC_FOUNDRY_API_KEY` | Microsoft Foundry 인증용 API 키([Microsoft Foundry](/docs/ko/microsoft-foundry) 참조) |177| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | `/model` 선택기에서 고정된 Sonnet 모델에 대한 표시 이름입니다. 설정되지 않으면, Claude Code가 고정된 ID를 인식하면 행에 모델의 이름이 표시되고, 그렇지 않으면 고정된 ID가 표시됩니다. [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하세요 |

136| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | Microsoft Entra 액세스 토큰과 같은 Microsoft Foundry 인증용 Bearer 토큰입니다. Claude Code는 이를 `Authorization: Bearer` 헤더로 전송합니다. `ANTHROPIC_FOUNDRY_API_KEY` 및 Azure 기본 자격 증명 체인보다 우선합니다. [Microsoft Foundry](/docs/ko/microsoft-foundry) 참조. Claude Code v2.1.203 이상이 필요합니다. |178| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | 고정된 Sonnet 모델이 지원하는 [기능](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)의 쉼표로 구분된 목록입니다(예: `effort,thinking`). [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하세요 |

137| `ANTHROPIC_FOUNDRY_BASE_URL` | Microsoft Foundry 리소스의 전체 기본 URL(예: `https://my-resource.services.ai.azure.com/anthropic`). `ANTHROPIC_FOUNDRY_RESOURCE`의 대안([Microsoft Foundry](/docs/ko/microsoft-foundry) 참조) |179| `ANTHROPIC_FEDERATION_RULE_ID` | [워크로드 ID 페더레이션](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation)을 위한 페더레이션 규칙 ID입니다. `ANTHROPIC_ORGANIZATION_ID`와 함께 설정하면, Claude Code는 페더레이션 자격 증명을 선택하며, 이는 `/login` 자격 증명보다 우선합니다. [인증 우선순위](/docs/ko/authentication#authentication-precedence)를 참조하세요 |

138| `ANTHROPIC_FOUNDRY_RESOURCE` | Microsoft Foundry 리소스 이름(예: `my-resource`). `ANTHROPIC_FOUNDRY_BASE_URL`이 설정되지 않은 경우 필수([Microsoft Foundry](/docs/ko/microsoft-foundry) 참조) |180| `ANTHROPIC_FOUNDRY_API_KEY` | Microsoft Foundry 인증용 API 키입니다([Microsoft Foundry](/docs/ko/microsoft-foundry) 참조) |

139| `ANTHROPIC_MODEL` | 사용할 모델 설정의 이름([모델 구성](/docs/ko/model-config#environment-variables) 참조) |181| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | Microsoft Foundry 인증용 Bearer 토큰입니다(예: Microsoft Entra 액세스 토큰). Claude Code는 이를 `Authorization: Bearer` 헤더로 전송합니다. `ANTHROPIC_FOUNDRY_API_KEY`와 Azure 기본 자격 증명 체인보다 우선합니다. [Microsoft Foundry](/docs/ko/microsoft-foundry)를 참조하세요. Claude Code v2.1.203 이상이 필요합니다 |

140| `ANTHROPIC_SMALL_FAST_MODEL` | \[더 이상 사용되지 않음] 백그라운드 작업용 [Haiku 클래스 모델](/docs/ko/costs)의 이름 |182| `ANTHROPIC_FOUNDRY_BASE_URL` | Microsoft Foundry 리소스의 전체 기본 URL입니다(예: `https://my-resource.services.ai.azure.com/anthropic`). `ANTHROPIC_FOUNDRY_RESOURCE`의 대안입니다([Microsoft Foundry](/docs/ko/microsoft-foundry) 참조) |

141| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Amazon Bedrock 또는 Amazon Bedrock Mantle 사용 시 Haiku 클래스 모델의 AWS 리전을 재정의합니다. Amazon Bedrock에서는 `ANTHROPIC_DEFAULT_HAIKU_MODEL` 또는 더 이상 사용되지 않는 `ANTHROPIC_SMALL_FAST_MODEL`도 설정되어 있을 때만 적용됩니다. Amazon Bedrock은 그렇지 않으면 백그라운드 작업에 [기본 Sonnet 모델 또는 세션 리전의 기본 모델](/docs/ko/amazon-bedrock#4-pin-model-versions)을 사용하기 때문입니다. |183| `ANTHROPIC_FOUNDRY_RESOURCE` | Microsoft Foundry 리소스 이름입니다(예: `my-resource`). `ANTHROPIC_FOUNDRY_BASE_URL`이 설정되지 않으면 필수입니다([Microsoft Foundry](/docs/ko/microsoft-foundry) 참조) |

142| `ANTHROPIC_VERTEX_BASE_URL` | Google Cloud's Agent Platform 엔드포인트 URL을 재정의합니다. 사용자 정의 Google Cloud's Agent Platform 엔드포인트 또는 [LLM 게이트웨이](/docs/ko/llm-gateway)를 통해 라우팅할 때 사용합니다. [Google Cloud's Agent Platform](/docs/ko/google-vertex-ai) 참조 |184| `ANTHROPIC_MODEL` | 사용할 모델 설정의 이름입니다([모델 구성](/docs/ko/model-config#environment-variables) 참조) |

143| `ANTHROPIC_VERTEX_PROJECT_ID` | Google Cloud's Agent Platform 요청용 GCP 프로젝트 ID입니다. `GCLOUD_PROJECT`, `GOOGLE_CLOUD_PROJECT` 또는 `GOOGLE_APPLICATION_CREDENTIALS` 자격 증명 파일의 프로젝트로 재정의됩니다. [Google Cloud's Agent Platform](/docs/ko/google-vertex-ai) 참조 |185| `ANTHROPIC_ORGANIZATION_ID` | [워크로드 ID 페더레이션](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation)을 위한 조직 ID입니다. `ANTHROPIC_FEDERATION_RULE_ID`와 함께 설정하세요. [인증 우선순위](/docs/ko/authentication#authentication-precedence)를 참조하세요 |

144| `ANTHROPIC_WORKSPACE_ID` | [워크로드 ID 페더레이션](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation)용 워크스페이스 ID입니다. 페더레이션 규칙이 둘 이상의 워크스페이스로 범위가 지정되어 있을 때 토큰 교환이 어느 워크스페이스를 대상으로 할지 알 수 있도록 이를 설정합니다. |186| `ANTHROPIC_PROFILE` | 인증할 Anthropic 프로필의 이름입니다(예: [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication)으로 생성되거나 [API 키 없이 Console 계정에 로그인](/docs/ko/authentication#sign-in-without-an-api-key)하여 생성된 프로필). [인증 우선순위](/docs/ko/authentication#authentication-precedence)를 참조하세요 |

145| `API_FORCE_IDLE_TIMEOUT` | 바이트가 도착하지 않을 때 스트리밍 모델 응답을 중단하는 5분 유휴 타임아웃을 재정의합니다. 느린 [게이트웨이](/docs/ko/llm-gateway) 또는 로컬 모델이 청크 사이에 5분 이상 일시 중지할 때 `0`으로 설정하여 타임아웃을 비활성화합니다. 모든 공급자에서 타임아웃을 활성화하려면 `1`로 설정합니다. 설정하지 않으면 타임아웃은 직접 Anthropic API 및 [Claude Platform on AWS](/docs/ko/claude-platform-on-aws) 연결에서 비활성화되며, Claude Code의 자체 바이트 수준 스트림 감시견이 실행되고, [Google Cloud's Agent Platform](/docs/ko/google-vertex-ai), [Microsoft Foundry](/docs/ko/microsoft-foundry), [Mantle](/docs/ko/amazon-bedrock#use-the-mantle-endpoint), [Amazon Bedrock](/docs/ko/amazon-bedrock), 게이트웨이 연결을 포함한 다른 모든 공급자에서 활성화되므로 정체된 스트림이 중단되지 않고 중단됩니다. v2.1.169부터 |187| `ANTHROPIC_SMALL_FAST_MODEL` | \[더 이상 사용되지 않음] [배경 작업용 Haiku 클래스 모델](/docs/ko/costs)의 이름입니다 |

146| `API_TIMEOUT_MS` | API 요청의 타임아웃(밀리초)(기본값: 600000, 또는 10분; 최대: 2147483647). 느린 네트워크에서 요청이 시간 초과되거나 프록시를 통해 라우팅할 때 이를 증가시킵니다. 최대값을 초과하는 값은 기본 타이머를 오버플로우하여 요청이 즉시 실패하게 합니다. |188| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Amazon Bedrock 또는 Amazon Bedrock Mantle을 사용할 때 Haiku 클래스 모델의 AWS 리전을 재정의합니다. Amazon Bedrock에서는 `ANTHROPIC_DEFAULT_HAIKU_MODEL` 또는 더 이상 사용되지 않는 `ANTHROPIC_SMALL_FAST_MODEL`도 설정되어 있을 때만 적용됩니다. Amazon Bedrock은 그렇지 않으면 [기본 Sonnet 모델 또는 세션 리전의 기본 모델](/docs/ko/amazon-bedrock#4-pin-model-versions)에서 배경 작업을 실행하기 때문입니다 |

147| `AWS_BEARER_TOKEN_BEDROCK` | 인증용 Amazon Bedrock API 키([Amazon Bedrock API 키](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/) 참조) |189| `ANTHROPIC_VERTEX_BASE_URL` | Google Cloud의 Agent Platform 엔드포인트 URL을 재정의합니다. 사용자 정의 Google Cloud의 Agent Platform 엔드포인트나 [LLM 게이트웨이](/docs/ko/llm-gateway)를 통한 라우팅에 사용합니다. [Google Cloud의 Agent Platform](/docs/ko/google-vertex-ai)을 참조하세요 |

148| `BASH_DEFAULT_TIMEOUT_MS` | 장시간 실행되는 bash 명령의 기본 타임아웃(기본값: 120000, 또는 2분) |190| `ANTHROPIC_VERTEX_PROJECT_ID` | Google Cloud의 Agent Platform 요청이 주소 지정되는 GCP 프로젝트 ID입니다. [GCP 자격 증명 구성](/docs/ko/google-vertex-ai#3-configure-gcp-credentials)을 참조하세요 |

149| `BASH_MAX_OUTPUT_LENGTH` | bash 출력이 전체 출력이 파일에 저장되고 Claude가 경로와 짧은 미리보기를 받기 전의 최대 문자 수입니다. [Bash 도구 동작](/docs/ko/tools-reference#bash-tool-behavior) 참조 |191| `ANTHROPIC_WORKSPACE_ID` | [워크로드 ID 페더레이션](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation)을 위한 워크스페이스 ID입니다. 페더레이션 규칙이 둘 이상의 워크스페이스로 범위가 지정되어 있을 때 설정하여 토큰 교환이 어느 워크스페이스를 대상으로 할지 알 수 있도록 합니다 |

150| `BASH_MAX_TIMEOUT_MS` | 모델이 장시간 실행되는 bash 명령에 대해 설정할 수 있는 최대 타임아웃(기본값: 600000, 또는 10분) |192| `API_FORCE_IDLE_TIMEOUT` | 바이트가 도착하지 않을 때 스트리밍 모델 응답을 중단하는 5분 본문 유휴 타임아웃을 재정의합니다. 느린 [게이트웨이](/docs/ko/llm-gateway) 또는 로컬 모델이 청크 사이에 5분 이상 일시 중지되는 경우 `0`으로 설정하여 타임아웃을 끕니다. 또는 모든 제공자에 대해 켜려면 `1`로 설정합니다. 설정되지 않으면, 타임아웃은 직접 Anthropic API 및 [AWS의 Claude Platform](/docs/ko/claude-platform-on-aws) 이외의 제공자에서 활성화됩니다. [스트림 감시견](/docs/ko/network-config#streaming-idle-watchdogs)은 독립적으로 실행되며 여기서 `0`을 설정해도 긴 침묵을 중단합니다 |

151| `CCR_FORCE_BUNDLE` | GitHub 액세스가 가능한 경우에도 [`claude --cloud`](/docs/ko/claude-code-on-the-web#send-local-repositories-without-github)가 로컬 리포지토리를 번들로 제공하고 업로드하도록 강제하려면 `1`로 설정합니다. |193| `API_TIMEOUT_MS` | API 요청의 타임아웃(밀리초)(기본값: 600000, 또는 10분; 최대값: 2147483647). 느린 네트워크에서 요청이 타임아웃되거나 프록시를 통해 라우팅할 때 이를 증가시킵니다. 최대값 이상의 값은 기본 타이머를 오버플로우하여 요청이 즉시 실패합니다 |

152| `CLAUDECODE` | Claude Code가 생성하는 subprocess(Bash 및 PowerShell 도구, tmux 세션, [훅](/docs/ko/hooks) 명령, [상태 줄](/docs/ko/statusline) 명령, stdio [MCP 서버](/docs/ko/mcp) subprocess)에서 `1`로 설정됩니다. IDE 확장도 통합 터미널에서 이를 설정합니다. Claude Code가 생성한 subprocess 내에서 스크립트가 실행 중인지 감지하는 데 사용합니다. 현재 프로세스가 도구 호출 또는 훅에 의해 직접 생성되었는지, 아니면 Claude Code가 시작한 stdio [MCP 서버](/docs/ko/mcp) 내부인지 확인하려면 `CLAUDE_CODE_CHILD_SESSION`을 대신 사용합니다. |194| `AWS_BEARER_TOKEN_BEDROCK` | Amazon Bedrock 인증용 API 키입니다([Amazon Bedrock API 키](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/) 참조) |

153| `CLAUDE_AFK_COUNTDOWN_MS` | 자동 계속 전에 응답하지 않은 [`AskUserQuestion`](/docs/ko/tools-reference) 대화 상자에 화면상 카운트다운이 나타나기 전의 밀리초입니다. 기본값 `20000`(20초), 자동 계속 타임아웃으로 제한됩니다. 자동 계속이 켜져 있지 않으면 효과가 없습니다. [`askUserQuestionTimeout`](/docs/ko/settings#available-settings) 설정 및 `CLAUDE_AFK_TIMEOUT_MS` 참조. Claude Code v2.1.198 이상이 필요합니다. |195| `BASH_DEFAULT_TIMEOUT_MS` | 장시간 실행되는 bash 명령의 기본 타임아웃입니다(기본값: 120000, 또는 2분) |

154| `CLAUDE_AFK_TIMEOUT_MS` | 응답하지 않은 [`AskUserQuestion`](/docs/ko/tools-reference) 대화 상자가 자동으로 계속되기 전의 유휴 시간(밀리초)입니다. 자동 계속은 기본적으로 꺼져 있습니다. [`askUserQuestionTimeout`](/docs/ko/settings#available-settings) 설정으로 옵트인합니다. 이 변수는 데모 및 자동화된 테스트를 위한 재정의입니다: 설정하면 해당 설정보다 우선하고 설정이 설정되지 않았거나 `never`인 경우에도 자동 계속을 켭니다. `0`으로 설정해도 타임아웃이 꺼지지 않습니다. 대화 상자가 즉시 닫힙니다. v2.1.198 및 v2.1.199에서는 자동 계속이 기본적으로 켜져 있었고 `60000`(60초) 타임아웃이 있었습니다. Claude Code v2.1.198 이상이 필요합니다. |196| `BASH_MAX_OUTPUT_LENGTH` | Claude Code가 명령 결과로 다시 읽는 bash 출력의 최대 문자 수입니다(기본값: 30000; 최대값: 150000). [`bashOutputMaxChars`](/docs/ko/settings-reference#bashoutputmaxchars) 설정을 설정하면, Claude Code는 이 변수를 무시합니다. [출력 제한](/docs/ko/tools-reference#output-limits)을 참조하세요 |

155| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | 모든 기본 제공 [subagent](/docs/ko/sub-agents) 유형(예: Explore 및 Plan)을 비활성화하려면 `1`로 설정합니다. 비대화형 모드(`-p` 플래그)에만 적용됩니다. SDK 사용자가 백지 상태를 원할 때 유용합니다. |197| `BASH_MAX_TIMEOUT_MS` | 모델이 장시간 실행되는 bash 명령에 대해 설정할 수 있는 최대 타임아웃입니다(기본값: 600000, 또는 10분). 유효한 상한은 이것과 `BASH_DEFAULT_TIMEOUT_MS` 중 더 큰 값입니다 |

156| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | SDK에서 생성한 MCP 서버의 도구 이름에서 `mcp__<server>__` 접두사를 건너뛰려면 `1`로 설정합니다. 도구는 원래 이름을 사용합니다. SDK 사용만 해당 |198| `BETA_TRACING_ENDPOINT` | [상세 베타 추적](/docs/ko/monitoring-usage#traces-beta)을 위한 OTLP 엔드포인트입니다: `ENABLE_BETA_TRACING_DETAILED=1`을 사용하면, 로그와 추적이 구성된 내보내기 대신 여기로 이동합니다. 셸, 사용자 설정 또는 관리 설정에서 설정하세요. [프로젝트 및 로컬 설정](/docs/ko/settings-reference#variables-claude-code-ignores-in-env)에서는 무시됩니다 |

157| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | 백그라운드 subagent의 정체 타임아웃(밀리초). 기본값 `600000`(10분). 타이머는 각 스트리밍 진행 이벤트에서 재설정됩니다. 윈도우 내에 진행이 도착하지 않으면 subagent가 중단되고 작업이 실패로 표시되며 부분 결과가 부모에게 표시됩니다. |199| `CCR_FORCE_BUNDLE` | [`claude --cloud`](/docs/ko/claude-code-on-the-web#send-local-repositories-without-github)가 원격에서 복제하는 대신 로컬 리포지토리를 번들로 묶고 업로드하도록 강제하려면 `1`로 설정하세요 |

158| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | 자동 압축이 트리거되는 자동 압축 윈도우의 백분율(1-100)을 설정합니다. `50`과 같은 낮은 값을 사용하여 더 일찍 압축합니다. 이 변수는 Claude Code가 사전에 압축할 때만 더 일찍 압축을 유발합니다: `CLAUDE_CODE_AUTO_COMPACT_WINDOW`가 설정되었을 때, [클라우드 세션](/docs/ko/claude-code-on-the-web)에서, [확장 컨텍스트](/docs/ko/model-config#extended-context) 없이 Sonnet 4.6 및 Opus 4.6에서 기본적으로 200K 경계에서 압축합니다. Sonnet 5에서는 모델의 [기본 임계값](/docs/ko/model-config#sonnet-5-context-window)에서 사전 압축이 적용됩니다. 로컬 세션의 Opus 4.8과 같은 다른 경우에는 대화가 모델의 컨텍스트 제한에 도달할 때 자동 압축이 트리거됩니다. 재정의는 기본 임계값만 낮출 수 있으므로 기본값보다 높은 값은 효과가 없습니다. 주 대화와 subagent 모두에 적용됩니다. |200| `CLAUDECODE` | Claude Code가 생성하는 서브프로세스(Bash 및 PowerShell 도구, tmux 세션, [훅](/docs/ko/hooks) 명령, [상태 줄](/docs/ko/statusline) 명령, stdio [MCP 서버](/docs/ko/mcp) 서브프로세스)에서 `1`로 설정합니다. IDE 확장도 통합 터미널에서 이를 설정합니다. 스크립트가 Claude Code에서 생성한 서브프로세스 내에서 실행 중인지 감지하는 데 사용합니다. 도구 호출 또는 훅에 의해 직접 생성된 현재 프로세스인지, 아니면 Claude Code가 시작한 stdio MCP 서버 내부인지 확인하려면 `CLAUDE_CODE_CHILD_SESSION`을 대신 사용하세요 |

159| `CLAUDE_AUTO_BACKGROUND_TASKS` | 장시간 실행되는 에이전트 작업의 자동 백그라운드 처리를 강제로 활성화하려면 `1`로 설정합니다. 활성화되면 subagent는 약 2분 동안 실행한 후 백그라운드로 이동합니다. |201| `CLAUDE_AFK_COUNTDOWN_MS` | 자동 계속 전에 응답하지 않은 [`AskUserQuestion`](/docs/ko/tools-reference) 대화 상자에 화면상 카운트다운이 나타나기 전의 밀리초 수입니다. 기본값 `20000`(20초), 자동 계속 타임아웃으로 제한됩니다. 자동 계속이 켜져 있지 않으면 효과가 없습니다. [`askUserQuestionTimeout`](/docs/ko/settings-reference#askuserquestiontimeout) 설정 및 `CLAUDE_AFK_TIMEOUT_MS`를 참조하세요. Claude Code v2.1.198 이상이 필요합니다 |

160| `CLAUDE_AX_SCREEN_READER` | 화면 판독기 친화적 출력을 렌더링하려면 `1`로 설정합니다: 장식 테두리 또는 애니메이션 없는 평면 텍스트. [`axScreenReader`](/docs/ko/settings#available-settings)가 `true`인 경우에도 화면 판독기 모드를 강제로 끄려면 `0`으로 설정합니다. [`--ax-screen-reader`](/docs/ko/cli-reference#cli-flags) 플래그가 우선합니다. Claude Code v2.1.181 이상이 필요합니다. |202| `CLAUDE_AFK_TIMEOUT_MS` | 응답하지 않은 [`AskUserQuestion`](/docs/ko/tools-reference) 대화 상자가 자동으로 계속되기 전의 유휴 시간(밀리초)입니다. 자동 계속은 기본적으로 꺼져 있습니다. [`askUserQuestionTimeout`](/docs/ko/settings-reference#askuserquestiontimeout) 설정으로 옵트인하세요. 이 변수는 데모 및 자동화된 테스트를 위한 재정의입니다: 설정되면 해당 설정보다 우선하고 설정이 설정 해제되거나 `never`인 경우에도 자동 계속을 켭니다. `0`을 설정해도 타임아웃이 꺼지지 않습니다. 대화 상자가 즉시 닫힙니다. v2.1.198 및 v2.1.199에서는 자동 계속이 기본적으로 켜져 있었고 `60000`(60초) 타임아웃이 있었습니다. Claude Code v2.1.198 이상이 필요합니다 |

161| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | 주 세션에서 각 Bash 또는 PowerShell 명령 후 원래 작업 디렉토리로 돌아갑니다. |203| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | 모든 기본 제공 [서브에이전트](/docs/ko/sub-agents) 유형(예: Explore 및 Plan)을 비활성화하려면 `1`로 설정하세요. 비대화형 모드(`-p` 플래그)에만 적용됩니다. SDK 사용자가 깨끗한 상태를 원할 때 유용합니다. 이는 또한 `general-purpose`를 제거합니다. 이는 Agent 도구 호출이 `subagent_type`을 생략할 때 Claude Code가 실행하는 서브에이전트입니다. 그러한 호출은 [`subagent_type is required`](/docs/ko/errors#subagent-type-is-required)로 실패합니다 |

162| `CLAUDE_CLIENT_PRESENCE_FILE` | 화면 잠금 수신기와 같은 외부 도구가 화면을 잠금 해제할 때 생성하고 잠금할 때 삭제하는 파일의 경로입니다. 파일이 존재하는 동안 Claude Code는 [Remote Control 모바일 푸시 알림](/docs/ko/remote-control#mobile-push-notifications)을 건너뜁니다. 따라서 컴퓨터를 적극적으로 사용하는 동안 푸시를 받지 않습니다. 파일이 없거나 읽을 수 없으면 알림이 정상적으로 전송됩니다. Claude Code는 파일을 폴링하지 않고 푸시 트리거 이벤트당 한 번 확인합니다. Claude Code v2.1.181 이상이 필요합니다. |204| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | SDK에서 생성한 MCP 서버의 도구 이름에서 `mcp__<server>__` 접두사를 건너뛰려면 `1`로 설정하세요. 도구는 원래 이름을 사용합니다. SDK 사용만 해당 |

163| `CLAUDE_CODE_ACCESSIBILITY` | 기본 터미널 커서를 표시하고 반전된 텍스트 커서 표시기를 비활성화하려면 `1`로 설정합니다. macOS Zoom과 같은 화면 확대기가 커서 위치를 추적할 수 있습니다. |205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | 서브에이전트의 밀리초 단위 정지 타임아웃입니다. 기본값 `600000`(10분); `CLAUDE_STREAM_IDLE_TIMEOUT_MS`를 높이고 스트림 감시견이 켜져 있으면, 기본값이 함께 올라갑니다. [느리거나 정지된 API 응답 처리](/docs/ko/agent-sdk/typescript#handle-slow-or-stalled-api-responses)에서 설명합니다. 타이머는 각 스트리밍 진행 이벤트에서 재설정됩니다. 창 내에 진행이 도착하지 않으면, Claude Code는 서브에이전트를 중단하고 정지를 부모에 보고합니다 |

164| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | `--add-dir`로 지정된 디렉토리에서 메모리 파일을 로드하려면 `1`로 설정합니다. `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md`, `CLAUDE.local.md`를 로드합니다. 기본적으로 추가 디렉토리는 메모리 파일을 로드하지 않습니다. |206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | 자동 압축이 트리거되는 자동 압축 창의 백분율(1-100)을 설정합니다. `50`과 같은 낮은 값을 사용하여 더 일찍 압축합니다. 변수는 임계값을 높일 수 없으므로 기본 백분율 이상의 값은 무시됩니다. [모델의 컨텍스트 제한 전에 압축](/docs/ko/model-config#context-window-and-auto-compaction)하는 세션에만 적용됩니다. 주 대화 및 서브에이전트 모두에 적용됩니다 |

165| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | [전체 화면 렌더링](/docs/ko/fullscreen)에서 증분 업데이트를 전송하는 대신 모든 프레임에서 전체 화면을 다시 칠하려면 `1`로 설정합니다. 전체 화면 모드에서 오래된 텍스트 또는 잘못된 위치의 텍스트 조각이 표시되면 이를 사용합니다. Claude Code는 Windows의 백그라운드 세션 및 [에이전트 보기](/docs/ko/agent-view)에 대해 자동으로 이를 활성화합니다. |207| `CLAUDE_AUTO_BACKGROUND_TASKS` | 장시간 실행되는 에이전트 작업의 자동 백그라운드 처리를 강제로 활성화하려면 `1`로 설정하세요. 활성화되면, 서브에이전트는 약 2분 동안 실행한 후 백그라운드로 이동합니다. 또한 Claude Code v2.1.212 이상의 비대화형 모드에서 [장시간 MCP 도구 호출의 자동 백그라운드 처리](/docs/ko/mcp#automatic-backgrounding-of-long-tool-calls)를 활성화합니다 |

166| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Claude Code가 모델 ID를 노력 가능으로 인식하지 못할 때에도 모든 요청과 함께 [노력](/docs/ko/model-config#adjust-effort-level) 매개변수를 전송하려면 `1`로 설정합니다. [LLM 게이트웨이](/docs/ko/llm-gateway) 또는 사용자 정의 식별자 아래에서 모델을 제공하는 타사 공급자를 통해 라우팅할 때 사용합니다. Claude 3 모델, Sonnet 4.0 및 4.5, Opus 4.0 및 4.1, Haiku 4.5를 포함하여 API에서 노력 매개변수를 거부하는 모델은 요청이 실패하지 않도록 제외됩니다. |208| `CLAUDE_AX_PREPARK_MS` | [화면 판독기 모드](/docs/ko/accessibility#what-your-screen-reader-hears)에서, Claude Code가 커서를 줄의 시작에 두고 새로운 또는 변경된 줄을 쓰기 전에 대기하는 밀리초 수입니다. 기본값 `50`. 즉시 쓰려면 `0`으로 설정하세요. Claude Code는 대기를 `5000`으로 제한합니다. Claude Code v2.1.233 이상이 필요합니다 |

167| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | 자격 증명을 새로 고쳐야 하는 간격(밀리초)([`apiKeyHelper`](/docs/ko/settings#available-settings) 사용 시) |209| `CLAUDE_AX_SCREEN_READER` | 화면 판독기 친화적 출력을 렌더링하려면 `1`로 설정하세요: 장식 테두리나 애니메이션 없는 평면 텍스트입니다. [`axScreenReader`](/docs/ko/settings-reference#axscreenreader)가 `true`인 경우에도 화면 판독기 모드를 강제로 끄려면 `0`으로 설정하세요. [`--ax-screen-reader`](/docs/ko/cli-reference#cli-flags) 플래그가 우선합니다. Claude Code v2.1.181 이상이 필요합니다 |

168| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | 새 [아티팩트](/docs/ko/artifacts)가 게시될 때 Claude Code가 브라우저를 자동으로 열지 않도록 하려면 `0`으로 설정합니다. 기존 아티팩트를 다시 게시해도 이 설정과 관계없이 브라우저를 열지 않습니다. |210| `CLAUDE_AX_STARTUP_QUIET_MS` | [화면 판독기 모드](/docs/ko/accessibility)에서, Claude Code가 시작 확인 줄 후 첫 번째 인터페이스 렌더링을 보유하는 밀리초 수이므로 화면 판독기가 새 출력이 중단되기 전에 줄을 완전히 말할 수 있습니다. 기본값 `3000`. 즉시 렌더링하려면 `0`으로 설정하세요. Claude Code는 보유를 `600000`(10분)으로 제한합니다. 첫 번째 키 입력이 보유를 조기에 끝냅니다. Claude Code v2.1.217 이상이 필요합니다 |

169| `CLAUDE_CODE_ATTRIBUTION_HEADER` | 시스템 프롬프트의 시작 부분에서 속성 블록(클라이언트 버전 및 프롬프트 지문)을 생략하려면 `0`으로 설정합니다. 비활성화하면 [LLM 게이트웨이](/docs/ko/llm-gateway)를 통해 라우팅할 때 프롬프트 캐시 히트율이 향상됩니다. Anthropic API 캐싱은 영향을 받지 않습니다. |211| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | 주 세션에서 각 Bash 또는 PowerShell 명령 후 원래 작업 디렉토리로 돌아갑니다 |

170| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | 자동 압축 계산에 사용되는 컨텍스트 용량을 토큰 단위로 설정합니다. 기본값은 모델의 컨텍스트 윈도우입니다: 표준 모델의 경우 200K 또는 [확장 컨텍스트](/docs/ko/model-config#extended-context) 모델의 경우 1M입니다. Sonnet 5는 자체 [기본 임계값](/docs/ko/model-config#sonnet-5-context-window)을 가집니다. 1M 모델에서 `500000`과 같은 낮은 값을 사용하여 압축 목적상 윈도우를 500K로 취급합니다. 값은 모델의 실제 컨텍스트 윈도우로 제한됩니다. `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`는 이 값의 백분율로 적용됩니다. 이 변수를 설정하면 압축 임계값이 상태 줄의 `used_percentage`에서 분리되며, 이는 항상 모델의 전체 컨텍스트 윈도우를 사용합니다. |212| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | 바이트 수준 스트리밍 유휴 감시견의 밀리초 단위 타임아웃입니다. 설정되면, 해당 감시견에 대해 `CLAUDE_STREAM_IDLE_TIMEOUT_MS`보다 우선하고 이벤트 수준 감시견은 변경하지 않습니다. Claude Code는 이 변수를 10초에서 30분 사이로 제한합니다. Claude Code v2.1.210 이상이 필요합니다 |

171| `CLAUDE_CODE_AUTO_CONNECT_IDE` | 자동 [IDE 연결](/docs/ko/vs-code)을 재정의합니다. 기본적으로 Claude Code는 지원되는 IDE의 통합 터미널 내에서 실행될 때 자동으로 연결됩니다. 이를 방지하려면 `false`로 설정합니다. tmux가 부모 터미널을 가리는 경우와 같이 자동 감지가 실패할 때 연결을 강제하려면 `true`로 설정합니다. [`autoConnectIde`](/docs/ko/settings#global-config-settings) 전역 구성 설정보다 우선합니다. |213| `CLAUDE_CLIENT_PRESENCE_FILE` | 화면 잠금 수신기와 같은 외부 도구가 화면을 잠금 해제할 때 생성하고 잠금할 때 삭제하는 파일의 경로입니다. 파일이 존재하는 동안, Claude Code는 [원격 제어 모바일 푸시 알림](/docs/ko/remote-control#mobile-push-notifications)을 건너뜁니다. 따라서 컴퓨터를 적극적으로 사용하는 동안 푸시를 받지 않습니다. 파일이 없거나 읽을 수 없으면, 알림이 정상적으로 전송됩니다. Claude Code는 파일을 폴링하지 않고 푸시 트리거 이벤트당 한 번 확인합니다. Claude Code v2.1.181 이상이 필요합니다 |

172| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Claude Code가 AWS 기본 자격 증명 공급자 체인이 자격 증명을 생성할 때까지 대기하는 시간(밀리초). 요청이 [`AWS default-chain credential resolve timed out`](/docs/ko/errors#aws-default-chain-credential-resolve-timed-out)으로 실패하기 전입니다(기본값: `60000`). MFA를 사용한 브라우저 기반 SSO 로그인과 같이 체인의 단계가 합법적으로 더 오래 필요할 때 이를 올립니다. Claude Code가 기본 체인으로 서명하는 모든 곳에 적용됩니다: [Amazon Bedrock](/docs/ko/amazon-bedrock#credential-caching-and-resolution-timeout), [Claude Platform on AWS](/docs/ko/claude-platform-on-aws), [Mantle 엔드포인트](/docs/ko/amazon-bedrock#use-the-mantle-endpoint). Claude Code v2.1.207 이상이 필요합니다. |214| `CLAUDE_CODE_ACCESSIBILITY` | 기본 터미널 커서를 표시하고 반전된 텍스트 커서 표시기를 비활성화하려면 `1`로 설정하세요. macOS Zoom과 같은 화면 확대기가 커서 위치를 추적할 수 있습니다 |

173| `CLAUDE_CODE_BRIDGE_SESSION_ID` | 세션에 활성 [Remote Control](/docs/ko/remote-control) 연결이 있는 동안 Bash 도구 및 [훅 명령](/docs/ko/hooks) subprocess에서 자동으로 설정되며, 연결이 끝나면 제거됩니다. 값은 `session_` 형식의 세션 ID이며, 세션의 `claude.ai/code` URL에 나타나는 동일한 식별자이므로 스크립트가 이를 실행한 세션으로 다시 연결할 수 있습니다. Claude Code v2.1.199 이상이 필요합니다. [클라우드 세션](/docs/ko/claude-code-on-the-web)에서는 `CLAUDE_CODE_REMOTE_SESSION_ID`를 대신 읽습니다. |215| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | `--add-dir`로 지정된 디렉토리에서 메모리 파일을 로드하려면 `1`로 설정하세요. `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md`, 및 `CLAUDE.local.md`를 로드합니다. 기본적으로 추가 디렉토리는 메모리 파일을 로드하지 않습니다 |

174| `CLAUDE_CODE_CERT_STORE` | TLS 연결을 위한 CA 인증서 소스의 쉼표로 구분된 목록입니다. `bundled`는 Claude Code와 함께 제공되는 Mozilla CA 세트입니다. `system`은 운영 체제 신뢰 저장소입니다. `tls.getCACertificates`가 있는 런타임에서만 읽습니다: 기본 바이너리 또는 npm 설치의 경우 Node 22.15 이상. [CA 인증서 저장소](/docs/ko/network-config#ca-certificate-store) 참조. 기본값은 `bundled,system`입니다. |216| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | [전체 화면 렌더링](/docs/ko/fullscreen)에서 증분 업데이트를 보내는 대신 모든 프레임에서 전체 화면을 다시 칠하려면 `1`로 설정하세요. 전체 화면 모드에서 오래되거나 잘못 배치된 텍스트 조각이 표시되면 이를 사용하세요. Claude Code는 Windows의 백그라운드 세션 및 [에이전트 보기](/docs/ko/agent-view)에 대해 자동으로 이를 활성화합니다 |

175| `CLAUDE_CODE_CHILD_SESSION` | Bash, PowerShell, Monitor 도구, [훅](/docs/ko/hooks) 명령, [상태 줄](/docs/ko/statusline) 명령을 통해 Claude Code가 생성하는 subprocess에서 `1`로 설정됩니다. stdio [MCP 서버](/docs/ko/mcp) subprocess에는 설정되지 않으며, 이는 장기 실행되고 이를 생성한 세션보다 오래 지속됩니다. `CLAUDECODE`와 달리 이는 Claude Code의 자체 생성 경로에서만 설정되고 IDE 확장에서는 설정되지 않으므로 중첩 세션을 IDE 통합 터미널에서 시작된 최상위 `claude`와 안정적으로 구분합니다. 이 방식으로 시작된 중첩 대화형 `claude` TUI는 `--resume`, `--continue`, 위쪽 화살표 기록, `claude agents` 목록에서 자동으로 제외됩니다. 비대화형 `claude -p` 세션은 여전히 지속됩니다. `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1`을 설정하여 이 제외를 재정의합니다. Claude Code v2.1.172 이상이 필요합니다. |217| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Claude Code가 모델 ID를 노력 가능으로 인식하지 않더라도 모든 요청과 함께 [노력](/docs/ko/model-config#adjust-effort-level) 매개변수를 보내려면 `1`로 설정하세요. [LLM 게이트웨이](/docs/ko/llm-gateway) 또는 사용자 정의 식별자로 모델을 제공하는 타사 제공자를 통해 라우팅할 때 사용합니다. Claude 3 모델, Sonnet 4.0 및 4.5, Opus 4.0 및 4.1, Haiku 4.5를 포함하여 API에서 노력 매개변수를 거부하는 모델은 요청이 실패하지 않도록 제외됩니다 |

220| `CLAUDE_CODE_ARTIFACT_COMMENTS` | Claude가 [아티팩트에 대한 댓글](/docs/ko/artifacts#collect-comments-on-an-artifact)을 읽고 회신하지 않도록 하려면 `0`으로 설정하세요. `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`이 [아티팩트를 꺼](/docs/ko/artifacts#availability)도록 설정되었을 때는 효과가 없습니다. Claude Code v2.1.221 이상이 필요합니다 |

221| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | Claude가 [자신에게 전송된 댓글에 자동으로 회신](/docs/ko/artifacts#let-claude-reply-to-comments-on-its-own)하지 않도록 하려면 `0`으로 설정하세요. Claude Code v2.1.228 이상이 필요합니다 |

222| `CLAUDE_CODE_ATTRIBUTION_HEADER` | 클라이언트 버전과 프롬프트 지문을 전달하는 [속성 블록](/docs/ko/llm-gateway-protocol#system-prompt-attribution-block)을 시스템 프롬프트의 시작에서 생략하려면 `0`으로 설정하세요. Anthropic API에 대한 직접 연결의 캐싱은 어느 쪽이든 영향을 받지 않습니다. 일부 직접 연결 설정에서, Claude Code는 `0`을 설정한 경우에도 [자동 모드](/docs/ko/permission-modes#eliminate-prompts-with-auto-mode) 분류기 요청에서 블록을 유지합니다. [시스템 프롬프트 속성 블록](/docs/ko/llm-gateway-protocol#system-prompt-attribution-block)에서 이것이 적용되는 연결과 자격 증명을 확인하세요. v2.1.181 이전에는 블록이 사용자 정의 기본 URL 및 Microsoft Foundry 연결에 대한 요청당 토큰을 포함했으므로, 해당 버전에서는 LLM 게이트웨이가 요청 본문에 캐시하거나 요청을 타사 제공자에게 전달할 때, 또는 Microsoft Foundry에 직접 연결할 때 `0`으로 설정하세요 |

223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | `CLAUDE_AUTO_BACKGROUND_TASKS`가 활성화되면, Claude에 여전히 실행 중인 [백그라운드 서브에이전트](/docs/ko/sub-agents#run-subagents-in-foreground-or-background)를 확인하도록 상기시키는 간격(초)입니다. `1`에서 `86400`까지의 일반 정수만 허용합니다. 다른 값이나 표기법은 설정 해제로 읽힙니다. 설정되지 않으면 체크인 알림이 없습니다. Claude Code v2.1.248 이상이 필요합니다 |

224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | [자동 압축 창](/docs/ko/model-config#set-the-auto-compact-window)을 토큰 단위로 설정합니다(`100000`에서 `1000000`). `500000`과 같은 일반 정수만 허용합니다: `500k`와 같은 값은 `500`으로 읽고 100K 최소값으로 제한됩니다. 유효한 창은 또한 모델의 컨텍스트 창으로 제한됩니다. `/autocompact` 명령, `--autocompact` 플래그, `autoCompactWindow` 설정보다 우선합니다. 상태 줄의 `used_percentage`는 항상 모델의 전체 컨텍스트 창에 대해 측정되므로, 이 변수가 설정되면 해당 백분율은 더 이상 압축이 실행될 때를 나타내지 않습니다 |

225| `CLAUDE_CODE_AUTO_CONNECT_IDE` | 자동 [IDE 연결](/docs/ko/vs-code)을 재정의합니다. 기본적으로 Claude Code는 지원되는 IDE의 통합 터미널 내에서 시작될 때 자동으로 연결됩니다. 이를 방지하려면 `false`로 설정하세요. tmux가 부모 터미널을 숨기는 경우와 같이 자동 감지가 실패할 때 연결 시도를 강제하려면 `true`로 설정하세요. [`autoConnectIde`](/docs/ko/settings-reference#autoconnectide) 전역 구성 설정보다 우선합니다 |

226| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Claude Code가 AWS 기본 자격 증명 제공자 체인이 자격 증명을 생성할 때까지 대기하는 시간(밀리초)입니다. 요청이 [`AWS default-chain credential resolve timed out`](/docs/ko/errors#aws-default-chain-credential-resolve-timed-out)으로 실패하기 전입니다(기본값: `60000`). MFA를 사용한 브라우저 기반 SSO 로그인과 같이 체인의 단계가 합법적으로 더 오래 필요한 경우 이를 높이세요. `aws-vault`와 같은 래퍼를 통해 적용됩니다. [Amazon Bedrock](/docs/ko/amazon-bedrock#credential-caching-and-resolution-timeout), [AWS의 Claude Platform](/docs/ko/claude-platform-on-aws), [Mantle 엔드포인트](/docs/ko/amazon-bedrock#use-the-mantle-endpoint)에서 Claude Code가 기본 체인으로 서명하는 모든 곳에 적용됩니다. Claude Code v2.1.207 이상이 필요합니다 |

227| `CLAUDE_CODE_BRIDGE_SESSION_ID` | 세션에 활성 [원격 제어](/docs/ko/remote-control) 연결이 있는 동안 Bash 도구 및 [훅 명령](/docs/ko/hooks) 서브프로세스에서 자동으로 설정되며, 연결이 끝나면 제거됩니다. 값은 `session_` 형식의 세션 ID이며, 세션의 `claude.ai/code` URL에 나타나는 동일한 식별자이므로 스크립트가 이를 실행한 세션으로 다시 연결할 수 있습니다. Claude Code v2.1.199 이상이 필요합니다. [클라우드 세션](/docs/ko/claude-code-on-the-web)에서는 대신 `CLAUDE_CODE_REMOTE_SESSION_ID`를 읽으세요 |

228| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | Claude Code가 `0x08` 바이트(`^H`로도 작성됨)를 일반 백스페이스로 읽도록 하려면 `0`으로 설정하거나, Ctrl+백스페이스로 읽도록 하려면 `1`로 설정하세요. 어느 값이든 플랫폼 기본값을 대체합니다. 기본적으로 Claude Code는 `TERM_PROGRAM`이 `mintty`이거나 `TERM`이 `cygwin`인 경우를 제외하고 Windows에서 Ctrl+백스페이스로, macOS 및 Linux에서 일반 백스페이스로 읽습니다. Windows 터미널에서 `0`을 설정하세요. [백스페이스가 전체 단어를 삭제](/docs/ko/terminal-config#fix-backspace-deleting-a-whole-word-on-windows) |

229| `CLAUDE_CODE_CERT_STORE` | TLS 연결을 위한 CA 인증서 소스의 쉼표로 구분된 목록입니다. `bundled`는 Claude Code와 함께 제공되는 Mozilla CA 집합입니다. `system`은 운영 체제 신뢰 저장소이며, `tls.getCACertificates`가 있는 런타임에서만 읽습니다: 기본 바이너리 또는 npm 설치의 경우 Node 22.15 이상입니다. [CA 인증서 저장소](/docs/ko/network-config#ca-certificate-store)를 참조하세요. 기본값은 `bundled,system`입니다 |

230| `CLAUDE_CODE_CHILD_SESSION` | Bash, PowerShell, Monitor 도구, [훅](/docs/ko/hooks) 명령, [상태 줄](/docs/ko/statusline) 명령을 통해 Claude Code가 생성하는 서브프로세스에서 `1`로 설정됩니다. stdio [MCP 서버](/docs/ko/mcp) 서브프로세스에는 설정되지 않습니다. 이는 장시간 실행되고 이를 생성한 세션보다 오래 지속됩니다. `CLAUDECODE`와 달리, 이는 Claude Code 자체가 서브프로세스를 시작할 때만 설정되며 IDE 확장에 의해 설정되지 않으므로, IDE 통합 터미널에서 시작된 최상위 `claude`와 중첩된 세션을 안정적으로 구분합니다. 이 방식으로 시작된 중첩된 대화형 `claude` TUI는 `--resume`, `--continue`, 위쪽 화살표 기록, `claude agents` 목록에서 자동으로 제외됩니다. 비대화형 `claude -p` 세션은 여전히 지속됩니다. `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1`을 설정하여 이 제외를 재정의하세요. Claude Code v2.1.172 이상이 필요합니다 |

231| `CLAUDE_CODE_CLIENT_CERT` | mTLS 인증을 위한 클라이언트 인증서 파일의 경로입니다 |

232| `CLAUDE_CODE_CLIENT_KEY` | mTLS 인증을 위한 클라이언트 개인 키 파일의 경로입니다 |

179| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | v2.1.186에서 제거되었으며 이제 작동하지 않습니다. 이전에는 스트리밍 API 요청의 연결, TLS, 응답 헤더 단계에 대한 별도의 타임아웃을 설정했습니다. 요청별 타임아웃의 경우 `API_TIMEOUT_MS`를 사용합니다. |234| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | v2.1.186에서 제거되었으며 이제 작동하지 않습니다. 이전에는 스트리밍 API 요청의 연결, TLS, 응답 헤더 단계에 대해 별도의 타임아웃을 설정했습니다. 요청당 타임아웃에는 `API_TIMEOUT_MS`를 사용하세요. 스트리밍 요청의 응답 헤더 단계에는 `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`를 참조하세요 |

180| `CLAUDE_CODE_DEBUG_LOGS_DIR` | 디버그 로그 파일 경로를 재정의합니다. 이름과 달리 이는 디렉토리가 아닌 파일 경로입니다. 디버그 모드를 `--debug`, `/debug`, 또는 `DEBUG` 환경 변수를 통해 별도로 활성화해야 합니다. 이 변수만 설정해도 로깅이 활성화되지 않습니다. [`--debug-file`](/docs/ko/cli-reference#cli-flags) 플래그는 둘 다 한 번에 수행합니다. 기본값은 `~/.claude/debug/<session-id>.txt`입니다. |235| `CLAUDE_CODE_DEBUG_LOGS_DIR` | 디버그 로그 파일 경로를 재정의합니다. 이름에도 불구하고, 이는 디렉토리가 아닌 파일 경로입니다. 디버그 모드를 `--debug`, `/debug`, 또는 `DEBUG` 환경 변수를 통해 별도로 활성화해야 합니다: 이 변수만 설정해도 로깅이 활성화되지 않습니다. [`--debug-file`](/docs/ko/cli-reference#cli-flags) 플래그는 둘 다 한 번에 수행합니다. 기본값은 `~/.claude/debug/<session-id>.txt`입니다 |

181| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | 디버그 로그 파일에 기록되는 최소 로그 수준입니다. 값: `verbose`, `debug`(기본값), `info`, `warn`, `error`. 전체 상태 줄 명령 출력과 같은 대용량 진단을 포함하려면 `verbose`로 설정하거나, 노이즈를 줄이려면 `error`로 올립니다. |236| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | 디버그 로그 파일에 작성되는 최소 로그 수준입니다. 값: `verbose`, `debug`(기본값), `info`, `warn`, `error`. 전체 상태 줄 명령 출력과 같은 대용량 진단을 포함하려면 `verbose`로 설정하거나, 노이즈를 줄이려면 `error`로 올리세요 |

182| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | [1M 컨텍스트 윈도우](/docs/ko/model-config#extended-context) 지원을 비활성화하려면 `1`로 설정합니다. 설정하면 1M 모델 변형을 모델 선택기에서 사용할 수 없습니다. [Sonnet 5](/docs/ko/model-config#sonnet-5-context-window) 세션은 200K 윈도우를 가진 것으로 취급됩니다. 규정 준수 요구 사항이 있는 엔터프라이즈 환경에 유용합니다. |237| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | [1M 컨텍스트 창](/docs/ko/model-config#extended-context) 지원을 비활성화하려면 `1`로 설정하세요. 설정되면, 1M 모델 변형은 모델 선택기에서 사용할 수 없으며, Claude Code는 [Sonnet 5](/docs/ko/model-config#sonnet-5-context-window)와 Fable 모델과 같이 기본 1M 창을 가진 모델의 세션을 200K 창으로 유지합니다. [확장 컨텍스트](/docs/ko/model-config#extended-context)에서 보유가 어떻게 적용되는지 참조하세요. 규정 준수 요구 사항이 있는 엔터프라이즈 환경에 유용합니다. 인식되지 않은 `[1m]` 모델 ID에 대한 창을 수정하는 역할에 대해서는 [게이트웨이 또는 사용자 정의 모델 ID에 대한 창 수정](/docs/ko/model-config#correct-the-window-for-a-gateway-or-custom-model-id)을 참조하세요 |

183| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Opus 4.6 및 Sonnet 4.6에 대해 [적응형 추론](/docs/ko/model-config#adjust-effort-level)을 비활성화하려면 `1`로 설정합니다. `MAX_THINKING_TOKENS`로 제어되는 고정 사고 예산으로 돌아갑니다. v2.1.111부터 Fable 5, Sonnet 5, Opus 4.7 이상에는 효과가 없으며, 항상 적응형 추론을 사용합니다. |238| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Opus 4.6 및 Sonnet 4.6에서 [적응형 추론](/docs/ko/model-config#adjust-effort-level)을 비활성화하고 `MAX_THINKING_TOKENS`로 제어되는 고정 사고 예산으로 폴백하려면 `1`로 설정하세요. [Fable 모델](/docs/ko/model-config#extended-thinking), Sonnet 5, Opus 4.7 이상에는 효과가 없습니다. 이들은 항상 적응형 추론을 사용합니다 |

184| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | [어드바이저 도구](/docs/ko/advisor)를 비활성화하려면 `1`로 설정합니다. `/advisor` 명령을 사용할 수 없게 되고 구성된 `advisorModel`은 무시되며, `--advisor` 플래그는 허용되지만 효과가 없으므로 기존 스크립트가 오류 없이 계속 작동합니다. |239| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | Claude Code가 [관리 설정](/docs/ko/managed-settings#precedence-within-the-managed-tier) `env` 블록을 관리 소스 전체에서 키별로 병합하지 않도록 하려면 `1`로 설정하세요. v2.1.223 이전처럼 최고 우선순위 소스의 전체 `env` 블록만 적용됩니다. Claude Code를 시작하는 환경에서 설정하세요. Claude Code는 설정 `env` 블록을 통해 전달된 복사본을 무시합니다. Claude Code v2.1.223 이상이 필요합니다 |

185| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | [백그라운드 에이전트 및 에이전트 보기](/docs/ko/agent-view)를 끄려면 `1`로 설정합니다: `claude agents`, `--bg`, `/background`, 온디맨드 감독자. [`disableAgentView`](/docs/ko/settings#available-settings) 설정과 동일합니다. |240| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | [어드바이저 도구](/docs/ko/advisor)를 비활성화하려면 `1`로 설정하세요. `/advisor` 명령을 사용할 수 없게 되고, 구성된 `advisorModel`은 무시되며, `--advisor` 플래그는 허용되지만 효과가 없으므로 기존 스크립트가 오류 없이 계속 작동합니다 |

186| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | [전체 화면 렌더링](/docs/ko/fullscreen)을 비활성화하려면 `1`로 설정합니다. 클래식 메인 화면 렌더러를 사용합니다. 대화가 터미널의 기본 스크롤백에 남아 있으므로 `Cmd+f` 및 tmux 복사 모드가 평소처럼 작동합니다. `CLAUDE_CODE_NO_FLICKER` 및 [`tui`](/docs/ko/settings#available-settings) 설정보다 우선합니다. `/tui default`로도 전환할 수 있습니다. [에이전트 보기](/docs/ko/agent-view)에서 열린 백그라운드 세션에는 적용되지 않으며, 항상 전체 화면 렌더링을 사용합니다. |241| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | [백그라운드 에이전트 및 에이전트 보기](/docs/ko/agent-view)를 끄려면 `1`로 설정하세요: `claude agents`, `--bg`, `/background`, 온디맨드 감독자. [`disableAgentView`](/docs/ko/settings-reference#disableagentview) 설정과 동일합니다 |

187| `CLAUDE_CODE_DISABLE_ARTIFACT` | [아티팩트](/docs/ko/artifacts) 도구를 비활성화하려면 `1`로 설정합니다. 이는 세션 출력을 claude.ai의 비공개 웹 페이지로 게시합니다. [`disableArtifact`](/docs/ko/settings#available-settings) 설정과 동일합니다. |242| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | [전체 화면 렌더링](/docs/ko/fullscreen)을 비활성화하고 클래식 주 화면 렌더러를 사용하려면 `1`로 설정하세요. 대화는 터미널의 기본 스크롤백에 남아 있으므로 `Cmd+f`와 tmux 복사 모드가 평소처럼 작동합니다. `CLAUDE_CODE_NO_FLICKER` 및 [`tui`](/docs/ko/settings-reference#tui) 설정보다 우선합니다. `/tui default`로도 전환할 수 있습니다. [에이전트 보기](/docs/ko/agent-view)에서 열린 백그라운드 세션에는 적용되지 않습니다. 이들은 항상 전체 화면 렌더링을 사용합니다 |

188| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | 첨부 파일 처리를 비활성화하려면 `1`로 설정합니다. `@` 구문이 있는 파일 언급은 파일 내용으로 확장되지 않고 일반 텍스트로 전송됩니다. |243| `CLAUDE_CODE_DISABLE_ARTIFACT` | [아티팩트](/docs/ko/artifacts) 도구를 끄려면 `1`로 설정하세요. 이는 세션 출력을 claude.ai의 비공개 웹 페이지로 게시합니다. 설정되면, 설정 파일이 도구를 다시 켜지 않습니다. 대신 설정 파일에서 도구를 끄려면 [`enableArtifact`](/docs/ko/settings-reference#enableartifact)를 `false`로 설정하세요. 더 이상 사용되지 않는 [`disableArtifact`](/docs/ko/settings-reference#disableartifact) 키도 끕니다 |

189| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | [자동 메모리](/docs/ko/memory#auto-memory)를 비활성화하려면 `1`로 설정합니다. `0`으로 설정하여 `--bare` 모드 또는 [`autoMemoryEnabled: false`](/docs/ko/settings#available-settings)가 그렇지 않으면 비활성화할 때에도 자동 메모리를 강제로 켭니다. 비활성화되면 Claude는 자동 메모리 파일을 생성하거나 로드하지 않습니다. |244| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | 첨부 파일 처리를 비활성화하려면 `1`로 설정하세요. `@` 구문이 있는 파일 언급은 파일 내용으로 확장되지 않고 일반 텍스트로 전송됩니다 |

190| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Bash 및 subagent 도구의 `run_in_background` 매개변수, 자동 백그라운드 처리, Ctrl+B 단축키를 포함한 모든 백그라운드 작업 기능을 비활성화하려면 `1`로 설정합니다. |245| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | [자동 메모리](/docs/ko/memory#auto-memory)를 비활성화하려면 `1`로 설정하세요. `--bare` 모드 또는 [`autoMemoryEnabled: false`](/docs/ko/settings-reference#automemoryenabled)가 그렇지 않으면 비활성화하더라도 자동 메모리를 강제로 켜려면 `0`으로 설정하세요. 비활성화되면, Claude는 자동 메모리 파일을 생성하거나 로드하지 않습니다 |

191| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | }[Amazon Bedrock](/docs/ko/amazon-bedrock) 스트리밍 응답이 `application/vnd.amazon.eventstream` 콘텐츠 유형을 전달하는지 확인하는 것을 건너뛰려면 `1`로 설정합니다. 이 변수가 없으면 다른 콘텐츠 유형의 응답이 해당 콘텐츠 유형을 명명하는 오류로 실패합니다. 이는 [게이트웨이 또는 프록시가 응답을 변환](/docs/ko/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy)하고 있음을 의미합니다. 게이트웨이가 `Content-Type` 헤더를 다시 쓰지만 바이너리 이벤트 스트림 본문을 수정되지 않은 상태로 전달할 때만 설정합니다. 본문 자체가 변환된 경우 요청은 `Truncated event message received`로 실패합니다. Claude Code v2.1.208 이상이 필요합니다. |246| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | 모든 백그라운드 작업 기능을 비활성화하려면 `1`로 설정하세요. Bash 및 서브에이전트 도구의 `run_in_background` 매개변수, 자동 백그라운드 처리, Ctrl+B 단축키 포함 |

192| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | [백그라운드 세션](/docs/ko/agent-view)의 실행 중인 백그라운드 셸 명령, 동적 워크플로우, v2.1.198부터 백그라운드 subagent를 [감독자](/docs/ko/agent-view#the-supervisor-process)가 중지, 재시작 또는 해당 세션의 프로세스를 업데이트할 때 중지하려면 `1`로 설정합니다. 대신 다음 프로세스로 전달하는 대신입니다. 이 핸드오프에만 영향을 줍니다: `←` 또는 [`/background`](/docs/ko/agent-view#from-inside-a-session)로 세션을 백그라운드 처리하면 여전히 진행 중인 작업을 수행하고, `CLAUDE_DISABLE_ADOPT`는 둘 다 끕니다. Claude Code v2.1.196 이상이 필요합니다. |247| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Claude Code가 [Amazon Bedrock](/docs/ko/amazon-bedrock) 스트리밍 응답을 누락되거나 빈 `Content-Type` 헤더가 있는 Amazon Bedrock의 이진 이벤트 스트림으로 처리하지 않도록 하려면 `1`로 설정하세요. 기본적으로 Claude Code는 게이트웨이가 그렇지 않으면 수정되지 않은 응답에서 헤더를 삭제했다고 가정하므로 본문을 디코딩하고 스트리밍이 계속 작동합니다. 게이트웨이가 스트림을 서버 전송 이벤트로 다시 내보내는 경우에만 설정하세요. Claude Code는 헤더 없는 본문을 서버 전송 이벤트로 읽습니다. Claude Code v2.1.239 이상이 필요합니다 |

193| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | 운영 체제가 메모리 압력을 보고할 때 Claude Code가 [백그라운드 셸 명령](/docs/ko/interactive-mode#background-bash-commands)을 종료하지 않도록 하려면 `1`로 설정합니다. 기본적으로 macOS 및 Linux에서 Claude Code는 세션이 30분 동안 유휴 상태이고 턴 또는 subagent가 실행 중이 아닐 때 메모리 압력 신호에서 주 세션에서 시작된 백그라운드 셸을 종료합니다. Windows에는 메모리 압력 신호가 없으므로 이 변수는 효과가 없습니다. Claude Code v2.1.193 이상이 필요합니다. |248| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | [Amazon Bedrock](/docs/ko/amazon-bedrock) 스트리밍 응답이 `application/vnd.amazon.eventstream` 콘텐츠 유형을 전달하는지 확인하는 것을 건너뛰려면 `1`로 설정하세요. 이 변수가 없으면, 응답이 다른 콘텐츠 유형을 전달할 때, Claude Code는 해당 유형을 명명하는 오류로 요청을 실패합니다. 이는 [게이트웨이 또는 프록시가 응답을 변환](/docs/ko/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy)하고 있음을 의미합니다. 이 변수를 설정하는 대신 게이트웨이를 구성하여 `Content-Type` 헤더와 본문을 수정되지 않은 상태로 전달하세요. Claude Code v2.1.208 이상이 필요합니다 |

194| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Claude Code와 함께 제공되는 [skill](/docs/ko/skills) 및 워크플로우를 비활성화하려면 `1`로 설정합니다: 번들 skill 및 워크플로우는 완전히 제거되고, `/init`과 같은 기본 제공 명령은 입력 가능하지만 모델에서 숨겨집니다. `/doctor`는 기본 제공 명령처럼 입력 가능하지만 `DISABLE_DOCTOR_COMMAND`로 숨길 수 있습니다. 플러그인, `.claude/skills/`, `.claude/commands/`의 skill은 영향을 받지 않습니다. [`disableBundledSkills`](/docs/ko/settings#available-settings) 설정과 동일합니다. `0`은 이를 재정의하지 않습니다. |249| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | [백그라운드 세션](/docs/ko/agent-view)의 실행 중인 백그라운드 셸 명령, 동적 워크플로우, v2.1.198부터 백그라운드 서브에이전트가 [감독자](/docs/ko/agent-view#the-supervisor-process)가 해당 세션의 프로세스를 중지, 재시작 또는 업데이트할 때 다음 프로세스로 전달되지 않도록 하려면 `1`로 설정하세요. 해당 전달에만 영향을 미칩니다: `←` 또는 [`/background`](/docs/ko/agent-view#from-inside-a-session)로 세션을 백그라운드 처리하면 여전히 진행 중인 작업을 전달하고, `CLAUDE_DISABLE_ADOPT`는 둘 다 끕니다. Claude Code v2.1.196 이상이 필요합니다 |

195| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | 사용자, 프로젝트, 자동 메모리 파일을 포함한 모든 CLAUDE.md 메모리 파일을 컨텍스트에 로드하지 않으려면 `1`로 설정합니다. |250| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Claude Code가 운영 체제가 메모리 압력을 보고할 때 [백그라운드 셸 명령](/docs/ko/interactive-mode#background-bash-commands)을 종료하지 않도록 하려면 `1`로 설정하세요. 기본적으로 macOS 및 Linux에서 Claude Code는 세션이 30분 동안 유휴 상태이고 턴이나 서브에이전트가 실행 중이 아닐 때 메모리 압력 신호에서 주 세션에서 시작된 백그라운드 셸을 종료합니다. Windows에는 메모리 압력 신호가 없으므로 이 변수는 효과가 없습니다. Claude Code v2.1.193 이상이 필요합니다 |

196| `CLAUDE_CODE_DISABLE_CRON` | [예약된 작업](/docs/ko/scheduled-tasks)을 비활성화하려면 `1`로 설정합니다. `/loop` skill과 cron 도구를 사용할 수 없게 되고 이미 예약된 모든 작업이 중지되며, 세션 중에 이미 실행 중인 작업을 포함한 모든 작업이 실행되지 않습니다. |251| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Claude Code에 포함된 [기술](/docs/ko/skills) 및 워크플로우를 비활성화하려면 `1`로 설정하세요: 번들 기술 및 워크플로우는 완전히 제거되고, `/init`과 같은 기본 제공 명령은 입력 가능하지만 모델에서 숨겨집니다. `/doctor`는 기본 제공 명령처럼 입력 가능합니다. `DISABLE_DOCTOR_COMMAND`로 숨기세요. 플러그인, `.claude/skills/`, `.claude/commands/`의 기술은 영향을 받지 않습니다. [`disableBundledSkills`](/docs/ko/settings-reference#disablebundledskills) 설정과 동일합니다 |

197| `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`)는 유지됩니다. [MCP 도구 검색](/docs/ko/mcp#scale-with-mcp-tool-search)은 비활성화되고 모든 MCP 도구는 `ENABLE_TOOL_SEARCH`가 설정된 경우에도 미리 로드됩니다. |252| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | [Chrome의 Claude](/docs/ko/chrome) 브라우저 도구를 사용 가능하게 유지하면서 시스템 프롬프트의 Chrome 섹션과 `/claude-in-chrome` [번들 기술](/docs/ko/skills#bundled-skills)을 생략하려면 `1`로 설정하세요. Claude Code를 포함하고 자체 브라우저 지침을 제공하는 호스트용입니다. Claude Code v2.1.257 이상이 필요합니다 |

198| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | 기본 제공 [Explore 및 Plan subagent](/docs/ko/sub-agents#built-in-subagents)를 비활성화하려면 `1`로 설정합니다. Claude는 검색 도구 또는 범용 subagent로 탐색하고, [계획 모드](/docs/ko/permission-modes#analyze-before-you-edit-with-plan-mode)는 Explore 및 Plan 에이전트를 시작하는 대신 파일을 직접 읽습니다. Explore 또는 Plan이라는 사용자 정의 subagent는 영향을 받지 않습니다. Agent SDK 또는 비대화형 모드에서 모든 기본 제공 subagent 유형을 제거하려면 `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`를 대신 사용합니다. Claude Code v2.1.198 이상이 필요합니다. |253| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | 사용자, 프로젝트, 자동 메모리 파일을 포함한 CLAUDE.md 메모리 파일을 컨텍스트에 로드하지 않으려면 `1`로 설정하세요 |

199| `CLAUDE_CODE_DISABLE_FAST_MODE` | [빠른 모드](/docs/ko/fast-mode)를 비활성화하려면 `1`로 설정합니다. |254| `CLAUDE_CODE_DISABLE_CRON` | [예약된 작업](/docs/ko/scheduled-tasks)을 비활성화하려면 `1`로 설정하세요. `/loop` 기술 및 cron 도구를 사용할 수 없게 되고 이미 예약된 작업이 중지됩니다. 세션 중에 이미 실행 중인 작업 포함 |

200| `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`](/docs/ko/settings#available-settings) 설정을 사용합니다. [세션 품질 설문조사](/docs/ko/data-usage#session-quality-surveys) 참조 |255| `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`)는 보존됩니다. [MCP 도구 검색](/docs/ko/mcp#scale-with-mcp-tool-search)이 비활성화되고 모든 MCP 도구가 미리 로드됩니다. 도구 검색이 설정되어 있더라도 마찬가지입니다. Claude Code v2.1.227 이상에서는 [관리 설정](/docs/ko/managed-settings)이 도구 검색을 켜 둘 수 있습니다. [사전 릴리스 기능 비활성화](/docs/ko/llm-gateway-protocol#disable-pre-release-capabilities)에서 재정의가 적용되는 위치를 확인하세요 |

201| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | 파일 [체크포인팅](/docs/ko/checkpointing)을 비활성화하려면 `1`로 설정합니다. `/rewind` 명령이 코드 변경 사항을 복원할 수 없습니다. |256| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | 기본 제공 [Explore 및 Plan 서브에이전트](/docs/ko/sub-agents#built-in-subagents)를 비활성화하려면 `1`로 설정하세요. Claude는 검색 도구 또는 범용 서브에이전트로 탐색하고, [계획 모드](/docs/ko/permission-modes#analyze-before-you-edit-with-plan-mode)는 Explore 및 Plan 에이전트를 시작하는 대신 파일을 직접 읽습니다. `Explore` 또는 `Plan`이라는 사용자 정의 서브에이전트는 영향을 받지 않습니다. Agent SDK 또는 비대화형 모드에서 모든 기본 제공 서브에이전트 유형을 제거하려면 `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`를 대신 사용하세요. Claude Code v2.1.198 이상이 필요합니다 |

202| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Claude의 시스템 프롬프트에서 기본 제공 커밋 및 PR 워크플로우 지침과 git 상태 스냅샷을 제거하려면 `1`로 설정합니다. 자신의 git 워크플로우 skill을 사용할 때 유용합니다. 설정하면 [`includeGitInstructions`](/docs/ko/settings#available-settings) 설정보다 우선합니다. |257| `CLAUDE_CODE_DISABLE_FAST_MODE` | [빠른 모드](/docs/ko/fast-mode)를 비활성화하려면 `1`로 설정하세요 |

203| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Anthropic API에서 Opus 4.0 및 4.1을 현재 Opus 버전으로 자동 재매핑하지 않으려면 `1`로 설정합니다. 의도적으로 이전 모델을 고정하려는 경우 사용합니다. 재매핑은 Amazon Bedrock, Google Cloud's Agent Platform, 또는 Microsoft Foundry에서 실행되지 않습니다. |258| `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`](/docs/ko/settings-reference#feedbacksurveyrate) 설정을 사용하세요. [세션 품질 설문조사](/docs/ko/data-usage#session-quality-surveys)를 참조하세요 |

204| `CLAUDE_CODE_DISABLE_MOUSE` | [전체 화면 렌더링](/docs/ko/fullscreen)에서 마우스 추적을 비활성화하려면 `1`로 설정합니다. `PgUp` 및 `PgDn`을 사용한 키보드 스크롤은 계속 작동합니다. 터미널의 기본 선택 시 복사 동작을 유지하려면 이를 사용합니다. |259| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | 파일 [체크포인팅](/docs/ko/checkpointing)을 비활성화하려면 `1`로 설정하세요. `/rewind` 명령이 코드 변경을 복원할 수 없습니다. [`fileCheckpointingEnabled`](/docs/ko/settings-reference#filecheckpointingenabled) 설정을 재정의합니다 |

205| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | [전체 화면 렌더링](/docs/ko/fullscreen)에서 클릭, 드래그, 호버 처리를 비활성화하려면 `1`로 설정합니다. 마우스 휠 스크롤은 유지합니다. 휠 스크롤이 Claude Code 내에서 작동하기를 원하지만 클릭이 커서를 배치하거나, 도구 출력을 확장하거나, 링크를 열지 않기를 원할 때 사용합니다. 둘 다 설정하면 `CLAUDE_CODE_DISABLE_MOUSE`가 우선합니다. Claude Code v2.1.195 이상이 필요합니다. |260| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Claude의 시스템 프롬프트에서 기본 제공 커밋 및 PR 워크플로우 지침과 git 상태 스냅샷을 제거하려면 `1`로 설정하세요. 자신의 git 워크플로우 기술을 사용할 때 유용합니다. 설정되면 [`includeGitInstructions`](/docs/ko/settings-reference#includegitinstructions) 설정보다 우선합니다 |

206| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | `DISABLE_AUTOUPDATER`, `DISABLE_FEEDBACK_COMMAND`, `DISABLE_ERROR_REPORTING`, `DISABLE_TELEMETRY` 설정과 동일합니다. |261| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Anthropic API에서 Opus 4.0 및 4.1을 현재 Opus 버전으로 자동 재매핑하지 않으려면 `1`로 설정하세요. 의도적으로 이전 모델을 고정하려고 할 때 사용합니다. 재매핑은 Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry에서 실행되지 않습니다 |

207| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | 스트리밍 요청이 중간에 실패할 때 비스트리밍 폴백을 비활성화하려면 `1`로 설정합니다. 스트리밍 오류는 재시도 계층으로 전파됩니다. 프록시 또는 게이트웨이가 폴백으로 인해 중복 도구 실행을 생성할 때 유용합니다. |262| `CLAUDE_CODE_DISABLE_MOUSE` | [전체 화면 렌더링](/docs/ko/fullscreen)에서 마우스 추적을 비활성화하려면 `1`로 설정하세요. `PgUp` 및 `PgDn`을 사용한 키보드 스크롤은 여전히 작동합니다. 터미널의 기본 선택 시 복사 동작을 유지하려면 이를 사용하세요 |

208| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | 터미널에서 입력하거나 포커스할 때에도 `PushNotification` 도구의 데스크톱 알림을 전송하려면 `1`로 설정합니다. 기본적으로 도구는 최근 키보드 활동 또는 터미널 포커스를 감지할 때 데스크톱 알림과 [모바일 푸시](/docs/ko/remote-control#mobile-push-notifications)를 모두 건너뜁니다. 이 변수는 로컬 확인만 비활성화하므로 서버는 활성 상태를 감지할 때 모바일 푸시를 억제할 수 있습니다. Claude Code v2.1.193 이상이 필요합니다. |263| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | [전체 화면 렌더링](/docs/ko/fullscreen)에서 클릭, 드래그, 호버 처리를 비활성화하면서 마우스 휠 스크롤을 유지하려면 `1`로 설정하세요. Claude Code 내에서 휠 스크롤이 작동하기를 원하지만 클릭이 커서를 배치하거나, 도구 출력을 확장하거나, 링크를 열지 않기를 원할 때 사용합니다. 둘 다 설정되면 `CLAUDE_CODE_DISABLE_MOUSE`가 우선합니다. Claude Code v2.1.195 이상이 필요합니다 |

209| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | 첫 실행 시 공식 플러그인 마켓플레이스의 자동 추가를 건너뛰려면 `1`로 설정합니다. |264| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | Claude Code가 API 요청이 연결 재설정 또는 TLS 핸드셰이크 오류와 같은 연결 수준 오류로 실패할 때 [mTLS 클라이언트 인증서 및 키](/docs/ko/network-config#mtls-authentication)를 다시 읽지 않도록 하려면 `1`로 설정하세요. 다시 로드가 비활성화되면, Claude Code는 다음에 설정을 적용하거나 다음 시작 시에만 회전된 파일을 로드합니다. Claude Code v2.1.232 이상이 필요합니다 |

210| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | 시스템 전체 관리 skill 디렉토리에서 skill을 로드하지 않으려면 `1`로 설정합니다. 운영자가 프로비저닝한 skill을 로드하지 않아야 하는 컨테이너 또는 CI 세션에 유용합니다. |265| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | 비필수 네트워크 트래픽을 비활성화하려면 `1`과 같은 비어있지 않은 값으로 설정하세요: 자동 업데이트, 원격 분석, 오류 보고, `/feedback` 명령, [Claude 작성 피드백](/docs/ko/tools-reference#sendfeedback-tool-behavior), 릴리스 노트, [PR 및 MR 상태 배지](/docs/ko/interactive-mode#pr-review-status) 확인, [빠른 모드](/docs/ko/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) 확인과 같은 가용성 확인. 또한 [플러그인 `command` 소스의 백그라운드 실행](/docs/ko/plugin-marketplaces#when-claude-code-re-runs-the-command)을 중지합니다. 이는 네트워크 트래픽이 아니라 로컬 명령이지만 종속성 설치를 트리거할 수 있습니다. **`0` 또는 `false`로 설정해도 이 트래픽이 비활성화됩니다**. 대부분의 온/오프 변수와 달리 변수를 설정 해제하여 다시 허용하세요. 또한 기능 플래그 가져오기를 비활성화하여 [원격 제어](/docs/ko/remote-control#requirements) 및 기타 [기능 플래그 가져오기가 필요한 기능](#features-that-need-feature-flag-fetching)을 사용할 수 없게 만듭니다. 공식 플러그인 마켓플레이스 자동 설치는 포함되지 않습니다. `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`로 비활성화하세요. [게이트웨이 모델 검색](/docs/ko/llm-gateway-connect#add-gateway-models-to-the-model-picker)에는 영향을 주지 않습니다. 이는 자체 옵트인입니다 |

211| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | 대화 컨텍스트를 기반으로 자동 터미널 제목 업데이트를 비활성화하려면 `1`로 설정합니다. Agent SDK 및 `claude -p` 세션에서는 세션 제목을 생성하는 백그라운드 Haiku 요청도 건너뜁니다. |266| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | 스트리밍 요청이 스트림 중간에 실패할 때 비스트리밍 폴백을 비활성화하려면 `1`로 설정하세요. 스트리밍 오류는 재시도 계층으로 전파됩니다. 프록시 또는 게이트웨이가 폴백으로 인해 중복 도구 실행을 생성할 때 유용합니다 |

212| `CLAUDE_CODE_DISABLE_THINKING` | API 요청에서 `thinking` 매개변수를 완전히 생략하려면 `1`로 설정합니다. 이는 매개변수를 거부하는 프록시 및 게이트웨이를 위한 호환성 옵션입니다. 변수의 동작은 이전 버전과 동일합니다. 기본적으로 생각하는 모델에서 매개변수를 생략하면 모델이 여전히 생각할 수 있습니다. Anthropic API에서 [확장 사고](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)를 명시적으로 비활성화하려면 `MAX_THINKING_TOKENS=0`을 대신 사용합니다. 이는 Fable 5에서도 효과가 없습니다. Fable 5는 사고를 끌 수 없기 때문입니다. [타사 공급자](/docs/ko/third-party-integrations)에서 `0`은 마찬가지로 매개변수를 생략하므로 두 변수는 거기서 동일하게 동작합니다. |267| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | 터미널에 입력하거나 포커스할 때도 `PushNotification` 도구의 데스크톱 알림을 보내려면 `1`로 설정하세요. 기본적으로 도구는 최근 키보드 활동 또는 터미널 포커스를 감지할 때 데스크톱 알림과 [모바일 푸시](/docs/ko/remote-control#mobile-push-notifications)를 모두 건너뜁니다. 이 변수는 로컬 확인만 비활성화하므로 서버는 활동을 감지할 때 모바일 푸시를 여전히 억제할 수 있습니다. Claude Code v2.1.193 이상이 필요합니다 |

213| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | [전체 화면 렌더링](/docs/ko/fullscreen)에서 가상 스크롤을 비활성화하려면 `1`로 설정합니다. 전체 화면 모드에서 스크롤이 메시지가 나타나야 할 위치에 빈 영역을 표시하면 이를 사용합니다. |268| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | 공식 플러그인 마켓플레이스의 자동 등록을 비활성화하려면 `1`로 설정하세요. Claude Code는 마켓플레이스를 등록하려고 할 때 변수를 읽습니다. 보통 머신의 첫 대화형 시작 중입니다. 그 시점에서 변수가 설정되면, Claude Code는 등록을 영구적으로 건너뜁니다. 나중에 변수를 설정 해제해도 건너뛰기가 취소되지 않습니다. 언제든지 `claude plugin marketplace add anthropics/claude-plugins-official`을 실행하여 마켓플레이스를 등록하세요 |

214| `CLAUDE_CODE_DISABLE_WORKFLOWS` | [워크플로우](/docs/ko/workflows#turn-workflows-off)를 비활성화하려면 `1`로 설정합니다. [`disableWorkflows`](/docs/ko/settings#available-settings) 설정과 동일합니다. |269| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Claude Code가 Claude Desktop 및 VS Code 확장이 Claude Code를 호스팅하는 방식인 Agent SDK의 `canUseTool` 콜백으로 보내는 세션에서 [응답하지 않은 권한 요청에 대한 `Notification` 훅](/docs/ko/hooks#notification)을 실행하지 않도록 하려면 `1`로 설정하세요. 터미널 세션에는 효과가 없습니다. Claude Code v2.1.233 이상이 필요합니다 |

215| `CLAUDE_CODE_EFFORT_LEVEL` | 지원되는 모델의 노력 수준을 설정합니다. 값: `low`, `medium`, `high`, `xhigh`, `max`, 또는 `auto`(모델 기본값 사용). 사용 가능한 수준은 모델에 따라 다릅니다. `/effort` 및 `effortLevel` 설정보다 우선합니다. [노력 수준 조정](/docs/ko/model-config#adjust-effort-level) 참조 |270| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | 시스템 전체 관리 기술 디렉토리에서 기술 로드를 건너뛰려면 `1`로 설정하세요. 컨테이너 또는 CI 세션이 운영자 제공 기술을 로드하지 않아야 할 때 유용합니다 |

216| `CLAUDE_CODE_ENABLE_APPEND_SUBAGENT_PROMPT` | 모든 [subagent](/docs/ko/sub-agents)의 시스템 프롬프트 끝에 추가 텍스트를 추가하는 것을 활성화하려면 `1`로 설정합니다. [`--append-subagent-system-prompt`](/docs/ko/cli-reference#cli-flags) 플래그는 추가된 텍스트를 제공하고 이 변수를 자동으로 설정하므로 직접 설정할 필요가 없습니다. Claude Code v2.1.205 이상이 필요합니다. |271| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | 대화 컨텍스트를 기반으로 자동 터미널 제목 업데이트를 비활성화하려면 `1`로 설정하세요. Agent SDK 및 `claude -p` 세션에서는 세션 제목을 생성하는 백그라운드 소형/빠른 모델 요청도 건너뜁니다 |

217| `CLAUDE_CODE_ENABLE_AUTO_MODE` | {{/* min-version: 2.1.207 */}}이전 릴리스와의 호환성을 위해 허용되며 효과가 없습니다. 자동 모드는 Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, 서명된 [Claude 앱 게이트웨이](/docs/ko/claude-apps-gateway) 세션을 포함한 모든 공급자에서 기본적으로 사용 가능합니다. v2.1.158부터 v2.1.206까지 이를 `1`로 설정하는 것이 해당 공급자에서 [자동 모드](/docs/ko/permission-modes#eliminate-prompts-with-auto-mode)를 사용 가능하게 하는 데 필요했습니다. |272| `CLAUDE_CODE_DISABLE_THINKING` | API 요청에서 `thinking` 매개변수를 완전히 생략하려면 `1`로 설정하세요. 이는 매개변수를 거부하는 프록시 및 게이트웨이를 위한 호환성 옵션입니다. 기본적으로 생각하는 모델에서 매개변수를 생략하면 모델이 여전히 생각할 수 있습니다. Anthropic API에서 [확장 사고](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)를 명시적으로 비활성화하려면 `MAX_THINKING_TOKENS=0`을 대신 사용하세요. 어느 변수도 Fable 모델에서 사고를 끄지 않습니다. 이는 사고를 끌 수 없습니다. [타사 제공자](/docs/ko/third-party-integrations)에서 `MAX_THINKING_TOKENS=0`은 마찬가지로 매개변수를 생략하므로 두 변수가 동일하게 작동합니다 |

218| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | [세션 요약](/docs/ko/interactive-mode#session-recap) 가용성을 재정의합니다. 재개를 강제로 끄려면 `0`으로 설정합니다. [`awaySummaryEnabled`](/docs/ko/settings#available-settings)가 `false`일 때 재개를 강제로 켜려면 `1`로 설정합니다. 설정 및 `/config` 토글보다 우선합니다. |273| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Claude Code가 모델 ID를 인식하지 못할 때(예: [LLM 게이트웨이](/docs/ko/llm-gateway) 별칭) 사전 [자동 압축](/docs/ko/costs#reduce-token-usage)을 건너뛰려면 `1`로 설정하세요. 이 변수가 없으면, Claude Code는 ID에 대해 가정하는 컨텍스트 창에서 압축합니다. `CLAUDE_CODE_MAX_CONTEXT_TOKENS`은 대신 가정된 창을 수정할 수 있습니다. [게이트웨이 또는 사용자 정의 모델 ID에 대한 창 수정](/docs/ko/model-config#correct-the-window-for-a-gateway-or-custom-model-id)에서 각 변수가 적용되는 시기를 참조하세요. Claude Code v2.1.223 이상이 필요합니다 |

219| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | [비대화형 모드](/docs/ko/headless)에서 백그라운드 설치가 완료된 후 턴 경계에서 플러그인 상태를 새로 고치려면 `1`로 설정합니다. 새로 고침이 세션 중간에 시스템 프롬프트를 변경하여 해당 턴의 [프롬프트 캐싱](/docs/ko/prompt-caching)을 무효화하므로 기본적으로 꺼져 있습니다. |274| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | [전체 화면 렌더링](/docs/ko/fullscreen)에서 가상 스크롤을 비활성화하고 대화 기록의 모든 메시지를 렌더링하려면 `1`로 설정하세요. 전체 화면 모드에서 스크롤이 메시지가 나타나야 할 위치에 빈 영역을 표시하면 이를 사용하세요 |

220| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Anthropic 바운드 비필수 트래픽이 차단될 때 "Claude가 어떻게 하고 있나요?" 세션 품질 설문조사를 자신의 [OpenTelemetry 수집기](/docs/ko/monitoring-usage)로 라우팅하려면 `1`로 설정합니다. 설문조사 등급은 구성된 수집기에 OTEL 이벤트로만 내보내집니다. 이 모드에서는 설문조사 데이터가 Anthropic으로 전송되지 않습니다. `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY`, 또는 `DO_NOT_TRACK`이 설정되었을 때 적용되며, 그렇지 않으면 효과가 없습니다. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` 및 조직 제품 피드백 정책이 우선합니다. |275| `CLAUDE_CODE_DISABLE_WORKFLOWS` | [워크플로우](/docs/ko/workflows#turn-workflows-off)를 비활성화하려면 `1`로 설정하세요. [`disableWorkflows`](/docs/ko/settings-reference#disableworkflows) 설정과 동일합니다 |

221| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | 도구 호출 입력이 Claude가 생성할 때 API에서 스트리밍되는지 여부를 제어합니다. 이 없으면 파일 쓰기와 같은 큰 도구 입력이 Claude가 생성을 완료한 후에만 도착하므로 중단된 것처럼 보일 수 있습니다. Anthropic API에 대해 기본적으로 활성화됩니다. Amazon Bedrock 및 Google Cloud's Agent Platform에서는 배포된 컨테이너가 지원하는 모델별로 활성화됩니다. 옵트아웃하려면 `0`으로 설정합니다. `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` 또는 `ANTHROPIC_BEDROCK_BASE_URL`을 통해 프록시로 라우팅할 때 강제로 활성화하려면 `1`로 설정합니다. Microsoft Foundry 및 [게이트웨이](/docs/ko/llm-gateway) 연결에는 기본적으로 꺼져 있습니다. |276| `CLAUDE_CODE_EFFORT_LEVEL` | 지원되는 모델의 노력 수준을 설정합니다. 값: `low`, `medium`, `high`, `xhigh`, `max`, 또는 `auto`(모델 기본값 사용). 사용 가능한 수준은 모델에 따라 다릅니다. `--effort`, `/effort`, `modelSettings` 및 `effortLevel` 설정보다 우선합니다. [`maxEffortLevel`](/docs/ko/settings-reference#maxeffortlevel) 상한이 여전히 적용됩니다. [노력 수준 조정](/docs/ko/model-config#adjust-effort-level)을 참조하세요 |

222| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | `ANTHROPIC_BASE_URL`이 LiteLLM, Kong 또는 내부 프록시와 같은 Anthropic 호환 게이트웨이를 가리킬 때 게이트웨이의 `/v1/models` 엔드포인트에서 `/model` 선택기를 채우려면 `1`로 설정합니다. 공유 API 키로 지원되는 게이트웨이는 그렇지 않으면 모든 사용자에게 키가 액세스할 수 있는 모든 모델을 표시하므로 기본적으로 꺼져 있습니다. 검색된 모델은 여전히 [`availableModels`](/docs/ko/settings#available-settings) 허용 목록으로 필터링됩니다. 세션이 받는 목록을 통해 전달합니다. [MDM 또는 관리 설정 파일](/docs/ko/settings#settings-files)을 통해 전달하세요. [서버 관리 전달은 게이트웨이 구성에서 사용할 수 없습니다](/docs/ko/server-managed-settings#platform-availability). |277| `CLAUDE_CODE_ENABLE_APPEND_SUBAGENT_PROMPT` | [포크된 서브에이전트](/docs/ko/sub-agents#fork-the-current-conversation)를 제외한 모든 [서브에이전트](/docs/ko/sub-agents)의 시스템 프롬프트 끝에 추가 텍스트를 추가하는 것을 활성화하려면 `1`로 설정하세요. [`--append-subagent-system-prompt`](/docs/ko/cli-reference#cli-flags) 및 [`--append-subagent-system-prompt-file`](/docs/ko/cli-reference#cli-flags) 플래그는 추가된 텍스트를 제공하고 이 변수를 자동으로 설정하므로 직접 설정할 필요가 없습니다. Claude Code v2.1.205 이상이 필요합니다 |

223| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | v2.1.142에서 제거됨. [빠른 모드](/docs/ko/fast-mode) 기본값이 Opus 4.6에서 Opus 4.7로 이동했을 때 |278| `CLAUDE_CODE_ENABLE_AUTO_MODE` | 호환성을 위해 허용되며 효과가 없습니다. 자동 모드는 Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry, 서명된 [Claude 앱 게이트웨이](/docs/ko/claude-apps-gateway) 세션을 포함한 모든 제공자에서 기본적으로 사용 가능합니다. v2.1.158부터 v2.1.206까지, 이를 `1`로 설정하는 것이 해당 제공자에서 [자동 모드](/docs/ko/permission-modes#eliminate-prompts-with-auto-mode)를 사용 가능하게 하는 데 필요했습니다 |

224| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | 프롬프트 제안을 비활성화하려면 `false`로 설정합니다(`/config`의 "프롬프트 제안" 토글). 이는 Claude가 응답한 후 프롬프트 입력에 나타나는 회색으로 표시된 예측입니다. [프롬프트 제안](/docs/ko/interactive-mode#prompt-suggestions) 참조 |279| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | [세션 요약](/docs/ko/interactive-mode#session-recap) 가용성을 재정의합니다. `/config` 토글에 관계없이 요약을 강제로 끄려면 `0`으로 설정하세요. [`awaySummaryEnabled`](/docs/ko/settings-reference#awaysummaryenabled)가 `false`일 때 요약을 강제로 켜려면 `1`로 설정하세요. 설정 및 `/config` 토글보다 우선합니다 |

225| `CLAUDE_CODE_ENABLE_TASKS` | 세션이 구조화된 Task 도구(`TaskCreate`, `TaskUpdate`, `TaskGet`, `TaskList`) 또는 레거시 `TodoWrite` 도구를 사용하는지 제어합니다. Claude Code v2.1.142부터 Task 도구는 모든 모드에서 기본값입니다. `TodoWrite`로 되돌리려면 `0`으로 설정합니다. [작업 목록](/docs/ko/interactive-mode#task-list) 및 [Task 도구로 마이그레이션](/docs/ko/agent-sdk/todo-tracking#migrate-to-task-tools) 참조 |280| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | 백그라운드 설치가 완료된 후 [비대화형 모드](/docs/ko/headless)에서 턴 경계에서 플러그인 상태를 새로 고치려면 `1`로 설정하세요. 기본적으로 꺼져 있습니다. 새로 고침이 세션 중간에 시스템 프롬프트를 변경하기 때문입니다. 이는 해당 턴에 대한 [프롬프트 캐싱](/docs/ko/prompt-caching)을 무효화합니다 |

226| `CLAUDE_CODE_ENABLE_TELEMETRY` | 메트릭 및 로깅을 위한 OpenTelemetry 데이터 수집을 활성화하려면 `1`로 설정합니다. OTel 내보내기를 구성하기 전에 필수입니다. [모니터링](/docs/ko/monitoring-usage) 참조 |281| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Anthropic 바운드 비필수 트래픽이 차단될 때 "Claude가 어떻게 하고 있나요?" 세션 품질 설문조사를 자신의 [OpenTelemetry 수집기](/docs/ko/monitoring-usage)로 라우팅하려면 `1`로 설정하세요. 설문조사 등급은 구성된 수집기에 OTEL 이벤트로만 내보내집니다. 이 모드에서는 설문조사 데이터가 Anthropic으로 전송되지 않습니다. `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY`, 또는 `DO_NOT_TRACK`이 설정되면 적용되며, 그렇지 않으면 효과가 없습니다. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` 및 조직 제품 피드백 정책이 우선합니다 |

227| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | 쿼리 루프가 유휴 상태가 된 후 자동으로 종료되기 전에 대기할 시간(밀리초). SDK 모드를 사용하는 자동화된 워크플로우 및 스크립트에 유용합니다. |282| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | 도구 호출 입력이 Claude가 생성할 때 API에서 스트리밍되는지 여부를 제어합니다. 이것이 꺼져 있으면, 긴 파일 쓰기와 같은 큰 도구 입력은 Claude가 생성을 마친 후에만 도착합니다. 이는 중단된 것처럼 보일 수 있습니다. Anthropic API에서 기본적으로 활성화됩니다. Amazon Bedrock 및 Google Cloud의 Agent Platform에서는 배포된 컨테이너가 지원하는 모델별로 활성화됩니다. 옵트아웃하려면 `0`으로 설정하세요. `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL`, 또는 `ANTHROPIC_BEDROCK_BASE_URL`을 통해 프록시를 통해 라우팅할 때 강제로 켜려면 `1`로 설정하세요. Microsoft Foundry 및 [게이트웨이](/docs/ko/llm-gateway) 연결에서는 기본적으로 꺼져 있습니다 |

228| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | [에이전트 팀](/docs/ko/agent-teams)을 활성화하려면 `1`로 설정합니다. 에이전트 팀은 실험적이며 기본적으로 비활성화됩니다. |283| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | `ANTHROPIC_BASE_URL`이 LiteLLM, Kong, 내부 프록시와 같은 Anthropic 호환 게이트웨이의 `/v1/models` 엔드포인트에서 `/model` 선택기를 채우려면 `1`로 설정하세요. 기본적으로 꺼져 있습니다. 공유 API 키로 지원되는 게이트웨이는 그렇지 않으면 모든 사용자에게 키가 액세스할 수 있는 모든 모델을 표시하기 때문입니다. 검색된 모델은 여전히 세션이 수신하는 [`availableModels`](/docs/ko/settings-reference#availablemodels) 허용 목록으로 필터링됩니다. [MDM 또는 관리 설정 파일](/docs/ko/managed-settings#delivery-mechanisms)을 통해 목록을 전달하세요. [서버 관리 전달은 게이트웨이 구성에서 사용할 수 없습니다](/docs/ko/server-managed-settings#platform-availability) |

229| `CLAUDE_CODE_EXTRA_BODY` | 모든 API 요청 본문의 최상위 수준으로 병합할 JSON 객체입니다. Claude Code가 직접 노출하지 않는 공급자 특정 매개변수를 전달하는 데 유용합니다. {{/* min-version: 2.1.206 */}}셸에서 내보낸 값은 `claude agents` 또는 `--bg`로 디스패치하는 [백그라운드 세션](/docs/ko/agent-view)에도 적용됩니다. v2.1.206 이전에는 백그라운드 세션이 셸 내보낸 값을 무시하고 백그라운드 감독자 프로세스가 상속한 복사본을 사용했습니다. |284| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | v2.1.142에서 제거되었습니다. [빠른 모드](/docs/ko/fast-mode) 기본값이 Opus 4.6에서 Opus 4.7로 이동했을 때 |

230| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | 파일 읽기의 기본 토큰 제한을 재정의합니다. 전체 파일을 읽어야 할 때 유용합니다. |285| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | 프롬프트 입력에 나타나는 회색 예측인 프롬프트 제안을 끄려면 `false`로 설정하세요. [`promptSuggestionEnabled`](/docs/ko/settings-reference#promptsuggestionenabled) 설정보다 우선합니다. 이는 `/config`의 **프롬프트 제안** 토글이 작성하는 것입니다. Claude Code는 또한 [계정이 사용 제한에 가까워지거나 도달할 때 제안을 일시 중지합니다](/docs/ko/interactive-mode#when-claude-code-skips-suggestions). 제한에 도달할 때까지 켜 두려면 `true`로 설정하세요. Claude Code v2.1.238 이상이 필요합니다. [프롬프트 제안](/docs/ko/interactive-mode#prompt-suggestions)을 참조하세요 |

231| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | 이 `claude`가 다른 Claude Code 세션 내부에서 시작되었을 때에도 트랜스크립트 지속성, 프롬프트 기록, `claude agents` 등록을 강제하려면 `1`로 설정합니다. 예를 들어 Claude Code의 Bash 도구에서 처음 시작된 tmux 서버에서 상속된 `CLAUDE_CODE_CHILD_SESSION` 값이 진정한 최상위 세션을 중첩으로 잘못 분류할 때 사용합니다. v2.1.178부터 Claude Code는 tmux 경우를 자동으로 감지하고 상속된 마커를 무시하므로 tmux는 더 이상 이 변수가 필요하지 않습니다. v2.1.169 이상에서도 인정됩니다. v2.1.170 및 v2.1.171에서는 효과가 없으며, 이를 재정의한 중첩 세션 감지가 제거되었습니다. |286| `CLAUDE_CODE_ENABLE_TASKS` | [이를 가진 세션](/docs/ko/tools-reference#task-tool-availability)에서 Claude Code가 제공하는 작업 추적 도구를 선택합니다. 기본적으로 Claude Code는 Task 도구 `TaskCreate`, `TaskUpdate`, `TaskGet`, `TaskList`를 제공합니다. 대신 레거시 `TodoWrite` 도구를 얻으려면 `0`으로 설정하세요. [작업 목록](/docs/ko/interactive-mode#task-list)을 참조하세요 |

232| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | 터미널이 지원하지만 자동 감지되지 않을 때 Claude의 응답에서 `~~text~~`에 대한 취소선 렌더링을 강제하려면 `1`로 설정합니다. SSH를 통해 `TERM_PROGRAM`이 전달되지 않는 경우와 같습니다. 이 없으면 감지되지 않은 터미널은 취소선으로 렌더링하는 대신 리터럴 `~~` 마커를 표시합니다. Claude Code v2.1.186 이상이 필요합니다. |287| `CLAUDE_CODE_ENABLE_TELEMETRY` | OpenTelemetry 데이터 수집을 메트릭 및 로깅에 대해 활성화하려면 `1`로 설정하세요. OTel 내보내기를 구성하기 전에 필수입니다. [모니터링](/docs/ko/monitoring-usage)을 참조하세요 |

233| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | 터미널이 지원하지만 자동 감지되지 않을 때 DEC 개인 모드 2026 [동기화된 출력](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036)을 강제로 활성화하려면 `1`로 설정합니다. Emacs `eat`과 같은 BSU/ESU를 구현하지만 기능 프로브에 응답하지 않는 에뮬레이터에 유용합니다. tmux에서는 효과가 없습니다. `CLAUDE_CODE_NO_FLICKER`와 달리 [전체 화면 렌더링](/docs/ko/fullscreen)으로 전환하지 않으므로 렌더러를 변경하지 않습니다. |288| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | 모든 모델에서 작업 추적 도구를 얻으려면 `1`로 설정하세요. 이것이 없으면, Claude Code는 기본적으로 [작업 도구 가용성](/docs/ko/tools-reference#task-tool-availability)에 나열된 모델에서만 제공합니다. `CLAUDE_CODE_ENABLE_TASKS`는 여전히 Task 도구 또는 `TodoWrite`를 선택합니다. Claude Code v2.1.233 이상이 필요합니다 |

234| `CLAUDE_CODE_FORK_SUBAGENT` | [포크된 subagent](/docs/ko/sub-agents#fork-the-current-conversation)를 모델의 기본값으로 만들려면 `1`로 설정하거나, 비활성화하려면 `0`으로 설정합니다. 서버 측 롤아웃을 재정의합니다. 활성화되면 Claude는 일반 목적 subagent를 사용하는 대신 포크를 생성합니다. 포크는 새로 시작하는 대신 전체 대화 컨텍스트를 상속하는 subagent이며, 모든 subagent 생성은 백그라운드에서 실행됩니다. 명시적 [`/fork`](/docs/ko/commands) 명령은 이 변수 없이도 작동합니다. 대화형 모드와 SDK 또는 `claude -p`를 통해 작동합니다. |289| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | 쿼리 루프가 유휴 상태가 된 후 자동으로 종료되기 전에 대기할 시간(밀리초)입니다. SDK 모드를 사용하는 자동화된 워크플로우 및 스크립트에 유용합니다 |

235| `CLAUDE_CODE_GIT_BASH_PATH` | Windows 전용: Git Bash 실행 파일(`bash.exe`)의 경로입니다. Git Bash가 설치되었지만 PATH에 없을 때 사용합니다. [Windows 설정](/docs/ko/setup#set-up-on-windows) 참조 |290| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | [에이전트 팀](/docs/ko/agent-teams)을 활성화하려면 `1`로 설정하세요. 에이전트 팀은 실험적이며 기본적으로 비활성화됩니다 |

236| `CLAUDE_CODE_GLOB_HIDDEN` | Claude가 [Glob 도구](/docs/ko/tools-reference#glob-tool-behavior)를 호출할 때 결과에서 dotfile을 제외하려면 `false`로 설정합니다. 기본적으로 포함됩니다. `@` 파일 자동 완성, `ls`, Grep 또는 Read에는 영향을 주지 않습니다. |291| `CLAUDE_CODE_EXTRA_BODY` | 모든 API 요청 본문의 최상위 수준으로 병합할 JSON 객체입니다. Claude Code가 직접 노출하지 않는 제공자 특정 매개변수를 전달하는 데 유용합니다. 셸에서 내보낸 값은 `claude agents` 또는 `--bg`로 디스패치하는 [백그라운드 세션](/docs/ko/agent-view)에도 적용됩니다. v2.1.206 이전에는 백그라운드 세션이 셸 내보낸 값을 무시하고 백그라운드 감독자 프로세스가 상속한 복사본을 사용했습니다 |

237| `CLAUDE_CODE_GLOB_NO_IGNORE` | [Glob 도구](/docs/ko/tools-reference#glob-tool-behavior)가 `.gitignore` 패턴을 존중하도록 하려면 `false`로 설정합니다. 기본적으로 Glob은 gitignored된 파일을 포함한 모든 일치하는 파일을 반환합니다. `@` 파일 자동 완성에는 영향을 주지 않으며, 이는 자체 [`respectGitignore` 설정](/docs/ko/settings#available-settings)을 가집니다. |292| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | 파일 읽기의 기본 토큰 제한을 재정의합니다. 전체 파일을 읽어야 할 때 유용합니다 |

238| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Glob 도구 파일 검색의 타임아웃(초). 대부분의 플랫폼에서 기본값은 20초이고 WSL에서는 60초입니다. |293| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | 다른 Claude Code 세션 내에서 시작된 경우에도 대화 기록 지속성, 프롬프트 기록, `claude agents` 등록을 강제하려면 `1`로 설정하세요. 상속된 `CLAUDE_CODE_CHILD_SESSION` 값(예: `screen` 세션 또는 Claude Code의 Bash 도구에 의해 먼저 시작된 백그라운드 런처)이 진정한 최상위 세션을 중첩된 것으로 잘못 분류할 때 사용합니다. v2.1.178부터 Claude Code는 tmux 경우를 자동으로 감지하고 상속된 마커를 무시하므로 tmux는 더 이상 이 변수가 필요하지 않습니다. 또한 v2.1.169 이하에서도 인정됩니다. v2.1.170 및 v2.1.171에서는 효과가 없습니다. 이는 중첩된 세션 감지가 제거되었습니다 |

239| `CLAUDE_CODE_HIDE_CWD` | 시작 로고에서 작업 디렉토리를 숨기려면 `1`로 설정합니다. 경로가 OS 사용자명을 노출하는 화면 공유 또는 녹화에 유용합니다. |294| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | 터미널이 지원하지만 SSH를 통해 `TERM_PROGRAM`이 전달되지 않는 경우와 같이 자동 감지되지 않을 때 Claude의 응답에서 `~~text~~`에 대한 취소선 렌더링을 강제하려면 `1`로 설정하세요. 이것이 없으면, 감지되지 않은 터미널은 취소선으로 렌더링하는 대신 리터럴 `~~` 마커를 표시합니다. Claude Code v2.1.186 이상이 필요합니다 |

240| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | IDE 확장에 연결하는 데 사용되는 호스트 주소를 재정의합니다. 기본적으로 Claude Code는 WSL-to-Windows 라우팅을 포함한 올바른 주소를 자동 감지합니다. |295| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | 터미널이 지원하지만 자동 감지되지 않을 때 DEC 개인 모드 2026 [동기화된 출력](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036)을 강제로 활성화하려면 `1`로 설정하세요. Emacs `eat`와 같이 BSU/ESU를 구현하지만 기능 프로브에 응답하지 않는 에뮬레이터에 유용합니다. tmux에서는 효과가 없습니다. `CLAUDE_CODE_NO_FLICKER`와 달리, 이는 [전체 화면 렌더링](/docs/ko/fullscreen)으로 전환하지 않습니다. 렌더러를 변경하지 않습니다 |

241| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | IDE 확장의 자동 설치를 건너뜁니다. [`autoInstallIdeExtension`](/docs/ko/settings#global-config-settings)을 `false`로 설정하는 것과 동일합니다. |296| `CLAUDE_CODE_FORK_SUBAGENT` | [포크 모드](/docs/ko/sub-agents#turn-fork-mode-on-or-off)를 제어합니다. 이는 Claude가 [포크된 서브에이전트](/docs/ko/sub-agents#fork-the-current-conversation)를 자신이 생성하도록 하며 대화형 세션에서만 기본적으로 켜져 있습니다. `claude -p` 및 Agent SDK에서도 켜려면 `1`로 설정하거나, 모든 종류의 세션에서 끄려면 `0`으로 설정하세요. 포크 모드가 켜져 있는지 여부에 관계없이 `/subtask`를 실행할 수 있습니다. 대화형 기본값에는 Claude Code v2.1.232 이상이 필요합니다. 이전 버전에서는 포크 모드를 켜려면 변수를 `1`로 설정하세요 |

242| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | 연결 중 IDE 잠금 파일 항목의 유효성 검사를 건너뛰려면 `1`로 설정합니다. 자동 연결이 실행 중인 IDE를 찾지 못할 때 사용합니다. |297| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | [서브에이전트](/docs/ko/sub-agents) 텍스트 및 사고 블록을 `claude -p --output-format stream-json` 출력에 내보내려면 `1`로 설정하세요. [`--forward-subagent-text`](/docs/ko/cli-reference#cli-flags) 플래그와 동일한 동작입니다. 하네스가 `claude`를 호출하고 플래그 자체를 전달할 수 없을 때 변수를 사용합니다. 플래그와 달리, 비대화형 모드에서 stream-json 출력 외부에서 오류로 종료되는 변수는 중첩된 호출이 설정되었을 때 계속 작동하도록 무시됩니다. Claude Code v2.1.211 이상이 필요합니다 |

243| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Claude Code가 활성 모델에 대해 가정하는 컨텍스트 윈도우 크기를 재정의합니다. v2.1.193부터 Claude Code가 Claude 모델로 인식하는 모델 이름에 대해 직접 적용됩니다. 인식된 Claude 모델의 경우 `DISABLE_COMPACT`도 설정되어 있을 때만 적용됩니다. `ANTHROPIC_BASE_URL`을 통해 이름의 기본 제공 크기와 일치하지 않는 컨텍스트 윈도우를 가진 모델로 라우팅할 때 사용합니다. |298| `CLAUDE_CODE_GIT_BASH_PATH` | Windows만 해당: Git Bash 실행 파일(`bash.exe`)의 경로입니다. Git Bash가 설치되었지만 PATH에 없을 때 사용합니다. 경로가 존재하지 않거나 파일이 `bash.exe`, `sh.exe`, `bash`, 또는 `sh`라는 이름이 아니면, Claude Code는 변수를 무시하고 `--debug`로 볼 수 있는 경고를 기록하면서 Git Bash를 자동 감지합니다. v2.1.219 이전에는 경로가 존재하지 않으면 Claude Code가 시작 시 종료되었고, bash 또는 sh인지 확인하지 않고 기존 파일을 셸로 사용했습니다. [Windows 설정](/docs/ko/setup#set-up-on-windows)을 참조하세요 |

244| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | 대부분의 요청에 대한 최대 출력 토큰 수를 설정합니다. 기본값 및 상한은 모델에 따라 다릅니다. [최대 출력 토큰](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) 참조. 이 값을 증가시키면 [자동 압축](/docs/ko/costs#reduce-token-usage)이 트리거되기 전에 사용 가능한 효과적인 컨텍스트 윈도우가 감소합니다. |299| `CLAUDE_CODE_GLOB_HIDDEN` | Claude가 [Glob 도구](/docs/ko/tools-reference#glob-tool-behavior)를 호출할 때 결과에서 숨김 파일을 제외하려면 `false`로 설정하세요. 기본적으로 포함됩니다. `@` 파일 자동 완성, `ls`, Grep, Read에는 영향을 주지 않습니다 |

245| `CLAUDE_CODE_MAX_RETRIES` | 실패한 API 요청을 재시도할 횟수를 재정의합니다(기본값: 10). v2.1.186부터 최대 15로 제한됩니다. v2.1.199부터 `CLAUDE_CODE_RETRY_WATCHDOG`이 기본값을 올리고 제한을 제거합니다. 더 긴 중단을 기다려야 하는 무인 세션의 경우 `CLAUDE_CODE_RETRY_WATCHDOG`을 대신 설정합니다. |300| `CLAUDE_CODE_GLOB_NO_IGNORE` | [Glob 도구](/docs/ko/tools-reference#glob-tool-behavior)가 `.gitignore` 패턴을 존중하도록 하려면 `false`로 설정하세요. 기본적으로 Glob은 gitignored 파일을 포함한 모든 일치 파일을 반환합니다. `@` 파일 자동 완성에는 영향을 주지 않습니다. 이는 자체 [`respectGitignore` 설정](/docs/ko/settings-reference#respectgitignore)을 가집니다 |

247| `CLAUDE_CODE_MAX_TURNS` | 명시적 제한이 전달되지 않을 때 에이전트 턴 수를 제한합니다. [`--max-turns`](/docs/ko/cli-reference#cli-flags) 전달과 동일하며, 둘 다 설정되면 우선합니다. 양의 정수가 아닌 값은 제한이 없는 것으로 취급되지 않고 오류와 함께 시작 시 거부됩니다. |302| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | 백그라운드 작업이 활성 목표를 대기 상태로 유지할 수 있는 시간(분)입니다. Claude Code가 [이를 확인하도록 요청](/docs/ko/goal#background-work-defers-evaluation)하기 전입니다. 기본값 `30`. 체크인을 끄려면 `0`으로 설정하세요. 일반 숫자로 전체 분을 제공하세요. 최대 `10080`(1주). Claude Code는 다른 값을 기본값으로 취급합니다. Claude Code v2.1.234 이상이 필요합니다 |

249| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | MCP 도구 호출의 유휴 타임아웃(밀리초). stdio, HTTP, SSE, WebSocket 또는 [claude.ai 커넥터](/docs/ko/mcp#use-mcp-servers-from-claude-ai) MCP 서버가 이 기간 동안 응답 및 진행 알림을 보내지 않으면 도구 호출이 오류로 중단됩니다. 네트워크 서버의 기본값은 300000(5분)이고 stdio 서버의 기본값은 1800000(30분)입니다. 유휴 확인을 비활성화하려면 `0`으로 설정합니다. 1000 미만의 값은 1초로 올라갑니다. 값은 유효한 `MCP_TOOL_TIMEOUT`으로 제한됩니다. `.mcp.json`의 서버별 `timeout`이 최소 1000이면 해당 서버의 유휴 윈도우를 최소 `timeout` 값으로 올립니다. IDE 서버 또는 SDK 인프로세스 서버에는 적용되지 않습니다. Claude Code v2.1.187 이상이 필요합니다. v2.1.203 이전에는 stdio 서버가 유휴 타임아웃에서 제외되었습니다. |304| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | IDE 확장에 연결하는 데 사용되는 호스트 주소를 재정의합니다. 기본적으로 Claude Code는 WSL-to-Windows 라우팅을 포함한 올바른 주소를 자동 감지합니다 |

250| `CLAUDE_CODE_NATIVE_CURSOR` | 터미널의 자체 커서를 입력 캐럿에서 그려진 블록 대신 표시하려면 `1`로 설정합니다. 커서는 터미널의 깜박임, 모양, 포커스 설정을 존중합니다. |305| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | IDE 확장의 자동 설치를 건너뛰려면 `1`로 설정하세요. [`autoInstallIdeExtension`](/docs/ko/settings-reference#autoinstallideextension)을 `false`로 설정하는 것과 동일합니다 |

251| `CLAUDE_CODE_NEW_INIT` | `/init`이 대화형 설정 흐름을 실행하도록 하려면 `1`로 설정합니다. 흐름은 코드베이스를 탐색하고 작성하기 전에 CLAUDE.md, skill 및 훅을 포함하여 생성할 파일을 묻습니다. 이 변수가 없으면 `/init`은 프롬프트 없이 자동으로 CLAUDE.md를 생성합니다. |306| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | 연결 중에 IDE 잠금 파일 항목의 유효성 검사를 건너뛰려면 `1`로 설정하세요. 자동 연결이 실행 중인 IDE를 찾지 못할 때 사용합니다 |

252| `CLAUDE_CODE_NO_FLICKER` | [전체 화면 렌더링](/docs/ko/fullscreen)을 활성화하려면 `1`로 설정합니다. 이는 깜박임을 줄이고 긴 대화에서 메모리를 평탄하게 유지하는 연구 미리보기입니다. [`tui`](/docs/ko/settings#available-settings) 설정과 동일합니다. `/tui fullscreen`으로도 전환할 수 있습니다. |307| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | 한 세션에서 [서브에이전트](/docs/ko/sub-agents#concurrent-subagent-limit)가 실행될 수 있는 최대 개수입니다. Agent 도구가 다른 것을 생성하기를 거부하기 전입니다(기본값: 20). 일반 숫자로 양의 정수를 허용합니다. 다른 것은 무시되므로 변수는 상한을 조정할 수 있지만 비활성화할 수 없습니다. Claude Code v2.1.217 이상이 필요합니다 |

253| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Claude.ai 인증용 OAuth 새로 고침 토큰입니다. 설정하면 `claude auth login`이 브라우저를 열지 않고 이 토큰을 직접 교환합니다. `CLAUDE_CODE_OAUTH_SCOPES`가 필요합니다. 자동화된 환경에서 인증을 프로비저닝하는 데 유용합니다. |308| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Claude Code가 활성 모델에 대해 가정하는 컨텍스트 창 크기를 재정의합니다. v2.1.193부터, 이것이 적용되는 방식은 Claude Code가 모델 ID를 확인하는 방식에 따라 다릅니다. [게이트웨이 또는 사용자 정의 모델 ID에 대한 창 수정](/docs/ko/model-config#correct-the-window-for-a-gateway-or-custom-model-id)을 참조하세요. `ANTHROPIC_BASE_URL`을 통해 컨텍스트 창이 이름의 기본 제공 크기와 일치하지 않는 모델로 라우팅할 때 사용합니다 |

254| `CLAUDE_CODE_OAUTH_SCOPES` | 새로 고침 토큰이 발급된 공백으로 구분된 OAuth 범위(예: `"user:profile user:inference user:sessions:claude_code"`). `CLAUDE_CODE_OAUTH_REFRESH_TOKEN`이 설정되면 필수입니다. |309| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | 대부분의 요청에 대한 최대 출력 토큰 수를 설정합니다. 기본값 및 상한은 모델에 따라 다릅니다. [최대 출력 토큰](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison)을 참조하세요. Claude Code는 인식하지 못하는 모델 ID(예: 게이트웨이 특정 이름)에 대해 기본값 32000을 설정하고 모델의 상한 이상의 값을 상한으로 낮춥니다. 이 값을 증가시키면 [자동 압축](/docs/ko/costs#reduce-token-usage)이 트리거되기 전에 사용 가능한 유효 컨텍스트 창이 감소합니다 |

255| `CLAUDE_CODE_OAUTH_TOKEN` | Claude.ai 인증용 OAuth 액세스 토큰입니다. `/login`의 대안으로 SDK 및 자동화된 환경에 사용됩니다. 키체인 저장 자격 증명보다 우선합니다. [`claude setup-token`](/docs/ko/authentication#generate-a-long-lived-token)으로 생성합니다. |310| `CLAUDE_CODE_MAX_RETRIES` | 실패한 API 요청을 재시도할 횟수를 재정의합니다(기본값: 10). v2.1.186부터 15로 제한됩니다. v2.1.199부터 `CLAUDE_CODE_RETRY_WATCHDOG`이 기본값을 올리고 상한을 제거합니다. 더 긴 중단을 기다려야 하는 무인 세션의 경우 대신 `CLAUDE_CODE_RETRY_WATCHDOG`을 설정하세요 |

256| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | v2.1.160에서 제거되었으며 이제 작동하지 않습니다. 이전에는 [빠른 모드](/docs/ko/fast-mode)를 Claude Opus 4.6에 고정했습니다. Opus 4.6은 더 이상 빠른 모드를 지원하지 않습니다. |311| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | v2.1.224에서 제거되었으며 이제 작동하지 않습니다. 이전에는 한 세션에서 Agent 도구로 Claude가 생성할 수 있는 [서브에이전트](/docs/ko/sub-agents)의 총 개수를 제한했습니다(기본값: 200). 상한을 초과하여 생성하면 `Subagent spawn limit reached`로 실패했습니다. [동시 서브에이전트 제한](/docs/ko/sub-agents#concurrent-subagent-limit) 및 [깊이 제한](/docs/ko/sub-agents#let-subagents-spawn-their-own-subagents)은 여전히 적용됩니다 |

257| `CLAUDE_CODE_OTEL_DIAG_STDERR` | OpenTelemetry 내보내기 진단 오류를 stderr에 쓰려면 `1`로 설정합니다. 기본적으로 이러한 오류는 `--debug`에서만 나타나므로 Prometheus 포트 충돌과 같은 잘못 구성된 내보내기는 그렇지 않으면 자동으로 실패합니다. Claude Code v2.1.179 이상이 필요합니다. [모니터링](/docs/ko/monitoring-usage) 참조 |312| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | [서브에이전트 계층](/docs/ko/sub-agents#let-subagents-spawn-their-own-subagents)의 수입니다. 주 대화 아래에서 허용됩니다 (기본값: 3). 기본값에서 서브에이전트는 자신의 서브에이전트를 생성할 수 있고, 세 번째 계층의 서브에이전트는 더 이상 생성할 수 없습니다. 중첩을 끄려면 `1`로 설정하세요. v2.1.217부터 v2.1.218까지 기본값은 1이었으므로 서브에이전트는 제한을 높이지 않으면 자신의 것을 생성할 수 없었습니다. v2.1.219는 기본값을 3으로 올렸습니다. 일반 숫자로 양의 정수를 허용합니다. 다른 것은 무시되므로 제한을 조정할 수 있지만 제거할 수 없습니다. Claude Code v2.1.217 이상이 필요합니다 |

258| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | 보류 중인 OpenTelemetry 스팬을 플러시하는 타임아웃(밀리초)(기본값: 5000). [모니터링](/docs/ko/monitoring-usage) 참조 |313| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | 읽기 전용 도구 및 서브에이전트가 병렬로 실행될 수 있는 최대 개수입니다(기본값: 10). 더 높은 값은 병렬 처리를 증가시키지만 더 많은 리소스를 소비합니다 |

259| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 동적 OpenTelemetry 헤더를 새로 고치는 간격(밀리초)(기본값: 1740000 / 29분). [동적 헤더](/docs/ko/monitoring-usage#dynamic-headers) 참조 |314| `CLAUDE_CODE_MAX_TURNS` | 명시적 제한이 전달되지 않을 때 에이전트 턴 수를 제한합니다. [`--max-turns`](/docs/ko/cli-reference#cli-flags)를 전달하는 것과 동일합니다. 둘 다 설정되면 플래그가 우선합니다. 양의 정수가 아닌 값은 상한이 없는 것으로 취급되지 않고 시작 시 오류로 거부됩니다 |

260| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | 종료 시 OpenTelemetry 내보내기가 완료되는 타임아웃(밀리초)(기본값: 2000). 메트릭이 종료 시 삭제되면 증가시킵니다. [모니터링](/docs/ko/monitoring-usage) 참조 |315| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | 한 세션이 만들 수 있는 [WebSearch](/docs/ko/tools-reference#websearch-tool-behavior) 호출의 총 개수에 대한 상한입니다(기본값: 200). Claude가 상한에 도달하면, 추가 WebSearch 호출은 이미 수집한 정보로 계속하도록 지시하는 알림을 반환합니다. 상한 없이 양의 정수를 허용합니다. 다른 것은 무시되고 기본값이 적용되므로 상한을 올릴 수 있지만 끌 수 없습니다. Claude Code v2.1.212 이상이 필요합니다 |

261| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | 새 버전을 사용할 수 있을 때 Claude Code가 백그라운드에서 패키지 관리자의 업그레이드 명령을 실행하도록 하려면 `1`로 설정합니다. Homebrew 및 WinGet 설치에 적용됩니다. 다른 패키지 관리자는 업그레이드 명령을 실행하지 않고 계속 표시합니다. [자동 업데이트](/docs/ko/setup#auto-updates) 참조 |316| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | stdio MCP 서버를 안전한 기본 환경과 서버의 구성된 `env`만으로 생성하려면 `1`로 설정하세요. 셸 환경을 상속하지 않습니다 |

262| `CLAUDE_CODE_PERFORCE_MODE` | Perforce 인식 쓰기 보호를 활성화하려면 `1`로 설정합니다. 설정하면 대상 파일이 소유자 쓰기 비트가 없으면 Edit, Write, NotebookEdit이 `p4 edit <file>` 힌트와 함께 실패합니다. Perforce는 `p4 edit`이 파일을 열 때까지 동기화된 파일에서 이를 지웁니다. 이는 Claude Code가 Perforce 변경 추적을 우회하지 않도록 방지합니다. |317| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | 여전히 실행 중인 MCP 도구 호출이 [백그라운드 작업](/docs/ko/mcp#automatic-backgrounding-of-long-tool-calls)으로 이동하기 전의 경과 시간(밀리초)입니다(기본값: 120000, 또는 2분). 자동 백그라운드 처리를 끄려면 `0`으로 설정하세요. Claude Code v2.1.212 이상이 필요합니다 |

263| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | 플러그인 루트 디렉토리를 재정의합니다. 이름과 달리 이는 캐시 자체가 아닌 부모 디렉토리를 설정합니다: 마켓플레이스 및 플러그인 캐시는 이 경로 아래의 하위 디렉토리에 있습니다. 기본값은 `~/.claude/plugins`입니다. |318| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | MCP 도구 호출의 밀리초 단위 유휴 타임아웃입니다. stdio, HTTP, SSE, WebSocket, 또는 [claude.ai 커넥터](/docs/ko/mcp#use-mcp-servers-from-claude-ai) MCP 서버가 이 시간 동안 응답이나 진행 알림을 보내지 않으면, 도구 호출은 전체 `MCP_TOOL_TIMEOUT`을 기다리는 대신 오류로 중단됩니다. 네트워크 서버의 300000(5분) 및 stdio 서버의 1800000(30분)의 전송별 기본값을 재정의합니다. 유휴 확인을 비활성화하려면 `0`으로 설정하세요. 1000 미만의 값은 1초로 올라가고, 값은 유효한 `MCP_TOOL_TIMEOUT`으로 제한됩니다. `.mcp.json`의 서버별 `timeout`이 최소 1000이면 해당 서버의 유휴 창을 최소 `timeout` 값으로 올립니다. IDE 서버 또는 SDK 인프로세스 서버에는 적용되지 않습니다. Claude Code v2.1.187 이상이 필요합니다. v2.1.203 이전에는 stdio 서버가 유휴 타임아웃에서 제외되었습니다 |

264| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | 플러그인을 설치하거나 업데이트할 때 git 작업의 타임아웃(밀리초)(기본값: 120000). 큰 리포지토리 또는 느린 네트워크 연결의 경우 이 값을 증가시킵니다. [Git 작업 시간 초과](/docs/ko/plugin-marketplaces#git-operations-time-out) 참조 |319| `CLAUDE_CODE_MESSAGING_SOCKET` | Claude Code에 의해 설정됨. 당신이 설정하지 않습니다: [수신함 소켓](/docs/ko/cross-session-messaging#the-sessions-inbox-socket)을 바인드하는 세션에서, Claude Code는 훅 및 Bash 명령에 해당 소켓의 경로를 내보냅니다. 메시징이 켜진 상태로 시작하는 세션에서 Claude Code는 훅이 실행되기 전에 소켓을 바인드합니다. 머신의 다른 세션이 이 경로로 메시지를 전달합니다. 각 세션은 부모에서 상속된 것이 아니라 자신의 소켓을 내보내고, 도착하는 메시지는 세션의 [인바운드 제어](/docs/ko/cross-session-messaging#control-inbound-messages)를 통과합니다. 설정 `env` 블록은 이를 설정할 수 없습니다. Claude Code v2.1.224 이상이 필요합니다 |

265| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | `git pull`이 실패할 때 기존 마켓플레이스 캐시를 유지하려면 `1`로 설정합니다. 다시 복제하면 같은 방식으로 실패할 오프라인 또는 에어갭 환경에서 유용합니다. [오프라인 환경에서 마켓플레이스 업데이트 실패](/docs/ko/plugin-marketplaces#marketplace-updates-fail-in-offline-environments) 참조 |320| `CLAUDE_CODE_MESSAGING_TOKEN` | Claude Code에 의해 설정됨. 당신이 설정하지 않습니다: [수신함 소켓](/docs/ko/cross-session-messaging#the-sessions-inbox-socket)을 바인드하는 세션에서, Claude Code는 이 세션별 토큰을 훅 및 Bash 명령과 함께 내보냅니다. 소켓에 게시하는 스크립트는 `{"type":"auth","token":"<token>"}` 첫 번째 줄로 세션에 속함을 증명할 수 있습니다. 기본 Windows에서 Claude Code는 이 줄을 요구하고 유효한 것으로 열지 않는 모든 연결을 닫습니다. [자신의 자식 규칙](/docs/ko/cross-session-messaging#the-sessions-inbox-socket)은 Claude Code가 토큰을 참조하는 시기를 말합니다. 각 세션은 부모 세션에서 상속된 것이 아니라 자신의 토큰을 내보냅니다. 설정 `env` 블록은 이를 설정할 수 없습니다. Claude Code v2.1.228 이상이 필요합니다 |

266| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | GitHub `owner/repo` 플러그인 소스를 SSH 대신 HTTPS를 통해 복제하려면 `1`로 설정합니다. CI 러너, 컨테이너 또는 `github.com`에 대해 구성된 SSH 키가 없는 모든 환경에서 유용합니다. |321| `CLAUDE_CODE_NATIVE_CURSOR` | 입력 캐럿에서 터미널의 자체 커서를 그려진 블록 대신 표시하려면 `1`로 설정하세요. 커서는 터미널의 깜박임, 모양, 포커스 설정을 존중합니다 |

267| `CLAUDE_CODE_PLUGIN_SEED_DIR` | 하나 이상의 읽기 전용 플러그인 시드 디렉토리의 경로이며, Unix에서는 `:`로, Windows에서는 `;`로 구분됩니다. 이를 사용하여 사전 채워진 플러그인 디렉토리를 컨테이너 이미지에 번들로 제공합니다. Claude Code는 시작 시 이러한 디렉토리에서 마켓플레이스를 등록하고 다시 복제하지 않고 사전 캐시된 플러그인을 사용합니다. [컨테이너용 플러그인 사전 채우기](/docs/ko/plugin-marketplaces#pre-populate-plugins-for-containers) 참조 |322| `CLAUDE_CODE_NEW_INIT` | `/init`이 대화형 설정 흐름을 실행하도록 하려면 `1`로 설정하세요. 흐름은 CLAUDE.md, 기술, 훅을 포함하여 생성할 파일을 묻고 코드베이스를 탐색한 후 작성합니다. 이 변수가 없으면 `/init`은 프롬프트 없이 CLAUDE.md를 자동으로 생성합니다 |

268| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Claude Code가 PowerShell을 생성할 때 `-ExecutionPolicy Bypass`를 전달하지 않으려면 `1`로 설정합니다. 도구 호출, 훅, 상태 줄 명령의 경우 대신 머신의 효과적인 실행 정책을 존중합니다. 기본적으로 Claude Code는 프로세스 범위에서 실행 정책을 우회하므로 `.ps1` 스크립트 및 모듈 가져오기가 기본 제한 Windows 설치에서 작동합니다. 프로세스 범위 우회는 이 설정과 관계없이 Group Policy `MachinePolicy` 또는 `UserPolicy`를 재정의하지 않습니다. |323| `CLAUDE_CODE_NONBLOCKING_STDOUT` | 터미널 출력을 두 번째 비차단 파일 설명자를 통해 작성하려면 `1`로 설정하세요. 일시 중지된 tmux 제어 모드 창이나 정지된 SSH 연결과 같이 읽기를 중지하는 터미널이 세션 중간에 Claude Code를 동결할 수 없습니다. macOS, Linux, WSL에서 stdout이 터미널일 때 적용됩니다. Claude Code v2.1.261 이상이 필요합니다 |

269| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | }[비대화형 모드](/docs/ko/headless#background-tasks-at-exit)에서 `-p` 플래그를 사용하여 최종 턴 후 결과가 출력의 일부인 백그라운드 subagent 및 워크플로우를 기다리는 최대 시간(밀리초). 기본값: `600000`, 또는 10분. 제한을 초과하면 남은 백그라운드 작업이 종료되고 프로세스가 종료됩니다. 일반 백그라운드 셸에 적용되는 5초 유예 기간과는 별개입니다. `0`으로 설정하여 무한정 대기합니다. |324| `CLAUDE_CODE_NO_FLICKER` | [전체 화면 렌더링](/docs/ko/fullscreen)을 활성화하려면 `1`로 설정하세요. 깜박임을 줄이고 긴 대화에서 메모리를 평평하게 유지하는 연구 미리보기입니다. [`tui`](/docs/ko/settings-reference#tui) 설정을 재정의합니다. `/tui fullscreen`으로도 전환할 수 있습니다 |

270| `CLAUDE_CODE_PROCESS_WRAPPER` | {{/* min-version: 2.1.208 */}}Claude Code가 자신의 바이너리에서 시작하는 프로세스를 `/opt/corp/launcher`와 같은 argv 접두사로 래퍼 실행 파일을 통해 시작하려면 설정합니다. [에이전트 보기](/docs/ko/agent-view) 세션을 호스팅하는 백그라운드 서비스, 이를 생성하는 모든 세션, 업데이트 설치를 완료하기 위해 Claude Code가 자신을 다시 시작하는 것을 포함합니다. 첫 번째 토큰은 `exec "$@"`로 실행을 끝내는 실행 파일의 절대 경로여야 하며, 대부분의 런처는 해당 단일 경로입니다. 값은 셸 명령이 아닌 인수 목록입니다: 공백은 토큰을 구분하고, 큰따옴표는 공백을 포함하는 경로를 그룹화하며, `[`로 시작하는 값은 JSON 문자열 배열로 읽습니다. 사용자 또는 [관리 설정](/docs/ko/permissions#managed-settings)의 `env` 블록에서 설정합니다. 프로젝트 및 로컬 설정은 이를 설정할 수 없습니다. VS Code 확장은 자신의 `claudeProcessWrapper` 설정을 통해 자신의 런처를 별도로 구성합니다. Windows에서는 무시됩니다. `CLAUDE_CODE_SHELL_PREFIX`는 별도의 제어입니다: 이는 Claude Code가 실행하는 셸 명령을 단일 인용 문자열로 래핑하는 반면, 이 변수는 Claude Code의 자신의 프로세스를 argv 접두사로 래핑합니다. [기업 런처 뒤에서 Claude Code 실행](/docs/ko/corporate-launcher) 참조 |325| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Claude.ai 인증을 위한 OAuth 새로 고침 토큰입니다. 설정되면, `claude auth login`은 브라우저를 열지 않고 이 토큰을 직접 교환합니다. `CLAUDE_CODE_OAUTH_SCOPES`가 필요합니다. 자동화된 환경에서 인증을 제공하는 데 유용합니다 |

271| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | }`ANTHROPIC_BASE_URL`이 사용자 정의 프록시를 가리킬 때 W3C 추적 컨텍스트를 전파하려면 `1`로 설정합니다. 전파는 모델 및 HTTP MCP 요청의 `traceparent` 헤더와 Bash, PowerShell, 훅 subprocess의 `TRACEPARENT` 환경 변수를 포함합니다. 기본적으로 전파는 Anthropic API에 직접 연결할 때만 활성화됩니다. v2.1.152에서 추가됨. [추적(베타)](/docs/ko/monitoring-usage#traces-beta) 참조 |326| `CLAUDE_CODE_OAUTH_SCOPES` | 새로 고침 토큰이 발급된 공백으로 구분된 OAuth 범위입니다(예: `"user:profile user:inference user:sessions:claude_code"`). `CLAUDE_CODE_OAUTH_REFRESH_TOKEN`이 설정되면 필수입니다 |

272| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Claude Code를 포함하고 대신 모델 공급자 라우팅을 관리하는 호스트 플랫폼에서 설정합니다. 설정하면 설정 파일의 `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL`, `ANTHROPIC_API_KEY`와 같은 공급자 선택, 엔드포인트, 인증 변수가 무시되므로 사용자 설정이 호스트의 라우팅을 재정의할 수 없습니다. Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry에 대한 자동 원격 분석 옵트아웃도 건너뛰므로 원격 분석은 표준 `DISABLE_TELEMETRY` 옵트아웃을 따릅니다. [API 공급자별 기본 동작](/docs/ko/data-usage#default-behaviors-by-api-provider) 참조 |327| `CLAUDE_CODE_OAUTH_TOKEN` | claude.ai 인증을 위한 OAuth 액세스 토큰입니다. SDK 및 자동화된 환경의 `/login`에 대한 대안입니다. 키체인 저장 자격 증명보다 우선합니다. [`claude setup-token`](/docs/ko/authentication#generate-a-long-lived-token)으로 생성하세요. [`/login`](/docs/ko/authentication#authentication-precedence)을 실행하지 않으면, Claude Code는 전체 세션에 대해 설정한 토큰을 사용합니다. 만료된 토큰을 교체하려면 새 토큰을 생성하고 다시 시작하세요 |

273| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | 호출자 대신 프록시가 DNS 해석을 수행하도록 허용하려면 `1`로 설정합니다. 프록시가 호스트명 해석을 처리해야 하는 환경에 대해 옵트인합니다. |328| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | v2.1.160에서 제거되었으며 이제 작동하지 않습니다. 이전에는 [빠른 모드](/docs/ko/fast-mode)를 현재 기본값 대신 Claude Opus 4.6으로 고정했습니다. Opus 4.6은 더 이상 빠른 모드를 지원하지 않습니다 |

274| `CLAUDE_CODE_REMOTE` | Claude Code가 [클라우드 세션](/docs/ko/claude-code-on-the-web)으로 실행 중일 때 자동으로 `true`로 설정됩니다. 훅 또는 설정 스크립트에서 이를 읽어 클라우드 환경에 있는지 감지합니다. |329| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | 콘텐츠 베어링 OpenTelemetry 속성(모델 응답, 도구 콘텐츠, 시스템 프롬프트, 원본 API 본문)의 최대 길이입니다. 잘림 마커 포함. UTF-16 코드 단위(기본값: 61440, 즉 60KB). 원격 분석 백엔드가 64KB보다 큰 속성 값을 허용하는 경우에만 올리거나, 원격 분석 볼륨을 줄이려면 낮추세요. Claude Code v2.1.214 이상이 필요합니다. [모니터링](/docs/ko/monitoring-usage)을 참조하세요 |

275| `CLAUDE_CODE_REMOTE_SESSION_ID` | [클라우드 세션](/docs/ko/claude-code-on-the-web)에서 현재 세션의 ID로 자동으로 설정됩니다. 세션 트랜스크립트로 다시 연결하는 링크를 구성하려면 이를 읽습니다. [세션으로 출력 다시 연결](/docs/ko/claude-code-on-the-web#link-output-back-to-the-session) 참조 |330| `CLAUDE_CODE_OTEL_DIAG_STDERR` | OpenTelemetry 내보내기 진단 오류를 stderr에 작성하려면 `1`로 설정하세요. 기본적으로 이러한 오류는 `--debug`에서만 나타나므로 Prometheus 포트 충돌과 같이 잘못 구성된 내보내기는 그렇지 않으면 자동으로 실패합니다. Claude Code v2.1.179 이상이 필요합니다. [모니터링](/docs/ko/monitoring-usage)을 참조하세요 |

276| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | 이전 세션이 중간에 끝난 경우 자동으로 재개하려면 `1`로 설정합니다. SDK 모드에서 사용되므로 모델이 SDK가 프롬프트를 다시 전송할 필요 없이 계속됩니다. |331| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | 보류 중인 OpenTelemetry 스팬을 플러시하기 위한 타임아웃(밀리초)(기본값: 5000). [모니터링](/docs/ko/monitoring-usage)을 참조하세요 |

277| `CLAUDE_CODE_RESUME_PROMPT` | 세션이 중간에 끝난 후 재개할 때 주입되는 계속 메시지를 재정의합니다. 기본값은 `Continue from where you left off.`입니다. 장시간 실행되는 에이전트의 스폰 스크립트는 이를 더 지시적인 부팅 메시지로 설정할 수 있습니다. 빈 문자열은 기본값을 사용합니다. |332| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 동적 OpenTelemetry 헤더를 새로 고치기 위한 간격(밀리초)(기본값: 1740000 / 29분). [동적 헤더](/docs/ko/monitoring-usage#dynamic-headers)를 참조하세요 |

278| `CLAUDE_CODE_RETRY_WATCHDOG` | 평가 하네스, CI 작업 또는 원격 작업자와 같은 무인 세션의 경우 `1`로 설정합니다. `429` 및 `529` 용량 오류를 `CLAUDE_CODE_MAX_RETRIES` 시도 후 실패하는 대신 무한정 재시도합니다. 감시견은 시도 사이에 최대 5분까지 백오프하거나 응답이 속도 제한 재설정 시간을 전달할 때 제한이 재설정될 때까지 대기합니다. 사용량 제한에 도달한 세션은 남은 윈도우를 기다립니다. v2.1.199부터 서버 오류, 타임아웃, 끊어진 연결과 같은 다른 일시적 오류에 대한 기본 재시도 횟수를 약 3시간의 백오프인 300으로 올리고 `CLAUDE_CODE_MAX_RETRIES`를 명시적으로 설정하면 15의 제한을 제거합니다. Claude Code v2.1.186 이상이 필요합니다. |333| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | 종료 시 OpenTelemetry 내보내기가 완료되기 위한 타임아웃(밀리초)(기본값: 2000). 종료 시 메트릭이 삭제되면 증가시키세요. [모니터링](/docs/ko/monitoring-usage)을 참조하세요 |

279| `CLAUDE_CODE_SAFE_MODE` | 안전 모드에서 시작하려면 `1`로 설정합니다: CLAUDE.md, skill, 플러그인, 훅, MCP 서버, 사용자 정의 명령 및 에이전트, 출력 스타일, 워크플로우, 사용자 정의 테마, 사용자 정의 키 바인딩, 상태 줄 및 파일 제안 명령, LSP 서버, 자동 메모리는 로드되지 않습니다. 손상된 구성을 문제 해결하기 위해. 관리 설정 정책은 여전히 적용되며, 정책 구성 훅, 상태 줄, 파일 제안 명령을 포함합니다. 관리 플러그인, 관리 skill, 관리 CLAUDE.md, 정책 구성 MCP 서버는 로드되지 않습니다. [`--safe-mode`](/docs/ko/cli-reference#cli-flags) 전달과 동일합니다. 직접 생성된 자식 프로세스는 변수를 상속합니다. |334| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | 새 버전을 사용할 수 있을 때 Claude Code가 백그라운드에서 패키지 관리자의 업그레이드 명령을 실행하도록 하려면 `1`로 설정하세요. Homebrew 및 WinGet 설치에 적용됩니다. 다른 패키지 관리자는 업그레이드 명령을 실행하지 않고 계속 표시합니다. [자동 업데이트](/docs/ko/setup#auto-updates)를 참조하세요 |

280| `CLAUDE_CODE_SCRIPT_CAPS` | `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`이 설정되었을 때 세션당 특정 스크립트를 호출할 수 있는 횟수를 제한하는 JSON 객체입니다. 키는 명령 텍스트에 대해 일치하는 부분 문자열입니다. 값은 정수 호출 제한입니다. 예를 들어 `{"deploy.sh": 2}`는 `deploy.sh`를 최대 2번 호출할 수 있습니다. 일치는 부분 문자열 기반이므로 `./scripts/deploy.sh $(evil)`과 같은 셸 확장 트릭도 여전히 제한에 포함됩니다. `xargs` 또는 `find -exec`을 통한 런타임 팬아웃은 감지되지 않습니다. 이는 심층 방어 제어입니다. |335| `CLAUDE_CODE_PERFORCE_MODE` | Perforce 인식 쓰기 보호를 활성화하려면 `1`로 설정하세요. 설정되면, Edit, Write, NotebookEdit은 대상 파일이 소유자 쓰기 비트가 없으면 `p4 edit <file>` 힌트로 실패합니다. Perforce는 `p4 edit`이 열 때까지 동기화된 파일에서 이를 지웁니다. 이는 Claude Code가 Perforce 변경 추적을 우회하지 않도록 합니다 |

281| `CLAUDE_CODE_SCROLL_SPEED` | [전체 화면 렌더링](/docs/ko/fullscreen#mouse-wheel-scrolling)에서 마우스 휠 스크롤 배수를 설정합니다. 1부터 20까지의 값을 허용합니다. 그리고 `0.5`와 같은 1 미만의 분수 값을 허용하여 터미널의 기본 스크롤 경로에서 가속 트랙패드 및 휠 스크롤을 느리게 합니다. 터미널이 증폭 없이 노치당 하나의 휠 이벤트를 보내는 경우 `vim`과 일치하도록 `3`으로 설정합니다. JetBrains IDE 터미널에서는 무시되며, Claude Code는 자체 스크롤 처리를 사용합니다. |336| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | 플러그인 루트 디렉토리를 재정의합니다. 이름에도 불구하고, 이는 캐시 자체가 아니라 부모 디렉토리를 설정합니다: 마켓플레이스 및 플러그인 캐시는 이 경로 아래의 하위 디렉토리에 있습니다. 기본값은 `~/.claude/plugins`입니다 |

282| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | [SessionEnd](/docs/ko/hooks#sessionend) 훅의 시간 예산(밀리초)을 재정의합니다. 세션 종료, `/clear`, 대화형 `/resume`을 통한 세션 전환에 적용됩니다. 기본적으로 예산은 1.5초이며, 설정 파일에서 구성된 가장 높은 훅별 `timeout`으로 자동으로 올라가며, 최대 60초입니다. 플러그인 제공 훅의 타임아웃은 예산을 올리지 않습니다. |337| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | 플러그인을 설치하거나 업데이트할 때 git 작업의 타임아웃(밀리초)(기본값: 120000). 큰 리포지토리 또는 느린 네트워크 연결의 경우 이 값을 증가시키세요. [Git 작업 타임아웃](/docs/ko/plugin-marketplaces#git-operations-time-out)을 참조하세요 |

283| `CLAUDE_CODE_SESSION_ID` | Bash 및 PowerShell 도구 subprocess에서 현재 세션 ID로 자동으로 설정됩니다. [훅](/docs/ko/hooks) 명령 subprocess 및 stdio [MCP 서버](/docs/ko/mcp) subprocess에서도 설정됩니다. [훅](/docs/ko/hooks)에 전달된 `session_id` 필드와 일치합니다. `/clear`에서 업데이트됩니다. MCP 서버 subprocess는 생성될 때 ID를 유지하며, `--resume <session-id>`에서 재개된 ID를 받습니다. `--continue` 또는 명시적 ID 없이 `--resume`에서 초기 시작 ID를 받을 수 있습니다. 스크립트 및 외부 도구를 Claude Code 세션과 연관시키는 데 사용합니다. |338| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | `git pull`이 실패할 때 다시 복제 시도를 건너뛰고 기존 마켓플레이스 캐시를 계속 사용하려면 `1`로 설정하세요. 다시 복제가 같은 방식으로 실패할 오프라인 또는 에어갭 환경에서 유용합니다. [마켓플레이스 업데이트가 오프라인 환경에서 실패](/docs/ko/plugin-marketplaces#marketplace-updates-fail-in-offline-environments)를 참조하세요 |

284| `CLAUDE_CODE_SHELL` | Claude Code가 Bash 도구 명령을 실행하는 데 사용하는 셸을 설정합니다. `bash` 또는 `zsh` 바이너리의 경로를 허용합니다(예: `/opt/homebrew/bin/bash`). `fish`와 같은 다른 셸은 지원되지 않습니다. 값이 작동하는 `bash` 또는 `zsh` 경로가 아니면 Claude Code는 이를 무시하고 자동 감지로 돌아갑니다. 자동 감지는 `bash` 또는 `zsh`를 가리킬 때 `$SHELL`을 사용하고, 그렇지 않으면 PATH 및 표준 설치 위치에서 찾은 첫 번째 작동 `zsh`를 선택한 다음 `bash`를 선택합니다. |339| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | GitHub `owner/repo` 단축 소스를 SSH 대신 HTTPS를 통해 복제하려면 `1`로 설정하세요. 플러그인 설치 및 업데이트, `/plugin marketplace add` 및 `update`에 적용됩니다. CI 러너, 컨테이너, 또는 `github.com`에 대해 구성된 SSH 키가 없는 환경에서 유용합니다 |

285| `CLAUDE_CODE_SHELL_PREFIX` | Claude Code가 생성하는 모든 셸 명령을 래핑할 명령 접두사: Bash 도구 호출, [훅](/docs/ko/hooks) 명령, [상태 줄](/docs/ko/statusline) 명령, stdio [MCP 서버](/docs/ko/mcp) 시작 명령. PowerShell 훅 및 exec 형식 훅은 접두사 없이 실행됩니다. 로깅 또는 감사에 유용합니다. 예: `/path/to/logger.sh`와 같은 실행 파일 경로를 설정하면 각 명령을 `/path/to/logger.sh '<command>'`로 실행합니다. 래퍼는 명령줄을 `$1`의 단일 셸 인용 인수로 받으므로 래퍼는 `$1`을 셸로 다시 평가해야 합니다(예: `exec bash -c "$1"`). `$1`을 실행 파일 경로로 취급하면 `npx -y <package>`와 같은 인수를 전달하는 stdio MCP 서버가 손상됩니다. Bash 도구 호출의 경우 `$1`에는 Claude Code가 조립하는 전체 셸 호출이 포함되며, Claude가 실행한 명령만이 아닙니다. |340| `CLAUDE_CODE_PLUGIN_SEED_DIR` | 하나 이상의 읽기 전용 플러그인 시드 디렉토리의 경로입니다. Unix에서는 `:`로, Windows에서는 `;`로 구분됩니다. 미리 채워진 플러그인 디렉토리를 컨테이너 이미지에 번들로 묶으려면 이를 사용합니다. Claude Code는 시작 시 이러한 디렉토리에서 마켓플레이스를 등록하고 다시 복제하지 않고 미리 캐시된 플러그인을 사용합니다. [컨테이너용 플러그인 미리 채우기](/docs/ko/plugin-marketplaces#pre-populate-plugins-for-containers)를 참조하세요 |

286| `CLAUDE_CODE_SIMPLE` | 최소 시스템 프롬프트 및 Bash, 파일 읽기, 파일 편집 도구만으로 실행하려면 `1`로 설정합니다. `--mcp-config`의 MCP 도구는 계속 사용 가능합니다. 훅, skill, 플러그인, MCP 서버, 자동 메모리, CLAUDE.md의 자동 검색을 비활성화합니다. OAuth 토큰 및 키체인 자격 증명은 읽지 않으므로 Anthropic 인증은 `ANTHROPIC_API_KEY` 또는 `--settings`의 `apiKeyHelper`에서 와야 합니다. [`--bare`](/docs/ko/headless#start-faster-with-bare-mode) 전달과 동일합니다. |341| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | 도구 호출, 훅, 상태 줄 명령을 위해 PowerShell을 생성할 때 Claude Code가 `-ExecutionPolicy Bypass`를 전달하지 않도록 하려면 `1`로 설정하세요. 대신 머신의 유효한 실행 정책을 존중합니다. 기본적으로 Claude Code는 프로세스 범위에서 실행 정책을 우회하므로 `.ps1` 스크립트 및 모듈 가져오기가 기본 제한 Windows 설치에서 작동합니다. 프로세스 범위 우회는 이 설정에 관계없이 Group Policy `MachinePolicy` 또는 `UserPolicy`를 재정의하지 않습니다 |

287| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | 모든 모델에서 더 짧은 시스템 프롬프트 및 축소된 도구 설명을 사용하려면 `1`로 설정합니다. `0`, `false`, `no`, 또는 `off`로 설정하여 실험 또는 서버 구성이 그렇지 않으면 활성화할 때에도 옵트아웃합니다. 전체 도구 세트, 훅, MCP 서버, CLAUDE.md 검색은 계속 활성화됩니다. |342| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | [비대화형 모드](/docs/ko/headless#background-tasks-at-exit)에서 `-p` 플래그를 사용한 최종 턴 후 백그라운드 서브에이전트 및 워크플로우를 기다리는 유휴 대기의 밀리초 단위 상한입니다. 유휴 대기는 Claude가 백그라운드 결과를 처리하기 위해 턴을 할 때마다 다시 시작됩니다. 기본값: `600000`, 또는 10분. 유휴 대기가 상한에 도달하면, Claude Code는 나머지 백그라운드 작업을 기다리는 것을 중지하고 종료합니다. 무한정 기다리려면 `0`으로 설정하세요. 이 상한은 일반 백그라운드 셸에 적용되는 5초 유예 기간과는 별개입니다. Claude Code v2.1.182 이상이 필요합니다 |

288| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | [Claude Platform on AWS](/docs/ko/claude-platform-on-aws)에 대한 클라이언트 측 인증을 건너뜁니다. 게이트웨이가 요청에 자체 서명하는 경우 |343| `CLAUDE_CODE_PROCESS_WRAPPER` | [에이전트 보기](/docs/ko/agent-view)를 호스팅하는 백그라운드 서비스와 같이 Claude Code가 자신의 바이너리에서 시작하는 프로세스를 `/opt/corp/launcher`와 같은 argv 접두사로 주어진 기업 런처를 통해 시작하려면 설정하세요. 사용자 또는 [관리 설정](/docs/ko/managed-settings)의 `env` 블록에서 설정하세요. 프로젝트 및 로컬 설정은 이를 설정할 수 없습니다. [`processWrapper` 설정](/docs/ko/settings-reference#processwrapper)과 동등합니다. Claude Code v2.1.210 이상이 필요합니다. 둘 다 설정되면 이 변수가 우선합니다. VS Code 확장은 자신의 `claudeProcessWrapper` 설정을 통해 자신의 런처를 별도로 구성합니다. Windows에서는 무시됩니다. [기업 런처 뒤에서 Claude Code 실행](/docs/ko/corporate-launcher)에서 값 형식, 런처가 적용되는 것, 런처가 만족해야 하는 계약을 참조하세요. Claude Code v2.1.208 이상이 필요합니다 |

289| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | {{/* min-version: 2.1.207 */}}AWS 기본 자격 증명 공급자 체인에서 해결된 자격 증명의 인프로세스 캐시를 끄려면 `1`로 설정합니다. Claude Code는 모든 API 요청에서 체인을 해결합니다. SSO 지원 프로필은 모든 요청에서 IAM Identity Center에 자격 증명을 요청합니다. [자격 증명 캐싱 및 해결 타임아웃](/docs/ko/amazon-bedrock#credential-caching-and-resolution-timeout) 참조. Claude Code v2.1.207 이상이 필요합니다. |344| `CLAUDE_CODE_PROJECT_DIR_NAME` | `CLAUDE_CONFIG_DIR`과 함께 설정하여 Claude Code가 해당 세션의 대화 기록 및 자동 메모리를 저장하는 `projects/` 디렉토리 이름을 선택합니다. 작업 디렉토리 경로에서 파생된 것 대신입니다. 예를 들어, `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude`로 Claude Code를 시작하면 `/srv/tenant-a/projects/work/` 아래에 저장합니다. `CLAUDE_CONFIG_DIR`이 설정되지 않으면 Claude Code는 이 변수를 무시합니다. `claude`를 시작하는 환경에서만 읽습니다. 설정 파일 `env` 블록에서는 읽지 않습니다. [프로젝트 디렉토리 이름 직접 지정](/docs/ko/sessions#name-the-project-directory-yourself)을 참조하세요. Claude Code v2.1.234 이상이 필요합니다 |

290| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Amazon Bedrock에 대한 AWS 인증을 건너뜁니다(예: LLM 게이트웨이를 사용할 때). |345| `CLAUDE_CODE_PROMPT_CACHE_TTL` | `5m` 또는 `1h`를 설정합니다. Claude Code가 허용하는 유일한 값입니다. 주 대화에 대한 [프롬프트 캐시 TTL](/docs/ko/prompt-caching#cache-lifetime)을 선택합니다: 대화형, `-p`, SDK 턴, 그리고 이들과 함께 인라인으로 실행되는 도우미. `promptCacheTtl` 설정 및 `ENABLE_PROMPT_CACHING_1H`보다 우선합니다. `FORCE_PROMPT_CACHING_5M`이 이를 재정의합니다. API는 1시간 캐시 쓰기를 더 높은 속도로 청구합니다. Claude Code v2.1.242 이상이 필요합니다 |

291| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Microsoft Foundry에 대한 Azure 인증을 건너뜁니다(예: LLM 게이트웨이를 사용할 때). Claude Code는 요청을 Azure 자격 증명 없이 전송하고 `ANTHROPIC_CUSTOM_HEADERS`를 통해 제공하는 것과 같은 `Authorization` 헤더를 유지합니다. `ANTHROPIC_FOUNDRY_API_KEY` 또는 `ANTHROPIC_FOUNDRY_AUTH_TOKEN`이 설정되면 무시됩니다. v2.1.203 이전에는 이 변수가 API 키도 설정되지 않으면 Microsoft Foundry 클라이언트가 요청을 보낼 수 없게 했습니다. |346| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | `ANTHROPIC_BASE_URL`이 사용자 정의 프록시를 가리킬 때 W3C 추적 컨텍스트를 전파하려면 `1`로 설정하세요. 전파는 모델 및 HTTP MCP 요청의 `traceparent` 헤더와 Bash, PowerShell, 훅 서브프로세스의 `TRACEPARENT` 환경 변수를 포함합니다. 기본적으로 전파는 Anthropic API에 직접 연결할 때만 활성화됩니다. v2.1.152에서 추가되었습니다. [추적(베타)](/docs/ko/monitoring-usage#traces-beta)을 참조하세요 |

292| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Amazon Bedrock Mantle에 대한 AWS 인증을 건너뜁니다(예: LLM 게이트웨이를 사용할 때). |347| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Claude Code를 포함하고 자신을 대신하여 모델 제공자 라우팅을 관리하는 호스트 플랫폼에 의해 설정됩니다. 설정되면, Claude Code는 설정 파일에서 `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL`, `ANTHROPIC_API_KEY`와 같은 제공자 선택, 엔드포인트, 인증 변수를 무시합니다. 사용자 설정이 호스트의 라우팅을 재정의할 수 없습니다. Claude Code는 또한 [관리 설정](/docs/ko/managed-settings)에서 `model`, `fallbackModel`, `modelOverrides`와 같은 모델 선택 키를 무시합니다. 어느 관리 소스가 전달하든 호스트의 모델 구성이 오래된 관리 모델 핀보다 우선합니다. Claude Code는 또한 관리 `env` 블록에서 `ANTHROPIC_MODEL` 및 `ANTHROPIC_DEFAULT_*_MODEL` 계열과 같은 모델 선택 변수를 무시합니다. 관리 설정의 [`availableModels`](/docs/ko/model-config#restrict-model-selection) 허용 목록은 호스트가 자신의 것을 제공하지 않으면 여전히 적용됩니다. Claude Code는 또한 Amazon Bedrock, AWS의 Claude Platform, Google Cloud의 Agent Platform, Microsoft Foundry와 같은 타사 제공자에 적용하는 자동 원격 분석 옵트아웃을 건너뜁니다. 따라서 원격 분석은 표준 `DISABLE_TELEMETRY` 옵트아웃을 따릅니다. [API 제공자별 기본 동작](/docs/ko/data-usage#default-behaviors-by-api-provider)을 참조하세요 |

293| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | 프롬프트 기록 및 세션 트랜스크립트를 디스크에 쓰지 않으려면 `1`로 설정합니다. 이 변수로 시작된 세션은 `--resume`, `--continue` 또는 위쪽 화살표 기록에 나타나지 않습니다. 임시 스크립트 세션에 유용합니다. |348| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | 프록시가 호출자 대신 DNS 확인을 수행하도록 하려면 `1`로 설정하세요. 프록시가 호스트 이름 확인을 처리해야 하는 환경에 대한 옵트인입니다 |

294| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Google Cloud's Agent Platform에 대한 Google 인증을 건너뜁니다(예: LLM 게이트웨이를 사용할 때). |349| `CLAUDE_CODE_REMOTE` | Claude Code가 [클라우드 세션](/docs/ko/claude-code-on-the-web)으로 실행 중일 때 자동으로 `true`로 설정됩니다. 훅 또는 설정 스크립트에서 이를 읽어 클라우드 세션에 있는지 감지합니다 |

295| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | [Stop](/docs/ko/hooks#stop) 또는 [SubagentStop](/docs/ko/hooks#subagentstop) 훅이 턴 종료를 차단할 수 있는 최대 연속 횟수입니다(기본값: 8). Claude Code가 턴을 어쨌든 종료하기 전입니다. `0`으로 설정하여 제한을 비활성화합니다. 훅이 해결하기 위해 더 많은 반복이 필요하면 이를 올립니다. |350| `CLAUDE_CODE_REMOTE_SESSION_ID` | [클라우드 세션](/docs/ko/claude-code-on-the-web)에서 현재 세션의 ID로 자동으로 설정됩니다. 세션 대화 기록으로 다시 연결하는 링크를 구성하려면 이를 읽으세요. [세션으로 출력 다시 연결](/docs/ko/cloud-environments#link-output-back-to-the-session)을 참조하세요 |

296| `CLAUDE_CODE_SUBAGENT_MODEL` | [모델 구성](/docs/ko/model-config) 참조 v2.1.196부터 `inherit`로 설정하는 것은 설정하지 않은 것과 동일합니다. 이전 버전은 `inherit`를 모든 subagent를 주 대화의 모델로 강제하는 재정의로 취급했습니다. |351| `CLAUDE_CODE_RESTRICTED` | 세션을 제한된 모드로 시작하려면 `1`로 설정하세요. [`--restricted`](/docs/ko/cli-reference#cli-flags)를 전달하는 것과 동일합니다. Claude Code는 설정 파일의 `env` 블록에서 이 변수를 무시합니다. Claude Code v2.1.248 이상이 필요합니다 |

297| `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`이 자동으로 이를 설정합니다. |352| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | 이전 세션이 턴 중간에 끝났으면 자동으로 재개하려면 `1`로 설정하세요. SDK 모드에서 사용되므로 모델이 SDK가 프롬프트를 다시 보낼 필요 없이 계속됩니다. 이를 끄려면 변수를 설정 해제하거나 `0`으로 설정하세요. v2.1.221 이전에는 Claude Code가 `0` 및 기타 거짓 값을 무시했으므로 비대화형 모드에서 `0`을 설정하면 여전히 재개가 트리거되었고 변수를 설정 해제하는 것이 끄는 유일한 방법이었습니다 |

298| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | 비대화형 모드(`-p` 플래그)에서 첫 번째 쿼리 전에 플러그인 설치가 완료될 때까지 대기하려면 `1`로 설정합니다. 이 없으면 플러그인이 백그라운드에서 설치되고 첫 번째 턴에서 사용하지 못할 수 있습니다. `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS`와 결합하여 대기를 제한합니다. |353| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | 턴 중간에 끝난 세션이 재개 시 자동으로 계속되기 위한 마지막 대화 기록 메시지의 최대 나이(밀리초)입니다. 마지막 메시지가 이 경계보다 오래되면, Claude Code는 `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` 자동 재개와 주입된 `CLAUDE_CODE_RESUME_PROMPT` 계속 메시지를 모두 건너뜁니다. 세션은 유휴 상태로 시작되므로 명시적으로 계속합니다. 설정 해제 또는 `0`은 경계가 없음을 의미합니다. 음수 또는 숫자가 아닌 값은 1시간 경계를 적용합니다. 장시간 실행되는 에이전트의 스폰 스크립트는 이를 설정할 수 있으므로 오래된 대화 기록에 대한 재시작이 오래된 프롬프트를 다시 실행하지 않습니다. Claude Code는 [에이전트 보기](/docs/ko/agent-view) 세션이 대화형 세션에서 상속된 대화를 재시작할 때 자신이 1시간 경계를 설정합니다. Claude Code v2.1.211 이상이 필요합니다 |

299| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | 동기 플러그인 설치의 타임아웃(밀리초). 초과되면 Claude Code는 플러그인 없이 진행하고 오류를 기록합니다. 기본값 없음: 이 변수가 없으면 동기 설치는 완료될 때까지 대기합니다. |354| `CLAUDE_CODE_RESUME_PROMPT` | 턴 중간에 끝난 세션을 재개할 때 주입되는 계속 메시지를 재정의합니다. 기본값은 `Continue from where you left off.`입니다. 장시간 실행되는 에이전트의 스폰 스크립트는 이를 더 지시적인 부팅 메시지로 설정할 수 있습니다. 빈 문자열은 기본값을 사용합니다 |

300| `CLAUDE_CODE_SYNC_SKILLS` | `CLAUDE_CODE_SYNC_SKILLS`이 설정되었을 때 비대화형 모드(`-p` 플래그)에서 첫 번째 쿼리 전에 활성화된 claude.ai skill을 `~/.claude/skills/`로 다운로드하고 10분마다 재동기화하려면 `1`로 설정합니다. claude.ai 인증이 필요합니다. [Claude Code on the web](/docs/ko/claude-code-on-the-web) 세션에서 자동으로 설정됩니다. |355| `CLAUDE_CODE_RETRY_WATCHDOG` | 평가 하네스, CI 작업, 원격 작업자와 같은 무인 세션의 경우 `1`로 설정하세요. `429` 및 `529` 용량 오류를 `CLAUDE_CODE_MAX_RETRIES` 시도 후 실패하는 대신 무한정 재시도합니다. Claude Code는 지출 제한 또는 소진된 사용 크레딧을 보고하는 `429`에서 즉시 실패합니다. 일정에 따라 재설정되는 [게이트웨이 지출 상한](/docs/ko/errors#spend-limit-reached)의 경우에도 마찬가지입니다. v2.1.239 이전에는 감시견이 이들을 무한정 재시도했습니다. 감시견은 시도 사이에 최대 5분까지 백오프하거나 응답이 속도 제한 재설정 시간을 전달할 때까지 백오프합니다. 따라서 사용 제한에 도달한 세션은 남은 창을 기다립니다. v2.1.199 이상에서는 서버 오류, 타임아웃, 끊어진 연결과 같은 다른 일시적 오류에 대한 기본 재시도 횟수를 300으로 올립니다. 대략 3시간의 백오프이며, `CLAUDE_CODE_MAX_RETRIES`를 명시적으로 설정하면 15의 상한을 제거합니다. Claude Code v2.1.186 이상이 필요합니다 |

301| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | `CLAUDE_CODE_SYNC_SKILLS`이 설정되었을 때 호스트가 세션 중에 skill 다시 로드를 요청할 때 중간 skill 재동기화의 타임아웃(밀리초)(기본값: 30000). 대기를 제한합니다. 초과되면 재동기화가 중지되고 남은 다운로드는 백그라운드에서 계속됩니다. |356| `CLAUDE_CODE_SAFE_MODE` | 안전 모드로 시작하려면 `1`로 설정하세요: CLAUDE.md, 기술, 플러그인, 훅, MCP 서버, 사용자 정의 명령 및 에이전트, 출력 스타일, 워크플로우, 사용자 정의 테마, 사용자 정의 키 바인딩, 상태 줄 및 파일 제안 명령, LSP 서버, 자동 메모리는 로드되지 않습니다. 손상된 구성 문제 해결용입니다. 관리 설정 정책은 여전히 적용됩니다. 정책 구성 훅, 상태 줄, 파일 제안 명령 포함; 관리 플러그인, 관리 기술, 관리 CLAUDE.md, 정책 구성 MCP 서버는 로드되지 않습니다. [`--safe-mode`](/docs/ko/cli-reference#cli-flags)를 전달하는 것과 동등합니다. 직접 생성된 자식 프로세스는 변수를 상속합니다 |

302| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | `CLAUDE_CODE_SYNC_SKILLS`이 설정되었을 때 첫 번째 쿼리가 초기 skill 동기화를 기다리는 시간(밀리초)(기본값: 5000). 초과되면 쿼리가 진행되고 남은 skill 다운로드는 백그라운드에서 계속됩니다. |357| `CLAUDE_CODE_SCRIPT_CAPS` | `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`이 설정되었을 때 특정 스크립트가 세션당 호출될 수 있는 횟수를 제한하는 JSON 객체입니다. 키는 명령 텍스트에 대해 일치하는 부분 문자열입니다. 값은 정수 호출 제한입니다. 예를 들어, `{"deploy.sh": 2}`는 `deploy.sh`를 최대 2번 호출할 수 있습니다. 일치는 부분 문자열 기반이므로 `./scripts/deploy.sh $(evil)`과 같은 셸 확장 트릭도 상한에 대해 계산됩니다. `xargs` 또는 `find -exec`을 통한 런타임 팬아웃은 감지되지 않습니다. 이는 심층 방어 제어입니다 |

303| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | diff 출력에서 구문 강조를 비활성화하려면 `false`로 설정합니다. 색상이 터미널 설정을 방해할 때 유용합니다. 코드 블록 및 파일 미리보기에서 강조를 비활성화하려면 [`syntaxHighlightingDisabled`](/docs/ko/settings) 설정을 사용합니다. |358| `CLAUDE_CODE_SCROLL_SPEED` | [전체 화면 렌더링](/docs/ko/fullscreen#mouse-wheel-scrolling)에서 마우스 휠 스크롤 배수를 설정합니다. `0.5`와 같이 1 미만의 분수 값을 포함하여 1에서 20까지의 양의 값을 허용합니다. 터미널이 이미 휠 이벤트를 증폭하는 경우 가속 트랙패드 및 휠 스크롤을 느리게 합니다. 터미널이 증폭 없이 노치당 하나의 휠 이벤트를 보내면 `vim`과 일치하도록 `3`으로 설정합니다. JetBrains IDE 터미널에서는 무시됩니다. Claude Code는 자신의 스크롤 처리를 사용합니다 |

304| `CLAUDE_CODE_TASK_LIST_ID` | 세션 간에 작업 목록을 공유합니다. 여러 Claude Code 인스턴스에서 동일한 ID를 설정하여 공유 작업 목록에서 조정합니다. [작업 목록](/docs/ko/interactive-mode#task-list) 참조 |359| `CLAUDE_CODE_SEND_FEEDBACK` | 세션에 대해 [Claude 작성 피드백](/docs/ko/tools-reference#sendfeedback-tool-behavior)을 끄려면 `0`으로 설정하세요. 계정이 이미 액세스 권한이 있는 경우 켜려면 `1`로 설정하세요. 변수는 액세스 자체를 부여할 수 없으며, `DISABLE_FEEDBACK_COMMAND` 및 [`feedbackDrafts`](/docs/ko/settings-reference#feedbackdrafts) 설정의 `off` 값과 같이 피드백을 끄는 다른 스위치가 여전히 적용됩니다 |

305| `CLAUDE_CODE_TEAM_NAME` | 이 팀원이 속한 에이전트 팀의 이름입니다. [에이전트 팀](/docs/ko/agent-teams) 멤버에서 자동으로 설정됩니다. |360| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | [SessionEnd](/docs/ko/hooks#sessionend) 훅의 시간 예산(밀리초)을 재정의합니다. 세션 종료, `/clear`, 대화형 `/resume`을 통한 세션 전환에 적용됩니다. 기본적으로 예산은 1.5초이며, 설정 파일에서 구성된 가장 높은 훅별 `timeout`으로 자동으로 올라갑니다. 최대 60초입니다. 플러그인 제공 훅의 타임아웃은 예산을 올리지 않습니다 |

306| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | {{/* min-version: 2.1.206 */}}비대화형 세션이 종료 시 [에이전트 팀](/docs/ko/agent-teams)이 정리를 완료할 때까지 대기하는 시간(밀리초)을 재정의합니다. 1000부터 60000까지 허용합니다. 범위를 벗어난 값은 무시되고 기본값 10000이 적용됩니다. Claude Code v2.1.206 이상이 필요합니다. |361| `CLAUDE_CODE_SESSION_ID` | Bash 및 PowerShell 도구 서브프로세스, [훅 명령](/docs/ko/hooks) 서브프로세스, stdio [MCP 서버](/docs/ko/mcp) 서브프로세스에서 현재 세션 ID로 자동으로 설정됩니다. Bash, PowerShell, 훅의 경우 이는 훅 JSON 입력의 `session_id` 필드와 일치하며 `/clear`에서 업데이트됩니다. MCP 서버 서브프로세스는 생성된 ID를 유지합니다. `--resume <session-id>`에서 재개된 ID를 수신합니다. 일치하는 훅 및 Bash입니다. `--continue` 또는 명시적 ID 없이 `--resume`에서 초기 시작 ID를 대신 수신할 수 있습니다. 스크립트 및 외부 도구를 이를 시작한 Claude Code 세션과 상관시키려면 사용합니다 |

307| `CLAUDE_CODE_TMPDIR` | 내부 임시 파일에 사용되는 임시 디렉토리를 재정의합니다. Claude Code는 이 경로에 `/claude-{uid}/`(Unix) 또는 `/claude/`(Windows)를 추가합니다. 기본값: macOS의 경우 `/tmp`, Linux/Windows의 경우 `os.tmpdir()`. v2.1.161부터 macOS 및 Linux에서 [샌드박스](/docs/ko/sandboxing) Bash subprocess는 경로가 너무 길어지면 일부 도구가 실패하므로 시스템 기본값 아래에 짧은 폴백 `$TMPDIR`을 받습니다. 샌드박스되지 않은 Bash 명령은 셸의 `$TMPDIR`을 변경되지 않고 상속합니다. Claude Code의 자체 임시 파일은 항상 재정의를 사용합니다. |362| `CLAUDE_CODE_SHELL` | Claude Code가 Bash 도구 명령을 실행하는 데 사용하는 셸을 설정합니다. `/opt/homebrew/bin/bash`와 같은 `bash` 또는 `zsh` 바이너리의 경로를 허용합니다. `fish`와 같은 다른 셸은 지원되지 않습니다. 값이 작동하는 `bash` 또는 `zsh` 경로가 아니면, Claude Code는 이를 무시하고 자동 감지로 폴백합니다. 자동 감지는 `bash` 또는 `zsh`를 가리킬 때 `$SHELL`을 사용합니다. 그렇지 않으면 PATH 및 표준 설치 위치에서 찾은 첫 번째 작동 `zsh`를 선택한 후 `bash`를 선택합니다 |

308| `CLAUDE_CODE_TMUX_TRUECOLOR` | tmux 내에서 24비트 truecolor 출력을 허용하려면 `1`로 설정합니다. 기본적으로 `$TMUX`가 설정되면 Claude Code는 256색으로 제한합니다. tmux는 구성되지 않으면 truecolor 이스케이프 시퀀스를 통과하지 않기 때문입니다. `~/.tmux.conf`에 `set -ga terminal-overrides ',*:Tc'`를 추가한 후 이를 설정합니다. [터미널 구성](/docs/ko/terminal-config)에서 다른 tmux 설정을 참조합니다. |363| `CLAUDE_CODE_SHELL_PREFIX` | Claude Code가 생성하는 셸 명령을 래핑하는 명령 접두사입니다: Bash 도구 호출, [훅](/docs/ko/hooks) 명령, [상태 줄](/docs/ko/statusline) 명령, stdio [MCP 서버](/docs/ko/mcp) 시작 명령. PowerShell 훅 및 exec 형식 훅은 접두사 없이 실행됩니다. 로깅 또는 감사에 유용합니다. `/path/to/logger.sh`와 같은 실행 파일 경로를 설정하면 각 명령이 `/path/to/logger.sh '<command>'`로 실행됩니다. 래퍼는 `$1`에서 명령줄을 단일 셸 인용 인수로 수신하므로 래퍼는 `exec bash -c "$1"`과 같이 `$1`을 다시 평가해야 합니다. `$1`을 실행 파일 경로로 취급하면 `npx -y <package>`와 같은 인수를 전달하는 stdio MCP 서버가 손상됩니다. Bash 도구 호출의 경우, `$1`은 Claude Code가 조립하는 전체 셸 호출을 포함합니다. 실행한 명령만이 아닙니다 |

309| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | [Claude Platform on AWS](/docs/ko/claude-platform-on-aws) 사용 |364| `CLAUDE_CODE_SIMPLE` | 최소 시스템 프롬프트 및 Bash, 파일 읽기, 파일 편집 도구만으로 실행하려면 `1`로 설정하세요. `--mcp-config`의 MCP 도구는 여전히 사용 가능합니다. 훅, 기술, 사용자 정의 명령, 서브에이전트, 플러그인, MCP 서버, 자동 메모리, CLAUDE.md의 자동 검색을 비활성화합니다. 기술은 `--add-dir`로 전달하는 디렉토리에서 여전히 로드됩니다. OAuth 토큰 및 키체인 자격 증명은 읽지 않으므로 Anthropic 인증은 `ANTHROPIC_API_KEY` 또는 `--settings`의 `apiKeyHelper`에서 와야 합니다. [`--bare`](/docs/ko/headless#start-faster-with-bare-mode)를 전달하는 것과 동등합니다 |

310| `CLAUDE_CODE_USE_BEDROCK` | [Amazon Bedrock](/docs/ko/amazon-bedrock) 사용 |365| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | 모든 모델에서 더 짧은 시스템 프롬프트 및 축약된 도구 설명을 사용하려면 `1`로 설정하세요. 실험 또는 서버 구성이 그렇지 않으면 활성화하더라도 옵트아웃하려면 `0`, `false`, `no`, 또는 `off`로 설정하세요. 전체 도구 집합, 훅, MCP 서버, CLAUDE.md 검색은 활성화된 상태로 유지됩니다 |

312| `CLAUDE_CODE_USE_MANTLE` | Amazon Bedrock [Mantle 엔드포인트](/docs/ko/amazon-bedrock#use-the-mantle-endpoint) 사용 |367| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | AWS 기본 자격 증명 제공자 체인의 인프로세스 캐시를 끄려면 `1`로 설정하세요. Claude Code는 모든 API 요청에서 체인을 확인합니다. 캐시가 꺼져 있으면, SSO 지원 프로필은 모든 요청에서 IAM Identity Center에 자격 증명을 요청합니다. [자격 증명 캐싱 및 확인 타임아웃](/docs/ko/amazon-bedrock#credential-caching-and-resolution-timeout)을 참조하세요. Claude Code v2.1.207 이상이 필요합니다 |

313| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Node.js 파일 API를 사용하여 사용자 정의 명령, subagent, 출력 스타일을 검색하려면 `1`로 설정합니다. 번들 ripgrep 바이너리를 사용할 수 없거나 환경에서 차단된 경우 이를 설정합니다. Grep 또는 파일 검색 도구에는 영향을 주지 않습니다. |368| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Amazon Bedrock에 대한 AWS 인증을 건너뛰려면 설정하세요(예: LLM 게이트웨이 사용 시) |

314| `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 도구](/docs/ko/tools-reference#powershell-tool) 참조 |369| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | [빠른 모드](/docs/ko/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) 가용성 확인이 실패한 것을 사용 가능한 것으로 취급하려면 `1`로 설정하세요. 네트워크가 확인의 직접 요청을 `api.anthropic.com`으로 차단하는 경우입니다. Claude Code는 여전히 "조직에서 빠른 모드가 비활성화됨" 응답을 존중합니다 |

315| `CLAUDE_CODE_USE_VERTEX` | [Google Cloud's Agent Platform](/docs/ko/google-vertex-ai) 사용 |370| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | 클라이언트 측 [빠른 모드](/docs/ko/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) 가용성 확인을 건너뛰려면 `1`로 설정하세요. 프록시가 확인의 요청을 거부하는 대신 가로채는 경우입니다. API는 조직이 빠른 모드를 비활성화했을 때 빠른 모드 요청을 여전히 거부합니다 |

316| `CLAUDE_CONFIG_DIR` | 구성 디렉토리를 재정의합니다(기본값: `~/.claude`). 모든 설정, 자격 증명, 세션 기록 및 플러그인이 이 경로 아래에 저장됩니다. 여러 계정을 나란히 실행하는 데 유용합니다: 예를 들어 `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |371| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Microsoft Foundry에 대한 Azure 인증을 건너뛰려면 설정하세요. 프록시 또는 게이트웨이가 자신의 `Authorization` 헤더를 주입하는 경우입니다. Claude Code는 Azure 자격 증명 없이 요청을 보내고 `ANTHROPIC_CUSTOM_HEADERS`를 통해 제공하는 것과 같이 제공하는 `Authorization` 헤더를 보존합니다. `ANTHROPIC_FOUNDRY_API_KEY` 또는 `ANTHROPIC_FOUNDRY_AUTH_TOKEN`이 설정되면 무시됩니다. v2.1.203 이전에는 이 변수가 API 키도 설정되지 않으면 Microsoft Foundry 클라이언트가 요청을 보낼 수 없게 했습니다 |

317| `CLAUDE_DISABLE_ADOPT` | 세션을 백그라운드 처리할 때 `←` 또는 [`/background`](/docs/ko/agent-view#from-inside-a-session)를 눌러 진행 중인 백그라운드 작업을 수행하는 대신 중지하려면 `1`로 설정합니다. Claude Code는 백그라운드 처리 전에 확인을 요청한 다음 그렇지 않으면 수행할 작업을 중지합니다. Claude Code v2.1.195 이상이 필요합니다. |372| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Amazon Bedrock Mantle에 대한 AWS 인증을 건너뛰려면 설정하세요(예: LLM 게이트웨이 사용 시) |

318| `CLAUDE_EFFORT` | Bash 도구 subprocess 및 훅 명령에서 활성 [노력 수준](/docs/ko/model-config#adjust-effort-level)으로 자동으로 설정됩니다: `low`, `medium`, `high`, `xhigh`, 또는 `max`. Ultracode는 별개의 수준이 아니며 `xhigh`로 보고됩니다. [훅](/docs/ko/hooks)에 전달된 `effort.level` 필드와 일치합니다. 현재 모델이 노력 매개변수를 지원할 때만 설정됩니다. |373| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | 프롬프트 기록 및 세션 대화 기록을 디스크에 작성하지 않으려면 `1`로 설정하세요. 이 변수로 시작된 세션은 `--resume`, `--continue`, 위쪽 화살표 기록에 나타나지 않습니다. 임시 스크립트 세션에 유용합니다 |

319| `CLAUDE_ENABLE_BYTE_WATCHDOG` | 바이트 수준 스트리밍 유휴 감시견을 강제로 활성화하려면 `1`로 설정하거나, 강제로 비활성화하려면 `0`으로 설정합니다. 설정하지 않으면 감시견은 직접 Anthropic API 및 [Claude Platform on AWS](/docs/ko/claude-platform-on-aws) 연결에 대해 기본적으로 활성화됩니다. 바이트 감시견은 `CLAUDE_STREAM_IDLE_TIMEOUT_MS`로 설정된 기간 동안 와이어에 바이트가 도착하지 않으면 연결을 중단합니다. 최소 5분이며 이벤트 수준 감시견과 독립적입니다. |374| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Google Cloud의 Agent Platform에 대한 Google 인증을 건너뛰려면 설정하세요(예: LLM 게이트웨이 사용 시) |

320| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Amazon Bedrock `vnd.amazon.eventstream` 응답에서 바이트 수준 스트리밍 유휴 감시견을 활성화하려면 `1`로 설정합니다. 기본적으로 꺼져 있습니다. `CLAUDE_STREAM_IDLE_TIMEOUT_MS`로 타임아웃을 구성합니다. |375| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | [Stop](/docs/ko/hooks#stop) 또는 [SubagentStop](/docs/ko/hooks#subagentstop) 훅이 Claude Code가 어쨌든 턴을 끝내기 전에 턴이 끝나는 것을 차단할 수 있는 최대 연속 횟수입니다(기본값: 8). 상한을 비활성화하려면 `0`으로 설정하세요. 훅이 합법적으로 더 많은 반복이 필요하면 이를 올리세요 |

321| `CLAUDE_ENABLE_STREAM_WATCHDOG` | 이벤트 수준 스트리밍 유휴 감시견을 강제로 활성화하려면 `1`로 설정하거나, 강제로 비활성화하려면 `0`으로 설정합니다. 설정하지 않으면 감시견은 모든 공급자에 대해 기본적으로 켜져 있습니다. v2.1.196 이전에는 설정하지 않은 기본값이 직접 Anthropic API에서 서버 제어이고 다른 공급자에서는 꺼져 있었습니다. v2.1.169부터 직접 Anthropic API 및 Claude Platform on AWS 이외의 공급자도 `API_FORCE_IDLE_TIMEOUT`에 설명된 독립적인 5분 본문 유휴 타임아웃을 가집니다. Amazon Bedrock에서는 `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`로 독립적인 바이트 수준 감시견을 활성화할 수도 있습니다. 둘 다 설정하면 함께 실행됩니다. `CLAUDE_STREAM_IDLE_TIMEOUT_MS`로 타임아웃을 구성합니다. |376| `CLAUDE_CODE_SUBAGENT_MODEL` | [서브에이전트](/docs/ko/sub-agents#choose-a-model), [에이전트 팀](/docs/ko/agent-teams#specify-teammates-and-models) 팀원, [워크플로우](/docs/ko/workflows) 에이전트의 기본 모델입니다. 다른 방식으로 모델이 할당되지 않은 경우입니다. `haiku`와 같은 별칭 또는 전체 모델 이름을 허용합니다. 두 소스가 이를 우선합니다: Claude가 에이전트를 생성할 때 전달하는 모델, 에이전트 정의의 `model` 필드(예: `inherit` 포함). 이를 변경하려면 [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/ko/sub-agents#run-every-subagent-on-one-model)를 설정하세요. [모델 선택](/docs/ko/sub-agents#choose-a-model)에서 전체 순서를 참조하세요. `inherit`로 설정하는 것은 설정 해제하는 것과 동일합니다. v2.1.251 이전에는 이 변수가 호출별 모델과 정의의 `model` 필드를 모두 재정의했습니다 |

322| `CLAUDE_ENV_FILE` | Claude Code가 각 Bash 명령 전에 같은 셸 프로세스에서 실행하는 셸 스크립트의 경로이므로 파일의 내보내기가 명령에 표시됩니다. virtualenv 또는 conda 활성화를 명령 간에 유지하는 데 사용합니다. [SessionStart](/docs/ko/hooks#persist-environment-variables), [Setup](/docs/ko/hooks#setup), [CwdChanged](/docs/ko/hooks#cwdchanged), [FileChanged](/docs/ko/hooks#filechanged) 훅으로도 동적으로 채워집니다. |377| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | 서브에이전트, 팀원, 워크플로우 에이전트에 하나의 모델을 강제하려면 `1`로 설정하세요. [모든 서브에이전트를 하나의 모델에서 실행](/docs/ko/sub-agents#run-every-subagent-on-one-model)에서 그 모델이 무엇인지 말합니다. Claude Code v2.1.257 이상이 필요합니다 |

323| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | 명시적 이름이 제공되지 않을 때 자동 생성된 [Remote Control](/docs/ko/remote-control) 세션 이름의 접두사입니다. 기본값은 머신의 호스트명이며, `myhost-graceful-unicorn`과 같은 이름을 생성합니다. `--remote-control-session-name-prefix` CLI 플래그는 단일 호출에 대해 동일한 값을 설정합니다. |378| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | `5m` 또는 `1h`를 설정합니다. Claude Code가 허용하는 유일한 값입니다. [서브에이전트](/docs/ko/sub-agents), 워크플로우, 백그라운드 작업과 같은 주 대화 외부의 요청에 대한 [프롬프트 캐시 TTL](/docs/ko/prompt-caching#cache-lifetime)을 선택합니다. `subagentPromptCacheTtl` 설정 및 `ENABLE_PROMPT_CACHING_1H`보다 우선합니다. `FORCE_PROMPT_CACHING_5M`이 이를 재정의합니다. API는 1시간 캐시 쓰기를 더 높은 속도로 청구합니다. Claude Code v2.1.242 이상이 필요합니다 |

324| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | 스트리밍 유휴 감시견이 정체된 연결을 닫기 전의 타임아웃(밀리초). 설정하지 않으면 이벤트 수준 감시견은 기본값 300초이고 바이트 수준 감시견은 직접 Anthropic API 연결에서 기본값 180초입니다(Claude Platform on AWS 및 다른 공급자에서 300초). 설정하지 않은 180초 바이트 감시견 기본값은 별개의 값이며 5분 제한을 받지 않습니다. `API_FORCE_IDLE_TIMEOUT`에 설명된 본문 유휴 타임아웃은 독립적으로 적용됩니다. Amazon Bedrock에서는 `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`일 때도 적용됩니다. |379| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | 서브프로세스 환경에서 자격 증명을 제거하려면 `1`로 설정하세요(Bash 도구, 훅, MCP stdio 서버): Anthropic 및 클라우드 제공자 자격 증명, Claude Code가 자격 증명으로 인식하는 다른 변수, 패키지 레지스트리 URL에 포함된 자격 증명. 부모 Claude 프로세스는 API 호출을 위해 이러한 자격 증명을 유지하지만 자식 프로세스는 이를 읽을 수 없습니다. 셸 확장을 통해 비밀을 유출하려는 프롬프트 주입 공격에 대한 노출을 줄입니다. Linux에서는 Bash 서브프로세스를 격리된 PID 네임스페이스에서도 실행하므로 `/proc`을 통해 호스트 프로세스 환경을 읽을 수 없습니다. 부작용으로 `ps`, `pgrep`, `kill`은 호스트 프로세스를 보거나 신호할 수 없습니다. `allowed_non_write_users`가 구성되면 `claude-code-action`이 자동으로 설정합니다 |

325| `DEBUG` | 디버그 모드를 활성화하려면 `1`로 설정합니다. [`--debug`](/docs/ko/cli-reference#cli-flags)로 실행하는 것과 동일합니다. 디버그 로그는 `~/.claude/debug/<session-id>.txt`에 기록되거나 `CLAUDE_CODE_DEBUG_LOGS_DIR`로 설정된 경로에 기록됩니다. `1`, `true`, `yes`, `on`의 참 값만 디버그 모드를 활성화하므로 다른 도구에 대해 설정된 `DEBUG=express:*`와 같은 네임스페이스 패턴은 이를 트리거하지 않습니다. |380| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | 비대화형 모드(`-p` 플래그)에서 첫 번째 쿼리 전에 플러그인 설치가 완료될 때까지 기다리려면 `1`로 설정하세요. 이것이 없으면 플러그인이 백그라운드에서 설치되고 첫 번째 턴에서 사용할 수 없을 수 있습니다. `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS`와 결합하여 대기를 제한하세요 |

326| `DISABLE_AUTOUPDATER` | 자동 업데이트를 비활성화하려면 `1`로 설정합니다. 수동 `claude update`는 계속 작동합니다. `DISABLE_UPDATES`를 사용하여 둘 다 차단합니다. |381| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | 동기 플러그인 설치의 타임아웃(밀리초)입니다. 초과되면, Claude Code는 플러그인 없이 진행하고 오류를 기록합니다. 기본값 없음: 이 변수가 없으면 동기 설치는 완료될 때까지 기다립니다 |

327| `DISABLE_AUTO_COMPACT` | 컨텍스트 제한에 접근할 때 자동 압축을 비활성화하려면 `1`로 설정합니다. 수동 `/compact` 명령은 계속 사용 가능합니다. 압축이 발생하는 시기를 명시적으로 제어하려는 경우 사용합니다. |382| `CLAUDE_CODE_SYNC_SKILLS` | 활성화된 claude.ai 기술을 `~/.claude/skills/synced/`로 다운로드하고 10분마다 재동기화하려면 `1`로 설정하세요. 첫 번째 쿼리를 실행하기 전에 Claude Code는 기술 목록을 기다립니다. 최대 `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`까지 기다립니다. 다운로드 자체는 백그라운드에서 완료되고, Claude는 기술을 호출할 때 기술의 다운로드를 기다립니다. `synced` 폴더 이름은 [이 다운로드를 위해 예약되어 있습니다](/docs/ko/skills#where-skills-live). v2.1.227 이전에는 기술이 `~/.claude/skills/`로 직접 다운로드되었습니다. `-p` 플래그를 사용한 비대화형 모드에만 적용됩니다. claude.ai 인증이 필요합니다. [웹의 Claude Code](/docs/ko/claude-code-on-the-web) 세션은 활성화된 claude.ai 기술을 자동으로 수신합니다. 여기서 설정할 필요가 없습니다. Claude Code는 [다운로드된 기술에 적용되는 추가 규칙](/docs/ko/skills#how-synced-skills-behave)을 적용합니다. 예를 들어 머신에서 `!` 명령을 실행하지 않습니다 |

328| `DISABLE_COMPACT` | 자동 압축과 수동 `/compact` 명령을 포함한 모든 압축을 비활성화하려면 `1`로 설정합니다. |383| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | `CLAUDE_CODE_SYNC_SKILLS`가 설정되었을 때 세션 중간 기술 재동기화의 타임아웃(밀리초)(기본값: 30000). 호스트가 세션 중간에 기술 다시 로드를 요청할 때 트리거되는 다운로드를 제한합니다. 초과되면 재동기화가 중지되고 나머지 다운로드는 백그라운드에서 계속됩니다 |

329| `DISABLE_COST_WARNINGS` | 비용 경고 메시지를 비활성화하려면 `1`로 설정합니다. |384| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | `CLAUDE_CODE_SYNC_SKILLS`가 설정되었을 때 첫 번째 쿼리가 초기 기술 목록을 기다리는 타임아웃(밀리초)(기본값: 5000). 초과되면 첫 번째 쿼리는 도착한 기술로 실행됩니다. 어느 쪽이든 다운로드는 백그라운드에서 완료되고, Claude는 기술을 호출할 때 기술의 다운로드를 기다립니다 |

330| `DISABLE_DOCTOR_COMMAND` | [`/doctor`](/docs/ko/commands#all-commands) 설정 점검 skill 및 `/checkup` 별칭을 숨기려면 `1`로 설정합니다. 사용자가 설치 진단을 실행하지 않아야 하는 관리형 배포에 유용합니다. `claude doctor` 터미널 명령에는 영향을 주지 않습니다. v2.1.205 이전에는 이 변수가 `/doctor` 진단 화면 명령을 숨겼습니다. |385| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | diff 출력에서 구문 강조를 비활성화하려면 `false`로 설정하세요. 색상이 터미널 설정을 방해할 때 유용합니다. 코드 블록 및 파일 미리보기에서도 강조를 비활성화하려면 [`syntaxHighlightingDisabled`](/docs/ko/settings-reference#syntaxhighlightingdisabled) 설정을 사용하세요 |

331| `DISABLE_ERROR_REPORTING` | 오류 보고를 거부하려면 `1`로 설정합니다. |386| `CLAUDE_CODE_TASK_LIST_ID` | 세션 간에 작업 목록을 공유합니다. 여러 Claude Code 인스턴스에서 동일한 ID를 설정하여 [Task 도구가 있는 세션](/docs/ko/tools-reference#task-tool-availability)에서 공유 작업 목록을 조정합니다. [작업 목록](/docs/ko/interactive-mode#task-list)을 참조하세요 |

332| `DISABLE_EXTRA_USAGE_COMMAND` | 사용자가 속도 제한을 초과하여 추가 사용량을 구매할 수 있는 `/usage-credits` 명령을 숨기려면 `1`로 설정합니다. |387| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | 비대화형 세션이 [에이전트 팀](/docs/ko/agent-teams) 분해가 완료될 때까지 종료 시 대기하는 시간(밀리초)을 재정의합니다. 1000에서 60000을 허용합니다. 범위를 벗어난 값은 무시되고 기본값 10000이 적용됩니다. Claude Code v2.1.206 이상이 필요합니다 |

333| `DISABLE_FEEDBACK_COMMAND` | `/feedback` 명령을 비활성화하려면 `1`로 설정합니다. 이전 이름 `DISABLE_BUG_COMMAND`도 허용됩니다. |388| `CLAUDE_CODE_TMPDIR` | 내부 임시 파일에 사용되는 임시 디렉토리를 재정의합니다. Claude Code는 Unix에서 이 경로에 `/claude-{uid}/`를 추가하거나 Windows에서 `/claude/`를 추가합니다. 기본값: macOS에서 `/tmp`, Linux 및 Windows에서 `os.tmpdir()`. macOS 및 Linux에서 [샌드박스](/docs/ko/sandboxing) Bash 서브프로세스는 재정의가 긴 경로인 경우 시스템 기본값 아래에서 짧은 폴백 `$TMPDIR`을 수신합니다. 일부 도구는 임시 경로가 너무 길면 실패합니다. 샌드박스되지 않은 Bash 명령은 셸의 `$TMPDIR`을 변경되지 않은 상태로 상속합니다. Claude Code의 자체 임시 파일은 항상 재정의를 사용합니다. 셸, 사용자 설정, 관리 설정에서 설정하세요. [프로젝트 및 로컬 설정](/docs/ko/settings-reference#variables-claude-code-ignores-in-env)에서는 무시됩니다 |

334| `DISABLE_GROWTHBOOK` | GrowthBook 기능 플래그 가져오기를 비활성화하려면 `1`로 설정합니다. 모든 플래그에 대해 코드 기본값을 사용합니다. 원격 분석 이벤트 로깅은 `DISABLE_TELEMETRY`도 설정되지 않으면 계속됩니다. |389| `CLAUDE_CODE_TMUX_TRUECOLOR` | tmux 내에서 24비트 truecolor 출력을 허용하려면 `1`과 같은 비어있지 않은 값으로 설정하세요. **`0` 또는 `false`로 설정해도 truecolor가 허용됩니다**. 대부분의 온/오프 변수와 달리 변수를 설정 해제하여 256색 제한을 복원하세요. 기본적으로 `$TMUX`가 설정되면 Claude Code는 256색으로 제한합니다. tmux는 구성되지 않으면 truecolor 이스케이프 시퀀스를 통과하지 않기 때문입니다. `~/.tmux.conf`에 `set -ga terminal-overrides ',*:Tc'`를 추가한 후 설정하세요. [터미널 구성](/docs/ko/terminal-config)에서 다른 tmux 설정을 참조하세요 |

335| `DISABLE_INSTALLATION_CHECKS` | 설치 경고를 비활성화하려면 `1`로 설정합니다. 표준 설치의 문제를 숨길 수 있으므로 설치 위치를 수동으로 관리할 때만 사용합니다. |390| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | Linux 및 WSL에서, Claude Code가 도구 메모리 상한에서 [제외하는 프로세스 종류](/docs/ko/tools-reference#memory-limit-on-linux-and-wsl)의 쉼표로 구분된 목록입니다(예: `mcp` 또는 `lsp`). 모든 종류를 제한하려면 `none`으로 설정하거나, Bash, PowerShell, Monitor 도구 명령만 제한하려면 `all-new`로 설정하세요. Claude Code는 나열한 것에 관계없이 Bash, PowerShell, Monitor 도구 명령을 상한 아래로 유지합니다. Claude Code v2.1.246 이상이 필요합니다 |

336| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | `/install-github-app` 명령을 숨기려면 `1`로 설정합니다. 타사 공급자(Amazon Bedrock, Google Cloud's Agent Platform, 또는 Microsoft Foundry)를 사용할 때 이미 숨겨집니다. |391| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | Linux 및 WSL에서, [Bash 및 PowerShell 도구 명령이 사용할 수 있는 메모리를 제한](/docs/ko/tools-reference#memory-limit-on-linux-and-wsl)하려면 `4G`와 같은 크기로 설정합니다. v2.1.246 이상에서 Monitor 도구 명령입니다. 바이트 수의 경우 일반 숫자만 작성하거나 `K`, `M`, `G`, 또는 `T` 접미사를 사용합니다. 상한을 끄려면 `0` 또는 `off`로 설정하세요. 첫 번째 프로세스 Claude Code가 상한을 켜거나 끈 후, 변경된 값은 다음에 `claude`를 시작할 때 적용됩니다. Claude Code v2.1.233 이상이 필요합니다 |

337| `DISABLE_INTERLEAVED_THINKING` | interleaved-thinking 베타 헤더 전송을 방지하려면 `1`로 설정합니다. LLM 게이트웨이 또는 공급자가 [interleaved thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking)을 지원하지 않을 때 유용합니다. |392| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Claude Code가 [원격 제어](/docs/ko/remote-control) 또는 SDK 호스트와 같은 원격 클라이언트로 전달하는 대화 상자의 마감일(밀리초)입니다. 또는 [보유된 교차 세션 메시지](/docs/ko/cross-session-messaging#control-inbound-messages)의 승인 대화 상자입니다. 권한 프롬프트 및 `AskUserQuestion` 질문은 자신의 흐름을 사용하며 이에 의해 관리되지 않습니다. Claude Code v2.1.236 이상에서는 무인 상태로 실행될 수 있는 세션의 세션 중간 [Fable 사용 크레딧 동의 프롬프트](/docs/ko/model-config#fable-and-usage-credits)도 제한합니다. [인바운드 메시지 제어](/docs/ko/cross-session-messaging#control-inbound-messages) 및 [비대화형 세션](/docs/ko/cross-session-messaging#non-interactive-sessions)은 마감일이 적용되지 않는 경우를 포함한 전체 보유 메시지 만료 규칙을 다룹니다. [`dialogExpiry`](/docs/ko/settings-reference#dialogexpiry) 설정을 재정의합니다. `0` 또는 음수 값은 마감일을 비활성화합니다 |

342| `DISABLE_PROMPT_CACHING_HAIKU` | Haiku 모델에 대해 프롬프트 캐싱을 비활성화하려면 `1`로 설정합니다. |397| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | 사용자 정의 명령, 서브에이전트, 출력 스타일을 ripgrep 대신 Node.js 파일 API를 사용하여 검색하려면 `1`로 설정하세요. 번들 ripgrep 바이너리를 사용할 수 없거나 환경에서 차단되는 경우 설정합니다. Grep 또는 파일 검색 도구에는 영향을 주지 않습니다 |

343| `DISABLE_PROMPT_CACHING_OPUS` | Opus 모델에 대해 프롬프트 캐싱을 비활성화하려면 `1`로 설정합니다. |398| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | PowerShell 도구를 제어합니다. Git Bash가 없는 Windows에서는 도구가 자동으로 활성화됩니다. `0`으로 설정하여 비활성화합니다. Git Bash가 설치된 Windows에서는 도구가 claude.ai 및 Console 계정에 대해 기본적으로 켜져 있습니다. Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry 세션에서 활성화하려면 `1`로 설정하거나, 끄려면 `0`으로 설정합니다. Linux, macOS, WSL에서는 `1`로 설정하여 활성화합니다. PATH에 `pwsh`가 필요합니다. Windows에서 활성화되면, Claude는 Git Bash를 통해 라우팅하는 대신 PowerShell 명령을 기본적으로 실행할 수 있습니다. [PowerShell 도구](/docs/ko/tools-reference#powershell-tool)를 참조하세요 |

345| `DISABLE_TELEMETRY` | 원격 분석을 거부하려면 `1`로 설정합니다. 원격 분석 이벤트에는 코드, 파일 경로 또는 bash 명령과 같은 사용자 데이터가 포함되지 않습니다. 기능 플래그도 비활성화하므로 아직 롤아웃 중인 일부 기능을 사용하지 못할 수 있습니다. |400| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | [WebFetch](/docs/ko/tools-reference#webfetch-tool-behavior)가 각 가져온 URL의 응답을 캐시하는 시간(밀리초)을 설정합니다. 기본값은 `900000`입니다. 15분입니다. 일반 숫자만 허용합니다. `0`, 소수, 다른 표기법은 기본값을 유지합니다. Claude Code는 시작당 한 번 값을 읽으므로 설정 `env` 블록의 변경은 다음에 `claude`를 시작할 때 적용됩니다. Claude Code v2.1.233 이상이 필요합니다 |

346| `DISABLE_UPDATES` | 수동 `claude update` 및 `claude install`을 포함한 모든 업데이트를 차단하려면 `1`로 설정합니다. `DISABLE_AUTOUPDATER`보다 더 엄격합니다. 자신의 채널을 통해 Claude Code를 배포하고 사용자가 자체 업데이트하지 않아야 할 때 사용합니다. |401| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | [WebFetch](/docs/ko/tools-reference#webfetch-tool-behavior)가 페이지 다운로드를 기다리는 시간(밀리초)의 상한입니다. 따라가는 리다이렉트 포함입니다. 그 시간까지 다운로드가 완료되지 않으면 마감일 오류로 실패합니다. 기본값은 `300000`입니다. 5분입니다. 제한을 제거하려면 `0`으로 설정하세요. 일반 숫자만 허용합니다. 소수 또는 다른 표기법은 기본값을 유지합니다. Claude Code v2.1.268 이상이 필요합니다 |

347| `DISABLE_UPGRADE_COMMAND` | `/upgrade` 명령을 숨기려면 `1`로 설정합니다. |402| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | [워크플로우](/docs/ko/workflows) 에이전트가 같은 접두사 형제의 첫 번째 응답이 시작되기를 기다리는 시간(밀리초)의 상한입니다. 팬아웃이 [프롬프트 캐시 접두사](/docs/ko/workflows#prompt-caching-in-a-fan-out)를 공유하는 여러 에이전트를 시작할 때입니다. Claude Code는 첫 번째 에이전트를 제외한 모든 에이전트를 이 시간 동안 보유하므로 나머지는 캐시되지 않은 접두사를 각각 처리하는 대신 캐시된 접두사를 읽습니다. 기본값 `5000`. 대기를 비활성화하려면 `0`으로 설정하세요. `DISABLE_PROMPT_CACHING`이 설정되면 에이전트는 절대 기다리지 않습니다. Claude Code v2.1.229 이상이 필요합니다 |

348| `DO_NOT_TRACK` | 원격 분석을 거부하려면 `1`로 설정합니다. `DISABLE_TELEMETRY` 설정과 동일합니다. Claude Code는 많은 개발자 CLI에서 인정하는 교차 도구 규칙으로 이를 존중합니다. |403| `CLAUDE_CONFIG_DIR` | 구성 디렉토리를 재정의합니다(기본값: `~/.claude`). 모든 설정, 세션 기록, 플러그인이 이 경로 아래에 저장됩니다. 자격 증명의 경우 [Claude Code가 자격 증명을 저장하는 위치](/docs/ko/authentication#credential-management)를 참조하세요. 여러 계정을 나란히 실행하는 데 유용합니다: 예를 들어, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. 셸, 사용자 설정, 관리 설정에서 설정하세요. [프로젝트 및 로컬 설정](/docs/ko/settings-reference#variables-claude-code-ignores-in-env)에서는 무시됩니다 |

349| `ENABLE_CLAUDEAI_MCP_SERVERS` | Claude Code에서 [claude.ai MCP 서버](/docs/ko/mcp#use-mcp-servers-from-claude-ai)를 비활성화하려면 `false`로 설정합니다. 로그인한 사용자의 경우 기본적으로 활성화됩니다. 프로젝트별 또는 조직별로 비활성화하려면 설정 대신 [`disableClaudeAiConnectors`](/docs/ko/settings#available-settings)를 설정합니다. |404| `CLAUDE_DISABLE_ADOPT` | `←` 또는 [`/background`](/docs/ko/agent-view#from-inside-a-session)를 눌러 세션을 백그라운드 처리할 때 진행 중인 백그라운드 작업을 계속하는 대신 중지하려면 `1`로 설정하세요. Claude Code는 백그라운드 처리 전에 확인하도록 요청한 후 계속될 작업을 중지합니다. Claude Code v2.1.195 이상이 필요합니다 |

350| `ENABLE_PROMPT_CACHING_1H` | API 키, [Amazon Bedrock](/docs/ko/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ko/google-vertex-ai), [Microsoft Foundry](/docs/ko/microsoft-foundry), [Claude Platform on AWS](/docs/ko/claude-platform-on-aws) 사용자를 위해 기본 5분 대신 1시간 [프롬프트 캐시 TTL](/docs/ko/prompt-caching#cache-lifetime)을 요청하려면 `1`로 설정합니다. 구독 사용자는 자동으로 1시간 TTL을 받습니다. 1시간 캐시 쓰기는 더 높은 요금으로 청구됩니다. |405| `CLAUDE_EFFORT` | 서브프로세스가 시작될 때 적용되는 [노력 수준](/docs/ko/model-config#adjust-effort-level)으로 Bash 도구 서브프로세스 및 훅 명령에서 자동으로 설정됩니다: `low`, `medium`, `high`, `xhigh`, 또는 `max`. Ultracode는 별개의 수준이 아니며 `xhigh`로 보고됩니다. [훅](/docs/ko/hooks)에 전달된 `effort.level` 필드와 일치합니다. 현재 모델이 노력 매개변수를 지원할 때만 설정됩니다 |

351| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | 더 이상 사용되지 않음. 대신 `ENABLE_PROMPT_CACHING_1H` 사용 |406| `CLAUDE_ENABLE_BYTE_WATCHDOG` | 바이트 수준 스트리밍 유휴 감시견을 강제로 활성화하려면 `1`로 설정하거나, 강제로 비활성화하려면 `0`으로 설정하세요. `0`은 또한 해당 감시견이 실행되는 연결에서 [첫 번째 바이트 마감일](/docs/ko/network-config#streaming-idle-watchdogs)을 끕니다. 설정되지 않으면, 감시견은 직접 Anthropic API 및 [AWS의 Claude Platform](/docs/ko/claude-platform-on-aws) 연결에 대해 기본적으로 활성화되고, `ANTHROPIC_BASE_URL` 또는 `ANTHROPIC_AWS_BASE_URL`을 통해 도달한 [게이트웨이](/docs/ko/gateways) 연결의 스트리밍 응답에 대해 활성화됩니다. v2.1.222 이전에는 해당 게이트웨이 연결에서 실행되지 않았으므로 이벤트 수준 감시견이 keep-alive 핑이 도착하는 동안에도 정지를 보고할 수 있었습니다. 타임아웃 및 타이머 상호 작용 방식에 대해서는 [스트리밍 유휴 감시견](/docs/ko/network-config#streaming-idle-watchdogs)을 참조하세요 |

352| `ENABLE_TOOL_SEARCH` | [MCP 도구 검색](/docs/ko/mcp#scale-with-mcp-tool-search)을 제어합니다. 설정 해제: 모든 MCP 도구는 기본적으로 연기되지만 Google Cloud's Agent Platform에서 또는 `ANTHROPIC_BASE_URL`이 비자사 호스트를 가리킬 때 미리 로드됩니다. 값: `true`(항상 연기 및 베타 헤더 전송, Google Cloud's Agent Platform 모델 Sonnet 4.5 또는 Opus 4.5보다 이전 또는 `tool_reference`를 지원하지 않는 프록시에서 요청 실패), `auto`(임계값 모드: 도구가 컨텍스트의 10% 이내에 맞으면 미리 로드), `auto:N`(사용자 정의 임계값, 예: 5%의 경우 `auto:5`), `false`(모두 미리 로드). `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`가 설정되면 무시되며, 모든 도구가 미리 로드됩니다. |407| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Amazon Bedrock `vnd.amazon.eventstream` 응답에서 바이트 수준 스트리밍 유휴 감시견을 활성화하려면 `1`로 설정하세요. 이는 또한 Bedrock 스트리밍 요청에서 [첫 번째 바이트 마감일](/docs/ko/network-config#streaming-idle-watchdogs)을 활성화합니다. 기본적으로 꺼져 있습니다. `CLAUDE_STREAM_IDLE_TIMEOUT_MS`로 타임아웃을 구성하세요 |

353| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | 모든 기본 모델에서 반복된 과부하 오류 후 폴백을 트리거하려면 비어 있지 않은 값으로 설정합니다. v2.1.160부터 구성된 [폴백 모델 체인](/docs/ko/model-config#fallback-model-chains)은 모든 기본 모델에 대해 반복된 과부하 오류에서 트리거되므로 이 변수는 폴백 모델로 전환하는 데 영향을 주지 않습니다. |408| `CLAUDE_ENABLE_STREAM_WATCHDOG` | 이벤트 수준 스트리밍 유휴 감시견을 강제로 비활성화하려면 `0`으로 설정하거나, 강제로 활성화하려면 `1`로 설정하세요. 설정되지 않으면, 감시견은 모든 제공자에 대해 기본적으로 켜져 있습니다. v2.1.196 이전에는 설정되지 않은 기본값이 직접 Anthropic API에서 서버 제어되었고 다른 제공자에서는 꺼져 있었습니다. `CLAUDE_STREAM_IDLE_TIMEOUT_MS`로 타임아웃을 구성하세요. 이와 함께 실행되는 다른 정지 타이머에 대해서는 [스트리밍 유휴 감시견](/docs/ko/network-config#streaming-idle-watchdogs)을 참조하세요 |

354| `FORCE_AUTOUPDATE_PLUGINS` | `DISABLE_AUTOUPDATER`를 통해 주 자동 업데이터가 비활성화된 경우에도 플러그인 자동 업데이트를 강제하려면 `1`로 설정합니다. |409| `CLAUDE_ENV_FILE` | Claude Code가 같은 셸 프로세스에서 각 Bash 명령 전에 실행하는 셸 스크립트의 경로입니다. 파일의 내보내기가 명령에 표시됩니다. virtualenv 또는 conda 활성화를 명령 간에 유지하는 데 사용합니다. 또한 [SessionStart](/docs/ko/hooks#persist-environment-variables), [Setup](/docs/ko/hooks#setup), [CwdChanged](/docs/ko/hooks#cwdchanged), [FileChanged](/docs/ko/hooks#filechanged) 훅에 의해 동적으로 채워집니다 |

355| `FORCE_HYPERLINK` | 터미널이 지원하지만 자동 감지되지 않을 때 클릭 가능한 OSC 8 하이퍼링크를 활성화하려면 `1`로 설정하거나, 비활성화하려면 `0`으로 설정합니다. |410| `CLAUDE_JOB_DIR` | Claude Code가 각 [백그라운드 세션](/docs/ko/agent-view)에서 해당 세션의 `~/.claude/jobs/<id>` 디렉토리로 설정합니다. 세션이 실행하는 셸 명령이 이를 상속합니다. 스크래치 파일을 [`$CLAUDE_JOB_DIR/tmp`](/docs/ko/agent-view#where-state-is-stored)에 작성합니다. Claude의 `Write` 및 `Edit` 호출은 거기서 권한을 요청하지 않으며, 디렉토리는 세션이 삭제될 때 제거됩니다 |

356| `FORCE_PROMPT_CACHING_5M` | 1시간 TTL이 적용되는 경우에도 5분 프롬프트 캐시 TTL을 강제하려면 `1`로 설정합니다. `ENABLE_PROMPT_CACHING_1H` 재정의 |411| `CLAUDE_PID` | Claude Code는 이를 생성하는 서브프로세스에서 자신의 프로세스 ID로 설정합니다: Bash 및 PowerShell 도구 명령 및 훅 명령입니다. Linux에서 Bash 도구의 셸 통합은 이를 사용하여 Claude Code 프로세스 자체와 일치하는 `pkill` 패턴을 거부합니다. [오류 참조](/docs/ko/errors#pkill-pattern-matches-the-claude-code-process)를 참조하세요. 자신의 스크립트에서 읽어 부모 Claude Code 프로세스를 의도적으로 식별하거나 신호합니다. Claude Code v2.1.214 이상이 필요합니다 |

357| `HTTP_PROXY` | 네트워크 연결을 위한 HTTP 프록시 서버를 지정합니다. |412| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | 명시적 이름이 제공되지 않을 때 자동 생성된 [원격 제어](/docs/ko/remote-control) 세션 이름의 접두사입니다. 기본값은 머신의 호스트 이름이며, `myhost-graceful-unicorn`과 같은 이름을 생성합니다. `--remote-control-session-name-prefix` CLI 플래그는 단일 호출에 대해 동일한 값을 설정합니다 |

358| `HTTPS_PROXY` | 네트워크 연결을 위한 HTTPS 프록시 서버를 지정합니다. |413| `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` | [첫 번째 바이트 마감일](/docs/ko/network-config#streaming-idle-watchdogs)이 실행되는 연결에서 스트리밍 요청의 첫 번째 응답 바이트의 마감일(밀리초)입니다. Claude Code가 이를 제한하는 방식, 큰 요청 본문에 추가하는 추가 시간, 설정하지 않을 때 마감일을 선택하는 방식에 대해서는 [API의 응답 없음](/docs/ko/errors#no-response-from-api)을 참조하세요. Claude Code v2.1.242 이상이 필요합니다 |

359| `IS_DEMO` | 데모 모드를 활성화하려면 `1`로 설정합니다: 헤더 및 `/status` 출력에서 이메일 및 조직 이름을 숨기고 온보딩을 건너뜁니다. 세션을 스트리밍하거나 녹화할 때 유용합니다. |414| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | 이벤트 및 바이트 수준 스트리밍 유휴 감시견이 정지된 연결을 닫기 전의 타임아웃(밀리초)입니다. 이 변수를 명시적으로 설정하면, 최소값은 `300000`(5분)입니다. 낮은 값은 확장 사고 일시 중지 및 프록시 버퍼링을 흡수하기 위해 자동으로 제한되고, 바이트 수준 감시견은 값을 30분으로 제한합니다. `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS`는 바이트 수준 감시견에 대해 이 변수보다 우선합니다. 감시견별 설정 해제 기본값에 대해서는 [스트리밍 유휴 감시견](/docs/ko/network-config#streaming-idle-watchdogs)을 참조하세요 |

360| `MAX_MCP_OUTPUT_TOKENS` | MCP 도구 응답에서 허용되는 최대 토큰 수입니다. Claude Code는 출력이 10,000 토큰을 초과할 때 경고를 표시합니다. 도구가 [`anthropic/maxResultSizeChars`](/docs/ko/mcp#raise-the-limit-for-a-specific-tool)를 선언하면 텍스트 내용에 대해 해당 문자 제한을 사용하지만, 해당 도구의 이미지 내용은 여전히 이 변수의 영향을 받습니다(기본값: 25000) |415| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | v2.1.260에서 제거되었으며 이제 작동하지 않습니다. 이전에는 [서브에이전트](/docs/ko/sub-agents)가 시작한 [백그라운드 셸 명령](/docs/ko/interactive-mode#background-bash-commands)이 실행될 수 있는 최대 시간(밀리초)을 제한했습니다. 기본값 60분입니다. [백그라운드 명령 수명 규칙](/docs/ko/tools-reference#background-commands)을 참조하세요 |

361| `MAX_STRUCTURED_OUTPUT_RETRIES` | 비대화형 모드(`-p` 플래그)에서 모델의 응답이 [`--json-schema`](/docs/ko/cli-reference#cli-flags)에 대한 유효성 검사에 실패할 때 재시도할 횟수입니다. 기본값은 5입니다. |416| `DEBUG` | 디버그 모드를 활성화하려면 `1`로 설정하세요. [`--debug`](/docs/ko/cli-reference#cli-flags)로 시작하는 것과 동등합니다. 디버그 로그는 `~/.claude/debug/<session-id>.txt`에 작성되거나 `CLAUDE_CODE_DEBUG_LOGS_DIR`으로 설정된 경로에 작성됩니다. `DEBUG=express:*`와 같은 네임스페이스 패턴이 다른 도구에 대해 설정되지 않으므로 `1`, `true`, `yes`, `on`의 참 값만 디버그 모드를 활성화합니다 |

362| `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`으로 설정하여 Anthropic API에서 사고를 비활성화합니다. Fable 5는 사고를 끌 수 없으므로 이는 효과가 없습니다. [타사 공급자](/docs/ko/third-party-integrations)에서 `0`은 마찬가지로 매개변수를 생략하므로 [적응형 추론](/docs/ko/model-config#adjust-effort-level)이 있는 모델은 여전히 생각할 수 있습니다. 0이 아닌 값의 경우 적응형 추론 모델에서 `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`을 통해 적응형 추론이 비활성화되지 않으면 예산이 무시됩니다. |417| `DISABLE_AUTOUPDATER` | 자동 백그라운드 업데이트를 비활성화하려면 `1`로 설정하세요. 수동 `claude update`는 여전히 작동합니다. 둘 다 차단하려면 `DISABLE_UPDATES`를 사용하세요 |

363| `MCP_CLIENT_SECRET` | [사전 구성된 자격 증명](/docs/ko/mcp#use-pre-configured-oauth-credentials)이 필요한 MCP 서버의 OAuth 클라이언트 시크릿입니다. `--client-secret`으로 서버를 추가할 때 대화형 프롬프트를 방지합니다. |418| `DISABLE_AUTO_COMPACT` | 컨텍스트 제한에 접근할 때 자동 압축을 비활성화하려면 `1`로 설정하세요. 수동 `/compact` 명령은 계속 사용 가능합니다. 압축이 발생할 때를 명시적으로 제어하려고 할 때 사용합니다. [`autoCompactEnabled`](/docs/ko/settings-reference#autocompactenabled) 설정을 재정의합니다 |

364| `MCP_CONNECTION_NONBLOCKING` | 시작이 첫 번째 쿼리 전에 MCP 서버 연결을 기다리는지 여부를 제어합니다. Claude Code v2.1.142부터 MCP 시작은 기본적으로 비블로킹입니다: 서버는 백그라운드에서 연결되고 완료되면 도구를 사용할 수 있게 됩니다. `0`으로 설정하여 블로킹 5초 연결 대기를 복원합니다. [`alwaysLoad: true`](/docs/ko/mcp#exempt-a-server-from-deferral)로 구성된 서버는 도구가 첫 번째 프롬프트를 빌드할 때 존재해야 하므로 이 변수와 관계없이 항상 시작을 차단합니다. |419| `DISABLE_COMPACT` | 모든 압축을 비활성화하려면 `1`로 설정하세요: 자동 압축 및 수동 `/compact` 명령 모두 |

365| `MCP_CONNECT_TIMEOUT_MS` | 블로킹 MCP 시작이 연결 배치를 기다리는 시간(밀리초)을 설정하고 도구 목록을 스냅샷하기 전입니다(기본값: 5000). [`alwaysLoad: true`](/docs/ko/mcp#exempt-a-server-from-deferral)로 표시된 서버에 적용됩니다. 마감 시점에 여전히 보류 중인 서버는 백그라운드에서 계속 연결되지만 다음 쿼리까지 나타나지 않습니다. `MCP_TIMEOUT`과 다르며, 이는 개별 서버의 연결 시도를 제한합니다. |420| `DISABLE_COST_WARNINGS` | 비용 경고 메시지를 비활성화하려면 `1`로 설정하세요 |

366| `MCP_OAUTH_CALLBACK_PORT` | [사전 구성된 자격 증명](/docs/ko/mcp#use-pre-configured-oauth-credentials)으로 MCP 서버를 추가할 때 `--callback-port`의 대안으로 OAuth 리디렉션 콜백의 고정 포트입니다. |421| `DISABLE_DOCTOR_COMMAND` | [`/doctor`](/docs/ko/commands#all-commands) 설정 체크업 기술 및 `/checkup` 별칭을 숨기려면 `1`로 설정하세요. 사용자가 세션에서 설정 진단을 실행하지 않아야 하는 관리 배포에 유용합니다. `claude doctor` 터미널 명령에는 영향을 주지 않습니다. v2.1.205 이전에는 이 변수가 `/doctor` 진단 화면 명령을 숨겼습니다 |

367| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | 시작 중에 병렬로 연결할 원격 MCP 서버(HTTP/SSE)의 최대 수(기본값: 20) |422| `DISABLE_ERROR_REPORTING` | 오류 보고를 옵트아웃하려면 `1`과 같은 비어있지 않은 값으로 설정하세요. **`0` 또는 `false`로 설정해도 옵트아웃됩니다**. 대부분의 온/오프 변수와 달리 변수를 설정 해제하여 오류 보고를 다시 켜세요 |

424| `DISABLE_FEEDBACK_COMMAND` | `/feedback` 명령 및 [Claude 작성 피드백](/docs/ko/tools-reference#sendfeedback-tool-behavior)을 비활성화하려면 `1`로 설정하세요. 또한 `/bug` 및 `/share`를 비활성화합니다. 이들은 동일한 경로를 통해 보고합니다. v2.1.212 이전에는 `/feedback`의 별칭이었으므로 명령이 모든 이름 아래에서 비활성화되었습니다. 더 이전 이름 `DISABLE_BUG_COMMAND`도 허용됩니다 |

425| `DISABLE_GROWTHBOOK` | GrowthBook 기능 플래그 가져오기를 비활성화하고 모든 플래그에 대해 코드 기본값을 사용하려면 `1` 또는 `true`로 설정하세요. 이는 [원격 제어](/docs/ko/remote-control#requirements) 및 기타 [기능 플래그 가져오기가 필요한 기능](#features-that-need-feature-flag-fetching)을 사용할 수 없게 만듭니다. `0` 또는 `false`로 설정하면 가져오기가 켜집니다. 원격 분석 이벤트 로깅은 `DISABLE_TELEMETRY`도 설정되지 않으면 켜집니다 |

426| `DISABLE_INSTALLATION_CHECKS` | 설치 경고를 비활성화하려면 `1`로 설정하세요. 설치 위치를 수동으로 관리할 때만 사용하세요. 표준 설치의 문제를 마스킹할 수 있습니다 |

427| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | `/install-github-app` 명령을 숨기려면 `1`로 설정하세요. 타사 제공자(Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry)를 사용할 때 이미 숨겨져 있습니다 |

428| `DISABLE_INTERLEAVED_THINKING` | 인터리브된 사고 베타 헤더를 보내지 않으려면 `1`로 설정하세요. LLM 게이트웨이 또는 제공자가 [인터리브된 사고](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking)를 지원하지 않을 때 유용합니다 |

429| `DISABLE_LOGIN_COMMAND` | `/login` 명령을 숨기려면 `1`로 설정하세요. 인증이 API 키 또는 `apiKeyHelper`를 통해 외부적으로 처리될 때 유용합니다 |

430| `DISABLE_LOGOUT_COMMAND` | `/logout` 명령을 숨기려면 `1`로 설정하세요 |

431| `DISABLE_PROMPT_CACHING` | 모든 모델에 대해 [프롬프트 캐싱](/docs/ko/prompt-caching#disable-prompt-caching)을 비활성화하려면 `1`로 설정하세요(모델별 설정보다 우선) |

432| `DISABLE_PROMPT_CACHING_FABLE` | Fable 모델에 대해 프롬프트 캐싱을 비활성화하려면 `1`로 설정하세요 |

433| `DISABLE_PROMPT_CACHING_HAIKU` | Haiku 모델에 대해 프롬프트 캐싱을 비활성화하려면 `1`로 설정하세요 |

434| `DISABLE_PROMPT_CACHING_OPUS` | Opus 모델에 대해 프롬프트 캐싱을 비활성화하려면 `1`로 설정하세요 |

435| `DISABLE_PROMPT_CACHING_SONNET` | Sonnet 모델에 대해 프롬프트 캐싱을 비활성화하려면 `1`로 설정하세요 |

436| `DISABLE_TELEMETRY` | 원격 분석을 옵트아웃하려면 `1`과 같은 비어있지 않은 값으로 설정하세요. **`0` 또는 `false`로 설정해도 옵트아웃됩니다**. 대부분의 온/오프 변수와 달리 변수를 설정 해제하여 원격 분석을 다시 켜세요. 원격 분석 이벤트는 코드, 파일 경로, bash 명령과 같은 사용자 데이터를 포함하지 않습니다. 또한 `DISABLE_GROWTHBOOK`과 동일한 효과로 기능 플래그 가져오기를 비활성화합니다. 이는 [원격 제어](/docs/ko/remote-control#requirements) 및 기타 [기능 플래그 가져오기가 필요한 기능](#features-that-need-feature-flag-fetching)을 사용할 수 없게 만듭니다. [조직의 원격 분석 끄기](/docs/ko/managed-settings#turn-telemetry-off-for-your-organization)를 참조하세요 |

437| `DISABLE_UPDATES` | 수동 `claude update` 및 `claude install`을 포함한 모든 업데이트를 차단하려면 `1`로 설정하세요. `DISABLE_AUTOUPDATER`보다 더 엄격합니다. 자신의 채널을 통해 Claude Code를 배포하고 사용자가 자동 업데이트하지 않아야 할 때 사용합니다 |

438| `DISABLE_UPGRADE_COMMAND` | `/upgrade` 명령을 숨기려면 `1`로 설정하세요 |

439| `DO_NOT_TRACK` | `DISABLE_TELEMETRY`와 동일한 효과로 원격 분석을 옵트아웃하려면 `1`로 설정하세요. [원격 제어](/docs/ko/remote-control#requirements) 및 기타 [기능 플래그 가져오기가 필요한 기능](#features-that-need-feature-flag-fetching)을 사용할 수 없게 만듭니다. Claude Code는 이 변수를 표준 부울로 읽으므로 `0`은 원격 분석을 켜고, 많은 개발자 CLI에서 인식하는 교차 도구 규칙을 존중합니다 |

440| `ENABLE_BETA_TRACING_DETAILED` | `BETA_TRACING_ENDPOINT`와 함께 [상세 베타 추적](/docs/ko/monitoring-usage#traces-beta)을 켜려면 `1`로 설정하세요. 콘텐츠 베어링 스팬 속성 및 `claude_code.hook` 스팬을 추가합니다. 대화형 CLI 세션도 조직이 베타에 대해 허용 목록에 있어야 합니다. 두 변수 모두 [프로젝트 및 로컬 설정](/docs/ko/settings-reference#variables-claude-code-ignores-in-env)에서는 무시됩니다 |

441| `ENABLE_CLAUDEAI_MCP_SERVERS` | 로그인한 사용자에 대해 기본적으로 활성화된 [claude.ai MCP 서버](/docs/ko/mcp#use-mcp-servers-from-claude-ai)를 가져오지 않도록 하려면 `false`로 설정하세요. 프로젝트 또는 조직별로 비활성화하려면 설정에서 [`disableClaudeAiConnectors`](/docs/ko/settings-reference#disableclaudeaiconnectors)를 설정하세요 |

442| `ENABLE_PROMPT_CACHING_1H` | 기본 5분 대신 1시간 [프롬프트 캐시 TTL](/docs/ko/prompt-caching#cache-lifetime)을 요청하려면 `1`로 설정하세요. API 키, [Amazon Bedrock](/docs/ko/amazon-bedrock), [Google Cloud의 Agent Platform](/docs/ko/google-vertex-ai), [Microsoft Foundry](/docs/ko/microsoft-foundry), [AWS의 Claude Platform](/docs/ko/claude-platform-on-aws) 사용자를 위한 것입니다. 포함된 사용량 내의 구독 사용자는 [주 대화](/docs/ko/prompt-caching#which-ttl-each-request-gets)에서 자동으로 1시간 TTL을 받습니다. [사용 크레딧](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)을 사용하는 구독 사용자는 1시간 TTL을 유지하도록 설정할 수 있습니다. 1시간 캐시 쓰기는 더 높은 속도로 청구됩니다. 요청 버킷별로 TTL을 선택하려면 `CLAUDE_CODE_PROMPT_CACHE_TTL` 및 `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`을 사용하세요. 이들이 이 변수보다 우선합니다 |

443| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | 더 이상 사용되지 않습니다. 대신 `ENABLE_PROMPT_CACHING_1H`을 사용하세요 |

444| `ENABLE_TOOL_SEARCH` | [MCP 도구 검색](/docs/ko/mcp#scale-with-mcp-tool-search)을 제어합니다. 설정되지 않으면, Claude Code는 기본적으로 모든 MCP 도구를 연기합니다. 그러나 Claude 4.5 세대보다 이전인 Google Cloud의 Agent Platform 모델, Azure에서 호스팅되는 Microsoft Foundry 배포, `ANTHROPIC_BASE_URL`이 비자사 호스트를 가리킬 때는 미리 로드합니다. `true`는 항상 연기하고 베타 헤더를 보냅니다. 예외는 동일한 Agent Platform 모델 및 Microsoft Foundry 배포입니다. 요청이 `tool_reference`를 지원하지 않는 프록시에서 실패합니다. `auto`는 도구 정의가 컨텍스트의 10% 이내에 맞을 때 미리 로드합니다. `auto:N`은 사용자 정의 임계값을 설정합니다(예: `auto:5`는 5%). `false`는 모든 도구를 미리 로드합니다. 자신이 설정한 값은 `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`가 설정되면 무시됩니다. v2.1.221 이전에는 Claude Code가 설정하지 않으면 Google Cloud의 Agent Platform의 모든 모델에 대해 도구 검색을 비활성화했습니다 |

445| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | 폴백 모델이 구성되지 않았을 때 반복된 과부하 오류에 대해 모든 모델의 재시도를 중지하도록 하려면 `1`과 같은 비어있지 않은 값으로 설정하세요. **`0` 또는 `false`로 설정해도 이를 활성화합니다**. 대부분의 온/오프 변수와 달리 변수를 설정 해제하여 기본 재시도 동작을 복원하세요. 이것이 없으면, Claude Code는 API 키 또는 [타사 제공자](/docs/ko/third-party-integrations)를 사용하여 인증할 때 Opus, Fable, Mythos 모델로 인식하는 모델에 대해 이 방식으로 재시도를 중지합니다. Claude 구독을 사용하는 경우는 아닙니다. Claude Code v2.1.160 이상에서 Claude Code는 반복된 과부하 오류에 대해 모든 기본 모델에 대해 구성된 [폴백 모델 체인](/docs/ko/model-config#fallback-model-chains)으로 전환하므로 이 변수는 폴백 모델로의 전환에 영향을 주지 않습니다 |

446| `FORCE_AUTOUPDATE_PLUGINS` | 주 자동 업데이트가 `DISABLE_AUTOUPDATER`를 통해 비활성화되었을 때도 플러그인 자동 업데이트를 강제하려면 `1`로 설정하세요 |

447| `FORCE_HYPERLINK` | 터미널이 지원하지만 자동 감지되지 않을 때 클릭 가능한 OSC 8 하이퍼링크를 활성화하려면 `1`로 설정하거나, 비활성화하려면 `0`으로 설정하세요. 설정되지 않으면, Claude Code는 터미널 지원을 감지할 때만 하이퍼링크를 활성화합니다. Claude Code는 이 값을 부울이 아닌 숫자로 구문 분석하므로 `false`, `no`, `off`와 같은 값은 하이퍼링크를 비활성화하는 대신 활성화합니다. 바닥글 [PR 또는 병합 요청 배지](/docs/ko/interactive-mode#pr-review-status)는 Claude Code가 터미널 지원을 감지할 수 없을 때(예: SSH를 통해)도 하이퍼링크로 렌더링됩니다. 배지를 일반 텍스트로 렌더링하려면 `0`으로 설정하세요 |

448| `FORCE_PROMPT_CACHING_5M` | 1시간 TTL이 그렇지 않으면 적용되더라도 5분 프롬프트 캐시 TTL을 강제하려면 `1`로 설정하세요. `CLAUDE_CODE_PROMPT_CACHE_TTL`, `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, `ENABLE_PROMPT_CACHING_1H`, `promptCacheTtl` 및 `subagentPromptCacheTtl` 설정을 재정의합니다 |

449| `HTTP_PROXY` | 네트워크 연결을 위한 HTTP 프록시 서버를 지정합니다 |

450| `HTTPS_PROXY` | 네트워크 연결을 위한 HTTPS 프록시 서버를 지정합니다 |

451| `IS_DEMO` | 데모 모드를 활성화하려면 `1`과 같은 비어있지 않은 값으로 설정하세요: 헤더 및 `/status` 출력에서 이메일 및 조직 이름을 숨기고 온보딩을 건너뜁니다. **`0` 또는 `false`로 설정해도 데모 모드가 활성화됩니다**. 대부분의 온/오프 변수와 달리 변수를 설정 해제하여 끄세요. 세션을 스트리밍하거나 녹화할 때 유용합니다 |

452| `MAX_MCP_OUTPUT_TOKENS` | MCP 도구 응답에서 허용되는 최대 토큰 수입니다. Claude Code는 출력이 10,000 토큰을 초과할 때 경고를 표시합니다. [`anthropic/maxResultSizeChars`](/docs/ko/mcp#raise-the-limit-for-a-specific-tool)를 선언하는 도구는 텍스트 콘텐츠에 대해 해당 문자 제한을 대신 사용하지만, 해당 도구의 이미지 콘텐츠는 여전히 이 변수의 영향을 받습니다(기본값: 25000) |

453| `MAX_STRUCTURED_OUTPUT_RETRIES` | 비대화형 모드에서 `-p` 플래그를 사용한 [`--json-schema`](/docs/ko/cli-reference#cli-flags)에 대한 유효성 검사에 실패할 때 Claude Code가 허용하는 시도 횟수입니다. 그 이후 유효한 출력이 없으면 실행이 실패합니다. [워크플로우](/docs/ko/workflows) 서브에이전트의 구조화된 출력이 유효성 검사에 실패할 때도 동일한 상한이 적용됩니다. 기본값 5, 첫 번째 시도 및 4번의 재시도 |

454| `MAX_THINKING_TOKENS` | [확장 사고](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)의 고정 토큰 예산입니다. Claude Code는 요청의 최대 출력 토큰보다 1개 토큰 아래로 제한하고 1,024 이상으로 제한하지 않습니다. [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/ko/model-config#adjust-effort-level)에서 해당 제한이 설정되는 방식을 참조하세요. 설정되지 않고 사고가 활성화되면, [적응형 추론](/docs/ko/model-config#adjust-effort-level)을 가진 모델은 자신의 사고 깊이를 선택하고, 다른 모델은 상한을 사용합니다. Anthropic API에서 사고를 비활성화하려면 `0`으로 설정하세요. Fable 모델은 예외입니다. 이들은 사고를 끌 수 없습니다. [타사 제공자](/docs/ko/third-party-integrations)에서 `0`은 대신 `thinking` 매개변수를 생략합니다. Anthropic API에서 사고가 꺼져 있으면, Claude Code는 Opus 5와 같이 [해당 조합을 받지 않는 모델](/docs/ko/errors#effort-isnt-available-with-thinking-turned-off)에 노력 `high`를 대신 보냅니다. Claude Code는 적응형 추론 모델의 0이 아닌 값을 무시합니다. 적응형 추론을 끄는 모델은 예외입니다. `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`이 적응형 추론을 끕니다 |

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

456| `MCP_CONNECTION_NONBLOCKING` | MCP 서버가 첫 번째 쿼리 전에 연결될 때까지 시작이 대기하는지 여부를 제어합니다. MCP 시작은 기본적으로 비차단입니다: 서버는 백그라운드에서 연결되고 도구는 완료되면 사용 가능해집니다. 첫 번째 쿼리 전에 서버가 연결될 때까지 기다리려면 `0`으로 설정하세요. [`alwaysLoad: true`](/docs/ko/mcp#exempt-a-server-from-deferral)로 구성된 서버는 여전히 시작을 기다리게 합니다. 예외는 [검색 캐시](/docs/ko/mcp#server-status-detail)에서 제공되는 경우입니다. 도구가 첫 번째 프롬프트를 구성할 때 존재해야 하기 때문입니다. 비대화형 모드(`-p`)에서 Claude Code는 여전히 첫 번째 턴 전에 보류 중인 서버를 기다립니다. 이 변수에 관계없이 더 긴 마감일이 있습니다. [`--mcp-config`](/docs/ko/cli-reference#cli-flags)를 명시적으로 전달할 때 캐시된 서버 예외를 참조하세요 |

457| `MCP_CONNECT_TIMEOUT_MS` | 차단 MCP 시작이 도구 목록을 스냅샷하기 전에 연결 배치를 기다리는 시간(밀리초)(기본값: 5000). `MCP_CONNECTION_NONBLOCKING=0`이거나 [`alwaysLoad: true`](/docs/ko/mcp#exempt-a-server-from-deferral)로 표시된 서버에 적용됩니다. 서버는 마감일에서 보류 중인 상태로 백그라운드에서 계속 연결됩니다. `MCP_TIMEOUT`과는 다릅니다. 이는 개별 서버의 연결 시도를 제한합니다 |

458| `MCP_DISCOVERY_CACHE` | [MCP 검색 캐시](/docs/ko/mcp#server-status-detail)를 켜거나 끕니다. 캐시가 켜져 있으면, 이전에 사용한 원격 HTTP 또는 SSE 서버가 [`cached` 상태](/docs/ko/mcp#server-status-detail)를 표시할 수 있고, Claude Code는 시작 시 대신 첫 번째 도구 호출에서 연결합니다. 캐시는 기본적으로 꺼져 있습니다. 점진적 롤아웃이 계정에 대해 활성화하지 않으면 말입니다. 켜려면 `1`로 설정하거나, 롤아웃이 활성화했을 때도 꺼두려면 `0`으로 설정하세요. v2.1.238 이전에는 캐시가 기본적으로 켜져 있었습니다. `cached` 상태에는 Claude Code v2.1.221 이상이 필요합니다 |

459| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | [검색 캐시](/docs/ko/mcp#server-status-detail) 항목의 최대 나이(초)입니다 (기본값: 14400, 또는 4시간). 항목이 그보다 오래된 시작에서 Claude Code는 이를 버리고 시작 시 서버를 연결합니다. 캐시가 꺼져 있을 때처럼 말입니다. Claude Code는 값을 7일로 제한합니다. v2.1.238 이전에는 기본값이 86400(24시간)이었고 Claude Code는 값을 제한하지 않았습니다 |

460| `MCP_DISCOVERY_CACHE_STRIKES` | [검색 캐시](/docs/ko/mcp#server-status-detail) 항목이 `MCP_DISCOVERY_CACHE_TTL_S`보다 오래된 시작에서 Claude Code는 백그라운드에서 새로 고칩니다. 이 변수는 새로 고침이 연속으로 실패할 수 있는 횟수를 설정합니다. 그 후 Claude Code는 항목을 버리고 다음 시작에서 서버를 대신 연결합니다(기본값: 1). 네트워크 연결이 가끔 끊어지면 이를 올리세요. 하나의 실패한 새로 고침이 항목을 버리지 않도록 합니다. Claude Code v2.1.238 이상이 필요합니다 |

461| `MCP_DISCOVERY_CACHE_TTL_S` | Claude Code가 [검색 캐시](/docs/ko/mcp#server-status-detail) 항목을 새로 고치지 않고 사용하는 시간(초)(기본값: 900). 항목이 그보다 오래된 시작에서 Claude Code는 여전히 사용하지만 백그라운드에서 새로 고칩니다. 항목이 `MCP_DISCOVERY_CACHE_MAX_STALE_S`보다 오래되면 Claude Code는 버립니다. Claude Code는 값을 `MCP_DISCOVERY_CACHE_MAX_STALE_S`로 제한합니다. 기본값은 4시간입니다. v2.1.238 이전에는 Claude Code가 값을 제한하지 않았습니다 |

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

463| `MCP_PROTOCOL_NEGOTIATION` | [v2 MCP 클라이언트 런타임](/docs/ko/mcp#mcp-client-runtimes)에서만, Claude Code가 MCP 프로토콜 개정 2026-07-28에 대해 서버를 탐사하는지 여부입니다. HTTP, claude.ai 커넥터, stdio 서버를 탐사하려면 `auto`로 설정하세요. 탐사에 응답하지 않는 서버는 이전 프로토콜에서 연결됩니다. SSE 및 WebSocket 서버는 항상 그렇게 합니다. 모든 서버에 대해 탐사를 건너뛰려면 `legacy`로 설정하세요. 변수가 없으면, Claude Code는 Claude Code v2.1.232 이상에서 HTTP 및 claude.ai 커넥터 서버를 탐사합니다. [MCP 클라이언트 런타임](/docs/ko/mcp#mcp-client-runtimes) 섹션이 나열하는 예외가 있습니다. 다른 값은 무시되고 디버그 로그에 경고가 표시됩니다. Claude Code는 프로세스당 한 번 값을 읽습니다. Claude Code v2.1.221 이상이 필요합니다 |

464| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | 시작 중에 병렬로 연결할 원격 MCP 서버(HTTP/SSE)의 최대 개수입니다(기본값: 20) |

465| `MCP_SDK_GENERATION` | 이 프로세스가 MCP 서버에 연결하는 [MCP 클라이언트 런타임](/docs/ko/mcp#mcp-client-runtimes)을 고정합니다: `v1`(MCP TypeScript SDK 1.x 기반) 또는 `v2`([MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/) 기반). 변수가 없으면, Claude Code는 Claude Code v2.1.232 이상에서 v2를 사용합니다. 해당 섹션이 v1을 사용한다고 말하는 경우는 제외합니다. Claude Code v2.1.221 이상에서 v2 런타임은 MCP OAuth 서버가 인증 응답에서 반환하는 발급자를 확인하고 일치하지 않으면 `Issuer mismatch in authorization response`로 시작하는 오류로 로그인을 실패합니다. v1 런타임은 이 확인을 실행하지 않습니다. 인식되지 않은 값을 설정하면 Claude Code는 무시하고 디버그 로그에 경고를 작성합니다. Claude Code는 프로세스당 한 번 값을 읽습니다. Claude Code v2.1.218 이상이 필요합니다 |

466| `MCP_SERVER_CONNECTION_BATCH_SIZE` | 시작 중에 병렬로 연결할 로컬 MCP 서버(stdio)의 최대 개수입니다(기본값: 3) |

370| `MCP_TOOL_TIMEOUT` | MCP 도구 실행의 타임아웃(밀리초)(기본값: 100000000, 약 28시간). HTTP, SSE, WebSocket 또는 [claude.ai 커넥터](/docs/ko/mcp#use-mcp-servers-from-claude-ai) MCP 서버의 경우 각 요청도 기본적으로 60초 후 타임아웃됩니다. 이 변수 또는 서버별 `timeout`을 60000 이상으로 설정하여 요청별 제한을 올립니다. 더 낮은 값은 여전히 전체 도구 실행 타임아웃을 단축하지만 요청별 제한을 60초로 유지합니다. Stdio 및 WebSocket 서버에는 요청별 타이머가 없습니다. `.mcp.json`의 서버별 `timeout` 필드가 해당 서버에 대해 이를 재정의합니다. {{/* min-version: 2.1.203 */}}서버별 `timeout`이 최소 1000이면 해당 서버의 도구 호출에 대한 최소 유휴 윈도우를 설정하므로 `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`이 더 빨리 중단하지 않습니다. 이 하한은 Claude Code v2.1.203 이상이 필요합니다. 환경 변수의 경우 1000 미만의 값은 1초로 내림됩니다. 서버별 필드의 경우 1000 미만의 값은 무시됩니다. |468| `MCP_TOOL_TIMEOUT` | MCP 도구 실행의 타임아웃(밀리초)(기본값: 100000000, 약 28시간). HTTP, SSE, claude.ai 커넥터 서버의 경우, 각 요청도 기본적으로 60초 후 타임아웃됩니다. 이 변수를 설정하거나 서버별 `timeout`을 60000 이상으로 설정하여 요청당 제한을 올리세요. 더 낮은 값은 여전히 전체 도구 실행 타임아웃을 단축하지만 요청당 제한을 60초로 유지합니다. Stdio 및 WebSocket 서버에는 요청당 타이머가 없습니다. `.mcp.json`의 서버별 `timeout` 필드가 이를 재정의합니다. 서버별 `timeout`이 최소 1000이면 해당 서버의 도구 호출에 대한 최소 유휴 창도 설정합니다. `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`이 더 일찍 중단하지 않습니다. 이 바닥은 Claude Code v2.1.203 이상이 필요합니다. 변수의 경우 1000 미만의 값은 1초로 올라갑니다. 서버별 필드의 경우 1000 미만의 값은 무시됩니다 |

372| `OTEL_LOG_ASSISTANT_RESPONSES` | 모델의 응답 텍스트를 `assistant_response` OpenTelemetry 로그 이벤트에 포함하려면 `1`로 설정합니다. 설정하지 않으면 `OTEL_LOG_USER_PROMPTS`의 값이 사용됩니다. `OTEL_LOG_USER_PROMPTS`가 설정된 경우에도 응답을 수정된 상태로 유지하려면 `0`으로 설정합니다. Claude Code v2.1.193 이상이 필요합니다. [모니터링](/docs/ko/monitoring-usage#assistant-response-event) 참조 |470| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | 속성 값 길이에 대한 표준 OpenTelemetry SDK 제한입니다. Claude Code는 콘텐츠 베어링 원격 분석 속성을 이것과 `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`의 더 작은 값으로 제한하므로 잘림 마커가 SDK 제한 내에 유지됩니다. Claude Code는 `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` 및 `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT` 변형을 동일하게 읽고, 설정된 가장 작은 값이 모든 신호에 적용됩니다. Claude Code v2.1.214 이상이 필요합니다. [모니터링](/docs/ko/monitoring-usage#common-configuration-variables)을 참조하세요 |

373| `OTEL_LOG_RAW_API_BODIES` | Anthropic Messages API 요청 및 응답 JSON을 `api_request_body` / `api_response_body` 로그 이벤트로 내보냅니다. 60KB에서 잘린 인라인 본문의 경우 `1`로 설정하거나, 잘리지 않은 본문을 디스크에 쓰고 `body_ref` 경로를 내보내려면 `file:<dir>`로 설정합니다. 기본적으로 비활성화됩니다. 본문에는 전체 대화 기록이 포함됩니다. [모니터링](/docs/ko/monitoring-usage#api-request-body-event) 참조 |471| `OTEL_LOG_ASSISTANT_RESPONSES` | `assistant_response` OpenTelemetry 로그 이벤트에 모델의 응답 텍스트를 포함하려면 `1`로 설정하세요. 설정되지 않으면 `OTEL_LOG_USER_PROMPTS`의 값이 대신 사용됩니다. `OTEL_LOG_USER_PROMPTS`가 설정되었을 때도 응답을 편집된 상태로 유지하려면 `0`으로 설정하세요. Claude Code v2.1.193 이상이 필요합니다. [모니터링](/docs/ko/monitoring-usage#assistant-response-event)을 참조하세요 |

374| `OTEL_LOG_TOOL_CONTENT` | 도구 입력 및 출력 내용을 OpenTelemetry 스팬 이벤트에 포함하려면 `1`로 설정합니다. 민감한 데이터를 보호하기 위해 기본적으로 비활성화됩니다. [모니터링](/docs/ko/monitoring-usage) 참조 |472| `OTEL_LOG_RAW_API_BODIES` | Anthropic Messages API 요청 및 응답 JSON을 `api_request_body` / `api_response_body` 로그 이벤트로 내보냅니다. 콘텐츠 제한으로 잘린 인라인 본문의 경우 `1`로 설정하거나, 잘리지 않은 본문을 디스크에 작성하고 `body_ref` 경로를 내보내려면 `file:<dir>`로 설정하세요. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`는 콘텐츠 제한을 구성합니다. 기본값 60KB입니다. 기본적으로 비활성화됩니다. 본문은 전체 대화 기록을 포함합니다. 셸, 사용자 설정, 관리 설정에서 설정하세요. [프로젝트 및 로컬 설정](/docs/ko/settings-reference#variables-claude-code-ignores-in-env)에서는 무시됩니다. [모니터링](/docs/ko/monitoring-usage#api-request-body-event)을 참조하세요 |

375| `OTEL_LOG_TOOL_DETAILS` | 도구 입력 인수, MCP 서버 이름, 사용자 작성 워크플로우 이름, 도구 실패 시 원본 오류 문자열, `api_refusal` 이벤트의 거부 `category`, 기타 도구 세부 정보를 OpenTelemetry 추적 및 로그에 포함하려면 `1`로 설정합니다. PII를 보호하기 위해 기본적으로 비활성화됩니다. [모니터링](/docs/ko/monitoring-usage) 참조 |473| `OTEL_LOG_TOOL_CONTENT` | OpenTelemetry 스팬 이벤트에 도구 입력 및 출력 콘텐츠를 포함하려면 `1`로 설정하세요. 기본적으로 비활성화되어 민감한 데이터를 보호합니다. [모니터링](/docs/ko/monitoring-usage)을 참조하세요 |

376| `OTEL_LOG_USER_PROMPTS` | 사용자 프롬프트 텍스트를 OpenTelemetry 추적 및 로그에 포함하려면 `1`로 설정합니다. 기본적으로 비활성화됩니다(프롬프트는 수정됨). [모니터링](/docs/ko/monitoring-usage) 참조 |474| `OTEL_LOG_TOOL_DETAILS` | OpenTelemetry 추적 및 로그에 도구 입력 인수, MCP 서버 이름, 사용자 작성 워크플로우 이름, 도구 실패 시 원본 오류 문자열, `api_refusal` 이벤트의 거부 `category`, 기타 도구 세부 정보를 포함하려면 `1`로 설정하세요. 기본적으로 비활성화되어 PII를 보호합니다. [모니터링](/docs/ko/monitoring-usage)을 참조하세요 |

377| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | 메트릭 속성에서 계정 UUID를 제외하려면 `false`로 설정합니다(기본값: 포함). [모니터링](/docs/ko/monitoring-usage) 참조 |475| `OTEL_LOG_USER_PROMPTS` | OpenTelemetry 추적 및 로그에 사용자 프롬프트 텍스트를 포함하려면 `1`로 설정하세요. 기본적으로 비활성화됩니다(프롬프트는 편집됨). [모니터링](/docs/ko/monitoring-usage)을 참조하세요 |

378| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | 메트릭 속성에 세션 진입점을 포함하려면 `true`로 설정합니다(기본값: 제외). v2.1.152에서 추가됨. [모니터링](/docs/ko/monitoring-usage) 참조 |476| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | 메트릭 속성에서 계정 UUID를 제외하려면 `false`로 설정하세요(기본값: 포함). [모니터링](/docs/ko/monitoring-usage)을 참조하세요 |

379| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | v2.1.161부터 Claude Code는 `OTEL_RESOURCE_ATTRIBUTES` 키를 메트릭 데이터포인트 레이블에 첨부합니다. 이를 제외하려면 `false`로 설정합니다(기본값: 포함). [모니터링](/docs/ko/monitoring-usage#multi-team-organization-support) 참조 |477| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | 메트릭 속성에 세션 진입점을 포함하려면 `true`로 설정하세요(기본값: 제외). v2.1.152에서 추가되었습니다. [모니터링](/docs/ko/monitoring-usage)을 참조하세요 |

380| `OTEL_METRICS_INCLUDE_SESSION_ID` | 메트릭 속성에서 세션 ID를 제외하려면 `false`로 설정합니다(기본값: 포함). [모니터링](/docs/ko/monitoring-usage) 참조 |478| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | v2.1.161부터 Claude Code는 `OTEL_RESOURCE_ATTRIBUTES` 키를 메트릭 데이터포인트 레이블에 첨부합니다. 제외하려면 `false`로 설정하세요(기본값: 포함). [모니터링](/docs/ko/monitoring-usage#multi-team-organization-support)을 참조하세요 |

381| `OTEL_METRICS_INCLUDE_VERSION` | 메트릭 속성에 Claude Code 버전을 포함하려면 `true`로 설정합니다(기본값: 제외). [모니터링](/docs/ko/monitoring-usage) 참조 |479| `OTEL_METRICS_INCLUDE_SESSION_ID` | 메트릭 속성에서 세션 ID를 제외하려면 `false`로 설정하세요(기본값: 포함). [모니터링](/docs/ko/monitoring-usage)을 참조하세요 |

382| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | [Skill 도구](/docs/ko/skills#control-who-invokes-a-skill)에 표시되는 skill 메타데이터의 문자 예산을 재정의합니다. 예산은 컨텍스트 윈도우의 1%에서 동적으로 확장되며, 8,000자의 폴백이 있습니다. 이전 버전과의 호환성을 위해 레거시 이름이 유지됩니다. |480| `OTEL_METRICS_INCLUDE_VERSION` | 메트릭 속성에 Claude Code 버전을 포함하려면 `true`로 설정하세요(기본값: 제외). [모니터링](/docs/ko/monitoring-usage)을 참조하세요 |

383| `TASK_MAX_OUTPUT_LENGTH` | 잘림 전 [subagent](/docs/ko/sub-agents) 출력의 최대 문자 수(기본값: 32000, 최대: 160000). 잘림 시 전체 출력이 디스크에 저장되고 경로가 잘린 응답에 포함됩니다. |481| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | [Skill 도구](/docs/ko/skills#control-who-invokes-a-skill)에 표시되는 기술 메타데이터의 문자 예산을 재정의합니다. 예산은 컨텍스트 창의 1%에서 동적으로 확장되며, 폴백은 8,000자입니다. 이전 호환성을 위해 레거시 이름이 유지됩니다 |

384| `USE_BUILTIN_RIPGREP` | Claude Code에 포함된 `rg` 대신 시스템 설치 `rg`를 사용하려면 `0`으로 설정합니다. |482| `TASK_MAX_OUTPUT_LENGTH` | [백그라운드 작업](/docs/ko/tools-reference#background-commands)의 출력 중 `TaskOutput` 도구가 유지하는 최대 문자 수입니다(기본값: 32000; 최대값: 160000). [`taskOutputMaxChars`](/docs/ko/settings-reference#taskoutputmaxchars) 설정을 설정하면, Claude Code는 이 변수를 무시합니다 |

~~400~~ 498| `VERTEX_REGION_CLAUDE_FABLE_5` | Google Cloud의 Agent Platform을 사용할 때 Claude Fable 5의 리전을 재정의합니다. v2.1.170에서 추가되었습니다 |

401표준 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` 및 신호별 변형)도 지원됩니다. 구성 세부 정보는 [모니터링](/docs/ko/monitoring-usage)을 참조합니다.499| `VERTEX_REGION_CLAUDE_FABLE_5_1` | Google Cloud의 Agent Platform을 사용할 때 Claude Fable 5.1의 리전을 재정의합니다. v2.1.257에서 추가되었습니다 |

500| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Google Cloud의 Agent Platform을 사용할 때 Claude Haiku 4.5의 리전을 재정의합니다 |

501

502표준 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`, 신호 특정 변형)도 지원됩니다. 구성 세부 정보는 [모니터링](/docs/ko/monitoring-usage)을 참조하세요.

503

504<h2 id="features-that-need-feature-flag-fetching">

505 기능 플래그 가져오기가 필요한 기능

506</h2>

507

508Claude Code는 Anthropic에서 가져오는 기능 플래그를 통해 일부 기능을 활성화합니다. Claude Code는 다음 세션에서 해당 가져오기를 건너뜁니다:

509

510* `DISABLE_GROWTHBOOK`, `DISABLE_TELEMETRY`, `DO_NOT_TRACK` 또는 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`을 설정한 세션; [변수 테이블](#variables)의 각 변수 행에서 어떤 값이 가져오기를 비활성화하는지 나타냅니다

511* Amazon Bedrock, Claude Platform on AWS, Google Cloud의 Agent Platform 또는 Microsoft Foundry와 같은 [타사 제공자](/docs/ko/third-party-integrations)의 세션(Claude Code를 포함하는 호스트 플랫폼이 `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`를 설정하지 않은 경우)

512* [Claude 앱 게이트웨이](/docs/ko/claude-apps-gateway) 세션

513

514가져오기가 비활성화된 경우 다음을 수행할 수 없습니다:

515

516* Pro, Max 및 Team 플랜에서 [기본적으로 자동 모드로 세션 시작](/docs/ko/permission-modes#which-mode-a-session-starts-in)

517* VS Code 확장이 [시작 권한 모드에 대한 설정 파일 읽기](/docs/ko/permission-modes#switch-permission-modes)

518* [`/auto-mode-setup`](/docs/ko/auto-mode-config#generate-environment-entries)을 실행하여 `autoMode.environment` 항목 작성

519* [원격 제어](/docs/ko/remote-control#requirements) 사용

520* [이 머신을 넘어 세션에 메시지 전송](/docs/ko/cross-session-messaging#message-sessions-on-other-machines); 이 머신의 세션 간 메시징은 가져오기가 비활성화된 상태에서 작동합니다

521* [`claude import` 또는 `/import` 명령 실행](/docs/ko/cli-reference#cli-commands)

522* [`/skill-doctor`](/docs/ko/skills#find-unused-skills) 실행 또는 `/plugin` **Stats** 탭에서 보고서 열기

523* [어드바이저 도구](/docs/ko/advisor#requirements) 사용

524* [아티팩트의 댓글](/docs/ko/artifacts#collect-comments-on-an-artifact) 읽기 또는 답글 달기

525* `MCP_SDK_GENERATION` 및 `MCP_PROTOCOL_NEGOTIATION`을 설정하지 않고 [v2 MCP 클라이언트 런타임](/docs/ko/mcp#mcp-client-runtimes) 및 해당 프로토콜 프로브 가져오기; Claude Code는 `MCP_SDK_GENERATION=v2`를 설정하지 않으면 v1 런타임을 사용하고, `MCP_PROTOCOL_NEGOTIATION=auto`를 설정하지 않으면 프로브를 건너뜁니다

526* Git Bash가 설치된 Windows의 claude.ai 및 Console 계정에 대해 기본적으로 [PowerShell 도구](/docs/ko/tools-reference#powershell-tool) 가져오기; Claude Code는 `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`을 설정하지 않으면 Git Bash를 통해 셸 명령을 라우팅합니다. Git Bash가 없는 Windows에서는 도구가 활성화된 상태로 유지됩니다

527* [Claude가 작성한 피드백](/docs/ko/tools-reference#sendfeedback-tool-behavior) 가져오기(Claude Code는 가져온 플래그를 통해 활성화)

528* Claude Code가 [API가 거부할 입력 스키마를 가진 MCP 도구 제외](/docs/ko/mcp#tools-with-invalid-input-schemas); 스키마를 어쨌든 전송하고, 이를 포함하는 요청은 [도구를 위치로 이름 지정하는 400 오류](/docs/ko/errors#tool-input-schema-is-invalid)로 실패합니다

529

530<h3 id="first-session-after-an-install-or-upgrade">

531 설치 또는 업그레이드 후 첫 번째 세션

532</h3>

533

534Claude Code를 설치한 후 또는 기능을 추가하는 버전으로 업그레이드한 후 첫 번째 세션에서 [플래그 게이트된 기능](#features-that-need-feature-flag-fetching)이 누락될 수 있으며, 세션은 자동 모드로 시작하는 플랜에서 수동 모드로 시작할 수 있습니다. Claude Code는 해당 세션 중에 플래그를 가져오므로 다음 세션에서 둘 다 있습니다.

535

536새로 설치한 후 `claude -p`, Agent SDK 또는 VS Code 확장과 같은 비대화형 세션에서 Claude Code는 [시작 권한 모드를 선택](/docs/ko/permission-modes#which-mode-a-session-starts-in)하기 전에 플래그를 선택할 수 있습니다.

402 537

403<h2 id="see-also">538<h2 id="see-also">

404 참고 항목539 참고 항목

env-vars.md 2026-09-11 23:01 UTC to 2026-09-12 03:02 UTC

환경 변수

환경 변수 설정

셸에서

설정 파일에서

우선순위

변수

기능 플래그 가져오기가 필요한 기능

설치 또는 업그레이드 후 첫 번째 세션

참고 항목