52| `Credit balance is too low` | [사용 한도](#credit-balance-is-too-low) |52| `Credit balance is too low` | [사용 한도](#credit-balance-is-too-low) |
53| `You've hit your monthly spend limit` / `You've hit your individual spend limit` / `You've hit your org's monthly spend limit` / `You've hit your channel's monthly spend limit` / `You've hit your team's shared budget` / `You've hit your individual usage limit` | [사용 한도](#youve-hit-your-monthly-spend-limit) |53| `You've hit your monthly spend limit` / `You've hit your individual spend limit` / `You've hit your org's monthly spend limit` / `You've hit your channel's monthly spend limit` / `You've hit your team's shared budget` / `You've hit your individual usage limit` | [사용 한도](#youve-hit-your-monthly-spend-limit) |
54| `Could not update your spend limit` | [사용 한도](#could-not-update-your-spend-limit) |54| `Could not update your spend limit` | [사용 한도](#could-not-update-your-spend-limit) |
55| `spend limit reached` / `spend limit unavailable` | [사용 한도](#spend-limit-reached) |55| `spend limit reached` / `spend limit unavailable` / `This request exceeds your group's budget` | [사용 한도](#spend-limit-reached) |
56| `Not logged in · Please run /login` | [인증](#not-logged-in) |56| `Not logged in · Please run /login` | [인증](#not-logged-in) |
57| `Couldn't save your login` | [인증](#couldnt-save-your-login) |57| `Couldn't save your login` | [인증](#couldnt-save-your-login) |
58| `Sign in again to take your previous account or API key off the config file.` | [인증](#sign-in-again-to-take-your-previous-account-or-api-key-off-the-config-file) |58| `Sign in again to take your previous account or API key off the config file.` | [인증](#sign-in-again-to-take-your-previous-account-or-api-key-off-the-config-file) |
336| `MCP server "<name>" connection closed before the tool call was answered` | [도구 오류](#connection-closed-before-the-tool-call-was-answered) |336| `MCP server "<name>" connection closed before the tool call was answered` | [도구 오류](#connection-closed-before-the-tool-call-was-answered) |
337| `MCP server "<name>" is disabled — re-enable it via /mcp to use its tools` | [도구 오류](#mcp-server-is-disabled) |337| `MCP server "<name>" is disabled — re-enable it via /mcp to use its tools` | [도구 오류](#mcp-server-is-disabled) |
338| `MCP server "<name>" tool "<tool>" timed out after <N>s. The server asked the user a question, and no answer came before the time limit.` | [도구 오류](#mcp-tool-call-timed-out-with-the-servers-question-unanswered) |338| `MCP server "<name>" tool "<tool>" timed out after <N>s. The server asked the user a question, and no answer came before the time limit.` | [도구 오류](#mcp-tool-call-timed-out-with-the-servers-question-unanswered) |
339| `Permission prompt tool returned an invalid result` | [도구 오류](#permission-prompt-tool-returned-an-invalid-result) |
339| `would be spawned with zero tools — refusing` | [도구 오류](#agent-would-be-spawned-with-zero-tools) |340| `would be spawned with zero tools — refusing` | [도구 오류](#agent-would-be-spawned-with-zero-tools) |
340| `File is covered by a Read deny rule in your permission settings` | [도구 오류](#file-is-covered-by-a-read-deny-rule) |341| `File is covered by a Read deny rule in your permission settings` | [도구 오류](#file-is-covered-by-a-read-deny-rule) |
341| `<path> is outside <dirs>; the permissions.blockWritesOutsideWorkingDirectories setting blocks writes outside the working directories` | [도구 오류](#setting-blocks-writes-outside-the-working-directories) |342| `<path> is outside <dirs>; the permissions.blockWritesOutsideWorkingDirectories setting blocks writes outside the working directories` | [도구 오류](#setting-blocks-writes-outside-the-working-directories) |
420| `The Claude Code program for this computer, the <build> build, could not be found` | [래퍼 및 IDE 오류](#the-claude-code-program-for-this-computer-could-not-be-found) |421| `The Claude Code program for this computer, the <build> build, could not be found` | [래퍼 및 IDE 오류](#the-claude-code-program-for-this-computer-could-not-be-found) |
421| `Restored the code, but skipped N files` | [되돌리기 경고 및 오류](#restored-the-code-but-skipped-files) |422| `Restored the code, but skipped N files` | [되돌리기 경고 및 오류](#restored-the-code-but-skipped-files) |
422| `No files were restored: N files failed (backup missing, or the file could not be updated)` | [되돌리기 경고 및 오류](#no-files-were-restored) |423| `No files were restored: N files failed (backup missing, or the file could not be updated)` | [되돌리기 경고 및 오류](#no-files-were-restored) |
424| `The file backups are still being copied. Nothing was changed. Try again in a moment.` | [`/rewind`](https://code.claude.com/docs/ko/checkpointing)에서 같은 지점을 다시 선택합니다. [`/branch`](https://code.claude.com/docs/ko/sessions#branch-a-session) 직후에 코드를 복원하면 Claude Code가 아직 파일 백업을 새 세션으로 복사하는 중일 수 있습니다. |
423| `Transcript writes are failing (...)` | [세션 저장 경고](#transcript-writes-are-failing) |425| `Transcript writes are failing (...)` | [세션 저장 경고](#transcript-writes-are-failing) |
424| `Transcript saving is off — CLAUDE_CODE_SKIP_PROMPT_HISTORY is set` | [세션 저장 경고](#transcript-saving-is-off-skip-prompt-history) |426| `Transcript saving is off — CLAUDE_CODE_SKIP_PROMPT_HISTORY is set` | [세션 저장 경고](#transcript-saving-is-off-skip-prompt-history) |
425| `Transcript saving is off — inherited CLAUDE_CODE_CHILD_SESSION marker` | [세션 저장 경고](#transcript-saving-is-off-child-session-marker) |427| `Transcript saving is off — inherited CLAUDE_CODE_CHILD_SESSION marker` | [세션 저장 경고](#transcript-saving-is-off-child-session-marker) |
431| `Not loaded: rename <path>, then restart — its name uses "<name>", a name reserved for the skills synced from your claude.ai account` | [구성 경고](#a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved) |433| `Not loaded: rename <path>, then restart — its name uses "<name>", a name reserved for the skills synced from your claude.ai account` | [구성 경고](#a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved) |
432| `N skill or command names refused: run with --debug to see which ([names]), rename, then restart` | [구성 경고](#skill-or-command-name-refused) |434| `N skill or command names refused: run with --debug to see which ([names]), rename, then restart` | [구성 경고](#skill-or-command-name-refused) |
433| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [구성 경고](#workspace-has-not-been-trusted) |435| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [구성 경고](#workspace-has-not-been-trusted) |
436| `Two Claude Code config files exist: this run uses <path>, not <path>` | [구성 경고](#two-claude-code-config-files-exist) |
434| `Make this change again later: <path> could not be updated, so it applies to this session only` | [구성 경고](#make-this-change-again-later) |437| `Make this change again later: <path> could not be updated, so it applies to this session only` | [구성 경고](#make-this-change-again-later) |
435| `is a network path, which cannot be added as a working directory` | [구성 경고](#working-directory-is-a-network-path) |438| `is a network path, which cannot be added as a working directory` | [구성 경고](#working-directory-is-a-network-path) |
436| `Remote managed settings failed to load (<cause>)` | [구성 경고](#remote-managed-settings-failed-to-load) |439| `Remote managed settings failed to load (<cause>)` | [구성 경고](#remote-managed-settings-failed-to-load) |
468| `CLAUDE_CODE_AUTO_COMPACT_WINDOW="<value>" isn't a usable size, so Claude Code ignores it` | [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`의 값 및 경고](https://code.claude.com/docs/ko/model-config#claude_code_auto_compact_window-values) |471| `CLAUDE_CODE_AUTO_COMPACT_WINDOW="<value>" isn't a usable size, so Claude Code ignores it` | [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`의 값 및 경고](https://code.claude.com/docs/ko/model-config#claude_code_auto_compact_window-values) |
469| `Model "<model>" isn't recognized · context assumed to be 200k tokens` | [게이트웨이 또는 사용자 지정 모델 ID의 윈도우 수정](https://code.claude.com/docs/ko/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id) |472| `Model "<model>" isn't recognized · context assumed to be 200k tokens` | [게이트웨이 또는 사용자 지정 모델 ID의 윈도우 수정](https://code.claude.com/docs/ko/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id) |
470| `Claude Code doesn't recognize the model "<model>", so it assumes a context window of 200k tokens` | [게이트웨이 또는 사용자 지정 모델 ID의 윈도우 수정](https://code.claude.com/docs/ko/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id) |473| `Claude Code doesn't recognize the model "<model>", so it assumes a context window of 200k tokens` | [게이트웨이 또는 사용자 지정 모델 ID의 윈도우 수정](https://code.claude.com/docs/ko/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id) |
474| `Model "<model>" isn't recognized · did you mean "<suggestion>"?` / `Claude Code doesn't recognize the model "<model>". Did you mean "<suggestion>"?` | [잘못 입력한 모델 이름 수정](https://code.claude.com/docs/ko/model-config.md#fix-a-mistyped-model-name) |
471| `[claude-code:unrecognized_model]` | [구성 경고](#unrecognized-model-id-on-a-request) |475| `[claude-code:unrecognized_model]` | [구성 경고](#unrecognized-model-id-on-a-request) |
472| `is ignored — managed settings set allowManagedReadPathsOnly` / `is ignored — managed settings set allowManagedDomainsOnly` | [구성 경고](#sandbox-allow-entries-are-ignored-under-a-managed-lock) |476| `is ignored — managed settings set allowManagedReadPathsOnly` / `is ignored — managed settings set allowManagedDomainsOnly` | [구성 경고](#sandbox-allow-entries-are-ignored-under-a-managed-lock) |
473| `Sandbox mask files left behind at write-deny paths` | [구성 경고](#stale-sandbox-mask-files-left-by-a-killed-session) |477| `Sandbox mask files left behind at write-deny paths` | [구성 경고](#stale-sandbox-mask-files-left-by-a-killed-session) |
909Fable 5.1 now uses usage credits · the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change913Fable 5.1 now uses usage credits · the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change
910```914```
911 915
912메시지에는 세션의 Fable 모델 이름이 표시되므로, Fable 5에서는 `continuing on Fable 5` 및 `Fable 5 now uses usage credits`로 표시됩니다. v2.1.257 이전에는 첫 번째 메시지가 `Fable 5 limit reached`로 시작했습니다.916메시지에는 세션의 Fable 모델 이름이 표시되므로, Fable 5.2에서는 `continuing on Fable 5.2` 및 `Fable 5.2 now uses usage credits`로 표시됩니다. v2.1.257 이전에는 첫 번째 메시지가 `Fable 5 limit reached`로 시작했습니다.
913 917
914이는 [Remote Control](https://code.claude.com/docs/ko/remote-control.md) 세션, [백그라운드 세션](https://code.claude.com/docs/ko/agent-view.md), [에이전트 팀](https://code.claude.com/docs/ko/agent-teams.md) 팀원 세션, 그리고 다른 애플리케이션이 Agent SDK를 통해 호스팅하는 세션에서 발생합니다. Claude Code가 프롬프트를 닫는 시점은 [Fable 및 사용량 크레딧](https://code.claude.com/docs/ko/model-config.md#fable-and-usage-credits)을 참조하세요.918이는 [Remote Control](https://code.claude.com/docs/ko/remote-control.md) 세션, [백그라운드 세션](https://code.claude.com/docs/ko/agent-view.md), [에이전트 팀](https://code.claude.com/docs/ko/agent-teams.md) 팀원 세션, 그리고 다른 애플리케이션이 Agent SDK를 통해 호스팅하는 세션에서 발생합니다. Claude Code가 프롬프트를 닫는 시점은 [Fable 및 사용량 크레딧](https://code.claude.com/docs/ko/model-config.md#fable-and-usage-credits)을 참조하세요.
915 919
983 987
984### Spend limit reached988### Spend limit reached
985 989
986[Claude 앱 게이트웨이](https://code.claude.com/docs/ko/claude-apps-gateway)를 통해 연결하고 있으며 게이트웨이 운영자가 설정한 [지출 상한](https://code.claude.com/docs/ko/claude-apps-gateway-spend-limits.md)을 초과했습니다. 게이트웨이는 명시된 기간이 재설정되거나 운영자가 상한을 올릴 때까지 요청을 차단합니다. 차단된 각 `429` 응답에는 `x-should-retry: false`가 표시되므로, Claude Code는 재시도하지 않고 이 메시지를 표시합니다.990[Claude 앱 게이트웨이](https://code.claude.com/docs/ko/claude-apps-gateway)를 통해 연결하고 있으며 게이트웨이 운영자가 설정한 [지출 상한](https://code.claude.com/docs/ko/claude-apps-gateway-spend-limits.md)에 도달했습니다. 게이트웨이는 운영자가 상한을 올리거나, 상한이 \$0보다 큰 경우 상한이 재설정될 때까지 요청을 차단합니다. 차단된 각 `429` 응답에는 `x-should-retry: false`가 표시되므로, 터미널에서 Claude Code는 재시도하지 않고 이 메시지를 표시합니다.
987 991
988```text theme={null}992```text theme={null}
989spend limit reached (daily; resets 2026-08-09 00:00 UTC)993spend limit reached · resets Dec 1
990```994```
991 995
992메시지에는 상한의 기간과 재설정 시간이 표시되며, 운영자가 `blocked_message`를 구성한 경우 그 뒤에 운영자의 안내가 이어집니다. v2.1.225 이전에는 메시지가 `spend limit reached`로만 표시되었으며, 이전 버전의 게이트웨이는 여전히 이 짧은 형식을 보냅니다.996메시지에 날짜가 있는지 확인합니다.
997
998* **날짜가 있는 경우**: 해당 날짜의 00:00 UTC에 상한이 재설정됩니다
999* **날짜가 없는 경우**: 상한이 \$0이거나, 게이트웨이가 v2.1.225 이전 버전을 실행하고 있습니다
1000
1001메시지의 그 밖의 텍스트는 게이트웨이 운영자의 안내입니다.
1002
1003게이트웨이 서버의 v2.1.225부터 v2.1.319 이전까지는 `spend limit reached (daily; resets 2026-08-09 00:00 UTC)`와 같이 메시지에 상한의 기간과 재설정 시간이 표시되었습니다.
993 1004
994**해결 방법:**1005**해결 방법:**
995 1006
996* 메시지에 표시된 재설정 시간까지 기다리거나, 메시지에 운영자의 안내가 포함되어 있으면 그 안내를 따릅니다1007* 메시지에 날짜가 있으면 재설정될 때까지 기다리거나, 메시지에 운영자의 안내가 포함되어 있으면 그 안내를 따릅니다
997* 상한에 자주 도달한다면 게이트웨이 운영자에게 상한을 올려 달라고 요청합니다1008* 메시지에 날짜가 없거나, 해당 날짜 이후에도 여전히 차단되거나, 상한에 자주 도달한다면 게이트웨이 운영자에게 상한을 올려 달라고 요청합니다
1009
1010또 다른 게이트웨이 메시지인 `This request exceeds your group's budget`은 그룹의 [공유 예산](https://code.claude.com/docs/ko/claude-apps-gateway-config.md#pooled-budget-order)이 소진되었음을 의미합니다. 메시지에 안내된 단계를 따르세요.
1011
1012```text theme={null}
1013This request exceeds your group's budget. Ask your organization's admins to raise it, or try again after it resets on November 1 at 00:00 UTC.
1014```
998 1015
999관련 메시지인 `spend limit unavailable`은 게이트웨이가 지출 기록을 읽을 수 없어 상한 초과가 아닌 예방 차원에서 요청을 차단했음을 의미합니다. 보통 저절로 해소되며, 지속되면 게이트웨이 운영자에게 알리세요.1016관련 메시지인 `spend limit unavailable`은 게이트웨이가 지출 기록을 읽을 수 없어 상한 초과가 아닌 예방 차원에서 요청을 차단했음을 의미합니다. 보통 저절로 해소되며, 지속되면 게이트웨이 운영자에게 알리세요.
1000 1017
2287 2304
2288### Couldn't send feedback2305### Couldn't send feedback
2289 2306
2290`Couldn't send feedback`으로 시작하는 메시지는 [`/feedback`, `/bug` 또는 `/share` 대화 상자](https://code.claude.com/docs/ko/commands#all-commands)에서 제출한 보고서나 큐에 있는 [피드백 초안](https://code.claude.com/docs/ko/tools-reference.md#sendfeedback-tool-behavior)을 피드백 서비스가 확인하지 않았음을 의미합니다. 수신되지 않은 것으로 간주합니다. 콜론 뒤에 조직에 관한 문장이 이어지면 조직이 피드백을 거부하는 것이며, 같은 보고서는 같은 응답을 받습니다.2307`Couldn't send feedback`으로 시작하는 메시지는 [`/feedback`, `/bug` 또는 `/share` 대화 상자](https://code.claude.com/docs/ko/commands#all-commands)에서 제출한 보고서나 큐에 있는 [피드백 초안](https://code.claude.com/docs/ko/tools-reference.md#sendfeedback-tool-behavior)을 피드백 서비스가 확인하지 않았음을 의미합니다. 수신되지 않은 것으로 간주합니다. 콜론 뒤에 조직에 관한 문장이 이어지면 조직이 피드백을 거부하는 것입니다.
2291 2308
2292다음 두 예시 중 두 번째는 조직의 거부입니다:2309두 번째 예시는 조직의 거부입니다:
2293 2310
2294```text wrap theme={null}2311```text wrap theme={null}
2295Couldn't send feedback (couldn't reach the service). If it keeps failing, you can file at https://github.com/anthropics/claude-code/issues instead.2312Couldn't send feedback (couldn't reach the service). If it keeps failing, you can file at https://github.com/anthropics/claude-code/issues instead.
2300**수행할 작업:**2317**수행할 작업:**
2301 2318
2302* **로그인되지 않음**: 메시지가 `: not signed in. Run /login, then retry.`로 이어집니다. `/login`을 실행한 다음 다시 보냅니다.2319* **로그인되지 않음**: 메시지가 `: not signed in. Run /login, then retry.`로 이어집니다. `/login`을 실행한 다음 다시 보냅니다.
2303* **조직의 거부**: 예를 들어 `: 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)에서 이슈를 엽니다. 큐에 있는 초안은 큐에 남아 있으며, [초안을 삭제](https://code.claude.com/docs/ko/tools-reference.md#discard-or-keep-a-draft)할 수 있습니다.2320* **조직의 거부**: 예를 들어 `: 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)됩니다.
2304* **거부된 자격 증명**: 메시지가 `: 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 키를 확인합니다.2321* **거부된 자격 증명**: 메시지가 `: 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 키를 확인합니다.
2305* **`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)에서 보고서를 제출합니다.2322* **`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)에서 보고서를 제출합니다.
2306* **`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)에서 보고서를 제출합니다.2323* **`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)에서 보고서를 제출합니다.
3431* **`Error: Workspace not trusted. <folder> is your home directory`**: 홈 디렉터리에 대한 신뢰는 절대 저장되지 않으므로 그곳에서 먼저 `claude`를 실행해도 도움이 되지 않습니다. 대신 프로젝트 디렉터리에서 `claude`를 한 번 실행해 신뢰 대화 상자를 수락한 후 그곳에서 `claude ultrareview`를 실행하거나, `--trust-workspace`를 추가합니다.3448* **`Error: Workspace not trusted. <folder> is your home directory`**: 홈 디렉터리에 대한 신뢰는 절대 저장되지 않으므로 그곳에서 먼저 `claude`를 실행해도 도움이 되지 않습니다. 대신 프로젝트 디렉터리에서 `claude`를 한 번 실행해 신뢰 대화 상자를 수락한 후 그곳에서 `claude ultrareview`를 실행하거나, `--trust-workspace`를 추가합니다.
3432* **`No answer in time.` 뒤에 `Error: Workspace not trusted`**: `Trust <folder>? [y/N]` 질문에 5분 동안 응답이 없었습니다. `claude ultrareview`를 다시 실행하고 질문에 답합니다.3449* **`No answer in time.` 뒤에 `Error: Workspace not trusted`**: `Trust <folder>? [y/N]` 질문에 5분 동안 응답이 없었습니다. `claude ultrareview`를 다시 실행하고 질문에 답합니다.
3433* **`Ultrareview did not start: <folder> is not trusted`**: `n`으로 답하거나 Enter를 누르는 등 `Trust <folder>? [y/N]` 질문에서 거절했습니다. 리뷰를 시작하려면 `claude ultrareview`를 다시 실행하고 `y`로 답합니다.3450* **`Ultrareview did not start: <folder> is not trusted`**: `n`으로 답하거나 Enter를 누르는 등 `Trust <folder>? [y/N]` 질문에서 거절했습니다. 리뷰를 시작하려면 `claude ultrareview`를 다시 실행하고 `y`로 답합니다.
3434* **``Ultrareview did not start: `--trust-workspace` takes no value``**: PR 번호나 `false` 등 플래그가 아닌 무언가가 `--trust-workspace` 뒤에 있습니다. 폴더를 신뢰하지 않는다면 플래그를 빼십시오. 이번 실행에서 신뢰하려면 PR 번호나 기본 브랜치를 플래그 앞에 둡니다: `claude ultrareview 1234 --trust-workspace`.3451* **``Ultrareview did not start: `--trust-workspace` takes no value``**: `--trust-workspace` 뒤에 PR 번호나 `false`처럼 플래그가 아닌 것이 옵니다. 폴더를 신뢰하지 않는다면 플래그를 빼세요. 이번 실행에서 신뢰하려면 PR 번호나 기본 브랜치를 플래그 앞에 둡니다: `claude ultrareview 1234 --trust-workspace`.
3435 3452
3436v2.1.309 이전에는 `claude ultrareview`가 `--trust-workspace`를 받지 않았습니다.3453v2.1.309 이전에는 `claude ultrareview`가 `--trust-workspace`를 받지 않았습니다.
3437 3454
3705 3722
3706### origin/HEAD가 없으면 /security-review가 실패함3723### origin/HEAD가 없으면 /security-review가 실패함
3707 3724
3708[`/security-review`](https://code.claude.com/docs/ko/commands#all-commands)는 브랜치를 `origin/HEAD`와 비교한 diff로 리뷰 컨텍스트를 구성합니다. `origin/HEAD`는 `origin` 원격의 기본 브랜치가 무엇인지 기록하는 로컬 ref입니다. 이 ref가 없으면 diff를 수집하는 git 명령이 실패하고 리뷰가 시작되기 전에 중단됩니다.3725[`/security-review`](https://code.claude.com/docs/ko/commands#all-commands)는 `origin` 원격의 기본 브랜치가 무엇인지 기록하는 로컬 참조인 `origin/HEAD`와 현재 브랜치를 비교한 diff로 리뷰 컨텍스트를 구성합니다. 이 참조가 없으면 diff를 수집하는 git 명령이 실패하고, 리뷰는 시작되기 전에 중단됩니다.
3709 3726
3710```text theme={null}3727```text theme={null}
3711Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]3728Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]
3724 3741
3725명령이 실행되기 전에 발생하는 관련 메시지도 있습니다.3742명령이 실행되기 전에 발생하는 관련 메시지도 있습니다.
3726 3743
3727* `Shell command permission check failed for pattern "..."`: 명령의 권한 검사가 명령을 허용하지 않았습니다. [주입된 명령에 대한 권한 검사](https://code.claude.com/docs/ko/skills.md#permission-checks-on-injected-commands)에서 각 권한 모드에서 어떤 결과가 중단되는지와 `allowed-tools`로 명령을 미리 승인하는 방법을 다룹니다3744* `Shell command permission check failed for pattern "..."`: 명령의 권한 검사가 이를 허용하지 않았습니다. [주입된 명령의 권한 검사](https://code.claude.com/docs/ko/skills.md#permission-checks-on-injected-commands)에서 각 권한 모드에서 어떤 결과가 중단으로 이어지는지, 그리고 `allowed-tools`로 명령을 사전 승인하는 방법을 다룹니다
3728* ``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)을 참조하세요3745* ``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)을 참조하세요
3729 3746
3730**해결 방법:**3747**해결 방법:**
3878 3895
3879* **기본 브랜치를 전달하지 않은 경우**: Claude Code는 저장소의 기본 브랜치와 비교했으며, 위 예시처럼 기본 브랜치를 명시적으로 전달하도록 제안합니다3896* **기본 브랜치를 전달하지 않은 경우**: Claude Code는 저장소의 기본 브랜치와 비교했으며, 위 예시처럼 기본 브랜치를 명시적으로 전달하도록 제안합니다
3880* **이미 클론에 있는 기본 브랜치를 전달한 경우**: 힌트는 ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``입니다3897* **이미 클론에 있는 기본 브랜치를 전달한 경우**: 힌트는 ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``입니다
3881* **클론에 없던 기본 브랜치를 전달한 경우**: 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`와 함께 실패합니다.3898* **클론에 없는 기본 브랜치를 전달한 경우**: 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`와 함께 실패했습니다.
3882 3899
3883**해결 방법:**3900**해결 방법:**
3884 3901
4227 4244
4228### /feedback is disabled by your organization's policy4245### /feedback is disabled by your organization's policy
4229 4246
4230이 메시지는 조직의 정책이 Claude Code에서의 제품 피드백을 허용하지 않으므로 `/feedback`, `/bug`, `/share`가 피드백 대화 상자를 열지 않는다는 의미입니다. 메시지에는 Claude Code 프롬프트에서 입력한 명령이 표시됩니다:4247이 메시지는 제품 피드백이 꺼져 있어 입력한 명령이 피드백 대화 상자를 열지 않는다는 의미입니다. 조직 정책과 이전 거부 모두 이 메시지를 발생시킵니다.
4248
4249* **조직 정책**: 조직 정책에서 Claude Code의 제품 피드백을 허용하지 않습니다. `/feedback`, `/bug`, `/share` 모두 이 메시지로 응답합니다.
4250* **이전 거부**: 피드백 서비스가 [`Couldn't send feedback: Feedback has not been enabled for your organization.`](#couldnt-send-feedback) 등으로 보낸 보고서를 거부했습니다. 이후 `/feedback`과 `/bug`가 이 메시지로 응답할 수 있습니다. 이 상태는 이 컴퓨터에서 해당 거부 시점부터 7일간 유지됩니다. Pro 및 Max를 포함한 모든 플랜에 적용됩니다.
4251
4252메시지에는 Claude Code 프롬프트에서 입력한 명령이 표시됩니다.
4231 4253
4232```text wrap theme={null}4254```text wrap theme={null}
4233/feedback is disabled by your organization's policy. To report a bug, open an issue at https://github.com/anthropics/claude-code/issues. Issues are public, so leave out anything confidential.4255/feedback is disabled by your organization's policy. To report a bug, open an issue at https://github.com/anthropics/claude-code/issues. Issues are public, so leave out anything confidential.
4238**해결 방법:**4260**해결 방법:**
4239 4261
4240* 버그를 보고하려면 [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)에서 이슈를 엽니다. 이곳의 이슈는 누구나 읽을 수 있으므로 코드, 트랜스크립트 및 기타 기밀 정보는 포함하지 마십시오.4262* 버그를 보고하려면 [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)에서 이슈를 엽니다. 이곳의 이슈는 누구나 읽을 수 있으므로 코드, 트랜스크립트 및 기타 기밀 정보는 포함하지 마십시오.
4263* 이전 거부 후에는 7일이 지날 때까지 기다린 후, 보고서를 다시 보내 서비스가 여전히 거부하는지 확인합니다
4264
4265v2.1.319 이전에는 이전 거부가 이 메시지를 발생시키지 않았습니다.
4241 4266
4242v2.1.302 이전에는 전체 메시지가 `/feedback is disabled by your organization's policy. Contact your organization admin to enable it.`였습니다.4267v2.1.302 이전에는 전체 메시지가 `/feedback is disabled by your organization's policy. Contact your organization admin to enable it.`였습니다.
4243 4268
4654* 답변할 시간을 더 주려면 서버의 구성 항목에서 더 긴 [`timeout`](https://code.claude.com/docs/ko/mcp#time-limits-on-mcp-tool-calls)을 밀리초 단위로 설정합니다. 예를 들어 10분이라면 `"timeout": 600000`으로 설정합니다4679* 답변할 시간을 더 주려면 서버의 구성 항목에서 더 긴 [`timeout`](https://code.claude.com/docs/ko/mcp#time-limits-on-mcp-tool-calls)을 밀리초 단위로 설정합니다. 예를 들어 10분이라면 `"timeout": 600000`으로 설정합니다
4655* 대신 대화형 세션에서 작업을 실행하고 서버의 [대화 상자](https://code.claude.com/docs/ko/mcp.md#respond-to-mcp-elicitation-requests)에 직접 답변합니다4680* 대신 대화형 세션에서 작업을 실행하고 서버의 [대화 상자](https://code.claude.com/docs/ko/mcp.md#respond-to-mcp-elicitation-requests)에 직접 답변합니다
4656 4681
4682### Permission prompt tool returned an invalid result
4683
4684[`--permission-prompt-tool`](https://code.claude.com/docs/ko/cli-reference#cli-flags)에 전달한 도구가 Claude Code가 읽을 수 없는 응답을 반환했기 때문에, 응답이 호출을 허용했더라도 그 응답을 기다리던 도구 호출은 실행되지 않았습니다.
4685
4686```text wrap theme={null}
4687Permission prompt tool returned an invalid result. Expected a single text block param with type="text" and a string text value.
4688```
4689
4690**조치 방법:**
4691
4692* 텍스트가 `{"behavior": "allow"}` 또는 `{"behavior": "deny", "message": "<reason>"}`인 텍스트 블록 하나를 반환합니다. 입력을 변경하려면 `allow` 객체에 `updatedInput`을 추가합니다. v2.1.86부터 v2.1.206까지는 `allow`에서 입력을 유지하려면 `"updatedInput": {}`가 필요했습니다.
4693* MCP SDK가 자동으로 추가할 수 있는 [`structuredContent`](https://code.claude.com/docs/ko/agent-sdk/custom-tools#return-structured-data)를 반환하지 않습니다. 예를 들어 도구를 다음과 같이 등록합니다.
4694 * **`mcp.server`의 `FastMCP` 또는 `MCPServer`**: `structured_output=False`로 등록합니다
4695 * **`fastmcp`의 `FastMCP`**: `output_schema=None`으로 등록하고 문자열을 반환합니다
4696 * **MCP TypeScript SDK**: `outputSchema` 없이 등록합니다
4697* 약 40KB 이상의 입력에서만 오류가 발생한다면 입력을 `updatedInput`이나 거부의 `message`에 복사하지 마세요. 그렇게 큰 입력을 변경하려면 [프롬프트 도구의 출력 제한을 높입니다](https://code.claude.com/docs/ko/mcp.md#raise-the-limit-for-a-specific-tool).
4698
4657### Agent would be spawned with zero tools4699### Agent would be spawned with zero tools
4658 4700
4659서브에이전트의 [`tools` 목록](https://code.claude.com/docs/ko/sub-agents#supported-frontmatter-fields)에 있는 모든 항목이 사용 가능한 도구와 일치하지 않았기 때문에 Claude Code가 서브에이전트 실행을 거부했습니다. 도구가 없으면 서브에이전트는 아무 작업도 할 수 없습니다. 메시지는 항목을 문제 유형별로 분류합니다.4701서브에이전트의 [`tools` 목록](https://code.claude.com/docs/ko/sub-agents#supported-frontmatter-fields)에 있는 모든 항목이 사용 가능한 도구와 일치하지 않았기 때문에 Claude Code가 서브에이전트 실행을 거부했습니다. 도구가 없으면 서브에이전트는 아무 작업도 할 수 없습니다. 메시지는 항목을 문제 유형별로 분류합니다.
6432 6474
6433v2.1.257 이전에는 `claude doctor`가 이러한 파일을 표시하지 않았으며, 이전 버전에서도 세션이 강제 종료되면 같은 자리 표시자가 남습니다.6475v2.1.257 이전에는 `claude doctor`가 이러한 파일을 표시하지 않았으며, 이전 버전에서도 세션이 강제 종료되면 같은 자리 표시자가 남습니다.
6434 6476
6477### Claude Code 설정 파일이 두 개 존재함
6478
6479Claude Code는 이 메시지가 명시한 첫 번째 파일을 사용하고 있으므로 두 번째 파일의 내용은 적용되지 않습니다. 첫 번째 파일은 [`.claude.json`](https://code.claude.com/docs/ko/claude-directory#ce-claude-json)의 이전 이름인 `.config.json`입니다. 메시지에는 어느 파일에 사용자의 설정이 들어 있는지 확인하는 방법이 포함되어 있습니다:
6480
6481```text wrap theme={null}
6482Two Claude Code config files exist: this run uses /home/you/.claude/.config.json, not /home/you/.claude.json. The file with the higher count here is usually yours, and this prints nothing else from them: grep -c -E '"(hasCompletedOnboarding|mcpServers)"' "/home/you/.claude/.config.json" "/home/you/.claude.json". To end this: if several hosts share this home, first get every host to version 2.1.319 or later, since an older one can write a moved .config.json back. Then stop your Claude processes on every host, move aside the one you do not want, and start none until no host lists it.
6483```
6484
6485Windows에서는 `grep` 명령이 포함된 문장 대신 `The one with hasCompletedOnboarding or mcpServers in it is usually yours.`가 표시됩니다.
6486
6487**할 일:**
6488
6489**1. 설정이 들어 있는 파일 찾기**
6490
6491* **Windows**: 두 파일을 모두 열고 어느 파일에 `hasCompletedOnboarding` 또는 `mcpServers`가 들어 있는지 확인하세요
6492* **기타 플랫폼**: 셸에서 메시지의 `grep` 명령을 실행하고 어느 파일의 개수가 더 높은지 확인하세요
6493
6494**2. 홈 디렉터리를 공유하는 모든 호스트 업데이트**
6495
6496여러 호스트가 이 홈 디렉터리를 공유하는 경우, 먼저 모든 호스트의 Claude Code를 메시지가 명시한 버전 이상으로 업데이트하세요. 이전 버전은 옮겨 둔 `.config.json`을 다시 기록할 수 있습니다.
6497
6498**3. Claude Code 중지**
6499
6500모든 호스트에서 Claude Code 프로세스를 중지하세요.
6501
6502**4. 원하지 않는 파일 옮기기**
6503
6504원하지 않는 파일을 해당 폴더 밖으로 옮기세요. 나중에 되돌릴 수 있도록 삭제하지 말고 옮기세요.
6505
6506**5. Claude Code를 다시 시작하기 전에 기다리기**
6507
6508옮긴 파일이 이전 경로에 있다고 표시하는 호스트가 하나도 남지 않을 때까지 어느 호스트에서도 Claude Code를 시작하지 마세요.
6509
6510두 파일 중 하나가 없어지면 메시지가 더 이상 표시되지 않습니다.
6511
6435### 나중에 이 변경을 다시 수행하세요: \~/.claude.json을 업데이트할 수 없음6512### 나중에 이 변경을 다시 수행하세요: \~/.claude.json을 업데이트할 수 없음
6436 6513
6437stderr의 이 알림은 로그인이나 신뢰 프롬프트에 대한 응답처럼 [`~/.claude.json`](https://code.claude.com/docs/ko/claude-directory#ce-claude-json)에 대한 변경 사항이 파일에 저장되지 않았다는 의미입니다:6514stderr의 이 알림은 로그인이나 신뢰 프롬프트에 대한 응답처럼 [`~/.claude.json`](https://code.claude.com/docs/ko/claude-directory#ce-claude-json)에 대한 변경 사항이 파일에 저장되지 않았다는 의미입니다:
6450 6527
6451* 구성된 [`--fallback-model`](https://code.claude.com/docs/ko/cli-reference#cli-flags)은 가용성 오류 후 해당 턴에만 제어를 인수받으며, 트랜스크립트에 공지가 표시됩니다6528* 구성된 [`--fallback-model`](https://code.claude.com/docs/ko/cli-reference#cli-flags)은 가용성 오류 후 해당 턴에만 제어를 인수받으며, 트랜스크립트에 공지가 표시됩니다
6452* Amazon Bedrock 또는 Google Cloud의 Agent Platform 시작 확인에서 기본 모델을 사용할 수 없음을 발견하거나, 계정이 [세션 중간에 모델에 대한 액세스를 잃음](https://code.claude.com/docs/ko/amazon-bedrock.md#when-a-model-is-disabled-mid-session)6529* Amazon Bedrock 또는 Google Cloud의 Agent Platform 시작 확인에서 기본 모델을 사용할 수 없음을 발견하거나, 계정이 [세션 중간에 모델에 대한 액세스를 잃음](https://code.claude.com/docs/ko/amazon-bedrock.md#when-a-model-is-disabled-mid-session)
6453* [자동 모델 폴백](https://code.claude.com/docs/ko/model-config.md#automatic-model-fallback)은 Fable 5.1, Fable 5, Opus 5.5, Sonnet 5.5, Opus 5에서 세션을 플래그된 카테고리의 폴백 모델로 이동하며, 해당 카테고리에 폴백 모델이 있을 때 트랜스크립트에 공지를 표시합니다6530* Fable 모델, Opus 5.5, Sonnet 5.5, Opus 5의 [자동 모델 폴백](https://code.claude.com/docs/ko/model-config.md#automatic-model-fallback)은 플래그된 카테고리에 폴백 모델이 있는 경우 세션을 해당 카테고리의 폴백 모델로 이동합니다. 트랜스크립트에 공지가 표시됩니다
6454 6531
6455아래의 모델 선택 확인은 두 번째와 세 번째 경우를 포착합니다. 첫 번째는 `/model` 변경이 아니라 트랜스크립트 공지로 나타납니다. [모델 구성](https://code.claude.com/docs/ko/model-config.md)에서 각 폴백이 적용되는 시기를 설명합니다.6532아래의 모델 선택 확인은 두 번째와 세 번째 경우를 포착합니다. 첫 번째는 `/model` 변경이 아니라 트랜스크립트 공지로 나타납니다. [모델 구성](https://code.claude.com/docs/ko/model-config.md)에서 각 폴백이 적용되는 시기를 설명합니다.
6456 6533
