Documentation 2026-11-10 21:57 UTC to 2026-11-11 22:59 UTC

96| [관리형 정책 CLAUDE.md](https://code.claude.com/docs/ko/memory.md#deploy-organization-wide-claude-md) | 클라이언트에서 강제하는 규칙이 아닌, Claude를 위한 조직 전체 행동 지침 | 관리형 정책 경로의 파일 |96| [관리형 정책 CLAUDE.md](https://code.claude.com/docs/ko/memory.md#deploy-organization-wide-claude-md) | 클라이언트에서 강제하는 규칙이 아닌, Claude를 위한 조직 전체 행동 지침 | 관리형 정책 경로의 파일 |

97| [MCP 서버 제어](https://code.claude.com/docs/ko/managed-mcp.md) | 사용자가 추가하거나 연결할 수 있는 MCP 서버를 제한하고, 고정 집합을 배포하거나, 모든 사용자에게 자신의 서버와 함께 원격 서버를 제공합니다 | `allowedMcpServers`, `deniedMcpServers`, `allowManagedMcpServersOnly`, `managedMcpServers`, 또는 배포된 `managed-mcp.json` 파일 |97| [MCP 서버 제어](https://code.claude.com/docs/ko/managed-mcp.md) | 사용자가 추가하거나 연결할 수 있는 MCP 서버를 제한하고, 고정 집합을 배포하거나, 모든 사용자에게 자신의 서버와 함께 원격 서버를 제공합니다 | `allowedMcpServers`, `deniedMcpServers`, `allowManagedMcpServersOnly`, `managedMcpServers`, 또는 배포된 `managed-mcp.json` 파일 |

98| [플러그인 마켓플레이스 제어](https://code.claude.com/docs/ko/plugins/org.md#restrict-what-users-can-install) | 사용자가 추가하고 설치할 수 있는 마켓플레이스 소스를 제한하고, 단일 실행을 위해 플러그인, 에이전트 및 MCP 서버를 사이드로드하는 CLI 플래그를 거부합니다. [`command` 플러그인 소스](https://code.claude.com/docs/ko/plugins/marketplace-reference#command-plugin-source)를 차단하고, 어떤 마켓플레이스의 플러그인을 터미널에서 제안할 수 있는지 허용 목록에 추가합니다 | `strictKnownMarketplaces`, `blockedMarketplaces`, `disableSideloadFlags`, `disableCommandPluginSources`, `pluginSuggestionMarketplaces` |98| [플러그인 마켓플레이스 제어](https://code.claude.com/docs/ko/plugins/org.md#restrict-what-users-can-install) | 사용자가 추가하고 설치할 수 있는 마켓플레이스 소스를 제한하고, 단일 실행을 위해 플러그인, 에이전트 및 MCP 서버를 사이드로드하는 CLI 플래그를 거부합니다. [`command` 플러그인 소스](https://code.claude.com/docs/ko/plugins/marketplace-reference#command-plugin-source)를 차단하고, 어떤 마켓플레이스의 플러그인을 터미널에서 제안할 수 있는지 허용 목록에 추가합니다 | `strictKnownMarketplaces`, `blockedMarketplaces`, `disableSideloadFlags`, `disableCommandPluginSources`, `pluginSuggestionMarketplaces` |

99| [사용자 정의 잠금](https://code.claude.com/docs/ko/settings-reference.md#strictpluginonlycustomization) | skills, 에이전트, hooks 및 MCP 서버가 사용자 및 프로젝트 소스에서 오지 않도록 차단하여 플러그인 또는 관리되는 설정에서만 올 수 있도록 합니다. skills를 잠금하면 [개발자가 claude.ai에서 활성화하는 skills](https://code.claude.com/docs/ko/skills.md#where-synced-skills-load)도 동기화되지 않습니다 | `strictPluginOnlyCustomization` |99| [사용자 정의 잠금](https://code.claude.com/docs/ko/settings-reference.md#strictpluginonlycustomization) | 사용자 및 프로젝트 소스의 스킬, 에이전트, 훅 및 MCP 서버를 차단합니다. 스킬을 잠그면 [개발자가 claude.ai에서 활성화하는 스킬](https://code.claude.com/docs/ko/skills.md#where-synced-skills-load)도 동기화되지 않습니다 | `strictPluginOnlyCustomization` |

100| [claude.ai 동기화 비활성화](https://code.claude.com/docs/ko/settings-reference.md#syncclaudeaiskills) | Claude Code가 개발자가 claude.ai에서 활성화하는 [skills](https://code.claude.com/docs/ko/skills.md#how-synced-skills-behave) 및 [플러그인](https://code.claude.com/docs/ko/plugins/loading.md#synced-plugins)을 로드하지 않도록 합니다. 조직의 claude.ai에서 Skills를 끄면 Claude Code는 둘 다 동기화를 중지하고, v2.1.273 이상에서는 이미 동기화한 것도 제거합니다. Skills를 끄지 않고 둘 중 하나를 중지하려면 관리되는 설정에서 해당 키를 `false`로 설정합니다 | `syncClaudeAiSkills`, `syncClaudeAiPlugins` |100| [claude.ai 동기화 비활성화](https://code.claude.com/docs/ko/settings-reference.md#syncclaudeaiskills) | Claude Code가 개발자가 claude.ai에서 활성화하는 [skills](https://code.claude.com/docs/ko/skills.md#how-synced-skills-behave) 및 [플러그인](https://code.claude.com/docs/ko/plugins/loading.md#synced-plugins)을 로드하지 않도록 합니다. 조직의 claude.ai에서 Skills를 끄면 Claude Code는 둘 다 동기화를 중지하고, v2.1.273 이상에서는 이미 동기화한 것도 제거합니다. Skills를 끄지 않고 둘 중 하나를 중지하려면 관리되는 설정에서 해당 키를 `false`로 설정합니다 | `syncClaudeAiSkills`, `syncClaudeAiPlugins` |

101| [Hook 제한](https://code.claude.com/docs/ko/settings-reference.md#allowmanagedhooksonly) | 실행되는 hooks를 제한하고 HTTP hook URL을 제한합니다. 전체 효과 목록은 [`allowManagedHooksOnly` 아래에서 실행되는 것](https://code.claude.com/docs/ko/settings-reference#what-runs-under-allowmanagedhooksonly)을 참조하세요 | `allowManagedHooksOnly`, `allowedHttpHookUrls` |101| [Hook 제한](https://code.claude.com/docs/ko/settings-reference.md#allowmanagedhooksonly) | 실행되는 hooks를 제한하고 HTTP hook URL을 제한합니다. 전체 효과 목록은 [`allowManagedHooksOnly` 아래에서 실행되는 것](https://code.claude.com/docs/ko/settings-reference#what-runs-under-allowmanagedhooksonly)을 참조하세요 | `allowManagedHooksOnly`, `allowedHttpHookUrls` |

102| [로그인 적용](https://code.claude.com/docs/ko/settings-reference.md#forceloginmethod) | 로그인을 특정 방법 또는 Anthropic 조직으로 제한합니다. 메서드 제한은 VS Code 확장, Agent SDK, `claude setup-token` 및 `/install-github-app` 전체에 적용되며, 터미널의 대화형 로그인 화면은 `/login` 또는 처음 실행 온보딩으로 도달하며, 메서드를 적용하지 않고 미리 선택합니다. Claude Code는 터미널, VS Code 확장 및 Agent SDK에서 claude.ai 계정 로그인에 대한 조직을 확인하며, Claude Console 로그인 또는 [gateway](https://code.claude.com/docs/ko/claude-apps-gateway) 로그인에 대해서는 확인하지 않습니다. v2.1.212 이전에는 터미널 로그인만 두 키를 모두 적용했습니다. 설정되면 `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` 또는 `apiKeyHelper`로 인증된 세션은 시작 시 차단됩니다. 클라우드 공급자 세션은 이러한 자격 증명 중 하나 또는 이전 Claude Console 로그인으로 저장된 API 키도 있는 경우가 아니면 영향을 받지 않습니다 | `forceLoginMethod`, `forceLoginOrgUUID` |102| [로그인 적용](https://code.claude.com/docs/ko/settings-reference.md#forceloginmethod) | 로그인을 특정 방법 또는 Anthropic 조직으로 제한합니다. 메서드 제한은 VS Code 확장, Agent SDK, `claude setup-token` 및 `/install-github-app` 전체에 적용되며, 터미널의 대화형 로그인 화면은 `/login` 또는 처음 실행 온보딩으로 도달하며, 메서드를 적용하지 않고 미리 선택합니다. Claude Code는 터미널, VS Code 확장 및 Agent SDK에서 claude.ai 계정 로그인에 대한 조직을 확인하며, Claude Console 로그인 또는 [gateway](https://code.claude.com/docs/ko/claude-apps-gateway) 로그인에 대해서는 확인하지 않습니다. v2.1.212 이전에는 터미널 로그인만 두 키를 모두 적용했습니다. 설정되면 `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` 또는 `apiKeyHelper`로 인증된 세션은 시작 시 차단됩니다. 클라우드 공급자 세션은 이러한 자격 증명 중 하나 또는 이전 Claude Console 로그인으로 저장된 API 키도 있는 경우가 아니면 영향을 받지 않습니다 | `forceLoginMethod`, `forceLoginOrgUUID` |

8 8 

9> [!NOTE]9> [!NOTE]

10>10>

11> 조언자 도구는 실험적이며 Anthropic API가 필요합니다. Amazon Bedrock, Claude Platform on AWS, Google Cloud의 Agent Platform 또는 Microsoft Foundry에서는 사용할 수 없습니다. 동작, 가격 책정 및 가용성은 변경될 수 있습니다.11> 조언자 도구는 실험적이며 Anthropic API 또는 [Claude Platform on AWS](https://code.claude.com/docs/ko/claude-platform-on-aws.md)가 필요합니다. Claude Platform on AWS에서는 Claude Code v2.1.300 이상이 필요합니다. Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry에서는 사용할 수 없습니다. 동작, 가격 책정 및 가용성은 변경될 수 있습니다.

12 12 

13조언자 도구를 사용하면 Claude가 작업 중 핵심 순간(예: 접근 방식을 확정하기 전, 반복되는 오류에 막혔을 때, 작업 완료를 선언하기 전)에 일반적으로 더 강력한 두 번째 모델을 참고할 수 있습니다. 조언자는 모든 도구 호출 및 결과를 포함한 전체 대화를 받고 Claude가 계속하기 전에 적용할 지침을 반환합니다.13조언자 도구를 사용하면 Claude가 작업 중 핵심 순간(예: 접근 방식을 확정하기 전, 반복되는 오류에 막혔을 때, 작업 완료를 선언하기 전)에 일반적으로 더 강력한 두 번째 모델을 참고할 수 있습니다. 조언자는 모든 도구 호출 및 결과를 포함한 전체 대화를 받고 Claude가 계속하기 전에 적용할 지침을 반환합니다.

14 14 

174 174 

175## 요구 사항175## 요구 사항

176 176 

177조언자 도구는 다음 모두를 요구합니다:177* **제공자**: Anthropic API 또는 [Claude Platform on AWS](https://code.claude.com/docs/ko/claude-platform-on-aws.md)이며, Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry는 해당되지 않습니다. Claude Platform on AWS에서 조언자를 사용하려면 Claude Code v2.1.300 이상이 필요합니다.

178 178* **LLM 게이트웨이**: `ANTHROPIC_BASE_URL`로 구성된 [LLM 게이트웨이](https://code.claude.com/docs/ko/llm-gateway)를 통하는 경우, 가용성은 게이트웨이가 요청을 Anthropic API로 그대로 전달하는지 여부에 따라 달라집니다. 게이트웨이 또는 그 업스트림이 조언자 도구를 인식하지 못하는 경우 Claude Code가 응답하는 방식에 대해 [자동 재시도 및 오류 전달](https://code.claude.com/docs/ko/llm-gateway-protocol.md#automatic-retry-and-error-forwarding)을 참조하십시오.

179* **Anthropic API만**: 조언자는 서버 실행 도구입니다. Amazon Bedrock, Claude Platform on AWS, Google Cloud의 Agent Platform 또는 Microsoft Foundry에서는 사용할 수 없습니다. `ANTHROPIC_BASE_URL`로 구성된 [LLM 게이트웨이](https://code.claude.com/docs/ko/llm-gateway)를 통해 가용성은 게이트웨이가 요청을 Anthropic API로 그대로 전달하는지 여부에 따라 달라집니다. 게이트웨이 또는 그 업스트림이 조언자 도구를 인식하지 못하는 경우 Claude Code가 응답하는 방식에 대해 [자동 재시도 및 오류 전달](https://code.claude.com/docs/ko/llm-gateway-protocol.md#automatic-retry-and-error-forwarding)을 참조하십시오.

180* **지원되는 주 모델**: Fable, Opus 4.6 이상, Sonnet 4.6 이상, Haiku 4.5 또는 Haiku 5.5. 각 모델이 어떤 조언자를 허용하는지는 [조언자 모델 선택](#choose-an-advisor-model)을 참조하십시오.179* **지원되는 주 모델**: Fable, Opus 4.6 이상, Sonnet 4.6 이상, Haiku 4.5 또는 Haiku 5.5. 각 모델이 어떤 조언자를 허용하는지는 [조언자 모델 선택](#choose-an-advisor-model)을 참조하십시오.

181* **기능 플래그 가져오기**: Claude Code는 Anthropic에서 가져온 기능 플래그를 통해 조언자를 켭니다. `DISABLE_TELEMETRY`와 같이 플래그 가져오기를 끄는 변수가 설정된 세션에서는 조언자가 꺼진 상태로 유지됩니다. [기능 플래그 가져오기가 필요한 기능](https://code.claude.com/docs/ko/env-vars.md#features-that-need-feature-flag-fetching)을 참조하십시오.180* **기능 플래그 가져오기**: Claude Platform on AWS를 사용하는 경우를 제외하고, 조언자에는 Anthropic에서 가져온 기능 플래그가 필요합니다. `DISABLE_TELEMETRY`와 같이 가져오기를 끄는 변수가 설정된 세션에는 해당 플래그가 없습니다. 세션을 확인하려면 [가져오기를 건너뛰거나 플래그 없이 시작하는 세션](https://code.claude.com/docs/ko/env-vars.md#features-that-need-feature-flag-fetching)을 참조하십시오.

182 181 

183## 조언자 끄기182## 조언자 끄기

184 183 

220 220 

221> [!NOTE]221> [!NOTE]

222>222>

223> `effort`는 각 응답 내에서 지연 시간 및 토큰 비용과 추론 깊이를 맞바꿉니다. [확장 사고](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)는 출력에 `thinking` 블록을 생성하는 별도의 기능이며, [Python](https://code.claude.com/docs/ko/agent-sdk/python.md#thinkingconfig) 또는 [TypeScript](https://code.claude.com/docs/ko/agent-sdk/typescript.md#thinkingconfig)의 `ThinkingConfig`에 있는 `display` 필드가 해당 텍스트를 받을지 여부를 제어합니다. 두 기능은 서로 독립적입니다. 확장 사고를 켠 상태에서 `effort: "low"`를 설정할 수도 있고, 확장 사고를 끈 상태에서 `effort: "max"`를 설정할 수도 있습니다.223> `effort`는 각 응답 내에서 지연 시간 및 토큰 비용과 추론 깊이를 맞바꿉니다. [확장 사고](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)는 출력에 `thinking` 블록을 생성하며, [Python](https://code.claude.com/docs/ko/agent-sdk/python.md#thinkingconfig) 또는 [TypeScript](https://code.claude.com/docs/ko/agent-sdk/typescript.md#thinkingconfig)의 `ThinkingConfig`에 있는 `display` 필드가 해당 텍스트를 받을지 여부를 제어합니다.

224 224 

225간단하고 범위가 명확한 작업(파일 목록 조회나 단일 grep 실행 등)을 수행하는 에이전트에는 낮은 effort를 사용해 비용과 지연 시간을 줄이세요. [세션](https://code.claude.com/docs/ko/sub-agents.md#choose-an-effort-level) 전체에 적용하려면 최상위 `query()` 옵션에서 `effort`를 설정하고, 서브에이전트별로 세션 수준을 재정의하려면 [`AgentDefinition`](https://code.claude.com/docs/ko/agent-sdk/subagents#agentdefinition-configuration)의 `effort` 필드를 사용하세요.225간단하고 범위가 명확한 작업(파일 목록 조회나 단일 grep 실행 등)을 수행하는 에이전트에는 낮은 effort를 사용해 비용과 지연 시간을 줄이세요. [세션](https://code.claude.com/docs/ko/sub-agents.md#choose-an-effort-level) 전체에 적용하려면 최상위 `query()` 옵션에서 `effort`를 설정하고, 서브에이전트별로 세션 수준을 재정의하려면 [`AgentDefinition`](https://code.claude.com/docs/ko/agent-sdk/subagents#agentdefinition-configuration)의 `effort` 필드를 사용하세요.

226 226 

222최종 사용자 ID를 첨부하면 다음 이벤트는 Security Information and Event Management(SIEM) 플랫폼으로 전달할 수 있는 사용자별 감사 추적이 됩니다:222최종 사용자 ID를 첨부하면 다음 이벤트는 Security Information and Event Management(SIEM) 플랫폼으로 전달할 수 있는 사용자별 감사 추적이 됩니다:

223 223 

224* `tool_decision` 및 `tool_result`: 각 도구 호출, 허용 또는 거부 여부, 그리고 그 결과224* `tool_decision` 및 `tool_result`: 각 도구 호출, 허용 또는 거부 여부, 그리고 그 결과

225* `safety_event`: 권한 규칙이나 자동 모드 분류기 등 어떤 검사가 도구 호출을 거부했거나 해당 호출에 권한 프롬프트를 요구했는지를 나타냅니다. 일부 호출에는 [안전 이벤트가 없습니다](https://code.claude.com/docs/ko/monitoring-usage.md#calls-without-a-safety-event). Claude Code v2.1.307 이상이 필요합니다

226* `mcp_server_connection`: MCP 서버 연결 및 연결 실패225* `mcp_server_connection`: MCP 서버 연결 및 연결 실패

227* `permission_mode_changed`: 권한 모드 변경226* `permission_mode_changed`: 권한 모드 변경

228 227 

229이러한 이벤트는 `claude_code.safety_event`와 같이 `claude_code.` 접두사가 붙은 이름의 로그 레코드로 내보내집니다. 모니터링 참조의 [보안 이벤트 감사](https://code.claude.com/docs/ko/monitoring-usage.md#audit-security-events)에서 보안 관련 이벤트의 전체 목록과 각 이벤트가 포함하는 속성을 확인하세요.228이러한 이벤트는 `claude_code.tool_decision`과 같이 `claude_code.` 접두사가 붙은 이름의 로그 레코드로 내보내집니다. 모니터링 참조의 [보안 이벤트 감사](https://code.claude.com/docs/ko/monitoring-usage.md#audit-security-events)에서 보안 관련 이벤트의 전체 목록과 각 이벤트가 포함하는 속성을 확인하세요.

230 229 

231## 내보내기에서 민감한 데이터 제어230## 내보내기에서 민감한 데이터 제어

232 231 

235| 변수 | 추가 내용 |234| 변수 | 추가 내용 |

236| - | - |235| - | - |

237| `OTEL_LOG_USER_PROMPTS=1` | `claude_code.user_prompt` 이벤트 및 `claude_code.interaction` 스팬의 프롬프트 텍스트 |236| `OTEL_LOG_USER_PROMPTS=1` | `claude_code.user_prompt` 이벤트 및 `claude_code.interaction` 스팬의 프롬프트 텍스트 |

238| `OTEL_LOG_TOOL_DETAILS=1` | `claude_code.tool_result` 이벤트의 도구 입력 인수(파일 경로, 셸 명령, 검색 패턴) 및 [비용 및 토큰 메트릭](https://code.claude.com/docs/ko/monitoring-usage.md#cost-counter)의 실제 에이전트, 스킬, 플러그인 및 MCP 서버 이름. 자동 모드 분류기가 호출을 차단할 때 지목한 기본 제공 규칙을 `claude_code.tool_decision` 및 `claude_code.safety_event` 이벤트의 [`classifier_category`](https://code.claude.com/docs/ko/monitoring-usage#tool-decision-event)로 추가합니다 |237| `OTEL_LOG_TOOL_DETAILS=1` | `claude_code.tool_result` 이벤트의 도구 입력 인수(파일 경로, 셸 명령, 검색 패턴) 및 [비용 및 토큰 메트릭](https://code.claude.com/docs/ko/monitoring-usage.md#cost-counter)의 실제 에이전트, 스킬, 플러그인 및 MCP 서버 이름. 자동 모드 분류기가 호출을 차단할 때 지목한 기본 제공 규칙을 `claude_code.tool_decision` 이벤트의 [`classifier_category`](https://code.claude.com/docs/ko/monitoring-usage#tool-decision-event)로 추가합니다 |

239| `OTEL_LOG_TOOL_CONTENT=1` | `claude_code.tool`의 [`tool.output` 스팬 이벤트](https://code.claude.com/docs/ko/monitoring-usage#tool-output-span-event)로 파일 콘텐츠, Bash 출력 및 MCP 도구, WebFetch, WebSearch가 반환하는 내용(기본적으로 60KB에서 잘림, `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`를 통해 구성 가능) Claude Code v2.1.214 이상 필요합니다. MCP 도구, WebFetch, WebSearch의 결과는 Claude Code v2.1.283 이상 필요합니다. [추적](#read-agent-traces)이 활성화되어야 합니다. 스팬 속성은 [자신의 게이트](https://code.claude.com/docs/ko/monitoring-usage.md#new-context-gates) 아래에서 도구 콘텐츠를 전달합니다 |238| `OTEL_LOG_TOOL_CONTENT=1` | `claude_code.tool`의 [`tool.output` 스팬 이벤트](https://code.claude.com/docs/ko/monitoring-usage#tool-output-span-event)로 파일 콘텐츠, Bash 출력 및 MCP 도구, WebFetch, WebSearch가 반환하는 내용(기본적으로 60KB에서 잘림, `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`를 통해 구성 가능) Claude Code v2.1.214 이상 필요합니다. MCP 도구, WebFetch, WebSearch의 결과는 Claude Code v2.1.283 이상 필요합니다. [추적](#read-agent-traces)이 활성화되어야 합니다. 스팬 속성은 [자신의 게이트](https://code.claude.com/docs/ko/monitoring-usage.md#new-context-gates) 아래에서 도구 콘텐츠를 전달합니다 |

240| `OTEL_LOG_RAW_API_BODIES` | `claude_code.api_request_body` 및 `claude_code.api_response_body` 로그 이벤트로 전체 Anthropic Messages API 요청 및 응답 JSON. 인라인 본문의 경우 `1`로 설정하여 기본적으로 60KB에서 잘리거나, 이벤트의 `body_ref` 경로가 있는 디스크의 잘리지 않은 본문의 경우 `file:<dir>`로 설정합니다. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`는 인라인 잘림 제한을 구성하며, Claude Code v2.1.214 이상 필요합니다. 본문에는 전체 대화 기록이 포함되며 확장 사고 콘텐츠가 수정됩니다. 이를 활성화하면 위의 세 변수가 드러낼 모든 것에 대한 동의를 의미합니다 |239| `OTEL_LOG_RAW_API_BODIES` | `claude_code.api_request_body` 및 `claude_code.api_response_body` 로그 이벤트로 전체 Anthropic Messages API 요청 및 응답 JSON. 인라인 본문의 경우 `1`로 설정하여 기본적으로 60KB에서 잘리거나, 이벤트의 `body_ref` 경로가 있는 디스크의 잘리지 않은 본문의 경우 `file:<dir>`로 설정합니다. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`는 인라인 잘림 제한을 구성하며, Claude Code v2.1.214 이상 필요합니다. 본문에는 전체 대화 기록이 포함되며 확장 사고 콘텐츠가 수정됩니다. 이를 활성화하면 위의 세 변수가 드러낼 모든 것에 대한 동의를 의미합니다 |

241 240 

1383| :- | :- | :- |1383| :- | :- | :- |

1384| `adaptive` | `type`, `display` | Claude가 사고할 시기를 적응적으로 결정합니다 |1384| `adaptive` | `type`, `display` | Claude가 사고할 시기를 적응적으로 결정합니다 |

1385| `enabled` | `type`, `budget_tokens`, `display` | 특정 토큰 예산으로 사고 활성화 |1385| `enabled` | `type`, `budget_tokens`, `display` | 특정 토큰 예산으로 사고 활성화 |

1386| `disabled` | `type` | 사고 비활성화 |1386| `disabled` | `type` | [모델과 공급자가 허용하는 경우](https://code.claude.com/docs/ko/model-config.md#where-you-cant-turn-thinking-off) 사고 비활성화 |

1387 1387 

1388선택적 `display` 필드는 사고 텍스트가 `"summarized"` 또는 `"omitted"`로 반환되는지 제어합니다. Claude Opus 4.7 이상에서 API 기본값은 `"omitted"`이므로, [`ThinkingBlock`](#thinkingblock) 출력에서 사고 콘텐츠를 받으려면 `"summarized"`를 설정합니다. Amazon Bedrock 및 Google Cloud의 Agent Platform과 같은 공급자에서 Claude Code는 인식하는 이전 모델에 대해 `display`를 전달하지 않습니다. 해당 모델은 Opus 4.6, Sonnet 4.6, Haiku 4.5 및 그 이전 모델이며, 이들은 자체 기본값을 사용합니다.1388선택적 `display` 필드는 사고 텍스트가 `"summarized"` 또는 `"omitted"`로 반환되는지 제어합니다. Claude Opus 4.7 이상에서 API 기본값은 `"omitted"`이므로, [`ThinkingBlock`](#thinkingblock) 출력에서 사고 콘텐츠를 받으려면 `"summarized"`를 설정합니다. Amazon Bedrock 및 Google Cloud의 Agent Platform과 같은 공급자에서 Claude Code는 인식하는 이전 모델에 대해 `display`를 전달하지 않습니다. 해당 모델은 Opus 4.6, Sonnet 4.6, Haiku 4.5 및 그 이전 모델이며, 이들은 자체 기본값을 사용합니다.

1389 1389 

664| `rewindFiles(userMessageId, options?)` | 지정된 사용자 메시지 시점의 상태로 파일을 복원합니다. 변경 사항을 미리 보려면 `{ dryRun: true }`를 전달하세요. `enableFileCheckpointing: true`가 필요합니다. [파일 체크포인트](https://code.claude.com/docs/ko/agent-sdk/file-checkpointing.md)를 참조하세요 |664| `rewindFiles(userMessageId, options?)` | 지정된 사용자 메시지 시점의 상태로 파일을 복원합니다. 변경 사항을 미리 보려면 `{ dryRun: true }`를 전달하세요. `enableFileCheckpointing: true`가 필요합니다. [파일 체크포인트](https://code.claude.com/docs/ko/agent-sdk/file-checkpointing.md)를 참조하세요 |

665| `setPermissionMode()` | 권한 모드를 변경합니다(스트리밍 입력 모드에서만 사용 가능) |665| `setPermissionMode()` | 권한 모드를 변경합니다(스트리밍 입력 모드에서만 사용 가능) |

666| `setModel()` | 모델을 변경합니다(스트리밍 입력 모드에서만 사용 가능). `undefined` 또는 문자열 `"default"`를 전달하면 [Claude Code의 기본 모델](https://code.claude.com/docs/ko/model-config.md)로 초기화됩니다. 새 모델이 자동 모드를 지원하지 않으면 `auto` 모드의 세션은 [`default` 모드로 변경](https://code.claude.com/docs/ko/agent-sdk/permissions#auto-mode-auto)됩니다 |666| `setModel()` | 모델을 변경합니다(스트리밍 입력 모드에서만 사용 가능). `undefined` 또는 문자열 `"default"`를 전달하면 [Claude Code의 기본 모델](https://code.claude.com/docs/ko/model-config.md)로 초기화됩니다. 새 모델이 자동 모드를 지원하지 않으면 `auto` 모드의 세션은 [`default` 모드로 변경](https://code.claude.com/docs/ko/agent-sdk/permissions#auto-mode-auto)됩니다 |

667| `setMaxThinkingTokens()` | *지원 중단:* 대신 `thinking` 옵션을 사용하세요. 최대 사고 토큰 수를 변경합니다. `null`을 전달하면 사고가 세션 기본값으로 재설정됩니다. 세션 중 재정의는 지워지며, 사고가 비활성화된 세션에서는 계속 꺼진 상태로 유지됩니다 |667| `setMaxThinkingTokens()` | *지원 중단:* 대신 `thinking` 옵션을 사용하세요. 최대 사고 토큰 수를 변경합니다. 이전 호출을 취소하고 세션이 시작될 때의 `thinking` 또는 `maxThinkingTokens` 옵션을 복원하려면 `null`을 전달하세요 |

668| `applyFlagSettings(settings)` | 런타임에 세션의 플래그 설정 계층에 설정을 병합합니다(스트리밍 입력 모드에서만 사용 가능). [`applyFlagSettings()`](#applyflagsettings)를 참조하세요 |668| `applyFlagSettings(settings)` | 런타임에 세션의 플래그 설정 계층에 설정을 병합합니다(스트리밍 입력 모드에서만 사용 가능). [`applyFlagSettings()`](#applyflagsettings)를 참조하세요 |

669| `updateSettings(source, settings)` | 허용 목록에 있는 키 하나를 프로젝트의 로컬 설정 파일 또는 사용자 설정 파일에 기록하여, 이후 세션에서도 값이 유지되도록 합니다. [`updateSettings()`](#updatesettings)를 참조하세요. Claude Code v2.1.257이 번들된 TypeScript SDK v0.3.257 이상이 필요합니다 |669| `updateSettings(source, settings)` | 허용 목록에 있는 키 하나를 프로젝트의 로컬 설정 파일 또는 사용자 설정 파일에 기록하여, 이후 세션에서도 값이 유지되도록 합니다. [`updateSettings()`](#updatesettings)를 참조하세요. Claude Code v2.1.257이 번들된 TypeScript SDK v0.3.257 이상이 필요합니다 |

670| `initializationResult()` | 지원되는 명령, 모델, 계정 정보, 출력 스타일 구성을 포함한 전체 초기화 결과를 반환합니다 |670| `initializationResult()` | 지원되는 명령, 모델, 계정 정보, 출력 스타일 구성을 포함한 전체 초기화 결과를 반환합니다 |

5428type ThinkingConfig =5428type ThinkingConfig =

5429 | { type: "adaptive"; display?: ThinkingDisplay } // The model determines when and how much to reason (Opus 4.6+)5429 | { type: "adaptive"; display?: ThinkingDisplay } // The model determines when and how much to reason (Opus 4.6+)

5430 | { type: "enabled"; budgetTokens?: number; display?: ThinkingDisplay } // Fixed thinking token budget5430 | { type: "enabled"; budgetTokens?: number; display?: ThinkingDisplay } // Fixed thinking token budget

5431 | { type: "disabled" }; // No extended thinking5431 | { type: "disabled" }; // Turn thinking off where the model and provider allow it

5432```5432```

5433 5433 

5434`disabled`에 대해서는 [사고를 끌 수 없는 경우](https://code.claude.com/docs/ko/model-config.md#where-you-cant-turn-thinking-off)를 참조하세요.

5435 

5434선택적 `display` 필드는 사고 텍스트를 `"summarized"`로 반환할지 `"omitted"`로 반환할지 제어합니다. Claude Opus 4.7 이상에서 API 기본값은 `"omitted"`이므로, `thinking` 블록에서 사고 내용을 받으려면 `"summarized"`로 설정합니다. Amazon Bedrock이나 Google Cloud의 Agent Platform 같은 제공자에서 Claude Code는 자신이 인식하는 이전 모델에 대해 `display`를 전달하지 않습니다. 해당 모델은 Opus 4.6, Sonnet 4.6, Haiku 4.5 및 그 이전 모델이며, 이 모델들은 자체 기본값을 사용합니다.5436선택적 `display` 필드는 사고 텍스트를 `"summarized"`로 반환할지 `"omitted"`로 반환할지 제어합니다. Claude Opus 4.7 이상에서 API 기본값은 `"omitted"`이므로, `thinking` 블록에서 사고 내용을 받으려면 `"summarized"`로 설정합니다. Amazon Bedrock이나 Google Cloud의 Agent Platform 같은 제공자에서 Claude Code는 자신이 인식하는 이전 모델에 대해 `display`를 전달하지 않습니다. 해당 모델은 Opus 4.6, Sonnet 4.6, Haiku 4.5 및 그 이전 모델이며, 이 모델들은 자체 기본값을 사용합니다.

5435 5437 

5436### `SpawnedProcess`5438### `SpawnedProcess`

169 169 

170목록이 [디렉토리별로 그룹화](#organize-the-list)될 때 요약은 `Needs input · double jump or wall climb?`와 같이 색상이 지정된 단어로 된 세션의 상태로 시작합니다. 기본 상태 그룹화에서는 그룹 헤더가 이미 상태를 명명하므로 행은 요약만 표시합니다.170목록이 [디렉토리별로 그룹화](#organize-the-list)될 때 요약은 `Needs input · double jump or wall climb?`와 같이 색상이 지정된 단어로 된 세션의 상태로 시작합니다. 기본 상태 그룹화에서는 그룹 헤더가 이미 상태를 명명하므로 행은 요약만 표시합니다.

171 171 

172턴 끝 요약 및 각 중간 다시 작성은 일반 제공자를 통한 하나의 짧은 Haiku 클래스 요청이며, 세션 자체와 동일한 [데이터 사용 약관](https://code.claude.com/docs/ko/data-usage.md)에 따라 청구되고 처리됩니다. 모델 다시 작성 사이의 15초 업데이트는 세션의 자체 출력을 재사용하며 요청을 보내지 않습니다. Haiku 클래스 모델이 구성되지 않은 타사 제공자 또는 게이트웨이에서는 요청이 대신 세션의 주 모델을 사용합니다. 모델을 선택하려면 [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](https://code.claude.com/docs/ko/model-config#environment-variables)을 설정합니다.172#### 행 요약 비용

173 

174턴 끝 요약 및 각 턴 중간 다시 작성은 일반 제공자를 통한 하나의 짧은 요청이며, 세션 자체와 동일한 [데이터 사용 약관](https://code.claude.com/docs/ko/data-usage.md)에 따라 청구되고 처리됩니다. 타사 제공자 또는 게이트웨이에서는 요약에 [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](https://code.claude.com/docs/ko/model-config#environment-variables)에 설정한 모델이 사용됩니다. 이 값이 설정되지 않은 경우 요약은 제공자의 백그라운드 작업용 모델을 사용합니다: [Amazon Bedrock](https://code.claude.com/docs/ko/amazon-bedrock.md#4-pin-model-versions), [Google Cloud의 Agent Platform](https://code.claude.com/docs/ko/google-vertex-ai.md#5-pin-model-versions), [Microsoft Foundry](https://code.claude.com/docs/ko/microsoft-foundry.md#4-pin-model-versions) 또는 사용 중인 [게이트웨이](https://code.claude.com/docs/ko/llm-gateway-protocol.md#requests-and-defaults-by-connection-method)를 참조하세요.

173 175 

174### 풀 리퀘스트 상태176### 풀 리퀘스트 상태

175 177 

74 74 

75Claude Code가 브라우저 작업 전에 권한을 요청하면 승인합니다. 대화 상자는 `Claude in Chrome wants to`로 시작하며, 해당 세션 동안 그 사이트의 모든 작업을 허용하는 옵션을 제공합니다. Claude가 새 탭을 열고 작업을 시작합니다.75Claude Code가 브라우저 작업 전에 권한을 요청하면 승인합니다. 대화 상자는 `Claude in Chrome wants to`로 시작하며, 해당 세션 동안 그 사이트의 모든 작업을 허용하는 옵션을 제공합니다. Claude가 새 탭을 열고 작업을 시작합니다.

76 76 

77언제든지 `/chrome`을 실행하여 연결 상태를 확인하고, 권한을 관리하고, 확장 프로그램을 다시 연결하거나, 사용할 연결된 브라우저를 선택할 수 있습니다. 상태 패널에 `Status: Enabled` 및 `Extension: Installed`가 표시되면 통합 기능이 정상적으로 작동하는 것입니다.77언제든지 `/chrome`을 실행하여 연결 상태를 확인하고, 권한을 관리하고, 확장 프로그램을 다시 연결하거나, 사용할 연결된 브라우저를 선택할 수 있습니다. 상태 패널에 "상태: 활성화됨" 및 "확장 프로그램: 설치됨"이 표시되면 통합 기능이 정상적으로 작동하는 것입니다.

78 78 

79둘 이상의 브라우저가 연결되어 있으면 Claude가 사용할 브라우저를 사용자가 선택합니다. 선택하기 전에 브라우저 작업이 시작되면 Claude가 브라우저를 하나 선택하도록 요청합니다. 나중에 브라우저를 전환하려면 `/chrome`을 실행하고 \*\*Select browser…\*\*를 선택합니다. 다른 브라우저가 연결되더라도 Claude는 사용자가 선택한 브라우저를 계속 사용합니다.79둘 이상의 브라우저가 연결되어 있으면 Claude가 사용할 브라우저를 사용자가 선택합니다. 선택하기 전에 브라우저 작업이 시작되면 Claude가 브라우저를 하나 선택하도록 요청합니다. 나중에 브라우저를 전환하려면 `/chrome`을 실행하고 \*\*Select browser…\*\*를 선택합니다. 다른 브라우저가 연결되더라도 Claude는 사용자가 선택한 브라우저를 계속 사용합니다.

80 80 

97 97 

98### 기본으로 Chrome 활성화하기98### 기본으로 Chrome 활성화하기

99 99 

100매번 `--chrome`을 전달하지 않고 Chrome을 연결하려면 CLI 세션에서 `/chrome`을 실행하고 \*\*`Enabled by default`\*\*를 선택합니다. [VS Code 확장 프로그램](https://code.claude.com/docs/ko/vs-code.md#automate-browser-tasks-with-chrome)에서는 프롬프트 상자에 `/chrome`을 입력하고 **`Enabled by default`** 스위치를 켭니다. 두 곳은 하나의 설정을 공유하므로 어느 쪽에서 켜든 CLI와 VS Code 모두에서 켜집니다.100매번 `--chrome`을 전달하지 않고 Chrome을 연결하려면 CLI 세션에서 `/chrome`을 실행하고 **기본으로 활성화**를 선택합니다. [VS Code 확장 프로그램](https://code.claude.com/docs/ko/vs-code.md#automate-browser-tasks-with-chrome)에서는 프롬프트 상자에 `/chrome`을 입력하고 **기본으로 활성화** 스위치를 켭니다. 두 곳은 하나의 설정을 공유하므로 어느 쪽에서 켜든 CLI와 VS Code 모두에서 켜집니다.

101 101 

102이 설정이 켜져 있고 Claude Code v2.1.287 이상을 사용하면 각 VS Code 세션이 시작될 때 브라우저에 연결되므로, 사용자가 `@browser`를 입력하기 전에도 Claude가 브라우저를 사용할 수 있습니다. 이전 버전이거나 설정이 꺼져 있으면 VS Code 세션은 `@browser`를 입력할 때 연결됩니다.102이 설정이 켜져 있고 Claude Code v2.1.287 이상을 사용하면 각 VS Code 세션이 시작될 때 브라우저에 연결되므로, 사용자가 `@browser`를 입력하기 전에도 Claude가 브라우저를 사용할 수 있습니다. 이전 버전이거나 설정이 꺼져 있으면 VS Code 세션은 `@browser`를 입력할 때 연결됩니다.

103 103 

109 109 

110### 시작 대화 상자에 응답하기110### 시작 대화 상자에 응답하기

111 111 

112`claude`를 시작할 때 "Claude in Chrome extension detected" 대화 상자가 나타나면, 선택한 응답에 따라 [**`Enabled by default`** 설정](#enable-chrome-by-default)이 변경됩니다.112`claude`를 시작할 때 "Claude in Chrome extension detected" 대화 상자가 나타나면, 선택한 응답에 따라 [**기본으로 활성화** 설정](#enable-chrome-by-default)이 변경됩니다.

113 113 

114* **Yes, use my browser**: 설정을 켜고 이 세션을 연결합니다114* **Yes, use my browser**: 설정을 켜고 이 세션을 연결합니다

115* **No, keep browser tools off** 또는 Esc: 설정을 끄며, Claude Code는 더 이상 Chrome 설정을 제안하지 않습니다115* **No, keep browser tools off** 또는 Esc: 설정을 끄며, Claude Code는 더 이상 Chrome 설정을 제안하지 않습니다

124 124 

125VS Code 세션에서 Claude Code가 브라우저 작업 전에 확인을 요청하면 프롬프트가 채팅 패널에 카드 형태로 나타납니다. 작업 대상이 허용하지 않은 사이트인 경우 카드에서 해당 사이트를 허용하는 옵션도 제공합니다.125VS Code 세션에서 Claude Code가 브라우저 작업 전에 확인을 요청하면 프롬프트가 채팅 패널에 카드 형태로 나타납니다. 작업 대상이 허용하지 않은 사이트인 경우 카드에서 해당 사이트를 허용하는 옵션도 제공합니다.

126 126 

127[기본으로 Chrome 활성화](#enable-chrome-by-default)가 켜져 있어 시작 시 브라우저에 연결된 세션에서는, Manual, Edit automatically, Auto, Bypass permissions 모드에서 허용하지 않은 사이트에 대한 브라우저 작업 전에 Claude Code가 사용자에게 확인을 요청합니다. Auto 및 Bypass permissions 모드에서는 해당 세션에서 `@browser`를 입력할 때까지 이 동작이 적용됩니다.127[기본으로 활성화](#enable-chrome-by-default)가 켜져 있어 시작 시 브라우저에 연결된 세션에서는, Manual, Edit automatically, Auto, Bypass permissions 모드에서 허용하지 않은 사이트에 대한 브라우저 작업 전에 Claude Code가 사용자에게 확인을 요청합니다. Auto 및 Bypass permissions 모드에서는 해당 세션에서 `@browser`를 입력할 때까지 이 동작이 적용됩니다.

128 128 

129### 플랜 모드의 브라우저 도구129### 플랜 모드의 브라우저 도구

130 130 

131[플랜 모드](https://code.claude.com/docs/ko/permission-modes.md#analyze-before-you-edit-with-plan-mode)에서는 Claude가 GIF를 녹화하거나, 새 탭을 열거나, 단축키를 실행하기 전에 권한 프롬프트가 나타납니다. 대화형 CLI 세션에서 [bypass permissions 모드를 사용할 수 있고](https://code.claude.com/docs/ko/permission-modes.md#skip-all-checks-with-bypasspermissions-mode) [기능 플래그 가져오기](https://code.claude.com/docs/ko/env-vars.md#features-that-need-feature-flag-fetching)가 꺼져 있으면 이러한 호출은 프롬프트 없이 실행됩니다.131[플랜 모드](https://code.claude.com/docs/ko/permission-modes.md#analyze-before-you-edit-with-plan-mode)에서는 Claude가 GIF를 녹화하거나 새 탭을 열기 전에 권한 프롬프트가 나타납니다. 대화형 CLI 세션에서 [bypass permissions 모드를 사용할 수 있고](https://code.claude.com/docs/ko/permission-modes.md#skip-all-checks-with-bypasspermissions-mode) [기능 플래그 가져오기](https://code.claude.com/docs/ko/env-vars.md#features-that-need-feature-flag-fetching)가 꺼져 있으면 이러한 호출은 프롬프트 없이 실행됩니다.

132 132 

133`tabs_context_mcp` 호출도 `createIfEmpty`를 설정하면 확인을 요청하며, 이러한 작업 중 하나라도 포함하는 `browser_batch` 호출도 마찬가지입니다.133`tabs_context_mcp` 호출도 `createIfEmpty`를 설정하면 확인을 요청하며, 이러한 작업 중 하나라도 포함하는 `browser_batch` 호출도 마찬가지입니다.

134 134 

313>313>

314> `gatewayInternalNetworks`는 공인 주소 공간으로 번호가 지정된 내부 네트워크를 위한 것입니다. 이 설정이 게이트웨이를 인터넷에 노출하는 것을 안전하게 만들지는 않습니다. 신뢰된 게이트웨이는 개발자 머신에서 명령을 실행하는 설정을 푸시할 수 있습니다.314> `gatewayInternalNetworks`는 공인 주소 공간으로 번호가 지정된 내부 네트워크를 위한 것입니다. 이 설정이 게이트웨이를 인터넷에 노출하는 것을 안전하게 만들지는 않습니다. 신뢰된 게이트웨이는 개발자 머신에서 명령을 실행하는 설정을 푸시할 수 있습니다.

315>315>

316> 방화벽 또는 로드 밸런서 규칙으로 게이트웨이가 네트워크 외부에서 접근할 수 없도록 유지하세요. 게이트웨이의 [`access_control.allow_cidrs`](https://code.claude.com/docs/ko/claude-apps-gateway-config#http-tuning)를 여기에서 선언한 것과 동일한 블록으로 설정하여 게이트웨이 자체가 다른 곳의 클라이언트를 거부하도록 하세요. 로드 밸런서나 인그레스 뒤에서는 `listen.trusted_proxies`도 해당 프런트 엔드로 설정하세요. 그렇지 않으면 게이트웨이가 개발자의 주소가 아니라 프런트 엔드 자체의 주소를 `allow_cidrs`와 대조하기 때문입니다.316> 방화벽 또는 로드 밸런서 규칙으로 게이트웨이가 네트워크 외부에서 접근할 수 없도록 유지하세요. 게이트웨이의 [`access_control.allow_cidrs`](https://code.claude.com/docs/ko/claude-apps-gateway-config#http-tuning)를 여기에서 선언한 것과 동일한 블록으로 설정하세요. 로드 밸런서나 인그레스가 [`listen.trusted_proxies`에 속하는 경우](https://code.claude.com/docs/ko/claude-apps-gateway-config#listen) 그곳에도 나열하세요. 그렇지 않으면 게이트웨이가 개발자의 주소가 아니라 프런트 엔드 자체의 주소를 `allow_cidrs`와 대조하기 때문입니다.

317 317 

318이 키는 로그인 키와 동일한 관리형 설정 소스, 즉 관리형 설정 파일, MDM 프로필 또는 레지스트리 정책에 추가하세요. Claude Code는 사용자, 프로젝트, 서버 관리형 설정에 있는 이 키를 무시합니다.318이 키는 로그인 키와 동일한 관리형 설정 소스, 즉 관리형 설정 파일, MDM 프로필 또는 레지스트리 정책에 추가하세요. Claude Code는 사용자, 프로젝트, 서버 관리형 설정에 있는 이 키를 무시합니다.

319 319 

59| `port` | 아니요 | 바인드 포트입니다. 기본값은 `8080`입니다. |59| `port` | 아니요 | 바인드 포트입니다. 기본값은 `8080`입니다. |

60| `public_url` | `host`가 루프백이 아닌 경우 | 외부에 노출되는 `https://` 오리진으로, IdP `redirect_uri`와 디스커버리 메타데이터를 구성하는 데 사용됩니다. TLS가 ALB, Ingress, Cloud Run 같은 프록시에서 종료되든 `tls`를 통해 게이트웨이 자체에서 종료되든, `host`가 루프백 주소가 아니면 항상 필요합니다. 게이트웨이는 클라이언트가 위조할 수 있는 `X-Forwarded-*` 헤더로부터 자신의 오리진을 도출하지 않기 때문입니다. 이 값이 없으면 부팅이 실패합니다. 아래의 `trusted_proxies`는 클라이언트 IP 확인에만 적용됩니다. 게이트웨이가 클라이언트에 전달하는 OTLP 엔드포인트를 이 URL로부터 구성하므로 [텔레메트리](#telemetry)를 활성화할 때도 필요합니다. |60| `public_url` | `host`가 루프백이 아닌 경우 | 외부에 노출되는 `https://` 오리진으로, IdP `redirect_uri`와 디스커버리 메타데이터를 구성하는 데 사용됩니다. TLS가 ALB, Ingress, Cloud Run 같은 프록시에서 종료되든 `tls`를 통해 게이트웨이 자체에서 종료되든, `host`가 루프백 주소가 아니면 항상 필요합니다. 게이트웨이는 클라이언트가 위조할 수 있는 `X-Forwarded-*` 헤더로부터 자신의 오리진을 도출하지 않기 때문입니다. 이 값이 없으면 부팅이 실패합니다. 아래의 `trusted_proxies`는 클라이언트 IP 확인에만 적용됩니다. 게이트웨이가 클라이언트에 전달하는 OTLP 엔드포인트를 이 URL로부터 구성하므로 [텔레메트리](#telemetry)를 활성화할 때도 필요합니다. |

61| `tls.cert` / `tls.key` | 아니요 | 게이트웨이가 TLS를 직접 종료하는 경우의 PEM 경로 |61| `tls.cert` / `tls.key` | 아니요 | 게이트웨이가 TLS를 직접 종료하는 경우의 PEM 경로 |

62| `trusted_proxies` | 아니요 | 게이트웨이 앞에 있는 로드 밸런서의 CIDR 또는 IP입니다. 설정하면 게이트웨이는 이 피어에서 온 `X-Forwarded-For`만 신뢰하고, IP별 속도 제한과 감사를 위해 실제 클라이언트 IP를 기록합니다. nginx의 `set_real_ip_from`과 같습니다. 일부 로드 밸런서처럼 `ipv4:port` 또는 `[ipv6]:port` 형식으로 작성된 `X-Forwarded-For` 항목은 포트를 제외하고 읽습니다. 대괄호 없이 포트가 붙은 IPv6 주소는 다른 주소로 읽히거나 아예 읽히지 않을 수 있으므로, 그런 형식을 쓰는 프록시에서는 포트 옵션을 끄십시오. |62| `trusted_proxies` | 아니요 | 신뢰할 프런트엔드의 CIDR 또는 IP. 설정하면 게이트웨이는 이 피어에서 온 `X-Forwarded-For`만 신뢰하고, IP별 속도 제한과 감사를 위해 실제 클라이언트 IP를 기록합니다. |

63 

64프런트엔드가 전달하는 마지막 `X-Forwarded-For` 항목이 어떤 개발자도 작성하지 않은 항목인 경우에만 해당 프런트엔드를 `trusted_proxies`에 나열하세요. 개발자가 연결하는 주소나 범위는 나열하지 마세요. 받은 각 연결의 주소를 덧붙이는 프런트엔드는 조건을 충족합니다. 개발자가 보낸 헤더를 그대로 전달하는 프런트엔드는 충족하지 않습니다.

65 

66일부 로드 밸런서처럼 `ipv4:port` 또는 `[ipv6]:port` 형식으로 작성된 `X-Forwarded-For` 항목은 포트를 제외하고 읽힙니다. 대괄호 없이 포트가 붙은 IPv6 주소는 다른 주소로 읽히거나 전혀 읽히지 않을 수 있습니다. 그런 형식을 작성하는 프록시에서는 포트 옵션을 끄세요.

63 67 

64### `oidc`68### `oidc`

65 69 

1659 1663 

1660두 신호 모두 게이트웨이가 확인한 클라이언트 주소를 사용합니다. 로드 밸런서, 포트 포워드 또는 터널이 트래픽을 중계하면서 `listen.trusted_proxies`에 등록되어 있지 않으면, 게이트웨이는 일반적으로 사설 주소인 중계 장치의 주소를 보게 되므로 런타임 경고와 사설 허용 목록 모두 이를 통해 중계된 트래픽을 잡아내지 못합니다.1664두 신호 모두 게이트웨이가 확인한 클라이언트 주소를 사용합니다. 로드 밸런서, 포트 포워드 또는 터널이 트래픽을 중계하면서 `listen.trusted_proxies`에 등록되어 있지 않으면, 게이트웨이는 일반적으로 사설 주소인 중계 장치의 주소를 보게 되므로 런타임 경고와 사설 허용 목록 모두 이를 통해 중계된 트래픽을 잡아내지 못합니다.

1661 1665 

1662이러한 프런트 엔드 뒤에서는 게이트웨이가 실제 클라이언트 주소를 볼 수 있도록 먼저 [`listen.trusted_proxies`](#listen)를 설정하고, 어떤 경우에도 게이트웨이와 그 앞에 있는 모든 것이 공용 인터넷에서 접근할 수 없도록 유지합니다.1666중계자가 [`listen.trusted_proxies`에 속하는 경우](#listen) 그곳에 나열하십시오. 어떤 경우든 게이트웨이와 그 앞에 있는 모든 것이 공용 인터넷에서 도달할 수 없도록 유지하십시오.

1663 1667 

1664### `load_test_mode`1668### `load_test_mode`

1665 1669 

131 131 

132로그인은 클라이언트 IP 주소별로 속도 제한되며, 기본값은 소규모 팀에 적합합니다. 각 주소는 10분마다 30개의 로그인 시작과 10개의 코드 제출을 받습니다. 수천 명의 개발자로의 롤아웃은 첫 번째 아침에 해당 제한에 도달할 수 있으며, 두 가지 이유 중 하나입니다:132로그인은 클라이언트 IP 주소별로 속도 제한되며, 기본값은 소규모 팀에 적합합니다. 각 주소는 10분마다 30개의 로그인 시작과 10개의 코드 제출을 받습니다. 수천 명의 개발자로의 롤아웃은 첫 번째 아침에 해당 제한에 도달할 수 있으며, 두 가지 이유 중 하나입니다:

133 133 

134* **게이트웨이가 로드 밸런서를 볼 수 없습니다.** [`listen.trusted_proxies`](https://code.claude.com/docs/ko/claude-apps-gateway-config#listen)가 없으면, 모든 개발자가 로드 밸런서의 주소에서 오는 것으로 나타나고 하나의 제한을 공유합니다. 다른 모든 것보다 먼저 설정하세요. 게이트웨이는 `X-Forwarded-For` 헤더를 무시할 때 처음으로 경고를 기록합니다.134* **게이트웨이가 로드 밸런서 너머를 볼 수 없습니다.** [`listen.trusted_proxies`](https://code.claude.com/docs/ko/claude-apps-gateway-config#listen)가 없으면, 모든 개발자가 로드 밸런서의 주소에서 오는 것으로 나타나고 하나의 제한을 공유합니다. 게이트웨이는 `X-Forwarded-For` 헤더를 처음 무시할 때 경고를 로그에 기록합니다. 로드 밸런서가 [`listen.trusted_proxies`에 속하는 경우](https://code.claude.com/docs/ko/claude-apps-gateway-config#listen), 다른 것을 변경하기 전에 먼저 나열하세요. 그래도 개발자가 하나의 주소를 공유한다면 [`rate_limits`](https://code.claude.com/docs/ko/claude-apps-gateway-config#http-tuning)를 올리세요.

135* **많은 개발자가 몇 개의 NAT 또는 VPN 송신 주소를 공유합니다.** `trusted_proxies`가 올바를 때도 해당 주소의 제한을 공유합니다. [`rate_limits`](https://code.claude.com/docs/ko/claude-apps-gateway-config#http-tuning)를 맞추도록 올리세요.135* **많은 개발자가 몇 개의 NAT 또는 VPN 송신 주소를 공유합니다.** `trusted_proxies`가 올바를 때도 해당 주소의 제한을 공유합니다. [`rate_limits`](https://code.claude.com/docs/ko/claude-apps-gateway-config#http-tuning)를 맞추도록 올리세요.

136 136 

137`max`를 크기 조정하려면, 개발자를 공유하는 송신 주소로 나누세요. 기본값인 10분인 하나의 `window_seconds` 기간 내에 그 중 몇 명이 로그인하는지 추정하세요. 그런 다음 재시도 및 Claude Code와 Claude Desktop 모두에 로그인하는 개발자를 포함하도록 두 배로 늘리세요.137`max`를 크기 조정하려면, 개발자를 공유하는 송신 주소로 나누세요. 기본값인 10분인 하나의 `window_seconds` 기간 내에 그 중 몇 명이 로그인하는지 추정하세요. 그런 다음 재시도 및 Claude Code와 Claude Desktop 모두에 로그인하는 개발자를 포함하도록 두 배로 늘리세요.

418| 시작 시 `Gateway login is configured in managed settings, but this Claude Code build does not include Cloud gateway support.`를 표시함 | 설치된 Claude Code 빌드가 gateway 지원보다 이전 버전임 | 개발자가 Cloud gateway 지원을 포함하는 릴리스로 Claude Code를 업데이트하도록 하세요 |418| 시작 시 `Gateway login is configured in managed settings, but this Claude Code build does not include Cloud gateway support.`를 표시함 | 설치된 Claude Code 빌드가 gateway 지원보다 이전 버전임 | 개발자가 Cloud gateway 지원을 포함하는 릴리스로 Claude Code를 업데이트하도록 하세요 |

419| 시작이 `Administrator policy requires a Cloud gateway sign-in on this machine`으로 종료됨 | 개발자의 환경이 `ANTHROPIC_API_KEY` 또는 `ANTHROPIC_AUTH_TOKEN`을 설정하거나, 설정이 [`apiKeyHelper`](https://code.claude.com/docs/ko/settings-reference#apikeyhelper)를 구성하거나, 이전 Claude Console 로그인의 API 키가 여전히 저장되어 있음 | 해당하는 각각을 지우도록 개발자에게 지시하세요: 변수를 설정 해제하거나, `apiKeyHelper` 항목을 제거하거나, `claude auth logout`을 실행하여 저장된 키를 제거합니다. `CLAUDE_CODE_USE_*`를 사용하여 클라우드 공급자를 선택하는 세션은 로그인 없이 시작됩니다. 다른 모든 세션의 경우 개발자가 `claude`를 시작하고 `/login`으로 로그인하도록 하세요. [관리자 정책이 Cloud gateway 로그인을 요구함](https://code.claude.com/docs/ko/errors.md#administrator-policy-requires-a-cloud-gateway-sign-in)도 참조하세요. |419| 시작이 `Administrator policy requires a Cloud gateway sign-in on this machine`으로 종료됨 | 개발자의 환경이 `ANTHROPIC_API_KEY` 또는 `ANTHROPIC_AUTH_TOKEN`을 설정하거나, 설정이 [`apiKeyHelper`](https://code.claude.com/docs/ko/settings-reference#apikeyhelper)를 구성하거나, 이전 Claude Console 로그인의 API 키가 여전히 저장되어 있음 | 해당하는 각각을 지우도록 개발자에게 지시하세요: 변수를 설정 해제하거나, `apiKeyHelper` 항목을 제거하거나, `claude auth logout`을 실행하여 저장된 키를 제거합니다. `CLAUDE_CODE_USE_*`를 사용하여 클라우드 공급자를 선택하는 세션은 로그인 없이 시작됩니다. 다른 모든 세션의 경우 개발자가 `claude`를 시작하고 `/login`으로 로그인하도록 하세요. [관리자 정책이 Cloud gateway 로그인을 요구함](https://code.claude.com/docs/ko/errors.md#administrator-policy-requires-a-cloud-gateway-sign-in)도 참조하세요. |

420| 시작 또는 `/login`이 `/managed/settings` 로드에서 403 후 `Claude Code may not be enabled for your organization`을 보고함 | gateway 또는 그 앞의 무언가가 `/managed/settings` 요청에 403으로 응답함. gateway 자체 설정 경로는 절대 403으로 응답하지 않음. 상태는 [`access_control`](https://code.claude.com/docs/ko/claude-apps-gateway-config#http-tuning) IP 확인 또는 gateway 앞의 프록시 또는 WAF에서 옴. 감사 로그는 IP 확인 거부를 `access.denied`로 이유와 함께 기록함. 개발자는 로그인 상태를 유지함 | 실패 시간에 `access.denied`에 대한 감사 로그를 확인하고 `access_control` 목록 또는 프론트 엔드를 수정한 후 개발자가 `claude`를 다시 시작하도록 하세요 |420| 시작 또는 `/login`이 `/managed/settings` 로드에서 403 후 `Claude Code may not be enabled for your organization`을 보고함 | gateway 또는 그 앞의 무언가가 `/managed/settings` 요청에 403으로 응답함. gateway 자체 설정 경로는 절대 403으로 응답하지 않음. 상태는 [`access_control`](https://code.claude.com/docs/ko/claude-apps-gateway-config#http-tuning) IP 확인 또는 gateway 앞의 프록시 또는 WAF에서 옴. 감사 로그는 IP 확인 거부를 `access.denied`로 이유와 함께 기록함. 개발자는 로그인 상태를 유지함 | 실패 시간에 `access.denied`에 대한 감사 로그를 확인하고 `access_control` 목록 또는 프론트 엔드를 수정한 후 개발자가 `claude`를 다시 시작하도록 하세요 |

421| CLI `/login`: `The gateway is limiting sign-in attempts right now`, 또는 이전 버전에서 `Request failed with status code 429`. `/device` 페이지는 이전에 시도하지 않은 개발자에게 `Too many attempts`를 표시할 수 있음 | IP당 로그인 속도 제한에 도달함. `listen.trusted_proxies`가 로드 밸런서를 포함하지 않아 모든 개발자가 해당 주소를 공유하거나, 많은 개발자가 NAT 또는 VPN 송신 주소를 공유함. `result: rate_limited`가 있는 감사 이벤트는 동일한 하나 또는 몇 개의 `client_ip` 값을 표시함. | 먼저 `listen.trusted_proxies`를 로드 밸런서의 소스 범위로 설정한 후, 개발자가 여전히 주소를 공유하는 경우 `rate_limits`를 높이세요. [대규모 롤아웃](#large-rollouts)을 참조하세요. |421| CLI `/login`: `The gateway is limiting sign-in attempts right now`, 또는 이전 버전에서 `Request failed with status code 429`. `/device` 페이지는 이전에 시도하지 않은 개발자에게 `Too many attempts`를 표시할 수 있음 | IP당 로그인 속도 제한에 도달함. `listen.trusted_proxies`가 로드 밸런서를 포함하지 않아 모든 개발자가 해당 주소를 공유하거나, 많은 개발자가 NAT 또는 VPN 송신 주소를 공유함. `result: rate_limited`가 있는 감사 이벤트는 동일한 하나 또는 몇 개의 `client_ip` 값을 표시함. | 로드 밸런서가 [`listen.trusted_proxies`에 속하는 경우](https://code.claude.com/docs/ko/claude-apps-gateway-config#listen) 먼저 이를 나열하세요. 그런 다음 개발자가 여전히 주소를 공유하는 경우 `rate_limits`를 높이세요. [대규모 롤아웃](#large-rollouts)을 참조하세요. |

422| CLI `/login`: `Gateway hosts must be on your organization's private network; <host> resolves to the public (or unrecognized) address <ip>` | gateway 호스트명이 최소 하나의 공개 IP 주소로 확인됨. Claude Code는 각 확인된 주소를 확인하고 모든 주소가 비공개여야 함. 일반적인 원인은 한 패밀리가 공개 주소로 확인되는 이중 스택 이름이며, AWS 내부 이중 스택 로드 밸런서를 포함하여 공개 범위 AAAA 주소를 반환함 | gateway 이름이 개발자 머신에서 비공개 주소로만 확인되도록 하세요. 이중 스택 이름의 경우 공개 범위 레코드를 삭제하거나 별도의 내부 전용 DNS 이름을 제공하세요. [비공개 네트워크 전제 조건](https://code.claude.com/docs/ko/claude-apps-gateway#prerequisites)을 참조하세요. 주소가 조직이 소유하고 내부적으로 사용하는 공개 공간인 경우 [해당 블록을 선언](https://code.claude.com/docs/ko/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own)하세요. |422| CLI `/login`: `Gateway hosts must be on your organization's private network; <host> resolves to the public (or unrecognized) address <ip>` | gateway 호스트명이 최소 하나의 공개 IP 주소로 확인됨. Claude Code는 각 확인된 주소를 확인하고 모든 주소가 비공개여야 함. 일반적인 원인은 한 패밀리가 공개 주소로 확인되는 이중 스택 이름이며, AWS 내부 이중 스택 로드 밸런서를 포함하여 공개 범위 AAAA 주소를 반환함 | gateway 이름이 개발자 머신에서 비공개 주소로만 확인되도록 하세요. 이중 스택 이름의 경우 공개 범위 레코드를 삭제하거나 별도의 내부 전용 DNS 이름을 제공하세요. [비공개 네트워크 전제 조건](https://code.claude.com/docs/ko/claude-apps-gateway#prerequisites)을 참조하세요. 주소가 조직이 소유하고 내부적으로 사용하는 공개 공간인 경우 [해당 블록을 선언](https://code.claude.com/docs/ko/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own)하세요. |

423| CLI `/login`: `Gateway login would go through proxy <proxy>, which is not on a private network` | `HTTPS_PROXY` 또는 `HTTP_PROXY`가 gateway 호스트에 적용되고 프록시의 호스트명이 공개 주소로 확인됨. 호스트가 비공개 주소로만 확인되는 프록시는 허용되며 이 오류를 트리거하지 않음 | 개발자 머신의 `NO_PROXY`에 gateway 호스트를 추가하여 연결이 직접 이루어지도록 하거나, 호스트명이 비공개 주소로 확인되는 프록시를 사용하세요. 메시지는 추가할 정확한 `NO_PROXY` 항목을 이름으로 지정합니다 |423| CLI `/login`: `Gateway login would go through proxy <proxy>, which is not on a private network` | `HTTPS_PROXY` 또는 `HTTP_PROXY`가 gateway 호스트에 적용되고 프록시의 호스트명이 공개 주소로 확인됨. 호스트가 비공개 주소로만 확인되는 프록시는 허용되며 이 오류를 트리거하지 않음 | 개발자 머신의 `NO_PROXY`에 gateway 호스트를 추가하여 연결이 직접 이루어지도록 하거나, 호스트명이 비공개 주소로 확인되는 프록시를 사용하세요. 메시지는 추가할 정확한 `NO_PROXY` 항목을 이름으로 지정합니다 |

424| CLI `/login`: `Claude Code only signs in to <host> from inside its declared network <block> (managed settings), and this machine is connecting from <ip>, outside it` | gateway가 [`gatewayInternalNetworks`](https://code.claude.com/docs/ko/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own)에 선언된 블록에 있고, 개발자 머신이 해당 블록 외부의 주소에서 도달함: VPN 주소 풀, 컨테이너 또는 WSL2 NAT 세그먼트, 또는 조직의 네트워크가 아님 | 개발자가 네트워크의 호스트 OS에서 `/login`을 실행하도록 하세요. 표시된 주소도 조직의 공개 공간인 경우 gateway 항목을 두 주소를 모두 포함하는 블록으로 바꾸세요(`/8`까지). 두 번째 겹치는 항목은 거부됩니다. 두 주소를 모두 포함하는 블록이 없으면 [게이트웨이 주소 선택](#choose-an-address-for-the-gateway)을 참조하세요 |424| CLI `/login`: `Claude Code only signs in to <host> from inside its declared network <block> (managed settings), and this machine is connecting from <ip>, outside it` | gateway가 [`gatewayInternalNetworks`](https://code.claude.com/docs/ko/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own)에 선언된 블록에 있고, 개발자 머신이 해당 블록 외부의 주소에서 도달함: VPN 주소 풀, 컨테이너 또는 WSL2 NAT 세그먼트, 또는 조직의 네트워크가 아님 | 개발자가 네트워크의 호스트 OS에서 `/login`을 실행하도록 하세요. 표시된 주소도 조직의 공개 공간인 경우 gateway 항목을 두 주소를 모두 포함하는 블록으로 바꾸세요(`/8`까지). 두 번째 겹치는 항목은 거부됩니다. 두 주소를 모두 포함하는 블록이 없으면 [게이트웨이 주소 선택](#choose-an-address-for-the-gateway)을 참조하세요 |

36 36 

37모든 클라우드 세션은 [클라우드 환경](https://code.claude.com/docs/ko/cloud-environments.md)에서 실행되며, 이는 네트워크 액세스, 환경 변수 및 설정 스크립트를 제어하는 저장된 구성입니다.37모든 클라우드 세션은 [클라우드 환경](https://code.claude.com/docs/ko/cloud-environments.md)에서 실행되며, 이는 네트워크 액세스, 환경 변수 및 설정 스크립트를 제어하는 저장된 구성입니다.

38 38 

39* **첫 번째 환경**: 아직 환경이 없으면 온보딩이 [**신뢰할 수 있는** 네트워크 액세스](https://code.claude.com/docs/ko/cloud-environments.md#access-levels)를 사용하여 **기본** 환경을 설정합니다. 이는 사용자를 위해 생성하거나 사용자가 생성하도록 요청합니다. 플랜에서 어느 것이 발생하는지는 [기본 환경](https://code.claude.com/docs/ko/cloud-environments.md#the-default-environment)을 참조하세요39* **첫 번째 환경**: 아직 환경이 없으면 온보딩이 [**제한된** 네트워크 액세스](https://code.claude.com/docs/ko/cloud-environments.md#access-levels)를 사용하여 **기본** 환경을 설정합니다. 플랜에서 이것이 어떻게 작동하는지는 [기본 환경](https://code.claude.com/docs/ko/cloud-environments.md#the-default-environment)을 참조하세요

40* **세션이 사용하는 환경**: 둘 이상의 환경이 있을 때 세션이 환경을 선택하는 방법은 [기본 환경](https://code.claude.com/docs/ko/cloud-environments.md#the-default-environment)을 참조하세요40* **세션이 사용하는 환경**: 둘 이상의 환경이 있을 때 세션이 환경을 선택하는 방법은 [기본 환경](https://code.claude.com/docs/ko/cloud-environments.md#the-default-environment)을 참조하세요

41* **세션이 접근하거나 시작 시 실행할 수 있는 항목 변경**: [클라우드 환경 구성](https://code.claude.com/docs/ko/cloud-environments.md)을 참조하세요41* **세션이 접근하거나 시작 시 실행할 수 있는 항목 변경**: [클라우드 환경 구성](https://code.claude.com/docs/ko/cloud-environments.md)을 참조하세요

42* **구성 없이 설치되어 있는 항목**: [설치된 도구](https://code.claude.com/docs/ko/cloud-environments.md#installed-tools)를 참조하세요42* **구성 없이 설치되어 있는 항목**: [설치된 도구](https://code.claude.com/docs/ko/cloud-environments.md#installed-tools)를 참조하세요

146* **자동 메모리**: 스윕은 프로젝트의 [자동 메모리](https://code.claude.com/docs/ko/memory.md#auto-memory) 디렉토리 `projects/<project>/memory/`의 메모리 파일을 삭제하지 않습니다. Claude Code는 전체 보존 기간 동안 비어 있었던 경우에만 해당 디렉토리를 제거합니다. v2.1.228 이전에는 스윕이 메모리 디렉토리 내의 폴더를 세션 데이터로 취급하고 그 아래의 오래된 파일을 삭제할 수 있었습니다.146* **자동 메모리**: 스윕은 프로젝트의 [자동 메모리](https://code.claude.com/docs/ko/memory.md#auto-memory) 디렉토리 `projects/<project>/memory/`의 메모리 파일을 삭제하지 않습니다. Claude Code는 전체 보존 기간 동안 비어 있었던 경우에만 해당 디렉토리를 제거합니다. v2.1.228 이전에는 스윕이 메모리 디렉토리 내의 폴더를 세션 데이터로 취급하고 그 아래의 오래된 파일을 삭제할 수 있었습니다.

147* **Claude Desktop 및 Cowork 트랜스크립트**: Claude Code는 Claude Desktop 또는 Cowork에서 시작하거나 가장 최근에 계속한 세션의 트랜스크립트를 나이에 관계없이 유지합니다. 이 트랜스크립트에 나이 제한을 주려면 [`desktopSessionCleanupPeriodDays`](https://code.claude.com/docs/ko/settings-reference#desktopsessioncleanupperioddays)를 설정하세요. Claude Code v2.1.248 이상 필요; 이전 버전은 `cleanupPeriodDays` 후에 삭제합니다.147* **Claude Desktop 및 Cowork 트랜스크립트**: Claude Code는 Claude Desktop 또는 Cowork에서 시작하거나 가장 최근에 계속한 세션의 트랜스크립트를 나이에 관계없이 유지합니다. 이 트랜스크립트에 나이 제한을 주려면 [`desktopSessionCleanupPeriodDays`](https://code.claude.com/docs/ko/settings-reference#desktopsessioncleanupperioddays)를 설정하세요. Claude Code v2.1.248 이상 필요; 이전 버전은 `cleanupPeriodDays` 후에 삭제합니다.

148 148 

149 다음 중 하나에 해당하면 Claude Code는 대신 `cleanupPeriodDays` 후에 이 트랜스크립트를 삭제합니다:149 다음과 같은 경우에는 Claude Code가 대신 `cleanupPeriodDays` 후에 이 트랜스크립트를 삭제합니다:

150 150 

151 * [관리형 설정](https://code.claude.com/docs/ko/managed-settings.md)이 `cleanupPeriodDays`를 설정한 경우151 * [관리형 설정](https://code.claude.com/docs/ko/managed-settings.md)이 `cleanupPeriodDays`를 설정한 경우

152 * [HIPAA 구성이 세션에 적용되는](https://code.claude.com/docs/ko/hipaa-setup.md#check-how-developers-sign-in-and-connect) 경우152 * [HIPAA 구성이 세션에 적용되는](https://code.claude.com/docs/ko/hipaa-setup.md#check-how-developers-sign-in-and-connect) 경우

170* **Linux**: `/tmp/claude-<uid>/<project>/<session-id>/scratchpad/`, 또는 시스템이 설정한 경우 `$TMPDIR` 아래의 동일한 형태170* **Linux**: `/tmp/claude-<uid>/<project>/<session-id>/scratchpad/`, 또는 시스템이 설정한 경우 `$TMPDIR` 아래의 동일한 형태

171* **Windows**: `%TEMP%\claude\<project>\<session-id>\scratchpad\`171* **Windows**: `%TEMP%\claude\<project>\<session-id>\scratchpad\`

172 172 

173`<project>`는 문자와 숫자 이외의 모든 문자가 `-`로 바뀐 작업 디렉토리 경로입니다. 예를 들어 `-Users-you-my-project`. [`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/ko/env-vars)을 설정하면 트리가 대신 해당 디렉토리 아래로 이동합니다. Hook은 현재 세션의 경로를 [`scratchpad_dir`](https://code.claude.com/docs/ko/hooks#common-input-fields)로 받습니다.173`<project>`는 문자와 숫자 이외의 모든 문자가 `-`로 바뀐 작업 디렉터리 경로입니다. 예를 들어 `-Users-you-my-project`. Windows에서 `<project>`는 해당 문자열의 16자 해시입니다. 예를 들어 `73295dabccd14c56`. Desktop 앱 세션에서는 문자열 자체일 수 있습니다. 정확한 경로를 확인하려면 Claude에게 물어보세요. [`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/ko/env-vars)을 설정하면 트리가 대신 해당 디렉터리 아래로 이동합니다. 훅은 현재 세션의 경로를 [`scratchpad_dir`](https://code.claude.com/docs/ko/hooks#common-input-fields)로 받습니다.

174 174 

175스크래치패드 파일은 세션의 트랜스크립트만큼 오래 지속됩니다: [보존 스윕](#cleaned-up-automatically)은 트랜스크립트를 삭제할 때 디렉토리를 삭제하고, [`claude purge`](#clear-local-data)는 임시 디렉토리를 건드리지 않습니다. 디렉토리가 시스템 임시 위치 아래에 있으므로 운영 체제도 이를 정리할 수 있습니다. 예를 들어 재시작 시. Claude가 거기에 작성한 것을 유지하려면 Claude에게 프로젝트로 이동하도록 요청하세요.175스크래치패드 파일은 세션의 트랜스크립트만큼 오래 지속됩니다: [보존 스윕](#cleaned-up-automatically)은 트랜스크립트를 삭제할 때 디렉토리를 삭제하고, [`claude purge`](#clear-local-data)는 임시 디렉토리를 건드리지 않습니다. 디렉토리가 시스템 임시 위치 아래에 있으므로 운영 체제도 이를 정리할 수 있습니다. 예를 들어 재시작 시. Claude가 거기에 작성한 것을 유지하려면 Claude에게 프로젝트로 이동하도록 요청하세요.

176 176 

8 8 

9AWS의 Claude Platform은 AWS 인증, IAM 액세스 제어 및 AWS Marketplace 청구를 지원하는 Anthropic 운영 Claude API입니다. 요청은 Anthropic의 API에 직접 도달하므로 동일한 릴리스 일정에 따라 [Claude API](https://platform.claude.com/docs)와 동일한 모델 및 API 기능을 사용할 수 있습니다. AWS 자격 증명 또는 워크스페이스 API 키로 인증하며, AWS Marketplace를 통해 비용을 지불합니다.9AWS의 Claude Platform은 AWS 인증, IAM 액세스 제어 및 AWS Marketplace 청구를 지원하는 Anthropic 운영 Claude API입니다. 요청은 Anthropic의 API에 직접 도달하므로 동일한 릴리스 일정에 따라 [Claude API](https://platform.claude.com/docs)와 동일한 모델 및 API 기능을 사용할 수 있습니다. AWS 자격 증명 또는 워크스페이스 API 키로 인증하며, AWS Marketplace를 통해 비용을 지불합니다.

10 10 

11Anthropic의 기능 플래그 서비스를 통해 Claude Code가 활성화하는 클라이언트 측 기능은 기본적으로 비활성화되어 있으며, [어드바이저 도구](https://code.claude.com/docs/ko/advisor.md)는 사용할 수 없습니다. 전체 목록은 [기능 가용성 매트릭스](https://code.claude.com/docs/ko/feature-availability.md#summary-by-provider)를 참조하십시오.

12 

13이 가이드를 사용하여 Claude Platform on AWS를 통해 이미 프로비저닝한 워크스페이스를 가리키도록 Claude Code를 설정합니다. 이 전에 필요한 AWS 구독 및 워크스페이스 설정은 [Claude Platform on AWS 설명서](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws)를 참조하십시오.11이 가이드를 사용하여 Claude Platform on AWS를 통해 이미 프로비저닝한 워크스페이스를 가리키도록 Claude Code를 설정합니다. 이 전에 필요한 AWS 구독 및 워크스페이스 설정은 [Claude Platform on AWS 설명서](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws)를 참조하십시오.

14 12 

15> [!NOTE]13> [!NOTE]

16>14>

17> AWS Marketplace를 통해 구독하면 AWS 계정에 연결된 새로운 Anthropic 조직이 프로비저닝됩니다. 이 조직은 Anthropic에서 이미 보유한 모든 조직과 별개이며, 자격 증명은 조직 간에 전송되지 않습니다. AWS 연결 조직의 워크스페이스 ID 및 API 키를 사용하고, 기존 Claude Console 계정의 키는 사용하지 마십시오.15> AWS Marketplace를 통해 구독하면 AWS 계정에 연결된 새로운 Anthropic 조직이 프로비저닝됩니다. 이 조직은 Anthropic에서 이미 보유한 모든 조직과 별개이며, 자격 증명은 조직 간에 전송되지 않습니다. AWS 연결 조직의 워크스페이스 ID 및 API 키를 사용하고, 기존 Claude Console 계정의 키는 사용하지 마십시오.

18 16 

17일부 Claude Code 기능은 AWS의 Claude Platform에서 사용할 수 없거나 다르게 작동합니다. [기능 가용성 매트릭스](https://code.claude.com/docs/ko/feature-availability.md#summary-by-provider)와 [기능 플래그 가져오기가 필요한 기능](https://code.claude.com/docs/ko/env-vars.md#features-that-need-feature-flag-fetching)을 참조하십시오.

18 

19## 필수 조건19## 필수 조건

20 20 

21Claude Code를 구성하기 전에 다음이 필요합니다.21Claude Code를 구성하기 전에 다음이 필요합니다.

37 37 

38**Default**는 자체 구성을 수행하지 않습니다:38**Default**는 자체 구성을 수행하지 않습니다:

39 39 

40* [**Trusted** 네트워크 액세스](#access-levels): 세션이 패키지 레지스트리 및 기타 [허용 목록 도메인](#default-allowed-domains)에 도달하고 세션의 네트워크를 통해 다른 것에는 도달하지 않습니다.40* [**Limited** 네트워크 액세스](#access-levels): 세션이 패키지 레지스트리 및 기타 [허용 목록 도메인](#default-allowed-domains)에 도달합니다.

41* 다른 구성 없음: **Default**는 환경 변수 또는 설정 스크립트를 정의하지 않으므로 세션은 [사전 설치된 도구](#installed-tools)만으로 시작됩니다.41* 다른 구성 없음: **Default**는 환경 변수 또는 설정 스크립트를 정의하지 않으므로 세션은 [사전 설치된 도구](#installed-tools)만으로 시작됩니다.

42 42 

43**Default**만 사용 가능한 경우 모든 세션이 이 환경에서 실행됩니다. 둘 이상의 환경이 있는 경우 세션은 표면별로 하나를 선택합니다:43**Default**만 사용 가능한 경우 모든 세션이 이 환경에서 실행됩니다. 둘 이상의 환경이 있는 경우 세션은 표면별로 하나를 선택합니다:

198 198 

199## 네트워크 액세스199## 네트워크 액세스

200 200 

201각 환경은 하나의 네트워크 액세스 수준을 설정하며, 이는 세션이 만들 수 있는 아웃바운드 연결을 제어합니다. 기본 수준인 **Trusted**는 패키지 레지스트리 및 기타 [허용 목록 도메인](#default-allowed-domains)을 허용합니다. **Custom**은 자신의 도메인 목록을 사용합니다.201각 환경은 하나의 네트워크 액세스 수준을 설정하며, 이는 세션이 만들 수 있는 아웃바운드 연결을 제어합니다. 새 환경은 **Allow package managers**가 선택된 **Limited**로 시작하므로, 해당 세션은 패키지 레지스트리 및 기타 [허용 목록 도메인](#default-allowed-domains)에 도달할 수 있습니다.

202 202 

203환경의 네트워크 액세스를 변경하려면 [편집을 위해 열고](#configure-your-environment) 대화 상자에서 **Network access** 선택기를 사용합니다. [공유 환경](#organization-shared-environments)은 읽기 전용으로 열리므로 Owner는 [관리자 설정](https://claude.ai/admin-settings)의 **Cloud environments** 페이지에서 네트워크 액세스를 변경합니다. 선택기를 여는 컨트롤은 [Default 환경](#the-default-environment) 아래에 나열된 앱 사용 환경 및 [클라우드 예약 작업 편집기](https://code.claude.com/docs/ko/routines.md#environments-and-network-access)에 나타납니다. 개인 환경에는 claude.ai 계정 설정에 별도의 페이지가 없습니다.203환경의 네트워크 액세스를 변경하려면 [편집을 위해 열고](#configure-your-environment) 대화 상자에서 **Network access** 선택기를 사용합니다. [공유 환경](#organization-shared-environments)은 읽기 전용으로 열리므로 Owner는 [관리자 설정](https://claude.ai/admin-settings)의 **Cloud environments** 페이지에서 네트워크 액세스를 변경합니다. 선택기를 여는 컨트롤은 [Default 환경](#the-default-environment) 아래에 나열된 앱 사용 환경 및 [클라우드 예약 작업 편집기](https://code.claude.com/docs/ko/routines.md#environments-and-network-access)에 나타납니다. 개인 환경에는 claude.ai 계정 설정에 별도의 페이지가 없습니다.

204 204 

210 210 

211### 액세스 수준211### 액세스 수준

212 212 

213[환경 대화 상자](#configure-your-environment)의 **Network access** 필드는 다음 네 가지 수준 중 하나를 사용합니다:213[환경 대화 상자](#configure-your-environment)의 **Network access** 필드는 다음 세 가지 수준 중 하나를 사용합니다:

214 214 

215| 수준 | 아웃바운드 연결 |215| 수준 | 아웃바운드 연결 |

216| :- | :- |216| :- | :- |

217| **None** | 세션의 네트워크를 통한 아웃바운드 네트워크 액세스 없음 |217| **None** | 세션의 네트워크를 통한 아웃바운드 네트워크 액세스 없음 |

218| **Trusted** | [허용 목록 도메인](#default-allowed-domains)만: 패키지 레지스트리, GitHub, 클라우드 SDK |218| **Limited** | **Allow package managers**가 선택된 동안 패키지 레지스트리, GitHub, 클라우드 SDK로 구성된 [기본 허용 목록](#default-allowed-domains)과 [나열한 도메인](#allow-specific-domains). [차단된 요청의 모습](https://code.claude.com/docs/ko/errors.md#host-not-allowed-in-a-cloud-session)을 참조합니다. |

219| **Full** | 모든 도메인 |219| **Full** | 모든 도메인 |

220| **Custom** | 자신의 허용 목록, 선택적으로 기본값 포함 |

221 220 

222어느 수준을 선택하든 세션은 여전히 이에 도달할 수 있습니다. 각각은 세션의 네트워크 허용 목록을 통과하지 않는 경로를 사용하기 때문입니다:221어느 수준을 선택하든 세션은 여전히 이에 도달할 수 있습니다. 각각은 세션의 네트워크 허용 목록을 통과하지 않는 경로를 사용하기 때문입니다:

223 222 

226* 환경의 [네트워크 시크릿](#add-network-secrets)에 나열한 호스트([시크릿을 받지 않는 호스트](#requests-that-never-get-the-credential) 제외)225* 환경의 [네트워크 시크릿](#add-network-secrets)에 나열한 호스트([시크릿을 받지 않는 호스트](#requests-that-never-get-the-credential) 제외)

227* Anthropic API(Claude Code의 자체 요청의 경우, [보안 및 격리](https://code.claude.com/docs/ko/claude-code-on-the-web.md#security-and-isolation) 아래에 언급된 대로 **None**에서도)226* Anthropic API(Claude Code의 자체 요청의 경우, [보안 및 격리](https://code.claude.com/docs/ko/claude-code-on-the-web.md#security-and-isolation) 아래에 언급된 대로 **None**에서도)

228 227 

228**Trusted** 또는 **Custom**으로 저장된 환경은 계속 동일한 호스트에 도달하며 다음과 같이 열립니다:

229 

230* **Trusted로 저장된 경우**: **Allow package managers**가 선택된 **Limited**로 열립니다

231* **Custom으로 저장된 경우**: 설정한 그대로의 **Allowed domains** 목록 및 **Allow package managers**와 함께 **Limited**로 열리며, 목록에 단독 `*`가 포함되어 있었다면 **Full**로 열립니다

232 

229### 특정 도메인 허용233### 특정 도메인 허용

230 234 

231Trusted 목록에 없는 도메인을 허용하려면 환경의 네트워크 액세스 설정에서 **Custom**을 선택한 다음 **Allowed domains** 필드에 한 줄에 하나의 도메인을 나열합니다. 이 예제는 내부 프로젝트에 필요할 수 있는 세 개의 호스트를 허용합니다.235[기본 허용 목록](#default-allowed-domains)에 없는 도메인을 허용하려면 환경의 **Network access** 선택기에서 **Limited**를 선택한 다음 **Allowed domains** 필드에 한 줄에 하나의 도메인을 나열합니다. 선행 `*.`은 모든 하위 도메인과 일치합니다. 이 예제는 내부 프로젝트에 필요할 수 있는 세 개의 호스트를 허용합니다.

232 236 

233```text theme={null}237```text theme={null}

234api.example.com238api.example.com

236registry.example.com240registry.example.com

237```241```

238 242 

239이 환경의 세션은 이제 `api.example.com`, `internal.example.com`의 모든 하위 도메인 및 `registry.example.com`에 도달할 수 있으며 세션의 네트워크를 통해 다른 도메인에는 도달할 수 없습니다. [GitHub 트래픽](#github-proxy), [MCP 커넥터 트래픽](#network-access) 및 환경의 [네트워크 시크릿](#add-network-secrets)의 호스트에 대한 요청([시크릿을 받지 않는 호스트](#requests-that-never-get-the-credential) 제외)은 이 허용 목록을 통과하지 않습니다. 선행 `*.`은 모든 하위 도메인과 일치합니다. [Trusted 도메인](#default-allowed-domains)도 유지하려면 **Also include default list of common package managers**를 확인합니다. 나열한 것만 허용하려면 선택 해제합니다.243**Allow package managers**가 선택된 동안 이 환경의 세션은 나열한 도메인과 함께 [기본 허용 목록](#default-allowed-domains)에도 도달합니다. 기본 허용 목록을 제외하려면 확인란을 선택 해제합니다. [GitHub 트래픽](#github-proxy), [MCP 커넥터 트래픽](#network-access) 및 환경의 [네트워크 시크릿](#add-network-secrets)의 호스트에 대한 요청([시크릿을 받지 않는 호스트](#requests-that-never-get-the-credential) 제외)은 이 허용 목록을 통과하지 않습니다.

240 244 

241조직이 [아티팩트](https://code.claude.com/docs/ko/artifacts.md#availability)를 사용하는 경우 세션이 이를 읽기 위해 목록에 `*.frame.claudeusercontent.com`이 필요하지 않습니다. 목록이 해당 호스트를 생략하면 Claude Code는 세션의 Anthropic 연결을 통해 아티팩트 콘텐츠를 읽습니다. 두 가지 상황에서 호스트를 허용 목록에 유지합니다:245조직이 [아티팩트](https://code.claude.com/docs/ko/artifacts.md#availability)를 사용하는 경우 세션이 이를 읽기 위해 목록에 `*.frame.claudeusercontent.com`이 필요하지 않습니다. 목록이 해당 호스트를 생략하면 Claude Code는 세션의 Anthropic 연결을 통해 아티팩트 콘텐츠를 읽습니다. 두 가지 상황에서 호스트를 허용 목록에 유지합니다:

242 246 

243* **이 환경의 세션이 다른 조직의 공개 아티팩트를 열기**: Claude Code는 호스트에서 직접 이를 가져오므로 이 목록에 추가합니다.247* **이 환경의 세션이 다른 조직의 공개 아티팩트를 열기**: Claude Code는 호스트에서 직접 이를 가져오므로 이 목록에 추가합니다.

244* **로컬 CLI 또는 자체 호스팅 러너를 구성하는 경우**: 호스트를 해당 허용 목록에 유지합니다. [네트워크 액세스 요구 사항](https://code.claude.com/docs/ko/network-config.md#network-access-requirements) 및 자체 호스팅 [네트워크 요구 사항](https://code.claude.com/docs/ko/self-hosted-environments-deploy.md#network-requirements)을 참조합니다.248* **로컬 CLI 또는 자체 호스팅 러너를 구성하는 경우**: 호스트를 해당 허용 목록에 유지합니다. [네트워크 액세스 요구 사항](https://code.claude.com/docs/ko/network-config.md#network-access-requirements) 및 자체 호스팅 [네트워크 요구 사항](https://code.claude.com/docs/ko/self-hosted-environments-deploy.md#network-requirements)을 참조합니다.

245 249 

246각 환경에는 자체 허용 도메인 목록이 있습니다. 관리자가 모든 구성원의 환경에 푸시할 수 있는 조직 수준의 허용 목록이 없습니다. [서버 관리 설정](https://code.claude.com/docs/ko/server-managed-settings.md)도 환경의 네트워크 허용 목록에 도메인을 추가하지 않습니다. 팀에 하나의 표준 목록을 제공하려면 Owner가 **Custom** 네트워크 액세스 및 해당 목록이 있는 [조직 공유 환경](#organization-shared-environments)을 만들 수 있습니다.250각 환경에는 자체 허용 도메인 목록이 있습니다. 관리자가 모든 구성원의 환경에 푸시할 수 있는 조직 수준의 허용 목록이 없습니다. [서버 관리 설정](https://code.claude.com/docs/ko/server-managed-settings.md)도 환경의 네트워크 허용 목록에 도메인을 추가하지 않습니다. 팀에 하나의 표준 목록을 제공하려면 Owner가 **Limited** 네트워크 액세스 및 해당 목록이 있는 [조직 공유 환경](#organization-shared-environments)을 만들 수 있습니다.

247 251 

248### GitHub 프록시252### GitHub 프록시

249 253 

255* **저장소 범위**: 프록시는 세션에 연결된 저장소에 대한 GitHub API 요청을 처리합니다. 다른 저장소에 대한 API 요청은 `GitHub access to`로 시작하고 `is not enabled for this session`을 포함하는 메시지와 함께 403을 받습니다. `github.com/{owner}/{repo}/archive/` 또는 `codeload.github.com` URL을 통해 가져오는 소스 아카이브도 저장소가 연결되어 있지 않으면 공개 저장소라도 동일한 403을 받습니다.259* **저장소 범위**: 프록시는 세션에 연결된 저장소에 대한 GitHub API 요청을 처리합니다. 다른 저장소에 대한 API 요청은 `GitHub access to`로 시작하고 `is not enabled for this session`을 포함하는 메시지와 함께 403을 받습니다. `github.com/{owner}/{repo}/archive/` 또는 `codeload.github.com` URL을 통해 가져오는 소스 아카이브도 저장소가 연결되어 있지 않으면 공개 저장소라도 동일한 403을 받습니다.

256* **GraphQL 제한**: 프록시는 GitHub의 GraphQL 엔드포인트에 대한 요청을 `GitHub GraphQL is not available from Claude Code sessions`로 시작하는 메시지와 함께 403으로 거부하며, 이 메시지는 REST 폴백인 `gh api repos/{owner}/{repo}/...`를 안내합니다. `gh pr` 및 `gh issue`와 같이 GraphQL을 사용하는 `gh` 하위 명령도 동일한 403을 받습니다. 제한은 제공하는 자격 증명과 관계없이 프록시를 통한 모든 요청에 적용되므로 설정한 `GH_TOKEN`은 동일한 403을 받습니다. Claude는 Projects v2와 같이 GraphQL에만 존재하는 GitHub API에 프록시를 통해 도달할 수 없습니다.260* **GraphQL 제한**: 프록시는 GitHub의 GraphQL 엔드포인트에 대한 요청을 `GitHub GraphQL is not available from Claude Code sessions`로 시작하는 메시지와 함께 403으로 거부하며, 이 메시지는 REST 폴백인 `gh api repos/{owner}/{repo}/...`를 안내합니다. `gh pr` 및 `gh issue`와 같이 GraphQL을 사용하는 `gh` 하위 명령도 동일한 403을 받습니다. 제한은 제공하는 자격 증명과 관계없이 프록시를 통한 모든 요청에 적용되므로 설정한 `GH_TOKEN`은 동일한 403을 받습니다. Claude는 Projects v2와 같이 GraphQL에만 존재하는 GitHub API에 프록시를 통해 도달할 수 없습니다.

257 261 

258공개 리포지토리의 커밋된 파일은 `raw.githubusercontent.com`을 통해 도착하며, [보안 프록시](#security-proxy)가 대신 처리합니다. 해당 도메인은 기본 [Trusted 목록](#default-allowed-domains)에 있으므로 환경의 [액세스 수준](#access-levels)이 이를 제외하지 않는 한 이러한 파일은 도달 가능합니다.262공개 저장소의 커밋된 파일은 `raw.githubusercontent.com`을 통해 도착하며, [보안 프록시](#security-proxy)가 대신 처리합니다. 해당 도메인은 [기본 허용 목록](#default-allowed-domains)에 있으므로 환경의 [네트워크 액세스](#access-levels)가 해당 목록을 허용하는 한 이러한 파일은 도달 가능합니다.

259 263 

260### 보안 프록시264### 보안 프록시

261 265 

391service redis-server start395service redis-server start

392```396```

393 397 

394Docker는 컨테이너화된 서비스를 실행하는 데 사용할 수 있습니다. Claude에게 `docker compose up`을 실행하여 프로젝트의 서비스를 시작하도록 요청합니다. 이미지를 가져오기 위한 네트워크 액세스는 환경의 [액세스 수준](#access-levels)을 따르며, [Trusted 기본값](#default-allowed-domains)에는 Docker Hub 및 기타 일반적인 레지스트리가 포함됩니다.398Docker는 컨테이너화된 서비스를 실행하는 데 사용할 수 있습니다. Claude에게 `docker compose up`을 실행하여 프로젝트의 서비스를 시작하도록 요청합니다. 이미지를 가져오기 위한 네트워크 액세스는 환경의 [액세스 수준](#access-levels)을 따르며, [기본 허용 목록](#default-allowed-domains)에는 Docker Hub 및 기타 일반적인 레지스트리가 포함됩니다.

395 399 

396이미지가 크거나 가져오기가 느린 경우 [설정 스크립트](#setup-scripts)에 `docker compose pull` 또는 `docker compose build`를 추가합니다. [환경 캐시](#environment-caching)는 가져온 이미지를 유지하므로 각 새 세션에는 디스크에 이미지가 있습니다. 캐시는 파일만 저장하고 실행 중인 프로세스는 저장하지 않으므로 Claude는 여전히 각 세션에서 컨테이너를 시작합니다.400이미지가 크거나 가져오기가 느린 경우 [설정 스크립트](#setup-scripts)에 `docker compose pull` 또는 `docker compose build`를 추가합니다. [환경 캐시](#environment-caching)는 가져온 이미지를 유지하므로 각 새 세션에는 디스크에 이미지가 있습니다. 캐시는 파일만 저장하고 실행 중인 프로세스는 저장하지 않으므로 Claude는 여전히 각 세션에서 컨테이너를 시작합니다.

397 401 

445 449 

446* **종료 코드 0**: 스크립트가 0이 아닌 코드로 종료되면 세션이 [시작되지 않거나](https://code.claude.com/docs/ko/web-quickstart.md#setup-script-failed) 스크립트가 설치하지 못한 항목 없이 시작됩니다. 중요하지 않은 명령에 `|| true`를 추가하여 일시적인 설치 실패로 스크립트가 실패하지 않도록 합니다.450* **종료 코드 0**: 스크립트가 0이 아닌 코드로 종료되면 세션이 [시작되지 않거나](https://code.claude.com/docs/ko/web-quickstart.md#setup-script-failed) 스크립트가 설치하지 못한 항목 없이 시작됩니다. 중요하지 않은 명령에 `|| true`를 추가하여 일시적인 설치 실패로 스크립트가 실패하지 않도록 합니다.

447* **5분 이내에 완료**: 스크립트의 총 실행 시간을 약 5분 이내로 유지하여 [환경 캐시](#environment-caching)를 구축할 수 있도록 합니다. 설정이 그보다 오래 걸리면 환경이 캐시되지 않습니다. `&`와 `wait`를 사용하여 독립적인 설치를 병렬로 실행하고, 맞지 않는 단일 다운로드는 백그라운드에서 실행하는 [SessionStart hook](#setup-scripts-vs-sessionstart-hooks)으로 이동합니다. 새 세션이 설정 중에 정지되거나 실패하면 [새 세션이 설정 중에 정지되거나 시간 초과됨](https://code.claude.com/docs/ko/web-quickstart.md#new-sessions-hang-or-time-out-during-setup)을 참조합니다.451* **5분 이내에 완료**: 스크립트의 총 실행 시간을 약 5분 이내로 유지하여 [환경 캐시](#environment-caching)를 구축할 수 있도록 합니다. 설정이 그보다 오래 걸리면 환경이 캐시되지 않습니다. `&`와 `wait`를 사용하여 독립적인 설치를 병렬로 실행하고, 맞지 않는 단일 다운로드는 백그라운드에서 실행하는 [SessionStart hook](#setup-scripts-vs-sessionstart-hooks)으로 이동합니다. 새 세션이 설정 중에 정지되거나 실패하면 [새 세션이 설정 중에 정지되거나 시간 초과됨](https://code.claude.com/docs/ko/web-quickstart.md#new-sessions-hang-or-time-out-during-setup)을 참조합니다.

448* **설치를 위한 네트워크 액세스**: 패키지 설치는 레지스트리에 도달해야 합니다. 기본 **신뢰됨** 수준은 npm, PyPI, RubyGems 및 crates.io를 포함한 [일반적인 패키지 레지스트리](#default-allowed-domains)를 포함합니다. **없음** 네트워크 액세스를 사용하면 설치가 실패합니다.452* **설치를 위한 네트워크 액세스**: 패키지 설치는 레지스트리에 도달해야 합니다. **패키지 관리자 허용**이 선택된 기본 **제한됨** 수준은 npm, PyPI, RubyGems 및 crates.io를 포함한 [일반적인 패키지 레지스트리](#default-allowed-domains)를 포함합니다. **없음** 네트워크 액세스를 사용하면 설치가 실패합니다.

449* **환경의 변수가 아직 설정되지 않음**: 스크립트는 세션이 환경의 [환경 변수](#set-environment-variables)를 설정하기 전에 실행됩니다. 스크립트에 필요한 값은 스크립트 자체에서 설정합니다.453* **환경의 변수가 아직 설정되지 않음**: 스크립트는 세션이 환경의 [환경 변수](#set-environment-variables)를 설정하기 전에 실행됩니다. 스크립트에 필요한 값은 스크립트 자체에서 설정합니다.

450 454 

451### 환경 캐싱455### 환경 캐싱

541* **세션당 하나의 저장소**: Anthropic 호스팅 환경에서 여러 저장소가 있는 세션은 어떤 저장소의 `.claude/settings.json`에서도 훅을 로드하지 않으므로 그곳에 정의한 SessionStart 훅이 실행되지 않습니다. 이러한 세션의 의존성은 대신 [설정 스크립트](#setup-scripts)로 설치합니다. 자체 호스팅 환경의 경우 [어떤 저장소의 설정이 적용되는지](https://code.claude.com/docs/ko/self-hosted-environments-configuration.md#repository-settings-in-sessions-with-several-repositories)를 참조합니다.545* **세션당 하나의 저장소**: Anthropic 호스팅 환경에서 여러 저장소가 있는 세션은 어떤 저장소의 `.claude/settings.json`에서도 훅을 로드하지 않으므로 그곳에 정의한 SessionStart 훅이 실행되지 않습니다. 이러한 세션의 의존성은 대신 [설정 스크립트](#setup-scripts)로 설치합니다. 자체 호스팅 환경의 경우 [어떤 저장소의 설정이 적용되는지](https://code.claude.com/docs/ko/self-hosted-environments-configuration.md#repository-settings-in-sessions-with-several-repositories)를 참조합니다.

542* **프로젝트의 클라우드 스레드에서는 실행되지 않음**: [프로젝트](https://code.claude.com/docs/ko/claude-projects.md#what-threads-pick-up-from-your-repositories)의 클라우드 스레드는 저장소 수와 관계없이 저장소의 `.claude/settings.json`에 있는 훅을 실행하지 않습니다. Anthropic 호스팅 환경에서는 [설정 스크립트](#setup-scripts)로 스레드의 의존성을 설치합니다. 자체 호스팅 환경에서는 대신 [실행기 호스트의 설정](https://code.claude.com/docs/ko/self-hosted-environments-configuration.md#repository-settings-in-sessions-with-several-repositories)에 있는 훅을 사용합니다.546* **프로젝트의 클라우드 스레드에서는 실행되지 않음**: [프로젝트](https://code.claude.com/docs/ko/claude-projects.md#what-threads-pick-up-from-your-repositories)의 클라우드 스레드는 저장소 수와 관계없이 저장소의 `.claude/settings.json`에 있는 훅을 실행하지 않습니다. Anthropic 호스팅 환경에서는 [설정 스크립트](#setup-scripts)로 스레드의 의존성을 설치합니다. 자체 호스팅 환경에서는 대신 [실행기 호스트의 설정](https://code.claude.com/docs/ko/self-hosted-environments-configuration.md#repository-settings-in-sessions-with-several-repositories)에 있는 훅을 사용합니다.

543* **클라우드 전용 범위 없음**: hook은 로컬 및 클라우드 세션 모두에서 실행됩니다. 로컬 실행을 건너뛰려면 `CLAUDE_CODE_REMOTE` 환경 변수가 `true`가 아닌 한 조기에 종료합니다. [종속성 설치 스크립트](#install-dependencies-with-a-sessionstart-hook)가 수행하는 방식입니다.547* **클라우드 전용 범위 없음**: hook은 로컬 및 클라우드 세션 모두에서 실행됩니다. 로컬 실행을 건너뛰려면 `CLAUDE_CODE_REMOTE` 환경 변수가 `true`가 아닌 한 조기에 종료합니다. [종속성 설치 스크립트](#install-dependencies-with-a-sessionstart-hook)가 수행하는 방식입니다.

544* **네트워크 액세스 필요**: 설치 명령은 패키지 레지스트리에 도달해야 합니다. 환경이 **없음** 네트워크 액세스를 사용하면 이러한 hook이 실패합니다. **신뢰됨** 아래의 [기본 허용 목록](#default-allowed-domains)은 npm, PyPI, RubyGems 및 crates.io를 포함합니다.548* **네트워크 액세스 필요**: 설치 명령은 패키지 레지스트리에 도달해야 합니다. 환경이 **없음** 네트워크 액세스를 사용하면 이러한 훅이 실패합니다. **패키지 관리자 허용**이 선택된 기본 **제한됨** 수준에서는 [기본 허용 목록](#default-allowed-domains)이 npm, PyPI, RubyGems 및 crates.io를 포함합니다.

545* **프록시 호환성**: Anthropic 호스팅 환경에서 모든 아웃바운드 트래픽은 [보안 프록시](#security-proxy)를 통과하고, 일부 패키지 관리자는 이와 올바르게 작동하지 않습니다. Bun은 알려진 예입니다. [자체 호스팅 환경](https://code.claude.com/docs/ko/self-hosted-environments-deploy.md#default-deny-egress)에서 아웃바운드 트래픽은 대신 자신의 네트워크 경계를 통과합니다.549* **프록시 호환성**: Anthropic 호스팅 환경에서 모든 아웃바운드 트래픽은 [보안 프록시](#security-proxy)를 통과하고, 일부 패키지 관리자는 이와 올바르게 작동하지 않습니다. Bun은 알려진 예입니다. [자체 호스팅 환경](https://code.claude.com/docs/ko/self-hosted-environments-deploy.md#default-deny-egress)에서 아웃바운드 트래픽은 대신 자신의 네트워크 경계를 통과합니다.

546* **시작 지연 추가**: 훅은 [환경 캐싱](#environment-caching)의 이점을 받는 설정 스크립트와 달리 세션이 시작되거나 재개될 때마다 실행됩니다. [의존성 설치 스크립트](#install-dependencies-with-a-sessionstart-hook)처럼 이미 완료된 작업을 건너뛰어 설치 스크립트를 빠르게 유지합니다.550* **시작 지연 추가**: 훅은 [환경 캐싱](#environment-caching)의 이점을 받는 설정 스크립트와 달리 세션이 시작되거나 재개될 때마다 실행됩니다. [의존성 설치 스크립트](#install-dependencies-with-a-sessionstart-hook)처럼 이미 완료된 작업을 건너뛰어 설치 스크립트를 빠르게 유지합니다.

547 551 

549 553 

550## 기본 허용 도메인554## 기본 허용 도메인

551 555 

552**Trusted** 네트워크 액세스를 사용하면 세션은 기본적으로 다음 도메인에 도달할 수 있습니다. `*`로 표시된 도메인은 와일드카드 하위 도메인 일치를 나타내므로 `*.gcr.io`는 `gcr.io`의 모든 하위 도메인을 허용합니다.556새 환경에서처럼 **Limited** 네트워크 액세스에서 **Allow package managers**가 선택되어 있으면 세션은 다음 도메인에 도달할 수 있습니다. `*`로 표시된 도메인은 와일드카드 하위 도메인 일치를 나타내므로 `*.gcr.io`는 `gcr.io`의 모든 하위 도메인을 허용합니다.

553 557 

554> [accordion] Anthropic 서비스558> [accordion] Anthropic 서비스

555>559>

65| `/bug [report]` | 버그를 보고하거나 대화를 공유합니다. 포함할 세션 기록의 양을 선택하고, 전송 전에 동의 화면에서 확인합니다. 퍼스트 파티 연결에서 Anthropic에 로그인한 경우 보고서는 Anthropic으로 전송됩니다. 서드 파티 제공업체를 사용하거나 Anthropic 자격 증명이 없는 경우, Claude Code는 사용자가 직접 전달할 수 있도록 보고서를 [`~/.claude/feedback-bundles/` 아래의 로컬 아카이브](https://code.claude.com/docs/ko/data-usage#telemetry-services)에 기록합니다. [VS Code 확장 프로그램](https://code.claude.com/docs/ko/vs-code.md#use-the-prompt-box)에서는 `/bug`가 대신 확장 프로그램 자체의 피드백 대화 상자를 엽니다. Claude Code v2.1.229 이상이 필요합니다. Claude가 응답하는 중에 실행하면 Claude Code가 즉시 대화 상자를 엽니다. v2.1.232 이전에는 Claude Code가 턴이 끝날 때까지 명령을 대기열에 두었습니다. 별칭: `/share`. v2.1.212 이전에는 `/bug`와 `/share`가 `/feedback`의 별칭이었습니다 |65| `/bug [report]` | 버그를 보고하거나 대화를 공유합니다. 포함할 세션 기록의 양을 선택하고, 전송 전에 동의 화면에서 확인합니다. 퍼스트 파티 연결에서 Anthropic에 로그인한 경우 보고서는 Anthropic으로 전송됩니다. 서드 파티 제공업체를 사용하거나 Anthropic 자격 증명이 없는 경우, Claude Code는 사용자가 직접 전달할 수 있도록 보고서를 [`~/.claude/feedback-bundles/` 아래의 로컬 아카이브](https://code.claude.com/docs/ko/data-usage#telemetry-services)에 기록합니다. [VS Code 확장 프로그램](https://code.claude.com/docs/ko/vs-code.md#use-the-prompt-box)에서는 `/bug`가 대신 확장 프로그램 자체의 피드백 대화 상자를 엽니다. Claude Code v2.1.229 이상이 필요합니다. Claude가 응답하는 중에 실행하면 Claude Code가 즉시 대화 상자를 엽니다. v2.1.232 이전에는 Claude Code가 턴이 끝날 때까지 명령을 대기열에 두었습니다. 별칭: `/share`. v2.1.212 이전에는 `/bug`와 `/share`가 `/feedback`의 별칭이었습니다 |

66| `/cd <path>` | 대화를 유지한 채 이 세션을 새 작업 디렉터리로 이동합니다. 경로의 일부를 입력하면 일치하는 디렉터리 제안이 표시되며, `Tab`을 눌러 제안을 수락합니다. 이동 즉시 Claude Code가 새 디렉터리에서 적용하는 항목과 `/cd`가 `/add-dir`와 어떻게 다른지는 [세션을 다른 디렉터리로 이동](https://code.claude.com/docs/ko/permissions.md#move-the-session-to-another-directory)을 참조하세요 |66| `/cd <path>` | 대화를 유지한 채 이 세션을 새 작업 디렉터리로 이동합니다. 경로의 일부를 입력하면 일치하는 디렉터리 제안이 표시되며, `Tab`을 눌러 제안을 수락합니다. 이동 즉시 Claude Code가 새 디렉터리에서 적용하는 항목과 `/cd`가 `/add-dir`와 어떻게 다른지는 [세션을 다른 디렉터리로 이동](https://code.claude.com/docs/ko/permissions.md#move-the-session-to-another-directory)을 참조하세요 |

67| `/chrome` | [Claude in Chrome](https://code.claude.com/docs/ko/chrome.md) 설정을 구성합니다 |67| `/chrome` | [Claude in Chrome](https://code.claude.com/docs/ko/chrome.md) 설정을 구성합니다 |

68| `/claude-api [migrate\|upgrade\|api-version\|managed-agents-onboard\|managed-agents-secure\|prompt-audit\|cost-optimize\|build-eval\|hillclimb\|preserved-thinking-migration]` | **[스킬](https://code.claude.com/docs/ko/skills.md#bundled-skills).** 프로젝트 언어에 맞는 [Claude API](https://platform.claude.com/docs/en/api/overview) 및 [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) 참조 자료를 로드합니다. 코드에서 `anthropic` 또는 `@anthropic-ai/sdk`를 임포트하면 자동으로 활성화되기도 합니다. 각 하위 명령의 기능과 필요한 버전은 [Claude API 프로젝트 작업](https://code.claude.com/docs/ko/skills.md#work-on-claude-api-projects)을 참조하세요 |68| `/claude-api [migrate\|upgrade\|api-version\|managed-agents-onboard\|managed-agents-secure\|prompt-audit\|cost-optimize\|latency-optimize\|build-eval\|hillclimb\|preserved-thinking-migration]` | **[스킬](https://code.claude.com/docs/ko/skills.md#bundled-skills).** 프로젝트 언어에 맞는 [Claude API](https://platform.claude.com/docs/en/api/overview) 및 [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) 참조 자료를 로드합니다. 코드에서 `anthropic` 또는 `@anthropic-ai/sdk`를 임포트하면 자동으로 활성화되기도 합니다. 각 하위 명령의 기능과 필요한 버전은 [Claude API 프로젝트 작업](https://code.claude.com/docs/ko/skills.md#work-on-claude-api-projects)을 참조하세요 |

69| `/claude-in-chrome [task]` | **[스킬](https://code.claude.com/docs/ko/skills.md#bundled-skills).** [Claude in Chrome](https://code.claude.com/docs/ko/chrome.md)을 통해 페이지 테스트, 양식 작성, 콘솔 로그 읽기 등의 작업을 Claude가 브라우저에서 수행하도록 합니다. 세션에서 Chrome 통합이 활성화된 경우(예: `claude --chrome` 사용) 또는 Claude Code가 [확장 프로그램 설치](https://code.claude.com/docs/ko/chrome.md#install-the-extension-when-claude-asks)를 제안할 수 있는 경우에 사용할 수 있습니다 |69| `/claude-in-chrome [task]` | **[스킬](https://code.claude.com/docs/ko/skills.md#bundled-skills).** [Claude in Chrome](https://code.claude.com/docs/ko/chrome.md)을 통해 페이지 테스트, 양식 작성, 콘솔 로그 읽기 등의 작업을 Claude가 브라우저에서 수행하도록 합니다. 세션에서 Chrome 통합이 활성화된 경우(예: `claude --chrome` 사용) 또는 Claude Code가 [확장 프로그램 설치](https://code.claude.com/docs/ko/chrome.md#install-the-extension-when-claude-asks)를 제안할 수 있는 경우에 사용할 수 있습니다 |

70| `/clear [name]` | 빈 컨텍스트로 새 대화를 시작합니다. 이름을 전달하면 `/resume` 선택기에서 이전 대화에 레이블을 지정합니다. 같은 대화를 계속하면서 컨텍스트를 확보하려면 대신 `/compact`를 사용합니다. `/resume`으로 이전 대화를 재개하거나, 같은 Claude Code 프로세스 내에서는 [되감기 메뉴의 이전 세션 항목](https://code.claude.com/docs/ko/checkpointing.md#rewind-past-a-cleared-conversation)에서 복원합니다. 별칭: `/reset`, `/new` |70| `/clear [name]` | 빈 컨텍스트로 새 대화를 시작합니다. 이름을 전달하면 `/resume` 선택기에서 이전 대화에 레이블을 지정합니다. 같은 대화를 계속하면서 컨텍스트를 확보하려면 대신 `/compact`를 사용합니다. `/resume`으로 이전 대화를 재개하거나, 같은 Claude Code 프로세스 내에서는 [되감기 메뉴의 이전 세션 항목](https://code.claude.com/docs/ko/checkpointing.md#rewind-past-a-cleared-conversation)에서 복원합니다. 별칭: `/reset`, `/new` |

71| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [--max-findings n\|all\|default] [pr#\|branch\|path]` | **[스킬](https://code.claude.com/docs/ko/skills.md#bundled-skills).** 현재 diff 또는 전달한 PR 번호, 브랜치, 경로에서 정확성 버그를 리뷰합니다. 모델과 effort 수준에 따라 정리할 부분도 리뷰 대상에 포함됩니다. 발견 사항을 적용하려면 `--fix`를, GitHub PR 또는 GitLab 병합 요청에 게시하려면 `--comment`를, 심층 [클라우드 리뷰](https://code.claude.com/docs/ko/ultrareview.md)를 실행하려면 `ultra`를 전달합니다. GitLab 병합 요청에 게시하려면 Claude Code v2.1.257 이상이 필요합니다. `github.com` PR 대상에 `ultra`를 사용할 때 `--post`를 전달하면 실행 대화 상자에서 [완료된 발견 사항을 PR에 게시](https://code.claude.com/docs/ko/ultrareview.md#post-findings-to-the-pull-request)하는 옵션이 미리 선택됩니다. `--post`는 Claude Code v2.1.227 이상이 필요합니다. effort 수준, 대상 지정, `/simplify`와의 관계는 [`/code-review`로 로컬에서 리뷰하기](https://code.claude.com/docs/ko/code-review-local)를 참조하세요. 별칭: `/review` |71| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [--max-findings n\|all\|default] [pr#\|branch\|path]` | **[스킬](https://code.claude.com/docs/ko/skills.md#bundled-skills).** 현재 diff 또는 전달한 PR 번호, 브랜치, 경로에서 정확성 버그를 리뷰합니다. 모델과 effort 수준에 따라 정리할 부분도 리뷰 대상에 포함됩니다. 발견 사항을 적용하려면 `--fix`를, GitHub PR 또는 GitLab 병합 요청에 게시하려면 `--comment`를, 심층 [클라우드 리뷰](https://code.claude.com/docs/ko/ultrareview.md)를 실행하려면 `ultra`를 전달합니다. GitLab 병합 요청에 게시하려면 Claude Code v2.1.257 이상이 필요합니다. `github.com` PR 대상에 `ultra`를 사용할 때 `--post`를 전달하면 실행 대화 상자에서 [완료된 발견 사항을 PR에 게시](https://code.claude.com/docs/ko/ultrareview.md#post-findings-to-the-pull-request)하는 옵션이 미리 선택됩니다. `--post`는 Claude Code v2.1.227 이상이 필요합니다. effort 수준, 대상 지정, `/simplify`와의 관계는 [`/code-review`로 로컬에서 리뷰하기](https://code.claude.com/docs/ko/code-review-local)를 참조하세요. 별칭: `/review` |

466claude --worktree feature-auth466claude --worktree feature-auth

467```467```

468 468 

469다른 이름으로 두 번째 터미널에서 동일한 명령을 실행하여 격리된 병렬 세션을 시작합니다. 커밋이 없는 저장소에서는 명령이 `Failed to resolve base branch "HEAD": git rev-parse failed` 오류로 실패합니다. 정리, `.worktreeinclude` 및 비git VCS 지원에 대해서는 [Worktrees](https://code.claude.com/docs/ko/worktrees.md)를 참조하십시오. 별도의 터미널 대신 한 화면에서 병렬 세션을 모니터링하려면 [백그라운드 에이전트](https://code.claude.com/docs/ko/agent-view.md)를 참조하십시오.469다른 이름으로 두 번째 터미널에서 동일한 명령을 실행하여 격리된 병렬 세션을 시작합니다. 정리, `.worktreeinclude` 및 비git VCS 지원에 대해서는 [Worktrees](https://code.claude.com/docs/ko/worktrees.md)를 참조하십시오. 별도의 터미널 대신 한 화면에서 병렬 세션을 모니터링하려면 [백그라운드 에이전트](https://code.claude.com/docs/ko/agent-view.md)를 참조하십시오.

470 470 

471## 편집 전에 계획하기471## 편집 전에 계획하기

472 472 

19 19 

20## 압축 후 유지되는 것20## 압축 후 유지되는 것

21 21 

22긴 세션이 압축될 때, Claude Code는 대화 기록을 요약하여 컨텍스트 윈도우에 맞춥니다. v2.1.198부터는 요약 요청이 세션의 [확장 사고](https://code.claude.com/docs/ko/model-config.md#extended-thinking) 구성을 상속하므로, 세션에서 사고가 활성화되어 있을 때는 사고를 활성화하여 추론하고 그렇지 않으면 비활성화된 상태로 유지됩니다. 사고는 요약이 생성되는 방식에만 영향을 미치며, 이후 세션 설정은 변경되지 않습니다. 각 콘텐츠 종류에 어떤 일이 발생하는지는 로드된 방식에 따라 달라집니다:22긴 세션이 압축될 때, Claude Code는 대화 기록을 요약하여 컨텍스트 윈도우에 맞춥니다.

23 23 

24| 메커니즘 | 압축 후 |24| 메커니즘 | 압축 후 |

25| :- | :- |25| :- | :- |

243| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | `1`로 설정하면 Claude Code에 포함된 [스킬](https://code.claude.com/docs/ko/skills.md)과 워크플로를 비활성화합니다: 번들 스킬과 워크플로는 완전히 제거되며, `/init` 같은 기본 제공 명령은 계속 입력할 수 있지만 모델에게는 숨겨집니다. `/doctor`는 기본 제공 명령처럼 계속 입력할 수 있으며, 숨기려면 대신 `DISABLE_DOCTOR_COMMAND`를 사용합니다. 플러그인, `.claude/skills/`, `.claude/commands/`의 스킬은 영향을 받지 않습니다. [`disableBundledSkills`](https://code.claude.com/docs/ko/settings-reference#disablebundledskills) 설정과 동일합니다 |243| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | `1`로 설정하면 Claude Code에 포함된 [스킬](https://code.claude.com/docs/ko/skills.md)과 워크플로를 비활성화합니다: 번들 스킬과 워크플로는 완전히 제거되며, `/init` 같은 기본 제공 명령은 계속 입력할 수 있지만 모델에게는 숨겨집니다. `/doctor`는 기본 제공 명령처럼 계속 입력할 수 있으며, 숨기려면 대신 `DISABLE_DOCTOR_COMMAND`를 사용합니다. 플러그인, `.claude/skills/`, `.claude/commands/`의 스킬은 영향을 받지 않습니다. [`disableBundledSkills`](https://code.claude.com/docs/ko/settings-reference#disablebundledskills) 설정과 동일합니다 |

244| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Claude Code를 임베드하고 자체 브라우저 안내를 제공하는 호스트용입니다. `1`로 설정하면 [Claude in Chrome](https://code.claude.com/docs/ko/chrome.md) 브라우저 도구는 사용할 수 있게 유지하면서 시스템 프롬프트의 Chrome 섹션과 `/claude-in-chrome` [번들 스킬](https://code.claude.com/docs/ko/skills.md#bundled-skills)을 생략합니다. VS Code에서는 v2.1.314 이상의 확장 프로그램이 세션 메시지에서도 Claude in Chrome 지침을 제외합니다. Claude Code v2.1.257 이상이 필요합니다 |244| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Claude Code를 임베드하고 자체 브라우저 안내를 제공하는 호스트용입니다. `1`로 설정하면 [Claude in Chrome](https://code.claude.com/docs/ko/chrome.md) 브라우저 도구는 사용할 수 있게 유지하면서 시스템 프롬프트의 Chrome 섹션과 `/claude-in-chrome` [번들 스킬](https://code.claude.com/docs/ko/skills.md#bundled-skills)을 생략합니다. VS Code에서는 v2.1.314 이상의 확장 프로그램이 세션 메시지에서도 Claude in Chrome 지침을 제외합니다. Claude Code v2.1.257 이상이 필요합니다 |

245| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | `1`로 설정하면 사용자, 프로젝트, 자동 메모리 파일을 포함한 모든 CLAUDE.md 메모리 파일을 컨텍스트에 로드하지 않습니다 |245| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | `1`로 설정하면 사용자, 프로젝트, 자동 메모리 파일을 포함한 모든 CLAUDE.md 메모리 파일을 컨텍스트에 로드하지 않습니다 |

246| `CLAUDE_CODE_DISABLE_CRON` | `1`로 설정하면 [세션 범위 예약 작업](https://code.claude.com/docs/ko/scheduled-tasks.md)을 비활성화합니다. `/loop` 스킬과 cron 도구를 사용할 수 없게 되며, 세션 도중 이미 실행 중인 작업을 포함해 이미 예약된 모든 작업의 실행이 중지됩니다 |246| `CLAUDE_CODE_DISABLE_CRON` | `1`로 설정하면 [세션 범위 예약 작업](https://code.claude.com/docs/ko/scheduled-tasks.md#disable-scheduled-tasks)을 비활성화합니다. `/loop` 스킬과 `CronCreate`를 사용할 수 없게 되며, 세션 도중 이미 실행 중인 작업을 포함해 이미 예약된 모든 작업이 더 이상 실행되지 않습니다 |

247| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | `1`로 설정하면 중요 경로 삭제에 대한 `auto` 및 `bypassPermissions` [시간 제한 및 거부](https://code.claude.com/docs/ko/permission-modes.md#time-limits-and-denials-in-auto-and-bypasspermissions-modes)를 끕니다. 그러면 이러한 삭제는 `auto` 모드에서는 분류기로 전달되고, `bypassPermissions` 모드에서는 Claude Code가 프롬프트를 표시할 수 있는 곳이면 어디서든 시간 제한 없는 프롬프트가 표시됩니다. Claude Code는 설정의 `env` 블록을 통해 전달된 값을 무시하므로, Claude Code를 실행하는 환경에서 설정합니다. Claude Code v2.1.281 이상이 필요합니다 |247| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | `1`로 설정하면 중요 경로 삭제에 대한 `auto` 및 `bypassPermissions` [시간 제한 및 거부](https://code.claude.com/docs/ko/permission-modes.md#time-limits-and-denials-in-auto-and-bypasspermissions-modes)를 끕니다. 그러면 이러한 삭제는 `auto` 모드에서는 분류기로 전달되고, `bypassPermissions` 모드에서는 Claude Code가 프롬프트를 표시할 수 있는 곳이면 어디서든 시간 제한 없는 프롬프트가 표시됩니다. Claude Code는 설정의 `env` 블록을 통해 전달된 값을 무시하므로, Claude Code를 실행하는 환경에서 설정합니다. Claude Code v2.1.281 이상이 필요합니다 |

248| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | `1`로 설정하면 API 요청에서 프리릴리스 `anthropic-beta` 요청 헤더, 이와 짝을 이루는 본문 필드, `defer_loading` 및 `eager_input_streaming` 같은 베타 도구 스키마 필드를 제거합니다. 프록시 게이트웨이가 `anthropic-beta` 헤더에 대해 `Unexpected value(s)` 오류나 `Extra inputs are not permitted` 오류로 요청을 거부할 때 사용합니다. [프리릴리스 기능 비활성화](https://code.claude.com/docs/ko/llm-gateway-protocol.md#disable-pre-release-capabilities)에 [MCP 도구 검색](https://code.claude.com/docs/ko/mcp.md#scale-with-mcp-tool-search)을 포함해 이 변수가 제거하는 항목과 Claude Code가 계속 전송하는 항목이 나와 있습니다 |248| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | `1`로 설정하면 API 요청에서 프리릴리스 `anthropic-beta` 요청 헤더, 이와 짝을 이루는 본문 필드, `defer_loading` 및 `eager_input_streaming` 같은 베타 도구 스키마 필드를 제거합니다. 프록시 게이트웨이가 `anthropic-beta` 헤더에 대해 `Unexpected value(s)` 오류나 `Extra inputs are not permitted` 오류로 요청을 거부할 때 사용합니다. [프리릴리스 기능 비활성화](https://code.claude.com/docs/ko/llm-gateway-protocol.md#disable-pre-release-capabilities)에 [MCP 도구 검색](https://code.claude.com/docs/ko/mcp.md#scale-with-mcp-tool-search)을 포함해 이 변수가 제거하는 항목과 Claude Code가 계속 전송하는 항목이 나와 있습니다 |

249| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | `1`로 설정하면 기본 제공 [Explore 및 Plan 서브에이전트](https://code.claude.com/docs/ko/sub-agents.md#built-in-subagents)를 비활성화합니다. Claude는 대신 검색 도구나 general-purpose 서브에이전트로 탐색하며, [플랜 모드](https://code.claude.com/docs/ko/permission-modes.md#analyze-before-you-edit-with-plan-mode)는 Explore 및 Plan 에이전트를 실행하지 않고 파일을 직접 읽습니다. 이름이 `Explore` 또는 `Plan`인 사용자 지정 서브에이전트는 영향을 받지 않습니다. Agent SDK나 비대화형 모드에서 모든 기본 제공 서브에이전트 유형을 제거하려면 대신 `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`를 사용합니다. Claude Code v2.1.198 이상이 필요합니다 |249| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | `1`로 설정하면 기본 제공 [Explore 및 Plan 서브에이전트](https://code.claude.com/docs/ko/sub-agents.md#built-in-subagents)를 비활성화합니다. Claude는 대신 검색 도구나 general-purpose 서브에이전트로 탐색하며, [플랜 모드](https://code.claude.com/docs/ko/permission-modes.md#analyze-before-you-edit-with-plan-mode)는 Explore 및 Plan 에이전트를 실행하지 않고 파일을 직접 읽습니다. 이름이 `Explore` 또는 `Plan`인 사용자 지정 서브에이전트는 영향을 받지 않습니다. Agent SDK나 비대화형 모드에서 모든 기본 제공 서브에이전트 유형을 제거하려면 대신 `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`를 사용합니다. Claude Code v2.1.198 이상이 필요합니다 |

250| `CLAUDE_CODE_DISABLE_FAST_MODE` | `1`로 설정하면 [빠른 모드](https://code.claude.com/docs/ko/fast-mode.md)를 비활성화합니다 |250| `CLAUDE_CODE_DISABLE_FAST_MODE` | `1`로 설정하면 [빠른 모드](https://code.claude.com/docs/ko/fast-mode.md)를 비활성화합니다 |

251| `CLAUDE_CODE_DISABLE_FEATURE_FLAGS` | `1`로 설정하면 기능 플래그 가져오기를 끕니다. Claude Code v2.1.319 이상이 필요합니다. 이 변수를 설정하면 [Remote Control](https://code.claude.com/docs/ko/remote-control.md#requirements)과 기타 [기능 플래그 가져오기가 필요한 기능](#features-that-need-feature-flag-fetching)을 사용할 수 없습니다. `DISABLE_TELEMETRY`도 설정한 경우를 제외하고 텔레메트리 이벤트 로깅은 계속 켜져 있습니다. 이전 이름인 `DISABLE_GROWTHBOOK`도 여전히 작동하며, v2.1.124부터 v2.1.318까지는 이 이름만 읽습니다 |

251| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | `1`로 설정하면 "How is Claude doing?" 세션 품질 설문을 비활성화합니다. `DISABLE_TELEMETRY`, `DO_NOT_TRACK` 또는 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`이 설정된 경우에도 설문이 비활성화되며, 단 `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`로 다시 사용하도록 선택한 경우는 예외입니다. 완전히 비활성화하는 대신 샘플링 비율을 설정하려면 [`feedbackSurveyRate`](https://code.claude.com/docs/ko/settings-reference#feedbacksurveyrate) 설정을 사용합니다. [세션 품질 설문](https://code.claude.com/docs/ko/data-usage.md#session-quality-surveys)을 참조하세요 |252| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | `1`로 설정하면 "How is Claude doing?" 세션 품질 설문을 비활성화합니다. `DISABLE_TELEMETRY`, `DO_NOT_TRACK` 또는 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`이 설정된 경우에도 설문이 비활성화되며, 단 `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`로 다시 사용하도록 선택한 경우는 예외입니다. 완전히 비활성화하는 대신 샘플링 비율을 설정하려면 [`feedbackSurveyRate`](https://code.claude.com/docs/ko/settings-reference#feedbacksurveyrate) 설정을 사용합니다. [세션 품질 설문](https://code.claude.com/docs/ko/data-usage.md#session-quality-surveys)을 참조하세요 |

252| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | `1`로 설정하면 파일 [체크포인트](https://code.claude.com/docs/ko/checkpointing.md) 기능을 비활성화합니다. `/rewind` 명령으로 코드 변경 사항을 복원할 수 없게 됩니다. [`fileCheckpointingEnabled`](https://code.claude.com/docs/ko/settings-reference#filecheckpointingenabled) 설정을 재정의합니다 |253| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | `1`로 설정하면 파일 [체크포인트](https://code.claude.com/docs/ko/checkpointing.md) 기능을 비활성화합니다. `/rewind` 명령으로 코드 변경 사항을 복원할 수 없게 됩니다. [`fileCheckpointingEnabled`](https://code.claude.com/docs/ko/settings-reference#filecheckpointingenabled) 설정을 재정의합니다 |

253| `CLAUDE_CODE_DISABLE_FILE_MENTIONS` | `1`로 설정하면 Claude Code가 파일과 디렉터리의 [`@` 멘션](https://code.claude.com/docs/ko/common-workflows#reference-files-and-directories)을 확장하지 않습니다. 대신 Claude는 멘션된 경로와 함께 파일 도구로 읽으라는 안내를 받습니다. [프로젝트 및 로컬 설정](https://code.claude.com/docs/ko/settings-reference.md#variables-claude-code-ignores-in-env)에서는 무시됩니다. Claude Code v2.1.299 이상이 필요합니다 |254| `CLAUDE_CODE_DISABLE_FILE_MENTIONS` | `1`로 설정하면 Claude Code가 파일과 디렉터리의 [`@` 멘션](https://code.claude.com/docs/ko/common-workflows#reference-files-and-directories)을 확장하지 않습니다. 대신 Claude는 멘션된 경로와 함께 파일 도구로 읽으라는 안내를 받습니다. [프로젝트 및 로컬 설정](https://code.claude.com/docs/ko/settings-reference.md#variables-claude-code-ignores-in-env)에서는 무시됩니다. Claude Code v2.1.299 이상이 필요합니다 |

451| `DISABLE_ERROR_REPORTING` | 오류 보고를 거부하려면 `1`과 같이 비어 있지 않은 아무 값으로 설정합니다. 대부분의 켜기/끄기 변수와 달리 **`0` 또는 `false`로 설정해도 여전히 거부됩니다**. 오류 보고를 다시 켜려면 변수를 설정 해제합니다 |452| `DISABLE_ERROR_REPORTING` | 오류 보고를 거부하려면 `1`과 같이 비어 있지 않은 아무 값으로 설정합니다. 대부분의 켜기/끄기 변수와 달리 **`0` 또는 `false`로 설정해도 여전히 거부됩니다**. 오류 보고를 다시 켜려면 변수를 설정 해제합니다 |

452| `DISABLE_EXTRA_USAGE_COMMAND` | 사용자가 속도 제한을 넘어 추가 사용량을 구매할 수 있는 `/usage-credits` 명령을 숨기려면 `1`로 설정합니다 |453| `DISABLE_EXTRA_USAGE_COMMAND` | 사용자가 속도 제한을 넘어 추가 사용량을 구매할 수 있는 `/usage-credits` 명령을 숨기려면 `1`로 설정합니다 |

453| `DISABLE_FEEDBACK_COMMAND` | `/feedback` 명령과 [Claude가 작성한 피드백](https://code.claude.com/docs/ko/tools-reference.md#sendfeedback-tool-behavior)을 비활성화하려면 `1`로 설정합니다. 동일한 경로로 보고하는 `/bug` 및 `/share`도 비활성화합니다. v2.1.212 이전에는 이들이 `/feedback`의 별칭이었으므로 모든 이름에서 명령이 비활성화되었습니다. 이전 이름인 `DISABLE_BUG_COMMAND`도 허용됩니다 |454| `DISABLE_FEEDBACK_COMMAND` | `/feedback` 명령과 [Claude가 작성한 피드백](https://code.claude.com/docs/ko/tools-reference.md#sendfeedback-tool-behavior)을 비활성화하려면 `1`로 설정합니다. 동일한 경로로 보고하는 `/bug` 및 `/share`도 비활성화합니다. v2.1.212 이전에는 이들이 `/feedback`의 별칭이었으므로 모든 이름에서 명령이 비활성화되었습니다. 이전 이름인 `DISABLE_BUG_COMMAND`도 허용됩니다 |

454| `DISABLE_GROWTHBOOK` | 기능 플래그 가져오기를 비활성화하고 모든 플래그에 코드 기본값을 사용하려면 `1` 또는 `true`로 설정합니다. 이렇게 하면 [Remote Control](https://code.claude.com/docs/ko/remote-control.md#requirements)과 기타 [기능 플래그 가져오기가 필요한 기능](#features-that-need-feature-flag-fetching)을 사용할 수 없게 됩니다. `0` 또는 `false`로 설정하면 가져오기가 켜진 상태로 유지됩니다. `DISABLE_TELEMETRY`도 설정하지 않는 한 텔레메트리 이벤트 로깅은 켜진 상태로 유지됩니다 |455| `DISABLE_GROWTHBOOK` | `1`로 설정하면 [기능 플래그 가져오기](#features-that-need-feature-flag-fetching)를 끕니다. Claude Code v2.1.124 이상이 필요합니다. v2.1.319 이상이 필요한 `CLAUDE_CODE_DISABLE_FEATURE_FLAGS`로 대체되었습니다. v2.1.318 이하 버전의 머신이 이 구성을 읽는 경우를 제외하고는 새 이름을 사용합니다. 이 이름도 계속 작동합니다 |

455| `DISABLE_INSTALLATION_CHECKS` | 설치 경고를 비활성화하려면 `1`로 설정합니다. 표준 설치의 문제를 가릴 수 있으므로, 설치 위치를 수동으로 관리하는 경우에만 사용합니다 |456| `DISABLE_INSTALLATION_CHECKS` | 설치 경고를 비활성화하려면 `1`로 설정합니다. 표준 설치의 문제를 가릴 수 있으므로, 설치 위치를 수동으로 관리하는 경우에만 사용합니다 |

456| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | `/install-github-app` 명령을 숨기려면 `1`로 설정합니다. 서드 파티 공급자(Amazon Bedrock, Google Cloud's Agent Platform 또는 Microsoft Foundry)를 사용할 때는 이미 숨겨져 있습니다 |457| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | `/install-github-app` 명령을 숨기려면 `1`로 설정합니다. 서드 파티 공급자(Amazon Bedrock, Google Cloud's Agent Platform 또는 Microsoft Foundry)를 사용할 때는 이미 숨겨져 있습니다 |

457| `DISABLE_INTERLEAVED_THINKING` | interleaved-thinking 베타 헤더 전송을 방지하려면 `1`로 설정합니다. LLM 게이트웨이 또는 공급자가 [인터리브드 사고](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking)를 지원하지 않을 때 유용합니다 |458| `DISABLE_INTERLEAVED_THINKING` | interleaved-thinking 베타 헤더 전송을 방지하려면 `1`로 설정합니다. LLM 게이트웨이 또는 공급자가 [인터리브드 사고](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking)를 지원하지 않을 때 유용합니다 |

569 570 

570Claude Code는 Anthropic에서 가져오는 기능 플래그를 통해 일부 기능을 켭니다. Claude Code는 다음 세션에서는 이 가져오기를 건너뜁니다.571Claude Code는 Anthropic에서 가져오는 기능 플래그를 통해 일부 기능을 켭니다. Claude Code는 다음 세션에서는 이 가져오기를 건너뜁니다.

571 572 

572* `DISABLE_GROWTHBOOK`, `DISABLE_TELEMETRY`, `DO_NOT_TRACK` 또는 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`을 설정한 세션. 어떤 값이 가져오기를 끄는지는 [변수 표](#variables)의 각 변수 행에 나와 있습니다573* `CLAUDE_CODE_DISABLE_FEATURE_FLAGS`, `DISABLE_TELEMETRY`, `DO_NOT_TRACK` 또는 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`을 설정한 세션. 어떤 값이 가져오기를 끄는지는 [변수 표](#variables)의 각 변수 행에 나와 있습니다

573* Amazon Bedrock, Claude Platform on AWS, Google Cloud의 Agent Platform 또는 Microsoft Foundry와 같은 [서드파티 제공자](https://code.claude.com/docs/ko/third-party-integrations.md)를 사용하는 세션. 단, Claude Code를 내장한 호스트 플랫폼이 `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`를 설정한 경우는 예외입니다574* Amazon Bedrock, Claude Platform on AWS, Google Cloud의 Agent Platform 또는 Microsoft Foundry와 같은 [서드파티 제공자](https://code.claude.com/docs/ko/third-party-integrations.md)를 사용하는 세션. 단, Claude Code를 내장한 호스트 플랫폼이 `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`를 설정한 경우는 예외입니다

574* [Claude apps 게이트웨이](https://code.claude.com/docs/ko/claude-apps-gateway) 세션575* [Claude apps 게이트웨이](https://code.claude.com/docs/ko/claude-apps-gateway) 세션

575 576 

576가져오기가 꺼져 있으면 다음 작업을 할 수 없습니다.577가져오기가 꺼져 있으면 다음 작업을 할 수 없습니다.

577 578 

578* `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 또는 `DISABLE_GROWTHBOOK`이 설정된 상태에서 [Remote Control](https://code.claude.com/docs/ko/remote-control.md) 사용. `DISABLE_TELEMETRY` 및 `DO_NOT_TRACK`에 대해서는 [Remote Control 요구 사항](https://code.claude.com/docs/ko/remote-control.md#requirements)을 참조하십시오579* `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 또는 [`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](#variables)가 설정된 상태에서 [Remote Control](https://code.claude.com/docs/ko/remote-control.md) 사용. `DISABLE_TELEMETRY` 및 `DO_NOT_TRACK`에 대해서는 [Remote Control 요구 사항](https://code.claude.com/docs/ko/remote-control.md#requirements)을 참조하십시오

579* [Remote Control](https://code.claude.com/docs/ko/remote-control.md#requirements)을 사용할 수 없을 때 [이 머신 외부의 세션에 메시지 보내기](https://code.claude.com/docs/ko/cross-session-messaging.md#message-sessions-on-other-machines). 이 머신의 세션 간 메시지 전송은 가져오기가 꺼져 있어도 작동합니다580* [Remote Control](https://code.claude.com/docs/ko/remote-control.md#requirements)을 사용할 수 없을 때 [이 머신 외부의 세션에 메시지 보내기](https://code.claude.com/docs/ko/cross-session-messaging.md#message-sessions-on-other-machines). 이 머신의 세션 간 메시지 전송은 가져오기가 꺼져 있어도 작동합니다

580* [`claude import` 또는 `/import` 명령](https://code.claude.com/docs/ko/cli-reference#cli-commands) 실행581* [`claude import` 또는 `/import` 명령](https://code.claude.com/docs/ko/cli-reference#cli-commands) 실행

581* [`/skill-doctor`](https://code.claude.com/docs/ko/skills#find-unused-skills) 실행 또는 `/plugin` **Stats** 탭에서 해당 보고서 열기582* [`/skill-doctor`](https://code.claude.com/docs/ko/skills#find-unused-skills) 실행 또는 `/plugin` **Stats** 탭에서 해당 보고서 열기

582* Pro, Max 및 Ultra 플랜에서 [`/restart`](https://code.claude.com/docs/ko/commands) 실행583* Pro, Max 및 Ultra 플랜에서 [`/restart`](https://code.claude.com/docs/ko/commands) 실행

583* claude.ai 계정에서 활성화된 [스킬](https://code.claude.com/docs/ko/skills.md#where-synced-skills-load) 및 [플러그인](https://code.claude.com/docs/ko/plugins/loading.md#synced-plugins)을 터미널 세션에 동기화584* claude.ai 계정에서 활성화된 [스킬](https://code.claude.com/docs/ko/skills.md#where-synced-skills-load) 및 [플러그인](https://code.claude.com/docs/ko/plugins/loading.md#synced-plugins)을 터미널 세션에 동기화

584* [You should know mod](https://code.claude.com/docs/ko/interactive-mode.md#you-should-know-suggestions) 켜기585* [You should know mod](https://code.claude.com/docs/ko/interactive-mode.md#you-should-know-suggestions) 켜기

585* [advisor 도구](https://code.claude.com/docs/ko/advisor.md#requirements) 사용586* [advisor 도구](https://code.claude.com/docs/ko/advisor.md#requirements) 사용. 단, Claude Code v2.1.300 이상을 사용하는 Claude Platform on AWS에서는 예외입니다

586* [MCP 작업](https://code.claude.com/docs/ko/mcp.md#mcp-tasks-that-run-on-the-server) 사용587* [MCP 작업](https://code.claude.com/docs/ko/mcp.md#mcp-tasks-that-run-on-the-server) 사용

587* [아티팩트의 댓글](https://code.claude.com/docs/ko/artifacts.md#collect-comments-on-an-artifact) 읽기 또는 답글 달기588* [아티팩트의 댓글](https://code.claude.com/docs/ko/artifacts.md#collect-comments-on-an-artifact) 읽기 또는 답글 달기

588* Claude가 [다른 조직의 공개 아티팩트](https://code.claude.com/docs/ko/artifacts.md#read-an-artifact-shared-with-you)를 읽도록 하기589* Claude가 [다른 조직의 공개 아티팩트](https://code.claude.com/docs/ko/artifacts.md#read-an-artifact-shared-with-you)를 읽도록 하기

562| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](https://code.claude.com/docs/ko/env-vars) | 500 | API가 `529` 과부하 오류로 거부한 요청의 재시도 간 백오프 시작 지연 시간(밀리초)입니다. API가 용량 한계에 도달했을 때 재시도를 더 긴 기간에 걸쳐 분산하려면 최대 32000까지 값을 높이세요. `CLAUDE_CODE_RETRY_WATCHDOG`이 `1`로 설정되어 있거나 거부된 요청이 [빠른 모드](https://code.claude.com/docs/ko/fast-mode.md#handle-rate-limits)로 전송된 경우에는 효과가 없습니다. Claude Code v2.1.292 이상이 필요합니다. |562| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](https://code.claude.com/docs/ko/env-vars) | 500 | API가 `529` 과부하 오류로 거부한 요청의 재시도 간 백오프 시작 지연 시간(밀리초)입니다. API가 용량 한계에 도달했을 때 재시도를 더 긴 기간에 걸쳐 분산하려면 최대 32000까지 값을 높이세요. `CLAUDE_CODE_RETRY_WATCHDOG`이 `1`로 설정되어 있거나 거부된 요청이 [빠른 모드](https://code.claude.com/docs/ko/fast-mode.md#handle-rate-limits)로 전송된 경우에는 효과가 없습니다. Claude Code v2.1.292 이상이 필요합니다. |

563| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](https://code.claude.com/docs/ko/env-vars) | 32000 | API가 `529` 과부하 오류로 거부한 요청의 재시도 간 백오프 상한(밀리초)입니다. API가 용량 한계에 도달했을 때 이후 재시도 간격이 계속 벌어지도록 하려면 최대 64000까지 값을 높이세요. `CLAUDE_CODE_RETRY_WATCHDOG`이 `1`로 설정되어 있거나 거부된 요청이 [빠른 모드](https://code.claude.com/docs/ko/fast-mode.md#handle-rate-limits)로 전송된 경우에는 효과가 없습니다. Claude Code v2.1.296 이상이 필요합니다. |563| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](https://code.claude.com/docs/ko/env-vars) | 32000 | API가 `529` 과부하 오류로 거부한 요청의 재시도 간 백오프 상한(밀리초)입니다. API가 용량 한계에 도달했을 때 이후 재시도 간격이 계속 벌어지도록 하려면 최대 64000까지 값을 높이세요. `CLAUDE_CODE_RETRY_WATCHDOG`이 `1`로 설정되어 있거나 거부된 요청이 [빠른 모드](https://code.claude.com/docs/ko/fast-mode.md#handle-rate-limits)로 전송된 경우에는 효과가 없습니다. Claude Code v2.1.296 이상이 필요합니다. |

564| [`API_TIMEOUT_MS`](https://code.claude.com/docs/ko/env-vars) | 600000 | 각 요청 시도가 응답 헤더를 받기까지 주어지는 시간(밀리초)입니다. 그 이후 스트리밍 응답이 진행되는 시간은 제한하지 않습니다. 느린 네트워크나 프록시의 경우 값을 높이세요. 이 값이 첫 바이트 기한의 상한으로 사용되는 방식은 [No response from API](#no-response-from-api)를 참조하세요. |564| [`API_TIMEOUT_MS`](https://code.claude.com/docs/ko/env-vars) | 600000 | 각 요청 시도가 응답 헤더를 받기까지 주어지는 시간(밀리초)입니다. 그 이후 스트리밍 응답이 진행되는 시간은 제한하지 않습니다. 느린 네트워크나 프록시의 경우 값을 높이세요. 이 값이 첫 바이트 기한의 상한으로 사용되는 방식은 [No response from API](#no-response-from-api)를 참조하세요. |

565| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](https://code.claude.com/docs/ko/env-vars) | 설정 안 됨 | 시간 초과된 [비스트리밍 요청](#streaming-response-ended-before-any-complete-data-was-received)을 다시 보내는 횟수의 한도입니다. 한도에 도달하면 요청이 실패합니다. 생성하는 데 타임아웃보다 오래 걸리는 Claude의 응답은 다시 보낼 때마다 다시 시간 초과되므로, 더 빨리 실패하려면 `0`과 같은 낮은 값으로 설정하세요. 각 비스트리밍 시도는 로컬 세션에서 300초 후, 또는 `API_TIMEOUT_MS`를 양수 값으로 설정한 경우 해당 시간 후에 시간 초과됩니다. Claude Code v2.1.285 이상이 필요합니다. |565| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](https://code.claude.com/docs/ko/env-vars) | 설정 안 됨 | 시간 초과된 [비스트리밍 요청](#streaming-response-ended-before-any-complete-data-was-received)을 다시 보내는 횟수의 한도입니다. 한도에 도달하면 요청이 실패합니다. 생성하는 데 타임아웃보다 오래 걸리는 Claude의 응답은 다시 보낼 때마다 다시 시간 초과되므로, 더 빨리 실패하려면 `0`과 같은 낮은 값으로 설정하세요. 각 시도의 타임아웃은 [비스트리밍 시도의 대기 시간](#how-long-a-non-streaming-attempt-waits)을 참조하세요. Claude Code v2.1.285 이상이 필요합니다. |

566| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](https://code.claude.com/docs/ko/env-vars) | 설정 안 됨 | 스트리밍 요청의 첫 번째 응답 바이트에 대한 기한(밀리초)입니다. Claude Code v2.1.242 이상이 필요합니다. 이 값이 설정되지 않았을 때 Claude Code가 기한을 정하는 방법은 [No response from API](#no-response-from-api)를 참조하세요. |566| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](https://code.claude.com/docs/ko/env-vars) | 설정 안 됨 | 스트리밍 요청의 첫 번째 응답 바이트에 대한 기한(밀리초)입니다. Claude Code v2.1.242 이상이 필요합니다. 이 값이 설정되지 않았을 때 Claude Code가 기한을 정하는 방법은 [No response from API](#no-response-from-api)를 참조하세요. |

567 567 

568#### 비스트리밍 시도의 대기 시간

569 

570비스트리밍 시도는 요청 타임아웃과 본문 유휴 타임아웃 중 먼저 도달하는 시점에 종료됩니다.

571 

572* **요청 타임아웃**: 양수 값을 설정한 경우 `API_TIMEOUT_MS`, 그렇지 않으면 로컬 세션에서 300초입니다.

573* **[본문 유휴 타임아웃](https://code.claude.com/docs/ko/network-config.md#streaming-idle-watchdogs)**: 이 타임아웃이 적용되고 사용자가 끄지 않은 경우, `API_TIMEOUT_MS`를 아무리 높게 설정하더라도 응답 없이 5\~6분이 지나면 종료됩니다.

574 

568## 서버 오류575## 서버 오류

569 576 

570이러한 오류의 대부분은 추론 제공자에서 발생합니다: Anthropic API의 Anthropic 서비스, Amazon Bedrock의 해당 제공자 엔드포인트 뒤의 서비스, Google Cloud의 Agent Platform, Microsoft Foundry 또는 사용자 정의 게이트웨이입니다. [자동 모드가 작업의 안전성을 결정할 수 없음](#auto-mode-cannot-determine-the-safety-of-an-action) 및 [API 오류로 인해 에이전트가 조기에 종료됨](#agent-terminated-early-due-to-an-api-error)은 또한 사용자 측의 원인을 다룹니다. 예를 들어 분류기 모델을 호출할 수 없는 Amazon Bedrock 계정이나 사용 한도에 도달한 서브에이전트입니다.577이러한 오류의 대부분은 추론 제공자에서 발생합니다: Anthropic API의 Anthropic 서비스, Amazon Bedrock의 해당 제공자 엔드포인트 뒤의 서비스, Google Cloud의 Agent Platform, Microsoft Foundry 또는 사용자 정의 게이트웨이입니다. [자동 모드가 작업의 안전성을 결정할 수 없음](#auto-mode-cannot-determine-the-safety-of-an-action) 및 [API 오류로 인해 에이전트가 조기에 종료됨](#agent-terminated-early-due-to-an-api-error)은 또한 사용자 측의 원인을 다룹니다. 예를 들어 분류기 모델을 호출할 수 없는 Amazon Bedrock 계정이나 사용 한도에 도달한 서브에이전트입니다.

2212이것은 클라이언트 측 네트워크 문제가 아닙니다. 클라우드 세션 및 [클라우드 예약 작업](https://code.claude.com/docs/ko/routines.md)은 세션의 네트워크를 통한 아웃바운드 트래픽이 [클라우드 환경의](https://code.claude.com/docs/ko/cloud-environments.md) 허용 목록으로 필터링되는 샌드박스 VM 내에서 실행됩니다:2219이것은 클라이언트 측 네트워크 문제가 아닙니다. 클라우드 세션 및 [클라우드 예약 작업](https://code.claude.com/docs/ko/routines.md)은 세션의 네트워크를 통한 아웃바운드 트래픽이 [클라우드 환경의](https://code.claude.com/docs/ko/cloud-environments.md) 허용 목록으로 필터링되는 샌드박스 VM 내에서 실행됩니다:

2213 2220 

2214* **GitHub 및 커넥터 트래픽**: [GitHub 작업](https://code.claude.com/docs/ko/cloud-environments.md#github-proxy) 및 MCP 커넥터 트래픽은 별도의 채널을 사용하므로 다른 호스트가 차단되는 동안에도 계속 작동할 수 있습니다.2221* **GitHub 및 커넥터 트래픽**: [GitHub 작업](https://code.claude.com/docs/ko/cloud-environments.md#github-proxy) 및 MCP 커넥터 트래픽은 별도의 채널을 사용하므로 다른 호스트가 차단되는 동안에도 계속 작동할 수 있습니다.

2215* **기본 환경**: **기본** 환경은 **신뢰할 수 있는** 액세스를 사용하며, 이는 패키지 레지스트리, 클라우드 공급자 API, 컨테이너 레지스트리 및 일반적인 개발 도메인의 [기본 허용 목록](https://code.claude.com/docs/ko/cloud-environments.md#default-allowed-domains)을 허용하고 해당 경로의 다른 도메인을 차단합니다.2222* **기본 환경**: **기본** 환경은 **패키지 관리자 허용**이 선택된 **제한됨** 액세스를 사용합니다. 이 환경의 세션은 패키지 레지스트리, 클라우드 공급자 API, 컨테이너 레지스트리 및 일반적인 개발 도메인의 [기본 허용 목록](https://code.claude.com/docs/ko/cloud-environments.md#default-allowed-domains)에 도달할 수 있습니다.

2216 2223 

2217**수행할 작업:**2224**수행할 작업:**

2218 2225 

2219이러한 단계는 자신의 환경 중 하나를 변경합니다. [조직 공유 환경](https://code.claude.com/docs/ko/cloud-environments.md#organization-shared-environments)은 선택기에서 읽기 전용으로 열리므로, [관리자 설정](https://claude.ai/admin-settings)의 **클라우드 환경** 페이지에서 Owner에게 네트워크 액세스를 변경하도록 요청합니다.2226이러한 단계는 자신의 환경 중 하나를 변경합니다. [조직 공유 환경](https://code.claude.com/docs/ko/cloud-environments.md#organization-shared-environments)은 선택기에서 읽기 전용으로 열리므로, [관리자 설정](https://claude.ai/admin-settings)의 **클라우드 환경** 페이지에서 Owner에게 네트워크 액세스를 변경하도록 요청합니다.

2220 2227 

2221* [클라우드 예약 작업의 양식](https://code.claude.com/docs/ko/routines.md#environments-and-network-access) 또는 클라우드 세션을 시작하는 [환경 선택기](https://code.claude.com/docs/ko/cloud-environments.md#configure-your-environment)에서 환경을 편집용으로 엽니다.2228* [클라우드 예약 작업의 양식](https://code.claude.com/docs/ko/routines.md#environments-and-network-access) 또는 클라우드 세션을 시작하는 [환경 선택기](https://code.claude.com/docs/ko/cloud-environments.md#configure-your-environment)에서 환경을 편집용으로 엽니다.

2222* **클라우드 환경 편집** 대화 상자에서 **네트워크 액세스**를 **신뢰할 수 있는**에서 **사용자 정의**로 변경한 다음 차단된 도메인을 **허용된 도메인**에 추가합니다. 한 줄에 하나의 도메인을 입력합니다. **또한 일반적인 패키지 관리자의 기본 목록 포함**을 확인하여 사용자 정의 도메인과 함께 [기본 허용 목록](https://code.claude.com/docs/ko/cloud-environments.md#default-allowed-domains)을 유지합니다. 제한 없는 액세스를 원하는 경우 대신 **전체**를 선택합니다.2229* **클라우드 환경 편집** 대화 상자에서 **네트워크 액세스** 아래의 **제한됨**을 선택한 다음 차단된 도메인을 **허용된 도메인**에 추가합니다. 한 줄에 하나의 도메인을 입력합니다. **패키지 관리자 허용**을 선택하여 사용자 도메인과 함께 [기본 허용 목록](https://code.claude.com/docs/ko/cloud-environments.md#default-allowed-domains)을 허용합니다. 제한 없는 액세스를 원하는 경우 대신 **전체**를 선택합니다.

2223* **변경 사항 저장**을 클릭합니다. 다음 실행은 업데이트된 허용 목록을 사용합니다. 이미 열려 있는 클라우드 세션의 경우, [네트워크 액세스 변경이 기존 세션에 도달할 때](https://code.claude.com/docs/ko/cloud-environments.md#network-access)를 참조합니다.2230* **변경 사항 저장**을 클릭합니다. 다음 실행은 업데이트된 허용 목록을 사용합니다. 이미 열려 있는 클라우드 세션의 경우, [네트워크 액세스 변경이 기존 세션에 도달할 때](https://code.claude.com/docs/ko/cloud-environments.md#network-access)를 참조합니다.

2224 2231 

2225액세스 수준 및 기본 허용 목록은 [네트워크 액세스](https://code.claude.com/docs/ko/cloud-environments.md#network-access)를 참조합니다. 로컬 CLI 세션은 이 정책의 영향을 받지 않습니다.2232액세스 수준 및 기본 허용 목록은 [네트워크 액세스](https://code.claude.com/docs/ko/cloud-environments.md#network-access)를 참조합니다. 로컬 CLI 세션은 이 정책의 영향을 받지 않습니다.

2342**수행할 작업:**2349**수행할 작업:**

2343 2350 

2344* **로그인되지 않음**: 메시지가 `: not signed in. Run /login, then retry.`로 이어집니다. `/login`을 실행한 다음 다시 보냅니다.2351* **로그인되지 않음**: 메시지가 `: not signed in. Run /login, then retry.`로 이어집니다. `/login`을 실행한 다음 다시 보냅니다.

2345* **조직의 거부**: 예를 들어 `: Feedback has not been enabled for your organization.` 또는 `: Feedback collection is not available for organizations with custom data retention policies.`입니다. 메시지에 `To report a bug, open an issue`가 추가되어 있으면 [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)에서 이슈를 엽니다. 이후 7일 동안 `/feedback`이 [조직의 정책에 의해 비활성화되었다](#feedback-is-disabled-by-your-organizations-policy)고 응답할 수 있습니다. 큐에 있는 초안은 큐에 남아 있으며 여전히 [일정에 따라 만료](https://code.claude.com/docs/ko/tools-reference.md#discard-or-keep-a-draft)됩니다.2352* **조직의 거부**: 예를 들어 `: Feedback has not been enabled for your organization.` 또는 `: Feedback collection is not available for organizations with custom data retention policies.`입니다. 이후 7일 동안 `/feedback`이 [조직의 정책에 의해 비활성화되었다](#feedback-is-disabled-by-your-organizations-policy)고 응답할 수 있습니다. 큐에 있는 초안은 큐에 남아 있으며 여전히 [일정에 따라 만료](https://code.claude.com/docs/ko/tools-reference.md#discard-or-keep-a-draft)됩니다.

2346* **거부된 자격 증명**: 메시지가 `: the sign-in this session uses is not allowed to send feedback` 또는 `: the server did not accept the credentials this session uses`로 이어집니다. Claude Code 프롬프트에서 `/status`를 실행하여 이 세션이 보내는 로그인, 토큰 또는 API 키를 확인합니다.2353* **거부된 자격 증명**: 메시지가 `: the sign-in this session uses is not allowed to send feedback` 또는 `: the server did not accept the credentials this session uses`로 이어집니다. Claude Code 프롬프트에서 `/status`를 실행하여 이 세션이 보내는 로그인, 토큰 또는 API 키를 확인합니다.

2347* **`Couldn't send feedback` 바로 뒤의 `(request timed out)` 또는 `(couldn't reach the service)`**: 보고서 또는 큐에 있는 초안을 다시 보냅니다. 대화 상자는 텍스트를 유지하며, 큐에 있는 초안의 메시지에는 `The draft is still queued.`라고 표시됩니다. 다른 요청도 실패하는 경우, 네트워크 연결을 확인하고 [Unable to connect to API](#unable-to-connect-to-api)를 참조합니다. 계속 실패하면 [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)에서 보고서를 제출합니다.2354* **`Couldn't send feedback` 바로 뒤의 `(request timed out)` 또는 `(couldn't reach the service)`**: 보고서 또는 큐에 있는 초안을 다시 보냅니다. 대화 상자는 텍스트를 유지하며, 큐에 있는 초안의 메시지에는 `The draft is still queued.`라고 표시됩니다. 다른 요청도 실패하는 경우, 네트워크 연결을 확인하고 [Unable to connect to API](#unable-to-connect-to-api)를 참조합니다. 계속 실패하면 [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)에서 보고서를 제출합니다.

2348* **`Couldn't send feedback` 바로 뒤의 `(server returned <status>)` 또는 이유 없음**: 상태는 서비스의 응답 코드입니다. 서비스가 자체 메시지를 보낸 경우 `(server returned 403: Access Forbidden)`처럼 상태 뒤에 이어집니다. 계속 실패하면 [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)에서 보고서를 제출합니다.2355* **`Couldn't send feedback` 바로 뒤의 `(server returned <status>)` 또는 이유 없음**: 상태는 서비스의 응답 코드입니다. 서비스가 자체 메시지를 보낸 경우 `(server returned 403: Access Forbidden)`처럼 상태 뒤에 이어집니다. 계속 실패하면 [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)에서 보고서를 제출합니다.

3492* **`Error: Workspace not trusted. <folder> is your home directory`**: 홈 디렉터리에 대한 신뢰는 저장되지 않으므로, 그곳에서 먼저 `claude`를 실행해도 도움이 되지 않습니다. 대신 프로젝트 디렉터리에서 `claude`를 한 번 실행하여 신뢰 대화 상자를 수락한 후 그곳에서 `claude ultrareview`를 실행하거나, `--trust-workspace`를 추가합니다.3499* **`Error: Workspace not trusted. <folder> is your home directory`**: 홈 디렉터리에 대한 신뢰는 저장되지 않으므로, 그곳에서 먼저 `claude`를 실행해도 도움이 되지 않습니다. 대신 프로젝트 디렉터리에서 `claude`를 한 번 실행하여 신뢰 대화 상자를 수락한 후 그곳에서 `claude ultrareview`를 실행하거나, `--trust-workspace`를 추가합니다.

3493* **`No answer in time.` 다음에 `Error: Workspace not trusted`**: `Trust <folder>? [y/N]` 질문에 5분 동안 응답이 없었습니다. `claude ultrareview`를 다시 실행하고 질문에 답합니다.3500* **`No answer in time.` 다음에 `Error: Workspace not trusted`**: `Trust <folder>? [y/N]` 질문에 5분 동안 응답이 없었습니다. `claude ultrareview`를 다시 실행하고 질문에 답합니다.

3494* **`Ultrareview did not start: <folder> is not trusted`**: 예를 들어 `n`으로 답하거나 Enter를 눌러 `Trust <folder>? [y/N]` 질문을 거절했습니다. 리뷰를 시작하려면 `claude ultrareview`를 다시 실행하고 `y`로 답합니다.3501* **`Ultrareview did not start: <folder> is not trusted`**: 예를 들어 `n`으로 답하거나 Enter를 눌러 `Trust <folder>? [y/N]` 질문을 거절했습니다. 리뷰를 시작하려면 `claude ultrareview`를 다시 실행하고 `y`로 답합니다.

3495* **``Ultrareview did not start: `--trust-workspace` takes no value``**: PR 번호나 `false`처럼 플래그가 아닌 무언가가 `--trust-workspace` 뒤에 왔습니다. 폴더를 신뢰하지 않는다면 플래그를 생략합니다. 이번 실행에 한해 신뢰하려면 PR 번호나 기준 브랜치를 플래그 앞에 둡니다: `claude ultrareview 1234 --trust-workspace`.3502* **``Ultrareview did not start: `--trust-workspace` takes no value``**: PR 번호나 `false`처럼 플래그가 아닌 값이 `--trust-workspace` 뒤에 있습니다. 폴더를 신뢰하지 않는다면 플래그를 빼십시오. 이번 실행에 대해 신뢰하려면 PR 번호나 베이스 브랜치를 플래그 앞에 둡니다: `claude ultrareview 1234 --trust-workspace`.

3496 3503 

3497v2.1.309 이전에는 `claude ultrareview`가 `--trust-workspace`를 받지 않았습니다.3504v2.1.309 이전에는 `claude ultrareview`가 `--trust-workspace`를 받지 않았습니다.

3498 3505 

3557 3564 

3558* 설치 후 아직 세션을 시작하지 않아 Claude Code가 플래그를 가져오지 않았습니다. 기능을 사용할 수 있는 경우에도 첫 번째 `claude import`에서 이 메시지가 출력될 수 있습니다.3565* 설치 후 아직 세션을 시작하지 않아 Claude Code가 플래그를 가져오지 않았습니다. 기능을 사용할 수 있는 경우에도 첫 번째 `claude import`에서 이 메시지가 출력될 수 있습니다.

3559* Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry, Claude Platform on AWS를 통해, 또는 [Claude apps 게이트웨이](https://code.claude.com/docs/ko/claude-apps-gateway#availability-and-limitations)를 통해 Claude Code를 사용합니다. 이러한 세션에서는 Claude Code가 기능 플래그를 가져오지 않으므로 `claude import`를 계속 사용할 수 없습니다.3566* Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry, Claude Platform on AWS를 통해, 또는 [Claude apps 게이트웨이](https://code.claude.com/docs/ko/claude-apps-gateway#availability-and-limitations)를 통해 Claude Code를 사용합니다. 이러한 세션에서는 Claude Code가 기능 플래그를 가져오지 않으므로 `claude import`를 계속 사용할 수 없습니다.

3560* 기능 플래그 가져오기를 끄는 `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `DISABLE_GROWTHBOOK` 또는 [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](https://code.claude.com/docs/ko/env-vars)를 설정했으므로 `claude import`를 계속 사용할 수 없습니다.3567* 기능 플래그 가져오기를 끄는 `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, [`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](https://code.claude.com/docs/ko/env-vars#variables), `DISABLE_GROWTHBOOK` 또는 [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](https://code.claude.com/docs/ko/env-vars)를 설정했으므로 `claude import`를 계속 사용할 수 없습니다.

3561 3568 

3562**해결 방법:**3569**해결 방법:**

3563 3570 

3799 3806 

3800다음 관련 메시지는 명령이 실행되기도 전에 표시됩니다:3807다음 관련 메시지는 명령이 실행되기도 전에 표시됩니다:

3801 3808 

3802* `Shell command permission check failed for pattern "..."`: 명령의 권한 검사가 이를 허용하지 않았습니다. [주입된 명령의 권한 검사](https://code.claude.com/docs/ko/skills.md#permission-checks-on-injected-commands)에서 각 권한 모드에서 어떤 결과가 중단되는지와 `allowed-tools`로 명령을 사전 승인하는 방법을 다룹니다3809* `Shell command permission check failed for pattern "..."`: 명령의 권한 검사에서 허용되지 않았습니다. [주입된 명령에 대한 권한 검사](https://code.claude.com/docs/ko/skills.md#permission-checks-on-injected-commands)에서 각 권한 모드에서 어떤 결과가 중단을 일으키는지와 `allowed-tools`로 명령을 사전 승인하는 방법을 다룹니다

3803* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: 스킬의 frontmatter가 bash가 없는 컴퓨터에서 bash를 요구합니다. Git for Windows를 설치하거나 frontmatter를 `shell: powershell`로 변경합니다. [주입된 명령이 실행되는 방식](https://code.claude.com/docs/ko/skills.md#how-injected-commands-run)을 참조하세요3810* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: 스킬의 frontmatter가 bash가 없는 컴퓨터에서 bash를 요구합니다. Git for Windows를 설치하거나 frontmatter를 `shell: powershell`로 변경합니다. [주입된 명령이 실행되는 방식](https://code.claude.com/docs/ko/skills.md#how-injected-commands-run)을 참조하세요

3804 3811 

3805**해결 방법:**3812**해결 방법:**

3953 3960 

3954* **기본 브랜치를 전달하지 않은 경우**: Claude Code는 저장소의 기본 브랜치와 비교했으며, 위 예시처럼 기본 브랜치를 명시적으로 전달하도록 제안합니다3961* **기본 브랜치를 전달하지 않은 경우**: Claude Code는 저장소의 기본 브랜치와 비교했으며, 위 예시처럼 기본 브랜치를 명시적으로 전달하도록 제안합니다

3955* **클론에 이미 있던 기본 브랜치를 전달한 경우**: 힌트는 ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``입니다3962* **클론에 이미 있던 기본 브랜치를 전달한 경우**: 힌트는 ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``입니다

3956* **클론에 없던 기본 브랜치를 전달한 경우**: Claude Code는 비교하기 전에 origin에서 해당 브랜치를 가져왔습니다. 힌트는 ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``이며, Claude Code가 클론이 shallow인지 판단할 수 없는 경우에는 대신 `git fetch --unshallow origin`을 제안합니다. v2.1.221 이전에는 가져온 모든 기본 브랜치에 대해 힌트가 `git fetch --unshallow origin`을 제안했으며, 완전한 클론에서는 이 명령이 `fatal: --unshallow on a complete repository does not make sense`와 함께 실패합니다.3963* **클론에 없던 기본 브랜치를 전달한 경우**: Claude Code가 비교하기 전에 origin에서 해당 브랜치를 가져왔습니다. 힌트는 ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``입니다. Claude Code가 클론이 얕은 클론인지 판단할 수 없으면 대신 `git fetch --unshallow origin`을 제안합니다. v2.1.221 이전에는 가져온 모든 기본 브랜치에 대해 힌트가 `git fetch --unshallow origin`을 제안했으며, 완전한 클론에서는 이 명령이 `fatal: --unshallow on a complete repository does not make sense`로 실패합니다.

3957 3964 

3958**해결 방법:**3965**해결 방법:**

3959 3966 

6615 6622 

6616**2. 홈 디렉터리를 공유하는 모든 호스트 업데이트**6623**2. 홈 디렉터리를 공유하는 모든 호스트 업데이트**

6617 6624 

6618여러 호스트가 이 홈 디렉터리를 공유하는 경우, 먼저 모든 호스트의 Claude Code를 메시지가 명시한 버전 이상으로 업데이트하세요. 이전 버전은 옮겨 둔 `.config.json`을 다시 기록할 수 있습니다.6625여러 호스트가 이 홈 디렉터리를 공유하는 경우, 먼저 모든 호스트의 Claude Code를 메시지가 명시한 버전 이상으로 업데이트하세요.

6619 6626 

6620**3. Claude Code 중지**6627**3. Claude Code 중지**

6621 6628 

112 <td>✓</td>112 <td>✓</td>

113 <td>✓</td>113 <td>✓</td>

114 <td>✗</td>114 <td>✗</td>

115 <td>✗</td>115 <td>✓ (Claude Code v2.1.300 이상)</td>

116 <td>✗</td>116 <td>✗</td>

117 <td>✗</td>117 <td>✗</td>

118 </tr>118 </tr>

221 221 

222> [!NOTE]222> [!NOTE]

223>223>

224> [LLM 게이트웨이](https://code.claude.com/docs/ko/llm-gateway)를 통해 인증하는 경우 기능 가용성은 게이트웨이가 전달하는 기본 제공자와 일치합니다. 단, Claude Code 자체가 끄는 기능은 제외됩니다. `ANTHROPIC_BASE_URL`이 `api.anthropic.com` 이외의 호스트를 가리킬 때마다 Claude Code는 게이트웨이가 전달하는 것과 관계없이 [Remote Control](https://code.claude.com/docs/ko/remote-control.md#requirements) 및 [서버 관리 설정](https://code.claude.com/docs/ko/server-managed-settings.md#platform-availability)과 같은 기능을 끕니다. [Advisor](https://code.claude.com/docs/ko/advisor.md)와 같은 일부 Anthropic 전용 기능은 게이트웨이가 요청을 Anthropic API로 그대로 전달하는 경우에만 작동합니다.224> [LLM 게이트웨이](https://code.claude.com/docs/ko/llm-gateway)를 통해 인증하는 경우 기능 가용성은 게이트웨이가 전달하는 기본 제공자와 일치합니다. 단, Claude Code 자체가 끄는 기능은 제외됩니다. `ANTHROPIC_BASE_URL`이 `api.anthropic.com` 이외의 호스트를 가리킬 때마다 Claude Code는 게이트웨이가 전달하는 것과 관계없이 [Remote Control](https://code.claude.com/docs/ko/remote-control.md#requirements) 및 [서버 관리 설정](https://code.claude.com/docs/ko/server-managed-settings.md#platform-availability)과 같은 기능을 끕니다. [Advisor](https://code.claude.com/docs/ko/advisor.md#requirements)와 같은 일부 기능은 게이트웨이가 요청을 그대로 전달하는 경우에만 작동합니다.

225>225>

226> \[Claude Code가 보내는 요청이 Amazon Bedrock 또는 Agent Platform 형식 게이트웨이, `ANTHROPIC_BASE_URL` 게이트웨이, Claude apps gateway 로그인 간에 어떻게 다른지에 대해서는 [연결 방법별 클라이언트 동작](https://code.claude.com/docs/ko/llm-gateway-protocol.md#how-the-connection-method-changes-client-behavior)을 참조하십시오.226> \[Claude Code가 보내는 요청이 Amazon Bedrock 또는 Agent Platform 형식 게이트웨이, `ANTHROPIC_BASE_URL` 게이트웨이, Claude apps gateway 로그인 간에 어떻게 다른지에 대해서는 [연결 방법별 클라이언트 동작](https://code.claude.com/docs/ko/llm-gateway-protocol.md#how-the-connection-method-changes-client-behavior)을 참조하십시오.

227 227 

244 244 

245> [tab] AWS의 Claude Platform245> [tab] AWS의 Claude Platform

246>246>

247> **사용 불가능:** 모든 [Claude 구독이 필요한 기능](#features-that-require-a-claude-subscription), 그리고 [빠른 모드](https://code.claude.com/docs/ko/fast-mode.md), [Advisor](https://code.claude.com/docs/ko/advisor.md), [Channels](https://code.claude.com/docs/ko/channels.md), [GitHub Actions](https://code.claude.com/docs/ko/github-actions.md), [분석 대시보드](https://code.claude.com/docs/ko/analytics.md), [서버 관리 설정](https://code.claude.com/docs/ko/server-managed-settings.md), [`/design-sync` 및 `/import` 명령](https://code.claude.com/docs/ko/commands#all-commands).247> **사용 불가능:** 모든 [Claude 구독이 필요한 기능](#features-that-require-a-claude-subscription), 그리고 [빠른 모드](https://code.claude.com/docs/ko/fast-mode.md), [채널](https://code.claude.com/docs/ko/channels.md), [GitHub Actions](https://code.claude.com/docs/ko/github-actions.md), [분석 대시보드](https://code.claude.com/docs/ko/analytics.md), [서버 관리 설정](https://code.claude.com/docs/ko/server-managed-settings.md), [`/design-sync` 및 `/import` 명령](https://code.claude.com/docs/ko/commands#all-commands).

248>248>

249> **Amazon Bedrock에서 사용 불가능한 경우 사용 가능:** [웹 검색](https://code.claude.com/docs/ko/tools-reference.md#websearch-tool-behavior).249> **Amazon Bedrock에서는 사용할 수 없지만 여기서는 사용 가능:** [웹 검색](https://code.claude.com/docs/ko/tools-reference.md#websearch-tool-behavior), 그리고 Claude Code v2.1.300 이상에서 [Advisor](https://code.claude.com/docs/ko/advisor.md).

250>250>

251> **부분 지원:**251> **부분 지원:**

252>252>

54 54 

55### Auto mode55### Auto mode

56 56 

57사용자 대신 별도의 분류기 모델이 작업을 검토하는 [권한 모드](#permission-mode)이므로, Claude Code는 대부분의 작업을 사용자에게 묻지 않고 실행합니다. Claude Code는 여전히 명시적 요청 규칙과 일치하는 작업 전에 사용자에게 묻습니다. 분류기는 범위 확대, 신뢰할 수 없는 인프라 및 [프롬프트 인젝션](#prompt-injection)을 차단합니다. 도구 결과는 분류기가 보는 것에서 제거되므로, 파일이나 웹 페이지의 악의적인 콘텐츠가 분류기를 직접 조작할 수 없습니다.57사용자 대신 별도의 분류기 모델이 작업을 검토하는 [권한 모드](#permission-mode)이므로, Claude Code는 대부분의 작업을 사용자에게 묻지 않고 실행합니다. Claude Code는 여전히 명시적 요청 규칙과 일치하는 작업 전에 사용자에게 묻습니다. 분류기는 범위 확대, 신뢰할 수 없는 인프라 및 [프롬프트 인젝션](#prompt-injection)을 차단합니다.

58 58 

59* **Claude Code v2.1.283 이상**: 자동 모드는 대화형 터미널 및 VS Code 세션의 [기본 제공 시작 권한 모드](https://code.claude.com/docs/ko/permission-modes.md#which-mode-a-session-starts-in)입니다59* **Claude Code v2.1.283 이상**: 자동 모드는 대화형 터미널 및 VS Code 세션의 [기본 제공 시작 권한 모드](https://code.claude.com/docs/ko/permission-modes.md#which-mode-a-session-starts-in)입니다

60* **이전 버전**: 자동 모드는 Pro, Max, Ultra 및 Team 플랜에서만 기본 제공 시작 권한 모드입니다60* **이전 버전**: 자동 모드는 Pro, Max, Ultra 및 Team 플랜에서만 기본 제공 시작 권한 모드입니다

227 227 

228## P228## P

229 229 

230### Permission mode230### 권한 모드

231 231 

232세션의 기본 승인 동작입니다. CLI에서 `Shift+Tab`으로 순환하거나 VS Code, Desktop 및 claude.ai의 모드 선택기를 사용합니다. 사용 가능한 모드는 `default`, `acceptEdits`, `plan`, `auto`, `dontAsk` 및 `bypassPermissions`입니다.232세션의 기본 승인 동작입니다. CLI에서는 `Shift+Tab`으로 전환하고, VS Code, Desktop, claude.ai에서는 모드 선택기를 사용합니다. 사용 가능한 모드는 `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions`입니다.

233 233 

234`default` 모드는 CLI 및 VS Code와 JetBrains 확장에서 Manual로 표시되며, Claude Code는 값에 대한 `manual`의 별칭을 허용합니다.234`default` 모드는 CLI, VS Code 및 JetBrains 확장 프로그램, 데스크톱 앱에서 Manual로 표시되며, Claude Code는 이 값의 별칭으로 `manual`도 허용합니다.

235 235 

236자세히 알아보기: [권한 모드 선택](https://code.claude.com/docs/ko/permission-modes.md)236자세히 알아보기: [권한 모드 선택](https://code.claude.com/docs/ko/permission-modes.md)

237 237 

238### Permission rule238### 권한 규칙

239 239 

240도구 이름 및 인수 패턴을 기반으로 도구 호출을 허용, 질문 또는 거부하는 설정 항목입니다. 규칙은 deny→ask→allow로 평가되며, 첫 번째 일치가 우선합니다. 권한 규칙은 더 광범위한 [권한 모드](#permission-mode) 위에 계층화된 세밀한 제어입니다.240도구 이름과 인수 패턴을 기준으로 도구 호출을 허용하거나, 확인을 요청하거나, 거부하는 설정 항목입니다. 규칙은 deny→ask→allow 순서로 평가되며, 처음 일치하는 규칙이 적용됩니다. 권한 규칙은 보다 넓은 범위의 [권한 모드](#permission-mode) 위에 적용되는 세분화된 제어 수단입니다.

241 241 

242자세히 알아보기: [권한 구성](https://code.claude.com/docs/ko/permissions.md)242자세히 알아보기: [권한 구성](https://code.claude.com/docs/ko/permissions.md)

243 243 

244### Plan mode244### 플랜 모드

245 245 

246Claude가 소스 파일을 편집하지 않고 변경 사항을 연구하고 제안하는 [권한 모드](#permission-mode)입니다. 읽고, 검색하고, 탐색 명령을 실행할 수 있으며, 아무것도 건드리기 전에 승인을 위한 계획을 제시합니다. `/plan`을 입력하거나 `Shift+Tab`을 눌러 plan mode에 들어갑니다.246Claude가 소스 파일을 편집하지 않고 조사하여 변경 사항을 제안하는 [권한 모드](#permission-mode)입니다. 읽기, 검색, 탐색 명령 실행은 가능하며, 무언가를 변경하기 전에 승인을 위한 계획을 제시합니다. `/plan`을 입력하거나 `Shift+Tab`을 눌러 플랜 모드로 진입합니다.

247 247 

248자세히 알아보기: [plan mode로 편집 전에 분석](https://code.claude.com/docs/ko/permission-modes.md#analyze-before-you-edit-with-plan-mode)248자세히 알아보기: [플랜 모드로 편집 전에 분석하기](https://code.claude.com/docs/ko/permission-modes.md#analyze-before-you-edit-with-plan-mode)

249 249 

250### Plugin250### 플러그인

251 251 

252스킬, 훅, 서브에이전트 및 MCP 서버의 번들이며, 단일 설치 가능한 단위로 패키징됩니다. 플러그인 스킬은 `plugin-name:skill-name`으로 네임스페이스되므로 여러 플러그인이 공존합니다. [마켓플레이스](https://code.claude.com/docs/ko/plugins/overview.md)를 통해 팀 전체에 플러그인을 배포합니다.252스킬, 훅, 서브에이전트, MCP 서버를 하나의 설치 가능한 단위로 패키징한 번들입니다. 플러그인 스킬은 `plugin-name:skill-name` 형식의 네임스페이스를 가지므로 여러 플러그인이 공존할 수 있습니다. [마켓플레이스](https://code.claude.com/docs/ko/plugins/overview.md)를 통해 팀 전체에 플러그인을 배포할 수 있습니다.

253 253 

254자세히 알아보기: [플러그인](https://code.claude.com/docs/ko/plugins/overview.md)254자세히 알아보기: [플러그인](https://code.claude.com/docs/ko/plugins/overview.md)

255 255 

256### Project trust256### 프로젝트 신뢰

257 257 

258Claude Code가 구성을 로드하기 전에 디렉토리를 수락하는 대화입니다. 수락은 프로젝트 디렉토리별로 저장되며, 홈 디렉토리는 제외되고, 여기서 신뢰는 현재 세션에만 유지되며 각 실행 시 프롬프트가 다시 나타납니다. 디렉토리를 신뢰할 때까지 Claude Code는 저장소가 제공하는 일부 콘텐츠를 보류합니다. 예를 들어 `.claude/settings.json`의 프로젝트 허용 규칙 및 마켓플레이스입니다. [폴더를 신뢰하기 전에 실행되는 것](https://code.claude.com/docs/ko/permissions.md#what-runs-before-you-trust-a-folder)에서는 `-p` 세션이 대화 없이 실행하는 것을 포함하여 각 종류의 콘텐츠를 나열합니다.258Claude Code가 디렉터리의 구성을 로드하기 전에 해당 디렉터리를 수락하는 대화 상자입니다. 수락 여부는 프로젝트 디렉터리별로 저장되지만, 홈 디렉터리는 예외로 현재 세션 동안에만 신뢰가 유지되며 실행할 때마다 프롬프트가 다시 표시됩니다. 디렉터리를 신뢰하기 전까지 Claude Code는 `.claude/settings.json`의 프로젝트 허용 규칙 및 마켓플레이스 등 저장소가 제공하는 일부 콘텐츠를 보류합니다. [폴더를 신뢰하기 전에 실행되는 항목](https://code.claude.com/docs/ko/permissions.md#what-runs-before-you-trust-a-folder)에는 `-p` 세션이 대화 상자 없이 실행하는 항목을 포함하여 각 콘텐츠 유형이 나열되어 있습니다.

259 259 

260자세히 알아보기: [`.claude` 디렉토리](https://code.claude.com/docs/ko/claude-directory)260자세히 알아보기: [`.claude` 디렉터리](https://code.claude.com/docs/ko/claude-directory)

261 261 

262### Prompt injection262### 프롬프트 인젝션

263 263 

264파일, 웹 페이지 또는 도구 결과에 포함된 적대적 지침이며, Claude를 요청하지 않은 작업으로 리디렉션하려고 시도합니다. Claude Code의 방어에는 권한 시스템, 명령 주입 탐지 및 신뢰 확인이 포함됩니다. [Auto mode](#auto-mode)는 도구 결과에서 의심스러운 내용을 스캔하는 서버 측 프로브와 도구 결과를 제거한 상태에서 작업을 검토하는 분류기를 추가하므로 주입된 텍스트가 직접 이를 조작할 수 없습니다.264파일, 웹 페이지 또는 도구 결과에 포함되어 Claude를 사용자가 요청하지 않은 작업으로 유도하려는 악의적인 지시입니다. Claude Code의 방어 수단에는 권한 시스템, 명령 인젝션 탐지, 신뢰 확인이 포함됩니다. [자동 모드](#auto-mode)에서는 서버 측 프로브가 도구 결과에서 의심스러운 콘텐츠를 검사하고, 분류기가 작업을 검토합니다.

265 265 

266자세히 알아보기: [프롬프트 주입으로부터 보호](https://code.claude.com/docs/ko/security.md#protect-against-prompt-injection)266자세히 알아보기: [프롬프트 인젝션으로부터 보호](https://code.claude.com/docs/ko/security.md#protect-against-prompt-injection)

267 267 

268## R268## R

269 269 

2341 2341 

2342#### 자동 모드 분류기를 위한 결과 주석 달기2342#### 자동 모드 분류기를 위한 결과 주석 달기

2343 2343 

2344`classifierContext`를 반환하면 도구 호출 결과에 대한 짧은 메모를 Claude가 아닌 [자동 모드](https://code.claude.com/docs/ko/permission-modes.md#eliminate-prompts-with-auto-mode) 분류기에 전송할 수 있습니다. 분류기는 [도구 결과 자체를 받지 않으므로](https://code.claude.com/docs/ko/permission-modes.md#how-the-classifier-evaluates-actions), 이 필드는 분류기가 이후 작업을 검토하기 전에 호출이 반환한 내용에 대해 알려 줄 수 있는 공식적인 방법입니다. 이 필드는 Claude Code v2.1.236 이상이 필요합니다.2344`classifierContext`를 반환하면 도구 호출 결과에 관한 짧은 메모를 Claude가 아닌 [자동 모드](https://code.claude.com/docs/ko/permission-modes.md#eliminate-prompts-with-auto-mode) 분류기에 보낼 수 있습니다. 이 메모는 분류기가 이후 작업을 검토할 때 사용됩니다. 이 필드는 Claude Code v2.1.236 이상이 필요합니다.

2345 2345 

2346아래 예시는 쿼리 출력의 출처를 분류기에 알려 줍니다.2346아래 예시는 쿼리 출력의 출처를 분류기에 알려 줍니다.

2347 2347 

47 47 

48[gateway 자격 증명 변수](https://code.claude.com/docs/ko/llm-gateway-connect.md#set-the-credential-variable) 또는 `apiKeyHelper`가 활성화되어 있는 동안 요청은 개발자의 claude.ai 구독 로그인 대신 해당 자격 증명을 전달하며, 구독의 사용량 제한이 적용되지 않습니다. Claude Code는 머신에 저장된 claude.ai 로그인을 유지하지만 해당 요청과 함께 전송하지 않습니다. 해당 트래픽은 gateway가 전달하는 자격 증명의 소유자(예: 조직의 Anthropic Console 계정 또는 gateway가 그곳으로 라우팅할 때 Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry 계정)에게 토큰당 청구됩니다.48[gateway 자격 증명 변수](https://code.claude.com/docs/ko/llm-gateway-connect.md#set-the-credential-variable) 또는 `apiKeyHelper`가 활성화되어 있는 동안 요청은 개발자의 claude.ai 구독 로그인 대신 해당 자격 증명을 전달하며, 구독의 사용량 제한이 적용되지 않습니다. Claude Code는 머신에 저장된 claude.ai 로그인을 유지하지만 해당 요청과 함께 전송하지 않습니다. 해당 트래픽은 gateway가 전달하는 자격 증명의 소유자(예: 조직의 Anthropic Console 계정 또는 gateway가 그곳으로 라우팅할 때 Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry 계정)에게 토큰당 청구됩니다.

49 49 

50[`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/ko/llm-gateway-connect#set-the-base-url-and-credential)은 Claude Code를 gateway로 가리키는 변수입니다. gateway 자격 증명 없이 해당 변수만 설정하면 구독을 대체하지 않습니다. 요청은 여전히 gateway를 통해 라우팅되지만 저장된 claude.ai 로그인이 활성 자격 증명으로 유지되므로 해당 사용량 제한 및 청구가 적용됩니다. 이 트래픽을 Anthropic에 전달하는 gateway는 `anthropic-beta`에서 OAuth 기능을 전달해야 합니다. [요청 헤더 참조](https://code.claude.com/docs/ko/llm-gateway-protocol.md#request-headers)를 참조하세요.50[`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/ko/llm-gateway-connect#set-the-base-url-and-credential)은 Claude Code를 게이트웨이로 가리키는 변수입니다. 게이트웨이 자격 증명 없이 해당 변수만 설정하면 구독을 대체하지 않습니다. 요청은 여전히 게이트웨이를 통해 라우팅되지만 저장된 claude.ai 로그인이 활성 자격 증명으로 유지되므로 해당 사용 한도 및 청구가 적용됩니다. 이 트래픽을 Anthropic에 전달하는 게이트웨이는 `Authorization`과 `anthropic-beta`의 OAuth 기능을 전달해야 합니다. [요청 헤더 참조](https://code.claude.com/docs/ko/llm-gateway-protocol.md#request-headers)를 참조하세요.

51 51 

52## 관련 페이지52## 관련 페이지

53 53 

40 40 

41| 형식 | 선택됨 | 엔드포인트 | 변경 없이 전달 |41| 형식 | 선택됨 | 엔드포인트 | 변경 없이 전달 |

42| :- | :- | :- | :- |42| :- | :- | :- | :- |

43| Anthropic Messages | `ANTHROPIC_BASE_URL` | `/v1/messages`, `/v1/messages/count_tokens` (선택사항) | `anthropic-beta` 및 `anthropic-version` 요청 헤더 |43| Anthropic Messages | `ANTHROPIC_BASE_URL` | `/v1/messages`, `/v1/messages/count_tokens` (선택사항) | `anthropic-beta` 및 `anthropic-version` 요청 헤더, 그리고 [claude.ai 로그인](#request-headers)이 Anthropic에 대한 요청을 인증하는 경우 `Authorization`도 포함 |

44| Amazon Bedrock InvokeModel | `ANTHROPIC_BEDROCK_BASE_URL`과 `CLAUDE_CODE_USE_BEDROCK=1` | `/model/{model}/invoke`, `/model/{model}/invoke-with-response-stream`, `/model/{model}/count-tokens` (선택사항) | `anthropic_beta` 및 `anthropic_version` 요청 본문 필드 |44| Amazon Bedrock InvokeModel | `ANTHROPIC_BEDROCK_BASE_URL`과 `CLAUDE_CODE_USE_BEDROCK=1` | `/model/{model}/invoke`, `/model/{model}/invoke-with-response-stream`, `/model/{model}/count-tokens` (선택사항) | `anthropic_beta` 및 `anthropic_version` 요청 본문 필드 |

45| Google Cloud의 Agent Platform rawPredict | `ANTHROPIC_VERTEX_BASE_URL`과 `CLAUDE_CODE_USE_VERTEX=1` | `:rawPredict`, `:streamRawPredict`, `count-tokens:rawPredict` (선택사항) | `anthropic-beta` 및 `anthropic-version` 요청 헤더, 그리고 `anthropic_version` 요청 본문 필드 |45| Google Cloud의 Agent Platform rawPredict | `ANTHROPIC_VERTEX_BASE_URL`과 `CLAUDE_CODE_USE_VERTEX=1` | `:rawPredict`, `:streamRawPredict`, `count-tokens:rawPredict` (선택사항) | `anthropic-beta` 및 `anthropic-version` 요청 헤더, 그리고 `anthropic_version` 요청 본문 필드 |

46 46 

115 115 

116## 요청 헤더116## 요청 헤더

117 117 

118Claude Code는 API 요청에 이러한 헤더를 포함합니다. 헤더 이름은 전송 중에 대소문자를 구분하지 않습니다. `anthropic-version` 및 `anthropic-beta`를 변경 없이 전달하고, 업스트림이 [AWS의 Claude Platform](https://code.claude.com/docs/ko/claude-platform-on-aws.md)일 때 `anthropic-workspace-id`를 전달합니다. 나머지는 게이트웨이가 라우팅, 속성 및 추적을 위해 사용할 수 있으며 전달할 필요가 없습니다.118Claude Code는 API 요청에 이러한 헤더를 포함합니다. 헤더 이름은 전송 중에 대소문자를 구분하지 않습니다. `anthropic-version` 및 `anthropic-beta`를 변경 없이 전달하고, 업스트림이 [AWS의 Claude Platform](https://code.claude.com/docs/ko/claude-platform-on-aws.md)일 때 `anthropic-workspace-id`를 전달합니다. 또한 게이트웨이가 자체 키가 아닌 개발자의 claude.ai 로그인으로 Anthropic에 인증하는 경우 `Authorization`도 전달합니다. 나머지는 게이트웨이가 라우팅, 속성 및 추적을 위해 사용할 수 있으며 전달할 필요가 없습니다.

119 119 

120| 헤더 | 설명 |120| 헤더 | 설명 |

121| :- | :- |121| :- | :- |

122| `Authorization`, `x-api-key` | 개발자의 게이트웨이 자격 증명. 설정한 [자격 증명 변수](https://code.claude.com/docs/ko/llm-gateway-connect.md#set-the-credential-variable)에 따라 하나 또는 두 헤더 모두에 포함됨 |122| `Authorization`, `x-api-key` | 개발자의 게이트웨이 자격 증명. 설정한 [자격 증명 변수](https://code.claude.com/docs/ko/llm-gateway-connect.md#set-the-credential-variable)에 따라 하나 또는 두 헤더 모두에 포함됨. claude.ai 로그인을 사용하고 게이트웨이 자격 증명이 없는 경우 `Authorization`은 로그인의 토큰을 전달함 |

123| `anthropic-version` | API 버전. 현재 `2023-06-01`. Amazon Bedrock 및 Google Cloud의 Agent Platform 형식 요청은 또한 `anthropic_version` 본문 필드를 전달하며, 그 값은 이 헤더의 값이 아닌 제공자 방언 문자열입니다. |123| `anthropic-version` | API 버전. 현재 `2023-06-01`. Amazon Bedrock 및 Google Cloud의 Agent Platform 형식 요청은 또한 `anthropic_version` 본문 필드를 전달하며, 그 값은 이 헤더의 값이 아닌 제공자 방언 문자열입니다. |

124| `anthropic-beta` | 요청에 대한 쉼표로 구분된 기능 값. 헤더를 그대로 전달합니다. 개별 값을 허용 목록에 추가하지 마십시오. Claude Code 릴리스에 따라 집합이 변경되기 때문입니다. 개발자가 claude.ai 로그인으로 인증할 때 (이는 `ANTHROPIC_BASE_URL`이 게이트웨이 자격 증명 변수 없이 설정될 때 가능함), 이 헤더는 또한 업스트림이 요구하는 OAuth 기능을 전달하며, 이를 제거하면 해당 요청이 `401`로 실패합니다. |124| `anthropic-beta` | 요청에 대한 쉼표로 구분된 기능 값. 헤더를 그대로 전달합니다. 개별 값을 허용 목록에 추가하지 마십시오. Claude Code 릴리스에 따라 집합이 변경되기 때문입니다. 개발자가 claude.ai 로그인으로 인증할 때 (이는 `ANTHROPIC_BASE_URL`이 게이트웨이 자격 증명 변수 없이 설정될 때 가능함), 이 헤더는 또한 업스트림이 요구하는 OAuth 기능을 전달하며, 이를 제거하면 해당 요청이 `401`로 실패합니다. |

125| `x-claude-code-session-id` | 현재 Claude Code 세션의 고유 식별자. 요청 본문을 구문 분석하지 않고 한 세션의 모든 요청을 집계하는 데 사용합니다. |125| `x-claude-code-session-id` | 현재 Claude Code 세션의 고유 식별자. 요청 본문을 구문 분석하지 않고 한 세션의 모든 요청을 집계하는 데 사용합니다. |

52* **전달 제어**: [`policyHelper`](https://code.claude.com/docs/ko/settings-reference#policyhelper), [`wslInheritsWindowsSettings`](https://code.claude.com/docs/ko/settings-reference#wslinheritswindowssettings), 및 [`managedSourcesBehavior`](https://code.claude.com/docs/ko/settings-reference#managedsourcesbehavior)52* **전달 제어**: [`policyHelper`](https://code.claude.com/docs/ko/settings-reference#policyhelper), [`wslInheritsWindowsSettings`](https://code.claude.com/docs/ko/settings-reference#wslinheritswindowssettings), 및 [`managedSourcesBehavior`](https://code.claude.com/docs/ko/settings-reference#managedsourcesbehavior)

53* **게이트웨이 로그인 키**: [`forceLoginGatewayUrl`](https://code.claude.com/docs/ko/settings-reference#forcelogingatewayurl), [`gatewayInternalNetworks`](https://code.claude.com/docs/ko/settings-reference#gatewayinternalnetworks), 및 [`forceLoginMethod`](https://code.claude.com/docs/ko/settings-reference#forceloginmethod)의 `"gateway"` 값53* **게이트웨이 로그인 키**: [`forceLoginGatewayUrl`](https://code.claude.com/docs/ko/settings-reference#forcelogingatewayurl), [`gatewayInternalNetworks`](https://code.claude.com/docs/ko/settings-reference#gatewayinternalnetworks), 및 [`forceLoginMethod`](https://code.claude.com/docs/ko/settings-reference#forceloginmethod)의 `"gateway"` 값

54 54 

55관리되는 설정 파일, MDM 프로필 또는 claude.ai 콘솔은 도달하는 모든 사용자에게 하나의 정책을 적용합니다. 개발자 그룹에 다른 정책을 제공하려면 해당 그룹에 다른 파일 또는 프로필을 배포하면 됩니다. claude.ai 콘솔은 [아직 그룹을 대상으로 할 수 없지만](https://code.claude.com/docs/ko/server-managed-settings.md#current-limitations), 자체 호스팅 [Claude 앱 게이트웨이](https://code.claude.com/docs/ko/claude-apps-gateway)는 IdP 그룹별로 관리되는 설정을 전달합니다.55관리형 설정 파일이나 MDM 프로필을 사용하면 해당 파일이나 프로필이 도달하는 모든 사용자가 하나의 정책을 받습니다. 개발자 그룹에 다른 정책을 제공하려면 해당 그룹에 다른 파일 또는 프로필을 배포하면 됩니다. Enterprise 플랜에서는 서버 관리 설정에서 [각 그룹에 자체 구성을 제공](https://code.claude.com/docs/ko/server-managed-settings.md#give-groups-different-settings)할 수도 있습니다. 자체 호스팅 [Claude 앱 게이트웨이](https://code.claude.com/docs/ko/claude-apps-gateway)는 IdP 그룹별로 관리형 설정을 전달합니다.

56 56 

57둘 이상의 메커니즘이 동일한 머신에 정책을 전달할 때, Claude Code는 기본적으로 하나를 사용하고 나머지는 무시합니다. [Claude Code가 관리되는 소스를 결합하는 방법](#how-claude-code-combines-managed-sources)에서 순서와 모든 소스에 적용되는 옵트인을 설명합니다.57둘 이상의 메커니즘이 동일한 머신에 정책을 전달할 때, Claude Code는 기본적으로 하나를 사용하고 나머지는 무시합니다. [Claude Code가 관리되는 소스를 결합하는 방법](#how-claude-code-combines-managed-sources)에서 순서와 모든 소스에 적용되는 옵트인을 설명합니다.

58 58 

163 163 

164인라인 형식은 Bash 또는 Zsh에서 해당 한 번의 시작을 위해 변수를 설정합니다. 모든 세션에서 계속 설정하려면 [환경 변수 설정](https://code.claude.com/docs/ko/env-vars.md#set-environment-variables)에 표시된 대로 `~/.claude/settings.json`의 `env` 블록에 추가하십시오.164인라인 형식은 Bash 또는 Zsh에서 해당 한 번의 시작을 위해 변수를 설정합니다. 모든 세션에서 계속 설정하려면 [환경 변수 설정](https://code.claude.com/docs/ko/env-vars.md#set-environment-variables)에 표시된 대로 `~/.claude/settings.json`의 `env` 블록에 추가하십시오.

165 165 

166이는 추가 디렉터리에서 `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` 및 `CLAUDE.local.md`를 로드합니다. [`--setting-sources`](https://code.claude.com/docs/ko/cli-reference)에서 `local`을 제외하면 `CLAUDE.local.md`가 건너뛰어집니다.166변수가 설정되면 Claude Code는 추가 디렉터리의 `CLAUDE.md`, `.claude/CLAUDE.md`, `CLAUDE.local.md` 및 `.claude/rules/*.md` 파일을 로드하며, [`paths` 필드](#path-specific-rules)를 설정한 규칙은 제외됩니다. [`--setting-sources`](https://code.claude.com/docs/ko/cli-reference)에서 `local`을 제외하면 `CLAUDE.local.md`가 건너뛰어집니다.

167 167 

168### `.claude/rules/`로 규칙 정리하기168### `.claude/rules/`로 규칙 정리하기

169 169 

168 168 

169[모델은 인식된 모델 ID가 아닙니다](https://code.claude.com/docs/ko/errors.md#model-is-not-a-recognized-model-id) 및 [모델을 찾을 수 없습니다](https://code.claude.com/docs/ko/errors.md#model-not-found)를 참조하여 메시지를 확인합니다.169[모델은 인식된 모델 ID가 아닙니다](https://code.claude.com/docs/ko/errors.md#model-is-not-a-recognized-model-id) 및 [모델을 찾을 수 없습니다](https://code.claude.com/docs/ko/errors.md#model-not-found)를 참조하여 메시지를 확인합니다.

170 170 

171`--model` 플래그, `ANTHROPIC_MODEL` 환경 변수 또는 `model` 설정으로 모델을 설정하면 Claude Code는 잘못 입력된 값을 미리 거부하지 않습니다. 세션이 시작되고 첫 번째 요청에서 [선택된 모델에 문제가 있습니다](https://code.claude.com/docs/ko/errors.md#theres-an-issue-with-the-selected-model)가 발생합니다. Anthropic API에서는 `claude-`로 시작하지 않으면서 모델 이름이나 별칭과 철자가 거의 같은 값이 [올바른 이름을 제안하는 시작 경고](#fix-a-mistyped-model-name)를 표시할 수도 있습니다.171`--model` 플래그, `ANTHROPIC_MODEL` 환경 변수 또는 `model` 설정으로 모델을 설정하면 Claude Code는 잘못 입력된 값을 미리 거부하지 않습니다. 세션이 시작되고 첫 번째 요청에서 [선택된 모델에 문제가 있습니다](https://code.claude.com/docs/ko/errors.md#theres-an-issue-with-the-selected-model)가 발생합니다. Anthropic API에서는 값이 모델 이름이나 별칭과 철자가 거의 같고 `claude-`로 시작하지 않으면 [가장 가까운 이름을 제안하는 경고](#fix-a-mistyped-model-name)가 표시될 수 있습니다.

172 172 

173요청된 모델에 예정된 폐기 날짜가 있거나 자동으로 최신 버전으로 다시 매핑되면 Claude Code는 요청된 모델의 이름을 지정하는 경고를 표시합니다. 대화형 세션은 시작 알림으로 표시합니다. v2.1.182부터 기본 텍스트 출력 형식을 사용할 때 [비대화형 모드](https://code.claude.com/docs/ko/headless.md)에서 동일한 경고가 stderr에 작성됩니다. 확인은 또한 [서브에이전트 frontmatter](https://code.claude.com/docs/ko/sub-agents.md)에 설정된 `model`을 다룹니다. stderr 경고는 `--output-format json` 및 `stream-json`에 대해 억제됩니다. 대신 [결과 메시지](https://code.claude.com/docs/ko/headless.md#get-structured-output)의 `modelUsage` 필드에서 실제 모델을 읽습니다.173요청된 모델에 예정된 폐기 날짜가 있거나 자동으로 최신 버전으로 다시 매핑되면 Claude Code는 요청된 모델의 이름을 지정하는 경고를 표시합니다. 대화형 세션은 시작 알림으로 표시합니다. v2.1.182부터 기본 텍스트 출력 형식을 사용할 때 [비대화형 모드](https://code.claude.com/docs/ko/headless.md)에서 동일한 경고가 stderr에 작성됩니다. 확인은 또한 [서브에이전트 frontmatter](https://code.claude.com/docs/ko/sub-agents.md)에 설정된 `model`을 다룹니다. stderr 경고는 `--output-format json` 및 `stream-json`에 대해 억제됩니다. 대신 [결과 메시지](https://code.claude.com/docs/ko/headless.md#get-structured-output)의 `modelUsage` 필드에서 실제 모델을 읽습니다.

174 174 

195}195}

196```196```

197 197 

198#### 잘못 입력한 모델 이름 수정하기

199 

200다음 경고 중 하나가 표시되면 Claude Code가 설정된 모델 ID를 인식하지 못하며, 해당 ID가 Claude Code가 인식하는 모델 이름이나 별칭과 철자가 거의 같다는 의미입니다:

201 

202```text theme={null}

203⚠ Model "<model>" isn't recognized · did you mean "<suggestion>"?

204Claude Code doesn't recognize the model "<model>". Did you mean "<suggestion>"?

205```

206 

207* **ID를 잘못 입력한 경우**: [모델을 설정한 위치](#setting-your-model)에서 제안된 값으로 변경합니다

208* **의도한 ID인 경우**: 그대로 둡니다. 세션은 작성한 그대로 ID를 전송합니다. Claude Code가 해당 ID에 대해 가정하는 컨텍스트 윈도우가 잘못된 경우 [윈도우를 수정합니다](#correct-the-window-for-a-gateway-or-custom-model-id)

209 

198#### 새 세션의 기본 모델 설정하기210#### 새 세션의 기본 모델 설정하기

199 211 

200`ANTHROPIC_DEFAULT_MODEL=<alias|name>`을 설정하여 세션이 기본적으로 시작되는 모델을 선택합니다. Claude Code v2.1.236 이상이 필요합니다.212`ANTHROPIC_DEFAULT_MODEL=<alias|name>`을 설정하여 세션이 기본적으로 시작되는 모델을 선택합니다. Claude Code v2.1.236 이상이 필요합니다.

772| :- | :- |784| :- | :- |

773| 현재 세션에 대한 토글 | macOS에서 `Option+T` 또는 Windows 및 Linux에서 `Alt+T`를 누릅니다 |785| 현재 세션에 대한 토글 | macOS에서 `Option+T` 또는 Windows 및 Linux에서 `Alt+T`를 누릅니다 |

774| 전역 기본값 설정 | `/config`를 실행하고 사고 모드를 토글합니다. `~/.claude/settings.json`에서 `alwaysThinkingEnabled`로 저장됩니다 |786| 전역 기본값 설정 | `/config`를 실행하고 사고 모드를 토글합니다. `~/.claude/settings.json`에서 `alwaysThinkingEnabled`로 저장됩니다 |

775| 환경 변수를 통해 비활성화 | [`MAX_THINKING_TOKENS=0`](https://code.claude.com/docs/ko/env-vars)을 설정하면 Opus 5.5, Sonnet 5.5, Haiku 5.5 및 Fable 모델을 제외하고 Anthropic API에서 사고가 꺼집니다. [서드파티 제공자](https://code.claude.com/docs/ko/third-party-integrations.md)에서는 Claude Code가 대신 `thinking` 매개변수를 생략하며, 적응형 추론 모델은 여전히 사고할 수 있습니다 |787| 환경 변수를 통해 비활성화 | [`MAX_THINKING_TOKENS=0`](https://code.claude.com/docs/ko/env-vars)을 설정합니다 |

788 

789Claude Code는 기본적으로 사고 출력을 축소합니다. `Ctrl+O`를 눌러 상세 모드를 토글하고 회색 기울임꼴 텍스트로 추론을 봅니다. Anthropic API의 대화형 세션은 기본적으로 편집된 thinking 블록을 수신하므로, 확장할 때 전체 요약을 사용 가능하게 하려면 설정에서 [`showThinkingSummaries: true`](https://code.claude.com/docs/ko/settings-reference#showthinkingsummaries)를 설정하세요. 축소되거나 편집된 경우에도 생성된 모든 사고 토큰에 대해 청구됩니다.

790 

791#### 사고를 끌 수 없는 경우

776 792 

777Opus 5.5, Sonnet 5.5, Haiku 5.5 또는 Fable 모델에서는 사고를 끌 수 없습니다. 세션 토글 및 `/config` 행은 스위치를 제공하는 대신 이 모델들에 대해 `Thinking can't be turned off`를 표시하고, 저장된 `alwaysThinkingEnabled: false` 또는 `MAX_THINKING_TOKENS=0`은 여기에 영향을 주지 않습니다. 이 모델들에서는 모델이 effort 수준에 따라 각 단계에서 얼마나 사고할지 결정합니다. 저장된 설정은 이를 허용하는 모델로 전환할 때 다시 적용됩니다.793Opus 5.5, Sonnet 5.5, Haiku 5.5 또는 Fable 모델에서는 사고를 끌 수 없습니다. 세션 토글 및 `/config` 행은 스위치를 제공하는 대신 이 모델들에 대해 `Thinking can't be turned off`를 표시하고, 저장된 `alwaysThinkingEnabled: false` 또는 `MAX_THINKING_TOKENS=0`은 여기에 영향을 주지 않습니다. 이 모델들에서는 모델이 effort 수준에 따라 각 단계에서 얼마나 사고할지 결정합니다. 저장된 설정은 이를 허용하는 모델로 전환할 때 다시 적용됩니다.

778 794 

779Claude Code는 기본적으로 사고 출력을 축소합니다. `Ctrl+O`를 눌러 상세 모드를 토글하고 회색 기울임꼴 텍스트로 추론을 봅니다. Anthropic API의 대화형 세션은 기본적으로 편집된 thinking 블록을 수신하므로, 확장할 때 전체 요약을 사용 가능하게 하려면 [설정](https://code.claude.com/docs/ko/settings.md)에서 `showThinkingSummaries: true`를 설정하세요. 축소되거나 편집된 경우에도 생성된 모든 사고 토큰에 대해 청구됩니다.795사고를 중지하거나 줄이려면, 사용 중인 제공자에 맞는 단계를 따르세요:

796 

797* **Anthropic API**: `claude-opus-5`, `claude-sonnet-5` 및 `claude-haiku-4-5`와 같은 모델에서는 사고를 끌 수 있습니다. `sonnet`과 같은 [별칭](#model-aliases)은 사고를 끌 수 없는 모델을 선택하므로, ID로 [모델을 설정](#setting-your-model)하세요.

798* **[서드파티 제공자](https://code.claude.com/docs/ko/third-party-integrations.md)**: Amazon Bedrock 및 Microsoft Foundry와 같은 제공자에서는 [적응형 추론](#adaptive-reasoning-and-fixed-thinking-budgets)을 사용하는 모델이 사고가 꺼져 있어도 여전히 사고할 수 있습니다. 사고를 줄이려면 [effort 수준을 낮추세요](#set-the-effort-level).

780 799 

781### 확장 컨텍스트800### 확장 컨텍스트

782 801 

900 919 

901Claude Code가 ID를 인식하거나 지정한 윈도우를 사용하게 되면, 해당 ID로 세션을 시작할 때 더 이상 경고가 표시되지 않습니다.920Claude Code가 ID를 인식하거나 지정한 윈도우를 사용하게 되면, 해당 ID로 세션을 시작할 때 더 이상 경고가 표시되지 않습니다.

902 921 

903#### 잘못 입력한 모델 이름 수정

904 

905다음 경고 중 하나가 표시되면 Claude Code가 설정된 모델 ID를 인식하지 못하며, 해당 ID의 철자가 Claude Code가 인식하는 모델 이름 또는 별칭과 거의 같다는 의미입니다.

906 

907```text theme={null}

908⚠ Model "<model>" isn't recognized · did you mean "<suggestion>"?

909Claude Code doesn't recognize the model "<model>". Did you mean "<suggestion>"?

910```

911 

912* **ID를 잘못 입력한 경우**: [모델을 설정한 위치](#setting-your-model)에서 ID를 제안된 값으로 변경합니다.

913* **의도한 ID인 경우**: 그대로 둡니다. 세션은 작성한 그대로 ID를 전송합니다. Claude Code가 해당 ID에 대해 가정하는 컨텍스트 윈도우가 잘못된 경우 [윈도우를 수정](#correct-the-window-for-a-gateway-or-custom-model-id)하십시오.

914 

915#### `CLAUDE_CODE_MAX_CONTEXT_TOKENS`가 적용되는 ID922#### `CLAUDE_CODE_MAX_CONTEXT_TOKENS`가 적용되는 ID

916 923 

917[LLM 게이트웨이](https://code.claude.com/docs/ko/llm-gateway) 또는 기타 사용자 정의 배포에서 Claude Code는 모델 ID가 모델의 실제 윈도우와 다른 컨텍스트 윈도우를 가정할 수 있습니다(ID가 Claude 모델로 확인되는지 여부와 관계없이). [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](https://code.claude.com/docs/ko/env-vars)를 Claude Code가 대신 가정해야 하는 윈도우로 설정합니다.924[LLM 게이트웨이](https://code.claude.com/docs/ko/llm-gateway) 또는 기타 사용자 정의 배포에서 Claude Code는 모델 ID가 모델의 실제 윈도우와 다른 컨텍스트 윈도우를 가정할 수 있습니다(ID가 Claude 모델로 확인되는지 여부와 관계없이). [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](https://code.claude.com/docs/ko/env-vars)를 Claude Code가 대신 가정해야 하는 윈도우로 설정합니다.

710* `skill.name`: 요청에 대해 활성화된 스킬로, Skill 도구나 `/` 명령으로 설정되거나 생성된 서브에이전트가 상속한 것입니다. 기본 제공, 번들, 사용자 정의, 공식 마켓플레이스 플러그인 스킬 이름은 그대로 표시됩니다. 서드파티 플러그인 스킬 이름은 `"third-party"`로 대체됩니다. 활성화된 스킬이 없으면 없습니다.710* `skill.name`: 요청에 대해 활성화된 스킬로, Skill 도구나 `/` 명령으로 설정되거나 생성된 서브에이전트가 상속한 것입니다. 기본 제공, 번들, 사용자 정의, 공식 마켓플레이스 플러그인 스킬 이름은 그대로 표시됩니다. 서드파티 플러그인 스킬 이름은 `"third-party"`로 대체됩니다. 활성화된 스킬이 없으면 없습니다.

711* `plugin.name`: 활성 스킬이나 서브에이전트가 플러그인에서 제공되는 경우 해당 소유 플러그인입니다. 공식 마켓플레이스 플러그인 이름은 그대로 표시됩니다. 서드파티 플러그인 이름은 `"third-party"`로 대체됩니다. 스킬과 서브에이전트 모두 소유 플러그인이 없으면 없습니다.711* `plugin.name`: 활성 스킬이나 서브에이전트가 플러그인에서 제공되는 경우 해당 소유 플러그인입니다. 공식 마켓플레이스 플러그인 이름은 그대로 표시됩니다. 서드파티 플러그인 이름은 `"third-party"`로 대체됩니다. 스킬과 서브에이전트 모두 소유 플러그인이 없으면 없습니다.

712* `marketplace.name`: 소유 플러그인이 설치된 마켓플레이스입니다. `OTEL_LOG_TOOL_DETAILS=1`이 설정되어 있더라도 공식 마켓플레이스 플러그인에 대해서만 내보내집니다. 그 외에는 없습니다.712* `marketplace.name`: 소유 플러그인이 설치된 마켓플레이스입니다. `OTEL_LOG_TOOL_DETAILS=1`이 설정되어 있더라도 공식 마켓플레이스 플러그인에 대해서만 내보내집니다. 그 외에는 없습니다.

713* `mcp_server.name`: 이 요청이 소비한 도구 결과를 제공한 MCP 서버입니다. 기본 제공, claude.ai 프록시, 공식 레지스트리 서버 이름은 그대로 표시됩니다. 사용자가 구성한 서버 이름은 `"custom"`으로 대체됩니다. 요청이 MCP 도구 결과를 소비하지 않은 경우에는 없습니다. v2.1.222 이전에는 Claude Code가 도구 결과를 소비한 요청뿐 아니라 MCP 도구 호출 이후의 모든 요청에 이 속성을 설정했으므로, 이 속성을 집계하는 대시보드에서는 업그레이드 후 값이 감소한 것으로 나타납니다.713* `mcp_server.name`: 이 요청이 사용한 도구 결과를 제공한 MCP 서버입니다. 기본 제공, claude.ai 프록시 및 공식 레지스트리 서버 이름은 그대로 표시됩니다. 사용자가 구성한 서버 이름은 `"custom"`으로 대체됩니다. 요청이 MCP 도구 결과를 사용하지 않은 경우에는 없습니다. v2.1.222 이전에는 Claude Code가 도구 결과를 사용한 요청뿐 아니라 MCP 도구 호출 이후의 모든 요청에 이 속성을 설정했으므로, 이 속성을 집계하는 대시보드에서는 업그레이드 후 값이 감소한 것으로 나타납니다.

714* `mcp_tool.name`: 이 요청이 소비한 결과를 제공한 MCP 도구로, 수정 및 버전 동작은 `mcp_server.name`과 동일합니다. 요청이 MCP 도구 결과를 소비하지 않은 경우에는 없습니다.714 * v2.1.312부터는 Anthropic 공식 마켓플레이스의 플러그인이 선언한 고정 URL 원격 서버의 이름도 `plugin_<plugin>_<server>` 형식으로 그대로 표시됩니다. 플러그인의 마켓플레이스 사본이 Anthropic의 등록된 소스에서 온 것이 아닌 경우(예: 클라우드 세션에서 시드 디렉터리로부터 마운트된 경우) 해당 이름은 `"custom"`으로 대체됩니다.

715* `mcp_tool.name`: 이 요청이 사용한 결과를 제공한 MCP 도구로, `mcp_server.name`과 동일한 마스킹 및 버전 동작을 따릅니다. 단, `mcp_server.name`이 `plugin_<plugin>_<server>` 이름을 표시할 때는 `"custom"`이 될 수 있습니다. 요청이 MCP 도구 결과를 사용하지 않은 경우에는 없습니다.

715 716 

716#### 토큰 카운터717#### 토큰 카운터

717 718 

998 * 동일한 대화형 CLI 세션에서 이전 권한 프롬프트에서 부여된 세션 나머지 기간 동안의 권한 부여999 * 동일한 대화형 CLI 세션에서 이전 권한 프롬프트에서 부여된 세션 나머지 기간 동안의 권한 부여

999 * 본질적으로 안전한 도구1000 * 본질적으로 안전한 도구

1000 1001 

1001 `source` 값은 이러한 출처 중 어느 것이 일치했는지 나타내지 않습니다. 어떤 출처가 호출을 거부했는지 확인하려면 동일한 `tool_use_id`를 가진 [안전 이벤트](#safety-event)를 찾아 `category` 및 `rule_source` 속성을 읽으세요. 일부 거부된 호출은 [안전 이벤트가 없습니다](#calls-without-a-safety-event).1002 `source` 값은 이러한 소스 중 어느 것이 일치했는지 나타내지 않습니다. `classifier_verdict`가 있는 경우 호출을 결정한 분류기 결과를 제공합니다. 호출을 거부한 권한 규칙이나 설정을 명시하는 `tool_decision` 속성은 없습니다.

1002 1003 

1003 Claude Code는 권한 프롬프트 요청 자체가 실패한 경우에도 `"config"`를 보고합니다. 예를 들어 Agent SDK의 [`canUseTool`](https://code.claude.com/docs/ko/agent-sdk/typescript#canusetool) 콜백이나 [`--permission-prompt-tool`](https://code.claude.com/docs/ko/cli-reference#cli-flags) 도구가 잘못된 결과를 반환하거나, 요청이 대기 중인 동안 입력 스트림이 닫히면 해당 요청이 실패합니다.1004 Claude Code는 권한 프롬프트 요청 자체가 실패한 경우에도 `"config"`를 보고합니다. 예를 들어 Agent SDK의 [`canUseTool`](https://code.claude.com/docs/ko/agent-sdk/typescript#canusetool) 콜백이나 [`--permission-prompt-tool`](https://code.claude.com/docs/ko/cli-reference#cli-flags) 도구가 잘못된 결과를 반환하거나, 요청이 대기 중인 동안 입력 스트림이 닫히면 해당 요청이 실패합니다.

1004 * `"hook"`: `PreToolUse` 또는 `PermissionRequest` 훅이 결정을 반환했습니다.1005 * `"hook"`: `PreToolUse` 또는 `PermissionRequest` 훅이 결정을 반환했습니다.

1046 1047 

1047#### 안전 이벤트1048#### 안전 이벤트

1048 1049 

1049[안전 이벤트가 없는 호출](#calls-without-a-safety-event)을 제외하고, 검사가 도구 호출을 거부하거나 권한 프롬프트를 요구할 때 로그에 기록됩니다. [샌드박스의 네트워크 프록시](https://code.claude.com/docs/ko/sandboxing.md#network-isolation)가 연결이나 요청을 거부할 때, 그리고 훅이 결과를 차단할 때도 로그에 기록됩니다. Claude Code v2.1.307 이상이 필요합니다.1050Claude Code는 `claude_code.safety_event` 전송을 중단했습니다:

1051 

1052* **v2.1.312 이상**: 이 버전은 이벤트를 전송하지 않으며, 이를 켜는 설정도 없습니다

1053* **v2.1.307\~v2.1.311**: 세션은 다음 기능 플래그 새로 고침 시점에 이벤트 전송을 중단합니다. Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry처럼 [기능 플래그를 가져오지](https://code.claude.com/docs/ko/env-vars.md#features-that-need-feature-flag-fetching) 않는 세션은 계속 전송할 수 있습니다.

1054 

1055거부된 도구 호출을 확인하려면 [`tool_decision`](#tool-decision-event) 이벤트를 쿼리하세요. 이 이벤트는 호출이 거부되었음을 보여 주지만 어떤 검사가 거부했는지를 항상 보여 주지는 않습니다.

1056 

1057여기의 이벤트 세부 정보는 v2.1.307\~v2.1.311의 이벤트를 설명하며, 이 버전에서 안전 이벤트는 다음과 같은 [사례](#safety-event-categories)를 기록합니다:

1058 

1059* 검사가 도구 호출을 거부하거나 권한 프롬프트를 요구하는 경우([안전 이벤트가 없는 호출](#calls-without-a-safety-event) 제외)

1060* [샌드박스의 네트워크 프록시](https://code.claude.com/docs/ko/sandboxing.md#network-isolation)가 연결 또는 요청을 거부하는 경우

1061* 훅이 결과 또는 턴 종료를 차단하는 경우

1050 1062 

1051이 이벤트는 다른 이벤트와 함께 내보내지며 별도의 설정이 없습니다. 이벤트 자체의 속성에는 명령 텍스트, 파일 경로, 호스트 이름, MCP 서버 및 도구 이름이 포함되지 않습니다. 레코드에는 모든 이벤트에 포함되는 [표준 속성](#standard-attributes)도 포함되며, 여기에는 `workspace.host_paths`와 [저장소 속성](#repository-attributes)이 포함될 수 있습니다. 이벤트 배후의 명령이나 MCP 도구를 확인하려면 `OTEL_LOG_TOOL_DETAILS=1`을 설정하고 일치하는 `tool_decision` 이벤트의 `tool_parameters`를 읽으세요.1063이 이벤트는 다른 이벤트와 함께 내보내지며 별도의 설정이 없습니다. 이벤트 자체의 속성에는 명령 텍스트, 파일 경로, 호스트 이름, MCP 서버 및 도구 이름이 포함되지 않습니다. 레코드에는 모든 이벤트에 포함되는 [표준 속성](#standard-attributes)도 포함되며, 여기에는 `workspace.host_paths`와 [저장소 속성](#repository-attributes)이 포함될 수 있습니다. 이벤트 배후의 명령이나 MCP 도구를 확인하려면 `OTEL_LOG_TOOL_DETAILS=1`을 설정하고 일치하는 `tool_decision` 이벤트의 `tool_parameters`를 읽으세요.

1052 1064 

1663 1675 

1664### 보안 질문을 이벤트에 매핑1676### 보안 질문을 이벤트에 매핑

1665 1677 

1678`safety_event` 행은 [이벤트를 여전히 전송하는](#safety-event) v2.1.307부터 v2.1.311까지의 세션에만 적용됩니다.

1679 

1666감지 규칙을 구축할 때 모니터링하려는 신호를 찾고 해당 이벤트 및 속성에 대해 백엔드를 쿼리합니다:1680감지 규칙을 구축할 때 모니터링하려는 신호를 찾고 해당 이벤트 및 속성에 대해 백엔드를 쿼리합니다:

1667 1681 

1668| 신호 | 이벤트 | 주요 속성 |1682| 신호 | 이벤트 | 주요 속성 |

1672| 자동 모드 분류기가 도구 호출을 허용 또는 차단했거나, Claude Code가 분류기 판정 없이 호출을 거부함 | `classifier_verdict`가 있는 [`tool_decision`](#tool-decision-event). 판정 없는 거부의 경우 `classifier_verdict`는 `"no_verdict"` 또는 `"unavailable"`입니다 | `classifier_verdict`, `permission_mode`, `tool_name`; `OTEL_LOG_TOOL_DETAILS=1`을 설정한 경우 `classifier_category` |1686| 자동 모드 분류기가 도구 호출을 허용 또는 차단했거나, Claude Code가 분류기 판정 없이 호출을 거부함 | `classifier_verdict`가 있는 [`tool_decision`](#tool-decision-event). 판정 없는 거부의 경우 `classifier_verdict`는 `"no_verdict"` 또는 `"unavailable"`입니다 | `classifier_verdict`, `permission_mode`, `tool_name`; `OTEL_LOG_TOOL_DETAILS=1`을 설정한 경우 `classifier_category` |

1673| 권한 모드 에스컬레이션 | `permission_mode_changed` | `from_mode`, `to_mode`, `trigger` |1687| 권한 모드 에스컬레이션 | `permission_mode_changed` | `from_mode`, `to_mode`, `trigger` |

1674| 서브에이전트가 수행하는 호출을 포함하여 각 도구 호출이 어떤 권한 모드에서 확인되었는지 | [`tool_decision`](#tool-decision-event) | `permission_mode`, `session.id` |1688| 서브에이전트가 수행하는 호출을 포함하여 각 도구 호출이 어떤 권한 모드에서 확인되었는지 | [`tool_decision`](#tool-decision-event) | `permission_mode`, `session.id` |

1675| 정책 훅이 작업을 차단함 | `hook_execution_complete` | `hook_event`, `num_blocking` |1689| 정책 훅이 작업을 차단함 | `hook_execution_complete` (호출이나 `tool_use_id`에 연결되지 않음) | `hook_event`, `num_blocking` |

1676| 훅이 어떤 도구 호출을 거부했는지, 그리고 훅이 어떤 결과 또는 턴 종료를 차단했는지 | 거부된 호출의 경우 `category`가 `"hook"`이고 `decision`이 `"reject"`인 [`safety_event`](#safety-event), 차단된 결과 또는 턴 종료의 경우 `category`가 `"hook_review"`인 이벤트 | `category`, `decision`, `hook_event`; 도구 호출의 경우 `tool_use_id` |1690| 훅이 거부한 도구 호출 | `decision`이 `"reject"`이고 `source`가 `"hook"`인 [`tool_decision`](#tool-decision-event) | `decision`, `source`, `tool_use_id` |

1691| 훅이 차단한 결과 또는 턴 종료 | `category`가 `"hook_review"`인 [`safety_event`](#safety-event) | `category`, `hook_event`; 도구 호출의 경우 `tool_use_id` |

1677| 샌드박스의 네트워크 프록시가 Bash 또는 PowerShell 명령의 연결 또는 요청을 거부함 | `sandbox_violation_count`가 있고 `"0"`이 아닌 [`safety_event`](#safety-event) | `sandbox_violation_count`, `category`, `sandbox_enabled`, `tool_use_id` |1692| 샌드박스의 네트워크 프록시가 Bash 또는 PowerShell 명령의 연결 또는 요청을 거부함 | `sandbox_violation_count`가 있고 `"0"`이 아닌 [`safety_event`](#safety-event) | `sandbox_violation_count`, `category`, `sandbox_enabled`, `tool_use_id` |

1678| 로그인, 로그아웃 및 인증 실패 | `auth` | `action`, `success`, `error_category` |1693| 로그인, 로그아웃 및 인증 실패 | `auth` | `action`, `success`, `error_category` |

1679| MCP 서버 연결 또는 실패 | `mcp_server_connection` | `status`, `server_name`, `is_plugin`, `error_code` |1694| MCP 서버 연결 또는 실패 | `mcp_server_connection` | `status`, `server_name`, `is_plugin`, `error_code` |

25 25 

26모든 작업을 검토하는 모드는 CLI에서 **Manual**이라고 명명되며, `claude --help`에서, VS Code 및 JetBrains 확장 프로그램에서, 그리고 데스크톱 앱에서도 **Manual**이라고 명명됩니다. 구성 값은 `default`이며, 이는 훅 및 SDK 통합이 사용하는 값입니다. CLI는 값을 입력하는 모든 곳에서 `manual`을 별칭으로 허용합니다. 예를 들어 `claude --permission-mode manual` 또는 `"defaultMode": "manual"`입니다.26모든 작업을 검토하는 모드는 CLI에서 **Manual**이라고 명명되며, `claude --help`에서, VS Code 및 JetBrains 확장 프로그램에서, 그리고 데스크톱 앱에서도 **Manual**이라고 명명됩니다. 구성 값은 `default`이며, 이는 훅 및 SDK 통합이 사용하는 값입니다. CLI는 값을 입력하는 모든 곳에서 `manual`을 별칭으로 허용합니다. 예를 들어 `claude --permission-mode manual` 또는 `"defaultMode": "manual"`입니다.

27 27 

28[보호된 경로](#protected-paths)에 대한 쓰기는 `bypassPermissions` 모드에서와 bypass 권한을 사용할 수 있는 plan-mode 세션에서를 제외하고는 자동 승인되지 않습니다. 이는 [모드 사이클에 `bypassPermissions`를 배치하는 방식으로 시작된](#switch-permission-modes) 대화형 터미널 세션을 의미합니다.28각 모드에는 [보호된 경로](#protected-paths)에 대한 쓰기와 관련된 자체 규칙이 있습니다.

29 29 

30모드는 기준선을 설정합니다. 특정 도구를 사전 승인하거나 차단하기 위해 [권한 규칙](https://code.claude.com/docs/ko/permissions.md#manage-permissions)을 위에 계층화합니다. 거부 규칙은 `bypassPermissions`를 포함한 모든 모드에서 차단합니다. 거부 및 요청 규칙은 Claude가 호출할 수 있는 다른 도구가 최소 하나 이상 있는 한 [`EndConversation`](https://code.claude.com/docs/ko/tools-reference#endconversation-tool-behavior)에 적용되지 않습니다. 허용 규칙은 `bypassPermissions`에서 효과가 없습니다.30모드는 기준선을 설정합니다. 특정 도구를 사전 승인하거나 차단하기 위해 [권한 규칙](https://code.claude.com/docs/ko/permissions.md#manage-permissions)을 위에 계층화합니다. 거부 규칙은 `bypassPermissions`를 포함한 모든 모드에서 차단합니다. 거부 및 요청 규칙은 Claude가 호출할 수 있는 다른 도구가 최소 하나 이상 있는 한 [`EndConversation`](https://code.claude.com/docs/ko/tools-reference#endconversation-tool-behavior)에 적용되지 않습니다. 허용 규칙은 `bypassPermissions`에서 효과가 없습니다.

31 31 

484* 사용자가 해당 외부 대상을 지정하지 않은 경우, 다른 저장소나 조직을 대상으로 풀 리퀘스트 열기, `gh repo fork`로 포크, 또는 타사 저장소에 푸시484* 사용자가 해당 외부 대상을 지정하지 않은 경우, 다른 저장소나 조직을 대상으로 풀 리퀘스트 열기, `gh repo fork`로 포크, 또는 타사 저장소에 푸시

485* 사용자가 출처와 대상을 모두 지정하지 않은 경우, 민감한 로컬 저장소의 콘텐츠나 이름, 경로 또는 유형으로 민감함이 드러나는 파일의 콘텐츠가 커밋, 푸시, PR 또는 이슈 텍스트, gist 또는 paste, 패키지 게시에 포함되는 것. 세션 트랜스크립트와 대화 로그, SSH 키, 클라우드 자격 증명, 브라우저 프로필, 셸 기록 같은 자격 증명 및 구성 dot 폴더, 사용자 데이터 내보내기가 모두 해당되며, 저장소가 비공개라고 해서 해제되지 않습니다485* 사용자가 출처와 대상을 모두 지정하지 않은 경우, 민감한 로컬 저장소의 콘텐츠나 이름, 경로 또는 유형으로 민감함이 드러나는 파일의 콘텐츠가 커밋, 푸시, PR 또는 이슈 텍스트, gist 또는 paste, 패키지 게시에 포함되는 것. 세션 트랜스크립트와 대화 로그, SSH 키, 클라우드 자격 증명, 브라우저 프로필, 셸 기록 같은 자격 증명 및 구성 dot 폴더, 사용자 데이터 내보내기가 모두 해당되며, 저장소가 비공개라고 해서 해제되지 않습니다

486* 직접 또는 셸 명령을 통해 Claude Code 세션 트랜스크립트, 즉 `~/.claude/projects/` 또는 구성된 config 디렉터리 아래의 `.jsonl` 기록 파일에 쓰기. 이 규칙은 Claude Code가 자체 검사를 위해 각 트랜스크립트 항목에 추가하는 메타데이터 줄도 포함합니다. 트랜스크립트 읽기는 차단되지 않습니다486* 직접 또는 셸 명령을 통해 Claude Code 세션 트랜스크립트, 즉 `~/.claude/projects/` 또는 구성된 config 디렉터리 아래의 `.jsonl` 기록 파일에 쓰기. 이 규칙은 Claude Code가 자체 검사를 위해 각 트랜스크립트 항목에 추가하는 메타데이터 줄도 포함합니다. 트랜스크립트 읽기는 차단되지 않습니다

487* 대상이 분류기가 보는 대화 어디에서도 할당되지 않은 셸 변수이거나 그러한 변수를 기준으로 하는 glob인 `rm -rf "$VAR"` 또는 `Remove-Item -Recurse -Force $dir` 같은 재귀적 강제 삭제. 값이 분류기가 전혀 받지 않는 이전 명령 출력에서만 나왔으므로, 분류기는 삭제 대상을 다른 삭제 규칙에 비추어 확인할 수 없습니다. 삭제되는 정확한 경로를 사용자가 지정하거나, Claude가 확인된 리터럴 경로를 명령에 직접 작성하여 삭제를 다시 실행하면 차단이 해제됩니다. 분류기가 대상을 확인할 수 있는 삭제는 영향을 받지 않습니다.487* 대상이 분류기가 보는 대화에서 할당되지 않은 셸 변수이거나 그러한 변수를 기준으로 하는 glob인 `rm -rf "$VAR"` 또는 `Remove-Item -Recurse -Force $dir` 같은 재귀적 강제 삭제. 그러한 할당이 없으면 분류기는 명령이 무엇을 삭제할지 알 수 없습니다.

488 488 

489 `rm -rf "$VAR"/*`처럼 변수 바로 아래의 glob은 대신 [핵심 경로](#critical-paths)에 해당합니다. 단독 `*`이거나 `/*` 또는 `\*`로 끝나는 `Remove-Item` 대상은 분류기에 도달하지 않으며, Claude Code가 [즉시 거부](#remove-item-in-powershell)합니다.489 삭제되는 정확한 경로를 사용자가 지정하거나, Claude가 확인된 리터럴 경로를 명령에 직접 작성하여 삭제를 다시 실행하면 차단이 해제됩니다. 분류기가 대상을 확인할 수 있는 삭제는 영향을 받지 않습니다.

490 

491 `rm -rf "$VAR"/*`처럼 변수 바로 아래의 glob은 대신 [핵심 경로](#critical-paths)에 해당합니다. 단독 `*`이거나 `/*` 또는 `\*`로 끝나는 `Remove-Item` 대상에 대해서는 [PowerShell의 Remove-Item](#remove-item-in-powershell)을 참조하십시오. Claude Code는 해당 명령을 즉시 거부합니다.

490 492 

491이 범주 중 일부는 민감한 원격 대상이나 보호된 IaC 범위처럼 구체적인 이름으로 좁힐 수 있는 [환경](https://code.claude.com/docs/ko/auto-mode-config.md#define-trusted-infrastructure) 항목에 따라 달라집니다.493이 범주 중 일부는 민감한 원격 대상이나 보호된 IaC 범위처럼 구체적인 이름으로 좁힐 수 있는 [환경](https://code.claude.com/docs/ko/auto-mode-config.md#define-trusted-infrastructure) 항목에 따라 달라집니다.

492 494 

730 732 

731## 보호된 경로733## 보호된 경로

732 734 

733`bypassPermissions` 모드와 [bypass permissions를 사용할 수 있는](#skip-all-checks-with-bypasspermissions-mode) plan 모드의 대화형 터미널 세션을 제외하고는 특정 경로에 대한 쓰기는 자동으로 승인되지 않습니다. 이는 저장소 상태와 Claude의 자체 설정이 실수로 손상되는 것을 방지합니다.735소수의 경로에는 저장소 상태와 Claude의 자체 구성이 저장되어 있으므로, 각 모드에는 이러한 경로에 대한 쓰기에 관한 고유한 규칙이 있습니다:

734 736 

735| 모드 | 보호된 경로 쓰기 |737| 모드 | 보호된 경로 쓰기 |

736| :- | :- |738| :- | :- |

737| `default`, `acceptEdits` | 프롬프트됨 |739| `default`, `acceptEdits` | 프롬프트됨 |

738| `plan` | [bypass permissions를 사용할 수 있는](#skip-all-checks-with-bypasspermissions-mode) 대화형 터미널 세션에서 허용됨. 그렇지 않으면 계획 중에 [auto mode](#eliminate-prompts-with-auto-mode)를 사용할 수 있을 때 분류기로 라우팅되고, 그렇지 않으면 프롬프트됨 |740| `plan` | [bypass permissions를 사용할 수 있는](#skip-all-checks-with-bypasspermissions-mode) 대화형 터미널 세션에서 허용됨. 그렇지 않으면 계획 중에 [auto mode](#eliminate-prompts-with-auto-mode)를 사용할 수 있을 때 분류기로 라우팅되고, 그렇지 않으면 프롬프트됨 |

739| `auto` | 분류기로 라우팅됨 |741| `auto` | 분류기로 라우팅되며, 분류기가 결정함 |

740| `dontAsk` | 거부됨 |742| `dontAsk` | 거부됨 |

741| `bypassPermissions` | 허용됨 |743| `bypassPermissions` | 허용됨 |

742 744 

185| `disableSideloadFlags` | `--plugin-dir`, `--plugin-url`, `--agents`, Agent SDK `plugins` 옵션 및 [`CLAUDE_CODE_PLUGIN_DIRS`](https://code.claude.com/docs/ko/env-vars#variables) 변수에 지정된 폴더를 시작 시 거부하며, `--mcp-config`도 그 안의 모든 서버가 프로세스 내 `type: "sdk"` 항목이 아닌 한 거부합니다. Agent SDK 애플리케이션이 세션 도중 [`addPlugins`](https://code.claude.com/docs/ko/agent-sdk/typescript#load-more-plugin-folders-with-addplugins)로 추가하는 플러그인 폴더를 거부합니다 | `.mcp.json`, `claude mcp add` 또는 SDK 제공 서버를 제한하지 않습니다. [`allowedMcpServers`](https://code.claude.com/docs/ko/managed-mcp)와 쌍을 이루세요 |185| `disableSideloadFlags` | `--plugin-dir`, `--plugin-url`, `--agents`, Agent SDK `plugins` 옵션 및 [`CLAUDE_CODE_PLUGIN_DIRS`](https://code.claude.com/docs/ko/env-vars#variables) 변수에 지정된 폴더를 시작 시 거부하며, `--mcp-config`도 그 안의 모든 서버가 프로세스 내 `type: "sdk"` 항목이 아닌 한 거부합니다. Agent SDK 애플리케이션이 세션 도중 [`addPlugins`](https://code.claude.com/docs/ko/agent-sdk/typescript#load-more-plugin-folders-with-addplugins)로 추가하는 플러그인 폴더를 거부합니다 | `.mcp.json`, `claude mcp add` 또는 SDK 제공 서버를 제한하지 않습니다. [`allowedMcpServers`](https://code.claude.com/docs/ko/managed-mcp)와 쌍을 이루세요 |

186| `disableCommandPluginSources` | `command` 소스가 있는 플러그인이 설치, 업데이트 또는 로드되는 것을 차단합니다. `command` 소스는 플러그인 디렉토리가 머신에서 명령을 실행하여 생성되는 것입니다. 설정되지 않으면 `allowManagedHooksOnly`의 값을 사용합니다 | 다른 소스 유형에 영향을 주지 않습니다 |186| `disableCommandPluginSources` | `command` 소스가 있는 플러그인이 설치, 업데이트 또는 로드되는 것을 차단합니다. `command` 소스는 플러그인 디렉토리가 머신에서 명령을 실행하여 생성되는 것입니다. 설정되지 않으면 `allowManagedHooksOnly`의 값을 사용합니다 | 다른 소스 유형에 영향을 주지 않습니다 |

187| `allowManagedHooksOnly` | 실행할 수 있는 훅을 제한합니다. [`allowManagedHooksOnly`](https://code.claude.com/docs/ko/settings-reference#allowmanagedhooksonly)를 참조하세요 | 사용자가 자신이 활성화한 플러그인의 훅을 신뢰하지 않습니다 |187| `allowManagedHooksOnly` | 실행할 수 있는 훅을 제한합니다. [`allowManagedHooksOnly`](https://code.claude.com/docs/ko/settings-reference#allowmanagedhooksonly)를 참조하세요 | 사용자가 자신이 활성화한 플러그인의 훅을 신뢰하지 않습니다 |

188| `strictPluginOnlyCustomization` | 플러그인, 관리형 설정 또는 Claude Code의 기본 제공에서 오지 않는 스킬, 에이전트, 훅 및 MCP 서버를 차단합니다. 또한 [스킬 디렉토리 플러그인](#keep-skills-directory-plugins-loading)이 로드되지 않도록 합니다. 모든 네 가지 유형을 다루려면 `true`로 설정하거나 일부를 다루려면 `skills`, `agents`, `hooks` 및 `mcp` 값의 배열(예: `["skills", "hooks"]`)로 설정하세요 | 사용자가 설치하는 플러그인을 제한하지 않습니다. `strictKnownMarketplaces`와 쌍을 이루세요 |188| `strictPluginOnlyCustomization` | 사용자 및 프로젝트 소스의 스킬, 에이전트, 훅 및 MCP 서버를 차단합니다. 또한 [스킬 디렉토리 플러그인](#keep-skills-directory-plugins-loading)이 로드되지 않도록 합니다. 모든 네 가지 유형을 다루려면 `true`로 설정하거나 일부를 다루려면 `skills`, `agents`, `hooks` 및 `mcp` 값의 배열(예: `["skills", "hooks"]`)로 설정하세요 | 사용자가 설치하는 플러그인을 제한하거나, 플러그인, 에이전트 및 MCP 서버를 사이드로드하는 CLI 플래그를 거부하지 않습니다. `strictKnownMarketplaces` 및 `disableSideloadFlags`와 쌍을 이루세요 |

189| `pluginSuggestionMarketplaces` | 플러그인이 터미널에서 설치 제안으로 나타날 수 있는 마켓플레이스. [플러그인 권장](#recommend-plugins)을 참조하세요 | 기본 제공 팁에 영향을 주지 않습니다 |189| `pluginSuggestionMarketplaces` | 플러그인이 터미널에서 설치 제안으로 나타날 수 있는 마켓플레이스. [플러그인 권장](#recommend-plugins)을 참조하세요 | 기본 제공 팁에 영향을 주지 않습니다 |

190| `pluginTrustMessage` | 플러그인이 설치되기 전에 `/plugin`이 표시하는 신뢰 경고에 텍스트를 추가합니다 | 경고 자신의 텍스트를 변경하지 않습니다 |190| `pluginTrustMessage` | 플러그인이 설치되기 전에 `/plugin`이 표시하는 신뢰 경고에 텍스트를 추가합니다 | 경고 자신의 텍스트를 변경하지 않습니다 |

191| `allowedChannelPlugins` | 채널 메시지를 푸시할 수 있는 플러그인의 기본 목록을 대체합니다. `channelsEnabled: true` 필요 | [채널 플러그인이 실행할 수 있는 것 제한](https://code.claude.com/docs/ko/channels.md#restrict-which-channel-plugins-can-run)을 참조하세요 |191| `allowedChannelPlugins` | 채널 메시지를 푸시할 수 있는 플러그인의 기본 목록을 대체합니다. `channelsEnabled: true` 필요 | [채널 플러그인이 실행할 수 있는 것 제한](https://code.claude.com/docs/ko/channels.md#restrict-which-channel-plugins-can-run)을 참조하세요 |

336 336 

337### 사용자 그룹에 릴리스 채널 할당337### 사용자 그룹에 릴리스 채널 할당

338 338 

339안정적 및 조기 액세스 채널을 실행하려면 같은 플러그인의 다른 ref를 가리키는 두 개의 마켓플레이스를 호스팅하세요. 그 다음 각 사용자 그룹에 별도의 엔드포인트 관리 설정 또는 게이트웨이 정책을 통해 자신의 마켓플레이스를 제공하세요. 관리자 콘솔의 서버 관리 설정은 [조직의 모든 사용자에게 적용되므로](https://code.claude.com/docs/ko/server-managed-settings.md#current-limitations) 다른 그룹에 다른 설정을 할당할 수 없습니다.339안정적 및 조기 액세스 채널을 실행하려면 같은 플러그인의 다른 ref를 가리키는 두 개의 마켓플레이스를 호스팅하세요. 그 다음 각 사용자 그룹에 별도의 엔드포인트 관리형 설정 또는 게이트웨이 정책을 통해 자신의 마켓플레이스를 제공하세요. Enterprise 플랜에서는 관리자 콘솔의 서버 관리형 설정도 사용할 수 있습니다.

340 340 

341* 각 그룹의 장치에 별도의 [엔드포인트 관리 설정](https://code.claude.com/docs/ko/managed-settings.md#delivery-mechanisms)(예: 관리되는 설정 파일 또는 MDM 프로필)을 배포하세요. 조직 전체 소스도 있는 장치에 그룹별 파일 또는 프로필이 적용되는지 확인하려면 [Claude Code가 관리되는 소스를 결합하는 방법](https://code.claude.com/docs/ko/managed-settings.md#precedence-within-the-managed-tier)을 참조하세요.341* 각 그룹의 장치에 별도의 [엔드포인트 관리 설정](https://code.claude.com/docs/ko/managed-settings.md#delivery-mechanisms)(예: 관리되는 설정 파일 또는 MDM 프로필)을 배포하세요. 조직 전체 소스도 있는 장치에 그룹별 파일 또는 프로필이 적용되는지 확인하려면 [Claude Code가 관리되는 소스를 결합하는 방법](https://code.claude.com/docs/ko/managed-settings.md#precedence-within-the-managed-tier)을 참조하세요.

342* 각 그룹에 대해 하나의 [Claude 앱 게이트웨이 정책](https://code.claude.com/docs/ko/claude-apps-gateway-config.md#managed)을 정의하세요. 기본적으로 게이트웨이는 일치 규칙이 사용자에게 맞는 첫 번째 정책을 적용하므로 각 사용자가 자신의 그룹의 정책에 도달하도록 정책을 정렬하세요. 해당 정책의 `extraKnownMarketplaces` 맵은 다른 정책의 것과 병합되지 않으므로 채널 마켓플레이스만이 아닌 그룹이 필요한 모든 마켓플레이스를 나열하세요.342* 각 그룹에 대해 하나의 [Claude 앱 게이트웨이 정책](https://code.claude.com/docs/ko/claude-apps-gateway-config.md#managed)을 정의하세요. 기본적으로 게이트웨이는 일치 규칙이 사용자에게 맞는 첫 번째 정책을 적용하므로 각 사용자가 자신의 그룹의 정책에 도달하도록 정책을 정렬하세요. 해당 정책의 `extraKnownMarketplaces` 맵은 다른 정책의 것과 병합되지 않으므로 채널 마켓플레이스만이 아닌 그룹이 필요한 모든 마켓플레이스를 나열하세요.

343* Enterprise 플랜에서는 관리자 콘솔에서 [각 그룹에 자체 구성을 부여](https://code.claude.com/docs/ko/server-managed-settings.md#give-groups-different-settings)하세요. 그룹의 구성은 조직 전체 구성과 병합되지 않으므로 각 마켓플레이스를 포함하여 그룹에 필요한 모든 설정을 그룹 자체 구성에 넣으세요.

343 344 

344어느 메커니즘이든 안정적 그룹은 이 구성을 받습니다:345어느 메커니즘이든 안정적 그룹은 이 설정을 받습니다:

345 346 

346```json theme={null}347```json theme={null}

347{348{

383 384 

384보안 검토의 이 요청은 현재 설정 스키마에 전용 키가 없습니다. 가장 가까운 기존 제어는:385보안 검토의 이 요청은 현재 설정 스키마에 전용 키가 없습니다. 가장 가까운 기존 제어는:

385 386 

386* **사용자별 또는 그룹별 타겟팅**: 모든 플러그인 키는 설정을 받는 모든 사용자에게 적용됩니다. 서버 관리 설정은 조직별로 하나의 구성을 제공합니다. 그룹별 정책의 경우 [사용자 그룹에 릴리스 채널 할당](#assign-release-channels-to-user-groups) 아래처럼 별도의 엔드포인트 관리 설정 또는 게이트웨이 정책을 사용하세요.387* **사용자별 또는 그룹별 타겟팅**: 모든 플러그인 키는 설정을 받는 모든 사용자에게 적용됩니다. 그룹별 정책의 경우 [사용자 그룹에 릴리스 채널 할당](#assign-release-channels-to-user-groups)에서와 같이 각 그룹에 고유한 설정을 제공하세요.

387* **허용된 마켓플레이스 내의 항목 제한**: 허용 목록은 마켓플레이스 소스와 일치합니다. 허용된 마켓플레이스에서 하나의 플러그인을 차단하려면 관리되는 `enabledPlugins`에서 `false`로 설정하세요.388* **허용된 마켓플레이스 내의 항목 제한**: 허용 목록은 마켓플레이스 소스와 일치합니다. 허용된 마켓플레이스에서 하나의 플러그인을 차단하려면 관리되는 `enabledPlugins`에서 `false`로 설정하세요.

388* **`/plugin` 숨기기**: 명령을 비활성화하는 키가 없습니다. 가장 가까운 동등은 자신의 마켓플레이스만 지정하는 허용 목록, 제공하는 플러그인에 대한 관리되는 `enabledPlugins` 항목 및 `disableSideloadFlags`를 결합합니다.389* **`/plugin` 숨기기**: 명령을 비활성화하는 키가 없습니다. 가장 가까운 동등은 자신의 마켓플레이스만 지정하는 허용 목록, 제공하는 플러그인에 대한 관리되는 `enabledPlugins` 항목 및 `disableSideloadFlags`를 결합합니다.

389* **허용 목록을 통해 `--plugin-dir` 제어**: 허용 목록은 `--plugin-dir`을 다루지 않습니다. `disableSideloadFlags`는 다룹니다.390* **허용 목록을 통해 `--plugin-dir` 제어**: 허용 목록은 `--plugin-dir`을 다루지 않습니다. `disableSideloadFlags`는 다룹니다.

31>31>

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

33>33>

34> ```bash theme={null}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}

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}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}

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}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}

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}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}

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}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}

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

80> ```80> ```

81>81>

257 257 

258| 명령 | 기능 | 예시 |258| 명령 | 기능 | 예시 |

259| - | - | - |259| - | - | - |

260| `/clear` | 대화 기록 지우기 | `/clear` |260| `/clear` | 새 대화를 시작합니다. 이전 대화는 `/resume`으로 재개할 수 있습니다. | `/clear` |

261| `/help` | 사용 가능한 명령 표시 | `/help` |261| `/help` | 사용 가능한 명령 표시 | `/help` |

262| `/exit` 또는 Ctrl+D 두 번 | Claude Code 종료 | `/exit` |262| `/exit` 또는 Ctrl+D 두 번 | Claude Code 종료 | `/exit` |

263 263 

33 * [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/ko/env-vars)이 `api.anthropic.com` 이외의 호스트(예: [LLM gateway](https://code.claude.com/docs/ko/llm-gateway) 또는 프록시)를 가리킵니다. Remote Control을 사용하려면 변수를 설정 해제하세요.33 * [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/ko/env-vars)이 `api.anthropic.com` 이외의 호스트(예: [LLM gateway](https://code.claude.com/docs/ko/llm-gateway) 또는 프록시)를 가리킵니다. Remote Control을 사용하려면 변수를 설정 해제하세요.

34 * enterprise [Claude apps gateway](https://code.claude.com/docs/ko/claude-apps-gateway)를 통해 로그인합니다.34 * enterprise [Claude apps gateway](https://code.claude.com/docs/ko/claude-apps-gateway)를 통해 로그인합니다.

35* **기능 플래그 평가**: [환경 변수를 설정하여 기능 플래그 평가를 비활성화](https://code.claude.com/docs/ko/env-vars.md#features-that-need-feature-flag-fetching)하는 경우, Remote Control의 가용성은 어느 것을 설정했는지에 따라 달라집니다:35* **기능 플래그 평가**: [환경 변수를 설정하여 기능 플래그 평가를 비활성화](https://code.claude.com/docs/ko/env-vars.md#features-that-need-feature-flag-fetching)하는 경우, Remote Control의 가용성은 어느 것을 설정했는지에 따라 달라집니다:

36 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 또는 `DISABLE_GROWTHBOOK`을 설정하면 Remote Control을 사용할 수 없습니다. Remote Control을 사용하려면 셸 환경이나 [`settings.json` 파일](https://code.claude.com/docs/ko/settings-reference#all-settings)의 `env` 블록에서 변수가 설정된 곳 어디든 설정 해제하세요.36 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 또는 [`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](https://code.claude.com/docs/ko/env-vars#variables)를 설정하면 Remote Control을 사용할 수 없습니다. Remote Control을 사용하려면 셸 환경이나 [`settings.json` 파일](https://code.claude.com/docs/ko/settings-reference#all-settings)의 `env` 블록에서 변수가 설정된 곳 어디든 설정 해제하세요.

37 * 만약 `DISABLE_TELEMETRY` 또는 `DO_NOT_TRACK`만 설정하면, 조직에서 [신뢰할 수 있는 디바이스](#trusted-devices)를 요구하지 않는 한 Remote Control은 계속 사용 가능합니다. 요구하는 경우 Remote Control을 사용하려면 변수를 설정 해제하세요. 두 변수 중 하나를 설정한 상태에서 Remote Control을 사용하려면 Claude Code v2.1.283 이상, Claude Desktop 앱에서는 v2.1.304 이상이 필요합니다.37 * 만약 `DISABLE_TELEMETRY` 또는 `DO_NOT_TRACK`만 설정하면, 조직에서 [신뢰할 수 있는 디바이스](#trusted-devices)를 요구하지 않는 한 Remote Control은 계속 사용 가능합니다. 요구하는 경우 Remote Control을 사용하려면 변수를 설정 해제하세요. 두 변수 중 하나를 설정한 상태에서 Remote Control을 사용하려면 Claude Code v2.1.283 이상, Claude Desktop 앱에서는 v2.1.304 이상이 필요합니다.

38* **작업 공간 신뢰**: 아직 신뢰하지 않은 디렉토리에서 `claude remote-control`은 신뢰하면 어떤 기능이 활성화되는지 출력하고 시작하기 전에 `Trust <directory>? [y/N]`을 묻습니다. `y`로 답하면 선택 사항이 저장되지만, 홈 디렉토리에서는 신뢰가 절대 저장되지 않으며 매번 실행할 때마다 질문이 반복됩니다. 표준 입력 또는 출력이 터미널이 아닐 때, 명령은 질문할 수 없으며 [`Workspace not trusted`](https://code.claude.com/docs/ko/errors#workspace-not-trusted-when-starting-remote-control) 오류로 종료됩니다.38* **작업 공간 신뢰**: 아직 신뢰하지 않은 디렉토리에서 `claude remote-control`은 신뢰하면 어떤 기능이 활성화되는지 출력하고 시작하기 전에 `Trust <directory>? [y/N]`을 묻습니다. `y`로 답하면 선택 사항이 저장되지만, 홈 디렉토리에서는 신뢰가 절대 저장되지 않으며 매번 실행할 때마다 질문이 반복됩니다. 표준 입력 또는 출력이 터미널이 아닐 때, 명령은 질문할 수 없으며 [`Workspace not trusted`](https://code.claude.com/docs/ko/errors#workspace-not-trusted-when-starting-remote-control) 오류로 종료됩니다.

39 39 

217 217 

218#### `DISABLE_TELEMETRY` 또는 `DO_NOT_TRACK`이 설정된 경우의 자동 연결218#### `DISABLE_TELEMETRY` 또는 `DO_NOT_TRACK`이 설정된 경우의 자동 연결

219 219 

220`DISABLE_TELEMETRY` 또는 `DO_NOT_TRACK`만 설정된 경우, 세션은 조직의 관리자 기본값이나 Claude Code 자체 기본값을 통해 자동 연결되지 않습니다. `DISABLE_GROWTHBOOK`이나 LLM 게이트웨이 등 다른 요인으로 Remote Control을 사용할 수 없는 경우에는 대신 [요구 사항](#requirements)부터 확인하세요.220`DISABLE_TELEMETRY` 또는 `DO_NOT_TRACK`만 설정된 경우, 세션은 조직의 관리자 기본값이나 Claude Code 자체 기본값을 통해 자동 연결되지 않습니다. [`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](https://code.claude.com/docs/ko/env-vars#variables)나 LLM 게이트웨이 등 다른 요인으로 Remote Control을 사용할 수 없는 경우에는 대신 [요구 사항](#requirements)부터 확인하세요.

221 221 

222`DISABLE_TELEMETRY` 또는 `DO_NOT_TRACK`만 설정된 상태에서 자동 연결을 켜기 전에, Claude Code 버전이 [이러한 변수에 대한 요구 사항](#requirements)을 충족하는지 확인합니다. 그런 다음 조직에서 [Trusted Devices](#trusted-devices)를 요구하는지 확인합니다.222`DISABLE_TELEMETRY` 또는 `DO_NOT_TRACK`만 설정된 상태에서 자동 연결을 켜기 전에, Claude Code 버전이 [이러한 변수에 대한 요구 사항](#requirements)을 충족하는지 확인합니다. 그런 다음 조직에서 [Trusted Devices](#trusted-devices)를 요구하는지 확인합니다.

223 223 

458 458 

459기능 플래그 평가를 비활성화하는 [환경 변수](https://code.claude.com/docs/ko/env-vars.md#features-that-need-feature-flag-fetching)가 설정되어 있으며, 전체 메시지는 Claude Code가 찾은 변수를 명시합니다. v2.1.154 이전 버전에서는 동일한 구성이 대신 "Remote Control is not yet enabled for your account"를 생성합니다. 수행할 작업은 메시지가 명시하는 변수에 따라 다릅니다:459기능 플래그 평가를 비활성화하는 [환경 변수](https://code.claude.com/docs/ko/env-vars.md#features-that-need-feature-flag-fetching)가 설정되어 있으며, 전체 메시지는 Claude Code가 찾은 변수를 명시합니다. v2.1.154 이전 버전에서는 동일한 구성이 대신 "Remote Control is not yet enabled for your account"를 생성합니다. 수행할 작업은 메시지가 명시하는 변수에 따라 다릅니다:

460 460 

461* **`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 또는 `DISABLE_GROWTHBOOK`**: 설정된 위치(셸 환경 또는 [`settings.json` 파일](https://code.claude.com/docs/ko/settings-reference#all-settings)의 `env` 블록)에서 변수를 설정 해제합니다.461* **`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `CLAUDE_CODE_DISABLE_FEATURE_FLAGS` 또는 `DISABLE_GROWTHBOOK`**: 설정된 위치(셸 환경 또는 [`settings.json` 파일](https://code.claude.com/docs/ko/settings-reference#all-settings)의 `env` 블록)에서 변수를 설정 해제합니다.

462* **`DISABLE_TELEMETRY` 또는 `DO_NOT_TRACK`**: Pro, Max, Ultra, Team 또는 Enterprise 플랜에서 `DISABLE_GROWTHBOOK`이 설정 해제된 경우, 이러한 변수는 조직이 [Trusted Devices](#trusted-devices)를 요구하지 않는 한 Remote Control을 사용 가능하게 둡니다. 요구하는 경우, Remote Control을 사용하기 위해 설정된 위치에서 변수를 설정 해제합니다. v2.1.154부터 v2.1.282까지는 어느 변수든 설정되어 있으면 이 메시지가 표시되므로, Claude Code를 [이러한 변수에 대한 요구 사항](#requirements)을 충족하는 버전으로 업데이트합니다.462* **`DISABLE_TELEMETRY` 또는 `DO_NOT_TRACK`**: Pro, Max, Ultra, Team 또는 Enterprise 플랜에서 `CLAUDE_CODE_DISABLE_FEATURE_FLAGS`와 `DISABLE_GROWTHBOOK`이 모두 설정 해제된 경우, 조직이 [Trusted Devices](#trusted-devices)를 요구하는 경우를 제외하고 이러한 변수가 설정되어 있어도 Remote Control을 계속 사용할 수 있습니다. 요구하는 경우, Remote Control을 사용하기 위해 설정된 위치에서 변수를 설정 해제합니다. v2.1.154부터 v2.1.282까지는 어느 변수든 설정되어 있으면 이 메시지가 표시되므로, Claude Code를 [이러한 변수에 대한 요구 사항](#requirements)을 충족하는 버전으로 업데이트합니다.

463 463 

464### "Remote Control is only available when using Claude via api.anthropic.com"464### "Remote Control is only available when using Claude via api.anthropic.com"

465 465 

111* **Environment variables**: Claude가 각 실행 중에 사용할 수 있는 값을 제공합니다. 이 값은 [환경을 사용하는 모든 사람에게 표시](https://code.claude.com/docs/ko/cloud-environments.md#what-carries-over-from-your-setup)되므로, Anthropic 호스팅 환경에서는 Claude가 실행 중에 호출하는 API의 키를 대신 [네트워크 시크릿](https://code.claude.com/docs/ko/cloud-environments.md#add-network-secrets)으로 저장합니다. 해당 섹션에는 시크릿을 받지 않는 요청도 나열되어 있습니다111* **Environment variables**: Claude가 각 실행 중에 사용할 수 있는 값을 제공합니다. 이 값은 [환경을 사용하는 모든 사람에게 표시](https://code.claude.com/docs/ko/cloud-environments.md#what-carries-over-from-your-setup)되므로, Anthropic 호스팅 환경에서는 Claude가 실행 중에 호출하는 API의 키를 대신 [네트워크 시크릿](https://code.claude.com/docs/ko/cloud-environments.md#add-network-secrets)으로 저장합니다. 해당 섹션에는 시크릿을 받지 않는 요청도 나열되어 있습니다

112* **Setup script**: 작업에 필요한 의존성과 도구를 설치합니다. 결과가 [캐시](https://code.claude.com/docs/ko/cloud-environments.md#environment-caching)되므로 스크립트가 모든 세션에서 다시 실행되지는 않습니다112* **Setup script**: 작업에 필요한 의존성과 도구를 설치합니다. 결과가 [캐시](https://code.claude.com/docs/ko/cloud-environments.md#environment-caching)되므로 스크립트가 모든 세션에서 다시 실행되지는 않습니다

113 113 

114**Default** 환경은 **Trusted** 네트워크 액세스로 제공되며, 세션의 네트워크를 통해 패키지 레지스트리, 클라우드 제공자 API, 컨테이너 레지스트리 및 일반적인 개발 도메인으로 구성된 [기본 허용 목록](https://code.claude.com/docs/ko/cloud-environments.md#default-allowed-domains)만 허용합니다. 작업에 추가하는 커넥터는 Anthropic의 서버를 통해 해당 서비스에 도달하므로 허용 목록을 변경할 필요가 없습니다.114**Default** 환경은 **Limited** 네트워크 액세스와 **Allow package managers**가 선택된 상태로 제공됩니다. 이 환경의 실행은 패키지 레지스트리, 클라우드 제공자 API, 컨테이너 레지스트리 및 일반적인 개발 도메인으로 구성된 [기본 허용 목록](https://code.claude.com/docs/ko/cloud-environments.md#default-allowed-domains)에 도달합니다. 작업에 추가하는 커넥터는 Anthropic의 서버를 통해 해당 서비스에 도달하므로 허용 목록을 변경할 필요가 없습니다.

115 115 

116작업이 자체 서비스나 해당 목록 외부의 도메인에 직접 도달해야 하는 경우, 실행하기 전에 환경의 [네트워크 액세스](https://code.claude.com/docs/ko/cloud-environments.md#network-access)를 편집합니다. 별도의 환경을 사용하려면 먼저 [환경을 만듭니다](https://code.claude.com/docs/ko/cloud-environments.md#configure-your-environment).116작업이 자체 서비스나 해당 목록 외부의 도메인에 직접 도달해야 하는 경우, 실행하기 전에 환경의 [네트워크 액세스](https://code.claude.com/docs/ko/cloud-environments.md#network-access)를 편집합니다. 별도의 환경을 사용하려면 먼저 [환경을 만듭니다](https://code.claude.com/docs/ko/cloud-environments.md#configure-your-environment).

117 117 

431 431 

432각 예약 작업은 네트워크 액세스, 환경 변수 및 설정 스크립트를 제어하는 [클라우드 환경](https://code.claude.com/docs/ko/cloud-environments.md)을 사용합니다. 작업은 모든 실행에서 환경의 네트워크 정책을 상속합니다.432각 예약 작업은 네트워크 액세스, 환경 변수 및 설정 스크립트를 제어하는 [클라우드 환경](https://code.claude.com/docs/ko/cloud-environments.md)을 사용합니다. 작업은 모든 실행에서 환경의 네트워크 정책을 상속합니다.

433 433 

434**Default** 환경은 **Trusted** 네트워크 액세스를 사용하며, 세션의 네트워크를 통해 [기본 허용 목록](https://code.claude.com/docs/ko/cloud-environments.md#default-allowed-domains)만 허용합니다. 해당 경로에서 허용 목록 외부의 호스트로 보내는 요청은 `403` 및 `x-deny-reason: host_not_allowed`로 실패합니다. MCP 커넥터 트래픽은 해당 경로가 아닌 Anthropic의 서버를 통해 라우팅되므로, 작업에 추가한 커넥터는 **Allowed domains**에 호스트를 추가하지 않아도 작동합니다. 필요하지 않은 커넥터는 [커넥터](#connectors)에서 제거하십시오.434**Default** 환경은 **Allow package managers**가 선택된 **Limited** 액세스를 사용하므로, 실행은 [기본 허용 목록](https://code.claude.com/docs/ko/cloud-environments.md#default-allowed-domains)에 접근할 수 있습니다. 차단된 호스트로 보내는 요청은 `403` 및 `x-deny-reason: host_not_allowed`로 실패합니다. MCP 커넥터 트래픽은 Anthropic의 서버를 통해 라우팅되므로, 작업에 추가한 커넥터는 **Allowed domains**에 호스트를 추가하지 않아도 작동합니다. 필요하지 않은 커넥터는 [커넥터](#connectors)에서 제거하십시오.

435 435 

436자신의 환경 중 하나에서 추가 도메인을 허용하려면 다음 단계를 따릅니다. [조직 공유 환경](https://code.claude.com/docs/ko/cloud-environments.md#organization-shared-environments)은 여기서 읽기 전용으로 열리므로, Owner가 대신 [관리자 설정](https://claude.ai/admin-settings)의 **Cloud environments** 페이지에서 네트워크 액세스를 변경합니다.436자신의 환경 중 하나에서 추가 도메인을 허용하려면 다음 단계를 따릅니다. [조직 공유 환경](https://code.claude.com/docs/ko/cloud-environments.md#organization-shared-environments)은 여기서 읽기 전용으로 열리므로, Owner가 대신 [관리자 설정](https://claude.ai/admin-settings)의 **Cloud environments** 페이지에서 네트워크 액세스를 변경합니다.

437 437 

447 447 

448목록에서 환경 위에 마우스를 올리고 오른쪽에 나타나는 설정 아이콘을 클릭합니다.448목록에서 환경 위에 마우스를 올리고 오른쪽에 나타나는 설정 아이콘을 클릭합니다.

449 449 

450**4. 네트워크 액세스 수준 변경**450**4. 도메인 추가**

451 451 

452**Edit cloud environment** 대화 상자에서 **Network access**를 **Custom**으로 변경하고 **Allowed domains**에 도메인을 입력합니다. 사용자 정의 도메인과 함께 [기본 허용 목록](https://code.claude.com/docs/ko/cloud-environments.md#default-allowed-domains)을 유지하려면 **Also include default list of common package managers**를 선택합니다. 제한 없는 액세스를 원하면 대신 **Full**을 선택합니다.452**Edit cloud environment** 대화 상자에서 **Network access** 아래의 **Limited**를 선택하고 **Allowed domains**에 도메인을 입력합니다. 사용자 도메인과 함께 [기본 허용 목록](https://code.claude.com/docs/ko/cloud-environments.md#default-allowed-domains)을 허용하려면 **Allow package managers**를 선택합니다. 제한 없는 액세스를 원하면 대신 **Full**을 선택합니다.

453 453 

454**5. 저장**454**5. 저장**

455 455 

6 6 

7> Claude Code 샌드박스 옵션 비교: 기본 제공 샌드박스 Bash 도구, 샌드박스 런타임, 개발 컨테이너, Docker, VM. 위협 모델에 맞는 적절한 격리를 선택합니다.7> Claude Code 샌드박스 옵션 비교: 기본 제공 샌드박스 Bash 도구, 샌드박스 런타임, 개발 컨테이너, Docker, VM. 위협 모델에 맞는 적절한 격리를 선택합니다.

8 8 

9Claude Code를 격리하면 세션이 호스트에서 읽고, 쓰고, 네트워크에 접근할 수 있는 범위를 제한합니다. 이는 Claude가 더 적은 권한 프롬프트로 작동하도록 하거나, 무인 상태로 실행하거나, 완전히 신뢰하지 않는 코드를 가리킬 때 가장 중요합니다.9Claude Code를 격리하면 세션이 읽고, 쓰고, 네트워크에서 접근할 수 있는 범위를 제한합니다. 이는 Claude가 더 적은 권한 프롬프트로 작동하도록 하거나 무인 상태로 실행할 때 가장 중요합니다.

10 10 

11Claude Code는 경량 명령별 샌드박스부터 완전히 별도의 가상 머신까지 여러 종류의 격리된 환경에서 실행될 수 있습니다. 이 페이지에서는 격리 방식을 비교하고, 위협 모델에 맞는 방식을 선택하는 데 도움을 주며, 조직 전체에서 해당 선택을 적용하는 방법을 보여줍니다.11Claude Code는 경량 명령별 샌드박스부터 완전히 별도의 가상 머신까지 여러 종류의 격리된 환경에서 실행될 수 있습니다. 이 페이지에서는 격리 방식을 비교하고, 위협 모델에 맞는 방식을 선택하는 데 도움을 주며, 조직 전체에서 해당 선택을 적용하는 방법을 보여줍니다.

12 12 

44| 자신의 머신에서 일상 작업 중 권한 프롬프트 감소 | [샌드박스 Bash 도구](https://code.claude.com/docs/ko/sandboxing.md), `/sandbox`로 구성 |44| 자신의 머신에서 일상 작업 중 권한 프롬프트 감소 | [샌드박스 Bash 도구](https://code.claude.com/docs/ko/sandboxing.md), `/sandbox`로 구성 |

45| Claude가 `--dangerously-skip-permissions` 또는 자동 모드로 무인 작동 | 사전 구성된 [개발 컨테이너](https://code.claude.com/docs/ko/devcontainer.md), 모든 컨테이너 또는 VM, 또는 [샌드박스 런타임](#sandbox-runtime) |45| Claude가 `--dangerously-skip-permissions` 또는 자동 모드로 무인 작동 | 사전 구성된 [개발 컨테이너](https://code.claude.com/docs/ko/devcontainer.md), 모든 컨테이너 또는 VM, 또는 [샌드박스 런타임](#sandbox-runtime) |

46| Docker 없이 MCP 서버 및 훅과 Bash 격리 | 샌드박스 런타임 |46| Docker 없이 MCP 서버 및 훅과 Bash 격리 | 샌드박스 런타임 |

47| 신뢰할 수 없는 저장소에서 작업 | 전용 가상 머신 또는 Claude 구독이 있는 경우 [웹의 Claude Code](https://code.claude.com/docs/ko/claude-code-on-the-web.md); `claude --cloud`로 시작할 때 GitHub는 필요하지 않습니다 |

48| 팀 전체에서 샌드박스 환경 표준화 | 사전 구성된 [개발 컨테이너](https://code.claude.com/docs/ko/devcontainer.md), 저장소에 복사됨 |47| 팀 전체에서 샌드박스 환경 표준화 | 사전 구성된 [개발 컨테이너](https://code.claude.com/docs/ko/devcontainer.md), 저장소에 복사됨 |

49| 로컬 설정이 없는 장치에서 Claude Code 사용 | [클라우드 세션](https://code.claude.com/docs/ko/claude-code-on-the-web.md), Claude 구독 필요, GitHub 저장소를 복제하려면 연결된 GitHub 계정 필요 |48| 로컬 설정이 없는 장치에서 Claude Code 사용 | [클라우드 세션](https://code.claude.com/docs/ko/claude-code-on-the-web.md), Claude 구독 필요, GitHub 저장소를 복제하려면 연결된 GitHub 계정 필요 |

50| 조직의 모든 개발자를 위한 격리 필요 | [조직 전체 격리 적용](#enforce-isolation-across-an-organization) |49| 조직의 모든 개발자를 위한 격리 필요 | [조직 전체 격리 적용](#enforce-isolation-across-an-organization) |

157 156 

158## 가상 머신157## 가상 머신

159 158 

160전용 가상 머신은 자체 커널과 클라우드 또는 microVM 배포에서 자체 가상화된 하드웨어를 사용하여 가장 강력한 분리를 제공합니다. 옵션에는 클라우드 인스턴스, 로컬 하이퍼바이저, Firecracker와 같은 microVM이 포함됩니다. 신뢰할 수 없는 코드를 평가할 때, 보안 정책이 에이전트와 호스트 간의 커널 수준 분리를 요구할 때, 또는 호스트 수준 방식이 규정 준수 요구 사항을 충족하지 않을 때 이 방식을 사용하세요.159전용 가상 머신은 자체 커널과 클라우드 또는 microVM 배포에서 자체 가상화된 하드웨어를 사용하여 가장 강력한 분리를 제공합니다. 옵션에는 클라우드 인스턴스, 로컬 하이퍼바이저, Firecracker와 같은 microVM이 포함됩니다. 보안 정책이 에이전트와 호스트 간의 커널 수준 분리를 요구할 때, 또는 어떤 호스트 수준 방식도 규정 준수 요구 사항을 충족하지 않을 때 이 방식을 사용하세요.

161 160 

162[Docker Sandboxes](https://docs.docker.com/ai/sandboxes/)는 자체 Docker 데몬 및 작업 공간 동기화가 있는 microVM을 제공하며, Docker Sandboxes가 설치된 모든 호스트에서 Claude Code를 실행할 수 있습니다. Docker Desktop이 필요하지 않은 Docker의 무료 독립형 제품입니다.161[Docker Sandboxes](https://docs.docker.com/ai/sandboxes/)는 자체 Docker 데몬 및 작업 공간 동기화가 있는 microVM을 제공하며, Docker Sandboxes가 설치된 모든 호스트에서 Claude Code를 실행할 수 있습니다. Docker Desktop이 필요하지 않은 Docker의 무료 독립형 제품입니다.

163 162 

739 739 

740샌드박스는 기본 Windows에서 실행되지 않으므로 `failIfUnavailable`이 설정되어 있으면 해당 머신에서는 Claude Code가 시작 시 종료됩니다. 플릿에 Windows 호스트가 포함되어 있다면 다음과 같이 할 수 있습니다:740샌드박스는 기본 Windows에서 실행되지 않으므로 `failIfUnavailable`이 설정되어 있으면 해당 머신에서는 Claude Code가 시작 시 종료됩니다. 플릿에 Windows 호스트가 포함되어 있다면 다음과 같이 할 수 있습니다:

741 741 

742* **운영 체제별로 구성 제공**: MDM을 통해 또는 [관리형 설정 파일](https://code.claude.com/docs/ko/managed-settings.md#delivery-mechanisms)로 macOS 및 Linux 머신에만 배포합니다. [서버 관리형 설정](https://code.claude.com/docs/ko/server-managed-settings.md#current-limitations)은 조직의 모든 사용자에게 적용됩니다742* **운영 체제별로 구성 제공**: MDM을 통해 또는 [관리형 설정 파일](https://code.claude.com/docs/ko/managed-settings.md#delivery-mechanisms)로 macOS 및 Linux 머신에만 배포합니다. [서버 관리형 설정](https://code.claude.com/docs/ko/server-managed-settings.md#give-groups-different-settings)은 기기가 아니라 구성원을 따릅니다.

743* **Windows 사용자를 지원되는 환경으로 이동**: WSL2 또는 컨테이너 내에서 Claude Code를 실행하도록 합니다743* **Windows 사용자를 지원되는 환경으로 이동**: WSL2 또는 컨테이너 내에서 Claude Code를 실행하도록 합니다

744 744 

745### 개발자가 정책을 확대하는 것을 방지745### 개발자가 정책을 확대하는 것을 방지

92* 현재 브랜치의 풀 요청 관리: 검토 의견, 실패한 CI 실행, 병합 충돌92* 현재 브랜치의 풀 요청 관리: 검토 의견, 실패한 CI 실행, 병합 충돌

93* 다른 것이 보류 중이지 않을 때 버그 사냥이나 단순화와 같은 정리 통과 실행93* 다른 것이 보류 중이지 않을 때 버그 사냥이나 단순화와 같은 정리 통과 실행

94 94 

95Claude는 해당 범위 외의 새로운 이니셔티브를 시작하지 않으며, 푸시나 삭제와 같은 되돌릴 수 없는 작업은 트랜스크립트가 이미 승인한 것을 계속할 때만 진행됩니다.95각 실행은 푸시하거나 삭제하기 전에 세션의 [권한 검사](https://code.claude.com/docs/ko/permissions.md)를 거칩니다.

96 

97단순한 `/loop`는 [동적으로 선택된 간격](#let-claude-choose-the-interval)에서 이 프롬프트를 실행합니다.

96 98 

97```text theme={null}99```text theme={null}

98/loop100/loop

99```101```

100 102 

101단순한 `/loop`는 [동적으로 선택된 간격](#let-claude-choose-the-interval)에서 이 프롬프트를 실행합니다. 고정 스케줄에서 실행하려면 `/loop 15m`과 같이 간격을 추가하세요. 내장 프롬프트를 자신의 기본값으로 바꾸려면 [loop.md로 기본 프롬프트 사용자 정의하기](#customize-the-default-prompt-with-loop-md)를 참조하세요.103고정 스케줄에서 실행하려면 `/loop 15m`과 같이 간격을 추가하세요. 내장 프롬프트를 자신의 기본값으로 바꾸려면 [loop.md로 기본 프롬프트 사용자 정의하기](#customize-the-default-prompt-with-loop-md)를 참조하세요.

102 104 

103### loop.md로 기본 프롬프트 사용자 정의하기105### loop.md로 기본 프롬프트 사용자 정의하기

104 106 

227 229 

228## 세션 범위 예약 작업 비활성화하기230## 세션 범위 예약 작업 비활성화하기

229 231 

230환경에서 `CLAUDE_CODE_DISABLE_CRON=1`을 설정하여 스케줄러를 완전히 비활성화합니다. cron 도구와 `/loop`를 사용할 수 없게 되며, 이미 스케줄된 모든 작업이 실행을 중지합니다. 비활성화 플래그의 전체 목록은 [Environment variables](https://code.claude.com/docs/ko/env-vars.md)를 참조하세요.232환경에서 `CLAUDE_CODE_DISABLE_CRON=1`을 설정하여 스케줄러를 완전히 비활성화합니다. `CronCreate`와 `/loop`를 사용할 수 없게 되며, 이미 예약된 모든 작업이 실행을 중지합니다. 프로젝트의 `.claude/scheduled_tasks.json` 파일에 작업이 있는 동안에는 `CronList`와 `CronDelete`를 계속 사용할 수 있으므로, 여전히 Claude에게 작업을 나열하거나 취소하도록 요청할 수 있습니다. 비활성화 플래그의 전체 목록은 [환경 변수](https://code.claude.com/docs/ko/env-vars.md)를 참조하세요.

231 233 

232## 제한 사항234## 제한 사항

233 235 

183 183 

184* **세션이 결과를 push하는 저장소**: 러너는 세션을 실패 처리하며, 0이 아닌 코드로 종료된 경우 스크립트 stderr의 마지막 부분을 사용자에게 표시합니다. 실패 이유를 짧은 한 줄로 stderr에 마지막으로 기록한 다음 0이 아닌 코드로 종료하십시오. stderr에 비밀 정보를 출력하지 말고, 훅을 배포하기 전에 `set -x`를 제거하십시오.184* **세션이 결과를 push하는 저장소**: 러너는 세션을 실패 처리하며, 0이 아닌 코드로 종료된 경우 스크립트 stderr의 마지막 부분을 사용자에게 표시합니다. 실패 이유를 짧은 한 줄로 stderr에 마지막으로 기록한 다음 0이 아닌 코드로 종료하십시오. stderr에 비밀 정보를 출력하지 말고, 훅을 배포하기 전에 `set -x`를 제거하십시오.

185 185 

186 훅 stderr의 마지막 약 4 KB 안에 git의 `couldn't find remote ref`가 나타나면 러너는 대신 브랜치가 삭제되었다고 보고합니다. 그러면 세션의 오류 메시지는 해당 브랜치가 원격에 더 이상 존재하지 않는다고 알리고 사용자에게 브랜치를 복원하도록 요청합니다. 해당 브랜치가 존재한다면 [세션이 `no longer exists on the remote` 또는 `couldn't find remote ref`로 실패하는 경우](https://code.claude.com/docs/ko/self-hosted-environments-deploy#no-longer-exists-on-the-remote)를 참조하십시오.186 훅 stderr의 마지막 약 4 KB 안에 git의 `couldn't find remote ref`가 나타나면 러너는 대신 브랜치가 없다고 보고합니다. 해당 브랜치가 존재한다면 [세션이 `couldn't be found in the remote repository` 또는 `couldn't find remote ref`로 실패하는 경우](https://code.claude.com/docs/ko/self-hosted-environments-deploy#no-longer-exists-on-the-remote)를 참조하십시오.

187* **세션이 읽기만 하는 저장소**(예: 실행 중인 세션에 추가된 저장소): 러너는 해당 저장소를 건너뛰고 나머지 저장소로 계속 진행합니다. 러너는 세션에 `Skipped` 단계를 게시하고 훅이 체크아웃 경로에 남긴 내용을 제거합니다.187* **세션이 읽기만 하는 저장소**(예: 실행 중인 세션에 추가된 저장소): 러너는 해당 저장소를 건너뛰고 나머지 저장소로 계속 진행합니다. 러너는 세션에 `Skipped` 단계를 게시하고 훅이 체크아웃 경로에 남긴 내용을 제거합니다.

188 188 

189 `Skipped` 단계에 checkout 훅이 언급되어 있으면 러너 로그의 `[runner:warn] checkout hook failed` 줄에서 실패 세부 정보를 확인하십시오. 단계에 소스 ref가 `no longer exists on remote`라고 표시되면 [세션이 `no longer exists on the remote` 또는 `couldn't find remote ref`로 실패하는 경우](https://code.claude.com/docs/ko/self-hosted-environments-deploy#no-longer-exists-on-the-remote)를 참조하십시오. 건너뛴 결과 세션에 저장소가 하나도 남지 않으면 러너는 결국 세션을 실패 처리합니다.189 `Skipped` 단계에 checkout 훅이 언급되어 있으면 러너 로그의 `[runner:warn] checkout hook failed` 줄에서 실패 세부 정보를 확인하십시오. 단계에 소스 ref가 `no longer exists on remote`라고 표시되면 [세션이 `couldn't be found in the remote repository` 또는 `couldn't find remote ref`로 실패하는 경우](https://code.claude.com/docs/ko/self-hosted-environments-deploy#no-longer-exists-on-the-remote)를 참조하십시오. 건너뛴 결과 세션에 저장소가 하나도 남지 않으면 러너는 결국 세션을 실패 처리합니다.

190 190 

191훅이 성공하면 러너는 세션이 끝난 후 체크아웃 경로를 제거합니다.191훅이 성공하면 러너는 세션이 끝난 후 체크아웃 경로를 제거합니다.

192 192 

638 638 

639* 표준 시스템 경로에 있는 엔터프라이즈 범위 [관리형 MCP 파일](https://code.claude.com/docs/ko/managed-mcp.md): Linux 러너 호스트에서는 `/etc/claude-code/managed-mcp.json`, macOS 호스트에서는 `/Library/Application Support/ClaudeCode/managed-mcp.json`입니다. 관리자가 나열한 서버만 로드할 수 있도록 잠긴 플릿에 사용합니다. 우선순위 규칙은 [managed-mcp.json을 통한 배타적 제어](https://code.claude.com/docs/ko/managed-mcp.md#exclusive-control-with-managed-mcp-json)를 참조하세요. 이 파일이 러너 호스트에 있으면 Claude Code는 claude.ai 커넥터를 포함하여 Anthropic의 컨트롤 플레인이 세션에 전달하는 MCP 서버를 건너뛰고, 세션 자식 프로세스의 stderr에 경고로 해당 서버 이름을 표시하며, 러너는 이를 `debug` 로그 수준으로 기록합니다. v2.1.229 이전에는 이러한 세션이 `You cannot dynamically configure MCP servers when an enterprise MCP config is present`와 함께 시작 시 종료되었습니다.639* 표준 시스템 경로에 있는 엔터프라이즈 범위 [관리형 MCP 파일](https://code.claude.com/docs/ko/managed-mcp.md): Linux 러너 호스트에서는 `/etc/claude-code/managed-mcp.json`, macOS 호스트에서는 `/Library/Application Support/ClaudeCode/managed-mcp.json`입니다. 관리자가 나열한 서버만 로드할 수 있도록 잠긴 플릿에 사용합니다. 우선순위 규칙은 [managed-mcp.json을 통한 배타적 제어](https://code.claude.com/docs/ko/managed-mcp.md#exclusive-control-with-managed-mcp-json)를 참조하세요. 이 파일이 러너 호스트에 있으면 Claude Code는 claude.ai 커넥터를 포함하여 Anthropic의 컨트롤 플레인이 세션에 전달하는 MCP 서버를 건너뛰고, 세션 자식 프로세스의 stderr에 경고로 해당 서버 이름을 표시하며, 러너는 이를 `debug` 로그 수준으로 기록합니다. v2.1.229 이전에는 이러한 세션이 `You cannot dynamically configure MCP servers when an enterprise MCP config is present`와 함께 시작 시 종료되었습니다.

640* 러너 호스트의 [관리형 설정](https://code.claude.com/docs/ko/managed-settings.md)에 있는 [`managedMcpServers`](https://code.claude.com/docs/ko/settings-reference#managedmcpservers) 키: 배타적 제어를 하지 않고 HTTP 및 SSE 서버를 제공하므로 다른 소스의 서버도 계속 로드됩니다. Claude Code v2.1.259 이상이 필요합니다.640* 러너 호스트의 [관리형 설정](https://code.claude.com/docs/ko/managed-settings.md)에 있는 [`managedMcpServers`](https://code.claude.com/docs/ko/settings-reference#managedmcpservers) 키: 배타적 제어를 하지 않고 HTTP 및 SSE 서버를 제공하므로 다른 소스의 서버도 계속 로드됩니다. Claude Code v2.1.259 이상이 필요합니다.

641* `<repo>/.mcp.json`: 프로젝트 범위입니다. [프로젝트](https://code.claude.com/docs/ko/claude-projects.md#what-threads-pick-up-from-your-repositories) 스레드 외부에서는 파일을 저장소에 커밋하면 해당 서버가 클라우드 세션에서 자동 승인됩니다. 여러 저장소가 있는 세션에서는 [최대 하나의 저장소 파일만 로드됩니다](#repository-settings-in-sessions-with-several-repositories).641* `<repo>/.mcp.json`: 프로젝트 범위입니다. [프로젝트](https://code.claude.com/docs/ko/claude-projects.md#what-threads-pick-up-from-your-repositories) 스레드 외부에서는 파일을 저장소에 커밋하면 해당 서버가 클라우드 세션에서 자동 승인됩니다. 여러 저장소가 있는 세션에서는 [최대 하나의 저장소 파일만 로드됩니다](#repository-settings-in-sessions-with-several-repositories). [`--trust-workspace false`](https://code.claude.com/docs/ko/self-hosted-environments-reference#runner-cli-flags)를 사용하면, 호스트의 `~/.claude/settings.json`에 있는 [`enabledMcpjsonServers`](https://code.claude.com/docs/ko/settings-reference#enabledmcpjsonservers)처럼 저장소가 커밋하지 않은 설정이 이 파일의 서버를 승인하는 경우를 제외하고 세션은 해당 서버를 건너뜁니다. Claude Code v2.1.319 이상이 필요합니다.

642* 래퍼 스크립트에서 지정하는 [`--mcp-config`](https://code.claude.com/docs/ko/cli-reference#cli-flags) 파일: `exec "$CLAUDE_RUNNER_CLAUDE_BIN" "$@" --mcp-config /etc/claude/mcp.json`과 같이 `"$@"` 뒤에 플래그를 덧붙입니다. 세션 도중 세션에 전달된 서버가 업데이트될 때 이 파일의 서버가 계속 실행되도록 하려면, `exec`처럼 래퍼가 [전체 환경](#wrapper-scripts)을 자식 프로세스에 전달하도록 합니다. v2.1.299 이전에는 이 파일의 stdio, HTTP, SSE 서버가 해당 서버를 명시하지 않은 첫 번째 업데이트 시점에 종료되었습니다.642* 래퍼 스크립트에서 지정하는 [`--mcp-config`](https://code.claude.com/docs/ko/cli-reference#cli-flags) 파일: `exec "$CLAUDE_RUNNER_CLAUDE_BIN" "$@" --mcp-config /etc/claude/mcp.json`과 같이 `"$@"` 뒤에 플래그를 덧붙입니다. 세션 도중 세션에 전달된 서버가 업데이트될 때 이 파일의 서버가 계속 실행되도록 하려면, `exec`처럼 래퍼가 [전체 환경](#wrapper-scripts)을 자식 프로세스에 전달하도록 합니다. v2.1.299 이전에는 이 파일의 stdio, HTTP, SSE 서버가 해당 서버를 명시하지 않은 첫 번째 업데이트 시점에 종료되었습니다.

643 643 

644조직에 커넥터 전달이 활성화되어 있으면 Anthropic의 컨트롤 플레인은 claude.ai에서 구성한 커넥터를 `api.anthropic.com`을 경유하는 서버 제공 MCP 구성을 통해 대화형으로 생성된 세션에 전달합니다. [CLI 디스패치](https://code.claude.com/docs/ko/self-hosted-environments-testing.md#run-the-test-loop)와 같이 프로그래밍 방식으로 생성된 세션은 커넥터 전달을 받지 않으므로, 이 섹션에 나열된 다른 소스를 통해 MCP 서버를 제공해야 합니다. 자식 프로세스의 OAuth 토큰에는 커넥터를 직접 가져오기 위한 범위가 포함되어 있지 않으므로 자식 프로세스는 직접 가져오기를 시도하지 않으며, 전달은 서버 주도로 이루어집니다.644조직에 커넥터 전달이 활성화되어 있으면 Anthropic의 컨트롤 플레인은 claude.ai에서 구성한 커넥터를 `api.anthropic.com`을 경유하는 서버 제공 MCP 구성을 통해 대화형으로 생성된 세션에 전달합니다. [CLI 디스패치](https://code.claude.com/docs/ko/self-hosted-environments-testing.md#run-the-test-loop)와 같이 프로그래밍 방식으로 생성된 세션은 커넥터 전달을 받지 않으므로, 이 섹션에 나열된 다른 소스를 통해 MCP 서버를 제공해야 합니다. 자식 프로세스의 OAuth 토큰에는 커넥터를 직접 가져오기 위한 범위가 포함되어 있지 않으므로 자식 프로세스는 직접 가져오기를 시도하지 않으며, 전달은 서버 주도로 이루어집니다.

906 906 

907여러 저장소가 있는 그 밖의 세션에서 Claude Code는 세션이 시작되는 디렉터리에서 프로젝트 설정을 읽으므로, 최대 하나의 저장소의 `.claude/settings.json`만 프로젝트 설정으로 적용됩니다. 다른 저장소의 파일에 정의된 훅은 실행되지 않고, 그 안의 거부 규칙은 적용되지 않으며, 해당 `env`도 설정되지 않습니다.907여러 저장소가 있는 그 밖의 세션에서 Claude Code는 세션이 시작되는 디렉터리에서 프로젝트 설정을 읽으므로, 최대 하나의 저장소의 `.claude/settings.json`만 프로젝트 설정으로 적용됩니다. 다른 저장소의 파일에 정의된 훅은 실행되지 않고, 그 안의 거부 규칙은 적용되지 않으며, 해당 `env`도 설정되지 않습니다.

908 908 

909* **기본값인 `--capacity 1`과 기본 제공 체크아웃 사용 시**: 세션은 저장소 목록의 첫 번째 저장소에서 시작됩니다. 해당 저장소의 `.claude/settings.json`이 프로젝트 설정으로 적용되고 `.mcp.json`이 로드되며, 다른 저장소의 파일은 적용되거나 로드되지 않습니다.909* **기본값인 `--capacity 1`과 기본 제공 체크아웃 사용 시**: 세션은 저장소 목록의 첫 번째 저장소에서 시작됩니다. 해당 저장소의 `.claude/settings.json`이 프로젝트 설정으로 적용되고 해당 저장소의 [`.mcp.json`](#mcp-servers)이 로드되며, 다른 저장소의 파일은 적용되거나 로드되지 않습니다.

910* **1보다 큰 `--capacity` 또는 [`checkout` 훅](#checkout) 사용 시**: 세션은 체크아웃이 포함된 세션별 디렉터리에서 시작됩니다. 어떤 저장소의 `.claude/settings.json`도 프로젝트 설정으로 적용되지 않고, 어떤 저장소의 `.mcp.json`도 로드되지 않으며, 훅 명령의 [`$CLAUDE_PROJECT_DIR`](https://code.claude.com/docs/ko/hooks#reference-scripts-by-path)은 체크아웃이 아닌 해당 디렉터리가 됩니다.910* **1보다 큰 `--capacity` 또는 [`checkout` 훅](#checkout) 사용 시**: 세션은 체크아웃이 포함된 세션별 디렉터리에서 시작됩니다. 어떤 저장소의 `.claude/settings.json`도 프로젝트 설정으로 적용되지 않고, 어떤 저장소의 `.mcp.json`도 로드되지 않으며, 훅 명령의 [`$CLAUDE_PROJECT_DIR`](https://code.claude.com/docs/ko/hooks#reference-scripts-by-path)은 체크아웃이 아닌 해당 디렉터리가 됩니다.

911 911 

912각 저장소의 `CLAUDE.md`는 세션이 어디에서 시작되든 로드됩니다. 프로젝트 스레드 외부에서는 해당 저장소의 스킬도 로드됩니다. 러너는 모든 저장소를 [추가 디렉터리](https://code.claude.com/docs/ko/permissions.md#additional-directories-grant-file-access-not-configuration)로 Claude Code에 전달하므로, Claude Code는 각 저장소의 `.claude/settings.json`에서 `enabledPlugins` 및 `extraKnownMarketplaces` 키도 읽습니다.912각 저장소의 `CLAUDE.md`는 세션이 어디에서 시작되든 로드됩니다. 프로젝트 스레드 외부에서는 해당 저장소의 스킬도 로드됩니다. 러너는 모든 저장소를 [추가 디렉터리](https://code.claude.com/docs/ko/permissions.md#additional-directories-grant-file-access-not-configuration)로 Claude Code에 전달하므로, Claude Code는 각 저장소의 `.claude/settings.json`에서 `enabledPlugins` 및 `extraKnownMarketplaces` 키도 읽습니다.

916* **러너가 `rejecting the malformed poll response`를 포함하는 `Poll failed` 줄을 로그에 기록함**: 러너가 수신한 작업 폴링 응답의 본문이 큐에서 예상하는 JSON이 아닙니다. 한 가지 원인은 가로채는 프록시나 캡티브 포털이 자체 페이지로 응답하는 경우입니다. 러너가 프록시를 통해 연결한다면 `api.anthropic.com`의 응답을 변경 없이 통과시키도록 프록시를 구성합니다.916* **러너가 `rejecting the malformed poll response`를 포함하는 `Poll failed` 줄을 로그에 기록함**: 러너가 수신한 작업 폴링 응답의 본문이 큐에서 예상하는 JSON이 아닙니다. 한 가지 원인은 가로채는 프록시나 캡티브 포털이 자체 페이지로 응답하는 경우입니다. 러너가 프록시를 통해 연결한다면 `api.anthropic.com`의 응답을 변경 없이 통과시키도록 프록시를 구성합니다.

917 917 

918 러너는 잘못된 형식의 응답을 거부하고, 이를 `claude_code_self_hosted_runner_poll_errors_total` [메트릭](https://code.claude.com/docs/ko/self-hosted-environments-reference.md#prometheus-metrics)의 `transport` 종류로 집계하며, [세션 수명 주기](https://code.claude.com/docs/ko/self-hosted-environments#session-lifecycle)에 설명된 실패한 폴링 일정에 따라 재시도합니다. 러너는 실행 중인 세션을 계속 제공합니다. v2.1.246 이전에는 러너가 이러한 응답을 빈 작업 큐로 해석했으며, 이로 인해 실행 중인 세션이 종료되거나 러너 자체가 종료될 수 있었습니다.918 러너는 잘못된 형식의 응답을 거부하고, 이를 `claude_code_self_hosted_runner_poll_errors_total` [메트릭](https://code.claude.com/docs/ko/self-hosted-environments-reference.md#prometheus-metrics)의 `transport` 종류로 집계하며, [세션 수명 주기](https://code.claude.com/docs/ko/self-hosted-environments#session-lifecycle)에 설명된 실패한 폴링 일정에 따라 재시도합니다. 러너는 실행 중인 세션을 계속 제공합니다. v2.1.246 이전에는 러너가 이러한 응답을 빈 작업 큐로 해석했으며, 이로 인해 실행 중인 세션이 종료되거나 러너 자체가 종료될 수 있었습니다.

919* **세션이 `no longer exists on the remote` 또는 `couldn't find remote ref`와 함께 실패함**: 러너는 git의 `couldn't find remote ref`를 삭제된 브랜치로 해석합니다. 브랜치는 여전히 존재할 수 있습니다. git 호스트에서 메시지에 표시된 이름 그대로 브랜치를 찾아본 후, 해당하는 각 원인을 확인합니다.919* **세션이 `couldn't be found in the remote repository` 또는 `couldn't find remote ref`와 함께 실패함**: git 호스트에서 브랜치를 찾아봅니다. 메시지에 표시된 이름 그대로 검색합니다.

920 920 

921 * **브랜치가 없는 경우**: 메시지에서 요청하는 대로 브랜치를 복원합니다.921 세션의 오류에는 `Retrying will fail the same way until you fix the missing branch described below.`가 포함됩니다. 오류에 브랜치 이름이 명시된 경우 `Last output before exit:` 아래의 텍스트는 다음과 같습니다.

922 

923 ```text theme={null}

924 The branch '<ref>' couldn't be found in the remote repository <repo>. If it was never pushed, push it. If it was deleted after a merge, restore it from its pull request. Then send a new message, or start a new session from a branch that has been pushed. (couldn't find remote ref)

925 ```

926 

927 * **브랜치가 호스트에 없는 경우**: 한 번도 푸시하지 않았다면 푸시하고, 병합 후 삭제되었다면 해당 풀 리퀘스트에서 복원합니다.

922 * **브랜치가 존재하고 러너를 관리하지 않는 경우**: 러너 관리자에게 전체 메시지를 보내고 브랜치가 존재한다고 알립니다.928 * **브랜치가 존재하고 러너를 관리하지 않는 경우**: 러너 관리자에게 전체 메시지를 보내고 브랜치가 존재한다고 알립니다.

923 * **브랜치가 존재하고 러너에 `checkout` 훅이 있는 경우**: 훅의 git 명령이 훅이 0이 아닌 코드로 종료되기 전에 stderr에 `couldn't find remote ref`를 출력할 수 있습니다. 해당 명령을 찾아 그 명령이 요청하는 ref 또는 가져오는 원격을 수정합니다. 러너는 세션이 요청한 리비전을 [`CLAUDE_RUNNER_REPO_REF`](https://code.claude.com/docs/ko/self-hosted-environments-configuration#checkout)로 훅에 전달합니다.929 * **브랜치가 존재하고 러너에 `checkout` 훅이 있는 경우**: 훅의 git 명령이 훅이 0이 아닌 코드로 종료되기 전에 stderr에 `couldn't find remote ref`를 출력할 수 있습니다. 해당 명령을 찾아 그 명령이 요청하는 ref 또는 가져오는 원격을 수정합니다. 러너는 세션이 요청한 리비전을 [`CLAUDE_RUNNER_REPO_REF`](https://code.claude.com/docs/ko/self-hosted-environments-configuration#checkout)로 훅에 전달합니다.

924 * **브랜치가 존재하고 러너에 `checkout` 훅이 없는 경우**: 러너가 직접 브랜치를 가져옵니다. [`--git-host-rewrite`](#rewrite-git-urls-for-private-networks)가 저장소에 적용된다면 재작성 대상 호스트에 같은 이름의 브랜치가 있는지 확인하고, 없다면 해당 호스트에 브랜치를 푸시합니다.930 * **브랜치가 존재하고 러너에 `checkout` 훅이 없는 경우**: 러너가 직접 브랜치를 가져옵니다. [`--git-host-rewrite`](#rewrite-git-urls-for-private-networks)가 저장소에 적용된다면 재작성 대상 호스트에 같은 이름의 브랜치가 있는지 확인하고, 없다면 해당 호스트에 브랜치를 푸시합니다.

925 * **브랜치가 존재하고 러너가 v2.1.301보다 오래된 경우**: 다른 실패가 자체 오류를 표시하도록 [버전 고정하기](#pin-the-version)에 설명된 대로 러너를 업그레이드합니다. v2.1.301 이전에는 오류 출력에 `couldn't find remote ref`가 포함된 다른 실패도 삭제된 브랜치로 보고되었습니다.931 * **브랜치가 존재하고 러너가 v2.1.301보다 오래된 경우**: 다른 실패가 자체 오류를 표시하도록 [버전 고정하기](#pin-the-version)에 설명된 대로 러너를 업그레이드합니다. v2.1.301 이전에는 오류 출력에 `couldn't find remote ref`가 포함된 다른 실패도 삭제된 브랜치로 보고되었습니다.

926 932 

927 러너를 업그레이드하거나 원인을 해결한 후 세션을 재시도하거나 새 세션을 시작합니다. 이러한 확인으로도 원인을 찾지 못하면 [문제를 보고합니다](#report-an-issue).933 러너를 업그레이드하거나 원인을 해결한 후 세션에 새 메시지를 보내거나, 푸시된 브랜치에서 새 세션을 시작합니다. 이러한 확인으로도 원인을 찾지 못하면 [문제를 보고합니다](#report-an-issue). v2.1.314 이전에는 메시지에 브랜치가 `no longer exists on the remote`라고 표시되었습니다. 해당 메시지에도 같은 확인 절차를 따릅니다.

928 934 

929 세션이 결과를 푸시하는 소스의 경우 삭제된 브랜치는 세션을 실패시킵니다. 세션이 읽기만 하는 git 소스의 경우 러너는 해당 소스를 건너뛰고 나머지 소스로 계속 진행합니다. 건너뛰면 세션에 저장소가 하나도 남지 않는 경우에는 러너가 세션을 실패시킵니다. v2.1.228 이전에는 이러한 세션이 빈 디렉터리에서 시작되었습니다.935 세션이 결과를 푸시하는 소스의 경우 삭제된 브랜치는 세션을 실패시킵니다. 세션이 읽기만 하는 git 소스의 경우 러너는 해당 소스를 건너뛰고 나머지 소스로 계속 진행합니다. 건너뛰면 세션에 저장소가 하나도 남지 않는 경우에는 러너가 세션을 실패시킵니다. v2.1.228 이전에는 이러한 세션이 빈 디렉터리에서 시작되었습니다.

930* **Claude Tag가 Slack에 응답을 게시하지 않는 경우가 있음**: 응답 알림은 [컨트롤 플레인이 제공하는 훅](https://code.claude.com/docs/ko/self-hosted-environments-configuration.md#how-each-session’s-config-is-assembled)입니다. 이전 러너는 제공된 훅을 무시하므로 `claude --version`으로 러너가 Claude Code v2.1.229 이상인지 확인합니다. 훅은 `python3`을 실행하므로 러너 이미지 안에서 `python3 --version`이 성공하는지 확인합니다. 그리고 어떤 설정 파일도 훅을 끄지 않는지 확인합니다. 여기에는 `managed-settings.json`, 러너 사용자의 `~/.claude/settings.json`, 저장소의 `.claude/settings.json` 또는 `.claude/settings.local.json`에 있는 `disableAllHooks`, 그리고 관리형 설정에서 훅을 포함하는 `allowManagedHooksOnly` 또는 [`strictPluginOnlyCustomization`](https://code.claude.com/docs/ko/settings-reference#strictpluginonlycustomization)이 해당됩니다.936* **Claude Tag가 Slack에 응답을 게시하지 않는 경우가 있음**: 응답 알림은 [컨트롤 플레인이 제공하는 훅](https://code.claude.com/docs/ko/self-hosted-environments-configuration.md#how-each-session’s-config-is-assembled)입니다. 이전 러너는 제공된 훅을 무시하므로 `claude --version`으로 러너가 Claude Code v2.1.229 이상인지 확인합니다. 훅은 `python3`을 실행하므로 러너 이미지 안에서 `python3 --version`이 성공하는지 확인합니다. 그리고 어떤 설정 파일도 훅을 끄지 않는지 확인합니다. 여기에는 `managed-settings.json`, 러너 사용자의 `~/.claude/settings.json`, 저장소의 `.claude/settings.json` 또는 `.claude/settings.local.json`에 있는 `disableAllHooks`, 그리고 관리형 설정에서 훅을 포함하는 `allowManagedHooksOnly` 또는 [`strictPluginOnlyCustomization`](https://code.claude.com/docs/ko/settings-reference#strictpluginonlycustomization)이 해당됩니다.

125| `SELF_HOSTED_RUNNER_MAX_LIFETIME_GRACE_MS` | `900000` | 세션이 `--kill-session-after-min` 제한에 도달한 후, 러너가 세션을 종료하기 전에 실행 중인 턴이 완료되거나 해제가 완료될 때까지 대기하는 시간입니다. |125| `SELF_HOSTED_RUNNER_MAX_LIFETIME_GRACE_MS` | `900000` | 세션이 `--kill-session-after-min` 제한에 도달한 후, 러너가 세션을 종료하기 전에 실행 중인 턴이 완료되거나 해제가 완료될 때까지 대기하는 시간입니다. |

126| `SELF_HOSTED_RUNNER_POST_TURN_SETTLE_MS` | `7000` | 턴이 완료된 후 세션의 프로세스가 턴의 끝을 Anthropic에 보고하는 동안 러너가 `--drain-wait-sec` 드레인에 대해 세션을 바쁜 것으로 계산하는 시간의 상한입니다. `0` 또는 사용할 수 없는 값은 기본값으로 폴백되므로 보유를 끌 수 없습니다. Claude Code v2.1.275 이상이 필요합니다. |126| `SELF_HOSTED_RUNNER_POST_TURN_SETTLE_MS` | `7000` | 턴이 완료된 후 세션의 프로세스가 턴의 끝을 Anthropic에 보고하는 동안 러너가 `--drain-wait-sec` 드레인에 대해 세션을 바쁜 것으로 계산하는 시간의 상한입니다. `0` 또는 사용할 수 없는 값은 기본값으로 폴백되므로 보유를 끌 수 없습니다. Claude Code v2.1.275 이상이 필요합니다. |

127| `SELF_HOSTED_RUNNER_SIGKILL_GRACE_MS` | `30000` | 러너가 중단 불가능한 I/O에 갇혀 있는 자식에게 OS가 `SIGKILL`을 전달할 때까지 기다린 후 자신을 종료하기 전까지 기다리는 시간입니다. `--post-session-hook-timeout-sec` 더하기 15초로 바닥이 정해지며, `--push-outcome-on-release`가 설정되면 30초 더 추가되므로 효과적인 최소값은 기본값에서 75초입니다. |127| `SELF_HOSTED_RUNNER_SIGKILL_GRACE_MS` | `30000` | 러너가 중단 불가능한 I/O에 갇혀 있는 자식에게 OS가 `SIGKILL`을 전달할 때까지 기다린 후 자신을 종료하기 전까지 기다리는 시간입니다. `--post-session-hook-timeout-sec` 더하기 15초로 바닥이 정해지며, `--push-outcome-on-release`가 설정되면 30초 더 추가되므로 효과적인 최소값은 기본값에서 75초입니다. |

128| `CLAUDE_RUNNER_DISABLE_RENEWAL_WARNING` | 설정되지 않음 | `1`일 때, 러너는 세션에 `The server has refused to renew this session's access to the model`을 게시하지 않습니다. 각 거부 후에는 다음 예약된 갱신 시점까지 기다렸다가 다시 요청합니다. Claude Code v2.1.319 이상이 필요합니다. |

128| `CLAUDE_RUNNER_FETCH_DEPTH` | `50` | 신선한 복제를 위한 Git 페치 깊이입니다. 양의 정수 또는 완전한 페치를 위해 `full` 또는 `0`을 설정하세요. 워크스페이스에 이미 있는 클론의 경우 [미리 준비된 체크아웃 재사용](https://code.claude.com/docs/ko/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout)을 참조하세요. |129| `CLAUDE_RUNNER_FETCH_DEPTH` | `50` | 신선한 복제를 위한 Git 페치 깊이입니다. 양의 정수 또는 완전한 페치를 위해 `full` 또는 `0`을 설정하세요. 워크스페이스에 이미 있는 클론의 경우 [미리 준비된 체크아웃 재사용](https://code.claude.com/docs/ko/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout)을 참조하세요. |

129| `CLAUDE_RUNNER_FETCH_SERVER_PROGRESS_CAP_MS` | `600000` | 서버가 대규모 저장소의 팩을 준비할 때처럼 Git 서버 자체의 진행률 수치가 계속 증가하는 동안, Git 페치가 첫 데이터를 기다릴 수 있는 시도당 시간(밀리초)입니다. `0` 또는 `off`는 이 대기를 끕니다. 이 경우 해당 페치는 데이터 없이 2분이 지나면 중단됩니다. 그 외의 정수는 `120000`에서 `1800000` 사이, 즉 2분에서 30분 사이로 제한됩니다. Claude Code v2.1.295 이상이 필요합니다. |130| `CLAUDE_RUNNER_FETCH_SERVER_PROGRESS_CAP_MS` | `600000` | 서버가 대규모 저장소의 팩을 준비할 때처럼 Git 서버 자체의 진행률 수치가 계속 증가하는 동안, Git 페치가 첫 데이터를 기다릴 수 있는 시도당 시간(밀리초)입니다. `0` 또는 `off`는 이 대기를 끕니다. 이 경우 해당 페치는 데이터 없이 2분이 지나면 중단됩니다. 그 외의 정수는 `120000`에서 `1800000` 사이, 즉 2분에서 30분 사이로 제한됩니다. Claude Code v2.1.295 이상이 필요합니다. |

130| `CLAUDE_RUNNER_SKIP_GIT_VERIFY` | 설정되지 않음 | `1`일 때, `checkout` 훅이 실행된 후 `.git` 존재 확인을 건너뜁니다. 훅이 비git 소스를 구체화할 때 이를 설정하세요. |131| `CLAUDE_RUNNER_SKIP_GIT_VERIFY` | 설정되지 않음 | `1`일 때, `checkout` 훅이 실행된 후 `.git` 존재 확인을 건너뜁니다. 훅이 비git 소스를 구체화할 때 이를 설정하세요. |

135 136 

136세션 자식은 끄지 않으면 Anthropic에 운영 텔레메트리를 전송합니다. 코드 또는 저장소 내용은 전송되지 않습니다. 러너 프로세스에서 텔레메트리 변수를 설정하세요. 러너는 서버 제공 환경 변수를 적용한 후 다시 주장하므로 운영자의 설정이 항상 우선합니다.137세션 자식은 끄지 않으면 Anthropic에 운영 텔레메트리를 전송합니다. 코드 또는 저장소 내용은 전송되지 않습니다. 러너 프로세스에서 텔레메트리 변수를 설정하세요. 러너는 서버 제공 환경 변수를 적용한 후 다시 주장하므로 운영자의 설정이 항상 우선합니다.

137 138 

138한 가지 제어는 자체 호스팅 환경에만 해당됩니다: `CLAUDE_CODE_BYOC_ENABLE_DATADOG=1`은 Datadog 운영 메트릭을 옵트인하며, 이는 자체 호스팅 환경에서 기본적으로 꺼져 있습니다. 일반 Claude Code 텔레메트리 제어인 `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `DISABLE_ERROR_REPORTING` 및 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`은 [environment variable reference](https://code.claude.com/docs/ko/env-vars.md)에서 문서화된 대로 세션 자식에 적용됩니다. `DISABLE_GROWTHBOOK`은 관련이 있지만 다릅니다: `DISABLE_GROWTHBOOK=1`을 설정하면 기능 플래그 페칭이 비활성화되고, `DISABLE_TELEMETRY`도 설정되지 않으면 텔레메트리가 켜져 있습니다.139한 가지 제어는 자체 호스팅 환경에만 해당됩니다: `CLAUDE_CODE_BYOC_ENABLE_DATADOG=1`은 Datadog 운영 메트릭을 옵트인하며, 이는 자체 호스팅 환경에서 기본적으로 꺼져 있습니다. 일반 Claude Code 텔레메트리 제어인 `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `DISABLE_ERROR_REPORTING` 및 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`은 [environment variable reference](https://code.claude.com/docs/ko/env-vars.md)에서 문서화된 대로 세션 자식에 적용됩니다. [`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](https://code.claude.com/docs/ko/env-vars#variables)는 관련이 있지만 다릅니다: `CLAUDE_CODE_DISABLE_FEATURE_FLAGS=1`을 설정하면 기능 플래그 페칭이 비활성화되고, `DISABLE_TELEMETRY`도 설정되지 않으면 텔레메트리가 켜져 있습니다. `CLAUDE_CODE_DISABLE_FEATURE_FLAGS`에는 Claude Code v2.1.319 이상이 필요합니다.

139 140 

140`CLAUDE_CODE_ENABLE_TELEMETRY`는 관련이 없습니다: [Monitoring](https://code.claude.com/docs/ko/monitoring-usage.md)에서 설명한 대로 자신의 수집기로 OpenTelemetry 내보내기를 활성화하며, Anthropic의 분석을 제어하지 않습니다.141`CLAUDE_CODE_ENABLE_TELEMETRY`는 관련이 없습니다: [Monitoring](https://code.claude.com/docs/ko/monitoring-usage.md)에서 설명한 대로 자신의 수집기로 OpenTelemetry 내보내기를 활성화하며, Anthropic의 분석을 제어하지 않습니다.

141 142 

108 108 

109실행 중인 세션에서 `/status`는 가져오기 실패 후 동일한 줄을 표시하며, 타사 공급자 변수 또는 사용자의 셸에서 내보낸 사용자 정의 `ANTHROPIC_BASE_URL`과 같은 일부 건너뛴 가져오기 원인의 경우입니다.109실행 중인 세션에서 `/status`는 가져오기 실패 후 동일한 줄을 표시하며, 타사 공급자 변수 또는 사용자의 셸에서 내보낸 사용자 정의 `ANTHROPIC_BASE_URL`과 같은 일부 건너뛴 가져오기 원인의 경우입니다.

110 110 

111### 그룹별로 다른 설정 지정

112 

113Enterprise 플랜에서는 조직 전체에 하나의 구성을 적용하는 대신 구성원 그룹마다 고유한 구성을 지정할 수 있습니다. 조직에 [HIPAA가 활성화되어](https://code.claude.com/docs/ko/hipaa-setup.md) 있으면 그룹 구성은 아직 사용할 수 없습니다. 각 그룹은 SCIM을 통해 ID 공급자에서 동기화된 그룹이든 관리 콘솔에서 관리하는 사용자 지정 그룹이든 이미 존재해야 합니다.

114 

115각 구성원은 최대 하나의 구성을 받으며, 모든 기기에서 동일한 구성이 적용됩니다:

116 

117* **구성이 있는 그룹의 구성원**: 해당 구성원이 속한 그룹 중 가장 높은 순위의 구성

118* **그 외 모든 사람**(구성이 있는 유일한 그룹이 삭제된 구성원 포함): 포괄 구성을 설정한 경우 해당 포괄 구성

119 

120구성은 서로 병합되지 않으며 조직 전체 구성과도 병합되지 않으므로, 각 구성에는 해당 그룹에 적용하려는 모든 설정이 포함되어야 합니다. 모든 구성원에게 제한을 적용하려면 모든 그룹 구성과 포괄 구성에 해당 제한을 넣으십시오.

121 

122구성원은 다음 단계 중 마지막 단계까지 조직 전체 구성을 계속 받으므로, 먼저 모든 것을 설정하고 테스트할 수 있습니다:

123 

124**1. 각 그룹에 구성 추가**

125 

126[**조직 설정 > Claude Code > 관리형 설정**](https://claude.ai/admin-settings/claude-code)에서 **Add configuration**을 클릭하고 그룹을 선택한 다음 시작점을 선택합니다. 그룹에 대한 정책을 완화하려면 ID 공급자가 동기화하는 그룹을 선택하여 누구도 관리 콘솔에서 자신을 해당 그룹에 추가할 수 없도록 하십시오.

127 

128구성원이 현재 받는 설정을 유지하면서 일부 설정만 변경하려면 조직 전체 구성의 사본에서 시작하십시오. 구성을 편집하고 저장합니다.