SpyBara
Go Premium

Documentation 2026-06-30 23:02 UTC to 2026-07-01 21:01 UTC

11 files changed +39 −12. View all changes and history on the product overview
2026
Fri 3 02:02 Thu 2 23:59 Wed 1 21:01

advisor.md +2 −2

Details

85조언자는 주 모델 이상의 기능을 가져야 합니다. 각 주 모델에 대해 허용되는 조언자는 다음과 같습니다:85조언자는 주 모델 이상의 기능을 가져야 합니다. 각 주 모델에 대해 허용되는 조언자는 다음과 같습니다:

86 86 

87| 주 모델 | 허용되는 조언자 | 참고 |87| 주 모델 | 허용되는 조언자 | 참고 |

88| ----------------------------------------------- | ------------------------ | ------------------------------------- |88| ----------------------------------------------- | ------------------------ | ---------------------------------------------------------------------- |

89| Haiku 4.5 | Fable, Opus, Sonnet | Haiku는 조언자를 호출할 수 있지만 조언자로 작동할 수 없습니다 |89| Haiku 4.5 | Fable, Opus, Sonnet | Haiku는 조언자를 호출할 수 있지만 조언자로 작동할 수 없습니다 |

90| Sonnet 4.6 | Fable, Opus, Sonnet | |90| Sonnet 4.6 | Fable, Opus, Sonnet | |

91| Sonnet 5 | Fable, Opus, Sonnet 5 | Sonnet 4.6 조언자는 거부됩니다 |91| Sonnet 5 | Fable, Opus, Sonnet 5 | Sonnet 4.6 조언자는 거부됩니다 |

92| Opus 4.6 이상 | 주 모델의 버전 이상인 Fable, Opus | Opus 4.7 주 모델과 Opus 4.6 조언자는 거부됩니다 |92| Opus 4.6 이상 | 주 모델의 버전 이상인 Fable, Opus | Opus 4.7 주 모델과 Opus 4.6 조언자는 거부됩니다. Opus 4.6 주 모델은 Sonnet 5 조언자도 허용합니다 |

93| Fable 5 ({/* min-version: 2.1.170 */}v2.1.170+) | Fable | Opus 또는 Sonnet 조언자는 거부됩니다 |93| Fable 5 ({/* min-version: 2.1.170 */}v2.1.170+) | Fable | Opus 또는 Sonnet 조언자는 거부됩니다 |

94 94 

95Fable 5는 주 모델로 작동하든 조언자로 작동하든 Claude Code v2.1.170 이상과 Fable 5 액세스가 필요합니다.95Fable 5는 주 모델로 작동하든 조언자로 작동하든 Claude Code v2.1.170 이상과 Fable 5 액세스가 필요합니다.

Details

