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) |
79| `API Error: 401 Invalid authentication credentials` | [驗證](#api-error-401-invalid-authentication-credentials) |81| `API Error: 401 Invalid authentication credentials` | [驗證](#api-error-401-invalid-authentication-credentials) |
80| `Login expired · Please run /login` | [驗證](#login-expired) |82| `Login expired · Please run /login` | [驗證](#login-expired) |
186| `The connection dropped while downloading the update` | [安裝錯誤](#the-connection-dropped-while-downloading-the-update) |188| `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) |189| `Download timed out: exceeded the total deadline` | [安裝錯誤](#the-connection-dropped-while-downloading-the-update) |
188| `--bg and --print conflict` | [命令列錯誤](#conflict-between-bg-and-print) |190| `--bg and --print conflict` | [命令列錯誤](#conflict-between-bg-and-print) |
191| `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) |192| `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) |193| `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) |194| `Couldn't verify your organization's policy for cloud sessions` | [命令列錯誤](#cloud-sessions-are-disabled-by-your-organizations-policy) |
246| `Marketplace name impersonates an official Anthropic/Claude marketplace` | [Plugin 錯誤](#claude-code-refuses-the-marketplace-name) |249| `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) |250| `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) |251| `"<name>" is another spelling of "<reserved>", a reserved marketplace name` | [Plugin 錯誤](#marketplace-name-is-another-spelling-of-a-reserved-name) |
252| `Marketplace "<name>" is added but ignored` | [Plugin 疑難排解](/docs/zh-TW/plugins/troubleshooting#marketplace-is-added-but-ignored) |
253| `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) |254| `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) |255| `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) |256| `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) |257| `Plugin archive integrity check failed` | [Plugin 錯誤](#plugin-archive-integrity-check-failed) |
258| `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) |259| `path escapes plugin directory` | [Plugin 錯誤](#path-escapes-plugin-directory) |
254| `path could not be checked` | [Plugin 錯誤](#path-could-not-be-checked) |260| `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) |261| `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) |296| `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) |297| `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) |298| `WebFetch cannot fetch localhost or other hostnames without a dot` | [工具錯誤](#webfetch-cannot-fetch-localhost) |
299| `The safety check for domain ... is rate-limited` | [工具錯誤](#webfetch-domain-safety-check-failed) |
300| `The safety check for domain ... is temporarily rate-limited` | [工具錯誤](#webfetch-domain-safety-check-failed) |
301| `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) |302| `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) |303| `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) |304| `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) |
415 伺服器錯誤424 伺服器錯誤
416</h2>425</h2>
417 426
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 帳戶或達到使用限制的子代理。427大多數這些錯誤來自推論提供者：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 428
420<h3 id="api-error-500-internal-server-error">429<h3 id="api-error-500-internal-server-error">
421 API Error: 500 Internal server error430 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.436API 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```437```
429 438
430尾部句子名稱檢查服務健康狀況的位置，並因提供者而異。Amazon Bedrock、Google Cloud 的 Agent Platform 和 Microsoft Foundry 設定會名稱該提供者的服務狀態。自訂 `ANTHROPIC_BASE_URL` 會名稱閘道主機。439結尾的句子會指明檢查服務健康狀況的位置，並因提供者而異。Amazon Bedrock、Google Cloud 的 Agent Platform 和 Microsoft Foundry 設定會指明該提供者的服務狀態。自訂 `ANTHROPIC_BASE_URL` 會指明閘道主機。
431 440
432來自 API 本身的 5xx 表示 API 內部發生意外故障。它不是由您的提示、設定或帳戶引起的。441來自 API 本身的 5xx 表示 API 內部發生意外故障。它不是由您的提示詞、設定或帳戶引起的。
433 442
434當代理、負載平衡器或閘道以 HTML 錯誤頁面回應時，訊息會顯示狀態碼和頁面的標題，例如 `API Error: 502 Bad Gateway`。對於沒有標題的頁面，訊息會改為顯示狀態碼及其標準名稱。在 v2.1.281 之前，當頁面有標題時狀態碼被丟棄，當頁面沒有標題時列印頁面的原始標記。443當代理伺服器、負載平衡器或閘道以 HTML 錯誤頁面回應時，訊息會顯示狀態碼和頁面的標題，例如 `API Error: 502 Bad Gateway`。對於沒有標題的頁面，訊息會改為顯示狀態碼及其標準名稱。在 v2.1.281 之前，當頁面有標題時狀態碼被丟棄，當頁面沒有標題時列印頁面的原始標記。
435 444
436**該怎麼做：**445**該怎麼做：**
437 446
438* 檢查 [status.claude.com](https://status.claude.com) 或訊息中名稱的提供者狀態頁面，查看是否有活躍的事件447* 檢查 [status.claude.com](https://status.claude.com) 或訊息中指明的提供者狀態頁面，查看是否有活躍的事件
439* 等待一分鐘，然後再次傳送您的訊息。您的原始訊息仍在對話中，因此對於較長的提示，您可以輸入 `try again` 而不是貼上整個內容。448* 等待一分鐘，然後再次傳送您的訊息。您的原始訊息仍在對話中，因此對於較長的提示詞，您可以輸入 `try again` 而不是貼上整個內容。
440* 如果錯誤持續存在且沒有發佈的事件，請執行 `/feedback`，以便 Anthropic 可以使用您的請求詳細資訊進行調查。如果您的環境中無法使用 `/feedback`，請參閱[報告錯誤](#report-an-error)。449* 如果錯誤持續存在且沒有發佈的事件，請執行 `/feedback`，以便 Anthropic 可以使用您的請求詳細資訊進行調查。如果您的環境中無法使用 `/feedback`，請參閱[報告錯誤](#report-an-error)。
441 450
442<h3 id="api-error-repeated-529-overloaded-errors">451<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.458API 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```459```
451 460
452尾部句子因提供者而異，方式與上面的 500 錯誤相同。461結尾的句子因提供者而異，方式與上面的 500 錯誤相同。
453 462
454529 不是您的使用限制，也不會計入您的配額。463529 不是您的用量上限，也不會計入您的配額。
455 464
456**該怎麼做：**465**該怎麼做：**
457 466
458* 檢查 [status.claude.com](https://status.claude.com) 或訊息中名稱的提供者狀態頁面，查看容量通知467* 檢查 [status.claude.com](https://status.claude.com) 或訊息中指明的提供者狀態頁面，查看容量通知
459* 在幾分鐘後重試468* 在幾分鐘後重試
460* 執行 `/model` 並切換到不同的模型以繼續工作，因為容量是按模型追蹤的。Claude Code 會在一個模型負載特別高時提示您執行此操作，例如 `Opus is experiencing high load, please use /model to switch to Sonnet`。在 Fable 模型上，訊息會名稱 Fable。469* 執行 `/model` 並切換到不同的模型以繼續工作，因為容量是按模型追蹤的。Claude Code 會在一個模型負載特別高時提示您執行此操作，例如 `Opus is experiencing high load, please use /model to switch to Sonnet`。在 Fable 模型上，訊息會指明 Fable。
461 470
462 在 Claude Desktop 應用程式執行的工作階段中，例如 Code 標籤或 Cowork，訊息讀作 `Opus is experiencing high load. Switch to Sonnet.`，您可以使用應用程式的模型選擇器切換模型。471 在 Claude Desktop 應用程式執行的工作階段中，例如 Code 標籤或 Cowork，訊息讀作 `Opus is experiencing high load. Switch to Sonnet.`，您可以使用應用程式的模型選擇器切換模型。
463 472
476**該怎麼做：**485**該怎麼做：**
477 486
478* 重試請求487* 重試請求
479* 如果緩慢的網路或代理是原因，請按照[自動重試](#automatic-retries)中的說明提高 `API_TIMEOUT_MS`488* 如果緩慢的網路或代理伺服器是原因，請按照[自動重試](#automatic-retries)中的說明提高 `API_TIMEOUT_MS`
480* 如果逾時頻繁且您的網路在其他方面狀況良好，請參閱下面的[網路和連線錯誤](#network-and-connection-errors)489* 如果逾時頻繁且您的網路在其他方面狀況良好，請參閱下面的[網路和連線錯誤](#network-and-connection-errors)
481 490
482<h3 id="no-response-from-api">491<h3 id="no-response-from-api">
483 No response from API492 No response from API
484</h3>493</h3>
485 494
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)中描述的預算下重試。495Claude 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 496
488```text theme={null}497```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.498API 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 分別為第一次嘗試的等待回應標頭和重試的等待設定：501Claude Code 分別為第一次嘗試的等待回應標頭和重試的等待設定：
493 502
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 添加一秒。503* **第一次嘗試**：當您將其設定為 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 上，重試使用與第一次嘗試相同的截止時間，訊息顯示一個持續時間而不是兩個。504* **重試**：比 `API_TIMEOUT_MS` 少一秒，預設略低於 10 分鐘，以便重試可以超過保持回應直到生成完成的代理伺服器或閘道。在 Amazon Bedrock 上，重試使用與第一次嘗試相同的截止時間，訊息顯示一個持續時間而不是兩個。
496 505
497兩個等待都不超過正 `API_TIMEOUT_MS` 少一秒，正 `API_TIMEOUT_MS` 在 11 秒以下會關閉截止時間。位元組級監視程式僅在回應標頭到達後才開始，因此在此之後停止傳送位元組的回應遵循[停滯串流規則](#automatic-retries)而不是此截止時間。506兩個等待都不超過正 `API_TIMEOUT_MS` 少一秒，正 `API_TIMEOUT_MS` 在 11 秒以下會關閉截止時間。位元組級監視程式僅在回應標頭到達後才開始，因此在此之後停止傳送位元組的回應遵循[停滯串流規則](#automatic-retries)而不是此截止時間。
498 507
499**該怎麼做：**508**該怎麼做：**
500 509
501* 再次傳送您的訊息。您的原始訊息仍在對話中，因此對於較長的提示，您可以輸入 `try again` 而不是貼上整個內容。510* 再次傳送您的訊息。您的原始訊息仍在對話中，因此對於較長的提示詞，您可以輸入 `try again` 而不是貼上整個內容。
502* 如果重複出現，將其視為[網路或代理問題](#unable-to-connect-to-api)。511* 如果重複出現，將其視為[網路或代理伺服器問題](#unable-to-connect-to-api)。
503* 如果您網路上的代理或閘道保持回應直到完成，請提高 `API_TIMEOUT_MS` 以便重試等待更長時間。在 Amazon Bedrock 上，也請提高 `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`。512* 如果您網路上的代理伺服器或閘道保持回應直到完成，請提高 `API_TIMEOUT_MS` 以便重試等待更長時間。在 Amazon Bedrock 上，也請提高 `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`。
504* 如果第一次嘗試持續逾時，然後重試成功，請提高 `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` 以便第一次嘗試也等待足夠長的時間。513* 如果第一次嘗試持續逾時，然後重試成功，請提高 `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` 以便第一次嘗試也等待足夠長的時間。
505 514
506在 v2.1.242 之前，Claude Code 在未回應的串流請求失敗之前等待完整的 `API_TIMEOUT_MS` 請求逾時（預設為 10 分鐘）。在 v2.1.261 之前，重試等待與第一次嘗試相同的截止時間，訊息沒有顯示持續時間。515在 v2.1.242 之前，Claude Code 在未回應的串流請求失敗之前等待完整的 `API_TIMEOUT_MS` 請求逾時（預設為 10 分鐘）。在 v2.1.261 之前，重試等待與第一次嘗試相同的截止時間，訊息沒有顯示持續時間。
509 The response above may be incomplete518 The response above may be incomplete
510</h3>519</h3>
511 520
512串流請求在回應仍在進行中時失敗，在 Claude 完成一個文字區塊或工具呼叫之後，或在完成思考後開始一個。重新傳送請求可能會執行相同的工具呼叫兩次，因此 Claude Code 會保留 Claude 完成的輸出並附加此通知，而不是丟棄該輪次。您看到的變體名稱原因：521串流請求在回應仍在進行中時失敗，在 Claude 完成一個文字區塊或工具呼叫之後，或在完成思考後開始一個。重新傳送請求可能會執行相同的工具呼叫兩次，因此 Claude Code 會保留 Claude 完成的輸出並附加此通知，而不是丟棄該回合。您看到的變體會指明原因：
513 522
514```text theme={null}523```text theme={null}
515API Error: Server error mid-response. The response above may be incomplete.524API Error: Server error mid-response. The response above may be incomplete.
520API Error: The response stream was malformed. The response above may be incomplete.529API Error: The response stream was malformed. The response above may be incomplete.
521```530```
522 531
523* `Server error mid-response`：中流過載或 5xx 伺服器錯誤。此變體需要 Claude Code v2.1.199 或更高版本；在此之前，該情況會丟棄部分輸出並將整個輪次報告為錯誤。532* `Server error mid-response`：中流過載或 5xx 伺服器錯誤。此變體需要 Claude Code v2.1.199 或更高版本；在此之前，該情況會丟棄部分輸出並將整個回合報告為錯誤。
524* `Connection lost mid-response`：連線中斷。您也會在代理或閘道在回應完成之前乾淨地結束回應正文時看到此變體。533* `Connection lost mid-response`：連線中斷。您也會在代理伺服器或閘道在回應完成之前乾淨地結束回應正文時看到此變體。
525* `Your computer went to sleep mid-response`：Claude Code 偵測到您的電腦在回應串流時進入睡眠狀態。一旦您的電腦喚醒，Claude Code 會將連線視為中斷並停止從中讀取。534* `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` 結束該輪次。535* `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` 開頭的錯誤）會出現。536* `The response stream was malformed`：已完成的內容區塊到達了事件，或事件到達時已損壞。損壞的事件是指其資料不是有效 JSON、其內容遺失或其內容與事件類型不符的事件。在 v2.1.284 之前，當具有無效 JSON 的事件在 Claude 完成其思考、文字區塊或工具呼叫後到達時，解析器的原始錯誤（例如以 `API Error: JSON Parse error` 開頭的錯誤）會出現。在 v2.1.287 之前，當 [Amazon Bedrock guardrail](/docs/zh-TW/amazon-bedrock#aws-guardrails) 封鎖了已經串流思考和部分文字的回應時，會出現此變體，而不是 guardrail 的訊息。
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)。537* `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 538
530在 v2.1.227 之前，`Connection lost mid-response` 讀作 `Connection closed mid-response`，`The response stopped arriving` 讀作 `Response stalled mid-stream`。539在 v2.1.227 之前，`Connection lost mid-response` 讀作 `Connection closed mid-response`，`The response stopped arriving` 讀作 `Response stalled mid-stream`。
531 540
532當丟棄、重複或損壞的串流事件在 Claude 開始任何文字或工具呼叫之前到達時，您看不到此通知：541當丟棄、重複或損壞的串流事件在 Claude 開始任何文字或工具呼叫之前到達時，您看不到此通知：
533 542
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.` 結束。543* 如果 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` 或解析器的原始錯誤結束。544* 如果沒有完成任何內容，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 545
537在四種情況下，Claude Code 會在不立即顯示此通知的情況下處理故障：546在四種情況下，Claude Code 會在不立即顯示此通知的情況下處理故障：
538 547
539* 在回應的早期，Claude Code 要麼重試故障，要麼以不同的錯誤結束輪次。請參閱[自動重試](#automatic-retries)。548* 在回應的早期，Claude Code 要麼重試故障，要麼以不同的錯誤結束回合。請參閱[自動重試](#automatic-retries)。
540* 當這些故障之一在 Claude 完成回應後到達時，Claude Code 會保留完整回應並正常結束輪次，沒有此通知。在 v2.1.222 之前，Claude Code 在連線中斷或在回應完成後停滯時顯示此通知，並將輪次報告為錯誤，儘管回應是完整的。549* 當這些故障之一在 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 在第一次截斷時以此通知結束非互動式輪次。550* 在[非互動式工作階段](/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 之前，子代理在第一次截斷時顯示此通知。551* 在 [subagent](/docs/zh-TW/sub-agents#api-errors-in-subagents) 中，無論工作階段是否互動：當其截斷回應包含文字但沒有工具呼叫時，Claude Code 會提示 subagent 繼續。通知僅在這些繼續用完後才成為 subagent 的最後一條訊息。在 v2.1.257 之前，subagent 在第一次截斷時顯示此通知。
543 552
544**該怎麼做：**553**該怎麼做：**
545 554
546* 在互動式工作階段中，閱讀螢幕上保留的回應：Claude Code 保留 Claude 在錯誤之前完成的每個區塊，但在輪次結束時丟棄中斷的最後區塊，因此最後的句子或工具呼叫可能會遺失。回覆 `continue` 以讓 Claude 從其最後完成的區塊繼續。555* 在互動式工作階段中，閱讀螢幕上保留的回應：Claude Code 保留 Claude 在錯誤之前完成的每個區塊，但在回合結束時丟棄中斷的最後區塊，因此最後的句子或工具呼叫可能會遺失。回覆 `continue` 以讓 Claude 從其最後完成的區塊繼續。
547* 在[非互動式模式](/docs/zh-TW/headless)（`-p`）中：556* 在[非互動模式](/docs/zh-TW/headless)（`-p`）中：
548 * 使用預設文字輸出，Claude Code 會列印它仍然從輪次早期保留的最後完成的文字區塊，然後是此訊息。當它沒有保留任何內容時，Claude Code 會單獨列印此訊息，例如因為 Claude Code 在輪次中間壓縮了對話並清除了該文字。在 v2.1.219 之前，Claude Code 在 `-p` 文字輸出中只列印此訊息並丟棄它已經產生的回應。557 * 使用預設文字輸出，Claude Code 會列印它仍然從回合早期保留的最後完成的文字區塊，然後是此訊息。當它沒有保留任何內容時，Claude Code 會單獨列印此訊息，例如因為 Claude Code 在回合中間壓縮了對話並清除了該文字。在 v2.1.219 之前，Claude Code 在 `-p` 文字輸出中只列印此訊息並丟棄它已經產生的回應。
549 * 使用 `--output-format json` 或 `stream-json`，Claude Code 會在 `result` 欄位中報告此訊息。558 * 使用 `--output-format json` 或 `stream-json`，Claude Code 會在 `result` 欄位中報告此訊息。
550 * 一旦連線穩定，要繼續該輪次，請恢復工作階段並按照[繼續對話](/docs/zh-TW/headless#continue-conversations)中的說明傳送 `continue`。559 * 一旦連線穩定，要繼續該回合，請恢復工作階段並按照[繼續對話](/docs/zh-TW/headless#continue-conversations)中的說明傳送 `continue`。
551 560
552<h3 id="auto-mode-cannot-determine-the-safety-of-an-action">561<h3 id="auto-mode-cannot-determine-the-safety-of-an-action">
553 Auto mode cannot determine the safety of an action562 Auto mode cannot determine the safety of an action
554</h3>563</h3>
555 564
556[auto mode](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) 使用的模型無法產生決定來分類動作，因此 auto mode 沒有自動批准該動作。您看到的訊息取決於分類器如何失敗。565[自動模式](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode)用來分類動作的模型無法產生決定，因此自動模式沒有自動核准該動作。您看到的訊息取決於分類器如何失敗。
557 566
558讀取、搜尋和編輯您的工作目錄內的內容會跳過分類器，因此它們在所有這些情況下都能繼續工作。567讀取、搜尋和編輯您的工作目錄內的內容會跳過分類器，因此它們在所有這些情況下都能繼續工作。
559 568
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.572<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```573```
565 574
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`。575當 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 576
568當沒有類別符合時，訊息出現時括號中沒有類別；多個故障會產生該形式。在 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) 上，包括 [Mantle 端點](/docs/zh-TW/amazon-bedrock#use-the-mantle-endpoint)，當您的 AWS 帳戶無法叫用訊息中名稱的模型時，它也會出現，該故障在每次重試時重複，直到您的帳戶被授予存取該模型的權限。577當沒有類別符合時，訊息出現時括號中沒有類別；多個故障會產生該形式。在 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) 上，包括 [Mantle 端點](/docs/zh-TW/amazon-bedrock#use-the-mantle-endpoint)，當您的 AWS 帳戶無法叫用訊息中指明的模型時，它也會出現，該故障在每次重試時重複，直到您的帳戶被授予存取該模型的權限。
569 578
570**該怎麼做：**579**該怎麼做：**
571 580
572* 在幾秒後重試；Claude 會看到相同的訊息，通常會自動重試。暫時故障與 [auto mode 資格](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode)無關；您不需要變更設定581* 在幾秒後重試；Claude 會看到相同的訊息，通常會自動重試。暫時故障與[自動模式資格](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode)無關；您不需要變更設定
573* 如果重試持續失敗，請繼續進行唯讀任務，稍後再回到被阻止的動作582* 如果重試持續失敗，請繼續進行唯讀任務，稍後再回到被阻止的動作
574* 在 Amazon Bedrock 上，如果訊息在每次重試時返回，請檢查您的帳戶是否可以叫用它名稱的模型：對於標準 Amazon Bedrock 模型，確認您的 [IAM 政策](/docs/zh-TW/amazon-bedrock#iam-configuration)允許叫用它；對於 Mantle 模型 ID，[聯絡您的 AWS 帳戶團隊](/docs/zh-TW/amazon-bedrock#mantle-endpoint-errors)583* 在 Amazon Bedrock 上，如果訊息在每次重試時返回，請檢查您的帳戶是否可以叫用它指明的模型：對於標準 Amazon Bedrock 模型，確認您的 [IAM 政策](/docs/zh-TW/amazon-bedrock#iam-configuration)允許叫用它；對於 Mantle 模型 ID，[聯絡您的 AWS 帳戶團隊](/docs/zh-TW/amazon-bedrock#mantle-endpoint-errors)
575 584
576當分類器請求失敗是因為您的 OAuth 令牌過期或被另一個工作階段輪換時，Claude Code 會重新整理令牌並重試請求一次，因此例行令牌過期不會作為此訊息出現。在 v2.1.216 之前，過期或輪換的令牌會導致每個分類器請求失敗，auto mode 會以此訊息拒絕每個檢查的動作，直到令牌被重新整理。585當分類器請求失敗是因為您的 OAuth token 過期或被另一個工作階段輪換時，Claude Code 會重新整理 token 並重試請求一次，因此例行的 token 過期不會作為此訊息出現。在 v2.1.216 之前，過期或輪換的 token 會導致每個分類器請求失敗，自動模式會以此訊息拒絕每個檢查的動作，直到 token 被重新整理。
577 586
578當分類器返回無法解析的回應時：587當分類器返回無法解析的回應時：
579 588
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 details601Auto 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```602```
594 603
595Claude Code 拒絕該動作，但告訴 Claude 這不是對該動作不安全的判斷，並繼續進行其他任務而不是重試。這些拒絕不計入 [auto mode 的暫停閾值](/docs/zh-TW/permission-modes#when-auto-mode-falls-back)。在[非互動式](/docs/zh-TW/headless) `-p` 執行中，Claude Code 不會停止執行。Claude 接收的內容取決於它在哪裡請求該動作：604Claude Code 拒絕該動作，但告訴 Claude 這不是對該動作不安全的判斷，並繼續進行其他任務而不是重試。這些拒絕不計入[自動模式的暫停閾值](/docs/zh-TW/permission-modes#when-auto-mode-falls-back)。在[非互動式](/docs/zh-TW/headless) `-p` 執行中，Claude Code 不會停止執行。Claude 接收的內容取決於它在哪裡請求該動作：
596 605
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` 的錯誤結果606* 對於 `-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 會將該拒絕返回給 Claude607* 在其他地方，包括互動式工作階段和 `-p` 執行的主對話，Claude Code 會將該拒絕返回給 Claude
599 608
600在 v2.1.225 之前，Claude Code 計算這些拒絕以達到暫停閾值，並返回與真正分類器區塊相同的拒絕訊息。609在 v2.1.225 之前，Claude Code 計算這些拒絕以達到暫停閾值，並返回與真正分類器區塊相同的拒絕訊息。
601 610
602**該怎麼做：**611**該怎麼做：**
603 612
604* 這不是對您的動作的決定。您對話中已有的內容在 auto mode 將對話傳送給分類器時觸發了 API 上的安全篩選器613* 這不是對您的動作的決定。您對話中已有的內容在自動模式將對話傳送給分類器時觸發了 API 上的安全篩選器
605* 重試無法幫助；相同的對話內容將再次觸發篩選器614* 重試無法幫助；相同的對話內容將再次觸發篩選器
606* 在互動式工作階段中，切換到不同的[權限模式](/docs/zh-TW/permission-modes)，以便您可以在提示時批准該動作615* 在互動式工作階段中，切換到不同的[權限模式](/docs/zh-TW/permission-modes)，以便您可以在提示時核准該動作
607* 開始一個新的對話，不包含觸發內容616* 開始一個新的對話，不包含觸發內容
608 617
609當對話增長超過分類器的上下文視窗時：618當對話增長超過分類器的上下文視窗時：
614 623
615動作發生的情況取決於 Claude 在哪裡請求它：624動作發生的情況取決於 Claude 在哪裡請求它：
616 625
617* 在互動式工作階段中，auto mode 會回退到該動作的正常權限提示，以便您可以手動批准或拒絕它626* 在互動式工作階段中，自動模式會改用該動作的正常權限提示，以便您可以手動核准或拒絕它
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` 的錯誤結果，執行繼續627* 對於[非互動式](/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)，沒有提示可以回退到，因此動作不執行，執行繼續628* 在 `-p` 執行中的其他地方，沒有 [`--permission-prompt-tool`](/docs/zh-TW/cli-reference#cli-flags)，沒有提示可以改用，因此動作不執行，執行繼續
620 629
621**該怎麼做：**630**該怎麼做：**
622 631
623* 在互動式工作階段中，在出現的提示中批准或拒絕該動作632* 在互動式工作階段中，在出現的提示中核准或拒絕該動作
624* 在互動式工作階段中，執行 `/compact` 以減少對話大小，以便後續動作再次適應分類器視窗633* 在互動式工作階段中，執行 `/compact` 以減少對話大小，以便後續動作再次適應分類器視窗
625 634
626<h3 id="the-server-returned-no-safety-verdict">635<h3 id="the-server-returned-no-safety-verdict">
627 The server returned no safety verdict636 The server returned no safety verdict
628</h3>637</h3>
629 638
630在[伺服器端分類器審查](/docs/zh-TW/permission-modes#server-side-classifier-review)下，當伺服器沒有給出判決時，auto mode 會拒絕一個動作。拒絕會在 Claude Code 可以判斷一個類別時在括號中名稱該類別，例如 `(timed out)`：639在[伺服器端分類器審查](/docs/zh-TW/permission-modes#server-side-classifier-review)下，當伺服器沒有給出判決時，自動模式會拒絕一個動作。拒絕會在 Claude Code 可以判斷一個類別時在括號中指明該類別，例如 `(timed out)`：
631 640
632```text theme={null}641```text theme={null}
633The server-side auto mode classifier gave no verdict (timed out), so auto mode cannot determine the safety of <tool>.642The server-side auto mode classifier gave no verdict (timed out), so auto mode cannot determine the safety of <tool>.
634```643```
635 644
636訊息的其餘部分告訴 Claude 一次重試是否可以幫助。在某些這些拒絕之前，Claude Code 會等待，以便 Claude 的下一次嘗試不會立即跟隨。在互動式工作階段中等待期間，微調器顯示 `Auto mode check unavailable` 並帶有倒計時，按 `Esc` 會中斷該輪次。645訊息的其餘部分告訴 Claude 一次重試是否可以幫助。在某些這些拒絕之前，Claude Code 會等待，以便 Claude 的下一次嘗試不會立即跟隨。在互動式工作階段中等待期間，微調器顯示 `Auto mode check unavailable` 並帶有倒計時，按 `Esc` 會中斷該回合。
637 646
638在連續十個回應都沒有判決後，auto mode 會停止該輪次：647在連續十個回應都沒有判決後，自動模式會停止該回合：
639 648
640```text theme={null}649```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.650Auto 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 652
644停止訊息在每種工作階段中出現在不同的位置：653停止訊息在每種工作階段中出現在不同的位置：
645 654
646* 在互動式工作階段中，訊息作為警告出現在記錄中，輪次結束655* 在互動式工作階段中，訊息作為警告出現在逐字稿中，回合結束
647* 在[非互動式](/docs/zh-TW/headless) `-p` 執行中，執行結束並報告執行錯誤。使用預設文字輸出，訊息在 stderr 上列印656* 在[非互動式](/docs/zh-TW/headless) `-p` 執行中，執行結束並報告執行錯誤。使用預設文字輸出，訊息在 stderr 上列印。
648* 當[子代理](/docs/zh-TW/sub-agents)達到限制時，子代理在完成之前停止，Claude 會收到它產生的任何內容，並附帶 auto mode 停止它的說明657* 當 [subagent](/docs/zh-TW/sub-agents) 達到限制時，subagent 在完成之前停止，Claude 會收到它產生的任何內容，並附帶自動模式停止它的說明
649 658
650**該怎麼做：**659**該怎麼做：**
651 660
652* 傳送另一條訊息以讓 Claude 再試一次。回應計數重新開始。661* 傳送另一條訊息以讓 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)列出要保持不變的內容。662* 如果停止重複且您的請求通過 [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 時不讀取該變數。663* 在啟動 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)664* 要自己核准動作，請改為[切換出自動模式](/docs/zh-TW/permission-modes#switch-permission-modes)
656 665
657在 v2.1.280 之前，Claude Code 立即拒絕來自沒有判決的回應的每個動作，從不停止該輪次。666在 v2.1.280 之前，Claude Code 立即拒絕來自沒有判決的回應的每個動作，從不停止該回合。
658 667
659<h3 id="agent-terminated-early-due-to-an-api-error">668<h3 id="agent-terminated-early-due-to-an-api-error">
660 Agent terminated early due to an API error669 Agent terminated early due to an API error
661</h3>670</h3>
662 671
663[子代理](/docs/zh-TW/sub-agents)的 API 請求終止失敗，例如因為達到使用限制或伺服器錯誤的重試用完，所以子代理在完成其任務之前停止。此訊息需要 Claude Code v2.1.199 或更高版本；在此之前，API 錯誤文字被返回給 Claude，就像它是子代理的結果一樣。672[subagent](/docs/zh-TW/sub-agents) 的 API 請求終止失敗，例如因為達到用量上限或伺服器錯誤的重試用完，所以 subagent 在完成其任務之前停止。此訊息需要 Claude Code v2.1.199 或更高版本；在此之前，API 錯誤文字被返回給 Claude，就像它是 subagent 的結果一樣。
664 673
665```text theme={null}674```text theme={null}
666Agent terminated early due to an API error: <error detail>675Agent terminated early due to an API error: <error detail>
668 677
669**該怎麼做：**678**該怎麼做：**
670 679
671* 將冒號後的錯誤詳細資訊與此頁面上的其自己的部分相符，例如[使用限制](#usage-limits)或[伺服器錯誤](#server-errors)，並遵循該部分的步驟680* 將冒號後的錯誤詳細資訊與此頁面上對應的部分相符，例如[用量上限](#usage-limits)或[伺服器錯誤](#server-errors)，並遵循該部分的步驟
672* 一旦基礎錯誤清除，請要求 Claude 重試任務或[恢復子代理](/docs/zh-TW/sub-agents#resume-subagents)681* 一旦基礎錯誤清除，請要求 Claude 重試任務或[恢復 subagent](/docs/zh-TW/sub-agents#resume-subagents)
673 682
674當速率限制、過載或伺服器錯誤中斷已經產生文字輸出的前景子代理時，Claude 會收到該部分輸出標記為不完整，而不是此錯誤。其唯一輸出是工具呼叫的子代理也會收到此錯誤；在 v2.1.199 中，該形狀返回了空部分結果。請參閱[子代理中的 API 錯誤](/docs/zh-TW/sub-agents#api-errors-in-subagents)。683當速率限制、過載或伺服器錯誤中斷已經產生文字輸出的前景 subagent 時，Claude 會收到該部分輸出標記為不完整，而不是此錯誤。其唯一輸出是工具呼叫的 subagent 也會收到此錯誤；在 v2.1.199 中，該形狀返回了空部分結果。請參閱 [subagent 中的 API 錯誤](/docs/zh-TW/sub-agents#api-errors-in-subagents)。
675 684
676<h2 id="usage-limits">685<h2 id="usage-limits">
677 使用限制686 使用限制
879* 如果變更持續失敗，請改為在瀏覽器中從您的 [claude.ai 計費設定](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)進行變更888* 如果變更持續失敗，請改為在瀏覽器中從您的 [claude.ai 計費設定](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)進行變更
880 889
881<h2 id="authentication-errors">890<h2 id="authentication-errors">
882 驗證錯誤891 身分驗證錯誤
883</h2>892</h2>
884 893
885這些錯誤表示 Claude Code 無法向 API 證明您的身份。隨時執行 `/status` 以查看目前哪個認證資格處於活動狀態。894這些錯誤表示 Claude Code 無法向 API 證明您的身分。您可以隨時執行 `/status` 以查看目前使用中的憑證。
886 895
887<h3 id="not-logged-in">896<h3 id="not-logged-in">
888 未登入897 未登入
889</h3>898</h3>
890 899
891此工作階段沒有有效的認證資格可用。900此工作階段沒有可用的有效憑證。
892 901
893```text theme={null}902```text theme={null}
894Not logged in · Please run /login903Not logged in · Please run /login
895```904```
896 905
897在 Claude Desktop 應用程式執行的工作階段中，例如 Code 標籤或 Cowork，訊息讀作 `Authentication required · Sign in again to continue`，您從應用程式再次登入。906在 Claude Desktop 應用程式執行的工作階段中（例如 Code 分頁或 Cowork），訊息會顯示為 `Authentication required · Sign in again to continue`，您需要從該應用程式重新登入。
898 907
899**該怎麼做：**908如果您在另一個使用相同[設定目錄](/docs/zh-TW/claude-directory)的 Claude Code 視窗中以 claude.ai 帳戶登入，顯示此訊息的互動式工作階段會自行開始使用該登入，無需重新啟動。
909
910在 macOS 上的 v2.1.286 之前版本中，從另一個視窗登入後，工作階段可能仍持續顯示此訊息。在這些版本中，請重新啟動顯示此訊息的工作階段。
900 911
901* 執行 `/login` 以使用您的 Claude 訂閱或 Console 帳戶進行驗證912**處理方式：**
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 913
906如果系統反覆提示您登入，請參閱[未登入或權杖已過期](/docs/zh-TW/troubleshoot-install#not-logged-in-or-token-expired)以取得系統時鐘檢查和 macOS 認證儲存復原步驟。914* 執行 `/login`，以您的 Claude 訂閱或 Console 帳戶進行身分驗證
915* 如果您預期透過環境變數進行身分驗證，請確認 `ANTHROPIC_API_KEY` 已在啟動 `claude` 的 shell 中設定並匯出
916* 對於無法進行互動式登入的 CI 或自動化情境，請設定 [`apiKeyHelper`](/docs/zh-TW/settings-reference#apikeyhelper) 指令碼，在啟動時取得金鑰
917* 請參閱[身分驗證優先順序](/docs/zh-TW/authentication#authentication-precedence)，了解存在多個憑證時 Claude Code 會使用哪一個
918
919如果系統反覆提示您登入，請參閱[未登入或 token 已過期](/docs/zh-TW/troubleshoot-install#not-logged-in-or-token-expired)，以了解系統時鐘檢查以及 macOS 憑證儲存的復原步驟。
907 920
908<h3 id="could-not-resolve-authentication-method">921<h3 id="could-not-resolve-authentication-method">
909 無法解析驗證方法922 無法解析身分驗證方式
910</h3>923</h3>
911 924
912工作階段到達 API 用戶端時沒有任何認證資格。[背景工作階段](/docs/zh-TW/agent-view)和雲端工作階段在背景工作程序啟動時沒有認證資格時會顯示此訊息。互動式、`-p` 和 Agent SDK 執行會將相同條件報告為[未登入](#not-logged-in)，並僅將此字串寫入其偵錯記錄，因此如果您在那裡找到它，請改為遵循該項目。925工作階段在沒有任何憑證的情況下抵達了 API 用戶端。當 worker 在沒有憑證的情況下啟動時，[背景工作階段](/docs/zh-TW/agent-view)和雲端工作階段會顯示此訊息。互動式、`-p` 和 Agent SDK 執行會將相同狀況回報為[未登入](#not-logged-in)，並僅將此字串寫入其除錯日誌，因此如果您是在日誌中發現此字串，請改依照該項目處理。
913 926
914```text theme={null}927```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 omitted928Could 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```929```
917 930
918在目前版本上，此錯誤表示背景工作程序沒有可用的認證資格。在 v2.1.174 之前，指派給閒置預初始化背景工作程序的背景工作階段即使在設定了有效認證資格時也可能以此方式失敗。在 v2.1.176 之前，在被聲稱之前處於閒置狀態的雲端工作階段也可能如此。請升級以復原。931在目前的版本中，此錯誤表示 worker 程序沒有可用的憑證。在 v2.1.174 之前，指派給閒置預先初始化 worker 的背景工作階段，即使已設定有效憑證，也可能以此方式失敗。在 v2.1.176 之前，被認領前處於閒置狀態的雲端工作階段也可能如此。請升級以復原。
919 932
920**該怎麼做：**933**處理方式：**
921 934
922* 如果此訊息出現在背景或雲端工作階段中，且您的認證資格已設定，請升級至 v2.1.176 或更新版本935* 如果此錯誤出現在背景或雲端工作階段中，且您的憑證已設定，請升級至 v2.1.176 或更新版本
923* 確認 `ANTHROPIC_API_KEY`、`CLAUDE_CODE_OAUTH_TOKEN` 或您的雲端提供者認證資格已在啟動背景工作程序的環境中設定，而不僅在您的互動式 shell 中設定936* 確認 `ANTHROPIC_API_KEY`、`CLAUDE_CODE_OAUTH_TOKEN` 或您的雲端供應商憑證已設定在啟動 worker 的環境中，而不僅是您的互動式 shell 中
924* 對於 Agent SDK，請參閱[快速入門中的驗證設定](/docs/zh-TW/agent-sdk/quickstart#setup)937* 若使用 Agent SDK，請參閱[快速入門中的身分驗證設定](/docs/zh-TW/agent-sdk/quickstart#setup)
925* 在相同環境中的互動式工作階段中執行 `/status` 以確認哪個認證資格來源會解析938* 在相同環境的互動式工作階段中執行 `/status`，確認解析到的是哪個憑證來源
926 939
927<h3 id="invalid-api-key">940<h3 id="invalid-api-key">
928 無效的 API 金鑰941 API 金鑰無效
929</h3>942</h3>
930 943
931`ANTHROPIC_API_KEY` 環境變數或 `apiKeyHelper` 指令碼傳回的金鑰被 API 拒絕，或 Claude Code 在傳送前阻止了來自 `ANTHROPIC_API_KEY` 的金鑰。944`ANTHROPIC_API_KEY` 環境變數或 `apiKeyHelper` 指令碼傳回了被 API 拒絕的金鑰，或者 Claude Code 在傳送前就封鎖了來自 `ANTHROPIC_API_KEY` 的金鑰。
932 945
933```text theme={null}946```text theme={null}
934Invalid API key · Fix external API key947Invalid API key · Fix external API key
935```948```
936 949
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)以瞭解如何讀取描述並修正該值。950當訊息在 `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 951
939**該怎麼做：**952**處理方式：**
940 953
941* 檢查拼寫錯誤，並確認金鑰未在 [Console](https://platform.claude.com/settings/keys) 中被撤銷954* 檢查是否有拼字錯誤，並在 [Console](https://platform.claude.com/settings/keys) 中確認金鑰未被撤銷
942* 在相同的 shell 中，執行 `env | grep ANTHROPIC`，或在 PowerShell 中執行 `Get-ChildItem Env:ANTHROPIC*`。direnv、dotenv shell 外掛程式和 IDE 終端機等工具可以從您專案中的 `.env` 檔案載入過時的金鑰，而無需您明確設定它955* 在同一個 shell 中執行 `env | grep ANTHROPIC`，或在 PowerShell 中執行 `Get-ChildItem Env:ANTHROPIC*`。direnv、dotenv shell 外掛和 IDE 終端機等工具可能會從專案中的 `.env` 檔案載入過時的金鑰，即使您並未明確設定它。
943* 取消設定 `ANTHROPIC_API_KEY` 並執行 `/login` 以改用訂閱驗證956* 取消設定 `ANTHROPIC_API_KEY` 並執行 `/login`，改用訂閱身分驗證
944* 如果金鑰來自 [`apiKeyHelper`](/docs/zh-TW/settings-reference#apikeyhelper) 指令碼，請直接執行該指令碼以確認它在 stdout 上列印有效的金鑰957* 如果金鑰來自 [`apiKeyHelper`](/docs/zh-TW/settings-reference#apikeyhelper) 指令碼，請直接執行該指令碼，確認它會在 stdout 上輸出有效的金鑰
945* 執行 `/status` 以確認 Claude Code 實際使用的認證資格來源958* 執行 `/status`，確認 Claude Code 實際使用的憑證來源
946 959
947<h3 id="your-apikeyhelper-script-is-failing">960<h3 id="your-apikeyhelper-script-is-failing">
948 您的 apiKeyHelper 指令碼失敗961 您的 apiKeyHelper 指令碼執行失敗
949</h3>962</h3>
950 963
951Claude Code 執行了您的 [`apiKeyHelper`](/docs/zh-TW/settings-reference#apikeyhelper) 設定中的命令，但沒有取回金鑰。沒有金鑰，請求會到達 API，並帶有預留位置認證資格，API 會以 `401` 拒絕它。終端機中的 `Authentication` 面板顯示發生了以下哪種情況：964Claude Code 執行了您 [`apiKeyHelper`](/docs/zh-TW/settings-reference#apikeyhelper) 設定中的命令，但沒有取得金鑰。沒有金鑰時，請求會帶著預留位置憑證抵達 API，而 API 會以 `401` 拒絕它。終端機中的 `Authentication` 面板會顯示發生了下列哪一種情況：
952 965
953* 命令以錯誤結束或逾時966* 命令以錯誤結束或逾時
954* 命令未向 stdout 列印任何內容967* 命令未在 stdout 輸出任何內容
955* 命令列印了除金鑰以外的內容，例如登入橫幅或記錄行。面板顯示 `returned output that cannot be used as an API key` 並說明出了什麼問題，而不重複輸出。在 v2.1.227 之前，Claude Code 會傳送命令列印的任何內容，在修剪周圍空白後。968* 命令輸出了金鑰以外的內容，例如登入橫幅或日誌行。面板會顯示 `returned output that cannot be used as an API key` 並說明問題所在，但不會重複輸出內容。在 v2.1.227 之前，Claude Code 會在去除前後空白後，直接傳送命令輸出的任何內容。
956 969
957```text theme={null}970```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 output971Your 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```972```
960 973
961在[非互動式模式](/docs/zh-TW/headless)中，stderr 也會帶有具體原因，前綴為 `apiKeyHelper failed:`。974在[非互動模式](/docs/zh-TW/headless)中，stderr 也會帶有具體原因，並以 `apiKeyHelper failed:` 作為前綴。
962 975
963Claude Code 會重新執行指令碼並在顯示此訊息之前最多重試請求兩次，因此失敗會在三次嘗試內出現。在 v2.1.208 之前，Claude Code 會花費完整的[重試預算](#automatic-retries)使用預留位置認證資格重新傳送請求，然後報告通用 `401` 驗證錯誤，而不是指令碼失敗。976Claude Code 在顯示此訊息之前，會重新執行指令碼並重試請求最多兩次，因此失敗會在三次嘗試內浮現。在 v2.1.208 之前，Claude Code 會用盡完整的[重試額度](#automatic-retries)以預留位置憑證重新傳送請求，然後回報一般性的 `401` 身分驗證錯誤，而非指令碼失敗。
964 977
965執行 `/login` 在這裡沒有幫助：只要設定存在，協助程式的輸出就會[優先於](/docs/zh-TW/authentication#authentication-precedence)已儲存的登入。978在這種情況下執行 `/login` 沒有幫助：只要該設定存在，helper 的輸出就會[優先於](/docs/zh-TW/authentication#authentication-precedence)已儲存的登入。
966 979
967**該怎麼做：**980**處理方式：**
968 981
969* 直接在您的 shell 中執行在 `apiKeyHelper` 中設定的命令以重現失敗982* 直接在 shell 中執行 `apiKeyHelper` 中設定的命令，以重現失敗情況
970* 如果命令報告工作階段已過期，請使用您的認證資格提供者重新驗證，例如再次登入您的 SSO 或機密保管庫983* 如果命令回報工作階段已過期，請向您的憑證供應商重新進行身分驗證，例如重新登入您的 SSO 或機密保管庫
971* 修正命令，使其僅將金鑰列印到 stdout，作為單一可列印 ASCII 權杖，最多 16,384 個字元，並以代碼 0 結束。請參閱[使用 apiKeyHelper 輪換認證資格](/docs/zh-TW/llm-gateway-connect#rotate-credentials-with-apikeyhelper)以取得有效的設定。984* 修正命令，使其僅將金鑰輸出到 stdout（單一個由可列印 ASCII 字元組成、最多 16,384 個字元的 token），並以代碼 0 結束。請參閱[使用 apiKeyHelper 輪替憑證](/docs/zh-TW/llm-gateway-connect#rotate-credentials-with-apikeyhelper)以取得可運作的設定。
972* 執行 `/status` 以確認 `apiKeyHelper` 是活動認證資格來源。`apiKeyHelper` 列顯示 `Failing` 及最後失敗的詳細資訊，例如結束代碼和命令的錯誤輸出，並在下次成功執行後消失。在 v2.1.274 之前，`/status` 僅顯示認證資格來源，不顯示失敗。985* 執行 `/status` 以查看失敗情況，並確認 `apiKeyHelper` 是使用中的憑證來源。`apiKeyHelper` 列會顯示 `Failing` 以及最近一次失敗的詳細資訊（例如退出碼和命令的錯誤輸出），並會在下一次成功執行後消失。在 v2.1.274 之前，`/status` 只會顯示憑證來源，不會顯示失敗情況。
973* 每次命令失敗時，其結束代碼和錯誤輸出也會出現在終端機中的 `Authentication` 面板中。在 v2.1.212 之前，該面板的標題為 `Cloud authentication`。986* 每次命令失敗時，其退出碼和錯誤輸出也會出現在終端機的 `Authentication` 面板中。在 v2.1.212 之前，該面板的標題為 `Cloud authentication`。
974 987
975<h3 id="invalid-request-header-value">988<h3 id="invalid-request-header-value">
976 無效的請求標頭值989 請求標頭值無效
977</h3>990</h3>
978 991
979Claude Code 即將作為請求標頭傳送的值包含 HTTP 標頭無法攜帶的字元：換行符、NUL 位元組或 `U+00FF` 以上的字元，例如彎引號或零寬空格。Claude Code 在傳送任何內容之前停止請求，並命名要修正的變數或設定。常見原因是從帶有隱藏字元或雜散換行符的文件或聊天中貼上的認證資格。992Claude Code 準備作為請求標頭傳送的值包含 HTTP 標頭無法承載的字元：換行、NUL 位元組，或高於 `U+00FF` 的字元，例如彎引號或零寬空格。Claude Code 會在傳送任何內容之前停止請求，並指出需要修正的變數或設定。常見原因是從文件或聊天中貼上的憑證帶有不可見字元或多餘的換行。
980 993
981Claude Code 在直接向 Claude API 或透過 [LLM 閘道](/docs/zh-TW/llm-gateway)傳送請求時執行此檢查。在第三方雲端提供者（例如 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock)）上，Claude Code 在傳送前不執行此檢查。994當 Claude Code 直接或透過 [LLM 閘道](/docs/zh-TW/llm-gateway)向 Claude API 傳送請求時，會執行此檢查。在 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) 等第三方雲端供應商上，Claude Code 不會在傳送前執行此檢查。
982 995
983```text theme={null}996```text theme={null}
984Invalid auth token · Fix external auth token997Invalid auth token · Fix external auth token
986Invalid request header from the environment · Fix the environment variable999Invalid request header from the environment · Fix the environment variable
987```1000```
988 1001
989訊息的第一部分取決於不良值的來源：1002訊息的第一部分取決於有問題的值來自何處：
990 1003
991* `Invalid auth token`：來自 [`ANTHROPIC_AUTH_TOKEN`](/docs/zh-TW/env-vars) 或 [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/zh-TW/env-vars) 的持有人權杖1004* `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`，而不重複名稱或值，因為您選擇了兩者。1005* `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`）複製到請求標頭中的值。描述命名要修正的變數。1006* `Invalid request header from the environment`：Claude Code 從另一個環境變數（例如 `CLAUDE_AGENT_SDK_CLIENT_APP`）複製到請求標頭中的值。說明會指出需要修正的變數。
994 1007
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)。1008Claude 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 1009
997在第二個 `·` 之後，訊息描述問題，如此完整範例所示：1010在第二個 `·` 之後，訊息會描述問題，如下列完整範例所示：
998 1011
999```text theme={null}1012```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).1013Invalid 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```1014```
1002 1015
1003位置從 1 開始計算字元。描述是從固定短語和字元計數建立的，因此它永遠不包括值本身。它僅在字元是眾所週知的隱藏或排版字元（例如位元組順序標記、零寬空格或彎引號）時命名該字元，並將其他任何內容報告為 `a non-ASCII character`。1016位置從 1 開始計算字元。說明由固定片語和字元數組成，因此永遠不會包含值本身。只有在問題字元是眾所周知的不可見字元或排版字元（例如位元組順序標記、零寬空格或彎引號）時，說明才會指出該字元名稱，其他情況則回報為 `a non-ASCII character`。
1004 1017
1005**該怎麼做：**1018**處理方式：**
1006 1019
1007* 重新設定訊息命名的變數或設定，重新輸入報告位置周圍的字元，而不是從相同來源再次貼上1020* 重新設定訊息所指出的變數或設定，並重新輸入回報位置附近的字元，而不是再次從相同來源貼上
1008* 對於 `ANTHROPIC_CUSTOM_HEADERS`，每行保留一個 `Name: Value` 對，並重寫訊息計數的對1021* 對於 `ANTHROPIC_CUSTOM_HEADERS`，每行保持一組 `Name: Value`，並重寫訊息所指出的那一組
1009* 執行 `/status` 以確認哪個認證資格來源處於活動狀態1022* 執行 `/status`，確認使用中的憑證來源
1010 1023
1011<h3 id="this-organization-has-been-disabled">1024<h3 id="this-organization-has-been-disabled">
1012 此組織已被停用1025 此組織已被停用
1013</h3>1026</h3>
1014 1027
1015Claude Code 正在使用來自已停用 Console 組織的過時 `ANTHROPIC_API_KEY`。當您有已儲存的訂閱登入時，金鑰會覆蓋它。1028Claude Code 正在使用來自已停用 Console 組織的過時 `ANTHROPIC_API_KEY`。當您有已儲存的訂閱登入時，該金鑰會覆寫它。
1016 1029
1017```text theme={null}1030```text theme={null}
1018Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your subscription instead1031Your 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.1033API Error: 400 ... This organization has been disabled.
1021```1034```
1022 1035
1023`·` 之後的提示取決於您的已儲存認證資格：當已儲存的 `/login` 可以在您取消設定金鑰後接管時出現第一種形式，當金鑰是您唯一的認證資格時出現第二種形式。1036`·` 之後的提示取決於您已儲存的憑證：當您取消設定金鑰後已儲存的 `/login` 可以接手時，會出現第一種形式；當金鑰是您唯一的憑證時，則出現第二種形式。
1024 1037
1025環境變數優先於 `/login`，因此在您的 shell 設定檔中匯出或從 `.env` 檔案載入的金鑰即使在您有有效的 Pro 或 Max 訂閱時也會被使用。在非互動式模式 (`-p`) 中，當存在金鑰時總是使用該金鑰。1038環境變數優先於 `/login`，因此即使您擁有可運作的 Pro 或 Max 訂閱，在 shell 設定檔中匯出或從 `.env` 檔案載入的金鑰仍會被使用。在非互動模式（`-p`）中，只要存在金鑰就一定會使用它。
1026 1039
1027**該怎麼做：**1040**處理方式：**
1028 1041
1029* 在目前的 shell 中取消設定 `ANTHROPIC_API_KEY` 並從您的 shell 設定檔中移除它，然後重新啟動 `claude`1042* 在目前的 shell 中取消設定 `ANTHROPIC_API_KEY`，並將其從 shell 設定檔中移除，然後重新啟動 `claude`
1030* 如果訊息說 `Update or unset`，您沒有已儲存的登入可以回退到。取消設定金鑰並執行 `/login`，或將金鑰替換為來自活動 Console 組織的金鑰。1043* 如果訊息顯示 `Update or unset`，表示您沒有可作為備援的已儲存登入。請取消設定金鑰並執行 `/login`，或將金鑰替換為來自使用中 Console 組織的金鑰。
1031* 之後執行 `/status` 以確認活動認證資格是您的訂閱1044* 之後執行 `/status`，確認使用中的憑證是您的訂閱
1032* 如果未設定環境變數且錯誤仍然存在，請聯絡支援或使用不同帳戶登入。1045* 如果未設定任何環境變數而錯誤仍然存在，請聯絡支援團隊或改用其他帳戶登入。
1033 1046
1034<h3 id="your-organization-has-disabled-api-key-authentication">1047<h3 id="your-organization-has-disabled-api-key-authentication">
1035 您的組織已停用 API 金鑰驗證1048 您的組織已停用 API 金鑰身分驗證
1036</h3>1049</h3>
1037 1050
1038此訊息需要 Claude Code v2.1.169 或更新版本。您的 Console 組織管理員已關閉 API 金鑰驗證，因此 API 拒絕 Claude Code 正在傳送的金鑰。恢復提示在 `·` 之後會根據金鑰的來源而異：1051此訊息需要 Claude Code v2.1.169 或更新版本。您 Console 組織的管理員已關閉 API 金鑰身分驗證，因此 API 會拒絕 Claude Code 傳送的金鑰。`·` 之後的復原提示會依金鑰來源而有所不同：
1039 1052
1040```text theme={null}1053```text theme={null}
1041Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account1054Your 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 account1058Your organization has disabled API key authentication · Sign in again with your claude.ai account
1046```1059```
1047 1060
1048最後一種形式出現在 Claude Desktop 應用程式執行的工作階段中，例如 Code 標籤或 Cowork，您從應用程式再次登入。1061最後一種形式出現在 Claude Desktop 應用程式執行的工作階段中（例如 Code 分頁或 Cowork），您需要從該應用程式重新登入。
1049 1062
1050環境變數和 `apiKeyHelper` 優先於 `/login`，因此在任一個仍在提供金鑰時單獨執行 `/login` 沒有幫助。請參閱[驗證優先順序](/docs/zh-TW/authentication#authentication-precedence)。1063環境變數和 `apiKeyHelper` 優先於 `/login`，因此只要其中任何一個仍在提供金鑰，單獨執行 `/login` 並沒有幫助。請參閱[身分驗證優先順序](/docs/zh-TW/authentication#authentication-precedence)。
1051 1064
1052**該怎麼做：**1065**處理方式：**
1053 1066
1054* 如果訊息命名 `ANTHROPIC_API_KEY`，在目前的 shell 中取消設定它，並從您的 shell 設定檔或 `.env` 檔案中移除它，然後重新啟動 `claude`1067* 如果訊息指出 `ANTHROPIC_API_KEY`，請在目前的 shell 中取消設定它，並將其從 shell 設定檔或 `.env` 檔案中移除，然後重新啟動 `claude`
1055* 如果訊息命名 `apiKeyHelper`，從您的 `settings.json` 中移除 [`apiKeyHelper`](/docs/zh-TW/settings-reference#apikeyhelper) 設定1068* 如果訊息指出 `apiKeyHelper`，請從您的 `settings.json` 中移除 [`apiKeyHelper`](/docs/zh-TW/settings-reference#apikeyhelper) 設定
1056* 執行 `/login` 以使用您的 claude.ai 帳戶登入1069* 執行 `/login`，以您的 claude.ai 帳戶登入
1057* 之後執行 `/status` 以確認活動認證資格是您的訂閱，而不是 API 金鑰1070* 之後執行 `/status`，確認使用中的憑證是您的訂閱而非 API 金鑰
1058* 如果您需要 API 金鑰驗證來進行自動化，請要求您的組織管理員在 Console 中重新啟用它1071* 如果您需要在自動化中使用 API 金鑰身分驗證，請要求組織管理員在 Console 中重新啟用它
1059 1072
1060<h3 id="your-organization-has-disabled-claude-subscription-access">1073<h3 id="your-organization-has-disabled-claude-subscription-access">
1061 您的組織已停用 Claude 訂閱存取1074 您的組織已停用 Claude 訂閱存取
1062</h3>1075</h3>
1063 1076
1064您的 Claude 組織不允許使用訂閱登入登入 Claude Code。使用相同帳戶再次執行 `/login` 會傳回相同的錯誤。1077您的 Claude 組織不允許以訂閱登入的方式登入 Claude Code。以相同帳戶再次執行 `/login` 會傳回相同的錯誤。
1065 1078
1066```text theme={null}1079```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 access1080Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access
1068```1081```
1069 1082
1070這是伺服器端組織設定，因此無法從本機設定、環境變數或 CLI 旗標覆蓋。1083這是伺服器端的組織設定，因此無法從本機設定、環境變數或 CLI 旗標覆寫。
1071 1084
1072Agent SDK 和 `-p` 非互動式模式將此呈現為 `oauth_org_not_allowed` 錯誤代碼。1085Agent SDK 和 `-p` 非互動模式會將此錯誤呈現為 `oauth_org_not_allowed` 錯誤代碼。
1073 1086
1074**該怎麼做：**1087**處理方式：**
1075 1088
1076* 要求您的管理員為您的組織啟用 Claude Code 存取1089* 要求您的管理員為您的組織啟用 Claude Code 存取
1077* 使用 Console API 金鑰而不是您的訂閱進行驗證。請參閱 [Claude Console 驗證](/docs/zh-TW/authentication#claude-console-authentication)以取得設定。1090* 改用 Console API 金鑰進行身分驗證，而非使用您的訂閱。設定方式請參閱 [Claude Console 身分驗證](/docs/zh-TW/authentication#claude-console-authentication)。
1078* 如果您是管理員且看不到啟用存取的選項，請聯絡 [Anthropic 支援](https://support.claude.com)1091* 如果您就是管理員，但看不到啟用存取的選項，請聯絡 [Anthropic 支援](https://support.claude.com)
1079 1092
1080<h3 id="routines-are-disabled-by-your-organizations-policy">1093<h3 id="routines-are-disabled-by-your-organizations-policy">
1081 您的組織政策已停用例行程序1094 Routine 已被您組織的政策停用
1082</h3>1095</h3>
1083 1096
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.1097您 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 1098
1086```text theme={null}1099```text theme={null}
1087Routines are disabled by your organization's policy.1100Routines are disabled by your organization's policy.
1088```1101```
1089 1102
1090這是伺服器端設定，因此無法從本機設定、環境變數或 CLI 旗標覆蓋。1103這是伺服器端設定，因此無法從本機設定、環境變數或 CLI 旗標覆寫。
1091 1104
1092**該怎麼做：**1105**處理方式：**
1093 1106
1094* 要求您的組織中的擁有者在 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) 啟用**例行程序**切換1107* 要求您組織中的 Owner 在 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) 啟用 **Routines** 切換開關
1095* 對於不需要組織層級例行程序的一次性排程工作，請參閱[排程工作](/docs/zh-TW/scheduled-tasks)1108* 對於不需要組織層級 routine 的一次性排程工作，請參閱[排程任務](/docs/zh-TW/scheduled-tasks)
1096 1109
1097<h3 id="remote-control-requires-the-anthropic-api">1110<h3 id="remote-control-requires-the-anthropic-api">
1098 Remote Control 需要 Anthropic API1111 Remote Control 需要 Anthropic API
1099</h3>1112</h3>
1100 1113
1101工作階段未直接與 Anthropic API 通訊，因此沒有 claude.ai 後端供 [Remote Control](/docs/zh-TW/remote-control) 配對。1114此工作階段並未直接與 Anthropic API 通訊，而這是 [Remote Control](/docs/zh-TW/remote-control) 的必要條件。
1102 1115
1103```text theme={null}1116```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.1117Remote 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```1118```
1106 1119
1107第二句解釋了什麼將工作階段路由到遠離 Anthropic API；在 v2.1.219 之前，訊息僅為第一句。根據原因，訊息命名：1120第二句會說明是什麼讓工作階段繞過了 Anthropic API；在 v2.1.219 之前，訊息只有第一句。根據原因不同，訊息會指出：
1108 1121
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`1122* `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`
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 Control1123* [`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` 傳送其請求1124* 已設定 `ANTHROPIC_UNIX_SOCKET`，因此工作階段會透過本機 socket 傳送請求，而非傳送至 `api.anthropic.com`
1112* 企業[雲端閘道](/docs/zh-TW/claude-apps-gateway)透過 `/login` 進行的登入，不支援 Remote Control，且沒有變數可取消設定1125* 透過 `/login` 完成的企業[雲端閘道](/docs/zh-TW/claude-apps-gateway)登入，它不支援 Remote Control，也沒有可取消設定的變數
1113 1126
1114**該怎麼做：**1127**處理方式：**
1115 1128
1116* 取消設定訊息命名的變數，例如 `CLAUDE_CODE_USE_BEDROCK` 或 `ANTHROPIC_BASE_URL`，並重新啟動工作階段，或從直接與 Anthropic API 通訊的工作階段啟動 Remote Control1129* 取消設定訊息所指出的變數（例如 `CLAUDE_CODE_USE_BEDROCK` 或 `ANTHROPIC_BASE_URL`）並重新啟動工作階段，或從直接與 Anthropic API 通訊的工作階段啟動 Remote Control
1117* 如果變數未在您的 shell 中設定，請檢查您的[設定檔](/docs/zh-TW/settings#where-settings-live)中的 `env` 金鑰，該金鑰將環境變數套用到每個工作階段1130* 如果您的 shell 中未設定該變數，請檢查[設定檔](/docs/zh-TW/settings#where-settings-live)中的 `env` 鍵，它會將環境變數套用到每個工作階段
1118* 對於此和其他 Remote Control 啟動訊息，請參閱[疑難排解 Remote Control](/docs/zh-TW/remote-control#troubleshooting)1131* 關於此訊息及其他 Remote Control 啟動訊息，請參閱[Remote Control 疑難排解](/docs/zh-TW/remote-control#troubleshooting)
1119 1132
1120<h3 id="remote-control-couldnt-refresh-your-login">1133<h3 id="remote-control-couldnt-refresh-your-login">
1121 Remote Control 無法重新整理您的登入1134 Remote Control 無法重新整理您的登入
1122</h3>1135</h3>
1123 1136
1124Claude Code 在短期認證資格上執行即時 [Remote Control](/docs/zh-TW/remote-control) 連線，該認證資格是使用您已儲存的 claude.ai 登入取得和更新的。當 claude.ai 停止接受該登入，或 Claude Code 沒有剩餘的已儲存登入時，Claude Code 會停止 Remote Control 並需要您再次登入。任一失敗都可能在 Claude Code 仍在連線時或稍後在更新認證資格時發生。1137Claude Code 以短期憑證執行即時的 [Remote Control](/docs/zh-TW/remote-control) 連線，這些憑證是使用您已儲存的 claude.ai 登入取得並續期的。當 claude.ai 不再接受該登入，或 Claude Code 已沒有任何已儲存的登入時，Claude Code 會停止 Remote Control，並需要您重新登入。這兩種失敗都可能發生在 Claude Code 仍在連線時，或之後續期憑證時。
1125 1138
1126當 Claude Code 要求登入服務重新整理您的已儲存登入並且沒有收到答案時，它會保持 Remote Control 執行並在連線的目前認證資格仍然有效時再次嘗試重新整理。當 Claude Code 無法到達登入服務、請求逾時或服務在不拒絕您的登入的情況下失敗時，重新整理會沒有答案。如果登入服務在該認證資格過期時仍未回答，Claude Code 會停止 Remote Control 並報告 `OAuth token refresh failed`。1139當 Claude Code 要求登入服務重新整理您已儲存的登入卻未得到回應時，它會讓 Remote Control 繼續執行，並在連線目前的憑證仍有效時再次嘗試重新整理。當 Claude Code 無法連上登入服務、請求逾時，或服務失敗但未拒絕您的登入時，重新整理就會得不到回應。如果該憑證到期時登入服務仍未回應，Claude Code 會停止 Remote Control 並回報 `OAuth token refresh failed`。
1127 1140
1128當 Claude Code 停止 Remote Control 時，它會在警告和以 `Remote Control disconnected` 開頭的文字記錄行中顯示原因。您的本機工作階段會繼續執行，但沒有 Remote Control。本節涵蓋這些行：1141當 Claude Code 停止 Remote Control 時，會在警告以及以 `Remote Control disconnected` 開頭的逐字稿行中顯示原因。您的本機工作階段會在沒有 Remote Control 的情況下繼續執行。本節涵蓋下列訊息行：
1129 1142
1130```text theme={null}1143```text theme={null}
1131Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control1144Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control
1137Remote Control disconnected — Signed out of Claude — run /login, then /remote-control1150Remote Control disconnected — Signed out of Claude — run /login, then /remote-control
1138```1151```
1139 1152
1140Claude Code 在訊息中間命名原因：1153Claude Code 會在訊息中間指出原因：
1141 1154
1142* ` Claude.ai login expired` 和 `Claude.ai login was rejected`：claude.ai 不再接受您的已儲存登入權杖，因為它已過期或被撤銷1155* `Claude.ai login expired` 和 `Claude.ai login was rejected`：claude.ai 不再接受您已儲存的登入 token，因為它已過期或被撤銷
1143* ` OAuth token unavailable`：當連線的認證資格到期進行更新時，Claude Code 沒有已儲存的登入權杖1156* `OAuth token unavailable`：當連線的憑證到期需要續期時，Claude Code 沒有已儲存的登入 token
1144* `OAuth token refresh failed`：claude.ai 在 Claude Code 重新連線時拒絕了您的已儲存登入權杖，重新整理權杖未產生新的權杖1157* `OAuth token refresh failed`：在 Claude Code 重新連線時，claude.ai 拒絕了您已儲存的登入 token，而重新整理 token 也沒有產生新的 token
1145* `JWT refresh failed: no OAuth token`：Claude Code 找不到已儲存的登入權杖來更新1158* `JWT refresh failed: no OAuth token`：Claude Code 找不到可用於續期的已儲存登入 token
1146* ` Signed out of Claude`：您在此機器上登出，例如在另一個終端機中執行 `/logout`，因此 Claude Code 沒有剩餘的已儲存登入來更新連線1159* `Signed out of Claude`：您已在此電腦上登出，例如在另一個終端機中執行了 `/logout`，因此 Claude Code 已沒有可用於續期連線的已儲存登入
1147 1160
1148**該怎麼做：**1161**處理方式：**
1149 1162
1150* 執行 `/login` 以再次登入1163* 執行 `/login` 重新登入
1151* 執行 `/remote-control` 以重新連線工作階段。以 `run /login to restore Remote Control` 結尾的訊息不需要此步驟：Claude Code 在您登入後會自動重新連線。1164* 執行 `/remote-control` 重新連線工作階段。以 `run /login to restore Remote Control` 結尾的訊息不需要此步驟：您登入後，Claude Code 會自行重新連線。
1152 1165
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 中新增。1166在 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 1167
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`。1168在 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 1169
1157<h3 id="remote-control-stopped-because-the-signed-in-account-changed">1170<h3 id="remote-control-stopped-because-the-signed-in-account-changed">
1158 Remote Control 因為已登入帳戶已變更而停止1171 因登入帳戶變更而停止 Remote Control
1159</h3>1172</h3>
1160 1173
1161Claude Code 在 [Remote Control](/docs/zh-TW/remote-control) 工作階段期間顯示此行，當您在此機器上登入不同的 claude.ai 帳戶或組織時。您在 Claude Code 工作階段外進行了切換，例如在另一個終端機中執行 `/login`。1174在 [Remote Control](/docs/zh-TW/remote-control) 工作階段期間，當您在此電腦上登入不同的 claude.ai 帳戶或組織時，Claude Code 會顯示此訊息行。您是在 Claude Code 工作階段之外進行切換的，例如在另一個終端機中執行 `/login`。
1162 1175
1163您在透過 `/login` 登入時啟動的 Remote Control 工作階段屬於當時登入的 claude.ai 帳戶和組織。1176您透過 `/login` 登入時啟動的 Remote Control 工作階段，屬於當時已登入的 claude.ai 帳戶和組織。
1164 1177
1165```text theme={null}1178```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-control1179Remote 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```1180```
1168 1181
1169Claude Code 在 claude.ai 確認帳戶或組織已變更後立即停止 Remote Control 工作階段。您的本機工作階段會繼續執行，但沒有 Remote Control。1182一旦 claude.ai 確認帳戶或組織已變更，Claude Code 就會停止 Remote Control 工作階段。您的本機工作階段會在沒有 Remote Control 的情況下繼續執行。
1170 1183
1171**該怎麼做：**1184**處理方式：**
1172 1185
1173* 執行 `/remote-control` 以在目前帳戶或組織下啟動新的 Remote Control 工作階段1186* 執行 `/remote-control`，在目前的帳戶或組織下啟動新的 Remote Control 工作階段
1174* 若要切換回去，請執行 `/login` 並再次登入先前的帳戶或組織。然後執行 `/remote-control`。1187* 若要切換回去，請執行 `/login` 並再次登入先前的帳戶或組織，然後執行 `/remote-control`。
1175 1188
1176在 v2.1.234 之前，當您在 Claude Code 工作階段外切換到不同帳戶或組織時，Claude Code 沒有注意到。Claude Code 保持 Remote Control 工作階段連線，直到稍後對 Remote Control 伺服器的請求失敗，並顯示 `Remote Control server rejected the request (HTTP 404)`。該失敗可能在切換後數小時才出現。1189在 v2.1.234 之前，當您在 Claude Code 工作階段之外切換到不同的帳戶或組織時，Claude Code 不會察覺。Claude Code 會讓 Remote Control 工作階段保持連線，直到之後對 Remote Control 伺服器的請求以 `Remote Control server rejected the request (HTTP 404)` 失敗為止。該失敗可能在切換後數小時才發生。
1177 1190
1178<h3 id="remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts">1191<h3 id="remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts">
1179 Remote Control 因為執行工作階段的應用程式登出或切換帳戶而停止1192 因執行工作階段的應用程式已登出或切換帳戶而停止 Remote Control
1180</h3>1193</h3>
1181 1194
1182當 Claude 桌面應用程式或 IDE 主持您的工作階段時，Claude Code 從該應用程式而不是從 `/login` 取得其登入權杖。當 claude.ai 拒絕該權杖時，Claude Code 要求應用程式提供新的權杖。如果應用程式回答它已登出，或它現在已登入不同的 Claude 帳戶，Claude Code 會結束 [Remote Control](/docs/zh-TW/remote-control) 工作階段並向應用程式傳送以下其中一行：1195當 Claude 桌面應用程式或 IDE 承載您的工作階段時，Claude Code 會從該應用程式取得登入 token，而非透過 `/login`。當 claude.ai 拒絕該 token 時，Claude Code 會向應用程式要求新的 token。如果應用程式回應它已登出，或現在已登入不同的 Claude 帳戶，Claude Code 會結束 [Remote Control](/docs/zh-TW/remote-control) 工作階段，並向應用程式傳送下列其中一行訊息：
1183 1196
1184```text theme={null}1197```text theme={null}
1185Remote Control stopped — the app running this session is now signed in to a different Claude account1198Remote 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 on1199Remote Control stopped — the app running this session is signed out of Claude. Sign in there, then turn Remote Control back on
1187```1200```
1188 1201
1189您的本機工作階段會繼續執行，但沒有 Remote Control。1202您的本機工作階段會在沒有 Remote Control 的情況下繼續執行。
1190 1203
1191**該怎麼做：**1204**處理方式：**
1192 1205
1193* 如果應用程式已登出，請再次登入，然後在應用程式中重新開啟 Remote Control1206* 如果應用程式已登出，請重新登入，然後在應用程式中重新開啟 Remote Control
1194* 如果應用程式切換了帳戶，Claude Code 無法在新帳戶下繼續已結束的工作階段。在該帳戶下啟動新的 Remote Control 工作階段。1207* 如果應用程式切換了帳戶，Claude Code 無法在新帳戶下繼續已結束的工作階段。請在該帳戶下啟動新的 Remote Control 工作階段。
1195 1208
1196在 v2.1.238 之前，Claude Code 在兩種情況下都向應用程式傳送了[Remote Control 無法重新整理您的登入](#remote-control-couldnt-refresh-your-login)下列出的 `run /login` 訊息。1209在 v2.1.238 之前，這兩種情況下 Claude Code 都會向應用程式傳送[Remote Control 無法重新整理您的登入](#remote-control-couldnt-refresh-your-login)中列出的 `run /login` 訊息。
1197 1210
1198<h3 id="oauth-token-revoked-or-expired">1211<h3 id="oauth-token-revoked-or-expired">
1199 OAuth 權杖已撤銷或已過期1212 OAuth token 已撤銷或已過期
1200</h3>1213</h3>
1201 1214
1202您的已儲存登入不再有效。撤銷的權杖表示您在任何地方登出或管理員移除了存取；已過期的權杖表示自動重新整理在工作階段中失敗。1215您已儲存的登入已不再有效。token 被撤銷表示您已在所有地方登出，或管理員移除了存取權；token 過期表示工作階段中途的自動重新整理失敗了。
1203 1216
1204兩個訊息都報告 API 為 Claude Code 傳送的請求傳回的拒絕。當已儲存的登入在失敗的重新整理後已被清除時，您會看到[登入已過期](#login-expired)。如果您在 [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/zh-TW/env-vars) 中使用長期權杖進行驗證，當該權杖過期或被撤銷時，您會看到相同的訊息。1217這兩則訊息都是回報 API 針對 Claude Code 所傳送請求的拒絕。如果已儲存的登入在重新整理失敗後已被清除，您會改為看到[登入已過期](#login-expired)。如果您在 [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/zh-TW/env-vars) 中使用長期 token 進行身分驗證，當該 token 過期或被撤銷時，您也會看到相同的訊息。
1205 1218
1206```text theme={null}1219```text theme={null}
1207OAuth token revoked · Please run /login1220OAuth token revoked · Please run /login
1208Please run /login · API Error: 401 OAuth token has expired ...1221Please run /login · API Error: 401 OAuth token has expired ...
1209```1222```
1210 1223
1211**該怎麼做：**1224**處理方式：**
1212 1225
1213* 執行 `/login` 以再次登入1226* 執行 `/login` 重新登入
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 錯誤。1227* 如果您使用 `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 錯誤失敗。
1215* 對於跨啟動的重複登入提示，請參閱[疑難排解](/docs/zh-TW/troubleshoot-install#not-logged-in-or-token-expired)中的系統時鐘檢查和 macOS 認證儲存復原步驟1228* 若每次啟動都反覆提示登入，請參閱[疑難排解](/docs/zh-TW/troubleshoot-install#not-logged-in-or-token-expired)中的系統時鐘檢查和 macOS 憑證儲存復原步驟
1216* 對於其他失敗，包括 `403 Forbidden` 和 OAuth 瀏覽器問題，請參閱[登入和驗證](/docs/zh-TW/troubleshoot-install#login-and-authentication)1229* 關於其他失敗情況（包括 `403 Forbidden` 和 OAuth 瀏覽器問題），請參閱[登入與身分驗證](/docs/zh-TW/troubleshoot-install#login-and-authentication)
1217 1230
1218<h3 id="api-error-401-invalid-authentication-credentials">1231<h3 id="api-error-401-invalid-authentication-credentials">
1219 API 錯誤：401 無效的驗證認證資格1232 API Error: 401 Invalid authentication credentials
1220</h3>1233</h3>
1221 1234
1222API 識別了您的認證資格格式，但拒絕了其背後的帳戶或組織。當認證資格最近被撤銷、組織被停用或移除了您的存取，或帳戶本身被停用時，Anthropic 會傳回此訊息，因此過期的權杖不是原因。認證資格可以是您的已儲存登入或已核准的 `ANTHROPIC_API_KEY`，修正方式不同，因此首先執行 `/status` 以查看哪一個處於活動狀態。1235API 辨識出您憑證的格式，但拒絕了其背後的帳戶或組織。當憑證最近被撤銷、組織已停用或移除了您的存取權，或帳戶本身已被停用時，Anthropic 會傳回此訊息，因此原因並非 token 過期。該憑證可能是您已儲存的登入，也可能是已核准的 `ANTHROPIC_API_KEY`，而修正方式各不相同，因此請先執行 `/status` 查看使用中的是哪一個。
1223 1236
1224```text theme={null}1237```text theme={null}
1225Please run /login · API Error: 401 Invalid authentication credentials1238Please run /login · API Error: 401 Invalid authentication credentials
1226```1239```
1227 1240
1228**該怎麼做：**1241**處理方式：**
1229 1242
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`。1243* 如果 `/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` 一次。如果認證資格被撤銷，新的登入會替換它。1244* 如果 `/status` 只顯示您的登入，請執行一次 `/login`。如果憑證已被撤銷，新的登入會取代它。
1232* 如果相同的訊息對相同的登入帳戶返回，則帳戶或組織不再活動。檢查 `/status` 報告的帳戶和組織，並要求您的組織管理員恢復存取。1245* 如果同一個登入帳戶再次出現相同訊息，表示該帳戶或組織已不再有效。請檢查 `/status` 回報的帳戶和組織，並要求組織管理員恢復存取權。
1233* 如果 [`ANTHROPIC_BASE_URL`](/docs/zh-TW/env-vars) 指向 [LLM 閘道](/docs/zh-TW/llm-gateway)，`401` 之後的文字是您的閘道訊息，而不是 Anthropic 的訊息，`/login` 不會改變它。改為修正您的閘道期望的認證資格。1246* 如果 [`ANTHROPIC_BASE_URL`](/docs/zh-TW/env-vars) 指向 [LLM 閘道](/docs/zh-TW/llm-gateway)，`401` 之後的文字是您閘道的訊息而非 Anthropic 的訊息，`/login` 無法改變它。請改為修正您閘道所預期的憑證。
1234 1247
1235<h3 id="login-expired">1248<h3 id="login-expired">
1236 登入已過期1249 登入已過期
1237</h3>1250</h3>
1238 1251
1239Claude Code 嘗試更新您已儲存的 claude.ai 或 Claude Console 登入，OAuth 服務拒絕了已儲存的重新整理權杖，因此 Claude Code 清除了已儲存的認證資格。之後，每個模型請求在到達 API 之前都會在本機停止，並顯示此訊息，因為只有 `/login` 可以建立新的認證資格。1252Claude Code 嘗試續期您已儲存的 claude.ai 登入，但 OAuth 服務拒絕了已儲存的 refresh token，因此 Claude Code 清除了已儲存的憑證。之後，每個模型請求都會在抵達 API 之前於本機以此訊息停止，因為只有 `/login` 能建立新的憑證。
1240 1253
1241在 v2.1.206 之前，Claude Code 無論如何都會傳送模型請求，並使用環境中剩餘的任何認證資格，每個模型都會失敗，並顯示[所選模型有問題](#theres-an-issue-with-the-selected-model)或 401，而不是登入提示。1254在 v2.1.206 之前，Claude Code 仍會以環境中剩餘的任何憑證傳送模型請求，而每個模型隨後都會以[所選模型有問題](#theres-an-issue-with-the-selected-model)或 401 失敗，而非提示您登入。
1242 1255
1243```text theme={null}1256```text theme={null}
1244Login expired · Please run /login1257Login expired · Please run /login
1245```1258```
1246 1259
1247在[非互動式模式](/docs/zh-TW/headless)(`-p`) 和 [Agent SDK](/docs/zh-TW/agent-sdk/overview) 中，訊息讀作如下，結構化錯誤代碼為 `authentication_failed`：1260在[非互動模式](/docs/zh-TW/headless)（`-p`）和 [Agent SDK](/docs/zh-TW/agent-sdk/overview) 中，訊息如下，且結構化錯誤代碼為 `authentication_failed`：
1248 1261
1249```text theme={null}1262```text theme={null}
1250Failed to authenticate: OAuth session expired and could not be refreshed1263Failed to authenticate: OAuth session expired and could not be refreshed
1251```1264```
1252 1265
1253這與[OAuth 權杖已撤銷或已過期](#oauth-token-revoked-or-expired)的狀態不同。這些訊息報告 API 傳回的拒絕。Claude Code 本身為已失敗更新的登入產生 `Login expired`，因此它不傳送請求。當更新失敗是因為帳戶本身被暫停而不是登入過時時，Claude Code 會改為顯示[您的帳戶已被暫停](#your-account-is-on-hold)。1266這與 [OAuth token 已撤銷或已過期](#oauth-token-revoked-or-expired)並非相同的狀態。那些訊息回報的是 API 傳回的拒絕。`Login expired` 則是 Claude Code 自己針對已續期失敗的登入所產生的，因此不會傳送任何請求。當續期失敗的原因是帳戶本身被停權，而非登入過時時，Claude Code 會改為顯示[您的帳戶已被暫停](#your-account-is-on-hold)。
1254 1267
1255使用 API 金鑰、[`CLAUDE_CODE_OAUTH_TOKEN`](/docs/zh-TW/env-vars) 或第三方提供者進行驗證的工作階段不使用已儲存的登入，永遠不會看到此訊息。1268使用 API 金鑰、[`CLAUDE_CODE_OAUTH_TOKEN`](/docs/zh-TW/env-vars) 或第三方供應商進行身分驗證的工作階段不會使用已儲存的登入，因此永遠不會看到此訊息。
1256 1269
1257您可以在請求失敗之前檢查此狀態：[`/status`](/docs/zh-TW/commands) 顯示讀作 `Expired — log in again` 的 `Login` 列，加上它為過期登入儲存的組織和電子郵件。該列僅在已儲存的登入是您的活動認證資格且無法再更新時出現。以其他方式進行驗證的工作階段不會顯示該列，即使已儲存的過期登入仍然存在。在 v2.1.210 之前，`/status` 在此狀態下沒有指示登入曾經存在過，因為已清除的認證資格沒有留下任何內容供其報告。1270您可以在請求失敗之前檢查是否處於此狀態：[`/status`](/docs/zh-TW/commands) 會顯示內容為 `Expired — log in again` 的 `Login` 列，以及為該過期登入所儲存的組織和電子郵件。只有當已儲存的登入是您使用中的憑證且無法再重新整理時，才會出現此列。以其他方式進行身分驗證的工作階段不會顯示此列，即使仍儲存著過期的登入也是如此。在 v2.1.210 之前，`/status` 在此狀態下不會顯示任何曾經存在登入的跡象，因為被清除的憑證已沒有任何可回報的內容。
1258 1271
1259**該怎麼做：**1272**處理方式：**
1260 1273
1261* 執行 `/login` 以再次登入。在不登入的情況下重試會在每個請求上顯示相同的訊息。1274* 執行 `/login` 重新登入。未登入就重試，每個請求都會顯示相同的訊息。
1262* 在非互動式模式中，在相同環境中執行 `claude`，完成 `/login`，然後重新執行您的命令。對於無法以互動方式登入的自動化，使用 `ANTHROPIC_API_KEY` 或[使用 `claude setup-token` 產生長期權杖](/docs/zh-TW/authentication#generate-a-long-lived-token)進行驗證。1275* 如果您在另一個 Claude Code 視窗中以 claude.ai 帳戶登入，請參閱[未登入](#not-logged-in)，了解此工作階段何時會自行開始使用該登入。
1263* 如果登入持續失敗，請參閱[登入和驗證](/docs/zh-TW/troubleshoot-install#login-and-authentication)1276* 在非互動模式中，請在相同環境中執行 `claude`，完成 `/login`，然後重新執行您的命令。對於無法互動式登入的自動化，請使用 `ANTHROPIC_API_KEY` 進行身分驗證，或[使用 `claude setup-token` 產生長期 token](/docs/zh-TW/authentication#generate-a-long-lived-token)。
1277* 如果登入持續失敗，請參閱[登入與身分驗證](/docs/zh-TW/troubleshoot-install#login-and-authentication)
1264 1278
1265<h3 id="could-not-refresh-your-login">1279<h3 id="could-not-refresh-your-login">
1266 無法重新整理您的登入，因為另一個 Claude Code 程序正在重新整理它1280 因另一個 Claude Code 程序正在重新整理，無法重新整理您的登入
1267</h3>1281</h3>
1268 1282
1269此訊息不表示您的登入被拒絕。您的已儲存 claude.ai 登入已過期，需要更新。此機器上的另一個 Claude Code 程序持有共用重新整理鎖定，或退出並將其留下，重新整理在此工作階段等待時沒有進展。Claude Code 在傳送前停止請求：1283此訊息並不表示您的登入被拒絕。您已儲存的 claude.ai 登入已過期而需要續期。同一台電腦上的另一個 Claude Code 程序持有共用的重新整理鎖定，或在結束時遺留了該鎖定，而在此工作階段等待期間，重新整理沒有任何進展。Claude Code 會在傳送前停止請求：
1270 1284
1271```text theme={null}1285```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 /login1286Could 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```1287```
1274 1288
1275在[非互動式模式](/docs/zh-TW/headless)(`-p`) 和 [Agent SDK](/docs/zh-TW/agent-sdk/overview) 中，訊息讀作如下，結構化錯誤代碼為 `server_error`：1289在[非互動模式](/docs/zh-TW/headless)（`-p`）和 [Agent SDK](/docs/zh-TW/agent-sdk/overview) 中，訊息如下，且結構化錯誤代碼為 `server_error`：
1276 1290
1277```text theme={null}1291```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 again1292Failed 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```1293```
1280 1294
1281使用 API 金鑰、[`CLAUDE_CODE_OAUTH_TOKEN`](/docs/zh-TW/env-vars) 或第三方提供者進行驗證的工作階段不使用已儲存的登入，永遠不會看到此訊息。1295使用 API 金鑰、[`CLAUDE_CODE_OAUTH_TOKEN`](/docs/zh-TW/env-vars) 或第三方供應商進行身分驗證的工作階段不會使用已儲存的登入，因此永遠不會看到此訊息。
1282 1296
1283**該怎麼做：**1297**處理方式：**
1284 1298
1285* 一分鐘後重試。如果另一個程序首先完成重新整理，此工作階段會使用更新的登入。1299* 一分鐘後再試一次。如果另一個程序先完成重新整理，此工作階段就會使用續期後的登入。
1286* 如果訊息持續返回，請關閉其他 Claude Code 視窗和程序，然後重試。1300* 如果訊息持續出現，請關閉其他 Claude Code 視窗和程序，然後重試。
1287* 如果在沒有其他 Claude Code 程序執行的情況下返回，請執行 `/login`。再次登入不會等待重新整理鎖定。1301* 如果在沒有其他 Claude Code 程序執行的情況下仍出現此訊息，請執行 `/login`。重新登入不需要等待重新整理鎖定。
1288 1302
1289<h3 id="couldnt-save-your-login">1303<h3 id="couldnt-save-your-login">
1290 無法儲存您的登入1304 無法儲存您的登入
1291</h3>1305</h3>
1292 1306
1293您使用 claude.ai 登入，但 Claude Code 無法將登入儲存到其認證資格存放區，因此登入未完成。在 macOS 上，當登入鑰匙圈鎖定時（例如在睡眠或閒置時），在 Claude Code 已在同一工作階段中讀取或儲存認證資格之後，可能會發生這種情況。1307您已以 claude.ai 登入，但 Claude Code 無法將登入儲存到其憑證存放區，因此登入未完成。在 macOS 上，如果 Claude Code 已在同一個工作階段中讀取或儲存過登入鑰匙圈中的憑證，而之後鑰匙圈被鎖定（例如因睡眠或閒置），就可能發生這種情況。
1294 1308
1295```text theme={null}1309```text theme={null}
1296Couldn't save your login. If your Mac's keychain is locked, unlock it and log in again.1310Couldn'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.1311Couldn't save your login. Try logging in again.
1298```1312```
1299 1313
1300第一種形式出現在 macOS 上，第二種形式出現在其他地方。暫時性認證資格存放區失敗（例如逾時或無法讀取的存放區）會產生相同的訊息。1314第一種形式出現在 macOS 上，第二種則出現在其他所有平台上。暫時性的憑證存放區失敗（例如逾時或存放區無法讀取）也會產生相同的訊息。
1301 1315
1302**該怎麼做：**1316**處理方式：**
1303 1317
1304* 在 macOS 上，解鎖登入鑰匙圈，然後再次執行 `/login`1318* 在 macOS 上，解鎖登入鑰匙圈，然後再次執行 `/login`
1305* 在其他平台上，再次執行 `/login`1319* 在其他平台上，再次執行 `/login`
1306* 如果登入仍未儲存，請參閱[未登入或權杖已過期](/docs/zh-TW/troubleshoot-install#not-logged-in-or-token-expired)以取得鑰匙圈解鎖命令和其他認證資格儲存復原步驟1320* 如果登入仍無法儲存，請參閱[未登入或 token 已過期](/docs/zh-TW/troubleshoot-install#not-logged-in-or-token-expired)，以取得鑰匙圈解鎖命令和其他憑證儲存復原步驟
1307 1321
1308<h3 id="failed-to-start-oauth-callback-server">1322<h3 id="failed-to-start-oauth-callback-server">
1309 無法啟動 OAuth 回呼伺服器1323 無法啟動 OAuth 回呼伺服器
1310</h3>1324</h3>
1311 1325
1312當 `/login`、`claude auth login` 或 `claude setup-token` 透過瀏覽器簽署您時，Claude Code 在 `127.0.0.1` 上開啟一個監聽連接埠，以便您的瀏覽器可以將登入結果傳回給它。此訊息表示 Claude Code 無法開啟該連接埠，登入在瀏覽器視窗或登入 URL 出現之前停止：1326當 `/login`、`claude auth login` 或 `claude setup-token` 透過瀏覽器讓您登入時，Claude Code 會在 `127.0.0.1` 上開啟一個監聽連接埠，讓您的瀏覽器可以將登入結果傳回給它。此訊息表示 Claude Code 無法開啟該連接埠，登入會在瀏覽器視窗或登入 URL 出現之前停止：
1313 1327
1314```text theme={null}1328```text theme={null}
1315Failed to start OAuth callback server: Failed to start server. Is port 0 in use?1329Failed to start OAuth callback server: Failed to start server. Is port 0 in use?
1316```1330```
1317 1331
1318如果您的訊息以 `Is port 0 in use?` 結尾，嘗試在 IPv4 loopback 位址 `127.0.0.1` 上監聽的嘗試完全失敗。因為失敗發生在登入 URL 存在之前，`Paste code here if prompted` 流程不可用作為解決方法。1332如果您的訊息以 `Is port 0 in use?` 結尾，表示嘗試在 IPv4 loopback 位址 `127.0.0.1` 上監聽時直接失敗。由於失敗發生在登入 URL 產生之前，`Paste code here if prompted` 流程無法作為替代方案。
1319 1333
1320**該怎麼做：**1334**處理方式：**
1321 1335
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 如何在認證資格之間進行選擇。1336* 若要在不使用本機監聽器的情況下立即登入：如果您使用 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`，以便報告包含您的環境詳細資訊。1337* 若要改在此電腦上使用瀏覽器登入，Claude Code 必須能夠在 `127.0.0.1` 上監聽。如果它在沙箱中執行，請確認沙箱的政策允許在本機連接埠上監聽，然後再次執行 `/login`。如果理應可以監聽卻仍然失敗，請執行 `/feedback`，讓回報內容包含您的環境詳細資訊。
1324 1338
1325<h3 id="claude-login-not-accepted">1339<h3 id="claude-login-not-accepted">
1326 Claude 登入未被接受1340 Claude 登入未被接受
1327</h3>1341</h3>
1328 1342
1329您嘗試啟動[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)，伺服器以 401 拒絕建立它：它未接受此機器傳送的 Claude 登入，通常是因為登入已過期或被撤銷。1343您嘗試啟動[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)，但伺服器以 401 拒絕建立：它不接受此電腦傳送的 Claude 登入，通常是因為登入已過期或被撤銷。
1330 1344
1331該行的第一部分是伺服器自己的原因（如果它給出的話）。否則該行讀作：1345如果伺服器提供了原因，該行的第一部分就是伺服器本身的原因。否則該行會顯示：
1332 1346
1333```text theme={null}1347```text theme={null}
1334Claude login not accepted · Run /login, then try again1348Claude login not accepted · Run /login, then try again
1335```1349```
1336 1350
1337**該怎麼做：**1351**處理方式：**
1338 1352
1339* 執行 `/login`，完成登入，然後再次啟動工作階段1353* 執行 `/login`，完成登入，然後再次啟動工作階段
1340 1354
1341<h3 id="artifacts-need-a-claude-ai-login">1355<h3 id="artifacts-need-a-claude-ai-login">
1342 工件需要 claude.ai 登入1356 Artifact 需要 claude.ai 登入
1343</h3>1357</h3>
1344 1358
1345Claude Code 拒絕了[工件](/docs/zh-TW/artifacts)發佈或讀取，因為工作階段沒有可用於工件的 claude.ai 登入。1359Claude Code 拒絕了 [artifact](/docs/zh-TW/artifacts) 的發佈或讀取，因為該工作階段沒有可用於 artifact 的 claude.ai 登入。
1346 1360
1347訊息的每種形式都以相同的詞開頭，後面跟著取決於您的工作階段如何進行驗證的補救措施。沒有競爭認證資格時，它讀作：1361訊息的每種形式都以相同的文字開頭，後面接著的補救方式取決於您工作階段的身分驗證方式。在沒有競爭憑證的情況下，訊息顯示為：
1348 1362
1349```text theme={null}1363```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.1364Artifacts 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```1365```
1352 1366
1353**該怎麼做：**1367**處理方式：**
1354 1368
1355* 執行 `/login` 並選擇**具有訂閱的 Claude 帳戶**。**Anthropic Console 帳戶**選項不提供 claude.ai 認證資格。1369* 執行 `/login` 並選取 **Claude account with subscription**。**Anthropic Console account** 選項不會提供 claude.ai 憑證。
1356* 當訊息命名優先的認證資格（例如 `ANTHROPIC_API_KEY`、`apiKeyHelper` 設定或先前 `/login` 儲存的 Console 金鑰）時，按訊息所說的方式移除它，然後執行 `/login`1370* 當訊息指出具有優先權的憑證（例如 `ANTHROPIC_API_KEY`、`apiKeyHelper` 設定，或先前 `/login` 所儲存的 Console 金鑰）時，請依訊息所述將其移除，然後執行 `/login`
1357* 當訊息說此遠端工作階段透過啟動它的機器進行驗證時，在該機器上登入 claude.ai，然後重新連線工作階段1371* 當訊息表示此遠端工作階段是透過啟動它的電腦進行身分驗證時，請在該電腦上登入 claude.ai，然後重新連線工作階段
1358* 當訊息說認證資格由工作階段的主機環境注入時，您無法在該工作階段中變更它；啟動已登入 claude.ai 的工作階段1372* 當訊息表示憑證是由工作階段的主機環境注入時，您無法在該工作階段中變更它；請啟動一個已登入 claude.ai 的工作階段
1359* 請參閱[可用性](/docs/zh-TW/artifacts#availability)以瞭解工件具有的其他要求，例如計畫、模型提供者和組織政策1373* 關於 artifact 的其他需求（例如方案、模型供應商和組織政策），請參閱[可用性](/docs/zh-TW/artifacts#availability)
1360 1374
1361<h3 id="administrator-policy-requires-a-cloud-gateway-sign-in">1375<h3 id="administrator-policy-requires-a-cloud-gateway-sign-in">
1362 管理員政策需要雲端閘道登入1376 管理員政策要求使用 Cloud gateway 登入
1363</h3>1377</h3>
1364 1378
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)登入。您會看到以下兩個訊息之一：1379此電腦上管理員的[受管設定](/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 1380
1367```text theme={null}1381```text theme={null}
1368Not signed in to the Cloud gateway — run /login.1382Not signed in to the Cloud gateway — run /login.
1369```1383```
1370 1384
1371當工作階段沒有閘道登入時，模型請求會失敗，並顯示此訊息，例如因為您自政策到達機器後未執行 `/login`。1385當工作階段沒有閘道登入時（例如因為政策套用到電腦後您尚未執行 `/login`），模型請求會以此訊息失敗。
1372 1386
1373如果您也有 `ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN` 或 `apiKeyHelper` 認證資格已設定，且受管設定設定了 `forceLoginMethod`，Claude Code 會在啟動時改為結束，並顯示以下開頭的訊息：1387如果電腦上也存有 Anthropic 核發的憑證，且受管設定設定了 `forceLoginMethod` 或 `forceLoginOrgUUID`，Claude Code 會改為在啟動時結束。該憑證可以是 `ANTHROPIC_API_KEY` 或 `ANTHROPIC_AUTH_TOKEN` 變數、`apiKeyHelper` 設定，或先前 Claude Console 登入所儲存的 API 金鑰。訊息開頭為：
1374 1388
1375```text theme={null}1389```text theme={null}
1376Administrator policy requires a Cloud gateway sign-in on this machine; the1390Administrator policy requires a Cloud gateway sign-in on this machine; the
1378ANTHROPIC_AUTH_TOKEN, or apiKeyHelper) is not used.1392ANTHROPIC_AUTH_TOKEN, or apiKeyHelper) is not used.
1379```1393```
1380 1394
1381**該怎麼做：**1395**處理方式：**
1382 1396
1383* 執行 `/login` 並在**雲端閘道**畫面上完成登入1397* 執行 `/login`，並在 **Cloud gateway** 畫面上完成登入
1384* 對於啟動訊息，移除您設定的 `ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN` 或 `apiKeyHelper` 設定，然後啟動 `claude` 並執行 `/login`1398* 對於啟動訊息，請移除您設定的 `ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN` 或 `apiKeyHelper` 設定。若要移除已儲存的 Console API 金鑰，請執行 `claude auth logout`，這也會移除已儲存的 claude.ai 登入。如果您以 `CLAUDE_CODE_USE_*` 選擇了雲端供應商，工作階段隨後會在沒有登入的情況下啟動。否則請啟動 `claude` 並執行 `/login`
1385* 如果您認為機器不應該需要閘道，請要求管理該機器的管理員從其受管設定中移除 `forceLoginMethod` 和 `forceLoginGatewayUrl`1399* 如果您認為此電腦不應要求使用閘道，請要求管理該電腦的管理員從其受管設定中移除 `forceLoginMethod` 和 `forceLoginGatewayUrl`
1386 1400
1387在 v2.1.265 上，迴歸也在某些使用 API 金鑰、`apiKeyHelper` 或自訂標頭進行驗證的 LLM 閘道和代理設定中顯示第一個訊息，即使機器上沒有管理員要求。更新至 v2.1.266 或更新版本。您不需要變更您的設定。1401在 v2.1.265 上，一個回歸問題也會在某些使用 API 金鑰、`apiKeyHelper` 或自訂標頭進行身分驗證的 LLM 閘道和代理伺服器設定中顯示第一則訊息，即使電腦上沒有任何管理員要求也是如此。請更新至 v2.1.266 或更新版本。您不需要變更您的設定。
1388 1402
1389在 v2.1.261 之前，在將 `forceLoginMethod` 設定為 `"gateway"` 的機器上，Claude Code 使用剩餘的已儲存登入，而不是失敗模型請求，並報告已設定的環境認證資格，並顯示 `This machine's managed settings require a first-party login` 而不是啟動訊息。在 v2.1.265 之前，其受管設定僅設定 `forceLoginGatewayUrl` 的機器不需要閘道登入，Claude Code 在那裡使用剩餘的認證資格。1403在 v2.1.261 之前，在將 `forceLoginMethod` 設為 `"gateway"` 的電腦上，Claude Code 會使用殘留的已儲存登入，而不會讓模型請求失敗，並以 `This machine's managed settings require a first-party login` 回報已設定的環境憑證，而非啟動訊息。在 v2.1.265 之前，受管設定只設定了 `forceLoginGatewayUrl` 的電腦不會要求閘道登入，而 Claude Code 會在該處使用殘留的憑證。
1390 1404
1391<h3 id="your-account-is-on-hold">1405<h3 id="your-account-is-on-hold">
1392 您的帳戶已被暫停1406 您的帳戶已被暫停
1393</h3>1407</h3>
1394 1408
1395Claude 帳戶背後的登入已被暫停。Claude Code 在嘗試更新您的已儲存登入並瞭解暫停時顯示第一個訊息，在您在瀏覽器中完成的登入報告時顯示第二個訊息：1409您登入所使用的 Claude 帳戶已被停權。當 Claude Code 嘗試續期您已儲存的登入並得知暫停狀態時，會顯示第一則訊息；當您在瀏覽器中完成的登入回報暫停狀態時，則顯示第二則訊息：
1396 1410
1397```text theme={null}1411```text theme={null}
1398Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted1412Your 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/restricted1413Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted
1400```1414```
1401 1415
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)，其復原步驟無法清除暫停。1416以相同帳戶重新登入並不會清除此訊息，因為暫停是針對帳戶而非登入。在[非互動模式](/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 1417
1404**該怎麼做：**1418**處理方式：**
1405 1419
1406* 開啟訊息中的連結以檢視暫停的詳細資訊或對其提出異議1420* 開啟訊息中的連結，查看暫停的詳細資訊或提出申訴
1407* 如果您有另一個 Claude 帳戶或不受暫停影響的 API 金鑰，您可以在暫停解決期間繼續工作：執行 `/login` 使用該帳戶，或使用 `ANTHROPIC_API_KEY` 設定金鑰1421* 如果您有另一個 Claude 帳戶或不受暫停影響的 API 金鑰，可以在暫停處理期間繼續工作：以該帳戶執行 `/login`，或以 `ANTHROPIC_API_KEY` 設定該金鑰
1408 1422
1409<h3 id="anthropic-profile-login-expired">1423<h3 id="anthropic-profile-login-expired">
1410 Anthropic 設定檔登入已過期1424 Anthropic 設定檔登入已過期
1411</h3>1425</h3>
1412 1426
1413Claude Code 透過 Anthropic 認證資格設定檔進行驗證，其已儲存的登入認證資格已過期，且設定檔沒有 Claude Code 可用來更新它的重新整理認證資格。Claude Code 在本機停止每個請求，不重試，因為重試會讀取相同的過期認證資格。1427Claude Code 正透過 Anthropic 憑證設定檔進行身分驗證，但該設定檔已儲存的登入憑證已過期，且設定檔中沒有 Claude Code 可用來續期的重新整理憑證。Claude Code 會在本機停止每個請求而不重試，因為重試只會讀取相同的過期憑證。
1414 1428
1415```text theme={null}1429```text theme={null}
1416Anthropic profile login expired · Re-authenticate your Anthropic profile1430Anthropic 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 profile1431Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile
1418```1432```
1419 1433
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`）或第三方提供者進行驗證的工作階段永遠不會看到此訊息。1434只有當使用中的憑證來自 Anthropic 憑證設定檔時才會出現此訊息，該設定檔可能是您以 `ANTHROPIC_PROFILE` 環境變數選擇的、Claude Code 在您的 Anthropic 設定目錄中探索到的使用中設定檔，或是您[不使用 API 金鑰登入](/docs/zh-TW/authentication#sign-in-without-an-api-key)時由 Claude Code 寫入的設定檔。使用 API 金鑰、`ANTHROPIC_AUTH_TOKEN` 等 bearer token 或第三方供應商進行身分驗證的工作階段永遠不會看到此訊息。
1421 1435
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 發現了它：1436在[提供無金鑰登入](/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 探索到的：
1423 1437
1424* 當您明確設定 `ANTHROPIC_PROFILE` 時，訊息以 `Re-authenticate your Anthropic profile` 結尾。1438* 當您明確設定 `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` 形式。1439* 當 Claude Code 從您的設定目錄探索到該設定檔時，訊息會提供 `/login`，因為 Claude Code 會讓可運作的 `/login` 優先於探索到的設定檔，然後改用您的 claude.ai 或 Console 帳戶進行身分驗證。在 v2.1.234 之前，Claude Code 在這種情況下也會顯示 `Re-authenticate your Anthropic profile` 形式。
1426 1440
1427**該怎麼做：**1441**處理方式：**
1428 1442
1429* 再次登入設定檔，然後重試：在[提供無金鑰登入](/docs/zh-TW/authentication#sign-in-without-an-api-key)的機器上，執行 `/login` 並為無金鑰 Console 登入或 Claude Platform CLI 的 `ant auth login` 寫入的設定檔選擇 Anthropic Console 帳戶；對於其他設定檔，使用建立它們的工具1443* 重新登入設定檔，然後重試：在[提供無金鑰登入](/docs/zh-TW/authentication#sign-in-without-an-api-key)的電腦上，對於由無金鑰 Console 登入或 Claude Platform CLI 的 `ant auth login` 所寫入的設定檔，請執行 `/login` 並選擇 Anthropic Console 帳戶；對於其他設定檔，請使用建立它們的工具
1430* 如果管理員佈建了設定檔的認證資格，請要求他們簽發新的認證資格1444* 如果設定檔的憑證是由管理員佈建的，請要求他們核發新的憑證
1431* 執行 `/status` 以確認活動認證資格來源和設定檔名稱1445* 執行 `/status`，確認使用中的憑證來源和設定檔名稱
1432* 若要停止使用設定檔，如果您設定了 `ANTHROPIC_PROFILE`，請取消設定它，然後以其他方式進行驗證，例如 `/login` 或 `ANTHROPIC_API_KEY`1446* 若要停止使用該設定檔，請取消設定 `ANTHROPIC_PROFILE`（如果您有設定它），然後改以其他方式進行身分驗證，例如 `/login` 或 `ANTHROPIC_API_KEY`
1433 1447
1434<h3 id="oauth-scope-requirement">1448<h3 id="oauth-scope-requirement">
1435 OAuth 範圍要求1449 OAuth 範圍要求
1436</h3>1450</h3>
1437 1451
1438已儲存的權杖早於較新功能需要的權限範圍：1452已儲存的 token 早於較新功能所需的權限範圍：
1439 1453
1440```text theme={null}1454```text theme={null}
1441OAuth token does not meet scope requirement: user:profile1455OAuth token does not meet scope requirement: user:profile
1442```1456```
1443 1457
1444**該怎麼做：**1458**處理方式：**
1445 1459
1446* 執行 `/login` 以取得具有目前範圍的新權杖。您不需要先登出。1460* 執行 `/login` 以取得具有目前範圍的新 token。您不需要先登出。
1447 1461
1448<h3 id="claude-ai-rejected-the-session-token">1462<h3 id="claude-ai-rejected-the-session-token">
1449 claude.ai 拒絕了工作階段權杖1463 claude.ai 拒絕了工作階段 token
1450</h3>1464</h3>
1451 1465
1452[claude.ai 連接器](/docs/zh-TW/mcp#use-mcp-servers-from-claude-ai)請求失敗，因為 claude.ai 拒絕了來自您的 Claude Code 登入的權杖。被拒絕的權杖是您的登入，而不是連接器在 claude.ai 中的自身授權，因此再次授權連接器不會解決它。在 `/mcp` 中，連接器顯示為 `connected · session token rejected`，其詳細資訊檢視讀作：1466[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 1467
1454```text theme={null}1468```text theme={null}
1455claude.ai rejected the session token. Run /login, then reconnect.1469claude.ai rejected the session token. Run /login, then reconnect.
1456```1470```
1457 1471
1458**該怎麼做：**1472**處理方式：**
1459 1473
1460* 執行 `/login` 以再次登入1474* 執行 `/login` 重新登入
1461* 從 `/mcp` 重新連線連接器，或執行 `/mcp reconnect <server>`。在您再次登入之前重新連線會使連接器處於相同狀態。`/mcp` 面板的**重新連線**選項報告 `your claude.ai session token was rejected`；輸入的 `/mcp reconnect <server>` 形式報告成功重新連線，即使權杖仍被拒絕。1475* 從 `/mcp` 重新連線連接器，或執行 `/mcp reconnect <server>`。在重新登入之前重新連線，連接器會維持相同狀態。`/mcp` 面板的 **Reconnect** 選項會回報 `your claude.ai session token was rejected`；而輸入的 `/mcp reconnect <server>` 形式即使 token 仍被拒絕，也會回報重新連線成功。
1462 1476
1463在 v2.1.222 之前，Claude Code 改為將連接器標記為需要驗證，這指向您進行連接器的授權流程，即使完成它也不會解決狀態。1477在 v2.1.222 之前，Claude Code 會改為將連接器標記為需要身分驗證，這會將您導向連接器的授權流程，即使完成該流程也無法解決此狀態。
1464 1478
1465<h3 id="mcp-server-needs-you-to-sign-in-again">1479<h3 id="mcp-server-needs-you-to-sign-in-again">
1466 MCP 伺服器需要您再次登入1480 MCP 伺服器需要您重新登入
1467</h3>1481</h3>
1468 1482
1469遠端 [MCP 伺服器](/docs/zh-TW/mcp)在工作階段中期拒絕了工具呼叫上的認證資格，通常是因為登入或權杖已過期或因為權杖缺少工具需要的權限。工具呼叫失敗，`/mcp` 將伺服器標記為[需要驗證](/docs/zh-TW/mcp#authenticate-with-remote-mcp-servers)。1483遠端 [MCP 伺服器](/docs/zh-TW/mcp)在工作階段中途的工具呼叫上拒絕了憑證，通常是因為登入或 token 已過期，或 token 缺少工具所需的權限。工具呼叫會失敗，而 `/mcp` 會將該伺服器標記為[需要身分驗證](/docs/zh-TW/mcp#authenticate-with-remote-mcp-servers)。
1470 1484
1471對於您從 Claude Code 登入的伺服器，包括 claude.ai 連接器，登入已過期或被撤銷：1485對於您從 Claude Code 登入的伺服器（包括 claude.ai 連接器），表示登入已過期或被撤銷：
1472 1486
1473```text theme={null}1487```text theme={null}
1474MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)1488MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)
1475```1489```
1476 1490
1477執行 `/mcp`，選擇伺服器，然後從其功能表再次登入。1491執行 `/mcp`，選取該伺服器，並從其選單重新登入。
1478 1492
1479對於使用 [`headersHelper`](/docs/zh-TW/mcp#use-dynamic-headers-for-custom-authentication) 指令碼設定的伺服器，Claude Code 已重新執行協助程式並在顯示此訊息之前重試呼叫一次：1493對於以 [`headersHelper`](/docs/zh-TW/mcp#use-dynamic-headers-for-custom-authentication) 指令碼設定的伺服器，Claude Code 在顯示此訊息之前已重新執行 helper 並重試呼叫一次：
1480 1494
1481```text theme={null}1495```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)1496MCP 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```1497```
1484 1498
1485檢查協助程式傳回伺服器接受的認證資格，然後從 `/mcp` 重新連線，這會再次執行協助程式。1499請確認 helper 傳回伺服器可接受的憑證，然後從 `/mcp` 重新連線，這會再次執行 helper。
1486 1500
1487對於在其設定中具有靜態 `Authorization` 標頭的伺服器：1501對於在設定中具有靜態 `Authorization` 標頭的伺服器：
1488 1502
1489```text theme={null}1503```text theme={null}
1490MCP server "<name>" rejected the Authorization header in its config (update it, then run /mcp to reconnect)1504MCP server "<name>" rejected the Authorization header in its config (update it, then run /mcp to reconnect)
1491```1505```
1492 1506
1493在伺服器設定的位置更新標頭值，然後從 `/mcp` 重新連線。1507請在設定該伺服器的位置更新標頭值，然後從 `/mcp` 重新連線。
1494 1508
1495在 v2.1.273 之前，已過期登入、`headersHelper` 和 `Authorization` 標頭情況都顯示 `MCP server "<name>" requires re-authorization (token expired)`。1509在 v2.1.273 之前，登入過期、`headersHelper` 和 `Authorization` 標頭這幾種情況都會顯示 `MCP server "<name>" requires re-authorization (token expired)`。
1496 1510
1497伺服器也可以拒絕帶有 HTTP 403 `insufficient_scope` 的工具呼叫，以要求您授權範圍，有時是您的權杖已列出的範圍。訊息命名該範圍：1511伺服器也可能以 HTTP 403 `insufficient_scope` 拒絕工具呼叫，要求您授權某個範圍，有時該範圍甚至已列在您的 token 中。訊息會指出該範圍：
1498 1512
1499```text theme={null}1513```text theme={null}
1500MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate1514MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate
1501```1515```
1502 1516
1503執行 `/mcp`，選擇伺服器，然後從其功能表再次驗證。1517執行 `/mcp`，選取該伺服器，並從其選單重新進行身分驗證。
1504 1518
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`，在再次驗證之前將遺漏的範圍新增到該列表。1519當伺服器的設定既未設定 [`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 1520
1507在 v2.1.274 之前，此情況顯示 `needs you to sign in again` 訊息，在 v2.1.273 之前它顯示 `requires re-authorization (token expired)` 如其他情況。1521在 v2.1.274 之前，這種情況會顯示 `needs you to sign in again` 訊息；而在 v2.1.273 之前，它會像其他情況一樣顯示 `requires re-authorization (token expired)`。
1508 1522
1509<h3 id="mcp-server-url-is-missing-or-not-a-valid-url">1523<h3 id="mcp-server-url-is-missing-or-not-a-valid-url">
1510 MCP 伺服器 URL 遺漏或不是有效的 URL1524 MCP 伺服器 URL 遺失或不是有效的 URL
1511</h3>1525</h3>
1512 1526
1513Claude Code 拒絕為遠端 MCP 伺服器啟動 OAuth 登入，因為伺服器的已設定 `url` 不會解析為 URL。除非 Claude Code 有更具體的設定問題要為伺服器報告，否則執行 [`claude mcp login <name>`](/docs/zh-TW/mcp#authenticate-from-the-command-line) 在您的 shell 中列印拒絕為：1527Claude Code 拒絕為遠端 MCP 伺服器啟動 OAuth 登入，因為該伺服器設定的 `url` 無法解析為 URL。除非 Claude Code 對該伺服器有更具體的設定問題要回報，否則在 shell 中執行 [`claude mcp login <name>`](/docs/zh-TW/mcp#authenticate-from-the-command-line) 會將此拒絕輸出為：
1514 1528
1515```text theme={null}1529```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.1530Couldn'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```1531```
1518 1532
1519**該怎麼做：**1533**處理方式：**
1520 1534
1521* 將項目的 `url` 設定為伺服器設定的伺服器的真實端點，或設定其 [`${VAR}` 參考](/docs/zh-TW/mcp#environment-variable-expansion-in-mcp-json)命名的環境變數，然後再次執行登入。1535* 在設定該伺服器的位置，將該項目的 `url` 設為伺服器的實際端點，或設定其 [`${VAR}` 參照](/docs/zh-TW/mcp#environment-variable-expansion-in-mcp-json)所指出的環境變數，然後再次執行登入。
1522 1536
1523<h3 id="issuer-mismatch-in-authorization-response">1537<h3 id="issuer-mismatch-in-authorization-response">
1524 授權回應中的簽發者不匹配1538 授權回應中的 Issuer 不符
1525</h3>1539</h3>
1526 1540
1527在 [MCP OAuth 登入](/docs/zh-TW/mcp#authenticate-with-remote-mcp-servers)期間，授權伺服器重新導向回 Claude Code，並帶有 `iss` 參數，該參數不命名 Claude Code 從伺服器的 OAuth 中繼資料預期的簽發者。此步驟中的簽發者錯誤是授權伺服器混合攻擊的樣子，因此 Claude Code 失敗登入，而不是交換授權代碼。Claude Code 在瀏覽器登入後在 `/mcp` 伺服器功能表中顯示錯誤：1541在 [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 1542
1529```text theme={null}1543```text theme={null}
1530Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"1544Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"
1531```1545```
1532 1546
1533`expected` 是來自伺服器的 OAuth 中繼資料的簽發者，`received` 是重新導向攜帶的 `iss` 值。其重新導向不攜帶 `iss` 參數的登入通過檢查，除非伺服器的中繼資料設定 `authorization_response_iss_parameter_supported`，在這種情況下 Claude Code 失敗登入。1547`expected` 是伺服器 OAuth 中繼資料中的 issuer，而 `received` 是重新導向所帶的 `iss` 值。重新導向未帶 `iss` 參數的登入會通過檢查，除非伺服器的中繼資料設定了 `authorization_response_iss_parameter_supported`，在此情況下 Claude Code 會讓登入失敗。
1534 1548
1535**該怎麼做：**1549**處理方式：**
1536 1550
1537* 嘗試從 `/mcp` 再次登入1551* 從 `/mcp` 再次嘗試登入
1538* 如果錯誤重複，請向伺服器操作員報告。修正是伺服器端的：授權伺服器必須在 `iss` 參數中傳回與在其中繼資料中宣傳的相同簽發者1552* 如果錯誤重複出現，請向伺服器營運者回報。修正需要在伺服器端進行：授權伺服器必須在 `iss` 參數中傳回與其在中繼資料中所公告相同的 issuer
1539* 若要在伺服器被修正時進行連線，請使用 [`MCP_SDK_GENERATION=v1`](/docs/zh-TW/env-vars) 啟動 Claude Code，其[執行時](/docs/zh-TW/mcp#mcp-client-runtimes)不執行此檢查。這會移除對混合攻擊的保護，因此偏好伺服器端修正1553* 若要在伺服器修正期間進行連線，請以 [`MCP_SDK_GENERATION=v1`](/docs/zh-TW/env-vars) 啟動 Claude Code，其[執行環境](/docs/zh-TW/mcp#mcp-client-runtimes)不會執行此檢查。這會移除對混淆攻擊的防護，因此建議優先採用伺服器端修正
1540 1554
1541在 v2.1.232 之前，Claude Code 僅在逐步推出中或當您設定 `MCP_SDK_GENERATION=v2` 時使用 v2 執行時。1555在 v2.1.232 之前，Claude Code 只有在逐步推出或您設定 `MCP_SDK_GENERATION=v2` 時才會使用 v2 執行環境。
1542 1556
1543<h3 id="refusing-to-send-credentials-to-non-https-token-endpoint">1557<h3 id="refusing-to-send-credentials-to-non-https-token-endpoint">
1544 拒絕向非 https 權杖端點傳送認證資格1558 拒絕將憑證傳送至非 https 的 token 端點
1545</h3>1559</h3>
1546 1560
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 重新整理伺服器的權杖時再次發生。1561在 [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 1562
1549在其完整形式中，訊息來自 MCP SDK 並引用它拒絕的權杖端點。在偵錯記錄中，它遵循 `Error during auth completion:` 用於登入或 `Token refresh failed:` 用於重新整理。在您的 shell 中，`claude mcp login <name>` 在 `Couldn't complete authentication for "<name>":` 之後列印它，在工作階段中，`/mcp` 在伺服器的功能表下顯示它：1563此訊息的完整形式來自 MCP SDK，並會引用它所拒絕的 token 端點。在除錯日誌中，登入時它會接在 `Error during auth completion:` 之後，重新整理時則接在 `Token refresh failed:` 之後。在 shell 中，`claude mcp login <name>` 會在 `Couldn't complete authentication for "<name>":` 之後輸出它；在工作階段中，`/mcp` 會在該伺服器的選單下顯示它：
1550 1564
1551```text theme={null}1565```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).1566Refusing 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```1567```
1554 1568
1555Claude Code 將具有查詢字串或長隨機外觀路徑段的伺服器 URL 視為可能的機密。對於此類伺服器，它在顯示或記錄 MCP SDK 引發的登入錯誤之前會進行編輯。此錯誤然後讀作可能在版本之間變更的短名稱，例如 `io`，後跟 `from the MCP SDK for` 和編輯的伺服器 URL。MCP SDK 的其他錯誤在那裡採用相同的形式。編輯的訊息只能是此錯誤，當伺服器的權杖端點是純 `http://` 在 `localhost`、`127.0.0.1` 或 `::1` 以外的位址時。1569Claude Code 會將帶有查詢字串或看似隨機的長路徑片段的伺服器 URL 視為可能是機密。對於這類伺服器，它會在顯示或記錄 MCP SDK 引發的登入錯誤之前先將其遮蔽。此時此錯誤會顯示為一個可能隨版本變更的簡短名稱（例如 `io`），後面接著 `from the MCP SDK for` 以及遮蔽後的伺服器 URL。來自 MCP SDK 的其他錯誤在該處也會呈現相同的格式。只有當伺服器的 token 端點是位於 `localhost`、`127.0.0.1` 或 `::1` 以外位址的純 `http://` 時，遮蔽後的訊息才可能是此錯誤。
1556 1570
1557**該怎麼做：**1571**處理方式：**
1558 1572
1559* 透過 HTTPS 提供該權杖端點，例如透過將伺服器放在終止 TLS 的反向代理或隧道後面，並設定伺服器以宣傳 `https://` 位址1573* 透過 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 提供端點1574* 若要在不變更伺服器的情況下進行連線，請以 [`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 1575
1562<h3 id="aws-credentials-expired-or-invalid">1576<h3 id="aws-credentials-expired-or-invalid">
1563 AWS 認證資格已過期或無效1577 AWS 憑證已過期或無效
1564</h3>1578</h3>
1565 1579
1566您的 AWS 工作階段權杖已過期或被拒絕。此訊息出現在來自 [Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws) 或 [Mantle 端點](/docs/zh-TW/amazon-bedrock#use-the-mantle-endpoint) 的 401 上，這是這些提供者報告過期安全權杖的方式。1580您的 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 1581
1568中間的動作提示會根據您的設定而異。穩定的部分是前導 `AWS credentials expired or invalid`：1582中間的動作提示會依您的設定而有所不同。固定不變的部分是開頭的 `AWS credentials expired or invalid`：
1569 1583
1570```text theme={null}1584```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 ...1585AWS 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```1586```
1573 1587
1574在 v2.1.273 之前，此訊息僅在您的設定檔中設定 [`awsAuthRefresh`](/docs/zh-TW/amazon-bedrock#advanced-credential-configuration) 時出現。1588在 v2.1.273 之前，只有在設定了 `awsAuthRefresh` 時才會出現此訊息。
1575 1589
1576**該怎麼做：**1590**處理方式：**
1577 1591
1578* 如果提示說認證資格由此環境管理，啟動 Claude Code 的應用程式擁有認證資格，此處的其他步驟不適用：重試，或聯絡您的管理員1592* 如果提示表示憑證由此環境管理，表示啟動 Claude Code 的應用程式擁有該憑證，此處的其他步驟不適用：請重試，或聯絡您的管理員
1579* 在另一個終端機中執行訊息中命名的命令，例如 `aws sso login --profile myprofile`，並完成瀏覽器登入，然後重試。否則自己重新整理您使用的 AWS 認證資格：您的 SSO 登入、存取金鑰、API 金鑰或代理權杖1593* 如果已設定 [`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)1594* 在互動式工作階段中設定了 `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 外有效1595* 如果重新整理命令成功後錯誤仍重複出現，請在相同的 shell 和設定檔中執行 `aws sts get-caller-identity`，確認該身分在 Claude Code 之外是有效的
1582 1596
1583<h3 id="aws-authentication-failed">1597<h3 id="aws-authentication-failed">
1584 AWS 驗證失敗1598 AWS 身分驗證失敗
1585</h3>1599</h3>
1586 1600
1587您的 AWS 提供者傳回 403，或 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) 傳回 401。1601您的 AWS 供應商傳回了 403，或 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) 傳回了 401。
1588 1602
1589Amazon Bedrock 將過期的安全權杖報告為 403，但 403 也是它報告授權拒絕的方式，例如來自遺漏 IAM 權限或未為您的帳戶啟用的模型的 `AccessDeniedException`。Claude Code 無法判斷您遇到了哪個原因。1603Amazon Bedrock 會將過期的安全性 token 回報為 403，但 403 也是它回報授權遭拒的方式，例如因缺少 IAM 權限而產生的 `AccessDeniedException`。Claude Code 無法區分這兩種原因。
1590 1604
1591來自 Amazon Bedrock 的 401 也會落在這裡，而不是在[AWS 認證資格已過期或無效](#aws-credentials-expired-or-invalid)下，因為 Amazon Bedrock 不將過期的權杖報告為 401。來自該端點的 401 通常來自請求路徑中的其他內容，例如公司代理。1605來自 Amazon Bedrock 的 401 也會歸類在此處，而非[AWS 憑證已過期或無效](#aws-credentials-expired-or-invalid)，因為 Amazon Bedrock 不會將過期的 token 回報為 401。來自該端點的 401 通常源自請求路徑中的其他環節，例如企業代理伺服器。
1592 1606
1593認證資格重新整理可以修正過期的權杖，無法修正其他原因，因此訊息提供兩者：1607重新整理憑證可以修正過期的 token，但無法修正其他原因，因此訊息會同時提供兩種方式：
1594 1608
1595```text theme={null}1609```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 ...1610AWS 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```1611```
1598 1612
1599中間的動作提示會根據您的設定而異。穩定的部分是前導 `AWS authentication failed`。1613中間的動作提示會依您的設定而有所不同。固定不變的部分是開頭的 `AWS authentication failed`。
1600 1614
1601當 403 是 Amazon Bedrock 的答案，表示您沒有使用指定的模型 ID 存取該模型時，提示改為告訴您在 Amazon Bedrock 主控台中為您的帳戶和區域啟用該模型。1615當 403 是 Amazon Bedrock 表示您無權存取指定模型 ID 之模型的回應時，提示會改為告訴您在 Amazon Bedrock 主控台中為您的帳戶和區域啟用該模型。
1602 1616
1603在 v2.1.273 之前，此訊息僅在您的設定檔中設定 [`awsAuthRefresh`](/docs/zh-TW/amazon-bedrock#advanced-credential-configuration) 時出現。1617在 v2.1.273 之前，只有在設定了 `awsAuthRefresh` 時才會出現此訊息。
1604 1618
1605**該怎麼做：**1619**處理方式：**
1606 1620
1607* 如果提示說認證資格由此環境管理，啟動 Claude Code 的應用程式擁有認證資格，此處的其他步驟不適用：重試，或聯絡您的管理員1621* 如果提示表示憑證由此環境管理，表示啟動 Claude Code 的應用程式擁有該憑證，此處的其他步驟不適用：請重試，或聯絡您的管理員
1608* 重新整理您的 AWS 認證資格，以防過期的認證資格是原因：執行訊息中命名的命令（如果設定了一個），或自己重新整理您的 SSO 登入、存取金鑰、API 金鑰或代理權杖1622* 重新整理您的 AWS 憑證，以防原因是憑證過期：若已設定 [`awsAuthRefresh`](/docs/zh-TW/amazon-bedrock#advanced-credential-configuration)，請執行訊息中指出的命令，或自行重新整理您的 SSO 登入、存取金鑰、API 金鑰或代理伺服器 token
1609* 如果您的認證資格是最新的，請確認 [IAM 設定](/docs/zh-TW/amazon-bedrock#iam-configuration)中的 IAM 權限已附加到您使用的身份，且所選模型已為您的帳戶和區域啟用1623* 如果您的憑證是最新的，請確認 [IAM 設定](/docs/zh-TW/amazon-bedrock#iam-configuration)中的 IAM 權限已附加至您使用的身分，並確認所選模型已在您的帳戶和區域中啟用
1610* 執行 `aws sts get-caller-identity` 以確認您的請求使用哪個身份1624* 執行 `aws sts get-caller-identity`，確認您的請求使用的是哪個身分
1611 1625
1612<h3 id="google-cloud-credentials-expired-or-invalid">1626<h3 id="google-cloud-credentials-expired-or-invalid">
1613 Google Cloud 認證資格已過期或無效1627 Google Cloud 憑證已過期或無效
1614</h3>1628</h3>
1615 1629
1616您的 [Google Cloud 的 Agent Platform](/docs/zh-TW/google-vertex-ai) Google Cloud 認證資格已過期或被拒絕：請求傳回 401，這是 Agent Platform 報告認證資格過期的方式。1630您用於 [Google Cloud 的 Agent Platform](/docs/zh-TW/google-vertex-ai) 的 Google Cloud 憑證已過期或被拒絕：請求傳回了 401，這是 Agent Platform 回報憑證過期的方式。
1617 1631
1618中間的動作提示會根據您的設定而異。穩定的部分是前導 `Google Cloud credentials expired or invalid`：1632中間的動作提示會依您的設定而有所不同。固定不變的部分是開頭的 `Google Cloud credentials expired or invalid`：
1619 1633
1620```text theme={null}1634```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 ...1635Google 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```1636```
1623 1637
1624**該怎麼做：**1638**處理方式：**
1625 1639
1626* 如果提示說認證資格由此環境管理，啟動 Claude Code 的應用程式擁有認證資格，此處的其他步驟不適用：重試，或聯絡您的管理員1640* 如果提示表示憑證由此環境管理，表示啟動 Claude Code 的應用程式擁有該憑證，此處的其他步驟不適用：請重試，或聯絡您的管理員
1627* 如果您使用應用程式預設認證資格進行驗證，請執行訊息中命名的 [`gcpAuthRefresh`](/docs/zh-TW/google-vertex-ai#advanced-credential-configuration) 命令或 `gcloud auth application-default login`，並完成登入，然後重試1641* 如果您使用應用程式預設憑證進行身分驗證，請執行訊息中指出的 [`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` 中的閘道權杖，然後重試1642* 如果您在設定了 `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)1643* 如果您使用服務帳戶金鑰檔案進行身分驗證，請確認 `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 外有效1644* 如果重新整理後錯誤仍重複出現，請在相同的 shell 中執行 `gcloud auth application-default print-access-token`，確認該身分在 Claude Code 之外可以正常運作
1631 1645
1632在 v2.1.273 之前，來自 Agent Platform 的 401 顯示通用 `Please run /login` 或 `Failed to authenticate` 訊息，無法重新整理 Google Cloud 認證資格。1646在 v2.1.273 之前，來自 Agent Platform 的 401 會改為顯示一般性的 `Please run /login` 或 `Failed to authenticate` 訊息，而這些訊息無法重新整理 Google Cloud 憑證。
1633 1647
1634<h3 id="google-cloud-authentication-failed">1648<h3 id="google-cloud-authentication-failed">
1635 Google Cloud 驗證失敗1649 Google Cloud 身分驗證失敗
1636</h3>1650</h3>
1637 1651
1638[Google Cloud 的 Agent Platform](/docs/zh-TW/google-vertex-ai) 傳回 403，它用於授權拒絕而不是過期的認證資格。通常您驗證的身份缺少 IAM 權限，或該模型未為您的專案啟用。1652[Google Cloud 的 Agent Platform](/docs/zh-TW/google-vertex-ai) 傳回了 403，它將此狀態碼用於授權遭拒，而非憑證過期。通常是您用於身分驗證的身分缺少 IAM 權限，或該模型未在您的專案中啟用。
1639 1653
1640中間的動作提示會根據您的設定而異。穩定的部分是前導 `Google Cloud authentication failed`：1654中間的動作提示會依您的設定而有所不同。固定不變的部分是開頭的 `Google Cloud authentication failed`：
1641 1655
1642```text theme={null}1656```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 ...1657Google 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```1658```
1645 1659
1646**該怎麼做：**1660**處理方式：**
1647 1661
1648* 如果提示說認證資格由此環境管理，啟動 Claude Code 的應用程式擁有認證資格，此處的其他步驟不適用：重試，或聯絡您的管理員1662* 如果提示表示憑證由此環境管理，表示啟動 Claude Code 的應用程式擁有該憑證，此處的其他步驟不適用：請重試，或聯絡您的管理員
1649* 確認 [IAM 設定](/docs/zh-TW/google-vertex-ai#iam-configuration)中的角色已授予您驗證的身份1663* 確認 [IAM 設定](/docs/zh-TW/google-vertex-ai#iam-configuration)中的角色已授予您用於身分驗證的身分
1650* 確認該模型已為您的專案啟用。請參閱[要求模型存取](/docs/zh-TW/google-vertex-ai#2-request-model-access)1664* 確認該模型已在您的專案中啟用。請參閱[請求模型存取權](/docs/zh-TW/google-vertex-ai#2-request-model-access)
1651 1665
1652在 v2.1.273 之前，來自 Agent Platform 的 403 顯示通用 `Please run /login` 或 `Failed to authenticate` 訊息，無法重新整理 Google Cloud 認證資格。1666在 v2.1.273 之前，來自 Agent Platform 的 403 會改為顯示一般性的 `Please run /login` 或 `Failed to authenticate` 訊息，而這些訊息無法重新整理 Google Cloud 憑證。
1653 1667
1654<h3 id="microsoft-foundry-authentication-failed">1668<h3 id="microsoft-foundry-authentication-failed">
1655 Microsoft Foundry 驗證失敗1669 Microsoft Foundry 身分驗證失敗
1656</h3>1670</h3>
1657 1671
1658[Microsoft Foundry](/docs/zh-TW/microsoft-foundry) 傳回 401 或 403：請求上的 Azure 認證資格被拒絕，或其背後的身份沒有存取 Foundry 資源的權限。`/login` 無法鑄造 Azure 認證資格。中間的動作提示會根據您的設定而異。穩定的部分是前導 `Microsoft Foundry authentication failed`：1672[Microsoft Foundry](/docs/zh-TW/microsoft-foundry) 傳回了 401 或 403：請求上的 Azure 憑證遭到拒絕，或其背後的身分沒有 Foundry 資源的存取權。`/login` 無法產生 Azure 憑證。中間的動作提示會依您的設定而有所不同。固定不變的部分是開頭的 `Microsoft Foundry authentication failed`：
1659 1673
1660```text theme={null}1674```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 ...1675Microsoft 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```1676```
1663 1677
1664**該怎麼做：**1678**處理方式：**
1665 1679
1666* 如果提示說認證資格由此環境管理，啟動 Claude Code 的應用程式擁有認證資格，此處的其他步驟不適用：重試，或聯絡您的管理員1680* 如果提示表示憑證由此環境管理，則啟動 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 認證資格鏈可以再次登入1681* 重新整理您在[設定 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)1682* 如果憑證仍有效，請確認該身分具有 Foundry 資源的存取權。請參閱 [Azure RBAC 設定](/docs/zh-TW/microsoft-foundry#azure-rbac-configuration)
1669 1683
1670在 v2.1.273 之前，來自 Microsoft Foundry 的 401 或 403 顯示通用 `Please run /login` 或 `Failed to authenticate` 訊息，無法重新整理 Azure 認證資格。1684在 v2.1.273 之前，來自 Microsoft Foundry 的 401 或 403 會改為顯示一般性的 `Please run /login` 或 `Failed to authenticate` 訊息，而這無法重新整理 Azure 憑證。
1671 1685
1672<h3 id="could-not-load-aws-or-google-cloud-credentials">1686<h3 id="could-not-load-aws-or-google-cloud-credentials">
1673 無法載入 AWS 或 Google Cloud 認證資格1687 無法載入 AWS 或 Google Cloud 憑證
1674</h3>1688</h3>
1675 1689
1676Claude Code 無法從 AWS 認證資格提供者鏈或從它執行的機器上的 Google 應用程式預設認證資格取得可用的認證資格，因此沒有請求到達您的雲端提供者。Claude Code 清除其快取的認證資格並在顯示此訊息之前重試兩次。`·` 之後的詳細資訊命名具體原因，例如過期的 SSO 工作階段、遺漏的應用程式預設認證資格報告為 `Could not load the default credentials`，或被拒絕的登入報告為 `invalid_grant`：1690Claude Code 無法在其執行的機器上，從 AWS 憑證提供者鏈或您的 Google 應用程式預設憑證取得可用的憑證，因此沒有任何請求到達您的雲端供應商。Claude Code 會清除其快取的憑證並重試兩次，之後才會顯示此訊息。`·` 之後的詳細資訊會指出具體原因，例如 SSO 工作階段已過期、缺少應用程式預設憑證（回報為 `Could not load the default credentials`），或登入已被撤銷（回報為 `invalid_grant`）：
1677 1691
1678```text theme={null}1692```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.1693API 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.1694API Error: Could not load Google Cloud credentials · invalid_grant. Check or refresh your Google Cloud credentials and try again.
1681```1695```
1682 1696
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`。1697在使用 `-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 1698
1685**該怎麼做：**1699**處理方式：**
1686 1700
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 外確認認證資格1701* 執行您供應商的登入命令，例如 `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)1702* 如果詳細資訊顯示 `AWS default-chain credential resolve timed out`，表示憑證鏈是卡住而非失敗，請改為依照 [AWS 預設鏈憑證解析逾時](#aws-default-chain-credential-resolve-timed-out)處理
1689 1703
1690<h3 id="aws-default-chain-credential-resolve-timed-out">1704<h3 id="aws-default-chain-credential-resolve-timed-out">
1691 AWS default-chain credential resolve 逾時1705 AWS 預設鏈憑證解析逾時
1692</h3>1706</h3>
1693 1707
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)並重試，因此到您看到它時，鏈已在重複嘗試中停滯。1708AWS 預設憑證提供者鏈未在 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 1709
1696```text theme={null}1710```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.1711API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.
1698```1712```
1699 1713
1700常見原因是停滯對 AWS 的請求的網路或代理，包括 SSO 權杖重新整理，以及其執行個體中繼資料服務 (IMDS) 永遠不會回答鏈探測的容器或 VM。1714常見原因包括：您 AWS 設定檔中的 `credential_process` 命令在等待它無法接收的輸入，以及容器或虛擬機器的執行個體中繼資料服務（IMDS）從未回應憑證鏈的探測。
1701 1715
1702在 v2.1.267 之前，訊息讀作 `API Error: AWS default-chain credential resolve timed out`。1716在 v2.1.267 之前，訊息為 `API Error: AWS default-chain credential resolve timed out`。
1703在 v2.1.207 之前，停滯的鏈使請求無限期等待，而不是失敗。1717在 v2.1.207 之前，停滯的憑證鏈會讓請求無限期等待，而不是失敗。
1704 1718
1705**該怎麼做：**1719**處理方式：**
1706 1720
1707* 在相同 shell 中使用相同 `AWS_PROFILE` 執行 `aws sts get-caller-identity`。如果它也掛起，請修正設定檔；以互動方式提示的 `credential_process` 命令是常見原因。1721* 在同一個 shell 中使用相同的 `AWS_PROFILE` 執行 `aws sts get-caller-identity`。如果它也卡住，請修正該設定檔；以互動方式提示輸入的 `credential_process` 命令是常見原因。
1708* 在啟動 Claude Code 之前完成登入步驟，例如 `aws sso login --profile myprofile`，以便鏈從本機 SSO 快取解析，而不是等待瀏覽器流程1722* 在啟動 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) 以毫秒為單位提高限制1723* 如果您的憑證鏈會執行確實需要超過 60 秒的互動式登入，例如透過 `aws-vault` 等包裝工具進行含 MFA 的 SSO，請使用 [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/zh-TW/env-vars) 以毫秒為單位提高限制
1710 1724
1711<h3 id="bedrock-setup-verification-timed-out-waiting-for-aws">1725<h3 id="bedrock-setup-verification-timed-out-waiting-for-aws">
1712 Bedrock 設定驗證逾時等待 AWS1726 Bedrock 設定驗證在等待 AWS 時逾時
1713</h3>1727</h3>
1714 1728
1715在 [Bedrock 設定精靈](/docs/zh-TW/amazon-bedrock#sign-in-with-bedrock)的認證資格驗證期間對 AWS 的呼叫（例如認證資格查詢或身份檢查）未在 60 秒限制內完成。精靈停止等待並失敗驗證步驟：1729在 [Bedrock 設定精靈](/docs/zh-TW/amazon-bedrock#sign-in-with-bedrock)的憑證驗證期間，對 AWS 的某個呼叫（例如憑證查詢或身分檢查）未在 60 秒限制內完成。精靈會停止等待並使驗證步驟失敗：
1716 1730
1717```text theme={null}1731```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.1732Timed 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```1733```
1720 1734
1721該數字反映您的限制：預設 60 秒，或您在 [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/zh-TW/env-vars) 中設定的值。1735其中的數字反映您的限制：預設為 60 秒，或是您在 [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/zh-TW/env-vars) 中設定的值。
1722 1736
1723常見原因是停滯對 AWS 的請求的網路或代理，包括 SSO 權杖重新整理，以及仍在等待您看不到的輸入的認證資格協助程式。僅在協助程式合法需要更多時間時提高限制。1737常見原因包括：網路或代理伺服器使對 AWS 的請求（包括 SSO token 重新整理）停滯，以及憑證輔助程式仍在等待您看不到的輸入。只有在輔助程式確實需要更多時間時才提高限制。
1724 1738
1725對 AWS 的單一停滯請求也可能在其自身的每個請求逾時上失敗，這在相同步驟上顯示較短的訊息：1739單一停滯的 AWS 請求也可能因其自身的每次請求逾時而失敗，這會在同一步驟顯示較短的訊息：
1726 1740
1727```text theme={null}1741```text theme={null}
1728A request to AWS timed out. Check your network and proxy settings, then try again.1742A request to AWS timed out. Check your network and proxy settings, then try again.
1729```1743```
1730 1744
1731當相同的逾時發生在模型釘選步驟上時，精靈會將模型標記為 `unreachable`，而不是顯示任一訊息。1745當相同的逾時發生在模型固定步驟時，精靈會將模型標記為 `unreachable`，而不是顯示上述任一訊息。
1732 1746
1733**該怎麼做：**1747**處理方式：**
1734 1748
1735* 在相同 shell 中執行 `aws sts get-caller-identity`。如果它也掛起，停滯在 Claude Code 外，在您的網路、您的代理或您的 AWS 設定檔中的認證資格協助程式中；首先修正那個。1749* 在同一個 shell 中執行 `aws sts get-caller-identity`。如果它也卡住，表示停滯發生在 Claude Code 之外，可能在您的網路、代理伺服器或 AWS 設定檔中的憑證輔助程式；請先修正該問題。
1736* 在開啟精靈之前完成任何互動式登入，例如 `aws sso login --profile myprofile`1750* 在開啟精靈之前完成任何互動式登入，例如 `aws sso login --profile myprofile`
1737* 如果您的 AWS 設定檔中的認證資格協助程式合法需要超過 60 秒來提示您，請使用 [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/zh-TW/env-vars) 以毫秒為單位提高限制1751* 如果您 AWS 設定檔中的憑證輔助程式確實需要超過 60 秒來提示您，請使用 [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/zh-TW/env-vars) 以毫秒為單位提高限制
1738 1752
1739<h3 id="cloud-gateway-session-expired">1753<h3 id="cloud-gateway-session-expired">
1740 雲端閘道工作階段已過期1754 雲端閘道工作階段已過期
1741</h3>1755</h3>
1742 1756
1743您透過 [Claude 應用程式閘道](/docs/zh-TW/claude-apps-gateway)登入，此機器上儲存的閘道工作階段已過期且無法更新，或閘道不再接受它，例如在閘道的 [JWT 機密被替換](/docs/zh-TW/claude-apps-gateway-deploy#jwt-secret-rotation)後。如果您在以互動方式啟動 `claude` 時看到此行，工作階段已開啟，未登入閘道：1757您透過 [Claude apps 閘道](/docs/zh-TW/claude-apps-gateway)登入，而此機器上儲存的閘道工作階段已過期且無法續期，或閘道已不再接受它，例如在閘道的 [JWT 密鑰被更換](/docs/zh-TW/claude-apps-gateway-deploy#jwt-secret-rotation)之後。如果您在以互動方式啟動 `claude` 時看到這一行，表示該工作階段已以未登入閘道的狀態開啟：
1744 1758
1745```text theme={null}1759```text theme={null}
1746Cloud gateway session expired — run /login to reconnect.1760Cloud gateway session expired — run /login to reconnect.
1747```1761```
1748 1762
1749相同的行可以在工作階段中期出現，當閘道認證資格過期且 Claude Code 無法更新它時。1763當閘道憑證過期且 Claude Code 無法續期時，同一行也可能在工作階段進行中出現。
1750 1764
1751在[非互動式](/docs/zh-TW/headless)執行、背景或其他無人值守工作階段或 `claude` 子命令（除了 `claude auth`）中，Claude Code 會在閘道不再接受工作階段時改為結束，並顯示此訊息：1765在[非互動](/docs/zh-TW/headless)執行、背景或其他無人值守的工作階段，或 `claude auth` 以外的 `claude` 子命令中，當閘道不再接受該工作階段時，Claude Code 會改為以此訊息結束：
1752 1766
1753```text theme={null}1767```text theme={null}
1754Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.1768Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.
1755```1769```
1756 1770
1757**該怎麼做：**1771**處理方式：**
1758 1772
1759* 在工作階段中執行 `/login` 並完成瀏覽器登入1773* 在工作階段中執行 `/login` 並完成瀏覽器登入
1760* 對於非互動式啟動，在相同環境中啟動 `claude`，執行 `/login`，然後重新執行您的命令1774* 若為非互動式啟動，請在相同環境中啟動 `claude`，執行 `/login`，然後重新執行您的命令
1761 1775
1762<h3 id="sign-in-timed-out-while-waiting-for-you-to-continue">1776<h3 id="sign-in-timed-out-while-waiting-for-you-to-continue">
1763 登入逾時，等待您繼續1777 等待您繼續時登入逾時
1764</h3>1778</h3>
1765 1779
1766在 [Claude 應用程式閘道](/docs/zh-TW/claude-apps-gateway)登入期間，閘道命名了登入的帳戶，Claude Code 要求您在儲存認證資格之前確認它。您將確認保持開啟超過登入本身的過期，閘道未簽發重新整理權杖，因此當您繼續時 Claude Code 未儲存任何內容：1780在 [Claude apps 閘道](/docs/zh-TW/claude-apps-gateway)登入期間，閘道指出了登入的帳戶，而 Claude Code 要求您在儲存憑證之前確認該帳戶。您讓確認畫面停留超過登入本身的有效期限，且閘道未核發可續期的 refresh token，因此當您繼續時，Claude Code 沒有儲存任何內容：
1767 1781
1768```text theme={null}1782```text theme={null}
1769Sign-in timed out while waiting for you to continue. Try again.1783Sign-in timed out while waiting for you to continue. Try again.
1770```1784```
1771 1785
1772**該怎麼做：**1786**處理方式：**
1773 1787
1774* 執行 `/login` 並在登入過期之前確認帳戶1788* 再次執行 `/login`，並在登入過期之前確認帳戶
1775 1789
1776<h3 id="gateway-refused-the-request">1790<h3 id="gateway-refused-the-request">
1777 閘道拒絕了請求1791 閘道拒絕了請求
1778</h3>1792</h3>
1779 1793
1780您透過 [Claude 應用程式閘道](/docs/zh-TW/claude-apps-gateway)登入，請求傳回 403：閘道或其背後的上游拒絕了它。再次登入不會改變拒絕，因此訊息指向您的閘道管理員：1794您已透過 [Claude apps 閘道](/docs/zh-TW/claude-apps-gateway)登入，而某個請求傳回了 403：閘道或其背後的上游拒絕了該請求。重新登入無法改變拒絕結果，因此訊息會引導您聯絡閘道管理員：
1781 1795
1782```text theme={null}1796```text theme={null}
1783Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...1797Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...
1784```1798```
1785 1799
1786**該怎麼做：**1800**處理方式：**
1787 1801
1788* 要求您的閘道管理員查詢請求。`API Error:` 尾部攜帶閘道傳回的拒絕1802* 請閘道管理員查詢該請求。`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)傳遞1803* 給管理員：閘道上的[存取控制規則](/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 1804
1791在 v2.1.273 之前，閘道工作階段上的 403 顯示通用 `Please run /login` 或 `Failed to authenticate` 訊息，再次登入不會清除拒絕。1805在 v2.1.273 之前，閘道工作階段上的 403 會改為顯示一般性的 `Please run /login` 或 `Failed to authenticate` 訊息，且重新登入並無法解除拒絕。
1792 1806
1793<h2 id="network-and-connection-errors">1807<h2 id="network-and-connection-errors">
1794 網路和連線錯誤1808 網路和連線錯誤
1979 1993
1980這些步驟會變更您自己的環境之一。[組織共享環境](/docs/zh-TW/cloud-environments#organization-shared-environments)在選擇器中以唯讀方式開啟，因此請要求擁有者從[管理設定](https://claude.ai/admin-settings)中的**雲端環境**頁面變更其網路存取。1994這些步驟會變更您自己的環境之一。[組織共享環境](/docs/zh-TW/cloud-environments#organization-shared-environments)在選擇器中以唯讀方式開啟，因此請要求擁有者從[管理設定](https://claude.ai/admin-settings)中的**雲端環境**頁面變更其網路存取。
1981 1995
1982* 開啟例行程式進行編輯，或啟動雲端工作階段。選擇顯示您環境名稱的雲端圖示（例如**預設**）以開啟選擇器。將滑鼠懸停在您的環境上，然後按一下設定圖示。1996* 開啟您的環境進行編輯，可從 [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)。如果您想要不受限制的存取，請改為選擇**完整**。1997* 在**編輯雲端環境**對話方塊中，將**網路存取**從**信任**變更為**自訂**，然後將被阻止的網域新增到**允許的網域**。每行輸入一個網域。勾選**也包括常見套件管理員的預設清單**以在您的自訂網域旁邊保留[預設允許清單](/docs/zh-TW/cloud-environments#default-allowed-domains)。如果您想要不受限制的存取，請改為選擇**完整**。
1984* 按一下**儲存變更**。下一次執行使用更新的允許清單。對於已開啟的雲端工作階段，請參閱[網路存取變更何時到達現有工作階段](/docs/zh-TW/cloud-environments#network-access)。1998* 按一下**儲存變更**。下一次執行使用更新的允許清單。對於已開啟的雲端工作階段，請參閱[網路存取變更何時到達現有工作階段](/docs/zh-TW/cloud-environments#network-access)。
1985 1999
1986請參閱[網路存取](/docs/zh-TW/cloud-environments#network-access)以了解存取層級和預設允許清單。本機 CLI 工作階段不受此原則影響。2000請參閱[網路存取](/docs/zh-TW/cloud-environments#network-access)以了解存取層級和預設允許清單。本機 CLI 工作階段不受此原則影響。
2866* 移除 `-p` 或 `--print`。`--bg` 將提示作為其位置引數，所以 `claude --bg "<task>"` 是完整命令。請參閱[從您的 shell 分派新代理](/docs/zh-TW/agent-view#from-your-shell)。2880* 移除 `-p` 或 `--print`。`--bg` 將提示作為其位置引數，所以 `claude --bg "<task>"` 是完整命令。請參閱[從您的 shell 分派新代理](/docs/zh-TW/agent-view#from-your-shell)。
2867* 若要以非互動模式執行提示並列印結果而不是建立背景工作階段，請移除 `--bg` 並執行 `claude -p "<task>"`2881* 若要以非互動模式執行提示並列印結果而不是建立背景工作階段，請移除 `--bg` 並執行 `claude -p "<task>"`
2868 2882
2883<h3 id="conflict-between-a-system-prompt-flag-and-its-file-form">
2884 系統提示詞旗標與其檔案形式衝突
2885</h3>
2886
2887您在同一次 `claude` 呼叫中同時傳入了 [`--append-subagent-system-prompt`](/docs/zh-TW/cli-reference#cli-flags) 與 `--append-subagent-system-prompt-file`，因此 `claude` 會以退出碼 1 結束，而不會啟動工作階段：
2888
2889```text theme={null}
2890Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.
2891```
2892
2893在 v2.1.283 之前，當您將 `--system-prompt` 與 `--system-prompt-file`，或將 `--append-system-prompt` 與 `--append-system-prompt-file` 一起傳入時，`claude` 也會以相同方式結束，因為這些組合會互相衝突，而不是[合併使用](/docs/zh-TW/cli-reference#system-prompt-flags)。在這些版本中，訊息會指出您合併使用的那一組旗標。
2894
2895**處理方式：**
2896
2897* 保留該旗標的其中一種形式並移除另一種。若要將固定的提示詞檔案與每次執行的文字合併，請在啟動前將文字合併到檔案中，而不是同時傳入兩個旗標
2898
2869<h3 id="invalid-agents-configuration">2899<h3 id="invalid-agents-configuration">
2870 無效的 --agents 設定2900 無效的 --agents 設定
2871</h3>2901</h3>
4066 工具錯誤4096 工具錯誤
4067</h2>4097</h2>
4068 4098
4069這些錯誤來自 Claude 的內建工具。Claude 會自動修正大多數工具錯誤。當需要您進行變更時，該錯誤的**應該怎麼做**清單會說明要變更的內容。4099這些錯誤來自 Claude 的內建工具。Claude 會自行修正大多數工具錯誤。當某個錯誤需要您進行變更時，該錯誤的 **處理方式** 清單會說明需要變更的內容。
4070 4100
4071<h3 id="agent-would-be-spawned-with-zero-tools">4101<h3 id="agent-would-be-spawned-with-zero-tools">
4072 Agent 會以零個工具生成4102 Agent would be spawned with zero tools
4073</h3>4103</h3>
4074 4104
4075子代理的 [`tools` 清單](/docs/zh-TW/sub-agents#supported-frontmatter-fields)中的每個項目都無法匹配可用的工具，因此 Claude Code 拒絕啟動子代理：沒有工具，它無法採取行動。該訊息會按出錯原因將您的項目分組：4105subagent 的 [`tools` 清單](/docs/zh-TW/sub-agents#supported-frontmatter-fields) 中的每個項目都無法比對到可用的工具，因此 Claude Code 拒絕啟動該 subagent：沒有任何工具，它就無法執行動作。訊息會依問題類型將您的項目分組：
4076 4106
4077* **無法識別**：該項目不符合任何工具名稱，通常是打字錯誤，例如 `Grpe` 而非 `Grep`。4107* **Unrecognized**：該項目不符合任何工具名稱，通常是拼字錯誤，例如將 `Grep` 寫成 `Grpe`。
4078* **子代理無法使用**：該項目命名了一個[子代理無法使用](/docs/zh-TW/sub-agents#available-tools)的真實工具。背景子代理保持較小的內建工具集，因此當子代理在背景中執行時（這是預設值），只有前景子代理可以使用的項目會出現在此處。如果您列出 `Agent`，該訊息會改為在下一個群組下報告它。4108* **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`。4109* **Matched no tools in this session**：該項目有效，但目前工作階段中沒有任何工具與其相符，例如未連線 GitHub MCP 伺服器時的 `mcp__github__*`，或是已達 [深度上限](/docs/zh-TW/sub-agents#let-subagents-spawn-their-own-subagents) 的 subagent 所列的 `Agent`。
4080 4110
4081省略 `tools` 欄位永遠不會觸發此拒絕。如果您將 `tools` 清單留空，或 `disallowedTools` 移除其中的每個項目，Claude Code 也會跳過拒絕並啟動沒有工具的子代理。4111省略 `tools` 欄位永遠不會觸發此拒絕。如果您將 `tools` 清單留空，或 `disallowedTools` 移除了其中的每個項目，Claude Code 也會略過此拒絕，並在沒有工具的情況下啟動 subagent。
4082 4112
4083在 v2.1.208 之前，子代理會以零個工具啟動，並可能返回空的或令人困惑的結果。4113在 v2.1.208 之前，subagent 會在沒有工具的情況下啟動，並可能傳回空白或令人困惑的結果。
4084 4114
4085```text theme={null}4115```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.4116Agent '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```4117```
4088 4118
4089**應該怎麼做：**4119**處理方式：**
4090 4120
4091* 根據[子代理可用的工具](/docs/zh-TW/sub-agents#available-tools)修正錯誤命名的每個項目4121* 對照 [subagent 可用的工具](/docs/zh-TW/sub-agents#available-tools)，修正錯誤中列出的每個項目
4092* 移除工作階段沒有的工具項目，例如來自未連接伺服器的 MCP 工具4122* 移除工作階段中不存在之工具的項目，例如來自未連線伺服器的 MCP 工具
4093* 對於[背景子代理會捨棄](/docs/zh-TW/sub-agents#available-tools)的工具（例如 `CronCreate`），移除該項目。若要保留該工具，[關閉 fork 模式](/docs/zh-TW/sub-agents#turn-fork-mode-on-or-off)並要求 Claude 在前景中執行子代理4123* 對於 [背景 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)4124* 刪除 `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`，因此只有其他工具的清單會解析為零個工具4125* 對於只包含 `Agent` 的 `tools` 清單，請提高 [深度上限](/docs/zh-TW/sub-agents#let-subagents-spawn-their-own-subagents)，或至少再給該 agent 一個其他工具：Claude Code 會在達到該上限時保留 `Agent` 不提供，因此除了 `Agent` 之外沒有任何其他項目的清單會解析為沒有工具
4096 4126
4097<h3 id="file-is-covered-by-a-read-deny-rule">4127<h3 id="file-is-covered-by-a-read-deny-rule">
4098 檔案受到 Read 拒絕規則的涵蓋4128 File is covered by a Read deny rule
4099</h3>4129</h3>
4100 4130
4101Edit 或 Write 工具在由 [`Read` 拒絕規則](/docs/zh-TW/permissions#read-and-edit)匹配的路徑上被呼叫，包括在該路徑建立新檔案。兩個工具都會變更 Claude 必須能夠讀回的內容，因此 Claude Code 在任何檔案存取之前拒絕該呼叫。NotebookEdit 不受 `Read` 拒絕規則涵蓋。在 v2.1.228 之前，該規則僅阻止 Edit 工具，在 v2.1.208 之前，只有 `Edit` 拒絕規則會阻止編輯。4131Edit 或 Write 工具被呼叫來操作符合 [`Read` 拒絕規則](/docs/zh-TW/permissions#read-and-edit) 的路徑，包括在該路徑建立新檔案。這兩個工具都會變更 Claude 必須能夠讀回的內容，因此 Claude Code 會在存取任何檔案之前拒絕該呼叫。NotebookEdit 不受 `Read` 拒絕規則涵蓋。在 v2.1.228 之前，該規則只會封鎖 Edit 工具；在 v2.1.208 之前，只有 `Edit` 拒絕規則會封鎖編輯。
4102 4132
4103```text theme={null}4133```text theme={null}
4104File is covered by a Read deny rule in your permission settings and cannot be edited.4134File is covered by a Read deny rule in your permission settings and cannot be edited.
4105```4135```
4106 4136
4107當 Claude Code 拒絕 Write 工具時，訊息結尾改為 `and cannot be written`。4137當 Claude Code 拒絕 Write 工具時，訊息的結尾會改為 `and cannot be written`。
4108 4138
4109**應該怎麼做：**4139**處理方式：**
4110 4140
4111* 如果 Claude 應該能夠變更檔案，請在 `/permissions` 或[設定](/docs/zh-TW/settings-reference#permission-settings)中移除或縮小 `Read` 拒絕規則4141* 如果 Claude 應該能夠變更該檔案，請在 `/permissions` 或 [設定](/docs/zh-TW/settings-reference#permission-settings) 中移除或縮小該 `Read` 拒絕規則
4112* 如果檔案必須保持未觸及，請保留該規則並為相同路徑新增 `Edit` 拒絕規則以同時阻止 NotebookEdit 工具4142* 如果該檔案必須保持不變，請保留該規則，並為相同路徑新增 `Edit` 拒絕規則，以同時封鎖 NotebookEdit 工具
4113 4143
4114<h3 id="path-cannot-contain-null-bytes">4144<h3 id="path-cannot-contain-null-bytes">
4115 路徑不能包含空位元組4145 Path cannot contain null bytes
4116</h3>4146</h3>
4117 4147
4118檔案工具呼叫的路徑或模式引數包含空位元組，檔案系統和搜尋工具無法接受。Read、Write、Edit、NotebookEdit、Glob 和 Grep 會檢查此項，訊息會命名工具和引數：4148檔案工具呼叫的路徑或模式引數包含 null 位元組，而檔案系統和搜尋工具無法接受這種字元。Read、Write、Edit、NotebookEdit、Glob 和 Grep 會檢查這一點，訊息會指出工具和引數：
4119 4149
4120```text theme={null}4150```text theme={null}
4121Read file_path cannot contain null bytes (\0). Remove the null byte and try again.4151Read file_path cannot contain null bytes (\0). Remove the null byte and try again.
4122```4152```
4123 4153
4124工具呼叫失敗，Claude 看到錯誤，回合繼續。4154該工具呼叫會失敗，Claude 會看到錯誤，回合則會繼續進行。
4125 4155
4126**應該怎麼做：**4156**處理方式：**
4127 4157
4128* 您這邊無需做任何事：錯誤會作為工具的結果返回給 Claude，訊息本身會告訴 Claude 移除空位元組並重試4158* 您無需採取任何動作：錯誤會作為工具的結果傳回給 Claude，而訊息本身會告知 Claude 移除 null 位元組並重試
4129 4159
4130在 v2.1.281 之前，Read、Write、Edit 或 NotebookEdit 路徑中的空位元組會以命名 `Path contains null bytes` 的錯誤結束整個回合，工具永遠不會執行。4160在 v2.1.281 之前，Read、Write、Edit 或 NotebookEdit 路徑中的 null 位元組會以指出 `Path contains null bytes` 的錯誤結束整個回合，且工具從未執行。
4131 4161
4132<h3 id="subagent-type-is-required">4162<h3 id="subagent-type-is-required">
4133 subagent\_type 是必需的4163 subagent\_type is required
4134</h3>4164</h3>
4135 4165
4136```text theme={null}4166```text theme={null}
4137subagent_type is required: the general-purpose agent is not available in this session. Available agents: ...4167subagent_type is required: the general-purpose agent is not available in this session. Available agents: ...
4138```4168```
4139 4169
4140Claude 呼叫了 [Agent 工具](/docs/zh-TW/tools-reference#agent-tool-behavior)但沒有 `subagent_type`，此工作階段沒有[通用子代理](/docs/zh-TW/sub-agents#built-in-subagents)可作為備用。這在兩種設定中是這樣的情況：4170Claude 在未指定 `subagent_type` 的情況下呼叫了 [Agent 工具](/docs/zh-TW/tools-reference#agent-tool-behavior)，而此工作階段沒有可供後備使用的 [general-purpose subagent](/docs/zh-TW/sub-agents#built-in-subagents)。這會發生在兩種設定中：
4141 4171
4142* [`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1`](/docs/zh-TW/env-vars) 在非互動模式中設定，這會移除每個內建子代理4172* 在非互動模式中設定了 [`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`4173* 工作階段的主執行緒 agent 具有排除了 `general-purpose` 的 [`tools: Agent(...)` 允許清單](/docs/zh-TW/sub-agents#restrict-which-subagents-can-be-spawned)
4144 4174
4145**應該怎麼做：**4175**處理方式：**
4146 4176
4147* 通常無需做任何事：訊息會列出工作階段確實擁有的子代理，因此 Claude 可以使用其中一個重試4177* 通常無需任何動作：訊息會列出工作階段中確實存在的 subagent，因此 Claude 可以使用其中之一重試
4148* 如果 Claude 持續失敗，請將 `general-purpose` 新增到 `tools: Agent(...)` 允許清單，或取消設定 `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`4178* 如果 Claude 持續失敗，請將 `general-purpose` 加入 `tools: Agent(...)` 允許清單，或取消設定 `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`
4149 4179
4150在 v2.1.235 之前，相同的呼叫失敗並顯示 `Agent type 'general-purpose' not found`。4180在 v2.1.235 之前，相同的呼叫會以 `Agent type 'general-purpose' not found` 失敗。
4151 4181
4152<h3 id="memory-index-is-over-its-read-limit">4182<h3 id="memory-index-is-over-its-read-limit">
4153 記憶體索引超過其讀取限制4183 Memory index is over its read limit
4154</h3>4184</h3>
4155 4185
4156Claude 寫入[自動記憶體](/docs/zh-TW/memory#auto-memory)索引 `MEMORY.md` 並將其留在其讀取限制之一上方：200 行或 25KB。寫入成功，但只有前 200 行或 25KB（以先到者為準）在工作階段開始時載入，因此超過限制的所有內容在每次讀取索引時都會被捨棄。在 v2.1.210 之前，超限索引在下次載入時會被無聲地截斷，沒有寫入時間訊號。4186Claude 寫入了 [自動記憶](/docs/zh-TW/memory#auto-memory) 索引 `MEMORY.md`，並使其超過其中一項讀取上限：200 行或 25KB。寫入已成功，但在工作階段開始時只會載入前 200 行或 25KB（以先達到者為準），因此每次讀取索引時，超出上限的所有內容都會被捨棄。在 v2.1.210 之前，超過上限的索引會在下次載入時被無聲截斷，且在寫入時不會有任何提示。
4157 4187
4158```text theme={null}4188```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.4189Error: 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```4190```
4161 4191
4162只有載入的內容才計入限制。YAML frontmatter 和區塊級 HTML 註解在索引載入前會被移除，因此它們被排除在測量之外。在 v2.1.211 之前，Claude Code 測量原始檔案，frontmatter 或註解即使在載入的內容符合時也可能觸發此錯誤。4192只有會被載入的內容才會計入上限。YAML frontmatter 和區塊層級的 HTML 註解會在載入索引前被移除，因此不計入測量。在 v2.1.211 之前，Claude Code 會測量原始檔案，即使載入的內容符合上限，frontmatter 或註解也可能觸發此錯誤。
4163 4193
4164Claude Code 在寫入後將錯誤傳遞給 Claude，而不是在您的終端中列印為橫幅，因此您可能只在文字記錄中注意到它。4194Claude Code 會在寫入後將錯誤傳遞給 Claude，而不是在您的終端機中以橫幅形式顯示，因此您可能只會在逐字稿中注意到它。
4165 4195
4166當 Claude 的寫入使檔案接近限制但未超過時，Claude Code 會返回更溫和的提醒以壓縮索引，而不是此錯誤。4196當 Claude 的寫入使檔案接近上限但未超過時，Claude Code 會傳回較溫和的提醒，要求壓縮索引，而非此錯誤。
4167 4197
4168**應該怎麼做：**4198**處理方式：**
4169 4199
4170* 讓 Claude 重寫 `MEMORY.md`，或要求它：每個項目保留一行，將詳細資訊移到主題檔案中，並合併或捨棄過時的項目4200* 讓 Claude 重寫 `MEMORY.md`，或要求它這麼做：每個項目保留一行，將細節移至主題檔案，並合併或刪除過時的項目
4171* 若要自己修剪索引，請參閱[稽核和編輯您的記憶體](/docs/zh-TW/memory#audit-and-edit-your-memory)4201* 若要自行精簡索引，請參閱 [稽核與編輯您的記憶](/docs/zh-TW/memory#audit-and-edit-your-memory)
4172 4202
4173<h3 id="pkill-pattern-matches-the-claude-code-process">4203<h3 id="pkill-pattern-matches-the-claude-code-process">
4174 pkill 模式符合 Claude Code 程序4204 pkill pattern matches the Claude Code process
4175</h3>4205</h3>
4176 4206
4177Bash 工具呼叫中的 `pkill` 命令使用了一個模式（通常帶有 `-f`），該模式符合 Claude Code 程序本身，因此 Claude Code 拒絕該命令而不是讓它結束工作階段。Claude Code 在執行 `pkill` 之前使用 `pgrep` 測試模式，並在結果中包含其自己的程序 ID 時拒絕。檢查僅在 Linux 上執行；在 macOS 上，`pkill` 不經修改地執行。在 v2.1.214 之前，命令執行，符合的模式在回合中途殺死了 Claude Code 工作階段。4207Bash 工具呼叫中的 `pkill` 命令使用了符合 Claude Code 程序本身的模式（通常搭配 `-f`），因此 Claude Code 會拒絕該命令，而不是讓它結束工作階段。Claude Code 會在執行 `pkill` 之前以 `pgrep` 測試該模式，若結果中包含其自身的程序 ID 便會拒絕。此檢查僅在 Linux 上執行；在 macOS 上，`pkill` 會原封不動地執行。在 v2.1.214 之前，該命令會執行，且符合的模式會在回合進行中終止 Claude Code 工作階段。
4178 4208
4179```text theme={null}4209```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 $$ ...`.4210pkill: refusing to run — this pattern matches the Claude CLI process (PID 12345). Narrow the pattern, or target your own children with `pkill -P $$ ...`.
4181```4211```
4182 4212
4183拒絕出現在 Bash 工具結果中，而不是作為您終端中的橫幅，Claude 通常會自行調整命令。4213拒絕訊息會出現在 Bash 工具結果中，而不是以橫幅形式出現在您的終端機中，Claude 通常會自行調整命令。
4184 4214
4185**應該怎麼做：**4215**處理方式：**
4186 4216
4187* 縮小模式，使其僅符合預期的程序，例如目標二進位檔的完整路徑而不是短子字串4217* 縮小模式範圍，使其只符合預期的程序，例如使用目標二進位檔的完整路徑，而非簡短的子字串
4188* 若要停止由目前 shell 啟動的程序，請使用 `pkill -P $$` 搭配模式，這會將符合限制為 shell 自己的子程序4218* 若要停止由目前 shell 啟動的程序，請將 `pkill -P $$` 與模式搭配使用，這會將比對範圍限制在該 shell 自身的子程序
4189 4219
4190<h3 id="failed-to-write-to-a-teammate-inbox">4220<h3 id="failed-to-write-to-a-teammate-inbox">
4191 無法寫入隊友的收件匣4221 Failed to write to a teammate's inbox
4192</h3>4222</h3>
4193 4223
4194Claude Code 無法將訊息寫入 `~/.claude/teams/{team-name}/inboxes/` 下隊友的信箱檔案，因此收件者沒有收到任何內容。當 Claude Code 無法建立或更新檔案時寫入失敗，例如因為磁碟已滿、目錄不可寫，或另一個代理長時間持有收件匣鎖。在 v2.1.224 之前，Claude Code 即使寫入失敗也會報告訊息已傳送。4224Claude Code 無法將訊息寫入 `~/.claude/teams/{team-name}/inboxes/` 下隊員的信箱檔案，因此收件者沒有收到任何內容。當 Claude Code 無法建立或更新該檔案時，寫入就會失敗，例如磁碟已滿、目錄不可寫入，或另一個 agent 持有收件匣鎖定過久。在 v2.1.224 之前，即使寫入失敗，Claude Code 仍會回報訊息已傳送。
4195 4225
4196錯誤出現在傳送代理的工具結果中，而不是作為您終端中的橫幅，其文字告訴 Claude 重試：4226錯誤會出現在傳送端 agent 的工具結果中，而不是以橫幅形式出現在您的終端機中，其文字會告知 Claude 重試：
4197 4227
4198```text theme={null}4228```text theme={null}
4199Failed to write to researcher's inbox — nothing was sent. Try again, or message the lead.4229Failed to write to researcher's inbox — nothing was sent. Try again, or message the lead.
4200```4230```
4201 4231
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` 訊息。該訊息和另外兩個協議訊息帶有自己的訊息文字和後果：4232結構化的 [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 4233
4204* `Failed to write the plan approval request to the lead's inbox — plan not submitted; try again`：隊友的計畫永遠沒有到達領導者，隊友保持在計畫模式直到重新提交成功4234* `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)`：隊友的權限要求永遠沒有到達領導者，因此沒有人核准工具呼叫4235* `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.`：關閉核准本身生效，隊友退出；只有對領導者的確認遺失4236* `The confirmation could not be written to team-lead's inbox.`：關閉核准本身已生效，隊員會結束；只是缺少給組長的確認
4207 4237
4208當您自己訊息隊友時，在領導者工作階段中輸入 `@name` 後跟訊息，相同的失敗會顯示為通知 `Couldn't write to @name's inbox — message not sent. Try again.`，Claude Code 會將您的文字保留在提示框中，以便您可以再次傳送。4238當您自行傳訊息給隊員時（在組長工作階段中輸入 `@name` 後接訊息），相同的失敗會以通知形式出現，即 `Couldn't write to @name's inbox — message not sent. Try again.`，且 Claude Code 會將您的文字保留在提示詞輸入框中，以便您再次傳送。
4209 4239
4210**應該怎麼做：**4240**處理方式：**
4211 4241
4212* 要求傳送者重新傳送訊息；收件匣鎖的爭用是暫時的，在重試時會清除4242* 請傳送者重新傳送訊息；收件匣鎖定的爭用是暫時性的，重試時便會解除
4213* 檢查可用磁碟空間，並檢查 `~/.claude/teams` 及其下的檔案是否可由您的使用者寫入4243* 檢查可用磁碟空間，並確認 `~/.claude/teams` 及其下的檔案可由您的使用者寫入
4214 4244
4215<h3 id="teammate-agent-definition-not-restored">4245<h3 id="teammate-agent-definition-not-restored">
4216 隊友的代理定義未被復原4246 Teammate's agent definition was not restored
4217</h3>4247</h3>
4218 4248
4219Claude 訊息了一個已停止的[代理團隊](/docs/zh-TW/agent-teams)隊友，Claude Code 將其恢復而沒有重新應用[子代理定義](/docs/zh-TW/agent-teams#use-subagent-definitions-for-teammates)它是從中生成的，因為其定義檔案來自沒有已儲存信任的資料夾。通知在傳送代理的工具結果中的恢復報告之後：4249Claude 傳訊息給一位已停止的 [agent team](/docs/zh-TW/agent-teams) 隊員，Claude Code 將其恢復，但沒有重新套用它最初據以產生的 [subagent 定義](/docs/zh-TW/agent-teams#use-subagent-definitions-for-teammates)，因為其定義檔案來自沒有已儲存信任的資料夾。此通知會接在傳送端 agent 工具結果中的恢復報告之後：
4220 4250
4221```text wrap theme={null}4251```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.4252Its 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```4253```
4224 4254
4225檢查適用於專案的 `.claude/agents/` 目錄或 `--add-dir` 目錄中的定義，接受父資料夾的信任對話不滿足它。4255此檢查適用於專案或 `--add-dir` 目錄之 `.claude/agents/` 目錄中的定義，而接受上層資料夾的信任對話框並不能滿足此檢查。
4226 4256
4227**應該怎麼做：**4257**處理方式：**
4228 4258
4229* 在[偵錯日誌](/docs/zh-TW/debug-your-config)命名的資料夾中執行 `claude` 並接受信任對話。下次 Claude Code 恢復隊友時會重新應用定義；您不需要重新啟動領導者工作階段4259* 在 [除錯日誌](/docs/zh-TW/debug-your-config) 指出的資料夾中執行 `claude`，並接受信任對話框。下次 Claude Code 恢復該隊員時，便會重新套用定義；您不需要重新啟動組長工作階段
4230* 或在 `~/.claude.json` 中將 `hasTrustDialogAccepted` 項目設定為 `true`，使用偵錯日誌列印的確切 `projects["<path>"]` 鍵4260* 或者，在 `~/.claude.json` 中將 `hasTrustDialogAccepted` 項目設為 `true`，並使用除錯日誌印出的確切 `projects["<path>"]` 鍵
4231 4261
4232<h3 id="message-too-large-for-cross-session-delivery">4262<h3 id="message-too-large-for-cross-session-delivery">
4233 跨工作階段傳遞的訊息太大4263 Message too large for cross-session delivery
4234</h3>4264</h3>
4235 4265
4236Claude 的[跨工作階段訊息](/docs/zh-TW/cross-session-messaging)到此機器上您的另一個工作階段太長而無法傳送。Claude Code 拒絕了它，接收工作階段沒有收到任何內容。拒絕出現在傳送工作階段的工具結果中，而不是作為您終端中的橫幅。它命名兩個大小以及如何使訊息符合：4266Claude 傳送給您在此機器上另一個工作階段的 [跨工作階段訊息](/docs/zh-TW/cross-session-messaging) 過長，無法傳送。Claude Code 拒絕了它，接收端工作階段沒有收到任何內容。拒絕訊息會出現在傳送端工作階段的工具結果中，而不是以橫幅形式出現在您的終端機中。它會指出兩個大小以及如何讓訊息符合限制：
4237 4267
4238```text wrap theme={null}4268```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.4269Failed 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```4270```
4241 4271
4242重新傳送相同的文字以相同方式失敗。4272重新傳送相同的文字也會以相同方式失敗。
4243 4273
4244**應該怎麼做：**4274**處理方式：**
4245 4275
4246* 要求 Claude 總結訊息，或將大量內容放在收件者可以讀取的檔案中4276* 要求 Claude 摘要該訊息，或將大量內容放入檔案並傳送該檔案的路徑
4247* 要求 Claude 將內容分割成幾個較短的訊息4277* 要求 Claude 將內容拆分成數則較短的訊息
4248 4278
4249在 v2.1.235 之前，Claude Code 報告超大訊息已傳送。接收工作階段未讀地捨棄了它。4279在 v2.1.235 之前，Claude Code 會將過大的訊息回報為已傳送。接收端工作階段會在未讀取的情況下將其捨棄。
4250 4280
4251<h3 id="too-many-messages-to-this-session-just-now">4281<h3 id="too-many-messages-to-this-session-just-now">
4252 此工作階段剛才收到太多訊息4282 Too many messages to this session just now
4253</h3>4283</h3>
4254 4284
4255Claude 向此機器上您的一個工作階段傳送了快速的[跨工作階段訊息](/docs/zh-TW/cross-session-messaging)爆發，爆發達到該工作階段的收件匣接受的內容。Claude Code 拒絕了下一個傳送，接收工作階段沒有收到任何內容。拒絕出現在傳送工作階段的工具結果中，而不是作為您終端中的橫幅：4285Claude 向您在此機器上的某個工作階段快速連續傳送了大量 [跨工作階段訊息](/docs/zh-TW/cross-session-messaging)，而這一連串訊息已達該工作階段收件匣所能接受的量。Claude Code 拒絕了下一次傳送，接收端工作階段沒有從中收到任何內容。拒絕訊息會出現在傳送端工作階段的工具結果中，而不是以橫幅形式出現在您的終端機中：
4256 4286
4257```text wrap theme={null}4287```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.4288Failed 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```4289```
4260 4290
4261**應該怎麼做：**4291**處理方式：**
4262 4292
4263* 通常無需做任何事：Claude 將剩餘內容批次處理為一個訊息，或在傳送更多內容之前等待4293* 通常無需任何動作：Claude 會將剩餘內容合併成一則訊息，或在傳送更多訊息前稍候
4264* 如果您自己提示了爆發，要求 Claude 將剩餘內容合併為單一訊息4294* 如果是您自己促成了這一連串訊息，請要求 Claude 將剩餘內容合併成單一訊息
4265 4295
4266在 v2.1.236 之前，Claude Code 報告這些傳送已傳送。接收工作階段未讀地捨棄了它們。4296在 v2.1.236 之前，Claude Code 會將這些傳送回報為已傳送。接收端工作階段會在未讀取的情況下將其捨棄。
4267 4297
4268<h3 id="cross-session-message-dropped-at-the-inbox">4298<h3 id="cross-session-message-dropped-at-the-inbox">
4269 跨工作階段訊息在收件者工作階段的收件匣被捨棄4299 Cross-session message was dropped at the recipient session's inbox
4270</h3>4300</h3>
4271 4301
4272Claude 傳送了[跨工作階段訊息](/docs/zh-TW/cross-session-messaging)到此機器上您的另一個工作階段，該工作階段的收件匣在 Claude 在該工作階段中讀取它之前捨棄了它。該行命名收件者的位址，當收件者提供原因時，在破折號後新增原因：4302Claude 傳送了一則 [跨工作階段訊息](/docs/zh-TW/cross-session-messaging) 給您在此機器上的另一個工作階段，而該工作階段的收件匣在該工作階段中的 Claude 讀取之前就將其捨棄。這一行會指出收件者的位址，若收件者提供了原因，則會在破折號後附上原因：
4273 4303
4274```text wrap theme={null}4304```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.4305Cross-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```4306```
4277 4307
4278一行可以涵蓋多個捨棄的訊息。然後它以複數開始，例如 `Cross-session messages (12) were dropped`。若要找到位址屬於哪個工作階段，請將其與 `/status` 在每個工作階段中顯示的 [`Peer address` 列](/docs/zh-TW/cross-session-messaging#the-sessions-inbox-socket)進行比較。4308一行可以涵蓋數則被捨棄的訊息，此時開頭會使用複數形式，例如 `Cross-session messages (12) were dropped`。若要找出某個位址屬於哪個工作階段，請將其與每個工作階段中 `/status` 顯示的 [`Peer address` 列](/docs/zh-TW/cross-session-messaging#the-sessions-inbox-socket) 進行比對。
4279 4309
4280在破折號後，該行給出以下一個或多個原因：4310在破折號之後，這一行會提供下列一個或多個原因：
4281 4311
4282* `its queue of undelivered peer messages was full`：收件者已經持有來自其他工作階段的許多未傳遞訊息，達到其佇列允許的數量4312* `its queue of undelivered peer messages was full`：收件者已持有其佇列所允許的最大數量、來自其他工作階段的未送達訊息
4283* `you sent faster than that session accepts`：傳送工作階段的訊息到達速度比收件者從一個傳送者接受的速度快4313* `you sent faster than that session accepts`：傳送端工作階段的訊息抵達速度，超過收件者從單一傳送者所接受的速度
4284* `it repeated your previous message`：訊息與傳送工作階段不久前傳送給此收件者的訊息相同4314* `it repeated your previous message`：該訊息與傳送端工作階段不久前傳送給此收件者的訊息完全相同
4285* `a relay loop between sessions was cut`：訊息繼續了工作階段相互訊息的鏈，該鏈已通過收件者太多次或變得太長4315* `a relay loop between sessions was cut`：該訊息延續了工作階段之間互相傳訊的鏈結，而該鏈結經過收件者的次數過多或長度過長
4286 4316
4287**應該怎麼做：**4317**處理方式：**
4288 4318
4289* 假設收件者從未看到捨棄的訊息。Claude Code 告訴 Claude 相同的內容，並告訴它改為在稍後的一個訊息中包含仍然重要的任何內容，而不是立即重新傳送4319* 假設收件者從未看到被捨棄的訊息。Claude Code 也會如此告知 Claude，並告訴它將仍然重要的內容納入稍後的一則訊息中，而不是立即重新傳送
4290* 如果您的工作階段相互傳送頻繁的更新，要求 Claude 傳送較少、較大的訊息，例如工作階段完成其工作時的一份報告4320* 如果您的工作階段會頻繁地互相傳送更新，請要求 Claude 傳送較少但較大的訊息，例如在某個工作階段完成工作時傳送一份報告
4291* 對於 `a relay loop between sessions was cut`，在其中一個工作階段中自己輸入下一個指令。Claude 為回應您自己的提示而傳送的訊息開始新的鏈4321* 對於 `a relay loop between sessions was cut`，請自行在其中一個工作階段中輸入下一個指令。Claude 為回應您自己的提示詞而傳送的訊息會開始一條新的鏈結
4292 4322
4293在 v2.1.238 之前，當收件者的收件匣捨棄訊息時，傳送工作階段沒有收到報告。4323在 v2.1.238 之前，當收件者的收件匣捨棄訊息時，傳送端工作階段不會收到任何報告。
4294 4324
4295<h3 id="refusing-to-send-a-cross-session-message">4325<h3 id="refusing-to-send-a-cross-session-message">
4296 拒絕傳送跨工作階段訊息4326 Refusing to send a cross-session message
4297</h3>4327</h3>
4298 4328
4299在 Claude Code 將[跨工作階段訊息](/docs/zh-TW/cross-session-messaging)寫入此機器上您的另一個工作階段之前，它會檢查目標工作階段的收件匣通訊端是否是訊息定址到的端點。當檢查失敗時，Claude Code 拒絕傳送，目標工作階段收不到任何內容。對於 Claude 傳送的訊息，拒絕出現在傳送工作階段的工具結果中：4329在 Claude Code 將 [跨工作階段訊息](/docs/zh-TW/cross-session-messaging) 寫入您在此機器上的另一個工作階段之前，它會檢查目標工作階段的收件匣 socket 是否就是該訊息所指定的端點。當檢查失敗時，Claude Code 會在傳送端工作階段中拒絕傳送，目標工作階段不會收到任何內容。對於 Claude 傳送的訊息，拒絕訊息會出現在傳送端工作階段的工具結果中：
4300 4330
4301```text theme={null}4331```text theme={null}
4302Failed to send to api-worker: Refusing to send: reply target is a symlink4332Failed to send to api-worker: Refusing to send: reply target is a symlink
4303```4333```
4304 4334
4305`Refusing to send:` 之後的文字命名失敗的檢查：4335`Refusing to send:` 之後的文字會指出失敗的檢查：
4306 4336
4307* `reply target is a symlink`：符號連結位於目標工作階段的通訊端路徑。Claude Code 不會透過它傳遞，因為連結可能會將訊息重新導向到目標工作階段未建立的端點。4337* `reply target is a symlink`：目標工作階段的 socket 路徑上有一個符號連結。Claude Code 不會透過它傳遞，因為該處的連結可能會將訊息重新導向至非目標工作階段建立的端點。
4308* `cannot vet reply target`：Claude Code 根本無法檢查目標路徑，例如因為讀取失敗並出現權限錯誤。4338* `cannot vet reply target`：Claude Code 完全無法檢查目標路徑，例如讀取時因權限錯誤而失敗。
4309 4339
4310**應該怎麼做：**4340**處理方式：**
4311 4341
4312* 通常無需做任何事：檢查會防止訊息到達定址到的工作階段以外的端點，沒有任何內容被傳送4342* 通常無需任何動作：這些檢查可防止訊息送達其所指定工作階段以外的端點，且沒有傳送任何內容
4313* 如果 `reply target is a symlink` 對一個工作階段重複，檢查在該工作階段的通訊端路徑（顯示在其 `/status` 下的 `Peer address`）建立連結的內容4343* 如果 `reply target is a symlink` 在某個工作階段重複出現，請檢查是什麼在該工作階段的 socket 路徑上建立了連結，該路徑會顯示在其 `/status` 的 `Peer address` 下
4314 4344
4315<h3 id="refusing-after-a-symlink-changed">4345<h3 id="refusing-after-a-symlink-changed">
4316 拒絕讀取、寫入或搜尋路徑4346 Refusing to read, write, or search a path
4317</h3>4347</h3>
4318 4348
4319Claude Code 檢查檔案路徑的[權限規則](/docs/zh-TW/permissions#read-and-edit)，然後在工具開啟檔案或啟動搜尋時再次確認該解析。當它無法確認路徑仍然導向檢查核准的位置時，Claude Code 拒絕操作而不是跟隨它。拒絕出現在工具結果中：4349Claude Code 會檢查檔案路徑的 [權限規則](/docs/zh-TW/permissions#read-and-edit)，然後在工具開啟檔案或開始搜尋時再次確認該解析結果。當它無法確認該路徑仍通往檢查所核准的位置時，Claude Code 會拒絕該操作，而不是跟隨它。拒絕訊息會出現在工具結果中：
4320 4350
4321```text wrap theme={null}4351```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.4352Refusing 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```4353```
4324 4354
4325每個拒絕命名其原因：4355每個拒絕都會指出其原因：
4326 4356
4327* `its symlink resolution changed after permission was checked`：路徑上的符號連結或 Grep 或 Glob 搜尋根在權限檢查和操作之間被取代。在讀取拒絕中，括號中的短語命名哪個比較失敗。4357* `its symlink resolution changed after permission was checked`：路徑上或 Grep、Glob 搜尋根目錄上的符號連結，在權限檢查與操作之間遭到替換。在讀取拒絕中，括號內的文字會指出哪一項比對失敗。
4328* `its parent-directory symlink resolution changed after permission was checked`：寫入路徑通過的目錄不再解析為核准的位置4358* `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 無法跟隨路徑到磁碟上的最終位置，例如因為路徑上的符號連結形成迴圈4359* `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 導向連結的目標4360* `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`4361* `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/` 目錄連結到另一位置4362* `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 準備搜尋時變更4363* `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.`：搜尋根存在但無法開啟；括號中的代碼是作業系統錯誤4364* `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 在許多同時檔案操作下驅逐核准記錄，工具使用它之前；重試執行新鮮的權限檢查4365* `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` 二進位檔解析為絕對路徑，因此它拒絕工作目錄外的搜尋，而不是執行您的拒絕規則不涵蓋的搜尋4366* `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 4367
4338**應該怎麼做：**4368**處理方式：**
4339 4369
4340* 通常無需做任何事：拒絕到達 Claude 作為工具結果，被拒絕的操作不執行4370* 通常無需任何動作：拒絕會作為工具結果傳遞給 Claude，被拒絕的操作不會執行
4341* 如果符號連結拒絕在一個路徑上重複，找到什麼持續重寫那裡的連結，例如建置工具或檔案監視程式，或要求 Claude 使用檔案的已解析路徑而不是連結的路徑4371* 如果符號連結拒絕在某個路徑上重複出現，請找出持續改寫該處連結的來源，例如建置工具或檔案監看程式，或要求 Claude 使用檔案的解析後路徑，而非連結路徑
4342* 如果此拒絕在 Windows 上 Claude Code 在 AppContainer 或受限權杖沙箱內執行時出現，升級到 v2.1.265 或更新版本4372* 如果 Claude Code 在 Windows 上於 AppContainer 或受限權杖沙箱中執行時，每個檔案都出現此拒絕，請升級至 v2.1.265 或更新版本
4343* 如果讀取拒絕在 macOS 上出現，針對沒有任何內容重寫的檔案，例如拖入提示的螢幕擷取畫面，升級到 v2.1.273 或更新版本4373* 如果在 macOS 上，對於沒有任何程式在改寫的檔案（例如拖曳到提示詞中的螢幕截圖）出現讀取拒絕，請升級至 v2.1.273 或更新版本
4344* 對於 ripgrep 拒絕，使用您的套件管理員安裝 ripgrep，使 `rg` 解析為 `PATH` 上的絕對路徑，或將搜尋保留在工作目錄下4374* 對於 ripgrep 拒絕，請使用您的套件管理員安裝 ripgrep，使 `rg` 能在 `PATH` 上解析為絕對路徑，或將搜尋保持在工作目錄之下
4345 4375
4346在 v2.1.251 之前，Claude Code 僅針對檔案寫入重新檢查路徑的解析，因此在權限檢查後取代的連結可能會將讀取或搜尋重新導向到不同位置而沒有訊息。其中，只有父目錄、透過符號連結和符號連結目錄寫入拒絕出現在較早的版本上。4376在 v2.1.251 之前，Claude Code 只會針對檔案寫入重新檢查路徑的解析結果，因此在權限檢查後遭替換的連結可能會在沒有任何訊息的情況下，將讀取或搜尋重新導向至不同的位置。在這些拒絕中，只有上層目錄、透過符號連結寫入，以及符號連結目錄這幾種寫入拒絕會出現在較早的版本中。
4347 4377
4348在 v2.1.280 之前，`where it leads on disk could not be determined` 拒絕沒有出現。4378在 v2.1.280 之前，`where it leads on disk could not be determined` 拒絕不會出現。
4349 4379
4350<h3 id="task-output-swap-refused">4380<h3 id="task-output-swap-refused">
4351 工作輸出交換被拒絕4381 Task output swap refused
4352</h3>4382</h3>
4353 4383
4354Claude Code 將每個 Bash 命令的輸出儲存到其暫存目錄下的檔案。每次它開啟其中一個檔案時，它都會檢查路徑是否仍然導向它建立的檔案，沒有符號連結、額外硬連結或移動的目錄重新導向它。此訊息表示該檢查失敗，因此 Claude Code 拒絕操作而不是透過該路徑寫入或讀取輸出。訊息出現在 Bash 工具結果中：4384Claude Code 會將每個 Bash 命令的輸出儲存到其暫存目錄下的檔案中。每次開啟這些檔案時，它都會檢查路徑是否仍通往它所建立的檔案，且沒有符號連結、額外的硬連結或被移動的目錄將其重新導向。此訊息表示該檢查失敗，因此 Claude Code 拒絕了該操作，而不是透過該路徑寫入或讀取輸出。訊息會出現在 Bash 工具結果中：
4355 4385
4356```text wrap theme={null}4386```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.4387task 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```4388```
4359 4389
4360括號中的文字命名失敗的檢查。原因例如 `output symlink was re-pointed`、`output file identity changed` 和 `not a regular file` 都報告相同的條件：輸出路徑上或沿著的某些內容不再是 Claude Code 建立的檔案。只有某些原因帶有 `To recover:` 句子。4390括號內的文字會指出失敗的檢查。`output symlink was re-pointed`、`output file identity changed` 和 `not a regular file` 等原因都回報相同的情況：輸出路徑上或沿途的某個東西已不再是 Claude Code 所建立的檔案。只有部分原因會附帶 `To recover:` 句子。
4361 4391
4362如果檢查在命令仍在執行時失敗，Claude Code 會停止命令，其結果報告：4392如果檢查在命令仍在執行時失敗，Claude Code 會停止該命令，其結果會回報：
4363 4393
4364```text theme={null}4394```text theme={null}
4365Command killed: its output file was replaced or could no longer be verified4395Command killed: its output file was replaced or could no longer be verified
4366```4396```
4367 4397
4368**應該怎麼做：**4398**處理方式：**
4369 4399
4370* 升級到 v2.1.260 或更新版本。較早的版本有時在沒有連結或移動目錄存在時顯示此訊息4400* 升級至 v2.1.260 或更新版本。較早的版本有時會在沒有連結或被移動目錄的情況下顯示此訊息
4371* 使用 [`CLAUDE_CODE_TMPDIR`](/docs/zh-TW/env-vars) 設定為新鮮目錄重新啟動 Claude Code4401* 將 [`CLAUDE_CODE_TMPDIR`](/docs/zh-TW/env-vars) 設為全新的目錄，然後重新啟動 Claude Code
4372* 或檢查您的專案在 Claude Code 暫存目錄下的目錄，範例訊息中的 `/private/tmp/claude-501/-Users-you-my-project`。如果該路徑是符號連結，或不應該在那裡的目錄，移除連結或目錄本身而不是連結的目標，並重新啟動 Claude Code4402* 或者，檢查 Claude Code 暫存目錄下您專案的目錄，也就是範例訊息中的 `/private/tmp/claude-501/-Users-you-my-project`。如果該路徑是符號連結，或是不應存在的目錄，請移除該連結或目錄本身，而非連結的目標，然後重新啟動 Claude Code
4373* 如果拒絕重複，程序在工作階段執行時替換、連結或移除 Claude Code 暫存目錄下的項目。將 [`CLAUDE_CODE_TMPDIR`](/docs/zh-TW/env-vars) 設定為沒有其他內容管理的目錄並重新啟動4403* 如果拒絕重複出現，表示有某個程序在工作階段執行期間，替換、連結或移除 Claude Code 暫存目錄下的項目。請將 [`CLAUDE_CODE_TMPDIR`](/docs/zh-TW/env-vars) 設為沒有其他程式管理的目錄，然後重新啟動
4374 4404
4375<h3 id="disk-quota-or-temp-filesystem-is-full">4405<h3 id="disk-quota-or-temp-filesystem-is-full">
4376 磁碟配額或暫存檔案系統已滿4406 Disk quota or temp filesystem is full
4377</h3>4407</h3>
4378 4408
4379Claude Code 將每個 Bash 和 PowerShell 命令的輸出儲存到其暫存目錄下的檔案。當命令以非零代碼退出且完全沒有輸出時，Claude Code 會檢查持有該檔案的檔案系統是否空間不足或 inode 不足，或您在其上的磁碟配額是否已用完。如果是這樣，診斷會出現在命令的結果中，代替空輸出：4409Claude Code 會將每個 Bash 和 PowerShell 命令的輸出儲存到其暫存目錄下的檔案中。當命令以非零代碼結束且完全沒有輸出時，Claude Code 會檢查存放該檔案的檔案系統是否已用盡空間或 inode，或您在其上的磁碟配額是否已用完。若是如此，命令的結果中會以診斷訊息取代空白輸出：
4380 4410
4381```text wrap theme={null}4411```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.4412Your 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```4413```
4384 4414
4385訊息命名什麼用完了：4415訊息會指出用盡的資源：
4386 4416
4387* `Your disk quota is full ... (EDQUOT)`：您在該檔案系統上的配額已用完。配額可以在檔案系統仍顯示可用空間時已滿4417* `Your disk quota is full ... (EDQUOT)`：您自己在該檔案系統上的配額已用完。即使檔案系統仍顯示有可用空間，配額也可能已滿
4388* `The filesystem with Claude Code's temp directory ..., or your disk quota on it, is full (ENOSPC)`：檔案系統或您在其上的配額沒有空間剩餘4418* `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 即將用完4419* `Command output was lost: the temp filesystem at ... is full` 或 `... is out of inodes`：檔案系統幾乎沒有剩餘的可用空間，或 inode 即將用盡
4390 4420
4391**應該怎麼做：**4421**處理方式：**
4392 4422
4393* 刪除您在持有 Claude Code 暫存目錄的檔案系統上不再需要的檔案。對於 `EDQUOT`，刪除計入您自己配額的檔案。對於 `out of inodes`，刪除許多檔案而不是幾個大檔案，因為每個檔案佔用一個 inode，無論其大小如何4423* 刪除存放 Claude Code 暫存目錄之檔案系統上不再需要的檔案。對於 `EDQUOT`，請刪除計入您自己配額的檔案。對於 `out of inodes`，請刪除大量檔案，而不是少數幾個大型檔案，因為無論大小，每個檔案都會佔用一個 inode
4394* 或使用 [`CLAUDE_CODE_TMPDIR`](/docs/zh-TW/env-vars) 設定為有空間的檔案系統上的目錄重新啟動 Claude Code4424* 或者，將 [`CLAUDE_CODE_TMPDIR`](/docs/zh-TW/env-vars) 設為位於有空間之檔案系統上的目錄，然後重新啟動 Claude Code
4395* 然後讓 Claude 再次執行命令。它列印的輸出已遺失，未被截斷4425* 接著讓 Claude 再次執行該命令。它先前印出的輸出已遺失，而不是被截斷
4396 4426
4397<h3 id="the-source-file-is-not-valid-utf-8-text">4427<h3 id="the-source-file-is-not-valid-utf-8-text">
4398 來源檔案不是有效的 UTF-8 文字4428 The source file is not valid UTF-8 text
4399</h3>4429</h3>
4400 4430
4401Claude 嘗試從其位元組不解碼為文字的檔案發佈[成品](/docs/zh-TW/artifacts)，或其文字已包含替換字元 `U+FFFD`，因此 Claude Code 拒絕發佈，未上傳任何內容。訊息出現在成品工具結果中，並命名要修正的第一個位置：4431Claude 嘗試從一個位元組無法解碼為文字、或其文字已包含替代字元 `U+FFFD` 的檔案發佈 [artifact](/docs/zh-TW/artifacts)，因此 Claude Code 在上傳任何內容之前就拒絕了發佈。訊息會出現在 Artifact 工具結果中，並指出第一個需要修正的位置：
4402 4432
4403```text wrap theme={null}4433```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.4434file_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.4436file_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```4437```
4408 4438
4409Claude Code 將檔案解碼為 UTF-8，或當它以小端 UTF-16 位元組順序標記開始時解碼為 UTF-16。當這樣的 UTF-16 檔案不解碼時，第一個訊息命名 `UTF-16` 並仍然告訴您將檔案重寫為 UTF-8。當更多位置跟隨命名的位置時，訊息在位置後新增計數，例如 `(+2 more)`。4439Claude Code 會將檔案解碼為 UTF-8，若檔案以小端序 UTF-16 位元組順序標記開頭，則解碼為 UTF-16。當這類 UTF-16 檔案無法解碼時，第一則訊息會指出 `UTF-16`，但仍會告知您將檔案重寫為 UTF-8。當指出的位置之後還有更多位置時，訊息會在位置後加上計數，例如 `(+2 more)`。
4410 4440
4411**應該怎麼做：**4441**處理方式：**
4412 4442
4413* 通常無需做任何事：Claude 重寫檔案並再次發佈4443* 通常無需任何動作：Claude 會重寫檔案並再次發佈
4414* 如果檔案是您寫入或匯出的，再次將其儲存為 UTF-8，並將每個 `U+FFFD` 替換為較早的編輯、貼上或轉換遺失的字元4444* 如果該檔案是您撰寫或匯出的，請將其重新儲存為 UTF-8，並將每個 `U+FFFD` 替換為先前的編輯、貼上或轉換所遺失的字元
4415* 若要在頁面上顯示有意的 `U+FFFD`，請在 HTML 中將其寫為 `�` 而不是字面字元4445* 若要在頁面上顯示刻意使用的 `U+FFFD`，請在 HTML 中將其寫成 `�`，而不是使用該字元本身
4416 4446
4417在 v2.1.267 之前，Claude Code 上傳這樣的檔案而不檢查它，伺服器改為拒絕發佈。4447在 v2.1.267 之前，Claude Code 會在未檢查的情況下上傳這類檔案，改由伺服器拒絕發佈。
4418 4448
4419<h3 id="reading-a-local-file-from-outside-the-connected-folders">4449<h3 id="reading-a-local-file-from-outside-the-connected-folders">
4420 在 Cowork 工作階段中從連接的資料夾外讀取本機檔案4450 Reading a local file from outside the connected folders in a Cowork session
4421</h3>4451</h3>
4422 4452
4423在 Claude Desktop 應用程式中在您的機器上執行的 [Cowork](https://claude.com/docs/cowork/overview) 工作階段中，Claude 命名了[成品](/docs/zh-TW/artifacts)的本機檔案。Claude Code 無法確認檔案是工作階段連接資料夾內的純檔案：路徑位於這些資料夾外、通過符號連結或以可能命名不同檔案的方式拼寫。讀取這樣的檔案需要您的核准，在無法向您顯示核准卡的工作階段中，例如設定為跳過所有核准的工作階段，Claude Code 拒絕讀取。4453在 Claude Desktop 應用程式中於您的機器上執行的 [Cowork](https://claude.com/docs/cowork/overview) 工作階段裡，Claude 為 [artifact](/docs/zh-TW/artifacts) 指定了一個本機檔案。Claude Code 無法確認該檔案是位於工作階段已連接資料夾內的一般檔案：該路徑位於這些資料夾之外、經過符號連結，或其寫法可能指向與表面上不同的檔案。讀取這類檔案需要您的核准，而在無法向您顯示核准卡片的工作階段中（例如設定為略過所有核准的工作階段），Claude Code 會拒絕該讀取。
4424 4454
4425拒絕出現在成品工具結果中；當檔案根本無法檢查時，它改為命名該失敗：4455拒絕訊息會出現在 Artifact 工具結果中；當檔案完全無法被檢查時，則會改為指出該失敗：
4426 4456
4427```text wrap theme={null}4457```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.4458Reading 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.4460cannot 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```4461```
4432 4462
4433**應該怎麼做：**4463**處理方式：**
4434 4464
4435* 通常無需做任何事：訊息告訴 Claude 改為使用連接資料夾內的純檔案4465* 通常無需任何動作：訊息會告知 Claude 改用已連接資料夾內的一般檔案
4436* 若要將該確切檔案放在成品中，將其複製到工作階段的連接資料夾之一中作為常規檔案（不是符號連結），並再次詢問4466* 若要將該檔案原樣放入 artifact，請將其以一般檔案（而非符號連結）的形式複製到工作階段的其中一個已連接資料夾中，然後再次提出要求
4437 4467
4438<h3 id="webfetch-cannot-fetch-localhost">4468<h3 id="webfetch-cannot-fetch-localhost">
4439 WebFetch 無法擷取 localhost4469 WebFetch cannot fetch localhost
4440</h3>4470</h3>
4441 4471
4442Claude 呼叫了 [WebFetch](/docs/zh-TW/tools-reference#webfetch-tool-behavior)，其 URL 的主機名沒有點，例如 `http://localhost:3000` 或裸內部網路名稱如 `http://wiki/`。WebFetch 在進行任何要求之前拒絕這些 URL：4472Claude 使用主機名稱不含點的 URL 呼叫了 [WebFetch](/docs/zh-TW/tools-reference#webfetch-tool-behavior)，例如 `http://localhost:3000` 或像 `http://wiki/` 這樣的純內部網路名稱。WebFetch 會在發出任何請求之前拒絕這些 URL：
4443 4473
4444```text wrap theme={null}4474```text wrap theme={null}
4445WebFetch cannot fetch localhost or other hostnames without a dot. To reach a local server, use Bash with curl instead.4475WebFetch cannot fetch localhost or other hostnames without a dot. To reach a local server, use Bash with curl instead.
4446```4476```
4447 4477
4448**應該怎麼做：**4478**處理方式：**
4479
4480* 通常無需任何動作：訊息會引導 Claude 透過 Bash 工具使用 `curl`，它可以連線至本機與內部網路伺服器
4449 4481
4450* 通常無需做任何事：訊息將 Claude 指向透過 Bash 工具的 `curl`，它可以到達本機和內部網路伺服器4482在 v2.1.268 之前，WebFetch 會以通用的 `Invalid URL` 錯誤回報這些 URL。
4483
4484<h3 id="webfetch-domain-safety-check-failed">
4485 WebFetch domain safety check failed
4486</h3>
4451 4487
4452在 v2.1.268 之前，WebFetch 報告這些 URL 時出現通用 `Invalid URL` 錯誤。4488在擷取 URL 之前，WebFetch 會將 URL 的主機名稱傳送至 `api.anthropic.com`，以對照 Anthropic 的 [網域安全封鎖清單](/docs/zh-TW/data-usage#webfetch-domain-safety-check) 進行檢查。如果檢查無法完成，WebFetch 就無法確認該網域是安全的，因此不會擷取該頁面，工具結果會改為包含下列其中一則訊息：
4489
4490```text wrap theme={null}
4491The 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.
4492
4493Unable to verify if domain example.com is safe to fetch. This may be due to network restrictions or enterprise security policies blocking claude.ai.
4494```
4495
4496* `rate-limited`：檢查端點以 HTTP `429` 回應。訊息會告知 Claude 在沒有該頁面的情況下繼續，且稍後最多只重試一次。Claude Code 不會快取失敗的檢查，因此稍後擷取該網域時會再次執行檢查。如果您網路上的工作階段經常遇到此情況，可以在設定中使用 [`skipWebFetchPreflight: true`](/docs/zh-TW/settings-reference#skipwebfetchpreflight) 略過檢查。
4497* `Unable to verify`：檢查請求失敗、逾時或收到其他錯誤狀態。如果您的網路封鎖了 `api.anthropic.com`，請將該網域加入允許清單，或在設定中使用 [`skipWebFetchPreflight: true`](/docs/zh-TW/settings-reference#skipwebfetchpreflight) 略過檢查。
4498
4499在 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.`。
4500在 v2.1.285 之前，受速率限制的檢查會改以 `Unable to verify` 訊息回報。
4453 4501
4454<h2 id="background-session-errors">4502<h2 id="background-session-errors">
4455 背景工作階段錯誤4503 背景工作階段錯誤
4456</h2>4504</h2>
4457 4505
4458[背景工作階段](/docs/zh-TW/agent-view)在沒有互動式終端的情況下執行，因此需要終端的命令在那裡的行為會有所不同。這些訊息會出現在背景工作階段的文字記錄中、附加到背景工作階段的終端中、您分派的工作階段或殼層中，或者對於下面的[worktree-guard 項目](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved)，會出現在任何在 worktree 中隔離或執行 worktree 隔離子代理的工作階段中；當訊息特定於某個表面時，其項目會說明。4506[背景工作階段](/docs/zh-TW/agent-view)在沒有自己的互動式終端機的情況下執行，因此需要終端機的命令在那裡的行為會有所不同。這些訊息會出現在背景工作階段的逐字稿中、附加到背景工作階段的終端機中、您分派的工作階段或 shell 中，或者對於下面的[worktree-guard 項目](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved)，會出現在任何在 worktree 中隔離或執行 worktree 隔離 subagent 的工作階段中；當訊息特定於某個使用介面時，其項目會說明。
4459 4507
4460<h3 id="commands-refused-in-a-background-session">4508<h3 id="commands-refused-in-a-background-session">
4461 在背景工作階段中拒絕的命令4509 在背景工作階段中拒絕的命令
4462</h3>4510</h3>
4463 4511
4464開啟互動式對話框的命令在沒有終端附加到背景工作階段時無法執行。`/install-github-app`、`/mcp` 設定清單和 MCP 伺服器選單中的驗證動作會回應一則訊息。對於 `/install-github-app` 和 `/mcp` 設定清單，工作階段也會在[代理檢視](/docs/zh-TW/agent-view)中的 **Needs input** 下出現，以便您可以找到它、附加並再次執行命令。當終端附加時，這些命令正常運作。4512開啟互動式對話框的命令在沒有終端機附加到背景工作階段時無法執行。`/install-github-app`、`/mcp` 設定清單和 MCP 伺服器選單中的身分驗證動作會回應一則訊息。對於 `/install-github-app` 和 `/mcp` 設定清單，工作階段也會在 [agent 檢視](/docs/zh-TW/agent-view)中的 **Needs input** 下出現，以便您可以找到它、附加並再次執行命令。當終端機附加時，這些命令正常運作。
4465 4513
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 而不是開啟瀏覽器。4514在 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 4515
4468措辭會命名該命令。`/mcp` 設定清單報告：4516措辭會命名該命令。`/mcp` 設定清單報告：
4469 4517
4473 4521
4474**該怎麼做：**4522**該怎麼做：**
4475 4523
4476* 從代理檢視附加到工作階段並再次執行命令4524* 從 agent 檢視附加到工作階段並再次執行命令
4477* 或使用訊息命名的形式，例如 `/mcp reconnect <server>`、`/mcp enable` 或 `/mcp disable`，這些在不附加的情況下有效4525* 或使用訊息命名的形式，例如 `/mcp reconnect <server>`、`/mcp enable` 或 `/mcp disable`，這些在不附加的情況下有效
4478 4526
4479<h3 id="write-or-command-blocked-because-the-path-cannot-be-safely-resolved">4527<h3 id="write-or-command-blocked-because-the-path-cannot-be-safely-resolved">
4480 寫入或命令被阻止，因為路徑無法安全解析4528 寫入或命令被阻止，因為路徑無法安全解析
4481</h3>4529</h3>
4482 4530
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)中的寫入和命令工作目錄。它在檢查操作不會到達共享簽出之前解析符號連結，當解析失敗時，它會阻止操作而不是讓它落在那裡。訊息命名它拒絕的路徑形式以及如何重試：4531Claude 透過 [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 4532
4485```text theme={null}4533```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.4534This 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 4538
4491**該怎麼做：**4539**該怎麼做：**
4492 4540
4493* 通常什麼都不做：完整訊息作為工具錯誤傳遞給 Claude，Claude 使用它命名的直接路徑重試。對於被阻止的檔案編輯，對話檢視只顯示簡短的 `Error editing file` 行；完整訊息出現在文字記錄檢視中，您可以使用 `Ctrl+O` 開啟。被阻止的命令在其命令輸出中列印它。4541* 通常什麼都不做：完整訊息作為工具錯誤傳遞給 Claude，Claude 使用它命名的直接路徑重試。對於被阻止的檔案編輯，對話檢視只顯示簡短的 `Error editing file` 行；完整訊息出現在逐字稿檢視中，您可以使用 `Ctrl+O` 開啟。被阻止的命令在其命令輸出中列印它。
4494* 如果同一檔案上的阻止重複，路徑可能透過已提交的符號連結執行，其目標包含 `..`，例如 `docs/current -> ../README.md`；要求 Claude 透過其真實路徑編輯目標檔案，而不是透過連結4542* 如果同一檔案上的阻止重複，路徑可能透過已提交的符號連結執行，其目標包含 `..`，例如 `docs/current -> ../README.md`；要求 Claude 透過其真實路徑編輯目標檔案，而不是透過連結
4495 4543
4496<h3 id="write-or-command-blocked-because-the-path-names-a-network-location">4544<h3 id="write-or-command-blocked-because-the-path-names-a-network-location">
4515 4563
4516Claude 在[在 worktree 中隔離的工作階段](/docs/zh-TW/worktrees#how-claude-code-enforces-isolation)中執行了 Bash 或 Monitor 命令，Claude Code 因以下兩個原因之一拒絕了它：4564Claude 在[在 worktree 中隔離的工作階段](/docs/zh-TW/worktrees#how-claude-code-enforces-isolation)中執行了 Bash 或 Monitor 命令，Claude Code 因以下兩個原因之一拒絕了它：
4517 4565
4518* 命令指向 git 到主簽出。4566* 命令將 git 指向主簽出。
4519* Claude Code 無法從命令文字驗證命令執行的任何 git 保持在 worktree 內。永遠不命名 git 的命令仍然可能因此原因被拒絕，因為展開變數間接參照（例如 `${!name}`）或執行 Bash 函數替換（例如 `${ command; }`）會產生在執行時本身可能是命令的值。4567* Claude Code 無法從命令文字驗證命令執行的任何 git 保持在 worktree 內。從未提及 git 的命令仍然可能因此原因被拒絕，因為展開變數間接參照（例如 `${!name}`）或執行 Bash 函數替換（例如 `${ command; }`）會產生在執行時本身可能是命令的值。
4520 4568
4521訊息的中間命名無法驗證的內容：4569訊息的中間命名無法驗證的內容：
4522 4570
4527**該怎麼做：**4575**該怎麼做：**
4528 4576
4529* 通常什麼都不做：Claude 讀取訊息並按其最後一句要求的方式重寫命令4577* 通常什麼都不做：Claude 讀取訊息並按其最後一句要求的方式重寫命令
4530* 如果您要求的命令持續被拒絕，按字面拼寫標記的值：用其值替換間接參照或替換，並從 worktree 內作為其自己的純命令執行 git4578* 如果您要求的命令持續被拒絕，按字面拼寫標記的值：用其值替換間接參照或替換，並從 worktree 內將 git 作為獨立的純命令執行
4531* 要有目的地作用於主簽出，在工作階段外的終端中自己執行命令4579* 要刻意作用於主簽出，請在工作階段外的終端機中自己執行命令
4532 4580
4533<h3 id="this-session-has-no-saved-transcript">4581<h3 id="this-session-has-no-saved-transcript">
4534 此工作階段沒有已儲存的文字記錄4582 此工作階段沒有已儲存的逐字稿
4535</h3>4583</h3>
4536 4584
4537您附加到已停止的[背景工作階段](/docs/zh-TW/agent-view)，該工作階段使用 `←` 或 `/background` 從另一個對話背景化，並在其第一個回應完成之前停止。在該第一個回應完成之前，對話仍然只存在於背景化它的工作階段中，因此 `claude attach` 拒絕啟動已停止的工作階段，而不是在相同工作階段 ID 下開始空白對話。訊息以此工作階段的 `claude respawn` 命令結尾：4585您附加到已停止的[背景工作階段](/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.4588This 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```4589```
4542 4590
4543在[代理檢視](/docs/zh-TW/agent-view)中開啟相同工作階段的列在清單下方顯示 `Press enter again to restart this session fresh`，列上的第二個 `Enter` 使用空白對話重新啟動工作階段。在 v2.1.212 之前，開啟列顯示拒絕訊息，無法從代理檢視重新啟動。在 v2.1.211 之前，開啟已停止的工作階段無聲地啟動該空白對話，並可以重新執行工作階段的原始提示。4591在 [agent 檢視](/docs/zh-TW/agent-view)中開啟相同工作階段的列，會改為在清單下方顯示 `Press enter again to restart this session fresh`，在該列上第二次按 `Enter` 會使用空白對話重新啟動工作階段。在 v2.1.212 之前，開啟列會顯示拒絕訊息，無法從 agent 檢視重新啟動。在 v2.1.211 之前，開啟已停止的工作階段會無聲地啟動該空白對話，並可能重新執行工作階段的原始提示詞。
4544 4592
4545**該怎麼做：**4593**該怎麼做：**
4546 4594
4547* 您背景化的對話完整無缺：使用 [`claude --resume`](/docs/zh-TW/sessions) 繼續它或繼續在其中工作4595* 您背景化的對話完整無缺：使用 [`claude --resume`](/docs/zh-TW/sessions) 繼續它或繼續在其中工作
4548* 要無論如何啟動已停止的工作階段，請使用訊息中的 ID 執行 `claude respawn <id>`，或在代理檢視中的其列上按 `Enter` 兩次4596* 若仍要重新啟動已停止的工作階段，請使用訊息中的 ID 執行 `claude respawn <id>`，或在 agent 檢視中的其列上按 `Enter` 兩次
4549* 如果工作階段確實完成了回應，您仍在 v2.1.214 之前的版本上看到此拒絕，`~/.claude/projects` 中的不可讀資料夾可能會使文字記錄掃描遺漏已儲存的對話；更新到 v2.1.214 或更新版本，其在掃描期間容許不可讀資料夾4597* 如果工作階段確實完成了回應，而您在 v2.1.214 之前的版本上仍看到此拒絕，`~/.claude/projects` 中的不可讀資料夾可能會使逐字稿掃描遺漏已儲存的對話；請更新到 v2.1.214 或更新版本，其在掃描期間容許不可讀資料夾
4550 4598
4551<h3 id="this-session-is-running-in-another-terminal">4599<h3 id="this-session-is-running-in-another-terminal">
4552 此工作階段在另一個終端中執行4600 此工作階段在另一個終端機中執行
4553</h3>4601</h3>
4554 4602
4555您在[代理檢視](/docs/zh-TW/agent-view)中開啟了已停止工作階段的列，其已儲存的對話已在此機器上的另一個即時 Claude Code 程序中開啟，因此 Claude Code 拒絕啟動將寫入相同文字記錄的第二個程序。您看到的訊息取決於[什麼保持對話](/docs/zh-TW/agent-view#opening-a-session-says-the-conversation-is-already-open)：4603您在 [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 4604
4557```text theme={null}4605```text theme={null}
4558Can't open — this session is running in another terminal4606Can'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 again4607This conversation is already open in another running Claude session — use that one, or close it and try again
4560```4608```
4561 4609
4562* **`running in another terminal`**：終端保持對話，例如您使用 `claude --resume` 或 `/resume` 繼續它的終端。列也顯示 `Open in a terminal`。4610* **`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)程序，尚未退出。4611* **`already open in another running Claude session`**：另一個非互動式 Claude Code 程序持有它，例如相同對話中尚未退出的[背景工作階段](/docs/zh-TW/agent-view#the-supervisor-process)程序。
4564 4612
4565Claude Code 儲存您在開啟列時輸入的回覆，並在工作階段下次啟動時將其作為工作階段的下一個提示傳送。4613Claude Code 會儲存您在開啟列時輸入的回覆，並在工作階段下次啟動時將其作為工作階段的下一個提示詞傳送。
4566 4614
4567**該怎麼做：**4615**該怎麼做：**
4568 4616
4569* 在保持它開啟的程序中繼續對話，或退出該程序並再次開啟列4617* 在開啟該對話的程序中繼續對話，或退出該程序並再次開啟列
4570 4618
4571在 v2.1.248 之前，只有 `already open in another running Claude session` 拒絕存在：在終端中繼續的對話不計為開啟，開啟列啟動寫入相同對話的第二個 Claude Code 程序。4619在 v2.1.248 之前，只有 `already open in another running Claude session` 拒絕存在：在終端機中繼續的對話不計為開啟，開啟列會啟動寫入相同對話的第二個 Claude Code 程序。
4572 4620
4573<h3 id="this-sessions-saved-conversation-is-no-longer-on-disk">4621<h3 id="this-sessions-saved-conversation-is-no-longer-on-disk">
4574 此工作階段的已儲存對話不再在磁碟上4622 此工作階段的已儲存對話不再在磁碟上
4575</h3>4623</h3>
4576 4624
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 拒絕而不是在不詢問的情況下重新執行工作階段的原始提示：4625您開啟了在背景服務關閉時結束的[背景工作階段](/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 4626
4579```text theme={null}4627```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.4628This 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```4629```
4582 4630
4583`claude attach <id>` 列印此文字。在代理檢視中，頁腳較短，以 `ctrl+x deletes the row` 結尾。4631`claude attach <id>` 列印此文字。在 agent 檢視中，頁腳較短，以 `ctrl+x deletes the row` 結尾。
4584 4632
4585**該怎麼做：**4633**該怎麼做：**
4586 4634
4587* 執行 `claude rm <id>` 刪除列。當其中一個[保留案例](/docs/zh-TW/agent-view#what-deleting-a-session-removes)適用時，`claude rm` 保留列和 worktree，並命名原因4635* 執行 `claude rm <id>` 刪除列。當其中一個[保留案例](/docs/zh-TW/agent-view#what-deleting-a-session-removes)適用時，`claude rm` 會改為保留列和 worktree，並說明原因
4588* 要再次執行工作階段的原始提示作為新對話，請執行 `claude respawn <id>`4636* 要將工作階段的原始提示詞作為新對話再次執行，請執行 `claude respawn <id>`
4589 4637
4590在 v2.1.248 之前，開啟這樣的列會重新執行工作階段的原始提示，而不是拒絕，將數週前的任務拉回前景。4638在 v2.1.248 之前，開啟這樣的列會重新執行工作階段的原始提示詞，而不是拒絕，將數週前的任務拉回前景。
4591 4639
4592<h3 id="worktree-has-commits-that-are-not-pushed-anywhere">4640<h3 id="worktree-has-commits-that-are-not-pushed-anywhere">
4593 Worktree 有未推送到任何地方的提交4641 Worktree 有未推送到任何地方的提交
4594</h3>4642</h3>
4595 4643
4596您嘗試刪除[背景工作階段](/docs/zh-TW/agent-view#what-deleting-a-session-removes)，其 worktree 保持 Claude Code 無法確認在其他地方儲存的提交。Claude Code 保留 worktree 和工作階段列，而不是銷毀提交。`claude rm` 命名分支和未推送的提交，並說明如何進行：4644您嘗試刪除[背景工作階段](/docs/zh-TW/agent-view#what-deleting-a-session-removes)，其 worktree 包含 Claude Code 無法確認已在其他地方儲存的提交。Claude Code 保留 worktree 和工作階段列，而不是在您未察覺的情況下銷毀提交。`claude rm` 命名分支和未推送的提交，並說明如何進行：
4597 4645
4598```text theme={null}4646```text theme={null}
4599kept 7c5dcf5d — its worktree is still at "/home/you/project/.claude/worktrees/fix-login"4647kept 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.4648 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@0123456789abcdef0123456789abcdef4649 push them and run 'claude rm 7c5dcf5d' again, or discard the worktree and its commits: claude rm 7c5dcf5d --discard-unpushed a1b2c3d000000000000000000000000000000000@0123456789abcdef0123456789abcdef
4602```4650```
4603 4651
4604當 Claude Code 無法總結提交時，詳細行讀取 `The worktree has unpushed commits`。在[代理檢視](/docs/zh-TW/agent-view)中，工作階段的列顯示 `not deleted`，原因相同。4652當 Claude Code 無法總結提交時，詳細行改為顯示 `The worktree has unpushed commits`。在 [agent 檢視](/docs/zh-TW/agent-view)中，工作階段的列顯示 `not deleted`，原因相同。
4605 4653
4606遠端上的提交不會阻止刪除。本機複製您的 `origin` 遠端預設分支上的提交也不會，只要該分支在您的主簽出中簽出，即儲存庫目錄本身而不是 worktree。4654遠端上的提交不會阻止刪除。您的 `origin` 遠端預設分支的本機副本上的提交也不會，只要該分支在您的主簽出（即儲存庫目錄本身而不是 worktree）中簽出。
4607 4655
4608**該怎麼做：**4656**該怎麼做：**
4609 4657
4610* 要保留提交，推送 worktree 的分支，或將其合併到在主簽出中簽出的預設分支，然後再次刪除工作階段4658* 要保留提交，推送 worktree 的分支，或將其合併到在主簽出中簽出的預設分支，然後再次刪除工作階段
4611* 要捨棄提交，執行訊息列印的 `claude rm <id> --discard-unpushed` 命令，或在代理檢視中的工作階段列上再次按 `Ctrl+X` 兩次。這會移除工作階段和 worktree 以及其分支、未推送的提交和任何未提交的變更。如果 worktree 自拒絕以來獲得了提交，Claude Code 再次保留它並顯示更新的狀態4659* 要捨棄提交，執行訊息列印的 `claude rm <id> --discard-unpushed` 命令，或在 agent 檢視中的工作階段列上再次按 `Ctrl+X` 兩次。這會移除工作階段和 worktree 以及其分支、未推送的提交和任何未提交的變更。如果 worktree 自拒絕以來新增了提交，Claude Code 會再次保留它並顯示更新的狀態
4612* 當訊息說 worktree 也由另一個已完成的工作階段記錄時，再次刪除不會捨棄它：推送提交，然後再次刪除工作階段4660* 當訊息說 worktree 也由另一個已完成的工作階段記錄時，再次刪除不會捨棄它：推送提交，然後再次刪除工作階段
4613 4661
4614在 v2.1.268 之前，`claude rm` 將提交摘要放在 `kept` 行本身上。當 `claude rm` 無法總結提交時，`kept` 行讀取 `worktree has commits that are not pushed anywhere` 代替摘要。4662在 v2.1.268 之前，`claude rm` 將提交摘要放在 `kept` 行本身上。當 `claude rm` 無法總結提交時，`kept` 行會以 `worktree has commits that are not pushed anywhere` 代替摘要。
4615 4663
4616在 v2.1.260 之前，訊息未命名分支或提交，再次刪除被拒絕的方式相同：刪除工作階段而不推送意味著使用 `git worktree remove --force <path>` 自己移除 worktree，然後再次執行 `claude rm <id>`。4664在 v2.1.260 之前，訊息未命名分支或提交，再次刪除也會以相同方式被拒絕：不推送而刪除工作階段意味著您必須使用 `git worktree remove --force <path>` 自己移除 worktree，然後再次執行 `claude rm <id>`。
4617 4665
4618在 v2.1.248 之前，在主簽出中簽出的預設分支不計算：您已經合併到那裡的分支仍然觸發此拒絕，直到其提交到達遠端。4666在 v2.1.248 之前，在主簽出中簽出的預設分支不計算在內：您已經合併到那裡的分支仍然會觸發此拒絕，直到其提交到達遠端。
4619 4667
4620<h3 id="terminal-host-process-died">4668<h3 id="terminal-host-process-died">
4621 終端主機程序已死亡4669 終端機主機程序已死亡
4622</h3>4670</h3>
4623 4671
4624每個[背景工作階段的](/docs/zh-TW/agent-view)終端在背景服務下的主機程序中執行，該程序在服務仍保持其連線時死亡，因此無法到達工作階段。4672每個[背景工作階段的](/docs/zh-TW/agent-view)終端機在背景服務下的主機程序中執行，該程序在服務仍保持其連線時死亡，因此無法連線到工作階段。
4625 4673
4626在 Linux 和 WSL 上，背景服務每隔幾秒檢查每個主機程序，當程序已退出但其與服務的連線從未關閉時標記工作階段失敗，並在[代理檢視](/docs/zh-TW/agent-view#read-session-state)中的其列上顯示原因：4674在 Linux 和 WSL 上，背景服務每隔幾秒檢查每個主機程序，當程序已退出但其與服務的連線從未關閉時，將工作階段標記為失敗，並在 [agent 檢視](/docs/zh-TW/agent-view#read-session-state)中的其列上顯示原因：
4627 4675
4628```text theme={null}4676```text theme={null}
4629terminal host process died — press Enter to restart4677terminal host process died — press Enter to restart
4630```4678```
4631 4679
4632從殼層，`claude attach <id>` 重新啟動已標記為死主機失敗的工作階段，否則列印原因並退出：4680從 shell，`claude attach <id>` 會重新啟動已因主機死亡而標記為失敗的工作階段，否則列印原因並退出：
4633 4681
4634```text theme={null}4682```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.4683Couldn'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```4684```
4637 4685
4638無論如何對話都會儲存。4686無論哪種情況，對話都會儲存。
4639 4687
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 永遠不會為您重新執行命令。4688執行 [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 4689
4642**該怎麼做：**4690**該怎麼做：**
4643 4691
4644* 在代理檢視中，在失敗的列上按 `Enter`；工作階段在新主機程序上重新啟動，對話繼續4692* 在 agent 檢視中，在失敗的列上按 `Enter`；工作階段在新主機程序上重新啟動，對話繼續
4645* 從殼層，再次執行 `claude attach <id>`。Claude Code 列印 `Session <id>'s terminal host died — restarting it on a fresh one…` 並重新開啟工作階段4693* 從 shell，再次執行 `claude attach <id>`。Claude Code 列印 `Session <id>'s terminal host died — restarting it on a fresh one…` 並重新開啟工作階段
4646* 您無法以這種方式重新啟動殼層命令列；再次分派命令以重新執行它4694* 您無法以這種方式重新啟動 shell 命令列；再次分派命令以重新執行它
4647 4695
4648在 v2.1.247 之前，死主機程序可能通過背景服務執行的每個活躍性檢查，因此開啟工作階段無限期地顯示 `opening… · esc to cancel`，`claude attach <id>` 等待而不報告錯誤。4696在 v2.1.247 之前，已死亡的主機程序可能通過背景服務執行的每個活躍性檢查，因此開啟工作階段會無限期地顯示 `opening… · esc to cancel`，而 `claude attach <id>` 會等待而不報告錯誤。
4649 4697
4650<h3 id="session-isnt-responding">4698<h3 id="session-isnt-responding">
4651 工作階段沒有回應4699 工作階段沒有回應
4652</h3>4700</h3>
4653 4701
4654您開啟了[背景工作階段](/docs/zh-TW/agent-view)，背景服務接受了開啟，但約十秒內沒有輸出到達，因此 Claude Code 得出結論，中繼工作階段終端的程序無法傳遞輸出，並結束嘗試而不是等待。4702您開啟了[背景工作階段](/docs/zh-TW/agent-view)，背景服務接受了開啟，但約十秒內沒有輸出到達，因此 Claude Code 判定中繼工作階段終端機的程序無法傳遞輸出，並結束嘗試而不是繼續等待。
4655 4703
4656在代理檢視中，Claude Code 在頁腳中提供重新啟動：4704在 agent 檢視中，Claude Code 在頁腳中提供重新啟動：
4657 4705
4658```text theme={null}4706```text theme={null}
4659Press enter again to restart this session — it isn't responding (its conversation is saved and resumes).4707Press enter again to restart this session — it isn't responding (its conversation is saved and resumes).
4660```4708```
4661 4709
4662從殼層，`claude attach <id>` 列印原因並退出：4710從 shell，`claude attach <id>` 列印原因並退出：
4663 4711
4664```text theme={null}4712```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).4713Couldn't attach to <id> — Session isn't responding — `claude stop <id>`, then `claude attach <id>` restarts it (the conversation is saved).
4666```4714```
4667 4715
4668Claude Code 永遠不會為您重新啟動執行[殼層命令](/docs/zh-TW/agent-view#run-a-shell-command)的列，因為重新啟動會再次執行命令。4716Claude Code 永遠不會為您重新啟動執行 [shell 命令](/docs/zh-TW/agent-view#run-a-shell-command)的列，因為重新啟動會再次執行命令。
4669 4717
4670**該怎麼做：**4718**該怎麼做：**
4671 4719
4672* 在代理檢視中，在相同列上再次按 `Enter`。Claude Code 停止無回應的程序並重新啟動工作階段，對話繼續。沒有第二次按下，什麼都不會停止4720* 在 agent 檢視中，在相同列上再次按 `Enter`。Claude Code 停止無回應的程序並重新啟動工作階段，對話繼續。沒有第二次按下，什麼都不會停止
4673* 從殼層，執行 `claude stop <id>`，然後 `claude attach <id>`4721* 從 shell，執行 `claude stop <id>`，然後 `claude attach <id>`
4674* 對於殼層命令列，在代理檢視中按 `Ctrl+X` 或執行 `claude stop <id>` 停止它；再次分派命令以重新執行它4722* 對於 shell 命令列，在 agent 檢視中按 `Ctrl+X` 或執行 `claude stop <id>` 停止它；再次分派命令以重新執行它
4675 4723
4676<h3 id="session-was-stopped-while-the-respawn-was-in-flight">4724<h3 id="session-was-stopped-while-the-respawn-was-in-flight">
4677 工作階段在重新生成進行中時被停止4725 工作階段在重新生成進行中時被停止
4678</h3>4726</h3>
4679 4727
4680您開啟了[背景工作階段](/docs/zh-TW/agent-view)，其程序未執行，當 Claude Code 重新啟動它時，另一個 Claude Code 程序停止了它，例如在另一個終端中的 `claude stop`。Claude Code 保持工作階段停止：4728您開啟了[背景工作階段](/docs/zh-TW/agent-view)，其程序未執行，而當 Claude Code 重新啟動它時，另一個 Claude Code 程序停止了它，例如在另一個終端機中的 `claude stop`。Claude Code 保持工作階段停止：
4681 4729
4682```text theme={null}4730```text theme={null}
4683Session <id> was stopped while the respawn was in flight4731Session <id> was stopped while the respawn was in flight
4684```4732```
4685 4733
4686開啟您剛分派的工作階段，當其程序仍在啟動時，等待程序。在 v2.1.246 之前，在那一刻開啟它可能會停止它並顯示此訊息。4734開啟您剛分派、其程序仍在啟動中的工作階段時，會改為等待該程序。在 v2.1.246 之前，在那一刻開啟它可能會停止它並顯示此訊息。
4687 4735
4688**該怎麼做：**4736**該怎麼做：**
4689 4737
4690* 如果您沒有停止工作階段，在代理檢視中再次開啟其列或執行 `claude respawn <id>` 重新啟動它4738* 如果您沒有停止工作階段，在 agent 檢視中再次開啟其列或執行 `claude respawn <id>` 重新啟動它
4691* 如果您自己停止了它，沒有什麼剩下要做的：工作階段保持停止4739* 如果您自己停止了它，就不需要再做任何事：工作階段保持停止
4692 4740
4693<h3 id="session-agent-no-longer-available">4741<h3 id="session-agent-no-longer-available">
4694 工作階段代理不再可用4742 工作階段 agent 不再可用
4695</h3>4743</h3>
4696 4744
4697您繼續了執行[自訂代理](/docs/zh-TW/sub-agents#invoke-subagents-explicitly)的工作階段，使用 `--agent` 或 `agent` 設定啟動，Claude Code 未找到該名稱的代理。它首先搜索工作階段的原始目錄，當您[信任該工作區](/docs/zh-TW/permissions#project-allow-rules-and-workspace-trust)時，然後搜索您繼續的目錄。工作階段仍然繼續，但使用預設工具，因此代理的工具限制不再適用：4745您繼續了一個執行[自訂 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 4746
4699```text theme={null}4747```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>.4748This 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```4749```
4702 4750
4703訊息只命名 Claude Code 搜索的目錄，無論您喚醒[背景工作階段](/docs/zh-TW/agent-view)、執行 `/resume` 或 `claude --resume`，還是在[非互動模式](/docs/zh-TW/headless)中繼續，它都會出現在繼續的對話中，它也會進入 stderr。使用 `--input-format stream-json` 的工作階段不顯示它，因為 Agent SDK 在啟動後提供代理。4751警告只列出 Claude Code 搜尋過的目錄，無論您是喚醒[背景工作階段](/docs/zh-TW/agent-view)、執行 `/resume` 或 `claude --resume`，還是在[非互動模式](/docs/zh-TW/headless)中繼續，它都會出現在繼續的對話中；在非互動模式中它也會輸出到 stderr。使用 `--input-format stream-json` 的工作階段不會顯示它，因為 Agent SDK 在啟動後才提供 agent。
4704 4752
4705Claude Code 不會將回退儲存到工作階段，因此警告在每次繼續時重複，直到您採取行動。內建 `claude` 代理不觸發警告，因為回退到預設工具集對它沒有變化。在 v2.1.216 之前，Claude Code 無聲地繼續作為預設代理，查詢僅涵蓋您繼續的目錄，因此專案範圍的代理在從另一個目錄繼續時丟失。4753Claude Code 不會將此備援儲存到工作階段，因此警告會在每次繼續時重複出現，直到您採取行動。內建 `claude` agent 不會觸發警告，因為改用預設工具集對它沒有任何變化。在 v2.1.216 之前，Claude Code 會無聲地以預設 agent 繼續，且查詢僅涵蓋您繼續時所在的目錄，因此從另一個目錄繼續時，專案範圍的 agent 就會遺失。
4706 4754
4707**該怎麼做：**4755**該怎麼做：**
4708 4756
4709* 在工作階段的專案中的 `.claude/agents/<name>.md` 或個人代理的 `~/.claude/agents/<name>.md` 重新建立代理檔案，然後再次繼續4757* 在工作階段專案中的 `.claude/agents/<name>.md`，或針對個人 agent 在 `~/.claude/agents/<name>.md` 重新建立 agent 檔案，然後再次繼續
4710* 或使用 `--agent <name>` 繼續，命名確實存在的代理，以改為作為該代理執行工作階段4758* 或使用 `--agent <name>` 繼續，指定確實存在的 agent，以改為作為該 agent 執行工作階段
4711* 如果代理是專案範圍的，您尚未信任工作階段的原始目錄，請在那裡執行 Claude Code 一次，接受信任對話，然後再次繼續4759* 如果 agent 是專案範圍的，而您尚未信任工作階段的原始目錄，請在那裡執行 Claude Code 一次，接受信任對話框，然後再次繼續
4712 4760
4713<h3 id="claude_code_process_wrapper-launcher-errors">4761<h3 id="claude_code_process_wrapper-launcher-errors">
4714 CLAUDE\_CODE\_PROCESS\_WRAPPER 啟動器錯誤4762 CLAUDE\_CODE\_PROCESS\_WRAPPER 啟動器錯誤
4715</h3>4763</h3>
4716 4764
4717[`CLAUDE_CODE_PROCESS_WRAPPER`](/docs/zh-TW/corporate-launcher)已設定，其值無法使用，因此 Claude Code 拒絕啟動受影響的程序，而不是在沒有啟動器的情況下執行它。配置問題報告為以變數名稱開頭並說明原因的訊息，例如：4765[`CLAUDE_CODE_PROCESS_WRAPPER`](/docs/zh-TW/corporate-launcher) 已設定，但其值無法使用，因此 Claude Code 拒絕啟動受影響的程序，而不是在沒有啟動器的情況下執行它。設定問題會以變數名稱開頭並說明原因的訊息報告，例如：
4718 4766
4719```text theme={null}4767```text theme={null}
4720CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file4768CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file
4721```4769```
4722 4770
4723啟動但在不用 Claude Code 替換自己的情況下退出的啟動器會使其啟動的工作階段失敗，工作階段在代理檢視中的列報告啟動器 `must exec, not daemonize`，後跟啟動器列印的任何內容。無法啟動或到達背景服務的工作階段因啟動器報告啟動器問題作為 `Couldn't reach the background service (...)` 內的原因。4771啟動後未以 Claude Code 替換自己就退出的啟動器，會使其正在啟動的工作階段失敗，該工作階段在 agent 檢視中的列會報告啟動器 `must exec, not daemonize`，後接啟動器列印的任何內容。因啟動器而無法啟動或無法連線到背景服務的工作階段，會將啟動器問題作為 `Couldn't reach the background service (...)` 內的原因報告。
4724 4772
4725**該怎麼做：**4773**該怎麼做：**
4726 4774
4727* 將變數設定為以呼叫 `exec "$@"` 結尾的可執行檔的絕對路徑。有關完整合約，請參閱[啟動器合約](/docs/zh-TW/corporate-launcher#the-launcher-contract)4775* 將變數設定為以呼叫 `exec "$@"` 結尾的可執行檔的絕對路徑。有關完整合約，請參閱[啟動器合約](/docs/zh-TW/corporate-launcher#the-launcher-contract)
4728* 檢查 `/status`，其在 Self-exec 項中顯示已解析的啟動命令，並在執行中的背景服務不符合時警告，或從殼層執行 `claude daemon status`4776* 檢查 `/status`，其在 Self-exec 項目中顯示已解析的啟動命令，並在執行中的背景服務不符合時發出警告，或從 shell 執行 `claude daemon status`
4729* 在[設定](/docs/zh-TW/corporate-launcher#set-up-the-launcher)的 `env` 區塊中修復值後，使用 `claude daemon stop --any` 重新啟動背景服務，以便下次分派啟動包裝的服務4777* 在[設定](/docs/zh-TW/corporate-launcher#set-up-the-launcher)的 `env` 區塊中修正值後，使用 `claude daemon stop --any` 重新啟動背景服務，以便下次分派時啟動經過包裝的服務
4730 4778
4731<h3 id="eunknown-when-starting-a-background-session">4779<h3 id="eunknown-when-starting-a-background-session">
4732 啟動背景工作階段時 EUNKNOWN4780 啟動背景工作階段時 EUNKNOWN
4733</h3>4781</h3>
4734 4782
4735Windows 拒絕使用沒有標準名稱的錯誤代碼啟動程式，因此失敗表現為 `EUNKNOWN`。通常的觸發器是軟體限制原則，例如群組原則或 AppLocker，阻止正在啟動的程式。當您使用 `/background` 或 `claude --bg` 啟動[背景工作階段](/docs/zh-TW/agent-view)時，錯誤出現：4783Windows 以沒有標準名稱的錯誤代碼拒絕啟動程式，因此失敗表現為 `EUNKNOWN`。通常的觸發原因是軟體限制原則（例如群組原則或 AppLocker）阻止正在啟動的程式。當您使用 `/background` 或 `claude --bg` 啟動[背景工作階段](/docs/zh-TW/agent-view)時，會出現此錯誤：
4736 4784
4737```text theme={null}4785```text theme={null}
4738Couldn't reach the background service (spawn background service: EUNKNOWN: unknown error, uv_spawn) — run 'claude daemon status'4786Couldn't reach the background service (spawn background service: EUNKNOWN: unknown error, uv_spawn) — run 'claude daemon status'
4739```4787```
4740 4788
4741在某些帳戶上，訊息在 `daemon` 位置說 `background service`。4789在某些帳戶上，訊息會以 `daemon` 取代 `background service`。
4742 4790
4743在 npm 安裝上，在 `npm install -g @anthropic-ai/claude-code` 替換二進位檔案時出現的 `EUNKNOWN` 與[重新安裝期間的 `EACCES`](#eacces-when-starting-a-background-session)有相同的原因，並在您在安裝完成後重試時清除。4791在 npm 安裝上，在 `npm install -g @anthropic-ai/claude-code` 替換二進位檔案時出現的 `EUNKNOWN` 與[重新安裝期間的 `EACCES`](#eacces-when-starting-a-background-session) 有相同的原因，並會在安裝完成後重試時消除。
4744 4792
4745Claude Code 透過 PowerShell 啟動背景服務，以便服務在關閉終端時存活，在安裝時使用 PowerShell 7，否則使用 Windows PowerShell 5.1。當兩個 PowerShell 都無法執行時，Claude Code 改為直接啟動服務，因此只阻止 PowerShell 的原則不會導致此錯誤。4793Claude Code 透過 PowerShell 啟動背景服務，以便服務在關閉終端機後仍能存活；已安裝 PowerShell 7 時使用它，否則使用 Windows PowerShell 5.1。當兩個 PowerShell 都無法執行時，Claude Code 改為直接啟動服務，因此只阻止 PowerShell 的原則不會導致此錯誤。
4746 4794
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。4795在 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 4796
4749**該怎麼做：**4797**該怎麼做：**
4750 4798
4751* 如果訊息讀取 `Couldn't start the session`，升級到 v2.1.212 或更新版本。在較早的版本上，您也可以在單獨的終端中首先執行 `claude daemon run`，然後再次啟動背景工作階段。該命令在終端的前景中執行背景服務，因此服務僅在該終端保持開啟時持續。4799* 如果訊息顯示 `Couldn't start the session`，請升級到 v2.1.212 或更新版本。在較早的版本上，您也可以先在另一個終端機中執行 `claude daemon run`，然後再次啟動背景工作階段。該命令在終端機的前景中執行背景服務，因此服務僅在該終端機保持開啟時持續運作。
4752* 如果 npm 安裝正在替換二進位檔案，等待它完成，然後再次啟動背景工作階段4800* 如果 npm 安裝正在替換二進位檔案，請等待它完成，然後再次啟動背景工作階段
4753* 如果錯誤在 v2.1.212 或更新版本上出現，沒有 npm 安裝執行，請要求您的 Windows 管理員在限制原則中允許 Claude Code 可執行檔4801* 如果錯誤在 v2.1.212 或更新版本上出現，且沒有 npm 安裝正在執行，請向您的 Windows 管理員確認是否有限制原則阻止 Claude Code 可執行檔
4754* 如果關閉終端時背景服務停止，Claude Code 在沒有 PowerShell 的情況下啟動它。安裝 PowerShell 7，或要求您的管理員解除阻止 PowerShell，以便服務可以超越終端。4802* 如果關閉終端機時背景服務停止，表示 Claude Code 是在沒有 PowerShell 的情況下啟動它的。請安裝 PowerShell 7，或要求您的管理員解除對 PowerShell 的阻止，以便服務可以在終端機關閉後繼續運作。
4755 4803
4756<h3 id="eacces-when-starting-a-background-session">4804<h3 id="eacces-when-starting-a-background-session">
4757 啟動背景工作階段時 EACCES4805 啟動背景工作階段時 EACCES
4758</h3>4806</h3>
4759 4807
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)開啟工作階段時，錯誤出現：4808Claude 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 4809
4762```text theme={null}4810```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'4811Couldn'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```4812```
4765 4813
4766當您使用 `/background` 或 `claude --bg` 啟動工作階段時，相同的原因出現在 `Couldn't reach the background service (...)` 內。在相同重新安裝視窗期間，錯誤可能命名另一個代碼，例如 `ENOENT` 或 `ENOEXEC`，或 Windows 上的 `EUNKNOWN` 或 `EPERM`；跨重試持續的 `EUNKNOWN` 有[不同的原因](#eunknown-when-starting-a-background-session)。4814當您使用 `/background` 或 `claude --bg` 啟動工作階段時，相同的原因出現在 `Couldn't reach the background service (...)` 內。在相同的重新安裝期間，錯誤可能改為顯示另一個代碼，例如 `ENOENT` 或 `ENOEXEC`，或 Windows 上的 `EUNKNOWN` 或 `EPERM`；在多次重試後仍持續的 `EUNKNOWN` 有[不同的原因](#eunknown-when-starting-a-background-session)。
4767 4815
4768在 npm 安裝上，Claude Code 等待重新安裝完成並自動重試：最多十秒，以及在 npm 安裝 Claude Code 在機器上明顯仍在執行時最多兩分鐘，涵蓋另一個 Claude Code 程序下載更新。當安裝超過該等待時，失敗命名更新而不是裸錯誤代碼：4816在 npm 安裝上，Claude Code 會等待重新安裝完成並自動重試：最多十秒，而當機器上明顯仍有 Claude Code 的 npm 安裝在執行時最多兩分鐘，這涵蓋了另一個 Claude Code 程序正在下載更新的情況。當安裝超過該等待時間時，失敗訊息會提及更新，而不是單純的錯誤代碼：
4769 4817
4770```text theme={null}4818```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 finishes4819Claude Code is being updated by npm on this machine (still not runnable after 2 min, EACCES) — try again when the update finishes
4772```4820```
4773 4821
4774在 v2.1.257 之前，等待在每種情況下停止在十秒，因此此錯誤在另一個 Claude Code 程序仍在下載更新時出現。在 v2.1.246 之前，Claude Code 立即失敗，沒有等待。4822在 v2.1.257 之前，等待在所有情況下都在十秒停止，因此此錯誤會在另一個 Claude Code 程序仍在下載更新時出現。在 v2.1.246 之前，Claude Code 會立即失敗，不會等待。
4775 4823
4776**該怎麼做：**4824**該怎麼做：**
4777 4825
4778* 等待幾秒，然後開啟工作階段或再次分派。當訊息說 Claude Code 正在更新時，在更新完成後重試。4826* 等待幾秒，然後開啟工作階段或再次分派。當訊息說 Claude Code 正在更新時，請在更新完成後重試。
4779* 如果錯誤在沒有 npm 安裝執行時持續，您的使用者無法執行已安裝的二進位檔案。檢查其權限及其目錄的，或重新安裝 Claude Code。4827* 如果錯誤在沒有 npm 安裝執行時持續，表示您的使用者無法執行已安裝的二進位檔案。請檢查其權限及其目錄的權限，或重新安裝 Claude Code。
4780 4828
4781<h3 id="background-service-exited-before-it-became-reachable">4829<h3 id="background-service-exited-before-it-became-reachable">
4782 背景服務在變得可到達之前退出4830 背景服務在可連線之前退出
4783</h3>4831</h3>
4784 4832
4785Claude Code 啟動為[背景服務](/docs/zh-TW/agent-view#the-supervisor-process)的程序在變得可到達之前退出，因此 Claude Code 無法開啟您的工作階段。當服務在退出前列印錯誤時，括號中的原因給出退出代碼或訊號以及服務列印的第一行，其命名停止它的內容：4833Claude Code 作為[背景服務](/docs/zh-TW/agent-view#the-supervisor-process)啟動的程序在接受連線之前就退出了，因此 Claude Code 無法開啟您的工作階段。當服務在退出前列印了錯誤時，括號中的原因會提供退出碼或訊號以及服務列印的第一行，該行指出使其停止的原因：
4786 4834
4787```text theme={null}4835```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'4836Couldn'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```4837```
4790 4838
4791當您從[代理檢視](/docs/zh-TW/agent-view)開啟工作階段時，相同的原因跟隨 `Couldn't start the background service —`。當服務在退出前未列印任何內容時，訊息改為說 `nothing on stderr`。4839當您從 [agent 檢視](/docs/zh-TW/agent-view)開啟工作階段時，相同的原因接在 `Couldn't start the background service —` 之後。當服務在退出前未列印任何內容時，訊息改為顯示 `nothing on stderr`。
4792 4840
4793Claude Code 使用服務的錯誤行報告失敗。在 v2.1.246 之前，失敗僅在 45 秒等待後表現，為 `background service did not become reachable within 45s`，沒有服務的錯誤行。4841Claude Code 會連同服務的錯誤行一起報告失敗。在 v2.1.246 之前，失敗僅在等待 45 秒後才以 `background service did not become reachable within 45s` 的形式出現，且不含服務的錯誤行。
4794 4842
4795兩個引用的原因有已知的原因：4843兩種引用的原因有已知的成因：
4796 4844
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 自我更新在安裝視窗期間在每次啟動時產生此失敗。4845* `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 之前，這樣的鎖定阻止每次啟動，直到您刪除檔案。4846* Windows 上每次啟動時都出現 `nothing on stderr` 且退出碼為 1：`daemon.lock` 指向一個 Claude Code 既無法傳送訊號、也無法證明已消失的程序，因此每個新服務都判定另一個服務持有鎖定並退出。Claude Code 能證明其寫入者已消失的鎖定會自動被替換，不會產生此失敗。當失敗在每次啟動時重複出現時，請刪除 `~/.claude/daemon.lock`，然後開啟工作階段或再次分派。在 v2.1.257 之前，這樣的鎖定會阻止每次啟動，直到您刪除該檔案。
4799 4847
4800**該怎麼做：**4848**該怎麼做：**
4801 4849
4802* 如果訊息引用一行，修復它命名的內容，然後開啟工作階段或再次分派。下次嘗試再次啟動服務4850* 如果訊息引用了一行，請修正其指出的問題，然後開啟工作階段或再次分派。下次嘗試會再次啟動服務
4803* 執行 `claude daemon status` 檢查現在是否有服務執行4851* 執行 `claude daemon status` 檢查現在是否有服務正在執行
4804 4852
4805<h3 id="working-directory-no-longer-exists-when-starting-a-background-session">4853<h3 id="working-directory-no-longer-exists-when-starting-a-background-session">
4806 啟動背景工作階段時工作目錄不再存在4854 啟動背景工作階段時工作目錄不再存在
4807</h3>4855</h3>
4808 4856
4809您嘗試在不再存在的目錄中啟動[背景工作階段](/docs/zh-TW/agent-view)。Claude Code 不啟動工作階段，訊息命名遺漏的目錄：4857您啟動[背景工作階段](/docs/zh-TW/agent-view)時所在的目錄在工作階段啟動期間被移除。Claude Code 不會啟動工作階段，訊息會指出遺失的目錄：
4810 4858
4811```text theme={null}4859```text theme={null}
4812Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)4860Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)
4813```4861```
4814 4862
4815在 v2.1.257 之前，工作階段似乎啟動，然後在代理檢視中顯示為失敗列，原因相同。4863在 v2.1.257 之前，工作階段看似已啟動，然後在 agent 檢視中顯示為失敗列，原因相同。
4816 4864
4817在 v2.1.281 之前，此訊息也在您啟動工作階段之前目錄已消失時出現。該案例報告[`could not be resolved on disk`](#workspace-not-trusted-when-dispatching-a-background-session)。4865在 v2.1.281 之前，當目錄在您啟動工作階段之前就已消失時，也會出現此訊息。該情況會報告 [`could not be resolved on disk`](#workspace-not-trusted-when-dispatching-a-background-session)。
4818 4866
4819**該怎麼做：**4867**該怎麼做：**
4820 4868
4821* 重新建立訊息命名的目錄，或從存在的目錄分派，然後再試一次4869* 重新建立訊息指出的目錄，或從存在的目錄分派，然後再試一次
4822 4870
4823<h3 id="workspace-not-trusted-when-dispatching-a-background-session">4871<h3 id="workspace-not-trusted-when-dispatching-a-background-session">
4824 分派背景工作階段時工作區未信任4872 分派背景工作階段時工作區未信任
4825</h3>4873</h3>
4826 4874
4827您在未[信任](/docs/zh-TW/permissions#project-allow-rules-and-workspace-trust)的目錄中啟動或重新啟動[背景工作階段](/docs/zh-TW/agent-view)，工作區信任對話無法出現以詢問您。Claude Code 不啟動工作階段：4875您在尚未[信任](/docs/zh-TW/permissions#project-allow-rules-and-workspace-trust)的目錄中啟動或重新啟動[背景工作階段](/docs/zh-TW/agent-view)，而工作區信任對話框無法出現來詢問您。Claude Code 不會啟動工作階段：
4828 4876
4829```text theme={null}4877```text theme={null}
4830Workspace not trusted. Run `claude` in /path/to/project once and accept the trust prompt, then retry.4878Workspace not trusted. Run `claude` in /path/to/project once and accept the trust prompt, then retry.
4831```4879```
4832 4880
4833從工作階段自己的目錄中的終端，相同的命令改為顯示信任對話並在您接受後啟動工作階段。此訊息出現在沒有對話可以出現的地方，例如在指令碼中，或當您從不同於其自己的目錄重新啟動工作階段時。4881若從工作階段自己目錄中的終端機執行，相同的命令會改為顯示信任對話框，並在您接受後啟動工作階段。此訊息出現在無法顯示對話框的地方，例如在指令碼中，或當您從非其自身的目錄重新啟動工作階段時。
4834 4882
4835兩個變體命名不同的原因：4883兩種變體指出不同的原因：
4836 4884
4837* **`The home directory is trusted one session at a time`**：工作階段的目錄是您的主目錄。Claude Code 永遠不會儲存主目錄的信任，因此在較早的工作階段中在那裡接受對話不計算。4885* **`The home directory is trusted one session at a time`**：工作階段的目錄是您的家目錄。Claude Code 永遠不會儲存家目錄的信任，因此在較早的工作階段中於該處接受對話框並不算數。
4838* **`<path> could not be resolved on disk`**：Claude Code 無法在磁碟上找到工作階段的目錄。4886* **`<path> could not be resolved on disk`**：Claude Code 無法在磁碟上找到工作階段的目錄。
4839 4887
4888在 v2.1.286 之前，在 Windows 上，如果信任記錄儲存時路徑的大小寫不同，此訊息也可能出現在您已信任的目錄中。請更新到 v2.1.286 或更新版本。
4889
4840**該怎麼做：**4890**該怎麼做：**
4841 4891
4842* 在訊息命名的目錄中執行 `claude` 並接受信任對話，然後再次執行命令4892* 在訊息指出的目錄中執行 `claude` 並接受信任對話框，然後再次執行命令
4843* 對於主目錄訊息，從您主目錄中的終端執行命令，以便對話可以出現，或改為從專案目錄啟動工作階段4893* 對於家目錄訊息，請從家目錄中的終端機執行命令，以便對話框可以出現，或改為從專案目錄啟動工作階段
4844* 對於 `could not be resolved on disk` 訊息，重新建立目錄，或從存在的目錄啟動新工作階段4894* 對於 `could not be resolved on disk` 訊息，請重新建立目錄，或從存在的目錄啟動新工作階段
4845 4895
4846<h2 id="wrapper-and-ide-errors">4896<h2 id="wrapper-and-ide-errors">
4847 包裝程式和 IDE 錯誤4897 包裝程式和 IDE 錯誤
