620| [`autoScrollEnabled`](#autoscrollenabled) | 전체 화면 렌더링에서 [새 출력을 아래로 따라가기](/docs/ko/fullscreen#auto-follow) | 인터페이스 및 터미널 | 모든 파일 |620| [`autoScrollEnabled`](#autoscrollenabled) | 전체 화면 렌더링에서 [새 출력을 아래로 따라가기](/docs/ko/fullscreen#auto-follow) | 인터페이스 및 터미널 | 모든 파일 |
621| [`autoUpdatesChannel`](#autoupdateschannel) | 최신 대신 안정적인 [릴리스 채널](/docs/ko/setup#configure-release-channel) 따르기 | 업데이트 및 버전 관리 | 모든 파일 |621| [`autoUpdatesChannel`](#autoupdateschannel) | 최신 대신 안정적인 [릴리스 채널](/docs/ko/setup#configure-release-channel) 따르기 | 업데이트 및 버전 관리 | 모든 파일 |
622| [`availableModels`](#availablemodels) | [사람들이 선택할 수 있는 모델 제한](/docs/ko/model-config#restrict-model-selection) | 모델 및 응답 | 모든 파일 |622| [`availableModels`](#availablemodels) | [사람들이 선택할 수 있는 모델 제한](/docs/ko/model-config#restrict-model-selection) | 모델 및 응답 | 모든 파일 |
623| [`availableModelsMatch`](#availablemodelsmatch) | 각 `availableModels` 모델 ID 항목이 [이름을 지정하는 버전만 허용](/docs/ko/model-config#block-specific-models-or-versions)하도록 만들기 | 모델 및 응답 | 관리됨 |
623| [`awaySummaryEnabled`](#awaysummaryenabled) | 터미널로 돌아올 때 표시되는 [세션 요약](/docs/ko/interactive-mode#session-recap) 끄기 | 원격, 데스크톱, 알림 | 모든 파일 |624| [`awaySummaryEnabled`](#awaysummaryenabled) | 터미널로 돌아올 때 표시되는 [세션 요약](/docs/ko/interactive-mode#session-recap) 끄기 | 원격, 데스크톱, 알림 | 모든 파일 |
624| [`awsAuthRefresh`](#awsauthrefresh) | 자신의 명령으로 `.aws`에서 만료된 [Bedrock 자격증명](/docs/ko/amazon-bedrock#advanced-credential-configuration) 새로 고침 | 인증 및 공급자 | 모든 파일 |625| [`awsAuthRefresh`](#awsauthrefresh) | 자신의 명령으로 `.aws`에서 만료된 [Bedrock 자격증명](/docs/ko/amazon-bedrock#advanced-credential-configuration) 새로 고침 | 인증 및 공급자 | 모든 파일 |
625| [`awsCredentialExport`](#awscredentialexport) | 자신의 명령에서 JSON으로 [Bedrock 자격증명](/docs/ko/amazon-bedrock#advanced-credential-configuration) 제공 | 인증 및 공급자 | 모든 파일 |626| [`awsCredentialExport`](#awscredentialexport) | 자신의 명령에서 JSON으로 [Bedrock 자격증명](/docs/ko/amazon-bedrock#advanced-credential-configuration) 제공 | 인증 및 공급자 | 모든 파일 |
626| [`axScreenReader`](#axscreenreader) | [화면 판독기 친화적 출력](/docs/ko/accessibility) 렌더링 | 인터페이스 및 터미널 | 모든 파일 |627| [`axScreenReader`](#axscreenreader) | [화면 판독기 친화적 출력](/docs/ko/accessibility) 렌더링 | 인터페이스 및 터미널 | 모든 파일 |
627| [`bashEditDiffEnabled`](#basheditdiffenabled) | [Bash 명령이 변경한 파일](/docs/ko/hooks#bash)을 모든 권한 모드에서 기록 | 인터페이스 및 터미널 | 사용자 또는 관리됨 |628| [`bashEditDiffEnabled`](#basheditdiffenabled) | [Bash 명령이 변경한 파일](/docs/ko/hooks#bash)을 모든 권한 모드에서 기록 | 인터페이스 및 터미널 | 사용자 또는 관리됨 |
628| [`bashOutputMaxChars`](#bashoutputmaxchars) | 성공한 명령의 [출력](/docs/ko/tools-reference#output-limits) 중 Claude가 인라인으로 받는 양 설정 | 메모리 및 컨텍스트 | 모든 파일 |629| [`bashOutputMaxChars`](#bashoutputmaxchars) | 성공한 명령의 [출력](/docs/ko/tools-reference#output-limits) 중 Claude가 인라인으로 받는 양 설정 | 메모리 및 컨텍스트 | 모든 파일 |
629| [`blockedMarketplaces`](#blockedmarketplaces) | 조직의 [플러그인 마켓플레이스](/docs/ko/plugin-marketplaces) 소스 차단 | 플러그인 및 기술 | 관리됨 |630| [`blockedMarketplaces`](#blockedmarketplaces) | 조직의 [플러그인 마켓플레이스](/docs/ko/plugins/overview) 소스 차단 | 플러그인 및 기술 | 관리됨 |
630| [`browserExternalPageTools`](#browserexternalpagetools) | [데스크톱](/docs/ko/desktop) 브라우저 창의 외부 페이지에서 Claude의 도구 끄기 | 도구 | 관리됨 |631| [`browserExternalPageTools`](#browserexternalpagetools) | [데스크톱](/docs/ko/desktop) 브라우저 창의 외부 페이지에서 Claude의 도구 끄기 | 도구 | 관리됨 |
631| [`channelsEnabled`](#channelsenabled) | 조직의 [채널](/docs/ko/channels#enable-channels-for-your-organization) 허용 | 플러그인 및 기술 | 관리됨 |632| [`channelsEnabled`](#channelsenabled) | 조직의 [채널](/docs/ko/channels#enable-channels-for-your-organization) 허용 | 플러그인 및 기술 | 관리됨 |
633| [`claudeInChromeDefaultEnabled`](#claudeinchromedefaultenabled) | `--chrome`을 전달하지 않고 모든 대화형 CLI 세션에서 [Chrome 통합](/docs/ko/chrome) 켜기 | 전역 설정 | 전역 설정 |
632| [`claudeMd`](#claudemd) | 관리되는 설정에서 조직 전체 [CLAUDE.md](/docs/ko/memory#deploy-organization-wide-claude-md) 지침 주입 | 메모리 및 컨텍스트 | 관리됨 |634| [`claudeMd`](#claudemd) | 관리되는 설정에서 조직 전체 [CLAUDE.md](/docs/ko/memory#deploy-organization-wide-claude-md) 지침 주입 | 메모리 및 컨텍스트 | 관리됨 |
633| [`claudeMdExcludes`](#claudemdexcludes) | 메모리가 로드될 때 특정 [CLAUDE.md](/docs/ko/memory#exclude-specific-claude-md-files) 파일 건너뛰기 | 메모리 및 컨텍스트 | 모든 파일 |635| [`claudeMdExcludes`](#claudemdexcludes) | 메모리가 로드될 때 특정 [CLAUDE.md](/docs/ko/memory#exclude-specific-claude-md-files) 파일 건너뛰기 | 메모리 및 컨텍스트 | 모든 파일 |
634| [`cleanupPeriodDays`](#cleanupperioddays) | Claude Code가 [트랜스크립트](/docs/ko/data-usage#data-retention)를 삭제하기 전에 유지하는 일 수 선택 | 개인정보 보호 및 원격 측정 | 모든 파일 |636| [`cleanupPeriodDays`](#cleanupperioddays) | Claude Code가 [트랜스크립트](/docs/ko/data-usage#data-retention)를 삭제하기 전에 유지하는 일 수 선택 | 개인정보 보호 및 원격 측정 | 모든 파일 |
635| [`companyAnnouncements`](#companyannouncements) | 시작 시 조직의 공지사항 표시 | 인터페이스 및 터미널 | 모든 파일 |637| [`companyAnnouncements`](#companyannouncements) | 시작 시 조직의 공지사항 표시 | 인터페이스 및 터미널 | 모든 파일 |
638| [`copyFullResponse`](#copyfullresponse) | [`/copy`](/docs/ko/commands)가 코드 블록 선택기를 표시하지 않고 전체 응답을 복사하도록 만들기 | 전역 설정 | 전역 설정 |
636| [`copyOnSelect`](#copyonselect) | [전체 화면 렌더링](/docs/ko/fullscreen#use-the-mouse) 및 에이전트 보기에서 마우스로 선택한 텍스트의 자동 복사 끄기 | 전역 설정 | 전역 설정 |639| [`copyOnSelect`](#copyonselect) | [전체 화면 렌더링](/docs/ko/fullscreen#use-the-mouse) 및 에이전트 보기에서 마우스로 선택한 텍스트의 자동 복사 끄기 | 전역 설정 | 전역 설정 |
637| [`crossSessionInbound`](#crosssessioninbound) | Claude Code가 [다른 세션의 메시지](/docs/ko/cross-session-messaging#control-inbound-messages)를 전달하는지, 전달하지 않고 공지를 표시하는지, 거부하는지 선택 | 에이전트, 세션, 워크트리 | 모든 파일 |640| [`crossSessionInbound`](#crosssessioninbound) | Claude Code가 [다른 세션의 메시지](/docs/ko/cross-session-messaging#control-inbound-messages)를 전달하는지, 전달하지 않고 공지를 표시하는지, 거부하는지 선택 | 에이전트, 세션, 워크트리 | 모든 파일 |
638| [`defaultShell`](#defaultshell) | [`!` 접두사](/docs/ko/interactive-mode#shell-mode-with-prefix)로 입력한 셸 명령을 Bash 또는 PowerShell 중 어느 것이 실행할지 선택 | 인터페이스 및 터미널 | 모든 파일 |641| [`defaultShell`](#defaultshell) | [`!` 접두사](/docs/ko/interactive-mode#shell-mode-with-prefix)로 입력한 셸 명령을 Bash 또는 PowerShell 중 어느 것이 실행할지 선택 | 인터페이스 및 터미널 | 모든 파일 |
642| [`defaultToAgentsView`](#defaulttoagentsview) | 인수 없이 `claude`를 실행할 때 새 대화 대신 [에이전트 보기](/docs/ko/agent-view) 열기 | 전역 설정 | 전역 설정 |
639| [`deniedMcpServers`](#deniedmcpservers) | URL, 명령 또는 이름으로 특정 [MCP 서버](/docs/ko/mcp) 차단 | MCP | 모든 파일 |643| [`deniedMcpServers`](#deniedmcpservers) | URL, 명령 또는 이름으로 특정 [MCP 서버](/docs/ko/mcp) 차단 | MCP | 모든 파일 |
644| [`deniedModels`](#deniedmodels) | [특정 모델 차단](/docs/ko/model-config#block-specific-models-or-versions), `availableModels`가 허용하는 것도 포함 | 모델 및 응답 | 관리됨 |
640| [`desktopSessionCleanupPeriodDays`](#desktopsessioncleanupperioddays) | [Claude Desktop 및 Cowork 트랜스크립트](/docs/ko/claude-directory#cleaned-up-automatically)의 나이 제한을 일 단위로 설정 | 개인정보 보호 및 원격 측정 | 사용자 또는 관리됨 |645| [`desktopSessionCleanupPeriodDays`](#desktopsessioncleanupperioddays) | [Claude Desktop 및 Cowork 트랜스크립트](/docs/ko/claude-directory#cleaned-up-automatically)의 나이 제한을 일 단위로 설정 | 개인정보 보호 및 원격 측정 | 사용자 또는 관리됨 |
641| [`dialogExpiry`](#dialogexpiry) | Claude Code가 [Remote Control](/docs/ko/remote-control) 또는 SDK 호스트의 전달된 대화에 답하기를 기다리는 시간 설정 | 인터페이스 및 터미널 | 사용자 또는 관리됨 |646| [`dialogExpiry`](#dialogexpiry) | Claude Code가 [Remote Control](/docs/ko/remote-control) 또는 SDK 호스트의 전달된 대화에 답하기를 기다리는 시간 설정 | 인터페이스 및 터미널 | 사용자 또는 관리됨 |
642| [`diffTool`](#difftool) | Claude의 제안된 파일 변경이 [VS Code](/docs/ko/vs-code) 또는 [JetBrains](/docs/ko/jetbrains#features) diff 뷰어에서 열리는지 또는 터미널에 남아있는지 선택 | 전역 설정 | 전역 설정 |647| [`diffTool`](#difftool) | Claude의 제안된 파일 변경이 [VS Code](/docs/ko/vs-code) 또는 [JetBrains](/docs/ko/jetbrains#features) diff 뷰어에서 열리는지 또는 터미널에 남아있는지 선택 | 전역 설정 | 전역 설정 |
647| [`disableBrowserExternalNavigation`](#disablebrowserexternalnavigation) | [데스크톱](/docs/ko/desktop) 브라우저 창을 사람 및 Claude의 localhost로 제한 | 도구 | 관리됨 |652| [`disableBrowserExternalNavigation`](#disablebrowserexternalnavigation) | [데스크톱](/docs/ko/desktop) 브라우저 창을 사람 및 Claude의 localhost로 제한 | 도구 | 관리됨 |
648| [`disableBundledSkills`](#disablebundledskills) | Claude Code에 포함된 [기술](/docs/ko/skills#bundled-skills) 및 [워크플로우](/docs/ko/workflows) 끄기 | 플러그인 및 기술 | 모든 파일 |653| [`disableBundledSkills`](#disablebundledskills) | Claude Code에 포함된 [기술](/docs/ko/skills#bundled-skills) 및 [워크플로우](/docs/ko/workflows) 끄기 | 플러그인 및 기술 | 모든 파일 |
649| [`disableClaudeAiConnectors`](#disableclaudeaiconnectors) | [claude.ai 커넥터](/docs/ko/mcp#disable-claude-ai-connectors)를 끄기 때문에 Claude Code가 가져오지 않음 | MCP | 모든 파일 |654| [`disableClaudeAiConnectors`](#disableclaudeaiconnectors) | [claude.ai 커넥터](/docs/ko/mcp#disable-claude-ai-connectors)를 끄기 때문에 Claude Code가 가져오지 않음 | MCP | 모든 파일 |
650| [`disableCommandPluginSources`](#disablecommandpluginsources) | 마켓플레이스 선언 명령을 실행하여 설치하는 [플러그인](/docs/ko/plugins) 차단 | 플러그인 및 기술 | 관리됨 |655| [`disableCommandPluginSources`](#disablecommandpluginsources) | 마켓플레이스 선언 명령을 실행하여 설치하는 [플러그인](/docs/ko/plugins/overview) 차단 | 플러그인 및 기술 | 관리됨 |
651| [`disableDeepLinkRegistration`](#disabledeeplinkregistration) | Claude Code가 [`claude-cli://` 핸들러](/docs/ko/deep-links) 등록 중지 | 원격, 데스크톱, 알림 | 모든 파일 |656| [`disableDeepLinkRegistration`](#disabledeeplinkregistration) | Claude Code가 [`claude-cli://` 핸들러](/docs/ko/deep-links) 등록 중지 | 원격, 데스크톱, 알림 | 모든 파일 |
652| [`disableDesktopLocalSessions`](#disabledesktoplocalsessions) | 기기에서 실행되는 [Desktop Code 세션](/docs/ko/desktop#local-sessions-on-managed-devices) 끄기, SSH를 다른 호스트 및 클라우드로 남겨두기 | 원격, 데스크톱, 알림 | 관리됨 |657| [`disableDesktopLocalSessions`](#disabledesktoplocalsessions) | 기기에서 실행되는 [Desktop Code 세션](/docs/ko/desktop#local-sessions-on-managed-devices) 끄기, SSH를 다른 호스트 및 클라우드로 남겨두기 | 원격, 데스크톱, 알림 | 관리됨 |
653| [`disabledMcpjsonServers`](#disabledmcpjsonservers) | 프로젝트의 [`.mcp.json`](/docs/ko/mcp#project-scope)에서 특정 서버 거부 | MCP | 모든 파일 |658| [`disabledMcpjsonServers`](#disabledmcpjsonservers) | 프로젝트의 [`.mcp.json`](/docs/ko/mcp#project-scope)에서 특정 서버 거부 | MCP | 모든 파일 |
654| [`disableMobileSimulatorTools`](#disablemobilesimulatortools) | [데스크톱](/docs/ko/desktop) iOS 시뮬레이터 창에서 Claude의 도구 차단 | 도구 | 관리됨 |659| [`disableMobileSimulatorTools`](#disablemobilesimulatortools) | [데스크톱](/docs/ko/desktop) iOS 시뮬레이터 창에서 Claude의 도구 차단 | 도구 | 관리됨 |
655| [`disableRemoteControl`](#disableremotecontrol) | [Remote Control](/docs/ko/remote-control)을 시작할 수 있는 모든 곳에서 끄기 | 원격, 데스크톱, 알림 | 모든 파일 |660| [`disableRemoteControl`](#disableremotecontrol) | [Remote Control](/docs/ko/remote-control)을 시작할 수 있는 모든 곳에서 끄기 | 원격, 데스크톱, 알림 | 모든 파일 |
656| [`disableSideloadFlags`](#disablesideloadflags) | [플러그인](/docs/ko/plugins), [subagent](/docs/ko/sub-agents), [MCP 서버](/docs/ko/mcp)를 사이드로드하는 CLI 플래그 거부 | 엔터프라이즈 및 관리 설정 | 관리됨 |661| [`disableSideloadFlags`](#disablesideloadflags) | [플러그인](/docs/ko/plugins/overview), [subagent](/docs/ko/sub-agents), [MCP 서버](/docs/ko/mcp)를 사이드로드하는 CLI 플래그 거부 | 엔터프라이즈 및 관리 설정 | 관리됨 |
657| [`disableSkillShellExecution`](#disableskillshellexecution) | [기술](/docs/ko/skills) 및 사용자 정의 명령이 인라인 셸 실행 중지 | 플러그인 및 기술 | 모든 파일 |662| [`disableSkillShellExecution`](#disableskillshellexecution) | [기술](/docs/ko/skills) 및 사용자 정의 명령이 인라인 셸 실행 중지 | 플러그인 및 기술 | 모든 파일 |
658| [`disableWorkflows`](#disableworkflows) | 모든 사람을 위해 [동적 워크플로우](/docs/ko/workflows) 끄기; 자신을 위해 `enableWorkflows` 사용 | 훅 및 자동화 | 모든 파일 |663| [`disableWorkflows`](#disableworkflows) | 모든 사람을 위해 [동적 워크플로우](/docs/ko/workflows) 끄기; 자신을 위해 `enableWorkflows` 사용 | 훅 및 자동화 | 모든 파일 |
659| [`editorMode`](#editormode) | 입력 프롬프트에서 [vim 키 바인딩](/docs/ko/interactive-mode#vim-editor-mode) 사용 | 인터페이스 및 터미널 | 모든 파일 |664| [`editorMode`](#editormode) | 입력 프롬프트에서 [vim 키 바인딩](/docs/ko/interactive-mode#vim-editor-mode) 사용 | 인터페이스 및 터미널 | 모든 파일 |
662| [`enableAllProjectMcpServers`](#enableallprojectmcpservers) | 프롬프트 없이 프로젝트 [`.mcp.json`](/docs/ko/mcp#project-server-approvals-and-workspace-trust) 파일의 모든 서버 승인 | MCP | 모든 파일 |667| [`enableAllProjectMcpServers`](#enableallprojectmcpservers) | 프롬프트 없이 프로젝트 [`.mcp.json`](/docs/ko/mcp#project-server-approvals-and-workspace-trust) 파일의 모든 서버 승인 | MCP | 모든 파일 |
663| [`enableArtifact`](#enableartifact) | 모든 파일에서 `false`로 [Artifact 도구](/docs/ko/artifacts) 끄기; 어떤 파일도 다시 켤 수 없음 | 원격, 데스크톱, 알림 | 모든 파일 |668| [`enableArtifact`](#enableartifact) | 모든 파일에서 `false`로 [Artifact 도구](/docs/ko/artifacts) 끄기; 어떤 파일도 다시 켤 수 없음 | 원격, 데스크톱, 알림 | 모든 파일 |
664| [`enabledMcpjsonServers`](#enabledmcpjsonservers) | 프로젝트의 [`.mcp.json`](/docs/ko/mcp#project-server-approvals-and-workspace-trust)에서 특정 서버 승인 | MCP | 모든 파일 |669| [`enabledMcpjsonServers`](#enabledmcpjsonservers) | 프로젝트의 [`.mcp.json`](/docs/ko/mcp#project-server-approvals-and-workspace-trust)에서 특정 서버 승인 | MCP | 모든 파일 |
665| [`enabledPlugins`](#enabledplugins) | 범위별로 개별 [플러그인](/docs/ko/plugins) 켜기 또는 끄기 | 플러그인 및 기술 | 모든 파일 |670| [`enabledPlugins`](#enabledplugins) | 범위별로 개별 [플러그인](/docs/ko/plugins/overview) 켜기 또는 끄기 | 플러그인 및 기술 | 모든 파일 |
666| [`enableWorkflows`](#enableworkflows) | 계획의 기본값에 대해 [동적 워크플로우](/docs/ko/workflows) 켜기 또는 끄기 | 훅 및 자동화 | 모든 파일 |671| [`enableWorkflows`](#enableworkflows) | 계획의 기본값에 대해 [동적 워크플로우](/docs/ko/workflows) 켜기 또는 끄기 | 훅 및 자동화 | 모든 파일 |
667| [`enforceAvailableModels`](#enforceavailablemodels) | [`/model` 기본 선택](/docs/ko/model-config#enforce-the-allowlist-for-the-default-model)을 `availableModels` 허용 목록 내에 유지 | 모델 및 응답 | 모든 파일 |672| [`enforceAvailableModels`](#enforceavailablemodels) | [`/model` 기본 선택](/docs/ko/model-config#enforce-the-allowlist-for-the-default-model)을 `availableModels` 허용 목록 내에 유지 | 모델 및 응답 | 모든 파일 |
668| [`env`](#env) | 모든 세션 및 해당 부프로세스에 대해 [환경 변수](/docs/ko/env-vars#in-settings-files) 설정 | 메모리 및 컨텍스트 | 모든 파일 |673| [`env`](#env) | 모든 세션 및 해당 부프로세스에 대해 [환경 변수](/docs/ko/env-vars#in-settings-files) 설정 | 메모리 및 컨텍스트 | 모든 파일 |
669| [`externalEditorContext`](#externaleditorcontext) | [Ctrl+G](/docs/ko/interactive-mode#general-controls)를 눌러 편집할 때 Claude의 마지막 응답을 주석으로 표시 | 전역 설정 | 전역 설정 |674| [`externalEditorContext`](#externaleditorcontext) | [Ctrl+G](/docs/ko/interactive-mode#general-controls)를 눌러 편집할 때 Claude의 마지막 응답을 주석으로 표시 | 전역 설정 | 전역 설정 |
670| [`extraKnownMarketplaces`](#extraknownmarketplaces) | 저장소 또는 조직의 [마켓플레이스](/docs/ko/plugin-marketplaces) 등록 | 플러그인 및 기술 | 모든 파일 |675| [`extraKnownMarketplaces`](#extraknownmarketplaces) | 저장소 또는 조직의 [마켓플레이스](/docs/ko/plugins/overview) 등록 | 플러그인 및 기술 | 모든 파일 |
671| [`fallbackModel`](#fallbackmodel) | 기본이 과부하일 때 [백업 모델](/docs/ko/model-config#fallback-model-chains) 이름 지정 | 모델 및 응답 | 모든 파일 |676| [`fallbackModel`](#fallbackmodel) | 기본이 과부하일 때 [백업 모델](/docs/ko/model-config#fallback-model-chains) 이름 지정 | 모델 및 응답 | 모든 파일 |
672| [`fastMode`](#fastmode) | 사용 가능한 세션에 대해 [빠른 모드](/docs/ko/fast-mode) 켜기 | 모델 및 응답 | 모든 파일 |677| [`fastMode`](#fastmode) | 사용 가능한 세션에 대해 [빠른 모드](/docs/ko/fast-mode) 켜기 | 모델 및 응답 | 모든 파일 |
673| [`fastModePerSessionOptIn`](#fastmodepersessionoptin) | 사람들이 각 세션에서 [빠른 모드](/docs/ko/fast-mode) 켜도록 요구 | 모델 및 응답 | 모든 파일 |678| [`fastModePerSessionOptIn`](#fastmodepersessionoptin) | 사람들이 각 세션에서 [빠른 모드](/docs/ko/fast-mode) 켜도록 요구 | 모델 및 응답 | 모든 파일 |
690| [`isolatePeerMachines`](#isolatepeermachines) | Claude가 [다른 기계의 세션 중 하나에 메시지를 보내기](/docs/ko/cross-session-messaging#require-approval-for-cross-machine-messages) 전에 물어보기 | 에이전트, 세션, 워크트리 | 모든 파일 |695| [`isolatePeerMachines`](#isolatepeermachines) | Claude가 [다른 기계의 세션 중 하나에 메시지를 보내기](/docs/ko/cross-session-messaging#require-approval-for-cross-machine-messages) 전에 물어보기 | 에이전트, 세션, 워크트리 | 모든 파일 |
691| [`keybindingFlavor`](#keybindingflavor) | 더 이상 사용되지 않으며 효과 없음; 단어 편집 바로 가기는 항상 [readline 규칙](/docs/ko/interactive-mode#make-ctrl-w-delete-back-to-whitespace)을 따름 | 인터페이스 및 터미널 | 모든 파일 |696| [`keybindingFlavor`](#keybindingflavor) | 더 이상 사용되지 않으며 효과 없음; 단어 편집 바로 가기는 항상 [readline 규칙](/docs/ko/interactive-mode#make-ctrl-w-delete-back-to-whitespace)을 따름 | 인터페이스 및 터미널 | 모든 파일 |
692| [`language`](#language) | Claude가 영어 이외의 언어로 응답하도록 함 | 모델 및 응답 | 모든 파일 |697| [`language`](#language) | Claude가 영어 이외의 언어로 응답하도록 함 | 모델 및 응답 | 모든 파일 |
698| [`leftArrowOpensAgents`](#leftarrowopensagents) | [세션을 백그라운드로 보내고 에이전트 보기를 열기](/docs/ko/agent-view#switch-sessions-without-leaving-the-terminal)하는 `←` 바로 가기 끄기 | 전역 설정 | 전역 설정 |
693| [`managedMcpServers`](#managedmcpservers) | 사용자가 추가하는 것과 함께 모든 사용자에게 원격 [MCP 서버](/docs/ko/managed-mcp#provide-servers-through-managed-settings) 제공 | MCP | 관리됨 |699| [`managedMcpServers`](#managedmcpservers) | 사용자가 추가하는 것과 함께 모든 사용자에게 원격 [MCP 서버](/docs/ko/managed-mcp#provide-servers-through-managed-settings) 제공 | MCP | 관리됨 |
694| [`managedSourcesBehavior`](#managedsourcesbehavior) | 배포하는 모든 [관리되는 소스](/docs/ko/managed-settings#how-claude-code-combines-managed-sources)를 구성하는 대신 가장 높은 우선순위 하나만 사용 | 엔터프라이즈 및 관리 설정 | 관리됨 |700| [`managedSourcesBehavior`](#managedsourcesbehavior) | 배포하는 모든 [관리되는 소스](/docs/ko/managed-settings#how-claude-code-combines-managed-sources)를 구성하는 대신 가장 높은 우선순위 하나만 사용 | 엔터프라이즈 및 관리 설정 | 관리됨 |
695| [`maxEffortLevel`](#maxeffortlevel) | 모든 모델 또는 모델별로, 모든 공급자에서 [노력 수준](/docs/ko/model-config#adjust-effort-level) 제한 | 모델 및 응답 | 모든 파일 |701| [`maxEffortLevel`](#maxeffortlevel) | 모든 모델 또는 모델별로, 모든 공급자에서 [노력 수준](/docs/ko/model-config#adjust-effort-level) 제한 | 모델 및 응답 | 모든 파일 |
702| [`maxProseWidth`](#maxprosewidth) | 넓은 터미널에서 Claude의 응답의 산문이 실행되는 너비 제한 | 인터페이스 및 터미널 | 모든 파일 |
696| [`minimumVersion`](#minimumversion) | [자동 업데이트](/docs/ko/setup#pin-a-minimum-version)가 버전 이하의 것을 설치하지 않도록 유지 | 업데이트 및 버전 관리 | 모든 파일 |703| [`minimumVersion`](#minimumversion) | [자동 업데이트](/docs/ko/setup#pin-a-minimum-version)가 버전 이하의 것을 설치하지 않도록 유지 | 업데이트 및 버전 관리 | 모든 파일 |
697| [`model`](#model) | Claude Code가 시작하는 [모델](/docs/ko/model-config#set-a-default-model-for-new-sessions) 변경 | 모델 및 응답 | 모든 파일 |704| [`model`](#model) | Claude Code가 시작하는 [모델](/docs/ko/model-config#set-a-default-model-for-new-sessions) 변경 | 모델 및 응답 | 모든 파일 |
698| [`modelOverrides`](#modeloverrides) | [모델 ID를 공급자의 ID(예: Bedrock ARN)에 매핑](/docs/ko/model-config#override-model-ids-per-version) | 모델 및 응답 | 모든 파일 |705| [`modelOverrides`](#modeloverrides) | [모델 ID를 공급자의 ID(예: Bedrock ARN)에 매핑](/docs/ko/model-config#override-model-ids-per-version) | 모델 및 응답 | 모든 파일 |
712| [`permissions.deny`](#permissions-deny) | 나열된 [도구 사용](/docs/ko/permissions#permission-rule-syntax) 차단, 비밀을 보유한 파일의 읽기 포함 | 권한 설정 | 모든 파일 |719| [`permissions.deny`](#permissions-deny) | 나열된 [도구 사용](/docs/ko/permissions#permission-rule-syntax) 차단, 비밀을 보유한 파일의 읽기 포함 | 권한 설정 | 모든 파일 |
713| [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | 누구도 [bypassPermissions 모드](/docs/ko/permission-modes#skip-all-checks-with-bypasspermissions-mode)에 들어가지 못하도록 방지 | 권한 설정 | 모든 파일 |720| [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | 누구도 [bypassPermissions 모드](/docs/ko/permission-modes#skip-all-checks-with-bypasspermissions-mode)에 들어가지 못하도록 방지 | 권한 설정 | 모든 파일 |
714| [`plansDirectory`](#plansdirectory) | [계획 모드](/docs/ko/permission-modes#analyze-before-you-edit-with-plan-mode)가 계획 파일을 쓰는 위치 선택 | 메모리 및 컨텍스트 | 모든 파일 |721| [`plansDirectory`](#plansdirectory) | [계획 모드](/docs/ko/permission-modes#analyze-before-you-edit-with-plan-mode)가 계획 파일을 쓰는 위치 선택 | 메모리 및 컨텍스트 | 모든 파일 |
715| [`pluginConfigs`](#pluginconfigs) | [플러그인](/docs/ko/plugins)의 구성 대화에서 제공한 답변 저장 | 플러그인 및 기술 | 사용자 또는 관리됨 |722| [`pluginConfigs`](#pluginconfigs) | [플러그인](/docs/ko/plugins/overview)의 구성 대화에서 제공한 답변 저장 | 플러그인 및 기술 | 사용자 또는 관리됨 |
716| [`pluginSuggestionMarketplaces`](#pluginsuggestionmarketplaces) | `/plugin`에서 플러그인 설치 제안을 표시할 수 있는 [마켓플레이스](/docs/ko/plugin-marketplaces#managed-marketplace-restrictions) 선택 | 플러그인 및 기술 | 관리됨 |723| [`pluginSuggestionMarketplaces`](#pluginsuggestionmarketplaces) | `/plugin`에서 플러그인 설치 제안을 표시할 수 있는 [마켓플레이스](/docs/ko/plugins/org#restrict-what-users-can-install) 선택 | 플러그인 및 기술 | 관리됨 |
717| [`pluginTrustMessage`](#plugintrustmessage) | [플러그인](/docs/ko/plugins) 신뢰 경고에 자신의 텍스트 추가 | 플러그인 및 기술 | 관리됨 |724| [`pluginTrustMessage`](#plugintrustmessage) | [플러그인](/docs/ko/plugins/overview) 신뢰 경고에 자신의 텍스트 추가 | 플러그인 및 기술 | 관리됨 |
718| [`policyHelper`](#policyhelper) | 시작 시 [관리되는 설정](/docs/ko/managed-settings#compute-the-policy-with-a-helper-program)을 계산하는 실행 파일 실행 | 엔터프라이즈 및 관리 설정 | 관리됨 |725| [`policyHelper`](#policyhelper) | 시작 시 [관리되는 설정](/docs/ko/managed-settings#compute-the-policy-with-a-helper-program)을 계산하는 실행 파일 실행 | 엔터프라이즈 및 관리 설정 | 관리됨 |
719| [`policyHelper.path`](#policyhelper-path) | Claude Code가 실행하는 [도우미 실행 파일](/docs/ko/managed-settings#compute-the-policy-with-a-helper-program) 이름 지정 | 엔터프라이즈 및 관리 설정 | 관리됨 |726| [`policyHelper.path`](#policyhelper-path) | Claude Code가 실행하는 [도우미 실행 파일](/docs/ko/managed-settings#compute-the-policy-with-a-helper-program) 이름 지정 | 엔터프라이즈 및 관리 설정 | 관리됨 |
720| [`policyHelper.refreshIntervalMs`](#policyhelper-refreshintervalms) | 백그라운드에서 간격으로 [도우미](/docs/ko/managed-settings#compute-the-policy-with-a-helper-program) 다시 실행 | 엔터프라이즈 및 관리 설정 | 관리됨 |727| [`policyHelper.refreshIntervalMs`](#policyhelper-refreshintervalms) | 백그라운드에서 간격으로 [도우미](/docs/ko/managed-settings#compute-the-policy-with-a-helper-program) 다시 실행 | 엔터프라이즈 및 관리 설정 | 관리됨 |
724| [`processWrapper`](#processwrapper) | Claude Code의 백그라운드 프로세스를 macOS 및 Linux의 [기업 런처](/docs/ko/corporate-launcher)를 통해 실행 | 에이전트, 세션, 워크트리 | 사용자 또는 관리됨 |731| [`processWrapper`](#processwrapper) | Claude Code의 백그라운드 프로세스를 macOS 및 Linux의 [기업 런처](/docs/ko/corporate-launcher)를 통해 실행 | 에이전트, 세션, 워크트리 | 사용자 또는 관리됨 |
725| [`promptCacheTtl`](#promptcachettl) | 주 대화의 [프롬프트 캐시 수명](/docs/ko/prompt-caching#cache-lifetime) 선택 | 모델 및 응답 | 모든 파일 |732| [`promptCacheTtl`](#promptcachettl) | 주 대화의 [프롬프트 캐시 수명](/docs/ko/prompt-caching#cache-lifetime) 선택 | 모델 및 응답 | 모든 파일 |
726| [`promptSuggestionEnabled`](#promptsuggestionenabled) | 입력 상자의 회색 [프롬프트 제안](/docs/ko/interactive-mode#prompt-suggestions) 숨기기 | 인터페이스 및 터미널 | 모든 파일 |733| [`promptSuggestionEnabled`](#promptsuggestionenabled) | 입력 상자의 회색 [프롬프트 제안](/docs/ko/interactive-mode#prompt-suggestions) 숨기기 | 인터페이스 및 터미널 | 모든 파일 |
734| [`prStatusFooterEnabled`](#prstatusfooterenabled) | 프롬프트 바닥글의 [PR 검토 상태](/docs/ko/interactive-mode#pr-review-status) 배지 및 그 뒤의 풀 요청 확인 끄기 | 전역 설정 | 전역 설정 |
727| [`prUrlTemplate`](#prurltemplate) | PR 링크를 github.com 대신 내부 코드 검토 도구로 지정 | Git 및 속성 | 모든 파일 |735| [`prUrlTemplate`](#prurltemplate) | PR 링크를 github.com 대신 내부 코드 검토 도구로 지정 | Git 및 속성 | 모든 파일 |
728| [`remote.defaultEnvironmentId`](#remote-defaultenvironmentid) | `claude --cloud`의 기본 [클라우드 환경](/docs/ko/cloud-environments) 선택; 자체 호스팅 `ccpool_` ID는 사용자 및 관리 설정 및 `--settings`에서만 읽음 | 원격, 데스크톱, 알림 | 모든 파일 |736| [`remote.defaultEnvironmentId`](#remote-defaultenvironmentid) | `claude --cloud`의 기본 [클라우드 환경](/docs/ko/cloud-environments) 선택; 자체 호스팅 `ccpool_` ID는 사용자 및 관리 설정 및 `--settings`에서만 읽음 | 원격, 데스크톱, 알림 | 모든 파일 |
729| [`remoteControlAtStartup`](#remotecontrolatstartup) | 세션이 시작할 때 [Remote Control](/docs/ko/remote-control#enable-remote-control-for-all-sessions) 자동 연결 | 원격, 데스크톱, 알림 | 모든 파일 |737| [`remoteControlAtStartup`](#remotecontrolatstartup) | 세션이 시작할 때 [Remote Control](/docs/ko/remote-control#enable-remote-control-for-all-sessions) 자동 연결 | 원격, 데스크톱, 알림 | 모든 파일 |
785| [`sshConfigs`](#sshconfigs) | Desktop 환경 드롭다운에 [SSH 연결](/docs/ko/desktop#pre-configure-ssh-connections-for-your-team) 추가 | 원격, 데스크톱, 알림 | 사용자 또는 관리됨 |793| [`sshConfigs`](#sshconfigs) | Desktop 환경 드롭다운에 [SSH 연결](/docs/ko/desktop#pre-configure-ssh-connections-for-your-team) 추가 | 원격, 데스크톱, 알림 | 사용자 또는 관리됨 |
786| [`sshHostAllowlist`](#sshhostallowlist) | [Desktop SSH 세션](/docs/ko/desktop#restrict-which-ssh-hosts-users-can-connect-to)이 도달할 수 있는 호스트 제한 | 원격, 데스크톱, 알림 | 관리됨 |794| [`sshHostAllowlist`](#sshhostallowlist) | [Desktop SSH 세션](/docs/ko/desktop#restrict-which-ssh-hosts-users-can-connect-to)이 도달할 수 있는 호스트 제한 | 원격, 데스크톱, 알림 | 관리됨 |
787| [`statusLine`](#statusline) | [상태 라인](/docs/ko/statusline)을 렌더링하는 자신의 명령 실행 | 인터페이스 및 터미널 | 모든 파일 |795| [`statusLine`](#statusline) | [상태 라인](/docs/ko/statusline)을 렌더링하는 자신의 명령 실행 | 인터페이스 및 터미널 | 모든 파일 |
788| [`strictKnownMarketplaces`](#strictknownmarketplaces) | 사용자가 추가하고 설치할 수 있는 [마켓플레이스](/docs/ko/plugin-marketplaces) 소스 허용 목록 | 플러그인 및 기술 | 관리됨 |796| [`strictKnownMarketplaces`](#strictknownmarketplaces) | 사용자가 추가하고 설치할 수 있는 [마켓플레이스](/docs/ko/plugins/overview) 소스 허용 목록 | 플러그인 및 기술 | 관리됨 |
789| [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | 사용자 및 프로젝트 소스에서 [기술](/docs/ko/skills), [에이전트](/docs/ko/sub-agents), [훅](/docs/ko/hooks), [MCP 서버](/docs/ko/mcp) 차단 | 플러그인 및 기술 | 관리됨 |797| [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | 사용자 및 프로젝트 소스에서 [기술](/docs/ko/skills), [에이전트](/docs/ko/sub-agents), [훅](/docs/ko/hooks), [MCP 서버](/docs/ko/mcp) 차단 | 플러그인 및 기술 | 관리됨 |
790| [`strictPluginOnlyCustomization.agents`](#strictpluginonlycustomization-agents) | [에이전트](/docs/ko/sub-agents)를 플러그인 및 관리 소스로 잠금 | 플러그인 및 기술 | 관리됨 |798| [`strictPluginOnlyCustomization.agents`](#strictpluginonlycustomization-agents) | [에이전트](/docs/ko/sub-agents)를 플러그인 및 관리 소스로 잠금 | 플러그인 및 기술 | 관리됨 |
791| [`strictPluginOnlyCustomization.hooks`](#strictpluginonlycustomization-hooks) | [훅](/docs/ko/hooks)을 플러그인 및 관리 소스로 잠금 | 플러그인 및 기술 | 관리됨 |799| [`strictPluginOnlyCustomization.hooks`](#strictpluginonlycustomization-hooks) | [훅](/docs/ko/hooks)을 플러그인 및 관리 소스로 잠금 | 플러그인 및 기술 | 관리됨 |
794| [`subagentPromptCacheTtl`](#subagentpromptcachettl) | subagent 및 주 대화 외부의 다른 요청의 [프롬프트 캐시 수명](/docs/ko/prompt-caching#cache-lifetime) 선택 | 모델 및 응답 | 모든 파일 |802| [`subagentPromptCacheTtl`](#subagentpromptcachettl) | subagent 및 주 대화 외부의 다른 요청의 [프롬프트 캐시 수명](/docs/ko/prompt-caching#cache-lifetime) 선택 | 모델 및 응답 | 모든 파일 |
795| [`subagentStatusLine`](#subagentstatusline) | [subagent](/docs/ko/sub-agents) 작업 표시의 행을 자신의 명령으로 다시 쓰기 | 인터페이스 및 터미널 | 모든 파일 |803| [`subagentStatusLine`](#subagentstatusline) | [subagent](/docs/ko/sub-agents) 작업 표시의 행을 자신의 명령으로 다시 쓰기 | 인터페이스 및 터미널 | 모든 파일 |
796| [`switchModelsOnFlag`](#switchmodelsonflag) | [안전 분류기](/docs/ko/model-config#ask-before-switching)가 요청에 플래그를 지정할 때 모델을 자동으로 전환하거나 일시 중지 | 모델 및 응답 | 모든 파일 |804| [`switchModelsOnFlag`](#switchmodelsonflag) | [안전 분류기](/docs/ko/model-config#ask-before-switching)가 요청에 플래그를 지정할 때 모델을 자동으로 전환하거나 일시 중지 | 모델 및 응답 | 모든 파일 |
797| [`syncClaudeAiPlugins`](#syncclaudeaiplugins) | [claude.ai 계정에서 활성화된 플러그인](/docs/ko/plugins-reference#synced-plugins) 다운로드 중지 및 이미 동기화된 플러그인 숨기기 | 플러그인 및 기술 | 사용자, 로컬 또는 관리됨 |805| [`syncClaudeAiPlugins`](#syncclaudeaiplugins) | [claude.ai 계정에서 활성화된 플러그인](/docs/ko/plugins/loading#synced-plugins) 다운로드 중지 및 이미 동기화된 플러그인 숨기기 | 플러그인 및 기술 | 사용자, 로컬 또는 관리됨 |
798| [`syncClaudeAiSkills`](#syncclaudeaiskills) | [claude.ai 계정에서 활성화된 기술](/docs/ko/skills#how-synced-skills-behave) 다운로드 중지 및 이미 동기화된 기술 숨기기 | 플러그인 및 기술 | 사용자, 로컬 또는 관리됨 |806| [`syncClaudeAiSkills`](#syncclaudeaiskills) | [claude.ai 계정에서 활성화된 기술](/docs/ko/skills#how-synced-skills-behave) 다운로드 중지 및 이미 동기화된 기술 숨기기 | 플러그인 및 기술 | 사용자, 로컬 또는 관리됨 |
799| [`syntaxHighlightingDisabled`](#syntaxhighlightingdisabled) | diff 및 코드 블록에서 구문 강조 끄기 | 인터페이스 및 터미널 | 모든 파일 |807| [`syntaxHighlightingDisabled`](#syntaxhighlightingdisabled) | diff 및 코드 블록에서 구문 강조 끄기 | 인터페이스 및 터미널 | 모든 파일 |
800| [`taskOutputMaxChars`](#taskoutputmaxchars) | v2.1.277에서 제거됨, 크기를 조정한 `TaskOutput` 도구와 함께 | 메모리 및 컨텍스트 | 모든 파일 |808| [`taskOutputMaxChars`](#taskoutputmaxchars) | v2.1.277에서 제거됨, 크기를 조정한 `TaskOutput` 도구와 함께 | 메모리 및 컨텍스트 | 모든 파일 |
827 모델 및 응답835 모델 및 응답
828</h2>836</h2>
829 837
830Claude Code가 사용할 모델과 응답 방식을 선택합니다. 이러한 설정이 `/model` 명령 및 환경 변수와 상호작용하는 방식에 대해서는 [모델 구성](/docs/ko/model-config)을 참조하십시오.838Claude Code가 사용할 모델과 응답 방식을 선택합니다. 이러한 설정이 `/model` 명령 및 환경 변수와 어떻게 상호작용하는지는 [모델 구성](/docs/ko/model-config)을 참조하십시오.
831 839
832<h3 id="advisormodel">840<h3 id="advisormodel">
833 `advisorModel`841 `advisorModel`
834</h3>842</h3>
835 843
836Claude가 서버 측 [advisor 도구](/docs/ko/advisor)를 호출할 때 응답하는 모델을 선택합니다. 이를 설정 해제하여 advisor를 끕니다. advisor는 최소한 주 모델만큼 능력이 있어야 합니다. 허용되는 쌍과 허용되지 않는 쌍을 선택할 때 발생하는 상황에 대해서는 [advisor 모델 선택](/docs/ko/advisor#choose-an-advisor-model)을 참조하십시오.844Claude가 서버 측 [advisor 도구](/docs/ko/advisor)를 호출할 때 응답하는 모델을 선택합니다. advisor를 끄려면 설정을 해제합니다. advisor는 최소한 주 모델만큼 능력이 있어야 합니다. 허용되는 쌍과 허용되지 않는 쌍을 선택할 때 발생하는 상황은 [advisor 모델 선택](/docs/ko/advisor#choose-an-advisor-model)을 참조하십시오.
837 845
838일반적으로 이 키를 직접 편집하지 않습니다. `/advisor`를 실행하여 현재 선택, advisor할 수 있는 모델, **advisor 없음**을 표시하는 선택기를 엽니다. Claude Code는 선택 사항을 `~/.claude/settings.json`의 이 키에 저장합니다. [Remote Control](/docs/ko/remote-control) 클라이언트에서 선택하거나 원격 워커에 연결된 세션에서 선택하면, 선택 사항이 해당 세션에만 적용되며 이 키를 변경하지 않습니다.846일반적으로 이 키를 직접 편집하지 않습니다. `/advisor`를 실행하여 현재 선택, advisor가 될 수 있는 모델, **advisor 없음**을 표시하는 선택기를 엽니다. Claude Code는 선택 사항을 `~/.claude/settings.json`의 이 키에 저장합니다. [Remote Control](/docs/ko/remote-control) 클라이언트에서 선택하거나 원격 워커에 연결된 세션에서 선택하면, 선택 사항이 해당 세션에만 적용되고 이 키는 변경되지 않습니다.
839 847
840계정에 [usage-credits 동의](/docs/ko/advisor#fable-advisor-and-usage-credits)가 필요한 경우, `/model fable`을 실행하여 먼저 동의합니다. 그렇게 할 때까지 `/advisor`에서 Fable을 선택해도 아무것도 저장되지 않으며 Claude Code는 먼저 `/model fable`을 실행하도록 지시합니다.848계정에 [usage-credits 동의](/docs/ko/advisor#fable-advisor-and-usage-credits)가 필요한 경우, `/model fable`을 실행하여 먼저 동의합니다. 동의하기 전까지는 `/advisor`에서 Fable을 선택해도 아무것도 저장되지 않으며 Claude Code는 먼저 `/model fable`을 실행하도록 지시합니다.
841 849
842* **범위**: [`모든 파일`](#scopes)850* **범위**: [`Any file`](#scopes)
843* **유형**: 문자열, `"fable"`, `"opus"`, 또는 `"sonnet"` 중 하나의 별칭(Claude Code의 해당 모델 제품군의 현재 기본 버전으로 확인됨) 또는 `"claude-opus-5"`와 같은 전체 모델 ID851* **유형**: 문자열, `"fable"`, `"opus"`, 또는 `"sonnet"` 중 하나의 별칭(Claude Code의 해당 모델 제품군의 현재 기본 버전으로 확인됨) 또는 `"claude-opus-5-5"`와 같은 전체 모델 ID
844* **기본값**: 설정 해제되어 advisor가 꺼짐852* **기본값**: 설정 해제되어 advisor가 꺼짐
845* **세션별 재정의**: `--advisor`는 한 세션 동안 이 키보다 우선합니다. [`CLAUDE_CODE_DISABLE_ADVISOR_TOOL`](/docs/ko/env-vars)은 advisor를 끄고, 이 키는 다시 켤 수 없습니다853* **세션별 재정의**: `--advisor`는 한 세션에 대해 이 키보다 우선하며, [`CLAUDE_CODE_DISABLE_ADVISOR_TOOL`](/docs/ko/env-vars)은 advisor를 끄고 이 키는 다시 켤 수 없습니다.
846 854
847```json settings.json theme={null}855```json settings.json theme={null}
848{856{
850}858}
851```859```
852 860
853이 키는 Amazon Bedrock 및 AWS의 Claude Platform과 같이 advisor가 [사용 불가능한](/docs/ko/advisor#requirements) 공급자에게는 영향을 주지 않습니다. `"fable"`은 [Fable 액세스](/docs/ko/advisor#choose-an-advisor-model)가 필요합니다.861이 키는 Amazon Bedrock 및 AWS의 Claude Platform과 같이 advisor가 [사용 불가능](/docs/ko/advisor#requirements)한 공급자에게는 영향을 주지 않습니다. `"fable"`은 [Fable 액세스](/docs/ko/advisor#choose-an-advisor-model)가 필요합니다.
854 862
855<h3 id="alwaysthinkingenabled">863<h3 id="alwaysthinkingenabled">
856 `alwaysThinkingEnabled`864 `alwaysThinkingEnabled`
858 866
859이를 `false`로 설정하여 모든 세션에 대해 [확장 사고](/docs/ko/model-config#extended-thinking)를 끕니다. 사고는 기본적으로 켜져 있으므로 `true`는 아무것도 변경하지 않습니다. 대부분의 사람들은 파일을 편집하는 대신 `/config`를 통해 이를 설정합니다.867이를 `false`로 설정하여 모든 세션에 대해 [확장 사고](/docs/ko/model-config#extended-thinking)를 끕니다. 사고는 기본적으로 켜져 있으므로 `true`는 아무것도 변경하지 않습니다. 대부분의 사람들은 파일을 편집하는 대신 `/config`를 통해 이를 설정합니다.
860 868
861Fable 모델과 같이 항상 사고하는 모델에서는 `false`가 영향을 주지 않습니다. [타사 공급자](/docs/ko/third-party-integrations)에서 Claude Code는 사고를 끄는 대신 `thinking` 매개변수를 생략하므로 적응형 추론 모델은 여전히 사고할 수 있습니다. Anthropic API에서 사고를 끈 경우, Claude Code는 Opus 5와 같이 [해당 조합을 허용하지 않는](/docs/ko/errors#effort-isnt-available-with-thinking-turned-off) 모델에 더 높은 수준 대신 노력 `high`를 보냅니다.869Opus 5.5, Sonnet 5.5, Fable 모델과 같이 항상 사고하는 모델에서는 `false`가 영향을 주지 않습니다. [타사 공급자](/docs/ko/third-party-integrations)에서 Claude Code는 사고를 끄는 대신 `thinking` 매개변수를 생략하므로 적응형 추론 모델은 여전히 사고할 수 있습니다. Anthropic API에서 사고를 끈 경우, Claude Code는 [해당 조합을 허용하지 않는](/docs/ko/errors#effort-isnt-available-with-thinking-turned-off) Opus 5와 같은 모델에 더 높은 수준 대신 노력 `high`를 보냅니다.
862 870
863* **범위**: [`모든 파일`](#scopes)871* **범위**: [`Any file`](#scopes)
864* **유형**: 부울872* **유형**: 부울
865 * `true`: 영향 없음; 사고는 이미 켜짐873 * `true`: 영향 없음; 사고는 이미 켜짐
866 * `false`: Claude Code는 모든 세션에 대해 확장 사고를 끕니다874 * `false`: Claude Code는 모든 세션에 대해 확장 사고를 끕니다.
867* **기본값**: 설정 해제되어 사고는 이를 지원하는 모델에 대해 켜짐875* **기본값**: 설정 해제되어 사고는 이를 지원하는 모델에 대해 켜짐
868* **세션별 재정의**: [`MAX_THINKING_TOKENS`](/docs/ko/env-vars)는 한 세션 동안 이 키보다 우선합니다: `0`은 `false`와 동일한 모델 및 공급자 제한 하에서 사고를 끄고, 양수 값은 이 키가 `false`일 때도 사고를 켭니다. 적응형 추론 모델에서 숫자 자체는 무시됩니다876* **세션별 재정의**: [`MAX_THINKING_TOKENS`](/docs/ko/env-vars)는 한 세션에 대해 이 키보다 우선합니다: `0`은 `false`와 동일한 모델 및 공급자 제한 하에서 사고를 끄고, 양수 값은 이 키가 `false`일 때도 사고를 켭니다. 적응형 추론 모델에서는 숫자 자체가 무시됩니다.
869 877
870```json settings.json theme={null}878```json settings.json theme={null}
871{879{
877 `availableModels`885 `availableModels`
878</h3>886</h3>
879 887
880사람들이 주 세션, [subagents](/docs/ko/sub-agents), [skills](/docs/ko/skills), [advisor](/docs/ko/advisor)에 대해 선택할 수 있는 모델을 제한합니다. 관리되는 목록은 `/model`, `--model`, 개발자 자신의 파일의 `model` 키를 제한합니다. 목록 외의 모델은 선택할 수 없습니다. 이것만으로는 기본값 옵션을 건드리지 않습니다. [`enforceAvailableModels`](#enforceavailablemodels)와 쌍을 이루십시오.888사람들이 주 세션, [subagents](/docs/ko/sub-agents), [skills](/docs/ko/skills), [advisor](/docs/ko/advisor)에 대해 선택할 수 있는 모델을 제한합니다. 관리되는 목록은 `/model`, `--model`, 개발자 자신의 파일의 `model` 키를 제한합니다. 목록 외의 모델은 선택할 수 없습니다. 기본 접두사 일치를 사용하면 Default 옵션 자체는 건드리지 않습니다. 이를 위해 [`enforceAvailableModels`](#enforceavailablemodels)와 쌍을 이룹니다.
881 889
882* **범위**: [`모든 파일`](#scopes). 조직에 대해 적용하려면 관리되는 설정에 배포합니다.890* **범위**: [`Any file`](#scopes). 조직에 대해 이를 적용하려면 관리되는 설정에 배포합니다.
883* **유형**: 모델 별칭 또는 ID의 배열891* **유형**: 모델 별칭 또는 ID의 배열
884* **기본값**: 설정 해제되어 모든 모델을 사용할 수 있음892* **기본값**: 설정 해제되어 모든 모델을 사용할 수 있음
885 893
891}899}
892```900```
893 901
894[모델 선택 제한](/docs/ko/model-config#restrict-model-selection)을 참조하십시오.902`"claude-opus-5"`와 같은 모델 ID 항목은 Opus 5.5와 같이 이를 확장하는 이후 버전도 허용합니다. 이러한 버전 중 하나를 차단하려면 [`deniedModels`](#deniedmodels)을 사용합니다. 각 모델 ID 항목이 이름을 지정하는 버전만 허용하도록 하려면 [`availableModelsMatch`](#availablemodelsmatch)를 사용합니다. [모델 선택 제한](/docs/ko/model-config#restrict-model-selection)을 참조하십시오.
903
904<h3 id="availablemodelsmatch">
905 `availableModelsMatch`
906</h3>
907
908[`availableModels`](#availablemodels) 항목이 모델 ID와 일치하는 방식을 선택합니다. 기본적으로 모델 ID 항목은 이를 확장하는 이후 버전도 허용하므로 `"claude-opus-5"`는 Opus 5.5를 허용합니다. `"exact"`를 사용하면 각 모델 ID 항목은 이름을 지정하는 버전만 허용하므로 해당 모델의 최신 버전은 이를 나열할 때까지 차단된 상태로 유지됩니다. Claude Code v2.1.283 이상이 필요합니다.
909
910* **범위**: [`Managed`](#scopes). Claude Code는 사용자, 프로젝트, 로컬 설정 및 `--settings`에서 이 키를 무시하고 경고를 표시합니다.
911* **유형**: 문자열, 다음 중 하나:
912 * `"prefix"`: 모델 ID 항목은 해당 버전 및 다른 세그먼트로 확장하는 모든 모델 ID를 허용합니다.
913 * `"exact"`: 모델 ID 항목은 이름을 지정하는 버전만 허용하며, 해당 버전의 날짜 ID를 포함하므로 `"claude-opus-5"`는 Opus 5를 허용하지만 `claude-opus-5-5`는 허용하지 않습니다. `"opus"`와 같은 제품군 별칭은 여전히 전체 제품군을 허용하며, `best`, `opusplan`, `default` 항목은 무시됩니다.
914* **기본값**: `"prefix"`
915
916이 예제는 Opus 5 및 Sonnet 5와 이들의 최신 릴리스를 허용하지 않습니다:
917
918```json managed-settings.json theme={null}
919{
920 "availableModels": ["claude-opus-5", "claude-sonnet-5"],
921 "availableModelsMatch": "exact"
922}
923```
924
925`"exact"`를 사용하면 목록이 최소한 하나의 모델 또는 제품군을 나열할 때마다 Default 옵션도 나열된 모델로 제한됩니다. [특정 모델 또는 버전 차단](/docs/ko/model-config#block-specific-models-or-versions)을 참조하십시오.
926
927<h3 id="deniedmodels">
928 `deniedModels`
929</h3>
930
931특정 모델을 차단하며, [`availableModels`](#availablemodels) 허용 목록이 있거나 없을 수 있으며 해당 목록이 이들을 허용하더라도 차단합니다. Claude Code는 차단된 모델을 `/model` 선택기에서 숨기며, `availableModels`이 적용되는 곳 어디서나 모델을 선택할 수 없습니다. Default 옵션의 세션은 [특정 모델 또는 버전 차단](/docs/ko/model-config#block-specific-models-or-versions)에서 설명하는 대로 차단된 모델도 실행하지 않습니다. Claude Code v2.1.283 이상이 필요합니다.
932
933* **범위**: [`Managed`](#scopes). Claude Code는 사용자, 프로젝트, 로컬 설정 및 `--settings`에서 이 키를 무시하고 경고를 표시합니다.
934* **유형**: 모델 별칭 또는 ID의 배열
935 * `"opus"`와 같은 제품군 별칭은 해당 제품군의 모든 모델을 차단합니다.
936 * `"claude-opus-5-5"`와 같은 모델 ID는 날짜 및 공급자별 ID를 포함한 모든 철자로 해당 버전을 차단합니다.
937 * `"claude-opus-5"`와 같이 부 버전이 없는 모델 ID는 Opus 5.5와 같은 이후 부 버전도 차단합니다. Opus 5만 차단하려면 `"claude-opus-5-0"`을 작성합니다.
938 * `best`, `opusplan`, `default` 항목은 무시됩니다.
939* **기본값**: 설정 해제되어 모델이 차단되지 않음
940
941이 예제는 Opus 및 Sonnet 모델을 허용하고 Opus 5.5를 차단합니다:
942
943```json managed-settings.json theme={null}
944{
945 "availableModels": ["opus", "sonnet"],
946 "deniedModels": ["claude-opus-5-5"]
947}
948```
949
950[특정 모델 또는 버전 차단](/docs/ko/model-config#block-specific-models-or-versions)을 참조하십시오.
895 951
896<h3 id="effortlevel">952<h3 id="effortlevel">
897 `effortLevel`953 `effortLevel`
898</h3>954</h3>
899 955
900저장하지 않은 모델에 대한 기본 [노력 수준](/docs/ko/model-config#adjust-effort-level)을 설정합니다. 낮은 수준은 간단한 작업에서 더 빠르고 저렴하며, 높은 수준은 복잡한 문제에 대해 더 깊이 있게 추론합니다.956저장하지 않은 모델에 대한 기본 [노력 수준](/docs/ko/model-config#adjust-effort-level)을 설정합니다. 낮은 수준은 간단한 작업에서 더 빠르고 저렴하며, 높은 수준은 복잡한 문제에서 더 깊이 있게 추론합니다.
901 957
902머신의 대화형 세션에서 `/effort low`, `medium`, `high`, 또는 `xhigh`를 실행하면, Claude Code는 이 키를 작성하는 대신 수준을 [`modelSettings`](#modelsettings) 아래의 활성 모델에 대해 저장합니다. v2.1.251 이전에는 `/effort`가 이 키를 작성했습니다.958머신의 대화형 세션에서 `/effort low`, `medium`, `high`, 또는 `xhigh`를 실행하면 Claude Code는 이 키를 작성하는 대신 [`modelSettings`](#modelsettings) 아래의 활성 모델에 대한 수준을 저장합니다. v2.1.251 이전에는 `/effort`가 이 키를 작성했습니다.
903 959
904동일한 설정 파일 내에서 Claude Code는 이 키보다 모델의 저장된 수준을 사용합니다. [`modelSettings`](#modelsettings)는 파일 간 우선순위를 나타냅니다.960동일한 설정 파일 내에서 Claude Code는 이 키보다 모델의 저장된 수준을 사용합니다. [`modelSettings`](#modelsettings)는 파일 간 우선순위를 나타냅니다.
905 961
906원격 워커에 연결된 세션에서 `/effort`는 해당 세션에만 적용됩니다. `-p` 실행 또는 Agent SDK에서도 해당 세션에만 적용됩니다. [모델의 기본 노력에 대한 보류가 적용되지 않는 한](/docs/ko/model-config#non-interactive-effort). [노력 수준 조정](/docs/ko/model-config#adjust-effort-level)은 해당 세션에만 적용되는 대화형 선택을 나열합니다. `/effort`가 인쇄하는 메시지는 어떤 일이 발생했는지 나타냅니다.962원격 워커에 연결된 세션, `-p` 실행, Agent SDK에서 `/effort`는 해당 세션에만 적용됩니다. [노력 수준 조정](/docs/ko/model-config#adjust-effort-level)은 해당 세션에만 적용되는 대화형 선택을 나열합니다. `/effort`가 인쇄하는 메시지는 어느 것이 발생했는지 나타냅니다.
907 963
908* **범위**: [`모든 파일`](#scopes)964* **범위**: [`Any file`](#scopes)
909* **유형**: 문자열, 다음 중 하나:965* **유형**: 문자열, 다음 중 하나:
910 * `"low"`: 짧고 범위가 지정되고 지연 시간에 민감한 작업(지능에 민감하지 않은)에 대한 최소 추론966 * `"low"`: 최소 추론, 짧고 범위가 지정되며 지연 시간에 민감하지만 지능에 민감하지 않은 작업용
911 * `"medium"`: 일부 지능을 절충할 수 있는 비용에 민감한 작업에 대한 토큰 사용 감소967 * `"medium"`: 일부 지능을 거래할 수 있는 비용에 민감한 작업에 대한 토큰 사용 감소
912 * `"high"`: 토큰 사용과 지능의 균형968 * `"high"`: 토큰 사용과 지능의 균형
913 * `"xhigh"`: 더 높은 토큰 지출로 더 깊은 추론969 * `"xhigh"`: 더 높은 토큰 지출로 더 깊은 추론
914* **기본값**: 설정 해제됨970* **기본값**: 설정 해제됨
915* **세션별 재정의**: `--effort`는 한 세션 동안 이 키보다 우선하며, [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ko/env-vars)은 둘 다보다 우선합니다971* **세션별 재정의**: `--effort`는 한 세션에 대해 이 키보다 우선하며, [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ko/env-vars)은 둘 다보다 우선합니다.
916 972
917```json settings.json theme={null}973```json settings.json theme={null}
918{974{
920}976}
921```977```
922 978
923Opus 4.7, Opus 4.8, Fable 5에서 Claude Code는 해당 모델의 기본 노력(조직 설정 또는 기본 제공)을 유지합니다. [노력 수준 조정](/docs/ko/model-config#adjust-effort-level)은 수준 설정의 어떤 방식이 보류를 끝내고 어떤 방식이 유지하는지 나타냅니다. 보류가 끝나면 Claude Code는 [`modelSettings`](#modelsettings)에 명시된 우선순위에 따라 노력을 해결합니다.979사용자 설정 파일 `~/.claude/settings.json`에서 이 키는 `/effort`가 모델별로 수준을 저장하기 전에 작성한 이전 형식이며, Opus 5, Fable 5.1, 이전 모델에서 이전에 적용된 곳에 계속 적용됩니다. Opus 5.5 및 이후에 릴리스된 모델은 이를 무시하고 [`modelSettings`](#modelsettings) 아래에서 수준을 저장할 때까지 자신의 기본값으로 시작합니다. 프로젝트, 로컬, 관리되는 설정 및 `--settings`에서 이 키는 모든 모델에 적용됩니다.
924 980
925<h3 id="enforceavailablemodels">981<h3 id="enforceavailablemodels">
926 `enforceAvailableModels`982 `enforceAvailableModels`
927</h3>983</h3>
928 984
929`/model` 선택기에는 적용되는 경우 [조직 기본 모델](/docs/ko/model-config#organization-default-model)로 확인되고, 그렇지 않으면 계정 유형의 기본값으로 확인되는 **기본값** 옵션이 있습니다. [`availableModels`](#availablemodels) 허용 목록은 이름을 지정할 수 있는 모델을 제한하지만, 그 자체로는 **기본값**을 그대로 두므로 **기본값**은 여전히 목록 외의 모델로 확인될 수 있습니다. 이 키는 그 간격을 닫습니다. Claude Code v2.1.175 이상이 필요합니다.985\[`/model` 선택기는 **Default** 옵션을 가지며, [`default` 모델 설정](/docs/ko/model-config#default-model-setting)은 이것이 확인되는 모델을 설명합니다. [`availableModels`](#availablemodels) 허용 목록은 이름을 지정할 수 있는 모델을 제한하지만, 기본 [접두사 일치](#availablemodelsmatch)를 사용하면 계정 유형의 기본값을 다시 매핑하지 않으므로 **Default**는 여전히 목록 외의 모델로 확인될 수 있습니다. 이 키는 그 간격을 닫습니다. Claude Code v2.1.175 이상이 필요합니다.
930 986
931조직이 관리되는 설정을 배포하면 Claude Code는 관리되는 소스에서만 이 키를 읽고 다른 파일에서는 무시합니다.987조직이 관리되는 설정을 배포할 때 Claude Code는 관리되는 소스에서만 이 키를 읽고 다른 파일에서는 무시합니다.
932 988
933* **범위**: [`모든 파일`](#scopes)989* **범위**: [`Any file`](#scopes)
934* **유형**: 부울990* **유형**: 부울
935 * `true`: **기본값**이 `availableModels` 외의 모델로 확인될 때, Claude Code는 목록의 첫 번째 사용 가능한 모델로 확인합니다991 * `true`: **Default**가 `availableModels` 외의 모델로 확인될 때 Claude Code는 이를 목록의 첫 번째 사용 가능한 모델로 확인합니다.
936 * `false`: **기본값**은 `availableModels` 외의 모델로도 평소대로 확인됩니다992 * `false`: 이 키는 **Default**가 확인되는 방식을 변경하지 않습니다.
937* **기본값**: `false`993* **기본값**: `false`
938 994
939이 예제는 명명된 선택을 Sonnet 및 Haiku 모델로 제한하고 **기본값**을 사용 가능한 첫 번째 모델로 확인하도록 합니다:995이 예제는 명명된 선택을 Sonnet 및 Haiku 모델로 제한하고 **Default**를 사용 가능한 첫 번째로 확인합니다:
940 996
941```json settings.json theme={null}997```json settings.json theme={null}
942{998{
945}1001}
946```1002```
947 1003
948`availableModels`가 설정 해제되거나 비어 있을 때 이 키는 영향을 주지 않습니다. [기본 모델에 대한 허용 목록 적용](/docs/ko/model-config#enforce-the-allowlist-for-the-default-model)을 참조하십시오. Claude Code v2.1.175 이상이 필요합니다.1004`availableModels`이 설정 해제되거나 비어 있을 때 이 키는 영향을 주지 않습니다. [Default 모델에 대한 허용 목록 적용](/docs/ko/model-config#enforce-the-allowlist-for-the-default-model)을 참조하십시오. Claude Code v2.1.175 이상이 필요합니다.
949 1005
950<h3 id="fallbackmodel">1006<h3 id="fallbackmodel">
951 `fallbackModel`1007 `fallbackModel`
952</h3>1008</h3>
953 1009
954주 모델이 과부하이거나 사용 불가능할 때 Claude Code가 순서대로 시도할 백업 모델을 이름 지정합니다. Claude Code는 체인의 다음 사용 가능한 모델로 전환하고 알림을 표시합니다. 체인이 없으면 Claude Code는 동일한 모델을 재시도한 다음 서버의 오류를 표시하고, 사용자가 재시도하거나 모델을 전환합니다.1010주 모델이 과부하되거나 사용 불가능할 때 Claude Code가 순서대로 시도할 백업 모델을 이름 지정합니다. Claude Code는 턴의 나머지 부분에 대해 체인의 다음 사용 가능한 모델로 전환하고 알림을 표시합니다. 체인이 없으면 Claude Code는 동일한 모델을 재시도한 다음 서버의 오류를 표시하며, 사용자가 재시도하거나 모델을 전환합니다.
955 1011
956전환은 폴백 모델에서 콜드 [프롬프트 캐시](/docs/ko/prompt-caching#switching-models)를 사용한 한 번의 턴을 의미합니다. 다음 메시지는 주 모델을 먼저 다시 시도합니다.1012전환은 폴백 모델에서 하나의 턴으로 콜드 [프롬프트 캐시](/docs/ko/prompt-caching#switching-models)를 의미합니다. 다음 메시지는 주 모델을 먼저 다시 시도합니다.
957 1013
958* **범위**: [`모든 파일`](#scopes)1014* **범위**: [`Any file`](#scopes)
959* **유형**: 모델 별칭 또는 ID의 배열; `"default"`는 기본 모델로 확장됩니다1015* **유형**: 모델 별칭 또는 ID의 배열; `"default"`는 기본 모델로 확장됩니다.
960* **기본값**: 설정 해제되어 실패한 요청이 다른 모델에서 재시도되지 않음1016* **기본값**: 설정 해제되어 실패한 요청이 다른 모델에서 재시도되지 않음
961* **세션별 재정의**: `--fallback-model`은 한 세션 동안 이 키보다 우선합니다1017* **세션별 재정의**: `--fallback-model`은 한 세션에 대해 이 키보다 우선합니다.
962 1018
963이 예제는 주 모델이 실패할 때 먼저 Sonnet 5를 시도한 다음 Haiku 4.5를 시도합니다:1019이 예제는 주 모델이 실패할 때 먼저 Sonnet 5를 시도한 다음 Haiku 4.5를 시도합니다:
964 1020
968}1024}
969```1025```
970 1026
971대부분의 배열 설정과 달리 이 키는 설정 파일 간에 병합되지 않습니다. 가장 높은 우선순위 파일이 전체 체인을 제공합니다. 프로젝트 파일이 `["claude-sonnet-5"]`를 설정하고 사용자 파일이 `["claude-haiku-4-5"]`를 설정하면, 체인은 `["claude-sonnet-5"]`만입니다. Claude Code는 목록에서 최대 3개의 서로 다른 허용 모델을 유지하고 나머지는 무시합니다. [폴백 모델 체인](/docs/ko/model-config#fallback-model-chains)을 참조하십시오.1027대부분의 배열 설정과 달리 이 키는 설정 파일 간에 병합되지 않습니다: 가장 높은 우선순위 파일이 정의하는 것이 전체 체인을 제공합니다. 프로젝트 파일이 `["claude-sonnet-5"]`를 설정하고 사용자 파일이 `["claude-haiku-4-5"]`를 설정하면 체인은 `["claude-sonnet-5"]`만입니다. Claude Code는 목록에서 최대 3개의 서로 다른 허용 모델을 유지하고 나머지는 무시합니다. [폴백 모델 체인](/docs/ko/model-config#fallback-model-chains)을 참조하십시오.
972 1028
973<h3 id="fastmode">1029<h3 id="fastmode">
974 `fastMode`1030 `fastMode`
975</h3>1031</h3>
976 1032
977사용 가능한 세션에 대해 [빠른 모드](/docs/ko/fast-mode)를 켭니다. 빠른 반복이나 라이브 디버깅과 같은 대화형 작업에 사용하여 토큰당 더 높은 비용으로 속도를 원합니다. 일반적으로 이 키를 직접 편집하지 않습니다. `/fast`를 실행하면 `fastMode: true`를 `~/.claude/settings.json`에 작성하고, 다시 실행하여 빠른 모드를 끄면 키를 제거합니다. 빠른 모드는 Opus 5 및 Opus 4.8에서만 실행됩니다. 다른 모델에서 켜면 Opus로 전환되고, 지원되지 않는 모델로 전환하면 꺼집니다. [빠른 모드가 켜져 있는 동안 모델 전환](/docs/ko/fast-mode#switch-models-while-fast-mode-is-on)을 참조하십시오.1033사용 가능한 세션에 대해 [빠른 모드](/docs/ko/fast-mode)를 켜서 빠른 반복 또는 라이브 디버깅과 같은 대화형 작업을 위해 토큰당 더 높은 비용으로 속도를 원합니다. 일반적으로 이 키를 직접 편집하지 않습니다: `/fast`를 실행하면 `fastMode: true`를 `~/.claude/settings.json`에 작성하고, 다시 실행하면 빠른 모드를 끕니다. 빠른 모드는 Opus 5.5, Opus 5, Opus 4.8에서만 실행됩니다: 다른 모델에서 켜면 Opus로 전환되고, 지원되지 않는 모델로 전환하면 꺼집니다. [빠른 모드가 켜져 있는 동안 모델 전환](/docs/ko/fast-mode#switch-models-while-fast-mode-is-on)을 참조하십시오.
978 1034
979* **범위**: [`모든 파일`](#scopes)1035* **범위**: [`Any file`](#scopes)
980* **유형**: 부울1036* **유형**: 부울
981 * `true`: Claude Code는 사용 가능한 세션에 대해 빠른 모드를 켭니다1037 * `true`: Claude Code는 사용 가능한 세션에 대해 빠른 모드를 켭니다.
982 * `false`: 빠른 모드는 꺼진 상태로 유지됩니다1038 * `false`: 빠른 모드는 꺼진 상태로 유지됩니다.
983* **기본값**: 설정 해제되어 빠른 모드는 꺼짐1039* **기본값**: 설정 해제되어 빠른 모드는 꺼짐
984* **세션별 재정의**: [`CLAUDE_CODE_DISABLE_FAST_MODE`](/docs/ko/env-vars)는 한 세션에 대해 빠른 모드를 끄고, 이 키는 다시 켤 수 없습니다1040* **세션별 재정의**: [`CLAUDE_CODE_DISABLE_FAST_MODE`](/docs/ko/env-vars)는 한 세션에 대해 빠른 모드를 끄고 이 키는 다시 켤 수 없습니다.
985 1041
986```json settings.json theme={null}1042```json settings.json theme={null}
987{1043{
993 `fastModePerSessionOptIn`1049 `fastModePerSessionOptIn`
994</h3>1050</h3>
995 1051
996일반적으로 `/fast`를 실행하면 [`fastMode`](#fastmode)를 사용자 설정에 저장하므로 빠른 모드는 이후의 모든 세션 시작 시 켜집니다. 이를 중지하려면 이 키를 `true`로 설정합니다. 저장된 `fastMode: true`는 더 이상 세션 시작 시 빠른 모드를 켜지 않으며, 각 사용자는 원하는 각 세션에서 `/fast`를 실행해야 합니다. Claude Code는 파일에 `fastMode` 키를 남겨두므로 이 키를 끄면 이전 동작이 복원됩니다. Team 또는 Enterprise 계획의 소유자는 [서버 관리 설정](/docs/ko/server-managed-settings)을 통해 조직 전체에 배포할 수 있습니다. 관리되는 설정이 키를 설정하면 `/fast on`은 대화형 터미널 세션 외부에서 거부되고 조직이 빠른 모드를 비활성화했다고 보고합니다. 이는 [비대화형 모드](/docs/ko/headless), [VS Code 확장](/docs/ko/vs-code), [클라우드 세션](/docs/ko/claude-code-on-the-web)을 포함합니다.1052일반적으로 `/fast`를 실행하면 [`fastMode`](#fastmode)를 사용자 설정에 저장하므로 빠른 모드는 이후의 모든 세션 시작 시 켜집니다. 이를 중지하려면 이 키를 `true`로 설정합니다: 저장된 `fastMode: true`는 더 이상 세션 시작 시 빠른 모드를 켜지 않으며, 각 사용자는 빠른 모드를 원하는 각 세션에서 `/fast`를 실행해야 합니다. Claude Code는 파일에 `fastMode` 키를 남겨두므로 이 키를 끄면 이전 동작이 복원됩니다.
997 1053
998* **범위**: [`모든 파일`](#scopes)1054Team 또는 Enterprise 계획의 소유자는 [서버 관리 설정](/docs/ko/server-managed-settings)을 통해 조직 전체에 배포할 수 있습니다. 관리되는 설정이 키를 설정할 때 `/fast on`은 대화형 터미널 세션 외부에서 거부되고 조직이 빠른 모드를 비활성화했다고 보고합니다. 이는 [비대화형 모드](/docs/ko/headless), [VS Code 확장](/docs/ko/vs-code), [클라우드 세션](/docs/ko/claude-code-on-the-web)을 포함합니다.
1055
1056* **범위**: [`Any file`](#scopes)
999* **유형**: 부울1057* **유형**: 부울
1000 * `true`: 저장된 `fastMode: true`는 더 이상 세션 시작 시 빠른 모드를 켜지 않으므로 각 사용자는 원하는 각 세션에서 `/fast`를 실행합니다. `--settings`와 함께 전달된 `fastMode: true`는 관리되는 설정이 이 키를 설정하지 않는 한 해당 세션에 대해 계산됩니다1058 * `true`: 저장된 `fastMode: true`는 더 이상 세션 시작 시 빠른 모드를 켜지 않으므로 각 사용자는 빠른 모드를 원하는 각 세션에서 `/fast`를 실행합니다. `--settings`로 전달된 `fastMode: true`는 관리되는 설정이 이 키를 설정하지 않는 한 해당 세션에 대해 계속 계산됩니다.
1001 * `false`: 저장된 `fastMode: true`는 이후의 모든 세션 시작 시 빠른 모드를 켭니다1059 * `false`: 저장된 `fastMode: true`는 이후의 모든 세션 시작 시 빠른 모드를 켭니다.
1002* **기본값**: `false`1060* **기본값**: `false`
1003 1061
1004```json settings.json theme={null}1062```json settings.json theme={null}
1013 `language`1071 `language`
1014</h3>1072</h3>
1015 1073
1016Claude가 기본적으로 영어 이외의 언어로 응답하도록 합니다. 응답에 대한 고정 목록이 없습니다. Claude Code는 값을 시스템 프롬프트에 그대로 추가하여 항상 해당 언어로 응답하도록 지시하므로 Claude가 읽을 수 있는 모든 언어 이름이 작동합니다. Claude Code는 값을 확인하지 않으므로 철자가 잘못된 이름은 오류를 생성하는 대신 작성된 대로 Claude에 도달합니다. 동일한 값은 [음성 받아쓰기](/docs/ko/voice-dictation#change-the-dictation-language)의 언어를 설정하며, 이는 [지원되는 받아쓰기 언어](/docs/ko/voice-dictation#change-the-dictation-language)의 고정 목록을 가지고 있으며, 자동 생성된 세션 제목도 설정합니다.1074Claude가 기본적으로 영어 이외의 언어로 응답하도록 합니다. 응답에 대한 고정 목록이 없습니다: Claude Code는 값을 Claude에 항상 해당 언어로 응답하도록 지시하는 것으로 그대로 전달하므로 Claude가 읽을 수 있는 모든 언어 이름이 작동합니다. Claude Code는 값을 확인하지 않으므로 잘못된 이름은 오류를 생성하는 대신 작성된 대로 Claude에 도달합니다. 동일한 값은 [음성 받아쓰기](/docs/ko/voice-dictation#change-the-dictation-language)의 언어를 설정하며, 이는 [지원되는 받아쓰기 언어](/docs/ko/voice-dictation#change-the-dictation-language)의 고정 목록을 가지며, 자동 생성된 세션 제목도 설정합니다.
1017 1075
1018* **범위**: [`모든 파일`](#scopes)1076* **범위**: [`Any file`](#scopes)
1019* **유형**: 문자열, `"japanese"`, `"spanish"`, `"french"` 등 모든 언어 이름; Claude Code는 이를 검증하지 않습니다1077* **유형**: 문자열, `"japanese"`, `"spanish"`, `"french"`와 같은 모든 언어 이름; Claude Code는 이를 검증하지 않습니다.
1020* **기본값**: 설정 해제됨; 세션 제목은 대화의 언어와 일치합니다1078* **기본값**: 설정 해제됨; 세션 제목은 대화의 언어와 일치합니다.
1021 1079
1022```json settings.json theme={null}1080```json settings.json theme={null}
1023{1081{
1029 `maxEffortLevel`1087 `maxEffortLevel`
1030</h3>1088</h3>
1031 1089
1032세션이 사용할 수 있는 [노력 수준](/docs/ko/model-config#adjust-effort-level)을 제한하고 낮은 수준을 사용 가능하게 둡니다. 더 높은 수준은 모두 제한에서 실행됩니다. `/effort`, `/model` 선택기, `--effort`, [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ko/env-vars), skill 또는 subagent의 `effort` frontmatter, 또는 모델 자체의 기본값을 포함합니다. Claude Code는 각 요청 전에 제한을 자체적으로 적용하므로 Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry를 포함한 모든 공급자에서 유지됩니다. Claude Code v2.1.267 이상이 필요합니다.1090세션이 사용할 수 있는 [노력 수준](/docs/ko/model-config#adjust-effort-level)을 제한하고 낮은 수준을 사용 가능하게 둡니다. 더 높은 수준은 모두 제한으로 실행되며, `/effort`, `/model` 선택기, `--effort`, [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ko/env-vars), 스킬 또는 subagent의 `effort` frontmatter, 또는 모델의 자체 기본값을 포함합니다. Claude Code는 각 요청 전에 제한을 자체 적용하므로 Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry를 포함한 모든 공급자에서 유지됩니다. Claude Code v2.1.267 이상이 필요합니다.
1033 1091
1034* **범위**: [`모든 파일`](#scopes). 조직에 대해 적용하려면 관리되는 설정에 배포합니다. 여러 범위가 제한을 설정할 때 가장 낮은 제한이 적용되므로 한 범위에서 설정된 제한은 다른 범위에서 높아질 수 없습니다1092* **범위**: [`Any file`](#scopes). 조직에 대해 이를 적용하려면 관리되는 설정에 배포합니다. 여러 범위가 제한을 설정할 때 가장 낮은 것이 적용되므로 한 범위에서 설정된 제한은 다른 범위에서 올릴 수 없습니다.
1035* **유형**: 문자열, `"low"`, `"medium"`, `"high"`, `"xhigh"`, 또는 `"max"` 중 하나. `"max"` 값은 제한을 설정하지 않습니다1093* **유형**: 문자열, `"low"`, `"medium"`, `"high"`, `"xhigh"`, 또는 `"max"` 중 하나. `"max"` 값은 제한을 설정하지 않습니다.
1036* **기본값**: 설정 해제되어 제한이 적용되지 않음1094* **기본값**: 설정 해제되어 제한이 적용되지 않음
1037* **ultracode에 미치는 영향**: `xhigh` 아래의 제한은 제한이 적용되는 모델에서 [ultracode](#ultracode)를 사용 불가능하게 합니다1095* **세션별 재정의**: 모델의 [`modelSettings`](#modelsettings) 항목에 `maxEffortLevel`을 추가합니다. 해당 항목은 사용자 설정 또는 [관리되는 소스](/docs/ko/managed-settings#how-claude-code-combines-managed-sources) 중 하나와 같이 둘 다 설정하는 설정 소스 내에서 모델에 대해서만 이 키를 대체합니다. 해당 소스의 제한에서 모델을 제외하려면 거기에 `"max"`를 설정합니다. Claude Code는 여전히 다른 소스의 제한을 적용합니다.
1038* **모델별 제한**: 모델의 [`modelSettings`](#modelsettings) 항목에 `maxEffortLevel`을 추가합니다. 해당 항목은 사용자 설정 또는 하나의 [관리되는 소스](/docs/ko/managed-settings#how-claude-code-combines-managed-sources)와 같이 둘 다를 설정하는 설정 소스 내에서만 이 키를 모델에 대해 대체합니다. 해당 소스의 제한에서 모델을 제외하려면 `"max"`를 설정합니다. Claude Code는 여전히 다른 소스의 제한을 적용합니다
1039 1096
1040이 예제는 모든 모델을 `medium`으로 제한하고 Sonnet 4.6을 제외합니다:1097이 예제는 모든 모델을 `medium`으로 제한하고 Sonnet 4.6을 제외합니다:
1041 1098
1050}1107}
1051```1108```
1052 1109
1053조직이 모델에 대해 [노력 제한](/docs/ko/model-config#organization-effort-limits)을 설정할 때, 두 제한 중 낮은 제한이 적용됩니다.1110조직이 모델에 대해 [노력 제한](/docs/ko/model-config#organization-effort-limits)을 설정할 때 두 제한 중 낮은 것이 적용됩니다.
1054 1111
1055<h3 id="model">1112<h3 id="model">
1056 `model`1113 `model`
1057</h3>1114</h3>
1058 1115
1059모든 새 세션이 사용할 모델을 설정하므로 매번 `/model`로 선택할 필요가 없습니다. 여기에 설정해도 세션 중에 전환하는 것을 막지 않습니다. 관리자가 [조직 기본 모델](/docs/ko/model-config#organization-default-model)을 설정하여 사용자 선택을 재정의하면, 사용자, 프로젝트 또는 로컬 설정에서 이 키를 설정해도 해당 모델을 얻습니다.1116모든 새 세션이 사용할 모델을 설정하므로 매번 `/model`로 선택할 필요가 없습니다. 여기에 설정해도 세션 중에 전환하는 것을 중지하지 않습니다. 관리자가 사용자 선택을 재정의하도록 [조직 기본 모델](/docs/ko/model-config#organization-default-model)을 설정한 경우 사용자, 프로젝트, 로컬 설정에서 이 키를 설정해도 해당 모델을 얻습니다.
1060 1117
1061* **범위**: [`모든 파일`](#scopes)1118* **범위**: [`Any file`](#scopes)
1062* **유형**: 문자열, 모델 별칭 또는 전체 모델 ID1119* **유형**: 문자열, 모델 별칭 또는 전체 모델 ID
1063* **기본값**: 설정 해제되어 Claude Code는 계정의 기본 모델을 사용합니다1120* **기본값**: 설정 해제되어 Claude Code는 계정의 기본 모델을 사용합니다.
1064* **세션별 재정의**: `--model`은 [`ANTHROPIC_MODEL`](/docs/ko/env-vars)보다 우선하며, 둘 다 한 세션 동안 이 키보다 우선합니다. 관리되는 `model`도 포함합니다. [`availableModels`](#availablemodels) 목록은 여전히 선택에 적용됩니다1121* **세션별 재정의**: `--model`은 [`ANTHROPIC_MODEL`](/docs/ko/env-vars)보다 우선하며, 둘 다 한 세션에 대해 이 키보다 우선하며, 관리되는 `model`보다도 우선합니다. [`availableModels`](#availablemodels) 목록은 여전히 선택에 적용됩니다.
1065 1122
1066```json settings.json theme={null}1123```json settings.json theme={null}
1067{1124{
1069}1126}
1070```1127```
1071 1128
1072여기의 값은 [`ANTHROPIC_DEFAULT_MODEL`](/docs/ko/model-config#set-a-default-model-for-new-sessions)을 능가합니다. Claude Code는 다른 것이 모델을 선택하지 않을 때만 사용합니다.1129여기의 값은 [`ANTHROPIC_DEFAULT_MODEL`](/docs/ko/model-config#set-a-default-model-for-new-sessions)을 능가하며, Claude Code는 다른 것이 모델을 선택하지 않을 때만 사용합니다.
1073 1130
1074<h3 id="modeloverrides">1131<h3 id="modeloverrides">
1075 `modelOverrides`1132 `modelOverrides`
1076</h3>1133</h3>
1077 1134
1078Anthropic 모델 ID를 Amazon Bedrock 추론 프로필 ARN과 같은 공급자별 모델 ID로 매핑합니다. 각 모델 선택기 항목은 공급자 API를 호출할 때 매핑된 값을 사용합니다. 관리자는 [Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry](/docs/ko/model-config#override-model-ids-per-version)에서 이를 사용하여 각 모델 버전을 특정 추론 프로필, 버전 이름 또는 배포로 라우팅하여 거버넌스, 비용 할당 또는 지역 라우팅을 수행합니다.1135Anthropic 모델 ID를 Amazon Bedrock 추론 프로필 ARN과 같은 공급자별 모델 ID로 매핑합니다. 각 모델 선택기 항목은 공급자 API를 호출할 때 매핑된 값을 사용합니다. 관리자는 [Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry](/docs/ko/model-config#override-model-ids-per-version)에서 이를 사용하여 각 모델 버전을 특정 추론 프로필, 버전 이름, 배포로 라우팅하여 거버넌스, 비용 할당, 지역 라우팅을 수행합니다.
1079 1136
1080* **범위**: [`모든 파일`](#scopes)1137* **범위**: [`Any file`](#scopes)
1081* **유형**: 모델 ID를 공급자 모델 ID로 매핑하는 객체1138* **유형**: 모델 ID를 공급자 모델 ID로 매핑하는 객체
1082* **기본값**: 설정 해제됨1139* **기본값**: 설정 해제됨
1083 1140
1091}1148}
1092```1149```
1093 1150
1094[모델 ID를 버전별로 재정의](/docs/ko/model-config#override-model-ids-per-version)를 참조하십시오.1151[버전별 모델 ID 재정의](/docs/ko/model-config#override-model-ids-per-version)를 참조하십시오.
1095 1152
1096<h3 id="modelpicker">1153<h3 id="modelpicker">
1097 `modelPicker`1154 `modelPicker`
1098</h3>1155</h3>
1099 1156
1100`/model` 선택기가 제공하는 모델을 작성한 순서대로 선택한 레이블 아래에 나열하므로 선택기는 조직이 실행하는 모델을 나열합니다. 기본 제공 라인업 이후 또는 대신합니다. 각 행의 `model`은 그대로 사용되므로 `--model`이 허용하는 모든 것을 허용합니다. `opus`와 같은 별칭, Anthropic 모델 ID, 또는 Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry, 또는 LLM 게이트웨이의 공급자 형식 ID입니다. Claude Code v2.1.242 이상이 필요합니다.1157\[`/model` 선택기가 제공하는 모델을 작성한 순서대로 선택한 레이블 아래에 나열하므로 선택기는 조직이 실행하는 모델을 나열하며, 기본 제공 라인업 후 또는 대신합니다. 각 행의 `model`은 그대로 사용되므로 `--model`이 허용하는 모든 것을 허용합니다: `opus`와 같은 별칭, Anthropic 모델 ID, 또는 Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry, LLM 게이트웨이의 공급자 형식 ID. Claude Code v2.1.242 이상이 필요합니다.
1101 1158
1102* **범위**: [`사용자 또는 관리됨`](#scopes). Claude Code는 관리되는 설정, `--settings`, 사용자 설정에서 키를 읽고 프로젝트 및 로컬 설정에서는 무시하므로 복제한 저장소가 선택기를 다시 레이블할 수 없습니다. 이 세 가지 중 가장 높은 것이 키를 설정하면 전체 라인업을 제공하며, Claude Code는 두 소스의 라인업을 결합하지 않습니다.1159* **범위**: [`User or managed`](#scopes). Claude Code는 관리되는 설정, `--settings`, 사용자 설정에서 키를 읽고 프로젝트 및 로컬 설정에서는 무시하므로 복제한 저장소가 선택기를 다시 레이블할 수 없습니다. 이 세 가지 중 가장 높은 것이 키를 설정하면 전체 라인업을 제공하며, Claude Code는 두 소스의 라인업을 결코 결합하지 않습니다.
1103* **유형**: `options` 배열과 선택적 `replaceBuiltInOptions` 부울을 포함하는 객체1160* **유형**: `options` 배열과 선택적 `replaceBuiltInOptions` 부울을 가진 객체
1104* **기본값**: 설정 해제되어 선택기는 기본 제공 라인업을 표시합니다1161* **기본값**: 설정 해제되어 선택기는 기본 제공 라인업을 표시합니다.
1105 1162
1106이 예제는 팀이 인식하는 이름 아래에 기본 제공 라인업 이후에 두 개의 Bedrock 배포를 추가합니다:1163이 예제는 두 개의 Bedrock 배포를 기본 제공 라인업 후에 추가하며, 팀이 인식하는 이름 아래에 있습니다:
1107 1164
1108```json managed-settings.json theme={null}1165```json managed-settings.json theme={null}
1109{1166{
1132 1189
1133| 필드 | 유형 | 수행 작업 |1190| 필드 | 유형 | 수행 작업 |
1134| :- | :- | :- |1191| :- | :- | :- |
1135| `options` | 필수 `model`과 선택적 `label` 및 `description`을 포함하는 각 행의 배열 | 선택기가 표시하는 행(이 순서대로), 회색으로 표시된 행은 맨 아래로 이동합니다. `label` 없이 Claude Code는 알려진 모델에 대해 기본 제공 이름으로 행을 제목으로 지정하거나 모델 ID로 지정하고, `description` 없이 일반 두 번째 줄을 작성합니다 |1192| `options` | 필수 `model` 및 선택적 `label`, `description`, `behavesAs`를 가진 행의 배열 | 선택기가 표시하는 행(이 순서로), 회색으로 표시된 행은 아래로 이동합니다. `label` 없이 Claude Code는 알려진 모델에 대해 기본 제공 이름으로 행을 제목으로 지정하거나 모델 ID로 지정하며, `description` 없이 일반 두 번째 줄을 작성합니다. |
1136| `replaceBuiltInOptions` | 부울, 기본값 `false` | 이 행만, **기본값**, 세션이 이미 사용 중인 모델의 행을 표시하려면 `true`로 설정합니다. 설정 해제하여 기본 제공 라인업 이후에 이 행을 추가합니다 |1193| `replaceBuiltInOptions` | 부울, 기본값 `false` | 이들 행만, **Default**, 세션이 이미 사용 중인 모델의 행을 표시하려면 `true`로 설정합니다. 기본 제공 라인업 후에 이들 행을 추가하려면 설정 해제합니다. |
1137 1194
1138`replaceBuiltInOptions`가 켜져 있으면 Claude Code는 다른 모든 행을 숨깁니다. 기본 제공 라인업, [`availableModels`](#availablemodels) 항목에 대해 추가하는 행, [게이트웨이 검색](/docs/ko/llm-gateway-protocol#model-discovery)이 찾은 모델, [`ANTHROPIC_CUSTOM_MODEL_OPTION`](/docs/ko/model-config#add-a-custom-model-option). 꺼져 있으면 Claude Code는 기본 제공 라인업이 이미 다루는 나열된 모델을 건너뜁니다. 레이블은 선택기가 표시하는 것을 변경하지만 Claude Code가 실행하는 모델은 변경하지 않습니다.1195\[`options`의 항목은 또한 `model` 옆에 선택적 `behavesAs` 문자열을 전달할 수 있으며, v2.1.257 이상이 필요합니다. 이를 Claude Code 버전이 이미 알고 있는 모델의 ID(예: `claude-opus-4-8`)로 설정하며, `model`이 버전보다 최신인 항목에서 설정합니다. Claude Code는 알려진 모델의 기능 및 노력 기본값을 항목에 적용하는 대신 모델을 알 수 없는 것으로 취급합니다. 항목의 레이블과 Claude Code가 요청에서 보내는 모델 ID는 변경되지 않습니다.
1139 1196
1140[`availableModels`](#availablemodels) 허용 목록은 여전히 이 행에 적용됩니다. 나열된 모델을 허용 목록에 추가하기 전에 [병합 동작](/docs/ko/model-config#merge-behavior)을 읽으십시오. 특정 모델 ID는 제품군의 와일드카드 항목을 좁힙니다. Claude Code는 선택기를 표시하기 전에 각 행을 세션에 대해 확인합니다:1197`replaceBuiltInOptions`가 켜져 있으면 Claude Code는 모든 다른 행을 숨깁니다: 기본 제공 라인업, [`availableModels`](#availablemodels) 항목에 대해 추가하는 행, [게이트웨이 검색](/docs/ko/llm-gateway-protocol#model-discovery)이 찾은 모델, [`ANTHROPIC_CUSTOM_MODEL_OPTION`](/docs/ko/model-config#add-a-custom-model-option). 꺼져 있으면 Claude Code는 기본 제공 라인업이 이미 포함하는 나열된 모델을 건너뜁니다. 레이블은 선택기가 표시하는 것을 변경하며, Claude Code가 실행하는 모델은 변경하지 않습니다.
1198
1199[`availableModels`](#availablemodels) 허용 목록은 여전히 이들 행에 적용됩니다. 나열된 모델을 허용 목록에 추가하기 전에 [병합 동작](/docs/ko/model-config#merge-behavior)을 읽으십시오: 특정 모델 ID는 제품군의 와일드카드 항목을 좁힙니다. Claude Code는 또한 선택기를 표시하기 전에 각 행을 세션에 대해 확인합니다:
1141 1200
1142* **삭제됨**: Claude Code가 제공할 수 없는 행(예: 폐기된 모델 또는 조직이 액세스할 수 없는 모델)1201* **삭제됨**: Claude Code가 제공할 수 없는 행(예: 폐기된 모델 또는 조직이 액세스할 수 없는 모델)
1143* **회색으로 표시됨**: 아직 선택할 수 없는 행(이유와 함께 표시됨)1202* **회색으로 표시됨**: 아직 선택할 수 없는 행이며, 이유와 함께 표시됩니다.
1144* **행이 생존하지 않음**: Claude Code는 기본 제공 라인업을 유지하고 허용 목록으로 필터링합니다1203* **행이 생존하지 않음**: Claude Code는 기본 제공 라인업을 유지하며, 허용 목록으로 필터링됩니다.
1145 1204
1146Claude Code는 구문 분석할 수 없는 행을 삭제하고 나머지를 유지합니다. [손상된 설정 파일 수정](/docs/ko/settings#fix-a-broken-settings-file)을 참조하십시오.1205Claude Code는 구문 분석할 수 없는 행을 삭제하고 나머지를 유지합니다. [손상된 설정 파일 수정](/docs/ko/settings#fix-a-broken-settings-file)을 참조하십시오.
1147 1206
1149 `modelPricing`1208 `modelPricing`
1150</h3>1209</h3>
1151 1210
1152조직이 지불하는 요금으로 지출을 보고합니다. 조직이 계약 요금을 가지고 있을 때 설정하므로 개발자가 보는 달러 수치가 청구서와 일치합니다. Claude Code는 `/usage`, [상태 줄](/docs/ko/statusline), Agent SDK의 `total_cost_usd`, [`--max-budget-usd`](/docs/ko/cli-reference) 제한, [OpenTelemetry](/docs/ko/monitoring-usage) 비용 메트릭 및 이벤트의 요금을 적용합니다. 요금을 제공합니다. Claude Code는 계약 또는 Claude 콘솔에서 읽지 않습니다. Claude Code v2.1.242 이상이 필요합니다.1211조직이 지불하는 요금으로 지출을 보고하며, 목록 가격 대신입니다. 조직이 계약 요금을 가지고 있을 때 설정하므로 개발자가 보는 달러 수치가 청구서와 일치합니다. Claude Code는 `/usage`, [상태 줄](/docs/ko/statusline), Agent SDK의 `total_cost_usd`, [`--max-budget-usd`](/docs/ko/cli-reference) 제한, [OpenTelemetry](/docs/ko/monitoring-usage) 비용 메트릭 및 이벤트의 요금을 적용합니다. 요금을 제공합니다: Claude Code는 계약 또는 Claude 콘솔에서 읽지 않습니다. Claude Code v2.1.242 이상이 필요합니다.
1153 1212
1154* **범위**: [`관리됨`](#scopes). 서버 관리 설정, MDM 정책, `managed-settings.json` 파일 또는 [정책 도우미](/docs/ko/managed-settings#compute-the-policy-with-a-helper-program)를 통해 키를 배포합니다. Claude Code는 사용자, 프로젝트, 로컬 설정, `--settings`, Windows의 사용자 쓰기 가능 [HKCU 레지스트리](/docs/ko/managed-settings#where-each-mechanism-stores-the-policy)에서 무시합니다. 서버 관리 설정을 사용하면 각 세션은 해당 세션의 [설정 가져오기](/docs/ko/server-managed-settings#fetch-and-caching-behavior)가 설정을 확인할 때까지 정가로 비용을 보고합니다. Claude Code를 포함하고 [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ko/env-vars)를 설정하는 호스트 애플리케이션은 SDK [`managedSettings`](/docs/ko/agent-sdk/typescript#options) 옵션을 통해 자체 테이블을 제공할 수 있으며, Claude Code는 관리되는 소스가 키를 설정하지 않을 때만 사용하고 Claude Code v2.1.246 이상에서만 사용합니다.1213* **범위**: [`Managed`](#scopes). 서버 관리 설정, MDM 정책, `managed-settings.json` 파일, [정책 도우미](/docs/ko/managed-settings#compute-the-policy-with-a-helper-program)를 통해 키를 배포합니다. Claude Code는 사용자, 프로젝트, 로컬 설정, `--settings`, Windows의 사용자 쓰기 가능 [HKCU 레지스트리](/docs/ko/managed-settings#where-each-mechanism-stores-the-policy)에서 무시합니다. 서버 관리 설정을 사용하면 각 세션은 해당 세션의 [설정 가져오기](/docs/ko/server-managed-settings#fetch-and-caching-behavior)가 설정을 확인할 때까지 목록 가격으로 비용을 보고합니다. Claude Code를 포함하고 [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ko/env-vars)를 설정하는 호스트 애플리케이션은 SDK [`managedSettings`](/docs/ko/agent-sdk/typescript#options) 옵션을 통해 자신의 테이블을 제공할 수 있으며, Claude Code는 관리되는 소스가 키를 설정하지 않을 때만 사용하며 Claude Code v2.1.246 이상에서만 사용합니다.
1155* **유형**: 선택적 `multiplier`와 선택적 `overrides` 맵을 포함하는 객체1214* **유형**: 선택적 `multiplier` 및 선택적 `overrides` 맵을 가진 객체
1156* **기본값**: 설정 해제되어 Claude Code는 호스트 애플리케이션이 테이블을 제공하지 않는 한 정가를 보고합니다1215* **기본값**: 설정 해제되어 Claude Code는 호스트 애플리케이션이 테이블을 제공하지 않는 한 목록 가격을 보고합니다.
1157 1216
1158`multiplier`만 설정하여 정액 할인 또는 인상을 하거나, `overrides`만 설정하여 모델별 요금을 설정하거나, 둘 다 설정합니다.1217단독으로 `multiplier`를 설정하여 정액 할인 또는 인상, 단독으로 `overrides`를 설정하여 모델별 요금, 또는 둘 다를 설정합니다.
1159 1218
1160이 예제는 Sonnet 4.6에 대한 계약 요금을 설정한 다음 Sonnet 행을 포함한 모든 수치를 15% 감소시킵니다:1219이 예제는 Sonnet 4.6에 대한 계약 요금을 설정한 다음 Sonnet 행을 포함한 모든 수치를 15% 감소시킵니다:
1161 1220
1175}1234}
1176```1235```
1177 1236
11781보다 큰 `multiplier`를 최대 10까지 설정하여 모든 수치를 인상합니다. 인상은 Claude Code v2.1.271 이상이 필요합니다. 이전 버전은 경고와 함께 1보다 큰 `multiplier`를 무시하고 설정의 나머지를 유지합니다.1237`multiplier`를 1 이상 10까지 설정하여 모든 수치를 인상합니다. 인상은 Claude Code v2.1.271 이상이 필요합니다. 이전 버전은 경고와 함께 1 이상의 `multiplier`를 무시하고 설정의 나머지를 유지합니다.
1179 1238
1180요금이 적용되는지 확인하는 방법을 포함한 단계는 [계약 요금으로 지출 보고](/docs/ko/costs#report-spend-at-your-contracted-rates)를 참조하십시오.1239단계(요금이 적용되는지 확인하는 방법 포함)는 [계약 요금으로 지출 보고](/docs/ko/costs#report-spend-at-your-contracted-rates)를 참조하십시오.
1181 1240
1182<span id="modelpricing-multiplier" />1241<span id="modelpricing-multiplier" />
1183 1242
1189 1248
1190| 필드 | 유형 | 수행 작업 |1249| 필드 | 유형 | 수행 작업 |
1191| :- | :- | :- |1250| :- | :- | :- |
1192| `multiplier` | 0보다 크고 최대 10인 숫자 | `overrides` 행이 다루는지 여부에 관계없이 Claude Code가 계산하는 모든 비용을 조정합니다. 1 미만은 할인, 1 초과는 인상입니다 |1251| `multiplier` | 0보다 크고 최대 10인 숫자 | Claude Code가 계산하는 모든 비용을 확장하며, `overrides` 행이 이를 포함하는지 여부와 관계없이 확장합니다. 1 미만은 할인, 1 이상은 인상입니다. |
1193| `overrides` | 모델 ID를 `input`, `output`, `cacheRead`, `cacheWrite`를 포함하는 요금 객체로 매핑하며, 각각 0\~10000 | 해당 모델의 백만 토큰당 USD 요금(모두 4개 필수). `cacheWrite`는 5분 및 1시간 캐시 쓰기를 모두 다룹니다. [어떤 모델이 행을 적용하는지](#which-models-a-modelpricing-row-applies-to) 참조 |1252| `overrides` | 모델 ID를 `input`, `output`, `cacheRead`, `cacheWrite`를 가진 요금 객체로 매핑하며, 각각 0에서 10000 | 해당 모델에 대한 백만 토큰당 USD 요금이며, 모두 4개 필수입니다. `cacheWrite`는 5분 및 1시간 캐시 쓰기를 모두 포함합니다. [어느 모델이 행을 적용하는지](#which-models-a-modelpricing-row-applies-to) 참조 |
1194 1253
1195Claude Code는 행의 요금을 작성한 대로 정확히 사용하며, 빠른 모드 할증료 또는 [미국 전용 추론 요금](https://platform.claude.com/docs/en/about-claude/pricing)을 추가하지 않습니다. `multiplier`도 설정하면 Claude Code는 행의 요금 위에 적용합니다. Claude Code는 구문 분석할 수 없는 요금이 있는 행 또는 구문 분석할 수 없는 `multiplier`를 삭제하고 나머지를 유지합니다. [손상된 설정 파일 수정](/docs/ko/settings#fix-a-broken-settings-file)을 참조하십시오.1254Claude Code는 행의 요금을 정확히 작성한 대로 사용하며, 빠른 모드 추가 요금 또는 [미국 전용 추론 요금](https://platform.claude.com/docs/en/about-claude/pricing)을 추가하지 않습니다. `multiplier`도 설정하면 Claude Code는 행의 요금 위에 이를 적용합니다. Claude Code는 구문 분석할 수 없는 요금이 있는 행 또는 구문 분석할 수 없는 `multiplier`를 삭제하고 나머지를 유지합니다. [손상된 설정 파일 수정](/docs/ko/settings#fix-a-broken-settings-file)을 참조하십시오.
1196 1255
1197<h4 id="which-models-a-modelpricing-row-applies-to">1256<h4 id="which-models-a-modelpricing-row-applies-to">
1198 `modelPricing` 행이 적용되는 모델1257 `modelPricing` 행이 적용되는 모델
1200 1259
1201Claude Code는 행의 키에서 행이 적용되는 모델을 결정합니다:1260Claude Code는 행의 키에서 행이 적용되는 모델을 결정합니다:
1202 1261
1203* **기본 제공 모델의 ID**: Claude Code 자체가 기본 제공 모델에 사용하는 키(해당 키가 `claude-sonnet-4-6`과 같은 모델 자체의 ID이든 Bedrock, Agent Platform 또는 Foundry ID이든). Claude Code는 해당 모델의 모든 날짜 스냅샷 ID 및 공급자별 ID에 행을 적용합니다.1262* **기본 제공 모델의 ID**: Claude Code 자체가 기본 제공 모델에 사용하는 키이며, 해당 키가 모델의 자체 ID(예: `claude-sonnet-4-6`) 또는 Bedrock, Agent Platform, Foundry ID인지 여부와 관계없이 사용합니다. Claude Code는 해당 모델의 모든 날짜 스냅샷 ID 및 공급자별 ID에 행을 적용합니다.
1204* **다른 키**: 게이트웨이 모델 별칭과 같이 기본 제공 모델의 ID가 아닌 키. Claude Code는 해당 하나의 ID에만 행을 적용합니다. 모델 ID가 키 중 하나와 정확히 일치하고 기본 제공 모델의 ID로 키가 지정된 행에도 해당하면 Claude Code는 정확한 일치를 사용합니다.1263* **다른 모든 키**: 기본 제공 모델의 ID가 아닌 키(예: 게이트웨이 모델 별칭). Claude Code는 해당 하나의 ID에만 행을 적용합니다. 모델 ID가 키 중 하나와 정확히 일치하고 기본 제공 모델의 ID로 키가 지정된 행 아래에도 해당할 때 Claude Code는 정확한 일치를 사용합니다.
1205* **Bedrock 애플리케이션 추론 프로필**: Claude Code가 [`modelOverrides`](#modeloverrides) 맵 또는 [`bedrock:GetInferenceProfile` 조회](/docs/ko/amazon-bedrock#iam-configuration)를 통해 프로필을 라우팅하는 모델로 확인한 후, Claude Code는 해당 모델의 행을 프로필에 적용합니다.1264* **Bedrock 애플리케이션 추론 프로필**: Claude Code가 [`modelOverrides`](#modeloverrides) 맵을 통해 또는 [`bedrock:GetInferenceProfile` 조회](/docs/ko/amazon-bedrock#iam-configuration)를 통해 프로필을 라우팅하는 모델로 확인한 후 Claude Code는 해당 모델의 행을 프로필에 적용합니다.
1206 1265
1207<h3 id="modelsettings">1266<h3 id="modelsettings">
1208 `modelSettings`1267 `modelSettings`
1210 1269
1211사용하는 각 모델에 대해 [노력 수준](/docs/ko/model-config#adjust-effort-level)을 저장합니다. Claude Code v2.1.251 이상이 필요합니다.1270사용하는 각 모델에 대해 [노력 수준](/docs/ko/model-config#adjust-effort-level)을 저장합니다. Claude Code v2.1.251 이상이 필요합니다.
1212 1271
1213머신의 대화형 세션에서 `/effort` 또는 `/model` 선택기의 노력 슬라이더로 `low`, `medium`, `high`, 또는 `xhigh`를 기본값으로 저장하면, Claude Code는 사용 중인 모델 아래에 해당 수준을 작성하므로 이 키를 직접 편집하는 경우는 거의 없습니다. [VS Code 확장의 모델 선택기](/docs/ko/vs-code#use-the-prompt-box)에서 이 수준 중 하나를 선택하면 Claude Code는 동일한 방식으로 여기에 저장합니다. [`effortLevel`](#effortlevel) 항목은 `/effort`가 해당 세션에만 적용되는 세션을 나열합니다.1272머신의 대화형 세션에서 `/effort` 또는 `/model` 선택기의 노력 슬라이더로 `low`, `medium`, `high`, 또는 `xhigh`를 기본값으로 저장할 때 Claude Code는 해당 수준을 사용 중인 모델 아래에 작성하므로 이 키를 거의 편집하지 않습니다. [VS Code 확장의 모델 선택기](/docs/ko/vs-code#use-the-prompt-box)에서 이들 수준 중 하나를 선택할 때 Claude Code는 동일한 방식으로 저장합니다. [`effortLevel`](#effortlevel) 항목은 `/effort`가 해당 세션에만 적용되는 세션을 나열합니다.
1214 1273
1215저장한 수준을 변경하거나 제거하려면 키를 직접 편집합니다.1274저장한 수준을 변경하거나 제거하려면 키를 직접 편집합니다.
1216 1275
1217여기의 모델의 `effortLevel`은 동일한 설정 파일의 최상위 [`effortLevel`](#effortlevel)보다 우선합니다. 파일 간에 Claude Code는 각 모델을 별도로 확인합니다. 해당 모델에 대해 `effortLevel`을 설정하거나 최상위 `effortLevel`을 설정하는 가장 높은 우선순위 [설정 파일](/docs/ko/settings#settings-precedence)이 결정하므로 관리되는 설정의 `effortLevel`은 사용자 설정에 저장한 수준을 능가합니다. [노력 수준 조정](/docs/ko/model-config#adjust-effort-level)은 저장된 수준을 재정의할 수 있는 다른 것(예: 시작 시 `--effort`)을 나열합니다.1276모델의 `effortLevel`은 동일한 설정 파일의 최상위 [`effortLevel`](#effortlevel)보다 우선합니다. 파일 간에 Claude Code는 각 모델을 별도로 확인합니다: 해당 모델에 대해 `effortLevel`을 설정하거나 [해당 모델에 적용되는](/docs/ko/model-config#adjust-effort-level) 최상위 `effortLevel`을 설정하는 가장 높은 우선순위 [설정 파일](/docs/ko/settings#settings-precedence)이 결정하므로 관리되는 설정의 `effortLevel`은 사용자 설정에서 저장한 수준을 능가합니다. [노력 수준 조정](/docs/ko/model-config#adjust-effort-level)은 저장된 수준을 재정의할 수 있는 다른 것(예: 시작 시 `--effort`)을 나열합니다.
1218 1277
1219한 모델의 노력을 설정하는 대신 제한하려면 해당 모델의 항목에 [`maxEffortLevel`](#maxeffortlevel) 필드를 추가합니다. 필드는 Claude Code v2.1.267 이상이 필요합니다.1278한 모델의 노력을 설정하는 대신 제한하려면 해당 모델의 항목에 [`maxEffortLevel`](#maxeffortlevel) 필드를 추가합니다. 필드는 Claude Code v2.1.267 이상이 필요합니다.
1220 1279
1221* **범위**: [`모든 파일`](#scopes)1280* **범위**: [`Any file`](#scopes)
1222* **유형**: 모델 이름을 `effortLevel` 필드(하나의 `"low"`, `"medium"`, `"high"`, 또는 `"xhigh"`), [`maxEffortLevel`](#maxeffortlevel) 필드, 또는 둘 다를 포함하는 객체로 매핑하는 객체1281* **유형**: 모델 이름을 `effortLevel` 필드(하나의 `"low"`, `"medium"`, `"high"`, 또는 `"xhigh"`), [`maxEffortLevel`](#maxeffortlevel) 필드, 또는 둘 다를 가진 객체로 매핑하는 객체
1223* **기본값**: 설정 해제됨1282* **기본값**: 설정 해제됨
1224 1283
1225Claude Code는 각 항목을 `claude-opus-5`와 같은 모델의 정규 이름 아래에 작성하고 해당 모델의 별칭, 날짜 접미사, `[1m]`, 인식된 공급자별 ID를 동일한 항목과 일치시킵니다.1284Claude Code는 각 항목을 `claude-opus-5-5`와 같은 모델의 정규 이름 아래에 작성하며, 해당 모델의 별칭, 날짜 접미사, `[1m]`, 인식된 공급자별 ID를 동일한 항목과 일치시킵니다.
1226 1285
1227이 예제는 Opus 5를 `medium`으로 유지하면서 다른 모델은 자신의 저장된 또는 기본 수준을 사용합니다:1286이 예제는 Opus 5.5를 `high`로 유지하면서 다른 모델은 자신의 저장되거나 기본 수준을 사용합니다:
1228 1287
1229```json settings.json theme={null}1288```json settings.json theme={null}
1230{1289{
1231 "modelSettings": {1290 "modelSettings": {
1232 "claude-opus-5": {1291 "claude-opus-5-5": {
1233 "effortLevel": "medium"1292 "effortLevel": "high"
1234 }1293 }
1235 }1294 }
1236}1295}
1237```1296```
1238 1297
1239`/effort auto`를 실행하여 사용 중인 모델에 대해 저장된 수준을 지웁니다. Claude Code는 다른 항목과 최상위 `effortLevel`을 그대로 둡니다.1298사용 중인 모델에 대해 저장된 수준을 지우려면 `/effort auto`를 실행합니다. Claude Code는 다른 항목과 파일의 모든 최상위 `effortLevel`을 그대로 둡니다.
1240 1299
1241<h3 id="outputstyle">1300<h3 id="outputstyle">
1242 `outputStyle`1301 `outputStyle`
1243</h3>1302</h3>
1244 1303
1245[출력 스타일](/docs/ko/output-styles)을 이름으로 선택합니다. 출력 스타일은 Claude의 역할, 톤, 출력 형식을 변경하는 저장된 지시 집합입니다. 기본 제공 Explanatory 및 Learning 스타일 또는 직접 작성한 스타일입니다.1304[출력 스타일](/docs/ko/output-styles)을 이름으로 선택합니다. 출력 스타일은 Claude의 역할, 톤, 출력 형식을 변경하는 저장된 지침 집합이며, 기본 제공 Explanatory 및 Learning 스타일 또는 직접 작성한 스타일입니다.
1246 1305
1247세션 중에 이 키를 변경하면 Claude는 다음 메시지부터 새 스타일을 사용합니다. 해당 메시지가 프롬프트 캐싱에서 비용이 얼마인지는 [출력 스타일 변경](/docs/ko/prompt-caching#changing-output-style)을 참조하십시오. v2.1.251 이전에는 `/clear`를 실행하거나 새 세션을 시작한 후에만 편집이 적용되었습니다.1306세션 중에 이 키를 변경하면 Claude는 다음 메시지부터 새 스타일을 사용합니다. 해당 메시지가 프롬프트 캐싱에서 비용이 얼마인지는 [출력 스타일 변경](/docs/ko/prompt-caching#changing-output-style)을 참조하십시오. v2.1.251 이전에는 `/clear`를 실행하거나 새 세션을 시작한 후에만 편집이 적용되었습니다.
1248 1307
1249* **범위**: [`모든 파일`](#scopes)1308* **범위**: [`Any file`](#scopes)
1250* **유형**: 문자열, [기본 제공](/docs/ko/output-styles#built-in-output-styles) 또는 [사용자 정의](/docs/ko/output-styles#create-a-custom-output-style) 출력 스타일의 이름1309* **유형**: 문자열, [기본 제공](/docs/ko/output-styles#built-in-output-styles) 또는 [사용자 정의](/docs/ko/output-styles#create-a-custom-output-style) 출력 스타일의 이름
1251* **기본값**: 설정 해제되어 Claude Code는 기본 스타일을 사용합니다1310* **기본값**: 설정 해제되어 Claude Code는 기본 스타일을 사용합니다.
1252 1311
1253이 예제는 작업 간에 교육 통찰력을 추가하는 기본 제공 Explanatory 스타일을 선택합니다:1312이 예제는 기본 제공 Explanatory 스타일을 선택하며, 작업 사이에 교육 통찰력을 추가합니다:
1254 1313
1255```json settings.json theme={null}1314```json settings.json theme={null}
1256{1315{
1262 `promptCacheTtl`1321 `promptCacheTtl`
1263</h3>1322</h3>
1264 1323
1265[프롬프트 캐시](/docs/ko/prompt-caching)가 주 대화를 유지하는 기간을 선택합니다. 이 키는 대화형, `-p`, Agent SDK 턴과 함께 Claude Code가 인라인으로 실행하는 도우미에 적용됩니다. 1시간 수명은 더 긴 휴식 시간 동안 캐시를 따뜻하게 유지하고, API는 [각 캐시 쓰기를 5분 수명보다 더 높은 요금으로 청구합니다](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing). Claude Code v2.1.242 이상이 필요합니다.1324[프롬프트 캐시](/docs/ko/prompt-caching)가 주 대화를 유지하는 기간을 선택합니다. 이 키는 대화형, `-p`, Agent SDK 턴과 함께 Claude Code가 인라인으로 실행하는 도우미에 적용됩니다. 1시간 수명은 더 긴 휴식 시간에 캐시를 따뜻하게 유지하며, API는 [각 캐시 쓰기를 5분 수명보다 더 높은 요금으로 청구합니다](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing). Claude Code v2.1.242 이상이 필요합니다.
1266 1325
1267* **범위**: [`모든 파일`](#scopes)1326* **범위**: [`Any file`](#scopes)
1268* **유형**: 문자열, 다음 중 하나:1327* **유형**: 문자열, 다음 중 하나:
1269 * `"5m"`: 캐시는 5분 동안 유지됩니다1328 * `"5m"`: 캐시는 5분 동안 유지됩니다.
1270 * `"1h"`: 캐시는 1시간 동안 유지됩니다1329 * `"1h"`: 캐시는 1시간 동안 유지됩니다.
1271* **기본값**: 설정 해제되어 각 주 대화 요청은 [기본 수명](/docs/ko/prompt-caching#which-ttl-each-request-gets)을 얻습니다1330* **기본값**: 설정 해제되어 각 주 대화 요청은 [기본 수명](/docs/ko/prompt-caching#which-ttl-each-request-gets)을 얻습니다.
1272* **세션별 재정의**: [`FORCE_PROMPT_CACHING_5M`](/docs/ko/env-vars)는 다른 모든 것보다 우선하고, [`CLAUDE_CODE_PROMPT_CACHE_TTL`](/docs/ko/env-vars), 그 다음 이 키, 마지막으로 [`ENABLE_PROMPT_CACHING_1H`](/docs/ko/env-vars)1331* **세션별 재정의**: [`FORCE_PROMPT_CACHING_5M`](/docs/ko/env-vars)은 모든 것보다 우선하며, 그 다음 [`CLAUDE_CODE_PROMPT_CACHE_TTL`](/docs/ko/env-vars), 그 다음 이 키, 마지막으로 [`ENABLE_PROMPT_CACHING_1H`](/docs/ko/env-vars)
1273 1332
1274이 예제는 주 대화를 1시간 수명으로 유지하고 subagents를 5분으로 둡니다:1333이 예제는 주 대화를 1시간 수명으로 유지하고 subagents를 5분으로 둡니다:
1275 1334
1280}1339}
1281```1340```
1282 1341
1283각 수명의 비용은 [캐시 수명](/docs/ko/prompt-caching#cache-lifetime)을 참조하십시오.1342각 수명이 비용이 얼마인지는 [캐시 수명](/docs/ko/prompt-caching#cache-lifetime)을 참조하십시오.
1284 1343
1285<h3 id="showthinkingsummaries">1344<h3 id="showthinkingsummaries">
1286 `showThinkingSummaries`1345 `showThinkingSummaries`
1288 1347
1289대화형 세션에서 Claude의 [확장 사고](/docs/ko/model-config#extended-thinking) 요약을 봅니다. `Ctrl+O`로 사고를 확장할 때 전체 요약을 원하면 설정합니다. 설정 해제되거나 `false`일 때 Anthropic API는 사고 블록을 수정하고 Claude Code는 축소된 스텁을 표시합니다. 타사 공급자는 수정하지 않습니다.1348대화형 세션에서 Claude의 [확장 사고](/docs/ko/model-config#extended-thinking) 요약을 봅니다. `Ctrl+O`로 사고를 확장할 때 전체 요약을 원하면 설정합니다. 설정 해제되거나 `false`일 때 Anthropic API는 사고 블록을 수정하고 Claude Code는 축소된 스텁을 표시합니다. 타사 공급자는 수정하지 않습니다.
1290 1349
1291* **범위**: [`모든 파일`](#scopes)1350* **범위**: [`Any file`](#scopes)
1292* **유형**: 부울1351* **유형**: 부울
1293 * `true`: `Ctrl+O`로 사고를 확장할 때 전체 사고 요약을 봅니다1352 * `true`: `Ctrl+O`로 사고를 확장할 때 전체 사고 요약을 봅니다.
1294 * `false`: Anthropic API는 사고 블록을 수정하고 Claude Code는 축소된 스텁을 표시합니다1353 * `false`: Anthropic API는 사고 블록을 수정하고 Claude Code는 축소된 스텁을 표시합니다.
1295* **기본값**: `false`1354* **기본값**: `false`
1296 1355
1297```json settings.json theme={null}1356```json settings.json theme={null}
1306 `subagentPromptCacheTtl`1365 `subagentPromptCacheTtl`
1307</h3>1366</h3>
1308 1367
1309[프롬프트 캐시](/docs/ko/prompt-caching)가 Claude Code가 주 대화 외부에서 만드는 요청을 유지하는 기간을 선택합니다. 이 키는 [subagents](/docs/ko/sub-agents), [workflows](/docs/ko/workflows), Claude Code의 자체 배경 및 도우미 요청(예: 압축 및 세션 제목)에 적용됩니다. 1시간 수명은 더 긴 휴식 시간 동안 캐시를 따뜻하게 유지하고, API는 [각 캐시 쓰기를 5분 수명보다 더 높은 요금으로 청구합니다](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing). Claude Code v2.1.242 이상이 필요합니다.1368[프롬프트 캐시](/docs/ko/prompt-caching)가 주 대화 외부에서 Claude Code가 만드는 요청을 유지하는 기간을 선택합니다. 이 키는 [subagents](/docs/ko/sub-agents), [workflows](/docs/ko/workflows), Claude Code의 자체 배경 및 도우미 요청(예: 압축 및 세션 제목)에 적용됩니다. 1시간 수명은 더 긴 휴식 시간에 캐시를 따뜻하게 유지하며, API는 [각 캐시 쓰기를 5분 수명보다 더 높은 요금으로 청구합니다](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing). Claude Code v2.1.242 이상이 필요합니다.
1310 1369
1311* **범위**: [`모든 파일`](#scopes)1370* **범위**: [`Any file`](#scopes)
1312* **유형**: 문자열, 다음 중 하나:1371* **유형**: 문자열, 다음 중 하나:
1313 * `"5m"`: 캐시는 5분 동안 유지됩니다1372 * `"5m"`: 캐시는 5분 동안 유지됩니다.
1314 * `"1h"`: 캐시는 1시간 동안 유지됩니다1373 * `"1h"`: 캐시는 1시간 동안 유지됩니다.
1315* **기본값**: 설정 해제되어 이러한 각 요청은 [기본 수명](/docs/ko/prompt-caching#which-ttl-each-request-gets)을 얻습니다1374* **기본값**: 설정 해제되어 이들 각 요청은 [기본 수명](/docs/ko/prompt-caching#which-ttl-each-request-gets)을 얻습니다.
1316* **세션별 재정의**: [`FORCE_PROMPT_CACHING_5M`](/docs/ko/env-vars)는 다른 모든 것보다 우선하고, [`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`](/docs/ko/env-vars), 그 다음 이 키, 그 다음 [`ENABLE_PROMPT_CACHING_1H`](/docs/ko/env-vars)(모든 요청에서 1시간 수명을 요청). subagent의 자체 frontmatter 값이 순위에서 어디에 있는지는 [TTL을 직접 선택](/docs/ko/prompt-caching#choose-the-ttl-yourself)을 참조하십시오1375* **세션별 재정의**: [`FORCE_PROMPT_CACHING_5M`](/docs/ko/env-vars)은 모든 것보다 우선하며, 그 다음 [`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`](/docs/ko/env-vars), 그 다음 이 키, 그 다음 [`ENABLE_PROMPT_CACHING_1H`](/docs/ko/env-vars)(모든 요청에서 1시간 수명을 요청). subagent의 자체 frontmatter 값이 어디에 순위가 지정되는지는 [TTL을 직접 선택](/docs/ko/prompt-caching#choose-the-ttl-yourself)을 참조하십시오.
1317 1376
1318이 예제는 subagents 및 주 대화 외부의 다른 요청에 1시간 수명을 제공합니다:1377이 예제는 subagents 및 주 대화 외부의 다른 요청에 1시간 수명을 제공합니다:
1319 1378
1323}1382}
1324```1383```
1325 1384
1326이 키는 [`promptCacheTtl`](#promptcachettl)이 다루지 않는 요청을 다루므로 Claude Code가 만드는 모든 요청에 대해 수명을 선택하려면 둘 다 설정합니다. subagent의 캐시가 주 대화의 캐시와 어떻게 다른지는 [Subagents 및 캐시](/docs/ko/prompt-caching#subagents-and-the-cache)를 참조하십시오.1385이 키는 [`promptCacheTtl`](#promptcachettl)이 포함하지 않는 요청을 포함하므로 Claude Code가 만드는 모든 요청에 대해 수명을 선택하려면 둘 다 설정합니다. subagent의 캐시가 주 대화의 캐시와 어떻게 다른지는 [Subagents 및 캐시](/docs/ko/prompt-caching#subagents-and-the-cache)를 참조하십시오.
1327 1386
1328<h3 id="switchmodelsonflag">1387<h3 id="switchmodelsonflag">
1329 `switchModelsOnFlag`1388 `switchModelsOnFlag`
1330</h3>1389</h3>
1331 1390
1332[안전 분류기가 요청에 플래그를 지정할](/docs/ko/model-config#automatic-model-fallback) 때 어떤 일이 발생하는지 선택합니다. 폴백 모델로 전환하고 계속하거나, 전환과 프롬프트 편집 중에서 선택할 수 있도록 일시 중지합니다.1391[안전 분류기가 요청에 플래그를 지정](/docs/ko/model-config#automatic-model-fallback)할 때 발생하는 상황을 선택합니다: 폴백 모델로 전환하고 계속하거나, 전환과 프롬프트 편집 중에서 선택할 수 있도록 일시 중지합니다.
1333 1392
1334* **범위**: [`모든 파일`](#scopes). `/config`에 **메시지가 플래그될 때 모델 전환**으로 나타납니다.1393* **범위**: [`Any file`](#scopes). `/config`에 **메시지에 플래그가 지정되면 모델 전환**으로 나타납니다.
1335* **유형**: 부울1394* **유형**: 부울
1336 * `true`: Claude Code는 폴백 모델로 전환하고 계속합니다1395 * `true`: Claude Code는 폴백 모델로 전환하고 계속합니다.
1337 * `false`: 대화형 세션에서 Claude Code는 일시 중지하여 전환과 프롬프트 편집 중에서 선택할 수 있습니다. 대화 상자를 표시할 수 없는 `-p` 실행과 같은 곳에서는 플래그된 요청이 오류로 끝납니다1396 * `false`: 대화형 세션에서 Claude Code는 전환과 프롬프트 편집 중에서 선택할 수 있도록 일시 중지합니다. 대화 상자를 표시할 수 없는 곳(예: `-p` 실행)에서는 플래그된 요청이 오류로 끝납니다.
1338* **기본값**: `true`, 자동으로 전환1397* **기본값**: `true`, 자동으로 전환
1339 1398
1340```json settings.json theme={null}1399```json settings.json theme={null}
1349 `ultracode`1408 `ultracode`
1350</h3>1409</h3>
1351 1410
1352[ultracode](/docs/ko/workflows#let-claude-decide-with-ultracode)를 사용하여 세션을 시작합니다. 켜져 있으면 Claude는 요청할 때까지 기다리는 대신 각 실질적인 작업에 대해 워크플로우를 계획합니다. Claude는 [동적 워크플로우](/docs/ko/workflows)가 활성화되고, 모델이 `xhigh` 노력을 지원하고, [노력 제한](/docs/ko/model-config#organization-effort-limits)이 `xhigh` 아래에 적용되지 않을 때만 워크플로우를 계획합니다. 어느 쪽이든 `ultracode: true`는 세션을 `xhigh` 노력으로 실행하거나 노력 제한이 더 낮을 때 제한에서 실행합니다. Claude Code는 이 키를 읽지만 절대 작성하지 않습니다. `/effort ultracode`는 현재 세션에만 ultracode를 켭니다.1411[ultracode](/docs/ko/workflows#let-claude-decide-with-ultracode)를 켜서 세션을 시작합니다. 켜져 있으면 Claude는 사용자가 요청할 때까지 기다리는 대신 각 실질적인 작업에 대해 워크플로우를 계획합니다. Claude는 [동적 워크플로우](/docs/ko/workflows)가 사용자에게 활성화되고 모델이 `xhigh` 노력을 지원할 때만 워크플로우를 계획합니다. 키는 세션의 노력 수준을 변경하지 않습니다: ultracode는 세션이 사용하는 어느 수준에서든 실행됩니다. Claude Code는 이 키를 읽지만 절대 작성하지 않습니다: `/effort ultracode`는 현재 세션에만 ultracode를 켭니다.
1353 1412
1354* **범위**: [`모든 파일`](#scopes)1413* **범위**: [`Any file`](#scopes)
1355* **유형**: 부울1414* **유형**: 부울
1356 * `true`: 세션은 `xhigh` 노력으로 시작하고, 동적 워크플로우가 활성화되고, 모델이 `xhigh`를 지원하고, 노력 제한이 `xhigh` 아래에 없을 때 ultracode가 켜집니다1415 * `true`: 동적 워크플로우가 사용자에게 활성화되고 모델이 `xhigh` 노력을 지원할 때 세션은 ultracode가 켜진 상태로 시작합니다.
1357 * `false`: 세션은 ultracode가 꺼진 상태로 시작합니다1416 * `false`: 세션은 ultracode가 꺼진 상태로 시작합니다.
1358* **기본값**: 설정 해제되어 ultracode는 꺼짐1417* **기본값**: 설정 해제되어 ultracode는 꺼짐
1359* **세션별 재정의**: `/effort ultracode`는 이 키 없이 한 세션에 대해 ultracode를 켭니다. `--effort ultracode`도 마찬가지이며, Claude Code v2.1.203 이상이 필요합니다1418* **세션별 재정의**: `/effort ultracode`는 이 키 없이 한 세션에 대해 ultracode를 켭니다. `--effort ultracode` 플래그도 한 세션에 대해 켜며, `xhigh` 노력에서 켜며, Claude Code v2.1.203 이상이 필요합니다.
1360 1419
1361```json settings.json theme={null}1420```json settings.json theme={null}
1362{1421{
1364}1423}
1365```1424```
1366 1425
1367Ultracode는 세션을 `xhigh` 노력으로 실행하고 `effortLevel` 및 [`modelSettings`](#modelsettings) 항목보다 우선합니다. `xhigh` 아래의 [노력 제한](/docs/ko/model-config#organization-effort-limits)(예: [`maxEffortLevel`](#maxeffortlevel) 설정)이 모델에 적용되면 세션은 대신 제한에서 실행되고 ultracode는 꺼집니다. Claude는 자체적으로 워크플로우를 계획하지 않으며, `/effort`는 `ultracode`를 제공하지 않습니다. Agent SDK `apply_flag_settings` 제어 요청도 키를 허용합니다.1426세션의 노력 수준은 [`effortLevel`](#effortlevel), [`modelSettings`](#modelsettings), 다른 [노력 소스](/docs/ko/model-config#adjust-effort-level)에서 나오며, [노력 제한](/docs/ko/model-config#organization-effort-limits)(예: [`maxEffortLevel`](#maxeffortlevel))은 ultracode를 끄지 않고 해당 수준을 낮춥니다. 이것과 `/effort ultracode off` 형식은 Claude Code v2.1.284 이상이 필요합니다. v2.1.284 이전에는 `ultracode: true`가 세션을 `xhigh` 노력으로 실행했으며, `xhigh` 아래의 노력 제한은 ultracode를 꺼진 상태로 유지했습니다. Agent SDK `apply_flag_settings` 제어 요청도 키를 허용합니다.
1368 1427
1369<h2 id="permission-settings">1428<h2 id="permission-settings">
1370 권한 설정1429 권한 설정
1487 `useAutoModeDuringPlan`1546 `useAutoModeDuringPlan`
1488</h3>1547</h3>
1489 1548
1490Claude Code가 계획 모드에서 셸 명령을 검토하기 위해 자동 모드 분류기를 사용할지 여부를 선택합니다. 기본값 `true`를 사용하면 자동 모드를 사용할 수 있고 프롬프트가 표시되지 않을 때 계획 중에 분류기가 각 명령을 검토합니다. 기본 제공 읽기 전용 집합 외부의 모든 명령에 대해 권한 프롬프트를 받으려면 `false`로 설정합니다. `/config`에 **계획 중 자동 모드 사용**으로 나타납니다.1549Claude Code가 계획 모드에서 셸 명령을 검토하기 위해 자동 모드 분류기를 사용할지 여부를 선택합니다. 기본값 `true`를 사용하면 자동 모드를 사용할 수 있고 프롬프트가 표시되지 않을 때 계획 중에 분류기가 각 명령을 검토합니다. [중요 경로 제거](/docs/ko/permission-modes#critical-paths)를 제외하고 기본 제공 읽기 전용 집합 외부의 모든 명령에 대해 권한 프롬프트를 받으려면 `false`로 설정합니다. `/config`에 **계획 중 자동 모드 사용**으로 나타납니다.
1491 1550
1492* **범위**: [`User, local, or managed`](#scopes). 저장소는 이를 끌 수 없습니다.1551* **범위**: [`User, local, or managed`](#scopes). 저장소는 이를 끌 수 없습니다.
1493* **유형**: Boolean1552* **유형**: Boolean
1494 * `true`: 설정되지 않은 것과 동일합니다. 자동 모드를 사용할 수 있으면 분류기는 계획 중에 각 셸 명령을 검토하고 이에 대해 프롬프트하지 않습니다. 이러한 파일 중 하나의 `false`는 여전히 이를 끕니다1553 * `true`: 설정되지 않은 것과 동일합니다. 자동 모드를 사용할 수 있으면 분류기는 계획 중에 각 셸 명령을 검토하고 [중요 경로 제거](/docs/ko/permission-modes#critical-paths)를 제외하고 이에 대해 프롬프트하지 않습니다. 이러한 파일 중 하나의 `false`는 여전히 이를 끕니다
1495 * `false`: 기본 제공 읽기 전용 집합 외부의 모든 명령에 대해 권한 프롬프트를 받습니다1554 * `false`: 기본 제공 읽기 전용 집합 외부의 모든 명령에 대해 권한 프롬프트를 받습니다
1496* **기본값**: `true`1555* **기본값**: `true`
1497 1556
1617 `permissions.blockReadsOutsideWorkingDirectories`1676 `permissions.blockReadsOutsideWorkingDirectories`
1618</h3>1677</h3>
1619 1678
1620Claude가 Read, Grep, Glob 및 LSP 도구를 사용하여 세션의 [작업 디렉토리](/docs/ko/permissions#working-directories) 외부의 경로를 읽지 못하도록 중지합니다. `bypassPermissions`를 포함한 모든 권한 모드에서 이를 수행합니다. Claude Code가 인식하는 `cat` 같은 파일 명령을 통해 일치하는 경로를 읽는 Bash 명령은 자동 모드 및 `bypassPermissions` 모드에서도 프롬프트합니다. Claude Code v2.1.257 이상이 필요합니다.1679Claude의 파일 도구가 모든 권한 모드에서 [작업 디렉토리](/docs/ko/permissions#working-directories) 외부의 읽기를 거부하도록 합니다. `bypassPermissions`를 포함한 모든 권한 모드에서 이를 수행합니다. Claude Code는 해당 경로에서 `Read`, `Grep`, `Glob` 및 `LSP` 호출을 거부하고 Claude에 `/add-dir`으로 디렉토리를 추가하도록 요청합니다. Claude Code 자체가 필요한 파일은 읽을 수 있습니다. 예를 들어 `~/.claude/` 아래의 기술, 플러그인, 규칙, 에이전트, 명령 및 `CLAUDE.md` 메모리 파일입니다. Claude Code v2.1.257 이상이 필요합니다.
1680
1681Claude Code는 셸 명령을 같은 방식으로 거부하지 않습니다:
1682
1683* [어떤 모드도 자동 승인하지 않는 작업](/docs/ko/permission-modes#actions-no-mode-auto-approves)은 해당 경로를 읽는 셸 명령이 프롬프트하는 경우를 다룹니다
1684* [블록 아래의 샌드박스된 명령](#sandboxed-commands-under-the-block)은 샌드박스된 명령이 읽을 수 있는 것을 다룹니다
1621 1685
1622셸 파서가 추적할 수 없는 Bash 명령(예: 두 번 이상 디렉토리를 변경하거나 부셸을 실행하는 명령)은 자동 모드 및 `bypassPermissions` 모드에서도 프롬프트합니다. 명령이 작업 디렉토리 외부의 경로를 명명하지 않아도 프롬프트가 나타납니다. 이 프롬프트는 명령이 [샌드박스](/docs/ko/sandboxing)에서 실행되고 샌드박스가 블록을 적용할 때는 적용되지 않습니다.1686셸 파서가 추적할 수 없는 Bash 명령(예: 두 번 이상 디렉토리를 변경하거나 부셸을 실행하는 명령)은 자동 모드 및 `bypassPermissions` 모드에서도 프롬프트합니다. 명령이 작업 디렉토리 외부의 경로를 명명하지 않아도 프롬프트가 나타납니다. 이 프롬프트는 명령이 [샌드박스](/docs/ko/sandboxing)에서 실행되고 샌드박스가 블록을 적용할 때는 적용되지 않습니다.
1623 1687
1624Claude Code는 또한 [자동 모드의 작업 디렉토리 외부의 첫 번째 읽기 전 프롬프트](/docs/ko/permission-modes#first-read-outside-the-working-directories)에서 이러한 읽기를 차단하도록 선택할 때 여기에 `true`를 작성합니다.1688Claude Code는 또한 [자동 모드의 작업 디렉토리 외부의 첫 번째 읽기 전 프롬프트](/docs/ko/permission-modes#first-read-outside-the-working-directories)에서 이러한 읽기를 차단하도록 선택할 때 여기에 `true`를 작성합니다.
1625 1689
1626* **범위**: [`Any file`](#scopes). 모든 설정 소스가 `true`를 설정하면 블록이 적용되므로 저장소의 체크인된 파일은 프로젝트에 대해 블록을 켤 수 있지만 설정한 블록을 해제할 수 없습니다.1690* **범위**: [`Any file`](#scopes). 모든 파일의 `true`가 적용되므로 저장소는 자신에 대해 블록을 켤 수 있지만 설정한 블록을 해제할 수 없습니다.
1627* **유형**: Boolean1691* **유형**: Boolean
1628 * `true`: 작업 디렉토리 외부의 파일 읽기가 차단됩니다1692 * `true`: Claude의 파일 도구가 작업 디렉토리 외부의 읽기를 거부합니다
1629 * `false`: 설정되지 않은 것과 동일합니다. 다른 설정 파일의 `true`는 여전히 차단합니다1693 * `false`: 설정되지 않은 것과 동일합니다. 다른 파일의 `true`는 여전히 블록을 적용합니다
1630* **기본값**: 설정되지 않음. 작업 디렉토리 외부의 읽기는 권한 모드 및 규칙을 따릅니다1694* **기본값**: 설정되지 않음. 작업 디렉토리 외부의 읽기는 [권한 모드](/docs/ko/permission-modes)를 따릅니다
1631 1695
1632```json settings.json theme={null}1696```json settings.json theme={null}
1633{1697{
1637}1701}
1638```1702```
1639 1703
1640저장소의 체크인된 설정 파일만 디렉토리를 추가하면 블록은 여전히 거기의 읽기에 적용됩니다. [`autoMemoryDirectory`](#automemorydirectory)가 프로젝트의 `.claude/settings.json`에서 오거나 [저장소 제공으로 취급되는](/docs/ko/permissions#when-your-local-settings-file-needs-trust) `.claude/settings.local.json`에서 올 때 Claude Code는 해당 디렉토리에서 [자동 메모리](/docs/ko/memory#storage-location)를 로드하지 않고 이를 저장하지 않습니다. Claude Code 자체가 필요한 파일은 읽을 수 있습니다. 예를 들어 `~/.claude/` 아래의 기술, 플러그인, 규칙, 에이전트, 명령 및 `CLAUDE.md` 메모리 파일입니다.1704`--add-dir`, `/add-dir` 또는 사용자 또는 관리되는 설정의 `additionalDirectories`로 추가한 디렉토리는 블록의 작업 디렉토리로 계산됩니다. 저장소 설정에만 추가된 디렉토리는 계산되지 않습니다: `.claude/settings.json`의 디렉토리, 그리고 git이 파일을 추적되지 않은 것으로 보고하지 않는 한 `.claude/settings.local.json`의 디렉토리입니다. git 저장소가 아닌 디렉토리에서 또는 git이 파일을 추적할 때 Claude Code는 `.claude/settings.local.json`을 저장소 설정으로 취급하므로 유지하려는 디렉토리를 사용자 설정에 넣으십시오.
1705
1706[`autoMemoryDirectory`](#automemorydirectory)가 프로젝트의 `.claude/settings.json`에서 오거나 [저장소 제공으로 취급되는](/docs/ko/permissions#when-your-local-settings-file-needs-trust) `.claude/settings.local.json`에서 올 때 Claude Code는 해당 디렉토리에서 [자동 메모리](/docs/ko/memory#storage-location)를 로드하지 않고 이를 저장하지 않습니다.
1707
1708블록을 해제하려면 이를 설정하는 모든 설정 파일에서 키를 제거한 다음 새 세션을 시작하십시오.
1641 1709
1642[샌드박스](/docs/ko/sandboxing)가 켜져 있으면 블록은 또한 작업 디렉토리 외부의 홈 디렉토리 및 마운트된 볼륨 루트에 대한 샌드박스된 명령 읽기 액세스를 거부합니다. [샌드박스 외부에서 실행](/docs/ko/sandboxing#the-unsandboxed-retry-escape-hatch)하기 위해 승인이 필요한 재시도는 `bypassPermissions` 모드에서도 프롬프트합니다. 도구가 `~/.gitconfig` 같은 홈 디렉토리에서 읽는 파일은 나머지와 함께 거부됩니다. 도구가 필요할 때 [`sandbox.filesystem.allowRead`](#sandbox-filesystem-allowread)로 특정 경로를 다시 열어야 합니다.1710<h4 id="sandboxed-commands-under-the-block">
1711 블록 아래의 샌드박스된 명령
1712</h4>
1713
1714[샌드박싱](/docs/ko/sandboxing)이 켜져 있으면 블록은 또한 샌드박스된 명령을 다룹니다. Claude Code는 홈 디렉토리 및 사용자 파일을 보유하는 다른 루트에 대한 읽기 액세스를 거부합니다: `/Users`, `/home`, `/root`, `/Volumes`, `/mnt`, `/media`, `/run/media` 및 `/srv`. 그런 다음 작업 디렉토리, [Claude Code가 세션에서 생성하는 worktrees](/docs/ko/worktrees), 세션 임시 디렉토리 및 명령이 필요한 `~/.claude`의 부분(예: 기술 및 플러그인)을 다시 엽니다. 블록이 적용되는 동안 저장소 설정의 `allowRead` 및 `allowWrite` 항목은 계산되지 않습니다.
1643 1715
1644세션의 작업 디렉토리가 Claude Code가 세션 중간에 들어간 것을 포함한 연결된 [git worktree](/docs/ko/worktrees)일 때 저장소의 공통 `.git` 디렉토리는 샌드박스된 명령에 대해 읽을 수 있고 쓸 수 있으므로 git이 거기서 계속 작동합니다.1716세션의 작업 디렉토리가 Claude Code가 세션 중간에 들어간 것을 포함한 연결된 [git worktree](/docs/ko/worktrees)일 때 저장소의 공통 `.git` 디렉토리는 샌드박스된 명령에 대해 읽을 수 있고 쓸 수 있으므로 git이 거기서 계속 작동합니다.
1645 1717
1718이러한 경우에는 블록이 샌드박스된 명령에 도달하지 않는 반면 Claude의 파일 도구는 계속 적용합니다:
1719
1720* 파일 시스템 격리가 [`sandbox.filesystem.disabled`](#sandbox-filesystem-disabled)를 통해 꺼져 있습니다
1721* [`allowManagedReadPathsOnly`](#sandbox-filesystem-allowmanagedreadpathsonly)가 설정되어 있습니다
1722* Claude Code를 시작한 디렉토리의 경로에 `*`, `?` 또는 `[` 같은 glob 문자가 포함되어 있습니다
1723
1724블록 아래에서 Claude Code는 `git`이 ID 및 설정을 유지하도록 샌드박스된 명령에 전역 git 구성 파일을 다시 엽니다:
1725
1726* `~/.gitconfig`
1727* `$XDG_CONFIG_HOME/git` 아래의 `config`, `ignore` 및 `attributes` 파일. 기본값은 `~/.config/git`입니다
1728* 전역 git 구성이 `[include]`, `[includeIf]`, `core.excludesFile` 또는 `core.attributesFile`을 통해 명명하는 파일
1729
1730Claude Code는 각 파일을 별도로 판단합니다. 파일이 샌드박스된 명령이 직접 또는 심볼릭 링크를 통해 쓸 수 있는 곳에 있으면 Claude Code는 이름을 지정하는 파일을 다시 열지 않습니다.
1731
1732Linux 및 WSL2에서 심볼릭 링크인 구성 파일은 자신의 경로에서 읽을 수 없게 유지될 수 있으며 `git`은 이를 없이 실행됩니다. `~/.git-credentials` 및 `$XDG_CONFIG_HOME/git/credentials`는 차단된 상태로 유지됩니다.
1733
1734다시 열린 파일이 `http.extraHeader` 토큰 같은 비밀을 보유하면 해당 경로를 [`sandbox.filesystem.denyRead`](#sandbox-filesystem-denyread)에 추가하십시오. `denyRead` 항목이 파일을 다루면 항상 이 다시 열기보다 우선합니다.
1735
1646<h3 id="permissions-defaultmode">1736<h3 id="permissions-defaultmode">
1647 `permissions.defaultMode`1737 `permissions.defaultMode`
1648</h3>1738</h3>
1919}2009}
1920```2010```
1921 2011
1922Claude Code는 OS 샌드박스 경계에서 이러한 목록을 적용하므로, `kubectl`, `terraform`, `npm`과 같이 샌드박스된 명령이 시작하는 모든 하위 프로세스에 적용되며, Claude의 파일 도구에만 적용되지 않습니다. Claude Code는 [권한 규칙](/docs/ko/sandboxing#permission-rules)을 동일한 목록에 추가합니다: `Edit` 허용 및 거부 규칙을 `allowWrite` 및 `denyWrite`에, `Read` 거부 규칙을 `denyRead`에, `WebFetch(domain:...)` 허용 및 거부 규칙을 [`network`](#sandbox-network) 도메인 목록에 추가합니다.2012Claude Code는 OS 샌드박스 경계에서 이러한 목록을 적용하므로, `kubectl`, `terraform`, `npm`과 같이 샌드박스된 명령이 시작하는 모든 하위 프로세스에 적용됩니다. Claude Code는 [권한 규칙](/docs/ko/sandboxing#permission-rules)을 동일한 목록에 추가합니다: `Edit` 허용 및 거부 규칙을 `allowWrite` 및 `denyWrite`에, `Read` 거부 규칙을 `denyRead`에, `WebFetch(domain:...)` 허용 및 거부 규칙을 [`network`](#sandbox-network) 도메인 목록에 추가합니다.
1923 2013
1924관리되는 전용 잠금이 설정되지 않으면, Claude Code는 세션이 로드하는 모든 설정 파일에서 모든 목록을 병합합니다. [`allowManagedReadPathsOnly`](#sandbox-filesystem-allowmanagedreadpathsonly)는 `allowRead`를 관리되는 설정의 항목으로만 제한하며, [`allowManagedDomainsOnly`](#sandbox-network-allowmanageddomainsonly)는 허용된 도메인에 대해 동일하게 수행합니다.2014관리되는 전용 잠금이 설정되지 않으면, Claude Code는 세션이 로드하는 모든 설정 파일에서 모든 목록을 병합합니다. [`allowManagedReadPathsOnly`](#sandbox-filesystem-allowmanagedreadpathsonly)는 `allowRead`를 관리되는 설정의 항목으로만 제한하며, [`allowManagedDomainsOnly`](#sandbox-network-allowmanageddomainsonly)는 허용된 도메인에 대해 동일하게 수행합니다.
1925 2015
1968}2058}
1969```2059```
1970 2060
1971Claude Code는 세션이 로드하는 모든 설정 범위에서 항목을 병합합니다: 사용자, 프로젝트, 로컬, 관리되는 경로가 서로 대체하지 않고 결합되며, Claude Code는 `Edit(...)` 허용 권한 규칙의 경로를 추가합니다. `allowWrite` 항목은 [보호된 경로](/docs/ko/sandboxing#protected-paths)를 해제할 수 없습니다.2061Claude Code는 세션이 로드하는 모든 설정 범위에서 `allowWrite` 항목과 `Edit(...)` 허용 권한 규칙의 경로를 병합하며, [`permissions.blockReadsOutsideWorkingDirectories`](#sandboxed-commands-under-the-block)가 켜져 있는 동안 저장소 설정의 항목을 제외합니다. `allowWrite` 항목은 [보호된 경로](/docs/ko/sandboxing#protected-paths)를 해제할 수 없습니다.
1972 2062
1973<h3 id="sandbox-filesystem-denywrite">2063<h3 id="sandbox-filesystem-denywrite">
1974 `sandbox.filesystem.denyWrite`2064 `sandbox.filesystem.denyWrite`
2039}2129}
2040```2130```
2041 2131
2042Claude Code는 프로젝트 설정에서 `.` 항목을 프로젝트 루트로, 사용자 설정에서 `~/.claude`로 확인합니다. Claude Code는 [`allowManagedReadPathsOnly`](#sandbox-filesystem-allowmanagedreadpathsonly)가 설정되지 않으면 세션이 로드하는 모든 설정 파일에서 항목을 병합합니다.2132Claude Code는 프로젝트 설정에서 `.` 항목을 프로젝트 루트로, 사용자 설정에서 `~/.claude`로 확인합니다. Claude Code는 [`allowManagedReadPathsOnly`](#sandbox-filesystem-allowmanagedreadpathsonly)가 설정되지 않으면 세션이 로드하는 모든 설정 파일에서 항목을 병합하며, [`permissions.blockReadsOutsideWorkingDirectories`](#sandboxed-commands-under-the-block)가 켜져 있는 동안 저장소 설정의 항목을 제외합니다.
2043 2133
2044<h3 id="sandbox-filesystem-allowmanagedreadpathsonly">2134<h3 id="sandbox-filesystem-allowmanagedreadpathsonly">
2045 `sandbox.filesystem.allowManagedReadPathsOnly`2135 `sandbox.filesystem.allowManagedReadPathsOnly`
2254 `sandbox.credentials`2344 `sandbox.credentials`
2255</h3>2345</h3>
2256 2346
2257[샌드박스된 명령으로부터 보호할](/docs/ko/sandboxing#protect-credentials) 자격증명 파일 및 환경 변수를 선언합니다. 각 항목은 파일 `path` 또는 변수 `name` 및 `mode`를 지정합니다: `deny`는 자격증명을 샌드박스 내부에 숨기고, `mask`는 샌드박스된 명령에 자리 표시자를 표시하면서 [샌드박스 프록시](/docs/ko/sandboxing#mask-credentials)는 아웃바운드 요청에서 실제 값을 대체합니다. Claude Code는 나열한 항목만 보호합니다. 기본 제공 자격증명 거부 목록이 없습니다. Claude Code v2.1.187 이상이 필요합니다.2347[샌드박스된 명령으로부터 보호할](/docs/ko/sandboxing#protect-credentials) 자격증명 파일 및 환경 변수를 선언합니다. 각 항목은 파일 `path` 또는 변수 `name` 및 `mode`를 지정합니다: `deny`는 자격증명을 샌드박스 내부에 숨기고, `mask`는 샌드박스된 명령에 자리 표시자를 표시하면서 [샌드박스 프록시](/docs/ko/sandboxing#mask-credentials)는 아웃바운드 요청에서 실제 값을 대체합니다. Claude Code는 나열한 항목만 보호합니다. 기본 제공 자격증명 거부 목록이 없습니다.
2258 2348
2259* **범위**: [`모든 파일`](#scopes). Claude Code는 `mask` 항목, `allowPlaintextInject`, `awsPairs`, `sigv4`를 사용자 설정, 관리되는 설정, `--settings` 플래그에서만 인정합니다.2349* **범위**: [`모든 파일`](#scopes). Claude Code는 `mask` 항목, `allowPlaintextInject`, `awsPairs`, `sigv4`를 사용자 설정, 관리되는 설정, `--settings` 플래그에서만 인정합니다.
2260* **유형**: `files`, `envVars`, `allowPlaintextInject`, `awsPairs`, `sigv4`를 포함하는 객체2350* **유형**: `files`, `envVars`, `allowPlaintextInject`, `awsPairs`, `sigv4`를 포함하는 객체
2273}2363}
2274```2364```
2275 2365
2276`deny` 파일 보호는 파일시스템 계층의 일부이므로, [파일시스템 격리를 비활성화](/docs/ko/sandboxing#disable-filesystem-isolation)할 때 적용되지 않습니다. 환경 변수 보호는 여전히 적용됩니다. Claude Code v2.1.187 이상이 필요합니다.2366`deny` 파일 보호는 파일시스템 계층의 일부이므로, [파일시스템 격리를 비활성화](/docs/ko/sandboxing#disable-filesystem-isolation)할 때 적용되지 않습니다. 환경 변수 보호는 여전히 적용됩니다.
2277 2367
2278<h4 id="invalid-credential-entries-in-managed-settings">2368<h4 id="invalid-credential-entries-in-managed-settings">
2279 관리되는 설정의 잘못된 자격증명 항목2369 관리되는 설정의 잘못된 자격증명 항목
2291 `sandbox.credentials.files`2381 `sandbox.credentials.files`
2292</h3>2382</h3>
2293 2383
2294자격증명 파일 또는 디렉토리를 샌드박스된 명령으로부터 보호합니다. `"mode": "deny"`를 사용하면, Claude Code는 샌드박스 내부의 경로 읽기를 차단하며, [`sandbox.filesystem.denyRead`](#sandbox-filesystem-denyread)와 동일한 읽기 블록입니다. `"mode": "mask"`를 사용하면, Linux 및 WSL2의 샌드박스된 명령은 파일의 센티널 복사본을 읽고, 샌드박스 프록시는 해당 항목의 `injectHosts`에 대한 아웃바운드 요청에서 실제 값을 대체합니다. macOS에서는 파일이 샌드박스 내부에서 읽을 수 없습니다. Claude Code v2.1.187 이상이 필요하며, `"mode": "mask"`는 v2.1.221 이상이 필요합니다.2384자격증명 파일 또는 디렉토리를 샌드박스된 명령으로부터 보호합니다. `"mode": "deny"`를 사용하면, Claude Code는 샌드박스 내부의 경로 읽기를 차단하며, [`sandbox.filesystem.denyRead`](#sandbox-filesystem-denyread)와 동일한 읽기 블록입니다. `"mode": "mask"`를 사용하면, Linux 및 WSL2의 샌드박스된 명령은 파일의 센티널 복사본을 읽고, 샌드박스 프록시는 해당 항목의 `injectHosts`에 대한 아웃바운드 요청에서 실제 값을 대체합니다. macOS에서는 파일이 샌드박스 내부에서 읽을 수 없습니다. `"mode": "mask"`는 v2.1.221 이상이 필요합니다.
2295 2385
2296* **범위**: [`모든 파일`](#scopes). Claude Code는 프로젝트 `.claude/settings.json` 및 로컬 `.claude/settings.local.json`에서 `mask` 항목을 버립니다.2386* **범위**: [`모든 파일`](#scopes). Claude Code는 프로젝트 `.claude/settings.json` 및 로컬 `.claude/settings.local.json`에서 `mask` 항목을 버립니다.
2297* **유형**: 각각 `path` 및 `"deny"` 또는 `"mask"`의 `mode`를 포함하는 객체의 배열이며, 선택적 [파일용 마스크 필드](#mask-fields-for-files)도 포함합니다.2387* **유형**: 각각 `path` 및 `"deny"` 또는 `"mask"`의 `mode`를 포함하는 객체의 배열이며, 선택적 [파일용 마스크 필드](#mask-fields-for-files)도 포함합니다.
2312}2402}
2313```2403```
2314 2404
2315경로는 `sandbox.filesystem.*` 설정과 동일한 [접두사](#sandbox-path-prefixes)를 사용하며, Claude Code는 세션이 로드하는 모든 설정 범위에서 배열을 병합합니다. [자격증명 보호](/docs/ko/sandboxing#protect-credentials)는 `--setting-sources`로 제외하는 소스에서 여전히 적용되는 것을 다룹니다. Claude Code v2.1.187 이상이 필요합니다. `mask` 항목은 v2.1.221 이상이 필요합니다.2405경로는 `sandbox.filesystem.*` 설정과 동일한 [접두사](#sandbox-path-prefixes)를 사용하며, Claude Code는 세션이 로드하는 모든 설정 범위에서 배열을 병합합니다. [자격증명 보호](/docs/ko/sandboxing#protect-credentials)는 `--setting-sources`로 제외하는 소스에서 여전히 적용되는 것을 다룹니다. `mask` 항목은 v2.1.221 이상이 필요합니다.
2316 2406
2317`mask` 대체는 샌드박스 프록시를 통해서만 실행되므로, [`sandbox.network.tlsTerminate`](#sandbox-network-tlsterminate) 또는 일반 HTTP 테스트 네트워크의 [`allowPlaintextInject`](#sandbox-credentials-allowplaintextinject)를 설정하십시오. `mask`는 단일 파일에 적용되므로, 각 자격증명 파일을 개별적으로 나열하십시오. Claude Code는 `deny` 항목의 `mask` 필드를 수용하지만 무시합니다. [자격증명 파일 마스크](/docs/ko/sandboxing#mask-credential-files)는 어떤 설정 소스가 인정되는지 및 항목이 `deny`로 돌아가는 시기를 다룹니다.2407`mask` 대체는 샌드박스 프록시를 통해서만 실행되므로, [`sandbox.network.tlsTerminate`](#sandbox-network-tlsterminate) 또는 일반 HTTP 테스트 네트워크의 [`allowPlaintextInject`](#sandbox-credentials-allowplaintextinject)를 설정하십시오. `mask`는 단일 파일에 적용되므로, 각 자격증명 파일을 개별적으로 나열하십시오. Claude Code는 `deny` 항목의 `mask` 필드를 수용하지만 무시합니다. [자격증명 파일 마스크](/docs/ko/sandboxing#mask-credential-files)는 어떤 설정 소스가 인정되는지 및 항목이 `deny`로 돌아가는 시기를 다룹니다.
2318 2408
2368 `sandbox.credentials.envVars`2458 `sandbox.credentials.envVars`
2369</h3>2459</h3>
2370 2460
2371환경 변수를 샌드박스된 명령으로부터 보호합니다. `"mode": "deny"`를 사용하면, Claude Code는 샌드박스된 명령의 환경에서 변수를 제거합니다. `"mode": "mask"`를 사용하면, 샌드박스된 명령은 세션별 센티널 값을 보고, 샌드박스 프록시는 해당 항목의 `injectHosts`에 대한 아웃바운드 요청에서 실제 값을 대체하므로, `gh` 및 `npm`과 같은 도구는 실제 자격증명을 보유하지 않고도 계속 인증합니다. Claude Code v2.1.187 이상이 필요하며, `"mode": "mask"`는 v2.1.199 이상이 필요합니다.2461환경 변수를 샌드박스된 명령으로부터 보호합니다. `"mode": "deny"`를 사용하면, Claude Code는 샌드박스된 명령의 환경에서 변수를 제거합니다. `"mode": "mask"`를 사용하면, 샌드박스된 명령은 세션별 센티널 값을 보고, 샌드박스 프록시는 해당 항목의 `injectHosts`에 대한 아웃바운드 요청에서 실제 값을 대체하므로, `gh` 및 `npm`과 같은 도구는 실제 자격증명을 보유하지 않고도 계속 인증합니다. `"mode": "mask"`는 v2.1.199 이상이 필요합니다.
2372 2462
2373* **범위**: [`모든 파일`](#scopes). Claude Code는 프로젝트 `.claude/settings.json` 및 로컬 `.claude/settings.local.json`에서 `mask` 항목을 버립니다.2463* **범위**: [`모든 파일`](#scopes). Claude Code는 프로젝트 `.claude/settings.json` 및 로컬 `.claude/settings.local.json`에서 `mask` 항목을 버립니다.
2374* **유형**: 각각 `name` 및 `"deny"` 또는 `"mask"`의 `mode`를 포함하는 객체의 배열이며, 선택적 [환경 변수용 마스크 필드](#mask-fields-for-environment-variables)도 포함합니다.2464* **유형**: 각각 `name` 및 `"deny"` 또는 `"mask"`의 `mode`를 포함하는 객체의 배열이며, 선택적 [환경 변수용 마스크 필드](#mask-fields-for-environment-variables)도 포함합니다.
2389}2479}
2390```2480```
2391 2481
2392`name`은 문자 또는 밑줄로 시작해야 하며 문자, 숫자, 밑줄만 포함해야 합니다. Claude Code는 세션이 로드하는 모든 설정 범위에서 배열을 병합하고, 동일한 변수가 두 모드로 나타날 때 `deny`를 적용합니다. [자격증명 보호](/docs/ko/sandboxing#protect-credentials)는 `--setting-sources`로 제외하는 소스에서 여전히 적용되는 것을 다룹니다. Claude Code v2.1.187 이상이 필요합니다. `mask` 항목은 v2.1.199 이상이 필요합니다.2482`name`은 문자 또는 밑줄로 시작해야 하며 문자, 숫자, 밑줄만 포함해야 합니다. Claude Code는 세션이 로드하는 모든 설정 범위에서 배열을 병합하고, 동일한 변수가 두 모드로 나타날 때 `deny`를 적용합니다. [자격증명 보호](/docs/ko/sandboxing#protect-credentials)는 `--setting-sources`로 제외하는 소스에서 여전히 적용되는 것을 다룹니다. `mask` 항목은 v2.1.199 이상이 필요합니다.
2393 2483
2394`mask` 대체는 샌드박스 프록시를 통해서만 실행되므로, [`sandbox.network.tlsTerminate`](#sandbox-network-tlsterminate) 또는 일반 HTTP 테스트 네트워크의 [`allowPlaintextInject`](#sandbox-credentials-allowplaintextinject)를 설정하십시오. [환경 변수 마스크](/docs/ko/sandboxing#mask-environment-variables)를 참조하십시오. Claude Code는 `deny` 항목의 `mask` 필드를 수용하지만 무시합니다.2484`mask` 대체는 샌드박스 프록시를 통해서만 실행되므로, [`sandbox.network.tlsTerminate`](#sandbox-network-tlsterminate) 또는 일반 HTTP 테스트 네트워크의 [`allowPlaintextInject`](#sandbox-credentials-allowplaintextinject)를 설정하십시오. [환경 변수 마스크](/docs/ko/sandboxing#mask-environment-variables)를 참조하십시오. Claude Code는 `deny` 항목의 `mask` 필드를 수용하지만 무시합니다.
2395 2485
2811 메모리 및 컨텍스트2901 메모리 및 컨텍스트
2812</h2>2902</h2>
2813 2903
2814Claude Code가 컨텍스트에 로드하는 내용, 압축 방식, 메모리 및 계획 저장 위치를 제어합니다. [컨텍스트 관리](/docs/ko/context-window) 및 [메모리](/docs/ko/memory)를 참조하세요.2904Claude Code가 컨텍스트에 로드하는 내용, 압축 방식, 메모리 및 계획 저장 위치를 제어합니다. [컨텍스트 관리](/docs/ko/context-window) 및 [메모리](/docs/ko/memory)를 참조하십시오.
2815 2905
2816<h3 id="autocompactenabled">2906<h3 id="autocompactenabled">
2817 `autoCompactEnabled`2907 `autoCompactEnabled`
2851}2941}
2852```2942```
2853 2943
2854[`/autocompact`](/docs/ko/commands#all-commands) 명령으로 설정하면 이 키가 사용자 설정에 기록됩니다. [자동 압축 윈도우 설정](/docs/ko/model-config#set-the-auto-compact-window)에서 명령, 플래그, 변수 및 설정이 어떻게 상호작용하는지 다룹니다.2944[`/autocompact`](/docs/ko/commands#all-commands) 명령으로 설정하면 이 키가 사용자 설정에 기록됩니다. [자동 압축 윈도우 설정](/docs/ko/model-config#set-the-auto-compact-window)에서 명령, 플래그, 변수 및 설정이 어떻게 상호작용하는지 설명합니다.
2855 2945
2856<h3 id="automemorydirectory">2946<h3 id="automemorydirectory">
2857 `autoMemoryDirectory`2947 `autoMemoryDirectory`
2875 `autoMemoryEnabled`2965 `autoMemoryEnabled`
2876</h3>2966</h3>
2877 2967
2878[자동 메모리](/docs/ko/memory#enable-or-disable-auto-memory)를 켜거나 끕니다. `false`일 때 Claude는 자동 메모리 디렉토리에서 읽거나 쓰지 않습니다. 세션 중에 `/memory`로도 토글할 수 있으며, 이는 이 키를 사용자 설정에 기록합니다.2968[자동 메모리](/docs/ko/memory#enable-or-disable-auto-memory)를 켜거나 끕니다. `false`일 때 Claude는 자동 메모리 디렉토리에서 읽거나 쓰지 않습니다. 세션 중에 `/memory`로 토글할 수도 있으며, 이는 이 키를 사용자 설정에 기록합니다.
2879 2969
2880* **범위**: [`모든 파일`](#scopes)2970* **범위**: [`모든 파일`](#scopes)
2881* **유형**: 부울2971* **유형**: 부울
2882 * `true`: 설정되지 않은 것과 동일합니다. `--bare`, 안전 모드 또는 `CLAUDE_CODE_DISABLE_AUTO_MEMORY`와 같이 이 키보다 우선하는 것이 세션을 끄지 않는 한 자동 메모리는 켜진 상태로 유지됩니다2972 * `true`: 설정되지 않은 것과 동일합니다. 자동 메모리는 `--bare`, 안전 모드 또는 `CLAUDE_CODE_DISABLE_AUTO_MEMORY`와 같이 이 키보다 우선하는 것이 세션을 끄지 않는 한 켜져 있습니다
2883 * `false`: Claude는 자동 메모리 디렉토리에서 읽거나 쓰지 않습니다2973 * `false`: Claude는 자동 메모리 디렉토리에서 읽거나 쓰지 않습니다
2884* **기본값**: `true`2974* **기본값**: `true`
2885* **세션별 재정의**: [`CLAUDE_CODE_DISABLE_AUTO_MEMORY`](/docs/ko/env-vars)는 한 세션 동안 이 키보다 우선하며, 어느 방향이든 적용됩니다2975* **세션별 재정의**: [`CLAUDE_CODE_DISABLE_AUTO_MEMORY`](/docs/ko/env-vars)는 한 세션 동안 이 키보다 어느 방향이든 우선합니다
2886 2976
2887```json settings.json theme={null}2977```json settings.json theme={null}
2888{2978{
2894 `bashOutputMaxChars`2984 `bashOutputMaxChars`
2895</h3>2985</h3>
2896 2986
2897성공한 Bash 또는 PowerShell 명령의 [출력 중 Claude가 인라인으로 받는 문자 수](/docs/ko/tools-reference#output-limits)를 설정합니다. 출력이 한계를 초과하면 Claude Code는 이를 파일에 저장하고 Claude는 짧은 미리보기와 파일의 경로를 받습니다. 자세한 빌드 또는 전체 테스트 스위트 로그와 같은 명령 출력이 기본값을 자주 초과하고 Claude가 파일을 열지 않고 읽기를 원할 때 한계를 높입니다. Claude Code v2.1.261 이상이 필요합니다.2987성공한 Bash 또는 PowerShell 명령의 [출력 중 Claude가 인라인으로 받는 문자 수](/docs/ko/tools-reference#output-limits)를 설정합니다. 출력이 한계를 초과하면 Claude Code는 출력을 파일에 저장하고 Claude는 짧은 미리보기와 파일의 경로를 받습니다. 자세한 빌드 또는 전체 테스트 스위트 로그와 같은 명령 출력이 기본값을 자주 초과하고 Claude가 파일을 열지 않고 읽기를 원할 때 한계를 높입니다. Claude Code v2.1.261 이상이 필요합니다.
2898 2988
2899* **범위**: [`모든 파일`](#scopes)2989* **범위**: [`모든 파일`](#scopes)
2900* **유형**: 문자 수, 양의 정수. Claude Code는 값을 `4000`에서 `128000` 범위로 제한합니다2990* **유형**: 문자 수, 양의 정수. Claude Code는 값을 `4000`에서 `128000` 범위로 제한합니다
2912 `claudeMd`3002 `claudeMd`
2913</h3>3003</h3>
2914 3004
2915CLAUDE.md 스타일 지침을 별도 파일을 배포하지 않고 조직 관리 메모리로 주입합니다. Claude Code는 텍스트를 사용자 및 프로젝트 CLAUDE.md 파일보다 먼저 관리 메모리 항목으로 로드합니다.3005CLAUDE.md 스타일 지침을 별도 파일을 배포하지 않고 조직 관리 메모리로 주입합니다. Claude Code는 텍스트를 사용자 및 프로젝트 CLAUDE.md 파일보다 먼저 관리되는 메모리 항목으로 로드합니다.
2916 3006
2917* **범위**: [`관리됨`](#scopes)3007* **범위**: [`관리됨`](#scopes)
2918* **유형**: 문자열, CLAUDE.md 파일의 텍스트. 파일처럼 작성하되 Markdown을 포함하고 줄 바꿈을 `\n`으로 표기합니다3008* **유형**: 문자열, CLAUDE.md 파일의 텍스트. 파일처럼 작성하되 Markdown을 포함하고 줄 바꿈을 `\n`으로 표기합니다
2926}3016}
2927```3017```
2928 3018
2929[조직 전체 CLAUDE.md 배포](/docs/ko/memory#deploy-organization-wide-claude-md)를 참조하세요.3019[조직 전체 CLAUDE.md 배포](/docs/ko/memory#deploy-organization-wide-claude-md)를 참조하십시오.
2930 3020
2931<h3 id="claudemdexcludes">3021<h3 id="claudemdexcludes">
2932 `claudeMdExcludes`3022 `claudeMdExcludes`
2933</h3>3023</h3>
2934 3024
2935Claude Code가 [메모리](/docs/ko/memory#exclude-specific-claude-md-files)를 로드할 때 특정 `CLAUDE.md` 파일을 건너뜁니다. 큰 모노레포에서 이를 사용하여 작업과 관련이 없는 다른 팀의 CLAUDE.md 파일을 건너뜁니다. [관련 없는 CLAUDE.md 파일 제외](/docs/ko/large-codebases#exclude-irrelevant-claude-md-files)는 대규모 코드베이스 가이드에서 해당 경우를 다룹니다. 패턴은 절대 파일 경로와 일치합니다.3025Claude Code가 [메모리](/docs/ko/memory#exclude-specific-claude-md-files)를 로드할 때 특정 `CLAUDE.md` 파일을 건너뜁니다. 큰 모노레포에서 이를 사용하여 작업과 관련이 없는 다른 팀의 CLAUDE.md 파일을 건너뜁니다. 대규모 코드베이스 가이드의 [관련 없는 CLAUDE.md 파일 제외](/docs/ko/large-codebases#exclude-irrelevant-claude-md-files)에서 해당 경우를 설명합니다. 패턴은 절대 파일 경로와 일치합니다.
2936 3026
2937* **범위**: [`모든 파일`](#scopes)3027* **범위**: [`모든 파일`](#scopes)
2938* **유형**: 문자열 배열, 각각 glob 패턴 또는 절대 경로3028* **유형**: 문자열 배열, 각각 glob 패턴 또는 절대 경로
2944}3034}
2945```3035```
2946 3036
2947제외는 사용자, 프로젝트 및 로컬 메모리 파일에만 적용됩니다. 관리 정책 CLAUDE.md 파일은 제외할 수 없습니다.3037제외는 사용자, 프로젝트 및 로컬 메모리 파일에만 적용됩니다. 관리되는 정책 CLAUDE.md 파일은 제외할 수 없습니다.
2948 3038
2949<span id="environment-variables" />3039<span id="environment-variables" />
2950 3040
2952 `env`3042 `env`
2953</h3>3043</h3>
2954 3044
2955모든 세션 및 Claude Code가 시작하는 서브프로세스에 대한 환경 변수를 설정합니다. [환경 변수 참조](/docs/ko/env-vars)의 모든 변수가 여기에 올 수 있으며, 이것이 모든 세션에 변수를 적용하거나 팀에 배포하는 방법입니다.3045모든 세션 및 Claude Code가 시작하는 서브프로세스에 대한 환경 변수를 설정합니다. [환경 변수 참조](/docs/ko/env-vars)의 대부분의 변수를 여기에 넣을 수 있으며, 이것이 모든 세션에 적용하거나 팀에 배포하는 방법입니다. 프로젝트 및 로컬 설정은 [일부 변수](#variables-claude-code-ignores-in-env)를 설정할 수 없습니다.
2956 3046
2957* **범위**: [`모든 파일`](#scopes)3047* **범위**: [`모든 파일`](#scopes)
2958* **유형**: 변수 이름을 문자열 값으로 매핑하는 객체3048* **유형**: 변수 이름을 문자열 값으로 매핑하는 객체
2973 `env` 값이 셸과 상호작용하는 방식3063 `env` 값이 셸과 상호작용하는 방식
2974</h4>3064</h4>
2975 3065
2976* 여기의 값은 셸에서 내보낸 동일한 변수를 덮어쓰며, 둘 이상의 설정 파일이 변수를 설정할 때 [가장 높은 우선순위](/docs/ko/settings#settings-precedence)가 적용됩니다.3066* 여기의 값은 셸에서 내보낸 동일한 변수를 덮어쓰며, 둘 이상의 설정 파일이 변수를 설정할 때 [가장 높은 우선순위](/docs/ko/settings#settings-precedence)가 적용됩니다. [Claude Code가 `env`에서 무시하는 변수](#variables-claude-code-ignores-in-env)는 프로젝트 및 로컬 설정의 예외를 나열합니다.
2977* 셸 내보내기를 취소하려면 변수를 `""`로 설정합니다. Claude Code는 공 값을 공급자 선택에 대해 설정되지 않은 것으로 취급하며, 서브프로세스는 공 값을 상속합니다.3067* 셸 내보내기를 취소하려면 변수를 `""`로 설정합니다. Claude Code는 공 값을 공급자 선택에 대해 설정되지 않은 것으로 취급하며, 서브프로세스는 공 값을 상속합니다.
2978* `NO_COLOR` 및 `FORCE_COLOR`는 여기서 설정하면 서브프로세스에만 도달합니다. Claude Code 자체 인터페이스 색상을 변경하려면 `claude`를 시작하기 전에 셸에서 설정합니다.3068* `NO_COLOR` 및 `FORCE_COLOR`는 여기에서 설정하면 서브프로세스에만 도달합니다. Claude Code 자체 인터페이스 색상을 변경하려면 `claude`를 시작하기 전에 셸에서 설정합니다.
2979* 여기의 값은 설정 파일의 일반 텍스트이며 Claude Code가 시작하는 모든 서브프로세스에 도달합니다. 회전하는 OTLP 베어러 토큰의 경우 [`otelHeadersHelper`](#otelheadershelper)를 사용합니다. API 자격 증명의 경우 [`apiKeyHelper`](#apikeyhelper)를 사용합니다.3069* 여기의 값은 설정 파일의 일반 텍스트이며 Claude Code가 시작하는 모든 서브프로세스에 도달합니다. 회전하는 OTLP 베어러 토큰의 경우 [`otelHeadersHelper`](#otelheadershelper)를 사용합니다. API 자격 증명의 경우 [`apiKeyHelper`](#apikeyhelper)를 사용합니다.
2980 3070
2981<h4 id="when-claude-code-applies-env-values">3071<h4 id="when-claude-code-applies-env-values">
2982 Claude Code가 `env` 값을 적용하는 시기3072 Claude Code가 `env` 값을 적용하는 시기
2983</h4>3073</h4>
2984 3074
2985* 사용자 설정, `--settings` 및 관리 설정에서: 시작 시 및 저장된 변경이 병합된 `env`를 변경할 때 실행 중인 세션에서.3075* 사용자 설정, `--settings` 및 관리되는 설정에서: 시작 시 및 저장된 변경이 병합된 `env`를 변경할 때 실행 중인 세션에서.
2986* 프로젝트 및 로컬 설정에서: 워크스페이스를 신뢰한 후 또는 신뢰 대화를 표시하지 않는 `-p` 모드에서 시작 시, 그리고 저장된 변경이 병합된 `env`를 변경할 때.3076* 프로젝트 및 로컬 설정에서: 워크스페이스를 신뢰한 후 또는 신뢰 대화를 표시하지 않는 `-p` 모드에서 시작할 때, 저장된 변경이 병합된 `env`를 변경할 때 다시.
2987* Claude Code가 모델 선택, 타임아웃 및 한계, 기능 토글 및 원격 분석 설정과 같은 안전한 것으로 분류하는 변수: 모든 설정 파일에서 시작 시, [프로젝트 및 로컬 설정이 `env`에서 설정할 수 없는 변수](#variables-claude-code-ignores-in-env) 제외.3077* Claude Code가 모델 선택, 타임아웃 및 한계, 기능 토글과 같은 안전한 것으로 분류하는 변수: [프로젝트 및 로컬 설정이 설정할 수 없는 변수](#variables-claude-code-ignores-in-env)를 제외하고 모든 설정 파일에서 시작할 때.
2988* v2.1.246 이상에서 [`/cd`로 세션을 이동](/docs/ko/permissions#move-the-session-to-another-directory)한 후: 새 디렉토리의 프로젝트 및 로컬 `env` 값, 이전 디렉토리의 값 위에.3078* v2.1.246 이상에서 [`/cd`로 세션을 이동](/docs/ko/permissions#move-the-session-to-another-directory)한 후: 새 디렉토리의 프로젝트 및 로컬 `env` 값, 이전 디렉토리의 위에.
2989 3079
2990<h4 id="variables-claude-code-ignores-in-env">3080<h4 id="variables-claude-code-ignores-in-env">
2991 Claude Code가 `env`에서 무시하는 변수3081 Claude Code가 `env`에서 무시하는 변수
2992</h4>3082</h4>
2993 3083
2994* 프로젝트 및 로컬 설정은 체크아웃된 저장소가 제어하지 않아야 하는 변수를 설정할 수 없습니다. 대신 셸, 사용자 설정 또는 관리 설정에서 설정합니다. Claude Code는 각각을 삭제하고 `claude --debug`로 볼 수 있는 경고를 기록합니다. 여기에는 다음이 포함됩니다:3084* 프로젝트 및 로컬 설정은 체크아웃된 저장소가 제어하지 않아야 하는 변수를 설정할 수 없습니다. 대신 셸, 사용자 설정 또는 관리되는 설정에서 설정합니다. Claude Code는 각각을 삭제하고 `claude --debug`로 볼 수 있는 경고를 기록합니다. 여기에는 다음이 포함됩니다:
2995 3085
2996 * Claude Code가 자신의 파일을 저장하거나 쓰는 위치를 선택하는 변수: `CLAUDE_CONFIG_DIR`, `CLAUDE_CODE_TMPDIR` 및 `HOME`, `TMPDIR`, `TMP`, `TEMP` 및 `XDG_*` 계열과 같은 운영 체제 디렉토리 변수.3086 * Claude Code가 자신의 파일을 저장하거나 쓰는 위치를 선택하는 변수: `CLAUDE_CONFIG_DIR`, `CLAUDE_CODE_TMPDIR` 및 `HOME`, `TMPDIR`, `TMP`, `TEMP` 및 `XDG_*` 계열과 같은 운영 체제 디렉토리 변수.
2997 * 세션 콘텐츠를 내보내는 변수: [`OTEL_LOG_RAW_API_BODIES`](/docs/ko/env-vars#variables) 및 자세한 베타 추적 쌍 `ENABLE_BETA_TRACING_DETAILED` 및 `BETA_TRACING_ENDPOINT`.3087 * 세션 콘텐츠를 내보내는 변수: [`OTEL_LOG_RAW_API_BODIES`](/docs/ko/env-vars#variables) 및 자세한 베타 추적 쌍 `ENABLE_BETA_TRACING_DETAILED` 및 `BETA_TRACING_ENDPOINT`.
3088 * [OpenTelemetry 내보내기](/docs/ko/monitoring-usage) 변수는 원격 측정을 켜거나, 어디로 갈지 선택하거나, 어떤 콘텐츠를 캡처할지 선택합니다:
3089
3090 * `CLAUDE_CODE_ENABLE_TELEMETRY`, 향상된 원격 측정 베타 쌍 `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA` 및 `ENABLE_ENHANCED_TELEMETRY_BETA`
3091 * 내보내기 선택기 `OTEL_LOGS_EXPORTER`, `OTEL_METRICS_EXPORTER` 및 `OTEL_TRACES_EXPORTER`
3092 * 콘텐츠 변수 `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_ASSISTANT_RESPONSES`, `OTEL_LOG_TOOL_CONTENT` 및 `OTEL_LOG_TOOL_DETAILS`
3093 * `OTEL_EXPORTER_OTLP_*` 변수는 이름이 `_ENDPOINT`, `_HEADERS`, `_PROTOCOL`, `_CERTIFICATE`, `_CLIENT_KEY` 또는 `_INSECURE`로 끝나며, 일반 및 신호별 형식으로 `OTEL_EXPORTER_OTLP_ENDPOINT` 및 `OTEL_EXPORTER_OTLP_METRICS_HEADERS`와 같습니다
3094 * `OTEL_EXPORTER_PROMETHEUS_HOST` 및 `OTEL_EXPORTER_PROMETHEUS_PORT`
3095
3096 이 값들만 프로젝트 및 로컬 설정에서 계속 적용됩니다. 왜냐하면 그들은 뭔가를 끄기 때문입니다: 세 개의 내보내기 선택기에 대해 `none`, 그리고 `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_CONTENT` 및 `OTEL_LOG_TOOL_DETAILS`에 대해 `0`과 같은 끄기 값. 이러한 값은 사용자 설정의 동일한 변수를 재정의하지만 Claude Code를 시작하는 환경, `--settings` 파일 또는 관리되는 설정이 설정하는 것은 재정의하지 않습니다.
3097
3098 프로젝트 또는 로컬 설정 파일이 이 그룹의 변수를 설정할 때 로컬 대화형 세션은 시작 시 공지를 표시합니다. `/status` 또는 `claude doctor`를 실행하여 Claude Code가 무시한 변수와 원격 측정을 끈 변수를 확인합니다. 둘 다 이름을 나열하며 값은 나열하지 않습니다. `-p`를 사용한 비대화형 실행 또는 Agent SDK 세션은 공지를 표시하지 않으므로 업그레이드 후 수집기가 여전히 데이터를 받는지 확인합니다. 그렇지 않으면 사용자 설정, 관리되는 설정, 작업의 환경 또는 `--settings`로 전달하는 파일에서 변수를 설정합니다.
3099
3100 프로젝트 및 로컬 설정에서 이 그룹을 무시하려면 Claude Code v2.1.282 이상이 필요합니다.
2998 * Claude Code가 시작하거나 동기화하는 방식을 변경하는 변수, 예: `CLAUDE_CODE_PROCESS_WRAPPER`, `CLAUDE_CODE_SYNC_SKILLS`, `CLAUDE_CODE_SYNC_PLUGINS`, `CLAUDE_CODE_PLUGIN_CACHE_DIR` 및 `CLAUDE_CODE_PLUGIN_SEED_DIR`.3101 * Claude Code가 시작하거나 동기화하는 방식을 변경하는 변수, 예: `CLAUDE_CODE_PROCESS_WRAPPER`, `CLAUDE_CODE_SYNC_SKILLS`, `CLAUDE_CODE_SYNC_PLUGINS`, `CLAUDE_CODE_PLUGIN_CACHE_DIR` 및 `CLAUDE_CODE_PLUGIN_SEED_DIR`.
2999 3102
3000 v2.1.251 이전에는 프로젝트 및 로컬 설정이 `HOME`, `XDG_CONFIG_HOME` 및 Claude Code가 시작하거나 동기화하는 방식을 변경하는 변수를 제외한 이 목록의 모든 변수를 설정할 수 있었습니다.3103 v2.1.251 이전에는 프로젝트 및 로컬 설정이 Claude Code가 파일을 쓰는 위치를 선택하거나 세션 콘텐츠를 내보내는 이 목록의 변수를 설정할 수도 있었습니다. `HOME` 및 `XDG_CONFIG_HOME` 제외.
3001* Claude Code의 호스팅 환경이 소유한 `CLAUDE_CODE_REMOTE` 및 `CLAUDE_CODE_ACCOUNT_UUID`와 같은 ID 변수는 모든 파일에서 무시됩니다.3104* Claude Code의 호스팅 환경이 소유하는 ID 변수, 예: `CLAUDE_CODE_REMOTE` 및 `CLAUDE_CODE_ACCOUNT_UUID`는 모든 파일에서 무시됩니다.
3002* Claude Code가 자체 내보내는 [`CLAUDE_CODE_MESSAGING_SOCKET` 및 `CLAUDE_CODE_MESSAGING_TOKEN`](/docs/ko/env-vars#variables)은 모든 파일에서 무시됩니다. 소켓 변수를 무시하려면 Claude Code v2.1.224 이상이 필요하며, 토큰을 무시하려면 v2.1.228 이상이 필요합니다.3105* [`CLAUDE_CODE_MESSAGING_SOCKET` 및 `CLAUDE_CODE_MESSAGING_TOKEN`](/docs/ko/env-vars#variables)는 Claude Code가 자체 내보내는 것이므로 모든 파일에서 무시됩니다. 소켓 변수를 무시하려면 Claude Code v2.1.224 이상이 필요하고, 토큰을 무시하려면 v2.1.228 이상이 필요합니다.
3003* Claude Code가 시작 환경에서만 읽는 [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/ko/sessions#name-the-project-directory-yourself)은 모든 파일에서 무시됩니다. v2.1.234 이상이 필요합니다.3106* [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/ko/sessions#name-the-project-directory-yourself)는 Claude Code가 시작 환경에서만 읽으므로 모든 파일에서 무시됩니다. v2.1.234 이상이 필요합니다.
3004* Claude Code가 시작 환경에서만 읽는 [`CLAUDE_CODE_RESTRICTED`](/docs/ko/env-vars#variables)은 모든 파일에서 무시됩니다.3107* [`CLAUDE_CODE_RESTRICTED`](/docs/ko/env-vars#variables)는 Claude Code가 시작 환경에서만 읽으므로 모든 파일에서 무시됩니다.
3108* [`CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY`](/docs/ko/env-vars#variables)는 Claude Code가 시작 환경에서만 읽으므로 모든 파일에서 무시됩니다. 변수는 Claude Code v2.1.283 이상이 필요합니다.
3109* [`CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` 및 `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT`](/docs/ko/env-vars#variables)는 Claude Code가 시작 환경에서만 읽으므로 모든 파일에서 무시됩니다.
3005 3110
3006<h3 id="filecheckpointingenabled">3111<h3 id="filecheckpointingenabled">
3007 `fileCheckpointingEnabled`3112 `fileCheckpointingEnabled`
3008</h3>3113</h3>
3009 3114
3010각 편집 전에 Claude Code가 파일을 스냅샷하여 [`/rewind`](/docs/ko/checkpointing)가 파일을 복원할 수 있도록 합니다. `/config`에 \*\*코드 되감기(체크포인트)\*\*로 표시되며, 여기서 토글하면 이 키가 사용자 설정에 기록됩니다.3115Claude Code가 각 편집 전에 파일을 스냅샷하여 [`/rewind`](/docs/ko/checkpointing)가 파일을 복원할 수 있도록 합니다. `/config`에 \*\*코드 되감기(체크포인트)\*\*로 표시되며, 여기서 토글하면 이 키가 사용자 설정에 기록됩니다.
3011 3116
3012* **범위**: [`모든 파일`](#scopes)3117* **범위**: [`모든 파일`](#scopes)
3013* **유형**: 부울3118* **유형**: 부울
3022}3127}
3023```3128```
3024 3129
3025`-p` 실행 또는 Agent SDK 세션에서 Claude Code는 이 키를 무시합니다. SDK는 `enableFileCheckpointing` 옵션으로 체크포인팅을 켜고, 베어 `-p` 실행은 `CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING=true`가 필요합니다. [Agent SDK의 파일 체크포인팅](/docs/ko/agent-sdk/file-checkpointing)을 참조하세요.3130`-p` 실행 또는 Agent SDK 세션에서 Claude Code는 이 키를 무시합니다. SDK는 `enableFileCheckpointing` 옵션으로 체크포인팅을 켜고, 베어 `-p` 실행은 `CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING=true`가 필요합니다. [Agent SDK의 파일 체크포인팅](/docs/ko/agent-sdk/file-checkpointing)을 참조하십시오.
3026 3131
3027<h3 id="plansdirectory">3132<h3 id="plansdirectory">
3028 `plansDirectory`3133 `plansDirectory`
3029</h3>3134</h3>
3030 3135
3031Claude Code가 [계획 모드](/docs/ko/permission-modes#analyze-before-you-edit-with-plan-mode)에서 작성하는 계획 파일을 저장할 위치를 선택합니다. Claude Code는 경로를 프로젝트 루트에 상대적으로 해석하고 경로가 외부로 해석될 때 기본값을 유지합니다.3136Claude Code가 [계획 모드](/docs/ko/permission-modes#analyze-before-you-edit-with-plan-mode)에서 작성하는 계획 파일을 저장할 위치를 선택합니다. Claude Code는 경로를 프로젝트 루트에 상대적으로 해석하고 경로가 외부에서 해석될 때 기본값을 유지합니다.
3032 3137
3033* **범위**: [`모든 파일`](#scopes)3138* **범위**: [`모든 파일`](#scopes)
3034* **유형**: 문자열, 프로젝트 루트에 상대적인 경로3139* **유형**: 문자열, 프로젝트 루트에 상대적인 경로
3044 `skillListingBudgetFraction`3149 `skillListingBudgetFraction`
3045</h3>3150</h3>
3046 3151
3047각 턴마다 Claude는 설명과 함께 [스킬 목록](/docs/ko/skills#skill-descriptions-are-cut-short)을 보며, Claude Code는 해당 목록을 컨텍스트 윈도우의 일부로 제한합니다. 목록이 한계를 초과하면 Claude Code는 모든 스킬의 이름을 유지하지만 가장 적게 사용된 스킬의 설명을 삭제하여 Claude가 여전히 해당 스킬을 호출할 수 있지만 자체적으로 선택할 가능성이 낮습니다. 더 많은 설명을 표시하려면 이 키를 높이되 턴당 더 많은 컨텍스트를 사용합니다.3152각 턴마다 Claude는 설명과 함께 [스킬 목록](/docs/ko/skills#skill-descriptions-are-cut-short)을 보며, Claude Code는 해당 목록을 컨텍스트 윈도우의 일부로 제한합니다. 목록이 제한을 초과하면 Claude Code는 모든 스킬의 이름을 유지하지만 가장 적게 사용된 스킬의 설명을 삭제하므로 Claude는 여전히 해당 스킬을 호출할 수 있지만 자체적으로 선택할 가능성이 낮습니다. 더 많은 설명을 표시하려면 이 키를 높이되 턴당 더 많은 컨텍스트를 사용합니다.
3048 3153
3049* **범위**: [`모든 파일`](#scopes)3154* **범위**: [`모든 파일`](#scopes)
3050* **유형**: 숫자, `0`보다 크고 최대 `1`인 분수3155* **유형**: 숫자, `0`보다 크고 최대 `1`인 분수
3056}3161}
3057```3162```
3058 3163
3059목록이 사용하는 컨텍스트 양과 어떤 스킬이 가장 많이 기여하는지 보려면 `/doctor`를 실행합니다.3164목록이 사용하는 컨텍스트 양과 어떤 스킬이 가장 많이 기여하는지 확인하려면 `/doctor`를 실행합니다.
3060 3165
3061<h3 id="skilllistingmaxdescchars">3166<h3 id="skilllistingmaxdescchars">
3062 `skillListingMaxDescChars`3167 `skillListingMaxDescChars`
3063</h3>3168</h3>
3064 3169
3065각 턴마다 Claude는 각 스킬의 `description` 및 `when_to_use` 텍스트를 보여주는 [스킬 목록](/docs/ko/skills#skill-descriptions-are-cut-short)을 봅니다. 이 키는 Claude Code가 스킬당 해당 텍스트의 몇 문자를 표시하는지 제한합니다. 더 긴 텍스트는 한계에서 잘립니다.3170각 턴마다 Claude는 각 스킬의 `description` 및 `when_to_use` 텍스트를 보여주는 [스킬 목록](/docs/ko/skills#skill-descriptions-are-cut-short)을 봅니다. 이 키는 Claude Code가 스킬당 해당 텍스트의 몇 문자를 표시하는지 제한합니다. 더 긴 텍스트는 제한에서 잘립니다.
3066 3171
3067* **범위**: [`모든 파일`](#scopes)3172* **범위**: [`모든 파일`](#scopes)
3068* **유형**: 문자 수, 양의 정수3173* **유형**: 문자 수, 양의 정수
3081</h3>3186</h3>
3082 3187
3083<Warning>3188<Warning>
3084 v2.1.277에서 제거되었으며, 이를 크기 조정한 `TaskOutput` 도구와 함께 제거되었습니다. 현재 버전에서 설정해도 효과가 없습니다. Claude는 대신 `Read`를 사용하여 백그라운드 작업의 [출력 파일](/docs/ko/tools-reference#background-commands)을 읽습니다.3189 v2.1.277에서 제거되었으며, 크기를 조정한 `TaskOutput` 도구와 함께 제거되었습니다. 설정해도 현재 버전에는 영향을 주지 않습니다. Claude는 `Read`를 사용하여 백그라운드 작업의 [출력 파일](/docs/ko/tools-reference#background-commands)을 읽습니다.
3085</Warning>3190</Warning>
3086 3191
3087v2.1.276까지 이 키를 [백그라운드 작업](/docs/ko/tools-reference#background-commands)의 출력 중 Claude가 `TaskOutput` 도구로 작업을 읽을 때 인라인으로 받는 문자 수로 설정했습니다.3192v2.1.276까지 이 키를 설정하여 Claude가 `TaskOutput` 도구로 작업을 읽을 때 인라인으로 받은 [백그라운드 작업](/docs/ko/tools-reference#background-commands)의 출력 문자 수를 설정했습니다.
3088 3193
3089<h2 id="interface-and-terminal">3194<h2 id="interface-and-terminal">
3090 인터페이스 및 터미널3195 인터페이스 및 터미널
3248}3353}
3249```3354```
3250 3355
3251권한 프롬프트 및 [`AskUserQuestion`](/docs/ko/tools-reference#askuserquestion-tool-behavior) 질문은 자체 흐름을 사용하며 이 기한의 적용을 받지 않습니다. 이 행은 `/config`에 **대화 상자 만료**로 표시되며, Claude Code v2.1.232 이상이 필요하고, Claude Code는 관리 설정이나 `--settings` 플래그가 키를 설정하는 동안 행을 숨깁니다.3356권한 프롬프트 및 [`AskUserQuestion`](/docs/ko/tools-reference#askuserquestion-tool-behavior) 질문은 자체 흐름을 사용하며 이 기한의 적용을 받지 않습니다. `/config`에 **대화 상자 만료**로 표시되며, 이 행은 Claude Code v2.1.232 이상이 필요하고, Claude Code는 관리 설정이나 `--settings` 플래그가 키를 설정하는 동안 행을 숨깁니다.
3252 3357
3253<h3 id="editormode">3358<h3 id="editormode">
3254 `editorMode`3359 `editorMode`
3401* **유형**: 문자열, `"classic"` 또는 `"readline"`3506* **유형**: 문자열, `"classic"` 또는 `"readline"`
3402* **기본값**: 설정되지 않음3507* **기본값**: 설정되지 않음
3403 3508
3509<h3 id="maxprosewidth">
3510 `maxProseWidth`
3511</h3>
3512
3513Claude의 응답에서 산문의 너비를 제한하여 넓은 터미널에서 줄이 읽기 쉽게 유지되도록 합니다. 단락, 제목, 목록 및 인용문은 이 많은 열 내에서 줄 바꿈되고, 표 및 코드 블록은 전체 터미널 너비를 유지합니다. Claude Code v2.1.282 이상이 필요합니다.
3514
3515* **범위**: [`모든 파일`](#scopes)
3516* **유형**: 터미널 열 수, 정수, 최소 `40`. Claude Code는 다른 값을 무시합니다
3517* **기본값**: 설정되지 않음, 따라서 산문은 터미널 가장자리에서 줄 바꿈됩니다
3518
3519```json settings.json theme={null}
3520{
3521 "maxProseWidth": 80
3522}
3523```
3524
3404<h3 id="prefersreducedmotion">3525<h3 id="prefersreducedmotion">
3405 `prefersReducedMotion`3526 `prefersReducedMotion`
3406</h3>3527</h3>
3462 `respondToBashCommands`3583 `respondToBashCommands`
3463</h3>3584</h3>
3464 3585
3465입력 상자에서 [`!` 접두사](/docs/ko/interactive-mode#shell-mode-with-prefix)로 셸 명령을 실행한 후 Claude가 응답할지 여부를 선택합니다. 기본적으로 Claude Code는 명령의 출력을 대화에 추가하고 Claude가 이에 응답합니다. 이 키를 `false`로 설정하면 응답 없이 출력을 컨텍스트에 추가하므로 여러 명령을 실행하고 함께 질문할 수 있습니다. Claude Code v2.1.186 이상이 필요합니다.3586입력 상자에서 [`!` 접두사](/docs/ko/interactive-mode#shell-mode-with-prefix)로 셸 명령을 실행한 후 Claude가 응답할지 여부를 선택합니다. 기본적으로 Claude Code는 명령의 출력을 대화에 추가하고 Claude가 이에 응답합니다. 이 키를 `false`로 설정하면 응답 없이 출력을 컨텍스트에 추가하므로 여러 명령을 실행하고 함께 질문할 수 있습니다.
3466 3587
3467* **범위**: [`모든 파일`](#scopes)3588* **범위**: [`모든 파일`](#scopes)
3468* **유형**: 부울3589* **유형**: 부울
3476}3597}
3477```3598```
3478 3599
3479[`!` 접두사를 사용한 셸 모드](/docs/ko/interactive-mode#shell-mode-with-prefix)를 참조하세요. Claude Code v2.1.186 이상이 필요합니다.3600[셸 모드와 `!` 접두사](/docs/ko/interactive-mode#shell-mode-with-prefix)를 참조하세요.
3480 3601
3481<h3 id="showclearcontextonplanaccept">3602<h3 id="showclearcontextonplanaccept">
3482 `showClearContextOnPlanAccept`3603 `showClearContextOnPlanAccept`
3983Claude Code가 git 커밋 및 풀 요청에 추가하는 속성을 사용자 정의합니다. 커밋은 기본적으로 `Co-Authored-By`와 같은 [git 트레일러](https://git-scm.com/docs/git-interpret-trailers)를 받습니다. 풀 요청 설명은 일반 텍스트를 받습니다. 아래의 하위 키를 사용하여 각 부분을 별도로 설정합니다.4104Claude Code가 git 커밋 및 풀 요청에 추가하는 속성을 사용자 정의합니다. 커밋은 기본적으로 `Co-Authored-By`와 같은 [git 트레일러](https://git-scm.com/docs/git-interpret-trailers)를 받습니다. 풀 요청 설명은 일반 텍스트를 받습니다. 아래의 하위 키를 사용하여 각 부분을 별도로 설정합니다.
3984 4105
3985* **범위**: [`모든 파일`](#scopes)4106* **범위**: [`모든 파일`](#scopes)
3986* **유형**: `commit` 및 `pr` 문자열과 `sessionUrl` 부울을 포함하는 객체4107* **유형**: `commit` 및 `pr` 문자열과 `sessionUrl` 부울을 포함하는 객체, 또는 모든 속성을 숨기려면 `false`. `false` 값은 Claude Code v2.1.281 이상이 필요합니다. 이전 버전은 이를 거부하고 [이를 포함하는 전체 사용자, 프로젝트 또는 로컬 설정 파일을 건너뜁니다](/docs/ko/settings#fix-a-broken-settings-file).
3987* **기본값**: 설정되지 않음. 따라서 Claude Code는 각 하위 키 아래에 표시된 표준 속성을 사용합니다.4108* **기본값**: 설정되지 않음. 따라서 Claude Code는 각 하위 키 아래에 표시된 표준 속성을 사용합니다.
3988 4109
4110모든 속성을 숨기려면 `attribution`을 `false`로 설정합니다. 이전 버전도 읽는 설정 파일에서는 [`commit`](#attribution-commit) 및 [`pr`](#attribution-pr)을 빈 문자열로 설정하고 [`sessionUrl`](#attribution-sessionurl)을 `false`로 설정합니다.
4111
3989이 예제는 커밋 속성을 바꾸고, 풀 요청 속성을 제거하며, 세션 링크를 삭제합니다:4112이 예제는 커밋 속성을 바꾸고, 풀 요청 속성을 제거하며, 세션 링크를 삭제합니다:
3990 4113
3991```json settings.json theme={null}4114```json settings.json theme={null}
3998}4121}
3999```4122```
4000 4123
4001모든 속성을 숨기려면 [`commit`](#attribution-commit) 및 [`pr`](#attribution-pr)을 빈 문자열로 설정하고 [`sessionUrl`](#attribution-sessionurl)을 `false`로 설정합니다. `commit` 또는 `pr`을 설정하면 Claude Code는 더 이상 사용되지 않는 `includeCoAuthoredBy` 설정을 무시하고 설정하지 않은 두 항목에 대해 기본 텍스트를 사용합니다.4124`commit` 또는 `pr`을 설정하면 Claude Code는 더 이상 사용되지 않는 `includeCoAuthoredBy` 설정을 무시하고 설정하지 않은 두 항목에 대해 기본 텍스트를 사용합니다.
4002 4125
4003Claude Code는 Claude에게 속성에 대한 사용자 정의 지침(예: CLAUDE.md 또는 [메모리](/docs/ko/memory) 규칙)이 이러한 커밋 및 PR 라인보다 우선한다고 알립니다. 단, 라인이 [관리되는 설정](/docs/ko/managed-settings)에서 설정된 경우는 제외합니다.4126Claude Code는 Claude에게 속성에 대한 사용자 정의 지침(예: CLAUDE.md 또는 [메모리](/docs/ko/memory) 규칙)이 이러한 커밋 및 PR 라인보다 우선한다고 알립니다. 단, 라인이 [관리되는 설정](/docs/ko/managed-settings)에서 설정된 경우는 제외합니다.
4004 4127
4024}4147}
4025```4148```
4026 4149
4027현재 모든 속성을 숨기려면 [`attribution.commit`](#attribution-commit) 및 [`attribution.pr`](#attribution-pr)을 빈 문자열로 설정하고 [`attribution.sessionUrl`](#attribution-sessionurl)을 `false`로 설정합니다.4150모든 속성을 숨기려면 [`attribution`](#attribution)을 참조하십시오.
4028 4151
4029<h3 id="includegitinstructions">4152<h3 id="includegitinstructions">
4030 `includeGitInstructions`4153 `includeGitInstructions`
4073 4196
4074* **범위**: [`모든 파일`](#scopes)4197* **범위**: [`모든 파일`](#scopes)
4075* **유형**: 문자열4198* **유형**: 문자열
4076* **기본값**: 설정되지 않음. 따라서 Claude Code는 `Co-Authored-By: <name> <noreply@anthropic.com>`을 추가합니다. 이름은 `Claude Sonnet 5`와 같은 세션의 활성 모델입니다.4199* **기본값**: 설정되지 않음. 따라서 Claude Code는 `Co-Authored-By: <name> <noreply@anthropic.com>`을 추가합니다. 이름은 `Claude Sonnet 5`와 같은 커밋이 만들어질 때 사용 중인 모델입니다. [서브에이전트](/docs/ko/sub-agents)가 커밋을 만들 때 트레일러는 서브에이전트의 모델을 이름으로 지정합니다.
4077 * Claude Code가 모델을 Claude 모델로 인식하지만 정확한 버전을 확인할 수 없는 경우 `Claude`만 작성합니다.4200 * Claude Code가 모델을 Claude 모델로 인식하지만 정확한 버전을 확인할 수 없는 경우 `Claude`만 작성합니다.
4078 * 모델 ID를 Claude 모델과 일치시킬 수 없는 경우(예: 사용자 정의 [`ANTHROPIC_BASE_URL`](/docs/ko/env-vars)을 통해 제공되는 타사 모델) `Claude Code`를 작성합니다.4201 * 모델 ID를 Claude 모델과 일치시킬 수 없는 경우(예: 사용자 정의 [`ANTHROPIC_BASE_URL`](/docs/ko/env-vars)을 통해 제공되는 타사 모델) `Claude Code`를 작성합니다.
4079 4202
4182* **관리되는 훅 및 SDK 훅 실행**: 관리되는 설정의 훅 및 [Agent SDK](/docs/ko/agent-sdk/overview)가 프로세스에 등록하는 훅4305* **관리되는 훅 및 SDK 훅 실행**: 관리되는 설정의 훅 및 [Agent SDK](/docs/ko/agent-sdk/overview)가 프로세스에 등록하는 훅
4183* **강제 활성화된 플러그인 훅 실행**: 관리되는 설정이 [`enabledPlugins`](#enabledplugins)를 통해 강제로 활성화하는 플러그인의 훅. Claude Code는 전체 `plugin@marketplace` ID와 일치하므로 다른 마켓플레이스의 동일한 이름의 플러그인은 차단된 상태로 유지됩니다. 이를 통해 조직 마켓플레이스를 통해 검증된 훅을 배포하면서 다른 모든 것을 차단할 수 있습니다.4306* **강제 활성화된 플러그인 훅 실행**: 관리되는 설정이 [`enabledPlugins`](#enabledplugins)를 통해 강제로 활성화하는 플러그인의 훅. Claude Code는 전체 `plugin@marketplace` ID와 일치하므로 다른 마켓플레이스의 동일한 이름의 플러그인은 차단된 상태로 유지됩니다. 이를 통해 조직 마켓플레이스를 통해 검증된 훅을 배포하면서 다른 모든 것을 차단할 수 있습니다.
4184* **다른 모든 것은 차단됨**: 사용자, 프로젝트 및 로컬 훅, 다른 플러그인의 훅, 에이전트 프론트매터에 선언된 훅4307* **다른 모든 것은 차단됨**: 사용자, 프로젝트 및 로컬 훅, 다른 플러그인의 훅, 에이전트 프론트매터에 선언된 훅
4185* **명령 소스 플러그인 비활성화**: Claude Code는 또한 [`disableCommandPluginSources`](#disablecommandpluginsources)를 명시적으로 `false`로 설정하지 않는 한 [`command` 소스](/docs/ko/plugin-marketplaces#command-sources)가 있는 플러그인(관리되는 `enabledPlugins`에서 강제로 활성화된 플러그인 포함)을 비활성화합니다.4308* **명령 소스 플러그인 비활성화**: Claude Code는 또한 [`disableCommandPluginSources`](#disablecommandpluginsources)를 명시적으로 `false`로 설정하지 않는 한 [`command` 소스](/docs/ko/plugins/marketplace-reference#command-plugin-source)가 있는 플러그인(관리되는 `enabledPlugins`에서 강제로 활성화된 플러그인 포함)을 비활성화합니다.
4186* **마켓플레이스 `headersHelper` 명령 차단**: Claude Code는 또한 [`disableCommandPluginSources`](#disablecommandpluginsources)가 명시적으로 `false`로 설정되지 않는 한 마켓플레이스 [`headersHelper` 명령](/docs/ko/plugin-marketplaces#authenticate-archive-downloads)을 차단합니다. 단, 관리되는 설정 자체가 선언하는 마켓플레이스는 제외됩니다. Claude Code v2.1.238 이상이 필요합니다.4309* **마켓플레이스 `headersHelper` 명령 차단**: Claude Code는 또한 [`disableCommandPluginSources`](#disablecommandpluginsources)가 명시적으로 `false`로 설정되지 않는 한 마켓플레이스 [`headersHelper` 명령](/docs/ko/plugins/host-marketplace#authenticate-archive-downloads)을 차단합니다. 단, 관리되는 설정 자체가 선언하는 마켓플레이스는 제외됩니다. Claude Code v2.1.238 이상이 필요합니다.
4187* **상태 줄 및 파일 제안이 관리되는 설정으로 좁혀짐**: Claude Code는 [상태 줄 및 파일 제안 게이트](#status-line-and-file-suggestion-gates)를 따르면서 관리되는 설정에서만 [`statusLine`](/docs/ko/statusline), [`fileSuggestion`](#filesuggestion), [`subagentStatusLine`](/docs/ko/statusline#subagent-status-lines)을 읽습니다.4310* **상태 줄 및 파일 제안이 관리되는 설정으로 좁혀짐**: Claude Code는 [상태 줄 및 파일 제안 게이트](#status-line-and-file-suggestion-gates)를 따르면서 관리되는 설정에서만 [`statusLine`](/docs/ko/statusline), [`fileSuggestion`](#filesuggestion), [`subagentStatusLine`](/docs/ko/statusline#subagent-status-lines)을 읽습니다.
4188 4311
4189[`/goal`](/docs/ko/goal) 명령은 이 키가 설정된 동안 실행할 수 없습니다. 훅에 따라 달라지기 때문입니다.4312[`/goal`](/docs/ko/goal) 명령은 이 키가 설정된 동안 실행할 수 없습니다. 훅에 따라 달라지기 때문입니다.
4367 플러그인 및 스킬4490 플러그인 및 스킬
4368</h2>4491</h2>
4369 4492
4370플러그인을 활성화하고, 마켓플레이스를 등록하고, 조직이 허용하는 플러그인 소스를 제한하고, 로드되는 스킬을 제어합니다. 플러그인 설치 및 빌드에 대해서는 [플러그인](/docs/ko/plugins)을 참조하십시오.4493플러그인을 활성화하고, 마켓플레이스를 등록하고, 조직이 허용하는 플러그인 소스를 제한하고, 로드되는 스킬을 제어합니다. 플러그인 설치 및 빌드에 대해서는 [플러그인](/docs/ko/plugins/overview)을 참조하십시오.
4371 4494
4372<h3 id="disablebundledskills">4495<h3 id="disablebundledskills">
4373 `disableBundledSkills`4496 `disableBundledSkills`
4374</h3>4497</h3>
4375 4498
4376Claude Code에 포함된 [스킬](/docs/ko/skills) 및 워크플로우를 끕니다. Claude Code는 번들된 스킬과 워크플로우를 완전히 제거하는 한편, `/init`과 같은 기본 제공 명령어는 입력 가능하지만 모델에서 숨겨집니다.4499Claude Code에 포함된 [스킬](/docs/ko/skills) 및 워크플로우를 끕니다. Claude Code는 번들 스킬 및 워크플로우를 완전히 제거하는 한편, `/init`과 같은 기본 제공 명령어는 입력 가능하지만 모델에서 숨겨집니다.
4377 4500
4378* **범위**: [`모든 파일`](#scopes)4501* **범위**: [`모든 파일`](#scopes)
4379* **유형**: Boolean4502* **유형**: 부울
4380 * `true`: Claude Code는 번들된 스킬과 워크플로우를 제거하고 `/init`과 같은 기본 제공 명령어를 모델에서 숨깁니다4503 * `true`: Claude Code는 번들 스킬 및 워크플로우를 제거하고 `/init`과 같은 기본 제공 명령어를 모델에서 숨깁니다
4381 * `false`: 번들된 스킬이 로드됩니다4504 * `false`: 번들 스킬이 로드됩니다
4382* **기본값**: 설정되지 않음, 따라서 번들된 스킬이 로드됩니다4505* **기본값**: 설정되지 않음, 따라서 번들 스킬이 로드됩니다
4383* **세션별 재정의**: [`CLAUDE_CODE_DISABLE_BUNDLED_SKILLS`](/docs/ko/env-vars)를 `1`로 설정하면 한 세션 동안 번들된 스킬이 꺼집니다. 둘 중 하나가 스킬을 끄면 다른 하나는 다시 켤 수 없습니다4506* **세션별 재정의**: [`CLAUDE_CODE_DISABLE_BUNDLED_SKILLS`](/docs/ko/env-vars)를 `1`로 설정하면 한 세션 동안 번들 스킬이 꺼집니다. 둘 중 하나가 스킬을 끄면 다른 하나는 다시 켤 수 없습니다
4384 4507
4385```json settings.json theme={null}4508```json settings.json theme={null}
4386{4509{
4388}4511}
4389```4512```
4390 4513
4391플러그인, `.claude/skills/`, `.claude/commands/`의 스킬은 영향을 받지 않습니다. `/doctor`는 기본 제공 명령어처럼 입력 가능합니다. 이를 숨기려면 대신 [`DISABLE_DOCTOR_COMMAND`](/docs/ko/env-vars)를 설정하십시오.4514플러그인, `.claude/skills/`, `.claude/commands/`의 스킬은 영향을 받지 않습니다. `/doctor`는 기본 제공 명령어처럼 입력 가능하며, 이를 숨기려면 대신 [`DISABLE_DOCTOR_COMMAND`](/docs/ko/env-vars)를 설정하십시오.
4392 4515
4393<h3 id="disableskillshellexecution">4516<h3 id="disableskillshellexecution">
4394 `disableSkillShellExecution`4517 `disableSkillShellExecution`
4396 4519
4397[스킬](/docs/ko/skills) 및 사용자, 프로젝트, 플러그인 또는 추가 디렉터리 소스의 사용자 정의 명령어에서 `` !`...` `` 및 ` ```! ` 블록에 대한 인라인 셸 실행을 끕니다. Claude Code는 각 명령어를 실행하는 대신 `[shell command execution disabled by policy]`로 바꿉니다.4520[스킬](/docs/ko/skills) 및 사용자, 프로젝트, 플러그인 또는 추가 디렉터리 소스의 사용자 정의 명령어에서 `` !`...` `` 및 ` ```! ` 블록에 대한 인라인 셸 실행을 끕니다. Claude Code는 각 명령어를 실행하는 대신 `[shell command execution disabled by policy]`로 바꿉니다.
4398 4521
4399* **범위**: [`모든 파일`](#scopes). 관리되는 설정의 `true`는 다른 곳의 `false`로 재정의될 수 없습니다.4522* **범위**: [`모든 파일`](#scopes). 관리 설정의 `true`는 다른 곳의 `false`로 재정의될 수 없습니다.
4400* **유형**: Boolean4523* **유형**: 부울
4401 * `true`: Claude Code는 각 인라인 셸 명령어를 실행하는 대신 `[shell command execution disabled by policy]`로 바꿉니다4524 * `true`: Claude Code는 각 인라인 셸 명령어를 실행하는 대신 `[shell command execution disabled by policy]`로 바꿉니다
4402 * `false`: 인라인 셸이 실행됩니다4525 * `false`: 인라인 셸이 실행됩니다
4403* **기본값**: 설정되지 않음, 따라서 인라인 셸이 실행됩니다4526* **기본값**: 설정되지 않음, 따라서 인라인 셸이 실행됩니다
4408}4531}
4409```4532```
4410 4533
4411번들된 스킬과 관리되는 설정을 통해 배포된 스킬은 영향을 받지 않습니다.4534번들 스킬 및 관리 설정을 통해 배포된 스킬은 영향을 받지 않습니다.
4412 4535
4413<h3 id="skilloverrides">4536<h3 id="skilloverrides">
4414 `skillOverrides`4537 `skillOverrides`
4415</h3>4538</h3>
4416 4539
4417[스킬](/docs/ko/skills#override-skill-visibility-from-settings)의 `SKILL.md`를 편집하지 않고 숨기거나 축소합니다. Claude Code는 각 스킬 이름 아래의 값을 Claude가 보는 스킬 목록과 `/` 자동 완성에 적용합니다.4540[스킬](/docs/ko/skills#override-skill-visibility-from-settings)의 `SKILL.md`를 편집하지 않고 스킬을 숨기거나 축소합니다. Claude Code는 각 스킬 이름 아래의 값을 Claude가 보는 스킬 목록 및 `/` 자동 완성에 적용합니다.
4418 4541
4419* **범위**: [`모든 파일`](#scopes). `/skills` 메뉴는 `.claude/settings.local.json`에 씁니다.4542* **범위**: [`모든 파일`](#scopes). `/skills` 메뉴는 `.claude/settings.local.json`에 씁니다.
4420* **유형**: 스킬 이름을 다음 중 하나로 매핑하는 객체:4543* **유형**: 스킬 이름을 다음 중 하나에 매핑하는 객체:
4421 * `"on"`: Claude가 스킬을 보고 `/name`을 입력할 수 있습니다4544 * `"on"`: Claude가 스킬을 보고 `/name`을 입력할 수 있습니다
4422 * `"name-only"`: Claude가 설명 없이 스킬을 이름으로만 봅니다4545 * `"name-only"`: Claude가 설명 없이 스킬을 이름으로만 봅니다
4423 * `"user-invocable-only"`: Claude가 스킬을 보지 못하지만 여전히 `/name`을 입력할 수 있습니다4546 * `"user-invocable-only"`: Claude가 스킬을 보지 못하지만 여전히 `/name`을 입력할 수 있습니다
4435}4558}
4436```4559```
4437 4560
4438재정의는 플러그인 스킬에 적용되지 않으며, 이는 `/plugin`을 통해 관리합니다.4561재정의는 플러그인 스킬에 적용되지 않으며, `/plugin`을 통해 관리합니다.
4439 4562
4440관리되는 설정 및 `--settings`로 전달된 파일에서, `/doctor`의 `checkup`과 같은 번들된 스킬의 별칭에 대한 키도 스킬에 적용됩니다. [별칭 키가 스킬 자체 이름의 키와 어떻게 결합되는지](/docs/ko/skills#override-skill-visibility-from-settings)를 참조하십시오.4563관리 설정 및 `--settings`로 전달된 파일에서 `/doctor`의 `checkup`과 같은 번들 스킬의 별칭에 대한 키도 스킬에 적용됩니다. [별칭 키가 스킬 자체 이름의 키와 어떻게 결합되는지](/docs/ko/skills#override-skill-visibility-from-settings)를 참조하십시오.
4441 4564
4442<h3 id="syncclaudeaiskills">4565<h3 id="syncclaudeaiskills">
4443 `syncClaudeAiSkills`4566 `syncClaudeAiSkills`
4444</h3>4567</h3>
4445 4568
4446[claude.ai 계정에서 활성화한 스킬](/docs/ko/skills#how-synced-skills-behave)의 다운로드를 끕니다. Claude Code는 [claude.ai 계정으로 로그인한 터미널 세션](/docs/ko/skills#where-synced-skills-load)에서 이를 `~/.claude/skills/synced/`로 다운로드합니다. 대화형 또는 비대화형이며, Cowork 및 클라우드 세션에서도 다운로드합니다. `false`로 설정하여 해당 다운로드를 중지하고 이미 동기화된 스킬을 로드하지 않도록 합니다. Claude Code는 `false`만 인정합니다. `true`는 설정되지 않은 것과 같으며 동기화를 켜지 않습니다.4569[claude.ai 계정에 대해 활성화된 스킬](/docs/ko/skills#how-synced-skills-behave)의 다운로드를 끕니다. Claude Code는 [claude.ai 계정으로 로그인하는 터미널 세션](/docs/ko/skills#where-synced-skills-load)에서 `~/.claude/skills/synced/`로 다운로드하며, 대화형 또는 비대화형이고 Cowork 및 클라우드 세션에서도 다운로드합니다. `false`로 설정하여 해당 다운로드를 중지하고 이미 동기화된 스킬 로드를 중지합니다. Claude Code는 `false`만 인정합니다. `true`는 설정되지 않은 것과 같으며 다른 곳에서 꺼진 동기화를 켜지 않습니다.
4447 4570
4448* **범위**: [`사용자, 로컬 또는 관리됨`](#scopes), 그리고 `--settings`로 전달된 파일. 저장소는 이를 끌 수 없습니다.4571* **범위**: [`사용자, 로컬 또는 관리`](#scopes), 및 `--settings`로 전달된 파일. 저장소는 이를 끌 수 없습니다.
4449* **유형**: Boolean4572* **유형**: 부울
4450 * `false`: Claude Code는 동기화된 스킬 다운로드를 중지하고 `~/.claude/skills/synced/`에 있는 스킬을 로드하지 않습니다. 사용자 또는 관리되는 설정에서 이를 `~/.claude/skills/.trash/`로 이동합니다4573 * `false`: Claude Code는 동기화된 스킬 다운로드를 중지하고 `~/.claude/skills/synced/`에 있는 스킬 로드를 중지합니다. 사용자 또는 관리 설정에서 `~/.claude/skills/.trash/`로도 이동합니다
4451 * `true`: 설정되지 않은 것과 같습니다4574 * `true`: 설정되지 않은 것과 같습니다
4452* **기본값**: 설정되지 않음, 따라서 claude.ai 계정으로 로그인한 세션은 스킬을 동기화합니다4575* **기본값**: 설정되지 않음, 따라서 claude.ai 계정으로 로그인한 세션은 스킬을 동기화합니다
4453 4576
4454이 예제는 머신이 계정의 스킬을 어떤 세션에서도 다운로드하지 않도록 합니다:4577이 예제는 머신이 모든 세션에서 계정의 스킬을 다운로드하지 않도록 유지합니다:
4455 4578
4456```json settings.json theme={null}4579```json settings.json theme={null}
4457{4580{
4463 `syncClaudeAiPlugins`4586 `syncClaudeAiPlugins`
4464</h3>4587</h3>
4465 4588
4466[claude.ai 계정에서 활성화한 플러그인](/docs/ko/plugins-reference#synced-plugins)의 다운로드를 끕니다. Claude Code는 claude.ai 계정으로 로그인한 터미널 세션의 시작 시 이를 `~/.claude/plugins/synced/`로 다운로드하고, Cowork 및 클라우드 세션에서도 다운로드하며, 각각을 `<name>@synced`로 로드합니다. `false`로 설정하여 해당 다운로드를 중지하고 이미 동기화된 플러그인을 로드하지 않도록 합니다. Claude Code는 `false`만 인정합니다. `true`는 설정되지 않은 것과 같으며 동기화를 켜지 않습니다. Claude Code v2.1.273 이상이 필요합니다.4589[claude.ai 계정에 대해 활성화된 플러그인](/docs/ko/plugins/loading#synced-plugins)의 다운로드를 끕니다. Claude Code는 claude.ai 계정으로 로그인하는 터미널 세션의 시작 부분에서 `~/.claude/plugins/synced/`로 다운로드하고 Cowork 세션에서도 다운로드하며, 각각을 `<name>@synced`로 로드합니다. `false`로 설정하여 해당 다운로드를 중지하고 이미 동기화된 플러그인 로드를 중지합니다. Claude Code는 `false`만 인정합니다. `true`는 설정되지 않은 것과 같으며 다른 곳에서 꺼진 동기화를 켜지 않습니다. Claude Code v2.1.273 이상이 필요합니다.
4467 4590
4468* **범위**: [`사용자, 로컬 또는 관리됨`](#scopes), 그리고 `--settings`로 전달된 파일. 저장소는 이를 끌 수 없습니다.4591* **범위**: [`사용자, 로컬 또는 관리`](#scopes), 및 `--settings`로 전달된 파일. 저장소는 이를 끌 수 없습니다.
4469* **유형**: Boolean4592* **유형**: 부울
4470 * `false`: Claude Code는 동기화된 플러그인 다운로드를 중지하고 `~/.claude/plugins/synced/`에 있는 플러그인을 로드하지 않습니다. 사용자 또는 관리되는 설정에서 이를 `~/.claude/plugins/.trash/`로 이동합니다4593 * `false`: Claude Code는 동기화된 플러그인 다운로드를 중지하고 `~/.claude/plugins/synced/`에 있는 플러그인 로드를 중지합니다. 사용자 또는 관리 설정에서 `~/.claude/plugins/.trash/`로도 이동합니다
4471 * `true`: 설정되지 않은 것과 같습니다4594 * `true`: 설정되지 않은 것과 같습니다
4472* **기본값**: 설정되지 않음, 따라서 claude.ai 계정으로 로그인한 세션은 플러그인을 동기화합니다4595* **기본값**: 설정되지 않음, 따라서 claude.ai 계정으로 로그인한 세션은 플러그인을 동기화합니다
4473 4596
4474모든 동기화된 플러그인 대신 하나의 동기화된 플러그인을 끄려면 [`enabledPlugins`](#enabledplugins)에서 `"<name>@synced": false`를 설정하십시오.4597모든 동기화된 플러그인이 아닌 하나의 동기화된 플러그인을 끄려면 [`enabledPlugins`](#enabledplugins)에서 `"<name>@synced": false`를 설정합니다.
4475 4598
4476이 예제는 머신이 계정의 플러그인을 어떤 세션에서도 다운로드하지 않도록 합니다:4599이 예제는 머신이 모든 세션에서 계정의 플러그인을 다운로드하지 않도록 유지합니다:
4477 4600
4478```json managed-settings.json theme={null}4601```json settings.json theme={null}
4479{4602{
4480 "syncClaudeAiPlugins": false4603 "syncClaudeAiPlugins": false
4481}4604}
4485 `allowedChannelPlugins`4608 `allowedChannelPlugins`
4486</h3>4609</h3>
4487 4610
4488[채널](/docs/ko/channels) 플러그인이 조직의 세션에 메시지를 푸시할 수 있는 플러그인을 선택합니다. 이를 설정하면 Claude Code는 기본 Anthropic 허용 목록 대신 목록을 사용합니다. 각 항목은 플러그인과 플러그인이 나오는 마켓플레이스의 이름을 지정합니다.4611[채널](/docs/ko/channels) 플러그인이 조직의 세션에 메시지를 푸시할 수 있는 채널을 선택합니다. 이를 설정하면 Claude Code는 기본 Anthropic 허용 목록 대신 목록을 사용합니다. 각 항목은 플러그인과 플러그인이 나오는 마켓플레이스의 이름을 지정합니다.
4489 4612
4490* **범위**: [`관리됨`](#scopes)4613* **범위**: [`관리`](#scopes)
4491* **유형**: 각각 `marketplace` 및 `plugin` 문자열을 포함하는 객체의 배열입니다. 항목은 `"telegram@claude-plugins-official"`과 같은 `"plugin@marketplace"` 문자열일 수 있으며, Claude Code는 이를 동등한 객체로 취급합니다. 문자열 형식은 Claude Code v2.1.267 이상이 필요합니다. 이전 버전은 하나를 포함할 때 전체 `allowedChannelPlugins` 값을 거부합니다4614* **유형**: 각각 `marketplace` 및 `plugin` 문자열을 포함하는 객체의 배열. 항목은 대신 `"telegram@claude-plugins-official"`과 같은 `"plugin@marketplace"` 문자열일 수 있으며, Claude Code는 이를 동등한 객체로 취급합니다. 문자열 형식은 Claude Code v2.1.267 이상이 필요합니다. 이전 버전은 하나를 포함할 때 전체 `allowedChannelPlugins` 값을 거부합니다
4492* **기본값**: 설정되지 않음, 따라서 Claude Code는 기본 Anthropic 허용 목록을 사용합니다4615* **기본값**: 설정되지 않음, 따라서 Claude Code는 기본 Anthropic 허용 목록을 사용합니다
4493 4616
4494이 예제는 채널을 켜고 공식 Anthropic 마켓플레이스의 Telegram 플러그인만 허용합니다:4617이 예제는 채널을 켜고 공식 Anthropic 마켓플레이스의 Telegram 플러그인만 허용합니다:
4504 4627
4505빈 배열은 모든 채널 플러그인을 차단합니다.4628빈 배열은 모든 채널 플러그인을 차단합니다.
4506 4629
4507이 키는 채널이 계정에 대한 [`channelsEnabled`](#channelsenabled) 게이트를 통과한 후에 적용됩니다. Team 및 Enterprise 플랜과 관리되는 설정이 있는 Console 계정에서는 `channelsEnabled: true`를 의미합니다. [채널 플러그인 실행 제한](/docs/ko/channels#restrict-which-channel-plugins-can-run)을 참조하십시오.4630이 키는 채널이 계정에 대해 [`channelsEnabled`](#channelsenabled) 게이트를 통과한 후에 적용됩니다. Team 및 Enterprise 플랜에서, 그리고 관리 설정이 있는 Console 계정에서는 `channelsEnabled: true`를 의미합니다. [채널 플러그인 실행 제한](/docs/ko/channels#restrict-which-channel-plugins-can-run)을 참조하십시오.
4508 4631
4509<h3 id="blockedmarketplaces">4632<h3 id="blockedmarketplaces">
4510 `blockedMarketplaces`4633 `blockedMarketplaces`
4512 4635
4513조직의 플러그인 마켓플레이스 소스를 차단합니다. Claude Code는 마켓플레이스 추가 및 플러그인 설치, 업데이트, 새로 고침 및 자동 업데이트 시 차단 목록을 확인하므로, 정책을 설정하기 전에 누군가 추가한 마켓플레이스는 플러그인을 가져오는 데 사용될 수 없습니다. 차단된 소스는 다운로드 전에 확인되므로 파일 시스템에 닿지 않습니다.4636조직의 플러그인 마켓플레이스 소스를 차단합니다. Claude Code는 마켓플레이스 추가 및 플러그인 설치, 업데이트, 새로 고침 및 자동 업데이트 시 차단 목록을 확인하므로, 정책을 설정하기 전에 누군가 추가한 마켓플레이스는 플러그인을 가져오는 데 사용될 수 없습니다. 차단된 소스는 다운로드 전에 확인되므로 파일 시스템에 닿지 않습니다.
4514 4637
4515* **범위**: [`관리됨`](#scopes)4638[claude.ai 관리 콘솔](/docs/ko/server-managed-settings)에서 이 키를 설정하면 claude.ai는 조직의 누구든 claude.ai에서 git 저장소의 마켓플레이스를 추가할 때도 적용합니다. [제한 작동 방식](/docs/ko/plugins/org#restrict-what-users-can-install)에서 설명합니다.
4639
4640* **범위**: [`관리`](#scopes)
4516* **유형**: [`strictKnownMarketplaces`](#allowed-source-types)와 동일한 형식의 마켓플레이스 소스 객체 배열4641* **유형**: [`strictKnownMarketplaces`](#allowed-source-types)와 동일한 형식의 마켓플레이스 소스 객체 배열
4517* **기본값**: 설정되지 않음, 따라서 마켓플레이스가 차단되지 않습니다4642* **기본값**: 설정되지 않음, 따라서 마켓플레이스가 차단되지 않습니다
4518 4643
4526}4651}
4527```4652```
4528 4653
4529`github` 항목은 [소유자 와일드카드 형식](#owner-wildcards) `"owner/*"`을 사용하여 해당 GitHub 소유자 아래의 모든 저장소를 차단할 수 있으며, 이는 Claude Code v2.1.223 이상이 필요합니다. `{ "source": "skills-dir" }`을 추가하여 Claude Code가 `~/.claude/skills/`에서 [`@skills-dir` 플러그인](/docs/ko/plugins-reference#skills-directory-plugins)을 로드하지 않도록 하면서 마켓플레이스를 제한하지 않습니다. [관리되는 마켓플레이스 제한](/docs/ko/plugin-marketplaces#managed-marketplace-restrictions)을 참조하십시오.4654GitHub 항목은 [소유자 와일드카드 형식](#owner-wildcards) `"owner/*"`을 사용하여 해당 GitHub 소유자 아래의 모든 저장소를 차단할 수 있으며, Claude Code v2.1.223 이상이 필요합니다. `{ "source": "skills-dir" }`을 추가하여 Claude Code가 마켓플레이스를 제한하지 않고 `~/.claude/skills/`에서 [`@skills-dir` 플러그인](/docs/ko/plugins/loading#plugins-shared-through-a-repository)을 로드하지 않도록 합니다. [관리 마켓플레이스 제한](/docs/ko/plugins/org#restrict-what-users-can-install)을 참조하십시오.
4530 4655
4531<h3 id="channelsenabled">4656<h3 id="channelsenabled">
4532 `channelsEnabled`4657 `channelsEnabled`
4533</h3>4658</h3>
4534 4659
4535조직의 [채널](/docs/ko/channels)을 허용합니다. claude.ai Team 및 Enterprise 플랜에서 Claude Code는 이를 `true`로 설정할 때까지 채널을 차단합니다. API 키로 인증하는 [Anthropic Console](/docs/ko/authentication#claude-console-authentication) 계정의 경우 채널이 기본적으로 허용됩니다. 조직이 관리되는 설정을 배포하는 경우 Claude Code는 이 키를 `true`로 설정할 때까지 해당 계정의 채널을 차단합니다.4660조직의 [채널](/docs/ko/channels)을 허용합니다. claude.ai Team 및 Enterprise 플랜에서 Claude Code는 이를 `true`로 설정할 때까지 채널을 차단합니다. API 키로 인증하는 [Anthropic Console](/docs/ko/authentication#claude-console-authentication) 계정의 경우 채널이 기본적으로 허용됩니다. 조직이 관리 설정을 배포하면 Claude Code는 이 키를 `true`로 설정할 때까지 해당 계정의 채널도 차단합니다.
4536 4661
4537* **범위**: [`관리됨`](#scopes)4662* **범위**: [`관리`](#scopes)
4538* **유형**: Boolean4663* **유형**: 부울
4539 * `true`: Claude Code는 조직의 채널을 허용합니다4664 * `true`: Claude Code는 조직의 채널을 허용합니다
4540 * `false`: 설정되지 않은 것과 같습니다. 채널이 차단되는지 여부는 기본값이 말하는 대로 플랜에 따라 다릅니다4665 * `false`: 설정되지 않은 것과 같습니다. 채널이 차단되는지 여부는 기본값에서 설명하는 대로 플랜에 따라 다릅니다
4541* **기본값**: 설정되지 않음. 채널은 Team 및 Enterprise 플랜과 관리되는 설정이 있는 Console 계정에서 차단되고, Pro 및 Max 플랜과 관리되는 설정이 없는 Console 계정에서 허용됩니다4666* **기본값**: 설정되지 않음. 채널은 Team 및 Enterprise 플랜에서 차단되고 관리 설정이 있는 Console 계정에서 차단되며, Pro 및 Max 플랜에서 허용되고 관리 설정이 없는 Console 계정에서 허용됩니다
4542 4667
4543```json managed-settings.json theme={null}4668```json managed-settings.json theme={null}
4544{4669{
4546}4671}
4547```4672```
4548 4673
4549활성화된 후 플러그인이 채널로 등록할 수 있는 것을 제한하려면 [`allowedChannelPlugins`](#allowedchannelplugins)를 설정하십시오. [엔터프라이즈 제어](/docs/ko/channels#enterprise-controls)를 참조하십시오.4674활성화된 후 플러그인이 채널로 등록할 수 있는 것을 제한하려면 [`allowedChannelPlugins`](#allowedchannelplugins)을 설정합니다. [엔터프라이즈 제어](/docs/ko/channels#enterprise-controls)를 참조하십시오.
4550 4675
4551<h3 id="disablecommandpluginsources">4676<h3 id="disablecommandpluginsources">
4552 `disableCommandPluginSources`4677 `disableCommandPluginSources`
4553</h3>4678</h3>
4554 4679
4555[`command` 플러그인 소스](/docs/ko/plugin-marketplaces#command-sources)를 차단합니다. 이는 사용자의 머신에서 마켓플레이스가 선언한 명령어를 실행하여 플러그인을 설치합니다. 이를 `true`로 설정하면 Claude Code는 명령어를 실행하지 않고, 명령어 소스 플러그인을 설치 또는 업데이트하지 않으며, 이미 설치된 플러그인 로드를 중지합니다. `false`로 설정하여 명시적으로 허용합니다. 명령어 소스를 차단할 때마다, `true`로 설정하든 [`allowManagedHooksOnly`](#allowmanagedhooksonly) 아래에서 설정되지 않은 상태로 두든, 마켓플레이스 [`headersHelper` 명령어](/docs/ko/plugin-marketplaces#authenticate-archive-downloads)도 차단합니다. 단, 관리되는 설정 자체가 선언하는 마켓플레이스는 제외합니다. Claude Code v2.1.229 이상이 필요하며, `headersHelper` 차단은 v2.1.238 이상이 필요합니다.4680[`command` 플러그인 소스](/docs/ko/plugins/marketplace-reference#command-plugin-source)를 차단합니다. 이는 사용자의 머신에서 마켓플레이스 선언 명령어를 실행하여 플러그인을 설치합니다. 이를 `true`로 설정하면 Claude Code는 명령어를 실행하지 않으며, 명령어 소스 플러그인을 설치 또는 업데이트하지 않고, 이미 설치된 플러그인 로드를 중지합니다. `false`로 설정하여 명시적으로 허용합니다. 명령어 소스를 차단할 때마다, `true`로 설정하든 [`allowManagedHooksOnly`](#allowmanagedhooksonly) 아래에서 설정되지 않은 상태로 두든, 마켓플레이스 [`headersHelper` 명령어](/docs/ko/plugins/host-marketplace#authenticate-archive-downloads)도 차단합니다. 단, 관리 설정 자체가 선언하는 마켓플레이스는 제외합니다. Claude Code v2.1.229 이상이 필요하며, `headersHelper` 차단은 v2.1.238 이상이 필요합니다.
4556 4681
4557* **범위**: [`관리됨`](#scopes)4682* **범위**: [`관리`](#scopes)
4558* **유형**: Boolean4683* **유형**: 부울
4559 * `true`: Claude Code는 마켓플레이스가 선언한 명령어를 실행하지 않고, 명령어 소스 플러그인을 설치 또는 업데이트하지 않으며, 이미 설치된 플러그인 로드를 중지합니다4684 * `true`: Claude Code는 마켓플레이스 선언 명령어를 실행하지 않으며, 명령어 소스 플러그인을 설치 또는 업데이트하지 않고, 이미 설치된 플러그인 로드를 중지합니다
4560 * `false`: Claude Code는 명령어 소스 플러그인을 명시적으로 허용합니다4685 * `false`: Claude Code는 명령어 소스 플러그인을 명시적으로 허용합니다
4561* **기본값**: 설정되지 않음, 따라서 Claude Code는 [`allowManagedHooksOnly`](#allowmanagedhooksonly)를 따릅니다. 훅 실행을 관리되는 설정으로 제한하는 조직은 명령어 소스도 비활성화됩니다4686* **기본값**: 설정되지 않음, 따라서 Claude Code는 [`allowManagedHooksOnly`](#allowmanagedhooksonly)를 따릅니다. 훅 실행을 관리 설정으로 제한하는 조직은 명령어 소스도 비활성화됩니다
4562 4687
4563```json managed-settings.json theme={null}4688```json managed-settings.json theme={null}
4564{4689{
4572 `pluginSuggestionMarketplaces`4697 `pluginSuggestionMarketplaces`
4573</h3>4698</h3>
4574 4699
4575상황별 설치 제안으로 나타날 수 있는 플러그인의 마켓플레이스 이름을 지정합니다. 스피너 팁과 `/plugin` **Discover** 탭의 상단에 고정됩니다. 기본 제공 퍼스트 파티 프론트엔드 디자인 팁은 영향을 받지 않습니다. 제안은 각 플러그인의 마켓플레이스 항목의 `relevance` 선언에서 나옵니다.4700스피너 팁 및 `/plugin` **Discover** 탭 상단에 고정된 상황별 설치 제안으로 나타날 수 있는 플러그인의 마켓플레이스 이름을 지정합니다. 기본 제공 자사 프론트엔드 설계 팁은 영향을 받지 않습니다. 제안은 각 플러그인의 마켓플레이스 항목의 `relevance` 선언에서 나옵니다.
4576 4701
4577* **범위**: [`관리됨`](#scopes)4702* **범위**: [`관리`](#scopes)
4578* **유형**: 마켓플레이스 이름의 배열4703* **유형**: 마켓플레이스 이름의 배열
4579* **기본값**: 설정되지 않음, 따라서 마켓플레이스가 선언한 제안이 표시되지 않습니다4704* **기본값**: 설정되지 않음, 따라서 마켓플레이스 선언 제안이 표시되지 않습니다
4580 4705
4581```json managed-settings.json theme={null}4706```json managed-settings.json theme={null}
4582{4707{
4584}4709}
4585```4710```
4586 4711
4587이름은 마켓플레이스가 머신에 등록되고 등록된 소스가 동일한 관리되는 설정에서도 선언될 때만 적용됩니다. 해당 이름의 [`extraKnownMarketplaces`](#extraknownmarketplaces) 항목 또는 [`strictKnownMarketplaces`](#strictknownmarketplaces)의 항목으로 선언됩니다. Claude Code는 허용 목록 이름 아래의 다른 소스에서 등록된 마켓플레이스를 무시합니다. 공식 마켓플레이스는 소스 요구 사항에서 제외됩니다. 이름만 허용 목록에 추가하면 충분합니다. 해당 이름은 공식 Anthropic 소스에서만 등록할 수 있기 때문입니다. [컨텍스트별 플러그인 제안](/docs/ko/plugin-relevance)을 참조하십시오.4712이름은 마켓플레이스가 머신에 등록되고 등록된 소스가 동일한 관리 설정에서도 선언될 때만 적용됩니다. 해당 이름의 [`extraKnownMarketplaces`](#extraknownmarketplaces) 항목 또는 [`strictKnownMarketplaces`](#strictknownmarketplaces)의 항목으로 선언됩니다. Claude Code는 허용 목록 이름 아래에서 다른 소스에서 등록된 마켓플레이스를 무시합니다. 공식 마켓플레이스는 소스 요구 사항에서 제외됩니다. 공식 Anthropic 소스에서만 등록할 수 있으므로 이름만 허용 목록에 추가하면 충분합니다. [컨텍스트별 플러그인 제안](/docs/ko/plugins/relevance)을 참조하십시오.
4588 4713
4589<h3 id="plugintrustmessage">4714<h3 id="plugintrustmessage">
4590 `pluginTrustMessage`4715 `pluginTrustMessage`
4591</h3>4716</h3>
4592 4717
4593설치 전에 Claude Code가 표시하는 플러그인 신뢰 경고에 조직의 고유한 텍스트를 추가합니다. 예를 들어 내부 마켓플레이스의 플러그인이 검증되었음을 확인합니다.4718설치 전에 Claude Code가 표시하는 플러그인 신뢰 경고에 조직의 자체 텍스트를 추가합니다. 예를 들어 내부 마켓플레이스의 플러그인이 검증되었음을 확인합니다.
4594 4719
4595* **범위**: [`관리됨`](#scopes)4720* **범위**: [`관리`](#scopes)
4596* **유형**: 문자열4721* **유형**: 문자열
4597* **기본값**: 설정되지 않음, 따라서 Claude Code는 표준 경고만 표시합니다4722* **기본값**: 설정되지 않음, 따라서 Claude Code는 표준 경고만 표시합니다
4598 4723
4606 `strictKnownMarketplaces`4731 `strictKnownMarketplaces`
4607</h3>4732</h3>
4608 4733
4609조직의 사람들이 플러그인을 추가하고 설치할 수 있는 플러그인 마켓플레이스 소스를 제한합니다. Claude Code는 마켓플레이스 추가 및 플러그인 설치, 업데이트, 새로 고침 및 자동 업데이트 시 허용 목록을 적용합니다. 네트워크 또는 파일 시스템 작업 전에 적용되므로, 정책을 설정하기 전에 누군가 추가한 마켓플레이스는 소스가 더 이상 일치하지 않으면 플러그인을 가져오는 데 사용될 수 없습니다. 차단된 사용자는 관리되는 정책의 이름을 지정하는 오류를 봅니다.4734조직의 사람들이 추가하고 플러그인을 설치할 수 있는 플러그인 마켓플레이스 소스를 제한합니다. Claude Code는 마켓플레이스 추가 및 플러그인 설치, 업데이트, 새로 고침 및 자동 업데이트 시 허용 목록을 적용하며, 모든 네트워크 또는 파일 시스템 작업 전에 적용하므로, 정책을 설정하기 전에 누군가 추가한 마켓플레이스는 소스가 더 이상 일치하지 않으면 플러그인을 가져오는 데 사용될 수 없습니다. 차단된 사용자는 관리 정책의 이름을 지정하는 오류를 봅니다.
4610 4735
4611* **범위**: [`관리됨`](#scopes)4736[claude.ai 관리 콘솔](/docs/ko/server-managed-settings)에서 이 키를 설정하면 claude.ai는 조직의 누구든 claude.ai에서 git 저장소의 마켓플레이스를 추가할 때도 적용합니다. [제한 작동 방식](/docs/ko/plugins/org#restrict-what-users-can-install)에서 설명합니다.
4612* **유형**: 마켓플레이스 소스 객체의 배열. [허용되는 소스 유형](#allowed-source-types)을 참조하십시오4737
4738* **범위**: [`관리`](#scopes)
4739* **유형**: 마켓플레이스 소스 객체의 배열. [허용된 소스 유형](#allowed-source-types)을 참조하십시오
4613* **기본값**: 설정되지 않음, 따라서 사용자는 모든 마켓플레이스를 추가할 수 있습니다. 빈 배열은 공식 Anthropic 마켓플레이스를 포함한 모든 마켓플레이스 소스를 차단하는 완전한 잠금입니다4740* **기본값**: 설정되지 않음, 따라서 사용자는 모든 마켓플레이스를 추가할 수 있습니다. 빈 배열은 공식 Anthropic 마켓플레이스를 포함한 모든 마켓플레이스 소스를 차단하는 완전한 잠금입니다
4614 4741
4615이 예제는 두 개의 GitHub 저장소를 허용합니다. 하나는 `v2.0` ref에 고정되고 하나는 호스팅된 `marketplace.json` URL입니다:4742이 예제는 두 개의 GitHub 저장소를 허용합니다. 하나는 `v2.0` ref에 고정되고 하나는 호스팅된 `marketplace.json` URL입니다:
4624}4751}
4625```4752```
4626 4753
4627이 키를 `allowedMarketplaces`로도 쓸 수 있습니다. [마켓플레이스 키 별칭](#marketplace-key-aliases)은 Claude Code가 별칭을 어떻게 취급하는지와 어느 버전이 이를 수용하는지 설명합니다. 이 키는 정책 게이트입니다. 사용자가 추가할 수 있는 것을 제어하지만 아무것도 등록하지 않습니다. 제한 및 사전 등록을 한 파일에서 수행하려면 [`extraKnownMarketplaces`와 결합](#combine-with-extraknownmarketplaces)을 참조하십시오. 사용자 대면 보기는 [관리되는 마켓플레이스 제한](/docs/ko/plugin-marketplaces#managed-marketplace-restrictions)을 참조하십시오.4754이 키를 `allowedMarketplaces`로도 쓸 수 있습니다. [마켓플레이스 키 별칭](#marketplace-key-aliases)에서 Claude Code가 별칭을 어떻게 취급하는지 및 어느 버전이 이를 수용하는지 설명합니다. 이 키는 정책 게이트입니다. 사용자가 추가할 수 있는 것을 제어하지만 아무것도 등록하지 않습니다. 제한 및 사전 등록을 한 파일에서 수행하려면 [`extraKnownMarketplaces`와 결합](#combine-with-extraknownmarketplaces)을 참조하십시오. 사용자 대면 보기는 [관리 마켓플레이스 제한](/docs/ko/plugins/org#restrict-what-users-can-install)을 참조하십시오.
4628 4755
4629<h4 id="allowed-source-types">4756<h4 id="allowed-source-types">
4630 허용되는 소스 유형4757 허용된 소스 유형
4631</h4>4758</h4>
4632 4759
4633아래의 각 항목은 소스 유형당 하나의 허용 목록 항목과 이를 수용하는 필드를 보여줍니다. 대부분의 유형은 정확히 일치합니다. `hostPattern` 및 `pathPattern`은 정규식으로 일치하고, `github` 항목은 [소유자 와일드카드](#owner-wildcards)를 사용할 수 있습니다.4760아래의 각 항목은 소스 유형당 하나의 허용 목록 항목과 이를 수용하는 필드를 보여줍니다. 대부분의 유형은 정확히 일치합니다. `hostPattern` 및 `pathPattern`은 정규식으로 일치하고, `github` 항목은 [소유자 와일드카드](#owner-wildcards)를 사용할 수 있습니다.
4636| :- | :- | :- |4763| :- | :- | :- |
4637| `github` | `{ "source": "github", "repo": "acme-corp/plugins", "ref": "main", "path": "marketplace" }` | `repo` 필수; `ref`는 분기 또는 태그; `path`는 하위 디렉터리 |4764| `github` | `{ "source": "github", "repo": "acme-corp/plugins", "ref": "main", "path": "marketplace" }` | `repo` 필수; `ref`는 분기 또는 태그; `path`는 하위 디렉터리 |
4638| `git` | `{ "source": "git", "url": "https://gitlab.example.com/tools/plugins.git", "ref": "production" }` | `url` 필수; `ref` 및 `path`는 `github`과 동일 |4765| `git` | `{ "source": "git", "url": "https://gitlab.example.com/tools/plugins.git", "ref": "production" }` | `url` 필수; `ref` 및 `path`는 `github`과 동일 |
4639| `url` | `{ "source": "url", "url": "https://plugins.example.com/marketplace.json", "headers": { "Authorization": "Bearer ${TOKEN}" } }` | `url` 필수; `headers`는 인증된 액세스를 위한 HTTP 헤더 추가 |4766| `url` | `{ "source": "url", "url": "https://plugins.example.com/marketplace.json", "headers": { "Authorization": "Bearer ${TOKEN}" } }` | `url` 필수; `headers`는 인증된 액세스를 위해 HTTP 헤더를 추가합니다 |
4640| `npm` | `{ "source": "npm", "package": "@acme-corp/claude-plugins" }` | `package` 필수, `marketplace.json`을 포함하는 npm 패키지 |
4641| `file` | `{ "source": "file", "path": "/opt/acme-corp/plugins/marketplace.json" }` | `path` 필수, `marketplace.json` 파일의 절대 경로 |4767| `file` | `{ "source": "file", "path": "/opt/acme-corp/plugins/marketplace.json" }` | `path` 필수, `marketplace.json` 파일의 절대 경로 |
4642| `directory` | `{ "source": "directory", "path": "/opt/acme-corp/approved-marketplaces" }` | `path` 필수, `.claude-plugin/marketplace.json`을 포함하는 디렉터리의 절대 경로 |4768| `directory` | `{ "source": "directory", "path": "/opt/acme-corp/approved-marketplaces" }` | `path` 필수, `.claude-plugin/marketplace.json`을 포함하는 디렉터리의 절대 경로 |
4643| `hostPattern` | `{ "source": "hostPattern", "hostPattern": "^github\\.example\\.com$" }` | `hostPattern` 필수, 마켓플레이스 호스트에 대해 일치하는 정규식 |4769| `hostPattern` | `{ "source": "hostPattern", "hostPattern": "^github\\.example\\.com$" }` | `hostPattern` 필수, 마켓플레이스 호스트의 어디든 일치하는 정규식. `^` 및 `$`로 고정하여 전체 호스트를 일치시킵니다 |
4644| `pathPattern` | `{ "source": "pathPattern", "pathPattern": "^/opt/approved/" }` | `pathPattern` 필수, `file` 및 `directory` 소스의 `path`에 대해 일치하는 정규식 |4770| `pathPattern` | `{ "source": "pathPattern", "pathPattern": "^/opt/approved/" }` | `pathPattern` 필수, `file` 및 `directory` 소스의 `path`의 어디든 일치하는 정규식. 접두사를 고정하려면 `^`로 시작합니다 |
4645| `skills-dir` | `{ "source": "skills-dir" }` | 필드 없음. `~/.claude/skills/` 플러그인 스캔을 다시 선택합니다 |4771| `skills-dir` | `{ "source": "skills-dir" }` | 필드 없음. `~/.claude/skills/` 플러그인 스캔을 다시 옵트인합니다 |
4646 4772
4647세 가지 소스 유형은 표 이상의 규칙을 수행합니다:4773세 가지 소스 유형은 표 이상의 규칙을 포함합니다:
4648 4774
4649* **`url`**: URL 마켓플레이스는 `marketplace.json` 파일만 다운로드하고, Claude Code는 해당 서버에서 상대 경로로 플러그인 파일을 가져오지 않으므로, 플러그인은 아카이브 URL과 같은 [플러그인 소스](/docs/ko/plugin-marketplaces#plugin-sources) 이외의 상대 경로를 사용해야 합니다. 상대 경로가 있는 플러그인의 경우 Git 기반 마켓플레이스를 대신 사용하십시오. [URL 기반 마켓플레이스에서 상대 경로가 있는 플러그인 실패](/docs/ko/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces)를 참조하십시오.4775* **`url`**: URL 마켓플레이스는 `marketplace.json` 파일만 다운로드하고, Claude Code는 해당 서버에서 상대 경로로 플러그인 파일을 가져오지 않으므로, 플러그인은 상대 경로 이외의 [플러그인 소스](/docs/ko/plugins/marketplace-reference#plugin-sources)(예: 아카이브 URL, 동일한 호스트에 있을 수 있음)를 사용해야 합니다. 상대 경로가 있는 플러그인의 경우 Git 기반 마켓플레이스를 대신 사용합니다. [URL 기반 마켓플레이스에서 상대 경로가 있는 플러그인이 실패합니다](/docs/ko/plugins/troubleshooting#plugins-with-relative-paths-fail-in-url-based-marketplaces)를 참조하십시오.
4650* **`hostPattern`**: 각 저장소를 나열하지 않고 내부 GitHub Enterprise 또는 GitLab 서버의 모든 마켓플레이스를 허용하는 데 사용합니다. Claude Code는 `github` 소스를 `github.com`에 대해 일치시키고, `url` 소스에서 호스트 이름을 가져오고, [git URL](https://git-scm.com/docs/git-clone#_git_urls)의 형식에 따라 `git` 소스에서 가져옵니다:4776* **`hostPattern`**: 각 저장소를 나열하지 않고 내부 GitHub Enterprise 또는 GitLab 서버의 모든 마켓플레이스를 허용하는 데 사용합니다. Claude Code는 `github` 소스를 `github.com`과 비교하고, `url` 소스에서 호스트 이름을 가져오며, [git URL](https://git-scm.com/docs/git-clone#_git_urls)의 형식에 따라 `git` 소스에서 가져옵니다:
4651 4777
4652 * `https://` 또는 `ssh://`와 같은 스키마가 있는 URL: URL의 호스트 이름입니다.4778 * `https://` 또는 `ssh://`와 같은 스키마가 있는 URL: URL의 호스트 이름.
4653 * 스키마 없는 SSH 주소, git의 `user@host:path` 형식(예: `git@git.example.com:tools/plugins.git`): `@`와 `:` 사이의 호스트이며, git이 연결하는 호스트입니다.4779 * 스키마 없는 SSH 주소, git의 `user@host:path` 형식(예: `git@git.example.com:tools/plugins.git`): `@`와 `:` 사이의 호스트, 이는 git이 연결하는 호스트입니다.
4654 * 스키마 없는 다른 형식: 호스트 없음, 따라서 `strictKnownMarketplaces` `hostPattern` 항목이 일치하지 않습니다. `blockedMarketplaces` `hostPattern`의 경우 Claude Code는 더 넓은 형식 집합에서 호스트를 가져오므로 차단 목록 항목이 여전히 그러한 형식과 일치할 수 있습니다. v2.1.234 이전에는 `strictKnownMarketplaces` `hostPattern`도 git이 SSH 주소로 취급하지 않는 일부 형식과 일치했습니다.4780 * 스키마 없는 다른 형식: 호스트 없음, 따라서 `strictKnownMarketplaces` `hostPattern` 항목이 일치하지 않습니다. `blockedMarketplaces` `hostPattern`의 경우 Claude Code는 더 넓은 형식 집합에서 호스트를 가져오므로 차단 목록 항목이 여전히 그러한 형식과 일치할 수 있습니다. v2.1.234 이전에는 `strictKnownMarketplaces` `hostPattern`도 git이 SSH 주소로 취급하지 않는 일부 형식과 일치했습니다.
4655 4781
4656 `file` 및 `directory` 소스에는 호스트가 없으며 `hostPattern` 항목과 일치하지 않습니다.4782 `file` 및 `directory` 소스에는 호스트가 없으며 `hostPattern` 항목과 일치하지 않습니다.
4657* **`pathPattern`**: 네트워크 소스에 대한 `hostPattern` 항목과 함께 파일 시스템 마켓플레이스를 허용하는 데 사용합니다. `".*"`는 모든 로컬 경로를 허용합니다. `"^/opt/approved/"`와 같은 더 좁은 패턴은 디렉터리로 제한합니다.4783* **`pathPattern`**: 네트워크 소스의 `hostPattern` 항목과 함께 파일 시스템 마켓플레이스를 허용하는 데 사용합니다. `".*"`는 모든 로컬 경로를 허용합니다. `"^/opt/approved/"`와 같은 더 좁은 패턴은 디렉터리로 제한합니다.
4658 4784
4659빈 배열이라도 모든 허용 목록은 Claude Code가 `~/.claude/skills/`에서 [`@skills-dir` 플러그인](/docs/ko/plugins-reference#skills-directory-plugins)을 로드하는 것을 중지합니다. `{ "source": "skills-dir" }` 항목을 추가하여 로드를 계속합니다. 항목은 이 키와 `blockedMarketplaces` 외부에서는 의미가 없습니다.4785빈 배열이라도 모든 허용 목록은 Claude Code가 `~/.claude/skills/`에서 [`@skills-dir` 플러그인](/docs/ko/plugins/loading#plugins-shared-through-a-repository)을 로드하는 것을 중지합니다. `{ "source": "skills-dir" }` 항목을 추가하여 로드를 계속합니다. 항목은 이 키 및 `blockedMarketplaces` 외부에서는 의미가 없습니다.
4660 4786
4661<h4 id="owner-wildcards">4787<h4 id="owner-wildcards">
4662 소유자 와일드카드4788 소유자 와일드카드
4663</h4>4789</h4>
4664 4790
4665`repo` 값이 `"<owner>/*"`인 `github` 항목은 해당 GitHub 소유자 아래의 모든 저장소와 일치합니다. 소유자 와일드카드는 Claude Code v2.1.223 이상이 필요하며 `strictKnownMarketplaces` 및 `blockedMarketplaces`에서만 작동합니다. `github` 소스가 나타나는 다른 곳(예: `extraKnownMarketplaces` 또는 `/plugin marketplace add`)에서는 `repo` 값이 단일 저장소의 이름을 지정해야 합니다. v2.1.223 이전에는 Claude Code가 항목을 문자 그대로 비교했으므로 허용 목록 항목이 저장소와 일치하지 않았고 차단 목록 항목이 아무것도 차단하지 않았습니다. 단일 저장소 항목은 모든 버전에서 적용됩니다.4791GitHub 소유자 아래의 모든 저장소와 일치하는 `repo` 값이 `"<owner>/*"`인 `github` 항목입니다. 소유자 와일드카드는 Claude Code v2.1.223 이상이 필요하며 `strictKnownMarketplaces` 및 `blockedMarketplaces`에서만 작동합니다. `github` 소스가 나타나는 다른 곳(예: `extraKnownMarketplaces` 또는 `/plugin marketplace add`)에서는 `repo` 값이 단일 저장소의 이름을 지정해야 합니다. v2.1.223 이전에는 Claude Code가 항목을 문자 그대로 비교했으므로 허용 목록 항목이 저장소와 일치하지 않았고 차단 목록 항목이 아무것도 차단하지 않았습니다. 단일 저장소 항목은 모든 버전에서 적용됩니다.
4666 4792
4667이 항목은 `acme-corp` 조직의 모든 마켓플레이스 저장소를 허용합니다:4793이 항목은 `acme-corp` 조직의 모든 마켓플레이스 저장소를 허용합니다:
4668 4794
4674}4800}
4675```4801```
4676 4802
4677전체 저장소 이름 위치만 와일드카드일 수 있습니다. Claude Code는 `*`, `*/plugins` 또는 `acme-corp/tools-*`와 같은 항목을 문자 그대로 비교하므로 저장소와 일치하지 않습니다.4803전체 저장소 이름 위치만 와일드카드일 수 있습니다. Claude Code는 `*`, `*/plugins` 또는 `acme-corp/tools-*`와 같은 항목을 유효하지 않은 것으로 무시하므로 저장소와 일치하지 않습니다.
4678 4804
4679일치 규칙은 두 설정 간에 다릅니다:4805일치 규칙은 두 설정 간에 다릅니다:
4680 4806
4682| - | - | - |4808| - | - | - |
4683| 일치하는 소스 철자 | `owner/repo` 형식만. 동일한 저장소를 복제하는 git URL은 일치하지 않습니다 | 동일한 github.com 저장소로 확인되는 git URL을 포함한 모든 철자 |4809| 일치하는 소스 철자 | `owner/repo` 형식만. 동일한 저장소를 복제하는 git URL은 일치하지 않습니다 | 동일한 github.com 저장소로 확인되는 git URL을 포함한 모든 철자 |
4684| 소유자 대소문자 | 정확한 항목 일치처럼 대소문자 구분 | 대소문자 구분 안 함 |4810| 소유자 대소문자 | 정확한 항목 일치처럼 대소문자 구분 | 대소문자 구분 안 함 |
4685| `ref` | 정확한 항목 규칙을 따릅니다. `ref`가 있는 항목은 정확한 ref를 가진 소스와만 일치하고, 없는 항목은 ref를 지정하지 않는 소스와만 일치합니다 | `ref` 없는 항목은 일치하는 저장소의 모든 ref를 차단합니다 |4811| `ref` | 정확한 항목 규칙을 따릅니다. `ref`가 있는 항목은 정확한 ref가 있는 소스와만 일치하고, 없는 항목은 ref를 지정하지 않는 소스와만 일치합니다 | `ref`가 없는 항목은 일치하는 저장소의 모든 ref를 차단합니다 |
4686| `path` | 정확한 항목 규칙보다 느슨합니다. `path`가 있는 항목은 정확한 값을 요구하고, 없는 항목은 저장소 내의 모든 경로와 일치합니다 | `path` 없는 항목은 일치하는 저장소의 모든 경로를 차단합니다 |4812| `path` | 정확한 항목 규칙보다 느슨합니다. `path`가 있는 항목은 정확한 값을 요구하는 반면, 없는 항목은 저장소 내의 모든 경로와 일치합니다 | `path`가 없는 항목은 일치하는 저장소의 모든 경로를 차단합니다 |
4687 4813
4688<h4 id="exact-matching">4814<h4 id="exact-matching">
4689 정확한 일치4815 정확한 일치
4690</h4>4816</h4>
4691 4817
4692소유자 와일드카드 `github` 항목과 정규식으로 일치하는 `hostPattern` 및 `pathPattern` 항목을 제외한 모든 소스 유형의 경우, Claude Code는 마켓플레이스 소스가 항목과 정확히 일치할 때만 사용자의 추가를 허용합니다. Git 기반 소스 `github` 및 `git`의 경우 정확한 일치는 선택적 필드를 포함합니다:4818소유자 와일드카드 `github` 항목 및 정규식으로 일치하는 `hostPattern` 및 `pathPattern` 항목을 제외한 모든 소스 유형의 경우, Claude Code는 마켓플레이스 소스가 항목과 정확히 일치할 때만 사용자의 추가를 허용합니다. Git 기반 소스 `github` 및 `git`의 경우 정확한 일치는 선택적 필드를 포함합니다:
4693 4819
4694* `repo` 또는 `url`은 정확히 일치해야 합니다4820* `repo` 또는 `url`은 정확히 일치해야 합니다
4695* `ref` 필드는 정확히 일치해야 하거나 둘 다 정의되지 않아야 합니다4821* `ref` 필드는 정확히 일치해야 하거나 둘 다 정의되지 않아야 합니다
4704 공식 마켓플레이스만 허용4830 공식 마켓플레이스만 허용
4705</h4>4831</h4>
4706 4832
4707공식 Anthropic 마켓플레이스만 허용하고 다른 것은 허용하지 않으려면 해당 저장소를 나열하십시오:4833공식 Anthropic 마켓플레이스만 허용하고 다른 것은 허용하지 않으려면 해당 저장소를 나열합니다:
4708 4834
4709```json managed-settings.json theme={null}4835```json managed-settings.json theme={null}
4710{4836{
4714}4840}
4715```4841```
4716 4842
4717이 항목을 사용하면 Claude Code는 이미 등록된 공식 마켓플레이스를 사용 가능하게 유지하고, 새 머신에서는 처음 대화형으로 Claude Code를 시작할 때 마켓플레이스를 자동으로 등록합니다. 자동 등록은 일반적으로 다음을 놓칩니다:4843이 항목을 사용하면 Claude Code는 이미 등록된 공식 마켓플레이스를 사용 가능하게 유지하고, 새 머신에서 대화형 터미널 세션을 처음 시작할 때 마켓플레이스를 자동으로 등록합니다. 자동 등록은 가장 일반적으로 다음을 놓칩니다:
4718 4844
4719* 머신의 첫 번째 대화형 시작 전에 실행되는 비대화형 환경입니다.4845* 머신의 첫 번째 대화형 터미널 세션 전에 실행되는 비대화형 환경.
4720* Claude Code가 이미 마켓플레이스를 차단한 정책(예: 빈 배열 잠금) 아래에서 대화형으로 실행된 머신입니다. Claude Code는 차단된 시도를 기록하고 정책이 변경된 후 다시 시도하지 않습니다.4846* Claude Code가 VS Code 확장을 통해서만 실행된 머신.
4847* Claude Code가 이미 마켓플레이스를 차단한 정책(예: 빈 배열 잠금) 아래에서 대화형 터미널 세션을 실행한 머신. Claude Code는 차단된 시도를 기록하고 정책이 변경된 후 다시 시도하지 않습니다.
4721 4848
4722이러한 머신에서는 동일한 `managed-settings.json`의 [`extraKnownMarketplaces`](#extraknownmarketplaces)에 마켓플레이스를 추가하여 Claude Code가 자동으로 등록하도록 하거나 `claude plugin marketplace add anthropics/claude-plugins-official`을 실행하십시오.4849이러한 머신에서는 동일한 `managed-settings.json`의 [`extraKnownMarketplaces`](#extraknownmarketplaces)에 마켓플레이스를 추가하여 Claude Code가 자동으로 등록하도록 하거나 `claude plugin marketplace add anthropics/claude-plugins-official`을 실행합니다.
4723 4850
4724<h4 id="combine-with-extraknownmarketplaces">4851<h4 id="combine-with-extraknownmarketplaces">
4725 `extraKnownMarketplaces`와 결합4852 `extraKnownMarketplaces`와 결합
4730| 측면 | `strictKnownMarketplaces` | `extraKnownMarketplaces` |4857| 측면 | `strictKnownMarketplaces` | `extraKnownMarketplaces` |
4731| - | - | - |4858| - | - | - |
4732| 목적 | 조직 정책 적용 | 팀 편의 |4859| 목적 | 조직 정책 적용 | 팀 편의 |
4733| 설정 파일 | 관리되는 설정만 | 모든 설정 파일 |4860| 설정 파일 | 관리 설정만 | 모든 설정 파일 |
4734| 동작 | 허용 목록에 없는 추가 차단 | 누락된 마켓플레이스 등록 |4861| 동작 | 허용 목록에 없는 추가 차단 | 누락된 마켓플레이스 등록 |
4735| 적용 시기 | 네트워크 및 파일 시스템 작업 전 | 사용자 또는 관리되는 설정에서 즉시; 저장소 파일의 작업 공간 신뢰 대화 후 |4862| 적용 시기 | 네트워크 및 파일 시스템 작업 전 | 사용자 또는 관리 설정에서 즉시. 저장소 파일의 작업 공간 신뢰 대화 후 |
4736| 재정의 가능 | 아니오, 최고 우선순위 | 예, 더 높은 우선순위 설정으로 |4863| 재정의 가능 | 아니오, 최고 우선순위 | 예, 더 높은 우선순위 설정으로 |
4737| 소스 형식 | 직접 소스 객체 | 중첩된 `source` 객체가 있는 명명된 마켓플레이스 |4864| 소스 형식 | 직접 소스 객체 | 중첩된 `source` 객체가 있는 명명된 마켓플레이스 |
4738 4865
4739모든 사용자에 대해 마켓플레이스를 제한하고 사전 등록하려면 `managed-settings.json`에서 둘 다 설정하십시오:4866마켓플레이스를 제한하고 모든 사용자에 대해 사전 등록하려면 `managed-settings.json`에서 둘 다 설정합니다:
4740 4867
4741```json managed-settings.json theme={null}4868```json managed-settings.json theme={null}
4742{4869{
4757 `strictPluginOnlyCustomization`4884 `strictPluginOnlyCustomization`
4758</h3>4885</h3>
4759 4886
4760사용자 및 프로젝트 소스의 스킬, 에이전트, 훅 및 MCP 서버를 차단하여 플러그인 또는 관리되는 설정에서만 올 수 있도록 합니다. [`strictKnownMarketplaces`](#strictknownmarketplaces)와 결합하여 전체 사용자 정의 공급 체인을 제어합니다. 마켓플레이스 허용 목록은 사용자가 설치할 수 있는 플러그인을 제어합니다.4887사용자 및 프로젝트 소스의 스킬, 에이전트, 훅 및 MCP 서버를 차단하여 플러그인 또는 관리 설정에서만 올 수 있도록 합니다. [`strictKnownMarketplaces`](#strictknownmarketplaces)와 결합하여 전체 사용자 정의 공급 체인을 제어합니다. 마켓플레이스 허용 목록은 사용자가 설치할 수 있는 플러그인을 제어합니다.
4761 4888
4762* **범위**: [`관리됨`](#scopes)4889* **범위**: [`관리`](#scopes)
4763* **유형**: 모든 4가지 사용자 정의를 잠그려면 `true` 또는 `"skills"`, `"agents"`, `"hooks"`, `"mcp"`에서 잠글 종류의 이름을 지정하는 배열4890* **유형**: 모든 네 가지 사용자 정의를 잠그려면 `true`, 또는 `"skills"`, `"agents"`, `"hooks"`, `"mcp"`에서 잠글 종류의 이름을 지정하는 배열
4764* **기본값**: 설정되지 않음, 따라서 아무것도 잠기지 않습니다4891* **기본값**: 설정되지 않음, 따라서 아무것도 잠기지 않습니다
4765 4892
4766이 예제는 스킬과 훅을 잠그고 에이전트와 MCP 서버는 잠금 해제된 상태로 둡니다:4893이 예제는 스킬 및 훅을 잠그고 에이전트 및 MCP 서버는 잠금 해제된 상태로 둡니다:
4767 4894
4768```json managed-settings.json theme={null}4895```json managed-settings.json theme={null}
4769{4896{
4771}4898}
4772```4899```
4773 4900
4774아래의 4개 하위 키 항목은 각 표면이 차단하는 것과 여전히 로드되는 것을 나열합니다. Claude Code는 인식하지 못하는 표면 이름을 무시하므로 모든 클라이언트가 업데이트되기 전에 새 표면 이름을 추가할 수 있습니다.4901아래의 네 가지 하위 키 항목은 각 표면이 차단하는 것과 여전히 로드되는 것을 나열합니다. Claude Code는 인식하지 못하는 표면 이름을 무시하므로 모든 클라이언트가 업데이트되기 전에 새 표면 이름을 추가할 수 있습니다.
4775 4902
4776<h3 id="strictpluginonlycustomization-skills">4903<h3 id="strictpluginonlycustomization-skills">
4777 `strictPluginOnlyCustomization.skills`4904 `strictPluginOnlyCustomization.skills`
4778</h3>4905</h3>
4779 4906
4780`skills` 표면을 잠급니다. Claude Code는 `~/.claude/skills/` 및 `.claude/skills/`의 스킬, `~/.claude/commands/` 및 `.claude/commands/`의 사용자 정의 명령어, `--add-dir` 디렉터리의 스킬, claude.ai 계정에서 동기화된 스킬 로드를 중지하고, 플러그인 스킬, 번들된 스킬, 관리되는 정책 디렉터리의 스킬 로드를 계속합니다.4907`skills` 표면을 잠급니다. Claude Code는 `~/.claude/skills/` 및 `.claude/skills/`의 스킬, `~/.claude/commands/` 및 `.claude/commands/`의 사용자 정의 명령어, `--add-dir` 디렉터리의 스킬, claude.ai 계정에서 동기화된 스킬 로드를 중지하고, 플러그인 스킬, 번들 스킬, 관리 정책 디렉터리의 스킬 로드를 계속합니다.
4781 4908
4782* **범위**: [`관리됨`](#scopes)4909* **범위**: [`관리`](#scopes)
4783* **유형**: [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) 배열의 문자열 `"skills"`4910* **유형**: [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) 배열의 문자열 `"skills"`
4784* **기본값**: 잠기지 않음4911* **기본값**: 잠기지 않음
4785 4912
4793 `strictPluginOnlyCustomization.agents`4920 `strictPluginOnlyCustomization.agents`
4794</h3>4921</h3>
4795 4922
4796`agents` 표면을 잠급니다. Claude Code는 `~/.claude/agents/` 및 `.claude/agents/`의 에이전트 로드를 중지하고, 플러그인 에이전트, 기본 제공 에이전트, 관리되는 정책 디렉터리의 에이전트 로드를 계속합니다.4923`agents` 표면을 잠급니다. Claude Code는 `~/.claude/agents/` 및 `.claude/agents/`의 에이전트 로드를 중지하고, 플러그인 에이전트, 기본 제공 에이전트, 관리 정책 디렉터리의 에이전트 로드를 계속합니다.
4797 4924
4798* **범위**: [`관리됨`](#scopes)4925* **범위**: [`관리`](#scopes)
4799* **유형**: [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) 배열의 문자열 `"agents"`4926* **유형**: [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) 배열의 문자열 `"agents"`
4800* **기본값**: 잠기지 않음4927* **기본값**: 잠기지 않음
4801 4928
4809 `strictPluginOnlyCustomization.hooks`4936 `strictPluginOnlyCustomization.hooks`
4810</h3>4937</h3>
4811 4938
4812`hooks` 표면을 잠급니다. Claude Code는 사용자, 프로젝트 및 로컬 `settings.json`의 훅 실행을 중지하고, 플러그인 훅과 관리되는 설정의 훅 실행을 계속합니다.4939`hooks` 표면을 잠급니다. Claude Code는 사용자, 프로젝트 및 로컬 `settings.json`의 훅 실행을 중지하고, 플러그인 훅 및 관리 설정의 훅 실행을 계속합니다.
4813 4940
4814* **범위**: [`관리됨`](#scopes)4941* **범위**: [`관리`](#scopes)
4815* **유형**: [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) 배열의 문자열 `"hooks"`4942* **유형**: [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) 배열의 문자열 `"hooks"`
4816* **기본값**: 잠기지 않음4943* **기본값**: 잠기지 않음
4817 4944
4827 4954
4828`mcp` 표면을 잠급니다. Claude Code는 `~/.claude.json` 및 `.mcp.json`의 MCP 서버 로드를 중지하고, 플러그인 MCP 서버, [`managed-mcp.json`](/docs/ko/managed-mcp) 서버, [`managedMcpServers`](#managedmcpservers)의 서버 로드를 계속합니다.4955`mcp` 표면을 잠급니다. Claude Code는 `~/.claude.json` 및 `.mcp.json`의 MCP 서버 로드를 중지하고, 플러그인 MCP 서버, [`managed-mcp.json`](/docs/ko/managed-mcp) 서버, [`managedMcpServers`](#managedmcpservers)의 서버 로드를 계속합니다.
4829 4956
4830* **범위**: [`관리됨`](#scopes)4957* **범위**: [`관리`](#scopes)
4831* **유형**: [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) 배열의 문자열 `"mcp"`4958* **유형**: [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) 배열의 문자열 `"mcp"`
4832* **기본값**: 잠기지 않음4959* **기본값**: 잠기지 않음
4833 4960
4841 `enabledPlugins`4968 `enabledPlugins`
4842</h3>4969</h3>
4843 4970
4844`plugin-name@marketplace-name`으로 키가 지정된 개별 [플러그인](/docs/ko/plugins)을 켜거나 끕니다. 모든 범위에서 항목이 없는 플러그인은 [`defaultEnabled`](/docs/ko/plugins-reference#default-enablement) 값으로 폴백됩니다. `/plugin` 또는 `claude plugin enable`로 플러그인을 활성화 또는 비활성화하면 Claude Code가 이 키를 작성합니다.4971`plugin-name@marketplace-name`으로 키가 지정된 개별 [플러그인](/docs/ko/plugins/overview)을 켜거나 끕니다. 모든 범위에서 항목이 없는 플러그인은 [`defaultEnabled`](/docs/ko/plugins/manifest-reference#fields) 값으로 폴백합니다. `/plugin` 또는 `claude plugin enable`로 플러그인을 활성화 또는 비활성화하면 Claude Code가 이 키를 작성합니다.
4845 4972
4846* **범위**: [`모든 파일`](#scopes)4973* **범위**: [`모든 파일`](#scopes)
4847* **유형**: `plugin-name@marketplace-name`을 Boolean으로 매핑하는 객체4974* **유형**: `plugin-name@marketplace-name`을 부울에 매핑하는 객체
4848* **기본값**: 설정되지 않음, 따라서 각 플러그인은 `defaultEnabled` 값을 따릅니다4975* **기본값**: 설정되지 않음, 따라서 각 플러그인은 `defaultEnabled` 값을 따릅니다
4849 4976
4850이 예제는 `team-tools` 마켓플레이스의 두 플러그인을 활성화하고 `personal`의 하나를 비활성화합니다:4977이 예제는 `team-tools` 마켓플레이스의 두 플러그인을 활성화하고 `personal`의 하나를 비활성화합니다:
4864* **사용자 설정**: 개인 플러그인 기본 설정4991* **사용자 설정**: 개인 플러그인 기본 설정
4865* **프로젝트 설정**: 저장소의 모든 사람과 공유되는 플러그인4992* **프로젝트 설정**: 저장소의 모든 사람과 공유되는 플러그인
4866* **로컬 설정**: 머신별 재정의, Claude Code가 설정을 저장할 때 gitignored4993* **로컬 설정**: 머신별 재정의, Claude Code가 설정을 저장할 때 gitignored
4867* **관리되는 설정**: 조직 전체 정책. `false`로 설정된 플러그인은 모든 범위에서 설치가 차단되고 마켓플레이스에서 숨겨집니다4994* **관리 설정**: 조직 전체 정책. `false`로 설정된 플러그인은 모든 범위에서 설치가 차단되고 마켓플레이스에서 숨겨집니다
4868 4995
4869프로젝트 설정은 사용자 설정보다 우선하므로, `~/.claude/settings.json`에서 플러그인을 `false`로 설정해도 프로젝트의 `.claude/settings.json`이 활성화하는 플러그인은 비활성화되지 않습니다. 머신에서 프로젝트 활성화 플러그인을 거부하려면 대신 `.claude/settings.local.json`에서 `false`로 설정하십시오. 관리되는 설정으로 강제 활성화된 플러그인은 관리되는 설정이 로컬 설정을 재정의하므로 이 방식으로 비활성화될 수 없습니다.4996프로젝트 설정은 사용자 설정보다 우선하므로 `~/.claude/settings.json`에서 플러그인을 `false`로 설정해도 프로젝트의 `.claude/settings.json`이 활성화하는 플러그인은 비활성화되지 않습니다. 머신에서 프로젝트 활성화 플러그인을 거부하려면 대신 `.claude/settings.local.json`에서 `false`로 설정합니다. 관리 설정으로 강제 활성화된 플러그인은 관리 설정이 로컬 설정을 재정의하므로 이 방식으로 비활성화될 수 없습니다.
4870 4997
4871GitHub 저장소 또는 npm 패키지와 같은 외부 소스의 플러그인을 프로젝트의 `.claude/settings.json`에서 활성화해도 다른 사람을 위해 설치되지 않습니다. 플러그인을 로드하는 모든 경로에서 Claude Code는 각 사용자가 [직접 설치할 때까지](/docs/ko/discover-plugins#configure-team-marketplaces) 플러그인이 설치되지 않은 것으로 보고합니다.4998프로젝트의 `.claude/settings.json`에서 GitHub 저장소 또는 npm 패키지와 같은 외부 소스의 플러그인을 활성화해도 다른 사람을 위해 설치되지 않습니다. 플러그인을 로드하는 모든 경로에서 Claude Code는 각 사용자가 [직접 설치할 때까지](/docs/ko/plugins/org#require-plugins-per-repository) 플러그인이 설치되지 않은 것으로 보고합니다.
4872 4999
4873<h3 id="extraknownmarketplaces">5000<h3 id="extraknownmarketplaces">
4874 `extraKnownMarketplaces`5001 `extraKnownMarketplaces`
4875</h3>5002</h3>
4876 5003
4877추가 플러그인 마켓플레이스를 이름으로 등록하여 저장소를 열거나 관리되는 설정이 도달하는 모든 사람이 직접 추가하지 않고도 마켓플레이스를 얻도록 합니다. Claude Code는 아직 알지 못하는 각 마켓플레이스를 등록합니다. [`enabledPlugins`](#enabledplugins)가 이름을 지정하는 플러그인이 설치되는지 여부는 플러그인의 소스와 어느 파일이 이를 활성화하는지에 따라 다릅니다. 해당 항목에는 규칙이 있습니다.5004저장소를 열거나 관리 설정이 도달하는 모든 사람이 마켓플레이스를 직접 추가하지 않고도 얻을 수 있도록 이름으로 추가 플러그인 마켓플레이스를 등록합니다. Claude Code는 아직 알지 못하는 각 마켓플레이스를 등록합니다. [`enabledPlugins`](#enabledplugins)가 이름을 지정한 플러그인이 설치되는지 여부는 플러그인의 소스 및 어느 파일이 이를 활성화하는지에 따라 다릅니다. 해당 항목에는 규칙이 있습니다.
4878 5005
4879* **범위**: [`모든 파일`](#scopes). Claude Code는 저장소의 `.claude/settings.json` 또는 `.claude/settings.local.json`의 항목을 해당 폴더의 작업 공간 신뢰 대화를 수락한 후에만 인정합니다. 신뢰하지 않은 폴더(메시지 없이 `-p` 실행 포함)에서는 무시합니다.5006* **범위**: [`모든 파일`](#scopes). Claude Code는 해당 폴더에 대한 작업 공간 신뢰 대화를 수락한 후에만 저장소의 `.claude/settings.json` 또는 `.claude/settings.local.json`의 항목을 인정합니다. 신뢰하지 않은 폴더(예: `-p` 실행 포함)에서는 메시지 없이 무시합니다.
4880* **유형**: 마켓플레이스 이름을 `source` 객체와 선택적 `autoUpdate` Boolean이 있는 객체로 매핑하는 객체5007* **유형**: 마켓플레이스 이름을 `source` 객체 및 선택적 `autoUpdate` 부울이 있는 객체에 매핑하는 객체
4881* **기본값**: 설정되지 않음5008* **기본값**: 설정되지 않음
4882 5009
4883이 예제는 GitHub 마켓플레이스와 자체 호스팅 git URL의 마켓플레이스를 등록합니다:5010이 예제는 GitHub 마켓플레이스 및 자체 호스팅 git URL의 마켓플레이스를 등록합니다:
4884 5011
4885```json settings.json theme={null}5012```json settings.json theme={null}
4886{5013{
4903 5030
4904[폴더를 신뢰하기 전에 실행되는 것](/docs/ko/permissions#what-runs-before-you-trust-a-folder)은 신뢰 게이트를 저장소가 제공할 수 있는 다른 콘텐츠와 비교합니다. 이 키를 `additionalMarketplaces`로도 쓸 수 있습니다. [마켓플레이스 키 별칭](#marketplace-key-aliases)을 참조하십시오.5031[폴더를 신뢰하기 전에 실행되는 것](/docs/ko/permissions#what-runs-before-you-trust-a-folder)은 신뢰 게이트를 저장소가 제공할 수 있는 다른 콘텐츠와 비교합니다. 이 키를 `additionalMarketplaces`로도 쓸 수 있습니다. [마켓플레이스 키 별칭](#marketplace-key-aliases)을 참조하십시오.
4905 5032
4906`source` 옆에 `"autoUpdate": true`를 설정하여 Claude Code가 시작 후 백그라운드에서 해당 마켓플레이스를 새로 고치고 설치된 플러그인을 업데이트하도록 합니다. 생략하면 `claude-plugins-official` 및 대부분의 다른 공식 Anthropic 마켓플레이스는 `true`로 기본 설정되고, 타사 마켓플레이스는 `false`로 기본 설정됩니다. [자동 업데이트 구성](/docs/ko/discover-plugins#configure-auto-updates)을 참조하십시오.5033시작 후 백그라운드에서 해당 마켓플레이스를 새로 고치고 설치된 플러그인을 업데이트하도록 Claude Code를 만들려면 `source` 옆에 `"autoUpdate": true`를 설정합니다. 생략하면 `claude-plugins-official` 및 대부분의 다른 공식 Anthropic 마켓플레이스는 기본값이 `true`이고 타사 마켓플레이스는 기본값이 `false`입니다. [자동 업데이트 구성](/docs/ko/plugins/install#keep-plugins-updated)을 참조하십시오.
4907 5034
4908둘 이상의 설정 파일이 동일한 이름 아래에 마켓플레이스 항목을 정의할 때 Claude Code는 [가장 높은 우선순위 파일](/docs/ko/settings#settings-precedence)의 항목을 사용합니다. 해당 항목은 낮은 우선순위 항목을 대체하고 필드를 상속하지 않으므로, 재정의는 한 파일의 `source.headers` 자격 증명을 다른 파일이 제어하는 URL과 결합할 수 없습니다. v2.1.228 이전에는 Claude Code가 같은 이름 항목을 필드별로 병합했으므로, 더 높은 우선순위 파일의 항목은 설정하지 않은 필드(다른 파일의 `headers` 포함)를 상속할 수 있었습니다.5035둘 이상의 설정 파일이 동일한 이름 아래에 마켓플레이스 항목을 정의할 때 Claude Code는 [최고 우선순위 파일](/docs/ko/settings#settings-precedence)의 항목을 전체적으로 사용합니다. 해당 항목은 낮은 우선순위 항목을 바꾸고 필드를 상속하지 않으므로 재정의는 한 파일의 `source.headers` 자격 증명을 다른 파일이 제어하는 URL과 결합할 수 없습니다. v2.1.228 이전에는 Claude Code가 같은 이름 항목을 필드별로 병합했으므로 더 높은 우선순위 파일의 항목은 설정하지 않은 필드(다른 파일의 `headers` 포함)를 상속할 수 있었습니다.
4909 5036
4910<h4 id="marketplace-source-types">5037<h4 id="marketplace-source-types">
4911 마켓플레이스 소스 유형5038 마켓플레이스 소스 유형
4915 5042
4916* **`github`**: GitHub 저장소, `repo` 포함5043* **`github`**: GitHub 저장소, `repo` 포함
4917* **`git`**: 모든 git URL, `url` 포함5044* **`git`**: 모든 git URL, `url` 포함
4918* **`url`**: `marketplace.json` 파일에 대한 직접 URL, `url` 및 선택적 `headers` 및 `headersHelper`(인증된 액세스용). `headersHelper`는 값이 `headers`에 나열하기에는 너무 단기인 헤더를 인쇄하는 명령어의 이름을 지정하며 Claude Code v2.1.238 이상이 필요합니다5045* **`url`**: `marketplace.json` 파일에 대한 직접 URL, `url` 및 선택적 `headers` 및 인증된 액세스를 위한 `headersHelper` 포함. `headersHelper`는 `headers`에 나열하기에는 너무 단기간인 값을 가진 헤더를 인쇄하는 명령어의 이름을 지정하며 Claude Code v2.1.238 이상이 필요합니다
4919* **`file`**: `marketplace.json` 파일에 대한 로컬 경로, `path` 포함5046* **`file`**: `marketplace.json` 파일에 대한 로컬 경로, `path` 포함
4920* **`directory`**: 로컬 파일 시스템 경로, `path` 포함, 개발 전용5047* **`directory`**: 개발 전용 로컬 파일 시스템 경로, `path` 포함
4921* **`settings`**: 호스팅된 저장소 없이 설정 파일에 직접 선언된 인라인 마켓플레이스, `name` 및 `plugins` 포함5048* **`settings`**: 호스팅된 저장소 없이 설정 파일에 직접 선언된 인라인 마켓플레이스, `name` 및 `plugins` 포함
4922 5049
4923`git` 소스 유형은 자체 호스팅 GitLab 및 Bitbucket을 포함한 모든 git 호스팅 서비스와 함께 작동합니다. Claude Code는 해당 머신에서 `git clone`이 사용할 것과 동일한 인증으로 저장소를 복제합니다. 구성된 자격 증명 도우미 또는 SSH 키입니다. `GITHUB_TOKEN`과 같은 공급자 토큰은 이를 읽는 자격 증명 도우미를 통해서만 적용됩니다. [비공개 저장소](/docs/ko/plugin-marketplaces#private-repositories)에서 설정 세부 정보를 참조하십시오.5050`git` 소스 유형은 자체 호스팅 GitLab 및 Bitbucket을 포함한 모든 git 호스팅 서비스와 함께 작동합니다. Claude Code는 해당 머신에서 `git clone`이 사용할 것과 동일한 인증으로 저장소를 복제합니다. 구성된 자격 증명 도우미 또는 SSH 키. `GITHUB_TOKEN`과 같은 공급자 토큰은 이를 읽는 자격 증명 도우미를 통해 적용됩니다. 설정 세부 정보는 [비공개 저장소](/docs/ko/plugins/host-marketplace#grant-access-to-a-private-marketplace)를 참조하십시오.
4924 5051
4925`github` 및 `git` 소스의 경우, Claude Code는 마켓플레이스 저장소를 추가하거나 업데이트할 때 [Git LFS](https://git-lfs.com) 콘텐츠를 다운로드하지 않습니다. LFS 추적 파일은 포인터 파일로 체크아웃되고, 추가 또는 업데이트 출력은 몇 개인지 보고합니다.5052`github` 및 `git` 소스의 경우 Claude Code는 마켓플레이스 저장소를 추가하거나 업데이트하기 위해 복제할 때 [Git LFS](https://git-lfs.com) 콘텐츠를 다운로드하지 않습니다. LFS 추적 파일은 포인터 파일로 체크아웃되고 추가 또는 업데이트 출력은 몇 개인지 보고합니다.
4926 5053
4927`source` 객체 내의 `skipLfs` 필드는 수용되며 효과가 없습니다. v2.1.274 이전에는 `"skipLfs": true`를 설정하지 않으면 Claude Code가 LFS 콘텐츠를 다운로드했습니다.5054`source` 객체 내의 `skipLfs` 필드는 수용되며 효과가 없습니다. v2.1.274 이전에는 Claude Code가 `"skipLfs": true`를 설정하지 않으면 LFS 콘텐츠를 다운로드했습니다.
4928 5055
4929`url` 소스의 경우, `headers`의 자격 증명이 만료되고 명령어가 새 자격 증명을 생성해야 할 때 `source` 객체 내에서 `headersHelper`를 설정합니다. Claude Code v2.1.238 이상이 필요합니다. 명령어가 인쇄해야 하는 것과 Claude Code가 실행하는 위치는 [headersHelper 명령어 작성](/docs/ko/plugin-marketplaces#write-the-headershelper-command)을 참조하고, Claude Code가 실행하지 않는 경우는 [Claude Code가 headersHelper 명령어를 건너뛰거나 출력을 삭제할 때](/docs/ko/plugin-marketplaces#when-claude-code-skips-a-headershelper-command-or-drops-its-output)를 참조하십시오. `https://` 마켓플레이스 URL에서 `headersHelper`를 설정하면 Claude Code는 두 지점에서 명령어를 실행하여 한 실행의 출력을 최대 60초 동안 재사용합니다:5056URL 소스의 경우 `headers`의 자격 증명이 만료되고 명령어가 새 자격 증명을 생성해야 할 때 `source` 객체 내에 `headersHelper`를 설정합니다. Claude Code v2.1.238 이상이 필요합니다. 명령어가 인쇄해야 하는 것 및 Claude Code가 실행하는 위치는 [headersHelper 명령어 작성](/docs/ko/plugins/host-marketplace#write-the-headershelper-command)을 참조하고, Claude Code가 headersHelper 명령어를 건너뛰는 경우는 [Claude Code가 headersHelper 명령어를 건너뛰거나 출력을 삭제할 때](/docs/ko/plugins/host-marketplace#when-claude-code-skips-a-headershelper-command-or-drops-its-output)를 참조하십시오. `https://` 마켓플레이스 URL에 `headersHelper`를 설정하면 Claude Code는 명령어를 두 지점에서 실행하여 한 실행의 출력을 최대 60초 동안 재사용합니다:
4930 5057
4931* 해당 마켓플레이스의 `marketplace.json` 각 가져오기 전(나중의 새로 고침 포함). Claude Code는 인쇄된 헤더를 해당 가져오기와 함께 보냅니다.5058* 해당 마켓플레이스의 `marketplace.json` 각 가져오기 전(나중의 새로 고침 포함). Claude Code는 인쇄된 헤더를 해당 가져오기와 함께 보냅니다.
4932* 마켓플레이스 URL의 원점(동일한 스키마, 호스트 및 포트를 의미)의 각 플러그인 아카이브 다운로드 전. Claude Code는 출력을 해당 다운로드와 함께 보내고, 다른 다운로드는 헤더를 받지 않습니다.5059* 마켓플레이스 URL의 원점(동일한 스키마, 호스트 및 포트를 의미)의 각 플러그인 아카이브 다운로드 전. Claude Code는 출력을 해당 다운로드와 함께 보내고 다른 다운로드는 헤더를 받지 않습니다.
4933 5060
4934Claude Code는 [`--add-dir`](/docs/ko/permissions#what-runs-before-you-trust-a-folder)로 추가한 디렉터리의 `.claude/settings.json` 또는 `.claude/settings.local.json`에서 설정된 모든 `headersHelper`를 무시하고, `url` 소스와 인라인 플러그인 항목 모두에서 해당 파일에 설정된 고정 `headers`만 보냅니다. [사용자가 headersHelper 명령어를 수락하는 방법](/docs/ko/plugin-marketplaces#how-users-accept-a-headershelper-command)은 다른 설정 파일을 다룹니다.5061Claude Code는 [`--add-dir`](/docs/ko/permissions#what-runs-before-you-trust-a-folder)로 추가한 디렉터리의 `.claude/settings.json` 또는 `.claude/settings.local.json`에서 설정된 모든 `headersHelper`를 무시하며, `url` 소스 및 인라인 플러그인 항목 모두에서 해당 파일에 설정된 고정 `headers`만 보냅니다. [사용자가 headersHelper 명령어를 수락하는 방법](/docs/ko/plugins/host-marketplace#how-users-accept-a-headershelper-command)은 다른 설정 파일을 다룹니다.
4935 5062
4936`settings` 소스에 나열된 플러그인은 GitHub 또는 npm과 같은 외부 소스를 참조해야 하며, `name`은 마켓플레이스 키와 일치해야 합니다. 여전히 각 플러그인을 `enabledPlugins`에서 별도로 활성화합니다. 이 예제는 하나의 플러그인을 인라인으로 선언합니다:5063`settings` 소스에 나열된 플러그인은 GitHub 또는 npm과 같은 외부 소스를 참조해야 하며 `name`은 마켓플레이스 키와 일치해야 합니다. 여전히 `enabledPlugins`에서 각 플러그인을 별도로 활성화합니다. 이 예제는 하나의 플러그인을 인라인으로 선언합니다:
4937 5064
4938```json settings.json theme={null}5065```json settings.json theme={null}
4939{5066{
4957}5084}
4958```5085```
4959 5086
4960`source: 'settings'` 아래의 플러그인 항목이 자체 `source`가 [`archive`](/docs/ko/plugin-marketplaces#zip-archives)인 경우 아카이브 다운로드를 위해 `headers`를 설정할 수 있습니다. `headers`에 넣을 값이 단기인 경우(예: 레지스트리가 요청 시 발급하는 토큰) 대신 `headersHelper` 명령어를 설정합니다. 항목은 둘 다 설정할 수 있습니다. 두 필드 모두 Claude Code v2.1.238 이상이 필요합니다.5087자체 `source`가 [`archive`](/docs/ko/plugins/marketplace-reference#archive-plugin-source)인 `source: 'settings'` 아래의 플러그인 항목은 아카이브 다운로드를 위해 `headers`를 설정할 수 있습니다. `headers`에 넣을 값이 단기간인 경우(예: 레지스트리가 요청 시 발행하는 토큰) 대신 `headersHelper` 명령어를 설정합니다. 항목은 둘 다 설정할 수 있습니다. 두 필드 모두 Claude Code v2.1.238 이상이 필요합니다.
4961 5088
4962Claude Code는 항목의 `headers`와 명령어가 인쇄하는 것을 해당 플러그인의 아카이브 다운로드와 함께 보내고 다른 다운로드와는 함께 보내지 않습니다. Claude Code는 사용자가 [해당 플러그인 하나를 직접 설치 또는 업데이트할 때](/docs/ko/plugin-marketplaces#how-users-accept-a-headershelper-command)만 명령어를 실행합니다. 3가지 추가 규칙은 항목을 보유한 파일에 따라 다릅니다:5089Claude Code는 항목의 `headers` 및 명령어가 인쇄한 것을 해당 플러그인의 아카이브 다운로드와 함께 보내고 다른 다운로드와는 함께 보내지 않습니다. Claude Code는 사용자가 [해당 플러그인 하나를 직접 설치 또는 업데이트할 때](/docs/ko/plugins/host-marketplace#how-users-accept-a-headershelper-command)만 명령어를 실행합니다. 세 가지 추가 규칙은 항목을 보유한 파일에 따라 다릅니다:
4963 5090
4964* **`strict`**: 마켓플레이스의 `marketplace.json`의 항목과 달리, 설정 파일의 항목은 인라인할 매니페스트 필드가 없으므로 `"strict": false`가 필요하지 않습니다. [엄격한 모드](/docs/ko/plugin-marketplaces#strict-mode)를 참조하십시오.5091* **`strict`**: 마켓플레이스의 `marketplace.json`의 항목과 달리 설정 파일의 항목은 인라인 매니페스트 필드가 없으므로 `"strict": false`가 필요하지 않습니다. [엄격 모드](/docs/ko/plugins/marketplace-reference#strict-mode)를 참조하십시오.
4965* **폴더 신뢰**: 프로젝트의 `.claude/settings.json` 또는 `.claude/settings.local.json`의 항목의 경우 Claude Code는 사용자가 [해당 폴더도 신뢰한](/docs/ko/permissions#what-runs-before-you-trust-a-folder) 후에만 명령어를 실행합니다.5092* **폴더 신뢰**: 프로젝트의 `.claude/settings.json` 또는 `.claude/settings.local.json`의 항목의 경우 Claude Code는 사용자가 [해당 폴더도 신뢰한](/docs/ko/permissions#what-runs-before-you-trust-a-folder) 후에만 명령어를 실행합니다.
4966* **헤더 필터**: Claude Code는 프로젝트의 `.claude/settings.json` 또는 `.claude/settings.local.json`의 항목에서 [요청 라우팅 및 클라이언트 ID 헤더 이름](/docs/ko/plugin-marketplaces#when-claude-code-skips-a-headershelper-command-or-drops-its-output)을 삭제합니다. 저장소가 해당 파일을 제공할 수 있기 때문입니다. Claude Code는 카탈로그 항목과 `--add-dir` 디렉터리의 설정 항목에 동일한 필터를 적용하고, 사용자 설정, `--settings` 파일 또는 관리되는 설정의 항목에는 필터를 적용하지 않습니다.5093* **헤더 필터**: Claude Code는 저장소가 해당 파일을 제공할 수 있으므로 프로젝트의 `.claude/settings.json` 또는 `.claude/settings.local.json`의 항목에서 [요청 라우팅 및 클라이언트 ID 헤더 이름](/docs/ko/plugins/host-marketplace#when-claude-code-skips-a-headershelper-command-or-drops-its-output)을 삭제합니다. Claude Code는 카탈로그 항목 및 `--add-dir` 디렉터리의 설정 항목에 동일한 필터를 적용하고 사용자 설정, `--settings` 파일 또는 관리 설정의 항목에는 필터를 적용하지 않습니다.
4967 5094
4968<h4 id="marketplace-key-aliases">5095<h4 id="marketplace-key-aliases">
4969 마켓플레이스 키 별칭5096 마켓플레이스 키 별칭
4971 5098
4972Claude Code v2.1.232 이상에서는 `extraKnownMarketplaces`를 `additionalMarketplaces`로, `strictKnownMarketplaces`를 `allowedMarketplaces`로 쓸 수 있습니다. Claude Code는 각 별칭을 다음과 같이 취급합니다:5099Claude Code v2.1.232 이상에서는 `extraKnownMarketplaces`를 `additionalMarketplaces`로, `strictKnownMarketplaces`를 `allowedMarketplaces`로 쓸 수 있습니다. Claude Code는 각 별칭을 다음과 같이 취급합니다:
4973 5100
4974* 이전 버전은 별칭을 무시하므로 혼합 Claude Code 버전의 플릿을 위한 관리되는 설정 파일과 같이 이전 버전도 읽는 파일에서 정규 철자를 유지합니다.5101* 이전 버전은 별칭을 무시하므로 혼합 Claude Code 버전의 플릿을 위한 관리 설정 파일과 같이 이전 버전도 읽는 파일에서 정규 철자를 유지합니다.
4975* 정규 키를 수용하는 모든 설정 파일에서 Claude Code는 별칭을 정규 키와 정확히 동일하게 읽습니다.5102* 정규 키를 수용하는 모든 설정 파일에서 Claude Code는 별칭을 정규 키와 정확히 동일하게 읽습니다.
4976* Claude Code는 파일을 업데이트할 때 `additionalMarketplaces`를 `extraKnownMarketplaces`로 다시 쓸 수 있습니다.5103* Claude Code는 파일을 업데이트할 때 `additionalMarketplaces`를 `extraKnownMarketplaces`로 다시 쓸 수 있습니다.
4977* 한 파일에서 두 철자를 모두 설정하면 Claude Code는 정규 값을 사용하고 별칭을 무시합니다.5104* 한 파일에서 두 철자를 모두 설정하면 Claude Code는 정규 값을 사용하고 별칭을 무시합니다.
4980 `pluginConfigs`5107 `pluginConfigs`
4981</h3>5108</h3>
4982 5109
4983플러그인의 [`userConfig`](/docs/ko/plugins-reference#user-configuration) 구성 대화에서 제공하는 비민감 답변을 플러그인 ID로 키가 지정된 상태로 저장합니다. Claude Code는 대화를 작성할 때 이 키를 사용자 설정에 작성하므로 직접 편집할 필요가 없습니다. Claude Code는 민감한 옵션을 macOS Keychain에 저장하고, Keychain이 쓰기를 거부할 때 `~/.claude/.credentials.json`으로 폴백합니다. 지원되는 키체인이 없는 플랫폼에서는 `~/.claude/.credentials.json`에 저장합니다.5110플러그인의 [`userConfig`](/docs/ko/plugins/manifest-reference#user-configuration) 구성 대화에서 제공하는 민감하지 않은 답변을 플러그인 ID로 키가 지정된 상태로 저장합니다. Claude Code는 대화를 작성할 때 이 키를 사용자 설정에 작성하므로 직접 편집할 필요가 없습니다. Claude Code는 민감한 옵션을 macOS Keychain에 저장하고, Keychain이 쓰기를 거부할 때 `~/.claude/.credentials.json`으로 폴백합니다. 지원되는 키체인이 없는 플랫폼에서는 `~/.claude/.credentials.json`에 저장합니다.
4984 5111
4985* **범위**: [`사용자 또는 관리됨`](#scopes)5112* **범위**: [`사용자 또는 관리`](#scopes)
4986* **유형**: 플러그인 ID를 `options` 필드가 있는 객체로 매핑하는 객체. 각 옵션 이름을 문자열, 숫자, Boolean 또는 문자열 배열로 매핑하고, 선택적 `mcpServers` 필드는 동일한 형태의 서버별 사용자 구성 값을 보유합니다5113* **유형**: 플러그인 ID를 `options` 필드가 있는 객체에 매핑하는 객체, 각 옵션 이름을 문자열, 숫자, 부울 또는 문자열 배열에 매핑하고, 동일한 형태의 서버별 사용자 구성 값을 보유하는 선택적 `mcpServers` 필드
4987* **기본값**: 설정되지 않음5114* **기본값**: 설정되지 않음
4988 5115
4989이 예제는 `acme-tools`의 `deployer` 플러그인에 대한 `api_endpoint` 옵션을 저장합니다:5116이 예제는 `acme-tools`의 `deployer` 플러그인에 대한 `api_endpoint` 옵션을 저장합니다:
5000}5127}
5001```5128```
5002 5129
5003기본 제공 플러그인은 `@builtin` 접미사가 있는 동일한 키 아래에 옵션을 저장합니다. 예를 들어, [**프로젝트 지침**](/docs/ko/memory#choose-which-instruction-files-load) 설정은 Claude Code가 `AGENTS.md` 파일을 읽는지 여부를 제어하며 `pluginConfigs["agents-md@builtin"].options.instructionFiles`입니다.5130기본 제공 플러그인은 `@builtin` 접미사가 있는 동일한 키 아래에 옵션을 저장합니다. 예를 들어 Claude Code가 `AGENTS.md` 파일을 읽는지 여부를 제어하는 [**프로젝트 지침**](/docs/ko/memory#choose-which-instruction-files-load) 설정은 `pluginConfigs["agents-md@builtin"].options.instructionFiles`입니다.
5004 5131
5005Claude Code는 이 값을 플러그인 훅, MCP 및 LSP 구성에 대체하므로 프로젝트 및 로컬 항목을 무시합니다. 복제된 저장소는 이를 제공할 수 없습니다. v2.1.207 이전에는 프로젝트 및 로컬 설정도 읽혔습니다.5132Claude Code는 이 값을 플러그인 훅, MCP 및 LSP 구성에 대체하므로 프로젝트 및 로컬 항목을 무시합니다. 복제된 저장소는 이를 제공할 수 없습니다. v2.1.207 이전에는 프로젝트 및 로컬 설정도 읽혔습니다.
5006 5133
5228}5355}
5229```5356```
5230 5357
5231플러그인의 자체 `settings.json`도 이 키를 제공할 수 있습니다. [플러그인과 함께 기본 설정 제공](/docs/ko/plugins#ship-default-settings-with-your-plugin)을 참조하세요.5358플러그인의 자체 `settings.json`도 이 키를 제공할 수 있습니다. [플러그인과 함께 기본 설정 제공](/docs/ko/plugins/components#default-settings)을 참조하세요.
5232 5359
5233<h3 id="crosssessioninbound">5360<h3 id="crosssessioninbound">
5234 `crossSessionInbound`5361 `crossSessionInbound`
5324 * `"in-process"`: 팀원은 메인 터미널 창 내부에서 실행됩니다5451 * `"in-process"`: 팀원은 메인 터미널 창 내부에서 실행됩니다
5325 * `"auto"`: tmux 내부에서 실행 중이거나 `PATH`에 `it2`가 있거나 tmux가 설치된 iTerm2 내부에서 분할 창을 사용합니다. 그 외에는 인프로세스입니다5452 * `"auto"`: tmux 내부에서 실행 중이거나 `PATH`에 `it2`가 있거나 tmux가 설치된 iTerm2 내부에서 분할 창을 사용합니다. 그 외에는 인프로세스입니다
5326 * `"tmux"`: 터미널에서 감지된 tmux 또는 iTerm2를 사용하여 분할 창을 만듭니다5453 * `"tmux"`: 터미널에서 감지된 tmux 또는 iTerm2를 사용하여 분할 창을 만듭니다
5327 * `"iterm2"`: Claude Code v2.1.186 이상에서 `it2` CLI를 통한 iTerm2 네이티브 분할 창5454 * `"iterm2"`: iTerm2 네이티브 분할 창을 `it2` CLI를 통해 사용합니다
5328* **Default**: `"in-process"`5455* **Default**: `"in-process"`
5329* **Per-session overrides**: `--teammate-mode`는 한 세션에 대해 이 키보다 우선합니다5456* **Per-session overrides**: `--teammate-mode`는 한 세션에 대해 이 키보다 우선합니다
5330 5457
5334}5461}
5335```5462```
5336 5463
5337`iterm2` 값에는 Claude Code v2.1.186 이상이 필요합니다.
5338
5339<span id="worktree-settings" />5464<span id="worktree-settings" />
5340 5465
5341<h3 id="worktree">5466<h3 id="worktree">
5671* **유형**: Boolean5796* **유형**: Boolean
5672 * `true`: Claude Code는 각 대화형 세션이 시작될 때 Remote Control을 자동으로 연결합니다5797 * `true`: Claude Code는 각 대화형 세션이 시작될 때 Remote Control을 자동으로 연결합니다
5673 * `false`: Claude Code는 `/remote-control`을 기다립니다5798 * `false`: Claude Code는 `/remote-control`을 기다립니다
5674* **기본값**: 설정되지 않음, 따라서 자동 연결은 설정된 조직의 관리 기본값을 따르고, 그렇지 않으면 Claude Code의 현재 기본값을 따릅니다5799* **기본값**: 설정되지 않음, 따라서 [자동 연결 기본값](/docs/ko/remote-control#enable-remote-control-for-all-sessions)이 적용됩니다
5675* **세션별 재정의**: `--remote-control`은 이 키가 `false`일 때도 한 세션에 대해 Remote Control을 켜고, 플래그는 한 세션에 대해 이를 끌 수 없습니다5800* **세션별 재정의**: `--remote-control`은 이 키가 `false`일 때도 한 세션에 대해 Remote Control을 켜고, 플래그는 한 세션에 대해 이를 끌 수 없습니다
5676 5801
5677```json settings.json theme={null}5802```json settings.json theme={null}
5823 5948
5824`/login` 클라우드 게이트웨이 화면이 연결하는 게이트웨이 URL을 설정하여 사람들이 주소를 입력하지 않고 [클라우드 게이트웨이](/docs/ko/claude-apps-gateway)에 도달하도록 합니다. 화면에는 URL 필드가 없습니다: 이 키가 설정되면, 게이트웨이 URL을 표시하고 사람이 Enter를 누르면 연결합니다. 없으면, IT 관리자에게 문의하도록 알립니다.5949`/login` 클라우드 게이트웨이 화면이 연결하는 게이트웨이 URL을 설정하여 사람들이 주소를 입력하지 않고 [클라우드 게이트웨이](/docs/ko/claude-apps-gateway)에 도달하도록 합니다. 화면에는 URL 필드가 없습니다: 이 키가 설정되면, 게이트웨이 URL을 표시하고 사람이 Enter를 누르면 연결합니다. 없으면, IT 관리자에게 문의하도록 알립니다.
5825 5950
5826이 키 또는 `forceLoginMethod: "gateway"`는 머신을 게이트웨이 전용으로 만들므로, `/login`은 로그인 방법 선택기 없이 클라우드 게이트웨이 화면에서 열립니다. [관리자 정책이 클라우드 게이트웨이 로그인을 요구합니다](/docs/ko/errors#administrator-policy-requires-a-cloud-gateway-sign-in)를 참조하여 남은 첫 번째 당사자 로그인 또는 API 키에 어떤 일이 발생하는지 확인하세요. 화면이 오류를 표시하는 대신 연결하도록 두 키를 모두 설정하세요.5951이 키 또는 `forceLoginMethod: "gateway"`는 머신을 게이트웨이 전용으로 만들므로, `CLAUDE_CODE_USE_*`로 클라우드 공급자를 선택하는 세션을 제외하고, `/login`은 로그인 방법 선택기 없이 클라우드 게이트웨이 화면에서 열립니다. [관리자 정책이 클라우드 게이트웨이 로그인을 요구합니다](/docs/ko/errors#administrator-policy-requires-a-cloud-gateway-sign-in)를 참조하여 남은 첫 번째 당사자 로그인 또는 API 키에 어떤 일이 발생하는지 확인하세요. 화면이 오류를 표시하는 대신 연결하도록 두 키를 모두 설정하세요.
5827 5952
5828* **범위**: [`관리됨`](#scopes). 머신의 소스에서만 읽습니다: `managed-settings.json`, macOS plist 또는 Windows HKLM 레지스트리, 또는 정책 도우미. Claude Code는 HKCU 및 서버 관리 설정에서 무시합니다.5953* **범위**: [`관리됨`](#scopes). 머신의 소스에서만 읽습니다: `managed-settings.json`, macOS plist 또는 Windows HKLM 레지스트리, 또는 정책 도우미. Claude Code는 HKCU 및 서버 관리 설정에서 무시합니다.
5829* **유형**: 문자열, 스키마를 포함한 전체 URL5954* **유형**: 문자열, 스키마를 포함한 전체 URL
6076 `cleanupPeriodDays`6201 `cleanupPeriodDays`
6077</h3>6202</h3>
6078 6203
6079Claude Code가 [세션 기록 및 기타 애플리케이션 데이터](/docs/ko/claude-directory#cleaned-up-automatically)를 삭제하기 전에 보관하는 일 수를 설정합니다. Claude Code는 세션이 시작된 후 백그라운드 스윕으로 삭제를 실행하며, 보관 기간을 안전하게 결정할 수 있는 한 실행합니다.6204Claude Code가 [세션 기록 및 기타 애플리케이션 데이터](/docs/ko/claude-directory#cleaned-up-automatically)를 삭제하기 전에 보관하는 일 수를 설정합니다. Claude Code는 세션이 시작된 후 백그라운드 스윕으로 삭제를 실행하며, 보관 기간을 안전하게 결정할 수 있는 한 실행합니다. 스윕은 메시지를 표시하지 않고 기록을 삭제하므로, 보관 기간보다 오래 사용하지 않은 세션은 더 이상 [`/resume`](/docs/ko/sessions#resume-a-session) 선택기에 나타나지 않습니다.
6080 6205
6081* **범위**: [`모든 파일`](#scopes)6206* **범위**: [`모든 파일`](#scopes)
6082* **유형**: 일 수, 정수, 최소값 `1`6207* **유형**: 일 수, 정수, 최소값 `1`
6173 엔터프라이즈 및 관리형 설정6298 엔터프라이즈 및 관리형 설정
6174</h2>6299</h2>
6175 6300
6176조직이 관리형 설정을 계산, 새로 고침 및 결합하는 데 사용하는 키입니다. [관리형 설정 설정](/docs/ko/admin-setup)을 참조하십시오.6301조직이 관리형 설정을 계산, 새로고침 및 결합하는 데 사용하는 키입니다. [관리형 설정 설정](/docs/ko/admin-setup)을 참조하세요.
6177 6302
6178<h3 id="disablesideloadflags">6303<h3 id="disablesideloadflags">
6179 `disableSideloadFlags`6304 `disableSideloadFlags`
6180</h3>6305</h3>
6181 6306
6182시작 시 `--plugin-dir`, `--plugin-url`, `--agents` 및 `--mcp-config` CLI 플래그를 거부합니다. 사용자는 이러한 플래그를 전달하여 단일 실행을 위해 [`strictKnownMarketplaces`](#strictknownmarketplaces)를 우회할 수 있습니다. Claude Code는 거부된 플래그의 이름을 지정하는 오류로 종료되며, 현재 데스크톱 앱의 [Cowork](/docs/ko/desktop) 로컬 세션인 이러한 플래그로 CLI를 내부적으로 시작하는 표면에 동일한 검사를 적용합니다. [클라우드 세션](/docs/ko/claude-code-on-the-web)에서 Claude Code는 서버가 `--mcp-config`를 통해 전달한 MCP 서버를 삭제합니다. 단, 프로세스 내 `type: "sdk"` 항목은 제외하고 세션을 시작합니다. Claude Code v2.1.193 이상이 필요합니다.6307`--plugin-dir`, `--plugin-url`, `--agents`, `--mcp-config` CLI 플래그를 시작 시 거부하여 사용자가 [`strictKnownMarketplaces`](#strictknownmarketplaces)를 단일 실행으로 우회하는 데 사용할 수 없도록 합니다. Claude Code는 거부된 플래그의 이름을 지정하는 오류로 종료되며, 현재 데스크톱 앱의 [Cowork](/docs/ko/desktop) 로컬 세션을 포함하여 이러한 플래그로 CLI를 내부적으로 시작하는 표면에 동일한 검사를 적용합니다. [클라우드 세션](/docs/ko/claude-code-on-the-web)에서 Claude Code는 `--mcp-config`를 통해 서버가 제공한 MCP 서버를 삭제합니다(인프로세스 `type: "sdk"` 항목 제외). 세션을 시작합니다. Claude Code v2.1.193 이상이 필요합니다.
6183 6308
6184* **범위**: [`Managed`](#scopes)6309* **범위**: [`Managed`](#scopes)
6185* **유형**: Boolean6310* **유형**: Boolean
6186 * `true`: Claude Code는 시작 시 `--plugin-dir`, `--plugin-url`, `--agents` 및 `--mcp-config`를 거부하고 이들의 이름을 지정하는 오류로 종료됩니다. 단, 클라우드 세션에서는 서버가 `--mcp-config`를 통해 전달한 MCP 서버를 삭제합니다. 프로세스 내 `type: "sdk"` 항목은 제외하고 세션을 시작합니다.6311 * `true`: Claude Code는 시작 시 `--plugin-dir`, `--plugin-url`, `--agents`, `--mcp-config`를 거부하고 이름을 지정하는 오류로 종료됩니다. 단, 클라우드 세션에서는 `--mcp-config`를 통해 서버가 제공한 MCP 서버를 삭제합니다(인프로세스 `type: "sdk"` 항목 제외). 세션을 시작합니다.
6187 * `false`: Claude Code는 해당 플래그를 수락합니다.6312 * `false`: Claude Code는 해당 플래그를 수락합니다.
6188* **기본값**: `false`6313* **기본값**: `false`
6189 6314
6193}6318}
6194```6319```
6195 6320
6196Claude Code는 여전히 서버가 모두 프로세스 내 `type: "sdk"` 항목인 `--mcp-config`를 수락하므로 Agent SDK 및 VS Code 확장이 계속 작동합니다. 사용자는 여전히 `claude mcp add` 또는 `.mcp.json` 파일로 서버를 추가할 수 있습니다. 서버별 제어를 위해 [`allowedMcpServers`](/docs/ko/managed-mcp)도 설정하십시오. Claude Code v2.1.193 이상이 필요합니다.6321Claude Code는 여전히 서버가 모두 인프로세스 `type: "sdk"` 항목인 `--mcp-config`를 수락하므로 Agent SDK 및 VS Code 확장이 계속 작동합니다. 사용자는 여전히 `claude mcp add` 또는 `.mcp.json` 파일로 서버를 추가할 수 있습니다. 서버별 제어의 경우 [`allowedMcpServers`](/docs/ko/managed-mcp)도 설정하세요. Claude Code v2.1.193 이상이 필요합니다.
6322
6323동일한 검사는 [`CLAUDE_CODE_PLUGIN_DIRS`](/docs/ko/env-vars#variables) 환경 변수에 명명된 플러그인 폴더를 포함합니다. 이는 Claude Code v2.1.280 이상이 필요합니다. 변수가 폴더의 이름을 지정하면 Claude Code는 동일한 오류로 종료되며, 오류는 변수를 설정 해제하도록 지시합니다.
6197 6324
6198클라우드 세션에서 Claude Code는 또한 서버 전달 중간 세션 MCP 업데이트를 무시합니다. 이는 클라우드 세션 구성 및 SDK `setMcpServers()` 호출이 이러한 세션에 도달하는 경로입니다. 프로세스 내 `type: "sdk"` 항목은 여기서도 면제됩니다. v2.1.239 이전에는 서버 전달 `--mcp-config`가 클라우드 세션이 시작되는 것을 차단했습니다.6325클라우드 세션에서 Claude Code는 또한 서버 제공 중간 세션 MCP 업데이트를 무시합니다. 이는 클라우드 세션 구성 및 SDK `setMcpServers()` 호출 뒤의 경로이며, 이러한 세션에 도달합니다. 인프로세스 `type: "sdk"` 항목은 거기서도 면제됩니다. v2.1.239 이전에는 서버 제공 `--mcp-config`가 클라우드 세션이 시작되는 것을 차단했습니다.
6199 6326
6200<h3 id="forceremotesettingsrefresh">6327<h3 id="forceremotesettingsrefresh">
6201 `forceRemoteSettingsRefresh`6328 `forceRemoteSettingsRefresh`
6202</h3>6329</h3>
6203 6330
6204Claude Code가 [서버 관리형 설정](/docs/ko/server-managed-settings)을 새로 가져올 때까지 CLI 시작을 차단합니다. 가져오기가 실패하면 Claude Code는 캐시된 설정이나 설정 없이 계속하지 않고 종료합니다. 환경이 관리형 정책 없이 세션이 실행되는 짧은 시간 창도 수용할 수 없을 때 설정하십시오.6331Claude Code가 [서버 관리형 설정](/docs/ko/server-managed-settings)을 새로 가져올 때까지 CLI 시작을 차단합니다. 가져오기가 실패하면 Claude Code는 캐시된 설정이나 설정 없이 계속하지 않고 종료합니다. 환경이 관리형 정책 없이 세션이 실행되는 짧은 기간도 허용할 수 없을 때 설정하세요.
6205 6332
6206키가 설정되지 않으면 Claude Code는 가져오기에서 시작을 차단하지 않습니다. 단, 개발자가 시작 시 로그인할 때는 가져오기를 위해 최대 5초를 기다립니다. Cloud 게이트웨이 세션은 항상 기다리며, 게이트웨이에 도달할 수 없으면 종료됩니다.6333키가 설정되지 않으면 Claude Code는 가져오기에서 시작을 차단하지 않지만, 개발자가 시작 시 로그인할 때 가져오기를 위해 최대 5초를 기다립니다. Cloud 게이트웨이 세션은 항상 기다리며, 게이트웨이에 도달할 수 없으면 종료됩니다.
6207 6334
6208* **범위**: [`Managed`](#scopes). Claude Code는 최우선 소스가 아닌 경우에도 관리자 제어 관리형 소스에서 `true`를 인정합니다.6335* **범위**: [`Managed`](#scopes). Claude Code는 최우선 소스가 아닌 경우에도 모든 관리자 제어 관리형 소스에서 `true`를 인정합니다.
6209* **유형**: Boolean6336* **유형**: Boolean
6210 * `true`: Claude Code는 서버 관리형 설정을 새로 가져올 때까지 시작을 차단하고 가져오기가 실패하면 종료합니다.6337 * `true`: Claude Code는 서버 관리형 설정을 새로 가져올 때까지 시작을 차단하고, 가져오기가 실패하면 종료합니다.
6211 * `false`: Claude Code는 가져오기에서 시작을 차단하지 않습니다. 단, 로그인 시작 시 최대 5초를 기다립니다.6338 * `false`: Claude Code는 가져오기에서 시작을 차단하지 않지만, 로그인 시작 시 가져오기를 위해 최대 5초를 기다립니다.
6212* **기본값**: `false`6339* **기본값**: `false`
6213 6340
6214```json managed-settings.json theme={null}6341```json managed-settings.json theme={null}
6217}6344}
6218```6345```
6219 6346
6220MDM 프로필 또는 관리형 설정 파일에 설정하여 첫 번째 서버 페이로드가 도착하기 전에 실패 폐쇄 시작을 적용합니다. Claude Code는 서버 관리형 설정을 가져오는 세션에서만 검사를 적용하므로 [이를 가져오지 않는](/docs/ko/server-managed-settings#platform-availability) 세션은 기다리지 않고 시작됩니다. `claude auth` 하위 명령은 면제되므로 사용자는 만료된 자격 증명이 가져오기 실패의 원인일 때 다시 인증할 수 있습니다. [실패 폐쇄 시작 적용](/docs/ko/server-managed-settings#enforce-fail-closed-startup)을 참조하십시오.6347MDM 프로필 또는 관리형 설정 파일에 설정하여 첫 번째 서버 페이로드가 도착하기 전에 실패 폐쇄 시작을 적용합니다. Claude Code는 서버 관리형 설정을 가져오는 세션에서만 검사를 적용하므로, [가져오지 않는](/docs/ko/server-managed-settings#platform-availability) 세션은 기다리지 않고 시작됩니다. `claude auth` 부명령은 면제되므로 사용자는 만료된 자격 증명이 가져오기 실패의 원인일 때 다시 인증할 수 있습니다. [실패 폐쇄 시작 적용](/docs/ko/server-managed-settings#enforce-fail-closed-startup)을 참조하세요.
6221 6348
6222<h3 id="managedsourcesbehavior">6349<h3 id="managedsourcesbehavior">
6223 `managedSourcesBehavior`6350 `managedSourcesBehavior`
6224</h3>6351</h3>
6225 6352
6226Claude Code가 조직이 전달하는 최우선 [관리형 소스](/docs/ko/managed-settings#how-claude-code-combines-managed-sources)만 적용할지, 아니면 전달하는 모든 관리자 소스를 결합할지 선택합니다. 기본적으로 Claude Code는 [정책 키](/docs/ko/managed-settings#how-claude-code-combines-managed-sources)를 전달하는 최우선 소스를 취하고 나머지는 무시합니다. 정책 키는 이 키와 `wslInheritsWindowsSettings`를 제외한 모든 설정 키입니다. 따라서 서버 관리형 설정이나 MDM 정책이 정책 키를 전달하면 `managed-settings.json` 파일은 [Claude Code가 모든 관리자 소스에서 읽는 키](/docs/ko/managed-settings#keys-read-from-every-admin-source)만 제공합니다. `"merge"`를 사용하면 전달하는 모든 관리자 소스가 하나의 결합된 정책에 키를 제공합니다. Claude Code v2.1.242 이상이 필요합니다.6353Claude Code가 조직이 제공하는 최우선 [관리형 소스](/docs/ko/managed-settings#how-claude-code-combines-managed-sources)만 적용할지, 아니면 제공하는 모든 관리자 소스를 결합할지 선택합니다. 기본적으로 Claude Code는 [정책 키](/docs/ko/managed-settings#how-claude-code-combines-managed-sources)를 전달하는 최우선 소스를 가져가고 나머지는 무시합니다. 정책 키는 이 키와 `wslInheritsWindowsSettings`를 제외한 모든 설정 키입니다. 해당 기본값에서 서버 관리형 설정 또는 MDM 정책이 정책 키를 제공하면 `managed-settings.json` 파일은 [Claude Code가 모든 관리자 소스에서 읽는 키](/docs/ko/managed-settings#keys-read-from-every-admin-source)만 제공합니다. `"merge"`를 사용하면 제공하는 모든 관리자 소스가 결합된 정책에 키를 제공합니다. Claude Code v2.1.242 이상이 필요합니다.
6227 6354
6228최우선 소스 아래에 [순위가 지정된](/docs/ko/managed-settings#how-claude-code-combines-managed-sources) 모든 소스가 관리자의 제어 하에 있는 경우에만 `"merge"`를 설정하십시오. Claude Code는 `permissions.allow` 규칙과 같은 하위 소스의 항목을 정책에 추가하기 때문입니다.6355최우선 소스 아래에 [순위가 지정된](/docs/ko/managed-settings#how-claude-code-combines-managed-sources) 모든 소스가 관리자의 제어 하에 있는 경우에만 `"merge"`를 설정하세요. Claude Code는 `permissions.allow` 규칙과 같은 하위 소스의 항목을 정책에 추가하기 때문입니다.
6229 6356
6230* **범위**: [`Managed`](#scopes). Claude Code는 이 키 또는 정책 키를 전달하는 최우선 소스에서 이 키를 읽고 순위가 낮은 모든 소스에서 이 키를 무시합니다. 따라서 하위 소스는 위의 소스와 결합하도록 자신을 선택할 수 없습니다. Windows HKCU 레지스트리나 [포함 호스트의 부모 설정](/docs/ko/managed-settings#let-an-embedding-host-add-policy)은 병합에 참여하지 않습니다.6357* **범위**: [`Managed`](#scopes). Claude Code는 이 키 또는 정책 키를 전달하는 최우선 소스에서 이 키를 읽고, 순위가 낮은 모든 소스에서 이 키를 무시합니다. 따라서 하위 소스는 위의 소스와 결합하도록 자신을 선택할 수 없습니다. Windows HKCU 레지스트리 또는 [포함 호스트의 부모 설정](/docs/ko/managed-settings#let-an-embedding-host-add-policy)은 병합에 참여하지 않습니다.
6231* **유형**: string, 다음 중 하나:6358* **유형**: string, 다음 중 하나:
6232 * `"first-wins"`: 정책 키를 전달하는 최우선 소스가 정책을 제공하고 하위 소스는 [Claude Code가 모든 관리자 소스에서 읽는 키](/docs/ko/managed-settings#keys-read-from-every-admin-source)만 제공합니다.6359 * `"first-wins"`: 정책 키를 전달하는 최우선 소스가 정책을 제공하고, 하위 소스는 [Claude Code가 모든 관리자 소스에서 읽는 키](/docs/ko/managed-settings#keys-read-from-every-admin-source)만 제공합니다.
6233 * `"merge"`: 전달하는 모든 관리자 소스가 아래 규칙으로 결합된 키를 제공합니다.6360 * `"merge"`: 제공하는 모든 관리자 소스가 키를 제공하며, 아래 규칙에 따라 결합됩니다.
6234* **기본값**: `"first-wins"`6361* **기본값**: `"first-wins"`
6235 6362
6236배포하는 최우선 소스에 키를 전달합니다. 서버 관리형 설정을 받지 않는 머신은 Claude Code가 이 키 또는 정책 키를 전달하는 최우선 소스에서 키를 읽기 때문에 MDM 프로필에도 키가 필요합니다. `managed-settings.json` 파일은 최하위 순위 관리자 소스이므로 여기에 설정된 `"merge"`는 결합할 아래 소스가 없습니다. 서버 관리형 설정에서 키는 다음과 같습니다:6363배포하는 최우선 소스에서 키를 제공합니다. 서버 관리형 설정을 받지 않는 머신은 Claude Code가 이 키 또는 정책 키를 전달하는 최우선 소스에서 키를 읽기 때문에 MDM 프로필에도 키가 필요합니다. `managed-settings.json` 파일은 최하위 순위 관리자 소스이므로, 거기에 설정된 `"merge"`는 결합할 아래 소스가 없습니다. 서버 관리형 설정에서 키는 다음과 같습니다:
6237 6364
6238```json theme={null}6365```json theme={null}
6239{6366{
6241}6368}
6242```6369```
6243 6370
6244`"merge"` 아래에서 Claude Code는 각 키를 종류별로 결합합니다. 이 표는 각 종류에 대한 규칙을 제공합니다. 제한 허용 목록, 값 전체 취득 및 최우선 소스 전용 행은 포함하는 모든 키의 이름을 지정하고 다른 행은 예를 제공합니다:6371`"merge"` 아래에서 Claude Code는 각 키를 종류별로 결합합니다. 이 표는 각 종류에 대한 규칙을 제공합니다. 제한 허용 목록, 값 전체 및 최우선 소스 전용 행은 포함하는 모든 키의 이름을 지정하고, 다른 행은 예를 제공합니다:
6245 6372
6246| 키의 종류 | Claude Code가 결합하는 방식 | 키 |6373| 키의 종류 | Claude Code가 결합하는 방법 | 키 |
6247| :- | :- | :- |6374| :- | :- | :- |
6248| 목록 | 모든 소스의 항목을 결합합니다. | [`permissions.allow`](#permissions-allow), [`sandbox.network.allowedDomains`](#sandbox-network-alloweddomains) 및 기타 목록 키 |6375| 목록 | 모든 소스의 항목을 결합합니다. | [`permissions.allow`](#permissions-allow), [`sandbox.network.allowedDomains`](#sandbox-network-alloweddomains) 및 기타 목록 키 |
6249| 잠금 | 모든 소스가 설정하는 가장 엄격한 값을 적용합니다. 어떤 소스도 엄격한 값을 설정하지 않으면 최우선 소스에서만 더 느슨한 값을 적용합니다. | [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly), [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) 및 기타 boolean 또는 enum 잠금 |6376| 잠금 | 모든 소스가 설정하는 가장 엄격한 값을 적용합니다. 어떤 소스도 엄격한 값을 설정하지 않으면 최우선 소스에서만 더 느슨한 값을 적용합니다. | [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly), [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) 및 기타 boolean 또는 enum 잠금 |
6250| 제한 허용 목록 | 하위 소스의 항목을 추가하지 않고 이를 설정하는 최우선 소스에서 전체 목록을 취합니다. 최우선 소스가 설정하지 않으면 다음 소스에서 전체 목록을 취합니다. | [`availableModels`](#availablemodels), [`allowedMcpServers`](#allowedmcpservers), [`strictKnownMarketplaces`](#strictknownmarketplaces), [`allowedChannelPlugins`](#allowedchannelplugins) 및 [`fallbackModel`](#fallbackmodel) 체인 |6377| 제한 허용 목록 | 하위 소스의 항목을 추가하지 않고 설정하는 최우선 소스에서 목록 전체를 가져옵니다. 최우선 소스가 설정하지 않으면 다음 소스에서 전체를 가져옵니다. | [`availableModels`](#availablemodels), [`allowedMcpServers`](#allowedmcpservers), [`strictKnownMarketplaces`](#strictknownmarketplaces), [`allowedChannelPlugins`](#allowedchannelplugins) 및 [`fallbackModel`](#fallbackmodel) 체인 |
6251| 값 전체 취득 | 하위 소스의 항목이나 필드를 결합하지 않고 이를 설정하는 최우선 소스에서 전체 값을 취합니다. 최우선 소스가 설정하지 않으면 다음 소스에서 전체 값을 취합니다. | [`sandbox.credentials.awsPairs`](#sandbox-credentials-awspairs), [`sandbox.ripgrep`](#sandbox-ripgrep) |6378| 값 전체 | 하위 소스의 항목이나 필드를 결합하지 않고 설정하는 최우선 소스에서 값 전체를 가져옵니다. 최우선 소스가 설정하지 않으면 다음 소스에서 전체를 가져옵니다. | [`sandbox.credentials.awsPairs`](#sandbox-credentials-awspairs), [`sandbox.ripgrep`](#sandbox-ripgrep) |
6252| 제공된 MCP 서버 | 모든 소스의 서버 이름을 결합합니다. 두 소스가 동일한 이름을 설정하면 상위 소스의 전체 항목을 적용합니다. | [`managedMcpServers`](#managedmcpservers) |6379| 제공된 MCP 서버 | 모든 소스의 서버 이름을 결합합니다. 두 소스가 동일한 이름을 설정하면 상위 소스의 전체 항목을 적용합니다. | [`managedMcpServers`](#managedmcpservers) |
6253| 최우선 소스에서만 읽기 | 정책 키를 전달하는 최우선 소스에서만 키를 읽으므로 최우선 소스가 설정하지 않을 때도 하위 소스의 값은 무시됩니다. | [`apiKeyHelper`](#apikeyhelper), [`awsAuthRefresh`](#awsauthrefresh), [`awsCredentialExport`](#awscredentialexport), [`gcpAuthRefresh`](#gcpauthrefresh), [`otelHeadersHelper`](#otelheadershelper), `proxyAuthHelper`, [`forceLoginOrgUUID`](#forceloginorguuid), [`forceLoginMethod`](#forceloginmethod)의 `"claudeai"` 및 `"console"` 값, [`parentSettingsBehavior`](#parentsettingsbehavior), [`modelPicker`](#modelpicker), [`policyHelper`](#policyhelper), [`permissions.defaultMode`](#permissions-defaultmode) |6380| 최우선 소스에서만 읽기 | 정책 키를 전달하는 최우선 소스에서만 키를 읽으므로, 최우선 소스가 설정하지 않을 때에도 하위 소스의 값은 무시됩니다. | [`apiKeyHelper`](#apikeyhelper), [`awsAuthRefresh`](#awsauthrefresh), [`awsCredentialExport`](#awscredentialexport), [`gcpAuthRefresh`](#gcpauthrefresh), [`otelHeadersHelper`](#otelheadershelper), `proxyAuthHelper`, [`forceLoginOrgUUID`](#forceloginorguuid), [`forceLoginMethod`](#forceloginmethod)의 `"claudeai"` 및 `"console"` 값, [`parentSettingsBehavior`](#parentsettingsbehavior), [`modelPicker`](#modelpicker), [`policyHelper`](#policyhelper), [`permissions.defaultMode`](#permissions-defaultmode) |
6254| `env` | [관리자 소스 전체에서 변수별로 병합합니다](/docs/ko/managed-settings#keys-read-from-every-admin-source). `"first-wins"` 및 `"merge"` 모두에서 | [`env`](#env) |6381| `env` | [관리자 소스 전체에서 변수별로 병합합니다](/docs/ko/managed-settings#keys-read-from-every-admin-source). `"first-wins"` 및 `"merge"` 모두에서 | [`env`](#env) |
6255| 다른 모든 키 | 이를 설정하는 최우선 소스에서 값을 취합니다. | [`cleanupPeriodDays`](#cleanupperioddays), [`model`](#model) |6382| 다른 모든 키 | 설정하는 최우선 소스에서 값을 가져옵니다. | [`cleanupPeriodDays`](#cleanupperioddays), [`model`](#model) |
6256 6383
6257`sandbox.credentials.awsPairs` 및 `sandbox.ripgrep`을 전체로 취득하려면 Claude Code v2.1.257 이상이 필요합니다.6384`sandbox.credentials.awsPairs` 및 `sandbox.ripgrep`을 전체로 가져오려면 Claude Code v2.1.257 이상이 필요합니다.
6258 6385
6259몇 가지 키는 표에 표시되지 않는 조건을 추가합니다:6386몇 가지 키는 표에 표시되지 않는 조건을 추가합니다:
6260 6387
6261* **[`policyHelper`](#policyhelper)**: Claude Code는 정책 키를 전달하는 최우선 소스가 MDM 정책이거나 관리형 설정 파일일 때만 이를 인정하므로 서버 관리형 설정에서는 적용되지 않습니다.6388* **[`policyHelper`](#policyhelper)**: Claude Code는 정책 키를 전달하는 최우선 소스가 MDM 정책 또는 관리형 설정 파일일 때만 인정하므로, 서버 관리형 설정에서는 적용되지 않습니다.
6262* **[`modelOverrides`](#modeloverrides)**: `availableModels`와 쌍을 이룹니다. Claude Code는 이를 설정하는 최우선 소스에서 `modelOverrides`를 취합니다. 단, 상위 소스가 `modelOverrides` 없이 `availableModels`를 설정하는 경우는 제외합니다. 이 경우 모든 소스에서 `modelOverrides`를 무시합니다.6389* **[`modelOverrides`](#modeloverrides)**: `availableModels`와 쌍을 이룹니다. Claude Code는 설정하는 최우선 소스에서 `modelOverrides`를 가져옵니다. 단, 상위 소스가 `modelOverrides` 없이 `availableModels`를 설정하는 경우는 제외됩니다. 이 경우 모든 소스에서 `modelOverrides`를 무시합니다.
6263* **[`forceLoginGatewayUrl`](#forcelogingatewayurl), [`gatewayInternalNetworks`](#gatewayinternalnetworks) 및 [`forceLoginMethod`](#forceloginmethod)의 `"gateway"` 값**: Claude Code는 서버 관리형 설정에서 이들을 읽지 않으므로 여기의 값은 MDM 정책이나 관리형 설정 파일에 설정된 값을 적용하거나 숨기지 않습니다. 머신의 관리자 소스 중에서 정책 키를 전달하는 최우선 순위 소스만 이들을 제공합니다. 서버 관리형 설정도 있는지 여부와 관계없이.6390* **[`forceLoginGatewayUrl`](#forcelogingatewayurl), [`gatewayInternalNetworks`](#gatewayinternalnetworks) 및 [`forceLoginMethod`](#forceloginmethod)의 `"gateway"` 값**: Claude Code는 서버 관리형 설정에서 이들 중 어느 것도 읽지 않으므로, 거기의 값은 MDM 정책 또는 관리형 설정 파일에 설정된 값을 적용하거나 숨기지 않습니다. 머신의 관리자 소스 중에서 정책 키를 전달하는 최우선 순위 소스만 서버 관리형 설정도 있는지 여부와 관계없이 이들을 제공합니다.
6264 6391
6265머신에서 결합된 소스를 확인하려면 `/status`를 실행하고 [`Setting sources` 행을 읽으십시오](/docs/ko/managed-settings#read-the-source-in-/status).6392머신에서 결합된 소스를 확인하려면 `/status`를 실행하고 [`Setting sources` 행을 읽으세요](/docs/ko/managed-settings#read-the-source-in-/status).
6266 6393
6267<h3 id="parentsettingsbehavior">6394<h3 id="parentsettingsbehavior">
6268 `parentSettingsBehavior`6395 `parentSettingsBehavior`
6269</h3>6396</h3>
6270 6397
6271Claude Code가 Agent SDK 또는 IDE 확장과 같은 포함 호스트 프로세스에서 제공하는 관리형 설정을 적용할지 선택합니다. 관리자 배포 관리형 계층도 있을 때. `"first-wins"`를 사용하면 Claude Code는 호스트 제공 설정을 삭제합니다. `"merge"`를 사용하면 제한 전용 필터를 통해 관리자 계층 아래에 적용합니다. 호스트가 자신의 제한을 시작하는 세션에 전달해야 할 때 `"merge"`를 설정하십시오. 예를 들어 Claude Desktop이 게이트웨이의 송신 허용 목록을 전달합니다.6398Claude Code가 Agent SDK 또는 IDE 확장과 같은 포함 호스트 프로세스에서 제공하는 관리형 설정을 적용할지 선택합니다. 관리자 배포 관리형 계층도 있을 때. `"first-wins"`를 사용하면 Claude Code는 호스트 제공 설정을 삭제합니다. `"merge"`를 사용하면 제한 전용 필터를 통해 관리자 계층 아래에 적용합니다. 호스트가 자신의 제한을 시작하는 세션에 전달해야 할 때 `"merge"`를 설정하세요. 예를 들어 Claude Desktop이 게이트웨이의 송신 허용 목록을 제공합니다.
6272 6399
6273* **범위**: [`Managed`](#scopes). Claude Code는 최우선 관리자 제어 관리형 소스에서 이를 읽습니다.6400* **범위**: [`Managed`](#scopes). Claude Code는 최우선 관리자 제어 관리형 소스에서 읽습니다.
6274* **유형**: string, 다음 중 하나:6401* **유형**: string, 다음 중 하나:
6275 * `"first-wins"`: Claude Code는 관리자 배포 관리형 계층이 있을 때 호스트 제공 설정을 삭제합니다.6402 * `"first-wins"`: Claude Code는 관리자 배포 관리형 계층이 있을 때 호스트 제공 설정을 삭제합니다.
6276 * `"merge"`: Claude Code는 제한 전용 필터를 통해 관리자 계층 아래에 호스트 제공 설정을 적용합니다.6403 * `"merge"`: Claude Code는 제한 전용 필터를 통해 관리자 계층 아래에 호스트 제공 설정을 적용합니다.
6282}6409}
6283```6410```
6284 6411
6285관리자 배포 관리형 계층이 없을 때 이 키는 효과가 없습니다. 호스트의 설정은 유일한 관리형 계층으로 적용되며 여전히 제한 값으로 필터링됩니다. 필터의 제한 및 관리형 소스가 상호 작용하는 방식은 [포함 호스트의 부모 설정](/docs/ko/managed-settings#parent-settings-from-embedding-hosts) 및 [부모 설정 제한](/docs/ko/claude-apps-gateway#restrict-parent-settings)을 참조하십시오.6412관리자 배포 관리형 계층이 없을 때 이 키는 효과가 없습니다. 호스트의 설정은 유일한 관리형 계층으로 적용되며, 여전히 제한 값으로 필터링됩니다. 필터의 제한 및 관리형 소스가 상호 작용하는 방식에 대해서는 [포함 호스트의 부모 설정](/docs/ko/managed-settings#parent-settings-from-embedding-hosts) 및 [부모 설정 제한](/docs/ko/claude-apps-gateway#restrict-parent-settings)을 참조하세요.
6286 6413
6287<span id="compute-managed-settings-with-a-policy-helper" />6414<span id="compute-managed-settings-with-a-policy-helper" />
6288 6415
6290 `policyHelper`6417 `policyHelper`
6291</h3>6418</h3>
6292 6419
6293배포하는 실행 파일을 실행하여 시작 시 관리형 설정을 계산합니다. 정적 파일 대신 디바이스 상태, ID 또는 원격 서비스에서 정책을 파생할 수 있습니다. Claude Code는 첫 번째 프롬프트를 수락하기 전에 도우미를 실행하고 내보내는 설정을 세션의 관리형 설정으로 취급합니다.6420배포하는 실행 파일을 실행하여 시작 시 관리형 설정을 계산하므로 정적 파일 대신 디바이스 상태, ID 또는 원격 서비스에서 정책을 파생할 수 있습니다. Claude Code는 첫 번째 프롬프트를 수락하기 전에 도우미를 실행하고 내보내는 설정을 세션의 관리형 설정으로 처리합니다.
6294 6421
6295* **범위**: [`Managed`](#scopes). macOS plist, Windows HKLM 레지스트리 또는 관리형 설정 파일에서 읽습니다. Claude Code는 [정책 키](/docs/ko/managed-settings#how-claude-code-combines-managed-sources)를 전달하는 최우선 관리형 소스에서 키를 읽고 해당 소스가 이 세 가지 중 하나일 때만 도우미를 실행합니다. 서버 관리형 설정, HKCU 레지스트리 및 호스트 제공 부모 설정에서 키를 무시합니다.6422* **범위**: [`Managed`](#scopes). macOS plist, Windows HKLM 레지스트리 또는 관리형 설정 파일에서 읽습니다. Claude Code는 [정책 키](/docs/ko/managed-settings#how-claude-code-combines-managed-sources)를 전달하는 최우선 관리형 소스에서 키를 읽고, 해당 소스가 이 세 가지 중 하나일 때만 도우미를 실행합니다. 서버 관리형 설정, HKCU 레지스트리 및 호스트 제공 부모 설정에서 키를 무시합니다.
6296* **유형**: `path`, `timeoutMs` 및 `refreshIntervalMs`가 있는 object6423* **유형**: `path`, `timeoutMs` 및 `refreshIntervalMs`가 있는 object
6297* **기본값**: 설정되지 않음. 따라서 도우미가 실행되지 않습니다.6424* **기본값**: 설정 해제되어 도우미가 실행되지 않습니다.
6298 6425
6299서버 관리형 설정이 시작 시 정책을 전달하면 도우미의 소스보다 우선하고 도우미는 실행되지 않습니다.6426서버 관리형 설정이 시작 시 정책을 제공하면 도우미의 소스보다 우선하고 도우미는 실행되지 않습니다.
6300 6427
6301나중에 설정 가져오기가 서버 관리형 설정이 제거되었음을 보고하면 Claude Code는 다음 시작을 기다리지 않고 그 시점에서 도우미를 실행합니다. 그 출력은 세션의 나머지를 관리하고 실패한 실행은 [실패한 시작 실행](#helper-failures)과 동일한 메시지로 세션을 종료합니다.6428나중에 설정 가져오기가 서버 관리형 설정이 제거되었음을 보고하면 Claude Code는 다음 시작을 기다리지 않고 그 시점에서 도우미를 실행합니다. 출력은 세션의 나머지를 관리하고, 실패한 실행은 [실패한 시작 실행](#helper-failures)과 동일한 메시지로 세션을 종료합니다.
6302 6429
6303이 예제는 5초 시간 초과로 도우미를 실행하고 5분마다 다시 실행합니다:6430이 예제는 5초 시간 초과로 도우미를 실행하고 5분마다 다시 실행합니다:
6304 6431
6316 도우미 출력 작성6443 도우미 출력 작성
6317</h4>6444</h4>
6318 6445
6319Claude Code는 인수 없이 도우미를 실행하고 환경에 `CLAUDE_CODE_VERSION`을 설정하며 stdout에서 JSON 봉투를 읽습니다. 1 MiB로 제한됩니다.6446Claude Code는 인수 없이 도우미를 실행하고, 환경에서 `CLAUDE_CODE_VERSION`을 설정하고, stdout에서 JSON 봉투를 읽으며, 1 MiB로 제한됩니다.
6320 6447
6321`managedSettings` 키 아래에 설정을 배치합니다. `managedSettings` 키가 없는 베어 설정 객체는 `managedSettings` undefined로 구문 분석되고 아무것도 적용하지 않으며 Claude Code는 오류를 보고하지 않습니다:6448`managedSettings` 키 아래에 설정을 배치합니다. `managedSettings` 키가 없는 베어 설정 객체는 `managedSettings` undefined로 구문 분석되고 아무것도 적용하지 않으며, Claude Code는 오류를 보고하지 않습니다:
6322 6449
6323```json theme={null}6450```json theme={null}
6324{6451{
6328}6455}
6329```6456```
6330 6457
6331도우미가 `managedSettings`를 내보낼 때 해당 객체는 실행의 유일한 관리형 설정 소스가 됩니다. Claude Code는 MDM, 파일 및 HKCU 소스를 무시하고 도우미의 출력에서만 [교차 소스 키](/docs/ko/managed-settings#keys-read-from-every-admin-source)를 읽으며 [부모 설정](/docs/ko/managed-settings#parent-settings-from-embedding-hosts)을 병합하지 않습니다.6458도우미가 `managedSettings`를 내보내면 해당 객체는 실행의 유일한 관리형 설정 소스가 됩니다. Claude Code는 MDM, 파일 및 HKCU 소스를 무시하고, 도우미의 출력에서만 [교차 소스 키](/docs/ko/managed-settings#keys-read-from-every-admin-source)를 읽고, [부모 설정](/docs/ko/managed-settings#parent-settings-from-embedding-hosts)을 병합하지 않습니다.
6332 6459
6333시작 `forceRemoteSettingsRefresh` 검사는 도우미 전에 실행되고 모든 관리자 소스를 읽습니다. 도우미가 `managedSettings`를 생략하는 봉투로 0을 종료하면 관리형 설정을 제공하지 않으며 다른 소스가 평소대로 적용됩니다.6460시작 `forceRemoteSettingsRefresh` 검사는 도우미 전에 실행되고 모든 관리자 소스를 읽습니다. 도우미가 `managedSettings`를 생략하는 봉투로 0을 종료하면 관리형 설정을 제공하지 않으며, 다른 소스는 평소대로 적용됩니다.
6334 6461
6335<h4 id="helper-failures">6462<h4 id="helper-failures">
6336 도우미 실패6463 도우미 실패
6337</h4>6464</h4>
6338 6465
6339도우미 실행이 실패하는 경우:6466도우미 실행은 다음과 같은 경우 실패합니다:
6340 6467
6341* `path`가 [`policyHelper.path`](#policyhelper-path)의 규칙을 위반합니다.6468* `path`가 [`policyHelper.path`](#policyhelper-path)의 규칙을 위반합니다.
6342* `path`에 일반 파일이 없습니다. Claude Code는 도우미를 시작하기 전에 동일한 `timeoutMs` 예산 내에서 파일을 확인하므로 응답하지 않는 네트워크 마운트로 인해 실행이 실패할 수 있습니다.6469* `path`에 일반 파일이 없습니다. Claude Code는 도우미를 시작하기 전에 동일한 `timeoutMs` 예산 내에서 파일을 확인하므로, 응답하지 않는 네트워크 마운트로 인해 실행이 실패할 수 있습니다.
6343* 도우미가 0이 아닌 값으로 종료되거나 `timeoutMs`가 경과할 때 여전히 실행 중이거나 예를 들어 실행 가능하지 않아 시작되지 않습니다.6470* 도우미가 0이 아닌 값으로 종료되거나, `timeoutMs`가 경과할 때 여전히 실행 중이거나, 예를 들어 실행 가능하지 않기 때문에 전혀 시작되지 않습니다.
6344* 도우미가 stdout 또는 stderr에 1 MiB 이상을 씁니다.6471* 도우미가 stdout 또는 stderr에 1 MiB 이상을 씁니다.
6345* stdout이 단일 JSON 객체가 아니거나 `managedSettings`에 [Claude Code가 복구할 수 없는 스키마 위반](/docs/ko/managed-settings#find-entries-claude-code-dropped)이 있습니다.6472* stdout이 단일 JSON 객체가 아니거나, `managedSettings`에 [Claude Code가 복구할 수 없는 스키마 위반](/docs/ko/managed-settings#find-entries-claude-code-dropped)이 있습니다.
6346 6473
6347시작 실행이 실패하면 Claude Code는 이유를 인쇄하고 시작을 거부합니다. 0이 아닌 종료 후 이유에는 도우미의 stderr 또는 stderr가 비어 있을 때 stdout이 포함됩니다. 시간 초과 후 이유는 `timeoutMs` 제한의 이름을 지정하고 도우미의 출력을 포함하지 않습니다. 거부는 대화형 세션, `claude -p`, Agent SDK 세션, [백그라운드 세션](/docs/ko/agent-view) 및 대부분의 하위 명령을 포함합니다.6474시작 실행이 실패하면 Claude Code는 이유를 인쇄하고 시작을 거부합니다. 0이 아닌 종료 후 이유에는 도우미의 stderr 또는 stderr가 비어 있을 때 stdout이 포함됩니다. 시간 초과 후 이유는 `timeoutMs` 제한의 이름을 지정하고 도우미의 출력을 포함하지 않습니다. 거부는 대화형 세션, `claude -p`, Agent SDK 세션, [백그라운드 세션](/docs/ko/agent-view) 및 대부분의 부명령을 포함합니다.
6348 6475
6349거부는 의도적이므로 중단 복원력이 필요한 도우미는 자신의 캐시에서 제공하고 0을 종료해야 합니다.6476거부는 의도적이므로 중단 복원력이 필요한 도우미는 자신의 캐시에서 제공하고 0을 종료해야 합니다.
6350 6477
6351백그라운드 새로 고침이 실패하면 Claude Code는 마지막 성공한 정책을 적용 상태로 유지하고 `/status`는 새로 고침이 성공할 때까지 이유와 함께 실패한 새로 고침을 표시합니다. 각 새로 고침은 시작 실행과 동일한 `timeoutMs` 및 실패 규칙에서 실행됩니다.6478백그라운드 새로고침이 실패하면 Claude Code는 마지막 성공한 정책을 유지하고, `/status`는 새로고침이 성공할 때까지 이유와 함께 실패한 새로고침을 표시합니다. 각 새로고침은 시작 실행과 동일한 `timeoutMs` 및 실패 규칙에서 실행됩니다.
6352 6479
6353`--debug`를 사용하면 Claude Code는 모든 실행에서 도우미의 stderr를 [디버그 로그](/docs/ko/debug-your-config)에 씁니다.6480`--debug`를 사용하면 Claude Code는 모든 실행에서 도우미의 stderr을 [디버그 로그](/docs/ko/debug-your-config)에 씁니다.
6354 6481
6355Claude Code는 잘못된 `policyHelper` 값을 [삭제된 항목](/docs/ko/managed-settings#find-entries-claude-code-dropped)으로 보고하고 도우미를 실행하지 않고 나머지 관리형 설정에서 세션을 시작합니다. 잘못된 값에는 베어 경로 문자열 및 [최소값](#policyhelper-timeoutms) 아래의 `timeoutMs`가 포함됩니다.6482Claude Code는 잘못된 `policyHelper` 값을 [삭제된 항목](/docs/ko/managed-settings#find-entries-claude-code-dropped)으로 보고하고 도우미를 실행하지 않고 나머지 관리형 설정에서 세션을 시작합니다. 잘못된 값에는 베어 경로 문자열 및 [최소값](#policyhelper-timeoutms) 아래의 `timeoutMs`가 포함됩니다.
6356 6483
6357도우미를 끄려면 이를 설정하는 소스에서 키를 제거합니다.6484도우미를 끄려면 설정하는 소스에서 키를 제거합니다.
6358 6485
6359<h3 id="policyhelper-path">6486<h3 id="policyhelper-path">
6360 `policyHelper.path`6487 `policyHelper.path`
6361</h3>6488</h3>
6362 6489
6363Claude Code가 실행하는 도우미 실행 파일의 이름을 지정합니다. 경로가 아래 규칙을 위반할 때 발생하는 일은 [도우미 실패](#helper-failures)를 참조하십시오.6490Claude Code가 실행하는 도우미 실행 파일의 이름을 지정합니다. 경로가 아래 규칙을 위반할 때 발생하는 일은 [도우미 실패](#helper-failures)를 참조하세요.
6364 6491
6365* **범위**: [`Managed`](#scopes). [`policyHelper`](#policyhelper)가 읽히는 macOS plist, Windows HKLM 레지스트리 또는 관리형 설정 파일에서 읽습니다.6492* **범위**: [`Managed`](#scopes). [`policyHelper`](#policyhelper)가 읽히는 macOS plist, Windows HKLM 레지스트리 또는 관리형 설정 파일에서 읽습니다.
6366* **유형**: string, `.` 또는 `..` 세그먼트 없이 정규화된 형식의 절대 경로. Windows에서는 `.exe`로 끝나는 드라이브 문자 또는 UNC 경로6493* **유형**: string, `.` 또는 `..` 세그먼트 없이 정규화된 형식의 절대 경로. Windows에서는 `.exe`로 끝나는 드라이브 문자 또는 UNC 경로
6378 `policyHelper.timeoutMs`6505 `policyHelper.timeoutMs`
6379</h3>6506</h3>
6380 6507
6381Claude Code가 도우미를 기다리는 시간을 설정합니다. 시간 초과 실행은 0이 아닌 종료와 동일한 방식으로 실패하므로 시작 시 Claude Code는 시작을 거부합니다.6508Claude Code가 도우미를 기다리는 시간을 설정하고, 실행을 실패로 처리합니다. 시간 초과 실행은 0이 아닌 종료와 동일한 방식으로 실패하므로 시작 시 Claude Code는 시작을 거부합니다.
6382 6509
6383* **범위**: [`Managed`](#scopes). [`policyHelper`](#policyhelper)가 읽히는 macOS plist, Windows HKLM 레지스트리 또는 관리형 설정 파일에서 읽습니다.6510* **범위**: [`Managed`](#scopes). [`policyHelper`](#policyhelper)가 읽히는 macOS plist, Windows HKLM 레지스트리 또는 관리형 설정 파일에서 읽습니다.
6384* **유형**: integer, 밀리초, 최소 `1000`6511* **유형**: integer, 밀리초, 최소 `1000`
6397 `policyHelper.refreshIntervalMs`6524 `policyHelper.refreshIntervalMs`
6398</h3>6525</h3>
6399 6526
6400Claude Code가 백그라운드에서 간격으로 도우미를 다시 실행하여 정책 변경이 실행 중인 세션에 도달하도록 합니다. 새로 고침이 성공하면 그 출력이 이전 관리형 설정을 다시 시작 없이 대체합니다. 새로 고침이 실패하면 Claude Code는 이미 가진 정책을 유지합니다.6527Claude Code가 백그라운드에서 간격으로 도우미를 다시 실행하여 정책 변경이 실행 중인 세션에 도달하도록 합니다. 새로고침이 성공하면 출력이 이전 관리형 설정을 다시 시작 없이 대체합니다. 새로고침이 실패하면 Claude Code는 이미 있는 정책을 유지합니다.
6401 6528
6402* **범위**: [`Managed`](#scopes). [`policyHelper`](#policyhelper)가 읽히는 macOS plist, Windows HKLM 레지스트리 또는 관리형 설정 파일에서 읽습니다.6529* **범위**: [`Managed`](#scopes). [`policyHelper`](#policyhelper)가 읽히는 macOS plist, Windows HKLM 레지스트리 또는 관리형 설정 파일에서 읽습니다.
6403* **유형**: integer, 밀리초: 새로 고침을 비활성화하려면 `0`, 그렇지 않으면 최소 `60000`6530* **유형**: integer, 밀리초: 새로고침을 비활성화하려면 `0`, 그렇지 않으면 최소 `60000`
6404* **기본값**: 설정되지 않음. 따라서 Claude Code는 시작 시 도우미를 한 번 실행합니다.6531* **기본값**: 설정 해제되어 Claude Code가 시작 시 도우미를 한 번 실행합니다.
6405 6532
6406이 예제는 5분마다 도우미를 다시 실행합니다:6533이 예제는 5분마다 도우미를 다시 실행합니다:
6407 6534
6418 `wslInheritsWindowsSettings`6545 `wslInheritsWindowsSettings`
6419</h3>6546</h3>
6420 6547
6421WSL의 Claude Code가 Windows 정책 체인에서 관리형 설정을 읽도록 합니다. HKLM 및 Windows 관리형 설정 파일이 `/etc/claude-code` 및 아래의 HKCU보다 우선합니다. 체인이 켜져 있는 동안 Claude Code는 `C:\Program Files\ClaudeCode\` 아래의 관리형 설정 파일이나 드롭인이 [정책 키](/docs/ko/managed-settings#how-claude-code-combines-managed-sources)를 전달하지 않을 때만 `/etc/claude-code`를 읽습니다. Windows에 이미 배포한 정책을 WSL 세션으로 확장하도록 설정하여 동일한 머신의 호스트 세션과 동일한 규칙을 따르도록 합니다. Claude Code는 HKLM 레지스트리 키 또는 `C:\Program Files\ClaudeCode\` 아래의 관리형 설정 파일이나 드롭인에 설정된 경우에만 이를 인정합니다. 둘 다 쓰기 위해 Windows 관리자가 필요합니다.6548Claude Code on WSL이 Windows 정책 체인에서 관리형 설정을 읽도록 하여 HKLM 및 Windows 관리형 설정 파일이 `/etc/claude-code` 및 아래의 HKCU보다 우선하도록 합니다. 체인이 켜져 있는 동안 Claude Code는 [HKLM 레지스트리 값 또는 `C:\Program Files\ClaudeCode\` 폴더에 Windows 관리자 문서가 없을 때](/docs/ko/managed-settings#present-admin-documents)만 `/etc/claude-code`를 읽습니다. Windows에 이미 배포한 정책을 WSL 세션으로 확장하도록 설정하여 호스트 세션과 동일한 규칙을 따르도록 합니다. Claude Code는 HKLM 레지스트리 키 또는 `C:\Program Files\ClaudeCode\` 아래의 관리형 설정 파일 또는 드롭인에 설정된 경우에만 인정하며, 둘 다 Windows 관리자가 작성해야 합니다.
6422 6549
6423* **범위**: [`Managed`](#scopes). 관리자 제어 Windows 소스에서.6550* **범위**: [`Managed`](#scopes). 관리자 제어 Windows 소스에서.
6424* **유형**: Boolean6551* **유형**: Boolean
6425 * `true`: WSL의 Claude Code는 Windows 정책 체인에서 관리형 설정을 읽고 `C:\Program Files\ClaudeCode\` 아래의 관리형 설정 파일이나 드롭인이 [정책 키](/docs/ko/managed-settings#how-claude-code-combines-managed-sources)를 전달하지 않을 때만 `/etc/claude-code`를 읽습니다.6552 * `true`: Claude Code on WSL은 Windows 정책 체인에서 관리형 설정을 읽고, Windows 관리자 문서가 없을 때만 `/etc/claude-code`를 읽습니다.
6426 * `false`: WSL은 `/etc/claude-code`만 읽습니다.6553 * `false`: WSL은 `/etc/claude-code`만 읽습니다.
6427* **기본값**: `false`. WSL은 `/etc/claude-code`만 읽습니다.6554* **기본값**: `false`, WSL은 `/etc/claude-code`만 읽습니다.
6428 6555
6429```json managed-settings.json theme={null}6556```json managed-settings.json theme={null}
6430{6557{
6432}6559}
6433```6560```
6434 6561
6435관리자 소스가 체인을 켜면 HKCU 정책은 HKCU도 키를 `true`로 설정할 때만 WSL에 참여합니다. 그 복사본은 체인을 자체적으로 켜지 않습니다. 이 키만 포함하는 Windows 소스는 정책 소스로 계산되지 않으므로 하위 우선 소스는 여전히 정책을 제공합니다. 이 키는 네이티브 Windows에 영향을 주지 않습니다.6562관리자 소스가 체인을 켜면 HKCU 정책은 HKCU도 키를 `true`로 설정할 때만 WSL에서 체인에 참여합니다. 해당 복사본은 체인을 자체적으로 켜지 않습니다. 이 키만 포함하고 `true` 또는 `false`로 설정된 Windows 소스는 정책 소스로 계산되지 않으므로 하위 우선 소스는 여전히 정책을 제공합니다. 이 키는 네이티브 Windows에 영향을 주지 않습니다.
6563
6564Claude Code는 따옴표 있음 또는 없음으로 `true` 및 `false`를 읽고 `null`을 키 제거로 읽습니다. 다른 값을 보유하는 관리자 제어 Windows 소스는 체인이 켜져 있는 [현재 관리자 문서](/docs/ko/managed-settings#present-admin-documents)로 계산됩니다. `/etc/claude-code` 또는 HKCU는 적용되지 않으며, 시작 경고는 키의 이름을 지정합니다. 존재하지만 읽을 수 없는 HKLM 값 또는 Windows 폴더 파일도 체인이 켜져 있는지 여부와 관계없이 `/etc/claude-code`가 적용되는 것을 방지합니다. Claude Code v2.1.282 이상이 필요합니다.
6436 6565
6437<h2 id="global-config-settings">6566<h2 id="global-config-settings">
6438 전역 설정6567 전역 설정
6482 6611
6483Claude Code는 `settings.json`에서 이 키를 무시합니다.6612Claude Code는 `settings.json`에서 이 키를 무시합니다.
6484 6613
6614<h3 id="claudeinchromedefaultenabled">
6615 `claudeInChromeDefaultEnabled`
6616</h3>
6617
6618매번 `--chrome`을 전달하지 않고도 모든 대화형 CLI 세션을 [Chrome 통합](/docs/ko/chrome)이 켜진 상태로 시작합니다. [`claude remote-control`](/docs/ko/remote-control)을 실행하면 `bypassPermissions` 모드를 제외하고 시작하는 [프로젝트](/docs/ko/claude-projects) 스레드의 세션도 이 키를 따릅니다. `/chrome`을 실행하고 **기본적으로 활성화됨**을 선택하면 [Chrome 기본적으로 활성화](/docs/ko/chrome#enable-chrome-by-default)에 설명된 대로 이 키가 설정됩니다. `/config`에 **Chrome에서 Claude 기본적으로 활성화됨**으로 표시됩니다.
6619
6620* **범위**: [`전역 설정`](#scopes)
6621* **유형**: Boolean
6622 * `true`: Claude Code가 대화형 CLI 세션이 시작될 때 Chrome 통합을 켭니다. `--chrome`을 전달할 때처럼 작동합니다
6623 * `false`: 대화형 CLI 세션이 Chrome 통합이 꺼진 상태로 시작되며, Claude Code는 [설정을 제안하는 것을 중단](/docs/ko/chrome#install-the-extension-when-claude-asks)합니다. 한 대화형 세션에 대해 켜려면 `--chrome`을 전달하세요
6624* **기본값**: 설정되지 않음. Chrome 통합이 꺼져 있고 Claude Code는 여전히 설정을 제안할 수 있습니다
6625* **세션별 재정의**: `--chrome` 및 [`--no-chrome`](/docs/ko/cli-reference)이 한 대화형 세션에 대해 이 키보다 우선합니다
6626
6627```json ~/.claude.json theme={null}
6628{
6629 "claudeInChromeDefaultEnabled": true
6630}
6631```
6632
6633Claude Code는 `settings.json`에서 이 키를 무시합니다.
6634
6635<h3 id="copyfullresponse">
6636 `copyFullResponse`
6637</h3>
6638
6639응답에 코드 블록이 포함되어 있을 때 표시되는 선택기 없이 [`/copy`](/docs/ko/commands)가 매번 전체 응답을 복사하도록 합니다. 해당 선택기에서 **항상 전체 응답 복사**를 선택하면 이 키가 `true`로 설정됩니다. `/config`에 **선택기 건너뛰기**로 표시됩니다.
6640
6641* **범위**: [`전역 설정`](#scopes)
6642* **유형**: Boolean
6643 * `true`: `/copy`가 선택기를 표시하지 않고 전체 응답을 복사합니다
6644 * `false`: 응답에 코드 블록이 포함되어 있을 때 `/copy`가 한 코드 블록 또는 전체 응답을 선택하는 선택기를 표시합니다
6645* **기본값**: `false`
6646
6647```json ~/.claude.json theme={null}
6648{
6649 "copyFullResponse": true
6650}
6651```
6652
6653Claude Code는 `settings.json`에서 이 키를 무시합니다.
6654
6485<h3 id="copyonselect">6655<h3 id="copyonselect">
6486 `copyOnSelect`6656 `copyOnSelect`
6487</h3>6657</h3>
6502 6672
6503Claude Code는 `settings.json`에서 이 키를 무시합니다.6673Claude Code는 `settings.json`에서 이 키를 무시합니다.
6504 6674
6675<h3 id="defaulttoagentsview">
6676 `defaultToAgentsView`
6677</h3>
6678
6679인수 없이 `claude`를 실행할 때 새 대화 대신 [에이전트 보기](/docs/ko/agent-view)를 엽니다. 에이전트 보기가 [꺼져 있지](#disableagentview) 않은 한 `/config`에 **기본적으로 에이전트 보기 열기**로 표시됩니다.
6680
6681* **범위**: [`전역 설정`](#scopes)
6682* **유형**: Boolean
6683 * `true`: 인수 없는 `claude`가 에이전트 보기를 열며, 에이전트 보기가 [꺼져 있지](#disableagentview) 않은 경우입니다
6684 * `false`: 인수 없는 `claude`가 새 대화를 시작합니다
6685* **기본값**: `false`
6686
6687```json ~/.claude.json theme={null}
6688{
6689 "defaultToAgentsView": true
6690}
6691```
6692
6693Claude Code는 `settings.json`에서 이 키를 무시합니다.
6694
6505<h3 id="difftool">6695<h3 id="difftool">
6506 `diffTool`6696 `diffTool`
6507</h3>6697</h3>
6556 6746
6557Claude Code는 `settings.json`에서 이 키를 무시합니다.6747Claude Code는 `settings.json`에서 이 키를 무시합니다.
6558 6748
6749<h3 id="leftarrowopensagents">
6750 `leftArrowOpensAgents`
6751</h3>
6752
6753빈 프롬프트에서 `←`를 눌러 [세션을 백그라운드로 보내고 에이전트 보기를 엽니다](/docs/ko/agent-view#switch-sessions-without-leaving-the-terminal). 이 키를 `false`로 설정하여 단축키를 끕니다. 에이전트 보기를 사용할 수 있을 때 `/config`에 **← 에이전트 보기 열기**로 표시됩니다.
6754
6755* **범위**: [`전역 설정`](#scopes)
6756* **유형**: Boolean
6757 * `true`: 터미널에서 시작한 세션의 빈 프롬프트에서 `←`를 누르면 세션을 백그라운드로 보내고 에이전트 보기를 엽니다
6758 * `false`: Claude Code가 단축키를 끕니다. [에이전트 보기에서 연결한](/docs/ko/agent-view#attach-to-a-session) 세션에서 빈 프롬프트의 `←`는 여전히 분리됩니다
6759* **기본값**: `true`
6760
6761```json ~/.claude.json theme={null}
6762{
6763 "leftArrowOpensAgents": false
6764}
6765```
6766
6767Claude Code는 `settings.json`에서 이 키를 무시합니다.
6768
6559<h3 id="permissionexplainerenabled">6769<h3 id="permissionexplainerenabled">
6560 `permissionExplainerEnabled`6770 `permissionExplainerEnabled`
6561</h3>6771</h3>
6570* **유형**: Boolean6780* **유형**: Boolean
6571* **기본값**: `true`6781* **기본값**: `true`
6572 6782
6783<h3 id="prstatusfooterenabled">
6784 `prStatusFooterEnabled`
6785</h3>
6786
6787현재 브랜치의 열린 풀 요청 또는 병합 요청에 대한 배지를 프롬프트 바닥글에 표시하며, 색상이 지정된 밑줄이 [상태](/docs/ko/interactive-mode#pr-review-status)를 표시합니다. `/config`에 **PR 상태 바닥글 표시**로 표시됩니다.
6788
6789* **범위**: [`전역 설정`](#scopes)
6790* **유형**: Boolean
6791 * `true`: 바닥글이 [PR 검토 상태](/docs/ko/interactive-mode#pr-review-status)의 조건에서 배지를 표시합니다
6792 * `false`: Claude Code가 바닥글의 풀 요청 및 병합 요청 확인을 건너뛰고 해당 배지를 표시하지 않습니다. [에이전트 보기에서 연결한](/docs/ko/agent-view#attach-to-a-session) 세션은 여전히 [연결된](/docs/ko/agent-view#pull-request-status) 풀 요청에 대한 일반 링크를 표시할 수 있습니다
6793* **기본값**: `true`
6794
6795```json ~/.claude.json theme={null}
6796{
6797 "prStatusFooterEnabled": false
6798}
6799```
6800
6801Claude Code는 `settings.json`에서 이 키를 무시합니다.
6802
6573<h3 id="teammatedefaultmodel">6803<h3 id="teammatedefaultmodel">
6574 `teammateDefaultModel`6804 `teammateDefaultModel`
6575</h3>6805</h3>