190`effort` 옵션은 Claude가 적용하는 추론의 양을 제어합니다. 낮은 노력 수준은 턴당 더 적은 토큰을 사용하고 비용을 줄입니다. 모든 모델이 노력 매개변수를 지원하는 것은 아닙니다. 어떤 모델이 지원하는지는 [노력](https://platform.claude.com/docs/en/build-with-claude/effort)을 참조하세요.190`effort` 옵션은 Claude가 적용하는 추론의 양을 제어합니다. 낮은 노력 수준은 턴당 더 적은 토큰을 사용하고 비용을 줄입니다. 모든 모델이 노력 매개변수를 지원하는 것은 아닙니다. 어떤 모델이 지원하는지는 [노력](https://platform.claude.com/docs/en/build-with-claude/effort)을 참조하세요.

191 191 

192| 수준 | 동작 | 적합한 경우 |192| 수준 | 동작 | 적합한 경우 |

193| :--------- | :----------- | :------------------------------------- |193| :--------- | :----------- | :----------------------------------------------- |

194| `"low"` | 최소 추론, 빠른 응답 | 파일 조회, 디렉토리 나열 |194| `"low"` | 최소 추론, 빠른 응답 | 파일 조회, 디렉토리 나열 |

195| `"medium"` | 균형 잡힌 추론 | 일상적인 편집, 표준 작업 |195| `"medium"` | 균형 잡힌 추론 | 일상적인 편집, 표준 작업 |

196| `"high"` | 철저한 분석 | 리팩토링, 디버깅 |196| `"high"` | 철저한 분석 | 리팩토링, 디버깅 |

197| `"xhigh"` | 확장된 추론 깊이 | 코딩 및 에이전트 작업; Fable 5 Opus 4.7+에서 권장 |197| `"xhigh"` | 확장된 추론 깊이 | 코딩 및 에이전트 작업; Fable 5, Opus 4.7+ 및 Sonnet 5에서 권장 |

198| `"max"` | 최대 추론 깊이 | 깊은 분석이 필요한 다단계 문제 |198| `"max"` | 최대 추론 깊이 | 깊은 분석이 필요한 다단계 문제 |

199 199 

200`effort`를 설정하지 않으면 두 SDK 모두 매개변수를 설정하지 않은 상태로 두고 모델의 기본 동작으로 미룹니다.200`effort`를 설정하지 않으면 두 SDK 모두 매개변수를 설정하지 않은 상태로 두고 모델의 기본 동작으로 미룹니다.

Details

3138```typescript theme={null}3138```typescript theme={null}

3139type ModelInfo = {3139type ModelInfo = {

3140 value: string;3140 value: string;

3141 resolvedModel?: string;

3141 displayName: string;3142 displayName: string;

3142 description: string;3143 description: string;

3143 supportsEffort?: boolean;3144 supportsEffort?: boolean;

3144 supportedEffortLevels?: ("low" | "medium" | "high" | "xhigh" | "max")[];3145 supportedEffortLevels?: ("low" | "medium" | "high" | "xhigh" | "max")[];

3145 supportsAdaptiveThinking?: boolean;3146 supportsAdaptiveThinking?: boolean;

3146 supportsFastMode?: boolean;3147 supportsFastMode?: boolean;

3148 supportsAutoMode?: boolean;

3147};3149};

3148```3150```

3149 3151 

3152| 필드 | 타입 | 설명 |

3153| :------------------------- | :----------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

3154| `value` | `string` | API 호출에서 전달할 모델 식별자 |

3155| `resolvedModel` | `string \| undefined` | 이 항목의 `value`가 확인되는 정규 와이어 모델 ID입니다. `sonnet`과 같은 별칭 항목은 `claude-sonnet-5`와 같은 명시적 모델 ID로 확인되므로, 호스트는 저장된 명시적 모델 ID를 이 별칭 항목이 포함하는 것과 일치시킬 수 있습니다. {/* min-version: 2.1.197 */}Claude Code v2.1.197 이상이 필요합니다. |

3156| `displayName` | `string` | 사람이 읽을 수 있는 표시 이름 |

3157| `description` | `string` | 모델의 기능에 대한 설명 |

3158| `supportsEffort` | `boolean \| undefined` | 이 모델이 노력 수준을 지원하는지 여부 |

3159| `supportedEffortLevels` | `("low" \| "medium" \| "high" \| "xhigh" \| "max")[] \| undefined` | 이 모델이 허용하는 노력 수준 |

3160| `supportsAdaptiveThinking` | `boolean \| undefined` | 이 모델이 Claude가 언제 그리고 얼마나 생각할지 결정하는 적응형 사고를 지원하는지 여부 |

3161| `supportsFastMode` | `boolean \| undefined` | 이 모델이 빠른 모드를 지원하는지 여부 |

3162| `supportsAutoMode` | `boolean \| undefined` | 이 모델이 자동 모드를 지원하는지 여부 |

3163 

3150<h3 id="agentinfo">3164<h3 id="agentinfo">

3151 `AgentInfo`3165 `AgentInfo`

3152</h3>3166</h3>

agent-teams.md +2 −0

Details

284 284 

285팀원들은 리더의 권한 설정으로 시작합니다. 리더가 `--dangerously-skip-permissions`로 실행되면, 모든 팀원도 그렇게 합니다. 생성 후, 개별 팀원 모드를 변경할 수 있지만, 생성 시 팀원별 모드를 설정할 수 없습니다.285팀원들은 리더의 권한 설정으로 시작합니다. 리더가 `--dangerously-skip-permissions`로 실행되면, 모든 팀원도 그렇게 합니다. 생성 후, 개별 팀원 모드를 변경할 수 있지만, 생성 시 팀원별 모드를 설정할 수 없습니다.

286 286 

287한 에이전트가 `SendMessage`를 통해 다른 에이전트에게 메시지를 보낼 때, 수신 에이전트는 사용자가 아닌 다른 Claude 세션에서 온 것으로 알려집니다. 팀원은 권한 프롬프트를 승인하거나 사용자를 대신하여 동의를 제공할 수 없으며, 작업이 거부된 팀원은 이를 다른 팀원에게 전달하여 확인을 우회할 수 없습니다. [자동 모드](/ko/permission-modes#eliminate-prompts-with-auto-mode)에서, 분류기는 다른 에이전트에서 전달된 승인 주장을 사용자로부터의 확인이 아닌 신뢰할 수 없는 입력으로 취급합니다. 팀원 권한 프롬프트는 리더 세션으로 버블업되므로, 거기서 직접 승인합니다.

288 

287<h3 id="context-and-communication">289<h3 id="context-and-communication">

288 컨텍스트 및 통신290 컨텍스트 및 통신

289</h3>291</h3>

agent-view.md +4 −4

Details

274프롬프트의 일부를 접두사로 붙이거나 언급하여 세션이 시작되는 방식을 제어합니다:274프롬프트의 일부를 접두사로 붙이거나 언급하여 세션이 시작되는 방식을 제어합니다:

275 275 

276| 입력 | 효과 |276| 입력 | 효과 |

277| :------------------------ | :----------------------------------------------------------------------------------------- |277| :------------------------ | :------------------------------------------------------------------------------------------------- |

278| `<agent-name> <prompt>` | 첫 번째 단어가 사용자 정의 [서브에이전트](/ko/sub-agents) 이름과 일치하면 해당 서브에이전트가 프론트매터의 구성으로 세션의 주 에이전트로 실행됩니다 |278| `<agent-name> <prompt>` | 첫 번째 단어가 사용자 정의 [서브에이전트](/ko/sub-agents) 이름과 일치하면 해당 서브에이전트가 프론트매터의 구성으로 세션의 주 에이전트로 실행됩니다 |

279| `@<agent-name>` | 프롬프트의 어디든지 사용자 정의 서브에이전트를 언급하여 주 에이전트로 실행합니다 |279| `@<agent-name>` | 프롬프트의 어디든지 사용자 정의 서브에이전트를 언급하여 주 에이전트로 실행합니다 |

280| `@<repo>` | 에이전트 뷰를 연 디렉토리 아래의 저장소를 언급하여 세션을 거기서 실행합니다 |280| `@<repo>` | 저장소를 언급하여 세션을 거기서 실행합니다. 어떤 저장소가 나열되는지는 [특정 디렉토리로 디스패치](#dispatch-to-a-specific-directory)를 참조하십시오 |

281| `/<command>` | [스킬](/ko/skills) 및 [명령](/ko/commands)을 프롬프트로 디스패치하도록 제안합니다 |281| `/<command>` | [스킬](/ko/skills) 및 [명령](/ko/commands)을 프롬프트로 디스패치하도록 제안합니다 |

282| `! <command>` | Claude 세션을 시작하는 대신 백그라운드 작업으로 셸 명령을 실행합니다. 작업은 연결하고, 감시하고, 분리할 수 있는 행으로 나타납니다 |282| `! <command>` | Claude 세션을 시작하는 대신 백그라운드 작업으로 셸 명령을 실행합니다. 작업은 연결하고, 감시하고, 분리할 수 있는 행으로 나타납니다 |

283| `#<number>` 또는 풀 리퀘스트 URL | 세션이 이미 해당 PR에서 작업 중이면 디스패치 대신 선택합니다 |283| `#<number>` 또는 풀 리퀘스트 URL | 세션이 이미 해당 PR에서 작업 중이면 디스패치 대신 선택합니다 |


293 특정 디렉토리로 디스패치293 특정 디렉토리로 디스패치

294</h4>294</h4>

295 295 

296새로운 세션은 에이전트 뷰를 연 디렉토리에서 실행됩니다. 다른 디렉토리를 대상으로 하려면:296새로운 세션은 에이전트 뷰를 연 디렉토리에서 실행됩니다. 다른 디렉토리를 대상으로 하려면 다음 중 하나를 사용합니다:

297 297 

298* 해당 디렉토리에서 `claude agents`를 엽니다.298* 해당 디렉토리에서 `claude agents`를 엽니다.

299* 여러 저장소를 보유한 상위 디렉토리에서 `claude agents`를 열고 프롬프트에서 `@<repo>`로 하나를 언급하여 세션을 거기서 실행합니다.299* 상위 디렉토리에서 `claude agents`를 열고 프롬프트에서 `@<repo>`로 하위 저장소를 언급하여 세션을 거기서 실행합니다. `@`를 입력하면 실행 디렉토리 아래 한 수준의 git 저장소와 이미 세션이 있는 모든 디렉토리가 나열됩니다. 이름에 공백이 포함된 디렉토리는 나열되지 않습니다.

300* 셸에서 디렉토리로 `cd`하고 `claude --bg "<prompt>"`를 실행합니다.300* 셸에서 디렉토리로 `cd`하고 `claude --bg "<prompt>"`를 실행합니다.

301 301 

302에이전트 뷰가 디렉토리별로 그룹화되면 강조된 행의 디렉토리가 디스패치 대상이 되므로 그룹으로 스크롤하고 경로를 다시 입력하지 않고 디스패치할 수 있습니다.302에이전트 뷰가 디렉토리별로 그룹화되면 강조된 행의 디렉토리가 디스패치 대상이 되므로 그룹으로 스크롤하고 경로를 다시 입력하지 않고 디스패치할 수 있습니다.

env-vars.md +2 −1

Details

268| `CLAUDE_CODE_SCROLL_SPEED` | [전체 화면 렌더링](/ko/fullscreen#mouse-wheel-scrolling)에서 마우스 휠 스크롤 배수를 설정합니다. 1부터 20까지의 값을 허용합니다. 그리고 `0.5`와 같은 1 미만의 분수 값을 허용하여 터미널의 기본 스크롤 경로에서 가속 트랙패드 및 휠 스크롤을 느리게 합니다. 터미널이 증폭 없이 노치당 하나의 휠 이벤트를 보내는 경우 `vim`과 일치하도록 `3`으로 설정합니다. JetBrains IDE 터미널에서는 무시되며, Claude Code는 자체 스크롤 처리를 사용합니다. |268| `CLAUDE_CODE_SCROLL_SPEED` | [전체 화면 렌더링](/ko/fullscreen#mouse-wheel-scrolling)에서 마우스 휠 스크롤 배수를 설정합니다. 1부터 20까지의 값을 허용합니다. 그리고 `0.5`와 같은 1 미만의 분수 값을 허용하여 터미널의 기본 스크롤 경로에서 가속 트랙패드 및 휠 스크롤을 느리게 합니다. 터미널이 증폭 없이 노치당 하나의 휠 이벤트를 보내는 경우 `vim`과 일치하도록 `3`으로 설정합니다. JetBrains IDE 터미널에서는 무시되며, Claude Code는 자체 스크롤 처리를 사용합니다. |

269| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | [SessionEnd](/ko/hooks#sessionend) 훅의 시간 예산(밀리초)을 재정의합니다. 세션 종료, `/clear`, 대화형 `/resume`을 통한 세션 전환에 적용됩니다. 기본적으로 예산은 1.5초이며, 설정 파일에서 구성된 가장 높은 훅별 `timeout`으로 자동으로 올라가며, 최대 60초입니다. 플러그인 제공 훅의 타임아웃은 예산을 올리지 않습니다. |269| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | [SessionEnd](/ko/hooks#sessionend) 훅의 시간 예산(밀리초)을 재정의합니다. 세션 종료, `/clear`, 대화형 `/resume`을 통한 세션 전환에 적용됩니다. 기본적으로 예산은 1.5초이며, 설정 파일에서 구성된 가장 높은 훅별 `timeout`으로 자동으로 올라가며, 최대 60초입니다. 플러그인 제공 훅의 타임아웃은 예산을 올리지 않습니다. |

270| `CLAUDE_CODE_SESSION_ID` | Bash 및 PowerShell 도구 subprocess에서 현재 세션 ID로 자동으로 설정됩니다. [훅](/ko/hooks) 명령 subprocess 및 stdio [MCP 서버](/ko/mcp) subprocess에서도 설정됩니다. [훅](/ko/hooks)에 전달된 `session_id` 필드와 일치합니다. `/clear`에서 업데이트됩니다. MCP 서버 subprocess는 생성될 때 ID를 유지하며, `--resume <session-id>`에서 재개된 ID를 받습니다. `--continue` 또는 명시적 ID 없이 `--resume`에서 초기 시작 ID를 받을 수 있습니다. 스크립트 및 외부 도구를 Claude Code 세션과 연관시키는 데 사용합니다. |270| `CLAUDE_CODE_SESSION_ID` | Bash 및 PowerShell 도구 subprocess에서 현재 세션 ID로 자동으로 설정됩니다. [훅](/ko/hooks) 명령 subprocess 및 stdio [MCP 서버](/ko/mcp) subprocess에서도 설정됩니다. [훅](/ko/hooks)에 전달된 `session_id` 필드와 일치합니다. `/clear`에서 업데이트됩니다. MCP 서버 subprocess는 생성될 때 ID를 유지하며, `--resume <session-id>`에서 재개된 ID를 받습니다. `--continue` 또는 명시적 ID 없이 `--resume`에서 초기 시작 ID를 받을 수 있습니다. 스크립트 및 외부 도구를 Claude Code 세션과 연관시키는 데 사용합니다. |

271| `CLAUDE_CODE_SHELL` | 자동 감지를 재정의합니다. 로그인 셸이 선호하는 작업 셸과 다를 유용합니다(예: `bash` vs `zsh`). |271| `CLAUDE_CODE_SHELL` | Claude Code가 Bash 도구 명령을 실행하는 사용하는 셸을 설정합니다. `bash` 또는 `zsh` 바이너리의 경로를 허용합니다(예: `/opt/homebrew/bin/bash`). `fish`와 같은 다른 셸은 지원되지 않습니다. 값이 작동하는 `bash` 또는 `zsh` 경로가 아니면 Claude Code는 이를 무시하고 자동 감지로 돌아갑니다. 자동 감지는 `bash` 또는 `zsh`를 가리킬 때 `$SHELL`을 사용하고, 그렇지 않으면 PATH 및 표준 설치 위치에서 찾은 첫 번째 작동 `zsh`를 선택한 다음 `bash`를 선택합니다. |

272| `CLAUDE_CODE_SHELL_PREFIX` | Claude Code가 생성하는 모든 셸 명령을 래핑할 명령 접두사: Bash 도구 호출, [훅](/ko/hooks) 명령, [상태 줄](/ko/statusline) 명령, stdio [MCP 서버](/ko/mcp) 시작 명령. PowerShell 훅 및 exec 형식 훅은 접두사 없이 실행됩니다. 로깅 또는 감사에 유용합니다. 예: `/path/to/logger.sh`와 같은 실행 파일 경로를 설정하면 각 명령을 `/path/to/logger.sh '<command>'`로 실행합니다. 래퍼는 명령줄을 `$1`의 단일 셸 인용 인수로 받으므로 래퍼는 `$1`을 셸로 다시 평가해야 합니다(예: `exec bash -c "$1"`). `$1`을 실행 파일 경로로 취급하면 `npx -y <package>`와 같은 인수를 전달하는 stdio MCP 서버가 손상됩니다. Bash 도구 호출의 경우 `$1`에는 Claude Code가 조립하는 전체 셸 호출이 포함되며, Claude가 실행한 명령만이 아닙니다. |272| `CLAUDE_CODE_SHELL_PREFIX` | Claude Code가 생성하는 모든 셸 명령을 래핑할 명령 접두사: Bash 도구 호출, [훅](/ko/hooks) 명령, [상태 줄](/ko/statusline) 명령, stdio [MCP 서버](/ko/mcp) 시작 명령. PowerShell 훅 및 exec 형식 훅은 접두사 없이 실행됩니다. 로깅 또는 감사에 유용합니다. 예: `/path/to/logger.sh`와 같은 실행 파일 경로를 설정하면 각 명령을 `/path/to/logger.sh '<command>'`로 실행합니다. 래퍼는 명령줄을 `$1`의 단일 셸 인용 인수로 받으므로 래퍼는 `$1`을 셸로 다시 평가해야 합니다(예: `exec bash -c "$1"`). `$1`을 실행 파일 경로로 취급하면 `npx -y <package>`와 같은 인수를 전달하는 stdio MCP 서버가 손상됩니다. Bash 도구 호출의 경우 `$1`에는 Claude Code가 조립하는 전체 셸 호출이 포함되며, Claude가 실행한 명령만이 아닙니다. |

273| `CLAUDE_CODE_SIMPLE` | 최소 시스템 프롬프트 및 Bash, 파일 읽기, 파일 편집 도구만으로 실행하려면 `1`로 설정합니다. `--mcp-config`의 MCP 도구는 계속 사용 가능합니다. 훅, skill, 플러그인, MCP 서버, 자동 메모리, CLAUDE.md의 자동 검색을 비활성화합니다. OAuth 토큰 및 키체인 자격 증명은 읽지 않으므로 Anthropic 인증은 `ANTHROPIC_API_KEY` 또는 `--settings`의 `apiKeyHelper`에서 와야 합니다. [`--bare`](/ko/headless#start-faster-with-bare-mode) 전달과 동일합니다. |273| `CLAUDE_CODE_SIMPLE` | 최소 시스템 프롬프트 및 Bash, 파일 읽기, 파일 편집 도구만으로 실행하려면 `1`로 설정합니다. `--mcp-config`의 MCP 도구는 계속 사용 가능합니다. 훅, skill, 플러그인, MCP 서버, 자동 메모리, CLAUDE.md의 자동 검색을 비활성화합니다. OAuth 토큰 및 키체인 자격 증명은 읽지 않으므로 Anthropic 인증은 `ANTHROPIC_API_KEY` 또는 `--settings`의 `apiKeyHelper`에서 와야 합니다. [`--bare`](/ko/headless#start-faster-with-bare-mode) 전달과 동일합니다. |

274| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | 모든 모델에서 더 짧은 시스템 프롬프트 및 축소된 도구 설명을 사용하려면 `1`로 설정합니다. `0`, `false`, `no`, 또는 `off`로 설정하여 실험 또는 서버 구성이 그렇지 않으면 활성화할 때에도 옵트아웃합니다. 전체 도구 세트, 훅, MCP 서버, CLAUDE.md 검색은 계속 활성화됩니다. |274| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | 모든 모델에서 더 짧은 시스템 프롬프트 및 축소된 도구 설명을 사용하려면 `1`로 설정합니다. `0`, `false`, `no`, 또는 `off`로 설정하여 실험 또는 서버 구성이 그렇지 않으면 활성화할 때에도 옵트아웃합니다. 전체 도구 세트, 훅, MCP 서버, CLAUDE.md 검색은 계속 활성화됩니다. |


378| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Vertex AI 사용 시 Claude Sonnet 4.6의 리전을 재정의합니다. |378| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Vertex AI 사용 시 Claude Sonnet 4.6의 리전을 재정의합니다. |

379| `VERTEX_REGION_CLAUDE_4_7_OPUS` | {/* min-version: 2.1.111 */}Vertex AI 사용 시 Claude Opus 4.7의 리전을 재정의합니다. v2.1.111에서 추가됨. |379| `VERTEX_REGION_CLAUDE_4_7_OPUS` | {/* min-version: 2.1.111 */}Vertex AI 사용 시 Claude Opus 4.7의 리전을 재정의합니다. v2.1.111에서 추가됨. |

380| `VERTEX_REGION_CLAUDE_4_8_OPUS` | {/* min-version: 2.1.154 */}Vertex AI 사용 시 Claude Opus 4.8의 리전을 재정의합니다. v2.1.154에서 추가됨. |380| `VERTEX_REGION_CLAUDE_4_8_OPUS` | {/* min-version: 2.1.154 */}Vertex AI 사용 시 Claude Opus 4.8의 리전을 재정의합니다. v2.1.154에서 추가됨. |

381| `VERTEX_REGION_CLAUDE_5_SONNET` | {/* min-version: 2.1.197 */}Vertex AI 사용 시 Claude Sonnet 5의 리전을 재정의합니다. v2.1.197에서 추가됨. |

381| `VERTEX_REGION_CLAUDE_FABLE_5` | {/* min-version: 2.1.170 */}Vertex AI 사용 시 Claude Fable 5의 리전을 재정의합니다. v2.1.170에서 추가됨. |382| `VERTEX_REGION_CLAUDE_FABLE_5` | {/* min-version: 2.1.170 */}Vertex AI 사용 시 Claude Fable 5의 리전을 재정의합니다. v2.1.170에서 추가됨. |

382| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Vertex AI 사용 시 Claude Haiku 4.5의 리전을 재정의합니다. |383| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Vertex AI 사용 시 Claude Haiku 4.5의 리전을 재정의합니다. |

383 384 

Details

195 195 

196선택기는 개발자가 Claude Code에서 `/model`을 실행할 때 열리는 대화형 모델 목록입니다. 각 검색된 항목은 "게이트웨이에서" 레이블이 지정되고 제공된 경우 `display_name`을 사용합니다. [`availableModels` 관리되는 설정](/ko/settings#available-settings)은 검색이 추가할 수 있는 것을 제한합니다.196선택기는 개발자가 Claude Code에서 `/model`을 실행할 때 열리는 대화형 모델 목록입니다. 각 검색된 항목은 "게이트웨이에서" 레이블이 지정되고 제공된 경우 `display_name`을 사용합니다. [`availableModels` 관리되는 설정](/ko/settings#available-settings)은 검색이 추가할 수 있는 것을 제한합니다.

197 197 

198검색된 ID는 선택기에 이미 있는 행과 정확히 일치하거나 검색된 ID와 기존 ID가 모두 [Fable](/ko/model-config#work-with-fable-5)로 해결될 때만 건너뜁니다. 기본 제공 행은 `sonnet`과 같은 별칭으로 키가 지정되므로, `claude-sonnet-4-6` 같은 검색된 ID는 기본 제공 항목 옆에 자체 "게이트웨이에서" 행을 추가합니다.198검색된 ID는 선택기에 이미 있는 행과 정확히 일치하거나 검색된 ID와 기존 ID가 모두 [Fable](/ko/model-config#work-with-fable-5)로 해결될 때만 건너뜁니다. {/* min-version: 2.1.197 */}Claude Code v2.1.197부터, 검색된 명시적 ID는 둘 다 동일한 모델로 해결될 때 기본 제공 항목으로 접혀집니다. 기본 제공 행은 `sonnet`과 같은 별칭으로 키가 지정되므로, 별칭이 현재 해결되는 모델의 명시적 ID (예: `claude-sonnet-5`)는 `sonnet` 행으로 축소되는 반면, 별칭이 해결되지 않는 ID (예: `claude-sonnet-4-6`)는 기본 제공 항목 옆에 자체 "게이트웨이에서" 행을 추가합니다.

199 199 

200결과는 `~/.claude/cache/gateway-models.json` 또는 Windows의 `%USERPROFILE%\.claude\cache\gateway-models.json`으로 캐시되고 각 시작 시 새로 고쳐집니다. 요청이 실패하거나 게이트웨이가 `/v1/models`를 구현하지 않으면, 선택기는 이전 시작의 캐시된 목록 또는 기본 제공 모델 목록으로 돌아갑니다. 게이트웨이가 검색 필터와 일치하지 않는 별칭 아래에서 Claude 모델을 제공하면, 개발자는 [모델 구성](/ko/model-config) 변수를 사용하여 해당 별칭을 수동으로 추가할 수 있습니다.200결과는 `~/.claude/cache/gateway-models.json` 또는 Windows의 `%USERPROFILE%\.claude\cache\gateway-models.json`으로 캐시되고 각 시작 시 새로 고쳐집니다. 요청이 실패하거나 게이트웨이가 `/v1/models`를 구현하지 않으면, 선택기는 이전 시작의 캐시된 목록 또는 기본 제공 모델 목록으로 돌아갑니다. 게이트웨이가 검색 필터와 일치하지 않는 별칭 아래에서 Claude 모델을 제공하면, 개발자는 [모델 구성](/ko/model-config) 변수를 사용하여 해당 별칭을 수동으로 추가할 수 있습니다.

201 201 

Details

628* `event.sequence`: 세션 내 이벤트 순서 지정을 위한 단조 증가 카운터628* `event.sequence`: 세션 내 이벤트 순서 지정을 위한 단조 증가 카운터

629* `response_length`: 응답 텍스트의 길이 (문자)629* `response_length`: 응답 텍스트의 길이 (문자)

630* `response`: 응답 텍스트 (60KB에서 잘림). 기본적으로 `<REDACTED>`로 수정됨. `OTEL_LOG_ASSISTANT_RESPONSES=1`로 설정하여 포함. `OTEL_LOG_ASSISTANT_RESPONSES`가 설정되지 않으면 `OTEL_LOG_USER_PROMPTS`가 대신 제어하므로 프롬프트 로깅이 켜져 있는 동안 응답을 수정된 상태로 유지하려면 `OTEL_LOG_ASSISTANT_RESPONSES=0`으로 설정합니다630* `response`: 응답 텍스트 (60KB에서 잘림). 기본적으로 `<REDACTED>`로 수정됨. `OTEL_LOG_ASSISTANT_RESPONSES=1`로 설정하여 포함. `OTEL_LOG_ASSISTANT_RESPONSES`가 설정되지 않으면 `OTEL_LOG_USER_PROMPTS`가 대신 제어하므로 프롬프트 로깅이 켜져 있는 동안 응답을 수정된 상태로 유지하려면 `OTEL_LOG_ASSISTANT_RESPONSES=0`으로 설정합니다

631* `model`: 모델 식별자 (예: "claude-sonnet-4-6")631* `model`: 모델 식별자 (예: "claude-sonnet-5")

632* `request_id`: 응답의 `request-id` 헤더의 Anthropic API 요청 ID. API가 반환할 때만 표시됩니다632* `request_id`: 응답의 `request-id` 헤더의 Anthropic API 요청 ID. API가 반환할 때만 표시됩니다

633* `query_source`: 요청을 발급한 하위 시스템, 예: `"repl_main_thread"`, `"compact"` 또는 하위 에이전트 이름633* `query_source`: 요청을 발급한 하위 시스템, 예: `"repl_main_thread"`, `"compact"` 또는 하위 에이전트 이름

634 634 

skills.md +2 −0

Details

129 129 

130`/deploy`를 입력하면 프로젝트 루트 skill이 실행됩니다. 중첩된 변형을 명시적으로 실행하려면 한정된 이름 `/apps/web:deploy`를 입력합니다.130`/deploy`를 입력하면 프로젝트 루트 skill이 실행됩니다. 중첩된 변형을 명시적으로 실행하려면 한정된 이름 `/apps/web:deploy`를 입력합니다.

131 131 

132`<skill-name>` 항목이 enterprise, personal 또는 project 위치에 있을 수 있으며, 디스크의 다른 곳에 있는 디렉토리로의 symlink일 수 있습니다. Claude Code는 symlink를 따라가고 대상 디렉토리에서 `SKILL.md`를 읽으며, 같은 대상에 둘 이상의 위치에서 도달할 수 있으면 Claude Code는 skill을 한 번만 로드합니다. Plugin skills는 symlinks를 다르게 처리합니다. [마켓플레이스 내에서 symlinks를 사용하여 파일 공유](/ko/plugins-reference#share-files-within-a-marketplace-with-symlinks)를 참조하세요.

133 

132<Note>134<Note>

133 `.claude-plugin/plugin.json`을 skill 폴더에 추가하면 `<name>@skills-dir`이라는 [플러그인](/ko/plugins-reference#skills-directory-plugins)으로 로드되므로, agents, hooks 및 MCP 서버를 번들로 제공할 수 있습니다. 프로젝트의 `.claude/skills/`에서는 먼저 작업 공간 신뢰 대화를 수락해야 합니다.135 `.claude-plugin/plugin.json`을 skill 폴더에 추가하면 `<name>@skills-dir`이라는 [플러그인](/ko/plugins-reference#skills-directory-plugins)으로 로드되므로, agents, hooks 및 MCP 서버를 번들로 제공할 수 있습니다. 프로젝트의 `.claude/skills/`에서는 먼저 작업 공간 신뢰 대화를 수락해야 합니다.

134</Note>136</Note>

Details

26| `irm is not recognized` 또는 `&& is not valid` | [셸에 맞는 명령 사용](#wrong-install-command-on-windows) |26| `irm is not recognized` 또는 `&& is not valid` | [셸에 맞는 명령 사용](#wrong-install-command-on-windows) |

27| `Cask 'claude-code' is unavailable: No Cask with this name exists` | [Homebrew 업데이트](#homebrew-cask-unavailable-or-outdated) |27| `Cask 'claude-code' is unavailable: No Cask with this name exists` | [Homebrew 업데이트](#homebrew-cask-unavailable-or-outdated) |

28| `'bash' is not recognized as the name of a cmdlet` | [Windows 설치 프로그램 명령 사용](#wrong-install-command-on-windows) |28| `'bash' is not recognized as the name of a cmdlet` | [Windows 설치 프로그램 명령 사용](#wrong-install-command-on-windows) |

29| `A parameter cannot be found that matches parameter name 'fsSL'` | [Windows 설치 프로그램 명령 사용](#wrong-install-command-on-windows) |

29| `Claude Code on Windows requires either Git for Windows (for bash) or PowerShell` | [셸 설치](#claude-code-on-windows-requires-either-git-for-windows-for-bash-or-powershell) |30| `Claude Code on Windows requires either Git for Windows (for bash) or PowerShell` | [셸 설치](#claude-code-on-windows-requires-either-git-for-windows-for-bash-or-powershell) |

30| `Claude Code does not support 32-bit Windows` | [Windows PowerShell 열기, x86 항목 아님](#claude-code-does-not-support-32-bit-windows) |31| `Claude Code does not support 32-bit Windows` | [Windows PowerShell 열기, x86 항목 아님](#claude-code-does-not-support-32-bit-windows) |

31| `The process cannot access the file ... because it is being used by another process` | [다운로드 폴더 지우기 및 다시 시도](#the-process-cannot-access-the-file-during-windows-install) |32| `The process cannot access the file ... because it is being used by another process` | [다운로드 폴더 지우기 및 다시 시도](#the-process-cannot-access-the-file-during-windows-install) |


489 Windows에서 잘못된 설치 명령490 Windows에서 잘못된 설치 명령

490</h3>491</h3>

491 492 

492`'irm' is not recognized`, `The token '&&' is not valid` 또는 `'bash' is not recognized as the name of a cmdlet`이 표시되면 다른 셸 또는 운영 체제의 설치 명령을 복사했습니다.493`'irm' is not recognized`, `The token '&&' is not valid`, `A parameter cannot be found that matches parameter name 'fsSL'` 또는 `'bash' is not recognized as the name of a cmdlet`이 표시되면 다른 셸 또는 운영 체제의 설치 명령을 복사했습니다.

493 494 

494* **`irm` 인식 안 됨**: CMD에 있고 PowerShell이 아닙니다. 두 가지 옵션이 있습니다:495* **`irm` 인식 안 됨**: CMD에 있고 PowerShell이 아닙니다. 두 가지 옵션이 있습니다:

495 496 


510 irm https://claude.ai/install.ps1 | iex511 irm https://claude.ai/install.ps1 | iex

511 ```512 ```

512 513 

514* **`A parameter cannot be found that matches parameter name 'fsSL'`**: Windows PowerShell에서 macOS/Linux `curl -fsSL ... | bash` 설치 프로그램을 실행했습니다. 여기서 `curl`은 `Invoke-WebRequest`의 별칭이며 `-fsSL` 플래그를 거부합니다. 대신 PowerShell 설치 프로그램을 사용하세요:

515 ```powershell theme={null}

516 irm https://claude.ai/install.ps1 | iex

517 ```

518 

513* **`bash` 인식 안 됨**: Windows에서 macOS/Linux 설치 프로그램을 실행했습니다. 대신 PowerShell 설치 프로그램을 사용하세요:519* **`bash` 인식 안 됨**: Windows에서 macOS/Linux 설치 프로그램을 실행했습니다. 대신 PowerShell 설치 프로그램을 사용하세요:

514 ```powershell theme={null}520 ```powershell theme={null}

515 irm https://claude.ai/install.ps1 | iex521 irm https://claude.ai/install.ps1 | iex

vs-code.md +2 −0

Details

5982. "Claude Code" 검색5982. "Claude Code" 검색

5993. **제거** 클릭5993. **제거** 클릭

600 600 

601VS Code 통합 터미널에서 `claude`를 실행하면 확장 프로그램이 자동으로 다시 설치됩니다. 확장 프로그램을 설치된 상태로 유지하지 않으려면 `/config`에서 **Auto-install IDE extension**을 끄거나 [`autoInstallIdeExtension`](/ko/settings#global-config-settings)을 `false`로 설정하십시오. [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/ko/env-vars) 환경 변수를 `1`로 설정할 수도 있습니다.

602 

601확장 프로그램 데이터를 제거하고 모든 설정을 재설정하려면 플랫폼에 해당하는 확장 프로그램의 저장소 디렉터리를 삭제하십시오.603확장 프로그램 데이터를 제거하고 모든 설정을 재설정하려면 플랫폼에 해당하는 확장 프로그램의 저장소 디렉터리를 삭제하십시오.

602 604 

603macOS에서:605macOS에서: