Documentation 2026-06-23 22:00 UTC to 2026-06-24 22:02 UTC

63 63 

64기본적으로 WSL은 `/etc/claude-code`의 Linux 파일 경로만 읽습니다. Windows 레지스트리 및 `C:\Program Files\ClaudeCode` 정책을 같은 머신의 WSL로 확장하려면 관리자 전용 Windows 소스 중 하나에서 [`wslInheritsWindowsSettings: true`](/ko/settings#available-settings)를 설정하세요.64기본적으로 WSL은 `/etc/claude-code`의 Linux 파일 경로만 읽습니다. Windows 레지스트리 및 `C:\Program Files\ClaudeCode` 정책을 같은 머신의 WSL로 확장하려면 관리자 전용 Windows 소스 중 하나에서 [`wslInheritsWindowsSettings: true`](/ko/settings#available-settings)를 설정하세요.

65 65 

66선택한 메커니즘이 무엇이든 관리 값은 사용자 및 프로젝트 설정보다 우선합니다. `permissions.allow` 및 `permissions.deny`와 같은 배열 설정은 모든 소스의 항목을 병합하므로 개발자는 관리 목록을 확장할 수 있지만 제거할 수는 없습니다.66선택한 메커니즘이 무엇이든 관리 값은 사용자 및 프로젝트 설정보다 우선합니다. `permissions.allow` 및 `permissions.deny`와 같은 배열 설정은 모든 소스의 항목을 병합하므로 개발자는 관리 목록을 확장할 수 있지만 제거할 수는 없습니다. [두 가지 예외](/ko/settings#settings-precedence)가 있습니다. 여기서 관리 값은 병합하지 않고 하위 계층을 대체합니다: `fallbackModel` 및 `availableModels`.

67 67 

68[Server-managed settings](/ko/server-managed-settings) 및 [Settings files and precedence](/ko/settings#settings-files)를 참조하세요.68[Server-managed settings](/ko/server-managed-settings) 및 [Settings files and precedence](/ko/settings#settings-files)를 참조하세요.

69 69 

74관리 설정은 도구, 샌드박스 실행, MCP 서버 및 플러그인 소스 제한, 실행되는 hooks 제어를 잠글 수 있습니다. 각 행은 이를 구동하는 설정 키가 있는 제어 표면입니다.74관리 설정은 도구, 샌드박스 실행, MCP 서버 및 플러그인 소스 제한, 실행되는 hooks 제어를 잠글 수 있습니다. 각 행은 이를 구동하는 설정 키가 있는 제어 표면입니다.

75 75 

76| 제어 | 기능 | 주요 설정 |76| 제어 | 기능 | 주요 설정 |

77| :------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------- |77| :------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------- |

78| [Permission rules](/ko/permissions) | 특정 도구 및 명령 허용, 요청 또는 거부 | `permissions.allow`, `permissions.deny` |78| [Permission rules](/ko/permissions) | 특정 도구 및 명령 허용, 요청 또는 거부 | `permissions.allow`, `permissions.deny` |

79| [Permission lockdown](/ko/permissions#managed-only-settings) | 관리 권한 규칙만 적용; `--dangerously-skip-permissions` 비활성화 | `allowManagedPermissionRulesOnly`, `permissions.disableBypassPermissionsMode` |79| [Permission lockdown](/ko/permissions#managed-only-settings) | 관리 권한 규칙만 적용; `--dangerously-skip-permissions` 비활성화 | `allowManagedPermissionRulesOnly`, `permissions.disableBypassPermissionsMode` |

80| [Sandboxing](/ko/sandboxing) | 도메인 허용 목록이 있는 OS 수준 파일 시스템 및 네트워크 격리 | `sandbox.enabled`, `sandbox.network.allowedDomains` |80| [Sandboxing](/ko/sandboxing) | 도메인 허용 목록이 있는 OS 수준 파일 시스템 및 네트워크 격리 | `sandbox.enabled`, `sandbox.network.allowedDomains` |

84| [Customization lockdown](/ko/settings#strictpluginonlycustomization) | skills, agents, hooks 및 MCP 서버를 사용자 및 프로젝트 소스에서 차단하여 플러그인 또는 관리 설정에서만 제공되도록 함 | `strictPluginOnlyCustomization` |84| [Customization lockdown](/ko/settings#strictpluginonlycustomization) | skills, agents, hooks 및 MCP 서버를 사용자 및 프로젝트 소스에서 차단하여 플러그인 또는 관리 설정에서만 제공되도록 함 | `strictPluginOnlyCustomization` |

85| [Hook restrictions](/ko/settings#hook-configuration) | 관리 hooks만 로드; HTTP hook URL 제한 | `allowManagedHooksOnly`, `allowedHttpHookUrls` |85| [Hook restrictions](/ko/settings#hook-configuration) | 관리 hooks만 로드; HTTP hook URL 제한 | `allowManagedHooksOnly`, `allowedHttpHookUrls` |

86| [Disable agent view](/ko/agent-view#how-background-sessions-are-hosted) | `claude agents`, `--bg`, `/background` 및 온디맨드 감독자 비활성화 | `disableAgentView` |86| [Disable agent view](/ko/agent-view#how-background-sessions-are-hosted) | `claude agents`, `--bg`, `/background` 및 온디맨드 감독자 비활성화 | `disableAgentView` |

87| [Model restrictions](/ko/model-config#restrict-model-selection) | 사용자가 선택할 수 있는 모델 제한, 선택적으로 기본 모델 선택에도 허용 목록 적용. [surface coverage](/ko/model-config#surface-coverage)에서 이 설정이 CLI, 웹 및 IDE에 어떻게 도달하는지 확인하세요 | `availableModels`, `enforceAvailableModels` |

87| [Version floor](/ko/settings) | 자동 업데이트가 조직 전체 최소값 아래로 설치되는 것을 방지 | `minimumVersion` |88| [Version floor](/ko/settings) | 자동 업데이트가 조직 전체 최소값 아래로 설치되는 것을 방지 | `minimumVersion` |

88| [Required version range](/ko/settings) | 실행 중인 버전이 조직 승인 범위를 벗어날 때 시작을 거부합니다. 다운그레이드만 차단하는 `minimumVersion`보다 더 강력합니다 | `requiredMinimumVersion`, `requiredMaximumVersion` |89| [Required version range](/ko/settings) | 실행 중인 버전이 조직 승인 범위를 벗어날 때 시작을 거부합니다. 다운그레이드만 차단하는 `minimumVersion`보다 더 강력합니다 | `requiredMinimumVersion`, `requiredMaximumVersion` |

89 90 

52/advisor opus52/advisor opus

53```53```

54 54 

55선택 항목은 사용자 설정의 `advisorModel`에 저장되고 세션 전체에서 유지됩니다. 현재 주 모델이 조언자를 지원하지 않으면 선택 항목이 여전히 저장되고 [`/model`](/ko/model-config#setting-your-model)을 사용하여 [호환되는 주 모델](#choose-an-advisor-model)로 전환할 때 활성화됩니다.55선택 항목은 사용자 설정의 `advisorModel`에 저장되고 세션 전체에서 유지됩니다. 조직의 [`availableModels`](/ko/model-config#restrict-model-selection) 허용 목록이 저장된 조언자 모델을 제외하면 `/advisor`로 허용된 모델을 선택할 때까지 조언자가 호출되지 않습니다. 현재 주 모델이 조언자를 지원하지 않으면 선택 항목이 여전히 저장되고 [`/model`](/ko/model-config#setting-your-model)을 사용하여 [호환되는 주 모델](#choose-an-advisor-model)로 전환할 때 활성화됩니다.

56 56 

57<h3 id="set-advisormodel-in-settings">57<h3 id="set-advisormodel-in-settings">

58 설정에서 `advisorModel` 설정58 설정에서 `advisorModel` 설정

76claude --advisor opus76claude --advisor opus

77```77```

78 78 

79플래그는 해당 세션에 대해 `advisorModel` 설정보다 우선합니다. 세션의 주 모델이 조언자를 지원하지 않으면 `/advisor`와 달리 플래그는 오류로 종료됩니다.79플래그는 해당 세션에 대해 `advisorModel` 설정보다 우선합니다. 세션의 주 모델이 조언자를 지원하지 않으면 오류로 종료되거나, 요청된 조언자 모델이 조직의 [`availableModels`](/ko/model-config#restrict-model-selection) 허용 목록에서 제외되면 오류로 종료됩니다.

80 80 

81<h2 id="choose-an-advisor-model">81<h2 id="choose-an-advisor-model">

82 조언자 모델 선택82 조언자 모델 선택

182조언자는 모델 강점을 결합하는 여러 방법 중 하나입니다. 더 강력한 모델을 언제 포함할지에 따라 선택하세요.182조언자는 모델 강점을 결합하는 여러 방법 중 하나입니다. 더 강력한 모델을 언제 포함할지에 따라 선택하세요.

183 183 

184| 접근 방식 | 더 강력한 모델이 실행되는 시기 | 시작 방식 |184| 접근 방식 | 더 강력한 모델이 실행되는 시기 | 시작 방식 |

185| ----------------------------------------------------- | -------------------------------- | --------------------------- |185| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | --------------------------- |

186| 조언자 도구 | 작업 중간의 결정 지점에서 | Claude가 지침이 필요할 때 호출합니다 |186| 조언자 도구 | 작업 중간의 결정 지점에서 | Claude가 지침이 필요할 때 호출합니다 |

187| [`opusplan`](/ko/model-config#opusplan-model-setting) | 계획 모드 중, 그 다음 실행을 위해 Sonnet으로 전환 | 계획 모드를 입력합니다 |187| [`opusplan`](/ko/model-config#opusplan-model-setting) | [계획 모드 중 `availableModels`에서 허용될 때](/ko/model-config#restrict-model-selection), 그 다음 실행을 위해 Sonnet으로 전환 | 계획 모드를 입력합니다 |

188| [서브에이전트](/ko/sub-agents#choose-a-model) (`model` 설정) | 전체 위임된 부작업에 대해 | Claude가 위임하거나 서브에이전트를 호출합니다 |188| [서브에이전트](/ko/sub-agents#choose-a-model) (`model` 설정) | 전체 위임된 부작업에 대해 | Claude가 위임하거나 서브에이전트를 호출합니다 |

189| [`/model`](/ko/model-config#setting-your-model) | 이후의 모든 턴에 대해 | 모델을 전환합니다 |189| [`/model`](/ko/model-config#setting-your-model) | 이후의 모든 턴에 대해 | 모델을 전환합니다 |

190 190 

86`settingSources`는 사용자, 프로젝트 및 로컬 설정을 다룹니다. 몇 가지 입력은 해당 값과 관계없이 읽혀집니다:86`settingSources`는 사용자, 프로젝트 및 로컬 설정을 다룹니다. 몇 가지 입력은 해당 값과 관계없이 읽혀집니다:

87 87 

88| 입력 | 동작 | 비활성화하려면 |88| 입력 | 동작 | 비활성화하려면 |

89| :---------------------------------------------------------- | :---------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------- |89| :---------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------- |

90| 관리형 정책 설정 | 호스트에 있을 때 항상 로드됨 | 관리형 설정 파일 제거 |90| 관리형 정책 설정 | 엔드포인트 관리형 정책(MDM plist, 레지스트리 정책 또는 관리형 설정 파일 여부)은 호스트에서 로드되며, [서버 관리형 설정](/ko/server-managed-settings)은 조직 OAuth 로그인 또는 직접 구성된 API 키로 세션이 인증될 때 [적격 구성](/ko/server-managed-settings#platform-availability)에서 가져와집니다 | 엔드포인트 정책: 호스트에서 관리형 설정 파일, plist 또는 레지스트리 정책을 제거합니다. 서버 관리형 설정: 조직 관리자가 제어하며, SDK에서 비활성화할 수 없습니다 |

91| `~/.claude.json` 전역 구성 | 항상 읽음 | `env`의 `CLAUDE_CONFIG_DIR`로 재배치 |91| `~/.claude.json` 전역 구성 | 항상 읽음 | `env`의 `CLAUDE_CONFIG_DIR`로 재배치 |

92| `~/.claude/projects/<project>/memory/`의 자동 메모리 | 기본적으로 시스템 프롬프트에 로드됨 | 설정에서 `autoMemoryEnabled: false` 설정 또는 `env`에서 `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` 설정 |92| `~/.claude/projects/<project>/memory/`의 자동 메모리 | 기본적으로 시스템 프롬프트에 로드됨 | 설정에서 `autoMemoryEnabled: false` 설정 또는 `env`에서 `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` 설정 |

93| [claude.ai MCP 커넥터](/ko/mcp#use-mcp-servers-from-claude-ai) | 활성 인증 방법이 claude.ai 구독일 때 로드됨. `mcpServers: {}`를 전달해도 이들을 억제하지 않음 | `strictMcpConfig: true` 설정, [`disableClaudeAiConnectors: true`](/ko/mcp#disable-claude-ai-connectors) 설정 또는 `env`에서 `ENABLE_CLAUDEAI_MCP_SERVERS=false` 설정 |93| [claude.ai MCP 커넥터](/ko/mcp#use-mcp-servers-from-claude-ai) | 활성 인증 방법이 claude.ai 구독일 때 로드됨. `mcpServers: {}`를 전달해도 이들을 억제하지 않음 | `strictMcpConfig: true` 설정, [`disableClaudeAiConnectors: true`](/ko/mcp#disable-claude-ai-connectors) 설정 또는 `env`에서 `ENABLE_CLAUDEAI_MCP_SERVERS=false` 설정 |

94 94 

95<Warning>95<Warning>

96 다중 테넌트 격리를 위해 기본 `query()` 옵션에 의존하지 마세요. 위의 입력이 `settingSources`와 관계없이 읽혀지므로, SDK 프로세스는 호스트 수준 구성 및 디렉토리별 메모리를 선택할 수 있습니다. 다중 테넌트 배포의 경우 각 테넌트를 자체 파일시스템에서 실행하고 `settingSources: []` 및 `env`에서 `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1`을 설정합니다. [안전한 배포](/ko/agent-sdk/secure-deployment)를 참조하세요.96 다중 테넌트 격리를 위해 기본 `query()` 옵션에 의존하지 마세요. 위의 입력이 `settingSources`와 관계없이 읽혀지므로, SDK 프로세스는 호스트 수준 구성 및 디렉토리별 메모리를 선택할 수 있습니다. 다중 테넌트 배포의 경우 각 테넌트를 자체 파일시스템에서 실행하고 `settingSources: []` 및 `env`에서 `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1`을 설정합니다. [서버 관리형 설정](/ko/server-managed-settings)은 프로세스가 조직 자격 증명으로 인증될 때 가져와집니다. 파일시스템 격리는 이들을 제거하지 않습니다. [안전한 배포](/ko/agent-sdk/secure-deployment)를 참조하세요.

97</Warning>97</Warning>

98 98 

99<h2 id="project-instructions-claude-md-and-rules">99<h2 id="project-instructions-claude-md-and-rules">

897```897```

898 898 

899| 속성 | 타입 | 기본값 | 설명 |899| 속성 | 타입 | 기본값 | 설명 |

900| :---------------------------- | :------------------------------------------------------------------------------------ | :---------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |900| :---------------------------- | :------------------------------------------------------------------------------------ | :---------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

901| `tools` | `list[str] \| ToolsPreset \| None` | `None` | 도구 구성. Claude Code의 기본 도구를 위해 `{"type": "preset", "preset": "claude_code"}` 사용 |901| `tools` | `list[str] \| ToolsPreset \| None` | `None` | 도구 구성. Claude Code의 기본 도구를 위해 `{"type": "preset", "preset": "claude_code"}` 사용 |

902| `allowed_tools` | `list[str]` | `[]` | 프롬프트 없이 자동 승인할 도구. 이것은 Claude를 이 도구로만 제한하지 않습니다. 나열되지 않은 도구는 `permission_mode` 및 `can_use_tool`로 넘어갑니다. `disallowed_tools`를 사용하여 도구를 차단합니다. [권한](/ko/agent-sdk/permissions#allow-and-deny-rules) 참조 |902| `allowed_tools` | `list[str]` | `[]` | 프롬프트 없이 자동 승인할 도구. 이것은 Claude를 이 도구로만 제한하지 않습니다. 나열되지 않은 도구는 `permission_mode` 및 `can_use_tool`로 넘어갑니다. `disallowed_tools`를 사용하여 도구를 차단합니다. [권한](/ko/agent-sdk/permissions#allow-and-deny-rules) 참조 |

903| `system_prompt` | `str \| SystemPromptPreset \| None` | `None` | 시스템 프롬프트 구성. 사용자 정의 프롬프트의 경우 문자열을 전달하거나, Claude Code의 시스템 프롬프트를 위해 `{"type": "preset", "preset": "claude_code"}` 사용. 프리셋을 확장하려면 `"append"` 추가 |903| `system_prompt` | `str \| SystemPromptPreset \| None` | `None` | 시스템 프롬프트 구성. 사용자 정의 프롬프트의 경우 문자열을 전달하거나, Claude Code의 시스템 프롬프트를 위해 `{"type": "preset", "preset": "claude_code"}` 사용. 프리셋을 확장하려면 `"append"` 추가 |

933| `agents` | `dict[str, AgentDefinition] \| None` | `None` | 프로그래밍 방식으로 정의된 서브에이전트 |933| `agents` | `dict[str, AgentDefinition] \| None` | `None` | 프로그래밍 방식으로 정의된 서브에이전트 |

934| `plugins` | `list[SdkPluginConfig]` | `[]` | 로컬 경로에서 사용자 정의 플러그인 로드. 자세한 내용은 [플러그인](/ko/agent-sdk/plugins) 참조 |934| `plugins` | `list[SdkPluginConfig]` | `[]` | 로컬 경로에서 사용자 정의 플러그인 로드. 자세한 내용은 [플러그인](/ko/agent-sdk/plugins) 참조 |

935| `sandbox` | [`SandboxSettings`](#sandboxsettings) ` \| None` | `None` | 프로그래밍 방식으로 샌드박스 동작 구성. 자세한 내용은 [샌드박스 설정](#sandboxsettings) 참조 |935| `sandbox` | [`SandboxSettings`](#sandboxsettings) ` \| None` | `None` | 프로그래밍 방식으로 샌드박스 동작 구성. 자세한 내용은 [샌드박스 설정](#sandboxsettings) 참조 |

936| `setting_sources` | `list[SettingSource] \| None` | `None` (CLI 기본값: 모든 소스) | 로드할 파일 시스템 설정을 제어합니다. 사용자, 프로젝트 및 로컬 설정을 비활성화하려면 `[]`를 전달합니다. 관리형 정책 설정은 어쨌든 로드됩니다. [Claude Code 기능 사용](/ko/agent-sdk/claude-code-features#what-settingsources-does-not-control)에서 이것이 제어하지 않는 입력 및 비활성화 방법 참조 |936| `setting_sources` | `list[SettingSource] \| None` | `None` (CLI 기본값: 모든 소스) | 로드할 파일 시스템 설정을 제어합니다. 사용자, 프로젝트 및 로컬 설정을 비활성화하려면 `[]`를 전달합니다. 관리형 정책 설정은 어쨌든 로드됩니다. 서버 관리 설정은 [적격 구성](/ko/server-managed-settings#platform-availability)에서 조직 자격증명으로 세션이 인증될 때 가져옵니다. [Claude Code 기능 사용](/ko/agent-sdk/claude-code-features#what-settingsources-does-not-control)에서 이것이 제어하지 않는 입력 및 비활성화 방법 참조 |

937| `skills` | `list[str] \| Literal["all"] \| None` | `None` | 세션에서 사용 가능한 스킬. 모든 발견된 스킬을 활성화하려면 `"all"`을 전달하거나, 스킬 이름 목록을 전달합니다. 설정하면 SDK는 `allowed_tools`에 Skill 도구를 자동으로 추가합니다. `tools`도 전달하는 경우 해당 목록에 `"Skill"`을 포함합니다. [스킬](/ko/agent-sdk/skills) 참조 |937| `skills` | `list[str] \| Literal["all"] \| None` | `None` | 세션에서 사용 가능한 스킬. 모든 발견된 스킬을 활성화하려면 `"all"`을 전달하거나, 스킬 이름 목록을 전달합니다. 설정하면 SDK는 `allowed_tools`에 Skill 도구를 자동으로 추가합니다. `tools`도 전달하는 경우 해당 목록에 `"Skill"`을 포함합니다. [스킬](/ko/agent-sdk/skills) 참조 |

938| `max_thinking_tokens` | `int \| None` | `None` | *Deprecated* - 생각 블록의 최대 토큰. 대신 `thinking` 사용 |938| `max_thinking_tokens` | `int \| None` | `None` | *Deprecated* - 생각 블록의 최대 토큰. 대신 `thinking` 사용 |

939| `thinking` | [`ThinkingConfig`](#thinkingconfig) ` \| None` | `None` | 확장된 생각 동작을 제어합니다. `max_thinking_tokens`보다 우선합니다 |939| `thinking` | [`ThinkingConfig`](#thinkingconfig) ` \| None` | `None` | 확장된 생각 동작을 제어합니다. `max_thinking_tokens`보다 우선합니다 |

1022 기본 동작1022 기본 동작

1023</h4>1023</h4>

1024 1024 

1025`setting_sources`가 생략되거나 `None`일 때, `query()`는 Claude Code CLI와 동일한 파일 시스템 설정을 로드합니다: 사용자, 프로젝트 및 로컬. 관리형 정책 설정은 모든 경우에 로드됩니다. 이 옵션과 관계없이 읽히는 입력 및 비활성화 방법은 [settingSources가 제어하지 않는 것](/ko/agent-sdk/claude-code-features#what-settingsources-does-not-control)을 참조하십시오.1025`setting_sources`가 생략되거나 `None`일 때, `query()`는 Claude Code CLI와 동일한 파일 시스템 설정을 로드합니다: 사용자, 프로젝트 및 로컬. 관리형 정책 설정은 모든 경우에 로드됩니다. 서버 관리 설정은 [적격 구성](/ko/server-managed-settings#platform-availability)에서 조직 자격증명으로 세션이 인증될 때 가져옵니다. [settingSources가 제어하지 않는 것](/ko/agent-sdk/claude-code-features#what-settingsources-does-not-control)에서 이것이 제어하지 않는 입력 및 비활성화 방법을 참조하십시오.

1026 1026 

1027<h4 id="why-use-setting_sources">1027<h4 id="why-use-setting_sources">

1028 setting\_sources를 사용하는 이유1028 setting\_sources를 사용하는 이유

419`resolveSettings()`는 단일 옵션 객체를 수락합니다. 모든 필드는 선택적입니다.419`resolveSettings()`는 단일 옵션 객체를 수락합니다. 모든 필드는 선택적입니다.

420 420 

421| 매개변수 | 타입 | 기본값 | 설명 |421| 매개변수 | 타입 | 기본값 | 설명 |

422| :------------------------------ | :------------------------------------ | :-------------- | :----------------------------------------------------------------------------- |422| :------------------------------ | :------------------------------------ | :-------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

423| `options.cwd` | `string` | `process.cwd()` | 프로젝트 및 로컬 설정을 상대적으로 해결할 디렉토리 |423| `options.cwd` | `string` | `process.cwd()` | 프로젝트 및 로컬 설정을 상대적으로 해결할 디렉토리 |

424| `options.settingSources` | [`SettingSource`](#settingsource)`[]` | 모든 소스 | 로드할 파일 시스템 소스입니다. 사용자, 프로젝트 및 로컬 설정을 건너뛰려면 `[]`를 전달합니다. 관리 정책 설정은 모든 경우에 로드됩니다 |424| `options.settingSources` | [`SettingSource`](#settingsource)`[]` | 모든 소스 | 로드할 파일 시스템 소스입니다. 사용자, 프로젝트 및 로컬 설정을 건너뛰려면 `[]`를 전달합니다. 관리 정책 설정은 모든 경우에 로드됩니다. 서버 관리 설정은 호스트가 `serverManagedSettings`를 전달할 때 가져오거나, 그렇지 않으면 CLI의 온디스크 캐시에서 읽습니다. 스냅샷은 네트워크에서 가져오지 않습니다 |

425| `options.managedSettings` | `Settings` | `undefined` | 관리 정책 우선순위 수준에서 병합된 제한적 정책 계층 설정입니다. `model`과 같은 제한적이지 않은 키는 자동으로 삭제됩니다 |425| `options.managedSettings` | `Settings` | `undefined` | 관리 정책 우선순위 수준에서 병합된 제한적 정책 계층 설정입니다. `model`과 같은 제한적이지 않은 키는 자동으로 삭제됩니다 |

426| `options.serverManagedSettings` | `Settings` | `undefined` | `/api/claude_code/settings`의 서버 관리 설정 페이로드입니다. 제한적이지 않은 키는 필터링 없이 통과합니다 |426| `options.serverManagedSettings` | `Settings` | `undefined` | `/api/claude_code/settings`의 서버 관리 설정 페이로드입니다. 제한적이지 않은 키는 필터링 없이 통과합니다 |

427 427 

517| `sessionStore` | [`SessionStore`](/ko/agent-sdk/session-storage#the-sessionstore-interface) | `undefined` | 세션 대화를 외부 백엔드로 미러링하여 모든 호스트가 이를 재개할 수 있습니다. [세션을 외부 저장소에 유지](/ko/agent-sdk/session-storage) 참조 |517| `sessionStore` | [`SessionStore`](/ko/agent-sdk/session-storage#the-sessionstore-interface) | `undefined` | 세션 대화를 외부 백엔드로 미러링하여 모든 호스트가 이를 재개할 수 있습니다. [세션을 외부 저장소에 유지](/ko/agent-sdk/session-storage) 참조 |

518| `sessionStoreFlush` | `'batched' \| 'eager'` | `'batched'` | *알파.* `sessionStore`의 플러시 모드입니다. `sessionStore`가 설정되지 않으면 무시됩니다 |518| `sessionStoreFlush` | `'batched' \| 'eager'` | `'batched'` | *알파.* `sessionStore`의 플러시 모드입니다. `sessionStore`가 설정되지 않으면 무시됩니다 |

519| `settings` | `string \| Settings` | `undefined` | 인라인 [설정](/ko/settings) 객체 또는 설정 파일의 경로입니다. [우선순위 순서](/ko/settings#settings-precedence)에서 플래그 설정 계층을 채웁니다. [`applyFlagSettings()`](#applyflagsettings)로 런타임에 변경합니다 |519| `settings` | `string \| Settings` | `undefined` | 인라인 [설정](/ko/settings) 객체 또는 설정 파일의 경로입니다. [우선순위 순서](/ko/settings#settings-precedence)에서 플래그 설정 계층을 채웁니다. [`applyFlagSettings()`](#applyflagsettings)로 런타임에 변경합니다 |

520| `settingSources` | [`SettingSource`](#settingsource)`[]` | CLI 기본값 (모든 소스) | 로드할 파일 시스템 설정을 제어합니다. 사용자, 프로젝트 및 로컬 설정을 비활성화하려면 `[]`을 전달합니다. 관리되는 정책 설정은 어쨌든 로드됩니다. [Claude Code 기능 사용](/ko/agent-sdk/claude-code-features#what-settingsources-does-not-control) 참조 |520| `settingSources` | [`SettingSource`](#settingsource)`[]` | CLI 기본값 (모든 소스) | 로드할 파일 시스템 설정을 제어합니다. 사용자, 프로젝트 및 로컬 설정을 비활성화하려면 `[]`을 전달합니다. 관리되는 정책 설정은 어쨌든 로드됩니다. 서버 관리 설정은 조직 자격 증명으로 세션이 [적격 구성](/ko/server-managed-settings#platform-availability)에서 인증할 때 가져옵니다. [Claude Code 기능 사용](/ko/agent-sdk/claude-code-features#what-settingsources-does-not-control)을 참조하여 이 옵션과 관계없이 읽히는 입력과 이를 비활성화하는 방법을 확인하세요 |

521| `skills` | `string[] \| 'all'` | `undefined` | 세션에서 사용 가능한 스킬입니다. 모든 발견된 스킬을 활성화하려면 `'all'`을 전달하거나 스킬 이름 목록을 전달합니다. 설정하면 SDK는 `allowedTools`에 Skill 도구를 자동으로 추가합니다. `tools`도 전달하는 경우 해당 목록에 `'Skill'`을 포함합니다. [스킬](/ko/agent-sdk/skills) 참조 |521| `skills` | `string[] \| 'all'` | `undefined` | 세션에서 사용 가능한 스킬입니다. 모든 발견된 스킬을 활성화하려면 `'all'`을 전달하거나 스킬 이름 목록을 전달합니다. 설정하면 SDK는 `allowedTools`에 Skill 도구를 자동으로 추가합니다. `tools`도 전달하는 경우 해당 목록에 `'Skill'`을 포함합니다. [스킬](/ko/agent-sdk/skills) 참조 |

522| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Claude Code 프로세스를 생성하는 사용자 정의 함수입니다. VM, 컨테이너 또는 원격 환경에서 Claude Code를 실행하는 데 사용합니다 |522| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Claude Code 프로세스를 생성하는 사용자 정의 함수입니다. VM, 컨테이너 또는 원격 환경에서 Claude Code를 실행하는 데 사용합니다 |

523| `stderr` | `(data: string) => void` | `undefined` | stderr 출력에 대한 콜백 |523| `stderr` | `(data: string) => void` | `undefined` | stderr 출력에 대한 콜백 |

765 기본 동작765 기본 동작

766</h4>766</h4>

767 767 

768`settingSources`가 생략되거나 `undefined`일 때 `query()`는 Claude Code CLI와 동일한 파일 시스템 설정을 로드합니다: 사용자, 프로젝트 및 로컬입니다. 관리되는 정책 설정은 모든 경우에 로드됩니다. [Claude Code 기능 사용](/ko/agent-sdk/claude-code-features#what-settingsources-does-not-control)을 참조하여 이 옵션과 관계없이 읽히는 입력과 이를 비활성화하는 방법을 확인하세요.768`settingSources`가 생략되거나 `undefined`일 때 `query()`는 Claude Code CLI와 동일한 파일 시스템 설정을 로드합니다: 사용자, 프로젝트 및 로컬입니다. 관리되는 정책 설정은 모든 경우에 로드됩니다. 서버 관리 설정은 조직 자격 증명으로 세션이 [적격 구성](/ko/server-managed-settings#platform-availability)에서 인증할 때 가져옵니다. [Claude Code 기능 사용](/ko/agent-sdk/claude-code-features#what-settingsources-does-not-control)을 참조하여 이 옵션과 관계없이 읽히는 입력과 이를 비활성화하는 방법을 확인하세요.

769 769 

770<h4 id="why-use-settingsources">770<h4 id="why-use-settingsources">

771 settingSources를 사용하는 이유771 settingSources를 사용하는 이유

477export CLAUDE_CODE_USE_MANTLE=1477export CLAUDE_CODE_USE_MANTLE=1

478```478```

479 479 

480Mantle 모델을 `/model` 선택기에 표시하려면 [설정 파일](/ko/settings)의 `availableModels`에 ID를 나열하십시오. 이 설정은 선택기를 나열된 항목으로 제한하므로 유지하려는 모든 별칭을 포함하십시오:480Mantle 모델을 `/model` 선택기에 표시하려면 [설정 파일](/ko/settings)의 `availableModels`에 ID를 나열하십시오. 이 설정은 선택기를 나열된 항목으로 제한하므로 유지하려는 버전 접두사 또는 전체 ID를 나열하십시오:

481 481 

482```json theme={null}482```json theme={null}

483{483{

484 "availableModels": ["opus", "sonnet", "haiku", "anthropic.claude-haiku-4-5"]484 "availableModels": ["opus", "sonnet", "claude-haiku-4-5", "anthropic.claude-haiku-4-5"]

485}485}

486```486```

487 487 

63 클라우드 세션에서 사용 가능한 것63 클라우드 세션에서 사용 가능한 것

64</h3>64</h3>

65 65 

66클라우드 세션은 저장소의 새로운 복제본에서 시작됩니다. 저장소에 커밋된 모든 것이 사용 가능합니다. 자신의 머신에만 설치하거나 구성한 것은 사용할 수 없습니다.66클라우드 세션은 저장소의 새로운 복제본에서 시작됩니다. 저장소에 커밋된 모든 것이 사용 가능합니다. 자신의 머신에만 설치하거나 구성한 것은 사용할 수 없습니다. 조직의 정책은 [서버 관리 설정](/ko/server-managed-settings)을 통해 별도로 도착합니다.

67 67 

68| | 클라우드 세션에서 사용 가능 | 이유 |68| | 클라우드 세션에서 사용 가능 | 이유 |

69| :------------------------------------------------------------------ | :-------------- | :--------------------------------------------------------------------------------------------- |69| :------------------------------------------------------------------ | :-------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

70| 저장소의 `CLAUDE.md` | 예 | 복제본의 일부 |70| 저장소의 `CLAUDE.md` | 예 | 복제본의 일부 |

71| 저장소의 `.claude/settings.json` hooks | 예 | 복제본의 일부 |71| 저장소의 `.claude/settings.json` hooks | 예 | 복제본의 일부 |

72| 저장소의 `.mcp.json` MCP 서버 | 예 | 복제본의 일부 |72| 저장소의 `.mcp.json` MCP 서버 | 예 | 복제본의 일부 |

73| 저장소의 `.claude/rules/` | 예 | 복제본의 일부 |73| 저장소의 `.claude/rules/` | 예 | 복제본의 일부 |

74| 저장소의 `.claude/skills/`, `.claude/agents/`, `.claude/commands/` | 예 | 복제본의 일부 |74| 저장소의 `.claude/skills/`, `.claude/agents/`, `.claude/commands/` | 예 | 복제본의 일부 |

75| `.claude/settings.json`에 선언된 플러그인 | 예 | 선언한 [마켓플레이스](/ko/plugin-marketplaces)에서 세션 시작 시 설치됩니다. 마켓플레이스 소스에 도달하려면 네트워크 액세스가 필요합니다 |75| `.claude/settings.json`에 선언된 플러그인 | 예 | 선언한 [마켓플레이스](/ko/plugin-marketplaces)에서 세션 시작 시 설치됩니다. 마켓플레이스 소스에 도달하려면 네트워크 액세스가 필요합니다 |

76| 조직의 [서버 관리 설정](/ko/server-managed-settings) | 예 | 세션이 시작될 때 Anthropic의 서버에서 가져옵니다. 클라우드 세션에서 `availableModels`이 어떻게 적용되는지는 [표면 범위](/ko/model-config#surface-coverage)를 참조하세요. MDM 또는 관리 설정 파일을 통해 장치에 배포된 설정은 세션이 Anthropic 관리 VM에서 실행되므로 적용되지 않습니다 |

76| 사용자 `~/.claude/CLAUDE.md` | 아니오 | 저장소가 아닌 머신에 있습니다 |77| 사용자 `~/.claude/CLAUDE.md` | 아니오 | 저장소가 아닌 머신에 있습니다 |

77| 사용자 `~/.claude/skills/`, `~/.claude/agents/`, `~/.claude/commands/` | 아니오 | 저장소가 아닌 머신에 있습니다. 대신 저장소의 `.claude/` 디렉토리에 커밋하세요. claude.ai에서 활성화한 Skills는 클라우드 세션에 자동으로 로드됩니다 |78| 사용자 `~/.claude/skills/`, `~/.claude/agents/`, `~/.claude/commands/` | 아니오 | 저장소가 아닌 머신에 있습니다. 대신 저장소의 `.claude/` 디렉토리에 커밋하세요. claude.ai에서 활성화한 Skills는 클라우드 세션에 자동으로 로드됩니다 |

78| 사용자 설정에서만 활성화된 플러그인 | 아니오 | 사용자 범위 `enabledPlugins`는 `~/.claude/settings.json`에 있습니다. 저장소의 `.claude/settings.json`에 선언하세요 |79| 사용자 설정에서만 활성화된 플러그인 | 아니오 | 사용자 범위 `enabledPlugins`는 `~/.claude/settings.json`에 있습니다. 저장소의 `.claude/settings.json`에 선언하세요 |

80| 정적 API 토큰 및 자격 증명 | 아니오 | 아직 전용 비밀 저장소가 없습니다. 아래를 참조하세요 |81| 정적 API 토큰 및 자격 증명 | 아니오 | 아직 전용 비밀 저장소가 없습니다. 아래를 참조하세요 |

81| AWS SSO와 같은 대화형 인증 | 아니오 | 지원되지 않습니다. SSO는 클라우드 세션에서 실행할 수 없는 브라우저 기반 로그인이 필요합니다 |82| AWS SSO와 같은 대화형 인증 | 아니오 | 지원되지 않습니다. SSO는 클라우드 세션에서 실행할 수 없는 브라우저 기반 로그인이 필요합니다 |

82 83 

83클라우드 세션에서 구성을 사용 가능하게 하려면 저장소에 커밋하세요. 아직 전용 비밀 저장소가 없습니다. 환경 변수와 설정 스크립트 모두 환경 구성에 저장되며, 해당 환경을 편집할 수 있는 모든 사람이 볼 수 있습니다. 클라우드 세션에서 비밀이 필요하면 이러한 가시성을 염두에 두고 환경 변수로 추가하세요.84클라우드 세션에서 구성을 사용 가능하게 하려면 저장소에 커밋하세요. 조직 정책은 [서버 관리 설정](/ko/server-managed-settings)을 통해 별도로 도착합니다. 아직 전용 비밀 저장소가 없습니다. 환경 변수와 설정 스크립트 모두 환경 구성에 저장되며, 해당 환경을 편집할 수 있는 모든 사람이 볼 수 있습니다. 클라우드 세션에서 비밀이 필요하면 이러한 가시성을 염두에 두고 환경 변수로 추가하세요.

84 85 

85<h3 id="installed-tools">86<h3 id="installed-tools">

86 설치된 도구87 설치된 도구

245| 실행 | Claude Code 시작 전, [캐시된 환경](#environment-caching)이 없을 때만 | Claude Code 시작 후, 재개된 세션을 포함한 모든 세션에서 |246| 실행 | Claude Code 시작 전, [캐시된 환경](#environment-caching)이 없을 때만 | Claude Code 시작 후, 재개된 세션을 포함한 모든 세션에서 |

246| 범위 | 클라우드 환경만 | 로컬 및 클라우드 모두 |247| 범위 | 클라우드 환경만 | 로컬 및 클라우드 모두 |

247 248 

248SessionStart hooks는 로컬의 사용자 수준 `~/.claude/settings.json`에서도 정의할 수 있지만 사용자 수준 설정은 클라우드 세션으로 이월되지 않습니다. 클라우드에서는 저장소에 커밋된 hooks만 실행됩니다.249SessionStart hooks는 로컬의 사용자 수준 `~/.claude/settings.json`에서도 정의할 수 있지만 사용자 수준 설정은 클라우드 세션으로 이월되지 않습니다. 클라우드에서는 저장소에서 그리고 조직의 [서버 관리 설정](/ko/server-managed-settings)에서 hooks가 제공됩니다.

249 250 

250<h3 id="install-dependencies-with-a-sessionstart-hook">251<h3 id="install-dependencies-with-a-sessionstart-hook">

251 SessionStart hook로 종속성 설치252 SessionStart hook로 종속성 설치

88| `/ide` | IDE 통합을 관리하고 상태를 표시합니다 |88| `/ide` | IDE 통합을 관리하고 상태를 표시합니다 |

89| `/init` | `CLAUDE.md` 가이드로 프로젝트를 초기화합니다. skills, hooks 및 개인 메모리 파일을 안내하는 대화형 흐름도 진행하려면 `CLAUDE_CODE_NEW_INIT=1`을 설정하세요 |89| `/init` | `CLAUDE.md` 가이드로 프로젝트를 초기화합니다. skills, hooks 및 개인 메모리 파일을 안내하는 대화형 흐름도 진행하려면 `CLAUDE_CODE_NEW_INIT=1`을 설정하세요 |

90| `/insights` | Claude Code 세션을 분석하는 보고서를 생성합니다. 프로젝트 영역, 상호 작용 패턴 및 마찰 지점을 포함합니다 |90| `/insights` | Claude Code 세션을 분석하는 보고서를 생성합니다. 프로젝트 영역, 상호 작용 패턴 및 마찰 지점을 포함합니다 |

91| `/install-github-app` | 리포지토리에 대해 [Claude GitHub Actions](/ko/github-actions) 앱을 설정합니다. 리포지토리를 선택하고 통합을 구성하는 과정을 안내합니다 |91| `/install-github-app` | 리포지토리에 대해 Claude GitHub App을 설치합니다. 선택적 단계로 [GitHub Actions](/ko/github-actions) 워크플로우 및 시크릿을 설정합니다. 리포지토리를 선택하고 통합을 구성하는 과정을 안내합니다 |

92| `/install-slack-app` | Claude Slack 앱을 설치합니다. OAuth 흐름을 완료하기 위해 브라우저를 엽니다 |92| `/install-slack-app` | Claude Slack 앱을 설치합니다. OAuth 흐름을 완료하기 위해 브라우저를 엽니다 |

93| `/keybindings` | [keyboard shortcuts](/ko/keybindings) 파일을 엽니다 |93| `/keybindings` | [keyboard shortcuts](/ko/keybindings) 파일을 엽니다 |

94| `/login` | Anthropic 계정에 로그인합니다 |94| `/login` | Anthropic 계정에 로그인합니다 |

691 관리 설정691 관리 설정

692</h3>692</h3>

693 693 

694관리 설정은 프로젝트 및 사용자 설정을 재정의하고 Desktop이 CLI 세션을 생성할 때 적용됩니다. 조직의 [관리 설정](/ko/settings#settings-precedence) 파일에서 이러한 키를 설정하거나 관리 콘솔을 통해 원격으로 푸시할 수 있습니다.694관리 설정은 프로젝트 및 사용자 설정을 재정의하고 Desktop의 Claude Code 세션에 적용됩니다. 조직의 [관리 설정](/ko/settings#settings-precedence) 파일에서 이러한 키를 설정하거나 관리 콘솔을 통해 원격으로 푸시할 수 있습니다.

695 695 

696| 키 | 설명 |696| 키 | 설명 |

697| ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |697| ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

698| `permissions.disableBypassPermissionsMode` | 사용자가 권한 무시 모드를 활성화하지 못하도록 하려면 `"disable"`로 설정합니다. |698| `permissions.disableBypassPermissionsMode` | 사용자가 권한 무시 모드를 활성화하지 못하도록 하려면 `"disable"`로 설정합니다. |

699| `disableAutoMode` | 사용자가 [Auto](/ko/permission-modes#eliminate-prompts-with-auto-mode) 모드를 활성화하지 못하도록 하려면 `"disable"`로 설정합니다. 모드 선택기에서 Auto를 제거합니다. `permissions` 아래에서도 허용됩니다. |699| `disableAutoMode` | 사용자가 [Auto](/ko/permission-modes#eliminate-prompts-with-auto-mode) 모드를 활성화하지 못하도록 하려면 `"disable"`로 설정합니다. 모드 선택기에서 Auto를 제거합니다. `permissions` 아래에서도 허용됩니다. |

700| `autoMode` | 조직 전체에서 auto mode 분류기가 신뢰하고 차단하는 것을 사용자 정의합니다. [auto mode 구성](/ko/auto-mode-config)을 참조하세요. |700| `autoMode` | 조직 전체에서 auto mode 분류기가 신뢰하고 차단하는 것을 사용자 정의합니다. [auto mode 구성](/ko/auto-mode-config)을 참조하세요. |

701| `sshConfigs` | 환경 드롭다운에 나타나는 [SSH 연결](#pre-configure-ssh-connections-for-your-team)을 사전 구성합니다. 사용자는 관리 연결을 편집하거나 삭제할 수 없습니다. |701| `sshConfigs` | 환경 드롭다운에 나타나는 [SSH 연결](#pre-configure-ssh-connections-for-your-team)을 사전 구성합니다. 사용자는 관리 연결을 편집하거나 삭제할 수 없습니다. |

702| `sshHostAllowlist` | [SSH 세션](#restrict-which-ssh-hosts-users-can-connect-to)을 확인된 호스트명이 이러한 패턴 중 하나와 일치하는 호스트로 제한합니다. 빈 배열은 SSH 세션을 비활성화합니다. 관리 설정에서만 읽습니다. |702| `sshHostAllowlist` | [SSH 세션](#restrict-which-ssh-hosts-users-can-connect-to)을 확인된 호스트명이 이러한 패턴 중 하나와 일치하는 호스트로 제한합니다. 빈 배열은 SSH 세션을 비활성화합니다. 관리 설정에서만 읽습니다. |

703| `managedMcpServers` | 타사 배포에서 모든 사용자에게 MCP 서버 구성을 푸시합니다. 각 항목은 `"http"`, `"sse"`, 또는 `"stdio"`의 전송, 연결 세부 정보, 그리고 선택적으로 해당 서버의 어떤 도구를 사용자가 호출할 수 있는지 제한하는 `toolPolicy` 맵을 지정합니다. 타사(3P) Desktop 배포에서만 사용 가능합니다. |703| `managedMcpServers` | 타사 배포에서 모든 사용자에게 MCP 서버 구성을 푸시합니다. 각 항목은 `"http"`, `"sse"`, 또는 `"stdio"`의 전송, 연결 세부 정보, 그리고 선택적으로 해당 서버의 어떤 도구를 사용자가 호출할 수 있는지 제한하는 `toolPolicy` 맵을 지정합니다. 타사(3P) Desktop 배포에서만 사용 가능합니다. 타사 배포는 관리 콘솔 설정을 받지 않으므로 관리 설정 파일 또는 MDM을 통해 이 키를 전달합니다. |

704 704 

705각 머신의 디스크에 배포된 관리 설정 파일은 Desktop 세션에 적용됩니다. 관리 콘솔을 통해 원격으로 푸시된 관리 설정은 현재 CLI 및 IDE 세션에만 도달하므로, Desktop 배포의 경우 MDM을 통해 파일을 배포하거나 위의 [관리 콘솔 컨트롤](#admin-console-controls)을 사용합니다.705Desktop 세션이 어느 위치에서 실행되는지에 따라 어떤 관리 설정이 Desktop 세션에 도달하는지가 결정됩니다. [`availableModels`](/ko/model-config#restrict-model-selection)과 같은 모델 제한은 터미널 CLI와 동일한 방식으로 Desktop의 Claude Code 세션에서 적용됩니다. [표면 범위](/ko/model-config#surface-coverage)를 참조하세요.

706 

707* **이 머신의 로컬 세션**: 디스크에 배포된 관리 설정 파일이 적용됩니다. 관리 콘솔을 통해 원격으로 푸시된 관리 설정도 세션이 조직 로그인 또는 직접 구성된 API 키로 인증할 때 Anthropic의 API에서 이러한 세션에 도달하며, 터미널 CLI와 동일한 [설정 우선순위](/ko/settings#settings-precedence)를 따릅니다.

708* **[클라우드 세션](#cloud-sessions)**: Anthropic이 관리하는 VM에서 실행되며 [서버 관리 설정](/ko/server-managed-settings)만 수신합니다.

709* **[SSH 세션](#ssh-sessions)**: 세션은 원격 호스트에서 관리 설정 파일을 읽습니다. Desktop 자체는 연결을 생성할 때 로컬 머신의 관리 설정에서 `sshConfigs` 및 `sshHostAllowlist`를 읽습니다.

706 710 

707`permissions.disableBypassPermissionsMode` 및 `disableAutoMode`는 사용자 및 프로젝트 설정에서도 작동하지만 관리 설정에 배치하면 사용자가 재정의하지 못하도록 방지합니다. `autoMode`는 사용자 설정, `.claude/settings.local.json`, 관리 설정에서 읽혀지지만 체크인된 `.claude/settings.json`에서는 읽혀지지 않습니다: 복제된 저장소는 자신의 분류기 규칙을 주입할 수 없습니다. `allowManagedPermissionRulesOnly` 및 `allowManagedHooksOnly`를 포함한 관리 전용 설정의 전체 목록은 [관리 전용 설정](/ko/permissions#managed-only-settings)을 참조하세요.711`permissions.disableBypassPermissionsMode` 및 `disableAutoMode`는 사용자 및 프로젝트 설정에서도 작동하지만 관리 설정에 배치하면 사용자가 재정의하지 못하도록 방지합니다. `autoMode`는 사용자 설정, `.claude/settings.local.json`, 관리 설정에서 읽혀지지만 체크인된 `.claude/settings.json`에서는 읽혀지지 않습니다: 복제된 저장소는 자신의 분류기 규칙을 주입할 수 없습니다. `allowManagedPermissionRulesOnly` 및 `allowManagedHooksOnly`를 포함한 관리 전용 설정의 전체 목록은 [관리 전용 설정](/ko/permissions#managed-only-settings)을 참조하세요.

708 712 

330 330 

331세부 정보 보기는 플러그인이 제공하는 구성 요소를 표시합니다: 명령어, skills, agents, hooks, MCP servers 및 LSP servers. 동일한 인벤토리는 `claude plugin details` 명령어로 명령줄에서도 사용할 수 있습니다.331세부 정보 보기는 플러그인이 제공하는 구성 요소를 표시합니다: 명령어, skills, agents, hooks, MCP servers 및 LSP servers. 동일한 인벤토리는 `claude plugin details` 명령어로 명령줄에서도 사용할 수 있습니다.

332 332 

333Claude Code v2.1.187 이상에서는 Installed 탭에 **Not used recently** 그룹이 추가되어 마켓플레이스에서 직접 설치했지만 최소 2주 동안 그리고 최소 10개 세션에서 호출하지 않은 플러그인을 표시하며, 세부 정보 보기는 각 플러그인에 대한 **Last used** 줄을 표시합니다. 이를 사용하여 더 이상 사용하지 않지만 여전히 시작 및 컨텍스트 비용을 추가하는 플러그인을 찾은 다음 비활성화하거나 제거합니다.

334 

335조직에서 관리하는 플러그인 또는 `--plugin-dir`로 로드하는 플러그인은 사용하지 않는 것으로 나열되지 않으며, LSP server, theme, output style, monitor 또는 workflow를 제공하는 플러그인도 추적할 호출 없이 값을 제공하므로 나열되지 않습니다. 조직이 [`strictKnownMarketplaces`](/ko/settings#strictknownmarketplaces)로 마켓플레이스를 제한할 때 그룹과 **Last used** 줄이 모두 숨겨집니다.

336 

333종속성을 선언하는 플러그인을 설치하면 설치 출력에 함께 자동 설치된 종속성이 나열됩니다.337종속성을 선언하는 플러그인을 설치하면 설치 출력에 함께 자동 설치된 종속성이 나열됩니다.

334 338 

335직접 명령어로 플러그인을 관리할 수도 있습니다.339직접 명령어로 플러그인을 관리할 수도 있습니다.

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

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

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

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

207| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | {/* max-version: 2.1.141 */}v2.1.142에서 제거됨. [빠른 모드](/ko/fast-mode) 기본값이 Opus 4.6에서 Opus 4.7로 이동했을 때 |207| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | {/* max-version: 2.1.141 */}v2.1.142에서 제거됨. [빠른 모드](/ko/fast-mode) 기본값이 Opus 4.6에서 Opus 4.7로 이동했을 때 |

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

209| `CLAUDE_CODE_ENABLE_TASKS` | 세션이 구조화된 Task 도구(`TaskCreate`, `TaskUpdate`, `TaskGet`, `TaskList`) 또는 레거시 `TodoWrite` 도구를 사용하는지 제어합니다. {/* min-version: 2.1.142 */}Claude Code v2.1.142부터 Task 도구는 모든 모드에서 기본값입니다. `TodoWrite`로 되돌리려면 `0`으로 설정합니다. [작업 목록](/ko/interactive-mode#task-list) 및 [Task 도구로 마이그레이션](/ko/agent-sdk/todo-tracking#migrate-to-task-tools) 참조 |209| `CLAUDE_CODE_ENABLE_TASKS` | 세션이 구조화된 Task 도구(`TaskCreate`, `TaskUpdate`, `TaskGet`, `TaskList`) 또는 레거시 `TodoWrite` 도구를 사용하는지 제어합니다. {/* min-version: 2.1.142 */}Claude Code v2.1.142부터 Task 도구는 모든 모드에서 기본값입니다. `TodoWrite`로 되돌리려면 `0`으로 설정합니다. [작업 목록](/ko/interactive-mode#task-list) 및 [Task 도구로 마이그레이션](/ko/agent-sdk/todo-tracking#migrate-to-task-tools) 참조 |

230| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | 병렬로 실행할 수 있는 읽기 전용 도구 및 subagent의 최대 수(기본값: 10). 더 높은 값은 병렬 처리를 증가시키지만 더 많은 리소스를 소비합니다. |230| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | 병렬로 실행할 수 있는 읽기 전용 도구 및 subagent의 최대 수(기본값: 10). 더 높은 값은 병렬 처리를 증가시키지만 더 많은 리소스를 소비합니다. |

231| `CLAUDE_CODE_MAX_TURNS` | 명시적 제한이 전달되지 않을 때 에이전트 턴 수를 제한합니다. [`--max-turns`](/ko/cli-reference#cli-flags) 전달과 동일하며, 둘 다 설정되면 우선합니다. 양의 정수가 아닌 값은 제한이 없는 것으로 취급되지 않고 오류와 함께 시작 시 거부됩니다. |231| `CLAUDE_CODE_MAX_TURNS` | 명시적 제한이 전달되지 않을 때 에이전트 턴 수를 제한합니다. [`--max-turns`](/ko/cli-reference#cli-flags) 전달과 동일하며, 둘 다 설정되면 우선합니다. 양의 정수가 아닌 값은 제한이 없는 것으로 취급되지 않고 오류와 함께 시작 시 거부됩니다. |

232| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | stdio MCP 서버를 안전한 기본 환경과 서버의 구성된 `env`만으로 생성하려면 `1`로 설정합니다. 셸 환경을 상속하지 않습니다. |232| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | stdio MCP 서버를 안전한 기본 환경과 서버의 구성된 `env`만으로 생성하려면 `1`로 설정합니다. 셸 환경을 상속하지 않습니다. |

233| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | {/* min-version: 2.1.187 */}원격 MCP 도구 호출의 유휴 타임아웃(밀리초)(기본값: 300000, 또는 5분). HTTP, SSE, WebSocket 또는 [claude.ai 커넥터](/ko/mcp#use-mcp-servers-from-claude-ai) MCP 서버가 이 기간 동안 응답 및 진행 알림을 보내지 않으면 도구 호출이 오류로 중단됩니다. 유휴 확인을 비활성화하려면 `0`으로 설정합니다. 1000 미만의 값은 1초로 올라갑니다. 값은 유효한 `MCP_TOOL_TIMEOUT`으로 제한됩니다. stdio 또는 IDE 서버에는 적용되지 않습니다. Claude Code v2.1.187 이상이 필요합니다. |

233| `CLAUDE_CODE_NATIVE_CURSOR` | 터미널의 자체 커서를 입력 캐럿에서 그려진 블록 대신 표시하려면 `1`로 설정합니다. 커서는 터미널의 깜박임, 모양, 포커스 설정을 존중합니다. |234| `CLAUDE_CODE_NATIVE_CURSOR` | 터미널의 자체 커서를 입력 캐럿에서 그려진 블록 대신 표시하려면 `1`로 설정합니다. 커서는 터미널의 깜박임, 모양, 포커스 설정을 존중합니다. |

234| `CLAUDE_CODE_NEW_INIT` | `/init`이 대화형 설정 흐름을 실행하도록 하려면 `1`로 설정합니다. 흐름은 코드베이스를 탐색하고 작성하기 전에 CLAUDE.md, skill 및 훅을 포함하여 생성할 파일을 묻습니다. 이 변수가 없으면 `/init`은 프롬프트 없이 자동으로 CLAUDE.md를 생성합니다. |235| `CLAUDE_CODE_NEW_INIT` | `/init`이 대화형 설정 흐름을 실행하도록 하려면 `1`로 설정합니다. 흐름은 코드베이스를 탐색하고 작성하기 전에 CLAUDE.md, skill 및 훅을 포함하여 생성할 파일을 묻습니다. 이 변수가 없으면 `/init`은 프롬프트 없이 자동으로 CLAUDE.md를 생성합니다. |

235| `CLAUDE_CODE_NO_FLICKER` | [전체 화면 렌더링](/ko/fullscreen)을 활성화하려면 `1`로 설정합니다. 이는 깜박임을 줄이고 긴 대화에서 메모리를 평탄하게 유지하는 연구 미리보기입니다. [`tui`](/ko/settings#available-settings) 설정과 동일합니다. `/tui fullscreen`으로도 전환할 수 있습니다. |236| `CLAUDE_CODE_NO_FLICKER` | [전체 화면 렌더링](/ko/fullscreen)을 활성화하려면 `1`로 설정합니다. 이는 깜박임을 줄이고 긴 대화에서 메모리를 평탄하게 유지하는 연구 미리보기입니다. [`tui`](/ko/settings#available-settings) 설정과 동일합니다. `/tui fullscreen`으로도 전환할 수 있습니다. |

55| `Extra inputs are not permitted` | [요청 오류](#extra-inputs-are-not-permitted) |55| `Extra inputs are not permitted` | [요청 오류](#extra-inputs-are-not-permitted) |

56| `There's an issue with the selected model` | [요청 오류](#there%E2%80%99s-an-issue-with-the-selected-model) |56| `There's an issue with the selected model` | [요청 오류](#there%E2%80%99s-an-issue-with-the-selected-model) |

57| `Claude Opus is not available with the Claude Pro plan` | [요청 오류](#claude-opus-is-not-available-with-the-claude-pro-plan) |57| `Claude Opus is not available with the Claude Pro plan` | [요청 오류](#claude-opus-is-not-available-with-the-claude-pro-plan) |

58| `Model ... is restricted by your organization's settings` | [요청 오류](#model-is-restricted-by-your-organization%E2%80%99s-settings) |

58| `thinking.type.enabled is not supported for this model` | [요청 오류](#thinking-type-enabled-is-not-supported-for-this-model) |59| `thinking.type.enabled is not supported for this model` | [요청 오류](#thinking-type-enabled-is-not-supported-for-this-model) |

59| `max_tokens must be greater than thinking.budget_tokens` | [요청 오류](#thinking-budget-exceeds-output-limit) |60| `max_tokens must be greater than thinking.budget_tokens` | [요청 오류](#thinking-budget-exceeds-output-limit) |

60| `API Error: 400 due to tool use concurrency issues` | [요청 오류](#tool-use-or-thinking-block-mismatch) |61| `API Error: 400 due to tool use concurrency issues` | [요청 오류](#tool-use-or-thinking-block-mismatch) |

706* 최근에 플랜을 업그레이드했는데도 여전히 이를 보면 `/logout`을 실행한 후 `/login`을 실행합니다. 저장된 토큰은 로그인 시 플랜을 반영하므로 웹에서 업그레이드해도 기존 세션에서 적용되지 않을 때까지 적용되지 않습니다.707* 최근에 플랜을 업그레이드했는데도 여전히 이를 보면 `/logout`을 실행한 후 `/login`을 실행합니다. 저장된 토큰은 로그인 시 플랜을 반영하므로 웹에서 업그레이드해도 기존 세션에서 적용되지 않을 때까지 적용되지 않습니다.

707* 각 플랜에 포함된 모델은 [claude.com/pricing](https://claude.com/pricing)을 참조하십시오.708* 각 플랜에 포함된 모델은 [claude.com/pricing](https://claude.com/pricing)을 참조하십시오.

708 709 

710<h3 id="model-is-restricted-by-your-organization’s-settings">

711 Model is restricted by your organization's settings

712</h3>

713 

714조직 관리자가 Claude Console에서 이 모델을 비활성화했거나 관리되는 설정의 [`availableModels`](/ko/model-config#restrict-model-selection) 허용 목록으로 제외되었습니다. 제한된 모델이 `--model`, `ANTHROPIC_MODEL` 또는 `model` 설정으로 설정되었을 때 Claude Code는 허용된 모델로 대체하고 계속합니다. 제한된 모델에 대해 `/model <name>`을 입력하면 `Run /model to choose a different model.`로 거부되고 세션은 현재 모델을 유지합니다.

715 

716```text theme={null}

717Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.

718```

719 

720**할 일:**

721 

722* `/model`을 실행하여 조직이 허용하는 모델 중에서 선택합니다. 제한된 모델은 선택기에서 숨겨집니다.

723* 제한된 모델이 `--model`, `ANTHROPIC_MODEL` 또는 설정 파일의 `model` 필드에 설정되었으면 해당 값을 제거하거나 업데이트하여 각 시작 시 알림이 반복되지 않도록 합니다.

724* 제한된 모델에 액세스해야 하면 조직 관리자에게 활성화를 요청합니다. [조직 모델 제한](/ko/model-config#organization-model-restrictions)을 참조하십시오.

725 

709<h3 id="thinking-type-enabled-is-not-supported-for-this-model">726<h3 id="thinking-type-enabled-is-not-supported-for-this-model">

710 thinking.type.enabled is not supported for this model727 thinking.type.enabled is not supported for this model

711</h3>728</h3>

115* **Team 및 Enterprise의 관리자 활성화**: 빠른 모드는 Team 및 Enterprise 조직에 대해 기본적으로 비활성화됩니다. 사용자가 액세스할 수 있으려면 관리자가 명시적으로 [빠른 모드를 활성화](#enable-fast-mode-for-your-organization)해야 합니다.115* **Team 및 Enterprise의 관리자 활성화**: 빠른 모드는 Team 및 Enterprise 조직에 대해 기본적으로 비활성화됩니다. 사용자가 액세스할 수 있으려면 관리자가 명시적으로 [빠른 모드를 활성화](#enable-fast-mode-for-your-organization)해야 합니다.

116 116 

117<Note>117<Note>

118 관리자가 조직에 대해 빠른 모드를 활성화하지 않은 경우 `/fast` 명령은 "Fast mode has been disabled by your organization."을 표시합니다. 조직의 [`availableModels`](/ko/model-config#restrict-model-selection) 허용 목록이 빠른 모드 Opus 모델을 제외하는 경우 `/fast`는 "is not in your organization's allowed models"로 거부됩니다.118 관리자가 조직에 대해 빠른 모드를 활성화하지 않은 경우 `/fast` 명령은 "Fast mode has been disabled by your organization."을 표시합니다. 조직의 [`availableModels`](/ko/model-config#restrict-model-selection) 허용 목록이 빠른 모드 Opus 모델을 제외하는 경우 `/fast`는 "is not in your organization's allowed models"로 거부됩니다. 예외는 빠른 모드를 지원하는 허용된 Opus 모델에서 이미 실행 중인 세션입니다: `/fast`는 그 모델에 적용됩니다.

119</Note>119</Note>

120 120 

121* **Team 및 Enterprise의 관리자 활성화**: 빠른 모드는 Team 및 Enterprise 조직에 대해 기본적으로 비활성화됩니다. 사용자가 액세스할 수 있으려면 관리자가 명시적으로 [빠른 모드를 활성화](#enable-fast-mode-for-your-organization)해야 합니다.

122 

121<h3 id="enable-fast-mode-for-your-organization">123<h3 id="enable-fast-mode-for-your-organization">

122 조직에 대해 빠른 모드 활성화124 조직에 대해 빠른 모드 활성화

123</h3>125</h3>

56 56 

57* **프롬프트 입력에서 클릭**하여 입력 중인 텍스트의 어디든지 커서를 배치합니다.57* **프롬프트 입력에서 클릭**하여 입력 중인 텍스트의 어디든지 커서를 배치합니다.

58* **`/` 명령 또는 `@` 파일 목록의 제안을 클릭**하여 수락합니다. 마우스 커서 위의 행을 강조 표시합니다.58* **`/` 명령 또는 `@` 파일 목록의 제안을 클릭**하여 수락합니다. 마우스 커서 위의 행을 강조 표시합니다.

59* **선택 메뉴의 옵션을 클릭**하여 선택합니다. 이는 권한 프롬프트, `/model`, `/config` 및 옵션 목록을 표시하는 기타 대화 상자를 포함합니다. 마우스 커서 위의 행에 포인터가 표시됩니다. {/* min-version: 2.1.187 */}Claude Code v2.1.187 이상이 필요합니다.

59* **축소된 도구 결과를 클릭**하여 확장하고 전체 출력을 봅니다. 다시 클릭하면 축소됩니다. 도구 호출과 그 결과가 함께 확장됩니다. 표시할 내용이 더 있는 메시지만 클릭 가능합니다.60* **축소된 도구 결과를 클릭**하여 확장하고 전체 출력을 봅니다. 다시 클릭하면 축소됩니다. 도구 호출과 그 결과가 함께 확장됩니다. 표시할 내용이 더 있는 메시지만 클릭 가능합니다.

60* **macOS에서 `Cmd`를 누르거나 Linux 및 Windows에서 `Ctrl`을 누르고 URL 또는 파일 경로를 클릭**하여 엽니다. Edit 또는 Write 후 인쇄된 것과 같은 도구 출력의 파일 경로는 기본 애플리케이션에서 열립니다. 일반 `http://` 및 `https://` URL은 브라우저에서 열립니다. v2.1.181부터 `Cmd` 또는 `Ctrl`을 누르지 않은 일반 클릭은 더 이상 링크를 열지 않으며, 기본 터미널 동작과 일치합니다. VS Code 통합 터미널 및 유사한 xterm.js 기반 터미널에서는 Claude Code가 터미널의 자체 링크 핸들러로 연기하며, 이는 동일한 제스처를 사용합니다.61* **macOS에서 `Cmd`를 누르거나 Linux 및 Windows에서 `Ctrl`을 누르고 URL 또는 파일 경로를 클릭**하여 엽니다. Edit 또는 Write 후 인쇄된 것과 같은 도구 출력의 파일 경로는 기본 애플리케이션에서 열립니다. 일반 `http://` 및 `https://` URL은 브라우저에서 열립니다. v2.1.181부터 `Cmd` 또는 `Ctrl`을 누르지 않은 일반 클릭은 더 이상 링크를 열지 않으며, 기본 터미널 동작과 일치합니다. VS Code 통합 터미널 및 유사한 xterm.js 기반 터미널에서는 Claude Code가 터미널의 자체 링크 핸들러로 연기하며, 이는 동일한 제스처를 사용합니다.

61* **클릭 및 드래그**하여 대화의 어디든지 텍스트를 선택합니다. 더블 클릭하면 단어를 선택하며, iTerm2의 단어 경계와 일치하므로 파일 경로가 하나의 단위로 선택됩니다. 트리플 클릭하면 줄을 선택합니다.62* **클릭 및 드래그**하여 대화의 어디든지 텍스트를 선택합니다. 더블 클릭하면 단어를 선택하며, iTerm2의 단어 경계와 일치하므로 파일 경로가 하나의 단위로 선택됩니다. 트리플 클릭하면 줄을 선택합니다.

44 빠른 설정44 빠른 설정

45</h2>45</h2>

46 46 

47이 작업을 설정하는 가장 쉬운 방법은 터미널에서 Claude Code를 통하는 것입니다. claude를 열고 `/install-github-app`을 실행하면 됩니다.47Claude Code 터미널에서 `/install-github-app`을 실행하여 통합을 대화형으로 설정합니다. 이 명령은 Claude GitHub 앱을 저장소에 설치한 다음 GitHub Actions 워크플로우 및 API 키 시크릿 추가 과정을 안내합니다.

48 48 

49이 명령은 GitHub 앱 및 필수 시크릿 설정을 안내합니다.49GitHub 앱이 설치된 후 명령은 GitHub Actions 설정을 계속할지 여부를 묻습니다. Claude Code v2.1.187 이상에서는 **지금 건너뛰기**를 선택하여 앱만 설치된 상태로 중지하고 `/install-github-app`을 다시 실행하여 워크플로우 및 시크릿 단계로 돌아갈 수 있습니다. 이전 버전은 워크플로우 선택으로 바로 진행합니다.

50 50 

51<Note>51<Note>

52 * GitHub 앱을 설치하고 시크릿을 추가하려면 저장소 관리자여야 합니다52 * GitHub 앱을 설치하고 시크릿을 추가하려면 저장소 관리자여야 합니다

208 Managed settings208 Managed settings

209</h3>209</h3>

210 210 

211IT 또는 DevOps에 의해 조직 전체에 적용되는 설정 파일이며, `~/.claude` 외부의 OS 수준 경로에 배치됩니다. 사용자는 관리 설정을 재정의하거나 제외할 수 없습니다. 보안 정책, 규정 준수 요구 사항 또는 플릿 전체의 표준화된 도구에 사용합니다.211IT 또는 DevOps에 의해 조직 전체에 적용되는 설정이며, Anthropic의 서버를 통해 관리 콘솔에서 전달되거나 `~/.claude` 외부의 OS 수준 경로에 배치됩니다. 사용자는 낮은 우선순위 범위에서 관리 설정을 재정의할 수 없습니다. 서버 관리 전달은 [적격 구성](/ko/server-managed-settings#platform-availability)에 적용됩니다. [보안 고려 사항](/ko/server-managed-settings#security-considerations)을 참조하십시오. 보안 정책, 규정 준수 요구 사항 또는 플릿 전체의 표준화된 도구에 사용합니다.

212 212 

213자세히 알아보기: [서버 관리 설정](/ko/server-managed-settings)213자세히 알아보기: [Server-managed settings](/ko/server-managed-settings) · [Settings files](/ko/settings#settings-files)

214 214 

215<h3 id="mcp-model-context-protocol">215<h3 id="mcp-model-context-protocol">

216 MCP (Model Context Protocol)216 MCP (Model Context Protocol)

268 * `Ctrl+C`를 눌러 취소하고 원래 입력 복원268 * `Ctrl+C`를 눌러 취소하고 원래 입력 복원

269 * 빈 검색에서 `Backspace`를 눌러 취소269 * 빈 검색에서 `Backspace`를 눌러 취소

270 270 

271검색은 검색어가 강조된 일치하는 명령을 표시하므로 이전 입력을 찾아 재사용할 수 있습니다.271검색은 선택한 범위에서 가장 최근의 고유한 프롬프트 100개를 로드하며, 중복은 가장 최신 항목으로 축소됩니다. 일치하는 프롬프트는 검색어가 강조된 상태로 표시되므로 이전 입력을 찾아 재사용할 수 있습니다.

272 272 

273<h2 id="background-bash-commands">273<h2 id="background-bash-commands">

274 백그라운드 bash 명령274 백그라운드 bash 명령

374| :------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------- |374| :------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------- |

375| `Space`, `Enter`, `Escape` | 답변을 해제하고 프롬프트로 돌아가기 |375| `Space`, `Enter`, `Escape` | 답변을 해제하고 프롬프트로 돌아가기 |

376| `Up` / `Down` | 답변 스크롤 |376| `Up` / `Down` | 답변 스크롤 |

377| `Left` / `Right` | {/* min-version: 2.1.187 */}이 답변과 세션의 이전 `/btw` 답변 사이를 이동합니다. `Left`는 이전 답변으로 이동하고 `Right`는 현재 답변으로 돌아갑니다. Claude Code v2.1.187 이상 필요 |

377| `c` | 답변을 클립보드에 원본 Markdown으로 복사합니다. 하드 래핑된 터미널 렌더링이 아닌 소스 텍스트를 캡처하는 마우스 선택 대신 이를 사용하세요 |378| `c` | 답변을 클립보드에 원본 Markdown으로 복사합니다. 하드 래핑된 터미널 렌더링이 아닌 소스 텍스트를 캡처하는 마우스 선택 대신 이를 사용하세요 |

378| `f` | 새 세션으로 포크합니다. 포크는 부모 대화에 이 질문과 답변을 실제 트랜스크립트 턴으로 상속하므로 전체 도구 액세스로 계속할 수 있습니다. 원본 세션은 [`/resume`](/ko/commands) 아래에 보존됩니다. 로컬 세션에서만 사용 가능 |379| `f` | 새 세션으로 포크합니다. 포크는 부모 대화에 이 질문과 답변을 실제 트랜스크립트 턴으로 상속하므로 전체 도구 액세스로 계속할 수 있습니다. 원본 세션은 [`/resume`](/ko/commands) 아래에 보존됩니다. 로컬 세션에서만 사용 가능 |

379| `x` | 현재 답변 위에 표시된 이전 `/btw` 교환 목록 지우기 |380| `x` | 현재 답변 위에 표시된 이전 `/btw` 교환 목록 지우기 |

218 218 

219서버당 `timeout`은 도구 호출당 하드 월클록 제한이며, 서버의 진행 알림은 이를 연장하지 않습니다. 1000 미만의 값은 무시되고 `MCP_TOOL_TIMEOUT`으로 넘어가거나, 해당 변수가 설정되지 않은 경우 약 28시간의 기본값으로 넘어갑니다. {/* min-version: 2.1.162 */}v2.1.162 이전에는 1000 미만의 값이 1초로 내림되었습니다. HTTP 및 SSE 서버의 경우, 요청당 fetch 첫 바이트 예산은 60초 최소값을 가집니다.219서버당 `timeout`은 도구 호출당 하드 월클록 제한이며, 서버의 진행 알림은 이를 연장하지 않습니다. 1000 미만의 값은 무시되고 `MCP_TOOL_TIMEOUT`으로 넘어가거나, 해당 변수가 설정되지 않은 경우 약 28시간의 기본값으로 넘어갑니다. {/* min-version: 2.1.162 */}v2.1.162 이전에는 1000 미만의 값이 1초로 내림되었습니다. HTTP 및 SSE 서버의 경우, 요청당 fetch 첫 바이트 예산은 60초 최소값을 가집니다.

220 220 

221v2.1.187부터 원격 HTTP, SSE, WebSocket 또는 [claude.ai 커넥터](#use-mcp-servers-from-claude-ai) 서버에 대한 도구 호출이 5분 동안 응답 및 진행 알림을 보내지 않으면 월클록 제한을 기다리는 대신 오류로 중단됩니다. [`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`](/ko/env-vars) 환경 변수를 밀리초 단위로 설정하여 유휴 윈도우를 변경하거나, `0`으로 설정하여 확인을 비활성화하세요. Stdio 서버는 로컬 프로세스이며 유휴 시간 초과의 대상이 아닙니다.

222 

221<h3 id="plugin-provided-mcp-servers">223<h3 id="plugin-provided-mcp-servers">

222 플러그인 제공 MCP 서버224 플러그인 제공 MCP 서버

223</h3>225</h3>

90 90 

91`--model` 플래그 및 `ANTHROPIC_MODEL` 환경 변수는 이를 사용하여 실행한 세션에만 적용됩니다. 동시에 다른 터미널에서 다른 모델을 실행하려면 `/model`로 전환하는 대신 각각 자신의 `--model` 플래그로 실행합니다.91`--model` 플래그 및 `ANTHROPIC_MODEL` 환경 변수는 이를 사용하여 실행한 세션에만 적용됩니다. 동시에 다른 터미널에서 다른 모델을 실행하려면 `/model`로 전환하는 대신 각각 자신의 `--model` 플래그로 실행합니다.

92 92 

93`claude --resume`, `--continue` 또는 `/resume` 선택기로 시작된 재개된 세션은 현재 `model` 설정에 관계없이 트랜스크립트가 저장되었을 때 사용 중이던 모델을 유지합니다. 해당 모델이 중단된 경우 세션은 일반 우선순위 순서로 폴백됩니다. 이는 다른 세션의 `/model` 선택이 재개 시 모델을 변경하는 것을 방지합니다.93`claude --resume`, `--continue` 또는 `/resume` 선택기로 시작된 재개된 세션은 현재 `model` 설정에 관계없이 트랜스크립트가 저장되었을 때 사용 중이던 모델을 유지합니다. 해당 모델이 중단된 경우 또는 [`availableModels`](#restrict-model-selection)에 의해 제외된 경우, 세션은 일반 우선순위 순서로 폴백됩니다. 이는 다른 세션의 `/model` 선택이 재개 시 모델을 변경하는 것을 방지합니다.

94 94 

95시작 시 활성 모델이 자신의 선택이 아닌 프로젝트 또는 관리되는 설정에서 나온 경우, 시작 헤더는 어느 설정 파일이 이를 설정했는지 표시합니다. `/model`을 실행하여 재정의합니다. 프로젝트 또는 관리되는 설정은 다음 실행 시 다시 적용됩니다.95시작 시 활성 모델이 자신의 선택이 아닌 프로젝트 또는 관리되는 설정에서 나온 경우, 시작 헤더는 어느 설정 파일이 이를 설정했는지 표시합니다. `/model`을 실행하여 재정의합니다. 프로젝트 또는 관리되는 설정은 다음 실행 시 다시 적용됩니다.

96 96 

121 모델 선택 제한121 모델 선택 제한

122</h2>122</h2>

123 123 

124엔터프라이즈 관리자는 [관리 또는 정책 설정](/ko/settings#settings-files)에서 `availableModels`을 사용하여 사용자가 선택할 수 있는 모델을 제한할 수 있습니다.124엔터프라이즈 관리자는 [관리 또는 정책 설정](/ko/settings#settings-files)에서 `availableModels`을 사용하여 사용자가 선택할 수 있는 모델을 제한할 수 있습니다. 항목은 `sonnet`과 같은 모델 패밀리, `claude-sonnet-4-5`와 같은 버전 접두사 또는 `claude-sonnet-4-5-20250929`와 같은 전체 모델 ID와 일치합니다.

125 125 

126`availableModels`이 설정되면 허용 목록은 사용자가 모델을 지정할 수 있는 모든 위치에 적용됩니다:126`availableModels`이 설정되면 허용 목록은 사용자가 모델을 지정할 수 있는 모든 위치에 적용됩니다:

127 127 

128* **메인 세션 모델**: `/model`, `--model` 플래그 및 `ANTHROPIC_MODEL` 환경 변수128* **메인 세션 모델**: `/model`, `--model` 플래그, `ANTHROPIC_MODEL` 환경 변수, `model` 설정 및 [세션을 재개할 때](#setting-your-model) 복원된 모델

129* **별칭 해석**: {/* min-version: 2.1.176 */}`ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL` 및 `ANTHROPIC_DEFAULT_FABLE_MODEL` 환경 변수는 허용된 별칭을 목록 외부의 모델로 리디렉션할 수 없습니다129* **별칭 해석**: {/* min-version: 2.1.176 */}`ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL` 및 `ANTHROPIC_DEFAULT_FABLE_MODEL` 환경 변수는 허용된 별칭을 목록 외부의 모델로 리디렉션할 수 없습니다

130* **빠른 모드**: {/* min-version: 2.1.176 */}`/fast`는 목록 외부의 Opus 모델로 암시적으로 전환될 때 토글을 거부하며, "is not in your organization's allowed models" 메시지를 표시합니다130* **빠른 모드**: {/* min-version: 2.1.176 */}`/fast`는 목록 외부의 Opus 모델로 암시적으로 전환될 때 토글을 거부하며, "is not in your organization's allowed models" 메시지를 표시합니다

131* **서브에이전트 모델**: [서브에이전트](/ko/sub-agents#choose-a-model) frontmatter의 `model` 필드, Agent 도구의 `model` 매개변수, `/agents`의 모델 선택기 및 `CLAUDE_CODE_SUBAGENT_MODEL`131* **서브에이전트 모델**: [서브에이전트](/ko/sub-agents#choose-a-model) frontmatter의 `model` 필드, Agent 도구의 `model` 매개변수, `/agents`의 모델 선택기 및 `CLAUDE_CODE_SUBAGENT_MODEL`

132* **어드바이저 모델**: 구성된 [`advisorModel`](/ko/advisor) 설정132* **스킬 및 명령 모델**: [스킬 및 명령](/ko/skills)의 `model` frontmatter

133* **폴백 체인**: [폴백 모델 체인](#fallback-model-chains) 외부의 요소는 삭제됩니다133* **어드바이저 모델**: 구성된 [`advisorModel`](/ko/advisor) 설정 및 `--advisor` 플래그

134* **백그라운드 에이전트 모델**: [디스패치 선택기](/ko/agent-view)에서 선택된 모델

134 135 

135`/model`로 차단된 모델로 전환하면 오류로 거부되고, 차단된 `--model` 플래그 또는 `ANTHROPIC_MODEL` 값은 시작 시 요청된 모델과 대체된 모델을 모두 이름 지은 경고와 함께 대체되며 세션은 기본 모델에서 시작됩니다. 차단된 서브에이전트 또는 어드바이저 재정의는 요청을 실패하지 않고 상속되거나 기본 모델로 폴백됩니다.136`/model`로 차단된 모델로 전환하면 오류로 거부되고, 차단된 `--model` 플래그, `ANTHROPIC_MODEL` 또는 `model` 설정 값은 시작 시 요청된 모델과 대체된 모델을 모두 이름 지은 경고와 함께 대체되며 세션은 기본 모델에서 시작됩니다. 차단된 서브에이전트, 스킬 또는 명령 재정의는 요청을 실패하지 않고 상속되거나 기본 모델로 폴백됩니다. 차단된 `advisorModel` 설정은 세션에 대해 어드바이저를 비활성화하고, 차단된 `--advisor` 플래그 값은 시작 시 오류로 종료됩니다. 제외된 모델은 `/model` 선택기에서 숨겨집니다.

137 

138자동 모델 변경은 동일한 방식으로 확인됩니다: [폴백 모델 체인](#fallback-model-chains)의 허용 목록 외부 요소는 삭제되고, [`opusplan`](#opusplan-model-setting)과 같은 계획 모드 업그레이드는 제외된 모델로 건너뛰어 계획이 세션의 모델에서 계속되며, 대상이 제외된 [자동 모델 폴백](#automatic-model-fallback)은 실행되지 않으므로 플래그된 요청은 거부로 끝납니다. [빠른 모드](/ko/fast-mode)를 활성화하면 세션이 실행될 모델이 허용 목록 외부에 있을 때 거부됩니다.

136 139 

137```json theme={null}140```json theme={null}

138{141{

140}143}

141```144```

142 145 

146<h3 id="surface-coverage">

147 표면 범위

148</h3>

149 

150모든 표면은 수신하는 허용 목록을 적용합니다. 각 표면에 도달하는 전달 메커니즘은 다릅니다:

151 

152| 전달 메커니즘 | CLI 및 IDE | 데스크톱 로컬 세션 | 웹, 모바일 및 클라우드 세션 | Agent SDK 및 비대화형 | Cowork |

153| :--------------------------------------------- | :-------- | :--------- | :--------------- | :--------------- | :----------- |

154| 관리 콘솔의 [서버 관리 설정](/ko/server-managed-settings) | 적용됨 | 적용됨 | 적용됨 | 적용됨 | 전달되지 않음 |

155| [MDM 또는 관리 설정 파일](/ko/settings#settings-files) | 적용됨 | 적용됨 | 전달되지 않음 | 적용됨 | 배포된 위치에서 적용됨 |

156 

157* 클라우드 세션은 [Claude Code on the web](/ko/claude-code-on-the-web) 또는 데스크톱 앱에서 Anthropic 관리 VM에서 실행됩니다: 장치에 배포된 설정은 이에 도달하지 않으므로 서버 관리 설정을 통해 허용 목록을 전달합니다. 클라우드 세션의 중간 세션 모델 전환은 요청된 모델이 허용 목록에 의해 제외될 때 거부됩니다. 세션 생성 시 서버 측 거부는 `availableModels` 설정 키가 아닌 [조직 모델 제한](#organization-model-restrictions)에 적용됩니다.

158* Cowork는 Claude 데스크톱 앱의 에이전트 작업 탭이며 설계상 서버 관리 설정을 수신하지 않습니다. 관리 설정 파일은 세션이 실행되는 위치에 있을 때 Cowork 세션에 적용됩니다. 원격 Cowork 세션은 Anthropic 관리 VM에서 실행되며, 여기서 장치 배포 파일이 없습니다.

159* [Bedrock, Vertex AI, Foundry 및 Claude Platform on AWS](/ko/claude-platform-on-aws)와 같은 [타사 제공자](/ko/server-managed-settings#platform-availability)의 세션은 서버 관리 설정을 수신하지 않으므로 MDM 또는 관리 설정 파일을 통해 허용 목록을 전달합니다.

160* 서버 관리 전달은 또한 세션이 조직 로그인 또는 직접 구성된 API 키로 인증해야 합니다. [`apiKeyHelper`](/ko/settings#available-settings) 스크립트를 통해서만 키를 생성하는 플릿은 MDM 또는 관리 설정 파일을 통해 허용 목록을 전달해야 합니다.

161* 데스크톱 Code 탭은 또한 [SSH 세션](/ko/desktop#ssh-sessions)을 호스팅하며, 이는 실행되는 원격 호스트에서 관리 설정 파일을 읽습니다. [데스크톱 관리 설정](/ko/desktop#managed-settings)을 참조하세요.

162* claude.ai 및 데스크톱 앱의 모델 선택기는 조직의 허용 목록에 의해 제외된 모델을 숨기거나 회색으로 표시합니다. 선택기 상태는 사용자를 위한 편의입니다. 적용은 세션에서 발생합니다.

163 

143<h3 id="default-model-behavior">164<h3 id="default-model-behavior">

144 기본 모델 동작165 기본 모델 동작

145</h3>166</h3>

146 167 

147기본적으로 모델 선택기의 Default 옵션은 `availableModels`의 영향을 받지 않습니다. 항상 사용 가능하며 [사용자의 구독 계층을 기반으로 한](#default-model-setting) 시스템의 런타임 기본값을 나타냅니다.168모델 선택기의 Default 옵션은 [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model)도 설정되지 않는 한 `availableModels`의 영향을 받지 않습니다. 자체적으로 `availableModels`은 Default를 사용 가능하게 두고, [사용자의 구독 계층을 기반으로 한](#default-model-setting) 시스템의 런타임 기본값으로 확인됩니다. 계층 기본값이 제한하려는 모델인 경우 `enforceAvailableModels`도 설정합니다.

148 169 

149허용 목록을 Default 옵션으로 확장하려면 비어 있지 않은 `availableModels` 목록과 함께 관리 또는 정책 설정에서 `enforceAvailableModels`을 `true`로 설정합니다. 계층 기본값이 허용 목록에 없으면 Default는 계층 기본값 대신 첫 번째 허용된 항목으로 확인됩니다. 이는 Claude Code v2.1.175 이상이 필요합니다.170빈 `availableModels` 배열은 Default 모델 강제를 활성화하지 않습니다: `availableModels: []`인 경우 명명된 모델 선택은 차단되지만 `enforceAvailableModels`에 관계없이 계정 유형에 대한 Default 모델은 사용 가능합니다.

150 171 

151빈 `availableModels` 배열은 강제를 활성화하지 않습니다. `availableModels: []`인 경우에도 사용자는 `enforceAvailableModels`에 관계없이 자신의 계층에 대한 Default 모델로 Claude Code를 사용할 수 있습니다.172<h3 id="enforce-the-allowlist-for-the-default-model">

173 Default 모델에 대해 허용 목록 적용

174</h3>

175 

176관리 설정에서 비어 있지 않은 `availableModels`과 함께 `enforceAvailableModels: true`를 설정하여 허용 목록을 Default 옵션으로 확장합니다. 이는 Claude Code v2.1.175 이상이 필요합니다.

177 

178```json theme={null}

179{

180 "availableModels": ["sonnet", "haiku"],

181 "enforceAvailableModels": true

182}

183```

184 

185사용자의 계정 유형에 대한 기본 모델이 허용 목록에 없으면 Default 옵션은 대신 허용되고 사용 가능한 모델을 이름 지은 첫 번째 `availableModels` 항목으로 확인되며, `/model` 선택기의 Default 행은 해당 모델을 표시합니다. 이는 기본값에 도달하는 모든 위치에 적용됩니다: 세션 시작, `/model`에서 Default 선택, [폴백 모델 체인](#fallback-model-chains)의 `"default"` 키워드 및 제외된 선택이 삭제될 때 사용되는 폴백입니다.

186 

187`enforceAvailableModels`은 `availableModels`이 설정되지 않거나 비어 있을 때 효과가 없습니다: `availableModels: []`인 경우 계정 유형에 대한 Default 모델은 사용 가능하므로 설정이 사용자를 모든 모델에서 잠글 수 없습니다. `availableModels`이 비어 있지 않지만 허용되고 사용 가능한 모델을 확인하는 항목이 없으면 강제가 저하되고 Default는 계정 유형 기본값으로 폴스루되며, `--debug` 아래에서만 표시되는 경고가 있습니다. 이를 피하려면 목록에 최소한 하나의 보장된 사용 가능 항목을 유지합니다.

188 

189[최고 우선순위 관리 소스](/ko/settings#settings-precedence)에 두 키를 배포합니다: 관리자 배포 관리 소스는 병합되지 않으므로 관리 설정 파일에 배치된 쌍은 관리 콘솔이 설정을 전달할 때 무시됩니다.

152 190 

153<h3 id="control-the-model-users-run-on">191<h3 id="control-the-model-users-run-on">

154 사용자가 실행하는 모델 제어192 사용자가 실행하는 모델 제어

155</h3>193</h3>

156 194 

157`model` 설정은 초기 선택이지 강제가 아닙니다. 세션이 시작될 때 활성화되는 모델을 설정하지만 사용자는 여전히 `/model`을 열고 Default를 선택할 수 있으며, 이는 `model`이 설정된 것과 관계없이 계층에 대한 시스템 기본값으로 확인됩니다.195`model` 설정은 초기 선택이지 강제가 아닙니다. 세션이 시작될 때 활성화되는 모델을 설정하지만 사용자는 여전히 `/model`을 열고 Default를 선택할 수 있으며, 이는 [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model)이 이를 리디렉션하지 않는 한 계층에 대한 시스템 기본값으로 확인됩니다.

158 196 

159모델 경험을 완전히 제어하려면 이러한 설정을 함께 사용합니다:197모델 경험을 완전히 제어하려면 이러한 설정을 함께 사용합니다:

160 198 

182 병합 동작220 병합 동작

183</h3>221</h3>

184 222 

185`availableModels`이 사용자, 프로젝트 및 로컬 설정에서만 설정되면 배열이 병합되고 이러한 수준에서 중복이 제거됩니다.223[최고 우선순위 관리 설정 소스](/ko/server-managed-settings#settings-precedence)가 `availableModels`을 정의하면 해당 목록만 적용됩니다: 사용자, 프로젝트 또는 로컬 설정의 항목은 이를 확대할 수 없으며, 관리자 배포 관리 소스는 서로 병합되지 않으므로 관리 설정 파일에 배포된 목록은 서버 관리 설정이 키를 전달할 때 무시됩니다. 그렇지 않으면 사용자, 프로젝트 및 로컬 설정의 목록은 다른 배열 설정처럼 [연결되고 중복이 제거됩니다](/ko/settings#settings-precedence). {/* min-version: 2.1.175 */}Claude Code v2.1.175부터 관리 목록은 낮은 우선순위 항목을 대체합니다. 이전 버전은 이들을 병합합니다.

186 224 

187`availableModels`이 관리 또는 정책 설정에서 설정되면 관리 또는 정책 값이 병합된 결과를 완전히 대체합니다: 사용자 또는 프로젝트 설정에서 추가된 항목은 이를 확대할 수 없습니다. 관리 및 정책 설정은 `enforceAvailableModels`에 대해 동일한 방식으로 낮은 우선순위 값을 대체합니다. Claude Code v2.1.175부터 이것이 엄격한 허용 목록을 적용하는 유일한 방법입니다. 이전 버전은 관리 목록을 낮은 우선순위 항목과 병합합니다.225유효한 목록 내에서 버전 접두사 또는 전체 모델 ID인지 여부에 관계없이 패밀리의 특정 모델을 이름 지은 항목은 해당 패밀리의 와일드카드 항목을 비활성화합니다: `["sonnet", "claude-sonnet-4-5"]`는 모든 Sonnet 모델이 아닌 Sonnet 4.5 버전만 허용합니다.

188 226 

189<h3 id="mantle-model-ids">227<h3 id="mantle-model-ids">

190 Mantle 모델 ID228 Mantle 모델 ID

191</h3>229</h3>

192 230 

193[Bedrock Mantle 엔드포인트](/ko/amazon-bedrock#use-the-mantle-endpoint)가 활성화되면 `availableModels`의 `anthropic.`으로 시작하는 항목이 `/model` 선택기에 사용자 정의 옵션으로 추가되고 Mantle 엔드포인트로 라우팅됩니다. 설정은 여전히 선택기를 나열된 항목으로 제한하므로 표준 별칭과 함께 모든 Mantle ID를 포함합니다.231[Bedrock Mantle 엔드포인트](/ko/amazon-bedrock#use-the-mantle-endpoint)가 활성화되면 `anthropic.`으로 시작하는 `availableModels`의 항목이 `/model` 선택기에 사용자 정의 옵션으로 추가되고 Mantle 엔드포인트로 라우팅됩니다. 이는 [타사 배포를 위한 모델 고정](#pin-models-for-third-party-deployments)에 설명된 별칭 일치에 대한 예외입니다. 설정은 여전히 선택기를 나열된 항목으로 제한하며, Mantle ID는 패밀리 이름을 포함하므로 특정 항목으로 계산되고 해당 패밀리의 와일드카드를 비활성화합니다: 모든 Mantle ID와 함께 유지하려는 버전 접두사 또는 전체 ID를 나열합니다. [병합 동작](#merge-behavior)을 참조하세요.

232 

233<h3 id="organization-model-restrictions">

234 조직 모델 제한

235</h3>

236 

237구성원이 Anthropic API를 통해 인증하고 설정 파일을 배포하지 않고 조직 전체 스위치를 원할 때 `availableModels` 대신 콘솔 토글을 사용합니다. 조직 관리자는 Claude 콘솔에서 개별 모델을 비활성화하여 구성원이 실행할 수 있는 모델을 제한합니다. 이 제한은 Claude Code가 인증할 때 계정의 자격과 함께 전달되며, 설정의 `availableModels` 목록과 별개이며, 서버는 세션이 생성될 때 동일한 제한을 독립적으로 적용합니다. Claude Code v2.1.187 이상이 필요합니다.

238 

239제한된 모델은 `/model` 선택기에서 숨겨집니다. `--model`, `ANTHROPIC_MODEL` 환경 변수 또는 `model` 설정으로 이름으로 선택하면 `Model "<name>" is restricted by your organization's settings. Using <model> instead.` 알림이 표시되고 세션은 허용된 모델에서 시작됩니다. 제한된 모델에 대해 `/model <name>`을 입력하면 `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.`로 거부되고 세션은 현재 모델을 유지합니다.

240 

241두 메커니즘은 구성됩니다: 모델은 `availableModels`에 의해 허용되고 조직에 의해 제한되지 않을 때만 선택 가능합니다. 조직 제한은 Anthropic API 및 [LLM 게이트웨이](/ko/llm-gateway) 배포의 세션에 전달됩니다. Bedrock, Vertex AI, Foundry 및 Claude Platform on AWS의 세션은 이를 수신하지 않으므로 대신 해당 제공자에서 `availableModels`을 사용합니다.

194 242 

195<h2 id="special-model-behavior">243<h2 id="special-model-behavior">

196 특수 모델 동작244 특수 모델 동작

209 257 

210Enterprise 종량제는 구독 시트가 아닌 사용량으로 청구되는 Enterprise 조직을 의미합니다.258Enterprise 종량제는 구독 시트가 아닌 사용량으로 청구되는 Enterprise 조직을 의미합니다.

211 259 

260관리 설정이 [Default 모델에 대한 허용 목록을 적용](#enforce-the-allowlist-for-the-default-model)하고 계정 유형 기본값이 `availableModels`에 없을 때 `default`는 위의 계정 유형 기본값 대신 적용된 Default로 확인됩니다.

261 

212Fable 5는 어떤 계정 유형에서도 기본 모델이 아닙니다. 세션은 `/model fable`, `model` 설정 또는 Fable 5를 사용할 수 있는 `best` 별칭으로 선택한 후에만 Fable 5를 사용합니다. `/model`로 선택하면 사용자 설정에서 선택된 모델로 저장되므로 모델을 변경할 때까지 이후 세션이 Fable 5에서 시작됩니다.262Fable 5는 어떤 계정 유형에서도 기본 모델이 아닙니다. 세션은 `/model fable`, `model` 설정 또는 Fable 5를 사용할 수 있는 `best` 별칭으로 선택한 후에만 Fable 5를 사용합니다. `/model`로 선택하면 사용자 설정에서 선택된 모델로 저장되므로 모델을 변경할 때까지 이후 세션이 Fable 5에서 시작됩니다.

213 263 

214<h3 id="opusplan-model-setting">264<h3 id="opusplan-model-setting">

267 317 

268세션은 그 Opus 모델에서 계속됩니다. Fable 5로 돌아가려면 `/model fable`을 실행합니다.318세션은 그 Opus 모델에서 계속됩니다. Fable 5로 돌아가려면 `/model fable`을 실행합니다.

269 319 

320폴백 대상은 [`availableModels`](#restrict-model-selection)에 대해 확인됩니다. 차단되면 폴백이 발생하지 않습니다. 거부는 정상 오류로 표시되고 세션의 모델은 변경되지 않습니다.

321 

270<h4 id="check-what-triggered-fallback">322<h4 id="check-what-triggered-fallback">

271 폴백을 트리거한 것 확인323 폴백을 트리거한 것 확인

272</h4>324</h4>

286* 두 모델이 동일한 요청에 플래그를 지정하면 프롬프트를 편집하고 다시 시도하거나 새 세션을 시작할 수 있습니다.338* 두 모델이 동일한 요청에 플래그를 지정하면 프롬프트를 편집하고 다시 시도하거나 새 세션을 시작할 수 있습니다.

287* 모바일 [Claude Code on the web](/ko/claude-code-on-the-web) 세션에서는 편집 및 재시도가 지원되지 않습니다. 모델을 전환하거나 데스크톱 브라우저 또는 데스크톱 앱에서 세션을 계속합니다.339* 모바일 [Claude Code on the web](/ko/claude-code-on-the-web) 세션에서는 편집 및 재시도가 지원되지 않습니다. 모델을 전환하거나 데스크톱 브라우저 또는 데스크톱 앱에서 세션을 계속합니다.

288* [비대화형 모드](/ko/cli-reference#cli-flags) 및 프롬프트를 표시할 수 없는 SDK 통합에서 플래그가 지정된 요청은 거부로 턴을 종료합니다.340* [비대화형 모드](/ko/cli-reference#cli-flags) 및 프롬프트를 표시할 수 없는 SDK 통합에서 플래그가 지정된 요청은 거부로 턴을 종료합니다.

341* 폴백 대상이 [`availableModels`](#restrict-model-selection)에 의해 차단되면 프롬프트가 표시되지 않습니다. 플래그가 지정된 요청은 거부로 종료되며, 대상이 차단될 때 자동 폴백과 동일합니다.

289 342 

290<h4 id="enable-fallback-on-bedrock-vertex-ai-and-foundry">343<h4 id="enable-fallback-on-bedrock-vertex-ai-and-foundry">

291 Bedrock, Vertex AI 및 Foundry에서 폴백 활성화344 Bedrock, Vertex AI 및 Foundry에서 폴백 활성화

452 505 

453사용자 정의 항목은 `/model` 선택기의 맨 아래에 나타납니다. `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` 및 `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION`은 선택 사항입니다. 생략하면 모델 ID가 이름으로 사용되고 설명은 기본값으로 `Custom model (<model-id>)`입니다.506사용자 정의 항목은 `/model` 선택기의 맨 아래에 나타납니다. `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` 및 `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION`은 선택 사항입니다. 생략하면 모델 ID가 이름으로 사용되고 설명은 기본값으로 `Custom model (<model-id>)`입니다.

454 507 

455Claude Code는 `ANTHROPIC_CUSTOM_MODEL_OPTION`에 설정된 모델 ID에 대한 유효성 검사를 건너뜁니다. 따라서 API 엔드포인트가 허용하는 모든 문자열을 사용할 수 있습니다.508Claude Code는 `ANTHROPIC_CUSTOM_MODEL_OPTION`에 설정된 모델 ID에 대한 유효성 검사를 건너뜁니다. 따라서 API 엔드포인트가 허용하는 모든 문자열을 사용할 수 있습니다. [`availableModels`](#restrict-model-selection)이 설정되어 있을 때는 사용자 정의 모델 ID를 허용 목록에도 포함시켜야 합니다. 사용자 정의 항목이 선택기에서 필터링되고 `--model` 선택이 다른 제외된 모델처럼 거부됩니다. `my-gateway/claude-opus-4-7`과 같이 패밀리 이름을 포함하는 사용자 정의 ID는 해당 패밀리의 특정 항목으로 계산되며 와일드카드를 비활성화하므로, 선택 가능하게 유지하려는 버전도 나열해야 합니다. [병합 동작](#merge-behavior)을 참조하십시오.

456 509 

457<h2 id="environment-variables">510<h2 id="environment-variables">

458 환경 변수511 환경 변수

505* 접미사는 모델별이 아닌 변수별로 읽혀집니다. Bedrock, Vertex 및 Foundry에서 한 변수의 `[1m]` 없는 모델 ID는 다른 변수가 접미사와 함께 동일한 모델을 설정하더라도 200K 컨텍스트를 사용합니다.558* 접미사는 모델별이 아닌 변수별로 읽혀집니다. Bedrock, Vertex 및 Foundry에서 한 변수의 `[1m]` 없는 모델 ID는 다른 변수가 접미사와 함께 동일한 모델을 설정하더라도 200K 컨텍스트를 사용합니다.

506 559 

507<Note>560<Note>

508 `settings.availableModels` 허용 목록은 타사 제공자를 사용할 때도 적용됩니다. 필터링은 `opus`, 버전 접두사(예: `claude-opus-4-8`) 또는 전체 모델 ID와 같은 모델 별칭과 일치합니다. 모든 `[1m]` 접미사는 허용 목록 항목과 요청된 모델 모두에서 제거되므로 `claude-opus-4-8` 항목은 표준 및 1M 컨텍스트 Opus 행을 모두 허용합니다. `us.anthropic.`과 같은 제공자별 접두사는 제거되지 않습니다. 선택기가 표시하는 것과 동일한 형식을 `availableModels`에 나열하거나 [`modelOverrides`](#override-model-ids-per-version)를 통해 매핑합니다.561 `availableModels` 허용 목록은 타사 제공자를 사용할 때도 적용됩니다. [서버 관리 설정은 그곳에 전달되지 않습니다](/ko/server-managed-settings#platform-availability). 필터링은 `opus`와 같은 모델 별칭, `claude-opus-4-8`과 같은 버전 접두사 또는 전체 제공자 형식 모델 ID와 일치합니다. `us.anthropic.`과 같은 제공자별 접두사는 제거되지 않으므로 특정 모델을 허용하려면 선택기가 표시하는 것과 동일한 제공자 형식 ID를 나열하거나 [`modelOverrides`](#override-model-ids-per-version)를 통해 매핑합니다. 모든 `[1m]` 접미사는 허용 목록 항목과 요청된 모델 모두에서 제거되어 일치합니다.

509</Note>562</Note>

510 563 

511<h3 id="customize-pinned-model-display-and-capabilities">564<h3 id="customize-pinned-model-display-and-capabilities">

572 625 

573재정의는 `/model` 선택기의 각 항목을 지원하는 기본 제공 모델 ID를 대체합니다. Bedrock에서 재정의는 Claude Code가 시작 시 자동으로 발견하는 모든 추론 프로필보다 우선합니다. `ANTHROPIC_MODEL`, `--model` 또는 `ANTHROPIC_DEFAULT_*_MODEL` 환경 변수를 통해 직접 제공하는 값은 제공자에게 그대로 전달되며 `modelOverrides`로 변환되지 않습니다.626재정의는 `/model` 선택기의 각 항목을 지원하는 기본 제공 모델 ID를 대체합니다. Bedrock에서 재정의는 Claude Code가 시작 시 자동으로 발견하는 모든 추론 프로필보다 우선합니다. `ANTHROPIC_MODEL`, `--model` 또는 `ANTHROPIC_DEFAULT_*_MODEL` 환경 변수를 통해 직접 제공하는 값은 제공자에게 그대로 전달되며 `modelOverrides`로 변환되지 않습니다.

574 627 

575`modelOverrides`는 `availableModels`과 함께 작동합니다. 허용 목록은 재정의 값이 아닌 Anthropic 모델 ID에 대해 평가되므로 `availableModels`의 `"opus"`와 같은 항목은 Opus 버전이 ARN에 매핑되어도 계속 일치합니다.628`modelOverrides`는 `availableModels`과 함께 작동합니다. 허용 목록은 재정의 값이 아닌 Anthropic 모델 ID에 대해 평가되므로 `availableModels`의 `"opus"`와 같은 항목은 Opus 버전이 ARN에 매핑되어도 계속 일치합니다. `enforceAvailableModels`이 관리 설정에서 설정되면 강제된 기본값은 [가장 높은 우선순위 관리 소스](/ko/server-managed-settings#settings-precedence)에서만 `modelOverrides`를 통해 확인됩니다. 추론 프로필 ARN에 고정된 버전과 같은 관리자의 매핑이 강제된 기본값에서 인정됩니다. 사용자 또는 프로젝트 설정의 재정의는 이에 영향을 주지 않습니다.

576 629 

577<h3 id="prompt-caching-configuration">630<h3 id="prompt-caching-configuration">

578 Prompt caching 구성631 Prompt caching 구성

1164 1164 

1165Claude Code는 실패한 API 요청을 내부적으로 재시도하고 포기한 후에만 단일 `claude_code.api_error` 이벤트를 내보내므로 이벤트 자체가 해당 요청의 최종 신호입니다. 중간 재시도 시도는 별도의 이벤트로 기록되지 않습니다.1165Claude Code는 실패한 API 요청을 내부적으로 재시도하고 포기한 후에만 단일 `claude_code.api_error` 이벤트를 내보내므로 이벤트 자체가 해당 요청의 최종 신호입니다. 중간 재시도 시도는 별도의 이벤트로 기록되지 않습니다.

1166 1166 

1167이벤트의 `attempt` 속성은 총 시도 횟수를 기록합니다. `CLAUDE_CODE_MAX_RETRIES` (기본값 `10`, 최대 `15`)보다 큰 값은 요청이 일시적 오류에 대한 모든 재시도를 소진했음을 나타냅니다. 더 낮은 값은 `400` 응답과 같은 재시도 불가능한 오류를 나타냅니다.1167이벤트의 `attempt` 속성은 총 시도 횟수를 기록합니다. `CLAUDE_CODE_MAX_RETRIES`는 기본값이 10이고 최대 15입니다. 요청이 일시적 오류에 대한 모든 재시도를 소진하면 `attempt`는 해당 유효 제한보다 하나 많습니다: 기본값으로는 11이고 16을 초과하지 않습니다. 더 낮은 값은 `400` 응답과 같은 재시도 불가능한 오류를 나타냅니다.

1168 1168 

1169복구된 세션과 정체된 세션을 구분하려면 `session.id`로 이벤트를 그룹화하고 오류 후 나중에 `api_request` 이벤트가 존재하는지 확인합니다.1169복구된 세션과 정체된 세션을 구분하려면 `session.id`로 이벤트를 그룹화하고 오류 후 나중에 `api_request` 이벤트가 존재하는지 확인합니다.

1170 1170 

202 202 

203`.`의 `allowRead`는 이 구성이 프로젝트 설정에 있으므로 프로젝트 루트로 해석됩니다. 동일한 구성을 `~/.claude/settings.json`에 배치했다면 `.`은 `~/.claude`로 해석되고 프로젝트 파일은 `denyRead` 규칙에 의해 차단된 상태로 유지됩니다.203`.`의 `allowRead`는 이 구성이 프로젝트 설정에 있으므로 프로젝트 루트로 해석됩니다. 동일한 구성을 `~/.claude/settings.json`에 배치했다면 `.`은 `~/.claude`로 해석되고 프로젝트 파일은 `denyRead` 규칙에 의해 차단된 상태로 유지됩니다.

204 204 

205<h3 id="protect-credentials">

206 자격증명 보호

207</h3>

208 

209`sandbox.credentials` 설정은 샌드박싱된 명령이 액세스하면 안 되는 자격증명 파일 및 환경 변수를 선언합니다. 나열된 파일 경로는 샌드박스 내에서 읽기가 거부되며, `filesystem.denyRead`가 적용하는 것과 동일한 블록이고, 나열된 환경 변수는 각 샌드박싱된 명령 실행 전에 설정 해제됩니다. 전용 `credentials` 블록은 자격증명 규칙을 환경 변수 설정 해제와 함께 그룹화하고 일반 파일시스템 규칙과 분리합니다. Claude Code v2.1.187 이상이 필요합니다.

210 

211아래 예제는 AWS 자격증명 파일 및 SSH 디렉토리의 읽기를 차단하고 샌드박싱된 명령의 환경에서 `GITHUB_TOKEN` 및 `NPM_TOKEN`을 제거합니다:

212 

213```json theme={null}

214{

215 "sandbox": {

216 "enabled": true,

217 "credentials": {

218 "files": [

219 { "path": "~/.aws/credentials", "mode": "deny" },

220 { "path": "~/.ssh", "mode": "deny" }

221 ],

222 "envVars": [

223 { "name": "GITHUB_TOKEN", "mode": "deny" },

224 { "name": "NPM_TOKEN", "mode": "deny" }

225 ]

226 }

227 }

228}

229```

230 

231각 항목은 `"mode": "deny"`를 포함하며, 이는 유일하게 지원되는 값입니다. 명시적 `mode` 필드는 스키마를 향후 모드와의 호환성을 유지합니다. 파일 경로는 `sandbox.filesystem.*` 설정과 동일한 [접두사 규칙](/ko/settings#sandbox-path-prefixes)을 따르며, 모든 [설정 범위](/ko/settings#settings-precedence)의 항목이 병합됩니다. 유일한 모드가 `deny`이므로 모든 범위는 제한을 추가할 수 있지만 제거할 수는 없습니다.

232 

233기본 제공 자격증명 거부 목록이 없으므로 나열한 파일 및 변수만 제한됩니다. 이 설정은 샌드박싱된 Bash 명령에만 영향을 미칩니다. 샌드박싱 여부와 관계없이 모든 하위 프로세스에서 Anthropic 및 클라우드 공급자 자격증명을 제거하려면 [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/ko/env-vars)를 설정합니다.

234 

205<h2 id="how-sandboxing-works">235<h2 id="how-sandboxing-works">

206 샌드박싱 작동 방식236 샌드박싱 작동 방식

207</h2>237</h2>

213샌드박싱된 Bash 도구는 파일 시스템 액세스를 특정 디렉토리로 제한합니다:243샌드박싱된 Bash 도구는 파일 시스템 액세스를 특정 디렉토리로 제한합니다:

214 244 

215* **기본 쓰기 동작**: 현재 작업 디렉토리 및 그 하위 디렉토리에 대한 읽기 및 쓰기 액세스, 그리고 `$TMPDIR`이 가리키는 세션 임시 디렉토리에 대한 액세스245* **기본 쓰기 동작**: 현재 작업 디렉토리 및 그 하위 디렉토리에 대한 읽기 및 쓰기 액세스, 그리고 `$TMPDIR`이 가리키는 세션 임시 디렉토리에 대한 액세스

216* **기본 읽기 동작**: 특정 거부된 디렉토리를 제외한 전체 컴퓨터에 대한 읽기 액세스. 이 기본값은 여전히 `~/.aws/credentials` 및 `~/.ssh/`와 같은 자격 증명 파일 읽기를 허용합니다. 이를 차단하려면 `denyRead`에 추가합니다.246* **기본 읽기 동작**: 특정 거부된 디렉토리를 제외한 전체 컴퓨터에 대한 읽기 액세스. 이 기본값은 여전히 `~/.aws/credentials` 및 `~/.ssh/`와 같은 자격 증명 파일 읽기를 허용합니다. [`sandbox.credentials`](#protect-credentials)를 사용하여 이러한 파일의 읽기를 차단하고 비밀 환경 변수를 설정 해제하거나, 경로를 `denyRead`에 추가합니다.

217* **차단된 액세스**: 명시적 권한 없이 현재 작업 디렉토리 및 세션 임시 디렉토리 외부의 파일을 수정할 수 없습니다. `~/.bashrc`와 같은 셸 구성 파일 및 `/bin/`의 시스템 바이너리 포함247* **차단된 액세스**: 명시적 권한 없이 현재 작업 디렉토리 및 세션 임시 디렉토리 외부의 파일을 수정할 수 없습니다. `~/.bashrc`와 같은 셸 구성 파일 및 `/bin/`의 시스템 바이너리 포함

218* **Git worktrees**: 작업 디렉토리가 [연결된 git worktree](/ko/worktrees)일 때, 샌드박스는 또한 메인 저장소의 공유 `.git` 디렉토리에 대한 쓰기를 허용하므로 `git commit`과 같은 명령이 refs 및 인덱스를 업데이트할 수 있습니다. 해당 디렉토리 내의 `hooks/` 및 `config`에 대한 쓰기는 계속 거부됩니다.248* **Git worktrees**: 작업 디렉토리가 [연결된 git worktree](/ko/worktrees)일 때, 샌드박스는 또한 메인 저장소의 공유 `.git` 디렉토리에 대한 쓰기를 허용하므로 `git commit`과 같은 명령이 refs 및 인덱스를 업데이트할 수 있습니다. 해당 디렉토리 내의 `hooks/` 및 `config`에 대한 쓰기는 계속 거부됩니다.

219* **구성 가능**: 설정을 통해 사용자 정의 허용 및 거부 경로를 정의합니다249* **구성 가능**: 설정을 통해 사용자 정의 허용 및 거부 경로를 정의합니다

326* **`failIfUnavailable`**: Linux의 bubblewrap과 같은 누락된 종속성이 경고를 표시하고 샌드박싱 없는 실행으로 폴백하는 대신 Claude Code가 시작되는 것을 차단합니다356* **`failIfUnavailable`**: Linux의 bubblewrap과 같은 누락된 종속성이 경고를 표시하고 샌드박싱 없는 실행으로 폴백하는 대신 Claude Code가 시작되는 것을 차단합니다

327* **`allowUnsandboxedCommands: false`**: `dangerouslyDisableSandbox` 탈출 해치가 무시되므로 샌드박스에서 실패한 명령을 샌드박스 외부에서 다시 시도할 수 없습니다357* **`allowUnsandboxedCommands: false`**: `dangerouslyDisableSandbox` 탈출 해치가 무시되므로 샌드박스에서 실패한 명령을 샌드박스 외부에서 다시 시도할 수 없습니다

328 358 

329함께 고려할 가치가 있는 두 가지 추가 사항이 있습니다. 격리 없이 실행해야 하는 조직 승인 도구에 대해 `excludedCommands`를 추가합니다. `~/.aws` 및 `~/.ssh`와 같은 자격 증명 디렉토리에 대해 [`denyRead`](#filesystem-isolation) 항목을 추가합니다. 기본 읽기 정책은 여전히 이를 허용합니다.359함께 고려할 가치가 있는 두 가지 추가 사항이 있습니다. 격리 없이 실행해야 하는 조직 승인 도구에 대해 `excludedCommands`를 추가합니다. `~/.aws` 및 `~/.ssh`와 같은 자격 증명 디렉토리에 대해 [`sandbox.credentials`](#protect-credentials) 항목을 추가합니다. 기본 읽기 정책은 여전히 이를 허용합니다.

330 360 

331샌드박스는 기본 Windows에서 실행되지 않으므로 플릿에 Windows 호스트가 포함되면 이 구성을 macOS 및 Linux로 범위를 지정하거나 해당 사용자가 WSL2 또는 컨테이너 내에서 Claude Code를 실행하도록 합니다.361샌드박스는 기본 Windows에서 실행되지 않으므로 플릿에 Windows 호스트가 포함되면 이 구성을 macOS 및 Linux로 범위를 지정하거나 해당 사용자가 WSL2 또는 컨테이너 내에서 Claude Code를 실행하도록 합니다.

332 362 

417 447 

418* **기본 제공 파일 도구**: Read, Edit 및 Write는 샌드박스를 통해 실행되지 않고 권한 시스템을 직접 사용합니다. [권한](/ko/permissions)을 참조하세요.448* **기본 제공 파일 도구**: Read, Edit 및 Write는 샌드박스를 통해 실행되지 않고 권한 시스템을 직접 사용합니다. [권한](/ko/permissions)을 참조하세요.

419* **컴퓨터 사용**: Claude가 앱을 열고 화면을 제어할 때 격리된 환경이 아닌 실제 데스크톱에서 실행됩니다. 앱별 권한 프롬프트가 각 애플리케이션을 제어합니다. [CLI의 컴퓨터 사용](/ko/computer-use) 또는 [Desktop의 컴퓨터 사용](/ko/desktop#let-claude-use-your-computer)을 참조하세요.449* **컴퓨터 사용**: Claude가 앱을 열고 화면을 제어할 때 격리된 환경이 아닌 실제 데스크톱에서 실행됩니다. 앱별 권한 프롬프트가 각 애플리케이션을 제어합니다. [CLI의 컴퓨터 사용](/ko/computer-use) 또는 [Desktop의 컴퓨터 사용](/ko/desktop#let-claude-use-your-computer)을 참조하세요.

420* **환경 변수**: 샌드박싱된 Bash 명령은 기본적으로 부모 프로세스 환경을 상속합니다. 여기에는 설정된 모든 자격 증명이 포함됩니다. 하위 프로세스에서 Anthropic 및 클라우드 공급자 자격 증명을 제거하려면 [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/ko/env-vars)를 설정합니다.450* **환경 변수**: 샌드박싱된 Bash 명령은 기본적으로 부모 프로세스 환경을 상속합니다. 여기에는 설정된 모든 자격 증명이 포함됩니다. [`sandbox.credentials`](#protect-credentials)를 사용하여 샌드박싱된 명령에 대한 특정 변수를 설정 해제하거나 [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/ko/env-vars)를 설정하여 모든 하위 프로세스에서 Anthropic 및 클라우드 공급자 자격 증명을 제거합니다.

421* **하위 에이전트**: [하위 에이전트](/ko/sub-agents)는 부모 세션과 동일한 프로세스에서 실행되며 동일한 샌드박스 구성을 사용합니다. 부모 세션에서 샌드박싱이 활성화되면 하위 에이전트 내의 Bash 명령이 샌드박싱됩니다.451* **하위 에이전트**: [하위 에이전트](/ko/sub-agents)는 부모 세션과 동일한 프로세스에서 실행되며 동일한 샌드박스 구성을 사용합니다. 부모 세션에서 샌드박싱이 활성화되면 하위 에이전트 내의 Bash 명령이 샌드박싱됩니다.

422 452 

423<Warning>453<Warning>

6 6 

7> 기기 관리 인프라 없이 Claude.ai의 웹 기반 인터페이스를 통해 조직을 위해 Claude Code를 중앙에서 구성합니다.7> 기기 관리 인프라 없이 Claude.ai의 웹 기반 인터페이스를 통해 조직을 위해 Claude Code를 중앙에서 구성합니다.

8 8 

9서버 관리 설정을 통해 관리자는 Claude.ai의 웹 기반 인터페이스를 통해 Claude Code를 중앙에서 구성할 수 있습니다. Claude Code 클라이언트는 사용자가 조직 자격증명으로 인증할 때 이러한 설정을 자동으로 수신합니다.9서버 관리 설정을 통해 관리자는 Claude.ai의 웹 기반 인터페이스를 통해 Claude Code를 중앙에서 구성할 수 있습니다. Claude Code 클라이언트는 사용자가 조직 OAuth 로그인 또는 직접 구성된 API 키로 인증할 때 이러한 설정을 자동으로 수신하며, 서버 관리 전달이 지원되는 플랫폼에서 이를 받습니다. [플랫폼 가용성](#platform-availability)을 참조하십시오.

10 10 

11이 방식은 기기 관리 인프라가 없거나 관리되지 않는 기기의 사용자를 위해 설정을 관리해야 하는 조직을 위해 설계되었습니다.11이 방식은 기기 관리 인프라가 없거나 관리되지 않는 기기의 사용자를 위해 설정을 관리해야 하는 조직을 위해 설계되었습니다.

12 12 

35| **서버 관리 설정** | MDM이 없는 조직 또는 관리되지 않는 기기의 사용자 | 인증 시 Anthropic의 서버에서 전달되는 설정 |35| **서버 관리 설정** | MDM이 없는 조직 또는 관리되지 않는 기기의 사용자 | 인증 시 Anthropic의 서버에서 전달되는 설정 |

36| **[엔드포인트 관리 설정](/ko/settings#settings-files)** | MDM 또는 엔드포인트 관리가 있는 조직 | MDM 구성 프로필, 레지스트리 정책 또는 관리 설정 파일을 통해 기기에 배포되는 설정 |36| **[엔드포인트 관리 설정](/ko/settings#settings-files)** | MDM 또는 엔드포인트 관리가 있는 조직 | MDM 구성 프로필, 레지스트리 정책 또는 관리 설정 파일을 통해 기기에 배포되는 설정 |

37 37 

38기기가 MDM 또는 엔드포인트 관리 솔루션에 등록된 경우, 엔드포인트 관리 설정은 설정 파일을 OS 수준에서 사용자 수정으로부터 보호할 수 있으므로 더 강력한 보안 보장을 제공합니다.38기기가 MDM 또는 엔드포인트 관리 솔루션에 등록된 경우, 엔드포인트 관리 설정은 설정 파일을 OS 수준에서 사용자 수정으로부터 보호할 수 있으므로 더 강력한 보안 보장을 제공합니다. 엔드포인트 관리 설정은 [클라우드 세션](/ko/model-config#surface-coverage)에 도달하지 않으므로, 웹에서 Claude Code를 사용하는 조직은 서버 관리 설정도 함께 구성해야 합니다.

39 39 

40<h2 id="configure-server-managed-settings">40<h2 id="configure-server-managed-settings">

41 서버 관리 설정 구성41 서버 관리 설정 구성

228 플랫폼 가용성228 플랫폼 가용성

229</h2>229</h2>

230 230 

231서버 관리 설정은 `api.anthropic.com`에 대한 직접 연결이 필요하며 타사 모델 공급자를 사용할 때는 사용할 수 없습니다.231서버 관리 설정은 `api.anthropic.com`에 대한 직접 연결이 필요하며, 전달을 위해서는 세션이 조직 OAuth 로그인 또는 직접 구성된 API 키로 인증되어야 합니다. [`apiKeyHelper`](/ko/settings#available-settings) 스크립트에서 반환된 키는 설정 가져오기를 트리거하지 않습니다. 서버 관리 설정은 타사 모델 공급자를 사용할 때는 사용할 수 없습니다:

232 232 

233* Amazon Bedrock233* Amazon Bedrock

234* Google Vertex AI234* Google Vertex AI

235* Microsoft Foundry235* Microsoft Foundry

236* [Claude Platform on AWS](/ko/claude-platform-on-aws)

236* `ANTHROPIC_BASE_URL` 또는 [LLM gateways](/ko/llm-gateway)를 통한 사용자 정의 API 엔드포인트237* `ANTHROPIC_BASE_URL` 또는 [LLM gateways](/ko/llm-gateway)를 통한 사용자 정의 API 엔드포인트

237 238 

238<h2 id="audit-logging">239<h2 id="audit-logging">

250서버 관리 설정은 중앙 집중식 정책 적용을 제공하지만 클라이언트 측 제어로 작동합니다. 관리되지 않는 기기에서 관리자 또는 sudo 액세스 권한이 있는 사용자는 Claude Code 바이너리, 파일 시스템 또는 네트워크 구성을 수정할 수 있습니다.251서버 관리 설정은 중앙 집중식 정책 적용을 제공하지만 클라이언트 측 제어로 작동합니다. 관리되지 않는 기기에서 관리자 또는 sudo 액세스 권한이 있는 사용자는 Claude Code 바이너리, 파일 시스템 또는 네트워크 구성을 수정할 수 있습니다.

251 252 

252| 시나리오 | 동작 |253| 시나리오 | 동작 |

253| :-------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |254| :-------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

254| 사용자가 캐시된 설정 파일을 편집함 | 변조된 파일이 시작 시 적용되지만 다음 서버 가져오기에서 올바른 설정이 복원됩니다. |255| 사용자가 캐시된 설정 파일을 편집함 | 변조된 파일이 시작 시 적용되지만 다음 서버 가져오기에서 올바른 설정이 복원됩니다. |

255| 사용자가 캐시된 설정 파일을 삭제함 | 첫 시작 동작이 발생합니다. 설정이 비동기적으로 가져오지며 짧은 적용되지 않은 시간이 있습니다. |256| 사용자가 캐시된 설정 파일을 삭제함 | 첫 시작 동작이 발생합니다. 설정이 비동기적으로 가져오지며 짧은 적용되지 않은 시간이 있습니다. |

256| API를 사용할 수 없음 | 캐시된 설정이 있으면 적용되고, 그렇지 않으면 다음 성공적인 가져오기까지 관리 설정이 적용되지 않습니다. `forceRemoteSettingsRefresh: true`를 사용하면 CLI는 계속하는 대신 종료됩니다. [`claude auth` 부분 명령](#enforce-fail-closed-startup) 제외 |257| API를 사용할 수 없음 | 캐시된 설정이 있으면 적용되고, 그렇지 않으면 다음 성공적인 가져오기까지 관리 설정이 적용되지 않습니다. `forceRemoteSettingsRefresh: true`를 사용하면 CLI는 계속하는 대신 종료됩니다. [`claude auth` 부분 명령](#enforce-fail-closed-startup) 제외 |

257| 사용자가 다른 조직으로 인증함 | 관리 조직 외부의 계정에 대해 설정이 전달되지 않습니다. |258| 사용자가 다른 조직으로 인증함 | 관리 조직 외부의 계정에 대해 설정이 전달되지 않습니다. |

258| 사용자가 [타사 모델 공급자](#platform-availability)를 구성함 | 서버 관리 설정이 우회됩니다. 여기에는 `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_MANTLE`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY` 설정 또는 기본이 아닌 `ANTHROPIC_BASE_URL` 설정이 포함됩니다. |259| 사용자가 [타사 모델 공급자](#platform-availability)를 구성함 | 서버 관리 설정이 우회됩니다. 여기에는 `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_MANTLE`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY`, `CLAUDE_CODE_USE_ANTHROPIC_AWS` 설정 또는 기본이 아닌 `ANTHROPIC_BASE_URL` 설정이 포함됩니다. |

259 260 

260런타임 구성 변경을 감지하려면 [`ConfigChange` hooks](/ko/hooks#configchange)를 사용하여 수정 사항을 기록하거나 적용되기 전에 무단 변경을 차단합니다.261런타임 구성 변경을 감지하려면 [`ConfigChange` hooks](/ko/hooks#configchange)를 사용하여 수정 사항을 기록하거나 적용되기 전에 무단 변경을 차단합니다.

261 262 

19</h3>19</h3>

20 20 

21| 범위 | 위치 | 영향을 받는 대상 | 팀과 공유? |21| 범위 | 위치 | 영향을 받는 대상 | 팀과 공유? |

22| :---------- | :-------------------------------------------------------- | :------------ | :--------------- |22| :---------- | :-------------------------------------------------------- | :----------------------------------------------------------------------------------------- | :--------------- |

23| **Managed** | 서버 관리 설정, plist / 레지스트리 또는 시스템 수준 `managed-settings.json` | 머신의 모든 사용자 | 예 (IT에서 배포) |23| **Managed** | 서버 관리 설정, plist / 레지스트리 또는 시스템 수준 `managed-settings.json` | 서버 관리 전달을 위한 모든 조직 구성원; plist, HKLM 레지스트리 및 파일 전달을 위한 머신의 모든 사용자; HKCU 레지스트리 전달을 위한 현재 사용자 | 예 (IT에서 배포) |

24| **User** | `~/.claude/` 디렉토리 | 모든 프로젝트에서 사용자 | 아니오 |24| **User** | `~/.claude/` 디렉토리 | 모든 프로젝트에서 사용자 | 아니오 |

25| **Project** | 저장소의 `.claude/` | 이 저장소의 모든 협업자 | 예 (git에 커밋됨) |25| **Project** | 저장소의 `.claude/` | 이 저장소의 모든 협업자 | 예 (git에 커밋됨) |

26| **Local** | `.claude/settings.local.json` | 이 저장소에서만 사용자 | 아니오 (gitignored) |26| **Local** | `.claude/settings.local.json` | 이 저장소에서만 사용자 | 아니오 (gitignored) |

230| `autoMode` | [자동 모드](/ko/permission-modes#eliminate-prompts-with-auto-mode) 분류기가 차단하고 허용하는 것을 사용자 정의합니다. `environment`, `allow`, `soft_deny` 및 `hard_deny` 배열의 산문 규칙을 포함합니다. 배열에 리터럴 문자열 `"$defaults"`를 포함하여 해당 위치에서 기본 제공 규칙을 상속합니다. [자동 모드 구성](/ko/auto-mode-config)을 참조하세요. 공유 프로젝트 설정에서는 읽지 않음 | `{"soft_deny": ["$defaults", "Never run terraform apply"]}` |230| `autoMode` | [자동 모드](/ko/permission-modes#eliminate-prompts-with-auto-mode) 분류기가 차단하고 허용하는 것을 사용자 정의합니다. `environment`, `allow`, `soft_deny` 및 `hard_deny` 배열의 산문 규칙을 포함합니다. 배열에 리터럴 문자열 `"$defaults"`를 포함하여 해당 위치에서 기본 제공 규칙을 상속합니다. [자동 모드 구성](/ko/auto-mode-config)을 참조하세요. 공유 프로젝트 설정에서는 읽지 않음 | `{"soft_deny": ["$defaults", "Never run terraform apply"]}` |

231| `autoScrollEnabled` | [fullscreen 렌더링](/ko/fullscreen)에서 새 출력을 대화의 맨 아래로 따릅니다. 기본값: `true`. `/config`에 **자동 스크롤**로 표시됩니다. 이것이 꺼져 있을 때도 권한 프롬프트는 여전히 보기로 스크롤됩니다 | `false` |231| `autoScrollEnabled` | [fullscreen 렌더링](/ko/fullscreen)에서 새 출력을 대화의 맨 아래로 따릅니다. 기본값: `true`. `/config`에 **자동 스크롤**로 표시됩니다. 이것이 꺼져 있을 때도 권한 프롬프트는 여전히 보기로 스크롤됩니다 | `false` |

232| `autoUpdatesChannel` | 업데이트를 따를 릴리스 채널입니다. 일반적으로 약 1주일 된 버전이고 주요 회귀가 있는 버전을 건너뛰는 `"stable"`을 사용하거나 가장 최근 릴리스인 `"latest"` (기본값)을 사용합니다. 자동 업데이트를 완전히 비활성화하려면 `env`에서 [`DISABLE_AUTOUPDATER`](/ko/setup#disable-auto-updates)를 설정합니다 | `"stable"` |232| `autoUpdatesChannel` | 업데이트를 따를 릴리스 채널입니다. 일반적으로 약 1주일 된 버전이고 주요 회귀가 있는 버전을 건너뛰는 `"stable"`을 사용하거나 가장 최근 릴리스인 `"latest"` (기본값)을 사용합니다. 자동 업데이트를 완전히 비활성화하려면 `env`에서 [`DISABLE_AUTOUPDATER`](/ko/setup#disable-auto-updates)를 설정합니다 | `"stable"` |

233| `availableModels` | 사용자가 메인 세션, [subagents](/ko/sub-agents) 및 [advisor](/ko/advisor)를 위해 선택할 수 있는 모델을 제한합니다. [모델 선택 제한](/ko/model-config#restrict-model-selection)을 참조하세요. `enforceAvailableModels`도 기본값을 제한하려면 참조하세요 | `["sonnet", "haiku"]` |233| `availableModels` | 사용자가 메인 세션, [subagents](/ko/sub-agents), [skills](/ko/skills) 및 [advisor](/ko/advisor)를 위해 선택할 수 있는 모델을 제한합니다. `enforceAvailableModels`도 설정되지 않으면 기본 옵션에는 영향을 주지 않습니다. [모델 선택 제한](/ko/model-config#restrict-model-selection)을 참조하세요 | `["sonnet", "haiku"]` |

234| `awaySummaryEnabled` | 몇 분 동안 터미널에서 떨어져 있다가 돌아올 때 한 줄 세션 요약을 표시합니다. 비활성화하려면 `false`로 설정하거나 `/config`에서 세션 요약을 끕니다. [`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](/ko/env-vars)와 동일합니다 | `true` |234| `awaySummaryEnabled` | 몇 분 동안 터미널에서 떨어져 있다가 돌아올 때 한 줄 세션 요약을 표시합니다. 비활성화하려면 `false`로 설정하거나 `/config`에서 세션 요약을 끕니다. [`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](/ko/env-vars)와 동일합니다 | `true` |

235| `awsAuthRefresh` | `.aws` 디렉토리를 수정하는 사용자 정의 스크립트 ([고급 자격 증명 구성](/ko/amazon-bedrock#advanced-credential-configuration) 참조) | `aws sso login --profile myprofile` |235| `awsAuthRefresh` | `.aws` 디렉토리를 수정하는 사용자 정의 스크립트 ([고급 자격 증명 구성](/ko/amazon-bedrock#advanced-credential-configuration) 참조) | `aws sso login --profile myprofile` |

236| `awsCredentialExport` | AWS 자격 증명이 포함된 JSON을 출력하는 사용자 정의 스크립트 ([고급 자격 증명 구성](/ko/amazon-bedrock#advanced-credential-configuration) 참조) | `/bin/generate_aws_grant.sh` |236| `awsCredentialExport` | AWS 자격 증명이 포함된 JSON을 출력하는 사용자 정의 스크립트 ([고급 자격 증명 구성](/ko/amazon-bedrock#advanced-credential-configuration) 참조) | `/bin/generate_aws_grant.sh` |

258| `effortLevel` | [노력 수준](/ko/model-config#adjust-effort-level)을 세션 간에 유지합니다. `"low"`, `"medium"`, `"high"` 또는 `"xhigh"`를 허용합니다. `/effort`를 이러한 값 중 하나로 실행할 때 자동으로 작성됩니다. `--effort` 및 [`CLAUDE_CODE_EFFORT_LEVEL`](/ko/env-vars)은 한 세션에 대해 이를 재정의합니다. [노력 수준 조정](/ko/model-config#adjust-effort-level)에서 지원되는 모델을 참조하세요 | `"xhigh"` |258| `effortLevel` | [노력 수준](/ko/model-config#adjust-effort-level)을 세션 간에 유지합니다. `"low"`, `"medium"`, `"high"` 또는 `"xhigh"`를 허용합니다. `/effort`를 이러한 값 중 하나로 실행할 때 자동으로 작성됩니다. `--effort` 및 [`CLAUDE_CODE_EFFORT_LEVEL`](/ko/env-vars)은 한 세션에 대해 이를 재정의합니다. [노력 수준 조정](/ko/model-config#adjust-effort-level)에서 지원되는 모델을 참조하세요 | `"xhigh"` |

259| `enableAllProjectMcpServers` | 프로젝트 `.mcp.json` 파일에 정의된 모든 MCP 서버를 자동으로 승인합니다 | `true` |259| `enableAllProjectMcpServers` | 프로젝트 `.mcp.json` 파일에 정의된 모든 MCP 서버를 자동으로 승인합니다 | `true` |

260| `enabledMcpjsonServers` | `.mcp.json` 파일에서 승인할 특정 MCP 서버 목록 | `["memory", "github"]` |260| `enabledMcpjsonServers` | `.mcp.json` 파일에서 승인할 특정 MCP 서버 목록 | `["memory", "github"]` |

261| `enforceAvailableModels` | {/* min-version: 2.1.175 */}}`true`이고 `availableModels`가 managed 또는 정책 설정의 비어있지 않은 목록일 때 기본 모델도 허용 목록으로 제한됩니다. [모델 선택 제한](/ko/model-config#restrict-model-selection)을 참조하고 `availableModels`가 여러 수준에서 설정될 때 [병합 동작](/ko/model-config#merge-behavior)을 참조하세요. Claude Code v2.1.175 이상이 필요합니다 | `true` |261| `enforceAvailableModels` | {/* min-version: 2.1.175 */}}`true`이고 `availableModels`가 managed 또는 정책 설정의 비어있지 않은 목록일 때 기본 모델도 허용 목록으로 제한됩니다. 기본 옵션이 허용 목록의 첫 번째 사용 가능한 항목으로 폴백됩니다. `availableModels`가 설정되지 않거나 비어있을 때는 영향을 주지 않습니다. [모델 선택 제한](/ko/model-config#restrict-model-selection)을 참조하세요. Claude Code v2.1.175 이상이 필요합니다 | `true` |

262| `env` | 모든 세션에 적용될 환경 변수 및 Claude Code가 생성하는 하위 프로세스에 적용됩니다. {/* min-version: 2.1.143 */}v2.1.143부터 여기에 설정된 `NO_COLOR` 및 `FORCE_COLOR`는 하위 프로세스로 전달되지만 Claude Code 자체 인터페이스 색상은 변경하지 않습니다. Claude를 시작하기 전에 셸에서 이를 설정하여 인터페이스 색상을 변경합니다 | `{"FOO": "bar"}` |262| `env` | 모든 세션에 적용될 환경 변수 및 Claude Code가 생성하는 하위 프로세스에 적용됩니다. {/* min-version: 2.1.143 */}v2.1.143부터 여기에 설정된 `NO_COLOR` 및 `FORCE_COLOR`는 하위 프로세스로 전달되지만 Claude Code 자체 인터페이스 색상은 변경하지 않습니다. Claude를 시작하기 전에 셸에서 이를 설정하여 인터페이스 색상을 변경합니다 | `{"FOO": "bar"}` |

263| `fallbackModel` | 기본 모델이 과부하이거나 사용할 수 없을 때 순서대로 시도할 폴백 모델입니다. Claude Code는 턴의 나머지 부분에 대해 체인의 다음 사용 가능한 모델로 전환하고 알림을 표시합니다. `"default"`는 기본 모델로 확장됩니다. 체인은 3개 모델로 제한되며 추가 항목은 무시됩니다. 대부분의 배열 설정과 달리 이 키는 설정 파일 전체에서 병합되지 않습니다: 이를 정의하는 최고 우선순위 파일이 전체 체인을 제공합니다. [`--fallback-model`](/ko/cli-reference#cli-flags) 플래그는 한 세션에 대해 이를 재정의합니다. [폴백 모델 체인](/ko/model-config#fallback-model-chains)을 참조하세요 | `["claude-sonnet-4-6", "claude-haiku-4-5"]` |263| `fallbackModel` | 기본 모델이 과부하이거나 사용할 수 없을 때 순서대로 시도할 폴백 모델입니다. Claude Code는 턴의 나머지 부분에 대해 체인의 다음 사용 가능한 모델로 전환하고 알림을 표시합니다. `"default"`는 기본 모델로 확장됩니다. 체인은 3개 모델로 제한되며 추가 항목은 무시됩니다. 대부분의 배열 설정과 달리 이 키는 설정 파일 전체에서 병합되지 않습니다: 이를 정의하는 최고 우선순위 파일이 전체 체인을 제공합니다. [`--fallback-model`](/ko/cli-reference#cli-flags) 플래그는 한 세션에 대해 이를 재정의합니다. [폴백 모델 체인](/ko/model-config#fallback-model-chains)을 참조하세요 | `["claude-sonnet-4-6", "claude-haiku-4-5"]` |

264| `fastModePerSessionOptIn` | `true`일 때 빠른 모드는 세션 간에 지속되지 않습니다. 각 세션은 빠른 모드가 꺼진 상태로 시작되며 사용자가 `/fast`로 활성화해야 합니다. 사용자의 빠른 모드 설정은 여전히 저장됩니다. [세션별 옵트인 필요](/ko/fast-mode#require-per-session-opt-in)를 참조하세요 | `true` |264| `fastModePerSessionOptIn` | `true`일 때 빠른 모드는 세션 간에 지속되지 않습니다. 각 세션은 빠른 모드가 꺼진 상태로 시작되며 사용자가 `/fast`로 활성화해야 합니다. 사용자의 빠른 모드 설정은 여전히 저장됩니다. [세션별 옵트인 필요](/ko/fast-mode#require-per-session-opt-in)를 참조하세요 | `true` |

394고급 샌드박싱 동작을 구성합니다. 샌드박싱은 bash 명령을 파일 시스템 및 네트워크에서 격리합니다. 자세한 내용은 [Sandboxing](/ko/sandboxing)을 참조하세요.394고급 샌드박싱 동작을 구성합니다. 샌드박싱은 bash 명령을 파일 시스템 및 네트워크에서 격리합니다. 자세한 내용은 [Sandboxing](/ko/sandboxing)을 참조하세요.

395 395 

396| 키 | 설명 | 예제 |396| 키 | 설명 | 예제 |

397| :------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------- |397| :------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |

398| `enabled` | bash 샌드박싱 활성화 (macOS, Linux 및 WSL2). 기본값: false | `true` |398| `enabled` | bash 샌드박싱 활성화 (macOS, Linux 및 WSL2). 기본값: false | `true` |

399| `failIfUnavailable` | `sandbox.enabled`가 true이지만 샌드박스를 시작할 수 없는 경우 (종속성 누락, 지원되지 않는 플랫폼) 시작 시 오류로 종료합니다. false (기본값)일 때 경고가 표시되고 명령이 샌드박싱되지 않은 상태로 실행됩니다. Managed 설정 배포에서 샌드박싱을 하드 게이트로 요구하는 경우를 위한 것입니다 | `true` |399| `failIfUnavailable` | `sandbox.enabled`가 true이지만 샌드박스를 시작할 수 없는 경우 (종속성 누락, 지원되지 않는 플랫폼) 시작 시 오류로 종료합니다. false (기본값)일 때 경고가 표시되고 명령이 샌드박싱되지 않은 상태로 실행됩니다. Managed 설정 배포에서 샌드박싱을 하드 게이트로 요구하는 경우를 위한 것입니다 | `true` |

400| `autoAllowBashIfSandboxed` | 샌드박싱되면 bash 명령 자동 승인. 기본값: true | `true` |400| `autoAllowBashIfSandboxed` | 샌드박싱되면 bash 명령 자동 승인. 기본값: true | `true` |

405| `filesystem.denyRead` | 샌드박싱된 명령이 읽을 수 없는 경로입니다. 배열은 모든 설정 범위에서 병합됩니다. `Read(...)` 거부 권한 규칙의 경로와도 병합됩니다. | `["~/.aws/credentials"]` |405| `filesystem.denyRead` | 샌드박싱된 명령이 읽을 수 없는 경로입니다. 배열은 모든 설정 범위에서 병합됩니다. `Read(...)` 거부 권한 규칙의 경로와도 병합됩니다. | `["~/.aws/credentials"]` |

406| `filesystem.allowRead` | `denyRead` 영역 내에서 읽기를 다시 허용할 경로입니다. `denyRead`보다 우선합니다. 배열은 모든 설정 범위에서 병합됩니다. 이를 사용하여 작업 공간 전용 읽기 액세스 패턴을 만듭니다. | `["."]` |406| `filesystem.allowRead` | `denyRead` 영역 내에서 읽기를 다시 허용할 경로입니다. `denyRead`보다 우선합니다. 배열은 모든 설정 범위에서 병합됩니다. 이를 사용하여 작업 공간 전용 읽기 액세스 패턴을 만듭니다. | `["."]` |

407| `filesystem.allowManagedReadPathsOnly` | (Managed 설정만) Managed 설정의 `filesystem.allowRead` 경로만 존중됩니다. `denyRead`는 여전히 모든 소스에서 병합됩니다. 기본값: false | `true` |407| `filesystem.allowManagedReadPathsOnly` | (Managed 설정만) Managed 설정의 `filesystem.allowRead` 경로만 존중됩니다. `denyRead`는 여전히 모든 소스에서 병합됩니다. 기본값: false | `true` |

408| `credentials.files` | 샌드박싱된 명령이 읽을 수 없는 자격 증명 파일 또는 디렉토리입니다. `filesystem.denyRead`와 동일한 읽기 블록을 적용합니다. 별도의 키는 자격 증명 경로를 `credentials.envVars`와 함께 그룹화하고 일반 파일 시스템 규칙과 분리합니다. 각 항목은 `{ "path": "...", "mode": "deny" }`입니다. 경로는 `filesystem.*` 설정과 동일한 [접두사](#sandbox-path-prefixes)를 사용합니다. 배열은 모든 설정 범위에서 병합됩니다. `deny`만 지원됩니다. Claude Code v2.1.187 이상이 필요합니다. | `[{ "path": "~/.aws/credentials", "mode": "deny" }]` |

409| `credentials.envVars` | 샌드박싱된 명령을 실행하기 전에 설정 해제할 환경 변수입니다. 각 항목은 `{ "name": "...", "mode": "deny" }`입니다. 배열은 모든 설정 범위에서 병합됩니다. `deny`만 지원됩니다. Claude Code v2.1.187 이상이 필요합니다. | `[{ "name": "GITHUB_TOKEN", "mode": "deny" }]` |

408| `network.allowUnixSockets` | (macOS만) Unix 소켓 경로 샌드박스에서 액세스 가능. Linux 및 WSL2에서는 무시되며, seccomp 필터가 소켓 경로를 검사할 수 없습니다. 대신 `allowAllUnixSockets`를 사용합니다. | `["~/.ssh/agent-socket"]` |410| `network.allowUnixSockets` | (macOS만) Unix 소켓 경로 샌드박스에서 액세스 가능. Linux 및 WSL2에서는 무시되며, seccomp 필터가 소켓 경로를 검사할 수 없습니다. 대신 `allowAllUnixSockets`를 사용합니다. | `["~/.ssh/agent-socket"]` |

409| `network.allowAllUnixSockets` | 샌드박스에서 모든 Unix 소켓 연결을 허용합니다. Linux 및 WSL2에서 이는 `socket(AF_UNIX, ...)` 호출을 차단하는 seccomp 필터를 건너뛰므로 Unix 소켓을 허용하는 유일한 방법입니다. 기본값: false | `true` |411| `network.allowAllUnixSockets` | 샌드박스에서 모든 Unix 소켓 연결을 허용합니다. Linux 및 WSL2에서 이는 `socket(AF_UNIX, ...)` 호출을 차단하는 seccomp 필터를 건너뛰므로 Unix 소켓을 허용하는 유일한 방법입니다. 기본값: false | `true` |

410| `network.allowLocalBinding` | localhost 포트에 바인딩 허용 (macOS만). 기본값: false | `true` |412| `network.allowLocalBinding` | localhost 포트에 바인딩 허용 (macOS만). 기본값: false | `true` |

424 Sandbox 경로 접두사426 Sandbox 경로 접두사

425</h4>427</h4>

426 428 

427`filesystem.allowWrite`, `filesystem.denyWrite`, `filesystem.denyRead` 및 `filesystem.allowRead`의 경로는 다음 접두사를 지원합니다:429`filesystem.allowWrite`, `filesystem.denyWrite`, `filesystem.denyRead`, `filesystem.allowRead` 및 `credentials.files`의 경로는 다음 접두사를 지원합니다:

428 430 

429| 접두사 | 의미 | 예제 |431| 접두사 | 의미 | 예제 |

430| :------------- | :------------------------------------------------------ | :------------------------------------------------------------------ |432| :------------- | :------------------------------------------------------ | :------------------------------------------------------------------ |

674예를 들어 사용자 설정이 `permissions.defaultMode`를 `acceptEdits`로 설정하지만 프로젝트의 공유 설정이 이를 `default`로 설정하면 프로젝트 값이 적용됩니다. 아래 예제는 배열 값 설정 (예: 권한 규칙)이 대신 어떻게 결합되는지를 다룹니다.676예를 들어 사용자 설정이 `permissions.defaultMode`를 `acceptEdits`로 설정하지만 프로젝트의 공유 설정이 이를 `default`로 설정하면 프로젝트 값이 적용됩니다. 아래 예제는 배열 값 설정 (예: 권한 규칙)이 대신 어떻게 결합되는지를 다룹니다.

675 677 

676<Note>678<Note>

677 **배열 설정은 범위 전체에서 병합됩니다.** 동일한 배열 값 설정 (예: `sandbox.filesystem.allowWrite` 또는 `permissions.allow`)이 여러 범위에 나타나면 배열은 **연결되고 중복 제거되며** 대체되지 않습니다. 이는 낮은 우선순위 범위가 높은 우선순위 범위에서 설정한 항목을 재정의하지 않고 항목을 추가할 수 있음을 의미하며 그 반대도 마찬가지입니다. 예를 들어 managed 설정이 `allowWrite`를 `["/opt/company-tools"]`로 설정하고 사용자가 `["~/.kube"]`를 추가하면 두 경로 모두 최종 구성에 포함됩니다. 유일한 예외는 [`fallbackModel`](#available-settings)로, 위치가 의미를 가지는 순서가 지정된 체인입니다: 이를 정의하는 최고 우선순위 파일이 전체 값을 제공합니다. 또 다른 예외는 {/* min-version: 2.1.175 */}v2.1.175부터 [`availableModels`](#available-settings)로, managed 또는 정책 값이 낮은 우선순위 항목을 완전히 대체합니다. [병합 동작](/ko/model-config#merge-behavior)을 참조하세요.679 **배열 설정은 범위 전체에서 병합됩니다.** 동일한 배열 값 설정 (예: `sandbox.filesystem.allowWrite` 또는 `permissions.allow`)이 여러 범위에 나타나면 배열은 **연결되고 중복 제거되며** 대체되지 않습니다. 이는 낮은 우선순위 범위가 높은 우선순위 범위에서 설정한 항목을 재정의하지 않고 항목을 추가할 수 있음을 의미하며 그 반대도 마찬가지입니다. 예를 들어 managed 설정이 `allowWrite`를 `["/opt/company-tools"]`로 설정하고 사용자가 `["~/.kube"]`를 추가하면 두 경로 모두 최종 구성에 포함됩니다. 두 가지 예외가 있습니다: [`fallbackModel`](#available-settings)은 위치가 의미를 가지는 순서가 지정된 체인입니다: 이를 정의하는 최고 우선순위 파일이 전체 값을 제공합니다. [`availableModels`](#available-settings): {/* min-version: 2.1.175 */}[최고 우선순위 managed 소스](/ko/server-managed-settings#settings-precedence)가 이를 정의할 때 해당 목록이 그대로 적용되고 사용자, 프로젝트 및 local 항목은 이를 확장할 수 없습니다. 비 managed 범위 전체에서 배열은 평소대로 병합됩니다. [병합 동작](/ko/model-config#merge-behavior)을 참조하세요.

678</Note>680</Note>

679 681 

680<h3 id="verify-active-settings">682<h3 id="verify-active-settings">

245모든 필드는 선택적입니다. Claude가 skill을 언제 사용할지 알 수 있도록 `description`만 권장됩니다.245모든 필드는 선택적입니다. Claude가 skill을 언제 사용할지 알 수 있도록 `description`만 권장됩니다.

246 246 

247| 필드 | 필수 | 설명 |247| 필드 | 필수 | 설명 |

248| :------------------------- | :-- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |248| :------------------------- | :-- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

249| `name` | 아니오 | skill 목록에 표시되는 표시 이름입니다. 디렉토리 이름으로 기본값이 설정됩니다. skill을 호출하기 위해 입력하는 이름과 어떻게 다른지는 [skill이 명령어 이름을 얻는 방법](#how-a-skill-gets-its-command-name)을 참조하세요. |249| `name` | 아니오 | skill 목록에 표시되는 표시 이름입니다. 디렉토리 이름으로 기본값이 설정됩니다. skill을 호출하기 위해 입력하는 이름과 어떻게 다른지는 [skill이 명령어 이름을 얻는 방법](#how-a-skill-gets-its-command-name)을 참조하세요. |

250| `description` | 권장 | skill이 무엇을 하는지, 언제 사용할지. Claude는 이를 사용하여 skill을 자동으로 적용할 시기를 결정합니다. 생략하면 markdown 콘텐츠의 첫 번째 단락을 사용합니다. 주요 사용 사례를 앞에 배치합니다: 결합된 `description` 및 `when_to_use` 텍스트는 컨텍스트 사용을 줄이기 위해 skill 목록에서 1,536자로 잘립니다. |250| `description` | 권장 | skill이 무엇을 하는지, 언제 사용할지. Claude는 이를 사용하여 skill을 자동으로 적용할 시기를 결정합니다. 생략하면 markdown 콘텐츠의 첫 번째 단락을 사용합니다. 주요 사용 사례를 앞에 배치합니다: 결합된 `description` 및 `when_to_use` 텍스트는 컨텍스트 사용을 줄이기 위해 skill 목록에서 1,536자로 잘립니다. |

251| `when_to_use` | 아니오 | Claude가 skill을 호출해야 할 때에 대한 추가 컨텍스트(예: 트리거 구문 또는 예제 요청). skill 목록에서 `description`에 추가되며 1,536자 제한에 포함됩니다. |251| `when_to_use` | 아니오 | Claude가 skill을 호출해야 할 때에 대한 추가 컨텍스트(예: 트리거 구문 또는 예제 요청). skill 목록에서 `description`에 추가되며 1,536자 제한에 포함됩니다. |

255| `user-invocable` | 아니오 | `/` 메뉴에서 숨기려면 `false`로 설정합니다. 사용자가 직접 호출하지 않아야 하는 배경 지식에 사용합니다. 기본값: `true`. |255| `user-invocable` | 아니오 | `/` 메뉴에서 숨기려면 `false`로 설정합니다. 사용자가 직접 호출하지 않아야 하는 배경 지식에 사용합니다. 기본값: `true`. |

256| `allowed-tools` | 아니오 | 이 skill이 활성화되었을 때 Claude가 권한을 요청하지 않고 사용할 수 있는 도구. 공백 또는 쉼표로 구분된 문자열 또는 YAML 목록을 허용합니다. |256| `allowed-tools` | 아니오 | 이 skill이 활성화되었을 때 Claude가 권한을 요청하지 않고 사용할 수 있는 도구. 공백 또는 쉼표로 구분된 문자열 또는 YAML 목록을 허용합니다. |

257| `disallowed-tools` | 아니오 | 이 skill이 활성화되었을 때 Claude의 사용 가능한 도구 풀에서 제거되는 도구. `AskUserQuestion`과 같이 배경 루프에 대해 특정 도구를 호출하지 않아야 하는 자율 skills에 사용합니다. 공백 또는 쉼표로 구분된 문자열 또는 YAML 목록을 허용합니다. 다음 메시지를 보낼 때 제한이 해제됩니다. |257| `disallowed-tools` | 아니오 | 이 skill이 활성화되었을 때 Claude의 사용 가능한 도구 풀에서 제거되는 도구. `AskUserQuestion`과 같이 배경 루프에 대해 특정 도구를 호출하지 않아야 하는 자율 skills에 사용합니다. 공백 또는 쉼표로 구분된 문자열 또는 YAML 목록을 허용합니다. 다음 메시지를 보낼 때 제한이 해제됩니다. |

258| `model` | 아니오 | 이 skill이 활성화되었을 때 사용할 모델. 재정의는 현재 턴의 나머지 부분에 적용되며 설정에 저장되지 않습니다. 다음 프롬프트에서 세션 모델이 재개됩니다. [`/model`](/ko/model-config)과 동일한 값을 허용하거나 활성 모델을 유지하려면 `inherit`을 허용합니다. |258| `model` | 아니오 | 이 skill이 활성화되었을 때 사용할 모델. 재정의는 현재 턴의 나머지 부분에 적용되며 설정에 저장되지 않습니다. 다음 프롬프트에서 세션 모델이 재개됩니다. [`/model`](/ko/model-config)과 동일한 값을 허용하거나 활성 모델을 유지하려면 `inherit`을 허용합니다. 조직의 [`availableModels`](/ko/model-config#restrict-model-selection) 허용 목록에서 제외된 값은 사용되지 않으며 세션은 현재 모델을 유지합니다. |

259| `effort` | 아니오 | [노력 수준](/ko/model-config#adjust-effort-level) - 이 skill이 활성화되었을 때. 세션 노력 수준을 재정의합니다. 기본값: 세션에서 상속. 옵션: `low`, `medium`, `high`, `xhigh`, `max`; 사용 가능한 수준은 모델에 따라 다릅니다. |259| `effort` | 아니오 | [노력 수준](/ko/model-config#adjust-effort-level) - 이 skill이 활성화되었을 때. 세션 노력 수준을 재정의합니다. 기본값: 세션에서 상속. 옵션: `low`, `medium`, `high`, `xhigh`, `max`; 사용 가능한 수준은 모델에 따라 다릅니다. |

260| `context` | 아니오 | forked subagent 컨텍스트에서 실행하려면 `fork`로 설정합니다. |260| `context` | 아니오 | forked subagent 컨텍스트에서 실행하려면 `fork`로 설정합니다. |

261| `agent` | 아니오 | `context: fork`가 설정되었을 때 사용할 subagent 유형. |261| `agent` | 아니오 | `context: fork`가 설정되었을 때 사용할 subagent 유형. |

3173. Subagent 정의의 `model` frontmatter3173. Subagent 정의의 `model` frontmatter

3184. 주 대화의 모델3184. 주 대화의 모델

319 319 

320환경 변수, 호출별 매개변수, frontmatter 값은 조직의 [`availableModels`](/ko/model-config#restrict-model-selection) 허용 목록에 대해 확인됩니다. 제외된 모델로 해결되는 값은 사용되지 않으며 subagent는 상속된 모델에서 대신 실행됩니다.

321 

320<h3 id="control-subagent-capabilities">322<h3 id="control-subagent-capabilities">

321 Subagent 기능 제어323 Subagent 기능 제어

322</h3>324</h3>

849 851 

850깊이는 각 수준이 [foreground 또는 background](#run-subagents-in-foreground-or-background)에서 실행되는지 여부와 관계없이 주 대화 아래의 subagent 수준 수로 계산됩니다. 깊이 5의 subagent는 Agent 도구를 받지 않으며 추가로 생성할 수 없습니다. 제한은 고정되어 있으며 구성할 수 없습니다.852깊이는 각 수준이 [foreground 또는 background](#run-subagents-in-foreground-or-background)에서 실행되는지 여부와 관계없이 주 대화 아래의 subagent 수준 수로 계산됩니다. 깊이 5의 subagent는 Agent 도구를 받지 않으며 추가로 생성할 수 없습니다. 제한은 고정되어 있으며 구성할 수 없습니다.

851 853 

854Claude Code v2.1.187부터 background subagent의 깊이는 처음 생성될 때 고정되며, [재개](#resume-subagents)해도 해당 깊이가 변경되지 않습니다. 예를 들어 주 대화가 subagent A를 생성하고 A가 깊이 2에서 background subagent B를 생성하면 주 대화에서 직접 재개할 때 B는 여전히 깊이 2입니다. Subagent를 더 얕은 컨텍스트에서 재개해도 깊이 제한이 이미 방지한 추가 수준을 생성할 수 없습니다.

855 

852특정 subagent가 다른 subagent를 생성하지 못하도록 하려면 [`tools`](#available-tools) 목록에서 `Agent`를 생략하거나 `disallowedTools`에 추가합니다.856특정 subagent가 다른 subagent를 생성하지 못하도록 하려면 [`tools`](#available-tools) 목록에서 `Agent`를 생략하거나 `disallowedTools`에 추가합니다.

853 857 

854[fork](#fork-the-current-conversation)는 여전히 다른 fork를 생성할 수 없습니다. 다른 subagent 유형을 생성할 수 있으며 깊이 제한에 포함됩니다.858[fork](#fork-the-current-conversation)는 여전히 다른 fork를 생성할 수 없습니다. 다른 subagent 유형을 생성할 수 있으며 깊이 제한에 포함됩니다.

34 34 

35```35```

36/voice36/voice

37Voice mode enabled (hold). Hold Space to record. Dictation language: en (/config to change).37Voice mode enabled (hold). Hold space to record. Dictation language: en (/config to change).

38```38```

39 39 

40`/voice`는 선택적 모드 인수를 허용합니다:40`/voice`는 선택적 모드 인수를 허용합니다:

57}57}

58```58```

59 59 

60음성 받아쓰기가 활성화되어 있는 동안 입력 바닥글은 프롬프트가 비어 있을 때 `hold Space to speak` 힌트를 표시합니다. 힌트는 현재 `voice:pushToTalk` 바인딩을 반영하며, [받아쓰기 키를 다시 바인딩](#rebind-the-dictation-key)하면 업데이트됩니다. 힌트 텍스트는 두 모드 모두에서 동일하며, [사용자 정의 상태 줄](/ko/statusline)이 구성된 경우 나타나지 않습니다.60음성 받아쓰기가 활성화되어 있는 동안 입력 바닥글은 프롬프트가 비어 있을 때 `hold space to speak` 힌트를 표시합니다. 힌트는 현재 `voice:pushToTalk` 바인딩을 반영하며, [받아쓰기 키를 다시 바인딩](#rebind-the-dictation-key)하면 업데이트됩니다. 힌트 텍스트는 두 모드 모두에서 동일하며, [사용자 정의 상태 줄](/ko/statusline)이 구성된 경우 나타나지 않습니다.

61 61 

62전사는 두 모드 모두에서 코딩 어휘에 맞게 조정됩니다. `regex`, `OAuth`, `JSON` 및 `localhost`와 같은 일반적인 개발 용어가 올바르게 인식되며, 현재 프로젝트 이름과 git 분기 이름이 자동으로 인식 힌트로 추가됩니다.62전사는 두 모드 모두에서 코딩 어휘에 맞게 조정됩니다. `regex`, `OAuth`, `JSON` 및 `localhost`와 같은 일반적인 개발 용어가 올바르게 인식되며, 현재 프로젝트 이름과 git 분기 이름이 자동으로 인식 힌트로 추가됩니다.

63 63