708| [`modelOverrides`](#modeloverrides) | [모델 ID를 공급자의 ID(예: Bedrock ARN)에 매핑](/docs/ko/model-config#override-model-ids-per-version) | 모델 및 응답 | 모든 파일 |708| [`modelOverrides`](#modeloverrides) | [모델 ID를 공급자의 ID(예: Bedrock ARN)에 매핑](/docs/ko/model-config#override-model-ids-per-version) | 모델 및 응답 | 모든 파일 |
709| [`modelPicker`](#modelpicker) | [`/model` 선택기](/docs/ko/model-config#available-models)가 나열하는 모델을 선택하고, 자신의 순서 및 자신의 레이블로 선택 | 모델 및 응답 | 사용자 또는 관리됨 |709| [`modelPicker`](#modelpicker) | [`/model` 선택기](/docs/ko/model-config#available-models)가 나열하는 모델을 선택하고, 자신의 순서 및 자신의 레이블로 선택 | 모델 및 응답 | 사용자 또는 관리됨 |
710| [`modelPricing`](#modelpricing) | 목록 가격 대신 조직의 계약 요금으로 지출 보고 | 모델 및 응답 | 관리됨 |710| [`modelPricing`](#modelpricing) | 목록 가격 대신 조직의 계약 요금으로 지출 보고 | 모델 및 응답 | 관리됨 |
711| [`modelSettings`](#modelsettings) | 모델별로 저장된 [effort 수준](/docs/ko/model-config#adjust-effort-level)을 유지하거나 한 모델의 effort 제한 | 모델 및 응답 | 모든 파일 |711| [`modelSettings`](#modelsettings) | 모델별로 저장된 [effort 수준](/docs/ko/model-config#adjust-effort-level) 또는 [자동 압축 윈도우](/docs/ko/model-config#set-the-auto-compact-window)를 유지하거나, 한 모델의 effort 상한을 설정합니다 | 모델 및 응답 | 모든 파일 |
712| [`otelHeadersHelper`](#otelheadershelper) | 자신의 명령으로 회전하는 [OpenTelemetry](/docs/ko/monitoring-usage#dynamic-headers) 헤더 생성 | 인증 및 공급자 | 모든 파일 |712| [`otelHeadersHelper`](#otelheadershelper) | 자신의 명령으로 회전하는 [OpenTelemetry](/docs/ko/monitoring-usage#dynamic-headers) 헤더 생성 | 인증 및 공급자 | 모든 파일 |
713| [`outputStyle`](#outputstyle) | [출력 스타일](/docs/ko/output-styles)로 Claude의 역할, 톤, 출력 형식 변경 | 모델 및 응답 | 모든 파일 |713| [`outputStyle`](#outputstyle) | [출력 스타일](/docs/ko/output-styles)로 Claude의 역할, 톤, 출력 형식 변경 | 모델 및 응답 | 모든 파일 |
714| [`parentSettingsBehavior`](#parentsettingsbehavior) | [관리형 설정](/docs/ko/managed-settings)을 배포할 때 [SDK 또는 IDE 호스트](/docs/ko/managed-settings#let-an-embedding-host-add-policy)가 전달하는 제한 사항 적용 또는 삭제 | 엔터프라이즈 및 관리형 설정 | 관리됨 |714| [`parentSettingsBehavior`](#parentsettingsbehavior) | [관리형 설정](/docs/ko/managed-settings)을 배포할 때 [SDK 또는 IDE 호스트](/docs/ko/managed-settings#let-an-embedding-host-add-policy)가 전달하는 제한 사항 적용 또는 삭제 | 엔터프라이즈 및 관리형 설정 | 관리됨 |
839 모델 및 응답839 모델 및 응답
840</h2>840</h2>
841 841
842Claude Code가 사용할 모델과 응답 방식을 선택합니다. 이러한 설정이 `/model` 명령 및 환경 변수와 어떻게 상호작용하는지는 [모델 구성](/docs/ko/model-config)을 참조하십시오.842Claude Code가 사용하는 모델과 응답 방식을 선택합니다. 이러한 설정이 `/model` 명령 및 환경 변수와 어떻게 상호 작용하는지는 [모델 구성](/docs/ko/model-config)을 참조하세요.
843 843
844<h3 id="advisormodel">844<h3 id="advisormodel">
845 `advisorModel`845 `advisorModel`
846</h3>846</h3>
847 847
848Claude가 서버 측 [advisor 도구](/docs/ko/advisor)를 호출할 때 응답하는 모델을 선택합니다. advisor를 끄려면 설정을 해제합니다. advisor는 최소한 주 모델만큼 능력이 있어야 합니다. 허용되는 쌍과 허용되지 않는 쌍을 선택할 때 발생하는 상황은 [advisor 모델 선택](/docs/ko/advisor#choose-an-advisor-model)을 참조하십시오.848Claude가 서버 측 [advisor 도구](/docs/ko/advisor)를 호출할 때 응답할 모델을 선택합니다. advisor를 끄려면 이 키를 설정 해제합니다. advisor는 최소한 메인 모델과 동등한 성능을 갖춰야 합니다. 허용되는 조합과 허용되지 않는 모델을 선택했을 때 어떻게 되는지는 [advisor 모델 선택](/docs/ko/advisor#choose-an-advisor-model)을 참조하세요.
849 849
850일반적으로 이 키를 직접 편집하지 않습니다. `/advisor`를 실행하여 현재 선택, advisor가 될 수 있는 모델, **advisor 없음**을 표시하는 선택기를 엽니다. Claude Code는 선택 사항을 `~/.claude/settings.json`의 이 키에 저장합니다. [Remote Control](/docs/ko/remote-control) 클라이언트에서 선택하거나 원격 워커에 연결된 세션에서 선택하면, 선택 사항이 해당 세션에만 적용되고 이 키는 변경되지 않습니다.850일반적으로 이 키를 직접 편집하지 않습니다. `/advisor`를 실행하면 현재 선택, advisor로 사용할 수 있는 모델, **No advisor**를 보여 주는 선택기가 열립니다. Claude Code는 선택한 항목을 `~/.claude/settings.json`의 이 키에 저장합니다. [Remote Control](/docs/ko/remote-control) 클라이언트에서 선택하거나 원격 워커에 연결된 세션에서 선택하면 해당 선택은 그 세션에만 적용되며 이 키는 변경되지 않습니다.
851 851
852계정에 [usage-credits 동의](/docs/ko/advisor#fable-advisor-and-usage-credits)가 필요한 경우, `/model fable`을 실행하여 먼저 동의합니다. 동의하기 전까지는 `/advisor`에서 Fable을 선택해도 아무것도 저장되지 않으며 Claude Code는 먼저 `/model fable`을 실행하도록 지시합니다.852계정에 [사용량 크레딧 동의](/docs/ko/advisor#fable-advisor-and-usage-credits)가 필요한 경우 먼저 `/model fable`을 실행하여 동의해야 합니다. 동의하기 전까지는 `/advisor`에서 Fable을 선택해도 아무것도 저장되지 않으며, Claude Code가 먼저 `/model fable`을 실행하라고 안내합니다.
853 853
854* **범위**: [`Any file`](#scopes)854* **범위**: [`Any file`](#scopes)
855* **유형**: 문자열, `"fable"`, `"opus"`, 또는 `"sonnet"` 중 하나의 별칭(Claude Code의 해당 모델 제품군의 현재 기본 버전으로 확인됨) 또는 `"claude-opus-5-5"`와 같은 전체 모델 ID855* **유형**: 문자열. 해당 모델 계열의 Claude Code 현재 기본 버전으로 해석되는 별칭 `"fable"`, `"opus"`, `"sonnet"` 중 하나 또는 `"claude-opus-5-5"`와 같은 전체 모델 ID
856* **기본값**: 설정 해제되어 advisor가 꺼짐856* **기본값**: 설정되지 않음. 따라서 advisor가 꺼져 있습니다
857* **세션별 재정의**: `--advisor`는 한 세션에 대해 이 키보다 우선하며, [`CLAUDE_CODE_DISABLE_ADVISOR_TOOL`](/docs/ko/env-vars)은 advisor를 끄고 이 키는 다시 켤 수 없습니다.857* **세션별 재정의**: 한 세션에 대해서는 `--advisor`가 이 키보다 우선합니다. [`CLAUDE_CODE_DISABLE_ADVISOR_TOOL`](/docs/ko/env-vars)은 advisor를 끄며, 이 키로 다시 켤 수 없습니다
858 858
859```json settings.json theme={null}859```json settings.json theme={null}
860{860{
862}862}
863```863```
864 864
865이 키는 Amazon Bedrock 및 AWS의 Claude Platform과 같이 advisor가 [사용 불가능](/docs/ko/advisor#requirements)한 공급자에게는 영향을 주지 않습니다. `"fable"`은 [Fable 액세스](/docs/ko/advisor#choose-an-advisor-model)가 필요합니다.865이 키는 Amazon Bedrock 및 Claude Platform on AWS처럼 advisor를 [사용할 수 없는](/docs/ko/advisor#requirements) 공급자에서는 효과가 없습니다. `"fable"`에는 [Fable 액세스](/docs/ko/advisor#choose-an-advisor-model)가 필요합니다.
866 866
867<h3 id="alwaysthinkingenabled">867<h3 id="alwaysthinkingenabled">
868 `alwaysThinkingEnabled`868 `alwaysThinkingEnabled`
869</h3>869</h3>
870 870
871이를 `false`로 설정하여 모든 세션에 대해 [확장 사고](/docs/ko/model-config#extended-thinking)를 끕니다. 사고는 기본적으로 켜져 있으므로 `true`는 아무것도 변경하지 않습니다. 대부분의 사람들은 파일을 편집하는 대신 `/config`를 통해 이를 설정합니다.871이 값을 `false`로 설정하면 모든 세션에서 [확장 사고](/docs/ko/model-config#extended-thinking)를 끕니다. 사고는 기본적으로 켜져 있으므로 `true`는 아무것도 바꾸지 않습니다. 대부분 파일을 편집하는 대신 `/config`를 통해 설정합니다.
872 872
873Opus 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`를 보냅니다.873Opus 5.5, Sonnet 5.5, Fable 모델처럼 항상 사고하는 모델에서는 `false`가 효과가 없습니다. [서드파티 공급자](/docs/ko/third-party-integrations)에서는 Claude Code가 사고를 끄는 대신 `thinking` 매개변수를 생략하므로 적응형 추론 모델은 여전히 사고할 수 있습니다. Anthropic API에서 사고를 끈 상태에서는, Opus 5처럼 [해당 조합을 허용하지 않는](/docs/ko/errors#effort-isnt-available-with-thinking-turned-off) 것으로 알려진 모델에 Claude Code가 더 높은 수준 대신 effort `high`를 보냅니다.
874 874
875* **범위**: [`Any file`](#scopes)875* **범위**: [`Any file`](#scopes)
876* **유형**: 부울876* **유형**: Boolean
877 * `true`: 영향 없음; 사고는 이미 켜짐877 * `true`: 효과 없음. 사고가 이미 켜져 있습니다
878 * `false`: Claude Code는 모든 세션에 대해 확장 사고를 끕니다.878 * `false`: Claude Code가 모든 세션에서 확장 사고를 끕니다
879* **기본값**: 설정 해제되어 사고는 이를 지원하는 모델에 대해 켜짐879* **기본값**: 설정되지 않음. 따라서 지원하는 모델에서는 사고가 켜져 있습니다
880* **세션별 재정의**: [`MAX_THINKING_TOKENS`](/docs/ko/env-vars)는 한 세션에 대해 이 키보다 우선합니다: `0`은 `false`와 동일한 모델 및 공급자 제한 하에서 사고를 끄고, 양수 값은 이 키가 `false`일 때도 사고를 켭니다. 적응형 추론 모델에서는 숫자 자체가 무시됩니다.880* **세션별 재정의**: 한 세션에 대해서는 [`MAX_THINKING_TOKENS`](/docs/ko/env-vars)가 이 키보다 우선합니다. `0`은 `false`와 동일한 모델 및 공급자 제한 아래에서 사고를 끄고, 양수 값은 이 키가 `false`여도 사고를 켭니다. 적응형 추론 모델에서는 숫자 자체가 무시됩니다
881 881
882```json settings.json theme={null}882```json settings.json theme={null}
883{883{
889 `availableModels`889 `availableModels`
890</h3>890</h3>
891 891
892사람들이 주 세션, [subagents](/docs/ko/sub-agents), [skills](/docs/ko/skills), [advisor](/docs/ko/advisor)에 대해 선택할 수 있는 모델을 제한합니다. 관리되는 목록은 `/model`, `--model`, 개발자 자신의 파일의 `model` 키를 제한합니다. 목록 외의 모델은 선택할 수 없습니다. 기본 접두사 일치를 사용하면 Default 옵션 자체는 건드리지 않습니다. 이를 위해 [`enforceAvailableModels`](#enforceavailablemodels)와 쌍을 이룹니다.892메인 세션, [서브에이전트](/docs/ko/sub-agents), [스킬](/docs/ko/skills), [advisor](/docs/ko/advisor)에 사용자가 선택할 수 있는 모델을 제한합니다. 관리형 목록은 `/model`, `--model`, 개발자 자신의 파일에 있는 `model` 키를 제한하며, 목록에 없는 모델은 선택할 수 없습니다. 기본 접두사 매칭에서는 이 키만으로 Default 옵션에 영향을 주지 않으므로, 그러려면 [`enforceAvailableModels`](#enforceavailablemodels)와 함께 사용하세요.
893 893
894* **범위**: [`Any file`](#scopes). 조직에 대해 이를 적용하려면 관리되는 설정에 배포합니다.894* **범위**: [`Any file`](#scopes). 조직 전체에 적용하려면 관리형 설정에 배포합니다.
895* **유형**: 모델 별칭 또는 ID의 배열895* **유형**: 모델 별칭 또는 ID의 배열
896* **기본값**: 설정 해제되어 모든 모델을 사용할 수 있음896* **기본값**: 설정되지 않음. 따라서 모든 모델을 사용할 수 있습니다
897 897
898이 예제는 사람들이 Sonnet 및 Haiku 모델만 선택하도록 허용합니다:898이 예시는 Sonnet 및 Haiku 모델만 선택할 수 있도록 합니다:
899 899
900```json settings.json theme={null}900```json settings.json theme={null}
901{901{
903}903}
904```904```
905 905
906`"claude-opus-5"`와 같은 모델 ID 항목은 Opus 5.5와 같이 이를 확장하는 이후 버전도 허용합니다. 이러한 버전 중 하나를 차단하려면 [`deniedModels`](#deniedmodels)을 사용합니다. 각 모델 ID 항목이 이름을 지정하는 버전만 허용하도록 하려면 [`availableModelsMatch`](#availablemodelsmatch)를 사용합니다. [모델 선택 제한](/docs/ko/model-config#restrict-model-selection)을 참조하십시오.906`"claude-opus-5"`와 같은 모델 ID 항목은 Opus 5.5처럼 이를 확장하는 이후 버전도 허용합니다. 그러한 버전 중 하나를 차단하려면 [`deniedModels`](#deniedmodels)를 사용하세요. 각 모델 ID 항목이 명시한 버전만 허용하도록 하려면 [`availableModelsMatch`](#availablemodelsmatch)를 사용하세요. [모델 선택 제한](/docs/ko/model-config#restrict-model-selection)을 참조하세요.
907 907
908<h3 id="availablemodelsmatch">908<h3 id="availablemodelsmatch">
909 `availableModelsMatch`909 `availableModelsMatch`
910</h3>910</h3>
911 911
912[`availableModels`](#availablemodels) 항목이 모델 ID와 일치하는 방식을 선택합니다. 기본적으로 모델 ID 항목은 이를 확장하는 이후 버전도 허용하므로 `"claude-opus-5"`는 Opus 5.5를 허용합니다. `"exact"`를 사용하면 각 모델 ID 항목은 이름을 지정하는 버전만 허용하므로 해당 모델의 최신 버전은 이를 나열할 때까지 차단된 상태로 유지됩니다. Claude Code v2.1.283 이상이 필요합니다.912[`availableModels`](#availablemodels) 항목이 모델 ID와 일치하는 방식을 선택합니다. 기본적으로 모델 ID 항목은 이를 확장하는 이후 버전도 허용하므로 `"claude-opus-5"`는 Opus 5.5를 허용합니다. `"exact"`를 사용하면 각 모델 ID 항목은 명시한 버전만 허용하므로, 해당 모델의 새 버전은 목록에 추가할 때까지 차단된 상태로 유지됩니다. Claude Code v2.1.283 이상이 필요합니다.
913 913
914* **범위**: [`Managed`](#scopes). Claude Code는 사용자, 프로젝트, 로컬 설정 및 `--settings`에서 이 키를 무시하고 경고를 표시합니다.914* **범위**: [`Managed`](#scopes). Claude Code는 사용자, 프로젝트, 로컬 설정과 `--settings`에 있는 이 키를 경고와 함께 무시합니다
915* **유형**: 문자열, 다음 중 하나:915* **유형**: 문자열. 다음 중 하나:
916 * `"prefix"`: 모델 ID 항목은 해당 버전 및 다른 세그먼트로 확장하는 모든 모델 ID를 허용합니다.916 * `"prefix"`: 모델 ID 항목은 해당 버전과, 다른 세그먼트로 이를 확장하는 모든 모델 ID를 허용합니다
917 * `"exact"`: 모델 ID 항목은 이름을 지정하는 버전만 허용하며, 해당 버전의 날짜 ID를 포함하므로 `"claude-opus-5"`는 Opus 5를 허용하지만 `claude-opus-5-5`는 허용하지 않습니다. `"opus"`와 같은 제품군 별칭은 여전히 전체 제품군을 허용하며, `best`, `opusplan`, `default` 항목은 무시됩니다.917 * `"exact"`: 모델 ID 항목은 해당 버전의 날짜가 포함된 ID를 포함하여 명시한 버전만 허용하므로, `"claude-opus-5"`는 Opus 5를 허용하지만 `claude-opus-5-5`는 허용하지 않습니다. `"opus"`와 같은 계열 별칭은 여전히 계열 전체를 허용하며, `best`, `opusplan`, `default` 항목은 무시됩니다
918* **기본값**: `"prefix"`918* **기본값**: `"prefix"`
919 919
920이 예제는 Opus 5 및 Sonnet 5와 이들의 최신 릴리스를 허용하지 않습니다:920이 예시는 Opus 5와 Sonnet 5를 허용하고 둘 다 이후 릴리스는 허용하지 않습니다:
921 921
922```json managed-settings.json theme={null}922```json managed-settings.json theme={null}
923{923{
926}926}
927```927```
928 928
929`"exact"`를 사용하면 목록이 최소한 하나의 모델 또는 제품군을 나열할 때마다 Default 옵션도 나열된 모델로 제한됩니다. [특정 모델 또는 버전 차단](/docs/ko/model-config#block-specific-models-or-versions)을 참조하십시오.929`"exact"`를 사용하면 목록에 모델이나 계열이 하나 이상 명시되어 있을 때마다 Default 옵션도 목록의 모델로 제한됩니다. [특정 모델 또는 버전 차단](/docs/ko/model-config#block-specific-models-or-versions)을 참조하세요.
930 930
931<h3 id="deniedmodels">931<h3 id="deniedmodels">
932 `deniedModels`932 `deniedModels`
933</h3>933</h3>
934 934
935특정 모델을 차단하며, [`availableModels`](#availablemodels) 허용 목록이 있거나 없을 수 있으며 해당 목록이 이들을 허용하더라도 차단합니다. Claude Code는 차단된 모델을 `/model` 선택기에서 숨기며, `availableModels`이 적용되는 곳 어디서나 모델을 선택할 수 없습니다. Default 옵션의 세션은 [특정 모델 또는 버전 차단](/docs/ko/model-config#block-specific-models-or-versions)에서 설명하는 대로 차단된 모델도 실행하지 않습니다. Claude Code v2.1.283 이상이 필요합니다.935[`availableModels`](#availablemodels) 허용 목록의 유무와 관계없이, 그리고 해당 목록이 허용하더라도 특정 모델을 차단합니다. Claude Code는 차단된 모델을 `/model` 선택기에서 숨기며, `availableModels`가 적용되는 어디에서도 해당 모델을 선택할 수 없습니다. [특정 모델 또는 버전 차단](/docs/ko/model-config#block-specific-models-or-versions)에서 설명하듯이 Default 옵션을 사용하는 세션도 차단된 모델을 실행하지 않습니다. Claude Code v2.1.283 이상이 필요합니다.
936 936
937* **범위**: [`Managed`](#scopes). Claude Code는 사용자, 프로젝트, 로컬 설정 및 `--settings`에서 이 키를 무시하고 경고를 표시합니다.937* **범위**: [`Managed`](#scopes). Claude Code는 사용자, 프로젝트, 로컬 설정과 `--settings`에 있는 이 키를 경고와 함께 무시합니다
938* **유형**: 모델 별칭 또는 ID의 배열938* **유형**: 모델 별칭 또는 ID의 배열
939 * `"opus"`와 같은 제품군 별칭은 해당 제품군의 모든 모델을 차단합니다.939 * `"opus"`와 같은 계열 별칭은 해당 계열의 모든 모델을 차단합니다
940 * `"claude-opus-5-5"`와 같은 모델 ID는 날짜 및 공급자별 ID를 포함한 모든 철자로 해당 버전을 차단합니다.940 * `"claude-opus-5-5"`와 같은 모델 ID는 날짜가 포함된 ID와 공급자별 ID를 포함하여 모든 표기의 해당 버전을 차단합니다
941 * `"claude-opus-5"`와 같이 부 버전이 없는 모델 ID는 Opus 5.5와 같은 이후 부 버전도 차단합니다. Opus 5만 차단하려면 `"claude-opus-5-0"`을 작성합니다.941 * `"claude-opus-5"`처럼 마이너 버전이 없는 모델 ID는 Opus 5.5와 같은 이후 마이너 버전도 차단합니다. Opus 5만 차단하려면 `"claude-opus-5-0"`을 작성합니다
942 * `best`, `opusplan`, `default` 항목은 무시됩니다.942 * `best`, `opusplan`, `default` 항목은 무시됩니다
943* **기본값**: 설정 해제되어 모델이 차단되지 않음943* **기본값**: 설정되지 않음. 따라서 차단되는 모델이 없습니다
944 944
945이 예제는 Opus 및 Sonnet 모델을 허용하고 Opus 5.5를 차단합니다:945이 예시는 Opus 및 Sonnet 모델을 허용하고 Opus 5.5를 차단합니다:
946 946
947```json managed-settings.json theme={null}947```json managed-settings.json theme={null}
948{948{
951}951}
952```952```
953 953
954[특정 모델 또는 버전 차단](/docs/ko/model-config#block-specific-models-or-versions)을 참조하십시오.954[특정 모델 또는 버전 차단](/docs/ko/model-config#block-specific-models-or-versions)을 참조하세요.
955 955
956<h3 id="effortlevel">956<h3 id="effortlevel">
957 `effortLevel`957 `effortLevel`
958</h3>958</h3>
959 959
960저장하지 않은 모델에 대한 기본 [노력 수준](/docs/ko/model-config#adjust-effort-level)을 설정합니다. 낮은 수준은 간단한 작업에서 더 빠르고 저렴하며, 높은 수준은 복잡한 문제에서 더 깊이 있게 추론합니다.960수준을 저장하지 않은 모델에 대한 기본 [effort 수준](/docs/ko/model-config#adjust-effort-level)을 설정합니다. 낮은 수준은 간단한 작업에서 더 빠르고 저렴하며, 높은 수준은 복잡한 문제에서 더 깊이 추론합니다.
961 961
962머신의 대화형 세션에서 `/effort low`, `medium`, `high`, 또는 `xhigh`를 실행하면 Claude Code는 이 키를 작성하는 대신 [`modelSettings`](#modelsettings) 아래의 활성 모델에 대한 수준을 저장합니다. v2.1.251 이전에는 `/effort`가 이 키를 작성했습니다.962로컬 머신의 대화형 세션에서 `/effort low`, `medium`, `high`, `xhigh`를 실행하면 Claude Code는 이 키에 쓰는 대신 활성 모델에 대한 수준을 [`modelSettings`](#modelsettings) 아래에 저장합니다. v2.1.251 이전에는 `/effort`가 이 키에 썼습니다.
963 963
964동일한 설정 파일 내에서 Claude Code는 이 키보다 모델의 저장된 수준을 사용합니다. [`modelSettings`](#modelsettings)는 파일 간 우선순위를 나타냅니다.964같은 설정 파일 내에서 Claude Code는 이 키보다 모델의 저장된 수준을 사용합니다. 파일 간 우선순위는 [`modelSettings`](#modelsettings)에 설명되어 있습니다.
965 965
966원격 워커에 연결된 세션, `-p` 실행, Agent SDK에서 `/effort`는 해당 세션에만 적용됩니다. [노력 수준 조정](/docs/ko/model-config#adjust-effort-level)은 해당 세션에만 적용되는 대화형 선택을 나열합니다. `/effort`가 인쇄하는 메시지는 어느 것이 발생했는지 나타냅니다.966원격 워커에 연결된 세션, `-p` 실행, Agent SDK에서는 `/effort`가 해당 세션에만 적용됩니다. 해당 세션에만 적용되는 대화형 선택 항목은 [effort 수준 조정](/docs/ko/model-config#adjust-effort-level)에 나열되어 있습니다. `/effort`가 출력하는 메시지에서 어떤 방식으로 적용되었는지 알려 줍니다.
967 967
968* **범위**: [`Any file`](#scopes)968* **범위**: [`Any file`](#scopes)
969* **유형**: 문자열, 다음 중 하나:969* **유형**: 문자열. 다음 중 하나:
970 * `"low"`: 최소 추론, 짧고 범위가 지정되며 지연 시간에 민감하지만 지능에 민감하지 않은 작업용970 * `"low"`: 가장 적은 추론. 지능에 민감하지 않은 짧고 범위가 정해진 지연 시간 민감 작업용
971 * `"medium"`: 일부 지능을 거래할 수 있는 비용에 민감한 작업에 대한 토큰 사용 감소971 * `"medium"`: 어느 정도의 지능을 절충할 수 있는 비용 민감 작업에서 토큰 사용량을 줄입니다
972 * `"high"`: 토큰 사용과 지능의 균형972 * `"high"`: 토큰 사용량과 지능의 균형을 맞춥니다
973 * `"xhigh"`: 더 높은 토큰 지출로 더 깊은 추론973 * `"xhigh"`: 더 많은 토큰을 사용하여 더 깊이 추론합니다
974* **기본값**: 설정 해제됨974* **기본값**: 설정되지 않음
975* **세션별 재정의**: `--effort`는 한 세션에 대해 이 키보다 우선하며, [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ko/env-vars)은 둘 다보다 우선합니다.975* **세션별 재정의**: 한 세션에 대해서는 `--effort`가 이 키보다 우선하며, [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ko/env-vars)은 둘 다보다 우선합니다
976 976
977```json settings.json theme={null}977```json settings.json theme={null}
978{978{
980}980}
981```981```
982 982
983사용자 설정 파일 `~/.claude/settings.json`에서 이 키는 `/effort`가 모델별로 수준을 저장하기 전에 작성한 이전 형식이며, Opus 5, Fable 5.1, 이전 모델에서 이전에 적용된 곳에 계속 적용됩니다. Opus 5.5 및 이후에 릴리스된 모델은 이를 무시하고 [`modelSettings`](#modelsettings) 아래에서 수준을 저장할 때까지 자신의 기본값으로 시작합니다. 프로젝트, 로컬, 관리되는 설정 및 `--settings`에서 이 키는 모든 모델에 적용됩니다.983사용자 설정 파일 `~/.claude/settings.json`에서 이 키는 `/effort`가 모델별로 수준을 저장하기 전에 쓰던 이전 형식이며, Opus 5, Fable 5.1 및 이전 모델처럼 이전에 적용되던 곳에 계속 적용됩니다. Opus 5.5 및 그 이후에 출시된 모델은 이 키를 무시하고 수준을 저장하기 전까지 자체 기본값으로 시작하며, `/effort`는 해당 수준을 [`modelSettings`](#modelsettings) 아래에 씁니다. 프로젝트, 로컬, 관리형 설정과 `--settings`에서는 이 키가 모든 모델에 적용됩니다.
984 984
985<h3 id="enforceavailablemodels">985<h3 id="enforceavailablemodels">
986 `enforceAvailableModels`986 `enforceAvailableModels`
987</h3>987</h3>
988 988
989\[`/model` 선택기는 **Default** 옵션을 가지며, [`default` 모델 설정](/docs/ko/model-config#default-model-setting)은 이것이 확인되는 모델을 설명합니다. [`availableModels`](#availablemodels) 허용 목록은 이름을 지정할 수 있는 모델을 제한하지만, 기본 [접두사 일치](#availablemodelsmatch)를 사용하면 계정 유형의 기본값을 다시 매핑하지 않으므로 **Default**는 여전히 목록 외의 모델로 확인될 수 있습니다. 이 키는 그 간격을 닫습니다. Claude Code v2.1.175 이상이 필요합니다.989`/model` 선택기에는 **Default** 옵션이 있으며, 이 옵션이 어떤 모델로 해석되는지는 [`default` 모델 설정](/docs/ko/model-config#default-model-setting)에 설명되어 있습니다. [`availableModels`](#availablemodels) 허용 목록은 지정할 수 있는 모델을 제한하지만, 기본 [접두사 매칭](#availablemodelsmatch)에서는 계정 유형의 기본값을 다시 매핑하지 않으므로 **Default**가 여전히 목록 밖의 모델로 해석될 수 있습니다. 이 키는 그 공백을 메웁니다. Claude Code v2.1.175 이상이 필요합니다.
990 990
991조직이 관리되는 설정을 배포할 때 Claude Code는 관리되는 소스에서만 이 키를 읽고 다른 파일에서는 무시합니다.991조직에서 관리형 설정을 배포하는 경우 Claude Code는 관리형 소스에서만 이 키를 읽고 다른 파일의 이 키는 무시합니다.
992 992
993* **범위**: [`Any file`](#scopes)993* **범위**: [`Any file`](#scopes)
994* **유형**: 부울994* **유형**: Boolean
995 * `true`: **Default**가 `availableModels` 외의 모델로 확인될 때 Claude Code는 이를 목록의 첫 번째 사용 가능한 모델로 확인합니다.995 * `true`: **Default**가 `availableModels` 밖의 모델로 해석될 경우 Claude Code는 목록에서 처음으로 사용 가능한 모델로 해석합니다
996 * `false`: 이 키는 **Default**가 확인되는 방식을 변경하지 않습니다.996 * `false`: 이 키는 **Default**가 해석되는 방식을 바꾸지 않습니다
997* **기본값**: `false`997* **기본값**: `false`
998 998
999이 예제는 명명된 선택을 Sonnet 및 Haiku 모델로 제한하고 **Default**를 사용 가능한 첫 번째로 확인합니다:999이 예시는 지정 선택을 Sonnet 및 Haiku 모델로 제한하고 **Default**가 그중 처음으로 사용 가능한 모델로 해석되도록 합니다:
1000 1000
1001```json settings.json theme={null}1001```json settings.json theme={null}
1002{1002{
1005}1005}
1006```1006```
1007 1007
1008`availableModels`이 설정 해제되거나 비어 있을 때 이 키는 영향을 주지 않습니다. [Default 모델에 대한 허용 목록 적용](/docs/ko/model-config#enforce-the-allowlist-for-the-default-model)을 참조하십시오. Claude Code v2.1.175 이상이 필요합니다.1008`availableModels`가 설정되지 않았거나 비어 있으면 이 키는 효과가 없습니다. [Default 모델에 허용 목록 적용](/docs/ko/model-config#enforce-the-allowlist-for-the-default-model)을 참조하세요. Claude Code v2.1.175 이상이 필요합니다.
1009 1009
1010<h3 id="fallbackmodel">1010<h3 id="fallbackmodel">
1011 `fallbackModel`1011 `fallbackModel`
1012</h3>1012</h3>
1013 1013
1014주 모델이 과부하되거나 사용 불가능할 때 Claude Code가 순서대로 시도할 백업 모델을 이름 지정합니다. Claude Code는 턴의 나머지 부분에 대해 체인의 다음 사용 가능한 모델로 전환하고 알림을 표시합니다. 체인이 없으면 Claude Code는 동일한 모델을 재시도한 다음 서버의 오류를 표시하며, 사용자가 재시도하거나 모델을 전환합니다.1014기본 모델이 과부하 상태이거나 사용할 수 없을 때 Claude Code가 순서대로 시도할 백업 모델을 지정합니다. Claude Code는 턴의 나머지 부분 동안 체인에서 다음으로 사용 가능한 모델로 전환하고 알림을 표시합니다. 체인이 없으면 Claude Code는 같은 모델을 재시도한 뒤 서버의 오류를 표시하며, 사용자가 직접 재시도하거나 모델을 전환해야 합니다.
1015 1015
1016전환은 폴백 모델에서 하나의 턴으로 콜드 [프롬프트 캐시](/docs/ko/prompt-caching#switching-models)를 의미합니다. 다음 메시지는 주 모델을 먼저 다시 시도합니다.1016전환하면 폴백 모델에서 [프롬프트 캐시](/docs/ko/prompt-caching#switching-models)가 비어 있는 상태로 한 턴이 진행됩니다. 다음 메시지에서는 다시 기본 모델을 먼저 시도합니다.
1017 1017
1018* **범위**: [`Any file`](#scopes)1018* **범위**: [`Any file`](#scopes)
1019* **유형**: 모델 별칭 또는 ID의 배열; `"default"`는 기본 모델로 확장됩니다.1019* **유형**: 모델 별칭 또는 ID의 배열. `"default"`는 기본 모델로 확장됩니다
1020* **기본값**: 설정 해제되어 실패한 요청이 다른 모델에서 재시도되지 않음1020* **기본값**: 설정되지 않음. 따라서 실패한 요청을 다른 모델로 재시도하지 않습니다
1021* **세션별 재정의**: `--fallback-model`은 한 세션에 대해 이 키보다 우선합니다.1021* **세션별 재정의**: 한 세션에 대해서는 `--fallback-model`이 이 키보다 우선합니다
1022 1022
1023이 예제는 주 모델이 실패할 때 먼저 Sonnet 5를 시도한 다음 Haiku 4.5를 시도합니다:1023이 예시는 기본 모델이 실패하면 Sonnet 5를 먼저 시도한 다음 Haiku 4.5를 시도합니다:
1024 1024
1025```json settings.json theme={null}1025```json settings.json theme={null}
1026{1026{
1028}1028}
1029```1029```
1030 1030
1031대부분의 배열 설정과 달리 이 키는 설정 파일 간에 병합되지 않습니다: 가장 높은 우선순위 파일이 정의하는 것이 전체 체인을 제공합니다. 프로젝트 파일이 `["claude-sonnet-5"]`를 설정하고 사용자 파일이 `["claude-haiku-4-5"]`를 설정하면 체인은 `["claude-sonnet-5"]`만입니다. Claude Code는 목록에서 최대 3개의 서로 다른 허용 모델을 유지하고 나머지는 무시합니다. [폴백 모델 체인](/docs/ko/model-config#fallback-model-chains)을 참조하십시오.1031대부분의 배열 설정과 달리 이 키는 설정 파일 간에 병합되지 않습니다. 이 키를 정의한 우선순위가 가장 높은 파일이 체인 전체를 제공합니다. 프로젝트 파일에서 `["claude-sonnet-5"]`를 설정하고 사용자 파일에서 `["claude-haiku-4-5"]`를 설정하면 체인은 `["claude-sonnet-5"]`뿐입니다. Claude Code는 목록에서 서로 다른 허용 모델을 최대 세 개까지 유지하고 나머지는 무시합니다. [폴백 모델 체인](/docs/ko/model-config#fallback-model-chains)을 참조하세요.
1032 1032
1033<h3 id="fastmode">1033<h3 id="fastmode">
1034 `fastMode`1034 `fastMode`
1035</h3>1035</h3>
1036 1036
1037사용 가능한 세션에 대해 [빠른 모드](/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)을 참조하십시오.1037사용 가능한 세션에서 [빠른 모드](/docs/ko/fast-mode)를 켭니다. 토큰당 비용이 더 높더라도 속도가 필요한 빠른 반복이나 실시간 디버깅 같은 대화형 작업에 적합합니다. 일반적으로 이 키를 직접 편집하지 않습니다. `/fast`를 실행하면 `~/.claude/settings.json`에 `fastMode: true`가 기록되고, 다시 실행하여 빠른 모드를 끄면 키가 제거됩니다. 빠른 모드는 Opus 5.5, Opus 5, Opus 4.8에서만 실행됩니다. 다른 모델에서 켜면 Opus로 전환되며, 지원되지 않는 모델로 전환하면 꺼집니다. [빠른 모드가 켜진 상태에서 모델 전환](/docs/ko/fast-mode#switch-models-while-fast-mode-is-on)을 참조하세요.
1038 1038
1039* **범위**: [`Any file`](#scopes)1039* **범위**: [`Any file`](#scopes)
1040* **유형**: 부울1040* **유형**: Boolean
1041 * `true`: Claude Code는 사용 가능한 세션에 대해 빠른 모드를 켭니다.1041 * `true`: Claude Code가 사용 가능한 세션에서 빠른 모드를 켭니다
1042 * `false`: 빠른 모드는 꺼진 상태로 유지됩니다.1042 * `false`: 빠른 모드가 꺼진 상태로 유지됩니다
1043* **기본값**: 설정 해제되어 빠른 모드는 꺼짐1043* **기본값**: 설정되지 않음. 따라서 빠른 모드가 꺼져 있습니다
1044* **세션별 재정의**: [`CLAUDE_CODE_DISABLE_FAST_MODE`](/docs/ko/env-vars)는 한 세션에 대해 빠른 모드를 끄고 이 키는 다시 켤 수 없습니다.1044* **세션별 재정의**: [`CLAUDE_CODE_DISABLE_FAST_MODE`](/docs/ko/env-vars)는 한 세션에 대해 빠른 모드를 끄며, 이 키로 다시 켤 수 없습니다
1045 1045
1046```json settings.json theme={null}1046```json settings.json theme={null}
1047{1047{
1053 `fastModePerSessionOptIn`1053 `fastModePerSessionOptIn`
1054</h3>1054</h3>
1055 1055
1056일반적으로 `/fast`를 실행하면 [`fastMode`](#fastmode)를 사용자 설정에 저장하므로 빠른 모드는 이후의 모든 세션 시작 시 켜집니다. 이를 중지하려면 이 키를 `true`로 설정합니다: 저장된 `fastMode: true`는 더 이상 세션 시작 시 빠른 모드를 켜지 않으며, 각 사용자는 빠른 모드를 원하는 각 세션에서 `/fast`를 실행해야 합니다. Claude Code는 파일에 `fastMode` 키를 남겨두므로 이 키를 끄면 이전 동작이 복원됩니다.1056일반적으로 `/fast`를 실행하면 [`fastMode`](#fastmode)가 사용자 설정에 저장되므로 이후 모든 세션이 시작될 때 빠른 모드가 켜집니다. 이를 막으려면 이 키를 `true`로 설정합니다. 그러면 저장된 `fastMode: true`가 더 이상 세션 시작 시 빠른 모드를 켜지 않으며, 각 사용자는 빠른 모드를 원하는 세션마다 `/fast`를 실행해야 합니다. Claude Code는 파일의 `fastMode` 키를 그대로 두므로 이 키를 끄면 이전 동작이 복원됩니다.
1057 1057
1058Team 또는 Enterprise 계획의 소유자는 [서버 관리 설정](/docs/ko/server-managed-settings)을 통해 조직 전체에 배포할 수 있습니다. 관리되는 설정이 키를 설정할 때 `/fast on`은 대화형 터미널 세션 외부에서 거부되고 조직이 빠른 모드를 비활성화했다고 보고합니다. 이는 [비대화형 모드](/docs/ko/headless), [VS Code 확장](/docs/ko/vs-code), [클라우드 세션](/docs/ko/claude-code-on-the-web)을 포함합니다.1058Team 또는 Enterprise 플랜의 Owner는 [서버 관리형 설정](/docs/ko/server-managed-settings)을 통해 조직 전체에 배포할 수 있습니다. 관리형 설정에서 이 키를 설정하면 대화형 터미널 세션 외부에서는 `/fast on`이 거부되고 조직에서 빠른 모드를 비활성화했다고 알립니다. 여기에는 [비대화형 모드](/docs/ko/headless), [VS Code 확장](/docs/ko/vs-code), [클라우드 세션](/docs/ko/claude-code-on-the-web)이 포함됩니다.
1059 1059
1060* **범위**: [`Any file`](#scopes)1060* **범위**: [`Any file`](#scopes)
1061* **유형**: 부울1061* **유형**: Boolean
1062 * `true`: 저장된 `fastMode: true`는 더 이상 세션 시작 시 빠른 모드를 켜지 않으므로 각 사용자는 빠른 모드를 원하는 각 세션에서 `/fast`를 실행합니다. `--settings`로 전달된 `fastMode: true`는 관리되는 설정이 이 키를 설정하지 않는 한 해당 세션에 대해 계속 계산됩니다.1062 * `true`: 저장된 `fastMode: true`가 더 이상 세션 시작 시 빠른 모드를 켜지 않으므로 각 사용자가 원하는 세션마다 `/fast`를 실행합니다. 관리형 설정에서 이 키를 설정하지 않는 한 `--settings`로 전달된 `fastMode: true`는 해당 세션에 여전히 적용됩니다
1063 * `false`: 저장된 `fastMode: true`는 이후의 모든 세션 시작 시 빠른 모드를 켭니다.1063 * `false`: 저장된 `fastMode: true`가 이후 모든 세션이 시작될 때 빠른 모드를 켭니다
1064* **기본값**: `false`1064* **기본값**: `false`
1065 1065
1066```json settings.json theme={null}1066```json settings.json theme={null}
1069}1069}
1070```1070```
1071 1071
1072[세션별 옵트인 필요](/docs/ko/fast-mode#require-per-session-opt-in)를 참조하십시오.1072[세션별 옵트인 요구](/docs/ko/fast-mode#require-per-session-opt-in)를 참조하세요.
1073 1073
1074<h3 id="language">1074<h3 id="language">
1075 `language`1075 `language`
1076</h3>1076</h3>
1077 1077
1078Claude가 기본적으로 영어 이외의 언어로 응답하도록 합니다. 응답에 대한 고정 목록이 없습니다: Claude Code는 값을 Claude에 항상 해당 언어로 응답하도록 지시하는 것으로 그대로 전달하므로 Claude가 읽을 수 있는 모든 언어 이름이 작동합니다. Claude Code는 값을 확인하지 않으므로 잘못된 이름은 오류를 생성하는 대신 작성된 대로 Claude에 도달합니다. 동일한 값은 [음성 받아쓰기](/docs/ko/voice-dictation#change-the-dictation-language)의 언어를 설정하며, 이는 [지원되는 받아쓰기 언어](/docs/ko/voice-dictation#change-the-dictation-language)의 고정 목록을 가지며, 자동 생성된 세션 제목도 설정합니다.1078Claude가 기본적으로 영어가 아닌 언어로 응답하도록 합니다. 응답에 대한 고정된 목록은 없습니다. Claude Code는 이 값을 해당 언어로 항상 응답하라는 지시로 Claude에 그대로 전달하므로 Claude가 읽을 수 있는 모든 언어 이름이 작동합니다. Claude Code는 값을 확인하지 않으므로 철자가 틀린 이름은 오류를 발생시키지 않고 작성된 그대로 Claude에 전달됩니다. 같은 값이 [음성 받아쓰기](/docs/ko/voice-dictation#change-the-dictation-language)의 언어와 자동 생성되는 세션 제목의 언어도 설정하며, 음성 받아쓰기에는 [지원되는 받아쓰기 언어](/docs/ko/voice-dictation#change-the-dictation-language)의 고정 목록이 있습니다.
1079 1079
1080* **범위**: [`Any file`](#scopes)1080* **범위**: [`Any file`](#scopes)
1081* **유형**: 문자열, `"japanese"`, `"spanish"`, `"french"`와 같은 모든 언어 이름; Claude Code는 이를 검증하지 않습니다.1081* **유형**: 문자열. `"japanese"`, `"spanish"`, `"french"`와 같은 모든 언어 이름. Claude Code는 검증하지 않습니다
1082* **기본값**: 설정 해제됨; 세션 제목은 대화의 언어와 일치합니다.1082* **기본값**: 설정되지 않음. 이 경우 세션 제목은 대화 언어를 따릅니다
1083 1083
1084```json settings.json theme={null}1084```json settings.json theme={null}
1085{1085{
1091 `maxEffortLevel`1091 `maxEffortLevel`
1092</h3>1092</h3>
1093 1093
1094세션이 사용할 수 있는 [노력 수준](/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 이상이 필요합니다.1094세션이 사용할 수 있는 [effort 수준](/docs/ko/model-config#adjust-effort-level)의 상한을 정하고, 그보다 낮은 수준은 계속 사용할 수 있도록 합니다. 더 높은 수준은 상한에서 대신 실행되며, 여기에는 `/effort`, `/model` 선택기, `--effort`, [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ko/env-vars), 스킬이나 서브에이전트의 `effort` frontmatter, 모델 자체 기본값에서 온 수준이 포함됩니다. Claude Code가 각 요청 전에 직접 상한을 적용하므로 Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry를 포함한 모든 공급자에서 유지됩니다. Claude Code v2.1.267 이상이 필요합니다.
1095 1095
1096* **범위**: [`Any file`](#scopes). 조직에 대해 이를 적용하려면 관리되는 설정에 배포합니다. 여러 범위가 제한을 설정할 때 가장 낮은 것이 적용되므로 한 범위에서 설정된 제한은 다른 범위에서 올릴 수 없습니다.1096* **범위**: [`Any file`](#scopes). 조직 전체에 적용하려면 관리형 설정에 배포합니다. 여러 범위에서 상한을 설정하면 가장 낮은 값이 적용되므로, 한 범위에서 설정한 상한을 다른 범위에서 올릴 수 없습니다
1097* **유형**: 문자열, `"low"`, `"medium"`, `"high"`, `"xhigh"`, 또는 `"max"` 중 하나. `"max"` 값은 제한을 설정하지 않습니다.1097* **유형**: 문자열. `"low"`, `"medium"`, `"high"`, `"xhigh"`, `"max"` 중 하나. `"max"` 값은 상한을 설정하지 않습니다
1098* **기본값**: 설정 해제되어 제한이 적용되지 않음1098* **기본값**: 설정되지 않음. 따라서 상한이 적용되지 않습니다
1099* **세션별 재정의**: 모델의 [`modelSettings`](#modelsettings) 항목에 `maxEffortLevel`을 추가합니다. 해당 항목은 사용자 설정 또는 [관리되는 소스](/docs/ko/managed-settings#how-claude-code-combines-managed-sources) 중 하나와 같이 둘 다 설정하는 설정 소스 내에서 모델에 대해서만 이 키를 대체합니다. 해당 소스의 제한에서 모델을 제외하려면 거기에 `"max"`를 설정합니다. Claude Code는 여전히 다른 소스의 제한을 적용합니다.1099* **모델별 상한**: 모델의 [`modelSettings`](#modelsettings) 항목에 `maxEffortLevel`을 추가합니다. 해당 항목은 사용자 설정이나 하나의 [관리형 소스](/docs/ko/managed-settings#how-claude-code-combines-managed-sources)처럼 둘 다 설정한 설정 소스 내에서만 그 모델에 대해 이 키를 대체합니다. 해당 소스의 상한에서 모델을 제외하려면 그곳에 `"max"`를 설정합니다. Claude Code는 다른 소스의 상한은 여전히 적용합니다
1100 1100
1101이 예제는 모든 모델을 `medium`으로 제한하고 Sonnet 4.6을 제외합니다:1101이 예시는 모든 모델의 상한을 `medium`으로 정하고 Sonnet 4.6은 제외합니다:
1102 1102
1103```json settings.json theme={null}1103```json settings.json theme={null}
1104{1104{
1111}1111}
1112```1112```
1113 1113
1114조직이 모델에 대해 [노력 제한](/docs/ko/model-config#organization-effort-limits)을 설정할 때 두 제한 중 낮은 것이 적용됩니다.1114조직에서 모델에 대한 [effort 제한](/docs/ko/model-config#organization-effort-limits)도 설정한 경우 두 상한 중 낮은 값이 적용됩니다.
1115 1115
1116<h3 id="model">1116<h3 id="model">
1117 `model`1117 `model`
1118</h3>1118</h3>
1119 1119
1120모든 새 세션이 사용할 모델을 설정하므로 매번 `/model`로 선택할 필요가 없습니다. 여기에 설정해도 세션 중에 전환하는 것을 중지하지 않습니다. 관리자가 사용자 선택을 재정의하도록 [조직 기본 모델](/docs/ko/model-config#organization-default-model)을 설정한 경우 사용자, 프로젝트, 로컬 설정에서 이 키를 설정해도 해당 모델을 얻습니다.1120모든 새 세션이 사용할 모델을 설정하여 매번 `/model`로 모델을 선택하지 않아도 되도록 합니다. 여기에서 설정해도 세션 중간에 전환하는 것은 막지 않습니다. 관리자가 사용자 선택을 재정의하도록 [조직 기본 모델](/docs/ko/model-config#organization-default-model)을 설정한 경우, 사용자, 프로젝트, 로컬 설정에서 이 키를 설정하더라도 해당 모델이 사용됩니다.
1121 1121
1122* **범위**: [`Any file`](#scopes)1122* **범위**: [`Any file`](#scopes)
1123* **유형**: 문자열, 모델 별칭 또는 전체 모델 ID1123* **유형**: 문자열. 모델 별칭 또는 전체 모델 ID
1124* **기본값**: 설정 해제되어 Claude Code는 계정의 기본 모델을 사용합니다.1124* **기본값**: 설정되지 않음. 따라서 Claude Code는 계정의 기본 모델을 사용합니다
1125* **세션별 재정의**: `--model`은 [`ANTHROPIC_MODEL`](/docs/ko/env-vars)보다 우선하며, 둘 다 한 세션에 대해 이 키보다 우선하며, 관리되는 `model`보다도 우선합니다. [`availableModels`](#availablemodels) 목록은 여전히 선택에 적용됩니다.1125* **세션별 재정의**: `--model`은 [`ANTHROPIC_MODEL`](/docs/ko/env-vars)보다 우선하며, 둘 다 한 세션에 대해서는 관리형 `model`을 포함하여 이 키보다 우선합니다. [`availableModels`](#availablemodels) 목록은 여전히 선택에 적용됩니다
1126 1126
1127```json settings.json theme={null}1127```json settings.json theme={null}
1128{1128{
1130}1130}
1131```1131```
1132 1132
1133여기의 값은 [`ANTHROPIC_DEFAULT_MODEL`](/docs/ko/model-config#set-a-default-model-for-new-sessions)을 능가하며, Claude Code는 다른 것이 모델을 선택하지 않을 때만 사용합니다.1133여기의 값은 [`ANTHROPIC_DEFAULT_MODEL`](/docs/ko/model-config#set-a-default-model-for-new-sessions)보다 우선하며, Claude Code는 다른 어떤 것도 모델을 선택하지 않을 때만 `ANTHROPIC_DEFAULT_MODEL`을 사용합니다.
1134 1134
1135<h3 id="modeloverrides">1135<h3 id="modeloverrides">
1136 `modelOverrides`1136 `modelOverrides`
1137</h3>1137</h3>
1138 1138
1139Anthropic 모델 ID를 Amazon Bedrock 추론 프로필 ARN과 같은 공급자별 모델 ID로 매핑합니다. 각 모델 선택기 항목은 공급자 API를 호출할 때 매핑된 값을 사용합니다. 관리자는 [Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry](/docs/ko/model-config#override-model-ids-per-version)에서 이를 사용하여 각 모델 버전을 특정 추론 프로필, 버전 이름, 배포로 라우팅하여 거버넌스, 비용 할당, 지역 라우팅을 수행합니다.1139Anthropic 모델 ID를 Amazon Bedrock 추론 프로필 ARN과 같은 공급자별 모델 ID에 매핑합니다. 그러면 각 모델 선택기 항목은 공급자 API를 호출할 때 매핑된 값을 사용합니다. 관리자는 [Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry](/docs/ko/model-config#override-model-ids-per-version)에서 거버넌스, 비용 할당 또는 지역 라우팅을 위해 각 모델 버전을 특정 추론 프로필, 버전 이름 또는 배포로 라우팅하는 데 이를 사용합니다.
1140 1140
1141* **범위**: [`Any file`](#scopes)1141* **범위**: [`Any file`](#scopes)
1142* **유형**: 모델 ID를 공급자 모델 ID로 매핑하는 객체1142* **유형**: 모델 ID를 공급자 모델 ID에 매핑하는 객체
1143* **기본값**: 설정 해제됨1143* **기본값**: 설정되지 않음
1144 1144
1145이 예제는 Opus 4.6에 대한 모든 호출을 명명된 Bedrock 추론 프로필로 라우팅합니다:1145이 예시는 Opus 4.6에 대한 모든 호출을 지정된 Bedrock 추론 프로필로 라우팅합니다:
1146 1146
1147```json settings.json theme={null}1147```json settings.json theme={null}
1148{1148{
1152}1152}
1153```1153```
1154 1154
1155[버전별 모델 ID 재정의](/docs/ko/model-config#override-model-ids-per-version)를 참조하십시오.1155[버전별 모델 ID 재정의](/docs/ko/model-config#override-model-ids-per-version)를 참조하세요.
1156 1156
1157<h3 id="modelpicker">1157<h3 id="modelpicker">
1158 `modelPicker`1158 `modelPicker`
1159</h3>1159</h3>
1160 1160
1161\[`/model` 선택기가 제공하는 모델을 작성한 순서대로 선택한 레이블 아래에 나열하므로 선택기는 조직이 실행하는 모델을 나열하며, 기본 제공 라인업 후 또는 대신합니다. 각 행의 `model`은 그대로 사용되므로 `--model`이 허용하는 모든 것을 허용합니다: `opus`와 같은 별칭, Anthropic 모델 ID, 또는 Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry, LLM 게이트웨이의 공급자 형식 ID. Claude Code v2.1.242 이상이 필요합니다.1161`/model` 선택기가 제공하는 모델을 작성한 순서대로 원하는 레이블로 나열하여, 선택기가 기본 제공 라인업 뒤에 또는 그 대신 조직에서 실행하는 모델을 나열하도록 합니다. 각 행의 `model`은 그대로 사용되므로 `--model`이 허용하는 모든 것을 허용합니다. 즉 `opus`와 같은 별칭, Anthropic 모델 ID, 또는 Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry, LLM 게이트웨이용 공급자 형식 ID를 사용할 수 있습니다. Claude Code v2.1.242 이상이 필요합니다.
1162 1162
1163* **범위**: [`User or managed`](#scopes). Claude Code는 관리되는 설정, `--settings`, 사용자 설정에서 키를 읽고 프로젝트 및 로컬 설정에서는 무시하므로 복제한 저장소가 선택기를 다시 레이블할 수 없습니다. 이 세 가지 중 가장 높은 것이 키를 설정하면 전체 라인업을 제공하며, Claude Code는 두 소스의 라인업을 결코 결합하지 않습니다.1163* **범위**: [`User or managed`](#scopes). Claude Code는 관리형 설정, `--settings`, 사용자 설정에서 이 키를 읽고, 복제한 저장소가 선택기의 레이블을 바꿀 수 없도록 프로젝트 및 로컬 설정에서는 무시합니다. 이 세 가지 중 키를 설정한 가장 높은 소스가 라인업 전체를 제공하며, Claude Code는 두 소스의 라인업을 결합하지 않습니다.
1164* **유형**: `options` 배열과 선택적 `replaceBuiltInOptions` 부울을 가진 객체1164* **유형**: 행의 `options` 배열과 선택적 `replaceBuiltInOptions` Boolean을 가진 객체
1165* **기본값**: 설정 해제되어 선택기는 기본 제공 라인업을 표시합니다.1165* **기본값**: 설정되지 않음. 따라서 선택기는 기본 제공 라인업을 표시합니다
1166 1166
1167이 예제는 두 개의 Bedrock 배포를 기본 제공 라인업 후에 추가하며, 팀이 인식하는 이름 아래에 있습니다:1167이 예시는 기본 제공 라인업 뒤에 팀이 알아볼 수 있는 이름으로 두 개의 Bedrock 배포를 추가합니다:
1168 1168
1169```json managed-settings.json theme={null}1169```json managed-settings.json theme={null}
1170{1170{
1189 `modelPicker`의 필드1189 `modelPicker`의 필드
1190</h4>1190</h4>
1191 1191
1192키는 행 자체에 대한 하나와 기본 제공 라인업을 대체하거나 추가하는지에 대한 하나의 두 필드를 사용합니다.1192이 키는 두 개의 필드를 받습니다. 하나는 행 자체에 대한 것이고, 다른 하나는 행이 기본 제공 라인업을 대체할지 또는 추가될지에 대한 것입니다.
1193 1193
1194| 필드 | 유형 | 수행 작업 |1194| 필드 | 유형 | 동작 |
1195| :- | :- | :- |1195| :- | :- | :- |
1196| `options` | 필수 `model` 및 선택적 `label`, `description`, `behavesAs`를 가진 행의 배열 | 선택기가 표시하는 행(이 순서로), 회색으로 표시된 행은 아래로 이동합니다. `label` 없이 Claude Code는 알려진 모델에 대해 기본 제공 이름으로 행을 제목으로 지정하거나 모델 ID로 지정하며, `description` 없이 일반 두 번째 줄을 작성합니다. |1196| `options` | 행의 배열. 각 행에는 필수 `model`과 선택적 `label`, `description`, `behavesAs`가 있습니다 | 선택기가 이 순서대로 표시하는 행입니다. 단, 회색으로 표시된 행은 맨 아래로 이동합니다. `label`이 없으면 Claude Code는 알고 있는 모델이면 기본 제공 이름으로, 그렇지 않으면 모델 ID로 행 제목을 붙이며, `description`이 없으면 일반적인 두 번째 줄을 작성합니다 |
1197| `replaceBuiltInOptions` | 부울, 기본값 `false` | 이들 행만, **Default**, 세션이 이미 사용 중인 모델의 행을 표시하려면 `true`로 설정합니다. 기본 제공 라인업 후에 이들 행을 추가하려면 설정 해제합니다. |1197| `replaceBuiltInOptions` | Boolean, 기본값 `false` | `true`로 설정하면 이 행들, **Default**, 세션이 이미 사용 중인 모델의 행만 표시합니다. 설정하지 않으면 이 행들이 기본 제공 라인업 뒤에 추가됩니다 |
1198 1198
1199\[`options`의 항목은 또한 `model` 옆에 선택적 `behavesAs` 문자열을 전달할 수 있으며, v2.1.257 이상이 필요합니다. 이를 Claude Code 버전이 이미 알고 있는 모델의 ID(예: `claude-opus-4-8`)로 설정하며, `model`이 버전보다 최신인 항목에서 설정합니다. Claude Code는 알려진 모델의 기능 및 노력 기본값을 항목에 적용하는 대신 모델을 알 수 없는 것으로 취급합니다. 항목의 레이블과 Claude Code가 요청에서 보내는 모델 ID는 변경되지 않습니다.1199`options`의 항목은 `model` 옆에 선택적 `behavesAs` 문자열도 가질 수 있으며, 이를 위해서는 v2.1.257 이상이 필요합니다. `model`이 현재 버전보다 새로운 항목에 `claude-opus-4-8`처럼 현재 Claude Code 버전이 이미 알고 있는 모델의 ID로 설정합니다. 그러면 Claude Code는 해당 모델을 알 수 없는 모델로 취급하는 대신 알려진 모델의 기능과 effort 기본값을 항목에 적용합니다. 항목의 레이블과 Claude Code가 요청에서 보내는 모델 ID는 변경되지 않습니다.
1200 1200
1201`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가 실행하는 모델은 변경하지 않습니다.1201`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가 실행하는 모델은 바꾸지 않습니다.
1202 1202
1203[`availableModels`](#availablemodels) 허용 목록은 여전히 이들 행에 적용됩니다. 나열된 모델을 허용 목록에 추가하기 전에 [병합 동작](/docs/ko/model-config#merge-behavior)을 읽으십시오: 특정 모델 ID는 제품군의 와일드카드 항목을 좁힙니다. Claude Code는 또한 선택기를 표시하기 전에 각 행을 세션에 대해 확인합니다:1203[`availableModels`](#availablemodels) 허용 목록은 이 행들에도 여전히 적용됩니다. 나열된 모델을 허용 목록에 추가하기 전에 [병합 동작](/docs/ko/model-config#merge-behavior)을 읽어 보세요. 특정 모델 ID는 해당 계열의 와일드카드 항목을 좁힙니다. Claude Code는 선택기를 표시하기 전에 각 행을 세션과 대조하여 확인하기도 합니다:
1204 1204
1205* **삭제됨**: Claude Code가 제공할 수 없는 행(예: 폐기된 모델 또는 조직이 액세스할 수 없는 모델)1205* **제거됨**: 폐기된 모델이나 조직에 액세스 권한이 없는 모델처럼 Claude Code가 제공할 수 없는 행
1206* **회색으로 표시됨**: 아직 선택할 수 없는 행이며, 이유와 함께 표시됩니다.1206* **회색으로 표시됨**: 아직 선택할 수 없는 행으로, 이유와 함께 표시됩니다
1207* **행이 생존하지 않음**: Claude Code는 기본 제공 라인업을 유지하며, 허용 목록으로 필터링됩니다.1207* **남은 행 없음**: Claude Code는 평소처럼 허용 목록으로 필터링된 기본 제공 라인업을 유지합니다
1208 1208
1209Claude Code는 구문 분석할 수 없는 행을 삭제하고 나머지를 유지합니다. [손상된 설정 파일 수정](/docs/ko/settings#fix-a-broken-settings-file)을 참조하십시오.1209Claude Code는 구문 분석할 수 없는 행을 제거하고 나머지는 유지합니다. [손상된 설정 파일 수정](/docs/ko/settings#fix-a-broken-settings-file)을 참조하세요.
1210 1210
1211<h3 id="modelpricing">1211<h3 id="modelpricing">
1212 `modelPricing`1212 `modelPricing`
1213</h3>1213</h3>
1214 1214
1215조직이 지불하는 요금으로 지출을 보고하며, 목록 가격 대신입니다. 조직이 계약 요금을 가지고 있을 때 설정하므로 개발자가 보는 달러 수치가 청구서와 일치합니다. 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 이상이 필요합니다.1215정가 대신 조직에서 지불하는 요율로 지출을 보고합니다. 조직에 계약 요율이 있을 때 설정하면 개발자에게 표시되는 금액이 청구서와 일치합니다. 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 Console에서 요율을 읽지 않습니다. Claude Code v2.1.242 이상이 필요합니다.
1216 1216
1217* **범위**: [`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 이상에서만 사용합니다.1217* **범위**: [`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 이상에서만 이를 사용합니다.
1218* **유형**: 선택적 `multiplier` 및 선택적 `overrides` 맵을 가진 객체1218* **유형**: 선택적 `multiplier`와 선택적 `overrides` 맵을 가진 객체
1219* **기본값**: 설정 해제되어 Claude Code는 호스트 애플리케이션이 테이블을 제공하지 않는 한 목록 가격을 보고합니다.1219* **기본값**: 설정되지 않음. 따라서 호스트 애플리케이션이 요율표를 제공하지 않는 한 Claude Code는 정가를 보고합니다
1220 1220
1221단독으로 `multiplier`를 설정하여 정액 할인 또는 인상, 단독으로 `overrides`를 설정하여 모델별 요금, 또는 둘 다를 설정합니다.1221일률적인 할인이나 인상에는 `multiplier`만, 모델별 요율에는 `overrides`만 설정하거나 둘 다 설정합니다.
1222 1222
1223이 예제는 Sonnet 4.6에 대한 계약 요금을 설정한 다음 Sonnet 행을 포함한 모든 수치를 15% 감소시킵니다:1223이 예시는 Sonnet 4.6의 계약 요율을 설정한 다음 Sonnet 행을 포함한 모든 금액을 15% 줄입니다:
1224 1224
1225```json managed-settings.json theme={null}1225```json managed-settings.json theme={null}
1226{1226{
1238}1238}
1239```1239```
1240 1240
1241`multiplier`를 1 이상 10까지 설정하여 모든 수치를 인상합니다. 인상은 Claude Code v2.1.271 이상이 필요합니다. 이전 버전은 경고와 함께 1 이상의 `multiplier`를 무시하고 설정의 나머지를 유지합니다.1241모든 금액을 인상하려면 `multiplier`를 1보다 크게, 최대 10까지 설정합니다. 인상에는 Claude Code v2.1.271 이상이 필요합니다. 이전 버전은 1보다 큰 `multiplier`를 경고와 함께 무시하고 설정의 나머지 부분은 유지합니다.
1242 1242
1243단계(요금이 적용되는지 확인하는 방법 포함)는 [계약 요금으로 지출 보고](/docs/ko/costs#report-spend-at-your-contracted-rates)를 참조하십시오.1243요율이 적용되었는지 확인하는 방법을 포함한 단계는 [계약 요율로 지출 보고](/docs/ko/costs#report-spend-at-your-contracted-rates)를 참조하세요.
1244 1244
1245<span id="modelpricing-multiplier" />1245<span id="modelpricing-multiplier" />
1246 1246
1250 `modelPricing`의 필드1250 `modelPricing`의 필드
1251</h4>1251</h4>
1252 1252
1253| 필드 | 유형 | 수행 작업 |1253| 필드 | 유형 | 동작 |
1254| :- | :- | :- |1254| :- | :- | :- |
1255| `multiplier` | 0보다 크고 최대 10인 숫자 | Claude Code가 계산하는 모든 비용을 확장하며, `overrides` 행이 이를 포함하는지 여부와 관계없이 확장합니다. 1 미만은 할인, 1 이상은 인상입니다. |1255| `multiplier` | 0보다 크고 10 이하인 숫자 | `overrides` 행이 적용되는지 여부와 관계없이 Claude Code가 계산하는 모든 비용을 조정합니다. 1 미만은 할인, 1 초과는 인상입니다 |
1256| `overrides` | 모델 ID를 `input`, `output`, `cacheRead`, `cacheWrite`를 가진 요금 객체로 매핑하며, 각각 0에서 10000 | 해당 모델에 대한 백만 토큰당 USD 요금이며, 모두 4개 필수입니다. `cacheWrite`는 5분 및 1시간 캐시 쓰기를 모두 포함합니다. [어느 모델이 행을 적용하는지](#which-models-a-modelpricing-row-applies-to) 참조 |1256| `overrides` | 모델 ID를 `input`, `output`, `cacheRead`, `cacheWrite`(각각 0\~10000)를 가진 요율 객체에 매핑하는 맵 | 해당 모델의 백만 토큰당 USD 요율이며, 네 가지 모두 필수입니다. `cacheWrite`는 5분 및 1시간 캐시 쓰기를 모두 포함합니다. [`modelPricing` 행이 적용되는 모델](#which-models-a-modelpricing-row-applies-to)을 참조하세요 |
1257 1257
1258Claude Code는 행의 요금을 정확히 작성한 대로 사용하며, 빠른 모드 추가 요금 또는 [미국 전용 추론 요금](https://platform.claude.com/docs/en/about-claude/pricing)을 추가하지 않습니다. `multiplier`도 설정하면 Claude Code는 행의 요금 위에 이를 적용합니다. Claude Code는 구문 분석할 수 없는 요금이 있는 행 또는 구문 분석할 수 없는 `multiplier`를 삭제하고 나머지를 유지합니다. [손상된 설정 파일 수정](/docs/ko/settings#fix-a-broken-settings-file)을 참조하십시오.1258Claude Code는 빠른 모드 추가 요금이나 [미국 전용 추론 요율](https://platform.claude.com/docs/en/about-claude/pricing)을 더하지 않고 작성한 그대로 행의 요율을 사용합니다. `multiplier`도 설정하면 Claude Code는 행의 요율 위에 이를 적용합니다. Claude Code는 구문 분석할 수 없는 요율이 있는 행이나 구문 분석할 수 없는 `multiplier`를 제거하고 나머지는 유지합니다. [손상된 설정 파일 수정](/docs/ko/settings#fix-a-broken-settings-file)을 참조하세요.
1259 1259
1260<h4 id="which-models-a-modelpricing-row-applies-to">1260<h4 id="which-models-a-modelpricing-row-applies-to">
1261 `modelPricing` 행이 적용되는 모델1261 `modelPricing` 행이 적용되는 모델
1262</h4>1262</h4>
1263 1263
1264Claude Code는 행의 키에서 행이 적용되는 모델을 결정합니다:1264Claude Code는 행의 키를 기준으로 행이 적용되는 모델을 결정합니다:
1265 1265
1266* **기본 제공 모델의 ID**: Claude Code 자체가 기본 제공 모델에 사용하는 키이며, 해당 키가 모델의 자체 ID(예: `claude-sonnet-4-6`) 또는 Bedrock, Agent Platform, Foundry ID인지 여부와 관계없이 사용합니다. Claude Code는 해당 모델의 모든 날짜 스냅샷 ID 및 공급자별 ID에 행을 적용합니다.1266* **기본 제공 모델의 ID**: Claude Code 자체가 기본 제공 모델에 사용하는 키로, `claude-sonnet-4-6`과 같은 모델 자체 ID이든 Bedrock, Agent Platform, Foundry ID이든 해당됩니다. Claude Code는 해당 모델의 모든 날짜 스냅샷 ID와 공급자별 ID에 행을 적용합니다.
1267* **다른 모든 키**: 기본 제공 모델의 ID가 아닌 키(예: 게이트웨이 모델 별칭). Claude Code는 해당 하나의 ID에만 행을 적용합니다. 모델 ID가 키 중 하나와 정확히 일치하고 기본 제공 모델의 ID로 키가 지정된 행 아래에도 해당할 때 Claude Code는 정확한 일치를 사용합니다.1267* **그 밖의 키**: 게이트웨이 모델 별칭처럼 기본 제공 모델의 ID가 아닌 키입니다. Claude Code는 해당 ID 하나에만 행을 적용합니다. 모델 ID가 키 중 하나와 정확히 일치하면서 기본 제공 모델의 ID로 키가 지정된 행에도 해당하는 경우, Claude Code는 정확히 일치하는 항목을 사용합니다.
1268* **Bedrock 애플리케이션 추론 프로필**: Claude Code가 [`modelOverrides`](#modeloverrides) 맵을 통해 또는 [`bedrock:GetInferenceProfile` 조회](/docs/ko/amazon-bedrock#iam-configuration)를 통해 프로필을 라우팅하는 모델로 확인한 후 Claude Code는 해당 모델의 행을 프로필에 적용합니다.1268* **Bedrock 애플리케이션 추론 프로필**: Claude Code가 [`modelOverrides`](#modeloverrides) 맵이나 [`bedrock:GetInferenceProfile` 조회](/docs/ko/amazon-bedrock#iam-configuration)를 통해 프로필을 라우팅 대상 모델로 확인하면, Claude Code는 해당 모델의 행을 프로필에 적용합니다.
1269 1269
1270<h3 id="modelsettings">1270<h3 id="modelsettings">
1271 `modelSettings`1271 `modelSettings`
1272</h3>1272</h3>
1273 1273
1274사용하는 각 모델에 대해 [노력 수준](/docs/ko/model-config#adjust-effort-level)을 저장합니다. Claude Code v2.1.251 이상이 필요합니다.1274사용하는 각 모델에 대한 [effort 수준](/docs/ko/model-config#adjust-effort-level)을 저장합니다. Claude Code v2.1.251 이상이 필요합니다.
1275 1275
1276머신의 대화형 세션에서 `/effort` 또는 `/model` 선택기의 노력 슬라이더로 `low`, `medium`, `high`, 또는 `xhigh`를 기본값으로 저장할 때 Claude Code는 해당 수준을 사용 중인 모델 아래에 작성하므로 이 키를 거의 편집하지 않습니다. [VS Code 확장의 모델 선택기](/docs/ko/vs-code#use-the-prompt-box)에서 이들 수준 중 하나를 선택할 때 Claude Code는 동일한 방식으로 저장합니다. [`effortLevel`](#effortlevel) 항목은 `/effort`가 해당 세션에만 적용되는 세션을 나열합니다.1276로컬 머신의 대화형 세션에서 `/effort` 또는 `/model` 선택기의 effort 슬라이더로 `low`, `medium`, `high`, `xhigh`를 기본값으로 저장하면 Claude Code는 사용 중인 모델 아래 여기에 해당 수준을 기록하므로, 이 키를 직접 편집할 일은 거의 없습니다. [VS Code 확장의 모델 선택기](/docs/ko/vs-code#use-the-prompt-box)에서 이러한 수준 중 하나를 선택하면 Claude Code는 같은 방식으로 여기에 저장합니다. `/effort`가 해당 세션에만 적용되는 세션은 [`effortLevel`](#effortlevel) 항목에 나열되어 있습니다.
1277 1277
1278저장한 수준을 변경하거나 제거하려면 키를 직접 편집합니다.1278저장한 수준을 변경하거나 제거하려면 키를 직접 편집합니다.
1279 1279
1280여기서 지정한 모델의 `effortLevel`은 동일한 설정 파일의 최상위 [`effortLevel`](#effortlevel)보다 우선합니다. 파일 간에 Claude Code는 각 모델을 별도로 확인합니다: 해당 모델에 대해 `effortLevel`을 설정하거나 [해당 모델에 적용되는](#effortlevel) 최상위 `effortLevel`을 설정하는 가장 높은 우선순위 [설정 파일](/docs/ko/settings#settings-precedence)이 결정하므로 관리되는 설정의 `effortLevel`은 사용자 설정에서 저장한 수준보다 우선합니다. [노력 수준 조정](/docs/ko/model-config#adjust-effort-level)은 저장된 수준을 재정의할 수 있는 다른 것(예: 시작 시 `--effort`)을 나열합니다.1280여기의 모델별 `effortLevel`은 같은 설정 파일의 최상위 [`effortLevel`](#effortlevel)보다 우선합니다. 파일 간에는 Claude Code가 각 모델을 개별적으로 해석합니다. 해당 모델에 대한 `effortLevel` 또는 [해당 모델에 적용되는](#effortlevel) 최상위 `effortLevel`을 설정한 우선순위가 가장 높은 [설정 파일](/docs/ko/settings#settings-precedence)이 결정하므로, 관리형 설정의 `effortLevel`은 사용자 설정에 저장한 수준보다 우선합니다. 실행 시 `--effort`처럼 저장된 수준을 재정의할 수 있는 다른 항목은 [effort 수준 조정](/docs/ko/model-config#adjust-effort-level)에 나열되어 있습니다.
1281 1281
1282한 모델의 노력을 설정하는 대신 제한하려면 해당 모델의 항목에 [`maxEffortLevel`](#maxeffortlevel) 필드를 추가합니다. 필드는 Claude Code v2.1.267 이상이 필요합니다.1282한 모델의 수준을 설정하는 대신 effort 상한을 정하려면 해당 모델의 항목에 [`maxEffortLevel`](#maxeffortlevel) 필드를 추가합니다. 이 필드에는 Claude Code v2.1.267 이상이 필요합니다.
1283 1283
1284* **범위**: [`Any file`](#scopes)1284* **범위**: [`Any file`](#scopes)
1285* **유형**: 모델 이름을 `effortLevel` 필드(하나의 `"low"`, `"medium"`, `"high"`, 또는 `"xhigh"`), [`maxEffortLevel`](#maxeffortlevel) 필드, 또는 둘 다를 가진 객체로 매핑하는 객체1285* **유형**: 모델 이름을 다음 필드 중 일부를 가진 객체에 매핑하는 객체:
1286* **기본값**: 설정 해제됨1286 * `effortLevel`: `"low"`, `"medium"`, `"high"`, `"xhigh"` 중 하나
1287 * [`maxEffortLevel`](#maxeffortlevel): 모델이 실행될 수 있는 가장 높은 effort 수준
1288 * `autoCompactWindow`: `100000`에서 `1000000` 사이의 토큰 수 또는 모델에 맞게 조정된 윈도우를 의미하는 `"auto"`. [`/autocompact`](/docs/ko/model-config#set-the-auto-compact-window)가 여기에 저장합니다. 해당 모델에 대해서는 이 값이 같은 설정 파일의 최상위 [`autoCompactWindow`](#autocompactwindow)보다 우선합니다. Claude Code v2.1.288 이상이 필요합니다
1289* **기본값**: 설정되지 않음
1287 1290
1288Claude Code는 각 항목을 `claude-opus-5-5`와 같은 모델의 정규 이름 아래에 작성하며, 해당 모델의 별칭, 날짜 접미사, `[1m]`, 인식된 공급자별 ID를 동일한 항목과 일치시킵니다.1291Claude Code는 각 항목을 `claude-opus-5-5`와 같은 모델의 표준 이름 아래에 기록하며, 해당 모델의 별칭, 날짜 접미사가 붙은 ID, `[1m]` ID, 인식되는 공급자별 ID를 같은 항목에 매칭합니다.
1289 1292
1290이 예제는 Opus 5.5를 `high`로 유지하면서 다른 모델은 자신의 저장되거나 기본 수준을 사용합니다:1293이 예시는 다른 모델은 각자의 저장된 수준이나 기본 수준을 사용하는 동안 Opus 5.5를 `high`로 유지합니다:
1291 1294
1292```json settings.json theme={null}1295```json settings.json theme={null}
1293{1296{
1299}1302}
1300```1303```
1301 1304
1302사용 중인 모델에 대해 저장된 수준을 지우려면 `/effort auto`를 실행합니다. Claude Code는 다른 항목과 파일의 모든 최상위 `effortLevel`을 그대로 둡니다.1305사용 중인 모델에 대해 저장된 수준을 지우려면 `/effort auto`를 실행합니다. Claude Code는 다른 항목과 최상위 `effortLevel`은 그대로 둡니다.
1303 1306
1304<h3 id="outputstyle">1307<h3 id="outputstyle">
1305 `outputStyle`1308 `outputStyle`
1306</h3>1309</h3>
1307 1310
1308[출력 스타일](/docs/ko/output-styles)을 이름으로 선택합니다. 출력 스타일은 Claude의 역할, 톤, 출력 형식을 변경하는 저장된 지침 집합이며, 기본 제공 Explanatory 및 Learning 스타일 또는 직접 작성한 스타일입니다.1311이름으로 [출력 스타일](/docs/ko/output-styles)을 선택합니다. 출력 스타일은 Claude의 역할, 어조, 출력 형식을 바꾸는 저장된 지침 세트로, 기본 제공 Explanatory 및 Learning 스타일이나 직접 작성한 스타일이 이에 해당합니다.
1309 1312
1310세션 중에 이 키를 변경하면 Claude는 다음 메시지부터 새 스타일을 사용합니다. 해당 메시지가 프롬프트 캐싱에서 비용이 얼마인지는 [출력 스타일 변경](/docs/ko/prompt-caching#changing-output-style)을 참조하십시오. v2.1.251 이전에는 `/clear`를 실행하거나 새 세션을 시작한 후에만 편집이 적용되었습니다.1313세션 중에 이 키를 변경하면 Claude는 다음 메시지부터 새 스타일을 사용합니다. 해당 메시지의 프롬프트 캐싱 비용은 [출력 스타일 변경](/docs/ko/prompt-caching#changing-output-style)을 참조하세요. v2.1.251 이전에는 `/clear`를 실행하거나 새 세션을 시작한 후에야 편집 내용이 적용되었습니다.
1311 1314
1312* **범위**: [`Any file`](#scopes)1315* **범위**: [`Any file`](#scopes)
1313* **유형**: 문자열, [기본 제공](/docs/ko/output-styles#built-in-output-styles) 또는 [사용자 정의](/docs/ko/output-styles#create-a-custom-output-style) 출력 스타일의 이름1316* **유형**: 문자열. [기본 제공](/docs/ko/output-styles#built-in-output-styles) 또는 [사용자 지정](/docs/ko/output-styles#create-a-custom-output-style) 출력 스타일의 이름
1314* **기본값**: 설정 해제되어 Claude Code는 기본 스타일을 사용합니다.1317* **기본값**: 설정되지 않음. 따라서 Claude Code는 기본 스타일을 사용합니다
1315 1318
1316이 예제는 기본 제공 Explanatory 스타일을 선택하며, 작업 사이에 교육 통찰력을 추가합니다:1319이 예시는 작업 사이에 교육적인 인사이트를 추가하는 기본 제공 Explanatory 스타일을 선택합니다:
1317 1320
1318```json settings.json theme={null}1321```json settings.json theme={null}
1319{1322{
1325 `promptCacheTtl`1328 `promptCacheTtl`
1326</h3>1329</h3>
1327 1330
1328[프롬프트 캐시](/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 이상이 필요합니다.1331[프롬프트 캐시](/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 이상이 필요합니다.
1329 1332
1330* **범위**: [`Any file`](#scopes)1333* **범위**: [`Any file`](#scopes)
1331* **유형**: 문자열, 다음 중 하나:1334* **유형**: 문자열. 다음 중 하나:
1332 * `"5m"`: 캐시는 5분 동안 유지됩니다.1335 * `"5m"`: 캐시가 5분 동안 유지됩니다
1333 * `"1h"`: 캐시는 1시간 동안 유지됩니다.1336 * `"1h"`: 캐시가 1시간 동안 유지됩니다
1334* **기본값**: 설정 해제되어 각 주 대화 요청은 [기본 수명](/docs/ko/prompt-caching#which-ttl-each-request-gets)을 얻습니다.1337* **기본값**: 설정되지 않음. 따라서 각 메인 대화 요청은 [기본 수명](/docs/ko/prompt-caching#which-ttl-each-request-gets)을 받습니다
1335* **세션별 재정의**: [`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)1338* **세션별 재정의**: [`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) 순입니다
1336 1339
1337이 예제는 주 대화를 1시간 수명으로 유지하고 subagents를 5분으로 둡니다:1340이 예시는 메인 대화를 1시간 수명으로 유지하고 서브에이전트는 5분으로 둡니다:
1338 1341
1339```json settings.json theme={null}1342```json settings.json theme={null}
1340{1343{
1343}1346}
1344```1347```
1345 1348
1346각 수명이 비용이 얼마인지는 [캐시 수명](/docs/ko/prompt-caching#cache-lifetime)을 참조하십시오.1349각 수명의 비용은 [캐시 수명](/docs/ko/prompt-caching#cache-lifetime)을 참조하세요.
1347 1350
1348<h3 id="showthinkingsummaries">1351<h3 id="showthinkingsummaries">
1349 `showThinkingSummaries`1352 `showThinkingSummaries`
1350</h3>1353</h3>
1351 1354
1352대화형 세션에서 Claude의 [확장 사고](/docs/ko/model-config#extended-thinking) 요약을 봅니다. `Ctrl+O`로 사고를 확장할 때 전체 요약을 원하면 설정합니다. 설정 해제되거나 `false`일 때 Anthropic API는 사고 블록을 수정하고 Claude Code는 축소된 스텁을 표시합니다. 타사 공급자는 수정하지 않습니다.1355대화형 세션에서 Claude의 [확장 사고](/docs/ko/model-config#extended-thinking) 요약을 확인합니다. `Ctrl+O`로 사고를 펼칠 때 전체 요약을 보려면 설정합니다. 설정하지 않았거나 `false`이면 Anthropic API가 thinking 블록을 편집하여 가리고 Claude Code는 접힌 스텁을 표시합니다. 서드파티 공급자는 가리지 않습니다.
1353 1356
1354* **범위**: [`Any file`](#scopes)1357* **범위**: [`Any file`](#scopes)
1355* **유형**: 부울1358* **유형**: Boolean
1356 * `true`: `Ctrl+O`로 사고를 확장할 때 전체 사고 요약을 봅니다.1359 * `true`: `Ctrl+O`로 사고를 펼치면 전체 사고 요약이 표시됩니다
1357 * `false`: Anthropic API는 사고 블록을 수정하고 Claude Code는 축소된 스텁을 표시합니다.1360 * `false`: Anthropic API가 thinking 블록을 가리고 Claude Code는 접힌 스텁을 표시합니다
1358* **기본값**: `false`1361* **기본값**: `false`
1359 1362
1360```json settings.json theme={null}1363```json settings.json theme={null}
1363}1366}
1364```1367```
1365 1368
1366수정은 모델이 생성하는 것이 아니라 보는 것만 변경합니다. 사고 지출을 줄이려면 [예산을 낮추거나 사고를 비활성화](/docs/ko/model-config#extended-thinking)하십시오.1369가리기는 표시되는 내용만 바꾸며 모델이 생성하는 내용은 바꾸지 않습니다. 사고 비용을 줄이려면 대신 [예산을 낮추거나 사고를 비활성화](/docs/ko/model-config#extended-thinking)하세요.
1367 1370
1368<h3 id="subagentpromptcachettl">1371<h3 id="subagentpromptcachettl">
1369 `subagentPromptCacheTtl`1372 `subagentPromptCacheTtl`
1370</h3>1373</h3>
1371 1374
1372[프롬프트 캐시](/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 이상이 필요합니다.1375[프롬프트 캐시](/docs/ko/prompt-caching)가 Claude Code가 메인 대화 외부에서 보내는 요청을 유지하는 기간을 선택합니다. 이 키는 [서브에이전트](/docs/ko/sub-agents), [워크플로](/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 이상이 필요합니다.
1373 1376
1374* **범위**: [`Any file`](#scopes)1377* **범위**: [`Any file`](#scopes)
1375* **유형**: 문자열, 다음 중 하나:1378* **유형**: 문자열. 다음 중 하나:
1376 * `"5m"`: 캐시는 5분 동안 유지됩니다.1379 * `"5m"`: 캐시가 5분 동안 유지됩니다
1377 * `"1h"`: 캐시는 1시간 동안 유지됩니다.1380 * `"1h"`: 캐시가 1시간 동안 유지됩니다
1378* **기본값**: 설정 해제되어 이들 각 요청은 [기본 수명](/docs/ko/prompt-caching#which-ttl-each-request-gets)을 얻습니다.1381* **기본값**: 설정되지 않음. 따라서 이러한 각 요청은 [기본 수명](/docs/ko/prompt-caching#which-ttl-each-request-gets)을 받습니다
1379* **세션별 재정의**: [`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)을 참조하십시오.1382* **세션별 재정의**: [`FORCE_PROMPT_CACHING_5M`](/docs/ko/env-vars)이 다른 모든 것보다 우선하고, 그다음 [`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`](/docs/ko/env-vars), 그다음 이 키, 그다음 모든 요청에 1시간 수명을 요청하는 [`ENABLE_PROMPT_CACHING_1H`](/docs/ko/env-vars) 순입니다. 서브에이전트 자체 frontmatter 값의 순위는 [TTL 직접 선택](/docs/ko/prompt-caching#choose-the-ttl-yourself)을 참조하세요
1380 1383
1381이 예제는 subagents 및 주 대화 외부의 다른 요청에 1시간 수명을 제공합니다:1384이 예시는 서브에이전트와 메인 대화 외부의 다른 요청에 1시간 수명을 부여합니다:
1382 1385
1383```json settings.json theme={null}1386```json settings.json theme={null}
1384{1387{
1386}1389}
1387```1390```
1388 1391
1389이 키는 [`promptCacheTtl`](#promptcachettl)이 포함하지 않는 요청을 포함하므로 Claude Code가 만드는 모든 요청에 대해 수명을 선택하려면 둘 다 설정합니다. subagent의 캐시가 주 대화의 캐시와 어떻게 다른지는 [Subagents 및 캐시](/docs/ko/prompt-caching#subagents-and-the-cache)를 참조하십시오.1392이 키는 [`promptCacheTtl`](#promptcachettl)이 다루지 않는 요청을 다루므로, Claude Code가 보내는 모든 요청의 수명을 선택하려면 둘 다 설정하세요. 서브에이전트의 캐시가 메인 대화의 캐시와 어떻게 다른지는 [서브에이전트와 캐시](/docs/ko/prompt-caching#subagents-and-the-cache)를 참조하세요.
1390 1393
1391<h3 id="switchmodelsonflag">1394<h3 id="switchmodelsonflag">
1392 `switchModelsOnFlag`1395 `switchModelsOnFlag`
1393</h3>1396</h3>
1394 1397
1395[안전 분류기가 요청에 플래그를 지정](/docs/ko/model-config#automatic-model-fallback)할 때 발생하는 상황을 선택합니다: 폴백 모델로 전환하고 계속하거나, 전환과 프롬프트 편집 중에서 선택할 수 있도록 일시 중지합니다.1398[안전 분류기가 요청에 플래그를 지정](/docs/ko/model-config#automatic-model-fallback)할 때 수행할 작업을 선택합니다. 폴백 모델로 전환하여 계속하거나, 일시 중지하여 전환과 프롬프트 편집 중에서 선택할 수 있도록 합니다.
1396 1399
1397* **범위**: [`Any file`](#scopes). `/config`에 **메시지에 플래그가 지정되면 모델 전환**으로 나타납니다.1400* **범위**: [`Any file`](#scopes). `/config`에서 **Switch models when a message is flagged**로 표시됩니다.
1398* **유형**: 부울1401* **유형**: Boolean
1399 * `true`: Claude Code는 폴백 모델로 전환하고 계속합니다.1402 * `true`: Claude Code가 폴백 모델로 전환하고 계속합니다
1400 * `false`: 대화형 세션에서 Claude Code는 전환과 프롬프트 편집 중에서 선택할 수 있도록 일시 중지합니다. 대화 상자를 표시할 수 없는 곳(예: `-p` 실행)에서는 플래그된 요청이 오류로 끝납니다.1403 * `false`: 대화형 세션에서는 Claude Code가 일시 중지하여 전환과 프롬프트 편집 중에서 선택할 수 있도록 합니다. `-p` 실행처럼 대화 상자를 표시할 수 없는 곳에서는 플래그가 지정된 요청이 오류로 종료됩니다
1401* **기본값**: `true`, 자동으로 전환1404* **기본값**: `true`, 자동으로 전환
1402 1405
1403```json settings.json theme={null}1406```json settings.json theme={null}
1406}1409}
1407```1410```
1408 1411
1409[전환하기 전에 묻기](/docs/ko/model-config#ask-before-switching)를 참조하십시오.1412[전환 전에 확인](/docs/ko/model-config#ask-before-switching)을 참조하세요.
1410 1413
1411<h3 id="ultracode">1414<h3 id="ultracode">
1412 `ultracode`1415 `ultracode`
1413</h3>1416</h3>
1414 1417
1415[ultracode](/docs/ko/workflows#let-claude-decide-with-ultracode)를 켜서 세션을 시작합니다. 켜져 있으면 Claude는 사용자가 요청할 때까지 기다리는 대신 각 실질적인 작업에 대해 워크플로우를 계획합니다. Claude는 [동적 워크플로우](/docs/ko/workflows)가 사용자에게 활성화되고 모델이 `xhigh` 노력을 지원할 때만 워크플로우를 계획합니다. 키는 세션의 노력 수준을 변경하지 않습니다: ultracode는 세션이 사용하는 어느 수준에서든 실행됩니다. Claude Code는 이 키를 읽지만 절대 작성하지 않습니다: `/effort ultracode`는 현재 세션에만 ultracode를 켭니다.1418[ultracode](/docs/ko/workflows#let-claude-decide-with-ultracode)를 켠 상태로 세션을 시작합니다. 켜면 Claude는 요청을 기다리지 않고 실질적인 각 작업에 대해 워크플로를 계획합니다. Claude는 [동적 워크플로](/docs/ko/workflows)가 활성화되어 있고 모델이 `xhigh` effort를 지원할 때만 워크플로를 계획합니다. 이 키는 세션의 effort 수준을 바꾸지 않습니다. ultracode는 세션이 사용하는 수준에서 실행됩니다. Claude Code는 이 키를 읽기만 하고 쓰지는 않습니다. `/effort ultracode`는 현재 세션에 대해서만 ultracode를 켭니다.
1416 1419
1417* **범위**: [`Any file`](#scopes)1420* **범위**: [`Any file`](#scopes)
1418* **유형**: 부울1421* **유형**: Boolean
1419 * `true`: 동적 워크플로우가 사용자에게 활성화되고 모델이 `xhigh` 노력을 지원할 때 세션은 ultracode가 켜진 상태로 시작합니다.1422 * `true`: 동적 워크플로가 활성화되어 있고 모델이 `xhigh`를 지원하면 ultracode를 켠 상태로 세션이 시작됩니다
1420 * `false`: 세션은 ultracode가 꺼진 상태로 시작합니다.1423 * `false`: ultracode를 끈 상태로 세션이 시작됩니다
1421* **기본값**: 설정 해제되어 ultracode는 꺼짐1424* **기본값**: 설정되지 않음. 따라서 ultracode가 꺼져 있습니다
1422* **세션별 재정의**: `/effort ultracode`는 이 키 없이 한 세션에 대해 ultracode를 켭니다. `--effort ultracode` 플래그도 한 세션에 대해 켜며, `xhigh` 노력에서 켜며, Claude Code v2.1.203 이상이 필요합니다.1425* **세션별 재정의**: `/effort ultracode`는 이 키 없이 한 세션에 대해 ultracode를 켜고, `/effort ultracode off`는 이 키가 `true`일 때 한 세션에 대해 ultracode를 끕니다. `--effort ultracode` 플래그도 `xhigh` effort로 한 세션에 대해 ultracode를 켜며, Claude Code v2.1.203 이상이 필요합니다
1423 1426
1424```json settings.json theme={null}1427```json settings.json theme={null}
1425{1428{
1427}1430}
1428```1431```
1429 1432
1430세션의 노력 수준은 [`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` 제어 요청도 키를 허용합니다.1433세션의 effort 수준은 [`effortLevel`](#effortlevel), [`modelSettings`](#modelsettings) 및 기타 [effort 소스](/docs/ko/model-config#adjust-effort-level)에서 결정되며, [`maxEffortLevel`](#maxeffortlevel)과 같은 [effort 상한](/docs/ko/model-config#organization-effort-limits)은 ultracode를 끄지 않고 해당 수준을 낮춥니다. 이 동작과 `/effort ultracode off` 형식에는 Claude Code v2.1.284 이상이 필요합니다. v2.1.284 이전에는 `ultracode: true`가 세션을 `xhigh` effort로 실행했으며, `xhigh` 미만의 effort 상한이 있으면 ultracode가 꺼진 상태로 유지되었습니다. Agent SDK `apply_flag_settings` 제어 요청도 이 키를 허용합니다.
1431 1434
1432<h2 id="permission-settings">1435<h2 id="permission-settings">
1433 권한 설정1436 권한 설정
2967}2970}
2968```2971```
2969 2972
2970[`/autocompact`](/docs/ko/commands#all-commands) 명령으로 설정하면 이 키가 사용자 설정에 기록됩니다. [자동 압축 윈도우 설정](/docs/ko/model-config#set-the-auto-compact-window)에서 명령, 플래그, 변수 및 설정이 어떻게 상호작용하는지 설명합니다.2973[`/autocompact`](/docs/ko/commands#all-commands) 명령은 현재 모델의 윈도우를 [`modelSettings`](#modelsettings) 아래에 저장하며, 이 값은 해당 모델에 대해 같은 파일의 이 키보다 우선합니다. [자동 압축 윈도우 설정](/docs/ko/model-config#set-the-auto-compact-window)에서 명령, 플래그, 변수 및 설정이 어떻게 상호작용하는지 설명합니다.
2971 2974
2972<h3 id="automemorydirectory">2975<h3 id="automemorydirectory">
2973 `autoMemoryDirectory`2976 `autoMemoryDirectory`
5435 에이전트, 세션, 및 worktrees5438 에이전트, 세션, 및 worktrees
5436</h2>5439</h2>
5437 5440
5438기본 에이전트를 설정하고, 팀원을 제어하며 세션 간 메시징을 구성하고, worktrees를 설정합니다. [Subagents](/docs/ko/sub-agents) 및 [Worktrees](/docs/ko/worktrees)를 참조하세요.5441기본 에이전트를 설정하고, 팀원을 제어하며 세션 간 메시징을 구성하고, worktrees를 설정합니다. [서브에이전트](/docs/ko/sub-agents) 및 [Worktrees](/docs/ko/worktrees)를 참조하세요.
5439 5442
5440<h3 id="agent">5443<h3 id="agent">
5441 `agent`5444 `agent`
5442</h3>5445</h3>
5443 5446
5444명명된 [subagent](/docs/ko/sub-agents#invoke-subagents-explicitly)로 메인 스레드를 실행하여 Claude Code가 해당 subagent의 시스템 프롬프트, 도구 제한 사항 및 모델을 세션에 적용하도록 합니다. 동일한 키는 `claude agents`에서 디스패치하는 세션의 기본 에이전트를 설정합니다.5447명명된 [서브에이전트](/docs/ko/sub-agents#invoke-subagents-explicitly)로 메인 스레드를 실행하여 Claude Code가 해당 서브에이전트의 시스템 프롬프트, 도구 제한 사항 및 모델을 세션에 적용하도록 합니다. 동일한 키는 `claude agents`에서 디스패치하는 세션의 기본 에이전트를 설정합니다.
5445 5448
5446* **Scope**: [`Any file`](#scopes)5449* **Scope**: [`Any file`](#scopes)
5447* **Type**: string, 기본 제공 또는 사용자 정의 에이전트의 이름5450* **Type**: string, 기본 제공 또는 사용자 정의 에이전트의 이름
5462 5465
5463이 세션이 [다른 Claude Code 세션에서 도착하는 메시지](/docs/ko/cross-session-messaging#control-inbound-messages)로 수행할 작업을 선택합니다. 적용되는 값이 없으면 Claude Code는 두 세션의 권한 모드 클래스에서 메시지별로 결정합니다. Claude Code v2.1.224 이상이 필요합니다.5466이 세션이 [다른 Claude Code 세션에서 도착하는 메시지](/docs/ko/cross-session-messaging#control-inbound-messages)로 수행할 작업을 선택합니다. 적용되는 값이 없으면 Claude Code는 두 세션의 권한 모드 클래스에서 메시지별로 결정합니다. Claude Code v2.1.224 이상이 필요합니다.
5464 5467
5465* **Scope**: [`Any file`](#scopes). 프로젝트 또는 로컬 값은 관리되는 설정, `--settings` 플래그 또는 사용자 설정이 제공하는 값보다 더 엄격할 때만 적용됩니다.5468* **Scope**: [`Any file`](#scopes). 프로젝트 또는 로컬 값은 관리형 설정, `--settings` 플래그 또는 사용자 설정이 제공하는 값보다 더 엄격할 때만 적용됩니다.
5466* **Type**: string, 다음 중 하나:5469* **Type**: string, 다음 중 하나:
5467 * `"accept"`: Claude Code가 메시지를 Claude에 전달합니다5470 * `"accept"`: Claude Code가 메시지를 Claude에 전달합니다
5468 * `"hold"`: Claude Code가 메시지를 전달하지 않고 알림을 표시합니다5471 * `"hold"`: Claude Code가 메시지를 전달하지 않고 알림을 표시합니다
5475}5478}
5476```5479```
5477 5480
5478Claude Code는 관리되는 설정을 먼저 읽은 다음 `--settings` 플래그, 그 다음 사용자 설정을 읽고 찾은 첫 번째 값을 적용합니다. `refuse`는 `hold`보다 더 엄격하고, `hold`는 `accept`보다 더 엄격합니다. 신뢰할 수 있는 소스 중 어느 것도 값을 설정하지 않으면 프로젝트 또는 로컬 `hold` 또는 `refuse`가 여전히 적용되어 메시지별 기본값을 대체합니다. 세션 간 메시징이 있는 세션에서 이 키는 `/config`에 **다른 세션의 메시지**로 나타나며, 이는 사용자 설정에 기록됩니다. 행에는 Claude Code v2.1.232 이상이 필요하며, Claude Code는 `--settings` 플래그 또는 관리되는 설정이 키를 설정하는 동안 이를 숨깁니다.5481Claude Code는 관리형 설정을 먼저 읽은 다음 `--settings` 플래그, 그 다음 사용자 설정을 읽고 찾은 첫 번째 값을 적용합니다. `refuse`는 `hold`보다 더 엄격하고, `hold`는 `accept`보다 더 엄격합니다. 신뢰할 수 있는 소스 중 어느 것도 값을 설정하지 않으면 프로젝트 또는 로컬 `hold` 또는 `refuse`가 여전히 적용되어 메시지별 기본값을 대체합니다. 세션 간 메시징이 있는 세션에서 이 키는 `/config`에 **다른 세션의 메시지**로 나타나며, 이는 사용자 설정에 기록됩니다. 행에는 Claude Code v2.1.232 이상이 필요하며, Claude Code는 `--settings` 플래그 또는 관리형 설정이 키를 설정하는 동안 이를 숨깁니다.
5479 5482
5480Claude Code는 인식하지 못하는 값을 설정할 때 [경고](/docs/ko/errors#crosssessioninbound-must-be-one-of-accept-hold-refuse)합니다. 해당 값이 사용자, 프로젝트, 로컬 또는 `--settings` 파일에 있는 동안 Claude Code는 인바운드 메시지를 보류합니다. 우선 순위를 갖는 소스가 `accept`를 설정하더라도 마찬가지입니다. 다른 소스가 설정한 `refuse`는 여전히 적용됩니다. 값을 수정하거나 제거하여 보류를 해제합니다.5483Claude Code는 인식하지 못하는 값을 설정할 때 [경고](/docs/ko/errors#crosssessioninbound-must-be-one-of-accept-hold-refuse)합니다. 해당 값이 사용자, 프로젝트, 로컬 또는 `--settings` 파일에 있는 동안 Claude Code는 인바운드 메시지를 보류합니다. 우선순위를 갖는 소스가 `accept`를 설정하더라도 마찬가지입니다. 다른 소스가 설정한 `refuse`는 여전히 적용됩니다. 값을 수정하거나 제거하여 보류를 해제합니다.
5481 5484
5482인식하지 못하는 값이 [관리되는 설정](/docs/ko/managed-settings)에 있으면 Claude Code는 대신 관리자가 수정할 때까지 이를 `refuse`로 처리합니다. v2.1.248 이전에는 Claude Code가 경고 없이 인식하지 못하는 값을 무시했습니다.5485인식하지 못하는 값이 [관리형 설정](/docs/ko/managed-settings)에 있으면 Claude Code는 대신 관리자가 수정할 때까지 이를 `refuse`로 처리합니다. v2.1.248 이전에는 Claude Code가 경고 없이 인식하지 못하는 값을 무시했습니다.
5483 5486
5484<h3 id="disableagentview">5487<h3 id="disableagentview">
5485 `disableAgentView`5488 `disableAgentView`
5486</h3>5489</h3>
5487 5490
5488[배경 에이전트 및 에이전트 보기](/docs/ko/agent-view)를 끕니다: `claude agents`, `--bg`, `/background` 및 온디맨드 감독자. [관리되는 설정](/docs/ko/managed-settings)에서 설정하여 조직에 대해 적용합니다.5491[배경 에이전트 및 에이전트 보기](/docs/ko/agent-view)를 끕니다: `claude agents`, `--bg`, `/background` 및 온디맨드 감독자. [관리형 설정](/docs/ko/managed-settings)에서 설정하여 조직에 대해 적용합니다.
5489 5492
5490* **Scope**: [`Any file`](#scopes)5493* **Scope**: [`Any file`](#scopes)
5491* **Type**: Boolean5494* **Type**: Boolean
5566 `worktree`5569 `worktree`
5567</h3>5570</h3>
5568 5571
5569Claude Code가 `--worktree`, `EnterWorktree` 도구 및 격리된 subagents 및 배경 세션에 대해 [git worktrees](/docs/ko/worktrees)를 생성하고 관리하는 방식을 구성합니다.5572Claude Code가 `--worktree`, `EnterWorktree` 도구 및 격리된 서브에이전트 및 배경 세션에 대해 [git worktrees](/docs/ko/worktrees)를 생성하고 관리하는 방식을 구성합니다.
5570 5573
5571* **Scope**: [`Any file`](#scopes)5574* **Scope**: [`Any file`](#scopes)
5572* **Type**: `baseRef`, `symlinkDirectories`, `sparsePaths` 및 `bgIsolation`을 포함하는 객체5575* **Type**: `baseRef`, `symlinkDirectories`, `sparsePaths` 및 `bgIsolation`을 포함하는 객체
5573* **Default**: 설정되지 않음5576* **Default**: 설정되지 않음
5574 5577
5575이 예제는 현재 `HEAD`에서 새 worktrees를 분기하고 각 worktree에 `node_modules`를 심링크합니다:5578이 예제는 현재 `HEAD`에서 새 worktree의 브랜치를 만들고 각 worktree에 `node_modules`의 심볼릭 링크를 만듭니다:
5576 5579
5577```json settings.json theme={null}5580```json settings.json theme={null}
5578{5581{
5589 `worktree.baseRef`5592 `worktree.baseRef`
5590</h3>5593</h3>
5591 5594
5592새 worktrees가 분기할 ref를 선택합니다. `"fresh"`는 원격과 일치하는 깨끗한 트리를 위해 `origin/<default-branch>`에서 분기합니다. `"head"`는 현재 로컬 `HEAD`에서 분기하므로 푸시되지 않은 커밋 및 기능 분기 상태가 worktree에 있습니다.5595새 worktree의 브랜치가 시작될 ref를 선택합니다. `"fresh"`는 원격과 일치하는 깨끗한 트리를 위해 `origin/<default-branch>`에서 브랜치를 만듭니다. `"head"`는 현재 로컬 `HEAD`에서 브랜치를 만들므로 푸시되지 않은 커밋 및 기능 브랜치 상태가 worktree에 있습니다.
5593 5596
5594* **Scope**: [`Any file`](#scopes)5597* **Scope**: [`Any file`](#scopes)
5595* **Type**: string, 다음 중 하나:5598* **Type**: string, 다음 중 하나:
5596 * `"fresh"`: 새 worktrees는 `origin/<default-branch>`에서 분기합니다5599 * `"fresh"`: 새 worktree는 `origin/<default-branch>`에서 브랜치를 만듭니다
5597 * `"head"`: 새 worktrees는 푸시되지 않은 커밋을 포함하여 현재 로컬 `HEAD`에서 분기합니다5600 * `"head"`: 새 worktree는 푸시되지 않은 커밋을 포함하여 현재 로컬 `HEAD`에서 브랜치를 만듭니다
5598* **Default**: `"fresh"`5601* **Default**: `"fresh"`
5599 5602
5600```json settings.json theme={null}5603```json settings.json theme={null}
5611 `worktree.symlinkDirectories`5614 `worktree.symlinkDirectories`
5612</h3>5615</h3>
5613 5616
5614메인 리포지토리의 디렉토리를 각 worktree에 심링크하여 디스크에 큰 디렉토리를 복제하지 않습니다.5617메인 저장소의 디렉터리를 각 worktree에 심볼릭 링크로 연결하여 디스크에 큰 디렉터리를 복제하지 않습니다.
5615 5618
5616* **Scope**: [`Any file`](#scopes)5619* **Scope**: [`Any file`](#scopes)
5617* **Type**: 문자열 배열, 리포지토리 루트에 상대적인 디렉토리 경로5620* **Type**: 문자열 배열, 저장소 루트에 상대적인 디렉터리 경로
5618* **Default**: 설정되지 않음. Claude Code는 디렉토리를 심링크하지 않습니다5621* **Default**: 설정되지 않음. Claude Code는 디렉터리를 심볼릭 링크로 연결하지 않습니다
5619 5622
5620이 예제는 메인 리포지토리의 `node_modules` 및 `.cache`를 모든 새 worktree에 심링크합니다:5623이 예제는 메인 저장소의 `node_modules` 및 `.cache`를 모든 새 worktree에 심볼릭 링크로 연결합니다:
5621 5624
5622```json settings.json theme={null}5625```json settings.json theme={null}
5623{5626{
5631 `worktree.sparsePaths`5634 `worktree.sparsePaths`
5632</h3>5635</h3>
5633 5636
5634git sparse-checkout를 통해 각 worktree에서 나열된 디렉토리만 체크아웃합니다. Claude Code는 해당 디렉토리와 루트 수준 파일만 디스크에 기록하므로 대규모 monorepos에서 더 빠릅니다. [필요한 디렉토리만 체크아웃](/docs/ko/large-codebases#check-out-only-the-directories-you-need)을 참조하세요.5637git sparse-checkout를 통해 각 worktree에서 나열된 디렉터리만 체크아웃합니다. Claude Code는 해당 디렉터리와 루트 수준 파일만 디스크에 기록하므로 대규모 monorepos에서 더 빠릅니다. [필요한 디렉터리만 체크아웃](/docs/ko/large-codebases#check-out-only-the-directories-you-need)을 참조하세요.
5635 5638
5636* **Scope**: [`Any file`](#scopes)5639* **Scope**: [`Any file`](#scopes)
5637* **Type**: 문자열 배열, 리포지토리 루트에 상대적인 디렉토리 경로5640* **Type**: 문자열 배열, 저장소 루트에 상대적인 디렉터리 경로
5638* **Default**: 설정되지 않음. 각 worktree는 전체 트리를 체크아웃합니다5641* **Default**: 설정되지 않음. 각 worktree는 전체 트리를 체크아웃합니다
5639 5642
5640이 예제는 각 worktree에서 `packages/my-app` 및 `shared/utils`와 루트 수준 파일만 체크아웃합니다:5643이 예제는 각 worktree에서 `packages/my-app` 및 `shared/utils`와 루트 수준 파일만 체크아웃합니다:
5647}5650}
5648```5651```
5649 5652
5650sparse worktree가 존재하는 동안 git은 리포지토리의 공유 `.git/config`에서 `extensions.worktreeConfig`를 활성화합니다.5653sparse worktree가 존재하는 동안 git은 저장소의 공유 `.git/config`에서 `extensions.worktreeConfig`를 활성화합니다.
5651 5654
5652<h3 id="worktree-bgisolation">5655<h3 id="worktree-bgisolation">
5653 `worktree.bgIsolation`5656 `worktree.bgIsolation`
5654</h3>5657</h3>
5655 5658
5656[배경 세션](/docs/ko/agent-view#how-file-edits-are-isolated)이 파일 편집을 격리하는 방식을 선택합니다. `"worktree"`를 사용하면 Claude Code는 세션이 `EnterWorktree`를 호출할 때까지 메인 체크아웃에서 `Edit` 및 `Write`를 차단합니다. `"none"`을 사용하면 배경 작업이 작업 복사본을 직접 편집합니다. git worktrees가 비실용적인 리포지토리의 경우 `"none"`을 설정합니다.5659[배경 세션](/docs/ko/agent-view#how-file-edits-are-isolated)이 파일 편집을 격리하는 방식을 선택합니다. `←` 또는 `/background`로 세션을 배경으로 옮긴 경우, 해당 세션은 이 키의 값과 관계없이 파일을 제자리에서 편집합니다. `"worktree"`를 사용하면 Claude Code는 세션이 `EnterWorktree`를 호출할 때까지 메인 체크아웃에서 `Edit` 및 `Write`를 차단합니다. `"none"`을 사용하면 배경 작업이 작업 복사본을 직접 편집합니다. git worktrees가 비실용적인 저장소의 경우 `"none"`을 설정합니다.
5657 5660
5658* **Scope**: [`Any file`](#scopes)5661* **Scope**: [`Any file`](#scopes)
5659* **Type**: string, 다음 중 하나:5662* **Type**: string, 다음 중 하나:
5669}5672}
5670```5673```
5671 5674
5672git 리포지토리 외부에서 실패하는 [`WorktreeCreate` 훅](/docs/ko/worktrees#non-git-version-control)은 블록을 해제하여 세션이 작업 디렉토리를 제자리에서 편집할 수 있도록 합니다. 해당 해제에는 Claude Code v2.1.203 이상이 필요합니다.5675git 저장소 외부에서 실패하는 [`WorktreeCreate` 훅](/docs/ko/worktrees#non-git-version-control)은 차단을 해제하여 세션이 작업 디렉터리를 제자리에서 편집할 수 있도록 합니다. 해당 해제에는 Claude Code v2.1.203 이상이 필요합니다.
5673 5676
5674<h2 id="remote-desktop-and-notifications">5677<h2 id="remote-desktop-and-notifications">
5675 원격, 데스크톱 및 알림5678 원격, 데스크톱 및 알림
