Documentation 2026-11-11 22:59 UTC to 2026-11-12 23:02 UTC

254| 소스 | 로드 시기 | 영향 |254| 소스 | 로드 시기 | 영향 |

255| :- | :- | :- |255| :- | :- | :- |

256| **시스템 프롬프트** | 모든 요청 | 작은 고정 비용, 항상 존재 |256| **시스템 프롬프트** | 모든 요청 | 작은 고정 비용, 항상 존재 |

257| **CLAUDE.md 파일** | 세션 시작, [`settingSources`](https://code.claude.com/docs/ko/agent-sdk/claude-code-features)를 통해 | 모든 요청에서 전체 콘텐츠(프롬프트 캐시되므로 첫 번째 요청만 전체 비용 지불) |257| **CLAUDE.md 파일** | 세션 시작, [`settingSources`](https://code.claude.com/docs/ko/agent-sdk/claude-code-features)를 통해 | 모든 요청에서 전체 콘텐츠(단, 프롬프트 캐시됨) |

258| **도구 정의** | Bash, Read, Edit 같은 핵심 기본 제공 도구는 모든 요청; MCP 도구 및 기타 기본 제공 도구는 필요 시([도구 검색](https://code.claude.com/docs/ko/agent-sdk/mcp.md#mcp-tool-search)이 기본적으로 지연시킴) | [도구 검색 구성](https://code.claude.com/docs/ko/agent-sdk/tool-search.md#configure-tool-search)에 설명된 경우에는 모든 스키마가 사전에 로드됩니다 |258| **도구 정의** | Bash, Read, Edit 같은 핵심 기본 제공 도구는 모든 요청; MCP 도구 및 기타 기본 제공 도구는 필요 시([도구 검색](https://code.claude.com/docs/ko/agent-sdk/mcp.md#mcp-tool-search)이 기본적으로 지연시킴) | [도구 검색 구성](https://code.claude.com/docs/ko/agent-sdk/tool-search.md#configure-tool-search)에 설명된 경우에는 모든 스키마가 사전에 로드됩니다 |

259| **대화 기록** | 턴에 걸쳐 누적 | 각 턴으로 증가: 프롬프트, 응답, 도구 입력, 도구 출력 |259| **대화 기록** | 턴에 걸쳐 누적 | 각 턴으로 증가: 프롬프트, 응답, 도구 입력, 도구 출력 |

260| **스킬 설명** | 세션 시작, 설정 소스를 통해 | 짧은 요약; 전체 콘텐츠는 호출될 때만 로드 |260| **스킬 설명** | 세션 시작, 설정 소스를 통해 | 짧은 요약; 전체 콘텐츠는 호출될 때만 로드 |

298 298 

299### 미러 쓰기는 최선의 노력입니다299### 미러 쓰기는 최선의 노력입니다

300 300 

301`append()`가 거부하면, SDK는 짧은 백오프를 사용하여 배치를 최대 2회 더 재시도하며, 총 최대 3회 시도합니다. 시간 초과된 호출은 재시도되지 않습니다. 원본 호출이 여전히 도착할 수 있기 때문입니다. 배치가 여전히 실패하면, SDK는 오류를 기록하고, `{ type: "system", subtype: "mirror_error" }` 메시지를 반복자로 내보내며, 배치를 삭제하고 쿼리를 계속합니다. 재시도된 배치는 이미 도착한 항목을 다시 전달할 수 있으므로, `append()` 구현에서 `entry.uuid`로 중복을 제거합니다.301`append()`가 거부하면, SDK는 짧은 백오프를 사용하여 배치를 최대 2회 더 재시도하며, 총 최대 3회 시도합니다. 시간 초과된 호출은 재시도되지 않습니다. 원본 호출이 여전히 도착할 수 있기 때문입니다. 재시도된 배치는 이미 도착한 항목을 다시 전달할 수 있으므로, `append()` 구현에서 `entry.uuid`로 중복을 제거하고, `uuid`가 없는 항목은 모두 유지합니다.

302 302 

303저장소 중단이 에이전트를 중단하지 않습니다. 서브프로세스가 먼저 로컬에 쓰기 때문입니다. 저장소 데이터 손실을 감지해야 하는 경우 `mirror_error`를 모니터링합니다. [저장소에서 재개된](#resume-from-the-store) 실행에서, 삭제된 배치는 실행이 끝나면 생존하는 복사본이 없습니다.303배치가 여전히 실패하면, SDK는 오류를 로그에 기록하고, `{ type: "system", subtype: "mirror_error" }` 메시지를 반복자로 내보내며, 배치를 삭제하고 쿼리를 계속합니다. 서브프로세스가 먼저 로컬에 쓰기 때문에 저장소 중단이 에이전트를 중단하지 않습니다. 저장소 데이터 손실을 감지하려면 `mirror_error`를 모니터링합니다. [저장소에서 재개된](#resume-from-the-store) 실행에서, 삭제된 배치는 실행이 끝나면 생존하는 복사본이 없습니다.

304 304 

305### `getSessionMessages`는 압축 후 체인을 반환합니다305### `getSessionMessages`는 압축 후 체인을 반환합니다

306 306 

513 513 

514### Invoke API와 함께 Mantle 실행514### Invoke API와 함께 Mantle 실행

515 515 

516Mantle에서 사용 가능한 모델이 현재 사용하는 모든 모델을 포함하지 않을 수 있습니다. `CLAUDE_CODE_USE_BEDROCK` 및 `CLAUDE_CODE_USE_MANTLE`을 모두 설정하면 Claude Code가 동일한 세션에서 두 엔드포인트를 모두 호출할 수 있습니다. Mantle 형식과 일치하는 모델 ID는 Mantle으로 라우팅되고 다른 모든 모델 ID는 Amazon Bedrock Invoke API로 이동합니다.516Mantle에서 사용 가능한 모델이 현재 사용하는 모든 모델을 포함하지 않을 수 있습니다. 게이트웨이 없이 연결하는 경우 `CLAUDE_CODE_USE_BEDROCK` 및 `CLAUDE_CODE_USE_MANTLE`을 모두 설정하여 동일한 세션에서 Mantle과 Invoke API를 모두 호출하십시오. Mantle 형식과 일치하는 모델 ID는 Mantle으로 라우팅되고 다른 모든 모델 ID는 Amazon Bedrock Invoke API로 이동합니다.

517 517 

518```bash theme={null}518```bash theme={null}

519export CLAUDE_CODE_USE_BEDROCK=1519export CLAUDE_CODE_USE_BEDROCK=1

619* 오류가 `bedrock-mantle:` 작업을 이름으로 지정하면 IAM 자격에 해당 작업을 부여하십시오.619* 오류가 `bedrock-mantle:` 작업을 이름으로 지정하면 IAM 자격에 해당 작업을 부여하십시오.

620* 오류가 작업을 이름으로 지정하지 않고 자격 증명이 유효하면 AWS 계정이 요청한 모델에 대한 액세스 권한을 부여받지 않았습니다. 액세스를 요청하려면 AWS 계정 팀에 문의하십시오.620* 오류가 작업을 이름으로 지정하지 않고 자격 증명이 유효하면 AWS 계정이 요청한 모델에 대한 액세스 권한을 부여받지 않았습니다. 액세스를 요청하려면 AWS 계정 팀에 문의하십시오.

621 621 

622모델 ID를 이름으로 지정하는 `400`은 해당 모델이 Mantle에서 제공되지 않음을 의미합니다. Mantle은 표준 Amazon Bedrock 카탈로그와 별개의 자체 모델 라인업을 가지고 있으므로 `us.anthropic.claude-sonnet-4-6`과 같은 추론 프로필 ID는 작동하지 않습니다. Mantle 형식 ID를 사용하거나 [두 엔드포인트를 모두 활성화](#run-mantle-alongside-the-invoke-api)하여 Claude Code가 추론 프로필 ID를 Invoke API로 보내도록 하십시오.622모델 ID를 이름으로 지정하는 `400`은 해당 모델이 Mantle에서 제공되지 않음을 의미합니다. Mantle은 표준 Amazon Bedrock 카탈로그와 별개의 자체 모델 라인업을 가지고 있으므로 `us.anthropic.claude-sonnet-4-6`과 같은 추론 프로필 ID는 작동하지 않습니다.

623 

624오류를 해결하려면 다음과 같이 하십시오.

625 

626* **게이트웨이 없이**: Mantle이 제공하는 [Mantle 형식 ID](#select-a-mantle-model)를 사용하거나, [Mantle을 Invoke API와 함께 실행](#run-mantle-alongside-the-invoke-api)하여 다른 형식의 ID를 해당 API로 보내십시오.

627* **게이트웨이를 통해**: 사용할 모델 ID를 게이트웨이 운영자에게 문의하십시오.

623 628 

624## 추가 리소스629## 추가 리소스

625 630 

148 148 

149#### 조직의 SSH 및 WSL 미리보기에서 스크립트 끄기149#### 조직의 SSH 및 WSL 미리보기에서 스크립트 끄기

150 150 

151[SSH 및 WSL 세션의 HTML 미리보기](#preview-html-files-in-ssh-and-wsl-sessions)에서 스크립트가 실행되지 않도록 하려면 [`disableBrowserExternalNavigation` 관리형 설정](#managed-settings)을 `true`로 설정합니다. 이 설정을 사용하면 사용자는 Browser 패널에서 [외부 사이트를 탐색](#restrict-external-browsing-for-your-organization)할 수도 없습니다.151[SSH 및 WSL 세션의 HTML 미리보기](#preview-html-files-in-ssh-and-wsl-sessions)에서 스크립트가 실행되지 않도록 하려면 [`disableRemotePreviewScripts` 관리형 설정](#managed-settings)을 `true`로 설정합니다. 사용자는 계속 외부 사이트를 탐색할 수 있습니다. Claude Desktop v5.1231.0 이상이 필요합니다.

152 152 

153이 설정은 [서버 관리형 설정](https://code.claude.com/docs/ko/server-managed-settings.md)에서 지정하거나, Desktop을 실행하는 컴퓨터의 [Claude Code MDM 정책 또는 관리형 설정 파일](https://code.claude.com/docs/ko/managed-settings.md#where-each-mechanism-stores-the-policy)에서 지정합니다. Desktop은 원격 머신이나 WSL 배포판에서 이 설정을 읽지 않습니다. [타사 공급자](https://code.claude.com/docs/ko/third-party-integrations.md)를 사용하는 경우 MDM 정책 또는 파일을 사용합니다.153> [!NOTE]

154>

155> 이전 버전은 `disableRemotePreviewScripts`를 무시합니다. 이전 버전에서 스크립트를 중지하려면 Desktop을 업데이트하거나, `disableBrowserExternalNavigation`도 `true`로 설정합니다. 그러면 `disableBrowserExternalNavigation`을 받는 모든 컴퓨터에서 사용자가 [외부 사이트를 탐색할 수 없습니다](#restrict-external-browsing-for-your-organization).

156 

157각 키는 [서버 관리형 설정](https://code.claude.com/docs/ko/server-managed-settings.md)에서 지정하거나, Desktop을 실행하는 컴퓨터의 [Claude Code MDM 정책 또는 관리형 설정 파일](https://code.claude.com/docs/ko/managed-settings.md#where-each-mechanism-stores-the-policy)에서 지정합니다. Desktop은 원격 머신, WSL 배포판, [`policyHelper`](https://code.claude.com/docs/ko/settings-reference#policyhelper), 또는 [Desktop 자체 정책](#device-management-policies)에서 이러한 키를 읽지 않습니다. [타사 공급자](https://code.claude.com/docs/ko/third-party-integrations.md)를 사용하는 경우 MDM 정책 또는 파일을 사용합니다.

154 158 

155> [!WARNING]159> [!WARNING]

156>160>

160 164 

161그런 다음 설정이 확실히 적용되도록 사용자에게 Desktop을 다시 시작하게 하고, 예상되는 동작을 알려 줍니다:165그런 다음 설정이 확실히 적용되도록 사용자에게 Desktop을 다시 시작하게 하고, 예상되는 동작을 알려 줍니다:

162 166 

163* **사용자가 여는 파일**: 미리보기에서 스크립트가 실행되지 않으므로 스크립트가 그리는 차트와 표는 비어 있습니다167* **사용자가 여는 파일**: 미리보기에서 스크립트가 실행되지 않으므로 스크립트가 그리는 차트와 표는 비어 있습니다. 알림은 `This preview doesn't run scripts`로 시작합니다.

164* **스크립트를 실행 중인 미리보기**: 다시 시작하기 전에 Desktop이 설정을 반영하면 해당 미리보기가 닫힙니다. 사용자에게 `This preview closed because scripts are turned off for previews. Open the file again to view it without scripts.`가 표시됩니다168* **스크립트를 실행 중인 미리보기**: 다시 시작하기 전에 Desktop이 설정을 반영하면 해당 미리보기가 닫힙니다. 사용자에게 `This preview closed because scripts are turned off for previews. Open the file again to view it without scripts.`가 표시됩니다

165* **사용자가 내보내는 파일**: 사용자가 [파일을 내보내](#preview-html-files-in-ssh-and-wsl-sessions) 브라우저에서 열면, 이 설정과 관계없이 스크립트가 브라우저에서 실행됩니다169* **사용자가 내보내는 파일**: 사용자가 [파일을 내보내](#preview-html-files-in-ssh-and-wsl-sessions) 브라우저에서 열면, 이 설정과 관계없이 스크립트가 브라우저에서 실행됩니다

166 170 

171##### 스크립트가 여전히 실행되는 컴퓨터 확인하기

172 

173다시 시작한 후 해당 컴퓨터의 SSH 또는 WSL 세션에서 HTML 파일을 엽니다. 미리보기 위의 알림이 `This preview doesn't load anything from the web`으로 시작하면 해당 컴퓨터에서는 여전히 스크립트가 실행됩니다. [Desktop 버전](#check-your-version), 키를 지정한 위치, 그리고 키 값이 JSON 불리언 `true`인지 확인합니다.

174 

167### 외부 사이트 탐색하기175### 외부 사이트 탐색하기

168 176 

169Browser 패널은 탭 브라우저이므로 실행 중인 앱 옆에 문서, 이슈 추적기 또는 다른 사이트를 열 수 있습니다. Browser를 열려면 macOS에서 **Cmd+Shift+B**를 누르거나 Windows에서 **Ctrl+Shift+B**를 누르거나, 세션 제목 표시줄에서 **Browser**를 클릭합니다. Google OAuth와 같은 팝업 로그인 흐름을 포함하여 패널의 사이트에 로그인할 수 있습니다.177Browser 패널은 탭 브라우저이므로 실행 중인 앱 옆에 문서, 이슈 추적기 또는 다른 사이트를 열 수 있습니다. Browser를 열려면 macOS에서 **Cmd+Shift+B**를 누르거나 Windows에서 **Ctrl+Shift+B**를 누르거나, 세션 제목 표시줄에서 **Browser**를 클릭합니다. Google OAuth와 같은 팝업 로그인 흐름을 포함하여 패널의 사이트에 로그인할 수 있습니다.

2037| `browserExternalPageTools` | `"disabled"`로 설정하면 Claude가 [Browser 창](#browse-external-sites)에서 외부 페이지를 읽거나 조작하는 도구를 사용할 수 없습니다. 사용자는 여전히 직접 외부 사이트로 이동할 수 있으며, 로컬 개발 서버 미리보기는 영향을 받지 않습니다. |2045| `browserExternalPageTools` | `"disabled"`로 설정하면 Claude가 [Browser 창](#browse-external-sites)에서 외부 페이지를 읽거나 조작하는 도구를 사용할 수 없습니다. 사용자는 여전히 직접 외부 사이트로 이동할 수 있으며, 로컬 개발 서버 미리보기는 영향을 받지 않습니다. |

2038| `disableMobileSimulatorTools` | `true`로 설정하면 [iOS Simulator 창](https://code.claude.com/docs/ko/desktop-ios-simulator.md#turn-off-simulator-access)에서 기기를 제어하고 캡처하는 Claude의 도구가 차단됩니다. 사용자가 직접 탭하는 용도로는 창을 계속 사용할 수 있으며, Claude의 액세스만 제거됩니다. 값은 JSON 불리언 `true`여야 하며, 문자열 `"true"`는 무시됩니다. |2046| `disableMobileSimulatorTools` | `true`로 설정하면 [iOS Simulator 창](https://code.claude.com/docs/ko/desktop-ios-simulator.md#turn-off-simulator-access)에서 기기를 제어하고 캡처하는 Claude의 도구가 차단됩니다. 사용자가 직접 탭하는 용도로는 창을 계속 사용할 수 있으며, Claude의 액세스만 제거됩니다. 값은 JSON 불리언 `true`여야 하며, 문자열 `"true"`는 무시됩니다. |

2039| `disableBrowserExternalNavigation` | `true`로 설정하면 [Browser 창](#browse-external-sites)에서 외부 탐색이 완전히 꺼집니다. 사용자와 Claude 모두 외부 사이트로 이동할 수 없으며, localhost 개발 서버 미리보기는 영향을 받지 않습니다. SSH 및 WSL 세션의 HTML 미리보기는 [스크립트를 실행하지 않습니다](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization). 값은 JSON 불리언 `true`여야 하며, 문자열 `"true"`는 무시됩니다. |2047| `disableBrowserExternalNavigation` | `true`로 설정하면 [Browser 창](#browse-external-sites)에서 외부 탐색이 완전히 꺼집니다. 사용자와 Claude 모두 외부 사이트로 이동할 수 없으며, localhost 개발 서버 미리보기는 영향을 받지 않습니다. SSH 및 WSL 세션의 HTML 미리보기는 [스크립트를 실행하지 않습니다](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization). 값은 JSON 불리언 `true`여야 하며, 문자열 `"true"`는 무시됩니다. |

2048| `disableRemotePreviewScripts` | `true`로 설정하면 SSH 및 WSL 세션의 [HTML 미리보기에서 스크립트만 끕니다](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization). Desktop은 원격 머신이나 WSL 배포판에서 이 키를 읽지 않습니다. 값은 JSON 불리언 `true`여야 하며, 문자열 `"true"`는 무시됩니다. Claude Desktop v5.1231.0 이상이 필요합니다. |

2040| `sshConfigs` | 환경 선택기에 표시되는 [SSH 연결](#pre-configure-ssh-connections-for-your-team)을 미리 구성합니다. 사용자는 관리되는 연결을 삭제할 수 없으며, 자신의 **Worktree folder** 외에는 아무것도 편집할 수 없습니다. |2049| `sshConfigs` | 환경 선택기에 표시되는 [SSH 연결](#pre-configure-ssh-connections-for-your-team)을 미리 구성합니다. 사용자는 관리되는 연결을 삭제할 수 없으며, 자신의 **Worktree folder** 외에는 아무것도 편집할 수 없습니다. |

2041| `sshHostCommands` | 사용자 자신의 연결과 함께 [명령에서 호스트를 가져오는 SSH 연결](#distribute-commands-to-your-team)을 제공합니다. Desktop은 컴퓨터의 관리형 설정 파일 또는 MDM 정책에서 이 키를 읽으며, [서버 관리형 설정](https://code.claude.com/docs/ko/server-managed-settings.md)에서는 무시합니다. macOS 또는 Linux에서는 Claude Desktop v3.6556.0 이상, Windows에서는 v4.16336.0 이상이 필요하며, Claude 계정으로 로그인해야 합니다. Windows에서는 Desktop이 [OpenSSH 클라이언트를 통해 연결](#use-your-ssh-configuration)하도록 설정되어 있어야 합니다. |2050| `sshHostCommands` | 사용자 자신의 연결과 함께 [명령에서 호스트를 가져오는 SSH 연결](#distribute-commands-to-your-team)을 제공합니다. Desktop은 컴퓨터의 관리형 설정 파일 또는 MDM 정책에서 이 키를 읽으며, [서버 관리형 설정](https://code.claude.com/docs/ko/server-managed-settings.md)에서는 무시합니다. macOS 또는 Linux에서는 Claude Desktop v3.6556.0 이상, Windows에서는 v4.16336.0 이상이 필요하며, Claude 계정으로 로그인해야 합니다. Windows에서는 Desktop이 [OpenSSH 클라이언트를 통해 연결](#use-your-ssh-configuration)하도록 설정되어 있어야 합니다. |

2042| `sshHostAllowlist` | [SSH 세션](#restrict-which-ssh-hosts-users-can-connect-to)을 확인된 호스트 이름이 이 패턴 중 하나와 일치하는 호스트로 제한합니다. 관리형 설정에서만 읽습니다. |2051| `sshHostAllowlist` | [SSH 세션](#restrict-which-ssh-hosts-users-can-connect-to)을 확인된 호스트 이름이 이 패턴 중 하나와 일치하는 호스트로 제한합니다. 관리형 설정에서만 읽습니다. |

2044| `disableSshSavedPasswords` | `true`로 설정하면 Desktop이 SSH 비밀번호 저장을 제안하지 않으며, 이전에 저장한 비밀번호를 사용하거나 표시하지도 않습니다. 이 설정을 켜도 저장된 비밀번호가 삭제되지는 않습니다. 관리형 설정에서만 읽습니다. Claude Desktop v1.49585.0 이상이 필요합니다. |2053| `disableSshSavedPasswords` | `true`로 설정하면 Desktop이 SSH 비밀번호 저장을 제안하지 않으며, 이전에 저장한 비밀번호를 사용하거나 표시하지도 않습니다. 이 설정을 켜도 저장된 비밀번호가 삭제되지는 않습니다. 관리형 설정에서만 읽습니다. Claude Desktop v1.49585.0 이상이 필요합니다. |

2045| `managedMcpServers` | 모든 사용자에게 MCP 서버 구성을 푸시합니다. 서드파티(3P) Desktop 배포에서만 사용할 수 있습니다. 각 항목에서 `"http"`, `"sse"`, `"stdio"` 중 하나의 전송 방식과 연결 세부 정보를 설정하고, 선택적으로 `toolPolicy` 맵을 설정하여 사용자가 호출할 수 있는 해당 서버의 도구를 제한합니다. 3P 배포는 관리자 콘솔 설정을 받지 않으므로 관리형 설정 파일, MDM 또는 Claude apps 게이트웨이 정책의 [`desktop` 블록](https://code.claude.com/docs/ko/claude-apps-gateway-config#claude-desktop-overlay)을 통해 전달하십시오. 게이트웨이를 통해 전달하려면 게이트웨이 서버에 Claude Code v2.1.232 이상이 필요합니다. 이 키는 데스크톱 앱 고유의 키이며, Claude Code는 항목 형식이 다른 [동일한 이름의 자체 관리형 설정](https://code.claude.com/docs/ko/managed-mcp.md#provide-servers-through-managed-settings)을 읽습니다. |2054| `managedMcpServers` | 모든 사용자에게 MCP 서버 구성을 푸시합니다. 서드파티(3P) Desktop 배포에서만 사용할 수 있습니다. 각 항목에서 `"http"`, `"sse"`, `"stdio"` 중 하나의 전송 방식과 연결 세부 정보를 설정하고, 선택적으로 `toolPolicy` 맵을 설정하여 사용자가 호출할 수 있는 해당 서버의 도구를 제한합니다. 3P 배포는 관리자 콘솔 설정을 받지 않으므로 관리형 설정 파일, MDM 또는 Claude apps 게이트웨이 정책의 [`desktop` 블록](https://code.claude.com/docs/ko/claude-apps-gateway-config#claude-desktop-overlay)을 통해 전달하십시오. 게이트웨이를 통해 전달하려면 게이트웨이 서버에 Claude Code v2.1.232 이상이 필요합니다. 이 키는 데스크톱 앱 고유의 키이며, Claude Code는 항목 형식이 다른 [동일한 이름의 자체 관리형 설정](https://code.claude.com/docs/ko/managed-mcp.md#provide-servers-through-managed-settings)을 읽습니다. |

2046 2055 

2047컴퓨터의 [우선순위가 가장 높은 MDM 정책 또는 관리형 설정 파일](https://code.claude.com/docs/ko/managed-settings.md#how-claude-code-combines-managed-sources)에서 `browserExternalPageTools`, `disableMobileSimulatorTools` 또는 `disableBrowserExternalNavigation`으로 기능을 끄면, 해당 컴퓨터에서는 그 기능이 꺼진 상태로 유지됩니다. [서버 관리형 설정](https://code.claude.com/docs/ko/server-managed-settings.md)에서 해당 키를 설정하지 않거나 기능을 허용하더라도 꺼진 상태로 유지됩니다. 이 용도로 사용자 수준의 `HKCU` 레지스트리 값을 사용하지 마십시오. 기능을 다시 켜려면 값을 설정한 모든 위치에서 해당 값을 제거하십시오. Claude Desktop v4.4212.0 이상이 필요합니다.2056컴퓨터의 [우선순위가 가장 높은 MDM 정책 또는 관리형 설정 파일](https://code.claude.com/docs/ko/managed-settings.md#how-claude-code-combines-managed-sources)에서 다음 네 가지 키 중 하나로 기능을 끄면, 해당 컴퓨터에서는 그 기능이 꺼진 상태로 유지됩니다.

2057 

2058* **`browserExternalPageTools`, `disableMobileSimulatorTools`, `disableBrowserExternalNavigation`**: Claude Desktop v4.4212.0 이상이 필요합니다

2059* **`disableRemotePreviewScripts`**: Claude Desktop v5.1231.0 이상이 필요합니다

2060 

2061[서버 관리형 설정](https://code.claude.com/docs/ko/server-managed-settings.md)에서 해당 키를 설정하지 않거나 기능을 허용하더라도 꺼진 상태로 유지됩니다. 이 용도로 사용자 수준의 `HKCU` 레지스트리 값을 사용하지 마십시오. 기능을 다시 켜려면 값을 설정한 모든 위치에서 해당 값을 제거하십시오.

2048 2062 

2049Desktop 세션에 어떤 관리형 설정이 적용되는지는 해당 세션이 실행되는 위치에 따라 달라집니다. [`availableModels`](https://code.claude.com/docs/ko/model-config#restrict-model-selection)와 같은 모델 제한은 터미널 CLI와 동일한 방식으로 Desktop의 Claude Code 세션에 적용됩니다. [사용 환경별 적용 범위](https://code.claude.com/docs/ko/model-config.md#surface-coverage)를 참조하십시오.2063Desktop 세션에 어떤 관리형 설정이 적용되는지는 해당 세션이 실행되는 위치에 따라 달라집니다. [`availableModels`](https://code.claude.com/docs/ko/model-config#restrict-model-selection)와 같은 모델 제한은 터미널 CLI와 동일한 방식으로 Desktop의 Claude Code 세션에 적용됩니다. [사용 환경별 적용 범위](https://code.claude.com/docs/ko/model-config.md#surface-coverage)를 참조하십시오.

2050 2064 

2109>2123>

2110> 배포하기 전에 `forceLoginOrgUUID` 값을 확인하십시오. ID가 조직의 ID가 아니면, 조직 구성원은 해당 ID를 가진 조직에도 속해 있지 않는 한 Claude Desktop을 사용할 수 없습니다. 복구하려면 올바른 ID를 배포하고 구성원이 Claude Desktop을 다시 시작하도록 하십시오.2124> 배포하기 전에 `forceLoginOrgUUID` 값을 확인하십시오. ID가 조직의 ID가 아니면, 조직 구성원은 해당 ID를 가진 조직에도 속해 있지 않는 한 Claude Desktop을 사용할 수 없습니다. 복구하려면 올바른 ID를 배포하고 구성원이 Claude Desktop을 다시 시작하도록 하십시오.

2111 2125 

2112Claude Code의 [관리형 설정](https://code.claude.com/docs/ko/managed-settings.md)에서 `forceLoginMethod`와 `forceLoginOrgUUID`를 설정해도 Claude Desktop 로그인 화면은 변경되지 않습니다.2126Claude Code의 [관리형 설정](https://code.claude.com/docs/ko/managed-settings.md)에서 `forceLoginMethod`와 `forceLoginOrgUUID`를 설정해도 Claude Desktop 로그인 화면은 변경되지 않습니다. 사용자는 여전히 자신의 Claude API 키나 [Claude Console 계정](https://claude.com/docs/third-party/claude-desktop/claude-api#which-devices-offer-the-claude-api-account-sign-in)으로 Claude Desktop을 사용하고, 그 방식으로 Code 탭 세션을 실행할 수 있습니다.

2127 

2128이를 막으려면 Claude Desktop 정책(Windows에서는 `HKLM`)에도 claude.ai 조직 ID로 `forceLoginOrgUUID`를 배포하십시오. 정책 자체에서 [Claude API를 선택](https://claude.com/docs/third-party/claude-desktop/claude-api#choose-an-authentication-approach)하는 경우를 제외하고, Claude Desktop은 앱을 다음에 실행할 때부터 사용자 자신의 API 키나 Console 계정을 더 이상 사용하지 않습니다.

2129 

2130배포하기 전에 다음 두 가지 경우를 확인하십시오.

2131 

2132* **Claude Console 조직**: Claude Console 조직의 ID로 `forceLoginOrgUUID`만 단독으로 배포하지 마십시오. 그러면 조직 구성원이 Claude Desktop을 사용할 수 없게 됩니다. 대신 [Claude API 계정 로그인을 제공하는 기기](https://claude.com/docs/third-party/claude-desktop/claude-api#which-devices-offer-the-claude-api-account-sign-in)를 참조하십시오.

2133* **Enterprise Admin Console**: Enterprise Admin Console에서 컴퓨터의 Claude Desktop 구성을 전달하는 경우, 먼저 해당 컴퓨터를 Claude Desktop v2.37337.0 이상으로 업데이트하십시오. 이전 버전은 이 키가 설정되면 해당 구성을 무시하기 때문입니다. [기기를 관리 프로필에 유지](https://claude.com/docs/third-party/claude-desktop/admin-console#keep-a-device-on-its-managed-profile)를 참조하십시오.

2113 2134 

2114### 네트워크 액세스 요구 사항2135### 네트워크 액세스 요구 사항

2115 2136 

5466This conversation is already open in another running Claude session — use that one, or close it and try again5466This conversation is already open in another running Claude session — use that one, or close it and try again

5467```5467```

5468 5468 

5469* **`running in another terminal`**: 터미널이 대화를 보유합니다. 예를 들어 `claude --resume` 또는 `/resume`으로 재개한 터미널입니다. 행에는 `Open in a terminal`도 표시됩니다.5469* **`running in another terminal`**: 백그라운드 세션이 아닌 프로세스가 대화를 보유합니다. 예를 들어 `claude -p` 실행이나 `claude --resume` 또는 `/resume`으로 대화를 재개한 터미널입니다. 행에는 `Open in a terminal`도 표시됩니다.

5470* **`already open in another running Claude session`**: 다른 비대화형 Claude Code 프로세스가 이를 보유합니다. 예를 들어 같은 대화에 대한 [백그라운드 세션](https://code.claude.com/docs/ko/agent-view.md#the-supervisor-process) 프로세스가 아직 종료되지 않았습니다.5470* **`already open in another running Claude session`**: 다른 [백그라운드 세션](https://code.claude.com/docs/ko/agent-view.md#the-supervisor-process)이 대화를 보유합니다.

5471 5471 

5472**할 일:**5472**할 일:**

5473 5473 

5474* 열려 있는 프로세스에서 대화를 계속하거나 해당 프로세스를 종료하고 행을 다시 엽니다.5474* `running in another terminal`의 경우: 해당 터미널에서 계속하거나, 해당 프로세스를 종료하거나 완료될 때까지 기다린 다음 다시 시도합니다.

5475* `already open in another running Claude session`의 경우: 해당 세션을 사용하거나, 해당 세션을 중지한 다음 다시 시도합니다.

5475 5476 

5476v2.1.248 이전에는 `already open in another running Claude session` 거부만 존재했습니다: 터미널에서 재개된 대화는 열려 있는 것으로 계산되지 않았으며, 행을 열면 같은 대화에 쓰는 두 번째 Claude Code 프로세스가 시작되었습니다.5477v2.1.248 이전에는 `already open in another running Claude session` 거부만 존재했습니다: 터미널에서 재개된 대화는 열려 있는 것으로 계산되지 않았으며, 행을 열면 같은 대화에 쓰는 두 번째 Claude Code 프로세스가 시작되었습니다.

5477 5478 

98 98 

99* **Pro, Max 및 Ultra**: 사용량 크레딧에서 빠른 모드 비용을 지불합니다. claude.ai의 [**설정 > 사용**](https://claude.ai/settings/usage)으로 이동하면, **사용량 크레딧** 섹션에 이번 달 사용량 크레딧으로 얼마를 지출했는지 표시됩니다. 이 수치에는 빠른 모드가 포함되지만 별도로 분류되지 않습니다.99* **Pro, Max 및 Ultra**: 사용량 크레딧에서 빠른 모드 비용을 지불합니다. claude.ai의 [**설정 > 사용**](https://claude.ai/settings/usage)으로 이동하면, **사용량 크레딧** 섹션에 이번 달 사용량 크레딧으로 얼마를 지출했는지 표시됩니다. 이 수치에는 빠른 모드가 포함되지만 별도로 분류되지 않습니다.

100* **Team 및 Enterprise**: 조직이 사용 크레딧에서 빠른 모드 사용 비용을 지불합니다. 자신의 사용 크레딧 지출을 확인하려면 [`/usage`](https://code.claude.com/docs/ko/costs#check-your-usage-credits-spend)를 실행하십시오. 조직이 해당 지출을 확인하는 위치에 대해서는 [Claude for Teams and Enterprise](https://code.claude.com/docs/ko/costs.md#claude-for-teams-and-enterprise)를 참조하십시오.100* **Team 및 Enterprise**: 조직이 사용 크레딧에서 빠른 모드 사용 비용을 지불합니다. 자신의 사용 크레딧 지출을 확인하려면 [`/usage`](https://code.claude.com/docs/ko/costs#check-your-usage-credits-spend)를 실행하십시오. 조직이 해당 지출을 확인하는 위치에 대해서는 [Claude for Teams and Enterprise](https://code.claude.com/docs/ko/costs.md#claude-for-teams-and-enterprise)를 참조하십시오.

101* **Claude Console**: 조직이 나머지 API 사용과 함께 빠른 모드 비용을 지불합니다. Console [사용](https://platform.claude.com/usage) 및 [비용](https://platform.claude.com/cost) 페이지에서 **그룹화 기준** 메뉴의 \*\*속도 (리서치 프리뷰)\*\*를 선택하여 빠른 모드를 표준 속도 사용과 분리합니다. 선택한 날짜 범위에 빠른 모드 사용이 포함된 경우에만 해당 옵션이 표시됩니다.101* **Claude Console**: 조직이 나머지 API 사용과 함께 빠른 모드 비용을 지불합니다. Console [사용](https://platform.claude.com/usage) 및 [비용](https://platform.claude.com/cost) 페이지에서 **그룹화 기준** 메뉴의 **속도**를 선택하여 빠른 모드를 표준 속도 사용과 분리합니다. 선택한 날짜 범위에 빠른 모드 사용이 포함된 경우에만 해당 옵션이 표시됩니다.

102 102 

103## 빠른 모드 사용 시기 결정103## 빠른 모드 사용 시기 결정

104 104 

218 218 

219## Claude Code에 내장된 mod219## Claude Code에 내장된 mod

220 220 

221Claude Code의 일부 기능은 그 자체가 mod입니다. 현재 세션에 있는 mod를 확인하려면 Claude Code 프롬프트에서 `/plugin`을 실행하고 **Installed** 탭으로 이동합니다. 이 탭의 **Built-in** 아래에 해당 mod가 나열됩니다. 내장 mod는 업데이트하거나 제거할 수 없으며, 각 mod를 끄는 방법은 표의 마지막 열에 나와 있습니다. [`mods active` 줄](#see-which-mods-a-session-loaded)에는 내장 mod가 표시되지 않습니다.221Claude Code의 일부 기능은 그 자체가 mod입니다. 현재 세션에 있는 mod를 확인하려면 Claude Code 프롬프트에서 `/plugin`을 실행하고 **Installed** 탭으로 이동합니다. 이 탭의 **Built-in** 아래에 해당 mod가 나열됩니다. 내장 mod는 업데이트하거나 제거할 수 없습니다. [`mods active` 줄](#see-which-mods-a-session-loaded)에는 내장 mod가 표시되지 않습니다.

222 222 

223이 표는 각 항목을 `/plugin`에 표시되는 이름으로 나열합니다.223이 표는 **Built-in** 항목 중 일부를 `/plugin`에 표시되는 이름으로 나열합니다.

224 224 

225| `/plugin`에 표시되는 이름 | 기능 | 활성화되는 위치 | 끄는 방법 |225| `/plugin`에 표시되는 이름 | 기능 | 활성화되는 위치 | 끄는 방법 |

226| :- | :- | :- | :- |226| :- | :- | :- | :- |

231| `cc-plugin-telemetry` | Claude Code와 내장 mod가 로그에 기록하는 분석 레코드를 전송합니다 | Claude Code 자체 분석이 켜져 있는 모든 곳 | `/plugin`에서 비활성화하거나, 예를 들어 [`DISABLE_TELEMETRY`](https://code.claude.com/docs/ko/env-vars)로 분석을 끕니다 |231| `cc-plugin-telemetry` | Claude Code와 내장 mod가 로그에 기록하는 분석 레코드를 전송합니다 | Claude Code 자체 분석이 켜져 있는 모든 곳 | `/plugin`에서 비활성화하거나, 예를 들어 [`DISABLE_TELEMETRY`](https://code.claude.com/docs/ko/env-vars)로 분석을 끕니다 |

232| `cc-plugin-you-should-know` | [You should know](https://code.claude.com/docs/ko/interactive-mode.md#you-should-know-suggestions): 보조 에이전트가 사용자가 놓쳤을 수 있는 내용을 발견하면 프롬프트 위에 알림을 표시합니다 | [켜기](https://code.claude.com/docs/ko/interactive-mode.md#you-should-know-suggestions) 전까지는 꺼져 있습니다 | `/plugin`에서 비활성화합니다 |232| `cc-plugin-you-should-know` | [You should know](https://code.claude.com/docs/ko/interactive-mode.md#you-should-know-suggestions): 보조 에이전트가 사용자가 놓쳤을 수 있는 내용을 발견하면 프롬프트 위에 알림을 표시합니다 | [켜기](https://code.claude.com/docs/ko/interactive-mode.md#you-should-know-suggestions) 전까지는 꺼져 있습니다 | `/plugin`에서 비활성화합니다 |

233 233 

234표에 없는 **Built-in** 플러그인의 경우, [`/plugin`에서 해당 플러그인의 세부 정보를 열어](https://code.claude.com/docs/ko/plugins/install#manage-installed-plugins) 기능을 확인하거나 비활성화할 수 있습니다.

235 

234`disableAllHooks`, `--bare`, `--safe-mode`처럼 설치된 mod를 중지하는 설정과 플래그는 내장 mod를 중지하지 않습니다.236`disableAllHooks`, `--bare`, `--safe-mode`처럼 설치된 mod를 중지하는 설정과 플래그는 내장 mod를 중지하지 않습니다.

235 237 

236### 내장 mod의 소스 읽기238### 내장 mod의 소스 읽기

194| `session.receive` | `($, e) => ({ text: e.text })`. `$.session.receive({ origin: { kind: 'peer-send-message' }, text })`로 발생시킵니다. |194| `session.receive` | `($, e) => ({ text: e.text })`. `$.session.receive({ origin: { kind: 'peer-send-message' }, text })`로 발생시킵니다. |

195| `ui.render` | `() => ({ type: 'Text', props: {}, children: ['...'] })` |195| `ui.render` | `() => ({ type: 'Text', props: {}, children: ['...'] })` |

196 196 

197`expect`에는 `toBe`, `toEqual`, `toMatch`, `toMatchObject`, `toContain`, `toBeDefined`, `toBeUndefined`, `toThrow` 어설션이 있으며, 이들 앞에 `.not`을 붙일 수 있습니다.197### `expect`로 결과 확인하기

198 

199키트에는 다음 어설션이 있으며, 선택한 어설션은 `expect(answer.text).toBe('ok')`처럼 확인할 값 뒤에 붙입니다.

200 

201* **동등성**: 같은 값 또는 객체에는 `toBe`, 구조에는 `toEqual`, 구조와 함께 `undefined` 필드 및 프로토타입까지 확인하려면 `toStrictEqual`, 지정한 필드만 확인하려면 `toMatchObject`

202* **텍스트**: 정규 표현식이나 부분 문자열을 받는 `toMatch`, `toStartWith`, `toEndWith`

203* **숫자**: `toBeGreaterThan`, `toBeGreaterThanOrEqual`, `toBeLessThan`, `toBeLessThanOrEqual`

204* **포함 내용**: 부분 문자열이나 멤버에는 `toContain`, 구조로 비교하는 멤버에는 `toContainEqual`, 그리고 `toHaveLength`, `toHaveProperty`

205* **존재 여부와 타입**: `toBeDefined`, `toBeUndefined`, `toBeNull`, `toBeTruthy`, `toBeFalsy`, `toBeNaN`, `toBeInstanceOf`

206* **예외 발생**: `expect`가 호출하는 함수 또는 `.rejects`로 확인하는 프로미스에 대한 `toThrow`

207 

208반대 조건을 확인하려면 어설션 앞에 `.not`을 붙이고, 프로미스가 어떤 값으로 처리되는지 확인하려면 `.resolves`나 `.rejects`를 붙입니다.

198 209 

199비동기 제너레이터가 아닌 일반 함수로 `on`에 전달한 스텁이나 훅 안에서 `expect`가 실패하면 테스트가 실패합니다. 엔진은 해당 훅을 건너뛰며, 실패 출력에는 `in the test's store.set hook`처럼 그 훅의 이름이 표시됩니다.210비동기 제너레이터가 아닌 일반 함수로 `on`에 전달한 스텁이나 훅 안에서 `expect`가 실패하면 테스트가 실패합니다. 엔진은 해당 훅을 건너뛰며, 실패 출력에는 `in the test's store.set hook`처럼 그 훅의 이름이 표시됩니다.

200 211 

26| 프로젝트 컨텍스트 | CLAUDE.md, 자동 메모리, 범위 미지정 규칙 | 세션 시작 후 또는 `/clear` 또는 `/compact` 후 |26| 프로젝트 컨텍스트 | CLAUDE.md, 자동 메모리, 범위 미지정 규칙 | 세션 시작 후 또는 `/clear` 또는 `/compact` 후 |

27| 대화 | 사용자 메시지, Claude의 응답, 도구 결과 | 매 턴마다 |27| 대화 | 사용자 메시지, Claude의 응답, 도구 결과 | 매 턴마다 |

28 28 

29대화 계층의 변경은 시스템 프롬프트와 프로젝트 컨텍스트를 캐시된 상태로 유지합니다. 시스템 프롬프트의 변경은 모든 것을 무효화합니다. 왜냐하면 이제 모든 이후 콘텐츠가 다른 프리픽스 뒤에 있기 때문입니다. 세 번째 열은 완전한 목록이 아닌 일반적인 트리거를 제공하며, 아래 섹션에서 전체 집합을 다룹니다.29대화 계층에 내용이 추가되어도 시스템 프롬프트와 프로젝트 컨텍스트는 캐시된 상태로 유지됩니다. 시스템 프롬프트의 변경은 모든 것을 무효화합니다. 왜냐하면 이제 모든 이후 콘텐츠가 다른 프리픽스 뒤에 있기 때문입니다. 세 번째 열은 완전한 목록이 아닌 일반적인 트리거를 제공하며, 아래 섹션에서 전체 집합을 다룹니다.

30 30 

31프리픽스 일치 규칙은 이 페이지의 대부분의 동작을 설명합니다. 예를 들어 [플랜 모드](https://code.claude.com/docs/ko/permission-modes.md#analyze-before-you-edit-with-plan-mode)와 [스킬 로딩](https://code.claude.com/docs/ko/skills.md)은 지침을 대화 메시지로 추가하므로 캐시된 프리픽스는 그대로 유지됩니다.31프리픽스 일치 규칙은 이 페이지의 대부분의 동작을 설명합니다. 예를 들어 [플랜 모드](https://code.claude.com/docs/ko/permission-modes.md#analyze-before-you-edit-with-plan-mode)와 [스킬 로딩](https://code.claude.com/docs/ko/skills.md)은 지침을 대화 메시지로 추가하므로 캐시된 프리픽스는 그대로 유지됩니다.

32 32 

174 174 

175### 대화 압축175### 대화 압축

176 176 

177[압축](https://code.claude.com/docs/ko/context-window.md#what-survives-compaction)은 메시지 기록을 요약으로 바꿉니다. 설계상 이는 대화 레이어를 무효화합니다. 다음 요청에는 이전 것과 접두사를 공유하지 않는 새로운 더 짧은 기록이 있기 때문입니다. 시스템 프롬프트 레이어와 프로젝트 컨텍스트 레이어는 캐시된 상태로 유지될 수 있습니다.177[압축](https://code.claude.com/docs/ko/context-window.md#what-survives-compaction)은 메시지 기록을 요약으로 바꿉니다. 설계상 이는 대화 레이어를 무효화합니다. 다음 요청에는 이전 것과 접두사를 공유하지 않는 새로운 더 짧은 기록이 있기 때문입니다.

178 178 

179* **시스템 프롬프트**: [재개된 대화](#resuming-a-session)가 현재는 오래된 시스템 프롬프트를 유지하고 있는 경우가 아니라면 다음 요청은 캐시에서 이 레이어를 읽습니다. 해당 대화가 처음 압축될 때 Claude Code는 이를 현재 프롬프트로 전환하며, 다음 요청은 이 레이어의 캐시를 한 번 다시 빌드합니다.179* **시스템 프롬프트**: [재개된 대화](#resuming-a-session)가 현재는 오래된 시스템 프롬프트를 유지하고 있는 경우가 아니라면 다음 요청은 캐시에서 이 레이어를 읽습니다. 해당 대화가 처음 압축될 때 Claude Code는 이를 현재 프롬프트로 전환하며, 다음 요청은 이 레이어의 캐시를 한 번 다시 빌드합니다.

180* **프로젝트 컨텍스트**: Claude Code는 디스크에서 이 레이어를 다시 로드합니다. 다음 요청은 세션 시작 이후 CLAUDE.md 및 메모리가 변경되지 않은 경우에만 캐시에서 이 레이어를 읽습니다.180* **프로젝트 컨텍스트**: Claude Code는 디스크에서 이 레이어를 다시 로드합니다. 이 레이어는 대화와 함께 캐시되므로 `/compact` 또는 자동 압축 후에는 파일이 변경되지 않았더라도 캐시가 다시 빌드됩니다.

181 181 

182요약을 생성하기 위해 Claude Code는 별도의 요청을 보냅니다. 이 요청은 대화의 시스템 프롬프트, 도구, 요약 대상 기록을 반복하며, 요약 지침으로 끝납니다. 캐시가 따뜻한 동안 해당 요청은 캐시에서 접두사를 읽습니다. 그러면 세션 중간 `/compact`는 컨텍스트 크기가 제안하는 것의 일부 비용만 들고 대부분의 시간을 요약 생성에 소비합니다.182요약을 생성하기 위해 Claude Code는 별도의 요청을 보냅니다. 이 요청은 대화의 시스템 프롬프트, 도구, 요약 대상 기록을 반복하며, 요약 지침으로 끝납니다. 캐시가 따뜻한 동안 해당 요청은 캐시에서 접두사를 읽습니다. 그러면 세션 중간 `/compact`는 컨텍스트 크기가 제안하는 것의 일부 비용만 들고 대부분의 시간을 요약 생성에 소비합니다.

183 183 

184[캐시 수명](#cache-lifetime)보다 긴 휴식 후에는 읽을 캐시가 남아 있지 않으므로 요약 요청은 해당 기록을 캐시되지 않은 입력으로 다시 처리합니다. 이것이 [이전 세션을 재개](https://code.claude.com/docs/ko/sessions.md#resume-a-session)할 때 `/compact`의 비용이 가장 많이 드는 이유입니다. 따뜻한 경우와 차가운 경우 모두에서 압축 후 턴은 훨씬 더 짧은 요약에 대해서만 대화 캐시를 다시 빌드하므로 해당 턴이 느린 부분이 아닙니다.184[캐시 수명](#cache-lifetime)보다 긴 휴식 후에는 읽을 캐시가 남아 있지 않으므로 요약 요청은 해당 기록을 캐시되지 않은 입력으로 다시 처리합니다. 이것이 [이전 세션을 재개](https://code.claude.com/docs/ko/sessions.md#resume-a-session)할 때 `/compact`의 비용이 가장 많이 드는 이유입니다. 따뜻한 경우와 차가운 경우 모두에서 압축 후 턴은 훨씬 더 짧은 기록에 대해서만 대화 캐시를 다시 빌드하므로 해당 턴이 느린 부분이 아닙니다.

185 185 

186> [!TIP]186> [!TIP]

187>187>

31>31>

32> **macOS, Linux, WSL:**32> **macOS, Linux, WSL:**

33>33>

34> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}34> ```bash theme={null}

35> curl -fsSL https://claude.ai/install.sh | bash35> curl -fsSL https://claude.ai/install.sh | bash

36> ```36> ```

37>37>

39>39>

40> **Windows PowerShell:**40> **Windows PowerShell:**

41>41>

42> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}42> ```powershell theme={null}

43> irm https://claude.ai/install.ps1 | iex43> irm https://claude.ai/install.ps1 | iex

44> ```44> ```

45>45>

46> **Windows CMD:**46> **Windows CMD:**

47>47>

48> ```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}48> ```batch theme={null}

49> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd49> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

50> ```50> ```

51>51>

63 63 

64> [tab] Homebrew64> [tab] Homebrew

65>65>

66> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}66> ```bash theme={null}

67> brew install --cask claude-code67> brew install --cask claude-code

68> ```68> ```

69>69>

75 75 

76> [tab] WinGet76> [tab] WinGet

77>77>

78> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}78> ```powershell theme={null}

79> winget install Anthropic.ClaudeCode79> winget install Anthropic.ClaudeCode

80> ```80> ```

81>81>

86| [`disabledMcpjsonServers`](#disabledmcpjsonservers) | 프로젝트의 [`.mcp.json`](https://code.claude.com/docs/ko/mcp#project-scope)에서 특정 서버를 거부합니다 | MCP | 모든 파일 |86| [`disabledMcpjsonServers`](#disabledmcpjsonservers) | 프로젝트의 [`.mcp.json`](https://code.claude.com/docs/ko/mcp#project-scope)에서 특정 서버를 거부합니다 | MCP | 모든 파일 |

87| [`disableMobileSimulatorTools`](#disablemobilesimulatortools) | [데스크톱](https://code.claude.com/docs/ko/desktop.md) iOS Simulator 창에서 Claude의 도구를 차단합니다 | 도구 | 관리형 |87| [`disableMobileSimulatorTools`](#disablemobilesimulatortools) | [데스크톱](https://code.claude.com/docs/ko/desktop.md) iOS Simulator 창에서 Claude의 도구를 차단합니다 | 도구 | 관리형 |

88| [`disableRemoteControl`](#disableremotecontrol) | [Remote Control](https://code.claude.com/docs/ko/remote-control.md)을 시작할 수 있는 모든 곳에서 끕니다 | 원격, 데스크톱 및 알림 | 모든 파일 |88| [`disableRemoteControl`](#disableremotecontrol) | [Remote Control](https://code.claude.com/docs/ko/remote-control.md)을 시작할 수 있는 모든 곳에서 끕니다 | 원격, 데스크톱 및 알림 | 모든 파일 |

89| [`disableRemotePreviewScripts`](#disableremotepreviewscripts) | SSH 및 WSL 세션에서 [데스크톱](https://code.claude.com/docs/ko/desktop.md#preview-html-files-in-ssh-and-wsl-sessions) 앱의 HTML 미리보기 내 스크립트를 끕니다 | 원격, 데스크톱 및 알림 | 관리형 |

89| [`disableSideloadFlags`](#disablesideloadflags) | [플러그인](https://code.claude.com/docs/ko/plugins/overview.md), [서브에이전트](https://code.claude.com/docs/ko/sub-agents.md), [MCP 서버](https://code.claude.com/docs/ko/mcp.md)를 사이드로드하는 CLI 플래그를 거부합니다 | 엔터프라이즈 및 관리형 설정 | 관리형 |90| [`disableSideloadFlags`](#disablesideloadflags) | [플러그인](https://code.claude.com/docs/ko/plugins/overview.md), [서브에이전트](https://code.claude.com/docs/ko/sub-agents.md), [MCP 서버](https://code.claude.com/docs/ko/mcp.md)를 사이드로드하는 CLI 플래그를 거부합니다 | 엔터프라이즈 및 관리형 설정 | 관리형 |

90| [`disableSkillShellExecution`](#disableskillshellexecution) | [스킬](https://code.claude.com/docs/ko/skills.md)과 사용자 지정 명령이 인라인 셸을 실행하지 않도록 합니다 | 플러그인 및 스킬 | 모든 파일 |91| [`disableSkillShellExecution`](#disableskillshellexecution) | [스킬](https://code.claude.com/docs/ko/skills.md)과 사용자 지정 명령이 인라인 셸을 실행하지 않도록 합니다 | 플러그인 및 스킬 | 모든 파일 |

91| [`disableWorkflows`](#disableworkflows) | 모든 사용자의 [동적 워크플로](https://code.claude.com/docs/ko/workflows.md)를 끕니다. 본인에게만 적용하려면 `enableWorkflows`를 사용합니다 | 훅 및 자동화 | 모든 파일 |92| [`disableWorkflows`](#disableworkflows) | 모든 사용자의 [동적 워크플로](https://code.claude.com/docs/ko/workflows.md)를 끕니다. 본인에게만 적용하려면 `enableWorkflows`를 사용합니다 | 훅 및 자동화 | 모든 파일 |

147| [`permissions.blockWritesOutsideWorkingDirectories`](#permissions-blockwritesoutsideworkingdirectories) | 모든 권한 모드에서 `Write`, `Edit`, `NotebookEdit` 도구가 [작업 디렉터리](https://code.claude.com/docs/ko/permissions.md#working-directories) 외부의 경로를 거부하도록 합니다. 단, [Claude Code 자체 파일 일부](#what-the-write-block-refuses-and-what-stays-writable)는 예외입니다 | 권한 설정 | 모든 파일 |148| [`permissions.blockWritesOutsideWorkingDirectories`](#permissions-blockwritesoutsideworkingdirectories) | 모든 권한 모드에서 `Write`, `Edit`, `NotebookEdit` 도구가 [작업 디렉터리](https://code.claude.com/docs/ko/permissions.md#working-directories) 외부의 경로를 거부하도록 합니다. 단, [Claude Code 자체 파일 일부](#what-the-write-block-refuses-and-what-stays-writable)는 예외입니다 | 권한 설정 | 모든 파일 |

148| [`permissions.defaultMode`](#permissions-defaultmode) | 새 세션의 기본 [권한 모드](https://code.claude.com/docs/ko/permission-modes.md#which-mode-a-session-starts-in)를 설정합니다 | 권한 설정 | 모든 파일 |149| [`permissions.defaultMode`](#permissions-defaultmode) | 새 세션의 기본 [권한 모드](https://code.claude.com/docs/ko/permission-modes.md#which-mode-a-session-starts-in)를 설정합니다 | 권한 설정 | 모든 파일 |

149| [`permissions.deny`](#permissions-deny) | 비밀 정보가 담긴 파일 읽기를 포함하여 나열된 [도구 사용](https://code.claude.com/docs/ko/permissions.md#permission-rule-syntax)을 차단합니다 | 권한 설정 | 모든 파일 |150| [`permissions.deny`](#permissions-deny) | 비밀 정보가 담긴 파일 읽기를 포함하여 나열된 [도구 사용](https://code.claude.com/docs/ko/permissions.md#permission-rule-syntax)을 차단합니다 | 권한 설정 | 모든 파일 |

151| [`permissions.denyInsteadOfPrompting`](#permissions-denyinsteadofprompting) | [권한 프롬프트](https://code.claude.com/docs/ko/permissions.md#permission-system)를 기다리게 될 도구 호출을 거부하여, 아무도 지켜보지 않는 세션이 계속 작업하도록 합니다 | 권한 설정 | 사용자 또는 관리형 |

150| [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | 누구도 [bypassPermissions 모드](https://code.claude.com/docs/ko/permission-modes.md#skip-all-checks-with-bypasspermissions-mode)에 진입하지 못하도록 합니다 | 권한 설정 | 모든 파일 |152| [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | 누구도 [bypassPermissions 모드](https://code.claude.com/docs/ko/permission-modes.md#skip-all-checks-with-bypasspermissions-mode)에 진입하지 못하도록 합니다 | 권한 설정 | 모든 파일 |

151| [`plansDirectory`](#plansdirectory) | [플랜 모드](https://code.claude.com/docs/ko/permission-modes.md#analyze-before-you-edit-with-plan-mode)가 플랜 파일을 작성할 위치를 선택합니다 | 메모리 및 컨텍스트 | 모든 파일 |153| [`plansDirectory`](#plansdirectory) | [플랜 모드](https://code.claude.com/docs/ko/permission-modes.md#analyze-before-you-edit-with-plan-mode)가 플랜 파일을 작성할 위치를 선택합니다 | 메모리 및 컨텍스트 | 모든 파일 |

152| [`pluginConfigs`](#pluginconfigs) | [플러그인](https://code.claude.com/docs/ko/plugins/overview.md) 구성 대화상자에 입력한 답변을 저장합니다 | 플러그인 및 스킬 | 사용자 또는 관리형 |154| [`pluginConfigs`](#pluginconfigs) | [플러그인](https://code.claude.com/docs/ko/plugins/overview.md) 구성 대화상자에 입력한 답변을 저장합니다 | 플러그인 및 스킬 | 사용자 또는 관리형 |

228| [`statusLine`](#statusline) | 직접 지정한 명령을 실행하여 프롬프트 아래에 [상태줄](https://code.claude.com/docs/ko/statusline.md)을 렌더링합니다 | 인터페이스 및 터미널 | 모든 파일 |230| [`statusLine`](#statusline) | 직접 지정한 명령을 실행하여 프롬프트 아래에 [상태줄](https://code.claude.com/docs/ko/statusline.md)을 렌더링합니다 | 인터페이스 및 터미널 | 모든 파일 |

229| [`strictKnownMarketplaces`](#strictknownmarketplaces) | 사용자가 추가하고 설치할 수 있는 [마켓플레이스](https://code.claude.com/docs/ko/plugins/overview.md) 소스를 허용 목록으로 지정합니다 | 플러그인 및 스킬 | 관리형 |231| [`strictKnownMarketplaces`](#strictknownmarketplaces) | 사용자가 추가하고 설치할 수 있는 [마켓플레이스](https://code.claude.com/docs/ko/plugins/overview.md) 소스를 허용 목록으로 지정합니다 | 플러그인 및 스킬 | 관리형 |

230| [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | 사용자 및 프로젝트 소스의 [스킬](https://code.claude.com/docs/ko/skills.md), [에이전트](https://code.claude.com/docs/ko/sub-agents.md), [훅](https://code.claude.com/docs/ko/hooks.md), [MCP 서버](https://code.claude.com/docs/ko/mcp.md)를 차단합니다 | 플러그인 및 스킬 | 관리형 |232| [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | 사용자 및 프로젝트 소스의 [스킬](https://code.claude.com/docs/ko/skills.md), [에이전트](https://code.claude.com/docs/ko/sub-agents.md), [훅](https://code.claude.com/docs/ko/hooks.md), [MCP 서버](https://code.claude.com/docs/ko/mcp.md)를 차단합니다 | 플러그인 및 스킬 | 관리형 |

231| [`strictPluginOnlyCustomization.agents`](#strictpluginonlycustomization-agents) | [에이전트](https://code.claude.com/docs/ko/sub-agents.md)를 플러그인 및 관리형 소스로 제한합니다 | 플러그인 및 스킬 | 관리형 |233| [`strictPluginOnlyCustomization.agents`](#strictpluginonlycustomization-agents) | 사용자 및 프로젝트 소스의 [에이전트](https://code.claude.com/docs/ko/sub-agents.md)를 차단합니다 | 플러그인 및 스킬 | 관리형 |

232| [`strictPluginOnlyCustomization.hooks`](#strictpluginonlycustomization-hooks) | [훅](https://code.claude.com/docs/ko/hooks.md)을 플러그인 및 관리형 소스로 제한합니다 | 플러그인 및 스킬 | 관리형 |234| [`strictPluginOnlyCustomization.hooks`](#strictpluginonlycustomization-hooks) | 사용자 및 프로젝트 소스의 [훅](https://code.claude.com/docs/ko/hooks.md)을 차단합니다 | 플러그인 및 스킬 | 관리형 |

233| [`strictPluginOnlyCustomization.mcp`](#strictpluginonlycustomization-mcp) | [MCP 서버](https://code.claude.com/docs/ko/mcp.md)를 플러그인 및 관리형 소스로 제한합니다 | 플러그인 및 스킬 | 관리형 |235| [`strictPluginOnlyCustomization.mcp`](#strictpluginonlycustomization-mcp) | 사용자 및 프로젝트 소스의 [MCP 서버](https://code.claude.com/docs/ko/mcp.md)를 차단합니다 | 플러그인 및 스킬 | 관리형 |

234| [`strictPluginOnlyCustomization.skills`](#strictpluginonlycustomization-skills) | [스킬](https://code.claude.com/docs/ko/skills.md)을 플러그인 및 관리형 소스로 제한합니다 | 플러그인 및 스킬 | 관리형 |236| [`strictPluginOnlyCustomization.skills`](#strictpluginonlycustomization-skills) | 사용자 및 프로젝트 소스의 [스킬](https://code.claude.com/docs/ko/skills.md)을 차단합니다 | 플러그인 및 스킬 | 관리형 |

235| [`subagentPromptCacheTtl`](#subagentpromptcachettl) | 서브에이전트 및 기본 대화 외부의 기타 요청에 대한 [프롬프트 캐시 수명](https://code.claude.com/docs/ko/prompt-caching.md#cache-lifetime)을 선택합니다 | 모델 및 응답 | 모든 파일 |237| [`subagentPromptCacheTtl`](#subagentpromptcachettl) | 서브에이전트 및 기본 대화 외부의 기타 요청에 대한 [프롬프트 캐시 수명](https://code.claude.com/docs/ko/prompt-caching.md#cache-lifetime)을 선택합니다 | 모델 및 응답 | 모든 파일 |

236| [`subagentStatusLine`](#subagentstatusline) | 직접 지정한 명령으로 [서브에이전트](https://code.claude.com/docs/ko/sub-agents.md) 작업 표시의 행을 다시 작성합니다 | 인터페이스 및 터미널 | 모든 파일 |238| [`subagentStatusLine`](#subagentstatusline) | 직접 지정한 명령으로 [서브에이전트](https://code.claude.com/docs/ko/sub-agents.md) 작업 표시의 행을 다시 작성합니다 | 인터페이스 및 터미널 | 모든 파일 |

237| [`switchModelsOnFlag`](#switchmodelsonflag) | [안전 분류기](https://code.claude.com/docs/ko/model-config.md#ask-before-switching)가 요청에 플래그를 지정하면 모델을 자동으로 전환하거나 일시 중지합니다 | 모델 및 응답 | 모든 파일 |239| [`switchModelsOnFlag`](#switchmodelsonflag) | [안전 분류기](https://code.claude.com/docs/ko/model-config.md#ask-before-switching)가 요청에 플래그를 지정하면 모델을 자동으로 전환하거나 일시 중지합니다 | 모델 및 응답 | 모든 파일 |

288}290}

289```291```

290 292 

291이 키는 Amazon Bedrock 및 Claude Platform on AWS처럼 advisor를 [사용할 수 없는](https://code.claude.com/docs/ko/advisor.md#requirements) 공급자에서는 효과가 없습니다. `"fable"`에는 [Fable 액세스](https://code.claude.com/docs/ko/advisor.md#choose-an-advisor-model)가 필요합니다.293이 키는 Amazon Bedrock처럼 advisor를 [사용할 수 없는](https://code.claude.com/docs/ko/advisor.md#requirements) 공급자에서는 효과가 없습니다. Claude Platform on AWS에서는 이 키에 Claude Code v2.1.300 이상이 필요합니다. `"fable"`에는 [Fable 액세스](https://code.claude.com/docs/ko/advisor.md#choose-an-advisor-model)가 필요합니다.

292 294 

293### `alwaysThinkingEnabled`295### `alwaysThinkingEnabled`

294 296 

448 450 

449사용 가능한 세션에서 [빠른 모드](https://code.claude.com/docs/ko/fast-mode.md)를 켭니다. 토큰당 비용이 더 높더라도 속도가 필요한 빠른 반복이나 실시간 디버깅 같은 대화형 작업에 적합합니다. 일반적으로 이 키를 직접 편집하지 않습니다. `/fast`를 실행하면 `~/.claude/settings.json`에 `fastMode: true`가 기록되고, 다시 실행하여 빠른 모드를 끄면 키가 제거됩니다.451사용 가능한 세션에서 [빠른 모드](https://code.claude.com/docs/ko/fast-mode.md)를 켭니다. 토큰당 비용이 더 높더라도 속도가 필요한 빠른 반복이나 실시간 디버깅 같은 대화형 작업에 적합합니다. 일반적으로 이 키를 직접 편집하지 않습니다. `/fast`를 실행하면 `~/.claude/settings.json`에 `fastMode: true`가 기록되고, 다시 실행하여 빠른 모드를 끄면 키가 제거됩니다.

450 452 

451빠른 모드는 Fable 5.2, Opus 5.5, Opus 5, Opus 4.8에서만 지원됩니다. 다른 모델에서 `/fast`를 실행하면 Opus로 전환되며, 지원되지 않는 모델로 전환하면 빠른 모드가 꺼집니다. [빠른 모드가 켜진 상태에서 모델 전환](https://code.claude.com/docs/ko/fast-mode.md#switch-models-while-fast-mode-is-on)을 참조하세요.453Anthropic API에서는 Fable 5.2, Opus 5.5, Opus 5, Opus 4.8만 빠른 모드를 지원합니다. 다른 모델에서 `/fast`를 실행하면 Opus로 전환되며, 지원되지 않는 모델로 전환하면 빠른 모드가 꺼집니다. [빠른 모드가 켜진 상태에서 모델 전환](https://code.claude.com/docs/ko/fast-mode.md#switch-models-while-fast-mode-is-on)을 참조하세요. Google Cloud의 Agent Platform에서는 대신 [`/fast`가 Fable 5.2로 전환하며](https://code.claude.com/docs/ko/fast-mode#use-fast-mode-on-agent-platform) 이 키를 기록하지 않고, Claude Code는 저장된 `true`를 무시합니다.

452 454 

453* **범위**: [`Any file`](#scopes)455* **범위**: [`Any file`](#scopes)

454* **유형**: Boolean456* **유형**: Boolean

904Claude가 묻지 않고 사용할 수 있는 도구, 확인을 요청하는 도구, 차단되는 도구를 제어합니다. 또한 새 세션의 기본 [권한 모드](https://code.claude.com/docs/ko/permission-modes.md)를 설정합니다. 아래의 모든 `permissions.*` 키는 이 객체 아래에 중첩됩니다.906Claude가 묻지 않고 사용할 수 있는 도구, 확인을 요청하는 도구, 차단되는 도구를 제어합니다. 또한 새 세션의 기본 [권한 모드](https://code.claude.com/docs/ko/permission-modes.md)를 설정합니다. 아래의 모든 `permissions.*` 키는 이 객체 아래에 중첩됩니다.

905 907 

906* **범위**: [`Any file`](#scopes)908* **범위**: [`Any file`](#scopes)

907* **타입**: `allow`, `ask`, `deny`, `additionalDirectories`, `blockReadsOutsideWorkingDirectories`, `blockWritesOutsideWorkingDirectories`, `defaultMode`, `disableBypassPermissionsMode`, `disableAutoMode`를 포함하는 객체909* **타입**: `allow`, `ask`, `deny`, `additionalDirectories`, `blockReadsOutsideWorkingDirectories`, `blockWritesOutsideWorkingDirectories`, `defaultMode`, `denyInsteadOfPrompting`, `disableBypassPermissionsMode`, `disableAutoMode`를 포함하는 객체

908* **기본값**: 설정되지 않음910* **기본값**: 설정되지 않음

909 911 

910이 예시는 `npm run` 명령을 묻지 않고 승인하고, `git push` 전에 확인을 요청하며, `.env` 읽기를 차단하고, 세션을 `acceptEdits`로 시작합니다.912이 예시는 `npm run` 명령을 묻지 않고 승인하고, `git push` 전에 확인을 요청하며, `.env` 읽기를 차단하고, 세션을 `acceptEdits`로 시작합니다.

1163 1165 

1164권한 규칙은 모든 모드 위에 적용됩니다. `deny` 규칙은 `bypassPermissions`를 포함한 모든 모드에서 차단합니다. [권한 모드](https://code.claude.com/docs/ko/permission-modes.md)를 참조하십시오. 클라우드 세션에서 Claude Code는 이 키의 값 중 `acceptEdits`, `plan`, `default`, `auto`만 따릅니다. VS Code 확장이 시작하는 대화의 경우 [확장이 시작 권한 모드로 읽는 설정](https://code.claude.com/docs/ko/permission-modes.md#switch-permission-modes)을 참조하십시오.1166권한 규칙은 모든 모드 위에 적용됩니다. `deny` 규칙은 `bypassPermissions`를 포함한 모든 모드에서 차단합니다. [권한 모드](https://code.claude.com/docs/ko/permission-modes.md)를 참조하십시오. 클라우드 세션에서 Claude Code는 이 키의 값 중 `acceptEdits`, `plan`, `default`, `auto`만 따릅니다. VS Code 확장이 시작하는 대화의 경우 [확장이 시작 권한 모드로 읽는 설정](https://code.claude.com/docs/ko/permission-modes.md#switch-permission-modes)을 참조하십시오.

1165 1167 

1168### `permissions.denyInsteadOfPrompting`

1169 

1170권한 프롬프트에 응답할 사람이 없을 때도 세션이 계속 실행되도록 하려면 이 값을 `true`로 설정하십시오. Claude Code는 원래 프롬프트를 기다릴 도구 호출을 거부하고 턴을 계속 진행합니다. Claude Code v2.1.319 이상이 필요합니다.

1171 

1172허용 규칙, [권한 모드](https://code.claude.com/docs/ko/permission-modes.md) 또는 자동 모드 분류기가 승인하면 호출이 진행됩니다. 원래 확인을 요청할 호출 대부분을 허용하려면 [`PermissionRequest` 훅](https://code.claude.com/docs/ko/hooks#permissionrequest)에서 응답하십시오.

1173 

1174* **범위**: [`User or managed`](#scopes) 및 `--settings`. 저장소는 사용자를 대신해 이를 설정할 수 없습니다.

1175* **타입**: Boolean

1176 * `true`: Claude Code가 원래 확인을 요청할 호출을 거부합니다

1177 * `false`: 설정되지 않은 경우와 동일합니다. 이러한 소스 중 다른 소스가 `true`를 설정하면 호출은 계속 거부됩니다

1178* **기본값**: 설정되지 않음. 따라서 승인이 필요한 호출은 확인을 요청합니다

1179 

1180`~/.claude/settings.json`에 두는 이 예시는 세션을 자동 모드로 시작하고, 그래도 프롬프트로 넘어갈 호출은 모두 거부합니다.

1181 

1182```json settings.json theme={null}

1183{

1184 "permissions": {

1185 "defaultMode": "auto",

1186 "denyInsteadOfPrompting": true

1187 }

1188}

1189```

1190 

1191이 키는 `-p` 실행, 대화형 터미널 세션, [VS Code 확장](https://code.claude.com/docs/ko/vs-code.md), [Desktop 앱](https://code.claude.com/docs/ko/desktop.md)의 로컬 세션, [서브에이전트](https://code.claude.com/docs/ko/sub-agents.md), [에이전트 팀](https://code.claude.com/docs/ko/agent-teams.md)에 적용됩니다. 대신 단일 [비대화형](https://code.claude.com/docs/ko/headless.md) 실행에서만 확인을 요청할 호출을 거부하려면 `-p`와 함께 [`--permission-prompts none`](https://code.claude.com/docs/ko/headless#turn-off-permission-prompts-in-unattended-runs)을 전달하십시오.

1192 

1193#### `denyInsteadOfPrompting`이 추가로 중지하는 항목

1194 

1195이 설정이 켜져 있으면 Claude Code는 응답을 요구하는 다음 요청도 중지합니다.

1196 

1197* **질문 및 플랜 도구**: Claude Code는 [`AskUserQuestion`](https://code.claude.com/docs/ko/tools-reference#askuserquestion-tool-behavior), `EnterPlanMode`, `ExitPlanMode`를 제외하므로 플랜 모드의 세션은 스스로 플랜 모드를 벗어날 수 없습니다. 에이전트 팀의 팀원은 `EnterPlanMode` 및 `ExitPlanMode`를 유지합니다

1198* **MCP elicitation**: [`Elicitation` 훅](https://code.claude.com/docs/ko/hooks#elicitation)이 응답하지 않는 한 Claude Code는 [elicitation 요청](https://code.claude.com/docs/ko/mcp.md#respond-to-mcp-elicitation-requests)을 취소합니다

1199* **권한 호스트**: Claude Code는 [`canUseTool` 콜백](https://code.claude.com/docs/ko/agent-sdk/user-input) 또는 [`--permission-prompt-tool`](https://code.claude.com/docs/ko/cli-reference#cli-flags)에 묻지 않습니다. 코드에서 호출을 승인하려면 `PermissionRequest` 훅에서 응답하십시오. 어떤 확인 규칙도 적용되지 않는 `auto` 모드의 [중요 경로 제거](https://code.claude.com/docs/ko/permission-modes.md#critical-path-removals-in-each-permission-mode)처럼 일부 호출은 훅에 묻기 전에 거부됩니다.

1200* **분류기 청구 알림**: [청구되는 분류기 요청에 대한 알림](https://code.claude.com/docs/ko/auto-mode-classifier-billing.md)이 대화 상자를 열게 되는 경우, Claude Code는 이를 표시하지 않고 해당 요청이 필요한 작업을 거부합니다

1201 

1202세션은 여전히 [워크스페이스 신뢰 대화 상자](https://code.claude.com/docs/ko/permissions.md#project-allow-rules-and-workspace-trust)와 [프로젝트 MCP 서버 승인](https://code.claude.com/docs/ko/mcp.md#project-server-approvals-and-workspace-trust)에서 대기할 수 있습니다. 세션을 실행 상태로 두기 전에 두 가지 모두에 응답하십시오.

1203 

1204#### `denyInsteadOfPrompting`의 메시지

1205 

1206이러한 메시지는 거부된 호출을 보고합니다. 프롬프트가 아니므로 사용자의 응답을 기다리지 않습니다.

1207 

1208Claude가 읽는 거부 메시지는 다음 텍스트로 시작할 수 있습니다.

1209 

1210```text theme={null}

1211Permission for this tool use was denied. It requires approval, and this session has no approval surface

1212```

1213 

1214`stream-json` 출력에서 [`permission_denied` 메시지를 내보내는 실행](https://code.claude.com/docs/ko/agent-sdk/typescript#sdkpermissiondeniedmessage)은 다음 `decision_reason`을 보고합니다.

1215 

1216```text theme={null}

1217no approval surface in this session; permission request denied automatically

1218```

1219 

1220이 설정이 켜진 자동 모드에서는 분류기가 차단했거나 [안전 검사가 거부한](https://code.claude.com/docs/ko/errors.md#auto-mode-cannot-determine-the-safety-of-an-action) 호출이 연속으로 20개 발생하면 턴이 종료되고 다음 메시지가 표시됩니다.

1221 

1222```text theme={null}

122320 actions were refused and no work went ahead in between, so Claude stopped.

1224```

1225 

1226`-p` 실행은 해당 턴을 `error_during_execution`으로 보고합니다.

1227 

1166### `permissions.disableBypassPermissionsMode`1228### `permissions.disableBypassPermissionsMode`

1167 1229 

1168누구도 `bypassPermissions` 모드로 진입하지 못하게 합니다. 그러면 Claude Code는 `--dangerously-skip-permissions` 플래그를 거부하고, [에이전트 정의의](https://code.claude.com/docs/ko/sub-agents.md#permission-modes) `permissionMode: bypassPermissions`를 무시하므로 서브에이전트는 상위 세션의 권한 모드로 실행됩니다.1230누구도 `bypassPermissions` 모드로 진입하지 못하게 합니다. 그러면 Claude Code는 `--dangerously-skip-permissions` 플래그를 거부하고, [에이전트 정의의](https://code.claude.com/docs/ko/sub-agents.md#permission-modes) `permissionMode: bypassPermissions`를 무시하므로 서브에이전트는 상위 세션의 권한 모드로 실행됩니다.

1202 1264 

1203`--dangerously-skip-permissions` 또는 `defaultMode: "bypassPermissions"`로 인해 세션이 `bypassPermissions` 모드로 진입하기 전에 Claude Code가 표시하는 확인 대화 상자를 건너뜁니다. 해당 대화 상자를 한 번 수락하면 Claude Code가 사용자 설정의 이 키에 `true`를 기록합니다.1265`--dangerously-skip-permissions` 또는 `defaultMode: "bypassPermissions"`로 인해 세션이 `bypassPermissions` 모드로 진입하기 전에 Claude Code가 표시하는 확인 대화 상자를 건너뜁니다. 해당 대화 상자를 한 번 수락하면 Claude Code가 사용자 설정의 이 키에 `true`를 기록합니다.

1204 1266 

1205* **범위**: [`User, local, or managed`](#scopes). 신뢰할 수 없는 저장소는 사용자를 대신해 대화 상자를 건너뛸 수 없습니다.1267* **범위**: [`User, local, or managed`](#scopes) 및 `--settings`로 전달된 파일. [백그라운드 세션](https://code.claude.com/docs/ko/permission-modes.md#bypass-permissions-ignored-in-a-background-session)은 사용자 및 관리형 설정만 반영합니다. 신뢰할 수 없는 저장소는 사용자를 대신해 대화 상자를 건너뛸 수 없습니다.

1206* **타입**: Boolean1268* **타입**: Boolean

1207 * `true`: 세션이 `bypassPermissions` 모드로 진입하기 전에 Claude Code가 확인 대화 상자를 건너뜁니다1269 * `true`: 세션이 `bypassPermissions` 모드로 진입하기 전에 Claude Code가 확인 대화 상자를 건너뜁니다

1208 * `false`: 설정되지 않은 경우와 동일합니다. 이러한 파일 중 다른 파일이 `true`를 설정하지 않는 한 대화 상자가 표시됩니다1270 * `false`: 설정되지 않은 경우와 동일합니다. 이러한 파일 중 다른 파일이 `true`를 설정하지 않는 한 대화 상자가 표시됩니다

3132 3194 

3133### `syntaxHighlightingDisabled`3195### `syntaxHighlightingDisabled`

3134 3196 

3135Claude Code는 터미널에 표시하는 diff, 코드 블록, 파일 미리 보기의 코드를 기본 제공 하이라이터로 언어별로 색상을 입힙니다. 플러그인이나 언어 서버는 관여하지 않습니다. 색상이 터미널 테마와 어울리지 않거나 스크린 리더를 느리게 하는 경우 등에는 이 키를 `true`로 설정하여 일반 텍스트로 표시합니다.3197Claude Code는 터미널에 표시하는 diff, 코드 블록, 파일 미리 보기의 코드를 기본 제공 하이라이터로 언어별로 색상을 입힙니다. 색상이 터미널 테마와 어울리지 않거나 스크린 리더를 느리게 하는 경우 등에는 이 키를 `true`로 설정하여 일반 텍스트로 표시합니다.

3136 3198 

3137* **범위**: [`Any file`](#scopes)3199* **범위**: [`Any file`](#scopes)

3138* **유형**: Boolean3200* **유형**: Boolean

4110 4172 

4111### `strictPluginOnlyCustomization`4173### `strictPluginOnlyCustomization`

4112 4174 

4113사용자 및 프로젝트 소스의 스킬, 에이전트, 훅, MCP 서버를 차단하여 플러그인이나 관리형 설정에서만 제공되도록 합니다. [`strictKnownMarketplaces`](#strictknownmarketplaces)와 결합하면 전체 사용자 지정 공급망을 제어할 수 있습니다. 마켓플레이스 허용 목록은 사용자가 설치할 수 있는 플러그인을 제어합니다.4175사용자 및 프로젝트 소스의 스킬, 에이전트, 훅, MCP 서버를 차단합니다. [`strictKnownMarketplaces`](#strictknownmarketplaces)와 결합하면 사용자가 플러그인을 설치할 수 있는 마켓플레이스를 선택할 수 있습니다. 한 번의 실행에 플러그인, 에이전트, MCP 서버를 사이드로드하는 CLI 플래그를 거부하려면 [`disableSideloadFlags`](#disablesideloadflags)를 추가하세요.

4114 4176 

4115* **범위**: [`관리형`](#scopes)4177* **범위**: [`관리형`](#scopes)

4116* **유형**: 네 가지 사용자 지정 유형을 모두 잠그려면 `true`, 또는 `"skills"`, `"agents"`, `"hooks"`, `"mcp"` 중에서 잠글 유형을 지정하는 배열4178* **유형**: 모두 잠그려면 `true`, 또는 `"skills"`, `"agents"`, `"hooks"`, `"mcp"` 중에서 잠글 항목을 지정하는 배열

4117* **기본값**: 설정되지 않음. 따라서 아무것도 잠기지 않습니다4179* **기본값**: 설정되지 않음. 따라서 아무것도 잠기지 않습니다

4118 4180 

4119다음 예시는 스킬과 훅을 잠그고 에이전트와 MCP 서버는 잠그지 않습니다.4181다음 예시는 스킬과 훅을 잠그고 에이전트와 MCP 서버는 잠그지 않습니다.

4216각 범위는 서로 다른 용도로 사용됩니다.4278각 범위는 서로 다른 용도로 사용됩니다.

4217 4279 

4218* **사용자 설정**: 개인 플러그인 기본 설정4280* **사용자 설정**: 개인 플러그인 기본 설정

4219* **프로젝트 설정**: 저장소의 모든 사람과 공유하는 플러그인4281* **프로젝트 설정**: 저장소의 모든 사람에게 켜지는 플러그인. 이 설정이 플러그인을 설치하지는 않으므로 각 사용자가 [직접 설치](https://code.claude.com/docs/ko/plugins/org.md#require-plugins-per-repository)합니다.

4220* **로컬 설정**: 머신별 재정의. Claude Code가 여기에 설정을 저장할 때 gitignore 처리됩니다4282* **로컬 설정**: 머신별 재정의. Claude Code가 여기에 설정을 저장할 때 gitignore 처리됩니다

4221* **관리형 설정**: 조직 전체 정책. 여기서 `false`로 설정된 플러그인은 모든 범위에서 설치가 차단되고 마켓플레이스에서 숨겨집니다4283* **관리형 설정**: 조직 전체 정책. 여기서 `false`로 설정된 플러그인은 모든 범위에서 설치가 차단되고 마켓플레이스에서 숨겨집니다

4222 4284 

4223프로젝트 설정이 사용자 설정보다 우선하므로, `~/.claude/settings.json`에서 플러그인을 `false`로 설정해도 프로젝트의 `.claude/settings.json`이 활성화한 플러그인은 비활성화되지 않습니다. 프로젝트에서 활성화한 플러그인을 자신의 머신에서 제외하려면 대신 `.claude/settings.local.json`에서 `false`로 설정하세요. 관리형 설정은 로컬 설정을 재정의하므로, 관리형 설정에서 강제로 활성화된 플러그인은 이 방법으로 비활성화할 수 없습니다.4285프로젝트 설정이 사용자 설정보다 우선하므로, `~/.claude/settings.json`에서 플러그인을 `false`로 설정해도 프로젝트의 `.claude/settings.json`이 활성화한 플러그인은 비활성화되지 않습니다. 프로젝트에서 활성화한 플러그인을 자신의 머신에서 제외하려면 대신 `.claude/settings.local.json`에서 `false`로 설정하세요. 관리형 설정은 로컬 설정을 재정의하므로, 관리형 설정에서 강제로 활성화된 플러그인은 이 방법으로 비활성화할 수 없습니다.

4224 4286 

4225프로젝트의 `.claude/settings.json`에서 GitHub 저장소나 npm 패키지 같은 외부 소스의 플러그인을 활성화해도 다른 사람에게 설치되지는 않습니다. 플러그인을 로드하는 모든 경로에서, 각 사용자가 [직접 설치](https://code.claude.com/docs/ko/plugins/org.md#require-plugins-per-repository)할 때까지 Claude Code는 해당 플러그인을 설치되지 않은 것으로 보고합니다.

4226 

4227### `extraKnownMarketplaces`4287### `extraKnownMarketplaces`

4228 4288 

4229추가 플러그인 마켓플레이스를 이름으로 등록하여, 저장소를 여는 사람이나 관리형 설정이 적용되는 모든 사람이 직접 추가하지 않아도 마켓플레이스를 사용할 수 있게 합니다. Claude Code는 아직 알지 못하는 각 마켓플레이스를 등록합니다. [`enabledPlugins`](#enabledplugins)가 해당 마켓플레이스에서 지정하는 플러그인이 설치되는지 여부는 플러그인의 소스와 어떤 파일이 이를 활성화하는지에 따라 달라지며, 해당 항목에 규칙이 설명되어 있습니다.4289추가 플러그인 마켓플레이스를 이름으로 등록하여, 저장소를 여는 사람이나 관리형 설정이 적용되는 모든 사람이 직접 추가하지 않아도 마켓플레이스를 사용할 수 있게 합니다. Claude Code는 아직 알지 못하는 각 마켓플레이스를 등록합니다. [`enabledPlugins`](#enabledplugins)가 해당 마켓플레이스에서 지정하는 플러그인이 설치되는지 여부는 플러그인의 소스와 어떤 파일이 이를 활성화하는지에 따라 달라지며, 규칙은 [프로젝트 설정에서 활성화되었지만 설치되지 않음](https://code.claude.com/docs/ko/plugins/loading.md#enabled-in-project-settings-but-not-installed)에 설명되어 있습니다.

4230 4290 

4231* **범위**: [`모든 파일`](#scopes). Claude Code는 저장소의 `.claude/settings.json` 또는 `.claude/settings.local.json`에 있는 항목을 해당 폴더의 워크스페이스 신뢰 대화 상자를 수락한 후에만 인식합니다. 신뢰하지 않은 폴더에서는, 그곳에서의 `-p` 실행을 포함하여, 메시지 없이 해당 항목을 무시합니다.4291* **범위**: [`모든 파일`](#scopes). Claude Code는 저장소의 `.claude/settings.json` 또는 `.claude/settings.local.json`에 있는 항목을 해당 폴더의 워크스페이스 신뢰 대화 상자를 수락한 후에만 인식합니다. 신뢰하지 않은 폴더에서는, 그곳에서의 `-p` 실행을 포함하여, 메시지 없이 해당 항목을 무시합니다.

4232* **유형**: 마켓플레이스 이름을 `source` 객체와 선택적 `autoUpdate` Boolean을 가진 객체에 매핑하는 객체4292* **유형**: 마켓플레이스 이름을 `source` 객체와 선택적 `autoUpdate` Boolean을 가진 객체에 매핑하는 객체

4354 4414 

4355사용자가 설치한 모든 mod보다 먼저, 나열된 순서대로 [mod](https://code.claude.com/docs/ko/plugins/mods/overview.md)가 실행되는 관리형 플러그인을 나열합니다. 관리형 설정에서 이 키를 설정할 때는 기본 제공 가드를 유지하려면 목록에 `sec-default@builtin`을 포함하세요. 관리형 설정에서 Claude Code는 플러그인이 조직의 것으로 간주되지 않는 id를 건너뜁니다. 해당 조건과 두 순서 지정 키가 함께 작동하는 방식은 [조직의 mod 설치 및 순서 설정](https://code.claude.com/docs/ko/plugins/mods/admin.md#install-your-organizations-mods)을 참조하세요.4415사용자가 설치한 모든 mod보다 먼저, 나열된 순서대로 [mod](https://code.claude.com/docs/ko/plugins/mods/overview.md)가 실행되는 관리형 플러그인을 나열합니다. 관리형 설정에서 이 키를 설정할 때는 기본 제공 가드를 유지하려면 목록에 `sec-default@builtin`을 포함하세요. 관리형 설정에서 Claude Code는 플러그인이 조직의 것으로 간주되지 않는 id를 건너뜁니다. 해당 조건과 두 순서 지정 키가 함께 작동하는 방식은 [조직의 mod 설치 및 순서 설정](https://code.claude.com/docs/ko/plugins/mods/admin.md#install-your-organizations-mods)을 참조하세요.

4356 4416 

4357* **범위**: [`사용자 또는 관리형`](#scopes). Claude Code는 관리형 설정에서 이 키를 읽습니다. 사용자 설정에서는 관리형 설정이 없는 머신에서 자격 증명이 Team 또는 Enterprise `/login`이 아닌 세션에서만 이 키를 읽습니다. 프로젝트 및 로컬 설정과 `--settings` 파일에서는 이 키를 무시합니다.4417* **범위**: [`사용자 또는 관리형`](#scopes). Claude Code는 관리형 설정에서 이 키를 읽습니다. 사용자 설정에서는 관리형 설정이나 `managed-mcp.json` 파일이 없는 머신에서 자격 증명이 Team 또는 Enterprise `/login`이 아닌 세션에서만 이 키를 읽습니다. 프로젝트 및 로컬 설정과 `--settings` 파일에서는 이 키를 무시합니다.

4358* **유형**: `plugin-name@marketplace-name` 문자열의 배열4418* **유형**: `plugin-name@marketplace-name` 문자열의 배열

4359* **기본값**: 설정되지 않음4419* **기본값**: 설정되지 않음

4360 4420 

4374 4434 

4375사용자가 설치한 모든 mod 다음에, 나열된 순서대로 [mod](https://code.claude.com/docs/ko/plugins/mods/overview.md)가 실행되는 관리형 플러그인을 나열합니다. `prependPlugins`와 `appendPlugins` 모두에 나열된 id는 앞에 추가됩니다. 관리형 설정에서 Claude Code는 플러그인이 [조직의 것으로 간주](https://code.claude.com/docs/ko/plugins/mods/admin.md#install-your-organizations-mods)되지 않는 id를 건너뜁니다.4435사용자가 설치한 모든 mod 다음에, 나열된 순서대로 [mod](https://code.claude.com/docs/ko/plugins/mods/overview.md)가 실행되는 관리형 플러그인을 나열합니다. `prependPlugins`와 `appendPlugins` 모두에 나열된 id는 앞에 추가됩니다. 관리형 설정에서 Claude Code는 플러그인이 [조직의 것으로 간주](https://code.claude.com/docs/ko/plugins/mods/admin.md#install-your-organizations-mods)되지 않는 id를 건너뜁니다.

4376 4436 

4377* **범위**: [`사용자 또는 관리형`](#scopes). Claude Code는 관리형 설정에서 이 키를 읽습니다. 사용자 설정에서는 관리형 설정이 없는 머신에서 자격 증명이 Team 또는 Enterprise `/login`이 아닌 세션에서만 이 키를 읽습니다. 프로젝트 및 로컬 설정과 `--settings` 파일에서는 이 키를 무시합니다.4437* **범위**: [`사용자 또는 관리형`](#scopes). Claude Code는 관리형 설정에서 이 키를 읽습니다. 사용자 설정에서는 관리형 설정이나 `managed-mcp.json` 파일이 없는 머신에서 자격 증명이 Team 또는 Enterprise `/login`이 아닌 세션에서만 이 키를 읽습니다. 프로젝트 및 로컬 설정과 `--settings` 파일에서는 이 키를 무시합니다.

4378* **유형**: `plugin-name@marketplace-name` 문자열의 배열4438* **유형**: `plugin-name@marketplace-name` 문자열의 배열

4379* **기본값**: 설정되지 않음4439* **기본값**: 설정되지 않음

4380 4440 

4612 4672 

4613### `crossSessionInbound`4673### `crossSessionInbound`

4614 4674 

4615이 세션이 [다른 Claude Code 세션에서 도착하는 메시지](https://code.claude.com/docs/ko/cross-session-messaging.md#control-inbound-messages)로 수행할 작업을 선택합니다. 적용되는 값이 없으면 Claude Code는 두 세션의 권한 모드 클래스에서 메시지별로 결정합니다. Claude Code v2.1.224 이상이 필요합니다.4675이 세션이 [다른 Claude Code 세션에서 도착하는 메시지](https://code.claude.com/docs/ko/cross-session-messaging.md#control-inbound-messages)로 수행할 작업을 선택합니다. 적용되는 값이 없으면 Claude Code는 두 세션의 권한 모드 클래스에서 메시지별로 결정합니다.

4616 4676 

4617* **Scope**: [`Any file`](#scopes). 프로젝트 또는 로컬 값은 관리형 설정, `--settings` 플래그 또는 사용자 설정이 제공하는 값보다 더 엄격할 때만 적용됩니다.4677* **Scope**: [`Any file`](#scopes). 프로젝트 또는 로컬 값은 관리형 설정, `--settings` 플래그 또는 사용자 설정이 제공하는 값보다 더 엄격할 때만 적용됩니다.

4618* **Type**: string, 다음 중 하나:4678* **Type**: string, 다음 중 하나:

4946}5006}

4947```5007```

4948 5008 

5009### `disableRemotePreviewScripts`

5010 

5011데스크톱 앱에서 SSH 또는 WSL 세션의 [HTML 파일을 미리 볼](https://code.claude.com/docs/ko/desktop.md#preview-html-files-in-ssh-and-wsl-sessions) 때 스크립트가 실행되지 않도록 합니다. Browser 창의 외부 탐색은 영향을 받지 않습니다.

5012 

5013이 키는 데스크톱 앱이 읽으며, 터미널 CLI는 무시합니다. Claude Desktop v5.1231.0 이상이 필요합니다. 이전 버전은 이 키를 무시합니다. 해당 버전에서 스크립트를 중지하려면 [`disableBrowserExternalNavigation`](#disablebrowserexternalnavigation)도 설정하십시오. 이 설정은 외부 탐색도 끕니다.

5014 

5015* **범위**: [`Managed`](#scopes). 데스크톱 앱은 원격 머신이나 WSL 배포판에서 이 키를 읽지 않습니다.

5016* **유형**: Boolean. JSON Boolean `true`만 효력이 있습니다

5017 * `true`: SSH 및 WSL 세션의 HTML 미리 보기에서 스크립트가 실행되지 않습니다

5018 * `false`: 이 키가 스크립트를 끄지 않습니다

5019* **기본값**: 설정되지 않음, 따라서 이 키는 아무 효과가 없습니다

5020 

5021데스크톱 앱을 실행하는 컴퓨터가 다른 Claude Code 관리형 설정을 받지 않는 경우, 생성하는 관리형 설정에서 [`parentSettingsBehavior`](#parentsettingsbehavior)도 `"merge"`로 설정하십시오. Windows에서 관리형 설정 파일을 생성하면, [허용](https://code.claude.com/docs/ko/admin-setup.md#wsl-sessions-in-claude-code-desktop)하기 전까지 사용자는 WSL 세션도 사용할 수 없게 됩니다. [조직의 SSH 및 WSL 미리 보기에서 스크립트 끄기](https://code.claude.com/docs/ko/desktop.md#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization)에서 두 가지를 모두 설명하고 키를 설정할 위치를 안내합니다.

5022 

5023다음 예시는 컴퓨터가 이미 받고 있는 관리형 설정에 추가할 때처럼 키만 보여 줍니다.

5024 

5025```json managed-settings.json theme={null}

5026{

5027 "disableRemotePreviewScripts": true

5028}

5029```

5030 

5031데스크톱 앱은 다른 값은 무시하며, 문자열 `"true"`나 `1`처럼 Boolean이 아닌 값은 경고도 로그에 기록합니다.

5032 

4949### `enableArtifact`5033### `enableArtifact`

4950 5034 

4951세션 출력을 claude.ai의 비공개 웹 페이지로 게시하는 [Artifact](https://code.claude.com/docs/ko/artifacts.md) 도구를 끕니다. `/config`에서 **Artifacts** 행을 끄면 Claude Code가 이 키를 사용자 설정에 기록하므로, 일반적으로 직접 편집할 필요는 없습니다.5035세션 출력을 claude.ai의 비공개 웹 페이지로 게시하는 [Artifact](https://code.claude.com/docs/ko/artifacts.md) 도구를 끕니다. `/config`에서 **Artifacts** 행을 끄면 Claude Code가 이 키를 사용자 설정에 기록하므로, 일반적으로 직접 편집할 필요는 없습니다.

5219 5303 

5220### `forceLoginMethod`5304### `forceLoginMethod`

5221 5305 

5222사람들이 로그인할 수 있는 계정 종류를 제한합니다. `"claudeai"`로 설정하여 claude.ai 계정만 허용하거나, `"console"`로 설정하여 Claude Console 계정만 허용하거나, `"gateway"`로 설정하여 사람들을 첫 번째 당사자 로그인 대신 [클라우드 게이트웨이](https://code.claude.com/docs/ko/claude-apps-gateway)로 보냅니다. 관리자는 관리형 설정에서 설정하고 [`forceLoginOrgUUID`](#forceloginorguuid)와 쌍을 이루어 개발자의 claude.ai 로그인을 한 조직 내에 유지합니다.5306사람들이 로그인할 수 있는 계정 종류를 제한합니다. claude.ai 로그인에는 `"claudeai"`를, Claude Console 로그인에는 `"console"`을 사용합니다. 사람들을 첫 번째 당사자 로그인 대신 [클라우드 게이트웨이](https://code.claude.com/docs/ko/claude-apps-gateway)로 보내려면 `"gateway"`로 설정합니다. 관리자는 관리형 설정에서 설정하고 [`forceLoginOrgUUID`](#forceloginorguuid)와 쌍을 이루어 개발자의 claude.ai 로그인을 한 조직 내에 유지합니다.

5223 5307 

5224설정 파일에서 `"claudeai"`로 설정하면, Claude Code는 해당 파일이 적용되는 세션에서 [키 없는 Console 로그인](https://code.claude.com/docs/ko/authentication.md#sign-in-without-an-api-key)도 제공하지 않습니다. `"console"`만 설정한 경우에는 로그인에 실패한 후에도 여전히 키 없는 로그인에 접근할 수 있습니다. Claude Code가 이를 제공하지 않도록 하려면 [관리 대상 머신에서 키 없는 로그인 제공 중지](https://code.claude.com/docs/ko/authentication.md#stop-offering-the-keyless-sign-in-on-managed-machines)를 참조하세요. 이 문서에는 `forceLoginOrgUUID`가 변경하는 다른 사항도 나와 있습니다.5308설정 파일에서 `"claudeai"`로 설정하면, Claude Code는 해당 파일이 적용되는 세션에서 [키 없는 Console 로그인](https://code.claude.com/docs/ko/authentication.md#sign-in-without-an-api-key)도 제공하지 않습니다. `"console"`만 설정한 경우에는 로그인에 실패한 후에도 여전히 키 없는 로그인에 접근할 수 있습니다. Claude Code가 이를 제공하지 않도록 하려면 [관리 대상 머신에서 키 없는 로그인 제공 중지](https://code.claude.com/docs/ko/authentication.md#stop-offering-the-keyless-sign-in-on-managed-machines)를 참조하세요. 이 문서에는 `forceLoginOrgUUID`가 변경하는 다른 사항도 나와 있습니다.

5225 5309 

5226* **범위**: [`모든 파일`](#scopes). Claude Code는 [`forceLoginGatewayUrl`](#forcelogingatewayurl)과 동일한 소스에서만 `"gateway"`를 인정하며, 그 외의 모든 곳에서는 설정되지 않은 것으로 취급합니다.5310* **범위**: [`모든 파일`](#scopes). Claude Code는 [`forceLoginGatewayUrl`](#forcelogingatewayurl)과 동일한 소스에서만 `"gateway"`를 인정하며, 그 외의 모든 곳에서는 설정되지 않은 것으로 취급합니다.

5227* **유형**: 문자열, 다음 중 하나:5311* **유형**: 문자열, 다음 중 하나:

5228 * `"claudeai"`: claude.ai 계정만 로그인할 수 있습니다.5312 * `"claudeai"`: claude.ai 로그인

5229 * `"console"`: Claude Console 계정만 로그인할 수 있습니다.5313 * `"console"`: Claude Console 로그인

5230 * `"gateway"`: Claude Code는 사람들을 첫 번째 당사자 로그인 대신 클라우드 게이트웨이로 보냅니다.5314 * `"gateway"`: Claude Code는 사람들을 첫 번째 당사자 로그인 대신 클라우드 게이트웨이로 보냅니다.

5231* **기본값**: 설정되지 않음, 따라서 사람들이 로그인 방법을 선택합니다.5315* **기본값**: 설정되지 않음, 따라서 사람들이 로그인 방법을 선택합니다.

5232 5316 

5471 5555 

5472Claude Code가 [세션 기록 및 기타 애플리케이션 데이터](https://code.claude.com/docs/ko/claude-directory.md#cleaned-up-automatically)를 삭제하기 전에 보관하는 일 수를 설정합니다. Claude Code는 세션이 시작된 후 백그라운드 스윕으로 삭제를 실행하며, 보관 기간을 안전하게 결정할 수 있는 한 실행합니다. 스윕은 메시지를 표시하지 않고 기록을 삭제하므로, 보관 기간보다 오래 사용하지 않은 세션은 더 이상 [`/resume`](https://code.claude.com/docs/ko/sessions#resume-a-session) 선택기에 나타나지 않습니다.5556Claude Code가 [세션 기록 및 기타 애플리케이션 데이터](https://code.claude.com/docs/ko/claude-directory.md#cleaned-up-automatically)를 삭제하기 전에 보관하는 일 수를 설정합니다. Claude Code는 세션이 시작된 후 백그라운드 스윕으로 삭제를 실행하며, 보관 기간을 안전하게 결정할 수 있는 한 실행합니다. 스윕은 메시지를 표시하지 않고 기록을 삭제하므로, 보관 기간보다 오래 사용하지 않은 세션은 더 이상 [`/resume`](https://code.claude.com/docs/ko/sessions#resume-a-session) 선택기에 나타나지 않습니다.

5473 5557 

5558기본적으로 Claude Code는 Claude Desktop 또는 Cowork에서 시작하거나 가장 최근에 계속한 세션의 트랜스크립트를 이 기간이 지나도 유지하며, 이 키를 직접 설정한 경우에도 마찬가지입니다. HIPAA 구성과 같은 [일부 경우에는 이 기간이 여전히 해당 트랜스크립트에 적용됩니다](https://code.claude.com/docs/ko/claude-directory.md#cleaned-up-automatically). v2.1.248 이전에는 Claude Code가 이 기간이 지나면 해당 트랜스크립트를 삭제했습니다.

5559 

5474* **범위**: [`모든 파일`](#scopes)5560* **범위**: [`모든 파일`](#scopes)

5475* **유형**: 일 수, 정수, 최소값 `1`5561* **유형**: 일 수, 정수, 최소값 `1`

5476* **기본값**: `30`5562* **기본값**: `30`

5485 5571 

5486### `desktopSessionCleanupPeriodDays`5572### `desktopSessionCleanupPeriodDays`

5487 5573 

5488Claude Desktop 또는 Cowork에서 시작하거나 가장 최근에 계속한 세션의 트랜스크립트에 대한 나이 제한을 일 수로 설정합니다. 이 키가 없으면 Claude Code는 [해당 트랜스크립트를 나이와 관계없이 유지합니다](https://code.claude.com/docs/ko/claude-directory.md#cleaned-up-automatically). Claude Code는 각 트랜스크립트가 이 제한과 [`cleanupPeriodDays`](#cleanupperioddays) 모두보다 오래되면 삭제하므로, `cleanupPeriodDays`가 기본값 30일 때 `7` 값은 여전히 30일 동안 유지합니다. [자동으로 정리되는 항목](https://code.claude.com/docs/ko/claude-directory.md#cleaned-up-automatically)에는 `cleanupPeriodDays`가 대신 적용되고 Claude Code가 이 키를 무시하는 경우가 나열되어 있습니다. Claude Code v2.1.248 이상이 필요합니다.5574Claude Desktop 또는 Cowork에서 시작하거나 가장 최근에 계속한 세션의 트랜스크립트에 대한 나이 제한을 일 수로 설정합니다. 이 키가 없으면 Claude Code는 Claude Desktop에서 삭제한 세션과 같은 경우를 제외하고 [해당 트랜스크립트를 나이와 관계없이 유지합니다](https://code.claude.com/docs/ko/claude-directory.md#cleaned-up-automatically). Claude Code v2.1.248 이상이 필요합니다.

5575 

5576Claude Code는 각 트랜스크립트가 이 제한과 [`cleanupPeriodDays`](#cleanupperioddays) 모두보다 오래되면 삭제하므로, `cleanupPeriodDays`가 기본값 30일 때 `7` 값은 여전히 30일 동안 유지합니다. [자동으로 정리되는 항목](https://code.claude.com/docs/ko/claude-directory.md#cleaned-up-automatically)에는 `cleanupPeriodDays`가 대신 적용되고 Claude Code가 이 키를 무시하는 경우가 나열되어 있습니다.

5489 5577 

5490* **범위**: [`사용자 또는 관리됨`](#scopes). Claude Code는 `--settings`로 전달하는 파일에서도 키를 읽고 프로젝트 및 로컬 설정에서는 무시합니다.5578* **범위**: [`사용자 또는 관리형`](#scopes). Claude Code는 `--settings`로 전달하는 파일에서도 키를 읽고 프로젝트 및 로컬 설정에서는 무시합니다.

5491* **유형**: 일 수, 정수, 최소값 `0`5579* **유형**: 일 수, 정수, 최소값 `0`

5492* **기본값**: `0`, 나이 제한을 설정하지 않음5580* **기본값**: `0`, 나이 제한을 설정하지 않음

5493 5581 

5501 5589 

5502[Claude가 작성한 피드백](https://code.claude.com/docs/ko/tools-reference.md#sendfeedback-tool-behavior) 제어: Claude가 검토할 피드백 초안을 대기열에 넣을 수 있는지 여부, 그리고 Claude Code가 Claude가 초안을 대기열에 넣을 때 카드를 표시하는지 여부입니다.5590[Claude가 작성한 피드백](https://code.claude.com/docs/ko/tools-reference.md#sendfeedback-tool-behavior) 제어: Claude가 검토할 피드백 초안을 대기열에 넣을 수 있는지 여부, 그리고 Claude Code가 Claude가 초안을 대기열에 넣을 때 카드를 표시하는지 여부입니다.

5503 5591 

5504* **범위**: [`사용자 또는 관리됨`](#scopes)5592* **범위**: [`사용자 또는 관리형`](#scopes)

5505* **유형**: 문자열, `"notify"`, `"quiet"` 또는 `"off"` 중 하나5593* **유형**: 문자열, `"notify"`, `"quiet"` 또는 `"off"` 중 하나

5506 * `"notify"`: Claude Code는 Claude가 초안을 대기열에 넣을 때 프롬프트 위에 카드를 표시하며, 기본적으로 [세션당 최대 3개의 카드](https://code.claude.com/docs/ko/tools-reference.md#what-you-see-when-claude-drafts)5594 * `"notify"`: Claude Code는 Claude가 초안을 대기열에 넣을 때 프롬프트 위에 카드를 표시하며, 기본적으로 [세션당 최대 3개의 카드](https://code.claude.com/docs/ko/tools-reference.md#what-you-see-when-claude-drafts)

5507 * `"quiet"`: Claude는 카드 없이 초안을 작성합니다. 프롬프트 바닥글에서 대기열에 있는 초안의 개수를 보고 `/feedback`에서 검토합니다.5595 * `"quiet"`: Claude는 카드 없이 초안을 작성합니다. 프롬프트 바닥글에서 대기열에 있는 초안의 개수를 보고 `/feedback`에서 검토합니다.