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)을 참조하세요 |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)을 참조하세요 |
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)을 참조하세요 |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)을 참조하세요 |
156| `ANTHROPIC_BETAS` | API 요청에 포함할 추가 `anthropic-beta` 헤더 값의 쉼표로 구분된 목록입니다. Claude Code는 이미 필요한 베타 헤더를 전송합니다. Claude Code가 기본 지원을 추가하기 전에 [Anthropic API 베타](https://platform.claude.com/docs/en/api/beta-headers)에 옵트인하려면 이를 사용하세요. [`--betas` 플래그](/docs/ko/cli-reference#cli-flags)와 달리 API 키 인증이 필요하지만, 이 변수는 Claude.ai 구독을 포함한 모든 인증 방법에서 작동합니다 |156| `ANTHROPIC_BETAS` | API 요청에 포함할 추가 `anthropic-beta` 헤더 값의 쉼표로 구분된 목록입니다. Claude Code는 이미 필요한 베타 헤더를 전송합니다. Claude Code가 기본 지원을 추가하기 전에 [Anthropic API 베타](https://platform.claude.com/docs/en/api/beta-headers)에 옵트인하려면 이를 사용하세요. [`--betas` 플래그](/docs/ko/cli-reference#cli-flags)와 달리 API 키 인증이 필요하지만, 이 변수는 Claude.ai 구독을 포함한 모든 인증 방법에서 작동합니다 |
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)으로 계산됩니다. 프로젝트 또는 로컬 설정에서 이러한 값은 [#in-settings-files](/docs/ko/settings-reference#in-settings-files)에서 [`env` 값이 적용되는 시기에 대한 규칙](/docs/ko/settings-reference#when-claude-code-applies-env-values)을 따릅니다 |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)을 따릅니다 |
158| `ANTHROPIC_CUSTOM_MODEL_OPTION` | `/model` 선택기에 사용자 정의 항목으로 추가할 모델 ID입니다. 기본 제공 별칭을 대체하지 않고 비표준 또는 게이트웨이 특정 모델을 선택 가능하게 만드는 데 사용합니다. [모델 구성](/docs/ko/model-config#add-a-custom-model-option)을 참조하세요 |158| `ANTHROPIC_CUSTOM_MODEL_OPTION` | `/model` 선택기에 사용자 정의 항목으로 추가할 모델 ID입니다. 기본 제공 별칭을 대체하지 않고 비표준 또는 게이트웨이 특정 모델을 선택 가능하게 만드는 데 사용합니다. [모델 구성](/docs/ko/model-config#add-a-custom-model-option)을 참조하세요 |
159| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | `/model` 선택기의 사용자 정의 모델 항목에 대한 표시 설명입니다. 설정하지 않으면 `Custom model (<model-id>)`로 기본값이 설정됩니다 |159| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | `/model` 선택기의 사용자 정의 모델 항목에 대한 표시 설명입니다. 설정하지 않으면 `Custom model (<model-id>)`로 기본값이 설정됩니다 |
160| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | `/model` 선택기의 사용자 정의 모델 항목에 대한 표시 이름입니다. 설정하지 않으면 Claude Code가 [ID를 인식](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)하는 경우 모델의 이름을 표시하고, 그렇지 않으면 모델 ID를 표시합니다 |160| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | `/model` 선택기의 사용자 정의 모델 항목에 대한 표시 이름입니다. 설정하지 않으면 Claude Code가 [ID를 인식](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)하는 경우 모델의 이름을 표시하고, 그렇지 않으면 모델 ID를 표시합니다 |
271| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | 공식 플러그인 마켓플레이스의 자동 등록을 비활성화하려면 `1`로 설정하세요. Claude Code는 마켓플레이스를 등록하려고 할 때 변수를 읽습니다. 보통 머신의 첫 대화형 시작 중입니다. 그 시점에 변수가 설정되면 Claude Code는 등록을 영구적으로 건너뜁니다. 나중에 변수를 설정 해제해도 건너뛰기가 취소되지 않습니다. 언제든지 `claude plugin marketplace add anthropics/claude-plugins-official`을 실행하여 마켓플레이스를 등록하세요 |271| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | 공식 플러그인 마켓플레이스의 자동 등록을 비활성화하려면 `1`로 설정하세요. Claude Code는 마켓플레이스를 등록하려고 할 때 변수를 읽습니다. 보통 머신의 첫 대화형 시작 중입니다. 그 시점에 변수가 설정되면 Claude Code는 등록을 영구적으로 건너뜁니다. 나중에 변수를 설정 해제해도 건너뛰기가 취소되지 않습니다. 언제든지 `claude plugin marketplace add anthropics/claude-plugins-official`을 실행하여 마켓플레이스를 등록하세요 |
272| `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 이상이 필요합니다 |272| `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 이상이 필요합니다 |
273| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | 시스템 전체 관리 기술 디렉토리에서 기술 로드를 건너뛰려면 `1`로 설정하세요. 운영자가 프로비저닝한 기술을 로드하지 않아야 하는 컨테이너 또는 CI 세션에 유용합니다 |273| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | 시스템 전체 관리 기술 디렉토리에서 기술 로드를 건너뛰려면 `1`로 설정하세요. 운영자가 프로비저닝한 기술을 로드하지 않아야 하는 컨테이너 또는 CI 세션에 유용합니다 |
274| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | 대화 컨텍스트를 기반으로 자동 터미널 제목 업데이트를 비활성화하려면 `1`로 설정하세요. 또한 세션 제목을 생성하는 백그라운드 소형/빠른 모델 요청을 건너뜁니다 |274| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | 대화 컨텍스트를 기반으로 자동 터미널 제목 업데이트를 비활성화하려면 `1`로 설정하세요. 또한 [세션 제목을 생성하는](/docs/ko/sessions#name-your-sessions) 백그라운드 소형/빠른 모델 요청을 건너뜁니다 |
275| `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`은 마찬가지로 매개변수를 생략하므로 두 변수는 동일하게 작동합니다 |275| `CLAUDE_CODE_DISABLE_THINKING` | API 요청에서 `thinking` 매개변수를 완전히 생략하려면 `1`로 설정하세요. 이는 매개변수를 거부하는 프록시 및 게이트웨이의 호환성 옵션입니다. 기본적으로 생각하는 모델에서 매개변수를 생략하면 모델이 여전히 생각할 수 있습니다. Anthropic API에서 [확장 사고](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)를 명시적으로 비활성화하려면 `MAX_THINKING_TOKENS=0`을 대신 사용하세요. 어느 변수도 Opus 5.5 또는 Fable 모델에서 사고를 끄지 않습니다. 이들은 사고를 끌 수 없습니다. [타사 제공자](/docs/ko/third-party-integrations)에서 `MAX_THINKING_TOKENS=0`은 마찬가지로 매개변수를 생략하므로 두 변수는 동일하게 작동합니다 |
276| `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 이상이 필요합니다 |276| `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 이상이 필요합니다 |
277| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | [전체 화면 렌더링](/docs/ko/fullscreen)에서 가상 스크롤을 비활성화하고 대화 기록의 모든 메시지를 렌더링하려면 `1`로 설정하세요. 전체 화면 모드에서 스크롤이 메시지가 나타나야 할 위치에 빈 영역을 표시하면 이를 사용하세요 |277| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | [전체 화면 렌더링](/docs/ko/fullscreen)에서 가상 스크롤을 비활성화하고 대화 기록의 모든 메시지를 렌더링하려면 `1`로 설정하세요. 전체 화면 모드에서 스크롤이 메시지가 나타나야 할 위치에 빈 영역을 표시하면 이를 사용하세요 |
278| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Windows에서 `cmd.exe` 런처를 통하지 않고 [PowerShell 도구](/docs/ko/tools-reference#powershell-tool) 명령을 직접 시작하려면 `1`로 설정하세요. 기본적으로 런처는 [백그라운드에서 실행](/docs/ko/tools-reference#background-commands) 중인 PowerShell 명령이 [세션의 다음 프로세스로 이월](/docs/ko/agent-view#the-supervisor-process)되도록 합니다(예: [`/background`](/docs/ko/agent-view#from-inside-a-session)로 세션을 백그라운드 처리할 때). 변수를 설정하면 백그라운드 PowerShell 명령이 세션의 프로세스가 종료될 때 중지됩니다. Bash 명령은 영향을 받지 않습니다. Claude Code v2.1.269 이상이 필요합니다 |278| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Windows에서 `cmd.exe` 런처를 통하지 않고 [PowerShell 도구](/docs/ko/tools-reference#powershell-tool) 명령을 직접 시작하려면 `1`로 설정하세요. 기본적으로 런처는 [백그라운드에서 실행](/docs/ko/tools-reference#background-commands) 중인 PowerShell 명령이 [세션의 다음 프로세스로 이월](/docs/ko/agent-view#the-supervisor-process)되도록 합니다(예: [`/background`](/docs/ko/agent-view#from-inside-a-session)로 세션을 백그라운드 처리할 때). 변수를 설정하면 백그라운드 PowerShell 명령이 세션의 프로세스가 종료될 때 중지됩니다. Bash 명령은 영향을 받지 않습니다. Claude Code v2.1.269 이상이 필요합니다 |
349| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | 도구 호출, 훅 및 상태 줄 명령에 대해 PowerShell을 생성할 때 Claude Code가 `-ExecutionPolicy Bypass`를 전달하지 않도록 하려면 `1`로 설정하세요. 대신 머신의 유효한 실행 정책을 존중합니다. 기본적으로 Claude Code는 프로세스 범위 우회를 전달하므로 `.ps1` 스크립트 및 모듈 가져오기가 기본 제한 Windows 설치에서 작동합니다. 프로세스 범위 우회는 이 설정과 관계없이 Group Policy `MachinePolicy` 또는 `UserPolicy`를 재정의하지 않습니다 |349| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | 도구 호출, 훅 및 상태 줄 명령에 대해 PowerShell을 생성할 때 Claude Code가 `-ExecutionPolicy Bypass`를 전달하지 않도록 하려면 `1`로 설정하세요. 대신 머신의 유효한 실행 정책을 존중합니다. 기본적으로 Claude Code는 프로세스 범위 우회를 전달하므로 `.ps1` 스크립트 및 모듈 가져오기가 기본 제한 Windows 설치에서 작동합니다. 프로세스 범위 우회는 이 설정과 관계없이 Group Policy `MachinePolicy` 또는 `UserPolicy`를 재정의하지 않습니다 |
350| `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 이상이 필요합니다 |350| `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 이상이 필요합니다 |
351| `CLAUDE_CODE_PROCESS_WRAPPER` | Claude Code가 자신의 바이너리에서 시작하는 프로세스(예: [에이전트 보기](/docs/ko/agent-view) 세션을 호스팅하는 백그라운드 서비스)를 `/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 이상이 필요합니다 |351| `CLAUDE_CODE_PROCESS_WRAPPER` | Claude Code가 자신의 바이너리에서 시작하는 프로세스(예: [에이전트 보기](/docs/ko/agent-view) 세션을 호스팅하는 백그라운드 서비스)를 `/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 이상이 필요합니다 |
352| `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는 이 변수를 무시합니다. 설정 파일 `env` 블록이 아니라 `claude`를 시작하는 환경에서만 읽습니다. [프로젝트 디렉토리 이름 직접 지정](/docs/ko/sessions#name-the-project-directory-yourself)을 참조하세요. Claude Code v2.1.234 이상이 필요합니다 |352| `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는 이 변수를 무시합니다. [설정 파일 `env` 블록](#in-settings-files)이 아니라 `claude`를 시작하는 환경에서만 읽습니다. [프로젝트 디렉토리 이름 직접 지정](/docs/ko/sessions#name-the-project-directory-yourself)을 참조하세요. Claude Code v2.1.234 이상이 필요합니다 |
353| `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 이상이 필요합니다 |353| `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 이상이 필요합니다 |
354| `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)을 참조하세요 |354| `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)을 참조하세요 |
355| `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, Claude Platform on AWS, Google Cloud의 Agent Platform 및 Microsoft Foundry 같은 타사 제공자에서 그렇지 않으면 적용하는 자동 원격 분석 옵트아웃을 건너뜁니다. 따라서 원격 분석은 표준 `DISABLE_TELEMETRY` 옵트아웃을 따릅니다. [API 제공자별 기본 동작](/docs/ko/data-usage#default-behaviors-by-api-provider)을 참조하세요 |355| `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, Claude Platform on AWS, Google Cloud의 Agent Platform 및 Microsoft Foundry 같은 타사 제공자에서 그렇지 않으면 적용하는 자동 원격 분석 옵트아웃을 건너뜁니다. 따라서 원격 분석은 표준 `DISABLE_TELEMETRY` 옵트아웃을 따릅니다. [API 제공자별 기본 동작](/docs/ko/data-usage#default-behaviors-by-api-provider)을 참조하세요 |
386| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | 서브에이전트, 팀원 및 워크플로우 에이전트에 하나의 모델을 강제하려면 `1`로 설정하세요. [모든 서브에이전트를 하나의 모델에서 실행](/docs/ko/sub-agents#run-every-subagent-on-one-model)은 그 모델이 무엇인지 말합니다. Claude Code v2.1.257 이상이 필요합니다 |386| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | 서브에이전트, 팀원 및 워크플로우 에이전트에 하나의 모델을 강제하려면 `1`로 설정하세요. [모든 서브에이전트를 하나의 모델에서 실행](/docs/ko/sub-agents#run-every-subagent-on-one-model)은 그 모델이 무엇인지 말합니다. Claude Code v2.1.257 이상이 필요합니다 |
387| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | `5m` 또는 `1h`로 설정합니다. Claude Code가 허용하는 유일한 값입니다. 주 대화 외부의 요청에 대한 [프롬프트 캐시 TTL](/docs/ko/prompt-caching#cache-lifetime)을 선택합니다. [서브에이전트](/docs/ko/sub-agents), 워크플로우 및 백그라운드 작업입니다. `subagentPromptCacheTtl` 설정 및 `ENABLE_PROMPT_CACHING_1H`보다 우선합니다. `FORCE_PROMPT_CACHING_5M`이 이를 재정의합니다. API는 1시간 캐시 쓰기를 더 높은 요금으로 청구합니다. Claude Code v2.1.242 이상이 필요합니다 |387| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | `5m` 또는 `1h`로 설정합니다. Claude Code가 허용하는 유일한 값입니다. 주 대화 외부의 요청에 대한 [프롬프트 캐시 TTL](/docs/ko/prompt-caching#cache-lifetime)을 선택합니다. [서브에이전트](/docs/ko/sub-agents), 워크플로우 및 백그라운드 작업입니다. `subagentPromptCacheTtl` 설정 및 `ENABLE_PROMPT_CACHING_1H`보다 우선합니다. `FORCE_PROMPT_CACHING_5M`이 이를 재정의합니다. API는 1시간 캐시 쓰기를 더 높은 요금으로 청구합니다. Claude Code v2.1.242 이상이 필요합니다 |
388| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | 서브프로세스 환경에서 자격 증명을 제거하려면 `1`로 설정하세요(Bash 도구, 훅, MCP stdio 서버): Anthropic 및 클라우드 제공자 자격 증명, Claude Code가 자격 증명으로 인식하는 다른 변수 및 패키지 레지스트리 URL에 포함된 자격 증명. 부모 Claude 프로세스는 API 호출을 위해 이러한 자격 증명을 유지하지만 자식 프로세스는 읽을 수 없습니다. 이는 셸 확장을 통해 비밀을 유출하려는 프롬프트 주입 공격에 대한 노출을 줄입니다. v2.1.251 이상에서 스크럽은 또한 Claude Code의 자신의 구성 저장소 포인터 변수(예: `CLAUDE_CONFIG_DIR`)를 제거합니다. 자식 프로세스는 재배치된 구성 디렉토리를 찾을 수 없습니다. 서브프로세스가 이러한 변수를 필요로 하면 스크럽을 설정 해제하세요. Linux에서 이는 또한 Bash 서브프로세스를 격리된 PID 네임스페이스에서 실행하므로 `/proc`을 통해 호스트 프로세스 환경을 읽을 수 없습니다. 부작용으로 `ps`, `pgrep` 및 `kill`은 호스트 프로세스를 보거나 신호할 수 없습니다. `claude-code-action`은 `allowed_non_write_users`가 구성되면 자동으로 이를 설정합니다 |388| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | 서브프로세스 환경에서 자격 증명을 제거하려면 `1`로 설정하세요(Bash 도구, 훅, MCP stdio 서버): Anthropic 및 클라우드 제공자 자격 증명, Claude Code가 자격 증명으로 인식하는 다른 변수 및 패키지 레지스트리 URL에 포함된 자격 증명. 부모 Claude 프로세스는 API 호출을 위해 이러한 자격 증명을 유지하지만 자식 프로세스는 읽을 수 없습니다. 이는 셸 확장을 통해 비밀을 유출하려는 프롬프트 주입 공격에 대한 노출을 줄입니다. v2.1.251 이상에서 스크럽은 또한 Claude Code의 자신의 구성 저장소 포인터 변수(예: `CLAUDE_CONFIG_DIR`)를 제거합니다. 자식 프로세스는 재배치된 구성 디렉토리를 찾을 수 없습니다. 서브프로세스가 이러한 변수를 필요로 하면 스크럽을 설정 해제하세요. Linux에서 이는 또한 Bash 서브프로세스를 격리된 PID 네임스페이스에서 실행하므로 `/proc`을 통해 호스트 프로세스 환경을 읽을 수 없습니다. 부작용으로 `ps`, `pgrep` 및 `kill`은 호스트 프로세스를 보거나 신호할 수 없습니다. `claude-code-action`은 `allowed_non_write_users`가 구성되면 자동으로 이를 설정합니다 |
389| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | [비대화형 모드](/docs/ko/headless)(`-p` 플래그)에서 플러그인 설치가 완료될 때까지 기다리려면 `1`로 설정하세요. 첫 번째 쿼리 전입니다. 이것이 없으면 플러그인이 백그라운드에 설치되고 첫 번째 턴에서 사용할 수 없을 수 있습니다. `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS`와 결합하여 대기를 경계하세요 |389| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | 비대화형 모드(`-p` 플래그)에서 플러그인 설치가 완료될 때까지 기다리려면 `1`로 설정하세요. 첫 번째 쿼리 전입니다. 이것이 없으면 플러그인이 백그라운드에 설치되고 첫 번째 턴에서 사용할 수 없을 수 있습니다. `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS`와 결합하여 대기를 경계하세요 |
390| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | 동기 플러그인 설치의 타임아웃(밀리초). 초과되면 Claude Code는 플러그인 없이 진행하고 오류를 기록합니다. 기본값 없음: 이 변수가 없으면 동기 설치가 완료될 때까지 기다립니다 |390| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | 동기 플러그인 설치의 타임아웃(밀리초). 초과되면 Claude Code는 플러그인 없이 진행하고 오류를 기록합니다. 기본값 없음: 이 변수가 없으면 동기 설치가 완료될 때까지 기다립니다 |
391| `CLAUDE_CODE_SYNC_SKILLS` | `-p` 플래그를 사용하여 비대화형 모드에서 claude.ai 계정에 대해 활성화된 기술을 다운로드하고 `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`까지 목록을 기다리려면 `1`로 설정하세요. 다운로드 자체는 백그라운드에서 완료되고 Claude는 해당 기술을 호출할 때 기술의 다운로드를 기다립니다. Claude.ai 인증이 필요합니다. 로그인한 claude.ai 계정이 있는 터미널 세션은 이 변수 없이 `~/.claude/skills/synced/`로 [이러한 기술을 다운로드](/docs/ko/skills#where-synced-skills-load)하고 약 10분마다 재동기화합니다. 따라서 `-p` 실행이 첫 번째 쿼리에서 현재 기술이 필요할 때만 설정하세요. v2.1.273 이전에는 터미널 세션이 이 변수 집합이 있는 `-p` 실행에서만 다운로드했습니다. `synced` 폴더 이름은 [이 다운로드를 위해 예약됩니다](/docs/ko/skills#where-skills-live). v2.1.227 이전에는 기술이 `~/.claude/skills/`로 직접 다운로드되었습니다. Claude Code는 [다운로드된 기술에 추가 규칙을 적용합니다](/docs/ko/skills#how-synced-skills-behave). 예를 들어 머신에서 `!` 명령을 실행하지 않습니다 |391| `CLAUDE_CODE_SYNC_SKILLS` | `-p` 플래그를 사용하여 비대화형 모드에서 claude.ai 계정에 대해 활성화된 기술을 다운로드하고 `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`까지 목록을 기다리려면 `1`로 설정하세요. 다운로드 자체는 백그라운드에서 완료되고 Claude는 해당 기술을 호출할 때 기술의 다운로드를 기다립니다. Claude.ai 인증이 필요합니다. 로그인한 claude.ai 계정이 있는 터미널 세션은 이 변수 없이 `~/.claude/skills/synced/`로 [이러한 기술을 다운로드](/docs/ko/skills#where-synced-skills-load)하고 약 10분마다 재동기화합니다. 따라서 `-p` 실행이 첫 번째 쿼리에서 현재 기술이 필요할 때만 설정하세요. v2.1.273 이전에는 터미널 세션이 이 변수 집합이 있는 `-p` 실행에서만 다운로드했습니다. `synced` 폴더 이름은 [이 다운로드를 위해 예약됩니다](/docs/ko/skills#where-skills-live). v2.1.227 이전에는 기술이 `~/.claude/skills/`로 직접 다운로드되었습니다. Claude Code는 [다운로드된 기술에 추가 규칙을 적용합니다](/docs/ko/skills#how-synced-skills-behave). 예를 들어 머신에서 `!` 명령을 실행하지 않습니다 |
392| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | 앱이 [Agent SDK](/docs/ko/agent-sdk/typescript#query-object)에 구축되었을 때 기술을 다시 로드할 때 기술 재동기화의 타임아웃(밀리초)(기본값: 30000). 초과되면 재로드는 도착한 기술로 계속되고 나머지 다운로드는 백그라운드에서 완료됩니다 |392| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | 앱이 [Agent SDK](/docs/ko/agent-sdk/typescript#query-object)에 구축되었을 때 기술을 다시 로드할 때 기술 재동기화의 타임아웃(밀리초)(기본값: 30000). 초과되면 재로드는 도착한 기술로 계속되고 나머지 다운로드는 백그라운드에서 완료됩니다 |
461| `IS_DEMO` | 데모 모드를 활성화하려면 `1` 같은 비어있지 않은 값으로 설정하세요: 헤더 및 `/status` 출력에서 이메일 및 조직 이름을 숨기고 온보딩을 건너뜁니다. **`0` 또는 `false`로 설정하면 여전히 데모 모드를 활성화합니다**. 대부분의 온/오프 변수와 달리 변수를 설정 해제하여 끄세요. 세션을 스트리밍하거나 녹화할 때 유용합니다 |461| `IS_DEMO` | 데모 모드를 활성화하려면 `1` 같은 비어있지 않은 값으로 설정하세요: 헤더 및 `/status` 출력에서 이메일 및 조직 이름을 숨기고 온보딩을 건너뜁니다. **`0` 또는 `false`로 설정하면 여전히 데모 모드를 활성화합니다**. 대부분의 온/오프 변수와 달리 변수를 설정 해제하여 끄세요. 세션을 스트리밍하거나 녹화할 때 유용합니다 |
462| `MAX_MCP_OUTPUT_TOKENS` | MCP 도구 응답에서 허용되는 최대 토큰 수입니다. Claude Code는 출력이 10,000 토큰을 초과할 때 경고를 표시합니다. [`anthropic/maxResultSizeChars`](/docs/ko/mcp#raise-the-limit-for-a-specific-tool)를 선언하는 도구는 텍스트 콘텐츠에 대해 해당 문자 제한을 사용하지만 이러한 도구의 이미지 콘텐츠는 여전히 이 변수의 영향을 받습니다(기본값: 25000) |462| `MAX_MCP_OUTPUT_TOKENS` | MCP 도구 응답에서 허용되는 최대 토큰 수입니다. Claude Code는 출력이 10,000 토큰을 초과할 때 경고를 표시합니다. [`anthropic/maxResultSizeChars`](/docs/ko/mcp#raise-the-limit-for-a-specific-tool)를 선언하는 도구는 텍스트 콘텐츠에 대해 해당 문자 제한을 사용하지만 이러한 도구의 이미지 콘텐츠는 여전히 이 변수의 영향을 받습니다(기본값: 25000) |
463| `MAX_STRUCTURED_OUTPUT_RETRIES` | 비대화형 모드에서 [`--json-schema`](/docs/ko/cli-reference#cli-flags)에 대해 모델의 응답이 유효성 검사에 실패할 때 Claude Code가 허용하는 시도 횟수입니다. `-p` 플래그 사용. 그 이후 유효한 출력이 없으면 실행이 실패합니다. [워크플로우](/docs/ko/workflows) 서브에이전트의 구조화된 출력이 유효성 검사에 실패할 때도 동일한 상한이 적용됩니다. 기본값 5(첫 번째 시도 및 4번의 재시도) |463| `MAX_STRUCTURED_OUTPUT_RETRIES` | 비대화형 모드에서 [`--json-schema`](/docs/ko/cli-reference#cli-flags)에 대해 모델의 응답이 유효성 검사에 실패할 때 Claude Code가 허용하는 시도 횟수입니다. `-p` 플래그 사용. 그 이후 유효한 출력이 없으면 실행이 실패합니다. [워크플로우](/docs/ko/workflows) 서브에이전트의 구조화된 출력이 유효성 검사에 실패할 때도 동일한 상한이 적용됩니다. 기본값 5(첫 번째 시도 및 4번의 재시도) |
464| `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)이 있는 모델이 자신의 사고 깊이를 선택하고 다른 모델은 상한을 사용합니다. Anthropic API에서 사고를 비활성화하려면 `0`으로 설정하세요. Fable 모델은 제외됩니다. 이들은 사고를 끌 수 없습니다. [타사 제공자](/docs/ko/third-party-integrations)에서 `0`은 대신 `thinking` 매개변수를 생략합니다. Anthropic API에서 사고가 꺼져 있으면 Claude Code는 `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`이 적응형 추론을 끄지 않으면 더 높은 수준 대신 노력 `high`를 전송합니다. Opus 5 같은 [해당 조합을 허용하지 않는](/docs/ko/errors#effort-isnt-available-with-thinking-turned-off) 모델입니다. Claude Code는 적응형 추론 모델에서 0이 아닌 값을 무시합니다. `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`이 적응형 추론을 끄는 모델은 제외됩니다 |464| `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)이 있는 모델이 자신의 사고 깊이를 선택하고 다른 모델은 상한을 사용합니다. Anthropic API에서 사고를 비활성화하려면 `0`으로 설정하세요. Opus 5.5 및 Fable 모델은 제외됩니다. 이들은 사고를 끌 수 없습니다. [타사 제공자](/docs/ko/third-party-integrations)에서 `0`은 대신 `thinking` 매개변수를 생략합니다. Anthropic API에서 사고가 꺼져 있으면 Claude Code는 [해당 조합을 허용하지 않는](/docs/ko/errors#effort-isnt-available-with-thinking-turned-off) 것으로 알고 있는 Opus 5 같은 모델에 더 높은 수준 대신 노력 `high`를 전송합니다. Claude Code는 적응형 추론 모델에서 0이 아닌 값을 무시합니다. `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`이 적응형 추론을 끄는 모델은 제외됩니다 |
465| `MCP_CLIENT_SECRET` | [사전 구성된 자격 증명](/docs/ko/mcp#use-pre-configured-oauth-credentials)이 필요한 MCP 서버의 OAuth 클라이언트 비밀입니다. `--client-secret`으로 서버를 추가할 때 대화형 프롬프트를 피합니다 |465| `MCP_CLIENT_SECRET` | [사전 구성된 자격 증명](/docs/ko/mcp#use-pre-configured-oauth-credentials)이 필요한 MCP 서버의 OAuth 클라이언트 비밀입니다. `--client-secret`으로 서버를 추가할 때 대화형 프롬프트를 피합니다 |
466| `MCP_CONNECTION_NONBLOCKING` | MCP 서버가 첫 번째 쿼리 전에 연결될 때까지 시작이 대기하는지 여부를 제어합니다. MCP 시작은 기본적으로 비차단입니다: 서버는 백그라운드에서 연결되고 도구는 완료되면 사용 가능해집니다. 첫 번째 쿼리 전에 서버가 연결될 때까지 기다리려면 `0`으로 설정하세요. [`alwaysLoad: true`](/docs/ko/mcp#exempt-a-server-from-deferral)로 구성된 서버는 어쨌든 시작을 기다리게 합니다. 단, [검색 캐시](/docs/ko/mcp#server-status-detail)에서 제공되는 경우는 제외됩니다. 도구가 첫 번째 프롬프트가 구축될 때 존재해야 하기 때문입니다. 비대화형 모드(`-p`)에서 `--input-format stream-json` 없이 Claude Code는 첫 번째 턴 전에 여전히 보류 중인 서버를 기다립니다. 이 변수와 관계없이. [`--mcp-config`](/docs/ko/cli-reference#cli-flags)를 명시적으로 전달하면 대기에 더 긴 기한이 있습니다. 캐시된 서버 예외는 해당 플래그 항목을 참조하세요 |466| `MCP_CONNECTION_NONBLOCKING` | MCP 서버가 첫 번째 쿼리 전에 연결될 때까지 시작이 대기하는지 여부를 제어합니다. MCP 시작은 기본적으로 비차단입니다: 서버는 백그라운드에서 연결되고 도구는 완료되면 사용 가능해집니다. 첫 번째 쿼리 전에 서버가 연결될 때까지 기다리려면 `0`으로 설정하세요. [`alwaysLoad: true`](/docs/ko/mcp#exempt-a-server-from-deferral)로 구성된 서버는 어쨌든 시작을 기다리게 합니다. 단, [검색 캐시](/docs/ko/mcp#server-status-detail)에서 제공되는 경우는 제외됩니다. 도구가 첫 번째 프롬프트가 구축될 때 존재해야 하기 때문입니다. 비대화형 모드(`-p`)에서 `--input-format stream-json` 없이 Claude Code는 첫 번째 턴 전에 여전히 보류 중인 서버를 기다립니다. 이 변수와 관계없이. [`--mcp-config`](/docs/ko/cli-reference#cli-flags)를 명시적으로 전달하면 대기에 더 긴 기한이 있습니다. 캐시된 서버 예외는 해당 플래그 항목을 참조하세요 |
467| `MCP_CONNECT_TIMEOUT_MS` | 차단 MCP 시작이 도구 목록을 스냅샷하기 전에 연결 배치를 기다리는 시간(밀리초)(기본값: 5000). `MCP_CONNECTION_NONBLOCKING=0` 또는 [`alwaysLoad: true`](/docs/ko/mcp#exempt-a-server-from-deferral)로 표시된 서버에 적용됩니다. 서버는 기한에서 여전히 보류 중이면 백그라운드에서 계속 연결됩니다. `MCP_TIMEOUT`과는 다릅니다. 이는 개별 서버의 연결 시도를 경계합니다 |467| `MCP_CONNECT_TIMEOUT_MS` | 차단 MCP 시작이 도구 목록을 스냅샷하기 전에 연결 배치를 기다리는 시간(밀리초)(기본값: 5000). `MCP_CONNECTION_NONBLOCKING=0` 또는 [`alwaysLoad: true`](/docs/ko/mcp#exempt-a-server-from-deferral)로 표시된 서버에 적용됩니다. 서버는 기한에서 여전히 보류 중이면 백그라운드에서 계속 연결됩니다. `MCP_TIMEOUT`과는 다릅니다. 이는 개별 서버의 연결 시도를 경계합니다 |
470| `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 이상이 필요합니다 |470| `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 이상이 필요합니다 |
471| `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가 값을 제한하지 않았습니다 |471| `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가 값을 제한하지 않았습니다 |
472| `MCP_OAUTH_CALLBACK_PORT` | [사전 구성된 자격 증명](/docs/ko/mcp#use-pre-configured-oauth-credentials)으로 MCP 서버를 추가할 때 OAuth 리디렉션 콜백의 고정 포트입니다. `--callback-port`의 대안입니다 |472| `MCP_OAUTH_CALLBACK_PORT` | [사전 구성된 자격 증명](/docs/ko/mcp#use-pre-configured-oauth-credentials)으로 MCP 서버를 추가할 때 OAuth 리디렉션 콜백의 고정 포트입니다. `--callback-port`의 대안입니다 |
473| `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는 HTTP 서버를 조사하고 [기능 플래그를 가져오는](/docs/ko/mcp#server-status-detail) 세션에서 claude.ai 커넥터 서버도 조사합니다. 다른 값은 디버그 로그의 경고로 무시됩니다. Claude Code v2.1.221 이상이 필요합니다 |473| `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는 HTTP 서버를 조사하고 [기능 플래그를 가져오는](#features-that-need-feature-flag-fetching) 세션에서 claude.ai 커넥터 서버도 조사합니다. 다른 값은 디버그 로그의 경고로 무시됩니다. Claude Code v2.1.221 이상이 필요합니다 |
474| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | 시작 중에 병렬로 연결할 원격 MCP 서버(HTTP/SSE)의 최대 수입니다(기본값: 20) |474| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | 시작 중에 병렬로 연결할 원격 MCP 서버(HTTP/SSE)의 최대 수입니다(기본값: 20) |
475| `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는 v2를 사용합니다. 해당 섹션에 나열된 버전부터 시작합니다. Claude Code v2.1.221 이상에서 v2 런타임은 MCP OAuth 서버가 인증 응답에서 반환하는 발급자를 확인하고 일치하지 않으면 `Issuer mismatch in authorization response`로 시작하는 오류로 로그인을 실패합니다. v1 런타임은 이 확인을 실행하지 않습니다. 인식할 수 없는 값을 설정하면 Claude Code는 무시하고 디버그 로그에 경고를 작성합니다. Claude Code는 프로세스당 한 번 값을 읽습니다. Claude Code v2.1.218 이상이 필요합니다 |475| `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는 v2를 사용합니다. 해당 섹션에 나열된 버전부터 시작합니다. Claude Code v2.1.221 이상에서 v2 런타임은 MCP OAuth 서버가 인증 응답에서 반환하는 발급자를 확인하고 일치하지 않으면 `Issuer mismatch in authorization response`로 시작하는 오류로 로그인을 실패합니다. v1 런타임은 이 확인을 실행하지 않습니다. 인식할 수 없는 값을 설정하면 Claude Code는 무시하고 디버그 로그에 경고를 작성합니다. Claude Code는 프로세스당 한 번 값을 읽습니다. Claude Code v2.1.218 이상이 필요합니다 |
476| `MCP_SERVER_CONNECTION_BATCH_SIZE` | 시작 중에 병렬로 연결할 로컬 MCP 서버(stdio)의 최대 수입니다(기본값: 3) |476| `MCP_SERVER_CONNECTION_BATCH_SIZE` | 시작 중에 병렬로 연결할 로컬 MCP 서버(stdio)의 최대 수입니다(기본값: 3) |
