8 8
9本頁列出 Claude Code 顯示的執行時錯誤及如何從每個錯誤中復原，以及當回應似乎有問題但沒有錯誤時要檢查的內容。如需安裝錯誤（例如 `command not found` 或設定期間的 TLS 失敗），請參閱[疑難排解安裝和登入](/docs/zh-TW/troubleshoot-install)。9本頁列出 Claude Code 顯示的執行時錯誤及如何從每個錯誤中復原，以及當回應似乎有問題但沒有錯誤時要檢查的內容。如需安裝錯誤（例如 `command not found` 或設定期間的 TLS 失敗），請參閱[疑難排解安裝和登入](/docs/zh-TW/troubleshoot-install)。
10 10
11除了[包裝程式和 IDE 錯誤](#wrapper-and-ide-errors)（由啟動程式列印而非 Claude Code 本身列印）外，這些錯誤和復原命令適用於 CLI、[桌面應用程式](/docs/zh-TW/desktop)和[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)，因為這三者都包裝相同的 Claude Code CLI。如需其他表面特定的問題，請參閱該表面頁面上的疑難排解部分。11除了[包裝程式和 IDE 錯誤](#wrapper-and-ide-errors)（由啟動程式列印而非 Claude Code 本身列印）外，這些錯誤和復原命令適用於 CLI、[桌面應用程式](/docs/zh-TW/desktop)和[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)，因為這三者都包裝相同的 Claude Code CLI。如需其他使用介面特定的問題，請參閱該使用介面頁面上的疑難排解部分。
12 12
13<Note>13<Note>
14 Claude Code 呼叫 Claude API 以取得模型回應，因此大多數執行時錯誤對應到基礎 API 錯誤代碼。本頁涵蓋每個錯誤在 Claude Code 中的含義及如何復原。如需原始 HTTP 狀態代碼定義，請參閱 [Claude Platform 錯誤參考](https://platform.claude.com/docs/en/api/errors)。14 Claude Code 呼叫 Claude API 以取得模型回應，因此大多數執行時錯誤對應到基礎 API 錯誤代碼。本頁涵蓋每個錯誤在 Claude Code 中的含義及如何復原。如需原始 HTTP 狀態代碼定義，請參閱 [Claude Platform 錯誤參考](https://platform.claude.com/docs/en/api/errors)。
42| `The server-side auto mode classifier gave no verdict` | [伺服器錯誤](#the-server-returned-no-safety-verdict) |42| `The server-side auto mode classifier gave no verdict` | [伺服器錯誤](#the-server-returned-no-safety-verdict) |
43| `Auto mode is unavailable — the server returned no safety verdict for the last 10 responses` | [伺服器錯誤](#the-server-returned-no-safety-verdict) |43| `Auto mode is unavailable — the server returned no safety verdict for the last 10 responses` | [伺服器錯誤](#the-server-returned-no-safety-verdict) |
44| `Agent terminated early due to an API error` | [伺服器錯誤](#agent-terminated-early-due-to-an-api-error) |44| `Agent terminated early due to an API error` | [伺服器錯誤](#agent-terminated-early-due-to-an-api-error) |
45| `You've hit your session limit` / `You've hit your weekly limit` / `You've hit your Opus limit` / `You've hit your Sonnet limit` | [使用限制](#youve-hit-your-session-limit) |45| `You've hit your session limit` / `You've hit your weekly limit` / `You've hit your Opus limit` / `You've hit your Sonnet limit` | [用量上限](#youve-hit-your-session-limit) |
46| `Usage credits required for 1M context` | [使用限制](#usage-credits-required-for-1m-context) |46| `Usage credits required for 1M context` | [用量上限](#usage-credits-required-for-1m-context) |
47| `the prompt to confirm went unanswered — nothing was sent` | [使用限制](#the-prompt-to-confirm-went-unanswered) |47| `the prompt to confirm went unanswered — nothing was sent` | [用量上限](#the-prompt-to-confirm-went-unanswered) |
48| `Server is temporarily limiting requests` | [使用限制](#server-is-temporarily-limiting-requests) |48| `Server is temporarily limiting requests` | [用量上限](#server-is-temporarily-limiting-requests) |
49| `Request rejected (429)` | [使用限制](#request-rejected-429) |49| `Request rejected (429)` | [用量上限](#request-rejected-429) |
50| `Credit balance is too low` | [使用限制](#credit-balance-is-too-low) |50| `Credit balance is too low` | [用量上限](#credit-balance-is-too-low) |
51| `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) |51| `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) |
52| `Could not update your spend limit` | [使用限制](#could-not-update-your-spend-limit) |52| `Could not update your spend limit` | [用量上限](#could-not-update-your-spend-limit) |
53| `spend limit reached` / `spend limit unavailable` | [使用限制](#spend-limit-reached) |53| `spend limit reached` / `spend limit unavailable` | [用量上限](#spend-limit-reached) |
54| `Not logged in · Please run /login` | [驗證](#not-logged-in) |54| `Not logged in · Please run /login` | [驗證](#not-logged-in) |
55| `Couldn't save your login` | [驗證](#couldnt-save-your-login) |55| `Couldn't save your login` | [驗證](#couldnt-save-your-login) |
56| `Authentication required · Sign in again to continue` | [驗證](#not-logged-in) |56| `Authentication required · Sign in again to continue` | [驗證](#not-logged-in) |
75| `Remote Control stopped — the app running this session is now signed in to a different Claude account` | [驗證](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |75| `Remote Control stopped — the app running this session is now signed in to a different Claude account` | [驗證](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |
76| `Remote Control stopped — the app running this session is signed out of Claude` | [驗證](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |76| `Remote Control stopped — the app running this session is signed out of Claude` | [驗證](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |
77| `Couldn't verify your organization's policy for remote control` | [疑難排解 Remote Control](/docs/zh-TW/remote-control#couldnt-verify-your-organizations-policy-for-remote-control) |77| `Couldn't verify your organization's policy for remote control` | [疑難排解 Remote Control](/docs/zh-TW/remote-control#couldnt-verify-your-organizations-policy-for-remote-control) |
78| `Remote Control is disabled by your organization's policy` | [疑難排解 Remote Control](/docs/zh-TW/remote-control#remote-control-is-disabled-by-your-organizations-policy) |
79| `Remote Control was turned off by your organization's policy` | [疑難排解 Remote Control](/docs/zh-TW/remote-control#remote-control-was-turned-off-by-your-organizations-policy) |
78| `OAuth token revoked` / `OAuth token has expired` | [驗證](#oauth-token-revoked-or-expired) |80| `OAuth token revoked` / `OAuth token has expired` | [驗證](#oauth-token-revoked-or-expired) |
81| `Failed to authenticate: OAuth token revoked` | [驗證](#oauth-token-revoked-or-expired) |
82| `Your account does not have access to Claude. Please login again or contact your administrator.` | [驗證](#oauth-token-revoked-or-expired) |
79| `API Error: 401 Invalid authentication credentials` | [驗證](#api-error-401-invalid-authentication-credentials) |83| `API Error: 401 Invalid authentication credentials` | [驗證](#api-error-401-invalid-authentication-credentials) |
80| `Login expired · Please run /login` | [驗證](#login-expired) |84| `Login expired · Please run /login` | [驗證](#login-expired) |
81| `Failed to start OAuth callback server` | [驗證](#failed-to-start-oauth-callback-server) |85| `Failed to start OAuth callback server` | [驗證](#failed-to-start-oauth-callback-server) |
186| `The connection dropped while downloading the update` | [安裝錯誤](#the-connection-dropped-while-downloading-the-update) |190| `The connection dropped while downloading the update` | [安裝錯誤](#the-connection-dropped-while-downloading-the-update) |
187| `Download timed out: exceeded the total deadline` | [安裝錯誤](#the-connection-dropped-while-downloading-the-update) |191| `Download timed out: exceeded the total deadline` | [安裝錯誤](#the-connection-dropped-while-downloading-the-update) |
188| `--bg and --print conflict` | [命令列錯誤](#conflict-between-bg-and-print) |192| `--bg and --print conflict` | [命令列錯誤](#conflict-between-bg-and-print) |
193| `Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.` | [命令列錯誤](#conflict-between-a-system-prompt-flag-and-its-file-form) |
189| `Cloud sessions cannot be created from a --restricted session` | [命令列錯誤](#cloud-sessions-cannot-be-created-from-a-restricted-session) |194| `Cloud sessions cannot be created from a --restricted session` | [命令列錯誤](#cloud-sessions-cannot-be-created-from-a-restricted-session) |
190| `Cloud sessions are disabled by your organization's policy` | [命令列錯誤](#cloud-sessions-are-disabled-by-your-organizations-policy) |195| `Cloud sessions are disabled by your organization's policy` | [命令列錯誤](#cloud-sessions-are-disabled-by-your-organizations-policy) |
191| `Couldn't verify your organization's policy for cloud sessions` | [命令列錯誤](#cloud-sessions-are-disabled-by-your-organizations-policy) |196| `Couldn't verify your organization's policy for cloud sessions` | [命令列錯誤](#cloud-sessions-are-disabled-by-your-organizations-policy) |
203| `Could not read Claude Code config` | [命令列錯誤](#could-not-read-claude-code-config) |208| `Could not read Claude Code config` | [命令列錯誤](#could-not-read-claude-code-config) |
204| `Could not import <server>: <reason>` | [命令列錯誤](#could-not-import-a-server-from-claude-desktop) |209| `Could not import <server>: <reason>` | [命令列錯誤](#could-not-import-a-server-from-claude-desktop) |
205| `Cannot add MCP server to scope: managed` | [命令列錯誤](#cannot-add-mcp-server-to-the-managed-scope) |210| `Cannot add MCP server to scope: managed` | [命令列錯誤](#cannot-add-mcp-server-to-the-managed-scope) |
211| `Cannot add MCP server: your organization's managed settings allow only MCP servers that plugins provide` | [命令列錯誤](#cannot-add-mcp-server-when-managed-settings-allow-only-plugin-servers) |
206| `is Anthropic-hosted and doesn't support local OAuth` | [命令列錯誤](#anthropic-hosted-and-doesnt-support-local-oauth) |212| `is Anthropic-hosted and doesn't support local OAuth` | [命令列錯誤](#anthropic-hosted-and-doesnt-support-local-oauth) |
207| `Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes` | [命令列錯誤](#cant-read-mcp-json) |213| `Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes` | [命令列錯誤](#cant-read-mcp-json) |
208| `MCP server "<name>" was not saved to` / `was not removed from` | [命令列錯誤](#mcp-server-was-not-saved-or-removed) |214| `MCP server "<name>" was not saved to` / `was not removed from` | [命令列錯誤](#mcp-server-was-not-saved-or-removed) |
246| `Marketplace name impersonates an official Anthropic/Claude marketplace` | [Plugin 錯誤](#claude-code-refuses-the-marketplace-name) |252| `Marketplace name impersonates an official Anthropic/Claude marketplace` | [Plugin 錯誤](#claude-code-refuses-the-marketplace-name) |
247| `Marketplace "<name>" is already added from a different source` | [Plugin 錯誤](#marketplace-is-already-added-from-a-different-source) |253| `Marketplace "<name>" is already added from a different source` | [Plugin 錯誤](#marketplace-is-already-added-from-a-different-source) |
248| `"<name>" is another spelling of "<reserved>", a reserved marketplace name` | [Plugin 錯誤](#marketplace-name-is-another-spelling-of-a-reserved-name) |254| `"<name>" is another spelling of "<reserved>", a reserved marketplace name` | [Plugin 錯誤](#marketplace-name-is-another-spelling-of-a-reserved-name) |
255| `Marketplace "<name>" is added but ignored` | [Plugin 疑難排解](/docs/zh-TW/plugins/troubleshooting#marketplace-is-added-but-ignored) |
256| `Marketplace "<name>" is registered but was refused (see the debug log)` | [Plugin 疑難排解](/docs/zh-TW/plugins/troubleshooting#marketplace-is-added-but-ignored) |
249| `references ${user_config.*} in a shell-form command` | [Plugin 錯誤](#plugin-command-references-user-config) |257| `references ${user_config.*} in a shell-form command` | [Plugin 錯誤](#plugin-command-references-user-config) |
250| `Monitor "<name>" from plugin <plugin> references ${user_config.*} in its command` | [Plugin 錯誤](#plugin-command-references-user-config) |258| `Monitor "<name>" from plugin <plugin> references ${user_config.*} in its command` | [Plugin 錯誤](#plugin-command-references-user-config) |
251| `headersHelper for MCP server '<name>' references ${user_config.*}` | [Plugin 錯誤](#plugin-command-references-user-config) |259| `headersHelper for MCP server '<name>' references ${user_config.*}` | [Plugin 錯誤](#plugin-command-references-user-config) |
252| `Plugin archive integrity check failed` | [Plugin 錯誤](#plugin-archive-integrity-check-failed) |260| `Plugin archive integrity check failed` | [Plugin 錯誤](#plugin-archive-integrity-check-failed) |
261| `An npm plugin source must name a registry package` | [Plugin 疑難排解](/docs/zh-TW/plugins/troubleshooting#an-npm-plugin-source-must-name-a-registry-package) |
253| `path escapes plugin directory` | [Plugin 錯誤](#path-escapes-plugin-directory) |262| `path escapes plugin directory` | [Plugin 錯誤](#path-escapes-plugin-directory) |
254| `path could not be checked` | [Plugin 錯誤](#path-could-not-be-checked) |263| `path could not be checked` | [Plugin 錯誤](#path-could-not-be-checked) |
255| `its marketplace entry path does not stay inside the marketplace directory` | [Plugin 錯誤](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |264| `its marketplace entry path does not stay inside the marketplace directory` | [Plugin 錯誤](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |
290| `Reading a local file from outside this session's connected folders, or through a link, needs the approval card` | [工具錯誤](#reading-a-local-file-from-outside-the-connected-folders) |299| `Reading a local file from outside this session's connected folders, or through a link, needs the approval card` | [工具錯誤](#reading-a-local-file-from-outside-the-connected-folders) |
291| `cannot read file_path (...) — the file could not be examined, and no one can answer the approval card` | [工具錯誤](#reading-a-local-file-from-outside-the-connected-folders) |300| `cannot read file_path (...) — the file could not be examined, and no one can answer the approval card` | [工具錯誤](#reading-a-local-file-from-outside-the-connected-folders) |
292| `WebFetch cannot fetch localhost or other hostnames without a dot` | [工具錯誤](#webfetch-cannot-fetch-localhost) |301| `WebFetch cannot fetch localhost or other hostnames without a dot` | [工具錯誤](#webfetch-cannot-fetch-localhost) |
302| `The safety check for domain ... is rate-limited` | [工具錯誤](#webfetch-domain-safety-check-failed) |
303| `The safety check for domain ... is temporarily rate-limited` | [工具錯誤](#webfetch-domain-safety-check-failed) |
304| `Unable to verify if domain ... is safe to fetch` | [工具錯誤](#webfetch-domain-safety-check-failed) |
293| `Can't open MCP settings while no terminal is attached to this background session` | [背景工作階段錯誤](#commands-refused-in-a-background-session) |305| `Can't open MCP settings while no terminal is attached to this background session` | [背景工作階段錯誤](#commands-refused-in-a-background-session) |
294| `Can't open MCP settings in a background session` | [背景工作階段錯誤](#commands-refused-in-a-background-session) |306| `Can't open MCP settings in a background session` | [背景工作階段錯誤](#commands-refused-in-a-background-session) |
295| `blocked because the path is spelled in a form that cannot be safely resolved` | [背景工作階段錯誤](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) |307| `blocked because the path is spelled in a form that cannot be safely resolved` | [背景工作階段錯誤](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) |
357Claude Code 會重試這些故障：369Claude Code 會重試這些故障：
358 370
359* 伺服器錯誤、過載回應，以及在 Claude 回應開始串流之前到達的請求逾時。371* 伺服器錯誤、過載回應，以及在 Claude 回應開始串流之前到達的請求逾時。
372* 在 Claude 完成思考之後、但在開始任何文字或工具呼叫之前到達的伺服器錯誤或過載回應。Claude Code 會在該點重試伺服器錯誤最多兩次。在 v2.1.284 之前，Claude Code 會在該點以錯誤結束回合。
360* 連線中斷。當連線在 Claude 完成其回應的任何部分（包括其思考）之前中途中斷時，Claude Code 會以相同的退避方式重新發出請求，並且回合會繼續，即使某些文字已經開始串流。當連線在 Claude 完成思考之後但在開始任何文字或工具呼叫之前中斷時，Claude Code 會改為快速連續重新發出請求最多兩次，如果連線在該點持續中斷，則以 `Connection lost before a response was produced` 結束回合。373* 連線中斷。當連線在 Claude 完成其回應的任何部分（包括其思考）之前中途中斷時，Claude Code 會以相同的退避方式重新發出請求，並且回合會繼續，即使某些文字已經開始串流。當連線在 Claude 完成思考之後但在開始任何文字或工具呼叫之前中斷時，Claude Code 會改為快速連續重新發出請求最多兩次，如果連線在該點持續中斷，則以 `Connection lost before a response was produced` 結束回合。
361* Claude Code 偵測到的連線在您的電腦進入睡眠狀態時在請求中途被中斷。Claude Code 將其計為上述規則下的連線中斷；一旦重試標籤命名了具體原因，它會讀作 `Connection lost while your computer was asleep`，如果回合在 Claude 完成思考但在任何文字或工具呼叫之前結束，訊息會讀作 `Your computer went to sleep before a response was produced`。374* Claude Code 偵測到的連線在您的電腦進入睡眠狀態時在請求中途被中斷。Claude Code 將其計為上述規則下的連線中斷；一旦重試標籤命名了具體原因，它會讀作 `Connection lost while your computer was asleep`，如果回合在 Claude 完成思考但在任何文字或工具呼叫之前結束，訊息會讀作 `Your computer went to sleep before a response was produced`。
362* 停滯的回應串流，當回應標頭已到達但 Claude 回應的任何部分都未到達，或當 Claude 完成思考但尚未開始任何文字或工具呼叫時：Claude Code 會中止停滯的連線，並最多重新發出一次請求，不在上述 10 次嘗試預算內。如果在 Claude 完成思考但在任何文字或工具呼叫之前回應停滯第二次，Claude Code 會以 `The response stalled before a response was produced` 結束回合。375* 停滯的回應串流，當回應標頭已到達但 Claude 回應的任何部分都未到達，或當 Claude 完成思考但尚未開始任何文字或工具呼叫時：Claude Code 會中止停滯的連線，並最多重新發出一次請求，不在上述 10 次嘗試預算內。如果在 Claude 完成思考但在任何文字或工具呼叫之前回應停滯第二次，Claude Code 會以 `The response stalled before a response was produced` 結束回合。
363* 串流請求 API 從未以回應標頭回答，在 [first-byte deadline 執行](/docs/zh-TW/network-config#streaming-idle-watchdogs) 的連線上：Claude Code 在截止時間中止它，並在重試預算內最多每個模型請求重新發送一次，然後如果該嘗試也未獲得回答，則以 [No response from API](#no-response-from-api) 結束回合。在其他連線上，請求會等待 `API_TIMEOUT_MS`。當您設定 `CLAUDE_CODE_RETRY_WATCHDOG` 時，一次重試上限不適用。376* 串流請求 API 從未以回應標頭回答，在 [first-byte deadline 執行](/docs/zh-TW/network-config#streaming-idle-watchdogs) 的連線上：Claude Code 在截止時間中止它，並在重試預算內最多每個模型請求重新發送一次，然後如果該嘗試也未獲得回答，則以 [No response from API](#no-response-from-api) 結束回合。在其他連線上，請求會等待 `API_TIMEOUT_MS`。當您設定 `CLAUDE_CODE_RETRY_WATCHDOG` 時，一次重試上限不適用。
364* 暫時性 429 節流，但不是閘道的支出限制 `429`，這不是節流；請參閱 [Spend limit reached](#spend-limit-reached)。377* 暫時性 429 節流，但不是閘道的支出限制 `429`，這不是節流；請參閱 [Spend limit reached](#spend-limit-reached)。
365 * 當您使用 claude.ai 訂閱登入時，這包括不帶有您計畫配額標頭的 429 節流。在 v2.1.199 之前，Claude Code 僅針對 API 金鑰和企業登入重試這些節流。378 * 當您使用 claude.ai 訂閱登入時，這包括不帶有您方案配額標頭的 429 節流。在 v2.1.199 之前，Claude Code 僅針對 API 金鑰和 Enterprise 登入重試這些節流。
366* 因為輸入加上 `max_tokens` 超過內容限制而被拒絕的請求。以相同方式重新發送它會以相同方式失敗，所以 Claude Code 會以縮減的 `max_tokens` 重試，並在兩種情況下停止重試並改為壓縮：379* 因為輸入加上 `max_tokens` 超過上下文限制而被拒絕的請求。以相同方式重新發送它會以相同方式失敗，所以 Claude Code 會以縮減的 `max_tokens` 重試，並在兩種情況下停止重試並改為壓縮：
367 * 當沒有縮減可以適應時，例如當對話本身幾乎填滿內容視窗時。380 * 當沒有縮減可以容納時，例如當對話本身幾乎填滿上下文視窗時。
368 * 當重試無法進一步縮減 `max_tokens` 時。在 v2.1.218 之前，Claude Code 可以重新發送仍然不適應的縮減請求，例如當擴展思考預算超過剩餘內容時，直到重試預算用盡。381 * 當重試無法進一步縮減 `max_tokens` 時。在 v2.1.218 之前，Claude Code 可能會重新發送仍然無法容納的縮減請求，例如當延伸思考預算超過剩餘上下文時，直到重試預算用盡。
369* 在 [Google Cloud 的 Agent Platform](/docs/zh-TW/google-vertex-ai) 上過期或遺失的 Google Cloud 認證，或在您的機器上無法載入的 AWS 認證。Claude Code 會捨棄其快取的認證並重試最多兩次，然後報告錯誤，以便您可以立即重新驗證，如 [Could not load AWS or Google Cloud credentials](#could-not-load-aws-or-google-cloud-credentials) 下所述。在 v2.1.228 之前，Claude Code 會透過完整重試預算重試失敗的 Google Cloud 認證，然後才顯示錯誤。382* 在 [Google Cloud 的 Agent Platform](/docs/zh-TW/google-vertex-ai) 上過期或遺失的 Google Cloud 憑證，或在您的機器上無法載入的 AWS 憑證。Claude Code 會捨棄其快取的憑證並重試最多兩次，然後報告錯誤，以便您可以立即重新驗證，如 [Could not load AWS or Google Cloud credentials](#could-not-load-aws-or-google-cloud-credentials) 下所述。在 v2.1.228 之前，Claude Code 會透過完整重試預算重試失敗的 Google Cloud 憑證，然後才顯示錯誤。
370* 來自 Anthropic API 的 `401` 或 `403`，直接或透過 [LLM gateway](/docs/zh-TW/llm-gateway)，而 [`apiKeyHelper`](/docs/zh-TW/settings-reference#apikeyhelper) 指令碼提供認證。Claude Code 會重新執行指令碼並使用其新輸出重試，在完整重試預算內。當指令碼本身在重新執行時失敗時，Claude Code 會改為顯示 [Your apiKeyHelper script is failing](#your-apikeyhelper-script-is-failing)。383* 來自 Anthropic API 的 `401` 或 `403`，直接或透過 [LLM 閘道](/docs/zh-TW/llm-gateway)，而 [`apiKeyHelper`](/docs/zh-TW/settings-reference#apikeyhelper) 指令碼提供憑證。Claude Code 會重新執行指令碼並使用其新輸出重試，在完整重試預算內。當指令碼本身在重新執行時失敗時，Claude Code 會改為顯示 [Your apiKeyHelper script is failing](#your-apikeyhelper-script-is-failing)。
371 384
372在 v2.1.227 之前，`Connection lost before a response was produced` 讀作 `Connection closed while thinking, before producing a response`，`The response stalled before a response was produced` 讀作 `Response stalled while thinking, before producing a response`。385在 v2.1.227 之前，`Connection lost before a response was produced` 讀作 `Connection closed while thinking, before producing a response`，`The response stalled before a response was produced` 讀作 `Response stalled while thinking, before producing a response`。
373 386
374Claude Code 不會重試這些故障：387Claude Code 不會重試這些故障：
375 388
376* TLS 憑證驗證失敗，例如 TLS 檢查代理、遺失的 `NODE_EXTRA_CA_CERTS` 套件，或過期的憑證。Claude Code 在第一次嘗試時報告錯誤，以便您可以立即修正憑證設定；請參閱 [SSL certificate errors](#ssl-certificate-errors)。Claude Code 仍會重試暫時性 TLS 條件，例如握手逾時。在 v2.1.199 之前，Claude Code 會透過完整重試預算重試憑證失敗，然後才顯示錯誤。389* TLS 憑證驗證失敗，例如 TLS 檢查代理伺服器、遺失的 `NODE_EXTRA_CA_CERTS` 套件，或過期的憑證。Claude Code 在第一次嘗試時報告錯誤，以便您可以立即修正憑證設定；請參閱 [SSL certificate errors](#ssl-certificate-errors)。Claude Code 仍會重試暫時性 TLS 條件，例如握手逾時。在 v2.1.199 之前，Claude Code 會透過完整重試預算重試憑證失敗，然後才顯示錯誤。
377* 伺服器錯誤、連線中斷，或停滯的串流在 Claude 完成文字區塊或工具呼叫之後到達，或在完成思考後開始一個但在完成回應之前。Claude Code 不會重新執行請求，因為這可能會執行相同的工具呼叫兩次。它會保留 Claude 完成的內容，執行 Claude 完成的任何工具呼叫，並從其結果繼續回合。關於您在互動式工作階段和非互動式工作階段中看到的內容，請閱讀 [The response above may be incomplete](#the-response-above-may-be-incomplete)。在 v2.1.199 之前，當伺服器錯誤在串流中途到達時，Claude Code 會捨棄部分輸出並將整個回合報告為錯誤。390* 伺服器錯誤、連線中斷，或停滯的串流在 Claude 完成文字區塊或工具呼叫之後到達，或在完成思考後開始一個但在完成回應之前。Claude Code 不會重新執行請求，因為這可能會執行相同的工具呼叫兩次。它會保留 Claude 完成的內容，執行 Claude 完成的任何工具呼叫，並從其結果繼續回合。關於您在互動式工作階段和非互動式工作階段中看到的內容，請閱讀 [The response above may be incomplete](#the-response-above-may-be-incomplete)。在 v2.1.199 之前，當伺服器錯誤在串流中途到達時，Claude Code 會捨棄部分輸出並將整個回合報告為錯誤。
378* 在 Claude 完成回應之後到達的故障：不需要重試任何內容，所以 Claude Code 會保留完整回應並正常結束回合。391* 在 Claude 完成回應之後到達的故障：不需要重試任何內容，所以 Claude Code 會保留完整回應並正常結束回合。
379* [Amazon Bedrock 串流回應具有意外的 content-type](#bedrock-streaming-response-has-an-unexpected-content-type)，因為重寫回應的閘道或代理會以相同方式重寫重試。需要 Claude Code v2.1.208 或更新版本。392* [Amazon Bedrock 串流回應具有意外的 content-type](#bedrock-streaming-response-has-an-unexpected-content-type)，因為重寫回應的閘道或代理伺服器會以相同方式重寫重試。需要 Claude Code v2.1.208 或更新版本。
380* 失敗的串流請求的非串流重試獲得成功狀態但 [body 中沒有 Claude API 訊息](#api-returned-an-empty-or-malformed-response)。Claude Code 以該錯誤結束回合。393* 失敗的串流請求的非串流重試獲得成功狀態但 [body 中沒有 Claude API 訊息](#api-returned-an-empty-or-malformed-response)。Claude Code 以該錯誤結束回合。
381* 您的組織的原則檢查拒絕的請求，其表現為帶有拒絕訊息的 `API Error:` 行。您的組織管理員使用 [Inference hooks](https://platform.claude.com/docs/en/manage-claude/inference-hooks)（Claude 企業功能）設定檢查，訊息以他們設定的指示結尾，或預設告訴您聯絡他們。Claude Code 不會將被拒絕的請求重新發送到相同的模型或 [fallback model](/docs/zh-TW/model-config#fallback-model-chains)，因為拒絕是關於請求的內容而不是模型。在 v2.1.239 之前，Claude Code 可以重新發送被拒絕的請求，不進行串流或在設定的後備模型上，然後才向您顯示拒絕。394* 您的組織的原則檢查拒絕的請求，其表現為帶有拒絕訊息的 `API Error:` 行。您的組織管理員使用 [Inference hooks](https://platform.claude.com/docs/en/manage-claude/inference-hooks)（Claude Enterprise 功能）設定檢查，訊息以他們設定的指示結尾，或預設告訴您聯絡他們。Claude Code 不會將被拒絕的請求重新發送到相同的模型或 [備援模型](/docs/zh-TW/model-config#fallback-model-chains)，因為拒絕是關於請求的內容而不是模型。在 v2.1.239 之前，Claude Code 可能會在向您顯示拒絕之前，以非串流方式或在設定的備援模型上重新發送被拒絕的請求。
382 395
383<h3 id="what-you-see-while-claude-code-retries-or-waits">396<h3 id="what-you-see-while-claude-code-retries-or-waits">
384 當 Claude Code 重試或等待時您看到的內容397 當 Claude Code 重試或等待時您看到的內容
388 401
389從 v2.1.198 開始，在重試期間會隱藏通常的微調器提示。一旦錯誤原因被揭示，如果故障是 529 過載，倒數計時下方的行也會命名檢查服務狀態的位置：Anthropic API 上的 `status.claude.com`，或其他設定上的訊息中命名的提供者或閘道主機。402從 v2.1.198 開始，在重試期間會隱藏通常的微調器提示。一旦錯誤原因被揭示，如果故障是 529 過載，倒數計時下方的行也會命名檢查服務狀態的位置：Anthropic API 上的 `status.claude.com`，或其他設定上的訊息中命名的提供者或閘道主機。
390 403
391如果在請求仍待處理時，回應串流上 20 秒內沒有資料到達，微調器會在任何重試開始之前顯示 `Waiting for API response · will retry in … · check your network`。請求尚未失敗：倒數計時執行到 Claude Code 中止停滯連線的點。中止後，您看到的內容取決於回應已進行的距離：404如果在請求仍待處理時，回應串流上 20 秒內沒有資料到達，微調器會在任何重試開始之前顯示 `Waiting for API response · will retry in … · check your network`。請求尚未失敗：倒數計時執行到 Claude Code 中止停滯連線的點。中止後，您看到的內容取決於回應已進行的程度：
392 405
393* 在 Claude 完成文字區塊或工具呼叫之前，或在完成思考後開始一個，Claude Code 會重試請求或以錯誤結束回合。[Automatic retries](#automatic-retries) 說明它重試哪些停滯以及重試多少次。406* 在 Claude 完成文字區塊或工具呼叫之前，或在完成思考後開始一個之前，Claude Code 會重試請求或以錯誤結束回合。[Automatic retries](#automatic-retries) 說明它重試哪些停滯以及重試多少次。
394* 在 Claude 完成文字區塊或工具呼叫之後，或在完成思考後開始一個，但在 Claude 完成回應之前，Claude Code 會保留 Claude 完成的內容，從 Claude 完成的任何工具呼叫繼續回合，並顯示 [The response above may be incomplete](#the-response-above-may-be-incomplete)。在非互動式工作階段中，以及在任何工作階段中的子代理回應，Claude Code 可能會先提示 Claude 繼續回應；該項目說明何時執行以及何時您仍在那裡看到通知。407* 在 Claude 完成文字區塊或工具呼叫之後，或在完成思考後開始一個之後，但在 Claude 完成回應之前，Claude Code 會保留 Claude 完成的內容，從 Claude 完成的任何工具呼叫繼續回合，並顯示 [The response above may be incomplete](#the-response-above-may-be-incomplete)。在非互動式工作階段中，以及在任何工作階段中的 subagent 回應，Claude Code 可能會先提示 Claude 繼續回應；該項目說明何時執行以及何時您仍在那裡看到通知。
395* 在 Claude 完成回應之後，Claude Code 正常結束回合。408* 在 Claude 完成回應之後，Claude Code 正常結束回合。
396 409
397一旦資料恢復或重試成功，橫幅會自動清除。如果它在每次嘗試時重新出現，請將其視為 [network issue](#unable-to-connect-to-api)。在 v2.1.185 之前，橫幅在 10 秒後出現，措辭不同。410一旦資料恢復或重試成功，橫幅會自動清除。如果它在每次嘗試時重新出現，請將其視為 [network issue](#unable-to-connect-to-api)。在 v2.1.185 之前，橫幅在 10 秒後出現，措辭不同。
398 411
399當 Claude 正在諮詢 [advisor](/docs/zh-TW/advisor) 時，橫幅在 90 秒無資料後出現，而不是 20 秒，因為長時間的顧問審查可以發送超過 20 秒的任何內容。在 v2.1.214 之前，20 秒的閾值也適用於顧問呼叫，所以橫幅在顧問審查期間出現，即使沒有任何問題。412當 Claude 正在諮詢 [advisor](/docs/zh-TW/advisor) 時，橫幅在 90 秒無資料後出現，而不是 20 秒，因為長時間的 advisor 審查可能遠超過 20 秒都未發送任何內容。在 v2.1.214 之前，20 秒的閾值也適用於 advisor 呼叫，所以即使沒有任何問題，橫幅也會在 advisor 審查期間出現。
400 413
401<h3 id="tune-retry-behavior">414<h3 id="tune-retry-behavior">
402 調整重試行為415 調整重試行為
407| 變數 | 預設 | 效果 |420| 變數 | 預設 | 效果 |
408| :- | :- | :- |421| :- | :- | :- |
409| [`CLAUDE_CODE_MAX_RETRIES`](/docs/zh-TW/env-vars) | 10 | 重試嘗試次數。從 v2.1.186 開始上限為 15；從 v2.1.199 開始 `CLAUDE_CODE_RETRY_WATCHDOG` 會提高預設值並移除上限。降低它以在指令碼中更快地顯示故障。 |422| [`CLAUDE_CODE_MAX_RETRIES`](/docs/zh-TW/env-vars) | 10 | 重試嘗試次數。從 v2.1.186 開始上限為 15；從 v2.1.199 開始 `CLAUDE_CODE_RETRY_WATCHDOG` 會提高預設值並移除上限。降低它以在指令碼中更快地顯示故障。 |
410| [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/zh-TW/env-vars) | 未設定 | 在無人值守的工作階段（例如 CI 工作）中設定為 `1`，以無限期重試 `429` 和 `529` 容量錯誤，而不是在 `CLAUDE_CODE_MAX_RETRIES` 嘗試後失敗。Claude Code 在報告支出限制或耗盡使用額度的 `429` 上立即失敗，即使是來自 [gateway spend cap](#spend-limit-reached) 的重新設定排程。在 v2.1.239 之前，看門狗無限期重試這些。在 v2.1.199 或更新版本上，它也會提高其他暫時性錯誤（例如伺服器錯誤、逾時和連線中斷）的預設重試計數至 300，大約三小時的退避，如果您明確設定該變數，則移除 `CLAUDE_CODE_MAX_RETRIES` 的上限 15。如需快速模式請求，請參閱 [Handle rate limits](/docs/zh-TW/fast-mode#handle-rate-limits)。 |423| [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/zh-TW/env-vars) | 未設定 | 在無人值守的工作階段（例如 CI 工作）中設定為 `1`，以無限期重試 `429` 和 `529` 容量錯誤，而不是在 `CLAUDE_CODE_MAX_RETRIES` 次嘗試後失敗。當標準速度的請求收到報告支出限制或用量點數耗盡的 `429` 時，Claude Code 會立即失敗，即使該 `429` 來自按排程重設的 [gateway spend cap](#spend-limit-reached)。在 v2.1.239 之前，看門狗會無限期重試這些錯誤。如需快速模式請求，請參閱 [Handle rate limits](/docs/zh-TW/fast-mode#handle-rate-limits)。在 v2.1.199 或更新版本上，它也會將其他暫時性錯誤（例如伺服器錯誤、逾時和連線中斷）的預設重試次數提高至 300，大約三小時的退避，並在您明確設定 `CLAUDE_CODE_MAX_RETRIES` 時移除其上限 15。 |
411| [`API_TIMEOUT_MS`](/docs/zh-TW/env-vars) | 600000 | 每個請求的逾時（毫秒）。為慢速網路或代理提高它。它也會上限 Claude Code 等待回應標頭的時間，如 [No response from API](#no-response-from-api) 中所述。 |424| [`API_TIMEOUT_MS`](/docs/zh-TW/env-vars) | 600000 | 每個請求的逾時（毫秒）。在慢速網路或代理伺服器上請提高此值。它也會限制 Claude Code 等待回應標頭的時間上限，如 [No response from API](#no-response-from-api) 中所述。 |
412| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/zh-TW/env-vars) | 未設定 | 串流請求的第一個回應位元組的截止時間（毫秒）。需要 Claude Code v2.1.242 或更新版本。關於當此未設定時 Claude Code 如何選擇截止時間，請參閱 [No response from API](#no-response-from-api)。 |425| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/zh-TW/env-vars) | 未設定 | 串流請求的第一個回應位元組的截止時間（毫秒）。需要 Claude Code v2.1.242 或更新版本。關於當此未設定時 Claude Code 如何選擇截止時間，請參閱 [No response from API](#no-response-from-api)。 |
413 426
414<h2 id="server-errors">427<h2 id="server-errors">
415 伺服器錯誤428 伺服器錯誤
416</h2>429</h2>
417 430
418大多數這些錯誤來自推論提供者：Anthropic 在 Anthropic API 上的服務，以及該提供者在 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 或自訂閘道上的端點後面的服務。[Auto mode 無法判斷動作的安全性](#auto-mode-cannot-determine-the-safety-of-an-action)和[Agent 因 API 錯誤而提前終止](#agent-terminated-early-due-to-an-api-error)也涵蓋您這一方的原因，例如無法叫用分類器模型的 Amazon Bedrock 帳戶或達到使用限制的子代理。431大多數這些錯誤來自推論提供者：Anthropic 在 Anthropic API 上的服務，以及該提供者在 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 或自訂閘道上的端點後面的服務。[自動模式無法判斷動作的安全性](#auto-mode-cannot-determine-the-safety-of-an-action)和[Agent 因 API 錯誤而提前終止](#agent-terminated-early-due-to-an-api-error)也涵蓋您這一方的原因，例如無法叫用分類器模型的 Amazon Bedrock 帳戶或達到用量上限的 subagent。
419 432
420<h3 id="api-error-500-internal-server-error">433<h3 id="api-error-500-internal-server-error">
421 API Error: 500 Internal server error434 API Error: 500 Internal server error
427API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com.440API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com.
428```441```
429 442
430尾部句子名稱檢查服務健康狀況的位置，並因提供者而異。Amazon Bedrock、Google Cloud 的 Agent Platform 和 Microsoft Foundry 設定會名稱該提供者的服務狀態。自訂 `ANTHROPIC_BASE_URL` 會名稱閘道主機。443結尾的句子會指明檢查服務健康狀況的位置，並因提供者而異。Amazon Bedrock、Google Cloud 的 Agent Platform 和 Microsoft Foundry 設定會指明該提供者的服務狀態。自訂 `ANTHROPIC_BASE_URL` 會指明閘道主機。
431 444
432來自 API 本身的 5xx 表示 API 內部發生意外故障。它不是由您的提示、設定或帳戶引起的。445來自 API 本身的 5xx 表示 API 內部發生意外故障。它不是由您的提示詞、設定或帳戶引起的。
433 446
434當代理、負載平衡器或閘道以 HTML 錯誤頁面回應時，訊息會顯示狀態碼和頁面的標題，例如 `API Error: 502 Bad Gateway`。對於沒有標題的頁面，訊息會改為顯示狀態碼及其標準名稱。在 v2.1.281 之前，當頁面有標題時狀態碼被丟棄，當頁面沒有標題時列印頁面的原始標記。447當代理伺服器、負載平衡器或閘道以 HTML 錯誤頁面回應時，訊息會顯示狀態碼和頁面的標題，例如 `API Error: 502 Bad Gateway`。對於沒有標題的頁面，訊息會改為顯示狀態碼及其標準名稱。在 v2.1.281 之前，當頁面有標題時狀態碼被丟棄，當頁面沒有標題時列印頁面的原始標記。
435 448
436**該怎麼做：**449**該怎麼做：**
437 450
438* 檢查 [status.claude.com](https://status.claude.com) 或訊息中名稱的提供者狀態頁面，查看是否有活躍的事件451* 檢查 [status.claude.com](https://status.claude.com) 或訊息中指明的提供者狀態頁面，查看是否有活躍的事件
439* 等待一分鐘，然後再次傳送您的訊息。您的原始訊息仍在對話中，因此對於較長的提示，您可以輸入 `try again` 而不是貼上整個內容。452* 等待一分鐘，然後再次傳送您的訊息。您的原始訊息仍在對話中，因此對於較長的提示詞，您可以輸入 `try again` 而不是貼上整個內容。
440* 如果錯誤持續存在且沒有發佈的事件，請執行 `/feedback`，以便 Anthropic 可以使用您的請求詳細資訊進行調查。如果您的環境中無法使用 `/feedback`，請參閱[報告錯誤](#report-an-error)。453* 如果錯誤持續存在且沒有發佈的事件，請執行 `/feedback`，以便 Anthropic 可以使用您的請求詳細資訊進行調查。如果您的環境中無法使用 `/feedback`，請參閱[報告錯誤](#report-an-error)。
441 454
442<h3 id="api-error-repeated-529-overloaded-errors">455<h3 id="api-error-repeated-529-overloaded-errors">
449API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.462API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.
450```463```
451 464
452尾部句子因提供者而異，方式與上面的 500 錯誤相同。465結尾的句子因提供者而異，方式與上面的 500 錯誤相同。
453 466
454529 不是您的使用限制，也不會計入您的配額。467529 不是您的用量上限，也不會計入您的配額。
455 468
456**該怎麼做：**469**該怎麼做：**
457 470
458* 檢查 [status.claude.com](https://status.claude.com) 或訊息中名稱的提供者狀態頁面，查看容量通知471* 檢查 [status.claude.com](https://status.claude.com) 或訊息中指明的提供者狀態頁面，查看容量通知
459* 在幾分鐘後重試472* 在幾分鐘後重試
460* 執行 `/model` 並切換到不同的模型以繼續工作，因為容量是按模型追蹤的。Claude Code 會在一個模型負載特別高時提示您執行此操作，例如 `Opus is experiencing high load, please use /model to switch to Sonnet`。在 Fable 模型上，訊息會名稱 Fable。473* 執行 `/model` 並切換到不同的模型以繼續工作，因為容量是按模型追蹤的。Claude Code 會在一個模型負載特別高時提示您執行此操作，例如 `Opus is experiencing high load, please use /model to switch to Sonnet`。在 Fable 模型上，訊息會指明 Fable。
461 474
462 在 Claude Desktop 應用程式執行的工作階段中，例如 Code 標籤或 Cowork，訊息讀作 `Opus is experiencing high load. Switch to Sonnet.`，您可以使用應用程式的模型選擇器切換模型。475 在 Claude Desktop 應用程式執行的工作階段中，例如 Code 標籤或 Cowork，訊息讀作 `Opus is experiencing high load. Switch to Sonnet.`，您可以使用應用程式的模型選擇器切換模型。
463 476
476**該怎麼做：**489**該怎麼做：**
477 490
478* 重試請求491* 重試請求
479* 如果緩慢的網路或代理是原因，請按照[自動重試](#automatic-retries)中的說明提高 `API_TIMEOUT_MS`492* 如果緩慢的網路或代理伺服器是原因，請按照[自動重試](#automatic-retries)中的說明提高 `API_TIMEOUT_MS`
480* 如果逾時頻繁且您的網路在其他方面狀況良好，請參閱下面的[網路和連線錯誤](#network-and-connection-errors)493* 如果逾時頻繁且您的網路在其他方面狀況良好，請參閱下面的[網路和連線錯誤](#network-and-connection-errors)
481 494
482<h3 id="no-response-from-api">495<h3 id="no-response-from-api">
483 No response from API496 No response from API
484</h3>497</h3>
485 498
486Claude Code 傳送了串流請求，API 在第一個位元組的截止時間內沒有返回回應標頭，因此 Claude Code 中止了請求，而不是等待完整的 `API_TIMEOUT_MS` 請求逾時（預設為 10 分鐘）。Claude Code 最多再傳送一次請求，如果[重試預算](#tune-retry-behavior)允許的話。當重試也沒有得到回應時，該輪次以此訊息結束，該訊息顯示每次嘗試等待了多長時間。當您設定 [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/zh-TW/env-vars) 時，一次重試的上限不適用，Claude Code 會在[調整重試行為](#tune-retry-behavior)中描述的預算下重試。499Claude Code 傳送了串流請求，API 在第一個位元組的截止時間內沒有返回回應標頭，因此 Claude Code 中止了請求，而不是等待完整的 `API_TIMEOUT_MS` 請求逾時（預設為 10 分鐘）。Claude Code 最多再傳送一次請求，如果[重試預算](#tune-retry-behavior)允許的話。當重試也沒有得到回應時，該回合以此訊息結束，該訊息顯示每次嘗試等待了多長時間。當您設定 [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/zh-TW/env-vars) 時，一次重試的上限不適用，Claude Code 會在[調整重試行為](#tune-retry-behavior)中描述的預算下重試。
487 500
488```text theme={null}501```text theme={null}
489API Error: No response from API (waited 3m, then 10m on the retry). If a proxy or gateway on your network holds responses until they complete, raise API_TIMEOUT_MS or CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS to wait longer.502API Error: No response from API (waited 3m, then 10m on the retry). If a proxy or gateway on your network holds responses until they complete, raise API_TIMEOUT_MS or CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS to wait longer.
492Claude Code 分別為第一次嘗試的等待回應標頭和重試的等待設定：505Claude Code 分別為第一次嘗試的等待回應標頭和重試的等待設定：
493 506
494* **第一次嘗試**：當您將其設定為 1 或更多時，[`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/zh-TW/env-vars)，限制在 10 秒到 30 分鐘之間。否則 Claude Code 會使用[串流空閒監視程式](/docs/zh-TW/network-config#streaming-idle-watchdogs)中列出的位元組級監視程式逾時，因此改變該逾時的變數也會改變此等待。無論哪種方式，Claude Code 都會為請求正文的每 32KB 添加一秒。507* **第一次嘗試**：當您將其設定為 1 或更多時，[`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/zh-TW/env-vars)，限制在 10 秒到 30 分鐘之間。否則 Claude Code 會使用[串流空閒監視程式](/docs/zh-TW/network-config#streaming-idle-watchdogs)中列出的位元組級監視程式逾時，因此改變該逾時的變數也會改變此等待。無論哪種方式，Claude Code 都會為請求正文的每 32KB 添加一秒。
495* **重試**：比 `API_TIMEOUT_MS` 少一秒，預設略低於 10 分鐘，以便重試可以超過保持回應直到生成完成的代理或閘道。在 Amazon Bedrock 上，重試使用與第一次嘗試相同的截止時間，訊息顯示一個持續時間而不是兩個。508* **重試**：比 `API_TIMEOUT_MS` 少一秒，預設略低於 10 分鐘，以便重試可以超過保持回應直到生成完成的代理伺服器或閘道。在 Amazon Bedrock 上，重試使用與第一次嘗試相同的截止時間，訊息顯示一個持續時間而不是兩個。
496 509
497兩個等待都不超過正 `API_TIMEOUT_MS` 少一秒，正 `API_TIMEOUT_MS` 在 11 秒以下會關閉截止時間。位元組級監視程式僅在回應標頭到達後才開始，因此在此之後停止傳送位元組的回應遵循[停滯串流規則](#automatic-retries)而不是此截止時間。510兩個等待都不超過正 `API_TIMEOUT_MS` 少一秒，正 `API_TIMEOUT_MS` 在 11 秒以下會關閉截止時間。位元組級監視程式僅在回應標頭到達後才開始，因此在此之後停止傳送位元組的回應遵循[停滯串流規則](#automatic-retries)而不是此截止時間。
498 511
499**該怎麼做：**512**該怎麼做：**
500 513
501* 再次傳送您的訊息。您的原始訊息仍在對話中，因此對於較長的提示，您可以輸入 `try again` 而不是貼上整個內容。514* 再次傳送您的訊息。您的原始訊息仍在對話中，因此對於較長的提示詞，您可以輸入 `try again` 而不是貼上整個內容。
502* 如果重複出現，將其視為[網路或代理問題](#unable-to-connect-to-api)。515* 如果重複出現，將其視為[網路或代理伺服器問題](#unable-to-connect-to-api)。
503* 如果您網路上的代理或閘道保持回應直到完成，請提高 `API_TIMEOUT_MS` 以便重試等待更長時間。在 Amazon Bedrock 上，也請提高 `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`。516* 如果您網路上的代理伺服器或閘道保持回應直到完成，請提高 `API_TIMEOUT_MS` 以便重試等待更長時間。在 Amazon Bedrock 上，也請提高 `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`。
504* 如果第一次嘗試持續逾時，然後重試成功，請提高 `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` 以便第一次嘗試也等待足夠長的時間。517* 如果第一次嘗試持續逾時，然後重試成功，請提高 `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` 以便第一次嘗試也等待足夠長的時間。
505 518
506在 v2.1.242 之前，Claude Code 在未回應的串流請求失敗之前等待完整的 `API_TIMEOUT_MS` 請求逾時（預設為 10 分鐘）。在 v2.1.261 之前，重試等待與第一次嘗試相同的截止時間，訊息沒有顯示持續時間。519在 v2.1.242 之前，Claude Code 在未回應的串流請求失敗之前等待完整的 `API_TIMEOUT_MS` 請求逾時（預設為 10 分鐘）。在 v2.1.261 之前，重試等待與第一次嘗試相同的截止時間，訊息沒有顯示持續時間。
509 The response above may be incomplete522 The response above may be incomplete
510</h3>523</h3>
511 524
512串流請求在回應仍在進行中時失敗，在 Claude 完成一個文字區塊或工具呼叫之後，或在完成思考後開始一個。重新傳送請求可能會執行相同的工具呼叫兩次，因此 Claude Code 會保留 Claude 完成的輸出並附加此通知，而不是丟棄該輪次。您看到的變體名稱原因：525串流請求在回應仍在進行中時失敗，在 Claude 完成一個文字區塊或工具呼叫之後，或在完成思考後開始一個。重新傳送請求可能會執行相同的工具呼叫兩次，因此 Claude Code 會保留 Claude 完成的輸出並附加此通知，而不是丟棄該回合。您看到的變體會指明原因：
513 526
514```text theme={null}527```text theme={null}
515API Error: Server error mid-response. The response above may be incomplete.528API Error: Server error mid-response. The response above may be incomplete.
520API Error: The response stream was malformed. The response above may be incomplete.533API Error: The response stream was malformed. The response above may be incomplete.
521```534```
522 535
523* `Server error mid-response`：中流過載或 5xx 伺服器錯誤。此變體需要 Claude Code v2.1.199 或更高版本；在此之前，該情況會丟棄部分輸出並將整個輪次報告為錯誤。536* `Server error mid-response`：中流過載或 5xx 伺服器錯誤。此變體需要 Claude Code v2.1.199 或更高版本；在此之前，該情況會丟棄部分輸出並將整個回合報告為錯誤。
524* `Connection lost mid-response`：連線中斷。您也會在代理或閘道在回應完成之前乾淨地結束回應正文時看到此變體。537* `Connection lost mid-response`：連線中斷。您也會在代理伺服器或閘道在回應完成之前乾淨地結束回應正文時看到此變體。
525* `Your computer went to sleep mid-response`：Claude Code 偵測到您的電腦在回應串流時進入睡眠狀態。一旦您的電腦喚醒，Claude Code 會將連線視為中斷並停止從中讀取。538* `Your computer went to sleep mid-response`：Claude Code 偵測到您的電腦在回應串流時進入睡眠狀態。一旦您的電腦喚醒，Claude Code 會將連線視為中斷並停止從中讀取。
526* `Part of the response never arrived`：串流事件在 API 和 Claude Code 之間被丟棄，因此稍後的事件參考了從未到達的內容。在 v2.1.281 之前，此情況以 `API Error: Content block not found` 結束該輪次。539* `Part of the response never arrived`：串流事件在 API 和 Claude Code 之間被丟棄，因此稍後的事件參考了從未到達的內容。在 v2.1.281 之前，此情況以 `API Error: Content block not found` 結束該回合。
527* `The response stream was malformed`：已完成的內容區塊到達了事件，或事件到達時已損壞。損壞的事件是指其資料不是有效 JSON、其內容遺失或其內容與事件類型不符的事件。在 v2.1.284 之前，當具有無效 JSON 的事件在 Claude 完成其思考、文字區塊或工具呼叫後到達時，解析器的原始錯誤（例如以 `API Error: JSON Parse error` 開頭的錯誤）會出現。540* `The response stream was malformed`：已完成的內容區塊到達了事件，或事件到達時已損壞。損壞的事件是指其資料不是有效 JSON、其內容遺失或其內容與事件類型不符的事件。在 v2.1.284 之前，當具有無效 JSON 的事件在 Claude 完成其思考、文字區塊或工具呼叫後到達時，解析器的原始錯誤（例如以 `API Error: JSON Parse error` 開頭的錯誤）會出現。
528* `The response stopped arriving`：連線保持開啟但停止傳遞資料，因此串流空閒監視程式中止了它。在 v2.1.222 之前，Claude Code 也可能在通過 `ANTHROPIC_BASE_URL` 或 `ANTHROPIC_AWS_BASE_URL` 到達的[閘道](/docs/zh-TW/gateways)連線上報告此故障，同時伺服器的保活 ping 仍在到達，因為它只計算那裡解析的回應事件；升級會停止這些虛假逾時在這些路由上。通過提供者基礎 URL（例如 `ANTHROPIC_BEDROCK_BASE_URL`）到達的閘道不被位元組監視程式包裝；請參閱[串流空閒監視程式](/docs/zh-TW/network-config#streaming-idle-watchdogs)。541* `The response stopped arriving`：連線保持開啟但停止傳遞資料，因此串流空閒監視程式中止了它。在 v2.1.222 之前，Claude Code 也可能在通過 `ANTHROPIC_BASE_URL` 或 `ANTHROPIC_AWS_BASE_URL` 到達的[閘道](/docs/zh-TW/gateways)連線上報告此故障，同時伺服器的保活 ping 仍在到達，因為它只計算那裡解析的回應事件；升級會停止這些虛假逾時在這些路由上。通過提供者基礎 URL（例如 `ANTHROPIC_BEDROCK_BASE_URL`）到達的閘道不被位元組監視程式包裝；請參閱[串流空閒監視程式](/docs/zh-TW/network-config#streaming-idle-watchdogs)。
529 542
531 544
532當丟棄、重複或損壞的串流事件在 Claude 開始任何文字或工具呼叫之前到達時，您看不到此通知：545當丟棄、重複或損壞的串流事件在 Claude 開始任何文字或工具呼叫之前到達時，您看不到此通知：
533 546
534* 如果 Claude 只完成了其思考，Claude Code 會重新發出請求。當重新發出的串流以相同方式中斷時，該輪次以 `Part of the response never arrived and no response was produced. Try again.` 或 `The response stream was malformed and no response was produced. Try again.` 結束。547* 如果 Claude 只完成了其思考，Claude Code 會重新發出請求。當重新發出的串流以相同方式中斷時，該回合以 `Part of the response never arrived and no response was produced. Try again.` 或 `The response stream was malformed and no response was produced. Try again.` 結束。
535* 如果沒有完成任何內容，Claude Code 會改為重新傳送請求而不進行串流。如果您使用 [`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK`](/docs/zh-TW/env-vars) 關閉了該回退，該輪次會以 `API Error: Content block not found` 結束丟棄的事件或 `API Error: Content block already closed` 結束重複的事件。對於損壞的事件且回退關閉，該輪次以 `API Error: Stream event unreadable` 或解析器的原始錯誤結束。548* 如果沒有完成任何內容，Claude Code 會改為重新傳送請求而不進行串流。如果您使用 [`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK`](/docs/zh-TW/env-vars) 關閉了該備援，該回合會以 `API Error: Content block not found` 結束丟棄的事件或 `API Error: Content block already closed` 結束重複的事件。對於損壞的事件且備援關閉，該回合以 `API Error: Stream event unreadable` 或解析器的原始錯誤結束。
536 549
537在四種情況下，Claude Code 會在不立即顯示此通知的情況下處理故障：550在四種情況下，Claude Code 會在不立即顯示此通知的情況下處理故障：
538 551
539* 在回應的早期，Claude Code 要麼重試故障，要麼以不同的錯誤結束輪次。請參閱[自動重試](#automatic-retries)。552* 在回應的早期，Claude Code 要麼重試故障，要麼以不同的錯誤結束回合。請參閱[自動重試](#automatic-retries)。
540* 當這些故障之一在 Claude 完成回應後到達時，Claude Code 會保留完整回應並正常結束輪次，沒有此通知。在 v2.1.222 之前，Claude Code 在連線中斷或在回應完成後停滯時顯示此通知，並將輪次報告為錯誤，儘管回應是完整的。553* 當這些故障之一在 Claude 完成回應後到達時，Claude Code 會保留完整回應並正常結束回合，沒有此通知。在 v2.1.222 之前，Claude Code 在連線中斷或在回應完成後停滯時顯示此通知，並將回合報告為錯誤，儘管回應是完整的。
541* 在[非互動式工作階段](/docs/zh-TW/headless)中，例如 `-p` 執行、[Agent SDK](/docs/zh-TW/agent-sdk/overview) 執行或[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)，當截斷回應在主對話中且包含文字但沒有工具呼叫時，您不必自己傳送 `continue`：Claude Code 會保留部分輸出並提示 Claude 從停止的地方繼續，最多連續三次。您只有在 Claude Code 用完這些繼續後才會看到此通知。在 v2.1.246 之前，Claude Code 在第一次截斷時以此通知結束非互動式輪次。554* 在[非互動式工作階段](/docs/zh-TW/headless)中，例如 `-p` 執行、[Agent SDK](/docs/zh-TW/agent-sdk/overview) 執行或[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)，當截斷回應在主對話中且包含文字但沒有工具呼叫時，您不必自己傳送 `continue`：Claude Code 會保留部分輸出並提示 Claude 從停止的地方繼續，最多連續三次。您只有在 Claude Code 用完這些繼續後才會看到此通知。在 v2.1.246 之前，Claude Code 在第一次截斷時以此通知結束非互動式回合。
542* 在[子代理](/docs/zh-TW/sub-agents#api-errors-in-subagents)中，無論工作階段是否互動：當其截斷回應包含文字但沒有工具呼叫時，Claude Code 會提示子代理繼續。通知僅在這些繼續用完後才成為子代理的最後一條訊息。在 v2.1.257 之前，子代理在第一次截斷時顯示此通知。555* 在 [subagent](/docs/zh-TW/sub-agents#api-errors-in-subagents) 中，無論工作階段是否互動：當其截斷回應包含文字但沒有工具呼叫時，Claude Code 會提示 subagent 繼續。通知僅在這些繼續用完後才成為 subagent 的最後一條訊息。在 v2.1.257 之前，subagent 在第一次截斷時顯示此通知。
543 556
544**該怎麼做：**557**該怎麼做：**
545 558
546* 在互動式工作階段中，閱讀螢幕上保留的回應：Claude Code 保留 Claude 在錯誤之前完成的每個區塊，但在輪次結束時丟棄中斷的最後區塊，因此最後的句子或工具呼叫可能會遺失。回覆 `continue` 以讓 Claude 從其最後完成的區塊繼續。559* 在互動式工作階段中，閱讀螢幕上保留的回應：Claude Code 保留 Claude 在錯誤之前完成的每個區塊，但在回合結束時丟棄中斷的最後區塊，因此最後的句子或工具呼叫可能會遺失。回覆 `continue` 以讓 Claude 從其最後完成的區塊繼續。
547* 在[非互動式模式](/docs/zh-TW/headless)（`-p`）中：560* 在[非互動模式](/docs/zh-TW/headless)（`-p`）中：
548 * 使用預設文字輸出，Claude Code 會列印它仍然從輪次早期保留的最後完成的文字區塊，然後是此訊息。當它沒有保留任何內容時，Claude Code 會單獨列印此訊息，例如因為 Claude Code 在輪次中間壓縮了對話並清除了該文字。在 v2.1.219 之前，Claude Code 在 `-p` 文字輸出中只列印此訊息並丟棄它已經產生的回應。561 * 使用預設文字輸出，Claude Code 會列印它仍然從回合早期保留的最後完成的文字區塊，然後是此訊息。當它沒有保留任何內容時，Claude Code 會單獨列印此訊息，例如因為 Claude Code 在回合中間壓縮了對話並清除了該文字。在 v2.1.219 之前，Claude Code 在 `-p` 文字輸出中只列印此訊息並丟棄它已經產生的回應。
549 * 使用 `--output-format json` 或 `stream-json`，Claude Code 會在 `result` 欄位中報告此訊息。562 * 使用 `--output-format json` 或 `stream-json`，Claude Code 會在 `result` 欄位中報告此訊息。
550 * 一旦連線穩定，要繼續該輪次，請恢復工作階段並按照[繼續對話](/docs/zh-TW/headless#continue-conversations)中的說明傳送 `continue`。563 * 一旦連線穩定，要繼續該回合，請恢復工作階段並按照[繼續對話](/docs/zh-TW/headless#continue-conversations)中的說明傳送 `continue`。
551 564
552<h3 id="auto-mode-cannot-determine-the-safety-of-an-action">565<h3 id="auto-mode-cannot-determine-the-safety-of-an-action">
553 Auto mode cannot determine the safety of an action566 Auto mode cannot determine the safety of an action
554</h3>567</h3>
555 568
556[auto mode](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) 使用的模型無法產生決定來分類動作，因此 auto mode 沒有自動批准該動作。您看到的訊息取決於分類器如何失敗。569[自動模式](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode)用來分類動作的模型無法產生決定，因此自動模式沒有自動核准該動作。您看到的訊息取決於分類器如何失敗。
557 570
558讀取、搜尋和編輯您的工作目錄內的內容會跳過分類器，因此它們在所有這些情況下都能繼續工作。571讀取、搜尋和編輯您的工作目錄內的內容會跳過分類器，因此它們在所有這些情況下都能繼續工作。
559 572
563<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait a moment and then try this action again.576<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait a moment and then try this action again.
564```577```
565 578
566當 Claude Code 可以判斷故障類別時，它會在 `temporarily unavailable` 後面的括號中名稱該類別，例如 `<model> is temporarily unavailable (rate-limited), so auto mode cannot determine the safety of <tool> right now`。類別為 `(rate-limited)`、`(overloaded)`、`(server error)`、`(timed out)` 和 `(connection failed)`。如果 `(timed out)` 或 `(connection failed)` 重複，請檢查您的連線；請參閱[無法連線到 API](#unable-to-connect-to-api)。在 v2.1.229 之前，訊息從不名稱類別，讀作 `Wait briefly and then try this action again`。579當 Claude Code 可以判斷故障類別時，它會在 `temporarily unavailable` 後面的括號中指明該類別，例如 `<model> is temporarily unavailable (rate-limited), so auto mode cannot determine the safety of <tool> right now`。類別為 `(rate-limited)`、`(overloaded)`、`(server error)`、`(timed out)` 和 `(connection failed)`。如果 `(timed out)` 或 `(connection failed)` 重複，請檢查您的連線；請參閱[無法連線到 API](#unable-to-connect-to-api)。在 v2.1.229 之前，訊息從不指明類別，讀作 `Wait briefly and then try this action again`。
567 580
568當沒有類別符合時，訊息出現時括號中沒有類別；多個故障會產生該形式。在 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) 上，包括 [Mantle 端點](/docs/zh-TW/amazon-bedrock#use-the-mantle-endpoint)，當您的 AWS 帳戶無法叫用訊息中名稱的模型時，它也會出現，該故障在每次重試時重複，直到您的帳戶被授予存取該模型的權限。581當沒有類別符合時，訊息出現時括號中沒有類別；多個故障會產生該形式。在 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) 上，包括 [Mantle 端點](/docs/zh-TW/amazon-bedrock#use-the-mantle-endpoint)，當您的 AWS 帳戶無法叫用訊息中指明的模型時，它也會出現，該故障在每次重試時重複，直到您的帳戶被授予存取該模型的權限。
569 582
570**該怎麼做：**583**該怎麼做：**
571 584
572* 在幾秒後重試；Claude 會看到相同的訊息，通常會自動重試。暫時故障與 [auto mode 資格](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode)無關；您不需要變更設定585* 在幾秒後重試；Claude 會看到相同的訊息，通常會自動重試。暫時故障與[自動模式資格](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode)無關；您不需要變更設定
573* 如果重試持續失敗，請繼續進行唯讀任務，稍後再回到被阻止的動作586* 如果重試持續失敗，請繼續進行唯讀任務，稍後再回到被阻止的動作
574* 在 Amazon Bedrock 上，如果訊息在每次重試時返回，請檢查您的帳戶是否可以叫用它名稱的模型：對於標準 Amazon Bedrock 模型，確認您的 [IAM 政策](/docs/zh-TW/amazon-bedrock#iam-configuration)允許叫用它；對於 Mantle 模型 ID，[聯絡您的 AWS 帳戶團隊](/docs/zh-TW/amazon-bedrock#mantle-endpoint-errors)587* 在 Amazon Bedrock 上，如果訊息在每次重試時返回，請檢查您的帳戶是否可以叫用它指明的模型：對於標準 Amazon Bedrock 模型，確認您的 [IAM 政策](/docs/zh-TW/amazon-bedrock#iam-configuration)允許叫用它；對於 Mantle 模型 ID，[聯絡您的 AWS 帳戶團隊](/docs/zh-TW/amazon-bedrock#mantle-endpoint-errors)
575 588
576當分類器請求失敗是因為您的 OAuth 令牌過期或被另一個工作階段輪換時，Claude Code 會重新整理令牌並重試請求一次，因此例行令牌過期不會作為此訊息出現。在 v2.1.216 之前，過期或輪換的令牌會導致每個分類器請求失敗，auto mode 會以此訊息拒絕每個檢查的動作，直到令牌被重新整理。589當分類器請求失敗是因為您的 OAuth token 過期或被另一個工作階段輪換時，Claude Code 會重新整理 token 並重試請求一次，因此例行的 token 過期不會作為此訊息出現。在 v2.1.216 之前，過期或輪換的 token 會導致每個分類器請求失敗，自動模式會以此訊息拒絕每個檢查的動作，直到 token 被重新整理。
577 590
578當分類器返回無法解析的回應時：591當分類器返回無法解析的回應時：
579 592
592Auto mode could not evaluate this action and is blocking it for safety — a safety check separate from auto mode blocked this request because of earlier conversation content — it isn't about the action itself — run with --debug for details605Auto mode could not evaluate this action and is blocking it for safety — a safety check separate from auto mode blocked this request because of earlier conversation content — it isn't about the action itself — run with --debug for details
593```606```
594 607
595Claude Code 拒絕該動作，但告訴 Claude 這不是對該動作不安全的判斷，並繼續進行其他任務而不是重試。這些拒絕不計入 [auto mode 的暫停閾值](/docs/zh-TW/permission-modes#when-auto-mode-falls-back)。在[非互動式](/docs/zh-TW/headless) `-p` 執行中，Claude Code 不會停止執行。Claude 接收的內容取決於它在哪裡請求該動作：608Claude Code 拒絕該動作，但告訴 Claude 這不是對該動作不安全的判斷，並繼續進行其他任務而不是重試。這些拒絕不計入[自動模式的暫停閾值](/docs/zh-TW/permission-modes#when-auto-mode-falls-back)。在[非互動式](/docs/zh-TW/headless) `-p` 執行中，Claude Code 不會停止執行。Claude 接收的內容取決於它在哪裡請求該動作：
596 609
597* 對於 `-p` 執行中沒有 `--input-format stream-json` 的[背景子代理](/docs/zh-TW/sub-agents#run-subagents-in-foreground-or-background)，Claude Code 會返回包含 `Agent aborted: auto mode classifier request refused by the safety safeguard in headless mode` 的錯誤結果610* 對於 `-p` 執行中沒有 `--input-format stream-json` 的[背景 subagent](/docs/zh-TW/sub-agents#run-subagents-in-foreground-or-background)，Claude Code 會返回包含 `Agent aborted: auto mode classifier request refused by the safety safeguard in headless mode` 的錯誤結果
598* 在其他地方，包括互動式工作階段和 `-p` 執行的主對話，Claude Code 會將該拒絕返回給 Claude611* 在其他地方，包括互動式工作階段和 `-p` 執行的主對話，Claude Code 會將該拒絕返回給 Claude
599 612
600在 v2.1.225 之前，Claude Code 計算這些拒絕以達到暫停閾值，並返回與真正分類器區塊相同的拒絕訊息。613在 v2.1.225 之前，Claude Code 計算這些拒絕以達到暫停閾值，並返回與真正分類器區塊相同的拒絕訊息。
601 614
602**該怎麼做：**615**該怎麼做：**
603 616
604* 這不是對您的動作的決定。您對話中已有的內容在 auto mode 將對話傳送給分類器時觸發了 API 上的安全篩選器617* 這不是對您的動作的決定。您對話中已有的內容在自動模式將對話傳送給分類器時觸發了 API 上的安全篩選器
605* 重試無法幫助；相同的對話內容將再次觸發篩選器618* 重試無法幫助；相同的對話內容將再次觸發篩選器
606* 在互動式工作階段中，切換到不同的[權限模式](/docs/zh-TW/permission-modes)，以便您可以在提示時批准該動作619* 在互動式工作階段中，切換到不同的[權限模式](/docs/zh-TW/permission-modes)，以便您可以在提示時核准該動作
607* 開始一個新的對話，不包含觸發內容620* 開始一個新的對話，不包含觸發內容
608 621
609當對話增長超過分類器的上下文視窗時：622當對話增長超過分類器的上下文視窗時：
614 627
615動作發生的情況取決於 Claude 在哪裡請求它：628動作發生的情況取決於 Claude 在哪裡請求它：
616 629
617* 在互動式工作階段中，auto mode 會回退到該動作的正常權限提示，以便您可以手動批准或拒絕它630* 在互動式工作階段中，自動模式會改用該動作的正常權限提示，以便您可以手動核准或拒絕它
618* 對於 [非互動式](/docs/zh-TW/headless) `-p` 執行中沒有 `--input-format stream-json` 的[背景子代理](/docs/zh-TW/sub-agents#run-subagents-in-foreground-or-background)，Claude Code 會返回包含 `Agent aborted: auto mode classifier transcript exceeded context window in headless mode` 的錯誤結果，執行繼續631* 對於[非互動式](/docs/zh-TW/headless) `-p` 執行中沒有 `--input-format stream-json` 的[背景 subagent](/docs/zh-TW/sub-agents#run-subagents-in-foreground-or-background)，Claude Code 會返回包含 `Agent aborted: auto mode classifier transcript exceeded context window in headless mode` 的錯誤結果，執行繼續
619* 在 `-p` 執行中的其他地方，沒有 [`--permission-prompt-tool`](/docs/zh-TW/cli-reference#cli-flags)，沒有提示可以回退到，因此動作不執行，執行繼續632* 在 `-p` 執行中的其他地方，沒有 [`--permission-prompt-tool`](/docs/zh-TW/cli-reference#cli-flags)，沒有提示可以改用，因此動作不執行，執行繼續
620 633
621**該怎麼做：**634**該怎麼做：**
622 635
623* 在互動式工作階段中，在出現的提示中批准或拒絕該動作636* 在互動式工作階段中，在出現的提示中核准或拒絕該動作
624* 在互動式工作階段中，執行 `/compact` 以減少對話大小，以便後續動作再次適應分類器視窗637* 在互動式工作階段中，執行 `/compact` 以減少對話大小，以便後續動作再次適應分類器視窗
625 638
626<h3 id="the-server-returned-no-safety-verdict">639<h3 id="the-server-returned-no-safety-verdict">
627 The server returned no safety verdict640 The server returned no safety verdict
628</h3>641</h3>
629 642
630在[伺服器端分類器審查](/docs/zh-TW/permission-modes#server-side-classifier-review)下，當伺服器沒有給出判決時，auto mode 會拒絕一個動作。拒絕會在 Claude Code 可以判斷一個類別時在括號中名稱該類別，例如 `(timed out)`：643在[伺服器端分類器審查](/docs/zh-TW/permission-modes#server-side-classifier-review)下，當伺服器沒有給出判決時，自動模式會拒絕一個動作。拒絕會在 Claude Code 可以判斷一個類別時在括號中指明該類別，例如 `(timed out)`：
631 644
632```text theme={null}645```text theme={null}
633The server-side auto mode classifier gave no verdict (timed out), so auto mode cannot determine the safety of <tool>.646The server-side auto mode classifier gave no verdict (timed out), so auto mode cannot determine the safety of <tool>.
634```647```
635 648
636訊息的其餘部分告訴 Claude 一次重試是否可以幫助。在某些這些拒絕之前，Claude Code 會等待，以便 Claude 的下一次嘗試不會立即跟隨。在互動式工作階段中等待期間，微調器顯示 `Auto mode check unavailable` 並帶有倒計時，按 `Esc` 會中斷該輪次。649訊息的其餘部分告訴 Claude 一次重試是否可以幫助。在某些這些拒絕之前，Claude Code 會等待，以便 Claude 的下一次嘗試不會立即跟隨。在互動式工作階段中等待期間，微調器顯示 `Auto mode check unavailable` 並帶有倒計時，按 `Esc` 會中斷該回合。
637 650
638在連續十個回應都沒有判決後，auto mode 會停止該輪次：651在連續十個回應都沒有判決後，自動模式會停止該回合：
639 652
640```text theme={null}653```text theme={null}
641Auto mode is unavailable — the server returned no safety verdict for the last 10 responses, so Claude stopped. Send a message to try again, or switch out of auto mode.654Auto mode is unavailable — the server returned no safety verdict for the last 10 responses, so Claude stopped. Send a message to try again, or switch out of auto mode.
643 656
644停止訊息在每種工作階段中出現在不同的位置：657停止訊息在每種工作階段中出現在不同的位置：
645 658
646* 在互動式工作階段中，訊息作為警告出現在記錄中，輪次結束659* 在互動式工作階段中，訊息作為警告出現在逐字稿中，回合結束
647* 在[非互動式](/docs/zh-TW/headless) `-p` 執行中，執行結束並報告執行錯誤。使用預設文字輸出，訊息在 stderr 上列印660* 在[非互動式](/docs/zh-TW/headless) `-p` 執行中，執行結束並報告執行錯誤。使用預設文字輸出，訊息在 stderr 上列印。
648* 當[子代理](/docs/zh-TW/sub-agents)達到限制時，子代理在完成之前停止，Claude 會收到它產生的任何內容，並附帶 auto mode 停止它的說明661* 當 [subagent](/docs/zh-TW/sub-agents) 達到限制時，subagent 在完成之前停止，Claude 會收到它產生的任何內容，並附帶自動模式停止它的說明
649 662
650**該怎麼做：**663**該怎麼做：**
651 664
652* 傳送另一條訊息以讓 Claude 再試一次。回應計數重新開始。665* 傳送另一條訊息以讓 Claude 再試一次。回應計數重新開始。
653* 如果停止重複且您的請求通過[LLM 閘道或代理](/docs/zh-TW/llm-gateway)，檢查它是否縮短串流回應或重寫它們。[伺服器端分類器審查](/docs/zh-TW/permission-modes#server-side-classifier-review)說明哪個閘道行為會導致拒絕，[閘道相容性指南](/docs/zh-TW/llm-gateway-protocol#feature-pass-through)列出要保持不變的內容。666* 如果停止重複且您的請求通過 [LLM 閘道或代理伺服器](/docs/zh-TW/llm-gateway)，檢查它是否縮短串流回應或重寫它們。[伺服器端分類器審查](/docs/zh-TW/permission-modes#server-side-classifier-review)說明哪個閘道行為會導致拒絕，[閘道相容性指南](/docs/zh-TW/llm-gateway-protocol#feature-pass-through)列出要保持不變的內容。
654* 在啟動 Claude Code 之前設定 `CLAUDE_CODE_AUTO_MODE_SERVER=0` 以改用其自己的分類器請求。在 v2.1.281 之前，Claude Code 在直接連線到 Anthropic API 時不讀取該變數。667* 在啟動 Claude Code 之前設定 `CLAUDE_CODE_AUTO_MODE_SERVER=0` 以改用其自己的分類器請求。在 v2.1.281 之前，Claude Code 在直接連線到 Anthropic API 時不讀取該變數。
655* 要自己批准動作，請改為[切換出 auto mode](/docs/zh-TW/permission-modes#switch-permission-modes)668* 要自己核准動作，請改為[切換出自動模式](/docs/zh-TW/permission-modes#switch-permission-modes)
656 669
657在 v2.1.280 之前，Claude Code 立即拒絕來自沒有判決的回應的每個動作，從不停止該輪次。670在 v2.1.280 之前，Claude Code 立即拒絕來自沒有判決的回應的每個動作，從不停止該回合。
658 671
659<h3 id="agent-terminated-early-due-to-an-api-error">672<h3 id="agent-terminated-early-due-to-an-api-error">
660 Agent terminated early due to an API error673 Agent terminated early due to an API error
661</h3>674</h3>
662 675
663[子代理](/docs/zh-TW/sub-agents)的 API 請求終止失敗，例如因為達到使用限制或伺服器錯誤的重試用完，所以子代理在完成其任務之前停止。此訊息需要 Claude Code v2.1.199 或更高版本；在此之前，API 錯誤文字被返回給 Claude，就像它是子代理的結果一樣。676[subagent](/docs/zh-TW/sub-agents) 的 API 請求終止失敗，例如因為達到用量上限或伺服器錯誤的重試用完，所以 subagent 在完成其任務之前停止。此訊息需要 Claude Code v2.1.199 或更高版本；在此之前，API 錯誤文字被返回給 Claude，就像它是 subagent 的結果一樣。
664 677
665```text theme={null}678```text theme={null}
666Agent terminated early due to an API error: <error detail>679Agent terminated early due to an API error: <error detail>
668 681
669**該怎麼做：**682**該怎麼做：**
670 683
671* 將冒號後的錯誤詳細資訊與此頁面上的其自己的部分相符，例如[使用限制](#usage-limits)或[伺服器錯誤](#server-errors)，並遵循該部分的步驟684* 將冒號後的錯誤詳細資訊與此頁面上對應的部分相符，例如[用量上限](#usage-limits)或[伺服器錯誤](#server-errors)，並遵循該部分的步驟
672* 一旦基礎錯誤清除，請要求 Claude 重試任務或[恢復子代理](/docs/zh-TW/sub-agents#resume-subagents)685* 一旦基礎錯誤清除，請要求 Claude 重試任務或[恢復 subagent](/docs/zh-TW/sub-agents#resume-subagents)
673 686
674當速率限制、過載或伺服器錯誤中斷已經產生文字輸出的前景子代理時，Claude 會收到該部分輸出標記為不完整，而不是此錯誤。其唯一輸出是工具呼叫的子代理也會收到此錯誤；在 v2.1.199 中，該形狀返回了空部分結果。請參閱[子代理中的 API 錯誤](/docs/zh-TW/sub-agents#api-errors-in-subagents)。687當速率限制、過載或伺服器錯誤中斷已經產生文字輸出的前景 subagent 時，Claude 會收到該部分輸出標記為不完整，而不是此錯誤。其唯一輸出是工具呼叫的 subagent 也會收到此錯誤；在 v2.1.199 中，該形狀返回了空部分結果。請參閱 [subagent 中的 API 錯誤](/docs/zh-TW/sub-agents#api-errors-in-subagents)。
675 688
676<h2 id="usage-limits">689<h2 id="usage-limits">
677 使用限制690 使用限制
694 707
695Claude Code 會阻止進一步的請求，直到訊息中顯示的重設時間。工作階段和每週限制在所有模型中共享，因此切換模型不會恢復存取。Opus 和 Sonnet 限制各自僅適用於對該模型系列的請求，因此使用 `/model` 切換到該系列外的模型可讓您繼續工作。708Claude Code 會阻止進一步的請求，直到訊息中顯示的重設時間。工作階段和每週限制在所有模型中共享，因此切換模型不會恢復存取。Opus 和 Sonnet 限制各自僅適用於對該模型系列的請求，因此使用 `/model` 切換到該系列外的模型可讓您繼續工作。
696 709
697在使用 claude.ai 訂閱登入的互動式工作階段中，Claude Code 也可以在開啟的工作階段中等待，並在重設後不久繼續中斷的任務。等待時，工作階段底部的一行會顯示 `Usage limit reached · continuing automatically at 3:45pm · esc to cancel`。在空提示處按 `Esc` 可取消等待。請參閱[等待使用限制重設](/docs/zh-TW/interactive-mode#wait-for-a-usage-limit-to-reset)以了解您看到的內容、如何開始或取消等待，以及如何關閉自動繼續。在 v2.1.234 之前，Claude Code 不提供此等待功能。710在使用 claude.ai 訂閱登入的互動式工作階段中，Claude Code 也可以在開啟的工作階段中等待，並在重設後不久繼續中斷的任務。請參閱[等待用量上限重設](/docs/zh-TW/interactive-mode#wait-for-a-usage-limit-to-reset)以了解您看到的內容、如何開始或取消等待，以及如何關閉自動繼續。在 v2.1.234 之前，Claude Code 不提供此等待功能。
698 711
699使用量同時計入工作階段和每週額度。單次大量活動突發（例如大型工作流程扇出）可能會在工作階段視窗重設之前耗盡每週額度。712使用量同時計入工作階段和每週額度。單次大量活動突發（例如大型工作流程扇出）可能會在工作階段視窗重設之前耗盡每週額度。
700 713
879* 如果變更持續失敗，請改為在瀏覽器中從您的 [claude.ai 計費設定](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)進行變更892* 如果變更持續失敗，請改為在瀏覽器中從您的 [claude.ai 計費設定](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)進行變更
880 893
881<h2 id="authentication-errors">894<h2 id="authentication-errors">
882 驗證錯誤895 身分驗證錯誤
883</h2>896</h2>
884 897
885這些錯誤表示 Claude Code 無法向 API 證明您的身份。隨時執行 `/status` 以查看目前哪個認證資格處於活動狀態。898這些錯誤表示 Claude Code 無法向 API 證明您的身分。隨時執行 `/status` 即可查看目前使用中的憑證。
886 899
887<h3 id="not-logged-in">900<h3 id="not-logged-in">
888 未登入901 未登入
889</h3>902</h3>
890 903
891此工作階段沒有有效的認證資格可用。904此工作階段沒有可用的有效憑證。
892 905
893```text theme={null}906```text theme={null}
894Not logged in · Please run /login907Not logged in · Please run /login
895```908```
896 909
897在 Claude Desktop 應用程式執行的工作階段中，例如 Code 標籤或 Cowork，訊息讀作 `Authentication required · Sign in again to continue`，您從應用程式再次登入。910在由 Claude Desktop 應用程式執行的工作階段中（例如 Code 分頁或 Cowork），訊息會顯示為 `Authentication required · Sign in again to continue`，您需要從應用程式重新登入。
898 911
899**該怎麼做：**912如果您在另一個使用相同[設定目錄](/docs/zh-TW/claude-directory)的 Claude Code 視窗中以 claude.ai 帳戶登入，顯示此訊息的互動式工作階段會自動開始使用該登入，無需重新啟動。
913
914在 macOS 上的 v2.1.286 之前，您從另一個視窗登入後，工作階段可能仍持續顯示此訊息。在這些版本上，請重新啟動顯示此訊息的工作階段。
900 915
901* 執行 `/login` 以使用您的 Claude 訂閱或 Console 帳戶進行驗證916**處理方式：**
902* 如果您預期環境變數會驗證您，請確認 `ANTHROPIC_API_KEY` 已在啟動 `claude` 的 shell 中設定並匯出
903* 對於無法進行互動式登入的 CI 或自動化，請設定一個 [`apiKeyHelper`](/docs/zh-TW/settings-reference#apikeyhelper) 指令碼，在啟動時擷取金鑰
904* 請參閱[驗證優先順序](/docs/zh-TW/authentication#authentication-precedence)以瞭解當存在多個認證資格時 Claude Code 使用哪一個
905 917
906如果系統反覆提示您登入，請參閱[未登入或權杖已過期](/docs/zh-TW/troubleshoot-install#not-logged-in-or-token-expired)以取得系統時鐘檢查和 macOS 認證儲存復原步驟。918* 執行 `/login`，以您的 Claude 訂閱或 Console 帳戶進行身分驗證
919* 如果您預期由環境變數進行身分驗證，請確認 `ANTHROPIC_API_KEY` 已在您啟動 `claude` 的 shell 中設定並匯出
920* 對於無法進行互動式登入的 CI 或自動化作業，請設定一個 [`apiKeyHelper`](/docs/zh-TW/settings-reference#apikeyhelper) 指令碼，在啟動時取得金鑰
921* 請參閱[身分驗證優先順序](/docs/zh-TW/authentication#authentication-precedence)，了解存在多個憑證時 Claude Code 會使用哪一個
922
923如果您反覆被要求登入，請參閱[未登入或 token 已過期](/docs/zh-TW/troubleshoot-install#not-logged-in-or-token-expired)，了解系統時鐘檢查與 macOS 憑證儲存的復原步驟。
907 924
908<h3 id="could-not-resolve-authentication-method">925<h3 id="could-not-resolve-authentication-method">
909 無法解析驗證方法926 無法解析身分驗證方式
910</h3>927</h3>
911 928
912工作階段到達 API 用戶端時沒有任何認證資格。[背景工作階段](/docs/zh-TW/agent-view)和雲端工作階段在背景工作程序啟動時沒有認證資格時會顯示此訊息。互動式、`-p` 和 Agent SDK 執行會將相同條件報告為[未登入](#not-logged-in)，並僅將此字串寫入其偵錯記錄，因此如果您在那裡找到它，請改為遵循該項目。929工作階段在沒有任何憑證的情況下抵達了 API 用戶端。當 worker 在沒有憑證的情況下啟動時，[背景工作階段](/docs/zh-TW/agent-view)與雲端工作階段會顯示此訊息。互動式、`-p` 與 Agent SDK 執行會將相同狀況回報為[未登入](#not-logged-in)，並且只會將此字串寫入其偵錯日誌，因此若您是在日誌中看到它，請改為依照該項目處理。
913 930
914```text theme={null}931```text theme={null}
915Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted932Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted
916```933```
917 934
918在目前版本上，此錯誤表示背景工作程序沒有可用的認證資格。在 v2.1.174 之前，指派給閒置預初始化背景工作程序的背景工作階段即使在設定了有效認證資格時也可能以此方式失敗。在 v2.1.176 之前，在被聲稱之前處於閒置狀態的雲端工作階段也可能如此。請升級以復原。935在目前的版本中，此錯誤表示 worker 程序沒有可用的憑證。在 v2.1.174 之前，即使已設定有效的憑證，指派給閒置預先初始化 worker 的背景工作階段仍可能以此方式失敗。在 v2.1.176 之前，在被認領前閒置的雲端工作階段也可能如此。請升級以復原。
919 936
920**該怎麼做：**937**處理方式：**
921 938
922* 如果此訊息出現在背景或雲端工作階段中，且您的認證資格已設定，請升級至 v2.1.176 或更新版本939* 如果此訊息出現在背景或雲端工作階段中，而您的憑證已經設定好，請升級至 v2.1.176 或更新版本
923* 確認 `ANTHROPIC_API_KEY`、`CLAUDE_CODE_OAUTH_TOKEN` 或您的雲端提供者認證資格已在啟動背景工作程序的環境中設定，而不僅在您的互動式 shell 中設定940* 確認 `ANTHROPIC_API_KEY`、`CLAUDE_CODE_OAUTH_TOKEN` 或您的雲端供應商憑證已在啟動 worker 的環境中設定，而不只是在您的互動式 shell 中
924* 對於 Agent SDK，請參閱[快速入門中的驗證設定](/docs/zh-TW/agent-sdk/quickstart#setup)941* 若使用 Agent SDK，請參閱[快速入門中的身分驗證設定](/docs/zh-TW/agent-sdk/quickstart#setup)
925* 在相同環境中的互動式工作階段中執行 `/status` 以確認哪個認證資格來源會解析942* 在相同環境的互動式工作階段中執行 `/status`，確認實際解析到的是哪個憑證來源
926 943
927<h3 id="invalid-api-key">944<h3 id="invalid-api-key">
928 無效的 API 金鑰945 無效的 API 金鑰
929</h3>946</h3>
930 947
931`ANTHROPIC_API_KEY` 環境變數或 `apiKeyHelper` 指令碼傳回的金鑰被 API 拒絕，或 Claude Code 在傳送前阻止了來自 `ANTHROPIC_API_KEY` 的金鑰。948`ANTHROPIC_API_KEY` 環境變數或 `apiKeyHelper` 指令碼傳回了被 API 拒絕的金鑰，或是 Claude Code 在傳送前就封鎖了來自 `ANTHROPIC_API_KEY` 的金鑰。
932 949
933```text theme={null}950```text theme={null}
934Invalid API key · Fix external API key951Invalid API key · Fix external API key
935```952```
936 953
937當訊息在 `Fix external API key` 之後繼續，並帶有描述（例如 `Invalid X-Api-Key header value from ANTHROPIC_API_KEY: it contains a line break at character 41 (120 characters on 2 lines).`）時，API 從未看到該金鑰。Claude Code 發現了 HTTP 標頭無法攜帶的字元，並在傳送前停止了請求。請參閱[無效的請求標頭值](#invalid-request-header-value)以瞭解如何讀取描述並修正該值。954當訊息在 `Fix external API key` 之後還接著一段描述，例如 `Invalid X-Api-Key header value from ANTHROPIC_API_KEY: it contains a line break at character 41 (120 characters on 2 lines).`，表示 API 從未收到該金鑰。Claude Code 發現了 HTTP 標頭無法承載的字元，並在傳送前停止了請求。請參閱[無效的請求標頭值](#invalid-request-header-value)，了解如何解讀該描述並修正值。
938 955
939**該怎麼做：**956**處理方式：**
940 957
941* 檢查拼寫錯誤，並確認金鑰未在 [Console](https://platform.claude.com/settings/keys) 中被撤銷958* 檢查是否有拼字錯誤，並在 [Console](https://platform.claude.com/settings/keys) 中確認金鑰未被撤銷
942* 在相同的 shell 中，執行 `env | grep ANTHROPIC`，或在 PowerShell 中執行 `Get-ChildItem Env:ANTHROPIC*`。direnv、dotenv shell 外掛程式和 IDE 終端機等工具可以從您專案中的 `.env` 檔案載入過時的金鑰，而無需您明確設定它959* 在同一個 shell 中執行 `env | grep ANTHROPIC`，或在 PowerShell 中執行 `Get-ChildItem Env:ANTHROPIC*`。direnv、dotenv shell 外掛以及 IDE 終端機等工具，可能會在您未明確設定的情況下，從專案中的 `.env` 檔案載入過時的金鑰。
943* 取消設定 `ANTHROPIC_API_KEY` 並執行 `/login` 以改用訂閱驗證960* 取消設定 `ANTHROPIC_API_KEY` 並執行 `/login`，改用訂閱進行身分驗證
944* 如果金鑰來自 [`apiKeyHelper`](/docs/zh-TW/settings-reference#apikeyhelper) 指令碼，請直接執行該指令碼以確認它在 stdout 上列印有效的金鑰961* 如果金鑰來自 [`apiKeyHelper`](/docs/zh-TW/settings-reference#apikeyhelper) 指令碼，請直接執行該指令碼，確認它會在 stdout 輸出有效的金鑰
945* 執行 `/status` 以確認 Claude Code 實際使用的認證資格來源962* 執行 `/status`，確認 Claude Code 實際使用的是哪個憑證來源
946 963
947<h3 id="your-apikeyhelper-script-is-failing">964<h3 id="your-apikeyhelper-script-is-failing">
948 您的 apiKeyHelper 指令碼失敗965 您的 apiKeyHelper 指令碼執行失敗
949</h3>966</h3>
950 967
951Claude Code 執行了您的 [`apiKeyHelper`](/docs/zh-TW/settings-reference#apikeyhelper) 設定中的命令，但沒有取回金鑰。沒有金鑰，請求會到達 API，並帶有預留位置認證資格，API 會以 `401` 拒絕它。終端機中的 `Authentication` 面板顯示發生了以下哪種情況：968Claude Code 執行了您 [`apiKeyHelper`](/docs/zh-TW/settings-reference#apikeyhelper) 設定中的命令，但沒有取得金鑰。沒有金鑰時，請求會帶著預留位置憑證抵達 API，API 會以 `401` 拒絕它。終端機中的 `Authentication` 面板會顯示發生的是下列哪一種情況：
952 969
953* 命令以錯誤結束或逾時970* 命令以錯誤結束或逾時
954* 命令未向 stdout 列印任何內容971* 命令沒有在 stdout 輸出任何內容
955* 命令列印了除金鑰以外的內容，例如登入橫幅或記錄行。面板顯示 `returned output that cannot be used as an API key` 並說明出了什麼問題，而不重複輸出。在 v2.1.227 之前，Claude Code 會傳送命令列印的任何內容，在修剪周圍空白後。972* 命令輸出了金鑰以外的內容，例如登入橫幅或日誌行。面板會顯示 `returned output that cannot be used as an API key` 並說明問題所在，但不會重複該輸出。在 v2.1.227 之前，Claude Code 會在去除前後空白後，直接傳送命令輸出的任何內容。
956 973
957```text theme={null}974```text theme={null}
958Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output975Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output
959```976```
960 977
961在[非互動式模式](/docs/zh-TW/headless)中，stderr 也會帶有具體原因，前綴為 `apiKeyHelper failed:`。978在[非互動模式](/docs/zh-TW/headless)中，stderr 也會帶有具體原因，並以 `apiKeyHelper failed:` 為前綴。
962 979
963Claude Code 會重新執行指令碼並在顯示此訊息之前最多重試請求兩次，因此失敗會在三次嘗試內出現。在 v2.1.208 之前，Claude Code 會花費完整的[重試預算](#automatic-retries)使用預留位置認證資格重新傳送請求，然後報告通用 `401` 驗證錯誤，而不是指令碼失敗。980在顯示此訊息之前，Claude Code 會重新執行指令碼並最多再重試請求兩次，因此失敗會在三次嘗試內浮現。在 v2.1.208 之前，Claude Code 會用完整個[重試額度](#automatic-retries)，以預留位置憑證重新傳送請求，然後回報一般的 `401` 身分驗證錯誤，而不是指令碼失敗。
964 981
965執行 `/login` 在這裡沒有幫助：只要設定存在，協助程式的輸出就會[優先於](/docs/zh-TW/authentication#authentication-precedence)已儲存的登入。982在此情況下執行 `/login` 沒有幫助：只要該設定存在，helper 的輸出就會[優先於](/docs/zh-TW/authentication#authentication-precedence)已儲存的登入。
966 983
967**該怎麼做：**984**處理方式：**
968 985
969* 直接在您的 shell 中執行在 `apiKeyHelper` 中設定的命令以重現失敗986* 直接在您的 shell 中執行 `apiKeyHelper` 中設定的命令，以重現失敗情況
970* 如果命令報告工作階段已過期，請使用您的認證資格提供者重新驗證，例如再次登入您的 SSO 或機密保管庫987* 如果命令回報工作階段已過期，請向您的憑證提供者重新進行身分驗證，例如重新登入您的 SSO 或密鑰保管庫
971* 修正命令，使其僅將金鑰列印到 stdout，作為單一可列印 ASCII 權杖，最多 16,384 個字元，並以代碼 0 結束。請參閱[使用 apiKeyHelper 輪換認證資格](/docs/zh-TW/llm-gateway-connect#rotate-credentials-with-apikeyhelper)以取得有效的設定。988* 修正命令，使其只將金鑰輸出至 stdout，格式為單一可列印 ASCII token、最多 16,384 個字元，並以退出碼 0 結束。請參閱[使用 apiKeyHelper 輪替憑證](/docs/zh-TW/llm-gateway-connect#rotate-credentials-with-apikeyhelper)以取得可用的設定範例。
972* 執行 `/status` 以確認 `apiKeyHelper` 是活動認證資格來源。`apiKeyHelper` 列顯示 `Failing` 及最後失敗的詳細資訊，例如結束代碼和命令的錯誤輸出，並在下次成功執行後消失。在 v2.1.274 之前，`/status` 僅顯示認證資格來源，不顯示失敗。989* 執行 `/status` 以查看失敗情況，並確認 `apiKeyHelper` 是使用中的憑證來源。`apiKeyHelper` 列會顯示 `Failing` 以及最近一次失敗的詳細資訊，例如退出碼與命令的錯誤輸出，並會在下一次成功執行後消失。在 v2.1.274 之前，`/status` 只會顯示憑證來源，不會顯示失敗情況。
973* 每次命令失敗時，其結束代碼和錯誤輸出也會出現在終端機中的 `Authentication` 面板中。在 v2.1.212 之前，該面板的標題為 `Cloud authentication`。990* 每次命令失敗時，其退出碼與錯誤輸出也會出現在終端機中的 `Authentication` 面板中。在 v2.1.212 之前，該面板的標題為 `Cloud authentication`。
974 991
975<h3 id="invalid-request-header-value">992<h3 id="invalid-request-header-value">
976 無效的請求標頭值993 無效的請求標頭值
977</h3>994</h3>
978 995
979Claude Code 即將作為請求標頭傳送的值包含 HTTP 標頭無法攜帶的字元：換行符、NUL 位元組或 `U+00FF` 以上的字元，例如彎引號或零寬空格。Claude Code 在傳送任何內容之前停止請求，並命名要修正的變數或設定。常見原因是從帶有隱藏字元或雜散換行符的文件或聊天中貼上的認證資格。996Claude Code 即將作為請求標頭傳送的值，包含 HTTP 標頭無法承載的字元：換行、NUL 位元組，或高於 `U+00FF` 的字元，例如彎引號或零寬度空格。Claude Code 會在傳送任何內容之前停止請求，並指出需要修正的變數或設定。常見原因是從文件或聊天中貼上的憑證帶有不可見字元或多餘的換行。
980 997
981Claude Code 在直接向 Claude API 或透過 [LLM 閘道](/docs/zh-TW/llm-gateway)傳送請求時執行此檢查。在第三方雲端提供者（例如 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock)）上，Claude Code 在傳送前不執行此檢查。998當 Claude Code 直接或透過 [LLM 閘道](/docs/zh-TW/llm-gateway)向 Claude API 傳送請求時，會執行此檢查。在第三方雲端供應商（例如 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock)）上，Claude Code 不會在傳送前執行此檢查。
982 999
983```text theme={null}1000```text theme={null}
984Invalid auth token · Fix external auth token1001Invalid auth token · Fix external auth token
986Invalid request header from the environment · Fix the environment variable1003Invalid request header from the environment · Fix the environment variable
987```1004```
988 1005
989訊息的第一部分取決於不良值的來源：1006訊息的第一部分取決於錯誤值的來源：
990 1007
991* `Invalid auth token`：來自 [`ANTHROPIC_AUTH_TOKEN`](/docs/zh-TW/env-vars) 或 [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/zh-TW/env-vars) 的持有人權杖1008* `Invalid auth token`：來自 [`ANTHROPIC_AUTH_TOKEN`](/docs/zh-TW/env-vars) 或 [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/zh-TW/env-vars) 的 bearer token
992* `Invalid ANTHROPIC_CUSTOM_HEADERS`：您在 [`ANTHROPIC_CUSTOM_HEADERS`](/docs/zh-TW/env-vars) 中設定的標頭名稱或值。描述計算哪個 `Name: Value` 對有問題，例如 `distinct header 2 of 3 parsed from ANTHROPIC_CUSTOM_HEADERS`，而不重複名稱或值，因為您選擇了兩者。1009* `Invalid ANTHROPIC_CUSTOM_HEADERS`：您在 [`ANTHROPIC_CUSTOM_HEADERS`](/docs/zh-TW/env-vars) 中設定的標頭名稱或值。描述會指出是第幾個 `Name: Value` 組合有問題，例如 `distinct header 2 of 3 parsed from ANTHROPIC_CUSTOM_HEADERS`，但不會重複名稱或值，因為兩者都是您自行選擇的。
993* `Invalid request header from the environment`：Claude Code 從另一個環境變數（例如 `CLAUDE_AGENT_SDK_CLIENT_APP`）複製到請求標頭中的值。描述命名要修正的變數。1010* `Invalid request header from the environment`：Claude Code 從另一個環境變數複製到請求標頭中的值，例如 `CLAUDE_AGENT_SDK_CLIENT_APP`。描述會指出需要修正的變數。
994 1011
995Claude Code 將此檢查捕獲的不良 `ANTHROPIC_API_KEY` 報告為[無效的 API 金鑰](#invalid-api-key)，具有相同的尾部描述。它將不良的已儲存 `/login` 認證資格報告為[未登入](#not-logged-in)；執行 `/login` 以儲存新的認證資格。[`apiKeyHelper`](/docs/zh-TW/settings-reference#apikeyhelper) 指令碼的輸出永遠不會到達此檢查：Claude Code 在指令碼執行時驗證它，標頭無法攜帶的輸出會失敗，並顯示[您的 apiKeyHelper 指令碼失敗](#your-apikeyhelper-script-is-failing)。1012Claude Code 會將此檢查攔截到的錯誤 `ANTHROPIC_API_KEY` 回報為[無效的 API 金鑰](#invalid-api-key)，並附上相同的結尾描述。對於已儲存的錯誤 `/login` 憑證，則會回報為[未登入](#not-logged-in)；請執行 `/login` 儲存新的憑證。[`apiKeyHelper`](/docs/zh-TW/settings-reference#apikeyhelper) 指令碼的輸出永遠不會經過此檢查：Claude Code 會在指令碼執行時驗證它，HTTP 標頭無法承載的輸出會以[您的 apiKeyHelper 指令碼執行失敗](#your-apikeyhelper-script-is-failing)失敗。
996 1013
997在第二個 `·` 之後，訊息描述問題，如此完整範例所示：1014在第二個 `·` 之後，訊息會描述問題，如以下完整範例所示：
998 1015
999```text theme={null}1016```text theme={null}
1000Invalid auth token · Fix external auth token · Invalid Authorization header value from ANTHROPIC_AUTH_TOKEN: it contains a line break at character 41 (120 characters on 2 lines).1017Invalid auth token · Fix external auth token · Invalid Authorization header value from ANTHROPIC_AUTH_TOKEN: it contains a line break at character 41 (120 characters on 2 lines).
1001```1018```
1002 1019
1003位置從 1 開始計算字元。描述是從固定短語和字元計數建立的，因此它永遠不包括值本身。它僅在字元是眾所週知的隱藏或排版字元（例如位元組順序標記、零寬空格或彎引號）時命名該字元，並將其他任何內容報告為 `a non-ASCII character`。1020位置從一開始計算字元。描述由固定片語與字元數組成，因此絕不會包含值本身。只有在問題字元是知名的不可見或排版字元時（例如位元組順序標記、零寬度空格或彎引號），描述才會指名該字元，其他字元一律回報為 `a non-ASCII character`。
1004 1021
1005**該怎麼做：**1022**處理方式：**
1006 1023
1007* 重新設定訊息命名的變數或設定，重新輸入報告位置周圍的字元，而不是從相同來源再次貼上1024* 重新設定訊息所指的變數或設定，重新輸入回報位置附近的字元，而不是再次從相同來源貼上
1008* 對於 `ANTHROPIC_CUSTOM_HEADERS`，每行保留一個 `Name: Value` 對，並重寫訊息計數的對1025* 對於 `ANTHROPIC_CUSTOM_HEADERS`，每行保留一組 `Name: Value`，並重新撰寫訊息所指出的那一組
1009* 執行 `/status` 以確認哪個認證資格來源處於活動狀態1026* 執行 `/status`，確認使用中的是哪個憑證來源
1010 1027
1011<h3 id="this-organization-has-been-disabled">1028<h3 id="this-organization-has-been-disabled">
1012 此組織已被停用1029 此組織已被停用
1013</h3>1030</h3>
1014 1031
1015Claude Code 正在使用來自已停用 Console 組織的過時 `ANTHROPIC_API_KEY`。當您有已儲存的訂閱登入時，金鑰會覆蓋它。1032Claude Code 正在使用來自已停用 Console 組織的過時 `ANTHROPIC_API_KEY`。當您有已儲存的訂閱登入時，該金鑰會覆寫它。
1016 1033
1017```text theme={null}1034```text theme={null}
1018Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your subscription instead1035Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your subscription instead
1020API Error: 400 ... This organization has been disabled.1037API Error: 400 ... This organization has been disabled.
1021```1038```
1022 1039
1023`·` 之後的提示取決於您的已儲存認證資格：當已儲存的 `/login` 可以在您取消設定金鑰後接管時出現第一種形式，當金鑰是您唯一的認證資格時出現第二種形式。1040`·` 之後的提示取決於您已儲存的憑證：當您取消設定金鑰後有已儲存的 `/login` 可接手時，會出現第一種形式；當金鑰是您唯一的憑證時，會出現第二種形式。
1024 1041
1025環境變數優先於 `/login`，因此在您的 shell 設定檔中匯出或從 `.env` 檔案載入的金鑰即使在您有有效的 Pro 或 Max 訂閱時也會被使用。在非互動式模式 (`-p`) 中，當存在金鑰時總是使用該金鑰。1042環境變數優先於 `/login`，因此即使您有可用的 Pro 或 Max 訂閱，在 shell 設定檔中匯出或從 `.env` 檔案載入的金鑰仍會被使用。在非互動模式（`-p`）中，只要金鑰存在就一定會被使用。
1026 1043
1027**該怎麼做：**1044**處理方式：**
1028 1045
1029* 在目前的 shell 中取消設定 `ANTHROPIC_API_KEY` 並從您的 shell 設定檔中移除它，然後重新啟動 `claude`1046* 在目前的 shell 中取消設定 `ANTHROPIC_API_KEY`，並從您的 shell 設定檔中移除它，然後重新啟動 `claude`
1030* 如果訊息說 `Update or unset`，您沒有已儲存的登入可以回退到。取消設定金鑰並執行 `/login`，或將金鑰替換為來自活動 Console 組織的金鑰。1047* 如果訊息顯示 `Update or unset`，表示您沒有可退回使用的已儲存登入。請取消設定金鑰並執行 `/login`，或將金鑰替換為來自使用中 Console 組織的金鑰。
1031* 之後執行 `/status` 以確認活動認證資格是您的訂閱1048* 之後執行 `/status`，確認使用中的憑證是您的訂閱
1032* 如果未設定環境變數且錯誤仍然存在，請聯絡支援或使用不同帳戶登入。1049* 如果沒有設定任何環境變數而錯誤仍然存在，請聯絡支援團隊或以其他帳戶登入。
1033 1050
1034<h3 id="your-organization-has-disabled-api-key-authentication">1051<h3 id="your-organization-has-disabled-api-key-authentication">
1035 您的組織已停用 API 金鑰驗證1052 您的組織已停用 API 金鑰身分驗證
1036</h3>1053</h3>
1037 1054
1038此訊息需要 Claude Code v2.1.169 或更新版本。您的 Console 組織管理員已關閉 API 金鑰驗證，因此 API 拒絕 Claude Code 正在傳送的金鑰。恢復提示在 `·` 之後會根據金鑰的來源而異：1055此訊息需要 Claude Code v2.1.169 或更新版本。您 Console 組織的管理員已關閉 API 金鑰身分驗證，因此 API 會拒絕 Claude Code 傳送的金鑰。`·` 之後的復原提示會依金鑰來源而不同：
1039 1056
1040```text theme={null}1057```text theme={null}
1041Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account1058Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account
1045Your organization has disabled API key authentication · Sign in again with your claude.ai account1062Your organization has disabled API key authentication · Sign in again with your claude.ai account
1046```1063```
1047 1064
1048最後一種形式出現在 Claude Desktop 應用程式執行的工作階段中，例如 Code 標籤或 Cowork，您從應用程式再次登入。1065最後一種形式出現在由 Claude Desktop 應用程式執行的工作階段中（例如 Code 分頁或 Cowork），您需要從應用程式重新登入。
1049 1066
1050環境變數和 `apiKeyHelper` 優先於 `/login`，因此在任一個仍在提供金鑰時單獨執行 `/login` 沒有幫助。請參閱[驗證優先順序](/docs/zh-TW/authentication#authentication-precedence)。1067環境變數與 `apiKeyHelper` 優先於 `/login`，因此只要其中任一項仍在提供金鑰，單獨執行 `/login` 並無幫助。請參閱[身分驗證優先順序](/docs/zh-TW/authentication#authentication-precedence)。
1051 1068
1052**該怎麼做：**1069**處理方式：**
1053 1070
1054* 如果訊息命名 `ANTHROPIC_API_KEY`，在目前的 shell 中取消設定它，並從您的 shell 設定檔或 `.env` 檔案中移除它，然後重新啟動 `claude`1071* 如果訊息指名 `ANTHROPIC_API_KEY`，請在目前的 shell 中取消設定它，並從您的 shell 設定檔或 `.env` 檔案中移除，然後重新啟動 `claude`
1055* 如果訊息命名 `apiKeyHelper`，從您的 `settings.json` 中移除 [`apiKeyHelper`](/docs/zh-TW/settings-reference#apikeyhelper) 設定1072* 如果訊息指名 `apiKeyHelper`，請從您的 `settings.json` 中移除 [`apiKeyHelper`](/docs/zh-TW/settings-reference#apikeyhelper) 設定
1056* 執行 `/login` 以使用您的 claude.ai 帳戶登入1073* 執行 `/login`，以您的 claude.ai 帳戶登入
1057* 之後執行 `/status` 以確認活動認證資格是您的訂閱，而不是 API 金鑰1074* 之後執行 `/status`，確認使用中的憑證是您的訂閱而非 API 金鑰
1058* 如果您需要 API 金鑰驗證來進行自動化，請要求您的組織管理員在 Console 中重新啟用它1075* 如果您的自動化作業需要 API 金鑰身分驗證，請要求組織管理員在 Console 中重新啟用
1059 1076
1060<h3 id="your-organization-has-disabled-claude-subscription-access">1077<h3 id="your-organization-has-disabled-claude-subscription-access">
1061 您的組織已停用 Claude 訂閱存取1078 您的組織已停用 Claude 訂閱存取
1062</h3>1079</h3>
1063 1080
1064您的 Claude 組織不允許使用訂閱登入登入 Claude Code。使用相同帳戶再次執行 `/login` 會傳回相同的錯誤。1081您的 Claude 組織不允許以訂閱登入方式登入 Claude Code。以相同帳戶再次執行 `/login` 會傳回相同的錯誤。
1065 1082
1066```text theme={null}1083```text theme={null}
1067Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access1084Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access
1068```1085```
1069 1086
1070這是伺服器端組織設定，因此無法從本機設定、環境變數或 CLI 旗標覆蓋。1087這是伺服器端的組織設定，因此無法透過本機設定、環境變數或 CLI 旗標覆寫。
1071 1088
1072Agent SDK 和 `-p` 非互動式模式將此呈現為 `oauth_org_not_allowed` 錯誤代碼。1089Agent SDK 與 `-p` 非互動模式會將此回報為 `oauth_org_not_allowed` 錯誤代碼。
1073 1090
1074**該怎麼做：**1091**處理方式：**
1075 1092
1076* 要求您的管理員為您的組織啟用 Claude Code 存取1093* 請您的管理員為您的組織啟用 Claude Code 存取
1077* 使用 Console API 金鑰而不是您的訂閱進行驗證。請參閱 [Claude Console 驗證](/docs/zh-TW/authentication#claude-console-authentication)以取得設定。1094* 改用 Console API 金鑰而非訂閱進行身分驗證。設定方式請參閱 [Claude Console 身分驗證](/docs/zh-TW/authentication#claude-console-authentication)。
1078* 如果您是管理員且看不到啟用存取的選項，請聯絡 [Anthropic 支援](https://support.claude.com)1095* 如果您是管理員卻看不到啟用存取的選項，請聯絡 [Anthropic 支援](https://support.claude.com)
1079 1096
1080<h3 id="routines-are-disabled-by-your-organizations-policy">1097<h3 id="routines-are-disabled-by-your-organizations-policy">
1081 您的組織政策已停用例行程序1098 您組織的政策已停用 routine
1082</h3>1099</h3>
1083 1100
1084An Owner in your Team or Enterprise organization has turned off routines at the organization level. The error appears when you try to create or run a routine, for example from the [Routines](/docs/zh-TW/routines) UI on claude.ai/code. On Claude Code v2.1.227 or later, the same setting also [hides `/schedule`](/docs/zh-TW/routines#troubleshooting) in the CLI.1101您 Team 或 Enterprise 組織中的 Owner 已在組織層級關閉 routine。當您嘗試建立或執行 routine 時（例如從 claude.ai/code 上的 [Routines](/docs/zh-TW/routines) UI），就會出現此錯誤。在 Claude Code v2.1.227 或更新版本上，相同的設定也會在 CLI 中[隱藏 `/schedule`](/docs/zh-TW/routines#troubleshooting)。
1085 1102
1086```text theme={null}1103```text theme={null}
1087Routines are disabled by your organization's policy.1104Routines are disabled by your organization's policy.
1088```1105```
1089 1106
1090這是伺服器端設定，因此無法從本機設定、環境變數或 CLI 旗標覆蓋。1107這是伺服器端設定，因此無法透過本機設定、環境變數或 CLI 旗標覆寫。
1091 1108
1092**該怎麼做：**1109**處理方式：**
1093 1110
1094* 要求您的組織中的擁有者在 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) 啟用**例行程序**切換1111* 請您組織中的 Owner 在 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) 啟用 **Routines** 切換開關
1095* 對於不需要組織層級例行程序的一次性排程工作，請參閱[排程工作](/docs/zh-TW/scheduled-tasks)1112* 對於不需要組織層級 routine 的一次性排程工作，請參閱[排程任務](/docs/zh-TW/scheduled-tasks)
1096 1113
1097<h3 id="remote-control-requires-the-anthropic-api">1114<h3 id="remote-control-requires-the-anthropic-api">
1098 Remote Control 需要 Anthropic API1115 Remote Control 需要 Anthropic API
1099</h3>1116</h3>
1100 1117
1101工作階段未直接與 Anthropic API 通訊，因此沒有 claude.ai 後端供 [Remote Control](/docs/zh-TW/remote-control) 配對。1118此工作階段並未直接與 Anthropic API 通訊，而這是 [Remote Control](/docs/zh-TW/remote-control) 所必需的。
1102 1119
1103```text theme={null}1120```text theme={null}
1104Remote Control is only available when using Claude via api.anthropic.com. CLAUDE_CODE_USE_BEDROCK is set, so this session is using Amazon Bedrock — unset it (or run in a shell without it) to use Remote Control.1121Remote Control is only available when using Claude via api.anthropic.com. CLAUDE_CODE_USE_BEDROCK is set, so this session is using Amazon Bedrock — unset it (or run in a shell without it) to use Remote Control.
1105```1122```
1106 1123
1107第二句解釋了什麼將工作階段路由到遠離 Anthropic API；在 v2.1.219 之前，訊息僅為第一句。根據原因，訊息命名：1124第二句說明了是什麼讓工作階段繞離了 Anthropic API；在 v2.1.219 之前，訊息只有第一句。視原因而定，訊息會指出：
1108 1125
1109* `CLAUDE_CODE_USE_*` 提供者變數，例如 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) 的 `CLAUDE_CODE_USE_BEDROCK` 或 [Google Cloud 的 Agent Platform](/docs/zh-TW/google-vertex-ai) 的 `CLAUDE_CODE_USE_VERTEX`1126* `CLAUDE_CODE_USE_*` 供應商變數，例如 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) 的 `CLAUDE_CODE_USE_BEDROCK` 或 [Google Cloud's Agent Platform](/docs/zh-TW/google-vertex-ai) 的 `CLAUDE_CODE_USE_VERTEX`
1110* [`ANTHROPIC_BASE_URL`](/docs/zh-TW/env-vars) 指向 `api.anthropic.com` 以外的主機，例如 [LLM 閘道](/docs/zh-TW/llm-gateway)或代理，即使您使用 claude.ai 登入；在 v2.1.196 之前，自訂基礎 URL 不會阻止 Remote Control1127* [`ANTHROPIC_BASE_URL`](/docs/zh-TW/env-vars) 指向 `api.anthropic.com` 以外的主機，例如 [LLM 閘道](/docs/zh-TW/llm-gateway)或代理伺服器，即使您以 claude.ai 登入亦然；在 v2.1.196 之前，自訂的 base URL 不會封鎖 Remote Control
1111* `ANTHROPIC_UNIX_SOCKET` 已設定，因此工作階段透過本機 socket 而不是向 `api.anthropic.com` 傳送其請求1128* 已設定 `ANTHROPIC_UNIX_SOCKET`，因此工作階段會透過本機 socket 傳送請求，而不是傳送至 `api.anthropic.com`
1112* 企業[雲端閘道](/docs/zh-TW/claude-apps-gateway)透過 `/login` 進行的登入，不支援 Remote Control，且沒有變數可取消設定1129* 透過 `/login` 進行的企業[雲端閘道](/docs/zh-TW/claude-apps-gateway)登入，此方式不支援 Remote Control，且沒有可取消設定的變數
1113 1130
1114**該怎麼做：**1131**處理方式：**
1115 1132
1116* 取消設定訊息命名的變數，例如 `CLAUDE_CODE_USE_BEDROCK` 或 `ANTHROPIC_BASE_URL`，並重新啟動工作階段，或從直接與 Anthropic API 通訊的工作階段啟動 Remote Control1133* 取消設定訊息所指的變數（例如 `CLAUDE_CODE_USE_BEDROCK` 或 `ANTHROPIC_BASE_URL`）並重新啟動工作階段，或從直接與 Anthropic API 通訊的工作階段啟動 Remote Control
1117* 如果變數未在您的 shell 中設定，請檢查您的[設定檔](/docs/zh-TW/settings#where-settings-live)中的 `env` 金鑰，該金鑰將環境變數套用到每個工作階段1134* 如果該變數未在您的 shell 中設定，請檢查[設定檔](/docs/zh-TW/settings#where-settings-live)中的 `env` 鍵，它會將環境變數套用至每個工作階段
1118* 對於此和其他 Remote Control 啟動訊息，請參閱[疑難排解 Remote Control](/docs/zh-TW/remote-control#troubleshooting)1135* 關於此訊息及其他 Remote Control 啟動訊息，請參閱 [Remote Control 疑難排解](/docs/zh-TW/remote-control#troubleshooting)
1119 1136
1120<h3 id="remote-control-couldnt-refresh-your-login">1137<h3 id="remote-control-couldnt-refresh-your-login">
1121 Remote Control 無法重新整理您的登入1138 Remote Control 無法重新整理您的登入
1122</h3>1139</h3>
1123 1140
1124Claude Code 在短期認證資格上執行即時 [Remote Control](/docs/zh-TW/remote-control) 連線，該認證資格是使用您已儲存的 claude.ai 登入取得和更新的。當 claude.ai 停止接受該登入，或 Claude Code 沒有剩餘的已儲存登入時，Claude Code 會停止 Remote Control 並需要您再次登入。任一失敗都可能在 Claude Code 仍在連線時或稍後在更新認證資格時發生。1141Claude Code 以短期憑證執行即時的 [Remote Control](/docs/zh-TW/remote-control) 連線，這些憑證是使用您已儲存的 claude.ai 登入取得並更新的。當 claude.ai 不再接受該登入，或 Claude Code 已沒有已儲存的登入時，Claude Code 會停止 Remote Control，並需要您重新登入。這兩種失敗都可能發生在 Claude Code 仍在連線時，或之後更新憑證時。
1125 1142
1126當 Claude Code 要求登入服務重新整理您的已儲存登入並且沒有收到答案時，它會保持 Remote Control 執行並在連線的目前認證資格仍然有效時再次嘗試重新整理。當 Claude Code 無法到達登入服務、請求逾時或服務在不拒絕您的登入的情況下失敗時，重新整理會沒有答案。如果登入服務在該認證資格過期時仍未回答，Claude Code 會停止 Remote Control 並報告 `OAuth token refresh failed`。1143當 Claude Code 要求登入服務重新整理您已儲存的登入卻沒有得到回應時，它會讓 Remote Control 繼續執行，並在連線目前的憑證仍有效期間再次嘗試重新整理。當 Claude Code 無法連上登入服務、請求逾時，或服務失敗但未拒絕您的登入時，重新整理就會得不到回應。如果在該憑證到期時登入服務仍未回應，Claude Code 會停止 Remote Control 並回報 `OAuth token refresh failed`。
1127 1144
1128當 Claude Code 停止 Remote Control 時，它會在警告和以 `Remote Control disconnected` 開頭的文字記錄行中顯示原因。您的本機工作階段會繼續執行，但沒有 Remote Control。本節涵蓋這些行：1145當 Claude Code 停止 Remote Control 時，會在警告以及以 `Remote Control disconnected` 開頭的逐字稿行中顯示原因。您的本機工作階段會在沒有 Remote Control 的情況下繼續執行。本節涵蓋以下幾行：
1129 1146
1130```text theme={null}1147```text theme={null}
1131Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control1148Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control
1137Remote Control disconnected — Signed out of Claude — run /login, then /remote-control1154Remote Control disconnected — Signed out of Claude — run /login, then /remote-control
1138```1155```
1139 1156
1140Claude Code 在訊息中間命名原因：1157Claude Code 會在訊息中間指出原因：
1141 1158
1142* ` Claude.ai login expired` 和 `Claude.ai login was rejected`：claude.ai 不再接受您的已儲存登入權杖，因為它已過期或被撤銷1159* `Claude.ai login expired` 與 `Claude.ai login was rejected`：claude.ai 不再接受您已儲存的登入 token，因為它已過期或被撤銷
1143* ` OAuth token unavailable`：當連線的認證資格到期進行更新時，Claude Code 沒有已儲存的登入權杖1160* `OAuth token unavailable`：當連線的憑證到期需要更新時，Claude Code 沒有已儲存的登入 token
1144* `OAuth token refresh failed`：claude.ai 在 Claude Code 重新連線時拒絕了您的已儲存登入權杖，重新整理權杖未產生新的權杖1161* `OAuth token refresh failed`：Claude Code 重新連線時，claude.ai 拒絕了您已儲存的登入 token，且重新整理 token 未產生新的 token
1145* `JWT refresh failed: no OAuth token`：Claude Code 找不到已儲存的登入權杖來更新1162* `JWT refresh failed: no OAuth token`：Claude Code 找不到可用於更新的已儲存登入 token
1146* ` Signed out of Claude`：您在此機器上登出，例如在另一個終端機中執行 `/logout`，因此 Claude Code 沒有剩餘的已儲存登入來更新連線1163* `Signed out of Claude`：您在這台機器上登出了，例如在另一個終端機中執行 `/logout`，因此 Claude Code 沒有剩餘的已儲存登入可用來更新連線
1147 1164
1148**該怎麼做：**1165**處理方式：**
1149 1166
1150* 執行 `/login` 以再次登入1167* 執行 `/login` 重新登入
1151* 執行 `/remote-control` 以重新連線工作階段。以 `run /login to restore Remote Control` 結尾的訊息不需要此步驟：Claude Code 在您登入後會自動重新連線。1168* 執行 `/remote-control` 重新連線工作階段。以 `run /login to restore Remote Control` 結尾的訊息不需要此步驟：您登入後 Claude Code 會自動重新連線。
1152 1169
1153在 v2.1.224 之前，`OAuth token refresh failed — run /login to re-authenticate` 讀作 `OAuth token refresh failed — re-authenticate, then re-enable Remote Control`，`JWT refresh failed: no OAuth token — run /login` 讀作 `no OAuth token available for recovery (code <N>)`。` Claude.ai login expired`、`Claude.ai login was rejected` 和 `OAuth token unavailable` 訊息已在 v2.1.225 中新增。1170在 v2.1.224 之前，`OAuth token refresh failed — run /login to re-authenticate` 顯示為 `OAuth token refresh failed — re-authenticate, then re-enable Remote Control`，而 `JWT refresh failed: no OAuth token — run /login` 顯示為 `no OAuth token available for recovery (code <N>)`。`Claude.ai login expired`、`Claude.ai login was rejected` 與 `OAuth token unavailable` 訊息是在 v2.1.225 新增的。
1154 1171
1155在 v2.1.238 之前，Claude Code 將現在說 `Signed out of Claude` 的情況報告為 `JWT refresh failed: no OAuth token — run /login`，並在一次登入重新整理沒有收到答案時立即停止 Remote Control，並顯示 `Claude.ai login expired — run /login to restore Remote Control`。1172在 v2.1.238 之前，Claude Code 會將現在顯示為 `Signed out of Claude` 的情況回報為 `JWT refresh failed: no OAuth token — run /login`，並且只要有一次登入重新整理沒有得到回應，就會以 `Claude.ai login expired — run /login to restore Remote Control` 停止 Remote Control。
1156 1173
1157<h3 id="remote-control-stopped-because-the-signed-in-account-changed">1174<h3 id="remote-control-stopped-because-the-signed-in-account-changed">
1158 Remote Control 因為已登入帳戶已變更而停止1175 由於登入的帳戶已變更，Remote Control 已停止
1159</h3>1176</h3>
1160 1177
1161Claude Code 在 [Remote Control](/docs/zh-TW/remote-control) 工作階段期間顯示此行，當您在此機器上登入不同的 claude.ai 帳戶或組織時。您在 Claude Code 工作階段外進行了切換，例如在另一個終端機中執行 `/login`。1178在 [Remote Control](/docs/zh-TW/remote-control) 工作階段期間，當您在這台機器上登入不同的 claude.ai 帳戶或組織時，Claude Code 會顯示此行。您是在 Claude Code 工作階段之外進行切換的，例如在另一個終端機中執行 `/login`。
1162 1179
1163您在透過 `/login` 登入時啟動的 Remote Control 工作階段屬於當時登入的 claude.ai 帳戶和組織。1180您透過 `/login` 登入時啟動的 Remote Control 工作階段，屬於當時已登入的 claude.ai 帳戶與組織。
1164 1181
1165```text theme={null}1182```text theme={null}
1166Remote Control disconnected — signed-in claude.ai account or organization changed on this machine — run /remote-control to start a session for the current account, or /login to switch back, then /remote-control1183Remote Control disconnected — signed-in claude.ai account or organization changed on this machine — run /remote-control to start a session for the current account, or /login to switch back, then /remote-control
1167```1184```
1168 1185
1169Claude Code 在 claude.ai 確認帳戶或組織已變更後立即停止 Remote Control 工作階段。您的本機工作階段會繼續執行，但沒有 Remote Control。1186一旦 claude.ai 確認帳戶或組織已變更，Claude Code 就會停止 Remote Control 工作階段。您的本機工作階段會在沒有 Remote Control 的情況下繼續執行。
1170 1187
1171**該怎麼做：**1188**處理方式：**
1172 1189
1173* 執行 `/remote-control` 以在目前帳戶或組織下啟動新的 Remote Control 工作階段1190* 執行 `/remote-control`，在目前的帳戶或組織下啟動新的 Remote Control 工作階段
1174* 若要切換回去，請執行 `/login` 並再次登入先前的帳戶或組織。然後執行 `/remote-control`。1191* 若要切換回去，請執行 `/login` 並重新登入先前的帳戶或組織，然後執行 `/remote-control`。
1175 1192
1176在 v2.1.234 之前，當您在 Claude Code 工作階段外切換到不同帳戶或組織時，Claude Code 沒有注意到。Claude Code 保持 Remote Control 工作階段連線，直到稍後對 Remote Control 伺服器的請求失敗，並顯示 `Remote Control server rejected the request (HTTP 404)`。該失敗可能在切換後數小時才出現。1193在 v2.1.234 之前，當您在 Claude Code 工作階段之外切換到不同的帳戶或組織時，Claude Code 不會察覺。Claude Code 會讓 Remote Control 工作階段保持連線，直到之後對 Remote Control 伺服器的請求以 `Remote Control server rejected the request (HTTP 404)` 失敗為止。該失敗可能在切換後數小時才出現。
1177 1194
1178<h3 id="remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts">1195<h3 id="remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts">
1179 Remote Control 因為執行工作階段的應用程式登出或切換帳戶而停止1196 由於執行工作階段的應用程式已登出或切換帳戶，Remote Control 已停止
1180</h3>1197</h3>
1181 1198
1182當 Claude 桌面應用程式或 IDE 主持您的工作階段時，Claude Code 從該應用程式而不是從 `/login` 取得其登入權杖。當 claude.ai 拒絕該權杖時，Claude Code 要求應用程式提供新的權杖。如果應用程式回答它已登出，或它現在已登入不同的 Claude 帳戶，Claude Code 會結束 [Remote Control](/docs/zh-TW/remote-control) 工作階段並向應用程式傳送以下其中一行：1199當 Claude 桌面應用程式或 IDE 託管您的工作階段時，Claude Code 會從該應用程式取得登入 token，而不是從 `/login`。當 claude.ai 拒絕該 token 時，Claude Code 會向應用程式要求新的 token。如果應用程式回應它已登出，或現在已登入不同的 Claude 帳戶，Claude Code 會結束 [Remote Control](/docs/zh-TW/remote-control) 工作階段，並向應用程式傳送下列其中一行：
1183 1200
1184```text theme={null}1201```text theme={null}
1185Remote Control stopped — the app running this session is now signed in to a different Claude account1202Remote Control stopped — the app running this session is now signed in to a different Claude account
1186Remote Control stopped — the app running this session is signed out of Claude. Sign in there, then turn Remote Control back on1203Remote Control stopped — the app running this session is signed out of Claude. Sign in there, then turn Remote Control back on
1187```1204```
1188 1205
1189您的本機工作階段會繼續執行，但沒有 Remote Control。1206您的本機工作階段會在沒有 Remote Control 的情況下繼續執行。
1190 1207
1191**該怎麼做：**1208**處理方式：**
1192 1209
1193* 如果應用程式已登出，請再次登入，然後在應用程式中重新開啟 Remote Control1210* 如果應用程式已登出，請重新登入，然後在應用程式中重新開啟 Remote Control
1194* 如果應用程式切換了帳戶，Claude Code 無法在新帳戶下繼續已結束的工作階段。在該帳戶下啟動新的 Remote Control 工作階段。1211* 如果應用程式切換了帳戶，Claude Code 無法在新帳戶下繼續已結束的工作階段。請在該帳戶下啟動新的 Remote Control 工作階段。
1195 1212
1196在 v2.1.238 之前，Claude Code 在兩種情況下都向應用程式傳送了[Remote Control 無法重新整理您的登入](#remote-control-couldnt-refresh-your-login)下列出的 `run /login` 訊息。1213在 v2.1.238 之前，這兩種情況下 Claude Code 都會向應用程式傳送列於 [Remote Control 無法重新整理您的登入](#remote-control-couldnt-refresh-your-login)中的 `run /login` 訊息。
1197 1214
1198<h3 id="oauth-token-revoked-or-expired">1215<h3 id="oauth-token-revoked-or-expired">
1199 OAuth 權杖已撤銷或已過期1216 OAuth token 已撤銷或已過期
1200</h3>1217</h3>
1201 1218
1202您的已儲存登入不再有效。撤銷的權杖表示您在任何地方登出或管理員移除了存取；已過期的權杖表示自動重新整理在工作階段中失敗。1219您已儲存的登入不再有效。token 被撤銷表示您已在所有地方登出，或管理員移除了存取權；token 過期則表示自動重新整理在工作階段中途失敗。
1203 1220
1204兩個訊息都報告 API 為 Claude Code 傳送的請求傳回的拒絕。當已儲存的登入在失敗的重新整理後已被清除時，您會看到[登入已過期](#login-expired)。如果您在 [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/zh-TW/env-vars) 中使用長期權杖進行驗證，當該權杖過期或被撤銷時，您會看到相同的訊息。1221這兩種訊息都是回報 API 針對 Claude Code 所傳送請求的拒絕。當已儲存的登入在重新整理失敗後已被清除時，您會改為看到[登入已過期](#login-expired)。如果您以 [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/zh-TW/env-vars) 中的長期 token 進行身分驗證，當該 token 過期或被撤銷時，您會看到相同的訊息。
1205 1222
1206```text theme={null}1223```text theme={null}
1207OAuth token revoked · Please run /login1224OAuth token revoked · Please run /login
1208Please run /login · API Error: 401 OAuth token has expired ...1225Please run /login · API Error: 401 OAuth token has expired ...
1209```1226```
1210 1227
1211**該怎麼做：**1228在[非互動模式](/docs/zh-TW/headless)（`-p`）與 [Agent SDK](/docs/zh-TW/agent-sdk/overview) 中，訊息如下，結構化錯誤代碼為 `authentication_failed`：
1212 1229
1213* 執行 `/login` 以再次登入1230```text theme={null}
1214* 如果您使用 `CLAUDE_CODE_OAUTH_TOKEN` 環境變數進行驗證，Claude Code 會在請求失敗並顯示 401 後繼續傳送您設定的值，而不是切換到已儲存登入的權杖。[`/status`](/docs/zh-TW/commands) 將此認證資格顯示為讀取 `CLAUDE_CODE_OAUTH_TOKEN` 的 `Auth token` 列。使用 [`claude setup-token`](/docs/zh-TW/authentication#generate-a-long-lived-token) 產生新的權杖並使用它重新啟動，或取消設定變數並執行 `/login`。在 v2.1.225 之前，Claude Code 可以在工作階段中期用已儲存登入的短期存取權杖替換變數的值，一旦該權杖過期，工作階段就會再次失敗，並顯示 401 錯誤。1231Failed to authenticate: OAuth token revoked. Please log in again or contact your administrator.
1215* 對於跨啟動的重複登入提示，請參閱[疑難排解](/docs/zh-TW/troubleshoot-install#not-logged-in-or-token-expired)中的系統時鐘檢查和 macOS 認證儲存復原步驟1232Failed to authenticate. API Error: 401 OAuth token has expired ...
1216* 對於其他失敗，包括 `403 Forbidden` 和 OAuth 瀏覽器問題，請參閱[登入和驗證](/docs/zh-TW/troubleshoot-install#login-and-authentication)1233```
1234
1235在 v2.1.287 之前，在非互動模式與 Agent SDK 中，撤銷訊息顯示為 `Your account does not have access to Claude. Please login again or contact your administrator.`
1236
1237**處理方式：**
1238
1239* 在 Claude Code 提示字元執行 `/login` 重新登入
1240* 如果您的 `-p` 命令或 Agent SDK 程式使用已儲存的登入，請在相同環境中執行 `claude`，完成 `/login`，然後重新執行命令或程式。對於無法互動式登入的自動化作業，請以 [`ANTHROPIC_API_KEY`](/docs/zh-TW/env-vars) 進行身分驗證，或[使用 `claude setup-token` 產生長期 token](/docs/zh-TW/authentication#generate-a-long-lived-token)。
1241* 如果您以 `CLAUDE_CODE_OAUTH_TOKEN` 環境變數進行身分驗證，在請求以 401 失敗後，Claude Code 會持續傳送您設定的值，而不會切換為已儲存登入的 token。[`/status`](/docs/zh-TW/commands) 會將此憑證顯示為一列內容為 `CLAUDE_CODE_OAUTH_TOKEN` 的 `Auth token`。請使用 [`claude setup-token`](/docs/zh-TW/authentication#generate-a-long-lived-token) 產生新的 token 並以其重新啟動，或取消設定該變數並執行 `/login`。在 v2.1.225 之前，Claude Code 可能會在工作階段中途以已儲存登入的短期存取 token 取代該變數的值，而當該 token 過期後，工作階段會再次以 401 錯誤失敗。
1242* 若每次啟動都反覆要求登入，請參閱[疑難排解](/docs/zh-TW/troubleshoot-install#not-logged-in-or-token-expired)中的系統時鐘檢查與 macOS 憑證儲存復原步驟
1243* 其他失敗（包括 `403 Forbidden` 與 OAuth 瀏覽器問題），請參閱[登入與身分驗證](/docs/zh-TW/troubleshoot-install#login-and-authentication)
1217 1244
1218<h3 id="api-error-401-invalid-authentication-credentials">1245<h3 id="api-error-401-invalid-authentication-credentials">
1219 API 錯誤：401 無效的驗證認證資格1246 API Error: 401 Invalid authentication credentials
1220</h3>1247</h3>
1221 1248
1222API 識別了您的認證資格格式，但拒絕了其背後的帳戶或組織。當認證資格最近被撤銷、組織被停用或移除了您的存取，或帳戶本身被停用時，Anthropic 會傳回此訊息，因此過期的權杖不是原因。認證資格可以是您的已儲存登入或已核准的 `ANTHROPIC_API_KEY`，修正方式不同，因此首先執行 `/status` 以查看哪一個處於活動狀態。1249API 辨識了您憑證的格式，但拒絕了其背後的帳戶或組織。當憑證最近被撤銷、組織已被停用或移除了您的存取權，或帳戶本身已被停用時，Anthropic 會傳回此訊息，因此原因並非 token 過期。該憑證可能是您已儲存的登入，也可能是已核准的 `ANTHROPIC_API_KEY`，而修正方式有所不同，因此請先執行 `/status` 查看使用中的是哪一個。
1223 1250
1224```text theme={null}1251```text theme={null}
1225Please run /login · API Error: 401 Invalid authentication credentials1252Please run /login · API Error: 401 Invalid authentication credentials
1226```1253```
1227 1254
1228**該怎麼做：**1255**處理方式：**
1229 1256
1230* 如果 `/status` 顯示未標記為未使用的 `API key` 列，則已核准的 [`ANTHROPIC_API_KEY`](/docs/zh-TW/authentication#authentication-precedence) 是活動認證資格，優先於您的登入，因此 `/login` 不會替換它。在 Claude Console 中輪換金鑰，或執行 `unset ANTHROPIC_API_KEY` 回退到您的訂閱，或在 PowerShell 中執行 `Remove-Item Env:ANTHROPIC_API_KEY`。1257* 如果 `/status` 顯示一列未標記為未使用的 `API key`，則已核准的 [`ANTHROPIC_API_KEY`](/docs/zh-TW/authentication#authentication-precedence) 是使用中的憑證且優先於您的登入，因此 `/login` 不會取代它。請在 Claude Console 中輪替金鑰，或執行 `unset ANTHROPIC_API_KEY`（在 PowerShell 中為 `Remove-Item Env:ANTHROPIC_API_KEY`）退回使用您的訂閱。
1231* 如果 `/status` 僅顯示您的登入，請執行 `/login` 一次。如果認證資格被撤銷，新的登入會替換它。1258* 如果 `/status` 只顯示您的登入，請執行一次 `/login`。如果憑證已被撤銷，新的登入會取代它。
1232* 如果相同的訊息對相同的登入帳戶返回，則帳戶或組織不再活動。檢查 `/status` 報告的帳戶和組織，並要求您的組織管理員恢復存取。1259* 如果相同的登入帳戶再次出現相同訊息，表示該帳戶或組織已不再有效。請檢查 `/status` 所回報的帳戶與組織，並請您的組織管理員恢復存取權。
1233* 如果 [`ANTHROPIC_BASE_URL`](/docs/zh-TW/env-vars) 指向 [LLM 閘道](/docs/zh-TW/llm-gateway)，`401` 之後的文字是您的閘道訊息，而不是 Anthropic 的訊息，`/login` 不會改變它。改為修正您的閘道期望的認證資格。1260* 如果 [`ANTHROPIC_BASE_URL`](/docs/zh-TW/env-vars) 指向 [LLM 閘道](/docs/zh-TW/llm-gateway)，`401` 之後的文字是您閘道的訊息而非 Anthropic 的訊息，`/login` 無法改變它。請改為修正您閘道所預期的憑證。
1234 1261
1235<h3 id="login-expired">1262<h3 id="login-expired">
1236 登入已過期1263 登入已過期
1237</h3>1264</h3>
1238 1265
1239Claude Code 嘗試更新您已儲存的 claude.ai 或 Claude Console 登入，OAuth 服務拒絕了已儲存的重新整理權杖，因此 Claude Code 清除了已儲存的認證資格。之後，每個模型請求在到達 API 之前都會在本機停止，並顯示此訊息，因為只有 `/login` 可以建立新的認證資格。1266Claude Code 嘗試更新您已儲存的 claude.ai 登入，但 OAuth 服務拒絕了已儲存的重新整理 token，因此 Claude Code 清除了已儲存的憑證。之後，每個模型請求都會在抵達 API 之前於本機以此訊息停止，因為只有 `/login` 能建立新的憑證。
1240 1267
1241在 v2.1.206 之前，Claude Code 無論如何都會傳送模型請求，並使用環境中剩餘的任何認證資格，每個模型都會失敗，並顯示[所選模型有問題](#theres-an-issue-with-the-selected-model)或 401，而不是登入提示。1268在 v2.1.206 之前，Claude Code 仍會使用環境中剩餘的任何憑證傳送模型請求，結果每個模型都以[所選模型有問題](#theres-an-issue-with-the-selected-model)或 401 失敗，而不是提示您登入。
1242 1269
1243```text theme={null}1270```text theme={null}
1244Login expired · Please run /login1271Login expired · Please run /login
1245```1272```
1246 1273
1247在[非互動式模式](/docs/zh-TW/headless)(`-p`) 和 [Agent SDK](/docs/zh-TW/agent-sdk/overview) 中，訊息讀作如下，結構化錯誤代碼為 `authentication_failed`：1274在[非互動模式](/docs/zh-TW/headless)（`-p`）與 [Agent SDK](/docs/zh-TW/agent-sdk/overview) 中，訊息如下，結構化錯誤代碼為 `authentication_failed`：
1248 1275
1249```text theme={null}1276```text theme={null}
1250Failed to authenticate: OAuth session expired and could not be refreshed1277Failed to authenticate: OAuth session expired and could not be refreshed
1251```1278```
1252 1279
1253這與[OAuth 權杖已撤銷或已過期](#oauth-token-revoked-or-expired)的狀態不同。這些訊息報告 API 傳回的拒絕。Claude Code 本身為已失敗更新的登入產生 `Login expired`，因此它不傳送請求。當更新失敗是因為帳戶本身被暫停而不是登入過時時，Claude Code 會改為顯示[您的帳戶已被暫停](#your-account-is-on-hold)。1280這與 [OAuth token 已撤銷或已過期](#oauth-token-revoked-or-expired)並非相同狀態。那些訊息回報的是 API 傳回的拒絕。`Login expired` 是 Claude Code 本身針對已無法更新的登入所產生的訊息，因此不會傳送任何請求。當更新失敗是因為帳戶本身遭到停權而非登入過時，Claude Code 會改為顯示[您的帳戶已遭暫停](#your-account-is-on-hold)。
1254 1281
1255使用 API 金鑰、[`CLAUDE_CODE_OAUTH_TOKEN`](/docs/zh-TW/env-vars) 或第三方提供者進行驗證的工作階段不使用已儲存的登入，永遠不會看到此訊息。1282以 API 金鑰、[`CLAUDE_CODE_OAUTH_TOKEN`](/docs/zh-TW/env-vars) 或第三方供應商進行身分驗證的工作階段不使用已儲存的登入，永遠不會看到此訊息。
1256 1283
1257您可以在請求失敗之前檢查此狀態：[`/status`](/docs/zh-TW/commands) 顯示讀作 `Expired — log in again` 的 `Login` 列，加上它為過期登入儲存的組織和電子郵件。該列僅在已儲存的登入是您的活動認證資格且無法再更新時出現。以其他方式進行驗證的工作階段不會顯示該列，即使已儲存的過期登入仍然存在。在 v2.1.210 之前，`/status` 在此狀態下沒有指示登入曾經存在過，因為已清除的認證資格沒有留下任何內容供其報告。1284您可以在請求失敗之前檢查此狀態：[`/status`](/docs/zh-TW/commands) 會顯示一列內容為 `Expired — log in again` 的 `Login`，以及它為過期登入所儲存的組織與電子郵件。只有當已儲存的登入是您使用中的憑證且已無法重新整理時，才會出現該列。以其他方式進行身分驗證的工作階段不會顯示該列，即使仍有已過期的登入被儲存。在 v2.1.210 之前，`/status` 在此狀態下不會顯示任何曾經存在登入的跡象，因為被清除的憑證讓它沒有可回報的內容。
1258 1285
1259**該怎麼做：**1286**處理方式：**
1260 1287
1261* 執行 `/login` 以再次登入。在不登入的情況下重試會在每個請求上顯示相同的訊息。1288* 執行 `/login` 重新登入。未登入就重試，每次請求都會顯示相同的訊息。
1262* 在非互動式模式中，在相同環境中執行 `claude`，完成 `/login`，然後重新執行您的命令。對於無法以互動方式登入的自動化，使用 `ANTHROPIC_API_KEY` 或[使用 `claude setup-token` 產生長期權杖](/docs/zh-TW/authentication#generate-a-long-lived-token)進行驗證。1289* 如果您在另一個 Claude Code 視窗中以 claude.ai 帳戶登入，請參閱[未登入](#not-logged-in)，了解此工作階段何時會自動開始使用該登入。
1263* 如果登入持續失敗，請參閱[登入和驗證](/docs/zh-TW/troubleshoot-install#login-and-authentication)1290* 在非互動模式中，請在相同環境中執行 `claude`，完成 `/login`，然後重新執行您的命令。對於無法互動式登入的自動化作業，請以 `ANTHROPIC_API_KEY` 進行身分驗證，或[使用 `claude setup-token` 產生長期 token](/docs/zh-TW/authentication#generate-a-long-lived-token)。
1291* 如果登入持續失敗，請參閱[登入與身分驗證](/docs/zh-TW/troubleshoot-install#login-and-authentication)
1264 1292
1265<h3 id="could-not-refresh-your-login">1293<h3 id="could-not-refresh-your-login">
1266 無法重新整理您的登入，因為另一個 Claude Code 程序正在重新整理它1294 由於另一個 Claude Code 程序正在重新整理，無法重新整理您的登入
1267</h3>1295</h3>
1268 1296
1269此訊息不表示您的登入被拒絕。您的已儲存 claude.ai 登入已過期，需要更新。此機器上的另一個 Claude Code 程序持有共用重新整理鎖定，或退出並將其留下，重新整理在此工作階段等待時沒有進展。Claude Code 在傳送前停止請求：1297此訊息並不表示您的登入被拒絕。您已儲存的 claude.ai 登入已過期且需要更新。同一台機器上的另一個 Claude Code 程序持有共用的重新整理鎖，或是已結束並遺留該鎖，而在此工作階段等待期間重新整理沒有任何進展。Claude Code 會在傳送前停止請求：
1270 1298
1271```text theme={null}1299```text theme={null}
1272Could not refresh your login because another Claude Code process is refreshing it (or exited mid-refresh) · Try again in a minute; if it keeps happening, close other Claude Code windows or sign in again with /login1300Could not refresh your login because another Claude Code process is refreshing it (or exited mid-refresh) · Try again in a minute; if it keeps happening, close other Claude Code windows or sign in again with /login
1273```1301```
1274 1302
1275在[非互動式模式](/docs/zh-TW/headless)(`-p`) 和 [Agent SDK](/docs/zh-TW/agent-sdk/overview) 中，訊息讀作如下，結構化錯誤代碼為 `server_error`：1303在[非互動模式](/docs/zh-TW/headless)（`-p`）與 [Agent SDK](/docs/zh-TW/agent-sdk/overview) 中，訊息如下，結構化錯誤代碼為 `server_error`：
1276 1304
1277```text theme={null}1305```text theme={null}
1278Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh. This is usually transient; retry in a minute, and if it persists close other Claude Code processes or sign in again1306Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh. This is usually transient; retry in a minute, and if it persists close other Claude Code processes or sign in again
1279```1307```
1280 1308
1281使用 API 金鑰、[`CLAUDE_CODE_OAUTH_TOKEN`](/docs/zh-TW/env-vars) 或第三方提供者進行驗證的工作階段不使用已儲存的登入，永遠不會看到此訊息。1309以 API 金鑰、[`CLAUDE_CODE_OAUTH_TOKEN`](/docs/zh-TW/env-vars) 或第三方供應商進行身分驗證的工作階段不使用已儲存的登入，永遠不會看到此訊息。
1282 1310
1283**該怎麼做：**1311**處理方式：**
1284 1312
1285* 一分鐘後重試。如果另一個程序首先完成重新整理，此工作階段會使用更新的登入。1313* 一分鐘後再試一次。如果另一個程序先完成了重新整理，此工作階段就會使用更新後的登入。
1286* 如果訊息持續返回，請關閉其他 Claude Code 視窗和程序，然後重試。1314* 如果訊息持續出現，請關閉其他 Claude Code 視窗與程序，然後重試。
1287* 如果在沒有其他 Claude Code 程序執行的情況下返回，請執行 `/login`。再次登入不會等待重新整理鎖定。1315* 如果在沒有其他 Claude Code 程序執行的情況下仍出現此訊息，請執行 `/login`。重新登入不需要等待重新整理鎖。
1288 1316
1289<h3 id="couldnt-save-your-login">1317<h3 id="couldnt-save-your-login">
1290 無法儲存您的登入1318 無法儲存您的登入
1291</h3>1319</h3>
1292 1320
1293您使用 claude.ai 登入，但 Claude Code 無法將登入儲存到其認證資格存放區，因此登入未完成。在 macOS 上，當登入鑰匙圈鎖定時（例如在睡眠或閒置時），在 Claude Code 已在同一工作階段中讀取或儲存認證資格之後，可能會發生這種情況。1321您已使用 claude.ai 登入，但 Claude Code 無法將登入儲存至其憑證儲存區，因此登入未完成。在 macOS 上，如果 Claude Code 在同一個工作階段中已經讀取或儲存過登入鑰匙圈中的憑證，之後鑰匙圈被鎖定（例如在睡眠或閒置時），就可能發生這種情況。
1294 1322
1295```text theme={null}1323```text theme={null}
1296Couldn't save your login. If your Mac's keychain is locked, unlock it and log in again.1324Couldn't save your login. If your Mac's keychain is locked, unlock it and log in again.
1297Couldn't save your login. Try logging in again.1325Couldn't save your login. Try logging in again.
1298```1326```
1299 1327
1300第一種形式出現在 macOS 上，第二種形式出現在其他地方。暫時性認證資格存放區失敗（例如逾時或無法讀取的存放區）會產生相同的訊息。1328第一種形式出現在 macOS 上，第二種則出現在其他所有平台上。暫時性的憑證儲存區失敗（例如逾時或儲存區無法讀取）也會產生相同的訊息。
1301 1329
1302**該怎麼做：**1330**處理方式：**
1303 1331
1304* 在 macOS 上，解鎖登入鑰匙圈，然後再次執行 `/login`1332* 在 macOS 上，解鎖登入鑰匙圈，然後再次執行 `/login`
1305* 在其他平台上，再次執行 `/login`1333* 在其他平台上，再次執行 `/login`
1306* 如果登入仍未儲存，請參閱[未登入或權杖已過期](/docs/zh-TW/troubleshoot-install#not-logged-in-or-token-expired)以取得鑰匙圈解鎖命令和其他認證資格儲存復原步驟1334* 如果登入仍無法儲存，請參閱[未登入或 token 已過期](/docs/zh-TW/troubleshoot-install#not-logged-in-or-token-expired)，了解鑰匙圈解鎖命令及其他憑證儲存復原步驟
1307 1335
1308<h3 id="failed-to-start-oauth-callback-server">1336<h3 id="failed-to-start-oauth-callback-server">
1309 無法啟動 OAuth 回呼伺服器1337 無法啟動 OAuth 回呼伺服器
1310</h3>1338</h3>
1311 1339
1312當 `/login`、`claude auth login` 或 `claude setup-token` 透過瀏覽器簽署您時，Claude Code 在 `127.0.0.1` 上開啟一個監聽連接埠，以便您的瀏覽器可以將登入結果傳回給它。此訊息表示 Claude Code 無法開啟該連接埠，登入在瀏覽器視窗或登入 URL 出現之前停止：1340當 `/login`、`claude auth login` 或 `claude setup-token` 透過瀏覽器為您登入時，Claude Code 會在 `127.0.0.1` 上開啟一個監聽埠，讓您的瀏覽器能將登入結果傳回給它。此訊息表示 Claude Code 無法開啟該埠，登入會在瀏覽器視窗或登入 URL 出現之前停止：
1313 1341
1314```text theme={null}1342```text theme={null}
1315Failed to start OAuth callback server: Failed to start server. Is port 0 in use?1343Failed to start OAuth callback server: Failed to start server. Is port 0 in use?
1316```1344```
1317 1345
1318如果您的訊息以 `Is port 0 in use?` 結尾，嘗試在 IPv4 loopback 位址 `127.0.0.1` 上監聽的嘗試完全失敗。因為失敗發生在登入 URL 存在之前，`Paste code here if prompted` 流程不可用作為解決方法。1346如果您的訊息以 `Is port 0 in use?` 結尾，表示在 IPv4 回送位址 `127.0.0.1` 上監聽的嘗試直接失敗了。由於失敗發生在登入 URL 產生之前，`Paste code here if prompted` 流程無法作為替代方案。
1319 1347
1320**該怎麼做：**1348**處理方式：**
1321 1349
1322* 若要立即登入而無需本機監聽器：如果您使用 claude.ai 訂閱，請在登入有效的機器上執行 [`claude setup-token`](/docs/zh-TW/authentication#generate-a-long-lived-token)，並將其列印的權杖設定為此機器上的 `CLAUDE_CODE_OAUTH_TOKEN`。否則將 `ANTHROPIC_API_KEY` 設定為 [Claude Console](https://platform.claude.com/settings/keys) 中的金鑰。[驗證優先順序](/docs/zh-TW/authentication#authentication-precedence)解釋 Claude Code 如何在認證資格之間進行選擇。1350* 若要在不使用本機監聽器的情況下立即登入：如果您使用 claude.ai 訂閱，請在可以正常登入的機器上執行 [`claude setup-token`](/docs/zh-TW/authentication#generate-a-long-lived-token)，並在這台機器上將其輸出的 token 設定為 `CLAUDE_CODE_OAUTH_TOKEN`。否則，請將 `ANTHROPIC_API_KEY` 設定為來自 [Claude Console](https://platform.claude.com/settings/keys) 的金鑰。[身分驗證優先順序](/docs/zh-TW/authentication#authentication-precedence)說明了 Claude Code 如何在多個憑證之間做選擇。
1323* 若要在此機器上改用瀏覽器登入，Claude Code 必須能夠在 `127.0.0.1` 上監聽。如果它在沙箱內執行，請檢查沙箱的政策是否允許在本機連接埠上監聽，然後再次執行 `/login`。如果它應該能夠並且仍然失敗，請執行 `/feedback`，以便報告包含您的環境詳細資訊。1351* 若要改為在這台機器上使用瀏覽器登入，Claude Code 必須能夠在 `127.0.0.1` 上監聽。如果它在沙箱中執行，請確認沙箱的政策允許在本機埠上監聽，然後再次執行 `/login`。如果它理應可以監聽卻仍然失敗，請執行 `/feedback`，讓回報中包含您的環境詳細資訊。
1324 1352
1325<h3 id="claude-login-not-accepted">1353<h3 id="claude-login-not-accepted">
1326 Claude 登入未被接受1354 不接受 Claude 登入
1327</h3>1355</h3>
1328 1356
1329您嘗試啟動[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)，伺服器以 401 拒絕建立它：它未接受此機器傳送的 Claude 登入，通常是因為登入已過期或被撤銷。1357您嘗試啟動[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)，但伺服器以 401 拒絕建立它：伺服器不接受這台機器所傳送的 Claude 登入，通常是因為登入已過期或被撤銷。
1330 1358
1331該行的第一部分是伺服器自己的原因（如果它給出的話）。否則該行讀作：1359如果伺服器有提供原因，該行的第一部分會是伺服器本身的原因。否則該行顯示為：
1332 1360
1333```text theme={null}1361```text theme={null}
1334Claude login not accepted · Run /login, then try again1362Claude login not accepted · Run /login, then try again
1335```1363```
1336 1364
1337**該怎麼做：**1365**處理方式：**
1338 1366
1339* 執行 `/login`，完成登入，然後再次啟動工作階段1367* 執行 `/login`，完成登入後再次啟動工作階段
1340 1368
1341<h3 id="artifacts-need-a-claude-ai-login">1369<h3 id="artifacts-need-a-claude-ai-login">
1342 工件需要 claude.ai 登入1370 Artifact 需要 claude.ai 登入
1343</h3>1371</h3>
1344 1372
1345Claude Code 拒絕了[工件](/docs/zh-TW/artifacts)發佈或讀取，因為工作階段沒有可用於工件的 claude.ai 登入。1373Claude Code 拒絕了 [artifact](/docs/zh-TW/artifacts) 的發布或讀取，因為此工作階段沒有可用於 artifact 的 claude.ai 登入。
1346 1374
1347訊息的每種形式都以相同的詞開頭，後面跟著取決於您的工作階段如何進行驗證的補救措施。沒有競爭認證資格時，它讀作：1375每種形式的訊息都以相同的文字開頭，後面接著依您工作階段的身分驗證方式而定的補救方法。在沒有競爭憑證的情況下，訊息顯示為：
1348 1376
1349```text theme={null}1377```text theme={null}
1350Artifacts need a claude.ai login. Run /login and select "Claude account with subscription", then retry — the "Anthropic Console account" option does not provide claude.ai credentials.1378Artifacts need a claude.ai login. Run /login and select "Claude account with subscription", then retry — the "Anthropic Console account" option does not provide claude.ai credentials.
1351```1379```
1352 1380
1353**該怎麼做：**1381**處理方式：**
1354 1382
1355* 執行 `/login` 並選擇**具有訂閱的 Claude 帳戶**。**Anthropic Console 帳戶**選項不提供 claude.ai 認證資格。1383* 執行 `/login` 並選擇 **Claude account with subscription**。**Anthropic Console account** 選項不提供 claude.ai 憑證。
1356* 當訊息命名優先的認證資格（例如 `ANTHROPIC_API_KEY`、`apiKeyHelper` 設定或先前 `/login` 儲存的 Console 金鑰）時，按訊息所說的方式移除它，然後執行 `/login`1384* 當訊息指名某個具有優先權的憑證（例如 `ANTHROPIC_API_KEY`、`apiKeyHelper` 設定，或先前 `/login` 所儲存的 Console 金鑰）時，請依訊息所述的方式移除它，然後執行 `/login`
1357* 當訊息說此遠端工作階段透過啟動它的機器進行驗證時，在該機器上登入 claude.ai，然後重新連線工作階段1385* 當訊息表示此遠端工作階段是透過啟動它的機器進行身分驗證時，請在該機器上登入 claude.ai，然後重新連線工作階段
1358* 當訊息說認證資格由工作階段的主機環境注入時，您無法在該工作階段中變更它；啟動已登入 claude.ai 的工作階段1386* 當訊息表示憑證是由工作階段的主機環境注入時，您無法在該工作階段中變更它；請啟動一個已登入 claude.ai 的工作階段
1359* 請參閱[可用性](/docs/zh-TW/artifacts#availability)以瞭解工件具有的其他要求，例如計畫、模型提供者和組織政策1387* 請參閱[可用性](/docs/zh-TW/artifacts#availability)，了解 artifact 的其他需求，例如方案、模型供應商與組織政策
1360 1388
1361<h3 id="administrator-policy-requires-a-cloud-gateway-sign-in">1389<h3 id="administrator-policy-requires-a-cloud-gateway-sign-in">
1362 管理員政策需要雲端閘道登入1390 管理員政策要求使用 Cloud 閘道登入
1363</h3>1391</h3>
1364 1392
1365此機器上的管理員[受管設定](/docs/zh-TW/managed-settings)將 [`forceLoginMethod`](/docs/zh-TW/settings-reference#forceloginmethod) 設定為 `"gateway"` 或設定 [`forceLoginGatewayUrl`](/docs/zh-TW/settings-reference#forcelogingatewayurl)。除非您透過 `CLAUDE_CODE_USE_BEDROCK` 等變數選擇雲端提供者，Claude Code 只接受 [Claude 應用程式閘道](/docs/zh-TW/claude-apps-gateway)登入。您會看到以下兩個訊息之一：1393管理員在這台機器上的[受管設定](/docs/zh-TW/managed-settings)將 [`forceLoginMethod`](/docs/zh-TW/settings-reference#forceloginmethod) 設定為 `"gateway"`，或設定了 [`forceLoginGatewayUrl`](/docs/zh-TW/settings-reference#forcelogingatewayurl)。除非您透過 `CLAUDE_CODE_USE_BEDROCK` 等變數選擇雲端供應商，否則 Claude Code 只會接受 [Claude apps 閘道](/docs/zh-TW/claude-apps-gateway)登入。您會看到下列兩種訊息之一：
1366 1394
1367```text theme={null}1395```text theme={null}
1368Not signed in to the Cloud gateway — run /login.1396Not signed in to the Cloud gateway — run /login.
1369```1397```
1370 1398
1371當工作階段沒有閘道登入時，模型請求會失敗，並顯示此訊息，例如因為您自政策到達機器後未執行 `/login`。1399當工作階段沒有閘道登入時，模型請求會以此訊息失敗，例如因為在政策套用到這台機器之後您尚未執行 `/login`。
1372 1400
1373如果您也有 `ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN` 或 `apiKeyHelper` 認證資格已設定，且受管設定設定了 `forceLoginMethod`，Claude Code 會在啟動時改為結束，並顯示以下開頭的訊息：1401如果這台機器還持有 Anthropic 核發的憑證，且受管設定設定了 `forceLoginMethod` 或 `forceLoginOrgUUID`，Claude Code 會改為在啟動時結束。該憑證可能是 `ANTHROPIC_API_KEY` 或 `ANTHROPIC_AUTH_TOKEN` 變數、`apiKeyHelper` 設定，或先前 Claude Console 登入所儲存的 API 金鑰。
1402
1403啟動訊息會指出工作階段所設定的憑證、其設定位置，以及移除它的步驟。例如，若您在 shell 中設定了 `ANTHROPIC_API_KEY` 變數，訊息會顯示為：
1374 1404
1375```text theme={null}1405```text theme={null}
1376Administrator policy requires a Cloud gateway sign-in on this machine; the1406Administrator policy requires a Cloud gateway sign-in on this machine, but this session is configured with an API key from ANTHROPIC_API_KEY, which a gateway machine does not accept.
1377Anthropic-issued credential configured here (ANTHROPIC_API_KEY,1407
1378ANTHROPIC_AUTH_TOKEN, or apiKeyHelper) is not used.1408To continue: unset ANTHROPIC_API_KEY (or run in a shell without it), then run claude and sign in with /login.
1379```1409```
1380 1410
1381**該怎麼做：**1411**處理方式：**
1412
1413* 對於 `Not signed in to the Cloud gateway`，請執行 `/login` 並在 **Cloud gateway** 畫面上完成登入
1414* 對於啟動訊息，請依照訊息結尾的步驟移除該憑證
1415* 如果您認為這台機器不應要求使用閘道，請要求管理該機器的管理員從其受管設定中移除 `forceLoginMethod` 與 `forceLoginGatewayUrl`
1382 1416
1383* 執行 `/login` 並在**雲端閘道**畫面上完成登入1417在 v2.1.284 之前，啟動訊息會列出可能的憑證，而不是指出所設定的那一個。訊息開頭為 `Administrator policy requires a Cloud gateway sign-in on this machine; the Anthropic-issued credential configured here (ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, or apiKeyHelper) is not used.`。如果您看到這段文字且無法判斷要移除哪個憑證，請更新至 v2.1.284 或更新版本，然後再次啟動 `claude`。
1384* 對於啟動訊息，移除您設定的 `ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN` 或 `apiKeyHelper` 設定，然後啟動 `claude` 並執行 `/login`
1385* 如果您認為機器不應該需要閘道，請要求管理該機器的管理員從其受管設定中移除 `forceLoginMethod` 和 `forceLoginGatewayUrl`
1386 1418
1387在 v2.1.265 上，迴歸也在某些使用 API 金鑰、`apiKeyHelper` 或自訂標頭進行驗證的 LLM 閘道和代理設定中顯示第一個訊息，即使機器上沒有管理員要求。更新至 v2.1.266 或更新版本。您不需要變更您的設定。1419在 v2.1.265 上，一個迴歸問題也會在某些以 API 金鑰、`apiKeyHelper` 或自訂標頭進行身分驗證的 LLM 閘道與代理伺服器設定中顯示第一則訊息，即使這台機器上沒有任何管理員要求亦然。請更新至 v2.1.266 或更新版本。您不需要變更設定。
1388 1420
1389在 v2.1.261 之前，在將 `forceLoginMethod` 設定為 `"gateway"` 的機器上，Claude Code 使用剩餘的已儲存登入，而不是失敗模型請求，並報告已設定的環境認證資格，並顯示 `This machine's managed settings require a first-party login` 而不是啟動訊息。在 v2.1.265 之前，其受管設定僅設定 `forceLoginGatewayUrl` 的機器不需要閘道登入，Claude Code 在那裡使用剩餘的認證資格。1421在 v2.1.261 之前，在將 `forceLoginMethod` 設定為 `"gateway"` 的機器上，Claude Code 會使用遺留的已儲存登入，而不是讓模型請求失敗，並以 `This machine's managed settings require a first-party login` 回報已設定的環境憑證，而不是顯示啟動訊息。
1390 1422
1391<h3 id="your-account-is-on-hold">1423<h3 id="your-account-is-on-hold">
1392 您的帳戶已被暫停1424 您的帳戶已遭暫停
1393</h3>1425</h3>
1394 1426
1395Claude 帳戶背後的登入已被暫停。Claude Code 在嘗試更新您的已儲存登入並瞭解暫停時顯示第一個訊息，在您在瀏覽器中完成的登入報告時顯示第二個訊息：1427您登入所使用的 Claude 帳戶已被停權。當 Claude Code 嘗試更新您已儲存的登入並得知暫停狀態時，會顯示第一則訊息；當您在瀏覽器中完成的登入回報此狀態時，會顯示第二則訊息：
1396 1428
1397```text theme={null}1429```text theme={null}
1398Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted1430Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted
1399Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted1431Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted
1400```1432```
1401 1433
1402使用相同帳戶再次登入不會清除訊息，因為暫停是在帳戶上，而不是登入上。在[非互動式模式](/docs/zh-TW/headless)(`-p`) 和 [Agent SDK](/docs/zh-TW/agent-sdk/overview) 中，結構化錯誤代碼為 `account_on_hold`。在 v2.1.235 之前，Claude Code 將被暫停的帳戶報告為[登入已過期 · 請執行 /login](#login-expired)，其復原步驟無法清除暫停。1434以相同帳戶重新登入不會清除此訊息，因為暫停是針對帳戶而非登入。在[非互動模式](/docs/zh-TW/headless)（`-p`）與 [Agent SDK](/docs/zh-TW/agent-sdk/overview) 中，結構化錯誤代碼為 `account_on_hold`。在 v2.1.235 之前，Claude Code 會將遭暫停的帳戶回報為 [Login expired · Please run /login](#login-expired)，而其復原步驟無法解除暫停。
1403 1435
1404**該怎麼做：**1436**處理方式：**
1405 1437
1406* 開啟訊息中的連結以檢視暫停的詳細資訊或對其提出異議1438* 開啟訊息中的連結，查看暫停的詳細資訊或提出申訴
1407* 如果您有另一個 Claude 帳戶或不受暫停影響的 API 金鑰，您可以在暫停解決期間繼續工作：執行 `/login` 使用該帳戶，或使用 `ANTHROPIC_API_KEY` 設定金鑰1439* 如果您有另一個不受暫停影響的 Claude 帳戶或 API 金鑰，可以在暫停解決期間繼續工作：以該帳戶執行 `/login`，或以 `ANTHROPIC_API_KEY` 設定金鑰
1408 1440
1409<h3 id="anthropic-profile-login-expired">1441<h3 id="anthropic-profile-login-expired">
1410 Anthropic 設定檔登入已過期1442 Anthropic 設定檔登入已過期
1411</h3>1443</h3>
1412 1444
1413Claude Code 透過 Anthropic 認證資格設定檔進行驗證，其已儲存的登入認證資格已過期，且設定檔沒有 Claude Code 可用來更新它的重新整理認證資格。Claude Code 在本機停止每個請求，不重試，因為重試會讀取相同的過期認證資格。1445Claude Code 正透過一個 Anthropic 憑證設定檔進行身分驗證，該設定檔中已儲存的登入憑證已過期，且設定檔中沒有 Claude Code 可用來更新它的重新整理憑證。Claude Code 會在本機停止每個請求而不重試，因為重試只會讀取相同的過期憑證。
1414 1446
1415```text theme={null}1447```text theme={null}
1416Anthropic profile login expired · Re-authenticate your Anthropic profile1448Anthropic profile login expired · Re-authenticate your Anthropic profile
1417Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile1449Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile
1418```1450```
1419 1451
1420這僅在活動認證資格來自 Anthropic 認證資格設定檔時出現，您可以使用 `ANTHROPIC_PROFILE` 環境變數選擇該設定檔，Claude Code 在您的 Anthropic 設定目錄中發現為活動設定檔，或 Claude Code 在您[登入時沒有 API 金鑰](/docs/zh-TW/authentication#sign-in-without-an-api-key)時寫入。使用 `/login` 的 claude.ai 選項、API 金鑰、持有人權杖（例如 `ANTHROPIC_AUTH_TOKEN`）或第三方提供者進行驗證的工作階段永遠不會看到此訊息。1452只有當使用中的憑證來自 Anthropic 憑證設定檔時才會出現此訊息，該設定檔可能是您以 `ANTHROPIC_PROFILE` 環境變數選擇的、Claude Code 在您的 Anthropic 設定目錄中探索到的使用中設定檔，或是 Claude Code 在您[無 API 金鑰登入](/docs/zh-TW/authentication#sign-in-without-an-api-key)時寫入的設定檔。以 API 金鑰、bearer token（例如 `ANTHROPIC_AUTH_TOKEN`）或第三方供應商進行身分驗證的工作階段永遠不會看到此訊息。
1421 1453
1422在[提供無金鑰登入](/docs/zh-TW/authentication#sign-in-without-an-api-key)的機器上，執行 `/login`，選擇 Anthropic Console 帳戶，然後再次登入以更新無金鑰 Console 登入或 Claude Platform CLI 的 `ant auth login` 寫入的設定檔。Claude Code 替換該設定檔中的過期認證資格。對於聯盟設定檔或另一個工具建立的設定檔，`/login` 不會更新認證資格。您看到的形式取決於您是否明確選擇了設定檔或 Claude Code 發現了它：1454在[提供無金鑰登入](/docs/zh-TW/authentication#sign-in-without-an-api-key)的機器上，若要更新由無金鑰 Console 登入或 Claude Platform CLI 的 `ant auth login` 所寫入的設定檔，請執行 `/login`，選擇 Anthropic Console 帳戶並重新登入。Claude Code 會取代該設定檔中的過期憑證。對於聯合設定檔或由其他工具建立的設定檔，`/login` 不會更新憑證。您看到哪一種形式，取決於設定檔是您選擇的還是 Claude Code 探索到的：
1423 1455
1424* 當您明確設定 `ANTHROPIC_PROFILE` 時，訊息以 `Re-authenticate your Anthropic profile` 結尾。1456* 當您明確設定 `ANTHROPIC_PROFILE` 時，訊息會以 `Re-authenticate your Anthropic profile` 結尾。
1425* 當 Claude Code 從您的設定目錄發現設定檔時，訊息提供 `/login`，因為 Claude Code 優先使用有效的 `/login` 而不是發現的設定檔，然後改為使用您的 claude.ai 或 Console 帳戶進行驗證。在 v2.1.234 之前，Claude Code 在此情況下也顯示 `Re-authenticate your Anthropic profile` 形式。1457* 當 Claude Code 從您的設定目錄探索到設定檔時，訊息會提供 `/login`，因為 Claude Code 會讓可用的 `/login` 優先於探索到的設定檔，並改以您的 claude.ai 或 Console 帳戶進行身分驗證。在 v2.1.234 之前，Claude Code 在這種情況下也會顯示 `Re-authenticate your Anthropic profile` 形式。
1426 1458
1427**該怎麼做：**1459**處理方式：**
1428 1460
1429* 再次登入設定檔，然後重試：在[提供無金鑰登入](/docs/zh-TW/authentication#sign-in-without-an-api-key)的機器上，執行 `/login` 並為無金鑰 Console 登入或 Claude Platform CLI 的 `ant auth login` 寫入的設定檔選擇 Anthropic Console 帳戶；對於其他設定檔，使用建立它們的工具1461* 重新登入設定檔，然後重試：在[提供無金鑰登入](/docs/zh-TW/authentication#sign-in-without-an-api-key)的機器上，對於由無金鑰 Console 登入或 Claude Platform CLI 的 `ant auth login` 所寫入的設定檔，請執行 `/login` 並選擇 Anthropic Console 帳戶；對於其他設定檔，請使用建立它們的工具
1430* 如果管理員佈建了設定檔的認證資格，請要求他們簽發新的認證資格1462* 如果設定檔的憑證是由管理員佈建的，請要求他們核發新的憑證
1431* 執行 `/status` 以確認活動認證資格來源和設定檔名稱1463* 執行 `/status`，確認使用中的憑證來源與設定檔名稱
1432* 若要停止使用設定檔，如果您設定了 `ANTHROPIC_PROFILE`，請取消設定它，然後以其他方式進行驗證，例如 `/login` 或 `ANTHROPIC_API_KEY`1464* 若要停止使用該設定檔，請在您有設定的情況下取消設定 `ANTHROPIC_PROFILE`，然後以其他方式進行身分驗證，例如 `/login` 或 `ANTHROPIC_API_KEY`
1433 1465
1434<h3 id="oauth-scope-requirement">1466<h3 id="oauth-scope-requirement">
1435 OAuth 範圍要求1467 OAuth 範圍需求
1436</h3>1468</h3>
1437 1469
1438已儲存的權杖早於較新功能需要的權限範圍：1470已儲存的 token 早於某個較新功能所需的權限範圍：
1439 1471
1440```text theme={null}1472```text theme={null}
1441OAuth token does not meet scope requirement: user:profile1473OAuth token does not meet scope requirement: user:profile
1442```1474```
1443 1475
1444**該怎麼做：**1476**處理方式：**
1445 1477
1446* 執行 `/login` 以取得具有目前範圍的新權杖。您不需要先登出。1478* 執行 `/login` 以取得具有目前範圍的新 token。您不需要先登出。
1447 1479
1448<h3 id="claude-ai-rejected-the-session-token">1480<h3 id="claude-ai-rejected-the-session-token">
1449 claude.ai 拒絕了工作階段權杖1481 claude.ai 拒絕了工作階段 token
1450</h3>1482</h3>
1451 1483
1452[claude.ai 連接器](/docs/zh-TW/mcp#use-mcp-servers-from-claude-ai)請求失敗，因為 claude.ai 拒絕了來自您的 Claude Code 登入的權杖。被拒絕的權杖是您的登入，而不是連接器在 claude.ai 中的自身授權，因此再次授權連接器不會解決它。在 `/mcp` 中，連接器顯示為 `connected · session token rejected`，其詳細資訊檢視讀作：1484[claude.ai 連接器](/docs/zh-TW/mcp#use-mcp-servers-from-claude-ai)請求失敗，因為 claude.ai 拒絕了來自您 Claude Code 登入的 token。被拒絕的 token 是您的登入，而不是連接器本身在 claude.ai 中的授權，因此重新授權連接器無法解決此問題。在 `/mcp` 中，該連接器會顯示為 `session token rejected`，其詳細資訊檢視顯示：
1453 1485
1454```text theme={null}1486```text theme={null}
1455claude.ai rejected the session token. Run /login, then reconnect.1487claude.ai rejected the session token. Run /login, then reconnect.
1456```1488```
1457 1489
1458**該怎麼做：**1490**處理方式：**
1459 1491
1460* 執行 `/login` 以再次登入1492* 執行 `/login` 重新登入
1461* 從 `/mcp` 重新連線連接器，或執行 `/mcp reconnect <server>`。在您再次登入之前重新連線會使連接器處於相同狀態。`/mcp` 面板的**重新連線**選項報告 `your claude.ai session token was rejected`；輸入的 `/mcp reconnect <server>` 形式報告成功重新連線，即使權杖仍被拒絕。1493* 從 `/mcp` 重新連線連接器，或執行 `/mcp reconnect <server>`。在重新登入之前重新連線，連接器會維持相同狀態。`/mcp` 面板的 **Reconnect** 選項會回報 `your claude.ai session token was rejected`；而輸入的 `/mcp reconnect <server>` 形式即使 token 仍被拒絕，也會回報重新連線成功。
1462 1494
1463在 v2.1.222 之前，Claude Code 改為將連接器標記為需要驗證，這指向您進行連接器的授權流程，即使完成它也不會解決狀態。1495在 v2.1.222 之前，Claude Code 會改將連接器標記為需要身分驗證，引導您前往連接器的授權流程，即使完成該流程也無法解決此狀態。
1464 1496
1465<h3 id="mcp-server-needs-you-to-sign-in-again">1497<h3 id="mcp-server-needs-you-to-sign-in-again">
1466 MCP 伺服器需要您再次登入1498 MCP 伺服器需要您重新登入
1467</h3>1499</h3>
1468 1500
1469遠端 [MCP 伺服器](/docs/zh-TW/mcp)在工作階段中期拒絕了工具呼叫上的認證資格，通常是因為登入或權杖已過期或因為權杖缺少工具需要的權限。工具呼叫失敗，`/mcp` 將伺服器標記為[需要驗證](/docs/zh-TW/mcp#authenticate-with-remote-mcp-servers)。1501遠端 [MCP 伺服器](/docs/zh-TW/mcp)在工作階段中途的工具呼叫時拒絕了憑證，通常是因為登入或 token 已過期，或是 token 缺少工具所需的權限。工具呼叫會失敗，且 `/mcp` 會將該伺服器標記為[需要身分驗證](/docs/zh-TW/mcp#authenticate-with-remote-mcp-servers)。
1470 1502
1471對於您從 Claude Code 登入的伺服器，包括 claude.ai 連接器，登入已過期或被撤銷：1503對於您從 Claude Code 登入的伺服器（包括 claude.ai 連接器），表示登入已過期或被撤銷：
1472 1504
1473```text theme={null}1505```text theme={null}
1474MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)1506MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)
1475```1507```
1476 1508
1477執行 `/mcp`，選擇伺服器，然後從其功能表再次登入。1509執行 `/mcp`，選擇該伺服器，並從其選單重新登入。
1478 1510
1479對於使用 [`headersHelper`](/docs/zh-TW/mcp#use-dynamic-headers-for-custom-authentication) 指令碼設定的伺服器，Claude Code 已重新執行協助程式並在顯示此訊息之前重試呼叫一次：1511對於以 [`headersHelper`](/docs/zh-TW/mcp#use-dynamic-headers-for-custom-authentication) 指令碼設定的伺服器，Claude Code 在顯示此訊息之前已經重新執行過 helper 並重試過一次呼叫：
1480 1512
1481```text theme={null}1513```text theme={null}
1482MCP server "<name>" rejected the credential from its headersHelper (check the helper and run /mcp to reconnect, or to authenticate if the server also uses OAuth)1514MCP server "<name>" rejected the credential from its headersHelper (check the helper and run /mcp to reconnect, or to authenticate if the server also uses OAuth)
1483```1515```
1484 1516
1485檢查協助程式傳回伺服器接受的認證資格，然後從 `/mcp` 重新連線，這會再次執行協助程式。1517請確認 helper 傳回的憑證是伺服器所接受的，然後從 `/mcp` 重新連線，這會再次執行 helper。
1486 1518
1487對於在其設定中具有靜態 `Authorization` 標頭的伺服器：1519對於設定中帶有靜態 `Authorization` 標頭的伺服器：
1488 1520
1489```text theme={null}1521```text theme={null}
1490MCP server "<name>" rejected the Authorization header in its config (update it, then run /mcp to reconnect)1522MCP server "<name>" rejected the Authorization header in its config (update it, then run /mcp to reconnect)
1491```1523```
1492 1524
1493在伺服器設定的位置更新標頭值，然後從 `/mcp` 重新連線。1525在設定該伺服器的位置更新標頭值，然後從 `/mcp` 重新連線。
1494 1526
1495在 v2.1.273 之前，已過期登入、`headersHelper` 和 `Authorization` 標頭情況都顯示 `MCP server "<name>" requires re-authorization (token expired)`。1527在 v2.1.273 之前，登入過期、`headersHelper` 與 `Authorization` 標頭這幾種情況都會顯示 `MCP server "<name>" requires re-authorization (token expired)`。
1496 1528
1497伺服器也可以拒絕帶有 HTTP 403 `insufficient_scope` 的工具呼叫，以要求您授權範圍，有時是您的權杖已列出的範圍。訊息命名該範圍：1529伺服器也可能以 HTTP 403 `insufficient_scope` 拒絕工具呼叫，要求您授權某個範圍，有時是您的 token 已列出的範圍。訊息會指出該範圍：
1498 1530
1499```text theme={null}1531```text theme={null}
1500MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate1532MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate
1501```1533```
1502 1534
1503執行 `/mcp`，選擇伺服器，然後從其功能表再次驗證。1535執行 `/mcp`，選擇該伺服器，並從其選單重新進行身分驗證。
1504 1536
1505當伺服器的設定既未設定 [`oauth.scopes`](/docs/zh-TW/mcp#restrict-oauth-scopes) 也未設定 [`authServerMetadataUrl`](/docs/zh-TW/mcp#override-oauth-metadata-discovery) 時，Claude Code 要求伺服器命名的範圍。使用任一設定，Claude Code 改為要求該設定的範圍。如果您釘選了 `oauth.scopes`，在再次驗證之前將遺漏的範圍新增到該列表。1537當伺服器的設定既未設定 [`oauth.scopes`](/docs/zh-TW/mcp#restrict-oauth-scopes) 也未設定 [`authServerMetadataUrl`](/docs/zh-TW/mcp#override-oauth-metadata-discovery) 時，Claude Code 會請求伺服器所指出的範圍。若有設定其中任一項，Claude Code 會改為請求該設定的範圍。如果您固定了 `oauth.scopes`，請在重新進行身分驗證之前，將缺少的範圍加入該清單。
1506 1538
1507在 v2.1.274 之前，此情況顯示 `needs you to sign in again` 訊息，在 v2.1.273 之前它顯示 `requires re-authorization (token expired)` 如其他情況。1539在 v2.1.274 之前，此情況會顯示 `needs you to sign in again` 訊息，而在 v2.1.273 之前，它會像其他情況一樣顯示 `requires re-authorization (token expired)`。
1508 1540
1509<h3 id="mcp-server-url-is-missing-or-not-a-valid-url">1541<h3 id="mcp-server-url-is-missing-or-not-a-valid-url">
1510 MCP 伺服器 URL 遺漏或不是有效的 URL1542 MCP 伺服器 URL 遺失或不是有效的 URL
1511</h3>1543</h3>
1512 1544
1513Claude Code 拒絕為遠端 MCP 伺服器啟動 OAuth 登入，因為伺服器的已設定 `url` 不會解析為 URL。除非 Claude Code 有更具體的設定問題要為伺服器報告，否則執行 [`claude mcp login <name>`](/docs/zh-TW/mcp#authenticate-from-the-command-line) 在您的 shell 中列印拒絕為：1545Claude Code 拒絕為遠端 MCP 伺服器啟動 OAuth 登入，因為該伺服器所設定的 `url` 無法解析為 URL。除非 Claude Code 有更具體的伺服器設定問題要回報，否則在您的 shell 中執行 [`claude mcp login <name>`](/docs/zh-TW/mcp#authenticate-from-the-command-line) 會將此拒絕顯示為：
1514 1546
1515```text theme={null}1547```text theme={null}
1516Couldn't complete authentication for "<name>": This server's URL is missing or not a valid URL, so sign-in can't start. Fix the URL in its MCP config (or set the environment variable it uses) and try again.1548Couldn't complete authentication for "<name>": This server's URL is missing or not a valid URL, so sign-in can't start. Fix the URL in its MCP config (or set the environment variable it uses) and try again.
1517```1549```
1518 1550
1519**該怎麼做：**1551**處理方式：**
1520 1552
1521* 將項目的 `url` 設定為伺服器設定的伺服器的真實端點，或設定其 [`${VAR}` 參考](/docs/zh-TW/mcp#environment-variable-expansion-in-mcp-json)命名的環境變數，然後再次執行登入。1553* 在設定該伺服器的位置將該項目的 `url` 設定為伺服器的實際端點，或設定其 [`${VAR}` 參照](/docs/zh-TW/mcp#environment-variable-expansion-in-mcp-json)所指名的環境變數，然後再次執行登入。
1522 1554
1523<h3 id="issuer-mismatch-in-authorization-response">1555<h3 id="issuer-mismatch-in-authorization-response">
1524 授權回應中的簽發者不匹配1556 授權回應中的 issuer 不符
1525</h3>1557</h3>
1526 1558
1527在 [MCP OAuth 登入](/docs/zh-TW/mcp#authenticate-with-remote-mcp-servers)期間，授權伺服器重新導向回 Claude Code，並帶有 `iss` 參數，該參數不命名 Claude Code 從伺服器的 OAuth 中繼資料預期的簽發者。此步驟中的簽發者錯誤是授權伺服器混合攻擊的樣子，因此 Claude Code 失敗登入，而不是交換授權代碼。Claude Code 在瀏覽器登入後在 `/mcp` 伺服器功能表中顯示錯誤：1559在 [MCP OAuth 登入](/docs/zh-TW/mcp#authenticate-with-remote-mcp-servers)期間，授權伺服器重新導向回 Claude Code 時所帶的 `iss` 參數，並非 Claude Code 根據伺服器 OAuth 中繼資料所預期的 issuer。此步驟出現錯誤的 issuer 正是授權伺服器混淆攻擊的樣貌，因此 Claude Code 會讓登入失敗，而不是交換授權碼。Claude Code 會在瀏覽器登入後於 `/mcp` 伺服器選單中顯示此錯誤：
1528 1560
1529```text theme={null}1561```text theme={null}
1530Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"1562Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"
1531```1563```
1532 1564
1533`expected` 是來自伺服器的 OAuth 中繼資料的簽發者，`received` 是重新導向攜帶的 `iss` 值。其重新導向不攜帶 `iss` 參數的登入通過檢查，除非伺服器的中繼資料設定 `authorization_response_iss_parameter_supported`，在這種情況下 Claude Code 失敗登入。1565`expected` 是伺服器 OAuth 中繼資料中的 issuer，`received` 是重新導向所帶的 `iss` 值。重新導向未帶 `iss` 參數的登入會通過檢查，除非伺服器的中繼資料設定了 `authorization_response_iss_parameter_supported`，此時 Claude Code 會讓登入失敗。
1534 1566
1535**該怎麼做：**1567**處理方式：**
1536 1568
1537* 嘗試從 `/mcp` 再次登入1569* 從 `/mcp` 再次嘗試登入
1538* 如果錯誤重複，請向伺服器操作員報告。修正是伺服器端的：授權伺服器必須在 `iss` 參數中傳回與在其中繼資料中宣傳的相同簽發者1570* 如果錯誤重複出現，請回報給伺服器營運者。修正需在伺服器端進行：授權伺服器必須在 `iss` 參數中傳回與其中繼資料所公告相同的 issuer
1539* 若要在伺服器被修正時進行連線，請使用 [`MCP_SDK_GENERATION=v1`](/docs/zh-TW/env-vars) 啟動 Claude Code，其[執行時](/docs/zh-TW/mcp#mcp-client-runtimes)不執行此檢查。這會移除對混合攻擊的保護，因此偏好伺服器端修正1571* 若要在伺服器修正期間連線，請以 [`MCP_SDK_GENERATION=v1`](/docs/zh-TW/env-vars) 啟動 Claude Code，其[執行階段](/docs/zh-TW/mcp#mcp-client-runtimes)不會執行此檢查。這會移除對混淆攻擊的防護，因此建議優先採用伺服器端修正
1540 1572
1541在 v2.1.232 之前，Claude Code 僅在逐步推出中或當您設定 `MCP_SDK_GENERATION=v2` 時使用 v2 執行時。1573在 v2.1.232 之前，Claude Code 只在逐步推出時或您設定 `MCP_SDK_GENERATION=v2` 時才使用 v2 執行階段。
1542 1574
1543<h3 id="refusing-to-send-credentials-to-non-https-token-endpoint">1575<h3 id="refusing-to-send-credentials-to-non-https-token-endpoint">
1544 拒絕向非 https 權杖端點傳送認證資格1576 拒絕將憑證傳送至非 https 的 token 端點
1545</h3>1577</h3>
1546 1578
1547在 [v2 執行時](/docs/zh-TW/mcp#mcp-client-runtimes)上，Claude Code 僅將 [MCP OAuth](/docs/zh-TW/mcp#authenticate-with-remote-mcp-servers) 權杖請求傳送到透過 HTTPS 或在 `localhost`、`127.0.0.1` 或 `::1` 上提供的權杖端點。此訊息表示伺服器的權杖端點都不是，因此 Claude Code 在傳送前停止了請求。這發生在瀏覽器登入之後，因此瀏覽器步驟首先成功，並在 Claude Code 重新整理伺服器的權杖時再次發生。1579在 [v2 執行階段](/docs/zh-TW/mcp#mcp-client-runtimes)上，Claude Code 只會將 [MCP OAuth](/docs/zh-TW/mcp#authenticate-with-remote-mcp-servers) token 請求傳送至透過 HTTPS 提供，或位於 `localhost`、`127.0.0.1` 或 `::1` 的 token 端點。此訊息表示伺服器的 token 端點兩者皆非，因此 Claude Code 在傳送請求之前停止了。這發生在瀏覽器登入之後，因此瀏覽器步驟會先成功，之後每當 Claude Code 重新整理該伺服器的 token 時也會再次發生。
1548 1580
1549在其完整形式中，訊息來自 MCP SDK 並引用它拒絕的權杖端點。在偵錯記錄中，它遵循 `Error during auth completion:` 用於登入或 `Token refresh failed:` 用於重新整理。在您的 shell 中，`claude mcp login <name>` 在 `Couldn't complete authentication for "<name>":` 之後列印它，在工作階段中，`/mcp` 在伺服器的功能表下顯示它：1581完整形式的訊息來自 MCP SDK，並會引用它所拒絕的 token 端點。在偵錯日誌中，它會接在登入的 `Error during auth completion:` 或重新整理的 `Token refresh failed:` 之後。在您的 shell 中，`claude mcp login <name>` 會在 `Couldn't complete authentication for "<name>":` 之後輸出它；在工作階段中，`/mcp` 會在伺服器的選單下顯示它：
1550 1582
1551```text theme={null}1583```text theme={null}
1552Refusing to send credentials to non-https token endpoint 'http://192.168.1.50:8123/oauth/token'. OAuth token requests MUST use TLS (localhost / 127.0.0.1 / ::1 are exempt).1584Refusing to send credentials to non-https token endpoint 'http://192.168.1.50:8123/oauth/token'. OAuth token requests MUST use TLS (localhost / 127.0.0.1 / ::1 are exempt).
1553```1585```
1554 1586
1555Claude Code 將具有查詢字串或長隨機外觀路徑段的伺服器 URL 視為可能的機密。對於此類伺服器，它在顯示或記錄 MCP SDK 引發的登入錯誤之前會進行編輯。此錯誤然後讀作可能在版本之間變更的短名稱，例如 `io`，後跟 `from the MCP SDK for` 和編輯的伺服器 URL。MCP SDK 的其他錯誤在那裡採用相同的形式。編輯的訊息只能是此錯誤，當伺服器的權杖端點是純 `http://` 在 `localhost`、`127.0.0.1` 或 `::1` 以外的位址時。1587Claude Code 會將帶有查詢字串或冗長隨機路徑區段的伺服器 URL 視為可能是機密。對於此類伺服器，它會在顯示或記錄 MCP SDK 引發的登入錯誤之前將其遮蔽。此時這個錯誤會顯示為一個可能隨版本變動的簡短名稱（例如 `io`），後面接著 `from the MCP SDK for` 以及遮蔽後的伺服器 URL。其他來自 MCP SDK 的錯誤在該處也採用相同形式。只有當伺服器的 token 端點是位於 `localhost`、`127.0.0.1` 或 `::1` 以外位址的純 `http://` 時，遮蔽後的訊息才可能是此錯誤。
1556 1588
1557**該怎麼做：**1589**處理方式：**
1558 1590
1559* 透過 HTTPS 提供該權杖端點，例如透過將伺服器放在終止 TLS 的反向代理或隧道後面，並設定伺服器以宣傳 `https://` 位址1591* 透過 HTTPS 提供該 token 端點，例如將伺服器放在終止 TLS 的反向代理伺服器或通道後方，並設定伺服器公告 `https://` 位址
1560* 若要在不變更伺服器的情況下進行連線，請使用 [`MCP_SDK_GENERATION=v1`](/docs/zh-TW/env-vars) 啟動 Claude Code，其[執行時](/docs/zh-TW/mcp#mcp-client-runtimes)不應用此規則，並透過純 HTTP 傳送權杖請求。該選擇持續到您退出並套用到每個伺服器。v1 執行時也會跳過[簽發者檢查](#issuer-mismatch-in-authorization-response)，因此偏好透過 HTTPS 提供端點1592* 若要在不變更伺服器的情況下連線，請以 [`MCP_SDK_GENERATION=v1`](/docs/zh-TW/env-vars) 啟動 Claude Code，其[執行階段](/docs/zh-TW/mcp#mcp-client-runtimes)不套用此規則，並會透過純 HTTP 傳送 token 請求。此選擇會持續到您結束為止，並套用至每個伺服器。v1 執行階段也會略過 [issuer 檢查](#issuer-mismatch-in-authorization-response)，因此建議優先透過 HTTPS 提供端點
1561 1593
1562<h3 id="aws-credentials-expired-or-invalid">1594<h3 id="aws-credentials-expired-or-invalid">
1563 AWS 認證資格已過期或無效1595 AWS 憑證已過期或無效
1564</h3>1596</h3>
1565 1597
1566您的 AWS 工作階段權杖已過期或被拒絕。此訊息出現在來自 [Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws) 或 [Mantle 端點](/docs/zh-TW/amazon-bedrock#use-the-mantle-endpoint) 的 401 上，這是這些提供者報告過期安全權杖的方式。1598您的 AWS 工作階段 token 已過期或被拒絕。當 [Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws) 或 [Mantle 端點](/docs/zh-TW/amazon-bedrock#use-the-mantle-endpoint)傳回 401 時會出現此訊息，這是這些供應商回報安全 token 過期的方式。
1567 1599
1568中間的動作提示會根據您的設定而異。穩定的部分是前導 `AWS credentials expired or invalid`：1600中間的動作提示會依您的設定而不同。固定不變的部分是開頭的 `AWS credentials expired or invalid`：
1569 1601
1570```text theme={null}1602```text theme={null}
1571AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...1603AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...
1572```1604```
1573 1605
1574在 v2.1.273 之前，此訊息僅在您的設定檔中設定 [`awsAuthRefresh`](/docs/zh-TW/amazon-bedrock#advanced-credential-configuration) 時出現。1606在 v2.1.273 之前，只有在設定了 `awsAuthRefresh` 時才會出現此訊息。
1575 1607
1576**該怎麼做：**1608**處理方式：**
1577 1609
1578* 如果提示說認證資格由此環境管理，啟動 Claude Code 的應用程式擁有認證資格，此處的其他步驟不適用：重試，或聯絡您的管理員1610* 如果提示表示憑證由此環境管理，則啟動 Claude Code 的應用程式擁有該憑證，此處的其他步驟並不適用：請重試，或聯絡您的管理員
1579* 在另一個終端機中執行訊息中命名的命令，例如 `aws sso login --profile myprofile`，並完成瀏覽器登入，然後重試。否則自己重新整理您使用的 AWS 認證資格：您的 SSO 登入、存取金鑰、API 金鑰或代理權杖1611* 如果設定了 [`awsAuthRefresh`](/docs/zh-TW/amazon-bedrock#advanced-credential-configuration)，請在另一個終端機中執行訊息所指的命令（例如 `aws sso login --profile myprofile`）並完成瀏覽器登入，然後重試。否則，請自行重新整理您所使用的 AWS 憑證：您的 SSO 登入、存取金鑰、API 金鑰或代理伺服器 token
1580* 在互動式工作階段中，您可以改為執行 `/login`，選擇**第三方平台**，然後在**使用第三方平台**下選擇 **Claude Platform on AWS · refresh credentials** 以執行相同命令，而無需重新啟動 Claude Code。請參閱[設定 AWS 認證資格](/docs/zh-TW/claude-platform-on-aws#1-configure-aws-credentials)1612* 在設定了 `awsAuthRefresh` 的互動式工作階段中，您也可以改為執行 `/login`，選擇 **3rd-party platform**，然後在 **Using 3rd-party platforms** 下選擇 **Claude Platform on AWS · refresh credentials**，即可在不重新啟動 Claude Code 的情況下執行相同的命令。請參閱[設定 AWS 憑證](/docs/zh-TW/claude-platform-on-aws#1-configure-aws-credentials)
1581* 如果重新整理命令成功後錯誤重複，請在相同 shell 和設定檔中使用 `aws sts get-caller-identity` 確認身份在 Claude Code 外有效1613* 如果重新整理命令成功後錯誤仍重複出現，請在相同的 shell 與設定檔中執行 `aws sts get-caller-identity`，確認該身分在 Claude Code 之外是有效的
1582 1614
1583<h3 id="aws-authentication-failed">1615<h3 id="aws-authentication-failed">
1584 AWS 驗證失敗1616 AWS 身分驗證失敗
1585</h3>1617</h3>
1586 1618
1587您的 AWS 提供者傳回 403，或 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) 傳回 401。1619您的 AWS 供應商傳回了 403，或 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) 傳回了 401。
1588 1620
1589Amazon Bedrock 將過期的安全權杖報告為 403，但 403 也是它報告授權拒絕的方式，例如來自遺漏 IAM 權限或未為您的帳戶啟用的模型的 `AccessDeniedException`。Claude Code 無法判斷您遇到了哪個原因。1621Amazon Bedrock 會將安全 token 過期回報為 403，但 403 也是它回報授權遭拒的方式，例如因缺少 IAM 權限而產生的 `AccessDeniedException`。Claude Code 無法區分這兩種原因。
1590 1622
1591來自 Amazon Bedrock 的 401 也會落在這裡，而不是在[AWS 認證資格已過期或無效](#aws-credentials-expired-or-invalid)下，因為 Amazon Bedrock 不將過期的權杖報告為 401。來自該端點的 401 通常來自請求路徑中的其他內容，例如公司代理。1623來自 Amazon Bedrock 的 401 也會歸到此處，而不是 [AWS 憑證已過期或無效](#aws-credentials-expired-or-invalid)，因為 Amazon Bedrock 不會將 token 過期回報為 401。來自該端點的 401 通常源自請求路徑中的其他元件，例如公司的代理伺服器。
1592 1624
1593認證資格重新整理可以修正過期的權杖，無法修正其他原因，因此訊息提供兩者：1625重新整理憑證可以修正過期的 token，但無法修正其他原因，因此訊息會同時提供兩者：
1594 1626
1595```text theme={null}1627```text theme={null}
1596AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...1628AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...
1597```1629```
1598 1630
1599中間的動作提示會根據您的設定而異。穩定的部分是前導 `AWS authentication failed`。1631中間的動作提示會依您的設定而不同。固定不變的部分是開頭的 `AWS authentication failed`。
1600 1632
1601當 403 是 Amazon Bedrock 的答案，表示您沒有使用指定的模型 ID 存取該模型時，提示改為告訴您在 Amazon Bedrock 主控台中為您的帳戶和區域啟用該模型。1633當 403 是 Amazon Bedrock 表示您無權存取指定模型 ID 之模型的回應時，提示會改為要求您在 Amazon Bedrock 主控台中為您的帳戶與區域啟用該模型。
1602 1634
1603在 v2.1.273 之前，此訊息僅在您的設定檔中設定 [`awsAuthRefresh`](/docs/zh-TW/amazon-bedrock#advanced-credential-configuration) 時出現。1635在 v2.1.273 之前，只有在設定了 `awsAuthRefresh` 時才會出現此訊息。
1604 1636
1605**該怎麼做：**1637**處理方式：**
1606 1638
1607* 如果提示說認證資格由此環境管理，啟動 Claude Code 的應用程式擁有認證資格，此處的其他步驟不適用：重試，或聯絡您的管理員1639* 如果提示表示憑證由此環境管理，則啟動 Claude Code 的應用程式擁有該憑證，此處的其他步驟並不適用：請重試，或聯絡您的管理員
1608* 重新整理您的 AWS 認證資格，以防過期的認證資格是原因：執行訊息中命名的命令（如果設定了一個），或自己重新整理您的 SSO 登入、存取金鑰、API 金鑰或代理權杖1640* 重新整理您的 AWS 憑證，以防原因是憑證過期：若有設定，請執行訊息所指的 [`awsAuthRefresh`](/docs/zh-TW/amazon-bedrock#advanced-credential-configuration) 命令，或自行重新整理您的 SSO 登入、存取金鑰、API 金鑰或代理伺服器 token
1609* 如果您的認證資格是最新的，請確認 [IAM 設定](/docs/zh-TW/amazon-bedrock#iam-configuration)中的 IAM 權限已附加到您使用的身份，且所選模型已為您的帳戶和區域啟用1641* 如果您的憑證是最新的，請確認 [IAM 設定](/docs/zh-TW/amazon-bedrock#iam-configuration)中的 IAM 權限已附加至您所使用的身分，且所選模型已為您的帳戶與區域啟用
1610* 執行 `aws sts get-caller-identity` 以確認您的請求使用哪個身份1642* 執行 `aws sts get-caller-identity`，確認您的請求使用的是哪個身分
1611 1643
1612<h3 id="google-cloud-credentials-expired-or-invalid">1644<h3 id="google-cloud-credentials-expired-or-invalid">
1613 Google Cloud 認證資格已過期或無效1645 Google Cloud 憑證已過期或無效
1614</h3>1646</h3>
1615 1647
1616您的 [Google Cloud 的 Agent Platform](/docs/zh-TW/google-vertex-ai) Google Cloud 認證資格已過期或被拒絕：請求傳回 401，這是 Agent Platform 報告認證資格過期的方式。1648您用於 [Google Cloud's Agent Platform](/docs/zh-TW/google-vertex-ai) 的 Google Cloud 憑證已過期或被拒絕：請求傳回了 401，這是 Agent Platform 回報憑證過期的方式。
1617 1649
1618中間的動作提示會根據您的設定而異。穩定的部分是前導 `Google Cloud credentials expired or invalid`：1650中間的動作提示會依您的設定而不同。固定不變的部分是開頭的 `Google Cloud credentials expired or invalid`：
1619 1651
1620```text theme={null}1652```text theme={null}
1621Google Cloud credentials expired or invalid · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · API Error: 401 ...1653Google Cloud credentials expired or invalid · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · API Error: 401 ...
1622```1654```
1623 1655
1624**該怎麼做：**1656**處理方式：**
1625 1657
1626* 如果提示說認證資格由此環境管理，啟動 Claude Code 的應用程式擁有認證資格，此處的其他步驟不適用：重試，或聯絡您的管理員1658* 如果提示表示憑證由此環境管理，則啟動 Claude Code 的應用程式擁有該憑證，此處的其他步驟並不適用：請重試，或聯絡您的管理員
1627* 如果您使用應用程式預設認證資格進行驗證，請執行訊息中命名的 [`gcpAuthRefresh`](/docs/zh-TW/google-vertex-ai#advanced-credential-configuration) 命令或 `gcloud auth application-default login`，並完成登入，然後重試1659* 如果您以應用程式預設憑證進行身分驗證，請執行訊息所指的 [`gcpAuthRefresh`](/docs/zh-TW/google-vertex-ai#advanced-credential-configuration) 命令，或 `gcloud auth application-default login`，完成登入後重試
1628* 如果您透過設定 `CLAUDE_CODE_SKIP_VERTEX_AUTH` 的 [LLM 閘道](/docs/zh-TW/llm-gateway)路由，請重新整理 `ANTHROPIC_AUTH_TOKEN` 或 `ANTHROPIC_CUSTOM_HEADERS` 中的閘道權杖，然後重試1660* 如果您在設定了 `CLAUDE_CODE_SKIP_VERTEX_AUTH` 的情況下透過 [LLM 閘道](/docs/zh-TW/llm-gateway)進行路由，請重新整理 `ANTHROPIC_AUTH_TOKEN` 或 `ANTHROPIC_CUSTOM_HEADERS` 中的閘道 token，然後重試
1629* 如果您使用服務帳戶金鑰檔案進行驗證，請確認 `GOOGLE_APPLICATION_CREDENTIALS` 指向有效的金鑰。請參閱[設定 GCP 認證資格](/docs/zh-TW/google-vertex-ai#3-configure-gcp-credentials)1661* 如果您以服務帳戶金鑰檔案進行身分驗證，請確認 `GOOGLE_APPLICATION_CREDENTIALS` 指向有效的金鑰。請參閱[設定 GCP 憑證](/docs/zh-TW/google-vertex-ai#3-configure-gcp-credentials)
1630* 如果重新整理後錯誤重複，請在相同 shell 中使用 `gcloud auth application-default print-access-token` 確認身份在 Claude Code 外有效1662* 如果重新整理後錯誤仍重複出現，請在相同的 shell 中執行 `gcloud auth application-default print-access-token`，確認該身分在 Claude Code 之外可正常運作
1631 1663
1632在 v2.1.273 之前，來自 Agent Platform 的 401 顯示通用 `Please run /login` 或 `Failed to authenticate` 訊息，無法重新整理 Google Cloud 認證資格。1664在 v2.1.273 之前，來自 Agent Platform 的 401 會改為顯示一般的 `Please run /login` 或 `Failed to authenticate` 訊息，而這些訊息無法重新整理 Google Cloud 憑證。
1633 1665
1634<h3 id="google-cloud-authentication-failed">1666<h3 id="google-cloud-authentication-failed">
1635 Google Cloud 驗證失敗1667 Google Cloud 身分驗證失敗
1636</h3>1668</h3>
1637 1669
1638[Google Cloud 的 Agent Platform](/docs/zh-TW/google-vertex-ai) 傳回 403，它用於授權拒絕而不是過期的認證資格。通常您驗證的身份缺少 IAM 權限，或該模型未為您的專案啟用。1670[Google Cloud 的 Agent Platform](/docs/zh-TW/google-vertex-ai) 傳回了 403，它使用此狀態碼表示授權遭拒，而非憑證過期。通常是您用來進行身分驗證的身分缺少 IAM 權限，或模型尚未在您的專案中啟用。
1639 1671
1640中間的動作提示會根據您的設定而異。穩定的部分是前導 `Google Cloud authentication failed`：1672中間的操作提示會依您的設定而有所不同。固定不變的部分是開頭的 `Google Cloud authentication failed`：
1641 1673
1642```text theme={null}1674```text theme={null}
1643Google Cloud authentication failed · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · if credentials are current, check GCP IAM permissions and Vertex AI model access · API Error: 403 ...1675Google Cloud authentication failed · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · if credentials are current, check GCP IAM permissions and Vertex AI model access · API Error: 403 ...
1644```1676```
1645 1677
1646**該怎麼做：**1678**處理方式：**
1647 1679
1648* 如果提示說認證資格由此環境管理，啟動 Claude Code 的應用程式擁有認證資格，此處的其他步驟不適用：重試，或聯絡您的管理員1680* 如果提示指出憑證由此環境管理，表示啟動 Claude Code 的應用程式擁有該憑證，此處的其他步驟不適用：請重試，或聯絡您的管理員
1649* 確認 [IAM 設定](/docs/zh-TW/google-vertex-ai#iam-configuration)中的角色已授予您驗證的身份1681* 確認 [IAM 設定](/docs/zh-TW/google-vertex-ai#iam-configuration)中的角色已授予您用來進行身分驗證的身分
1650* 確認該模型已為您的專案啟用。請參閱[要求模型存取](/docs/zh-TW/google-vertex-ai#2-request-model-access)1682* 確認模型已在您的專案中啟用。請參閱[請求模型存取權](/docs/zh-TW/google-vertex-ai#2-request-model-access)
1651 1683
1652在 v2.1.273 之前，來自 Agent Platform 的 403 顯示通用 `Please run /login` 或 `Failed to authenticate` 訊息，無法重新整理 Google Cloud 認證資格。1684在 v2.1.273 之前，來自 Agent Platform 的 403 會改為顯示通用的 `Please run /login` 或 `Failed to authenticate` 訊息，而這無法重新整理 Google Cloud 憑證。
1653 1685
1654<h3 id="microsoft-foundry-authentication-failed">1686<h3 id="microsoft-foundry-authentication-failed">
1655 Microsoft Foundry 驗證失敗1687 Microsoft Foundry 身分驗證失敗
1656</h3>1688</h3>
1657 1689
1658[Microsoft Foundry](/docs/zh-TW/microsoft-foundry) 傳回 401 或 403：請求上的 Azure 認證資格被拒絕，或其背後的身份沒有存取 Foundry 資源的權限。`/login` 無法鑄造 Azure 認證資格。中間的動作提示會根據您的設定而異。穩定的部分是前導 `Microsoft Foundry authentication failed`：1690[Microsoft Foundry](/docs/zh-TW/microsoft-foundry) 傳回了 401 或 403：請求上的 Azure 憑證遭到拒絕，或其背後的身分沒有 Foundry 資源的存取權。`/login` 無法產生 Azure 憑證。中間的操作提示會依您的設定而有所不同。固定不變的部分是開頭的 `Microsoft Foundry authentication failed`：
1659 1691
1660```text theme={null}1692```text theme={null}
1661Microsoft Foundry authentication failed · refresh your Foundry credential (ANTHROPIC_FOUNDRY_AUTH_TOKEN, ANTHROPIC_FOUNDRY_API_KEY, Azure sign-in for Entra, or your proxy token) and retry · if credentials are current, check access to the Foundry resource · API Error: 401 ...1693Microsoft Foundry authentication failed · refresh your Foundry credential (ANTHROPIC_FOUNDRY_AUTH_TOKEN, ANTHROPIC_FOUNDRY_API_KEY, Azure sign-in for Entra, or your proxy token) and retry · if credentials are current, check access to the Foundry resource · API Error: 401 ...
1662```1694```
1663 1695
1664**該怎麼做：**1696**處理方式：**
1665 1697
1666* 如果提示說認證資格由此環境管理，啟動 Claude Code 的應用程式擁有認證資格，此處的其他步驟不適用：重試，或聯絡您的管理員1698* 如果提示指出憑證由此環境管理，表示啟動 Claude Code 的應用程式擁有該憑證，此處的其他步驟不適用：請重試，或聯絡您的管理員
1667* 重新整理您在[設定 Azure 認證資格](/docs/zh-TW/microsoft-foundry#2-configure-azure-credentials)中設定的認證資格：輪換 `ANTHROPIC_FOUNDRY_API_KEY`、鑄造新的 `ANTHROPIC_FOUNDRY_AUTH_TOKEN`，或執行 `az login` 以便預設 Microsoft Entra 認證資格鏈可以再次登入1699* 重新整理您在[設定 Azure 憑證](/docs/zh-TW/microsoft-foundry#2-configure-azure-credentials)中設定的憑證：輪替 `ANTHROPIC_FOUNDRY_API_KEY`、產生新的 `ANTHROPIC_FOUNDRY_AUTH_TOKEN`，或執行 `az login`，讓預設的 Microsoft Entra 憑證鏈能再次登入
1668* 如果認證資格是最新的，請確認身份有權存取 Foundry 資源。請參閱 [Azure RBAC 設定](/docs/zh-TW/microsoft-foundry#azure-rbac-configuration)1700* 如果憑證仍有效，請確認該身分具有 Foundry 資源的存取權。請參閱 [Azure RBAC 設定](/docs/zh-TW/microsoft-foundry#azure-rbac-configuration)
1669 1701
1670在 v2.1.273 之前，來自 Microsoft Foundry 的 401 或 403 顯示通用 `Please run /login` 或 `Failed to authenticate` 訊息，無法重新整理 Azure 認證資格。1702在 v2.1.273 之前，來自 Microsoft Foundry 的 401 或 403 會改為顯示通用的 `Please run /login` 或 `Failed to authenticate` 訊息，而這無法重新整理 Azure 憑證。
1671 1703
1672<h3 id="could-not-load-aws-or-google-cloud-credentials">1704<h3 id="could-not-load-aws-or-google-cloud-credentials">
1673 無法載入 AWS 或 Google Cloud 認證資格1705 無法載入 AWS 或 Google Cloud 憑證
1674</h3>1706</h3>
1675 1707
1676Claude Code 無法從 AWS 認證資格提供者鏈或從它執行的機器上的 Google 應用程式預設認證資格取得可用的認證資格，因此沒有請求到達您的雲端提供者。Claude Code 清除其快取的認證資格並在顯示此訊息之前重試兩次。`·` 之後的詳細資訊命名具體原因，例如過期的 SSO 工作階段、遺漏的應用程式預設認證資格報告為 `Could not load the default credentials`，或被拒絕的登入報告為 `invalid_grant`：1708Claude Code 無法在其執行的機器上，從 AWS 憑證提供者鏈或您的 Google 應用程式預設憑證取得可用的憑證，因此沒有任何請求送達您的雲端供應商。Claude Code 會清除其快取的憑證並重試兩次，之後才顯示此訊息。`·` 之後的詳細資訊會指出具體原因，例如 SSO 工作階段過期、缺少應用程式預設憑證（回報為 `Could not load the default credentials`），或登入遭撤銷（回報為 `invalid_grant`）：
1677 1709
1678```text theme={null}1710```text theme={null}
1679API Error: Could not load AWS credentials · Could not load credentials from any providers. Check or refresh your AWS credentials and try again.1711API Error: Could not load AWS credentials · Could not load credentials from any providers. Check or refresh your AWS credentials and try again.
1680API Error: Could not load Google Cloud credentials · invalid_grant. Check or refresh your Google Cloud credentials and try again.1712API Error: Could not load Google Cloud credentials · invalid_grant. Check or refresh your Google Cloud credentials and try again.
1681```1713```
1682 1714
1683在[非互動式模式](/docs/zh-TW/headless)中使用 `-p` 和在 [Agent SDK](/docs/zh-TW/agent-sdk/overview) 中，結構化錯誤代碼為 `cloud_credential_error`。在 v2.1.267 之前，訊息僅顯示 `API Error:` 之後的詳細資訊文字，結構化代碼為 `server_error` 或 `unknown`。1715在使用 `-p` 的[非互動模式](/docs/zh-TW/headless)以及 [Agent SDK](/docs/zh-TW/agent-sdk/overview) 中，結構化錯誤代碼為 `cloud_credential_error`。在 v2.1.267 之前，訊息只會顯示 `API Error:` 之後的詳細文字，且結構化代碼為 `server_error` 或 `unknown`。
1684 1716
1685**該怎麼做：**1717**處理方式：**
1686 1718
1687* 執行您的提供者的登入命令，例如 `aws sso login --profile myprofile` 或 `gcloud auth application-default login`，然後重試。[Bedrock、Agent Platform 或 Foundry 認證資格未載入](/docs/zh-TW/troubleshoot-install#bedrock-agent-platform-or-foundry-credentials-not-loading)顯示如何在 Claude Code 外確認認證資格1719* 執行您供應商的登入命令，例如 `aws sso login --profile myprofile` 或 `gcloud auth application-default login`，然後重試。[Bedrock、Agent Platform 或 Foundry 憑證無法載入](/docs/zh-TW/troubleshoot-install#bedrock-agent-platform-or-foundry-credentials-not-loading)說明如何在 Claude Code 之外確認憑證
1688* 如果詳細資訊讀作 `AWS default-chain credential resolve timed out`，鏈掛起而不是失敗，因此改為遵循 [AWS default-chain credential resolve timed out](#aws-default-chain-credential-resolve-timed-out)1720* 如果詳細資訊顯示 `AWS default-chain credential resolve timed out`，表示憑證鏈是停滯而非失敗，請改為依照 [AWS 預設憑證鏈解析逾時](#aws-default-chain-credential-resolve-timed-out)處理
1689 1721
1690<h3 id="aws-default-chain-credential-resolve-timed-out">1722<h3 id="aws-default-chain-credential-resolve-timed-out">
1691 AWS default-chain credential resolve 逾時1723 AWS 預設憑證鏈解析逾時
1692</h3>1724</h3>
1693 1725
1694AWS 預設認證資格提供者鏈未在 60 秒內產生認證資格，因此 Claude Code 停止了解析並失敗了請求。此逾時是[無法載入 AWS 或 Google Cloud 認證資格](#could-not-load-aws-or-google-cloud-credentials)的一個原因。失敗是本機認證資格解析：請求永遠不會到達 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock)、[Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws) 或 [Mantle 端點](/docs/zh-TW/amazon-bedrock#use-the-mantle-endpoint)。Claude Code 在此錯誤出現之前清除其[認證資格快取](/docs/zh-TW/amazon-bedrock#credential-caching-and-resolution-timeout)並重試，因此到您看到它時，鏈已在重複嘗試中停滯。1726AWS 預設憑證提供者鏈未在 60 秒內產生憑證，因此 Claude Code 停止解析並使請求失敗。此逾時是[無法載入 AWS 或 Google Cloud 憑證](#could-not-load-aws-or-google-cloud-credentials)的原因之一。失敗發生在本機憑證解析階段：請求從未送達 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock)、[Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws) 或 [Mantle 端點](/docs/zh-TW/amazon-bedrock#use-the-mantle-endpoint)。Claude Code 會在此錯誤出現之前清除其[憑證快取](/docs/zh-TW/amazon-bedrock#credential-caching-and-resolution-timeout)並重試，因此當您看到此錯誤時，憑證鏈已在多次嘗試中停滯。
1695 1727
1696```text theme={null}1728```text theme={null}
1697API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.1729API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.
1698```1730```
1699 1731
1700常見原因是停滯對 AWS 的請求的網路或代理，包括 SSO 權杖重新整理，以及其執行個體中繼資料服務 (IMDS) 永遠不會回答鏈探測的容器或 VM。1732常見原因包括：AWS 設定檔中的 `credential_process` 命令正在等待它無法接收的輸入，以及容器或虛擬機器的執行個體中繼資料服務（IMDS）始終未回應憑證鏈的探測。
1701 1733
1702在 v2.1.267 之前，訊息讀作 `API Error: AWS default-chain credential resolve timed out`。1734在 v2.1.267 之前，訊息為 `API Error: AWS default-chain credential resolve timed out`。
1703在 v2.1.207 之前，停滯的鏈使請求無限期等待，而不是失敗。1735在 v2.1.207 之前，停滯的憑證鏈會讓請求無限期等待，而不會失敗。
1704 1736
1705**該怎麼做：**1737**處理方式：**
1706 1738
1707* 在相同 shell 中使用相同 `AWS_PROFILE` 執行 `aws sts get-caller-identity`。如果它也掛起，請修正設定檔；以互動方式提示的 `credential_process` 命令是常見原因。1739* 在同一個 shell 中使用相同的 `AWS_PROFILE` 執行 `aws sts get-caller-identity`。如果它也停滯，請修正設定檔；以互動方式提示輸入的 `credential_process` 命令是常見原因。
1708* 在啟動 Claude Code 之前完成登入步驟，例如 `aws sso login --profile myprofile`，以便鏈從本機 SSO 快取解析，而不是等待瀏覽器流程1740* 在啟動 Claude Code 之前完成登入步驟，例如 `aws sso login --profile myprofile`
1709* 如果您的鏈執行合法需要超過 60 秒的互動式登入，例如透過 `aws-vault` 等包裝程式的 SSO 與 MFA，請使用 [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/zh-TW/env-vars) 以毫秒為單位提高限制1741* 如果您的憑證鏈執行的互動式登入確實需要超過 60 秒，例如透過 `aws-vault` 等包裝工具進行的 SSO 加 MFA，請使用 [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/zh-TW/env-vars) 以毫秒為單位提高上限
1710 1742
1711<h3 id="bedrock-setup-verification-timed-out-waiting-for-aws">1743<h3 id="bedrock-setup-verification-timed-out-waiting-for-aws">
1712 Bedrock 設定驗證逾時等待 AWS1744 Bedrock 設定驗證在等待 AWS 時逾時
1713</h3>1745</h3>
1714 1746
1715在 [Bedrock 設定精靈](/docs/zh-TW/amazon-bedrock#sign-in-with-bedrock)的認證資格驗證期間對 AWS 的呼叫（例如認證資格查詢或身份檢查）未在 60 秒限制內完成。精靈停止等待並失敗驗證步驟：1747在 [Bedrock 設定精靈](/docs/zh-TW/amazon-bedrock#sign-in-with-bedrock)的憑證驗證期間，對 AWS 的某個呼叫（例如憑證查詢或身分檢查）未在 60 秒上限內完成。精靈會停止等待，並使驗證步驟失敗：
1716 1748
1717```text theme={null}1749```text theme={null}
1718Timed out after 60s waiting for AWS. Check your network and proxy settings; if a credential helper needs longer to prompt you, raise CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS.1750Timed out after 60s waiting for AWS. Check your network and proxy settings; if a credential helper needs longer to prompt you, raise CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS.
1719```1751```
1720 1752
1721該數字反映您的限制：預設 60 秒，或您在 [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/zh-TW/env-vars) 中設定的值。1753數字反映的是您的上限：預設為 60 秒，或是您在 [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/zh-TW/env-vars) 中設定的值。
1722 1754
1723常見原因是停滯對 AWS 的請求的網路或代理，包括 SSO 權杖重新整理，以及仍在等待您看不到的輸入的認證資格協助程式。僅在協助程式合法需要更多時間時提高限制。1755常見原因包括：網路或代理伺服器使對 AWS 的請求（包括 SSO token 重新整理）停滯，以及憑證輔助程式仍在等待您看不到的輸入。只有在輔助程式確實需要更多時間時才提高上限。
1724 1756
1725對 AWS 的單一停滯請求也可能在其自身的每個請求逾時上失敗，這在相同步驟上顯示較短的訊息：1757單一對 AWS 的停滯請求也可能因其自身的單次請求逾時而失敗，這會在同一步驟顯示較短的訊息：
1726 1758
1727```text theme={null}1759```text theme={null}
1728A request to AWS timed out. Check your network and proxy settings, then try again.1760A request to AWS timed out. Check your network and proxy settings, then try again.
1729```1761```
1730 1762
1731當相同的逾時發生在模型釘選步驟上時，精靈會將模型標記為 `unreachable`，而不是顯示任一訊息。1763當相同的逾時發生在模型固定步驟時，精靈會將模型標記為 `unreachable`，而不會顯示上述任一訊息。
1732 1764
1733**該怎麼做：**1765**處理方式：**
1734 1766
1735* 在相同 shell 中執行 `aws sts get-caller-identity`。如果它也掛起，停滯在 Claude Code 外，在您的網路、您的代理或您的 AWS 設定檔中的認證資格協助程式中；首先修正那個。1767* 在同一個 shell 中執行 `aws sts get-caller-identity`。如果它也停滯，表示停滯發生在 Claude Code 之外，位於您的網路、代理伺服器或 AWS 設定檔中的憑證輔助程式；請先修正該問題。
1736* 在開啟精靈之前完成任何互動式登入，例如 `aws sso login --profile myprofile`1768* 在開啟精靈之前完成任何互動式登入，例如 `aws sso login --profile myprofile`
1737* 如果您的 AWS 設定檔中的認證資格協助程式合法需要超過 60 秒來提示您，請使用 [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/zh-TW/env-vars) 以毫秒為單位提高限制1769* 如果 AWS 設定檔中的憑證輔助程式確實需要超過 60 秒來提示您，請使用 [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/zh-TW/env-vars) 以毫秒為單位提高上限
1738 1770
1739<h3 id="cloud-gateway-session-expired">1771<h3 id="cloud-gateway-session-expired">
1740 雲端閘道工作階段已過期1772 雲端閘道工作階段已過期
1741</h3>1773</h3>
1742 1774
1743您透過 [Claude 應用程式閘道](/docs/zh-TW/claude-apps-gateway)登入，此機器上儲存的閘道工作階段已過期且無法更新，或閘道不再接受它，例如在閘道的 [JWT 機密被替換](/docs/zh-TW/claude-apps-gateway-deploy#jwt-secret-rotation)後。如果您在以互動方式啟動 `claude` 時看到此行，工作階段已開啟，未登入閘道：1775您是透過 [Claude apps 閘道](/docs/zh-TW/claude-apps-gateway)登入的，而儲存在此機器上的閘道工作階段已過期且無法續期，或閘道已不再接受它，例如在閘道的 [JWT 密鑰被替換](/docs/zh-TW/claude-apps-gateway-deploy#jwt-secret-rotation)之後。如果您在以互動方式啟動 `claude` 時看到這一行，表示工作階段已在未登入閘道的狀態下開啟：
1744 1776
1745```text theme={null}1777```text theme={null}
1746Cloud gateway session expired — run /login to reconnect.1778Cloud gateway session expired — run /login to reconnect.
1747```1779```
1748 1780
1749相同的行可以在工作階段中期出現，當閘道認證資格過期且 Claude Code 無法更新它時。1781當閘道憑證過期且 Claude Code 無法續期時，同一行也可能在工作階段進行中出現。
1750 1782
1751在[非互動式](/docs/zh-TW/headless)執行、背景或其他無人值守工作階段或 `claude` 子命令（除了 `claude auth`）中，Claude Code 會在閘道不再接受工作階段時改為結束，並顯示此訊息：1783在[非互動](/docs/zh-TW/headless)執行、背景或其他無人值守的工作階段，或 `claude auth` 以外的 `claude` 子命令中，當閘道不再接受該工作階段時，Claude Code 會改為以此訊息結束：
1752 1784
1753```text theme={null}1785```text theme={null}
1754Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.1786Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.
1755```1787```
1756 1788
1757**該怎麼做：**1789**處理方式：**
1758 1790
1759* 在工作階段中執行 `/login` 並完成瀏覽器登入1791* 在工作階段中執行 `/login` 並完成瀏覽器登入
1760* 對於非互動式啟動，在相同環境中啟動 `claude`，執行 `/login`，然後重新執行您的命令1792* 若為非互動式啟動，請在相同環境中啟動 `claude`，執行 `/login`，然後重新執行您的命令
1761 1793
1762<h3 id="sign-in-timed-out-while-waiting-for-you-to-continue">1794<h3 id="sign-in-timed-out-while-waiting-for-you-to-continue">
1763 登入逾時，等待您繼續1795 等待您繼續時登入逾時
1764</h3>1796</h3>
1765 1797
1766在 [Claude 應用程式閘道](/docs/zh-TW/claude-apps-gateway)登入期間，閘道命名了登入的帳戶，Claude Code 要求您在儲存認證資格之前確認它。您將確認保持開啟超過登入本身的過期，閘道未簽發重新整理權杖，因此當您繼續時 Claude Code 未儲存任何內容：1798在 [Claude apps 閘道](/docs/zh-TW/claude-apps-gateway)登入期間，閘道指出了登入的帳戶，而 Claude Code 要求您在儲存憑證之前確認該帳戶。您讓確認畫面停留超過了登入本身的有效期限，且閘道未核發可用來續期的 refresh token，因此當您繼續時，Claude Code 沒有儲存任何內容：
1767 1799
1768```text theme={null}1800```text theme={null}
1769Sign-in timed out while waiting for you to continue. Try again.1801Sign-in timed out while waiting for you to continue. Try again.
1770```1802```
1771 1803
1772**該怎麼做：**1804**處理方式：**
1773 1805
1774* 執行 `/login` 並在登入過期之前確認帳戶1806* 再次執行 `/login`，並在登入過期之前確認帳戶
1775 1807
1776<h3 id="gateway-refused-the-request">1808<h3 id="gateway-refused-the-request">
1777 閘道拒絕了請求1809 閘道拒絕了請求
1778</h3>1810</h3>
1779 1811
1780您透過 [Claude 應用程式閘道](/docs/zh-TW/claude-apps-gateway)登入，請求傳回 403：閘道或其背後的上游拒絕了它。再次登入不會改變拒絕，因此訊息指向您的閘道管理員：1812您是透過 [Claude apps 閘道](/docs/zh-TW/claude-apps-gateway)登入的，而某個請求傳回了 403：閘道或其背後的上游拒絕了該請求。重新登入無法改變拒絕結果，因此訊息會指向您的閘道管理員：
1781 1813
1782```text theme={null}1814```text theme={null}
1783Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...1815Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...
1784```1816```
1785 1817
1786**該怎麼做：**1818**處理方式：**
1787 1819
1788* 要求您的閘道管理員查詢請求。`API Error:` 尾部攜帶閘道傳回的拒絕1820* 請您的閘道管理員查詢該請求。`API Error:` 後面的內容包含閘道傳回的拒絕資訊
1789* 對於管理員：閘道上的[存取控制規則](/docs/zh-TW/claude-apps-gateway-config#http-tuning)傳回 403，[稽核記錄](/docs/zh-TW/claude-apps-gateway-deploy#logs)會記錄其原因，上游的授權拒絕會根據[上游錯誤訊息](/docs/zh-TW/claude-apps-gateway-config#upstream-error-messages)傳遞1821* 對管理員而言：閘道上的[存取控制規則](/docs/zh-TW/claude-apps-gateway-config#http-tuning)會傳回 403，並由[稽核日誌](/docs/zh-TW/claude-apps-gateway-deploy#logs)記錄其原因；上游的授權拒絕則會依照[上游錯誤訊息](/docs/zh-TW/claude-apps-gateway-config#upstream-error-messages)的方式傳遞
1790 1822
1791在 v2.1.273 之前，閘道工作階段上的 403 顯示通用 `Please run /login` 或 `Failed to authenticate` 訊息，再次登入不會清除拒絕。1823在 v2.1.273 之前，閘道工作階段上的 403 會改為顯示通用的 `Please run /login` 或 `Failed to authenticate` 訊息，且重新登入也無法解除該拒絕。
1792 1824
1793<h2 id="network-and-connection-errors">1825<h2 id="network-and-connection-errors">
1794 網路和連線錯誤1826 網路和連線錯誤
1979 2011
1980這些步驟會變更您自己的環境之一。[組織共享環境](/docs/zh-TW/cloud-environments#organization-shared-environments)在選擇器中以唯讀方式開啟，因此請要求擁有者從[管理設定](https://claude.ai/admin-settings)中的**雲端環境**頁面變更其網路存取。2012這些步驟會變更您自己的環境之一。[組織共享環境](/docs/zh-TW/cloud-environments#organization-shared-environments)在選擇器中以唯讀方式開啟，因此請要求擁有者從[管理設定](https://claude.ai/admin-settings)中的**雲端環境**頁面變更其網路存取。
1981 2013
1982* 開啟例行程式進行編輯，或啟動雲端工作階段。選擇顯示您環境名稱的雲端圖示（例如**預設**）以開啟選擇器。將滑鼠懸停在您的環境上，然後按一下設定圖示。2014* 開啟您的環境進行編輯，可從 [routine 的表單](/docs/zh-TW/routines#environments-and-network-access)，或從您啟動雲端工作階段的[環境選擇器](/docs/zh-TW/cloud-environments#configure-your-environment)開啟。
1983* 在**更新雲端環境**對話方塊中，將**網路存取**從**信任**變更為**自訂**，然後將被阻止的網域新增到**允許的網域**。每行輸入一個網域。檢查**也包括常見套件管理員的預設清單**以在您的自訂網域旁邊保留[預設允許清單](/docs/zh-TW/cloud-environments#default-allowed-domains)。如果您想要不受限制的存取，請改為選擇**完整**。2015* 在**編輯雲端環境**對話方塊中，將**網路存取**從**信任**變更為**自訂**，然後將被阻止的網域新增到**允許的網域**。每行輸入一個網域。勾選**也包括常見套件管理員的預設清單**以在您的自訂網域旁邊保留[預設允許清單](/docs/zh-TW/cloud-environments#default-allowed-domains)。如果您想要不受限制的存取，請改為選擇**完整**。
1984* 按一下**儲存變更**。下一次執行使用更新的允許清單。對於已開啟的雲端工作階段，請參閱[網路存取變更何時到達現有工作階段](/docs/zh-TW/cloud-environments#network-access)。2016* 按一下**儲存變更**。下一次執行使用更新的允許清單。對於已開啟的雲端工作階段，請參閱[網路存取變更何時到達現有工作階段](/docs/zh-TW/cloud-environments#network-access)。
1985 2017
1986請參閱[網路存取](/docs/zh-TW/cloud-environments#network-access)以了解存取層級和預設允許清單。本機 CLI 工作階段不受此原則影響。2018請參閱[網路存取](/docs/zh-TW/cloud-environments#network-access)以了解存取層級和預設允許清單。本機 CLI 工作階段不受此原則影響。
2314API Error: 400 ... Extra inputs are not permitted ... context_management2346API Error: 400 ... Extra inputs are not permitted ... context_management
2315```2347```
2316 2348
2317Claude Code 發送測試版專用欄位（例如 `context_management` 和 `effort`）以及啟用它們的 `anthropic-beta` 標頭。當閘道轉發正文但刪除標頭時，API 會看到它不識別的欄位。2349Claude Code 會發送測試版專用欄位（例如 `context_management`），並附上啟用它們的 `anthropic-beta` 標頭。當閘道轉發本文但刪除標頭時，API 會看到它無法識別的欄位。
2318 2350
2319**該怎麼辦：**2351**該怎麼辦：**
2320 2352
2849 命令列錯誤2881 命令列錯誤
2850</h2>2882</h2>
2851 2883
2852這些錯誤來自 `claude` 命令列及其子命令、您在提示符提交的命令名稱，以及執行 shell 命令以收集內容的命令（例如 `/security-review`），然後才執行其提示。它們也來自 `/tui`，它會重新啟動 CLI。2884這些錯誤來自 `claude` 命令列及其子命令、來自您在提示字元中送出的命令名稱，以及來自 `/security-review` 等在提示詞執行前透過執行 shell 命令收集脈絡的命令。它們也來自會重新啟動 CLI 的 `/tui`。
2853 2885
2854<h3 id="conflict-between-bg-and-print">2886<h3 id="conflict-between-bg-and-print">
2855 \--bg 和 --print 之間的衝突2887 `--bg` 與 `--print` 衝突
2856</h3>2888</h3>
2857 2889
2858此訊息需要 Claude Code v2.1.198 或更新版本。您在同一個 `claude` 呼叫中結合了 `--bg` 與 `-p` 或 `--print`。`--bg` 啟動一個[背景工作階段](/docs/zh-TW/agent-view#from-your-shell)，您稍後可以使用 `claude agents` 附加到該工作階段，而 `--print` 以[非互動模式](/docs/zh-TW/headless)執行，永遠不會啟動 `claude agents` 附加到的互動工作階段。在 v2.1.198 之前，此組合會無聲地建立一個永遠無法附加的背景工作。2890此訊息需要 Claude Code v2.1.198 或更新版本。您在同一次 `claude` 呼叫中將 `--bg` 與 `-p` 或 `--print` 合併使用。`--bg` 會啟動一個[背景工作階段](/docs/zh-TW/agent-view#from-your-shell)，供您之後以 `claude agents` 附加；而 `--print` 以[非互動方式](/docs/zh-TW/headless)執行，永遠不會啟動 `claude agents` 所附加的互動式工作階段。在 v2.1.198 之前，這種組合會默默建立一個永遠無法附加的背景工作。
2859 2891
2860```text theme={null}2892```text theme={null}
2893--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.
2861```2894```
2862 2895
2863**該怎麼做：**2896**處理方式：**
2897
2898* 移除 `-p` 或 `--print`。`--bg` 以位置引數接收提示詞，因此 `claude --bg "<task>"` 就是完整的命令。請參閱[從您的 shell 分派新的 agent](/docs/zh-TW/agent-view#from-your-shell)。
2899* 若要以非互動方式執行提示詞並印出結果，而不是建立背景工作階段，請移除 `--bg` 並執行 `claude -p "<task>"`
2864 2900
2865* 移除 `-p` 或 `--print`。`--bg` 將提示作為其位置引數，所以 `claude --bg "<task>"` 是完整命令。請參閱[從您的 shell 分派新代理](/docs/zh-TW/agent-view#from-your-shell)。2901<h3 id="conflict-between-a-system-prompt-flag-and-its-file-form">
2866* 若要以非互動模式執行提示並列印結果而不是建立背景工作階段，請移除 `--bg` 並執行 `claude -p "<task>"`2902 系統提示詞旗標與其檔案形式衝突
2903</h3>
2904
2905您在一次 `claude` 呼叫中同時傳入了 [`--append-subagent-system-prompt`](/docs/zh-TW/cli-reference#cli-flags) 與 `--append-subagent-system-prompt-file`，因此 `claude` 會以退出碼 1 結束，而不會啟動工作階段：
2906
2907```text theme={null}
2908Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.
2909```
2910
2911在 v2.1.283 之前，當您將 `--system-prompt` 與 `--system-prompt-file` 一起傳入，或將 `--append-system-prompt` 與 `--append-system-prompt-file` 一起傳入時，`claude` 也會以相同方式結束，因為這些組合會互相衝突，而不是[合併](/docs/zh-TW/cli-reference#system-prompt-flags)。在這些版本中，訊息會指出您合併使用的那一組旗標。
2912
2913**處理方式：**
2914
2915* 保留旗標的其中一種形式並移除另一種。若要將固定的提示詞檔案與每次執行的文字合併，請在啟動前將文字併入檔案，而不是同時傳入兩個旗標
2867 2916
2868<h3 id="invalid-agents-configuration">2917<h3 id="invalid-agents-configuration">
2869 無效的 --agents 設定2918 無效的 `--agents` 設定
2870</h3>2919</h3>
2871 2920
2872您傳遞給 `--agents` 的值無效，所以 `claude` 以代碼 1 結束而不是啟動工作階段。當您傳遞 `--safe-mode` 或設定 [`CLAUDE_CODE_SAFE_MODE`](/docs/zh-TW/env-vars#variables) 時，Claude Code 會完全忽略 `--agents`。使用 `--resume` 或 `--continue` 時，內嵌 JSON 值不會被檢查且工作階段會啟動；從檔案讀取的值在每次啟動時都會被檢查。在 v2.1.242 之前，Claude Code 無論如何都會啟動工作階段。2921您傳給 `--agents` 的值無效，因此 `claude` 會以退出碼 1 結束，而不會啟動工作階段。當您傳入 `--safe-mode` 或設定 [`CLAUDE_CODE_SAFE_MODE`](/docs/zh-TW/env-vars#variables) 時，Claude Code 會完全忽略 `--agents`。搭配 `--resume` 或 `--continue` 時，內嵌的 JSON 值不會受到檢查，工作階段會照常啟動；從檔案讀取的值則會在每次啟動時檢查。在 v2.1.242 之前，Claude Code 無論如何都會啟動工作階段。
2873 2922
2874```text theme={null}2923```text theme={null}
2875Error: Invalid --agents configuration:2924Error: Invalid --agents configuration:
2876<what failed>2925<what failed>
2877```2926```
2878 2927
2879第一行之後的內容取決於值如何失敗。Claude Code 按順序執行這些檢查，並在第一個失敗的檢查處停止。如果您的值有兩種問題，您只有在修復第一個問題後才會看到第二個：2928第一行之後的內容取決於該值失敗的方式。Claude Code 會依序執行以下檢查，並在第一個失敗的檢查處停止。如果您的值有兩種問題，您必須先修正第一種，才會看到第二種：
2880 2929
28811. 當值以 `{` 開頭但不能解析為 JSON，或 `--agents` 檔案的內容無法解析時，Claude Code 會列印一行 `invalid JSON:` 行，其中包含 JSON 解析器自己的訊息29301. 當值以 `{` 開頭但無法解析為 JSON，或 `--agents` 檔案的內容無法解析時，Claude Code 會印出一行 `invalid JSON:`，其中附上 JSON 剖析器本身的訊息
28822. 當它解析但代理定義與 [CLI 定義的子代理](/docs/zh-TW/sub-agents#choose-the-subagent-scope)的架構不符時，Claude Code 會為每個問題列印一行29312. 當值可以解析，但某個 agent 定義不符合 [CLI 定義之 subagent](/docs/zh-TW/sub-agents#choose-the-subagent-scope) 的 schema 時，Claude Code 會針對每個問題印出一行
28833. 當代理名稱以 `-` 開頭時，Claude Code 會列印 `<name>: agent names must not start with '-'`29323. 當 agent 名稱以 `-` 開頭時，Claude Code 會印出 `<name>: agent names must not start with '-'`
2884 2933
2885當有超過 20 行問題時，Claude Code 會列印前 20 行，並用 `…and N more` 取代其餘部分。2934當問題行超過 20 行時，Claude Code 會印出前 20 行，並以 `…and N more` 取代其餘部分。
2886 2935
2887使用 `--print` 時，`--agents` 也接受 [JSON 檔案的路徑](/docs/zh-TW/sub-agents#choose-the-subagent-scope)代替內嵌物件。在 v2.1.281 之前，`--agents` 只接受內嵌 JSON，並將檔案路徑視為無效 JSON。檔案形式有其自己的拒絕，列印在此訊息的位置，包括這些：2936搭配 `--print` 時，`--agents` 也接受以 [JSON 檔案的路徑](/docs/zh-TW/sub-agents#choose-the-subagent-scope)取代內嵌物件。在 v2.1.281 之前，`--agents` 只接受內嵌 JSON，並將檔案路徑視為無效的 JSON。檔案形式有其自身的拒絕情況，會以取代此訊息的方式印出，包括以下幾種：
2888 2937
2889* **`Error: --agents takes a JSON object, or a file path only with --print (-p)`**：Claude Code 在互動工作階段中將值讀取為檔案路徑。將定義作為內嵌 JSON 傳遞，或新增 `-p` 以從檔案讀取它們。2938* **`Error: --agents takes a JSON object, or a file path only with --print (-p)`**：Claude Code 在互動式工作階段中將該值讀取為檔案路徑。請以內嵌 JSON 傳入定義，或加上 `-p` 以從檔案讀取。
2890* **`Error: --agents file not found: <path>`**：該路徑不存在任何檔案。不以 `{` 開頭且不是有效 JSON 的值會被讀取為路徑，所以您的 shell 損壞的內嵌 JSON 也可能以這種方式失敗。檢查路徑或引號，然後再次執行命令。2939* **`Error: --agents file not found: <path>`**：該路徑上不存在檔案。不以 `{` 開頭且不是有效 JSON 的值會被當成路徑讀取，因此被您的 shell 破壞的內嵌 JSON 也可能以這種方式失敗。請檢查路徑或引號，然後再次執行命令。
2891 2940
2892**該怎麼做：**2941**處理方式：**
2893 2942
2894* 修復訊息列出的每個問題，然後再次執行命令。請參閱 [CLI 定義的子代理採用的欄位](/docs/zh-TW/sub-agents#choose-the-subagent-scope)。2943* 修正訊息列出的每個問題，然後再次執行命令。請參閱 [CLI 定義之 subagent 可接受的欄位](/docs/zh-TW/sub-agents#choose-the-subagent-scope)。
2895 2944
2896<h3 id="cloud-sessions-cannot-be-created-from-a-restricted-session">2945<h3 id="cloud-sessions-cannot-be-created-from-a-restricted-session">
2897 無法從 --restricted 工作階段建立雲端工作階段2946 無法從 `--restricted` 工作階段建立雲端工作階段
2898</h3>2947</h3>
2899 2948
2900當您使用 [`--restricted`](/docs/zh-TW/cli-reference#cli-flags) 啟動工作階段時，Claude Code 拒絕從它建立[雲端工作階段](/docs/zh-TW/claude-code-on-the-web#from-terminal-to-cloud)，因為新工作階段會在受限程序外執行，不會強制執行受限模式。Claude Code 在用戶端拒絕，在聯絡伺服器之前，所以不會建立任何雲端工作階段：2949當您以 [`--restricted`](/docs/zh-TW/cli-reference#cli-flags) 啟動工作階段時，Claude Code 會拒絕從該工作階段建立[雲端工作階段](/docs/zh-TW/claude-code-on-the-web#from-terminal-to-cloud)，因為新的工作階段會在受限程序之外執行，而不會強制執行受限模式。Claude Code 會在用戶端、聯絡伺服器之前就拒絕，因此不會建立任何雲端工作階段：
2901 2950
2902```text theme={null}2951```text theme={null}
2903Cloud sessions cannot be created from a --restricted session: they would not enforce it.2952Cloud sessions cannot be created from a --restricted session: they would not enforce it.
2904```2953```
2905 2954
2906**該怎麼做：**2955**處理方式：**
2907 2956
2908* 在受限工作階段中本地執行工作2957* 在受限工作階段中於本機執行該任務
2909* 如果您控制工作階段的啟動方式，請啟動新的 `claude` 工作階段而不使用 `--restricted`，並從那裡建立雲端工作階段2958* 如果您能控制工作階段的啟動方式，請在不使用 `--restricted` 的情況下啟動新的 `claude` 工作階段，並從那裡建立雲端工作階段
2910 2959
2911在 v2.1.248 之前，Claude Code 沒有 `--restricted` 旗標；較早的版本會以未知選項錯誤拒絕該旗標。2960在 v2.1.248 之前，Claude Code 沒有 `--restricted` 旗標；較早的版本會以未知選項錯誤拒絕該旗標本身。
2912 2961
2913<h3 id="cloud-sessions-are-disabled-by-your-organizations-policy">2962<h3 id="cloud-sessions-are-disabled-by-your-organizations-policy">
2914 您的組織政策已停用雲端工作階段2963 雲端工作階段已被您組織的政策停用
2915</h3>2964</h3>
2916 2965
2917您的組織的 `allow_remote_sessions` 政策已關閉，所以[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)和使用它們的命令不可用：2966您組織的 `allow_remote_sessions` 政策已關閉，因此無法使用[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)及使用它們的命令：
2918 2967
2919```text theme={null}2968```text theme={null}
2920Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.2969Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.
2921```2970```
2922 2971
2923當您[從終端建立雲端工作階段](/docs/zh-TW/claude-code-on-the-web#from-terminal-to-cloud)時會出現此訊息，當您提交需要雲端工作階段的命令時，例如 `/teleport`、`/remote-env` 或 `/web-setup`。在 v2.1.268 之前，提交其中一個命令會傳回[`Unknown command`](#unknown-command)。2972當您[從終端機建立雲端工作階段](/docs/zh-TW/claude-code-on-the-web#from-terminal-to-cloud)時，以及當您送出需要雲端工作階段的命令（例如 `/teleport`、`/remote-env` 或 `/web-setup`）時，就會出現此訊息。在 v2.1.268 之前，送出這些命令之一會改為回傳 [`Unknown command`](#unknown-command)。
2924 2973
2925這是伺服器端組織政策，所以無法從本地設定、環境變數或 CLI 旗標覆蓋。2974這是伺服器端的組織政策，因此無法透過本機設定、環境變數或 CLI 旗標覆寫。
2926 2975
2927如果 Claude Code 尚未載入您的組織政策或無法擷取它，這些命令會改為回答 `Couldn't verify your organization's policy for cloud sessions. Check your network connection, then restart Claude Code and try again.`。2976如果 Claude Code 尚未載入您組織的政策或無法擷取政策，這些命令會改為回應 `Couldn't verify your organization's policy for cloud sessions. Check your network connection, then restart Claude Code and try again.`。
2928 2977
2929**該怎麼做：**2978**處理方式：**
2930 2979
2931* 要求您的組織中的[擁有者](/docs/zh-TW/server-managed-settings#access-control)在 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) 的 Claude Code 管理設定中啟用雲端工作階段2980* 請您組織中的 [Owner](/docs/zh-TW/server-managed-settings#access-control) 在 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) 的 Claude Code 管理設定中啟用雲端工作階段
2932* 如果訊息說它無法驗證政策，請檢查您的網路連線，然後重新啟動 Claude Code 並再試一次2981* 如果訊息表示無法驗證政策，請檢查您的網路連線，然後重新啟動 Claude Code 並再試一次
2933 2982
2934<h3 id="the-json-schema-value-is-not-a-valid-json-schema">2983<h3 id="the-json-schema-value-is-not-a-valid-json-schema">
2935 \--json-schema 值不是有效的 JSON Schema2984 `--json-schema` 的值不是有效的 JSON Schema
2936</h3>2985</h3>
2937 2986
2938您傳遞給 [`--json-schema`](/docs/zh-TW/cli-reference#cli-flags) 的架構在[非互動模式](/docs/zh-TW/headless#get-structured-output)中無法通過 JSON Schema 編譯，所以 `claude` 以代碼 1 結束而不是執行提示。在 v2.1.205 之前，無效的架構會產生無結構的輸出而沒有錯誤，任何使用 `format` 關鍵字的架構都被視為無效。2987您在[非互動模式](/docs/zh-TW/headless#get-structured-output)中傳給 [`--json-schema`](/docs/zh-TW/cli-reference#cli-flags) 的 schema 未能通過 JSON Schema 編譯，因此 `claude` 會以退出碼 1 結束，而不會執行提示詞。在 v2.1.205 之前，無效的 schema 會產生非結構化輸出而不報錯，且任何使用 `format` 關鍵字的 schema 都會被視為無效。
2939 2988
2940```text theme={null}2989```text theme={null}
2941Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values2990Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values
2942```2991```
2943 2992
2944第二個冒號後的文字是驗證器的診斷，並命名失敗的關鍵字或位置。使用 `format` 關鍵字的架構，例如 `"format": "email"`，是有效的：Claude Code 接受 `format` 作為註釋，不強制執行它。2993第二個冒號之後的文字是驗證器的診斷訊息，會指出失敗的關鍵字或位置。使用 `format` 關鍵字的 schema（例如 `"format": "email"`）是有效的：Claude Code 將 `format` 視為註解接受，且不會強制執行它。
2945 2994
2946Claude Code 在架構編譯之前執行兩項檢查：它拒絕不可解析的 JSON 值，並顯示 `Error: --json-schema is not valid JSON`，以及有效但不是物件的 JSON，並顯示 `Error: --json-schema must be a JSON object`。2995Claude Code 會在 schema 編譯前執行兩項檢查：對於無法解析為 JSON 的值，它會以 `Error: --json-schema is not valid JSON` 拒絕；對於有效但不是物件的 JSON，則以 `Error: --json-schema must be a JSON object` 拒絕。
2947 2996
2948**該怎麼做：**2997**處理方式：**
2949 2998
2950* 修復診斷命名的架構部分，然後重新執行命令2999* 修正診斷訊息所指出的 schema 部分，然後重新執行命令
2951* 請參閱[取得結構化輸出](/docs/zh-TW/headless#get-structured-output)以取得有效的架構和命令3000* 請參閱[取得結構化輸出](/docs/zh-TW/headless#get-structured-output)，了解可運作的 schema 與命令
2952 3001
2953<h3 id="settings-file-exceeds-the-2mib-limit">3002<h3 id="settings-file-exceeds-the-2mib-limit">
2954 設定檔超過 2MiB 限制3003 設定檔超過 2MiB 限制
2955</h3>3004</h3>
2956 3005
2957您傳遞給 [`--settings`](/docs/zh-TW/cli-reference#cli-flags) 的檔案大於 2 MiB，所以 `claude` 在啟動時以代碼 1 結束而不是載入它。在 v2.1.214 之前，Claude Code 讀取檔案時沒有大小檢查，多 GB 檔案或 `/dev/zero` 等裝置檔案會無限制地增加記憶體。3006您傳給 [`--settings`](/docs/zh-TW/cli-reference#cli-flags) 的檔案大於 2 MiB，因此 `claude` 會在啟動時以退出碼 1 結束，而不會載入它。在 v2.1.214 之前，Claude Code 讀取檔案時不會檢查大小，數 GB 的檔案或 `/dev/zero` 之類的裝置檔案會讓記憶體無限制地增長。
2958 3007
2959```text theme={null}3008```text theme={null}
2960Error: Settings file exceeds the 2MiB limit: /path/to/settings.json3009Error: Settings file exceeds the 2MiB limit: /path/to/settings.json
2961```3010```
2962 3011
2963Claude Code 以相同方式拒絕不是常規檔案的 `--settings` 路徑：裝置、FIFO 或通訊端會報告 `Error: Cannot use settings file (Not a regular file (device, FIFO, or socket))`，後面跟著路徑，目錄會報告 `EISDIR` 原因。3012Claude Code 會以相同方式拒絕不是一般檔案的 `--settings` 路徑：裝置、FIFO 或 socket 會回報 `Error: Cannot use settings file (Not a regular file (device, FIFO, or socket))`，後接路徑；目錄則會回報 `EISDIR` 原因。
2964 3013
2965**該怎麼做：**3014**處理方式：**
2966 3015
2967* 將 `--settings` 指向 2 MiB 以下的常規 JSON 設定檔。請參閱[設定](/docs/zh-TW/settings)以了解格式。3016* 將 `--settings` 指向小於 2 MiB 的一般 JSON 設定檔。格式請參閱[設定](/docs/zh-TW/settings)。
2968 3017
2969<h3 id="the-current-directory-no-longer-exists">3018<h3 id="the-current-directory-no-longer-exists">
2970 目前目錄不再存在3019 目前目錄已不存在
2971</h3>3020</h3>
2972 3021
2973您從一個在您的 shell 進入後被刪除或移動的目錄啟動 `claude`，例如另一個 shell 移除的 worktree 或臨時目錄。Claude Code 無法讀取其工作目錄，所以它在啟動工作階段之前以代碼 1 結束，在互動和[非互動](/docs/zh-TW/headless)模式中都是如此。在 v2.1.239 之前，Claude Code 會因縮小的套件來源和原始 `ENOENT ... uv_cwd` 堆疊在 stderr 上而崩潰，而不是顯示此訊息。3022您從一個在您的 shell 進入後已被刪除或移動的目錄啟動了 `claude`，例如另一個 shell 移除的 worktree 或暫存目錄。Claude Code 無法讀取其工作目錄，因此會在啟動工作階段前以退出碼 1 結束，互動模式與[非互動](/docs/zh-TW/headless)模式皆然。在 v2.1.239 之前，Claude Code 會當機，並在 stderr 上輸出壓縮過的套件原始碼與原始的 `ENOENT ... uv_cwd` 堆疊，而不是此訊息。
2974 3023
2975```text theme={null}3024```text theme={null}
2976The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.3025The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.
2977error: The current working directory was deleted, so that command didn't work. Please cd into a different directory and try again.3026error: The current working directory was deleted, so that command didn't work. Please cd into a different directory and try again.
2978```3027```
2979 3028
2980原因和修復對兩種形式都是相同的。3029兩種形式的原因與修正方法相同。
2981 3030
2982當 Claude Code 因不同的原因（例如權限變更）無法讀取工作目錄時，訊息會命名錯誤代碼：`Can't read the current directory (EACCES). Start Claude Code from a different directory.`3031當 Claude Code 因其他原因（例如權限變更）無法讀取工作目錄時，訊息會改為指出錯誤碼：`Can't read the current directory (EACCES). Start Claude Code from a different directory.`
2983 3032
2984在 macOS 上，`~/Desktop`、`~/Documents`、`~/Downloads` 或 iCloud Drive 中目錄的 `EPERM` 通常表示 macOS 阻止您的終端應用程式存取該資料夾。讀取該資料夾的其他命令也會以相同方式失敗：即使使用 `sudo`，`ls` 也會報告 `Operation not permitted`。3033在 macOS 上，若 `~/Desktop`、`~/Documents`、`~/Downloads` 或 iCloud Drive 中的目錄出現 `EPERM`，通常表示 macOS 正在阻擋您的終端機應用程式存取該資料夾。其他讀取該資料夾的命令也會以相同方式失敗：在該處執行 `ls` 會回報 `Operation not permitted`，即使使用 `sudo` 也一樣。
2985 3034
2986**該怎麼做：**3035**處理方式：**
2987 3036
2988* 變更為存在的目錄，例如您的主目錄或專案目錄，然後再次執行 `claude`3037* 切換到存在的目錄，例如您的家目錄或專案目錄，然後再次執行 `claude`
2989* 如果目錄在相同路徑被重新建立，您的 shell 仍然持有已刪除的目錄。執行 `cd "$PWD"` 或離開並重新進入目錄，然後執行 `claude`3038* 如果該目錄已在相同路徑重新建立，您的 shell 仍持有已刪除的那個目錄。請執行 `cd "$PWD"`，或離開後重新進入該目錄，然後再次執行 `claude`
2990* 對於 macOS 上的 `EPERM`，使用 Cmd+Q 結束您的終端應用程式，重新開啟它，返回該資料夾，然後執行 `claude`。如果該資料夾中的 `ls` 仍然失敗，請開啟**系統設定 > 隱私與安全 > 檔案和資料夾**，為您的終端應用程式開啟該資料夾，然後重新開啟終端3039* 對於 macOS 上的 `EPERM`，請以 Cmd+Q 結束您的終端機應用程式，重新開啟它，回到該資料夾並執行 `claude`。如果在該資料夾中執行 `ls` 仍然失敗，請開啟 **系統設定 > 隱私權與安全性 > 檔案與資料夾**，為您的終端機應用程式開啟該資料夾，然後重新開啟終端機
2991 3040
2992<h3 id="temp-directory-refused-or-cannot-be-created">3041<h3 id="temp-directory-refused-or-cannot-be-created">
2993 臨時目錄被拒絕或無法建立3042 暫存目錄遭拒絕或無法建立
2994</h3>3043</h3>
2995 3044
2996在 macOS 和 Linux 上，Claude Code 在啟動時建立一個私有臨時目錄 `claude-<uid>`，位於系統臨時目錄或 [`CLAUDE_CODE_TMPDIR`](/docs/zh-TW/env-vars) 覆蓋下。當無法建立目錄，或該路徑上的現有項目無法通過安全檢查時，Claude Code 會將失敗列印到 stderr 並以代碼 1 結束而不是啟動工作階段：3045在 macOS 與 Linux 上，Claude Code 會在啟動時建立一個私有暫存目錄 `claude-<uid>`，位於系統暫存目錄或 [`CLAUDE_CODE_TMPDIR`](/docs/zh-TW/env-vars) 覆寫值之下。當該目錄無法建立，或該路徑上已存在的項目未通過安全檢查時，Claude Code 會將失敗原因印到 stderr 並以退出碼 1 結束，而不會啟動工作階段：
2997 3046
2998```text wrap theme={null}3047```text wrap theme={null}
2999ENOSPC: no space left on device, mkdir '/tmp/claude-501'3048ENOSPC: no space left on device, mkdir '/tmp/claude-501'
3006Temp directory /tmp/claude-501 is not readable (its mode may have been altered, or a path component denies search). Refusing to use it — restore its permissions (chmod 0700) or remove it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it.3054Temp directory /tmp/claude-501 is not readable (its mode may have been altered, or a path component denies search). Refusing to use it — restore its permissions (chmod 0700) or remove it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it.
3007```3055```
3008 3056
3009**該怎麼做：**3057**處理方式：**
3010 3058
3011* 對於 `ENOSPC`，釋放保存臨時目錄的磁碟區上的磁碟空間3059* 對於 `ENOSPC`，請釋放存放暫存目錄之磁碟區的磁碟空間
3012* 對於 `Refusing to use it` 形式，移除命名的項目本身，而不是連結指向的內容，然後啟動 Claude Code；對於 `owned by uid` 形式，只有管理員或該使用者可以移除它3060* 對於 `Refusing to use it` 形式，請移除所指出的項目本身，而不是連結所指向的目標，然後再次啟動 Claude Code；對於 `owned by uid` 形式，只有管理員或該使用者可以移除它
3013* 對於 `is not readable`，在命名的目錄上執行 `chmod 0700`，或移除它並重新啟動3061* 對於 `is not readable`，請對所指出的目錄執行 `chmod 0700`，或將其移除後重新啟動
3014* 在任何這些情況下，將 [`CLAUDE_CODE_TMPDIR`](/docs/zh-TW/env-vars) 設定為您控制的目錄並啟動 Claude Code，保留被拒絕的路徑不變3062* 在上述任何情況下，您都可以將 [`CLAUDE_CODE_TMPDIR`](/docs/zh-TW/env-vars) 設為您可控制的目錄並再次啟動 Claude Code，不需理會遭拒絕的路徑
3015 3063
3016<h3 id="directory-couldnt-be-resolved-to-a-real-location">3064<h3 id="directory-couldnt-be-resolved-to-a-real-location">
3017 目錄無法解析為真實位置3065 目錄無法解析為實際位置
3018</h3>3066</h3>
3019 3067
3020您為工作目錄的子目錄執行了 `/add-dir`，Claude Code 無法將目錄解析為其真實位置。3068您對工作目錄的子目錄執行了 `/add-dir`，而 Claude Code 無法將該目錄解析為其實際位置。
3021 3069
3022您已經可以存取工作目錄的子目錄，所以 `/add-dir` 只會載入其技能、命令和代理。在載入它們之前，Claude Code 會檢查目錄的真實位置（解析任何符號連結）是否在工作目錄內。當 Claude Code 無法解析該位置時，它不會載入任何內容並顯示此訊息：3070您對工作目錄的子目錄本來就有檔案存取權，因此 `/add-dir` 只會載入其 skill、命令與 agent。在載入之前，Claude Code 會檢查該目錄解析所有符號連結後的實際位置是否位於工作目錄內。當 Claude Code 無法解析該位置時，它不會載入任何內容，並顯示此訊息：
3023 3071
3024```text theme={null}3072```text theme={null}
3025packages/app couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded. Check that it is a directory inside the working directory and try again.3073packages/app couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded. Check that it is a directory inside the working directory and try again.
3026```3074```
3027 3075
3028**該怎麼做：**3076**處理方式：**
3029 3077
3030* 檢查路徑是否命名工作目錄內的真實目錄，然後再次執行 `/add-dir`3078* 確認該路徑指向工作目錄內的實際目錄，然後再次執行 `/add-dir`
3031* 訊息不會改變您的檔案存取；它只報告目錄的 `.claude/` 內容未被載入3079* 此訊息不會改變您的檔案存取權；它只是回報該目錄的 `.claude/` 內容未被載入
3032 3080
3033在 v2.1.261 之前，當工作目錄在 `/net/<host>` 自動掛載上時，此訊息也會為每個 `/add-dir <subdirectory>` 出現，Claude Code 根據設計拒絕解析路徑；目錄很好，重試無法幫助。3081在 v2.1.261 之前，當工作目錄位於 `/net/<host>` 自動掛載點上時，每次執行 `/add-dir <subdirectory>` 也都會出現此訊息，因為 Claude Code 在設計上會拒絕解析這類路徑；該目錄本身沒有問題，重試也無濟於事。
3034 3082
3035<h3 id="workspace-not-trusted-when-starting-remote-control">3083<h3 id="workspace-not-trusted-when-starting-remote-control">
3036 啟動遠端控制時工作區未受信任3084 啟動 Remote Control 時工作區未受信任
3037</h3>3085</h3>
3038 3086
3039您在未信任的目錄中使用 `claude remote-control` 或其 `claude rc` 別名啟動[遠端控制](/docs/zh-TW/remote-control)伺服器模式，命令無法詢問您是否信任它。例如，命令的標準輸入或標準輸出不是終端，因為其中一個被重新導向或管道化。命令以代碼 1 結束：3087您在尚未信任的目錄中以 `claude remote-control` 或其別名 `claude rc` 啟動了 [Remote Control](/docs/zh-TW/remote-control) 伺服器模式，而該命令無法詢問您是否信任此目錄。例如，由於標準輸入或標準輸出之一被重新導向或透過管線傳送，命令的標準輸入或標準輸出不是終端機。該命令會以退出碼 1 結束：
3040 3088
3041```text theme={null}3089```text theme={null}
3042Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.3090Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.
3043```3091```
3044 3092
3045兩個也以 `Error: Workspace not trusted.` 開頭的變體也會在終端中出現，終端太小而無法顯示信任目錄會開啟什麼，或沒有報告其大小的終端。放大視窗或切換到正常終端視窗，然後再次執行 `claude rc`。3093另外兩種同樣以 `Error: Workspace not trusted.` 開頭的變體，會出現在太小而無法顯示信任該目錄會啟用哪些功能的終端機中，或未回報其大小的終端機中。請放大視窗或切換到一般終端機視窗，然後再次執行 `claude rc`。
3046 3094
3047在您的主目錄中，訊息是不同的，因為工作區信任對話框永遠不會為主目錄保存信任，所以在那裡接受它無法滿足此檢查。在 v2.1.214 之前，主目錄顯示上面的訊息，其建議無法在那裡成功。3095在您的家目錄中，訊息會不同，因為工作區信任對話框永遠不會為家目錄儲存信任，因此在那裡接受它無法滿足此檢查。在 v2.1.214 之前，家目錄會顯示上述訊息，而其建議在那裡無法成功。
3048 3096
3049```text theme={null}3097```text theme={null}
3050Error: Workspace not trusted. /Users/you is your home directory, and for security home-directory trust is never saved, so running `claude` here first won't help. Run `claude rc` from a project directory instead (run `claude` there once to accept the trust dialog).3098Error: Workspace not trusted. /Users/you is your home directory, and for security home-directory trust is never saved, so running `claude` here first won't help. Run `claude rc` from a project directory instead (run `claude` there once to accept the trust dialog).
3051```3099```
3052 3100
3053如果您在 [`Trust <directory>?` 問題](/docs/zh-TW/remote-control#requirements)回答 `n` 或按 Enter，命令會列印一條 `Remote Control did not start` 訊息，命名目錄並以代碼 1 結束。再次執行 `claude rc` 以回答 `y`。3101如果您在 [`Trust <directory>?` 問題](/docs/zh-TW/remote-control#requirements)中回答 `n` 或按下 Enter，該命令會印出一則指出該目錄的 `Remote Control did not start` 訊息，並以退出碼 1 結束。請再次執行 `claude rc` 並回答 `y`。
3054 3102
3055**該怎麼做：**3103**處理方式：**
3056 3104
3057* 首先從終端信任目錄：在那裡執行 `claude rc` 並回答 `y`，或執行 `claude` 並接受[工作區信任對話框](/docs/zh-TW/permissions#project-allow-rules-and-workspace-trust)，然後再次執行您的原始命令3105* 先從終端機信任該目錄：在該處執行 `claude rc` 並回答 `y`，或在該處執行 `claude` 並接受[工作區信任對話框](/docs/zh-TW/permissions#project-allow-rules-and-workspace-trust)，然後再次執行您原本的命令
3058* 在您的主目錄中，變更為專案目錄並在那裡啟動遠端控制3106* 在您的家目錄中，請切換到專案目錄並在那裡啟動 Remote Control
3059 3107
3060在 v2.1.284 之前，命令永遠不會詢問，即使在終端中也是如此。3108在 v2.1.284 之前，即使在終端機中，該命令也從不詢問。
3061 3109
3062<h3 id="not-carried-over-to-the-sessions-remote-control-starts">3110<h3 id="not-carried-over-to-the-sessions-remote-control-starts">
3063 未被遠端控制啟動的工作階段帶過去3111 不會傳遞到 Remote Control 啟動的工作階段
3064</h3>3112</h3>
3065 3113
3066您使用全域 `claude` 旗標在 `remote-control` 動詞之前啟動[遠端控制](/docs/zh-TW/remote-control)，該旗標會限制或設定遠端控制啟動的工作階段，例如 `--settings`、`--setting-sources`、`--permission-mode`、`--disallowed-tools` 或 `--mcp-config`。放在動詞之前的旗標永遠不會到達這些工作階段。Claude Code 拒絕啟動，命名旗標：3114您在 `remote-control` 動詞之前加上了一個全域 `claude` 旗標來啟動 [Remote Control](/docs/zh-TW/remote-control)，且該旗標會限制或設定 Remote Control 所啟動的工作階段，例如 `--settings`、`--setting-sources`、`--permission-mode`、`--disallowed-tools` 或 `--mcp-config`。放在動詞之前的旗標永遠不會傳遞到這些工作階段。Claude Code 會改為拒絕啟動，並指出該旗標：
3067 3115
3068```text theme={null}3116```text theme={null}
3069Error: `--settings` before `remote-control` is not carried over to the sessions Remote Control starts, so Remote Control refuses to start rather than drop it — remove it, and give Remote Control's own options after the verb (see `claude remote-control --help`).3117Error: `--settings` before `remote-control` is not carried over to the sessions Remote Control starts, so Remote Control refuses to start rather than drop it — remove it, and give Remote Control's own options after the verb (see `claude remote-control --help`).
3070```3118```
3071 3119
3072Claude Code 不拒絕無害的全域旗標，例如 `--verbose`、`--model` 或包裝器注入的 `--session-id` 或 `--plugin-dir`：它忽略它們，遠端控制啟動。3120Claude Code 不會拒絕那些捨棄後無害的全域旗標，例如 `--verbose`、`--model`，或由包裝程式注入的 `--session-id` 或 `--plugin-dir`：它會忽略這些旗標，Remote Control 照常啟動。
3073 3121
3074Claude Code 也拒絕為它尚未識別為無害的全域旗標啟動，所以在較新版本中新增的旗標可能會在此訊息中出現，直到稍後的版本將其標記為無害。3122對於尚未被 Claude Code 認定為無害的全域旗標，Claude Code 也會拒絕啟動，因此較新版本中新增的旗標可能會出現在此訊息中，直到後續版本將其標記為無害為止。
3075 3123
3076**該怎麼做：**3124**處理方式：**
3077 3125
3078* 從動詞之前移除旗標，並在其後傳遞[遠端控制自己的選項](/docs/zh-TW/remote-control#start-a-remote-control-session)；`claude remote-control --help` 列出它們3126* 從動詞之前移除該旗標，並在動詞之後傳入 [Remote Control 自身的選項](/docs/zh-TW/remote-control#start-a-remote-control-session)；`claude remote-control --help` 會列出這些選項
3079* 當被拒絕的旗標是 `--permission-mode` 時，執行 `claude remote-control --permission-mode <mode>` 以設定遠端控制啟動的工作階段的權限模式3127* 當被拒絕的旗標是 `--permission-mode` 時，請執行 `claude remote-control --permission-mode <mode>`，為 Remote Control 所啟動的工作階段設定權限模式
3080 3128
3081在 v2.1.248 之前，當全域旗標首先出現時，`claude remote-control` 不接受其自己的旗標，命令失敗並出現未知選項錯誤。3129在 v2.1.248 之前，當全域旗標放在前面時，`claude remote-control` 不接受其自身的旗標，且命令會以 `unknown option` 錯誤失敗。
3082 3130
3083<h3 id="claude-import-is-not-yet-available-in-this-build">3131<h3 id="claude-import-is-not-yet-available-in-this-build">
3084 claude import 在此組建中尚不可用3132 此建置尚無法使用 claude import
3085</h3>3133</h3>
3086 3134
3087您執行了 [`claude import`](/docs/zh-TW/cli-reference#cli-commands)，Claude Code 發現匯入流程已關閉，所以命令以代碼 1 結束而不是啟動匯入。在 v2.1.222 之前，關閉匯入流程的組建會將 `import` 視為提示並啟動互動工作階段，而不是列印此訊息。3135您執行了 [`claude import`](/docs/zh-TW/cli-reference#cli-commands)，而 Claude Code 發現匯入流程已關閉，因此該命令會以退出碼 1 結束，而不會開始匯入。在 v2.1.222 之前，匯入流程關閉的建置會將 `import` 當成提示詞，並啟動互動式工作階段，而不是印出此訊息。
3088 3136
3089```text theme={null}3137```text theme={null}
3090`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.3138`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.
3091```3139```
3092 3140
3093Claude Code 通過它從 Anthropic 擷取並在磁碟上快取的功能旗標開啟 `claude import`。此訊息表示快取的值已關閉。原因通常是以下之一：3141Claude Code 透過從 Anthropic 擷取並快取在磁碟上的功能旗標來開啟 `claude import`。此訊息表示快取的值為關閉。原因通常是下列之一：
3094 3142
3095* 您自安裝以來尚未啟動工作階段，所以 Claude Code 尚未擷取旗標。第一個 `claude import` 即使該功能對您可用，也可能列印此訊息。3143* 您在安裝後尚未啟動過工作階段，因此 Claude Code 尚未擷取該旗標。即使您可以使用此功能，第一次執行 `claude import` 也可能印出此訊息。
3096* 您通過 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 或 AWS 上的 Claude Platform，或通過[Claude 應用程式閘道](/docs/zh-TW/claude-apps-gateway#availability-and-limitations)使用 Claude Code。Claude Code 在這些工作階段中不擷取功能旗標，所以 `claude import` 保持不可用。3144* 您透過 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 或 Claude Platform on AWS，或透過 [Claude apps 閘道](/docs/zh-TW/claude-apps-gateway#availability-and-limitations)使用 Claude Code。Claude Code 在這些工作階段中不會擷取功能旗標，因此 `claude import` 會一直無法使用。
3097* 您設定了 `DISABLE_TELEMETRY`、`DO_NOT_TRACK`、`DISABLE_GROWTHBOOK` 或 [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/zh-TW/env-vars)，它們關閉功能旗標擷取，所以 `claude import` 保持不可用。3145* 您設定了 `DISABLE_TELEMETRY`、`DO_NOT_TRACK`、`DISABLE_GROWTHBOOK` 或 [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/zh-TW/env-vars)，這些會關閉功能旗標擷取，因此 `claude import` 會一直無法使用。
3098 3146
3099**該怎麼做：**3147**處理方式：**
3100 3148
3101* 在新安裝上，啟動 `claude`，等待工作階段載入，結束，然後再次執行 `claude import`3149* 在全新安裝上，請啟動 `claude`，等待工作階段載入後結束，然後再次執行 `claude import`
3102* 在功能旗標擷取保持關閉的地方，自己設定設定：使用 [`claude mcp add`](/docs/zh-TW/mcp#installing-mcp-servers) 新增 MCP 伺服器，並建立您想要帶過去的 [`CLAUDE.md` 檔案](/docs/zh-TW/memory#how-claude-md-files-load)、[技能和命令](/docs/zh-TW/skills#where-skills-live)以及[子代理](/docs/zh-TW/sub-agents#choose-the-subagent-scope)。訊息也命名 `~/.claude/settings.json`。在 `claude import` 帶過去的設定中，該檔案只保存[權限模式](/docs/zh-TW/settings-reference#permission-settings)；Claude Code 不從它讀取 MCP 伺服器。3150* 在功能旗標擷取保持關閉的情況下，請自行建立設定：以 [`claude mcp add`](/docs/zh-TW/mcp#installing-mcp-servers) 新增 MCP 伺服器，並建立您想要轉移的 [`CLAUDE.md` 檔案](/docs/zh-TW/memory#how-claude-md-files-load)、[skill 與命令](/docs/zh-TW/skills#where-skills-live)，以及 [subagent](/docs/zh-TW/sub-agents#choose-the-subagent-scope)。訊息中也提到了 `~/.claude/settings.json`。在 `claude import` 所轉移的設定中，該檔案只包含[權限模式](/docs/zh-TW/settings-reference#permission-settings)；Claude Code 不會從中讀取 MCP 伺服器。
3103 3151
3104<h3 id="could-not-read-claude-code-config">3152<h3 id="could-not-read-claude-code-config">
3105 無法讀取 Claude Code 設定3153 無法讀取 Claude Code 設定
3106</h3>3154</h3>
3107 3155
3108您在 Claude Code 無法解析 `~/.claude.json` 時執行了 [`claude import`](/docs/zh-TW/cli-reference#cli-commands)，該檔案是它儲存您的登入和每個專案狀態的地方。子命令讀取該檔案以檢查可用性，但不顯示互動工作階段顯示的復原對話框，所以它以代碼 1 結束。在 v2.1.222 之前，具有不可讀設定檔的 `claude import` 啟動了互動工作階段，其復原對話框處理了該檔案。3156您在 Claude Code 無法剖析 `~/.claude.json` 時執行了 [`claude import`](/docs/zh-TW/cli-reference#cli-commands)，該檔案儲存您的登入與各專案狀態。此子命令會讀取該檔案以檢查可用性，但不會顯示互動式工作階段所顯示的復原對話框，因此會以退出碼 1 結束。在 v2.1.222 之前，在設定檔無法讀取時執行 `claude import` 會啟動互動式工作階段，由其復原對話框處理該檔案。
3109 3157
3110```text theme={null}3158```text theme={null}
3111Could not read Claude Code config — run `claude` with no arguments to recover it.3159Could not read Claude Code config — run `claude` with no arguments to recover it.
3112```3160```
3113 3161
3114**該怎麼做：**3162**處理方式：**
3115 3163
3116* 執行不帶引數的 `claude`。Claude Code 偵測無效檔案並提供重設它。然後再次執行 `claude import`。3164* 不帶任何引數執行 `claude`。Claude Code 會偵測到無效的檔案並提供重設選項。然後再次執行 `claude import`。
3117* 若要保留您所做的手動編輯，請在編輯器中修復 `~/.claude.json` 中的 JSON 語法，然後重新執行 `claude import`3165* 若要保留您手動進行的編輯，請改為在編輯器中修正 `~/.claude.json` 的 JSON 語法，然後重新執行 `claude import`
3118 3166
3119<h3 id="could-not-import-a-server-from-claude-desktop">3167<h3 id="could-not-import-a-server-from-claude-desktop">
3120 無法從 Claude Desktop 匯入伺服器3168 無法從 Claude Desktop 匯入伺服器
3121</h3>3169</h3>
3122 3170
3123Claude Code 無法新增您在 `claude mcp add-from-claude-desktop` 中選擇的其中一個伺服器。命令仍會匯入其他選定的伺服器，並為每個無法新增的伺服器列印一行。在 v2.1.205 之前，第一個失敗的伺服器停止了匯入。3171Claude Code 無法新增您在 `claude mcp add-from-claude-desktop` 中選取的其中一個伺服器。該命令仍會匯入其他選取的伺服器，並為每個無法新增的伺服器印出一行訊息。在 v2.1.205 之前，第一個失敗的伺服器會中止匯入。
3124 3172
3125```text theme={null}3173```text theme={null}
3126Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.3174Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.
3127```3175```
3128 3176
3129伺服器名稱後的文字是原因。最常見的是名稱檢查：Claude Desktop 允許伺服器名稱中的字元，例如空格和句號，而 `claude mcp` 限制為字母、數字、連字號和底線。其他原因包括無法通過驗證的伺服器設定和被您的組織[MCP 政策](/docs/zh-TW/managed-mcp)阻止的伺服器。3177伺服器名稱之後的文字就是原因。最常見的是名稱檢查：Claude Desktop 允許伺服器名稱中包含空格與句點等字元，而 `claude mcp` 將其限制為字母、數字、連字號與底線。其他原因包括伺服器設定未通過驗證，以及伺服器遭您組織的 [MCP 政策](/docs/zh-TW/managed-mcp)封鎖。
3130 3178
3131**該怎麼做：**3179**處理方式：**
3132 3180
3133* 在 `claude_desktop_config.json` 中重新命名伺服器以僅使用字母、數字、連字號和底線，然後再次執行 `claude mcp add-from-claude-desktop`3181* 將 `claude_desktop_config.json` 中的伺服器重新命名為僅使用字母、數字、連字號與底線，然後再次執行 `claude mcp add-from-claude-desktop`
3134* 使用有效名稱直接使用 `claude mcp add` 或 `claude mcp add-json` 新增該伺服器。請參閱[從 Claude Desktop 匯入 MCP 伺服器](/docs/zh-TW/mcp#import-mcp-servers-from-claude-desktop)。3182* 以有效的名稱透過 `claude mcp add` 或 `claude mcp add-json` 直接新增該伺服器。請參閱[從 Claude Desktop 匯入 MCP 伺服器](/docs/zh-TW/mcp#import-mcp-servers-from-claude-desktop)。
3135 3183
3136<h3 id="cannot-add-mcp-server-to-the-managed-scope">3184<h3 id="cannot-add-mcp-server-to-the-managed-scope">
3137 無法將 MCP 伺服器新增到受管範圍3185 無法將 MCP 伺服器新增到 managed 範圍
3138</h3>3186</h3>
3139 3187
3140您使用 `--scope managed` 執行了 `claude mcp add` 或 `claude mcp add-json`。該範圍保存您的組織通過 [`managedMcpServers`](/docs/zh-TW/settings-reference#managedmcpservers) 受管設定提供的伺服器。Claude Code 只從受管設定讀取它們，所以命令無法將伺服器寫入該範圍。3188您以 `--scope managed` 執行了 `claude mcp add` 或 `claude mcp add-json`。該範圍存放您組織透過 [`managedMcpServers`](/docs/zh-TW/settings-reference#managedmcpservers) 受管設定所提供的伺服器。Claude Code 只會從受管設定讀取這些伺服器，因此該命令無法將伺服器寫入該範圍。
3141 3189
3142```text theme={null}3190```text theme={null}
3143Cannot add MCP server to scope: managed3191Cannot add MCP server to scope: managed
3144```3192```
3145 3193
3146**該怎麼做：**3194**處理方式：**
3195
3196* 將伺服器新增到您可寫入的範圍：`local`、`user` 或 `project`。未指定 `--scope` 時，該命令使用 `local`。請參閱 [MCP 安裝範圍](/docs/zh-TW/mcp#mcp-installation-scopes)
3197* 若要將伺服器提供給您組織中的每位使用者，請將其新增到您所部署之受管設定中的 [`managedMcpServers`](/docs/zh-TW/settings-reference#managedmcpservers)
3147 3198
3148* 將伺服器新增到您可以寫入的範圍：`local`、`user` 或 `project`。不使用 `--scope` 時，命令使用 `local`。請參閱 [MCP 安裝範圍](/docs/zh-TW/mcp#mcp-installation-scopes)3199<h3 id="cannot-add-mcp-server-when-managed-settings-allow-only-plugin-servers">
3149* 若要為您的組織中的每個使用者提供伺服器，請將其新增到您部署的受管設定中的 [`managedMcpServers`](/docs/zh-TW/settings-reference#managedmcpservers)3200 受管設定僅允許外掛伺服器時無法新增 MCP 伺服器
3201</h3>
3202
3203您在組織的受管設定將 [`strictPluginOnlyCustomization`](/docs/zh-TW/settings-reference#strictpluginonlycustomization) 設為 `true` 或設為包含 `mcp` 的清單時，執行了 `claude mcp add` 或 `claude mcp add-json`。在此設定下，Claude Code 不會從 `~/.claude.json` 或 `.mcp.json` 載入 MCP 伺服器，因此該命令會以退出碼 1 結束，而不會儲存一個永遠不會載入的伺服器：
3204
3205```text theme={null}
3206Cannot add MCP server: your organization's managed settings allow only MCP servers that plugins provide. Install a plugin that provides this server, or ask your administrator to make it available.
3207```
3208
3209`claude mcp add-from-claude-desktop` 會將您選取的每個伺服器回報為未匯入，並以此訊息作為原因。[`/import`](/docs/zh-TW/commands#all-commands) 會針對它嘗試新增的每個 MCP 伺服器回報此訊息，並仍會匯入它找到的其他項目。
3210
3211在 v2.1.284 之前，這些命令會儲存伺服器並回報成功，但該伺服器從未載入。
3212
3213**處理方式：**
3214
3215* 安裝提供該伺服器的[外掛](/docs/zh-TW/plugins/install)
3216* 請您的管理員以[外掛](/docs/zh-TW/plugins/org)發佈該伺服器，或者若它是遠端 HTTP 或 SSE 伺服器，則透過 [`managedMcpServers`](/docs/zh-TW/settings-reference#managedmcpservers) 提供
3150 3217
3151<h3 id="cant-read-mcp-json">3218<h3 id="cant-read-mcp-json">
3152 無法讀取 .mcp.json3219 無法讀取 .mcp.json
3153</h3>3220</h3>
3154 3221
3155讀取專案 [`.mcp.json`](/docs/zh-TW/mcp#project-scope) 的命令，例如 `claude mcp add` 或 `claude mcp add-json` 搭配 `--scope project`，或 `claude mcp remove`，發現您目前目錄中的檔案不是常規檔案或大於 2 MiB，所以它以此錯誤結束而不是讀取檔案。3222讀取專案 [`.mcp.json`](/docs/zh-TW/mcp#project-scope) 的命令（例如搭配 `--scope project` 的 `claude mcp add` 或 `claude mcp add-json`，或 `claude mcp remove`）發現您目前目錄中的該檔案不是一般檔案，或大於 2 MiB，因此會以此錯誤結束，而不會讀取該檔案。
3156 3223
3157```text theme={null}3224```text theme={null}
3158Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes. Fix or remove it, then run the command again.3225Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes. Fix or remove it, then run the command again.
3159```3226```
3160 3227
3161在 v2.1.257 之前，`.mcp.json` 上的 FIFO 會讓命令無限期等待而沒有輸出，到 `/dev/zero` 等裝置檔案的符號連結會增加記憶體直到程序被殺死。3228在 v2.1.257 之前，位於 `.mcp.json` 的 FIFO 會讓命令永遠等待而沒有任何輸出，而指向 `/dev/zero` 等裝置檔案的符號連結會讓記憶體持續增長，直到程序被終止。
3162 3229
3163**該怎麼做：**3230**處理方式：**
3164 3231
3165* 檢查您目前目錄中 `.mcp.json` 上的內容。將其替換為 [project-scope 格式](/docs/zh-TW/mcp#project-scope)中的普通 JSON 檔案，或刪除它，然後再次執行命令。3232* 檢查您目前目錄中 `.mcp.json` 所在的內容。將其替換為採用[專案範圍格式](/docs/zh-TW/mcp#project-scope)的一般 JSON 檔案，或將其刪除，然後再次執行命令。
3166 3233
3167<h3 id="mcp-server-was-not-saved-or-removed">3234<h3 id="mcp-server-was-not-saved-or-removed">
3168 MCP 伺服器未被保存或移除3235 MCP 伺服器未儲存或未移除
3169</h3>3236</h3>
3170 3237
3171您為 `user` 或 `local` [範圍](/docs/zh-TW/mcp#mcp-installation-scopes)中的伺服器執行了 `claude mcp add`、`claude mcp add-json` 或 `claude mcp remove`。兩個範圍都儲存在 `~/.claude.json` 中，寫入後 Claude Code 讀取該檔案時變更不在其中。命令以此錯誤結束而不是其成功行。3238您針對 `user` 或 `local` [範圍](/docs/zh-TW/mcp#mcp-installation-scopes)中的伺服器執行了 `claude mcp add`、`claude mcp add-json` 或 `claude mcp remove`。這兩個範圍都儲存在 `~/.claude.json` 中，而 Claude Code 在寫入後讀回該檔案時，變更並不在檔案中。該命令會以此錯誤結束，而不是顯示其成功訊息。
3172 3239
3173```text theme={null}3240```text theme={null}
3174MCP server "example" was not saved to /home/user/.claude.json. If that file is read-only or protected by a sandbox, make it writable or run the command outside the sandbox, then add the server again.3241MCP server "example" was not saved to /home/user/.claude.json. If that file is read-only or protected by a sandbox, make it writable or run the command outside the sandbox, then add the server again.
3175```3242```
3176 3243
3177移除後，訊息讀取 `was not removed from` 並以 `then remove the server again` 結尾。對於 `local` 範圍伺服器，路徑後面跟著項目所屬的專案目錄，如 `(local scope for /path/to/project)`。3244移除後，訊息會顯示 `was not removed from`，並以 `then remove the server again` 結尾。對於 `local` 範圍的伺服器，路徑後面會接著該項目所屬的專案目錄，形式為 `(local scope for /path/to/project)`。
3178 3245
3179在 v2.1.283 之前，`claude mcp add`、`claude mcp add-json` 和 `claude mcp remove` 即使變更未到達檔案也報告成功。3246在 v2.1.283 之前，即使變更未寫入檔案，`claude mcp add`、`claude mcp add-json` 與 `claude mcp remove` 也會回報成功。
3180 3247
3181**該怎麼做：**3248**處理方式：**
3182 3249
3183* 使訊息命名的檔案可寫，或在沙箱外執行命令，然後再次執行相同的新增或移除命令。3250* 讓訊息所指出的檔案變為可寫入，或在沙箱之外執行命令，然後再次執行相同的新增或移除命令。
3184 3251
3185<h3 id="mcp-server-may-not-have-been-saved-or-removed">3252<h3 id="mcp-server-may-not-have-been-saved-or-removed">
3186 MCP 伺服器可能未被保存或移除3253 MCP 伺服器可能未儲存或未移除
3187</h3>3254</h3>
3188 3255
3189您為 `user` 或 `local` [範圍](/docs/zh-TW/mcp#mcp-installation-scopes)中的伺服器執行了 `claude mcp add`、`claude mcp add-json` 或 `claude mcp remove`，Claude Code 無法讀取 `~/.claude.json` 回來確認變更。變更可能也可能不在磁碟上。括號中的文字是該讀取的錯誤。3256您針對 `user` 或 `local` [範圍](/docs/zh-TW/mcp#mcp-installation-scopes)中的伺服器執行了 `claude mcp add`、`claude mcp add-json` 或 `claude mcp remove`，而 Claude Code 無法讀回 `~/.claude.json` 以確認變更。該變更可能已寫入磁碟，也可能沒有。括號中的文字是該次讀取的錯誤。
3190 3257
3191```text theme={null}3258```text theme={null}
3192MCP server "example" may not have been saved: /home/user/.claude.json could not be read to confirm the change (EACCES: permission denied, open '/home/user/.claude.json'). Run `claude mcp get example` to check, then add the server again if it is missing.3259MCP server "example" may not have been saved: /home/user/.claude.json could not be read to confirm the change (EACCES: permission denied, open '/home/user/.claude.json'). Run `claude mcp get example` to check, then add the server again if it is missing.
3193```3260```
3194 3261
3195移除後，訊息讀取 `may not have been removed` 並以 `then remove the server again if it is still listed` 結尾。3262移除後，訊息會顯示 `may not have been removed`，並以 `then remove the server again if it is still listed` 結尾。
3196 3263
3197在 v2.1.283 之前，命令即使無法確認變更也報告成功。3264在 v2.1.283 之前，即使無法確認變更，這些命令也會回報成功。
3198 3265
3199**該怎麼做：**3266**處理方式：**
3200 3267
3201* 執行 `claude mcp get <name>` 以檢查變更是否在磁碟上。對於 `local` 範圍伺服器，從伺服器所屬的專案目錄執行它，因為本地範圍是每個專案。3268* 執行 `claude mcp get <name>` 以檢查變更是否已寫入磁碟。對於 `local` 範圍的伺服器，請從該伺服器所屬的專案目錄執行，因為 local 範圍是以專案為單位。
3202* 如果伺服器在新增後遺失，或在移除後仍然列出，執行相同的新增或移除命令。3269* 如果新增後伺服器不存在，或移除後仍被列出，請再次執行相同的新增或移除命令。
3203 3270
3204<h3 id="anthropic-hosted-and-doesnt-support-local-oauth">3271<h3 id="anthropic-hosted-and-doesnt-support-local-oauth">
3205 伺服器是 Anthropic 託管的，不支援本地 OAuth3272 伺服器由 Anthropic 託管，不支援本機 OAuth
3206</h3>3273</h3>
3207 3274
3208您為 MCP 伺服器啟動了登入，其 URL 指向通過第三方身份提供者進行身份驗證的 Anthropic 託管連接器主機。這些主機包括 `microsoft365.mcp.claude.com`、`gmail.mcp.claude.com` 和 `gcal.mcp.claude.com`。Claude Code 拒絕為這些主機從 `/mcp` 面板和 `claude mcp login` 啟動其本地 OAuth 流程，因為[它們的登入僅通過 claude.ai 工作](/docs/zh-TW/mcp#use-mcp-servers-from-claude-ai)。3275您為一個 MCP 伺服器啟動了登入，而其 URL 指向透過第三方身分提供者進行身分驗證的 Anthropic 託管連接器主機。這些主機包括 `microsoft365.mcp.claude.com`、`gmail.mcp.claude.com` 與 `gcal.mcp.claude.com`。Claude Code 會拒絕從 `/mcp` 面板和 `claude mcp login` 為這些主機啟動其本機 OAuth 流程，因為[它們的登入只能透過 claude.ai 進行](/docs/zh-TW/mcp#use-mcp-servers-from-claude-ai)。
3209 3276
3210```text theme={null}3277```text theme={null}
3211"gmail" is Anthropic-hosted and doesn't support local OAuth. Connect it via Settings → Connectors on claude.ai (requires `claude login`), then it'll be available here automatically.3278"gmail" is Anthropic-hosted and doesn't support local OAuth. Connect it via Settings → Connectors on claude.ai (requires `claude login`), then it'll be available here automatically.
3212```3279```
3213 3280
3214**該怎麼做：**3281**處理方式：**
3215 3282
3216* 使用 `claude mcp remove <name>` 移除您的項目，以便它無法隱藏相同 URL 上的 claude.ai 連接器3283* 以 `claude mcp remove <name>` 移除您的項目，使其不會遮蔽相同 URL 上的 claude.ai 連接器
3217* 移除後，在 [claude.ai/customize/connectors](https://claude.ai/customize/connectors) 連接服務，同時登入您在 Claude Code 中使用的帳戶。連接後，如果您的活躍身份驗證方法是 claude.ai 訂閱登入，[連接器會自動出現在 Claude Code 中](/docs/zh-TW/mcp#use-mcp-servers-from-claude-ai)3284* 移除之後，在登入您於 Claude Code 中使用的帳戶時，於 [claude.ai/customize/connectors](https://claude.ai/customize/connectors) 連接該服務。連接後，如果您目前的身分驗證方式是 claude.ai 訂閱登入，[該連接器會自動出現在 Claude Code 中](/docs/zh-TW/mcp#use-mcp-servers-from-claude-ai)
3218 3285
3219<h3 id="server-rejected-the-authorization-header-minted-by-the-configured-headershelper">3286<h3 id="server-rejected-the-authorization-header-minted-by-the-configured-headershelper">
3220 伺服器拒絕了由設定的 headersHelper 鑄造的授權標頭3287 伺服器拒絕了所設定之 headersHelper 產生的 Authorization 標頭
3221</h3>3288</h3>
3222 3289
3223其 [`headersHelper`](/docs/zh-TW/mcp#use-dynamic-headers-for-custom-authentication) 提供 `Authorization` 標頭的 MCP 伺服器以 HTTP 401 或 403 回答連線，所以 Claude Code 將連線報告為失敗。因為幫助程式提供 `Authorization` 標頭，Claude Code [不會回退到 OAuth](/docs/zh-TW/mcp#authenticate-with-remote-mcp-servers) 用於伺服器：3290一個由 [`headersHelper`](/docs/zh-TW/mcp#use-dynamic-headers-for-custom-authentication) 提供 `Authorization` 標頭的 MCP 伺服器以 HTTP 401 或 403 回應連線，因此 Claude Code 將連線回報為失敗。由於該輔助程式提供了 `Authorization` 標頭，Claude Code [不會改用 OAuth](/docs/zh-TW/mcp#authenticate-with-remote-mcp-servers) 連接該伺服器：
3224 3291
3225```text theme={null}3292```text theme={null}
3226Server rejected the Authorization header minted by the configured headersHelper (HTTP 401). Check that the helper command returns a valid credential for this MCP endpoint — OAuth fallback is disabled when the helper supplies Authorization.3293Server rejected the Authorization header minted by the configured headersHelper (HTTP 401). Check that the helper command returns a valid credential for this MCP endpoint — OAuth fallback is disabled when the helper supplies Authorization.
3227```3294```
3228 3295
3229Claude Code 在每次連線嘗試時重新執行幫助程式，所以在暫時拒絕（例如權杖輪換競賽）後重試可以使用新認證成功。3296Claude Code 會在每次嘗試連線時重新執行該輔助程式，因此在暫時性拒絕（例如 token 輪替競爭）之後重試，可能會以新的憑證成功。
3230 3297
3231**該怎麼做：**3298**處理方式：**
3232 3299
3233* 按照 Claude Code 執行它的方式自己執行 `headersHelper` 命令：從 [Claude Code 執行它的目錄](/docs/zh-TW/mcp#where-the-helper-runs)，使用 [Claude Code 為它設定的環境變數](/docs/zh-TW/mcp#use-dynamic-headers-for-custom-authentication)，以及沒有 [Claude Code 為來自專案 `.mcp.json`、外掛程式或專案代理檔案的伺服器移除的認證變數](/docs/zh-TW/mcp#which-variables-a-helper-can-read)。檢查它列印的 `Authorization` 值伺服器的端點接受3300* 以 Claude Code 執行它的方式自行執行 `headersHelper` 命令：從 [Claude Code 執行它的目錄](/docs/zh-TW/mcp#where-the-helper-runs)執行，帶有 [Claude Code 為其設定的環境變數](/docs/zh-TW/mcp#use-dynamic-headers-for-custom-authentication)，並且對於來自專案 `.mcp.json`、外掛或專案 agent 檔案的伺服器，不包含 [Claude Code 會移除的憑證變數](/docs/zh-TW/mcp#which-variables-a-helper-can-read)。確認它印出的 `Authorization` 值能被伺服器的端點接受
3234* 修復幫助程式或其認證來源後，在 `/mcp` 中選擇伺服器並選擇**重新連線**3301* 修正輔助程式或其憑證來源之後，在 `/mcp` 中選取該伺服器並選擇 **Reconnect**
3235 3302
3236在 v2.1.248 之前，Claude Code 為其幫助程式提供 `Authorization` 標頭的伺服器執行 OAuth 發現。該發現可能失敗並顯示 `Incompatible auth server: does not support dynamic client registration` 而不是報告被拒絕的認證。3303在 v2.1.248 之前，Claude Code 會對由輔助程式提供 `Authorization` 標頭的伺服器執行 OAuth 探索。該探索可能會以 `Incompatible auth server: does not support dynamic client registration` 失敗，而不是回報遭拒絕的憑證。
3237 3304
3238<h3 id="mcp-permission-prompt-tool-not-found">3305<h3 id="mcp-permission-prompt-tool-not-found">
3239 找不到 MCP 權限提示工具3306 找不到 MCP 權限提示工具
3240</h3>3307</h3>
3241 3308
3242您傳遞給 [`--permission-prompt-tool`](/docs/zh-TW/cli-reference#cli-flags) 的工具在執行首次需要權限決定時不在連接的 MCP 工具中，要麼因為其伺服器永遠沒有連接，要麼因為沒有連接的伺服器公開該名稱的工具。Claude Code 仍會傳送您的提示：[非互動](/docs/zh-TW/headless)執行在第一個工具呼叫時以此錯誤和結束代碼 1 結束，所以即使提出了請求，它也不會產生答案。在第一個提示之前，Claude Code 等待最多由 [`MCP_TIMEOUT`](/docs/zh-TW/env-vars) 設定的每個伺服器連線逾時 30 秒，以便該伺服器連接。在 v2.1.206 之前，啟動不會等待伺服器完成連接，所以啟動緩慢但健康的伺服器也會產生此錯誤。3309您傳給 [`--permission-prompt-tool`](/docs/zh-TW/cli-reference#cli-flags) 的工具，在執行首次需要權限決策時並不在已連線的 MCP 工具之中，原因可能是其伺服器從未連線，或沒有任何已連線的伺服器公開該名稱的工具。Claude Code 仍會送出您的提示詞：[非互動](/docs/zh-TW/headless)執行會在第一次工具呼叫時以此錯誤及退出碼 1 結束，因此即使請求已送出，也不會產生任何回答。在第一個提示詞之前，Claude Code 會等待該伺服器連線，最長等到由 [`MCP_TIMEOUT`](/docs/zh-TW/env-vars) 設定、每個伺服器 30 秒的連線逾時。在 v2.1.206 之前，啟動時不會等待伺服器完成連線，因此啟動緩慢但正常的伺服器也會產生此錯誤。
3243 3310
3244```text theme={null}3311```text theme={null}
3245Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none3312Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none
3246```3313```
3247 3314
3248`Available MCP tools:` 後的列表命名已連接的 MCP 工具。3315`Available MCP tools:` 之後的清單會列出已連線的 MCP 工具。
3249 3316
3250**該怎麼做：**3317**處理方式：**
3251 3318
3252* 檢查伺服器啟動並保持連接：在同一目錄中執行 `claude mcp list` 並確認伺服器列為已連接3319* 確認伺服器能啟動並保持連線：在相同目錄中執行 `claude mcp list`，並確認該伺服器被列為已連線
3253* 確認工具名稱與伺服器公開的 `mcp__<server>__<tool>` 名稱相符3320* 確認工具名稱與伺服器所公開的 `mcp__<server>__<tool>` 名稱相符
3254* 如果伺服器需要超過 30 秒才能啟動，請提高 [`MCP_TIMEOUT`](/docs/zh-TW/env-vars)3321* 如果伺服器需要超過 30 秒才能啟動，請調高 [`MCP_TIMEOUT`](/docs/zh-TW/env-vars)
3255 3322
3256<h3 id="oauth-callback-port-is-already-in-use">3323<h3 id="oauth-callback-port-is-already-in-use">
3257 OAuth 回呼連接埠已在使用中3324 OAuth 回呼連接埠已被使用
3258</h3>3325</h3>
3259 3326
3260當您使用 OAuth 登入遠端 MCP 伺服器時，Claude Code 啟動本地監聽器以接收登入回呼。如果該監聽器需要的連接埠被另一個程序持有，登入會失敗並顯示此訊息。這主要發生在通過 [`MCP_OAUTH_CALLBACK_PORT`](/docs/zh-TW/env-vars) 變數或 `--callback-port` 設定的[固定回呼連接埠](/docs/zh-TW/mcp#use-a-fixed-oauth-callback-port)上，因為沒有一個 Claude Code 會選擇可用的連接埠。3327當您以 OAuth 登入遠端 MCP 伺服器時，Claude Code 會啟動一個本機監聽器來接收登入回呼。如果該監聽器所需的連接埠被其他程序佔用，登入就會以此訊息失敗。這主要發生在透過 [`MCP_OAUTH_CALLBACK_PORT`](/docs/zh-TW/env-vars) 變數或 `--callback-port` 設定了[固定回呼連接埠](/docs/zh-TW/mcp#use-a-fixed-oauth-callback-port)的情況，因為若未設定，Claude Code 會挑選一個可用的連接埠。
3261 3328
3262```text theme={null}3329```text theme={null}
3263OAuth callback port <port> is already in use — another process may be holding it. Run `lsof -ti:<port> -sTCP:LISTEN` to find it.3330OAuth callback port <port> is already in use — another process may be holding it. Run `lsof -ti:<port> -sTCP:LISTEN` to find it.
3264```3331```
3265 3332
3266在 Windows 上，建議的命令是 `netstat -ano | findstr :<port>`。3333在 Windows 上，建議的命令則是 `netstat -ano | findstr :<port>`。
3267 3334
3268**該怎麼做：**3335**處理方式：**
3269 3336
3270* 執行訊息中的命令以找到持有連接埠的程序，並停止它或等待它完成3337* 執行訊息中的命令以找出佔用該連接埠的程序，並停止它或等待它結束
3271* 如果另一個程式永久需要該連接埠，請向伺服器註冊不同的重新導向 URI，並使用 `MCP_OAUTH_CALLBACK_PORT` 或 `--callback-port` 設定其連接埠，以您使用的為準3338* 如果其他程式需要永久使用該連接埠，請向伺服器註冊不同的重新導向 URI，並以 `MCP_OAUTH_CALLBACK_PORT` 或 `--callback-port`（視您使用哪一個）設定其連接埠
3272* 然後再次啟動登入，例如在 `/mcp` 中選擇伺服器3339* 然後再次啟動登入，例如在 `/mcp` 中選取該伺服器
3273 3340
3274<h3 id="no-available-ports-for-oauth-redirect">3341<h3 id="no-available-ports-for-oauth-redirect">
3275 沒有可用的 OAuth 重新導向連接埠3342 沒有可用於 OAuth 重新導向的連接埠
3276</h3>3343</h3>
3277 3344
3278當您使用 [OAuth](/docs/zh-TW/mcp#authenticate-with-remote-mcp-servers) 登入遠端 MCP 伺服器時，Claude Code 啟動本地監聽器以接收登入回呼。當 Claude Code 無法為其繫結本地連接埠時，登入失敗並顯示此訊息。機器上的某些內容阻止它在 `127.0.0.1` 上監聽，例如安全軟體或拒絕本地監聽器的沙箱政策。3345當您以 [OAuth](/docs/zh-TW/mcp#authenticate-with-remote-mcp-servers) 登入遠端 MCP 伺服器時，Claude Code 會啟動一個本機監聽器來接收登入回呼。當 Claude Code 無法為其綁定本機連接埠時，登入就會以此訊息失敗。機器上有某些東西阻止它在 `127.0.0.1` 上監聽，例如安全軟體或拒絕本機監聽器的沙箱政策。
3279 3346
3280```text theme={null}3347```text theme={null}
3281No available ports for OAuth redirect3348No available ports for OAuth redirect
3282```3349```
3283 3350
3284在 v2.1.268 之前，Claude Code 不會回退到作業系統指派的連接埠，所以訊息也會在只有其自我選擇的連接埠無法繫結時出現。這可能發生在 Hyper-V 保留涵蓋 Claude Code 選擇的連接埠的連接埠範圍的 Windows 主機上。3351在 v2.1.268 之前，Claude Code 不會改用作業系統指派的連接埠，因此當只有它自行挑選的連接埠無法綁定時，也會出現此訊息。這可能發生在 Windows 主機上，因為 Hyper-V 會保留涵蓋 Claude Code 挑選範圍的連接埠區段。
3285 3352
3286**該怎麼做：**3353**處理方式：**
3287 3354
3288* 檢查安全軟體或沙箱政策是否阻止程序在 `127.0.0.1` 上監聽，並允許 Claude Code 繫結本地連接埠3355* 檢查是否有安全軟體或沙箱政策阻擋程序在 `127.0.0.1` 上監聽，並允許 Claude Code 綁定本機連接埠
3289* 然後再次啟動登入，例如在 `/mcp` 中選擇伺服器3356* 然後再次啟動登入，例如在 `/mcp` 中選取該伺服器
3290 3357
3291<h3 id="security-review-fails-without-origin-head">3358<h3 id="security-review-fails-without-origin-head">
3292 /security-review 在沒有 origin/HEAD 的情況下失敗3359 /security-review 因缺少 origin/HEAD 而失敗
3293</h3>3360</h3>
3294 3361
3295[`/security-review`](/docs/zh-TW/commands#all-commands) 通過針對 `origin/HEAD` 進行差異來建立其審查內容，該本地參考記錄您的 `origin` 遠端上哪個分支是預設的。當該參考不存在時，收集差異的 git 命令失敗，審查在啟動前停止。3362[`/security-review`](/docs/zh-TW/commands#all-commands) 會將您的分支與 `origin/HEAD` 比較差異來建立其審查脈絡，`origin/HEAD` 是記錄您 `origin` 遠端預設分支為何的本機 ref。當該 ref 不存在時，用來收集差異的 git 命令會失敗，審查在開始之前就會停止。
3296 3363
3297```text theme={null}3364```text theme={null}
3298Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]3365Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]
3301'git <command> [<revision>...] -- [<file>...]'3368'git <command> [<revision>...] -- [<file>...]'
3302```3369```
3303 3370
3304訊息可能引用 `git log` 或不同的 `git diff`。Git 只在遠端公告預設分支且您的擷取 refspec 涵蓋它時建立 `origin/HEAD`，完整的遠端 `git clone` 帶有提交會執行此操作。該參考在這些設定中遺失：3371訊息中引用的也可能是 `git log` 或其他 `git diff`。只有在遠端公告了預設分支，且您的 fetch refspec 涵蓋該分支時，Git 才會建立 `origin/HEAD`；對有提交的遠端執行完整的 `git clone` 就會如此。在下列設定中，該 ref 會缺失：
3305 3372
3306* 單分支或 CI 檢出，擷取太窄的 refspec3373* 單一分支或 CI 檢出，其擷取的 refspec 範圍太窄
3307* 伺服器端 HEAD 指向沒有人推送的分支的遠端3374* 伺服器端 HEAD 指向一個沒人推送過之分支的遠端
3308* 沒有 `origin` 遠端的儲存庫，或您從未擷取的儲存庫3375* 沒有 `origin` 遠端的儲存庫，或您從未擷取過的遠端
3309 3376
3310Claude Code 為任何[注入動態內容](/docs/zh-TW/skills#when-an-injected-command-fails)的技能顯示相同的錯誤，失敗的注入命令會中止該技能的呼叫。兩個同級字串在命令執行之前就會觸發：3377對於任何[注入動態脈絡](/docs/zh-TW/skills#when-an-injected-command-fails)的 skill，Claude Code 都會顯示相同的錯誤，而注入的命令失敗會中止該 skill 的呼叫。另有兩個相關字串會在命令執行之前就出現：
3311 3378
3312* `Shell command permission check failed for pattern "..."`：命令的權限檢查不允許它。[注入命令的權限檢查](/docs/zh-TW/skills#permission-checks-on-injected-commands)涵蓋每個權限模式中哪些結果中止以及如何使用 `allowed-tools` 預先核准命令3379* `Shell command permission check failed for pattern "..."`：該命令的權限檢查不允許它。[注入命令的權限檢查](/docs/zh-TW/skills#permission-checks-on-injected-commands)說明了在各權限模式下哪些結果會中止，以及如何以 `allowed-tools` 預先核准命令
3313* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``：技能的 frontmatter 在沒有它的機器上要求 bash。安裝 Git for Windows 或將 frontmatter 變更為 `shell: powershell`。請參閱[注入命令如何執行](/docs/zh-TW/skills#how-injected-commands-run)3380* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``：該 skill 的 frontmatter 要求在沒有 bash 的機器上使用 bash。請安裝 Git for Windows，或將 frontmatter 改為 `shell: powershell`。請參閱[注入命令的執行方式](/docs/zh-TW/skills#how-injected-commands-run)
3314 3381
3315**該怎麼做：**3382**處理方式：**
3316 3383
3317* 通過命名您的遠端預設分支建立參考：`git remote set-head origin <default-branch>`。只要本地追蹤參考 `origin/<default-branch>` 存在，這就有效。如果不存在，如在單分支複製中，首先擷取分支：執行 `git remote set-branches --add origin <branch>`，然後 `git fetch origin`，然後重新執行 set-head 命令。重新執行 `/security-review`。3384* 指定您遠端的預設分支來建立該 ref：`git remote set-head origin <default-branch>`。只要本機追蹤 ref `origin/<default-branch>` 存在，此方法就有效。如果它不存在（例如在單一分支複製中），請先擷取該分支：執行 `git remote set-branches --add origin <branch>`，接著執行 `git fetch origin`，然後重新執行 set-head 命令。再重新執行 `/security-review`。
3318* 如果您寧願不命名分支，執行 `git fetch origin`，然後 `git remote set-head origin --auto`，它詢問遠端其預設分支是什麼。當遠端不公告預設分支時它失敗並顯示 `error: Cannot determine remote HEAD`，因為它是空的或其 HEAD 指向沒有人推送的分支；改為明確命名分支。當您的複製不擷取該分支時它失敗並顯示 `error: Not a valid ref`；首先如上所述擴大 refspec。3385* 如果您不想指定分支名稱，請執行 `git fetch origin`，然後執行 `git remote set-head origin --auto`，它會詢問遠端其預設分支為何。當遠端未公告預設分支（因為它是空的，或其 HEAD 指向一個沒人推送過的分支）時，它會以 `error: Cannot determine remote HEAD` 失敗；此時請明確指定分支。當您的複製不會擷取該分支時，它會以 `error: Not a valid ref` 失敗；請先依上述方式擴大 refspec。
3319* 如果儲存庫沒有遠端，使用 `git remote add origin <url>` 新增一個並在建立參考之前擷取。如果遠端是空的，首先使用 `git push -u origin HEAD` 推送您的分支，並在 set-head 命令中命名該分支；`origin/HEAD` 然後指向您剛推送的分支，所以 `/security-review` 看到空差異直到分支與它分歧。3386* 如果儲存庫沒有遠端，請以 `git remote add origin <url>` 新增一個，並在建立 ref 之前先擷取。如果遠端是空的，請先以 `git push -u origin HEAD` 推送您的分支，並在 set-head 命令中指定該分支；`origin/HEAD` 隨後會指向您剛推送的分支，因此在分支與其分歧之前，`/security-review` 看到的會是空的差異。
3320 3387
3321<h3 id="input-must-be-provided-when-using-print">3388<h3 id="input-must-be-provided-when-using-print">
3322 使用 --print 時必須提供輸入3389 使用 `--print` 時必須提供輸入
3323</h3>3390</h3>
3324 3391
3325裸 `claude` 需要 stdout 是終端才能啟動互動 UI。當 stdout 被重新導向，或控制台不是真實終端時，例如 PowerShell ISE 和某些 IDE 輸出窗格，`claude` 改為以[非互動](/docs/zh-TW/headless)模式執行。這與 `claude -p` 相同，它需要提示，所以訊息命名 `--print` 即使您沒有傳遞旗標。在任何地方傳遞 `-p`/`--print` 而沒有提示且 stdin 上沒有任何管道會產生相同的錯誤。3392單純執行 `claude` 時，stdout 必須是終端機才能啟動互動式 UI。當 stdout 被重新導向，或主控台不是真正的終端機（例如 PowerShell ISE 和某些 IDE 輸出窗格）時，`claude` 會改以[非互動方式](/docs/zh-TW/headless)執行。這與 `claude -p` 是相同的模式，而該模式需要提示詞，因此即使您沒有傳入該旗標，訊息也會提到 `--print`。在任何地方傳入 `-p`/`--print` 卻未提供提示詞，且 stdin 也沒有透過管線傳入任何內容，都會產生相同的錯誤。
3326 3393
3327```text theme={null}3394```text theme={null}
3328Error: Input must be provided either through stdin or as a prompt argument when using --print3395Error: Input must be provided either through stdin or as a prompt argument when using --print
3329```3396```
3330 3397
3331**該怎麼做：**3398**處理方式：**
3332 3399
3333* 對於互動使用，在真實終端中執行 `claude`：Windows Terminal 或 PowerShell 控制台而不是 ISE，以及您的 IDE 整合終端而不是輸出窗格3400* 若要互動使用，請在真正的終端機中執行 `claude`：使用 Windows Terminal 或 PowerShell 主控台而非 ISE，並使用 IDE 的整合式終端機而非輸出窗格
3334* 對於一次性使用，傳遞提示：`claude -p "your question"`，或使用 `echo "your question" | claude -p` 管道它3401* 若要單次使用，請傳入提示詞：`claude -p "your question"`，或以 `echo "your question" | claude -p` 透過管線傳入
3335 3402
3336<h3 id="input-contained-only-whitespace">3403<h3 id="input-contained-only-whitespace">
3337 輸入僅包含空白3404 輸入僅包含空白字元
3338</h3>3405</h3>
3339 3406
3340在[非互動模式](/docs/zh-TW/headless)中，Claude Code 拒絕完全由空格、製表符或換行符組成的提示，而不是傳送它，因為 API 拒絕沒有可見文字的訊息。您看到的訊息取決於空白提示來自何處：3407在[非互動模式](/docs/zh-TW/headless)中，Claude Code 會拒絕完全由空格、Tab 或換行組成的提示詞，而不會送出它，因為 API 會拒絕沒有可見文字的訊息。您看到的訊息取決於空白提示詞的來源：
3341 3408
3342* **`claude -p` 的提示引數或管道 stdin**：`claude` 以 `Error: Input contained only whitespace. Provide a prompt with text through stdin or as a prompt argument when using --print` 結束3409* **`claude -p` 的提示詞引數或透過管線傳入的 stdin**：`claude` 會以 `Error: Input contained only whitespace. Provide a prompt with text through stdin or as a prompt argument when using --print` 結束
3343* **提交給執行中的 `--input-format stream-json` 或 [Agent SDK](/docs/zh-TW/agent-sdk/overview) 工作階段的訊息**：Claude Code 在不呼叫模型的情況下結束轉向，工作階段保持可用。拒絕作為資訊訊息和轉向的結果文字到達：`Blank prompt — the message was only whitespace, so nothing was sent to the model.`3410* **送到執行中之 `--input-format stream-json` 或 [Agent SDK](/docs/zh-TW/agent-sdk/overview) 工作階段的訊息**：Claude Code 會在不呼叫模型的情況下結束該回合，工作階段仍可繼續使用。拒絕會以資訊訊息的形式送達，同時也作為該回合的結果文字：`Blank prompt — the message was only whitespace, so nothing was sent to the model.`
3344 3411
3345在 v2.1.229 之前，Claude Code 將僅空白訊息傳送到 API，API 以 400 錯誤拒絕了請求。3412在 v2.1.229 之前，Claude Code 會將僅含空白字元的訊息送到 API，而 API 會以 400 錯誤拒絕該請求。
3346 3413
3347**該怎麼做：**3414**處理方式：**
3348 3415
3349* 在提示中包含可見文字。如果指令碼從變數或檔案建立提示，請在呼叫 Claude Code 之前檢查來源是否不為空。3416* 在提示詞中包含可見文字。如果腳本是從變數或檔案建立提示詞，請在呼叫 Claude Code 之前確認來源不是空的。
3350 3417
3351<h3 id="stream-json-input-carried-over-256m-characters-with-no-newline">3418<h3 id="stream-json-input-carried-over-256m-characters-with-no-newline">
3352 stream-json 輸入在沒有換行符的情況下超過 256M 個字元3419 stream-json 輸入傳送了超過 256M 個字元且沒有換行
3353</h3>3420</h3>
3354 3421
3355您的程式在沒有換行符的情況下在 stdin 上傳送了超過 268,435,456 個字元到 `claude -p --input-format stream-json` 執行，所以 Claude Code 將此錯誤列印到 stderr 並以代碼 1 結束而不是緩衝更多輸入。訊息將該預算陳述為 `256M`。在 v2.1.257 之前，Claude Code 無限制地緩衝此類輸入，增加記憶體直到程序崩潰或被殺死。3422您的程式向 `claude -p --input-format stream-json` 執行的 stdin 傳送了超過 268,435,456 個字元而沒有換行，因此 Claude Code 會將此錯誤印到 stderr 並以退出碼 1 結束，而不會緩衝更多輸入。訊息中將該上限表示為 `256M`。在 v2.1.257 之前，Claude Code 會無限制地緩衝這類輸入，使記憶體持續增長，直到程序當機或被終止。
3356 3423
3357```text theme={null}3424```text theme={null}
3358Error: stream-json input carried over 256M characters with no newline. Each stream-json message must be a single newline-terminated JSON line: either the producer is not newline-terminating its messages, or one message exceeded this budget.3425Error: stream-json input carried over 256M characters with no newline. Each stream-json message must be a single newline-terminated JSON line: either the producer is not newline-terminating its messages, or one message exceeded this budget.
3359```3426```
3360 3427
3361沒有換行符的此長度輸入通常表示生產者根本不是 stream-json 生產者，例如二進位檔案或意外管道的純日誌輸出。超過預算的單個訊息失敗相同的檢查。3428這麼長而沒有換行的輸入，通常表示產生者根本不是 stream-json 產生者，例如不小心透過管線傳入的二進位檔案或純文字日誌輸出。單一訊息超過上限也會無法通過相同的檢查。
3362 3429
3363**該怎麼做：**3430**處理方式：**
3364 3431
3365* 檢查什麼被管道到 stdin。使用 [`--input-format stream-json`](/docs/zh-TW/cli-reference#cli-flags)，每個訊息必須是一個換行符終止的 JSON 行3432* 檢查透過管線傳入 stdin 的內容。使用 [`--input-format stream-json`](/docs/zh-TW/cli-reference#cli-flags) 時，每則訊息都必須是一行以換行結尾的 JSON
3366* 若要改為傳送純文字，請移除 `--input-format stream-json`；`claude -p` 預設從 stdin 讀取純文字提示3433* 若要改為傳送純文字，請移除 `--input-format stream-json`；`claude -p` 預設會從 stdin 讀取純文字提示詞
3367 3434
3368<h3 id="unknown-command">3435<h3 id="unknown-command">
3369 未知命令3436 Unknown command
3370</h3>3437</h3>
3371 3438
3372在互動終端工作階段中，您提交了一個 `/` 名稱，該名稱與此工作階段中的任何命令都不符，所以 Claude Code 報告該名稱而不是執行任何操作：3439在互動式終端機工作階段中，您送出了一個不符合此工作階段中任何命令的 `/` 名稱，因此 Claude Code 會回報該名稱，而不會執行任何動作：
3373 3440
3374```text theme={null}3441```text theme={null}
3375Unknown command: /hepl. Did you mean /help?3442Unknown command: /hepl. Did you mean /help?
3376```3443```
3377 3444
3378Claude Code 建議此工作階段中菜單列出的最接近的命令名稱或別名。當沒有接近的時，訊息在名稱後結束。原因通常是以下之一：3445Claude Code 會建議選單在此工作階段中列出的最接近的命令名稱或別名。當沒有相近的名稱時，訊息會在名稱之後結束。原因通常是下列之一：
3379 3446
3380* 打字錯誤，例如 `/hepl` 代替 `/help`。[命令菜單如何匹配您輸入的內容](/docs/zh-TW/commands#how-the-command-menu-matches-what-you-type)涵蓋在提交前選擇接近的匹配3447* 打字錯誤，例如將 `/help` 打成 `/hepl`。[命令選單如何比對您輸入的內容](/docs/zh-TW/commands#how-the-command-menu-matches-what-you-type)說明了如何在送出前挑選相近的比對結果
3381* 存在但在此工作階段中不可用的命令，因為不符合要求，例如您的平台、計畫或身份驗證方法。[`/web-setup`](/docs/zh-TW/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command) 和 [`/schedule`](/docs/zh-TW/routines#schedule-returns-unknown-command) 的故障排除項目演練兩個常見情況。某些命令在您的組織政策停用它們時會回答自己的訊息，例如 [`Cloud sessions are disabled by your organization's policy`](#cloud-sessions-are-disabled-by-your-organizations-policy)3448* 命令存在，但因為未滿足某項需求（例如您的平台、方案或身分驗證方式）而在此工作階段中無法使用。[`/web-setup`](/docs/zh-TW/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command) 與 [`/schedule`](/docs/zh-TW/routines#schedule-returns-unknown-command) 的疑難排解項目逐步說明了兩種常見情況。某些命令在您組織的政策停用它們時，會以自己的訊息回應，例如 [`Cloud sessions are disabled by your organization's policy`](#cloud-sessions-are-disabled-by-your-organizations-policy)
3382* 來自此工作階段中未安裝或未連接的[外掛程式](/docs/zh-TW/plugins/overview)或 [MCP 伺服器](/docs/zh-TW/mcp#use-mcp-prompts-as-commands)的命令3449* 來自未在此工作階段中安裝或連線之[外掛](/docs/zh-TW/plugins/overview)或 [MCP 伺服器](/docs/zh-TW/mcp#use-mcp-prompts-as-commands)的命令
3383 3450
3384Claude Code 只在互動終端工作階段中以這種方式回答不符合的 `/` 名稱。在每個其他工作階段中，它改為將提示作為普通訊息傳送給 Claude，並附註命令未執行以及 Claude 可以在工作階段中執行的命令列表。這些工作階段包括：3451Claude Code 只在互動式終端機工作階段中以這種方式回應不相符的 `/` 名稱。在其他所有工作階段中，它會改將提示詞當成一般訊息送給 Claude，並附上命令未執行的說明，以及 Claude 在該工作階段中可執行的命令清單。這些工作階段包括：
3385 3452
3386* `-p` 執行3453* `-p` 執行
3387* [Agent SDK](/docs/zh-TW/agent-sdk/overview) 應用程式3454* [Agent SDK](/docs/zh-TW/agent-sdk/overview) 應用程式
3388* [Desktop 應用程式](/docs/zh-TW/desktop)的代碼標籤3455* [Desktop 應用程式](/docs/zh-TW/desktop)的 Code 分頁
3389* [VS Code 擴充功能](/docs/zh-TW/vs-code)的聊天面板3456* [VS Code 擴充功能](/docs/zh-TW/vs-code)的聊天面板
3390* [雲端工作階段](/docs/zh-TW/claude-code-on-the-web)和[例行程序](/docs/zh-TW/routines)3457* [雲端工作階段](/docs/zh-TW/claude-code-on-the-web)與 [routine](/docs/zh-TW/routines)
3391 3458
3392對於無法在其中一個工作階段中執行的內建命令，Claude Code 仍會回答該命令不可用，而不是將其傳送給 Claude。在 v2.1.274 之前，只有雲端工作階段和例行程序將不符合的名稱傳送給 Claude。在 v2.1.273 之前，它們也回答 `Unknown command`。3459對於無法在上述工作階段之一中執行的內建命令，Claude Code 仍會回應該命令無法使用，而不會將其送給 Claude。在 v2.1.274 之前，只有雲端工作階段與 routine 會將不相符的名稱送給 Claude。在 v2.1.273 之前，它們也會回應 `Unknown command`。
3393 3460
3394Claude Code 不會將每個以 `/` 開頭的提示視為命令。當 `/` 後的第一個單詞以標點符號開頭時，它會將提示作為普通訊息傳送給 Claude，例如開啟 Lean 文件註釋的 `/--`，或是路徑，例如 `/var/log/syslog`。3461Claude Code 不會將每個以 `/` 開頭的提示詞都視為命令。當 `/` 之後的第一個單字以標點符號開頭（例如開啟 Lean 文件註解的 `/--`），或是 `/var/log/syslog` 之類的路徑時，它會將提示詞當成一般訊息送給 Claude。
3395 3462
3396在 v2.1.236 之前，如果您在命令菜單列出您輸入的名稱的接近匹配時按 Enter，Claude Code 會執行該匹配，所以 `/hepl` 之類的打字錯誤會執行 `/help` 而不是產生此訊息。3463在 v2.1.236 之前，如果您在命令選單列出與您輸入名稱相近的比對結果時按下 `Enter`，Claude Code 會執行該比對結果，因此像 `/hepl` 這樣的打字錯誤會執行 `/help`，而不是產生此訊息。
3397 3464
3398**該怎麼做：**3465**處理方式：**
3399 3466
3400* 執行建議的名稱，或輸入 `/` 後跟名稱的一部分以查看此工作階段中可用的內容3467* 執行建議的名稱，或輸入 `/` 加上名稱的一部分，以查看此工作階段中可用的命令
3401* 如果 Claude Code 將記錄的命令報告為未知，請檢查[命令參考](/docs/zh-TW/commands)中的其行以了解它命名的要求3468* 如果 Claude Code 將文件中記載的命令回報為未知，請查看[命令參考](/docs/zh-TW/commands)中該命令的列，了解它所列出的需求
3402 3469
3403<h3 id="diff-is-too-large-for-ultrareview">3470<h3 id="diff-is-too-large-for-ultrareview">
3404 差異對於 ultrareview 來說太大3471 差異過大，無法進行 ultrareview
3405</h3>3472</h3>
3406 3473
3407您的分支與基礎分支之間的差異，包括未提交和暫存的變更，超過了 [ultrareview](/docs/zh-TW/ultrareview) 的大小限制，所以 `/code-review ultra` 和 `claude ultrareview` 子命令在雲端工作階段啟動之前拒絕審查。被拒絕的審查不使用免費執行，也不計費使用額度。訊息命名有效的限制、您的差異大小以及貢獻最多變更行的檔案。在 v2.1.216 之前，訊息只顯示原始差異統計。3474您的分支與基底分支之間的差異（包括未提交與已暫存的變更）超過了 [ultrareview](/docs/zh-TW/ultrareview) 的大小限制，因此 `/code-review ultra` 與 `claude ultrareview` 子命令會在雲端工作階段啟動前拒絕審查。被拒絕的審查不會使用免費執行次數，也不會計費用量點數。訊息會列出生效中的限制、您差異的大小，以及貢獻最多變更行數的檔案。在 v2.1.216 之前，訊息只會顯示原始的差異統計。
3408 3475
3409```text theme={null}3476```text theme={null}
3410Diff is too large for ultrareview: 812 files, 96,410 lines changed (limits: 500 files, 8,000 lines). Largest files: package-lock.json (41,904 lines), dist/bundle.js (18,210 lines), src/generated/api.ts (9,876 lines). Pass a closer base branch (`/code-review ultra <branch>`) to narrow the scope, or split the change.3477Diff is too large for ultrareview: 812 files, 96,410 lines changed (limits: 500 files, 8,000 lines). Largest files: package-lock.json (41,904 lines), dist/bundle.js (18,210 lines), src/generated/api.ts (9,876 lines). Pass a closer base branch (`/code-review ultra <branch>`) to narrow the scope, or split the change.
3411```3478```
3412 3479
3413審查拉取請求應用相同的限制；該形式的訊息以 `PR #<N> is too large for ultrareview` 開頭，並命名 PR 的檔案和行計數。3480審查 pull request 時也適用相同的限制；該形式的訊息以 `PR #<N> is too large for ultrareview` 開頭，並列出該 PR 的檔案數與行數。
3414 3481
3415**該怎麼做：**3482**處理方式：**
3416 3483
3417* 傳遞更接近您工作的基礎分支，例如 `/code-review ultra develop`，以便審查僅涵蓋針對該分支的差異3484* 傳入更接近您工作內容的基底分支，例如 `/code-review ultra develop`，讓審查只涵蓋與該分支之間的差異
3418* 將變更分成較小的分支並審查每一個。訊息命名的檔案貢獻最多變更行，所以首先開始將這些移到它們自己的分支。3485* 將變更拆分為較小的分支並分別審查。訊息列出的檔案貢獻了最多的變更行數，因此請先將這些檔案移到獨立的分支。
3419 3486
3420<h3 id="could-not-find-merge-base-with-the-base-branch">3487<h3 id="could-not-find-merge-base-with-the-base-branch">
3421 無法找到與基礎分支的合併基礎3488 找不到與基底分支的 merge-base
3422</h3>3489</h3>
3423 3490
3424`/code-review ultra` 和 `claude ultrareview` 子命令審查您的分支與基礎分支之間的差異，這需要兩者共享的提交。當 `git merge-base` 找不到時，Claude Code 在雲端工作階段啟動之前拒絕審查。在 Claude Code 可以驗證完整的複製上，至少有一個分支，它改為[審查每個追蹤的檔案](/docs/zh-TW/ultrareview#diff-limits-and-fallbacks)而不是拒絕。當基礎分支根本找不到時，當 Claude Code 無法驗證您的複製是否完整時，或在罕見的儲存庫中（其中整個樹差異不可能），例如 SHA-256 物件格式，您會看到此拒絕。3491`/code-review ultra` 與 `claude ultrareview` 子命令會審查您的分支與基底分支之間的差異，這需要兩者共有的一個提交。當 `git merge-base` 找不到任何共同提交時，Claude Code 會在雲端工作階段啟動前拒絕審查。在 Claude Code 能驗證為完整、且至少有一個分支的複製上，它會改為[審查每個受追蹤的檔案](/docs/zh-TW/ultrareview#diff-limits-and-fallbacks)，而不是拒絕。當完全找不到基底分支、Claude Code 無法驗證您的複製是否完整，或在少數無法進行整棵樹差異的儲存庫中（例如 SHA-256 物件格式），您會看到此拒絕訊息。
3425 3492
3426```text theme={null}3493```text theme={null}
3427Could not find merge-base with main. Pass the base branch explicitly (e.g. `/code-review ultra develop`) or make sure you're in a git repo with a main branch.3494Could not find merge-base with main. Pass the base branch explicitly (e.g. `/code-review ultra develop`) or make sure you're in a git repo with a main branch.
3428```3495```
3429 3496
3430第一句後的提示取決於 Claude Code 觀察到的內容：3497第一句之後的提示取決於 Claude Code 觀察到的情況：
3431 3498
3432* **您沒有傳遞基礎分支**：Claude Code 與儲存庫的預設分支進行了比較，並建議明確傳遞您的基礎，如上例所示3499* **您沒有傳入基底分支**：Claude Code 與儲存庫的預設分支比較，並建議您明確傳入基底分支，如上例所示
3433* **您傳遞的基礎分支已在您的複製中**：提示讀取 ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``3500* **您傳入的基底分支原本就在您的複製中**：提示為 ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``
3434* **您傳遞的基礎分支不在您的複製中**：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`。3501* **您傳入的基底分支不在您的複製中**：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` 失敗。
3435 3502
3436**該怎麼做：**3503**處理方式：**
3437 3504
3438* 如果另一個分支是您的真實基礎，明確傳遞它：`/code-review ultra <branch>`3505* 如果另一個分支才是您真正的基底，請明確傳入它：`/code-review ultra <branch>`
3439* 如果您的複製可能沒有完整歷史，執行 `git fetch --unshallow origin` 並重新執行審查3506* 如果您的複製可能沒有完整的歷史記錄，請執行 `git fetch --unshallow origin` 並重新執行審查
3440 3507
3441<h3 id="your-checkout-has-no-branches">3508<h3 id="your-checkout-has-no-branches">
3442 您的檢出沒有分支3509 您的檢出沒有任何分支
3443</h3>3510</h3>
3444 3511
3445檢出可以有提交但沒有分支：如果您執行 `git init` 後跟 `git fetch <url>` 和 `git checkout FETCH_HEAD`，您會得到一個分離的 HEAD 而沒有參考。Claude Code 將您的儲存庫打包為 git 套件以上傳它進行 [ultrareview](/docs/zh-TW/ultrareview)，它無法打包沒有分支或其他參考的儲存庫，所以 `/code-review ultra` 和 `claude ultrareview` 子命令在雲端工作階段啟動之前拒絕審查。3512檢出可能有提交但沒有分支：如果您執行 `git init`，接著執行 `git fetch <url>` 與 `git checkout FETCH_HEAD`，就會得到一個沒有任何 ref 的分離 HEAD。Claude Code 會將您的儲存庫打包成 git bundle 以上傳進行 [ultrareview](/docs/zh-TW/ultrareview)，而它無法打包沒有分支或其他 ref 的儲存庫，因此 `/code-review ultra` 與 `claude ultrareview` 子命令會在雲端工作階段啟動前拒絕審查。
3446 3513
3447```text theme={null}3514```text theme={null}
3448Your checkout has no branches (detached HEAD only), which cloud review can't bundle. Create one first — `git checkout -b <name>` — then rerun /code-review ultra.3515Your checkout has no branches (detached HEAD only), which cloud review can't bundle. Create one first — `git checkout -b <name>` — then rerun /code-review ultra.
3449```3516```
3450 3517
3451在 v2.1.221 之前，Claude Code 嘗試審查此檢出中的每個追蹤檔案，上傳失敗。3518在 v2.1.221 之前，Claude Code 會嘗試審查此檢出中每個受追蹤的檔案，而上傳會失敗。
3452 3519
3453**該怎麼做：**3520**處理方式：**
3454 3521
3455* 使用 `git checkout -b <name>` 在您目前的提交上建立分支，然後重新執行審查3522* 以 `git checkout -b <name>` 在您目前的提交上建立分支，然後重新執行審查
3456 3523
3457<h3 id="no-github-account-is-connected-to-your-claude-account">3524<h3 id="no-github-account-is-connected-to-your-claude-account">
3458 沒有 GitHub 帳戶連接到您的 Claude 帳戶3525 沒有 GitHub 帳戶連接到您的 Claude 帳戶
3459</h3>3526</h3>
3460 3527
3461您執行了 `/code-review ultra <PR#>` 或 `claude ultrareview <PR#>`，在建立雲端工作階段之前 Claude Code 詢問伺服器[連接到您的 Claude 帳戶的 GitHub 帳戶](/docs/zh-TW/ultrareview#review-a-pull-request)是否可以到達 PR 的儲存庫。沒有帳戶連接，或連接已過期，所以雲端複製會失敗，Claude Code 拒絕啟動。Claude Code 不會為被拒絕的啟動花費免費執行或計費使用額度。3528您執行了 `/code-review ultra <PR#>` 或 `claude ultrareview <PR#>`，而在建立雲端工作階段之前，Claude Code 會詢問伺服器[連接到您 Claude 帳戶的 GitHub 帳戶](/docs/zh-TW/ultrareview#review-a-pull-request)是否能存取該 PR 的儲存庫。由於沒有連接任何帳戶，或連接已過期，雲端複製將會失敗，因此 Claude Code 拒絕啟動。對於被拒絕的啟動，Claude Code 不會消耗免費執行次數，也不會計費用量點數。
3462 3529
3463```text theme={null}3530```text theme={null}
3464Ultrareview clones <owner>/<repo> in the cloud with the GitHub account connected to your Claude account, and none is connected (or the connection expired). To fix: run /web-setup to reuse your GitHub CLI login, or connect an account at https://claude.ai/connect-github — then re-run /code-review ultra 1234 (allow a minute after connecting).3531Ultrareview clones <owner>/<repo> in the cloud with the GitHub account connected to your Claude account, and none is connected (or the connection expired). To fix: run /web-setup to reuse your GitHub CLI login, or connect an account at https://claude.ai/connect-github — then re-run /code-review ultra 1234 (allow a minute after connecting).
3465```3532```
3466 3533
3467當 [`/web-setup`](/docs/zh-TW/web-quickstart#connect-from-your-terminal) 在您的工作階段中不可用時，訊息只命名 claude.ai 連結。3534當您的工作階段中無法使用 [`/web-setup`](/docs/zh-TW/web-quickstart#connect-from-your-terminal) 時，訊息只會提到 claude.ai 連結。
3468 3535
3469**該怎麼做：**3536**處理方式：**
3470 3537
3471* 執行 `/web-setup` 以將您的 GitHub CLI 登入連接到您的 Claude 帳戶，或在 [claude.ai/connect-github](https://claude.ai/connect-github) 連接帳戶3538* 執行 `/web-setup` 將您的 GitHub CLI 登入連接到您的 Claude 帳戶，或在 [claude.ai/connect-github](https://claude.ai/connect-github) 連接帳戶
3472* 連接後一分鐘重新執行審查3539* 連接後等待一分鐘再重新執行審查
3473 3540
3474在 v2.1.248 之前，Claude Code 在啟動前不檢查此項。3541在 v2.1.248 之前，Claude Code 不會在啟動前檢查此項目。
3475 3542
3476<h3 id="your-connected-github-account-cant-see-the-repository">3543<h3 id="your-connected-github-account-cant-see-the-repository">
3477 您連接的 GitHub 帳戶無法看到儲存庫3544 您連接的 GitHub 帳戶無法看到該儲存庫
3478</h3>3545</h3>
3479 3546
3480您執行了 `/code-review ultra <PR#>` 或 `claude ultrareview <PR#>`，[連接到您的 Claude 帳戶的 GitHub 帳戶](/docs/zh-TW/ultrareview#review-a-pull-request)無法讀取 PR 的儲存庫，所以雲端複製會失敗，Claude Code 拒絕啟動。Claude Code 不會為被拒絕的啟動花費免費執行或計費使用額度。3547您執行了 `/code-review ultra <PR#>` 或 `claude ultrareview <PR#>`，而[連接到您 Claude 帳戶的 GitHub 帳戶](/docs/zh-TW/ultrareview#review-a-pull-request)無法讀取該 PR 的儲存庫，因此雲端複製將會失敗，Claude Code 拒絕啟動。對於被拒絕的啟動，Claude Code 不會消耗免費執行次數，也不會計費用量點數。
3481 3548
3482```text theme={null}3549```text theme={null}
3483Your connected GitHub account can't see <owner>/<repo> — usually the Claude GitHub app isn't installed on <owner> or wasn't granted this repo (web-connected accounts need it for private repos), or a different GitHub account is connected. To fix: run /web-setup to reuse your GitHub CLI login, or install the app at https://github.com/apps/claude/installations/new — then re-run /code-review ultra 1234.3550Your connected GitHub account can't see <owner>/<repo> — usually the Claude GitHub app isn't installed on <owner> or wasn't granted this repo (web-connected accounts need it for private repos), or a different GitHub account is connected. To fix: run /web-setup to reuse your GitHub CLI login, or install the app at https://github.com/apps/claude/installations/new — then re-run /code-review ultra 1234.
3484```3551```
3485 3552
3486當 [`/web-setup`](/docs/zh-TW/web-quickstart#connect-from-your-terminal) 在您的工作階段中不可用時，訊息只命名應用程式安裝。3553當您的工作階段中無法使用 [`/web-setup`](/docs/zh-TW/web-quickstart#connect-from-your-terminal) 時，訊息只會提到應用程式的安裝。
3487 3554
3488**該怎麼做：**3555**處理方式：**
3489 3556
3490* 如果您的本地 `gh` CLI 可以讀取儲存庫，執行 `/web-setup` 以將該登入連接到您的 Claude 帳戶3557* 如果您本機的 `gh` CLI 可以讀取該儲存庫，請執行 `/web-setup` 將該登入連接到您的 Claude 帳戶
3491* 變更後重新執行審查3558* 變更後重新執行審查
3492 3559
3493在 v2.1.248 之前，Claude Code 在啟動前不檢查此項。3560在 v2.1.248 之前，Claude Code 不會在啟動前檢查此項目。
3494 3561
3495<h3 id="the-github-app-preflight-failed-transiently">3562<h3 id="the-github-app-preflight-failed-transiently">
3496 GitHub 應用程式預檢暫時失敗3563 GitHub App 預檢發生暫時性失敗
3497</h3>3564</h3>
3498 3565
3499您從本地儲存庫啟動了[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)，兩個步驟一起失敗。Claude Code 無法建立或上傳您的儲存庫套件。在上傳之前，它檢查了雲端服務是否可以從 GitHub 複製儲存庫，而不是明確的答案，該檢查以重試可能清除的錯誤結束，例如網路錯誤、逾時或暫時伺服器錯誤。完整訊息以停止套件的內容開頭，例如 `Could not upload repo bundle (<error>)`，並以預檢句子結尾：3566您從本機儲存庫啟動了[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)，而有兩個步驟同時失敗。Claude Code 無法建置或上傳您儲存庫的 bundle。在上傳之前，它會檢查雲端服務是否能從 GitHub 複製該儲存庫，而該檢查沒有得到明確的答案，而是以重試可能排除的錯誤結束，例如網路錯誤、逾時或暫時性的伺服器錯誤。完整的訊息會以阻止 bundle 的原因開頭，例如 `Could not upload repo bundle (<error>)`，並以預檢句子結尾：
3500 3567
3501```text theme={null}3568```text theme={null}
3502Could not upload repo bundle (<error>). The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead3569Could not upload repo bundle (<error>). The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead
3503```3570```
3504 3571
3505**該怎麼做：**3572**處理方式：**
3506 3573
3507* 片刻後重新執行命令。當 GitHub 檢查通過時，Claude Code 可以從 GitHub 複製啟動工作階段，所以失敗的上傳不再阻止啟動3574* 稍待片刻後重新執行命令。當 GitHub 檢查通過時，Claude Code 可以從 GitHub 複製啟動工作階段，因此失敗的上傳不再阻擋啟動
3508* 如果重試持續失敗，訊息的開頭命名停止上傳的內容。當該原因是您可以修復的內容時，修復它以便工作階段可以改為從您的本地儲存庫啟動3575* 如果重試持續失敗，訊息開頭會指出阻止上傳的原因。當該原因是您可以修正的問題時，請加以修正，讓工作階段改為能從您的本機儲存庫啟動
3509 3576
3510在 v2.1.251 之前，Claude Code 以 `Please set up GitHub on https://claude.ai/code` 結束訊息，即使 GitHub 檢查只暫時失敗，設定建議無法清除暫時失敗。3577在 v2.1.251 之前，即使 GitHub 檢查只是暫時性失敗，Claude Code 也會以 `Please set up GitHub on https://claude.ai/code` 結束訊息，而設定建議無法排除暫時性失敗。
3511 3578
3512<h3 id="the-repository-upload-cant-follow-a-git-setting">3579<h3 id="the-repository-upload-cant-follow-a-git-setting">
3513 儲存庫上傳無法遵循 git 設定3580 儲存庫上傳無法遵循某項 git 設定
3514</h3>3581</h3>
3515 3582
3516您啟動了[上傳您的本地儲存庫的雲端工作階段](/docs/zh-TW/claude-code-on-the-web#send-local-repositories-without-github)，或[分支的 ultrareview](/docs/zh-TW/ultrareview)，上傳無法遵循決定哪些屬性規則適用於您的檔案的 git 設定之一。如果上傳進行並錯過了規則，git 在儲存前轉換的檔案（例如清潔篩選器加密的檔案）可能會到達雲端，因為它在磁碟上。Claude Code 拒絕上傳，沒有任何內容被上傳：3583您啟動了[上傳您本機儲存庫的雲端工作階段](/docs/zh-TW/claude-code-on-the-web#send-local-repositories-without-github)，或對某個分支進行 [ultrareview](/docs/zh-TW/ultrareview)，而上傳無法遵循決定哪些屬性規則套用到您檔案的其中一項 git 設定。如果上傳照常進行而遺漏了某條規則，git 會在儲存前轉換的檔案（例如由 clean 篩選器加密的檔案）可能會以其在磁碟上的原樣送到雲端。Claude Code 會改為拒絕上傳，且不會上傳任何內容：
3517 3584
3518```text theme={null}3585```text theme={null}
3519Not uploading this working tree: core.ignoreCase (which decides whether .gitattributes patterns match file names regardless of letter case) is set in <file>, and the upload cannot follow that setting, so a file git would change before storing it (to encrypt it, for example) could be uploaded as it is on disk. Move the core.ignoreCase line into this repository's .git/config or directly into your ~/.gitconfig, then retry.3586Not uploading this working tree: core.ignoreCase (which decides whether .gitattributes patterns match file names regardless of letter case) is set in <file>, and the upload cannot follow that setting, so a file git would change before storing it (to encrypt it, for example) could be uploaded as it is on disk. Move the core.ignoreCase line into this repository’s .git/config or directly into your ~/.gitconfig, then retry.
3520```3587```
3521 3588
3522訊息命名設定和它的設定位置，並以該情況的修復結尾。相同的拒絕出現在 `core.attributesFile` 和 `attr.tree` 中，每個都有自己的修復。3589訊息會指出該設定及其設定位置，並以適用於您所遇情況的修正方法作結。對於 `core.attributesFile` 與 `attr.tree` 也會出現相同的拒絕訊息，各自附有其修正方法。
3523 3590
3524訊息可以命名您的 git 設定通過 `include` 或 `includeIf` 指令拉入的設定檔，即使該指令的條件不適用於此儲存庫。3591訊息可能會指出一個由您的 git 設定透過 `include` 或 `includeIf` 指示詞引入的設定檔，即使該指示詞的條件不適用於此儲存庫。
3525 3592
3526**該怎麼做：**3593**處理方式：**
3527 3594
3528* 應用訊息最後句子中的修復3595* 套用訊息最後一句中的修正方法
3529 3596
3530<h3 id="github-isnt-connected-to-your-claude-account">3597<h3 id="github-isnt-connected-to-your-claude-account">
3531 GitHub 未連接到您的 Claude 帳戶3598 GitHub 未連接到您的 Claude 帳戶
3532</h3>3599</h3>
3533 3600
3534您從本地儲存庫啟動了[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)，例如使用 `/autofix-pr`。沒有 GitHub 帳戶連接到您的 Claude 帳戶，或連接已過期，所以 Claude Code 拒絕啟動：3601您從本機儲存庫啟動了[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)，例如使用 `/autofix-pr`。沒有 GitHub 帳戶連接到您的 Claude 帳戶，或連接已過期，因此 Claude Code 拒絕啟動：
3535 3602
3536```text theme={null}3603```text theme={null}
3537GitHub isn't connected to your Claude account, so this repository can't be cloned in the cloud. Run /web-setup to connect with your GitHub CLI login, or connect on the web at https://claude.ai/connect-github3604GitHub isn't connected to your Claude account, so this repository can't be cloned in the cloud. Run /web-setup to connect with your GitHub CLI login, or connect on the web at https://claude.ai/connect-github
3538```3605```
3539 3606
3540當您使用 [`/schedule`](/docs/zh-TW/routines) 建立例行程序時，相同的訊息作為設定注意事項出現，命名儲存庫；注意事項不會阻止建立例行程序。3607當您以 [`/schedule`](/docs/zh-TW/routines) 建立 routine 時，相同的訊息會以指出該儲存庫的設定提醒形式出現；該提醒不會阻擋建立 routine。
3541 3608
3542**該怎麼做：**3609**處理方式：**
3543 3610
3544* 執行 `/web-setup` 以將您的 GitHub CLI 登入連接到您的 Claude 帳戶，或在 [claude.ai/connect-github](https://claude.ai/connect-github) 連接帳戶。請參閱 [GitHub 身份驗證選項](/docs/zh-TW/claude-code-on-the-web#github-authentication-options)以了解兩者的差異。3611* 執行 `/web-setup` 將您的 GitHub CLI 登入連接到您的 Claude 帳戶，或在 [claude.ai/connect-github](https://claude.ai/connect-github) 連接帳戶。兩者的差異請參閱 [GitHub 身分驗證選項](/docs/zh-TW/claude-code-on-the-web#github-authentication-options)。
3545* 連接後一分鐘重新執行命令3612* 連接後等待一分鐘再重新執行命令
3546 3613
3547在 v2.1.268 之前，Claude Code 將此報告為 Claude GitHub 應用程式檢查的暫時失敗，並建議重試或安裝應用程式；兩者都不連接 GitHub 帳戶。3614在 v2.1.268 之前，Claude Code 會將此情況回報為 Claude GitHub App 檢查的暫時性失敗，並建議重試或安裝該應用程式；但兩者都無法連接 GitHub 帳戶。
3548 3615
3549<h3 id="single-sign-on-authorization-needed">3616<h3 id="single-sign-on-authorization-needed">
3550 需要單一登入授權3617 需要單一登入授權
3551</h3>3618</h3>
3552 3619
3553您執行了 [`/install-github-app`](/docs/zh-TW/github-actions#quick-setup) 並選擇了其組織強制執行 SAML 單一登入的儲存庫。在設定之前，Claude Code 使用 GitHub CLI 檢查您對儲存庫的存取，GitHub 拒絕了該檢查，因為您的 `gh` 權杖尚未針對組織授權。精靈顯示帶有授權步驟的警告：3620您執行了 [`/install-github-app`](/docs/zh-TW/github-actions#quick-setup)，並選擇了一個其組織強制使用 SAML 單一登入的儲存庫。在設定之前，Claude Code 會以 GitHub CLI 檢查您對該儲存庫的存取權，而 GitHub 拒絕了該檢查，因為您的 `gh` token 尚未獲得該組織的授權。精靈會顯示警告以及授權步驟：
3554 3621
3555```text theme={null}3622```text theme={null}
3556Single sign-on authorization needed3623Single sign-on authorization needed
3557<owner>/<repo> belongs to an organization that enforces SAML single sign-on, and your GitHub CLI token isn't authorized for it yet.3624<owner>/<repo> belongs to an organization that enforces SAML single sign-on, and your GitHub CLI token isn't authorized for it yet.
3558```3625```
3559 3626
3560**該怎麼做：**3627**處理方式：**
3561 3628
3562* 通過執行 `gh auth refresh -h github.com -s repo,workflow` 使用 `repo` 和 `workflow` 範圍重新授權您的 GitHub CLI 登入，並在 GitHub 提示單一登入時授權組織3629* 執行 `gh auth refresh -h github.com -s repo,workflow`，以 `repo` 與 `workflow` 範圍重新授權您的 GitHub CLI 登入，並在 GitHub 提示單一登入時授權該組織
3563* 如果您使用 `GH_TOKEN` 中的個人存取權杖進行身份驗證，請開啟 [github.com/settings/tokens](https://github.com/settings/tokens)，在權杖上選擇**設定 SSO**，並授權組織3630* 如果您使用 `GH_TOKEN` 中的個人存取 token 進行身分驗證，請開啟 [github.com/settings/tokens](https://github.com/settings/tokens)，在該 token 上選取 **Configure SSO**，並授權該組織
3564* 再次執行 `/install-github-app`3631* 再次執行 `/install-github-app`
3565 3632
3566在 v2.1.273 之前，Claude Code 為此條件顯示 `Admin permissions required` 警告。3633在 v2.1.273 之前，Claude Code 對此情況顯示的是 `Admin permissions required` 警告。
3567 3634
3568<h3 id="failed-to-resume-the-conversation">3635<h3 id="failed-to-resume-the-conversation">
3569 無法恢復對話3636 無法繼續對話
3570</h3>3637</h3>
3571 3638
3572Claude Code 無法讀取或處理您從 [`claude --resume` 選擇器](/docs/zh-TW/sessions#use-the-session-picker)選擇的工作階段的已保存文字記錄，所以它結束程序而不是在部分載入狀態下繼續。訊息包括重試的命令：3639Claude Code 無法讀取或處理您從 [`claude --resume` 選擇器](/docs/zh-TW/sessions#use-the-session-picker)中所選工作階段的已儲存逐字稿，因此它會結束程序，而不是在部分載入的狀態下繼續。訊息中包含重試用的命令：
3573 3640
3574```text theme={null}3641```text theme={null}
3575Failed to resume the conversation.3642Failed to resume the conversation.
3576Run claude --resume <session-id> to retry, or claude to start a new session.3643Run claude --resume <session-id> to retry, or claude to start a new session.
3577```3644```
3578 3645
3579Claude Code 在顯示訊息後以代碼 1 結束。在執行中的工作階段內的 `/resume` 選擇器報告對話中的 `Failed to resume conversation`，您目前的工作階段保持執行。在 v2.1.216 之前，來自 `claude --resume` 選擇器的失敗恢復在 `Resuming conversation…` 微調器上無限期停留，而不是顯示此訊息。3646Claude Code 在顯示訊息後會以退出碼 1 結束。執行中工作階段內的 `/resume` 選擇器則會改為在對話中回報 `Failed to resume conversation`，而您目前的工作階段會繼續執行。在 v2.1.216 之前，從 `claude --resume` 選擇器繼續失敗時，會無限期停留在 `Resuming conversation…` 載入動畫，而不是顯示此訊息。
3580 3647
3581**該怎麼做：**3648**處理方式：**
3582 3649
3583* 執行 `claude --resume <session-id>` 搭配訊息中的工作階段 ID 以重試3650* 以訊息中的工作階段 ID 執行 `claude --resume <session-id>` 來重試
3584* 如果每次重試都以相同方式失敗，執行 `claude update` 並再次恢復。v2.1.275 之前的版本在已保存的文字記錄包含它們無法讀取的項目時恢復失敗。3651* 在 v2.1.285 之前的版本上，如果重試以相同方式失敗，請執行 `claude update` 並再次繼續。當已儲存的逐字稿包含這些版本無法讀取的項目時，這些版本會無法繼續。
3585* 如果重試再次失敗，執行 `claude` 以啟動新工作階段3652* 如果重試再次失敗，請執行 `claude` 以啟動新的工作階段
3586 3653
3587<h3 id="no-conversation-found-with-the-session-id">3654<h3 id="no-conversation-found-with-the-session-id">
3588 找不到具有工作階段 ID 的對話3655 No conversation found with the session ID
3589</h3>3656</h3>
3590 3657
3591您傳遞了工作階段 ID 給 `claude --resume <session-id>`，沒有已保存的文字記錄與其相符：3658您將工作階段 ID 傳給了 `claude --resume <session-id>`，但沒有任何已儲存的逐字稿與之相符：
3592 3659
3593```text theme={null}3660```text theme={null}
3594No conversation found with session ID: <session-id>3661No conversation found with session ID: <session-id>
3595```3662```
3596 3663
3597Claude Code 在顯示訊息後以代碼 1 結束。Claude Code [首先搜尋目前專案，然後搜尋此機器上的每個其他專案](/docs/zh-TW/sessions#resume-a-session)以找到 ID。在 v2.1.223 之前，查詢停止在目前專案目錄及其 git worktrees，所以從工作階段最後工作的目錄恢復。3664Claude Code 在顯示此訊息後會以代碼 1 結束。Claude Code 會[先搜尋目前的專案，再搜尋此機器上的所有其他專案](/docs/zh-TW/sessions#resume-a-session)來尋找該 ID。在 v2.1.223 之前，查找僅限於目前的專案目錄及其 git worktree，因此請從該工作階段最後運作的目錄繼續工作階段。
3598 3665
3599常見原因：3666常見原因：
3600 3667
3601* **打字錯誤的 ID**：對於非互動執行，ID 是 [`--output-format json` 輸出](/docs/zh-TW/headless#get-structured-output)的 `session_id` 欄位3668* **ID 輸入錯誤**：對於非互動式執行，ID 是 [`--output-format json` 輸出](/docs/zh-TW/headless#get-structured-output)中的 `session_id` 欄位
3602* **已刪除的文字記錄**：Claude Code 在[保留期](/docs/zh-TW/sessions#where-transcripts-are-stored)後移除文字記錄，預設為 30 天，遵循[保留掃描規則](/docs/zh-TW/claude-directory#cleaned-up-automatically)3669* **逐字稿已刪除**：Claude Code 會在[保留期限](/docs/zh-TW/sessions#where-transcripts-are-stored)（預設為 30 天）過後，依照[保留清理規則](/docs/zh-TW/claude-directory#cleaned-up-automatically)移除逐字稿
3603* **不同的機器**：Claude Code 在本地儲存文字記錄，所以在執行工作階段的機器上恢復它3670* **不同的機器**：Claude Code 將逐字稿儲存在本機，因此請在執行該工作階段的機器上繼續工作階段
3604* **重複副本**：如果您在 `~/.claude/projects` 下複製了專案目錄，使兩個文字記錄帶有相同 ID，Claude Code 報告此訊息而不是任意恢復一個副本3671* **重複的副本**：如果您複製了 `~/.claude/projects` 下的專案目錄，導致兩份逐字稿帶有相同的 ID，Claude Code 會回報此訊息，而不是任意繼續其中一份副本
3605 3672
3606**該怎麼做：**3673**處理方式：**
3607 3674
3608* 對於互動工作階段，使用 `claude --resume` 開啟[工作階段選擇器](/docs/zh-TW/sessions#use-the-session-picker)，按 `Ctrl+A` 將其擴大到此機器上的每個專案，然後選擇工作階段3675* 對於互動式工作階段，使用 `claude --resume` 開啟[工作階段選擇器](/docs/zh-TW/sessions#use-the-session-picker)，並按下 `Ctrl+A` 將範圍擴大至此機器上的所有專案，然後選擇該工作階段
3609* 使用 `claude -p` 或 [Agent SDK](/docs/zh-TW/agent-sdk/overview) 建立的工作階段不會出現在選擇器中，所以根據您的原始執行列印的 `session_id` 重新檢查 ID3676* 使用 `claude -p` 或 [Agent SDK](/docs/zh-TW/agent-sdk/overview) 建立的工作階段不會出現在選擇器中，因此請將 ID 與原始執行時印出的 `session_id` 再次核對
3610 3677
3611<h3 id="windows-reported-an-error-ebadf">3678<h3 id="windows-reported-an-error-ebadf">
3612 Windows 在 Claude Code 讀取此工作階段的文字記錄檔案時報告了錯誤 (EBADF)3679 Windows reported an error (EBADF) when Claude Code read this session's transcript file
3613</h3>3680</h3>
3614 3681
3615您在 Windows 上恢復了工作階段，其已保存的[文字記錄檔案](/docs/zh-TW/sessions#where-transcripts-are-stored)正常開啟，讀取它然後失敗並顯示系統錯誤 EBADF。系統錯誤沒有說明讀取失敗的原因，所以訊息建議可能的原因和要嘗試的內容：3682您在 Windows 上繼續了一個工作階段，其已儲存的[逐字稿檔案](/docs/zh-TW/sessions#where-transcripts-are-stored)正常開啟，但隨後讀取時因系統錯誤 EBADF 而失敗。系統錯誤並未說明讀取失敗的原因，因此此訊息會提示可能的原因及可嘗試的做法：
3616 3683
3617```text theme={null}3684```text theme={null}
3618Windows reported an error (EBADF) when Claude Code read this session's transcript file, although the file had opened normally. This can happen when other software intercepts file reads — security, encryption or endpoint-management tools, for example. If it keeps happening for this conversation, try excluding the folder that holds Claude Code's session transcripts from such software (the .claude folder in your user profile, unless the app or CLAUDE_CONFIG_DIR points Claude Code elsewhere), or adding Claude Code to its allowed applications, then resume again.3685Windows reported an error (EBADF) when Claude Code read this session's transcript file, although the file had opened normally. This can happen when other software intercepts file reads — security, encryption or endpoint-management tools, for example. If it keeps happening for this conversation, try excluding the folder that holds Claude Code's session transcripts from such software (the .claude folder in your user profile, unless the app or CLAUDE_CONFIG_DIR points Claude Code elsewhere), or adding Claude Code to its allowed applications, then resume again.
3619```3686```
3620 3687
3621訊息遵循命令自己的失敗行，例如 `Failed to resume session <session-id>`。`claude --resume` 或 [`claude -p`](/docs/zh-TW/headless) 命令在顯示它後以代碼 1 結束。在工作階段內的 `/resume` 後，您目前的工作階段保持執行。3688此訊息會接在命令本身的失敗行之後，例如 `Failed to resume session <session-id>`。`claude --resume` 或 [`claude -p`](/docs/zh-TW/headless) 命令在顯示此訊息後會以代碼 1 結束。若是在工作階段內執行 `/resume`，您目前的工作階段會繼續運作。
3622 3689
3623**該怎麼做：**3690**處理方式：**
3624 3691
3625* 從掃描或攔截檔案讀取的軟體（例如安全、加密或端點管理工具）中排除保存工作階段文字記錄的資料夾。文字記錄預設位於 `%USERPROFILE%\.claude\projects` 下，或位於 [`CLAUDE_CONFIG_DIR`](/docs/zh-TW/env-vars) 命名的目錄下3692* 將存放工作階段逐字稿的資料夾從會掃描或攔截檔案讀取的軟體中排除，例如安全性、加密或端點管理工具。逐字稿預設位於 `%USERPROFILE%\.claude\projects` 下，或位於 [`CLAUDE_CONFIG_DIR`](/docs/zh-TW/env-vars) 所指定的目錄下
3626* 如果您無法新增排除項，請改為將 Claude Code 新增到該軟體的允許應用程式3693* 如果無法新增排除項目，請改為將 Claude Code 加入該軟體的允許應用程式中
3627* 再次恢復工作階段3694* 再次繼續該工作階段
3628 3695
3629在 v2.1.282 之前，失敗沒有解釋：`claude --resume <session-id>` 在 `Failed to resume session <session-id>` 結束，`-p` 執行只列印系統錯誤文字，例如 `Failed to resume session: EBADF: bad file descriptor, read`。3696在 v2.1.282 之前，此失敗不會附帶任何說明：`claude --resume <session-id>` 會以 `Failed to resume session <session-id>` 結束，而 `-p` 執行則只會印出系統錯誤文字，例如 `Failed to resume session: EBADF: bad file descriptor, read`。
3630 3697
3631<h3 id="cannot-switch-renderers-in-this-session">3698<h3 id="cannot-switch-renderers-in-this-session">
3632 無法在此工作階段中切換轉譯器3699 Cannot switch renderers in this session
3633</h3>3700</h3>
3634 3701
3635當您切換轉譯器時，Claude Code 重新啟動其程序。您在 Claude Code 拒絕重新啟動的工作階段中執行了 [`/tui`](/docs/zh-TW/fullscreen#enable-fullscreen-rendering)，所以它不會切換並保存任何內容。您看到的訊息告訴您原因：3702切換渲染器時，Claude Code 會重新啟動其程序。您在 Claude Code 拒絕重新啟動的工作階段中執行了 [`/tui`](/docs/zh-TW/fullscreen#enable-fullscreen-rendering)，因此它不會切換，也不會儲存任何內容。您看到的訊息會告訴您原因：
3636 3703
3637* `Cannot switch renderers while work is running in the background`：您有在背景執行的工作，重新啟動會放棄，例如背景 shell 或子代理。等待工作完成或使用 [`/tasks`](/docs/zh-TW/commands) 停止它，然後再次執行 `/tui fullscreen` 或 `/tui default`3704* `Cannot switch renderers while work is running in the background`：您有正在背景執行的工作，重新啟動會使其中斷，例如背景 shell 或 subagent。請等待工作完成，或使用 [`/tasks`](/docs/zh-TW/commands) 將其停止，然後再次執行 `/tui fullscreen` 或 `/tui default`
3638* `Cannot switch renderers in this session`：工作階段有 Claude Code 無法傳遞給重新啟動的程序的限制。在 v2.1.234 之前，Claude Code 無論如何都會重新啟動，重新啟動的工作階段在沒有它們的情況下執行3705* `Cannot switch renderers in this session`：該工作階段具有 Claude Code 無法傳遞給重新啟動後程序的限制。在 v2.1.234 之前，Claude Code 仍會重新啟動，而重新啟動後的工作階段會在沒有這些限制的情況下執行
3639 3706
3640在限制訊息中，括號中的部分命名 Claude Code 發現的限制：3707在限制訊息中，括號內的部分列出了 Claude Code 找到的限制：
3641 3708
3642```text theme={null}3709```text theme={null}
3643Cannot switch renderers in this session — it has restrictions a restart can't carry over (permission rules set for this session only). Nothing was changed. Running /tui fullscreen in a session started without them switches every later session too.3710Cannot switch renderers in this session — it has restrictions a restart can't carry over (permission rules set for this session only). Nothing was changed. Running /tui fullscreen in a session started without them switches every later session too.
3644```3711```
3645 3712
3646訊息可以在括號中顯示的每個原因：3713訊息括號中可能顯示的各項原因：
3647 3714
3648* `launch flags: a custom system prompt, a tool allowlist, or restricted settings`：您使用 Claude Code 不傳遞回重新啟動程序的旗標啟動了工作階段。這些旗標包括 [`--system-prompt`](/docs/zh-TW/cli-reference#cli-flags)、`--system-prompt-file`、`--append-system-prompt-file`、[`--tools`](/docs/zh-TW/cli-reference#cli-flags) 允許清單、[`--setting-sources`](/docs/zh-TW/cli-reference#cli-flags) 和 [`--permission-prompt-tool`](/docs/zh-TW/cli-reference#cli-flags)3715* `launch flags: a custom system prompt, a tool allowlist, or restricted settings`：您使用了 Claude Code 不會傳回給重新啟動後程序的旗標來啟動工作階段。這些旗標包括 [`--system-prompt`](/docs/zh-TW/cli-reference#cli-flags)、`--system-prompt-file`、`--append-system-prompt-file`、[`--tools`](/docs/zh-TW/cli-reference#cli-flags) 允許清單、[`--setting-sources`](/docs/zh-TW/cli-reference#cli-flags) 以及 [`--permission-prompt-tool`](/docs/zh-TW/cli-reference#cli-flags)
3649* `permission rules set for this session only`：來自鉤子或 SDK 呼叫者的[權限更新](/docs/zh-TW/hooks#permission-update-entries)新增了具有 `session` 目的地的拒絕或詢問規則。工作階段範圍的允許規則不會觸發拒絕。重新啟動會丟棄它們，Claude Code 改為提示3716* `permission rules set for this session only`：來自 hook 或 SDK 呼叫端的[權限更新](/docs/zh-TW/hooks#permission-update-entries)新增了目的地為 `session` 的拒絕或詢問規則。僅限工作階段範圍的允許規則不會觸發拒絕。重新啟動會捨棄這些規則，Claude Code 會改為再次提示
3650* `ask-before-running rules with no command-line form`：來自鉤子或 SDK 呼叫者的權限更新新增了詢問規則以及 Claude Code 作為 `--allowed-tools` 和 `--disallowed-tools` 傳遞回的規則。詢問規則不存在旗標3717* `ask-before-running rules with no command-line form`：來自 hook 或 SDK 呼叫端的權限更新，在 Claude Code 以 `--allowed-tools` 和 `--disallowed-tools` 傳回的規則之外，另外新增了詢問規則。詢問規則沒有對應的旗標
3651* `permission rules a command line cannot carry intact` 和 `added directories a command line cannot carry intact`：權限更新在工作階段中期新增了規則或目錄路徑。重新啟動的程序的命令列無法將其文字作為相同值帶過去3718* `permission rules a command line cannot carry intact` 與 `added directories a command line cannot carry intact`：權限更新在工作階段中途新增了規則或目錄路徑。重新啟動後程序的命令列無法以相同的值承載其文字
3652 3719
3653**該怎麼做：**3720**處理方式：**
3654 3721
3655* 在沒有這些限制的工作階段中，執行 `/tui fullscreen`，或 `/tui default` 以切換回。Claude Code 在那裡保存 [`tui` 設定](/docs/zh-TW/settings-reference#tui)3722* 在未附帶這些限制而啟動的工作階段中，執行 `/tui fullscreen`，或執行 `/tui default` 切換回來。Claude Code 會在該處儲存 [`tui` 設定](/docs/zh-TW/settings-reference#tui)
3656 3723
3657<h3 id="couldnt-open-claude-desktop">3724<h3 id="couldnt-open-claude-desktop">
3658 無法開啟 Claude Desktop3725 Couldn't open Claude Desktop
3659</h3>3726</h3>
3660 3727
3661您執行了 [`/desktop`](/docs/zh-TW/desktop#coming-from-the-cli) 或其別名 `/app` 在工作階段中，或在您的 shell 中執行了 [`claude --desktop`](/docs/zh-TW/cli-reference#cli-flags)，Claude Code 用來開啟 Claude Desktop 的系統命令失敗。在 `/desktop` 後，工作階段保持在終端中；`claude --desktop` 列印訊息而沒有 `Error:` 前綴並以狀態 1 結束。3728您在工作階段中執行了 [`/desktop`](/docs/zh-TW/desktop#coming-from-the-cli) 或其別名 `/app`，或在 shell 中執行了 [`claude --desktop`](/docs/zh-TW/cli-reference#cli-flags)，而 Claude Code 用來開啟 Claude Desktop 的系統命令失敗了。執行 `/desktop` 後，工作階段會留在終端機中；`claude --desktop` 則會印出不含 `Error:` 前綴的訊息，並以狀態 1 結束。
3662 3729
3663括號中的文字命名失敗的命令，帶有其結束狀態和其錯誤輸出的第一行（如果它產生了）。在 macOS 上該命令是 `open`，如此範例；在 Windows 上它是 `rundll32`：3730括號中的文字指出失敗的命令，若該命令有產生結束狀態及錯誤輸出，也會附上其結束狀態與錯誤輸出的第一行。在 macOS 上，該命令為 `open`，如下例所示；在 Windows 上則為 `rundll32`：
3664 3731
3665```text theme={null}3732```text theme={null}
3666Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and try again.3733Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and try again.
3667```3734```
3668 3735
3669**該怎麼做：**3736**處理方式：**
3670 3737
3671* 自己開啟 Claude Desktop，然後再次執行 `/desktop` 或 `claude --desktop`3738* 自行開啟 Claude Desktop，然後再次執行 `/desktop` 或 `claude --desktop`
3672* 若要讀取該命令的完整錯誤輸出，使用 `/debug` 開啟偵錯日誌，再次執行 `/desktop`，或執行 `claude --desktop --debug-file <path>`，然後檢查偵錯日誌3739* 若要查看失敗命令的完整錯誤輸出，請使用 `/debug` 開啟偵錯日誌並再次執行 `/desktop`，或執行 `claude --desktop --debug-file <path>`，然後檢查偵錯日誌
3673 3740
3674在 v2.1.285 之前，訊息以 `Open Claude Desktop and run /desktop again.` 結尾。在 v2.1.275 之前，它是 `Failed to open Claude Desktop. Please try opening it manually.`，沒有說明什麼失敗。3741在 v2.1.285 之前，此訊息的結尾為 `Open Claude Desktop and run /desktop again.`。在 v2.1.275 之前，訊息為 `Failed to open Claude Desktop. Please try opening it manually.`，且未說明失敗的內容。
3675 3742
3676<h3 id="terminal-setup-left-your-zed-keymap-unchanged">3743<h3 id="terminal-setup-left-your-zed-keymap-unchanged">
3677 /terminal-setup 保持您的 Zed 快捷鍵不變3744 /terminal-setup left your Zed keymap unchanged
3678</h3>3745</h3>
3679 3746
3680您在 Zed 中執行了 [`/terminal-setup`](/docs/zh-TW/terminal-config#enter-multiline-prompts)，Claude Code 無法完成對您的 Zed `keymap.json` 的更新，所以它保持檔案不變。3747您在 Zed 中執行了 [`/terminal-setup`](/docs/zh-TW/terminal-config#enter-multiline-prompts)，而 Claude Code 無法完成對您 Zed `keymap.json` 的更新，因此保留了該檔案的原樣。
3681 3748
3682每個訊息命名您的快捷鍵的路徑，並以您自己新增的快捷鍵區塊結尾：3749每則訊息都會指出您 keymap 的路徑，並在結尾附上需自行新增的快捷鍵區塊：
3683 3750
3684```text theme={null}3751```text theme={null}
3685Couldn't update your Zed keymap, so it was left unchanged.3752Couldn't update your Zed keymap, so it was left unchanged.
3687{ "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } }3754{ "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } }
3688```3755```
3689 3756
3690訊息的第一行命名原因：3757訊息的第一行指出原因：
3691 3758
3692* `Couldn't read your Zed keymap, so it was left unchanged.`：Claude Code 無法讀取檔案，例如因為檔案權限3759* `Couldn't read your Zed keymap, so it was left unchanged.`：Claude Code 無法讀取該檔案，例如因為檔案權限的緣故
3693* `Your Zed keymap isn't a readable list of keybindings, so it was left unchanged.`：檔案讀取良好，但不解析為快捷鍵區塊的陣列，即使允許 `//` 註釋和尾隨逗號3760* `Your Zed keymap isn't a readable list of keybindings, so it was left unchanged.`：檔案可正常讀取，但即使允許 `//` 註解與尾隨逗號，仍無法解析為快捷鍵區塊的陣列
3694* `Couldn't back up your Zed keymap; not modifying it.`：Claude Code 無法將檔案複製到其旁邊的 `.bak` 備份，所以它沒有變更任何內容3761* `Couldn't back up your Zed keymap; not modifying it.`：Claude Code 無法將檔案複製為其旁邊的 `.bak` 備份，因此未做任何變更
3695* `Couldn't update your Zed keymap, so it was left unchanged.`：合併的結果未驗證為帶有繫結的有效快捷鍵，所以 Claude Code 丟棄它而不是寫入。具有重複鍵的快捷鍵區塊可能導致此情況3762* `Couldn't update your Zed keymap, so it was left unchanged.`：合併後的結果未能驗證為帶有該綁定的有效 keymap，因此 Claude Code 捨棄了結果而未寫入。帶有重複鍵的快捷鍵區塊可能會造成此情況
3696 3763
3697**該怎麼做：**3764**處理方式：**
3698 3765
3699* 將訊息中的區塊複製到您 `keymap.json` 中訊息命名的路徑中的頂級陣列3766* 將訊息中的區塊複製到訊息所指路徑下 `keymap.json` 的頂層陣列中
3700* 對於 `isn't a readable list of keybindings`，修復語法錯誤，或使檔案的頂級值成為陣列，然後再次執行 `/terminal-setup`3767* 對於 `isn't a readable list of keybindings`，請修正語法錯誤，或將檔案的頂層值改為陣列，然後再次執行 `/terminal-setup`
3701 3768
3702在 v2.1.247 之前，`/terminal-setup` 無法解析使用 `//` 註釋或尾隨逗號的 Zed 快捷鍵，它用只有其自己的繫結替換整個檔案，同時報告繫結已安裝。若要恢復較早版本替換的快捷鍵，請使用[輸入多行提示](/docs/zh-TW/terminal-config#enter-multiline-prompts)下描述的 `.bak` 備份檔案。3769在 v2.1.247 之前，`/terminal-setup` 無法解析使用了 `//` 註解或尾隨逗號的 Zed keymap，並會將整個檔案替換為僅包含其自身的綁定，同時回報綁定已安裝。若要還原被早期版本替換的 keymap，請使用 [Enter multiline prompts](/docs/zh-TW/terminal-config#enter-multiline-prompts) 中說明的 `.bak` 備份檔案。
3703 3770
3704<h3 id="skill-usage-reports-are-not-available-on-this-connection">3771<h3 id="skill-usage-reports-are-not-available-on-this-connection">
3705 此連線上不提供技能使用報告3772 Skill usage reports are not available on this connection
3706</h3>3773</h3>
3707 3774
3708您在[遠端控制](/docs/zh-TW/remote-control)上、從您的手機或瀏覽器執行了 [`/skill-doctor`](/docs/zh-TW/skills#find-unused-skills)。Claude Code 不會通過遠端控制傳送技能使用報告，並改為回答此訊息：3775您透過 [Remote Control](/docs/zh-TW/remote-control)，從手機或瀏覽器執行了 [`/skill-doctor`](/docs/zh-TW/skills#find-unused-skills)。Claude Code 不會透過 Remote Control 傳送 skill 使用報告，而是改以此訊息回覆：
3709 3776
3710```text theme={null}3777```text theme={null}
3711Skill usage reports are not available on this connection.3778Skill usage reports are not available on this connection.
3712```3779```
3713 3780
3714**該怎麼做：**3781**處理方式：**
3715 3782
3716* 在工作階段執行所在的機器上的終端中執行 `/skill-doctor`，或在那裡執行 `claude -p "/skill-doctor"`3783* 在執行該工作階段的機器上，於終端機中執行 `/skill-doctor`，或在該處執行 `claude -p "/skill-doctor"`
3717 3784
3718<h3 id="custom-output-styles-cant-be-selected-over-remote-control">3785<h3 id="custom-output-styles-cant-be-selected-over-remote-control">
3719 無法通過遠端控制選擇自訂輸出樣式3786 Custom output styles can't be selected over Remote Control
3720</h3>3787</h3>
3721 3788
3722您從行動應用程式或網路通過[遠端控制](/docs/zh-TW/remote-control)執行了 [`/output-style`](/docs/zh-TW/output-styles#change-your-output-style)，或命令在轉向中轉送到工作階段。因為此類轉向可能不來自帳戶擁有者，Claude Code 只在其上列出並選擇[內建樣式](/docs/zh-TW/output-styles#built-in-output-styles)，並在命令列出樣式或不識別您給定的名稱時新增此注意。[自訂樣式](/docs/zh-TW/output-styles#create-a-custom-output-style)名稱得到與不存在的名稱相同的回覆：3789您透過 [Remote Control](/docs/zh-TW/remote-control) 從行動應用程式或網頁執行了 [`/output-style`](/docs/zh-TW/output-styles#change-your-output-style)，或該命令是透過轉送至工作階段的訊息傳入的。由於這類回合可能並非來自帳戶擁有者，Claude Code 在該回合中只會列出及選擇[內建風格](/docs/zh-TW/output-styles#built-in-output-styles)，並在命令列出風格或無法辨識您提供的名稱時，附加此通知。[自訂風格](/docs/zh-TW/output-styles#create-a-custom-output-style)名稱會得到與不存在的名稱相同的回覆：
3723 3790
3724```text theme={null}3791```text theme={null}
3725Custom output styles can't be selected over Remote Control or from a relayed message. Select one in the session itself, or pick a built-in style here.3792Custom output styles can't be selected over Remote Control or from a relayed message. Select one in the session itself, or pick a built-in style here.
3726```3793```
3727 3794
3728**該怎麼做：**3795**處理方式：**
3729 3796
3730* 選擇內建樣式，例如 `/output-style concise`3797* 選擇一個內建風格，例如 `/output-style concise`
3731* 若要使用自訂樣式，在專案的 `.claude/settings.local.json` 中設定 [`outputStyle`](/docs/zh-TW/settings-reference#outputstyle)，或在工作階段自己的終端中執行 `/output-style <style>`（如果它有的話）3798* 若要使用自訂風格，請在專案的 `.claude/settings.local.json` 中設定 [`outputStyle`](/docs/zh-TW/settings-reference#outputstyle)，或者若工作階段本身有終端機，請在該終端機執行 `/output-style <style>`
3732 3799
3733<h3 id="output-styles-are-saved-to-local-settings-which-this-session-doesnt-load">3800<h3 id="output-styles-are-saved-to-local-settings-which-this-session-doesnt-load">
3734 輸出樣式被保存到此工作階段不載入的本地設定3801 Output styles are saved to local settings which this session doesn't load
3735</h3>3802</h3>
3736 3803
3737您嘗試在其設定來源排除 `local` 的工作階段中使用 `/output-style <style>` 或 `/config outputStyle=<style>` 切換[輸出樣式](/docs/zh-TW/output-styles)。範例是 [Agent SDK](/docs/zh-TW/agent-sdk/typescript) 工作階段，其 [`settingSources`](/docs/zh-TW/agent-sdk/typescript#options) 保留 `"local"` 和使用 [`--setting-sources`](/docs/zh-TW/cli-reference#cli-flags) 值保留 `local` 啟動的 CLI 工作階段。兩個命令都將樣式保存到 `.claude/settings.local.json`，此類工作階段永遠不會讀取回，所以 Claude Code 拒絕而不是寫入沒有效果的設定：3804您在設定來源排除了 `local` 的工作階段中，嘗試使用 `/output-style <style>` 或 `/config outputStyle=<style>` 切換[輸出風格](/docs/zh-TW/output-styles)。例如 [`settingSources`](/docs/zh-TW/agent-sdk/typescript#options) 未包含 `"local"` 的 [Agent SDK](/docs/zh-TW/agent-sdk/typescript) 工作階段，以及使用未包含 `local` 的 [`--setting-sources`](/docs/zh-TW/cli-reference#cli-flags) 值啟動的 CLI 工作階段。這兩個命令都會將風格儲存至 `.claude/settings.local.json`，而這類工作階段永遠不會讀回該檔案，因此 Claude Code 會拒絕執行，而不是寫入一個不會生效的設定：
3738 3805
3739```text theme={null}3806```text theme={null}
3740Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load, so the style can't be changed here.3807Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load, so the style can't be changed here.
3741```3808```
3742 3809
3743**該怎麼做：**3810**處理方式：**
3744 3811
3745* 將 `local` 新增到工作階段的設定來源並再次切換3812* 將 `local` 加入工作階段的設定來源，然後再次切換
3746* 在工作階段確實載入的設定檔中設定 [`outputStyle`](/docs/zh-TW/settings-reference#outputstyle) 鍵，例如專案中的 `.claude/settings.json` 或 `~/.claude/settings.json`。在 TypeScript SDK 中，改為在內嵌 `settings` 物件內設定 `outputStyle`；請參閱[啟用輸出樣式](/docs/zh-TW/agent-sdk/modifying-system-prompts#activate-an-output-style)3813* 在工作階段確實會載入的設定檔中設定 [`outputStyle`](/docs/zh-TW/settings-reference#outputstyle) 鍵，例如專案中的 `.claude/settings.json` 或 `~/.claude/settings.json`。在 TypeScript SDK 中，請改為在內嵌的 `settings` 物件中設定 `outputStyle`；請參閱 [Activate an output style](/docs/zh-TW/agent-sdk/modifying-system-prompts#activate-an-output-style)
3747 3814
3748<h2 id="plugin-errors">3815<h2 id="plugin-errors">
3749 Plugin 錯誤3816 Plugin 錯誤
4066 工具錯誤4133 工具錯誤
4067</h2>4134</h2>
4068 4135
4069這些錯誤來自 Claude 的內建工具。Claude 會自動修正大多數工具錯誤。當需要您進行變更時，該錯誤的**應該怎麼做**清單會說明要變更的內容。4136這些錯誤來自 Claude 的內建工具。Claude 會自行修正大多數工具錯誤。當某個錯誤需要您進行變更時，該錯誤的 **處理方式** 清單會說明需要變更的內容。
4070 4137
4071<h3 id="agent-would-be-spawned-with-zero-tools">4138<h3 id="agent-would-be-spawned-with-zero-tools">
4072 Agent 會以零個工具生成4139 Agent would be spawned with zero tools
4073</h3>4140</h3>
4074 4141
4075子代理的 [`tools` 清單](/docs/zh-TW/sub-agents#supported-frontmatter-fields)中的每個項目都無法匹配可用的工具，因此 Claude Code 拒絕啟動子代理：沒有工具，它無法採取行動。該訊息會按出錯原因將您的項目分組：4142subagent 的 [`tools` 清單](/docs/zh-TW/sub-agents#supported-frontmatter-fields) 中的每個項目都無法比對到可用的工具，因此 Claude Code 拒絕啟動該 subagent：沒有任何工具，它就無法執行動作。訊息會依問題類型將您的項目分組：
4076 4143
4077* **無法識別**：該項目不符合任何工具名稱，通常是打字錯誤，例如 `Grpe` 而非 `Grep`。4144* **Unrecognized**：該項目不符合任何工具名稱，通常是拼字錯誤，例如將 `Grep` 寫成 `Grpe`。
4078* **子代理無法使用**：該項目命名了一個[子代理無法使用](/docs/zh-TW/sub-agents#available-tools)的真實工具。背景子代理保持較小的內建工具集，因此當子代理在背景中執行時（這是預設值），只有前景子代理可以使用的項目會出現在此處。如果您列出 `Agent`，該訊息會改為在下一個群組下報告它。4145* **Not available to subagents**：該項目指定的是實際存在、但 [subagent 無法使用](/docs/zh-TW/sub-agents#available-tools) 的工具。背景 subagent 保留的內建工具集較小，因此當 subagent 會在背景執行時（這是預設行為），只有前景 subagent 能使用的項目就會歸入此組。如果您列出 `Agent`，訊息會改將其歸入下一組。
4079* **在此工作階段中未匹配任何工具**：該項目有效，但目前工作階段中沒有工具符合它，例如沒有連接 GitHub MCP 伺服器的 `mcp__github__*`，或子代理在[深度限制](/docs/zh-TW/sub-agents#let-subagents-spawn-their-own-subagents)處的 `Agent`。4146* **Matched no tools in this session**：該項目有效，但目前工作階段中沒有任何工具與其相符，例如未連線 GitHub MCP 伺服器時的 `mcp__github__*`，或是已達 [深度上限](/docs/zh-TW/sub-agents#let-subagents-spawn-their-own-subagents) 的 subagent 所列的 `Agent`。
4080 4147
4081省略 `tools` 欄位永遠不會觸發此拒絕。如果您將 `tools` 清單留空，或 `disallowedTools` 移除其中的每個項目，Claude Code 也會跳過拒絕並啟動沒有工具的子代理。4148省略 `tools` 欄位永遠不會觸發此拒絕。如果您將 `tools` 清單留空，或 `disallowedTools` 移除了其中的每個項目，Claude Code 也會略過此拒絕，並在沒有工具的情況下啟動 subagent。
4082 4149
4083在 v2.1.208 之前，子代理會以零個工具啟動，並可能返回空的或令人困惑的結果。4150在 v2.1.208 之前，subagent 會在沒有工具的情況下啟動，並可能傳回空白或令人困惑的結果。
4084 4151
4085```text theme={null}4152```text theme={null}
4086Agent 'code-reviewer' would be spawned with zero tools — refusing. Its tools list resolved to nothing: unrecognized [Grpe]. Fix the agent's tools frontmatter or pass a different subagent_type.4153Agent 'code-reviewer' would be spawned with zero tools — refusing. Its tools list resolved to nothing: unrecognized [Grpe]. Fix the agent's tools frontmatter or pass a different subagent_type.
4087```4154```
4088 4155
4089**應該怎麼做：**4156**處理方式：**
4090 4157
4091* 根據[子代理可用的工具](/docs/zh-TW/sub-agents#available-tools)修正錯誤命名的每個項目4158* 對照 [subagent 可用的工具](/docs/zh-TW/sub-agents#available-tools)，修正錯誤中列出的每個項目
4092* 移除工作階段沒有的工具項目，例如來自未連接伺服器的 MCP 工具4159* 移除工作階段中不存在之工具的項目，例如來自未連線伺服器的 MCP 工具
4093* 對於[背景子代理會捨棄](/docs/zh-TW/sub-agents#available-tools)的工具（例如 `CronCreate`），移除該項目。若要保留該工具，[關閉 fork 模式](/docs/zh-TW/sub-agents#turn-fork-mode-on-or-off)並要求 Claude 在前景中執行子代理4160* 對於 [背景 subagent 會捨棄](/docs/zh-TW/sub-agents#available-tools) 的工具（例如 `CronCreate`），請移除該項目。若要保留該工具，請 [關閉 fork 模式](/docs/zh-TW/sub-agents#turn-fork-mode-on-or-off)，並要求 Claude 在前景執行該 subagent
4094* 刪除 `tools` 欄位而不是列出工具，以給予子代理[子代理可用的每個工具](/docs/zh-TW/sub-agents#available-tools)4161* 刪除 `tools` 欄位而不列出工具，即可讓 subagent 取得每個 [subagent 可用的工具](/docs/zh-TW/sub-agents#available-tools)
4095* 對於只包含 `Agent` 的 `tools` 清單，提高[深度限制](/docs/zh-TW/sub-agents#let-subagents-spawn-their-own-subagents)或給予代理至少一個其他工具：Claude Code 在該限制處會保留 `Agent`，因此只有其他工具的清單會解析為零個工具4162* 對於只包含 `Agent` 的 `tools` 清單，請提高 [深度上限](/docs/zh-TW/sub-agents#let-subagents-spawn-their-own-subagents)，或至少再給該 agent 一個其他工具：Claude Code 會在達到該上限時保留 `Agent` 不提供，因此除了 `Agent` 之外沒有任何其他項目的清單會解析為沒有工具
4096 4163
4097<h3 id="file-is-covered-by-a-read-deny-rule">4164<h3 id="file-is-covered-by-a-read-deny-rule">
4098 檔案受到 Read 拒絕規則的涵蓋4165 File is covered by a Read deny rule
4099</h3>4166</h3>
4100 4167
4101Edit 或 Write 工具在由 [`Read` 拒絕規則](/docs/zh-TW/permissions#read-and-edit)匹配的路徑上被呼叫，包括在該路徑建立新檔案。兩個工具都會變更 Claude 必須能夠讀回的內容，因此 Claude Code 在任何檔案存取之前拒絕該呼叫。NotebookEdit 不受 `Read` 拒絕規則涵蓋。在 v2.1.228 之前，該規則僅阻止 Edit 工具，在 v2.1.208 之前，只有 `Edit` 拒絕規則會阻止編輯。4168Edit 或 Write 工具被呼叫來操作符合 [`Read` 拒絕規則](/docs/zh-TW/permissions#read-and-edit) 的路徑，包括在該路徑建立新檔案。這兩個工具都會變更 Claude 必須能夠讀回的內容，因此 Claude Code 會在存取任何檔案之前拒絕該呼叫。NotebookEdit 不受 `Read` 拒絕規則涵蓋。在 v2.1.228 之前，該規則只會封鎖 Edit 工具；在 v2.1.208 之前，只有 `Edit` 拒絕規則會封鎖編輯。
4102 4169
4103```text theme={null}4170```text theme={null}
4104File is covered by a Read deny rule in your permission settings and cannot be edited.4171File is covered by a Read deny rule in your permission settings and cannot be edited.
4105```4172```
4106 4173
4107當 Claude Code 拒絕 Write 工具時，訊息結尾改為 `and cannot be written`。4174當 Claude Code 拒絕 Write 工具時，訊息的結尾會改為 `and cannot be written`。
4108 4175
4109**應該怎麼做：**4176**處理方式：**
4110 4177
4111* 如果 Claude 應該能夠變更檔案，請在 `/permissions` 或[設定](/docs/zh-TW/settings-reference#permission-settings)中移除或縮小 `Read` 拒絕規則4178* 如果 Claude 應該能夠變更該檔案，請在 `/permissions` 或 [設定](/docs/zh-TW/settings-reference#permission-settings) 中移除或縮小該 `Read` 拒絕規則
4112* 如果檔案必須保持未觸及，請保留該規則並為相同路徑新增 `Edit` 拒絕規則以同時阻止 NotebookEdit 工具4179* 如果該檔案必須保持不變，請保留該規則，並為相同路徑新增 `Edit` 拒絕規則，以同時封鎖 NotebookEdit 工具
4113 4180
4114<h3 id="path-cannot-contain-null-bytes">4181<h3 id="path-cannot-contain-null-bytes">
4115 路徑不能包含空位元組4182 Path cannot contain null bytes
4116</h3>4183</h3>
4117 4184
4118檔案工具呼叫的路徑或模式引數包含空位元組，檔案系統和搜尋工具無法接受。Read、Write、Edit、NotebookEdit、Glob 和 Grep 會檢查此項，訊息會命名工具和引數：4185檔案工具呼叫的路徑或模式引數包含 null 位元組，而檔案系統和搜尋工具無法接受這種字元。Read、Write、Edit、NotebookEdit、Glob 和 Grep 會檢查這一點，訊息會指出工具和引數：
4119 4186
4120```text theme={null}4187```text theme={null}
4121Read file_path cannot contain null bytes (\0). Remove the null byte and try again.4188Read file_path cannot contain null bytes (\0). Remove the null byte and try again.
4122```4189```
4123 4190
4124工具呼叫失敗，Claude 看到錯誤，回合繼續。4191該工具呼叫會失敗，Claude 會看到錯誤，回合則會繼續進行。
4125 4192
4126**應該怎麼做：**4193**處理方式：**
4127 4194
4128* 您這邊無需做任何事：錯誤會作為工具的結果返回給 Claude，訊息本身會告訴 Claude 移除空位元組並重試4195* 您無需採取任何動作：錯誤會作為工具的結果傳回給 Claude，而訊息本身會告知 Claude 移除 null 位元組並重試
4129 4196
4130在 v2.1.281 之前，Read、Write、Edit 或 NotebookEdit 路徑中的空位元組會以命名 `Path contains null bytes` 的錯誤結束整個回合，工具永遠不會執行。4197在 v2.1.281 之前，Read、Write、Edit 或 NotebookEdit 路徑中的 null 位元組會以指出 `Path contains null bytes` 的錯誤結束整個回合，且工具從未執行。
4131 4198
4132<h3 id="subagent-type-is-required">4199<h3 id="subagent-type-is-required">
4133 subagent\_type 是必需的4200 subagent\_type is required
4134</h3>4201</h3>
4135 4202
4136```text theme={null}4203```text theme={null}
4137subagent_type is required: the general-purpose agent is not available in this session. Available agents: ...4204subagent_type is required: the general-purpose agent is not available in this session. Available agents: ...
4138```4205```
4139 4206
4140Claude 呼叫了 [Agent 工具](/docs/zh-TW/tools-reference#agent-tool-behavior)但沒有 `subagent_type`，此工作階段沒有[通用子代理](/docs/zh-TW/sub-agents#built-in-subagents)可作為備用。這在兩種設定中是這樣的情況：4207Claude 在未指定 `subagent_type` 的情況下呼叫了 [Agent 工具](/docs/zh-TW/tools-reference#agent-tool-behavior)，而此工作階段沒有可供後備使用的 [general-purpose subagent](/docs/zh-TW/sub-agents#built-in-subagents)。這會發生在兩種設定中：
4141 4208
4142* [`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1`](/docs/zh-TW/env-vars) 在非互動模式中設定，這會移除每個內建子代理4209* 在非互動模式中設定了 [`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1`](/docs/zh-TW/env-vars)，這會移除所有內建 subagent
4143* 工作階段的主執行緒代理有一個 [`tools: Agent(...)` 允許清單](/docs/zh-TW/sub-agents#restrict-which-subagents-can-be-spawned)，其中不包括 `general-purpose`4210* 工作階段的主執行緒 agent 具有排除了 `general-purpose` 的 [`tools: Agent(...)` 允許清單](/docs/zh-TW/sub-agents#restrict-which-subagents-can-be-spawned)
4144 4211
4145**應該怎麼做：**4212**處理方式：**
4146 4213
4147* 通常無需做任何事：訊息會列出工作階段確實擁有的子代理，因此 Claude 可以使用其中一個重試4214* 通常無需任何動作：訊息會列出工作階段中確實存在的 subagent，因此 Claude 可以使用其中之一重試
4148* 如果 Claude 持續失敗，請將 `general-purpose` 新增到 `tools: Agent(...)` 允許清單，或取消設定 `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`4215* 如果 Claude 持續失敗，請將 `general-purpose` 加入 `tools: Agent(...)` 允許清單，或取消設定 `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`
4149 4216
4150在 v2.1.235 之前，相同的呼叫失敗並顯示 `Agent type 'general-purpose' not found`。4217在 v2.1.235 之前，相同的呼叫會以 `Agent type 'general-purpose' not found` 失敗。
4151 4218
4152<h3 id="memory-index-is-over-its-read-limit">4219<h3 id="memory-index-is-over-its-read-limit">
4153 記憶體索引超過其讀取限制4220 Memory index is over its read limit
4154</h3>4221</h3>
4155 4222
4156Claude 寫入[自動記憶體](/docs/zh-TW/memory#auto-memory)索引 `MEMORY.md` 並將其留在其讀取限制之一上方：200 行或 25KB。寫入成功，但只有前 200 行或 25KB（以先到者為準）在工作階段開始時載入，因此超過限制的所有內容在每次讀取索引時都會被捨棄。在 v2.1.210 之前，超限索引在下次載入時會被無聲地截斷，沒有寫入時間訊號。4223Claude 寫入了 [自動記憶](/docs/zh-TW/memory#auto-memory) 索引 `MEMORY.md`，並使其超過其中一項讀取上限：200 行或 25KB。寫入已成功，但在工作階段開始時只會載入前 200 行或 25KB（以先達到者為準），因此每次讀取索引時，超出上限的所有內容都會被捨棄。在 v2.1.210 之前，超過上限的索引會在下次載入時被無聲截斷，且在寫入時不會有任何提示。
4157 4224
4158```text theme={null}4225```text theme={null}
4159Error: this write left the memory index at MEMORY.md at 214 lines, over its 200-line read limit. The write succeeded, but everything past the limit is silently dropped each time the index is loaded — entries at the end are already invisible to readers. Rewrite it to under 140 lines now: keep one line per entry, move detail into topic files, and merge or drop stale entries.4226Error: this write left the memory index at MEMORY.md at 214 lines, over its 200-line read limit. The write succeeded, but everything past the limit is silently dropped each time the index is loaded — entries at the end are already invisible to readers. Rewrite it to under 140 lines now: keep one line per entry, move detail into topic files, and merge or drop stale entries.
4160```4227```
4161 4228
4162只有載入的內容才計入限制。YAML frontmatter 和區塊級 HTML 註解在索引載入前會被移除，因此它們被排除在測量之外。在 v2.1.211 之前，Claude Code 測量原始檔案，frontmatter 或註解即使在載入的內容符合時也可能觸發此錯誤。4229只有會被載入的內容才會計入上限。YAML frontmatter 和區塊層級的 HTML 註解會在載入索引前被移除，因此不計入測量。在 v2.1.211 之前，Claude Code 會測量原始檔案，即使載入的內容符合上限，frontmatter 或註解也可能觸發此錯誤。
4163 4230
4164Claude Code 在寫入後將錯誤傳遞給 Claude，而不是在您的終端中列印為橫幅，因此您可能只在文字記錄中注意到它。4231Claude Code 會在寫入後將錯誤傳遞給 Claude，而不是在您的終端機中以橫幅形式顯示，因此您可能只會在逐字稿中注意到它。
4165 4232
4166當 Claude 的寫入使檔案接近限制但未超過時，Claude Code 會返回更溫和的提醒以壓縮索引，而不是此錯誤。4233當 Claude 的寫入使檔案接近上限但未超過時，Claude Code 會傳回較溫和的提醒，要求壓縮索引，而非此錯誤。
4167 4234
4168**應該怎麼做：**4235**處理方式：**
4169 4236
4170* 讓 Claude 重寫 `MEMORY.md`，或要求它：每個項目保留一行，將詳細資訊移到主題檔案中，並合併或捨棄過時的項目4237* 讓 Claude 重寫 `MEMORY.md`，或要求它這麼做：每個項目保留一行，將細節移至主題檔案，並合併或刪除過時的項目
4171* 若要自己修剪索引，請參閱[稽核和編輯您的記憶體](/docs/zh-TW/memory#audit-and-edit-your-memory)4238* 若要自行精簡索引，請參閱 [稽核與編輯您的記憶](/docs/zh-TW/memory#audit-and-edit-your-memory)
4172 4239
4173<h3 id="pkill-pattern-matches-the-claude-code-process">4240<h3 id="pkill-pattern-matches-the-claude-code-process">
4174 pkill 模式符合 Claude Code 程序4241 pkill pattern matches the Claude Code process
4175</h3>4242</h3>
4176 4243
4177Bash 工具呼叫中的 `pkill` 命令使用了一個模式（通常帶有 `-f`），該模式符合 Claude Code 程序本身，因此 Claude Code 拒絕該命令而不是讓它結束工作階段。Claude Code 在執行 `pkill` 之前使用 `pgrep` 測試模式，並在結果中包含其自己的程序 ID 時拒絕。檢查僅在 Linux 上執行；在 macOS 上，`pkill` 不經修改地執行。在 v2.1.214 之前，命令執行，符合的模式在回合中途殺死了 Claude Code 工作階段。4244Bash 工具呼叫中的 `pkill` 命令使用了符合 Claude Code 程序本身的模式（通常搭配 `-f`），因此 Claude Code 會拒絕該命令，而不是讓它結束工作階段。Claude Code 會在執行 `pkill` 之前以 `pgrep` 測試該模式，若結果中包含其自身的程序 ID 便會拒絕。此檢查僅在 Linux 上執行；在 macOS 上，`pkill` 會原封不動地執行。在 v2.1.214 之前，該命令會執行，且符合的模式會在回合進行中終止 Claude Code 工作階段。
4178 4245
4179```text theme={null}4246```text theme={null}
4180pkill: refusing to run — this pattern matches the Claude CLI process (PID 12345). Narrow the pattern, or target your own children with `pkill -P $$ ...`.4247pkill: refusing to run — this pattern matches the Claude CLI process (PID 12345). Narrow the pattern, or target your own children with `pkill -P $$ ...`.
4181```4248```
4182 4249
4183拒絕出現在 Bash 工具結果中，而不是作為您終端中的橫幅，Claude 通常會自行調整命令。4250拒絕訊息會出現在 Bash 工具結果中，而不是以橫幅形式出現在您的終端機中，Claude 通常會自行調整命令。
4184 4251
4185**應該怎麼做：**4252**處理方式：**
4186 4253
4187* 縮小模式，使其僅符合預期的程序，例如目標二進位檔的完整路徑而不是短子字串4254* 縮小模式範圍，使其只符合預期的程序，例如使用目標二進位檔的完整路徑，而非簡短的子字串
4188* 若要停止由目前 shell 啟動的程序，請使用 `pkill -P $$` 搭配模式，這會將符合限制為 shell 自己的子程序4255* 若要停止由目前 shell 啟動的程序，請將 `pkill -P $$` 與模式搭配使用，這會將比對範圍限制在該 shell 自身的子程序
4189 4256
4190<h3 id="failed-to-write-to-a-teammate-inbox">4257<h3 id="failed-to-write-to-a-teammate-inbox">
4191 無法寫入隊友的收件匣4258 Failed to write to a teammate's inbox
4192</h3>4259</h3>
4193 4260
4194Claude Code 無法將訊息寫入 `~/.claude/teams/{team-name}/inboxes/` 下隊友的信箱檔案，因此收件者沒有收到任何內容。當 Claude Code 無法建立或更新檔案時寫入失敗，例如因為磁碟已滿、目錄不可寫，或另一個代理長時間持有收件匣鎖。在 v2.1.224 之前，Claude Code 即使寫入失敗也會報告訊息已傳送。4261Claude Code 無法將訊息寫入 `~/.claude/teams/{team-name}/inboxes/` 下隊員的信箱檔案，因此收件者沒有收到任何內容。當 Claude Code 無法建立或更新該檔案時，寫入就會失敗，例如磁碟已滿、目錄不可寫入，或另一個 agent 持有收件匣鎖定過久。在 v2.1.224 之前，即使寫入失敗，Claude Code 仍會回報訊息已傳送。
4195 4262
4196錯誤出現在傳送代理的工具結果中，而不是作為您終端中的橫幅，其文字告訴 Claude 重試：4263錯誤會出現在傳送端 agent 的工具結果中，而不是以橫幅形式出現在您的終端機中，其文字會告知 Claude 重試：
4197 4264
4198```text theme={null}4265```text theme={null}
4199Failed to write to researcher's inbox — nothing was sent. Try again, or message the lead.4266Failed to write to researcher's inbox — nothing was sent. Try again, or message the lead.
4200```4267```
4201 4268
4202結構化[代理團隊](/docs/zh-TW/agent-teams)協議訊息以相同方式失敗，錯誤命名未傳遞的訊息：當 Claude Code 無法寫入計畫核准、計畫拒絕、關閉要求或關閉拒絕時，錯誤讀作 `Failed to write the <message> to <name>'s inbox — nothing was sent`。該清單中的 `plan approval` 是領導者核准隊友計畫的決定；隊友的計畫提交是單獨的 `plan approval request` 訊息。該訊息和另外兩個協議訊息帶有自己的訊息文字和後果：4269結構化的 [agent team](/docs/zh-TW/agent-teams) 協定訊息也會以相同方式失敗，且錯誤會指出未送達的訊息：當 Claude Code 無法寫入計畫核准、計畫駁回、關閉請求或關閉拒絕時，錯誤內容為 `Failed to write the <message> to <name>'s inbox — nothing was sent`。該清單中的 `plan approval` 是組長核准隊員計畫的決定；隊員提交的計畫則是另一則 `plan approval request` 訊息。該訊息與另外兩則協定訊息有各自的訊息文字與後果：
4203 4270
4204* `Failed to write the plan approval request to the lead's inbox — plan not submitted; try again`：隊友的計畫永遠沒有到達領導者，隊友保持在計畫模式直到重新提交成功4271* `Failed to write the plan approval request to the lead's inbox — plan not submitted; try again`：隊員的計畫從未送達組長，且隊員會停留在 plan mode，直到重新提交成功為止
4205* `The permission request could not be delivered to the team lead (mailbox write failed)`：隊友的權限要求永遠沒有到達領導者，因此沒有人核准工具呼叫4272* `The permission request could not be delivered to the team lead (mailbox write failed)`：隊員的權限請求從未送達組長，因此沒有人核准該工具呼叫
4206* `The confirmation could not be written to team-lead's inbox.`：關閉核准本身生效，隊友退出；只有對領導者的確認遺失4273* `The confirmation could not be written to team-lead's inbox.`：關閉核准本身已生效，隊員會結束；只是缺少給組長的確認
4207 4274
4208當您自己訊息隊友時，在領導者工作階段中輸入 `@name` 後跟訊息，相同的失敗會顯示為通知 `Couldn't write to @name's inbox — message not sent. Try again.`，Claude Code 會將您的文字保留在提示框中，以便您可以再次傳送。4275當您自行傳訊息給隊員時（在組長工作階段中輸入 `@name` 後接訊息），相同的失敗會以通知形式出現，即 `Couldn't write to @name's inbox — message not sent. Try again.`，且 Claude Code 會將您的文字保留在提示詞輸入框中，以便您再次傳送。
4209 4276
4210**應該怎麼做：**4277**處理方式：**
4211 4278
4212* 要求傳送者重新傳送訊息；收件匣鎖的爭用是暫時的，在重試時會清除4279* 請傳送者重新傳送訊息；收件匣鎖定的爭用是暫時性的，重試時便會解除
4213* 檢查可用磁碟空間，並檢查 `~/.claude/teams` 及其下的檔案是否可由您的使用者寫入4280* 檢查可用磁碟空間，並確認 `~/.claude/teams` 及其下的檔案可由您的使用者寫入
4214 4281
4215<h3 id="teammate-agent-definition-not-restored">4282<h3 id="teammate-agent-definition-not-restored">
4216 隊友的代理定義未被復原4283 Teammate's agent definition was not restored
4217</h3>4284</h3>
4218 4285
4219Claude 訊息了一個已停止的[代理團隊](/docs/zh-TW/agent-teams)隊友，Claude Code 將其恢復而沒有重新應用[子代理定義](/docs/zh-TW/agent-teams#use-subagent-definitions-for-teammates)它是從中生成的，因為其定義檔案來自沒有已儲存信任的資料夾。通知在傳送代理的工具結果中的恢復報告之後：4286Claude 傳訊息給一位已停止的 [agent team](/docs/zh-TW/agent-teams) 隊員，Claude Code 將其恢復，但沒有重新套用它最初據以產生的 [subagent 定義](/docs/zh-TW/agent-teams#use-subagent-definitions-for-teammates)，因為其定義檔案來自沒有已儲存信任的資料夾。此通知會接在傳送端 agent 工具結果中的恢復報告之後：
4220 4287
4221```text wrap theme={null}4288```text wrap theme={null}
4222Its agent definition was not restored: the folder its definition file came from is not trusted (source: projectSettings), so the teammate is running with the team-essential tools and no custom instructions. To restore it, the user needs to run Claude Code in that folder once and accept the trust dialog (the --debug log names the folder); do not change trust settings on the user's behalf.4289Its agent definition was not restored: the folder its definition file came from is not trusted (source: projectSettings), so the teammate is running with the team-essential tools and no custom instructions. To restore it, the user needs to run Claude Code in that folder once and accept the trust dialog (the --debug log names the folder); do not change trust settings on the user's behalf.
4223```4290```
4224 4291
4225檢查適用於專案的 `.claude/agents/` 目錄或 `--add-dir` 目錄中的定義，接受父資料夾的信任對話不滿足它。4292此檢查適用於專案或 `--add-dir` 目錄之 `.claude/agents/` 目錄中的定義，而接受上層資料夾的信任對話框並不能滿足此檢查。
4226 4293
4227**應該怎麼做：**4294**處理方式：**
4228 4295
4229* 在[偵錯日誌](/docs/zh-TW/debug-your-config)命名的資料夾中執行 `claude` 並接受信任對話。下次 Claude Code 恢復隊友時會重新應用定義；您不需要重新啟動領導者工作階段4296* 在 [除錯日誌](/docs/zh-TW/debug-your-config) 指出的資料夾中執行 `claude`，並接受信任對話框。下次 Claude Code 恢復該隊員時，便會重新套用定義；您不需要重新啟動組長工作階段
4230* 或在 `~/.claude.json` 中將 `hasTrustDialogAccepted` 項目設定為 `true`，使用偵錯日誌列印的確切 `projects["<path>"]` 鍵4297* 或者，在 `~/.claude.json` 中將 `hasTrustDialogAccepted` 項目設為 `true`，並使用除錯日誌印出的確切 `projects["<path>"]` 鍵
4231 4298
4232<h3 id="message-too-large-for-cross-session-delivery">4299<h3 id="message-too-large-for-cross-session-delivery">
4233 跨工作階段傳遞的訊息太大4300 Message too large for cross-session delivery
4234</h3>4301</h3>
4235 4302
4236Claude 的[跨工作階段訊息](/docs/zh-TW/cross-session-messaging)到此機器上您的另一個工作階段太長而無法傳送。Claude Code 拒絕了它，接收工作階段沒有收到任何內容。拒絕出現在傳送工作階段的工具結果中，而不是作為您終端中的橫幅。它命名兩個大小以及如何使訊息符合：4303Claude 傳送給您在此機器上另一個工作階段的 [跨工作階段訊息](/docs/zh-TW/cross-session-messaging) 過長，無法傳送。Claude Code 拒絕了它，接收端工作階段沒有收到任何內容。拒絕訊息會出現在傳送端工作階段的工具結果中，而不是以橫幅形式出現在您的終端機中。它會指出兩個大小以及如何讓訊息符合限制：
4237 4304
4238```text wrap theme={null}4305```text wrap theme={null}
4239Failed to send to api-worker: Message too large for cross-session delivery: the serialized message is 1,203,844 characters and the limit is 1,048,576. Shorten the message text — put bulk content in a file the recipient can read rather than in the message — or split it into smaller messages.4306Failed to send to api-worker: Message too large for cross-session delivery: the serialized message is 1,203,844 characters and the limit is 1,048,576. Shorten the message text — put bulk content in a file the recipient can read rather than in the message — or split it into smaller messages.
4240```4307```
4241 4308
4242重新傳送相同的文字以相同方式失敗。4309重新傳送相同的文字也會以相同方式失敗。
4243 4310
4244**應該怎麼做：**4311**處理方式：**
4245 4312
4246* 要求 Claude 總結訊息，或將大量內容放在收件者可以讀取的檔案中4313* 要求 Claude 摘要該訊息，或將大量內容放入檔案並傳送該檔案的路徑
4247* 要求 Claude 將內容分割成幾個較短的訊息4314* 要求 Claude 將內容拆分成數則較短的訊息
4248 4315
4249在 v2.1.235 之前，Claude Code 報告超大訊息已傳送。接收工作階段未讀地捨棄了它。4316在 v2.1.235 之前，Claude Code 會將過大的訊息回報為已傳送。接收端工作階段會在未讀取的情況下將其捨棄。
4250 4317
4251<h3 id="too-many-messages-to-this-session-just-now">4318<h3 id="too-many-messages-to-this-session-just-now">
4252 此工作階段剛才收到太多訊息4319 Too many messages to this session just now
4253</h3>4320</h3>
4254 4321
4255Claude 向此機器上您的一個工作階段傳送了快速的[跨工作階段訊息](/docs/zh-TW/cross-session-messaging)爆發，爆發達到該工作階段的收件匣接受的內容。Claude Code 拒絕了下一個傳送，接收工作階段沒有收到任何內容。拒絕出現在傳送工作階段的工具結果中，而不是作為您終端中的橫幅：4322Claude 向您在此機器上的某個工作階段快速連續傳送了大量 [跨工作階段訊息](/docs/zh-TW/cross-session-messaging)，而這一連串訊息已達該工作階段收件匣所能接受的量。Claude Code 拒絕了下一次傳送，接收端工作階段沒有從中收到任何內容。拒絕訊息會出現在傳送端工作階段的工具結果中，而不是以橫幅形式出現在您的終端機中：
4256 4323
4257```text wrap theme={null}4324```text wrap theme={null}
4258Failed to send to api-worker: Too many messages to this session just now: 30 were sent recently and more would be dropped by its rate limit, so this one was not sent. Batch what remains into one message, or wait a little before sending more.4325Failed to send to api-worker: Too many messages to this session just now: 30 were sent recently and more would be dropped by its rate limit, so this one was not sent. Batch what remains into one message, or wait a little before sending more.
4259```4326```
4260 4327
4261**應該怎麼做：**4328**處理方式：**
4262 4329
4263* 通常無需做任何事：Claude 將剩餘內容批次處理為一個訊息，或在傳送更多內容之前等待4330* 通常無需任何動作：Claude 會將剩餘內容合併成一則訊息，或在傳送更多訊息前稍候
4264* 如果您自己提示了爆發，要求 Claude 將剩餘內容合併為單一訊息4331* 如果是您自己促成了這一連串訊息，請要求 Claude 將剩餘內容合併成單一訊息
4265 4332
4266在 v2.1.236 之前，Claude Code 報告這些傳送已傳送。接收工作階段未讀地捨棄了它們。4333在 v2.1.236 之前，Claude Code 會將這些傳送回報為已傳送。接收端工作階段會在未讀取的情況下將其捨棄。
4267 4334
4268<h3 id="cross-session-message-dropped-at-the-inbox">4335<h3 id="cross-session-message-dropped-at-the-inbox">
4269 跨工作階段訊息在收件者工作階段的收件匣被捨棄4336 Cross-session message was dropped at the recipient session's inbox
4270</h3>4337</h3>
4271 4338
4272Claude 傳送了[跨工作階段訊息](/docs/zh-TW/cross-session-messaging)到此機器上您的另一個工作階段，該工作階段的收件匣在 Claude 在該工作階段中讀取它之前捨棄了它。該行命名收件者的位址，當收件者提供原因時，在破折號後新增原因：4339Claude 傳送了一則 [跨工作階段訊息](/docs/zh-TW/cross-session-messaging) 給您在此機器上的另一個工作階段，而該工作階段的收件匣在該工作階段中的 Claude 讀取之前就將其捨棄。這一行會指出收件者的位址，若收件者提供了原因，則會在破折號後附上原因：
4273 4340
4274```text wrap theme={null}4341```text wrap theme={null}
4275Cross-session message was dropped at the recipient session's inbox (recipient: uds:/tmp/cc-socks/13605.sock) and not delivered — its queue of undelivered peer messages was full. Claude was told not to resend right away.4342Cross-session message was dropped at the recipient session's inbox (recipient: uds:/tmp/cc-socks/13605.sock) and not delivered — its queue of undelivered peer messages was full. Claude was told not to resend right away.
4276```4343```
4277 4344
4278一行可以涵蓋多個捨棄的訊息。然後它以複數開始，例如 `Cross-session messages (12) were dropped`。若要找到位址屬於哪個工作階段，請將其與 `/status` 在每個工作階段中顯示的 [`Peer address` 列](/docs/zh-TW/cross-session-messaging#the-sessions-inbox-socket)進行比較。4345一行可以涵蓋數則被捨棄的訊息，此時開頭會使用複數形式，例如 `Cross-session messages (12) were dropped`。若要找出某個位址屬於哪個工作階段，請將其與每個工作階段中 `/status` 顯示的 [`Peer address` 列](/docs/zh-TW/cross-session-messaging#the-sessions-inbox-socket) 進行比對。
4279 4346
4280在破折號後，該行給出以下一個或多個原因：4347在破折號之後，這一行會提供下列一個或多個原因：
4281 4348
4282* `its queue of undelivered peer messages was full`：收件者已經持有來自其他工作階段的許多未傳遞訊息，達到其佇列允許的數量4349* `its queue of undelivered peer messages was full`：收件者已持有其佇列所允許的最大數量、來自其他工作階段的未送達訊息
4283* `you sent faster than that session accepts`：傳送工作階段的訊息到達速度比收件者從一個傳送者接受的速度快4350* `you sent faster than that session accepts`：傳送端工作階段的訊息抵達速度，超過收件者從單一傳送者所接受的速度
4284* `it repeated your previous message`：訊息與傳送工作階段不久前傳送給此收件者的訊息相同4351* `it repeated your previous message`：該訊息與傳送端工作階段不久前傳送給此收件者的訊息完全相同
4285* `a relay loop between sessions was cut`：訊息繼續了工作階段相互訊息的鏈，該鏈已通過收件者太多次或變得太長4352* `a relay loop between sessions was cut`：該訊息延續了工作階段之間互相傳訊的鏈結，而該鏈結經過收件者的次數過多或長度過長
4286 4353
4287**應該怎麼做：**4354**處理方式：**
4288 4355
4289* 假設收件者從未看到捨棄的訊息。Claude Code 告訴 Claude 相同的內容，並告訴它改為在稍後的一個訊息中包含仍然重要的任何內容，而不是立即重新傳送4356* 假設收件者從未看到被捨棄的訊息。Claude Code 也會如此告知 Claude，並告訴它將仍然重要的內容納入稍後的一則訊息中，而不是立即重新傳送
4290* 如果您的工作階段相互傳送頻繁的更新，要求 Claude 傳送較少、較大的訊息，例如工作階段完成其工作時的一份報告4357* 如果您的工作階段會頻繁地互相傳送更新，請要求 Claude 傳送較少但較大的訊息，例如在某個工作階段完成工作時傳送一份報告
4291* 對於 `a relay loop between sessions was cut`，在其中一個工作階段中自己輸入下一個指令。Claude 為回應您自己的提示而傳送的訊息開始新的鏈4358* 對於 `a relay loop between sessions was cut`，請自行在其中一個工作階段中輸入下一個指令。Claude 為回應您自己的提示詞而傳送的訊息會開始一條新的鏈結
4292 4359
4293在 v2.1.238 之前，當收件者的收件匣捨棄訊息時，傳送工作階段沒有收到報告。4360在 v2.1.238 之前，當收件者的收件匣捨棄訊息時，傳送端工作階段不會收到任何報告。
4294 4361
4295<h3 id="refusing-to-send-a-cross-session-message">4362<h3 id="refusing-to-send-a-cross-session-message">
4296 拒絕傳送跨工作階段訊息4363 Refusing to send a cross-session message
4297</h3>4364</h3>
4298 4365
4299在 Claude Code 將[跨工作階段訊息](/docs/zh-TW/cross-session-messaging)寫入此機器上您的另一個工作階段之前，它會檢查目標工作階段的收件匣通訊端是否是訊息定址到的端點。當檢查失敗時，Claude Code 拒絕傳送，目標工作階段收不到任何內容。對於 Claude 傳送的訊息，拒絕出現在傳送工作階段的工具結果中：4366在 Claude Code 將 [跨工作階段訊息](/docs/zh-TW/cross-session-messaging) 寫入您在此機器上的另一個工作階段之前，它會檢查目標工作階段的收件匣 socket 是否就是該訊息所指定的端點。當檢查失敗時，Claude Code 會在傳送端工作階段中拒絕傳送，目標工作階段不會收到任何內容。對於 Claude 傳送的訊息，拒絕訊息會出現在傳送端工作階段的工具結果中：
4300 4367
4301```text theme={null}4368```text theme={null}
4302Failed to send to api-worker: Refusing to send: reply target is a symlink4369Failed to send to api-worker: Refusing to send: reply target is a symlink
4303```4370```
4304 4371
4305`Refusing to send:` 之後的文字命名失敗的檢查：4372`Refusing to send:` 之後的文字會指出失敗的檢查：
4306 4373
4307* `reply target is a symlink`：符號連結位於目標工作階段的通訊端路徑。Claude Code 不會透過它傳遞，因為連結可能會將訊息重新導向到目標工作階段未建立的端點。4374* `reply target is a symlink`：目標工作階段的 socket 路徑上有一個符號連結。Claude Code 不會透過它傳遞，因為該處的連結可能會將訊息重新導向至非目標工作階段建立的端點。
4308* `cannot vet reply target`：Claude Code 根本無法檢查目標路徑，例如因為讀取失敗並出現權限錯誤。4375* `cannot vet reply target`：Claude Code 完全無法檢查目標路徑，例如讀取時因權限錯誤而失敗。
4309 4376
4310**應該怎麼做：**4377**處理方式：**
4311 4378
4312* 通常無需做任何事：檢查會防止訊息到達定址到的工作階段以外的端點，沒有任何內容被傳送4379* 通常無需任何動作：這些檢查可防止訊息送達其所指定工作階段以外的端點，且沒有傳送任何內容
4313* 如果 `reply target is a symlink` 對一個工作階段重複，檢查在該工作階段的通訊端路徑（顯示在其 `/status` 下的 `Peer address`）建立連結的內容4380* 如果 `reply target is a symlink` 在某個工作階段重複出現，請檢查是什麼在該工作階段的 socket 路徑上建立了連結，該路徑會顯示在其 `/status` 的 `Peer address` 下
4314 4381
4315<h3 id="refusing-after-a-symlink-changed">4382<h3 id="refusing-after-a-symlink-changed">
4316 拒絕讀取、寫入或搜尋路徑4383 Refusing to read, write, or search a path
4317</h3>4384</h3>
4318 4385
4319Claude Code 檢查檔案路徑的[權限規則](/docs/zh-TW/permissions#read-and-edit)，然後在工具開啟檔案或啟動搜尋時再次確認該解析。當它無法確認路徑仍然導向檢查核准的位置時，Claude Code 拒絕操作而不是跟隨它。拒絕出現在工具結果中：4386Claude Code 會檢查檔案路徑的 [權限規則](/docs/zh-TW/permissions#read-and-edit)，然後在工具開啟檔案或開始搜尋時再次確認該解析結果。當它無法確認該路徑仍通往檢查所核准的位置時，Claude Code 會拒絕該操作，而不是跟隨它。拒絕訊息會出現在工具結果中：
4320 4387
4321```text wrap theme={null}4388```text wrap theme={null}
4322Refusing to read /path/to/file: its symlink resolution changed after permission was checked (a link on the way now leads somewhere the check did not see). If a link in the working directory is being rewritten concurrently, stop that and retry.4389Refusing to read /path/to/file: its symlink resolution changed after permission was checked (a link on the way now leads somewhere the check did not see). If a link in the working directory is being rewritten concurrently, stop that and retry.
4323```4390```
4324 4391
4325每個拒絕命名其原因：4392每個拒絕都會指出其原因：
4326 4393
4327* `its symlink resolution changed after permission was checked`：路徑上的符號連結或 Grep 或 Glob 搜尋根在權限檢查和操作之間被取代。在讀取拒絕中，括號中的短語命名哪個比較失敗。4394* `its symlink resolution changed after permission was checked`：路徑上或 Grep、Glob 搜尋根目錄上的符號連結，在權限檢查與操作之間遭到替換。在讀取拒絕中，括號內的文字會指出哪一項比對失敗。
4328* `its parent-directory symlink resolution changed after permission was checked`：寫入路徑通過的目錄不再解析為核准的位置4395* `its parent-directory symlink resolution changed after permission was checked`：寫入路徑所經過的某個目錄不再解析至已核准的位置
4329* `where it leads on disk could not be determined (a link on the way could not be examined, or the links do not resolve)`：Claude Code 無法跟隨路徑到磁碟上的最終位置，例如因為路徑上的符號連結形成迴圈4396* `where it leads on disk could not be determined (a link on the way could not be examined, or the links do not resolve)`：Claude Code 無法沿著路徑找到磁碟上的最終位置，例如因為路徑上的符號連結形成迴圈
4330* `it is a symbolic link. Write to the link's target path instead`：符號連結位於核准的寫入位置本身，例如 `CLAUDE.md` 是 `AGENTS.md` 的符號連結；訊息將 Claude 導向連結的目標4397* `it is a symbolic link. Write to the link's target path instead`：要求的寫入位置本身就是符號連結，例如作為指向 `AGENTS.md` 之符號連結的 `CLAUDE.md`；訊息會引導 Claude 改用該連結的目標
4331* `Refusing to write through symlink: <path>. Resolve the symlink and pass the real target path explicitly.`：當另一個寫入器開啟檔案時捕獲的相同條件，例如寫入符號連結的 `.mcp.json`4398* `Refusing to write through symlink: <path>. Resolve the symlink and pass the real target path explicitly.`：在另一個寫入器開啟檔案時偵測到的相同情況，例如寫入作為符號連結的 `.mcp.json`
4332* `Refusing to write into symlinked directory: <path>`：持有檔案的目錄本身是符號連結，例如專案的 `.claude/` 目錄連結到另一位置4399* `Refusing to write into symlinked directory: <path>`：存放該檔案的目錄本身就是符號連結，例如連結至其他位置的專案 `.claude/` 目錄
4333* `a path one of its Read deny rules is written through changed while the search was being prepared. Retry.`：搜尋的 `Read` 拒絕規則命名通過符號連結的路徑，該連結在 Claude Code 準備搜尋時變更4400* `a path one of its Read deny rules is written through changed while the search was being prepared. Retry.`：搜尋所適用的某條 `Read` 拒絕規則指定了一個經過符號連結的路徑，而該連結在 Claude Code 準備搜尋時發生了變更
4334* `it could not be opened (EACCES) — it is unreadable, or is being replaced concurrently.`：搜尋根存在但無法開啟；括號中的代碼是作業系統錯誤4401* `it could not be opened (EACCES) — it is unreadable, or is being replaced concurrently.`：搜尋根目錄存在，但無法開啟；括號內的代碼是作業系統錯誤
4335* `its permission check expired before it ran (too many concurrent file operations). Retry.`：Claude Code 在許多同時檔案操作下驅逐核准記錄，工具使用它之前；重試執行新鮮的權限檢查4402* `its permission check expired before it ran (too many concurrent file operations). Retry.`：在大量同時進行的檔案操作下，Claude Code 在工具使用核准記錄之前就將其逐出；重試會執行新的權限檢查
4336* `ripgrep was found only by name on PATH, and a search outside the working directory cannot apply your Read deny rules in that configuration`：Claude Code 無法將 `rg` 二進位檔解析為絕對路徑，因此它拒絕工作目錄外的搜尋，而不是執行您的拒絕規則不涵蓋的搜尋4403* `ripgrep was found only by name on PATH, and a search outside the working directory cannot apply your Read deny rules in that configuration`：Claude Code 無法將 `rg` 二進位檔解析為絕對路徑，因此會拒絕工作目錄以外的搜尋，而不是執行一個您的拒絕規則無法涵蓋的搜尋
4337 4404
4338**應該怎麼做：**4405**處理方式：**
4339 4406
4340* 通常無需做任何事：拒絕到達 Claude 作為工具結果，被拒絕的操作不執行4407* 通常無需任何動作：拒絕會作為工具結果傳遞給 Claude，被拒絕的操作不會執行
4341* 如果符號連結拒絕在一個路徑上重複，找到什麼持續重寫那裡的連結，例如建置工具或檔案監視程式，或要求 Claude 使用檔案的已解析路徑而不是連結的路徑4408* 如果符號連結拒絕在某個路徑上重複出現，請找出持續改寫該處連結的來源，例如建置工具或檔案監看程式，或要求 Claude 使用檔案的解析後路徑，而非連結路徑
4342* 如果此拒絕在 Windows 上 Claude Code 在 AppContainer 或受限權杖沙箱內執行時出現，升級到 v2.1.265 或更新版本4409* 如果 Claude Code 在 Windows 上於 AppContainer 或受限權杖沙箱中執行時，每個檔案都出現此拒絕，請升級至 v2.1.265 或更新版本
4343* 如果讀取拒絕在 macOS 上出現，針對沒有任何內容重寫的檔案，例如拖入提示的螢幕擷取畫面，升級到 v2.1.273 或更新版本4410* 如果在 macOS 上，對於沒有任何程式在改寫的檔案（例如拖曳到提示詞中的螢幕截圖）出現讀取拒絕，請升級至 v2.1.273 或更新版本
4344* 對於 ripgrep 拒絕，使用您的套件管理員安裝 ripgrep，使 `rg` 解析為 `PATH` 上的絕對路徑，或將搜尋保留在工作目錄下4411* 對於 ripgrep 拒絕，請使用您的套件管理員安裝 ripgrep，使 `rg` 能在 `PATH` 上解析為絕對路徑，或將搜尋保持在工作目錄之下
4345 4412
4346在 v2.1.251 之前，Claude Code 僅針對檔案寫入重新檢查路徑的解析，因此在權限檢查後取代的連結可能會將讀取或搜尋重新導向到不同位置而沒有訊息。其中，只有父目錄、透過符號連結和符號連結目錄寫入拒絕出現在較早的版本上。4413在 v2.1.251 之前，Claude Code 只會針對檔案寫入重新檢查路徑的解析結果，因此在權限檢查後遭替換的連結可能會在沒有任何訊息的情況下，將讀取或搜尋重新導向至不同的位置。在這些拒絕中，只有上層目錄、透過符號連結寫入，以及符號連結目錄這幾種寫入拒絕會出現在較早的版本中。
4347 4414
4348在 v2.1.280 之前，`where it leads on disk could not be determined` 拒絕沒有出現。4415在 v2.1.280 之前，`where it leads on disk could not be determined` 拒絕不會出現。
4349 4416
4350<h3 id="task-output-swap-refused">4417<h3 id="task-output-swap-refused">
4351 工作輸出交換被拒絕4418 Task output swap refused
4352</h3>4419</h3>
4353 4420
4354Claude Code 將每個 Bash 命令的輸出儲存到其暫存目錄下的檔案。每次它開啟其中一個檔案時，它都會檢查路徑是否仍然導向它建立的檔案，沒有符號連結、額外硬連結或移動的目錄重新導向它。此訊息表示該檢查失敗，因此 Claude Code 拒絕操作而不是透過該路徑寫入或讀取輸出。訊息出現在 Bash 工具結果中：4421Claude Code 會將每個 Bash 命令的輸出儲存到其暫存目錄下的檔案中。每次開啟這些檔案時，它都會檢查路徑是否仍通往它所建立的檔案，且沒有符號連結、額外的硬連結或被移動的目錄將其重新導向。此訊息表示該檢查失敗，因此 Claude Code 拒絕了該操作，而不是透過該路徑寫入或讀取輸出。訊息會出現在 Bash 工具結果中：
4355 4422
4356```text wrap theme={null}4423```text wrap theme={null}
4357task output swap refused (tasks dir moved or linked): /private/tmp/claude-501/-Users-you-my-project/1f0e62dc-4b0a-4f5e-9c2d-8a7b6c5d4e3f/tasks/b7k2f9m3q.output. To recover: restart Claude Code with CLAUDE_CODE_TMPDIR set to a fresh directory; or, if /private/tmp/claude-501/-Users-you-my-project is a stray directory or a symbolic link that should not be there, remove that entry itself (not what it points to) and restart.4424task output swap refused (tasks dir moved or linked): /private/tmp/claude-501/-Users-you-my-project/1f0e62dc-4b0a-4f5e-9c2d-8a7b6c5d4e3f/tasks/b7k2f9m3q.output. To recover: restart Claude Code with CLAUDE_CODE_TMPDIR set to a fresh directory; or, if /private/tmp/claude-501/-Users-you-my-project is a stray directory or a symbolic link that should not be there, remove that entry itself (not what it points to) and restart.
4358```4425```
4359 4426
4360括號中的文字命名失敗的檢查。原因例如 `output symlink was re-pointed`、`output file identity changed` 和 `not a regular file` 都報告相同的條件：輸出路徑上或沿著的某些內容不再是 Claude Code 建立的檔案。只有某些原因帶有 `To recover:` 句子。4427括號內的文字會指出失敗的檢查。`output symlink was re-pointed`、`output file identity changed` 和 `not a regular file` 等原因都回報相同的情況：輸出路徑上或沿途的某個東西已不再是 Claude Code 所建立的檔案。只有部分原因會附帶 `To recover:` 句子。
4361 4428
4362如果檢查在命令仍在執行時失敗，Claude Code 會停止命令，其結果報告：4429如果檢查在命令仍在執行時失敗，Claude Code 會停止該命令，其結果會回報：
4363 4430
4364```text theme={null}4431```text theme={null}
4365Command killed: its output file was replaced or could no longer be verified4432Command killed: its output file was replaced or could no longer be verified
4366```4433```
4367 4434
4368**應該怎麼做：**4435**處理方式：**
4369 4436
4370* 升級到 v2.1.260 或更新版本。較早的版本有時在沒有連結或移動目錄存在時顯示此訊息4437* 升級至 v2.1.260 或更新版本。較早的版本有時會在沒有連結或被移動目錄的情況下顯示此訊息
4371* 使用 [`CLAUDE_CODE_TMPDIR`](/docs/zh-TW/env-vars) 設定為新鮮目錄重新啟動 Claude Code4438* 將 [`CLAUDE_CODE_TMPDIR`](/docs/zh-TW/env-vars) 設為全新的目錄，然後重新啟動 Claude Code
4372* 或檢查您的專案在 Claude Code 暫存目錄下的目錄，範例訊息中的 `/private/tmp/claude-501/-Users-you-my-project`。如果該路徑是符號連結，或不應該在那裡的目錄，移除連結或目錄本身而不是連結的目標，並重新啟動 Claude Code4439* 或者，檢查 Claude Code 暫存目錄下您專案的目錄，也就是範例訊息中的 `/private/tmp/claude-501/-Users-you-my-project`。如果該路徑是符號連結，或是不應存在的目錄，請移除該連結或目錄本身，而非連結的目標，然後重新啟動 Claude Code
4373* 如果拒絕重複，程序在工作階段執行時替換、連結或移除 Claude Code 暫存目錄下的項目。將 [`CLAUDE_CODE_TMPDIR`](/docs/zh-TW/env-vars) 設定為沒有其他內容管理的目錄並重新啟動4440* 如果拒絕重複出現，表示有某個程序在工作階段執行期間，替換、連結或移除 Claude Code 暫存目錄下的項目。請將 [`CLAUDE_CODE_TMPDIR`](/docs/zh-TW/env-vars) 設為沒有其他程式管理的目錄，然後重新啟動
4374 4441
4375<h3 id="disk-quota-or-temp-filesystem-is-full">4442<h3 id="disk-quota-or-temp-filesystem-is-full">
4376 磁碟配額或暫存檔案系統已滿4443 Disk quota or temp filesystem is full
4377</h3>4444</h3>
4378 4445
4379Claude Code 將每個 Bash 和 PowerShell 命令的輸出儲存到其暫存目錄下的檔案。當命令以非零代碼退出且完全沒有輸出時，Claude Code 會檢查持有該檔案的檔案系統是否空間不足或 inode 不足，或您在其上的磁碟配額是否已用完。如果是這樣，診斷會出現在命令的結果中，代替空輸出：4446Claude Code 會將每個 Bash 和 PowerShell 命令的輸出儲存到其暫存目錄下的檔案中。當命令以非零代碼結束且完全沒有輸出時，Claude Code 會檢查存放該檔案的檔案系統是否已用盡空間或 inode，或您在其上的磁碟配額是否已用完。若是如此，命令的結果中會以診斷訊息取代空白輸出：
4380 4447
4381```text wrap theme={null}4448```text wrap theme={null}
4382Your disk quota is full on the filesystem with Claude Code's temp directory /private/tmp/claude-501/-Users-you-my-project/1f0e62dc-4b0a-4f5e-9c2d-8a7b6c5d4e3f/tasks (EDQUOT), so any output this command printed was lost, and it may have failed because it could not write. Delete files you no longer need there, or restart Claude Code with CLAUDE_CODE_TMPDIR set to a directory on another filesystem.4449Your disk quota is full on the filesystem with Claude Code's temp directory /private/tmp/claude-501/-Users-you-my-project/1f0e62dc-4b0a-4f5e-9c2d-8a7b6c5d4e3f/tasks (EDQUOT), so any output this command printed was lost, and it may have failed because it could not write. Delete files you no longer need there, or restart Claude Code with CLAUDE_CODE_TMPDIR set to a directory on another filesystem.
4383```4450```
4384 4451
4385訊息命名什麼用完了：4452訊息會指出用盡的資源：
4386 4453
4387* `Your disk quota is full ... (EDQUOT)`：您在該檔案系統上的配額已用完。配額可以在檔案系統仍顯示可用空間時已滿4454* `Your disk quota is full ... (EDQUOT)`：您自己在該檔案系統上的配額已用完。即使檔案系統仍顯示有可用空間，配額也可能已滿
4388* `The filesystem with Claude Code's temp directory ..., or your disk quota on it, is full (ENOSPC)`：檔案系統或您在其上的配額沒有空間剩餘4455* `The filesystem with Claude Code's temp directory ..., or your disk quota on it, is full (ENOSPC)`：檔案系統或您在其上的配額已沒有剩餘空間
4389* `Command output was lost: the temp filesystem at ... is full` 或 `... is out of inodes`：檔案系統幾乎沒有可用空間剩餘，或 inode 即將用完4456* `Command output was lost: the temp filesystem at ... is full` 或 `... is out of inodes`：檔案系統幾乎沒有剩餘的可用空間，或 inode 即將用盡
4390 4457
4391**應該怎麼做：**4458**處理方式：**
4392 4459
4393* 刪除您在持有 Claude Code 暫存目錄的檔案系統上不再需要的檔案。對於 `EDQUOT`，刪除計入您自己配額的檔案。對於 `out of inodes`，刪除許多檔案而不是幾個大檔案，因為每個檔案佔用一個 inode，無論其大小如何4460* 刪除存放 Claude Code 暫存目錄之檔案系統上不再需要的檔案。對於 `EDQUOT`，請刪除計入您自己配額的檔案。對於 `out of inodes`，請刪除大量檔案，而不是少數幾個大型檔案，因為無論大小，每個檔案都會佔用一個 inode
4394* 或使用 [`CLAUDE_CODE_TMPDIR`](/docs/zh-TW/env-vars) 設定為有空間的檔案系統上的目錄重新啟動 Claude Code4461* 或者，將 [`CLAUDE_CODE_TMPDIR`](/docs/zh-TW/env-vars) 設為位於有空間之檔案系統上的目錄，然後重新啟動 Claude Code
4395* 然後讓 Claude 再次執行命令。它列印的輸出已遺失，未被截斷4462* 接著讓 Claude 再次執行該命令。它先前印出的輸出已遺失，而不是被截斷
4396 4463
4397<h3 id="the-source-file-is-not-valid-utf-8-text">4464<h3 id="the-source-file-is-not-valid-utf-8-text">
4398 來源檔案不是有效的 UTF-8 文字4465 The source file is not valid UTF-8 text
4399</h3>4466</h3>
4400 4467
4401Claude 嘗試從其位元組不解碼為文字的檔案發佈[成品](/docs/zh-TW/artifacts)，或其文字已包含替換字元 `U+FFFD`，因此 Claude Code 拒絕發佈，未上傳任何內容。訊息出現在成品工具結果中，並命名要修正的第一個位置：4468Claude 嘗試從一個位元組無法解碼為文字、或其文字已包含替代字元 `U+FFFD` 的檔案發佈 [artifact](/docs/zh-TW/artifacts)，因此 Claude Code 在上傳任何內容之前就拒絕了發佈。訊息會出現在 Artifact 工具結果中，並指出第一個需要修正的位置：
4402 4469
4403```text wrap theme={null}4470```text wrap theme={null}
4404file_path: the source file is not valid UTF-8 text (first invalid byte at line 12, column 40). It may be saved in another encoding or contain binary data. Rewrite it as UTF-8, then publish again. Nothing was published.4471file_path: the source file is not valid UTF-8 text (first invalid byte at line 12, column 40). It may be saved in another encoding or contain binary data. Rewrite it as UTF-8, then publish again. Nothing was published.
4406file_path: the source file has the replacement character U+FFFD at line 12, column 40, usually left where an earlier edit or paste lost a character. Replace it with the intended text (in HTML, write an intended U+FFFD as �), then publish again. Nothing was published.4473file_path: the source file has the replacement character U+FFFD at line 12, column 40, usually left where an earlier edit or paste lost a character. Replace it with the intended text (in HTML, write an intended U+FFFD as �), then publish again. Nothing was published.
4407```4474```
4408 4475
4409Claude Code 將檔案解碼為 UTF-8，或當它以小端 UTF-16 位元組順序標記開始時解碼為 UTF-16。當這樣的 UTF-16 檔案不解碼時，第一個訊息命名 `UTF-16` 並仍然告訴您將檔案重寫為 UTF-8。當更多位置跟隨命名的位置時，訊息在位置後新增計數，例如 `(+2 more)`。4476Claude Code 會將檔案解碼為 UTF-8，若檔案以小端序 UTF-16 位元組順序標記開頭，則解碼為 UTF-16。當這類 UTF-16 檔案無法解碼時，第一則訊息會指出 `UTF-16`，但仍會告知您將檔案重寫為 UTF-8。當指出的位置之後還有更多位置時，訊息會在位置後加上計數，例如 `(+2 more)`。
4410 4477
4411**應該怎麼做：**4478**處理方式：**
4412 4479
4413* 通常無需做任何事：Claude 重寫檔案並再次發佈4480* 通常無需任何動作：Claude 會重寫檔案並再次發佈
4414* 如果檔案是您寫入或匯出的，再次將其儲存為 UTF-8，並將每個 `U+FFFD` 替換為較早的編輯、貼上或轉換遺失的字元4481* 如果該檔案是您撰寫或匯出的，請將其重新儲存為 UTF-8，並將每個 `U+FFFD` 替換為先前的編輯、貼上或轉換所遺失的字元
4415* 若要在頁面上顯示有意的 `U+FFFD`，請在 HTML 中將其寫為 `�` 而不是字面字元4482* 若要在頁面上顯示刻意使用的 `U+FFFD`，請在 HTML 中將其寫成 `�`，而不是使用該字元本身
4416 4483
4417在 v2.1.267 之前，Claude Code 上傳這樣的檔案而不檢查它，伺服器改為拒絕發佈。4484在 v2.1.267 之前，Claude Code 會在未檢查的情況下上傳這類檔案，改由伺服器拒絕發佈。
4418 4485
4419<h3 id="reading-a-local-file-from-outside-the-connected-folders">4486<h3 id="reading-a-local-file-from-outside-the-connected-folders">
4420 在 Cowork 工作階段中從連接的資料夾外讀取本機檔案4487 Reading a local file from outside the connected folders in a Cowork session
4421</h3>4488</h3>
4422 4489
4423在 Claude Desktop 應用程式中在您的機器上執行的 [Cowork](https://claude.com/docs/cowork/overview) 工作階段中，Claude 命名了[成品](/docs/zh-TW/artifacts)的本機檔案。Claude Code 無法確認檔案是工作階段連接資料夾內的純檔案：路徑位於這些資料夾外、通過符號連結或以可能命名不同檔案的方式拼寫。讀取這樣的檔案需要您的核准，在無法向您顯示核准卡的工作階段中，例如設定為跳過所有核准的工作階段，Claude Code 拒絕讀取。4490在 Claude Desktop 應用程式中於您的機器上執行的 [Cowork](https://claude.com/docs/cowork/overview) 工作階段裡，Claude 為 [artifact](/docs/zh-TW/artifacts) 指定了一個本機檔案。Claude Code 無法確認該檔案是位於工作階段已連接資料夾內的一般檔案：該路徑位於這些資料夾之外、經過符號連結，或其寫法可能指向與表面上不同的檔案。讀取這類檔案需要您的核准，而在無法向您顯示核准卡片的工作階段中（例如設定為略過所有核准的工作階段），Claude Code 會拒絕該讀取。
4424 4491
4425拒絕出現在成品工具結果中；當檔案根本無法檢查時，它改為命名該失敗：4492拒絕訊息會出現在 Artifact 工具結果中；當檔案完全無法被檢查時，則會改為指出該失敗：
4426 4493
4427```text wrap theme={null}4494```text wrap theme={null}
4428Reading a local file from outside this session's connected folders, or through a link, needs the approval card, and no one can answer it in this Cowork session. Use a plain file inside the connected folders; do not retry this file in this session.4495Reading a local file from outside this session's connected folders, or through a link, needs the approval card, and no one can answer it in this Cowork session. Use a plain file inside the connected folders; do not retry this file in this session.
4430cannot read file_path (ENOENT) — the file could not be examined, and no one can answer the approval card in this Cowork session. Check that the file exists as a plain file inside the connected folders, then retry with that path.4497cannot read file_path (ENOENT) — the file could not be examined, and no one can answer the approval card in this Cowork session. Check that the file exists as a plain file inside the connected folders, then retry with that path.
4431```4498```
4432 4499
4433**應該怎麼做：**4500**處理方式：**
4434 4501
4435* 通常無需做任何事：訊息告訴 Claude 改為使用連接資料夾內的純檔案4502* 通常無需任何動作：訊息會告知 Claude 改用已連接資料夾內的一般檔案
4436* 若要將該確切檔案放在成品中，將其複製到工作階段的連接資料夾之一中作為常規檔案（不是符號連結），並再次詢問4503* 若要將該檔案原樣放入 artifact，請將其以一般檔案（而非符號連結）的形式複製到工作階段的其中一個已連接資料夾中，然後再次提出要求
4437 4504
4438<h3 id="webfetch-cannot-fetch-localhost">4505<h3 id="webfetch-cannot-fetch-localhost">
4439 WebFetch 無法擷取 localhost4506 WebFetch cannot fetch localhost
4440</h3>4507</h3>
4441 4508
4442Claude 呼叫了 [WebFetch](/docs/zh-TW/tools-reference#webfetch-tool-behavior)，其 URL 的主機名沒有點，例如 `http://localhost:3000` 或裸內部網路名稱如 `http://wiki/`。WebFetch 在進行任何要求之前拒絕這些 URL：4509Claude 使用主機名稱不含點的 URL 呼叫了 [WebFetch](/docs/zh-TW/tools-reference#webfetch-tool-behavior)，例如 `http://localhost:3000` 或像 `http://wiki/` 這樣的純內部網路名稱。WebFetch 會在發出任何請求之前拒絕這些 URL：
4443 4510
4444```text wrap theme={null}4511```text wrap theme={null}
4445WebFetch cannot fetch localhost or other hostnames without a dot. To reach a local server, use Bash with curl instead.4512WebFetch cannot fetch localhost or other hostnames without a dot. To reach a local server, use Bash with curl instead.
4446```4513```
4447 4514
4448**應該怎麼做：**4515**處理方式：**
4516
4517* 通常無需任何動作：訊息會引導 Claude 透過 Bash 工具使用 `curl`，它可以連線至本機與內部網路伺服器
4449 4518
4450* 通常無需做任何事：訊息將 Claude 指向透過 Bash 工具的 `curl`，它可以到達本機和內部網路伺服器4519在 v2.1.268 之前，WebFetch 會以通用的 `Invalid URL` 錯誤回報這些 URL。
4520
4521<h3 id="webfetch-domain-safety-check-failed">
4522 WebFetch domain safety check failed
4523</h3>
4451 4524
4452在 v2.1.268 之前，WebFetch 報告這些 URL 時出現通用 `Invalid URL` 錯誤。4525在擷取 URL 之前，WebFetch 會將 URL 的主機名稱傳送至 `api.anthropic.com`，以對照 Anthropic 的 [網域安全封鎖清單](/docs/zh-TW/data-usage#webfetch-domain-safety-check) 進行檢查。如果檢查無法完成，WebFetch 就無法確認該網域是安全的，因此不會擷取該頁面，工具結果會改為包含下列其中一則訊息：
4526
4527```text wrap theme={null}
4528The safety check for domain example.com is rate-limited (too many domain checks from this network; the limit is shared and can stay exhausted for minutes). Do not retry WebFetch in a loop or sleep to wait it out; continue without this page and report that its safety check was rate-limited. A single later attempt is fine; if that is rate-limited too, stop.
4529
4530Unable to verify if domain example.com is safe to fetch. This may be due to network restrictions or enterprise security policies blocking claude.ai.
4531```
4532
4533* `rate-limited`：檢查端點以 HTTP `429` 回應。訊息會告知 Claude 在沒有該頁面的情況下繼續，且稍後最多只重試一次。Claude Code 不會快取失敗的檢查，因此稍後擷取該網域時會再次執行檢查。如果您網路上的工作階段經常遇到此情況，可以在設定中使用 [`skipWebFetchPreflight: true`](/docs/zh-TW/settings-reference#skipwebfetchpreflight) 略過檢查。
4534* `Unable to verify`：檢查請求失敗、逾時或收到其他錯誤狀態。如果您的網路封鎖了 `api.anthropic.com`，請將該網域加入允許清單，或在設定中使用 [`skipWebFetchPreflight: true`](/docs/zh-TW/settings-reference#skipwebfetchpreflight) 略過檢查。
4535
4536在 v2.1.286 之前，速率限制訊息的內容為 `The safety check for domain example.com is temporarily rate-limited (too many domain checks from this network). Retry after about a minute; retrying sooner will fail the same way.`。
4537在 v2.1.285 之前，受速率限制的檢查會改以 `Unable to verify` 訊息回報。
4453 4538
4454<h2 id="background-session-errors">4539<h2 id="background-session-errors">
4455 背景工作階段錯誤4540 背景工作階段錯誤
4456</h2>4541</h2>
4457 4542
4458[背景工作階段](/docs/zh-TW/agent-view)在沒有互動式終端的情況下執行，因此需要終端的命令在那裡的行為會有所不同。這些訊息會出現在背景工作階段的文字記錄中、附加到背景工作階段的終端中、您分派的工作階段或殼層中，或者對於下面的[worktree-guard 項目](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved)，會出現在任何在 worktree 中隔離或執行 worktree 隔離子代理的工作階段中；當訊息特定於某個表面時，其項目會說明。4543[背景工作階段](/docs/zh-TW/agent-view)在沒有自己的互動式終端機的情況下執行，因此需要終端機的命令在那裡的行為會有所不同。這些訊息會出現在背景工作階段的逐字稿中、附加到背景工作階段的終端機中、您分派的工作階段或 shell 中，或者對於下面的[worktree-guard 項目](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved)，會出現在任何在 worktree 中隔離或執行 worktree 隔離 subagent 的工作階段中；當訊息特定於某個使用介面時，其項目會說明。
4459 4544
4460<h3 id="commands-refused-in-a-background-session">4545<h3 id="commands-refused-in-a-background-session">
4461 在背景工作階段中拒絕的命令4546 在背景工作階段中拒絕的命令
4462</h3>4547</h3>
4463 4548
4464開啟互動式對話框的命令在沒有終端附加到背景工作階段時無法執行。`/install-github-app`、`/mcp` 設定清單和 MCP 伺服器選單中的驗證動作會回應一則訊息。對於 `/install-github-app` 和 `/mcp` 設定清單，工作階段也會在[代理檢視](/docs/zh-TW/agent-view)中的 **Needs input** 下出現，以便您可以找到它、附加並再次執行命令。當終端附加時，這些命令正常運作。4549開啟互動式對話框的命令在沒有終端機附加到背景工作階段時無法執行。`/install-github-app`、`/mcp` 設定清單和 MCP 伺服器選單中的身分驗證動作會回應一則訊息。對於 `/install-github-app` 和 `/mcp` 設定清單，工作階段也會在 [agent 檢視](/docs/zh-TW/agent-view)中的 **Needs input** 下出現，以便您可以找到它、附加並再次執行命令。當終端機附加時，這些命令正常運作。
4465 4550
4466在 v2.1.216 之前，工作階段在 `/install-github-app` 或 `/mcp` 設定清單被拒絕後不會在 **Needs input** 下出現。在 v2.1.213 到 v2.1.215 中，命令在附加終端時仍然有效，拒絕訊息告訴您附加並再次執行命令。從 v2.1.208 到 v2.1.212，Claude Code 即使在附加終端時也拒絕它們，訊息如 `Can't open MCP settings in a background session`；在這些版本上，改為從常規 `claude` 工作階段執行命令，或升級。在 v2.1.208 之前，它們在背景工作階段內開啟其對話框。在 v2.1.208 中，Claude Code 也拒絕了背景工作階段中的 `/model` 選擇器，`/upgrade` 列印升級 URL 而不是開啟瀏覽器。4551在 v2.1.216 之前，工作階段在 `/install-github-app` 或 `/mcp` 設定清單被拒絕後不會在 **Needs input** 下出現。在 v2.1.213 到 v2.1.215 中，命令在附加終端機時仍然有效，拒絕訊息告訴您附加並再次執行命令。從 v2.1.208 到 v2.1.212，Claude Code 即使在附加終端機時也拒絕它們，訊息如 `Can't open MCP settings in a background session`；在這些版本上，改為從一般的 `claude` 工作階段執行命令，或升級。在 v2.1.208 之前，它們在背景工作階段內開啟其對話框。僅在 v2.1.208 中，Claude Code 也拒絕了背景工作階段中的 `/model` 選擇器，且 `/upgrade` 列印升級 URL 而不是開啟瀏覽器。
4467 4552
4468措辭會命名該命令。`/mcp` 設定清單報告：4553措辭會命名該命令。`/mcp` 設定清單報告：
4469 4554
4473 4558
4474**該怎麼做：**4559**該怎麼做：**
4475 4560
4476* 從代理檢視附加到工作階段並再次執行命令4561* 從 agent 檢視附加到工作階段並再次執行命令
4477* 或使用訊息命名的形式，例如 `/mcp reconnect <server>`、`/mcp enable` 或 `/mcp disable`，這些在不附加的情況下有效4562* 或使用訊息命名的形式，例如 `/mcp reconnect <server>`、`/mcp enable` 或 `/mcp disable`，這些在不附加的情況下有效
4478 4563
4479<h3 id="write-or-command-blocked-because-the-path-cannot-be-safely-resolved">4564<h3 id="write-or-command-blocked-because-the-path-cannot-be-safely-resolved">
4480 寫入或命令被阻止，因為路徑無法安全解析4565 寫入或命令被阻止，因為路徑無法安全解析
4481</h3>4566</h3>
4482 4567
4483Claude 透過 [worktree 隔離防護](/docs/zh-TW/agent-view#how-file-edits-are-isolated)無法解析為一個可驗證位置的拼寫來定址檔案或工作目錄。防護檢查[任何在 worktree 中隔離的工作階段](/docs/zh-TW/worktrees#how-claude-code-enforces-isolation)中的寫入和命令工作目錄，互動式或背景，以及[worktree 隔離子代理](/docs/zh-TW/worktrees#isolate-subagents-with-worktrees)中的寫入和命令工作目錄。它在檢查操作不會到達共享簽出之前解析符號連結，當解析失敗時，它會阻止操作而不是讓它落在那裡。訊息命名它拒絕的路徑形式以及如何重試：4568Claude 透過 [worktree 隔離防護](/docs/zh-TW/agent-view#how-file-edits-are-isolated)無法解析為一個可驗證位置的拼寫來定址檔案或工作目錄。防護會檢查[任何在 worktree 中隔離的工作階段](/docs/zh-TW/worktrees#how-claude-code-enforces-isolation)（無論互動式或背景）以及 [worktree 隔離 subagent](/docs/zh-TW/worktrees#isolate-subagents-with-worktrees) 中的寫入和命令工作目錄。它在檢查操作不會到達共享簽出之前解析符號連結，當解析失敗時，它會阻止操作而不是讓它落在那裡。訊息命名它拒絕的路徑形式以及如何重試：
4484 4569
4485```text theme={null}4570```text theme={null}
4486This write was blocked because the path is spelled in a form that cannot be safely resolved (for example through a symlink storing a raw dot segment, a network-share or device-namespace shape, or an unreadable ancestor directory). If the file is inside the worktree /path/to/worktree, address it by its direct symlink-free path instead.4571This write was blocked because the path is spelled in a form that cannot be safely resolved (for example through a symlink storing a raw dot segment, a network-share or device-namespace shape, or an unreadable ancestor directory). If the file is inside the worktree /path/to/worktree, address it by its direct symlink-free path instead.
4490 4575
4491**該怎麼做：**4576**該怎麼做：**
4492 4577
4493* 通常什麼都不做：完整訊息作為工具錯誤傳遞給 Claude，Claude 使用它命名的直接路徑重試。對於被阻止的檔案編輯，對話檢視只顯示簡短的 `Error editing file` 行；完整訊息出現在文字記錄檢視中，您可以使用 `Ctrl+O` 開啟。被阻止的命令在其命令輸出中列印它。4578* 通常什麼都不做：完整訊息作為工具錯誤傳遞給 Claude，Claude 使用它命名的直接路徑重試。對於被阻止的檔案編輯，對話檢視只顯示簡短的 `Error editing file` 行；完整訊息出現在逐字稿檢視中，您可以使用 `Ctrl+O` 開啟。被阻止的命令在其命令輸出中列印它。
4494* 如果同一檔案上的阻止重複，路徑可能透過已提交的符號連結執行，其目標包含 `..`，例如 `docs/current -> ../README.md`；要求 Claude 透過其真實路徑編輯目標檔案，而不是透過連結4579* 如果同一檔案上的阻止重複，路徑可能透過已提交的符號連結執行，其目標包含 `..`，例如 `docs/current -> ../README.md`；要求 Claude 透過其真實路徑編輯目標檔案，而不是透過連結
4495 4580
4496<h3 id="write-or-command-blocked-because-the-path-names-a-network-location">4581<h3 id="write-or-command-blocked-because-the-path-names-a-network-location">
4515 4600
4516Claude 在[在 worktree 中隔離的工作階段](/docs/zh-TW/worktrees#how-claude-code-enforces-isolation)中執行了 Bash 或 Monitor 命令，Claude Code 因以下兩個原因之一拒絕了它：4601Claude 在[在 worktree 中隔離的工作階段](/docs/zh-TW/worktrees#how-claude-code-enforces-isolation)中執行了 Bash 或 Monitor 命令，Claude Code 因以下兩個原因之一拒絕了它：
4517 4602
4518* 命令指向 git 到主簽出。4603* 命令將 git 指向主簽出。
4519* Claude Code 無法從命令文字驗證命令執行的任何 git 保持在 worktree 內。永遠不命名 git 的命令仍然可能因此原因被拒絕，因為展開變數間接參照（例如 `${!name}`）或執行 Bash 函數替換（例如 `${ command; }`）會產生在執行時本身可能是命令的值。4604* Claude Code 無法從命令文字驗證命令執行的任何 git 保持在 worktree 內。從未提及 git 的命令仍然可能因此原因被拒絕，因為展開變數間接參照（例如 `${!name}`）或執行 Bash 函數替換（例如 `${ command; }`）會產生在執行時本身可能是命令的值。
4520 4605
4521訊息的中間命名無法驗證的內容：4606訊息的中間命名無法驗證的內容：
4522 4607
4527**該怎麼做：**4612**該怎麼做：**
4528 4613
4529* 通常什麼都不做：Claude 讀取訊息並按其最後一句要求的方式重寫命令4614* 通常什麼都不做：Claude 讀取訊息並按其最後一句要求的方式重寫命令
4530* 如果您要求的命令持續被拒絕，按字面拼寫標記的值：用其值替換間接參照或替換，並從 worktree 內作為其自己的純命令執行 git4615* 如果您要求的命令持續被拒絕，按字面拼寫標記的值：用其值替換間接參照或替換，並從 worktree 內將 git 作為獨立的純命令執行
4531* 要有目的地作用於主簽出，在工作階段外的終端中自己執行命令4616* 要刻意作用於主簽出，請在工作階段外的終端機中自己執行命令
4532 4617
4533<h3 id="this-session-has-no-saved-transcript">4618<h3 id="this-session-has-no-saved-transcript">
4534 此工作階段沒有已儲存的文字記錄4619 此工作階段沒有已儲存的逐字稿
4535</h3>4620</h3>
4536 4621
4537您附加到已停止的[背景工作階段](/docs/zh-TW/agent-view)，該工作階段使用 `←` 或 `/background` 從另一個對話背景化，並在其第一個回應完成之前停止。在該第一個回應完成之前，對話仍然只存在於背景化它的工作階段中，因此 `claude attach` 拒絕啟動已停止的工作階段，而不是在相同工作階段 ID 下開始空白對話。訊息以此工作階段的 `claude respawn` 命令結尾：4622您附加到已停止的[背景工作階段](/docs/zh-TW/agent-view)，該工作階段使用 `←` 或 `/background` 從另一個對話背景化，並在其第一個回應完成之前停止。在該第一個回應完成之前，對話仍然只存在於背景化它的工作階段中，因此 `claude attach` 拒絕啟動已停止的工作階段，而不是在相同工作階段 ID 下開始空白對話。訊息以此工作階段的 `claude respawn` 命令結尾：
4540This session has no saved transcript — it was stopped before its first response finished. If it was backgrounded from another conversation, that one is still intact; `claude respawn <id>` starts this one fresh.4625This session has no saved transcript — it was stopped before its first response finished. If it was backgrounded from another conversation, that one is still intact; `claude respawn <id>` starts this one fresh.
4541```4626```
4542 4627
4543在[代理檢視](/docs/zh-TW/agent-view)中開啟相同工作階段的列在清單下方顯示 `Press enter again to restart this session fresh`，列上的第二個 `Enter` 使用空白對話重新啟動工作階段。在 v2.1.212 之前，開啟列顯示拒絕訊息，無法從代理檢視重新啟動。在 v2.1.211 之前，開啟已停止的工作階段無聲地啟動該空白對話，並可以重新執行工作階段的原始提示。4628在 [agent 檢視](/docs/zh-TW/agent-view)中開啟相同工作階段的列，會改為在清單下方顯示 `Press enter again to restart this session fresh`，在該列上第二次按 `Enter` 會使用空白對話重新啟動工作階段。在 v2.1.212 之前，開啟列會顯示拒絕訊息，無法從 agent 檢視重新啟動。在 v2.1.211 之前，開啟已停止的工作階段會無聲地啟動該空白對話，並可能重新執行工作階段的原始提示詞。
4544 4629
4545**該怎麼做：**4630**該怎麼做：**
4546 4631
4547* 您背景化的對話完整無缺：使用 [`claude --resume`](/docs/zh-TW/sessions) 繼續它或繼續在其中工作4632* 您背景化的對話完整無缺：使用 [`claude --resume`](/docs/zh-TW/sessions) 繼續它或繼續在其中工作
4548* 要無論如何啟動已停止的工作階段，請使用訊息中的 ID 執行 `claude respawn <id>`，或在代理檢視中的其列上按 `Enter` 兩次4633* 若仍要重新啟動已停止的工作階段，請使用訊息中的 ID 執行 `claude respawn <id>`，或在 agent 檢視中的其列上按 `Enter` 兩次
4549* 如果工作階段確實完成了回應，您仍在 v2.1.214 之前的版本上看到此拒絕，`~/.claude/projects` 中的不可讀資料夾可能會使文字記錄掃描遺漏已儲存的對話；更新到 v2.1.214 或更新版本，其在掃描期間容許不可讀資料夾4634* 如果工作階段確實完成了回應，而您在 v2.1.214 之前的版本上仍看到此拒絕，`~/.claude/projects` 中的不可讀資料夾可能會使逐字稿掃描遺漏已儲存的對話；請更新到 v2.1.214 或更新版本，其在掃描期間容許不可讀資料夾
4550 4635
4551<h3 id="this-session-is-running-in-another-terminal">4636<h3 id="this-session-is-running-in-another-terminal">
4552 此工作階段在另一個終端中執行4637 此工作階段在另一個終端機中執行
4553</h3>4638</h3>
4554 4639
4555您在[代理檢視](/docs/zh-TW/agent-view)中開啟了已停止工作階段的列，其已儲存的對話已在此機器上的另一個即時 Claude Code 程序中開啟，因此 Claude Code 拒絕啟動將寫入相同文字記錄的第二個程序。您看到的訊息取決於[什麼保持對話](/docs/zh-TW/agent-view#opening-a-session-says-the-conversation-is-already-open)：4640您在 [agent 檢視](/docs/zh-TW/agent-view)中開啟了已停止工作階段的列，而其已儲存的對話已在此機器上的另一個執行中 Claude Code 程序中開啟，因此 Claude Code 拒絕啟動將寫入相同逐字稿的第二個程序。您看到的訊息取決於[持有該對話的是什麼](/docs/zh-TW/agent-view#opening-a-session-says-the-conversation-is-already-open)：
4556 4641
4557```text theme={null}4642```text theme={null}
4558Can't open — this session is running in another terminal4643Can't open — this session is running in another terminal
4559This conversation is already open in another running Claude session — use that one, or close it and try again4644This conversation is already open in another running Claude session — use that one, or close it and try again
4560```4645```
4561 4646
4562* **`running in another terminal`**：終端保持對話，例如您使用 `claude --resume` 或 `/resume` 繼續它的終端。列也顯示 `Open in a terminal`。4647* **`running in another terminal`**：終端機持有該對話，例如您使用 `claude --resume` 或 `/resume` 繼續它的終端機。列也會顯示 `Open in a terminal`。
4563* **`already open in another running Claude session`**：另一個非互動式 Claude Code 程序保持它，例如相同對話的[背景工作階段](/docs/zh-TW/agent-view#the-supervisor-process)程序，尚未退出。4648* **`already open in another running Claude session`**：另一個非互動式 Claude Code 程序持有它，例如相同對話中尚未退出的[背景工作階段](/docs/zh-TW/agent-view#the-supervisor-process)程序。
4564 4649
4565Claude Code 儲存您在開啟列時輸入的回覆，並在工作階段下次啟動時將其作為工作階段的下一個提示傳送。4650Claude Code 會儲存您在開啟列時輸入的回覆，並在工作階段下次啟動時將其作為工作階段的下一個提示詞傳送。
4566 4651
4567**該怎麼做：**4652**該怎麼做：**
4568 4653
4569* 在保持它開啟的程序中繼續對話，或退出該程序並再次開啟列4654* 在開啟該對話的程序中繼續對話，或退出該程序並再次開啟列
4570 4655
4571在 v2.1.248 之前，只有 `already open in another running Claude session` 拒絕存在：在終端中繼續的對話不計為開啟，開啟列啟動寫入相同對話的第二個 Claude Code 程序。4656在 v2.1.248 之前，只有 `already open in another running Claude session` 拒絕存在：在終端機中繼續的對話不計為開啟，開啟列會啟動寫入相同對話的第二個 Claude Code 程序。
4572 4657
4573<h3 id="this-sessions-saved-conversation-is-no-longer-on-disk">4658<h3 id="this-sessions-saved-conversation-is-no-longer-on-disk">
4574 此工作階段的已儲存對話不再在磁碟上4659 此工作階段的已儲存對話不再在磁碟上
4575</h3>4660</h3>
4576 4661
4577您開啟了在背景服務關閉時結束的[背景工作階段](/docs/zh-TW/agent-view)，[文字記錄清理](/docs/zh-TW/settings-reference#cleanupperioddays)已移除其已儲存的對話，例如在機器關閉數週後。通常開啟這樣的列會[繼續其已儲存的對話](/docs/zh-TW/agent-view#sessions-show-as-failed-after-shutdown)。沒有什麼可繼續，Claude Code 拒絕而不是在不詢問的情況下重新執行工作階段的原始提示：4662您開啟了在背景服務關閉時結束的[背景工作階段](/docs/zh-TW/agent-view)，而[逐字稿清理](/docs/zh-TW/settings-reference#cleanupperioddays)已移除其已儲存的對話，例如在機器關閉數週後。通常開啟這樣的列會[繼續其已儲存的對話](/docs/zh-TW/agent-view#sessions-show-as-failed-after-shutdown)。由於沒有可繼續的內容，Claude Code 會拒絕，而不是在不詢問的情況下重新執行工作階段的原始提示詞：
4578 4663
4579```text theme={null}4664```text theme={null}
4580This session's saved conversation is no longer on disk (it ended while the background service was off, and old transcripts are cleaned up), so there is nothing to resume. `claude rm 7c5dcf5d` deletes the row; `claude respawn 7c5dcf5d` runs its original prompt again instead.4665This session's saved conversation is no longer on disk (it ended while the background service was off, and old transcripts are cleaned up), so there is nothing to resume. `claude rm 7c5dcf5d` deletes the row; `claude respawn 7c5dcf5d` runs its original prompt again instead.
4581```4666```
4582 4667
4583`claude attach <id>` 列印此文字。在代理檢視中，頁腳較短，以 `ctrl+x deletes the row` 結尾。4668`claude attach <id>` 列印此文字。在 agent 檢視中，頁腳較短，以 `ctrl+x deletes the row` 結尾。
4584 4669
4585**該怎麼做：**4670**該怎麼做：**
4586 4671
4587* 執行 `claude rm <id>` 刪除列。當其中一個[保留案例](/docs/zh-TW/agent-view#what-deleting-a-session-removes)適用時，`claude rm` 保留列和 worktree，並命名原因4672* 執行 `claude rm <id>` 刪除列。當其中一個[保留案例](/docs/zh-TW/agent-view#what-deleting-a-session-removes)適用時，`claude rm` 會改為保留列和 worktree，並說明原因
4588* 要再次執行工作階段的原始提示作為新對話，請執行 `claude respawn <id>`4673* 要將工作階段的原始提示詞作為新對話再次執行，請執行 `claude respawn <id>`
4589 4674
4590在 v2.1.248 之前，開啟這樣的列會重新執行工作階段的原始提示，而不是拒絕，將數週前的任務拉回前景。4675在 v2.1.248 之前，開啟這樣的列會重新執行工作階段的原始提示詞，而不是拒絕，將數週前的任務拉回前景。
4591 4676
4592<h3 id="worktree-has-commits-that-are-not-pushed-anywhere">4677<h3 id="worktree-has-commits-that-are-not-pushed-anywhere">
4593 Worktree 有未推送到任何地方的提交4678 Worktree 有未推送到任何地方的提交
4594</h3>4679</h3>
4595 4680
4596您嘗試刪除[背景工作階段](/docs/zh-TW/agent-view#what-deleting-a-session-removes)，其 worktree 保持 Claude Code 無法確認在其他地方儲存的提交。Claude Code 保留 worktree 和工作階段列，而不是銷毀提交。`claude rm` 命名分支和未推送的提交，並說明如何進行：4681您嘗試刪除[背景工作階段](/docs/zh-TW/agent-view#what-deleting-a-session-removes)，其 worktree 包含 Claude Code 無法確認已在其他地方儲存的提交。Claude Code 保留 worktree 和工作階段列，而不是在您未察覺的情況下銷毀提交。`claude rm` 命名分支和未推送的提交，並說明如何進行：
4597 4682
4598```text theme={null}4683```text theme={null}
4599kept 7c5dcf5d — its worktree is still at "/home/you/project/.claude/worktrees/fix-login"4684kept 7c5dcf5d — its worktree is still at “/home/you/project/.claude/worktrees/fix-login”
4600 2 unpushed commits on "claude/fix-login": a1b2c3d "Fix login flow" and 1 more. They exist on no remote, so deleting the worktree would lose them.4685 2 unpushed commits on “claude/fix-login”: a1b2c3d “Fix login flow” and 1 more. They exist on no remote, so deleting the worktree would lose them.
4601 push them and run 'claude rm 7c5dcf5d' again, or discard the worktree and its commits: claude rm 7c5dcf5d --discard-unpushed a1b2c3d000000000000000000000000000000000@0123456789abcdef0123456789abcdef4686 push them and run 'claude rm 7c5dcf5d' again, or discard the worktree and its commits: claude rm 7c5dcf5d --discard-unpushed a1b2c3d000000000000000000000000000000000@0123456789abcdef0123456789abcdef
4602```4687```
4603 4688
4604當 Claude Code 無法總結提交時，詳細行讀取 `The worktree has unpushed commits`。在[代理檢視](/docs/zh-TW/agent-view)中，工作階段的列顯示 `not deleted`，原因相同。4689當 Claude Code 無法總結提交時，詳細行改為顯示 `The worktree has unpushed commits`。在 [agent 檢視](/docs/zh-TW/agent-view)中，工作階段的列顯示 `not deleted`，原因相同。
4605 4690
4606遠端上的提交不會阻止刪除。本機複製您的 `origin` 遠端預設分支上的提交也不會，只要該分支在您的主簽出中簽出，即儲存庫目錄本身而不是 worktree。4691遠端上的提交不會阻止刪除。您的 `origin` 遠端預設分支的本機副本上的提交也不會，只要該分支在您的主簽出（即儲存庫目錄本身而不是 worktree）中簽出。
4607 4692
4608**該怎麼做：**4693**該怎麼做：**
4609 4694
4610* 要保留提交，推送 worktree 的分支，或將其合併到在主簽出中簽出的預設分支，然後再次刪除工作階段4695* 要保留提交，推送 worktree 的分支，或將其合併到在主簽出中簽出的預設分支，然後再次刪除工作階段
4611* 要捨棄提交，執行訊息列印的 `claude rm <id> --discard-unpushed` 命令，或在代理檢視中的工作階段列上再次按 `Ctrl+X` 兩次。這會移除工作階段和 worktree 以及其分支、未推送的提交和任何未提交的變更。如果 worktree 自拒絕以來獲得了提交，Claude Code 再次保留它並顯示更新的狀態4696* 要捨棄提交，執行訊息列印的 `claude rm <id> --discard-unpushed` 命令，或在 agent 檢視中的工作階段列上再次按 `Ctrl+X` 兩次。這會移除工作階段和 worktree 以及其分支、未推送的提交和任何未提交的變更。如果 worktree 自拒絕以來新增了提交，Claude Code 會再次保留它並顯示更新的狀態
4612* 當訊息說 worktree 也由另一個已完成的工作階段記錄時，再次刪除不會捨棄它：推送提交，然後再次刪除工作階段4697* 當訊息說 worktree 也由另一個已完成的工作階段記錄時，再次刪除不會捨棄它：推送提交，然後再次刪除工作階段
4613 4698
4614在 v2.1.268 之前，`claude rm` 將提交摘要放在 `kept` 行本身上。當 `claude rm` 無法總結提交時，`kept` 行讀取 `worktree has commits that are not pushed anywhere` 代替摘要。4699在 v2.1.268 之前，`claude rm` 將提交摘要放在 `kept` 行本身上。當 `claude rm` 無法總結提交時，`kept` 行會以 `worktree has commits that are not pushed anywhere` 代替摘要。
4615 4700
4616在 v2.1.260 之前，訊息未命名分支或提交，再次刪除被拒絕的方式相同：刪除工作階段而不推送意味著使用 `git worktree remove --force <path>` 自己移除 worktree，然後再次執行 `claude rm <id>`。4701在 v2.1.260 之前，訊息未命名分支或提交，再次刪除也會以相同方式被拒絕：不推送而刪除工作階段意味著您必須使用 `git worktree remove --force <path>` 自己移除 worktree，然後再次執行 `claude rm <id>`。
4617 4702
4618在 v2.1.248 之前，在主簽出中簽出的預設分支不計算：您已經合併到那裡的分支仍然觸發此拒絕，直到其提交到達遠端。4703在 v2.1.248 之前，在主簽出中簽出的預設分支不計算在內：您已經合併到那裡的分支仍然會觸發此拒絕，直到其提交到達遠端。
4619 4704
4620<h3 id="terminal-host-process-died">4705<h3 id="terminal-host-process-died">
4621 終端主機程序已死亡4706 終端機主機程序已死亡
4622</h3>4707</h3>
4623 4708
4624每個[背景工作階段的](/docs/zh-TW/agent-view)終端在背景服務下的主機程序中執行，該程序在服務仍保持其連線時死亡，因此無法到達工作階段。4709每個[背景工作階段的](/docs/zh-TW/agent-view)終端機在背景服務下的主機程序中執行，該程序在服務仍保持其連線時死亡，因此無法連線到工作階段。
4625 4710
4626在 Linux 和 WSL 上，背景服務每隔幾秒檢查每個主機程序，當程序已退出但其與服務的連線從未關閉時標記工作階段失敗，並在[代理檢視](/docs/zh-TW/agent-view#read-session-state)中的其列上顯示原因：4711在 Linux 和 WSL 上，背景服務每隔幾秒檢查每個主機程序，當程序已退出但其與服務的連線從未關閉時，將工作階段標記為失敗，並在 [agent 檢視](/docs/zh-TW/agent-view#read-session-state)中的其列上顯示原因：
4627 4712
4628```text theme={null}4713```text theme={null}
4629terminal host process died — press Enter to restart4714terminal host process died — press Enter to restart
4630```4715```
4631 4716
4632從殼層，`claude attach <id>` 重新啟動已標記為死主機失敗的工作階段，否則列印原因並退出：4717從 shell，`claude attach <id>` 會重新啟動已因主機死亡而標記為失敗的工作階段，否則列印原因並退出：
4633 4718
4634```text theme={null}4719```text theme={null}
4635Couldn't attach to <id> — This session's terminal host process died (the conversation is saved) — run `claude attach <id>` again to restart it on a fresh host.4720Couldn't attach to <id> — This session's terminal host process died (the conversation is saved) — run `claude attach <id>` again to restart it on a fresh host.
4636```4721```
4637 4722
4638無論如何對話都會儲存。4723無論哪種情況，對話都會儲存。
4639 4724
4640執行[殼層命令](/docs/zh-TW/agent-view#run-a-shell-command)的列改為顯示 `terminal host process died — its output is gone; the command was not run again`，`claude attach` 列印 `This command's terminal host process died — its output is gone and the command was not run again`。Claude Code 永遠不會為您重新執行命令。4725執行 [shell 命令](/docs/zh-TW/agent-view#run-a-shell-command)的列改為顯示 `terminal host process died — its output is gone; the command was not run again`，`claude attach` 列印 `This command's terminal host process died — its output is gone and the command was not run again`。Claude Code 永遠不會為您重新執行命令。
4641 4726
4642**該怎麼做：**4727**該怎麼做：**
4643 4728
4644* 在代理檢視中，在失敗的列上按 `Enter`；工作階段在新主機程序上重新啟動，對話繼續4729* 在 agent 檢視中，在失敗的列上按 `Enter`；工作階段在新主機程序上重新啟動，對話繼續
4645* 從殼層，再次執行 `claude attach <id>`。Claude Code 列印 `Session <id>'s terminal host died — restarting it on a fresh one…` 並重新開啟工作階段4730* 從 shell，再次執行 `claude attach <id>`。Claude Code 列印 `Session <id>'s terminal host died — restarting it on a fresh one…` 並重新開啟工作階段
4646* 您無法以這種方式重新啟動殼層命令列；再次分派命令以重新執行它4731* 您無法以這種方式重新啟動 shell 命令列；再次分派命令以重新執行它
4647 4732
4648在 v2.1.247 之前，死主機程序可能通過背景服務執行的每個活躍性檢查，因此開啟工作階段無限期地顯示 `opening… · esc to cancel`，`claude attach <id>` 等待而不報告錯誤。4733在 v2.1.247 之前，已死亡的主機程序可能通過背景服務執行的每個活躍性檢查，因此開啟工作階段會無限期地顯示 `opening… · esc to cancel`，而 `claude attach <id>` 會等待而不報告錯誤。
4649 4734
4650<h3 id="session-isnt-responding">4735<h3 id="session-isnt-responding">
4651 工作階段沒有回應4736 工作階段沒有回應
4652</h3>4737</h3>
4653 4738
4654您開啟了[背景工作階段](/docs/zh-TW/agent-view)，背景服務接受了開啟，但約十秒內沒有輸出到達，因此 Claude Code 得出結論，中繼工作階段終端的程序無法傳遞輸出，並結束嘗試而不是等待。4739您開啟了[背景工作階段](/docs/zh-TW/agent-view)，背景服務接受了開啟，但約十秒內沒有輸出到達，因此 Claude Code 判定中繼工作階段終端機的程序無法傳遞輸出，並結束嘗試而不是繼續等待。
4655 4740
4656在代理檢視中，Claude Code 在頁腳中提供重新啟動：4741在 agent 檢視中，Claude Code 在頁腳中提供重新啟動：
4657 4742
4658```text theme={null}4743```text theme={null}
4659Press enter again to restart this session — it isn't responding (its conversation is saved and resumes).4744Press enter again to restart this session — it isn't responding (its conversation is saved and resumes).
4660```4745```
4661 4746
4662從殼層，`claude attach <id>` 列印原因並退出：4747從 shell，`claude attach <id>` 列印原因並退出：
4663 4748
4664```text theme={null}4749```text theme={null}
4665Couldn't attach to <id> — Session isn't responding — `claude stop <id>`, then `claude attach <id>` restarts it (the conversation is saved).4750Couldn't attach to <id> — Session isn't responding — `claude stop <id>`, then `claude attach <id>` restarts it (the conversation is saved).
4666```4751```
4667 4752
4668Claude Code 永遠不會為您重新啟動執行[殼層命令](/docs/zh-TW/agent-view#run-a-shell-command)的列，因為重新啟動會再次執行命令。4753Claude Code 永遠不會為您重新啟動執行 [shell 命令](/docs/zh-TW/agent-view#run-a-shell-command)的列，因為重新啟動會再次執行命令。
4669 4754
4670**該怎麼做：**4755**該怎麼做：**
4671 4756
4672* 在代理檢視中，在相同列上再次按 `Enter`。Claude Code 停止無回應的程序並重新啟動工作階段，對話繼續。沒有第二次按下，什麼都不會停止4757* 在 agent 檢視中，在相同列上再次按 `Enter`。Claude Code 停止無回應的程序並重新啟動工作階段，對話繼續。沒有第二次按下，什麼都不會停止
4673* 從殼層，執行 `claude stop <id>`，然後 `claude attach <id>`4758* 從 shell，執行 `claude stop <id>`，然後 `claude attach <id>`
4674* 對於殼層命令列，在代理檢視中按 `Ctrl+X` 或執行 `claude stop <id>` 停止它；再次分派命令以重新執行它4759* 對於 shell 命令列，在 agent 檢視中按 `Ctrl+X` 或執行 `claude stop <id>` 停止它；再次分派命令以重新執行它
4675 4760
4676<h3 id="session-was-stopped-while-the-respawn-was-in-flight">4761<h3 id="session-was-stopped-while-the-respawn-was-in-flight">
4677 工作階段在重新生成進行中時被停止4762 工作階段在重新生成進行中時被停止
4678</h3>4763</h3>
4679 4764
4680您開啟了[背景工作階段](/docs/zh-TW/agent-view)，其程序未執行，當 Claude Code 重新啟動它時，另一個 Claude Code 程序停止了它，例如在另一個終端中的 `claude stop`。Claude Code 保持工作階段停止：4765您開啟了[背景工作階段](/docs/zh-TW/agent-view)，其程序未執行，而當 Claude Code 重新啟動它時，另一個 Claude Code 程序停止了它，例如在另一個終端機中的 `claude stop`。Claude Code 保持工作階段停止：
4681 4766
4682```text theme={null}4767```text theme={null}
4683Session <id> was stopped while the respawn was in flight4768Session <id> was stopped while the respawn was in flight
4684```4769```
4685 4770
4686開啟您剛分派的工作階段，當其程序仍在啟動時，等待程序。在 v2.1.246 之前，在那一刻開啟它可能會停止它並顯示此訊息。4771開啟您剛分派、其程序仍在啟動中的工作階段時，會改為等待該程序。在 v2.1.246 之前，在那一刻開啟它可能會停止它並顯示此訊息。
4687 4772
4688**該怎麼做：**4773**該怎麼做：**
4689 4774
4690* 如果您沒有停止工作階段，在代理檢視中再次開啟其列或執行 `claude respawn <id>` 重新啟動它4775* 如果您沒有停止工作階段，在 agent 檢視中再次開啟其列或執行 `claude respawn <id>` 重新啟動它
4691* 如果您自己停止了它，沒有什麼剩下要做的：工作階段保持停止4776* 如果您自己停止了它，就不需要再做任何事：工作階段保持停止
4692 4777
4693<h3 id="session-agent-no-longer-available">4778<h3 id="session-agent-no-longer-available">
4694 工作階段代理不再可用4779 工作階段 agent 不再可用
4695</h3>4780</h3>
4696 4781
4697您繼續了執行[自訂代理](/docs/zh-TW/sub-agents#invoke-subagents-explicitly)的工作階段，使用 `--agent` 或 `agent` 設定啟動，Claude Code 未找到該名稱的代理。它首先搜索工作階段的原始目錄，當您[信任該工作區](/docs/zh-TW/permissions#project-allow-rules-and-workspace-trust)時，然後搜索您繼續的目錄。工作階段仍然繼續，但使用預設工具，因此代理的工具限制不再適用：4782您繼續了一個執行[自訂 agent](/docs/zh-TW/sub-agents#invoke-subagents-explicitly) 的工作階段（使用 `--agent` 或 `agent` 設定啟動），而 Claude Code 未找到該名稱的 agent。當您已[信任該工作區](/docs/zh-TW/permissions#project-allow-rules-and-workspace-trust)時，它會先搜尋工作階段的原始目錄，然後搜尋您繼續時所在的目錄。工作階段仍然會繼續，但使用預設工具，因此 agent 的工具限制不再適用：
4698 4783
4699```text theme={null}4784```text theme={null}
4700This session was running agent 'code-reviewer', which is no longer available (no agent by that name in /home/you/project). Continuing with the default tools and system prompt — the agent's tool restrictions no longer apply. To restore it, re-create the agent, or resume with an explicit --agent <name>.4785This session was running agent 'code-reviewer', which is no longer available (no agent by that name in /home/you/project). Continuing with the default tools and system prompt — the agent's tool restrictions no longer apply. To restore it, re-create the agent, or resume with an explicit --agent <name>.
4701```4786```
4702 4787
4703訊息只命名 Claude Code 搜索的目錄，無論您喚醒[背景工作階段](/docs/zh-TW/agent-view)、執行 `/resume` 或 `claude --resume`，還是在[非互動模式](/docs/zh-TW/headless)中繼續，它都會出現在繼續的對話中，它也會進入 stderr。使用 `--input-format stream-json` 的工作階段不顯示它，因為 Agent SDK 在啟動後提供代理。4788警告只列出 Claude Code 搜尋過的目錄，無論您是喚醒[背景工作階段](/docs/zh-TW/agent-view)、執行 `/resume` 或 `claude --resume`，還是在[非互動模式](/docs/zh-TW/headless)中繼續，它都會出現在繼續的對話中；在非互動模式中它也會輸出到 stderr。使用 `--input-format stream-json` 的工作階段不會顯示它，因為 Agent SDK 在啟動後才提供 agent。
4704 4789
4705Claude Code 不會將回退儲存到工作階段，因此警告在每次繼續時重複，直到您採取行動。內建 `claude` 代理不觸發警告，因為回退到預設工具集對它沒有變化。在 v2.1.216 之前，Claude Code 無聲地繼續作為預設代理，查詢僅涵蓋您繼續的目錄，因此專案範圍的代理在從另一個目錄繼續時丟失。4790Claude Code 不會將此備援儲存到工作階段，因此警告會在每次繼續時重複出現，直到您採取行動。內建 `claude` agent 不會觸發警告，因為改用預設工具集對它沒有任何變化。在 v2.1.216 之前，Claude Code 會無聲地以預設 agent 繼續，且查詢僅涵蓋您繼續時所在的目錄，因此從另一個目錄繼續時，專案範圍的 agent 就會遺失。
4706 4791
4707**該怎麼做：**4792**該怎麼做：**
4708 4793
4709* 在工作階段的專案中的 `.claude/agents/<name>.md` 或個人代理的 `~/.claude/agents/<name>.md` 重新建立代理檔案，然後再次繼續4794* 在工作階段專案中的 `.claude/agents/<name>.md`，或針對個人 agent 在 `~/.claude/agents/<name>.md` 重新建立 agent 檔案，然後再次繼續
4710* 或使用 `--agent <name>` 繼續，命名確實存在的代理，以改為作為該代理執行工作階段4795* 或使用 `--agent <name>` 繼續，指定確實存在的 agent，以改為作為該 agent 執行工作階段
4711* 如果代理是專案範圍的，您尚未信任工作階段的原始目錄，請在那裡執行 Claude Code 一次，接受信任對話，然後再次繼續4796* 如果 agent 是專案範圍的，而您尚未信任工作階段的原始目錄，請在那裡執行 Claude Code 一次，接受信任對話框，然後再次繼續
4712 4797
4713<h3 id="claude_code_process_wrapper-launcher-errors">4798<h3 id="claude_code_process_wrapper-launcher-errors">
4714 CLAUDE\_CODE\_PROCESS\_WRAPPER 啟動器錯誤4799 CLAUDE\_CODE\_PROCESS\_WRAPPER 啟動器錯誤
4715</h3>4800</h3>
4716 4801
4717[`CLAUDE_CODE_PROCESS_WRAPPER`](/docs/zh-TW/corporate-launcher)已設定，其值無法使用，因此 Claude Code 拒絕啟動受影響的程序，而不是在沒有啟動器的情況下執行它。配置問題報告為以變數名稱開頭並說明原因的訊息，例如：4802[`CLAUDE_CODE_PROCESS_WRAPPER`](/docs/zh-TW/corporate-launcher) 已設定，但其值無法使用，因此 Claude Code 拒絕啟動受影響的程序，而不是在沒有啟動器的情況下執行它。設定問題會以變數名稱開頭並說明原因的訊息報告，例如：
4718 4803
4719```text theme={null}4804```text theme={null}
4720CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file4805CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file
4721```4806```
4722 4807
4723啟動但在不用 Claude Code 替換自己的情況下退出的啟動器會使其啟動的工作階段失敗，工作階段在代理檢視中的列報告啟動器 `must exec, not daemonize`，後跟啟動器列印的任何內容。無法啟動或到達背景服務的工作階段因啟動器報告啟動器問題作為 `Couldn't reach the background service (...)` 內的原因。4808啟動後未以 Claude Code 替換自己就退出的啟動器，會使其正在啟動的工作階段失敗，該工作階段在 agent 檢視中的列會報告啟動器 `must exec, not daemonize`，後接啟動器列印的任何內容。因啟動器而無法啟動或無法連線到背景服務的工作階段，會將啟動器問題作為 `Couldn't reach the background service (...)` 內的原因報告。
4724 4809
4725**該怎麼做：**4810**該怎麼做：**
4726 4811
4727* 將變數設定為以呼叫 `exec "$@"` 結尾的可執行檔的絕對路徑。有關完整合約，請參閱[啟動器合約](/docs/zh-TW/corporate-launcher#the-launcher-contract)4812* 將變數設定為以呼叫 `exec "$@"` 結尾的可執行檔的絕對路徑。有關完整合約，請參閱[啟動器合約](/docs/zh-TW/corporate-launcher#the-launcher-contract)
4728* 檢查 `/status`，其在 Self-exec 項中顯示已解析的啟動命令，並在執行中的背景服務不符合時警告，或從殼層執行 `claude daemon status`4813* 檢查 `/status`，其在 Self-exec 項目中顯示已解析的啟動命令，並在執行中的背景服務不符合時發出警告，或從 shell 執行 `claude daemon status`
4729* 在[設定](/docs/zh-TW/corporate-launcher#set-up-the-launcher)的 `env` 區塊中修復值後，使用 `claude daemon stop --any` 重新啟動背景服務，以便下次分派啟動包裝的服務4814* 在[設定](/docs/zh-TW/corporate-launcher#set-up-the-launcher)的 `env` 區塊中修正值後，使用 `claude daemon stop --any` 重新啟動背景服務，以便下次分派時啟動經過包裝的服務
4730 4815
4731<h3 id="eunknown-when-starting-a-background-session">4816<h3 id="eunknown-when-starting-a-background-session">
4732 啟動背景工作階段時 EUNKNOWN4817 啟動背景工作階段時 EUNKNOWN
4733</h3>4818</h3>
4734 4819
4735Windows 拒絕使用沒有標準名稱的錯誤代碼啟動程式，因此失敗表現為 `EUNKNOWN`。通常的觸發器是軟體限制原則，例如群組原則或 AppLocker，阻止正在啟動的程式。當您使用 `/background` 或 `claude --bg` 啟動[背景工作階段](/docs/zh-TW/agent-view)時，錯誤出現：4820Windows 以沒有標準名稱的錯誤代碼拒絕啟動程式，因此失敗表現為 `EUNKNOWN`。通常的觸發原因是軟體限制原則（例如群組原則或 AppLocker）阻止正在啟動的程式。當您使用 `/background` 或 `claude --bg` 啟動[背景工作階段](/docs/zh-TW/agent-view)時，會出現此錯誤：
4736 4821
4737```text theme={null}4822```text theme={null}
4738Couldn't reach the background service (spawn background service: EUNKNOWN: unknown error, uv_spawn) — run 'claude daemon status'4823Couldn't reach the background service (spawn background service: EUNKNOWN: unknown error, uv_spawn) — run 'claude daemon status'
4739```4824```
4740 4825
4741在某些帳戶上，訊息在 `daemon` 位置說 `background service`。4826在某些帳戶上，訊息會以 `daemon` 取代 `background service`。
4742 4827
4743在 npm 安裝上，在 `npm install -g @anthropic-ai/claude-code` 替換二進位檔案時出現的 `EUNKNOWN` 與[重新安裝期間的 `EACCES`](#eacces-when-starting-a-background-session)有相同的原因，並在您在安裝完成後重試時清除。4828在 npm 安裝上，在 `npm install -g @anthropic-ai/claude-code` 替換二進位檔案時出現的 `EUNKNOWN` 與[重新安裝期間的 `EACCES`](#eacces-when-starting-a-background-session) 有相同的原因，並會在安裝完成後重試時消除。
4744 4829
4745Claude Code 透過 PowerShell 啟動背景服務，以便服務在關閉終端時存活，在安裝時使用 PowerShell 7，否則使用 Windows PowerShell 5.1。當兩個 PowerShell 都無法執行時，Claude Code 改為直接啟動服務，因此只阻止 PowerShell 的原則不會導致此錯誤。4830Claude Code 透過 PowerShell 啟動背景服務，以便服務在關閉終端機後仍能存活；已安裝 PowerShell 7 時使用它，否則使用 Windows PowerShell 5.1。當兩個 PowerShell 都無法執行時，Claude Code 改為直接啟動服務，因此只阻止 PowerShell 的原則不會導致此錯誤。
4746 4831
4747在 v2.1.212 之前，Claude Code 僅使用 Windows PowerShell 5.1 啟動服務，因此任何群組原則阻止 PowerShell 5.1 的機器失敗，訊息為 `Couldn't start the session — EUNKNOWN: unknown error, uv_spawn`，即使安裝了 PowerShell 7。4832在 v2.1.212 之前，Claude Code 僅使用 Windows PowerShell 5.1 啟動服務，因此任何群組原則阻止 PowerShell 5.1 的機器都會失敗，訊息為 `Couldn't start the session — EUNKNOWN: unknown error, uv_spawn`，即使已安裝 PowerShell 7 也是如此。
4748 4833
4749**該怎麼做：**4834**該怎麼做：**
4750 4835
4751* 如果訊息讀取 `Couldn't start the session`，升級到 v2.1.212 或更新版本。在較早的版本上，您也可以在單獨的終端中首先執行 `claude daemon run`，然後再次啟動背景工作階段。該命令在終端的前景中執行背景服務，因此服務僅在該終端保持開啟時持續。4836* 如果訊息顯示 `Couldn't start the session`，請升級到 v2.1.212 或更新版本。在較早的版本上，您也可以先在另一個終端機中執行 `claude daemon run`，然後再次啟動背景工作階段。該命令在終端機的前景中執行背景服務，因此服務僅在該終端機保持開啟時持續運作。
4752* 如果 npm 安裝正在替換二進位檔案，等待它完成，然後再次啟動背景工作階段4837* 如果 npm 安裝正在替換二進位檔案，請等待它完成，然後再次啟動背景工作階段
4753* 如果錯誤在 v2.1.212 或更新版本上出現，沒有 npm 安裝執行，請要求您的 Windows 管理員在限制原則中允許 Claude Code 可執行檔4838* 如果錯誤在 v2.1.212 或更新版本上出現，且沒有 npm 安裝正在執行，請向您的 Windows 管理員確認是否有限制原則阻止 Claude Code 可執行檔
4754* 如果關閉終端時背景服務停止，Claude Code 在沒有 PowerShell 的情況下啟動它。安裝 PowerShell 7，或要求您的管理員解除阻止 PowerShell，以便服務可以超越終端。4839* 如果關閉終端機時背景服務停止，表示 Claude Code 是在沒有 PowerShell 的情況下啟動它的。請安裝 PowerShell 7，或要求您的管理員解除對 PowerShell 的阻止，以便服務可以在終端機關閉後繼續運作。
4755 4840
4756<h3 id="eacces-when-starting-a-background-session">4841<h3 id="eacces-when-starting-a-background-session">
4757 啟動背景工作階段時 EACCES4842 啟動背景工作階段時 EACCES
4758</h3>4843</h3>
4759 4844
4760Claude Code 無法執行其自己的二進位檔案來啟動[背景服務](/docs/zh-TW/agent-view#the-supervisor-process)，該服務託管背景工作階段。在 npm 安裝上，這通常意味著 `npm install -g @anthropic-ai/claude-code` 在那一刻替換二進位檔案，無論您執行它還是[自動更新程式](/docs/zh-TW/setup#auto-updates)執行。當您從[代理檢視](/docs/zh-TW/agent-view)開啟工作階段時，錯誤出現：4845Claude Code 無法執行其自己的二進位檔案來啟動託管背景工作階段的[背景服務](/docs/zh-TW/agent-view#the-supervisor-process)。在 npm 安裝上，這通常意味著 `npm install -g @anthropic-ai/claude-code` 在那一刻正在替換二進位檔案，無論是您執行的還是[自動更新程式](/docs/zh-TW/setup#auto-updates)執行的。當您從 [agent 檢視](/docs/zh-TW/agent-view)開啟工作階段時，會出現此錯誤：
4761 4846
4762```text theme={null}4847```text theme={null}
4763Couldn't start the background service — spawn background service: EACCES: permission denied, posix_spawn '/usr/local/lib/node_modules/@anthropic-ai/claude-code/bin/claude'4848Couldn't start the background service — spawn background service: EACCES: permission denied, posix_spawn '/usr/local/lib/node_modules/@anthropic-ai/claude-code/bin/claude'
4764```4849```
4765 4850
4766當您使用 `/background` 或 `claude --bg` 啟動工作階段時，相同的原因出現在 `Couldn't reach the background service (...)` 內。在相同重新安裝視窗期間，錯誤可能命名另一個代碼，例如 `ENOENT` 或 `ENOEXEC`，或 Windows 上的 `EUNKNOWN` 或 `EPERM`；跨重試持續的 `EUNKNOWN` 有[不同的原因](#eunknown-when-starting-a-background-session)。4851當您使用 `/background` 或 `claude --bg` 啟動工作階段時，相同的原因出現在 `Couldn't reach the background service (...)` 內。在相同的重新安裝期間，錯誤可能改為顯示另一個代碼，例如 `ENOENT` 或 `ENOEXEC`，或 Windows 上的 `EUNKNOWN` 或 `EPERM`；在多次重試後仍持續的 `EUNKNOWN` 有[不同的原因](#eunknown-when-starting-a-background-session)。
4767 4852
4768在 npm 安裝上，Claude Code 等待重新安裝完成並自動重試：最多十秒，以及在 npm 安裝 Claude Code 在機器上明顯仍在執行時最多兩分鐘，涵蓋另一個 Claude Code 程序下載更新。當安裝超過該等待時，失敗命名更新而不是裸錯誤代碼：4853在 npm 安裝上，Claude Code 會等待重新安裝完成並自動重試：最多十秒，而當機器上明顯仍有 Claude Code 的 npm 安裝在執行時最多兩分鐘，這涵蓋了另一個 Claude Code 程序正在下載更新的情況。當安裝超過該等待時間時，失敗訊息會提及更新，而不是單純的錯誤代碼：
4769 4854
4770```text theme={null}4855```text theme={null}
4771Claude Code is being updated by npm on this machine (still not runnable after 2 min, EACCES) — try again when the update finishes4856Claude Code is being updated by npm on this machine (still not runnable after 2 min, EACCES) — try again when the update finishes
4772```4857```
4773 4858
4774在 v2.1.257 之前，等待在每種情況下停止在十秒，因此此錯誤在另一個 Claude Code 程序仍在下載更新時出現。在 v2.1.246 之前，Claude Code 立即失敗，沒有等待。4859在 v2.1.257 之前，等待在所有情況下都在十秒停止，因此此錯誤會在另一個 Claude Code 程序仍在下載更新時出現。在 v2.1.246 之前，Claude Code 會立即失敗，不會等待。
4775 4860
4776**該怎麼做：**4861**該怎麼做：**
4777 4862
4778* 等待幾秒，然後開啟工作階段或再次分派。當訊息說 Claude Code 正在更新時，在更新完成後重試。4863* 等待幾秒，然後開啟工作階段或再次分派。當訊息說 Claude Code 正在更新時，請在更新完成後重試。
4779* 如果錯誤在沒有 npm 安裝執行時持續，您的使用者無法執行已安裝的二進位檔案。檢查其權限及其目錄的，或重新安裝 Claude Code。4864* 如果錯誤在沒有 npm 安裝執行時持續，表示您的使用者無法執行已安裝的二進位檔案。請檢查其權限及其目錄的權限，或重新安裝 Claude Code。
4780 4865
4781<h3 id="background-service-exited-before-it-became-reachable">4866<h3 id="background-service-exited-before-it-became-reachable">
4782 背景服務在變得可到達之前退出4867 背景服務在可連線之前退出
4783</h3>4868</h3>
4784 4869
4785Claude Code 啟動為[背景服務](/docs/zh-TW/agent-view#the-supervisor-process)的程序在變得可到達之前退出，因此 Claude Code 無法開啟您的工作階段。當服務在退出前列印錯誤時，括號中的原因給出退出代碼或訊號以及服務列印的第一行，其命名停止它的內容：4870Claude Code 作為[背景服務](/docs/zh-TW/agent-view#the-supervisor-process)啟動的程序在接受連線之前就退出了，因此 Claude Code 無法開啟您的工作階段。當服務在退出前列印了錯誤時，括號中的原因會提供退出碼或訊號以及服務列印的第一行，該行指出使其停止的原因：
4786 4871
4787```text theme={null}4872```text theme={null}
4788Couldn't reach the background service (background service exited before it became reachable (exit code N): <the service's first error line>) — run 'claude daemon status'4873Couldn't reach the background service (background service exited before it became reachable (exit code N): <the service's first error line>) — run 'claude daemon status'
4789```4874```
4790 4875
4791當您從[代理檢視](/docs/zh-TW/agent-view)開啟工作階段時，相同的原因跟隨 `Couldn't start the background service —`。當服務在退出前未列印任何內容時，訊息改為說 `nothing on stderr`。4876當您從 [agent 檢視](/docs/zh-TW/agent-view)開啟工作階段時，相同的原因接在 `Couldn't start the background service —` 之後。當服務在退出前未列印任何內容時，訊息改為顯示 `nothing on stderr`。
4792 4877
4793Claude Code 使用服務的錯誤行報告失敗。在 v2.1.246 之前，失敗僅在 45 秒等待後表現，為 `background service did not become reachable within 45s`，沒有服務的錯誤行。4878Claude Code 會連同服務的錯誤行一起報告失敗。在 v2.1.246 之前，失敗僅在等待 45 秒後才以 `background service did not become reachable within 45s` 的形式出現，且不含服務的錯誤行。
4794 4879
4795兩個引用的原因有已知的原因：4880兩種引用的原因有已知的成因：
4796 4881
4797* `Error: claude native binary not installed.`：npm 安裝在那一刻替換 Claude Code 二進位檔案，因此服務執行 npm 的佔位符。在安裝完成後重試；如果沒有安裝執行時行持續，[完成 npm 安裝](/docs/zh-TW/troubleshoot-install#native-binary-not-found-after-npm-install)。在 v2.1.257 之前，macOS npm 自我更新在安裝視窗期間在每次啟動時產生此失敗。4882* `Error: claude native binary not installed.`：npm 安裝在那一刻正在替換 Claude Code 二進位檔案，因此服務執行了 npm 的佔位檔。請在安裝完成後重試；如果在沒有安裝執行時該行仍持續出現，請[完成 npm 安裝](/docs/zh-TW/troubleshoot-install#native-binary-not-found-after-npm-install)。在 v2.1.257 之前，macOS 上的 npm 自我更新會在安裝期間的每次啟動時產生此失敗。
4798* Windows 上每次啟動時 `nothing on stderr` 和退出代碼 1：`daemon.lock` 命名 Claude Code 既無法訊號也無法證明已消失的程序，因此每個新服務得出結論另一個保持鎖定並退出。Claude Code 可以證明其寫入器已消失的鎖定會自動替換，不會產生此失敗。當失敗在每次啟動時重複時，刪除 `~/.claude/daemon.lock`，然後開啟工作階段或再次分派。在 v2.1.257 之前，這樣的鎖定阻止每次啟動，直到您刪除檔案。4883* Windows 上每次啟動時都出現 `nothing on stderr` 且退出碼為 1：`daemon.lock` 指向一個 Claude Code 既無法傳送訊號、也無法證明已消失的程序，因此每個新服務都判定另一個服務持有鎖定並退出。Claude Code 能證明其寫入者已消失的鎖定會自動被替換，不會產生此失敗。當失敗在每次啟動時重複出現時，請刪除 `~/.claude/daemon.lock`，然後開啟工作階段或再次分派。在 v2.1.257 之前，這樣的鎖定會阻止每次啟動，直到您刪除該檔案。
4799 4884
4800**該怎麼做：**4885**該怎麼做：**
4801 4886
4802* 如果訊息引用一行，修復它命名的內容，然後開啟工作階段或再次分派。下次嘗試再次啟動服務4887* 如果訊息引用了一行，請修正其指出的問題，然後開啟工作階段或再次分派。下次嘗試會再次啟動服務
4803* 執行 `claude daemon status` 檢查現在是否有服務執行4888* 執行 `claude daemon status` 檢查現在是否有服務正在執行
4804 4889
4805<h3 id="working-directory-no-longer-exists-when-starting-a-background-session">4890<h3 id="working-directory-no-longer-exists-when-starting-a-background-session">
4806 啟動背景工作階段時工作目錄不再存在4891 啟動背景工作階段時工作目錄不再存在
4807</h3>4892</h3>
4808 4893
4809您嘗試在不再存在的目錄中啟動[背景工作階段](/docs/zh-TW/agent-view)。Claude Code 不啟動工作階段，訊息命名遺漏的目錄：4894您啟動[背景工作階段](/docs/zh-TW/agent-view)時所在的目錄在工作階段啟動期間被移除。Claude Code 不會啟動工作階段，訊息會指出遺失的目錄：
4810 4895
4811```text theme={null}4896```text theme={null}
4812Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)4897Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)
4813```4898```
4814 4899
4815在 v2.1.257 之前，工作階段似乎啟動，然後在代理檢視中顯示為失敗列，原因相同。4900在 v2.1.257 之前，工作階段看似已啟動，然後在 agent 檢視中顯示為失敗列，原因相同。
4816 4901
4817在 v2.1.281 之前，此訊息也在您啟動工作階段之前目錄已消失時出現。該案例報告[`could not be resolved on disk`](#workspace-not-trusted-when-dispatching-a-background-session)。4902在 v2.1.281 之前，當目錄在您啟動工作階段之前就已消失時，也會出現此訊息。該情況會報告 [`could not be resolved on disk`](#workspace-not-trusted-when-dispatching-a-background-session)。
4818 4903
4819**該怎麼做：**4904**該怎麼做：**
4820 4905
4821* 重新建立訊息命名的目錄，或從存在的目錄分派，然後再試一次4906* 重新建立訊息指出的目錄，或從存在的目錄分派，然後再試一次
4822 4907
4823<h3 id="workspace-not-trusted-when-dispatching-a-background-session">4908<h3 id="workspace-not-trusted-when-dispatching-a-background-session">
4824 分派背景工作階段時工作區未信任4909 分派背景工作階段時工作區未信任
4825</h3>4910</h3>
4826 4911
4827您在未[信任](/docs/zh-TW/permissions#project-allow-rules-and-workspace-trust)的目錄中啟動或重新啟動[背景工作階段](/docs/zh-TW/agent-view)，工作區信任對話無法出現以詢問您。Claude Code 不啟動工作階段：4912您在尚未[信任](/docs/zh-TW/permissions#project-allow-rules-and-workspace-trust)的目錄中啟動或重新啟動[背景工作階段](/docs/zh-TW/agent-view)，而工作區信任對話框無法出現來詢問您。Claude Code 不會啟動工作階段：
4828 4913
4829```text theme={null}4914```text theme={null}
4830Workspace not trusted. Run `claude` in /path/to/project once and accept the trust prompt, then retry.4915Workspace not trusted. Run `claude` in /path/to/project once and accept the trust prompt, then retry.
4831```4916```
4832 4917
4833從工作階段自己的目錄中的終端，相同的命令改為顯示信任對話並在您接受後啟動工作階段。此訊息出現在沒有對話可以出現的地方，例如在指令碼中，或當您從不同於其自己的目錄重新啟動工作階段時。4918若從工作階段自己目錄中的終端機執行，相同的命令會改為顯示信任對話框，並在您接受後啟動工作階段。此訊息出現在無法顯示對話框的地方，例如在指令碼中，或當您從非其自身的目錄重新啟動工作階段時。
4834 4919
4835兩個變體命名不同的原因：4920兩種變體指出不同的原因：
4836 4921
4837* **`The home directory is trusted one session at a time`**：工作階段的目錄是您的主目錄。Claude Code 永遠不會儲存主目錄的信任，因此在較早的工作階段中在那裡接受對話不計算。4922* **`The home directory is trusted one session at a time`**：工作階段的目錄是您的家目錄。Claude Code 永遠不會儲存家目錄的信任，因此在較早的工作階段中於該處接受對話框並不算數。
4838* **`<path> could not be resolved on disk`**：Claude Code 無法在磁碟上找到工作階段的目錄。4923* **`<path> could not be resolved on disk`**：Claude Code 無法在磁碟上找到工作階段的目錄。
4839 4924
4925在 v2.1.286 之前，在 Windows 上，如果信任記錄儲存時路徑的大小寫不同，此訊息也可能出現在您已信任的目錄中。請更新到 v2.1.286 或更新版本。
4926
4840**該怎麼做：**4927**該怎麼做：**
4841 4928
4842* 在訊息命名的目錄中執行 `claude` 並接受信任對話，然後再次執行命令4929* 在訊息指出的目錄中執行 `claude` 並接受信任對話框，然後再次執行命令
4843* 對於主目錄訊息，從您主目錄中的終端執行命令，以便對話可以出現，或改為從專案目錄啟動工作階段4930* 對於家目錄訊息，請從家目錄中的終端機執行命令，以便對話框可以出現，或改為從專案目錄啟動工作階段
4844* 對於 `could not be resolved on disk` 訊息，重新建立目錄，或從存在的目錄啟動新工作階段4931* 對於 `could not be resolved on disk` 訊息，請重新建立目錄，或從存在的目錄啟動新工作階段
4845 4932
4846<h2 id="wrapper-and-ide-errors">4933<h2 id="wrapper-and-ide-errors">
4847 包裝程式和 IDE 錯誤4934 包裝程式和 IDE 錯誤
