Documentation 2026-11-12 23:02 UTC to 2026-11-13 02:00 UTC

349 349 

350### 當模型在工作階段中被停用時350### 當模型在工作階段中被停用時

351 351 

352如果您的帳戶失去對工作階段執行所在模型的存取權，例如因為管理員在您的 Amazon Bedrock 帳戶中停用了它，Claude Code 會將工作階段切換到另一個模型，而不是讓每個請求都失敗，並顯示 `Switched to <fallback> because <model> is not available`。它會嘗試與啟動備援相同的模型：先嘗試同一層級的較早版本，對於沒有可用 Opus 版本的 Opus 工作階段，則嘗試預設的 Sonnet 模型。352當 Amazon Bedrock 以您的帳戶無法使用為由拒絕您工作階段的模型時，Claude Code 會將您的工作階段切換到另一個模型，讓您可以繼續工作。您會看到一則以 `Switched to <fallback> because <model> is not available` 開頭的訊息。例如，當管理員停用該模型，或最新的模型尚未對您的帳戶開放時，就會發生這種情況。

353 353 

354切換僅適用於您未釘選的層級，這與啟動備援的條件相同。在您選擇的特定版本上執行的工作階段，或在[應用程式推論設定檔 ARN](#map-each-model-version-to-an-inference-profile) 上執行的工作階段，會保持其模型，且若沒有備援模型鏈，請求會失敗。在[自動模式](https://code.claude.com/docs/zh-TW/permission-modes.md#enable-auto-mode-on-bedrock-agent-platform-or-foundry)中，Claude Code 只會切換到自動模式在 Amazon Bedrock 上支援的模型。如果這些模型都無法使用，請求會失敗並顯示 [AWS authentication failed](https://code.claude.com/docs/zh-TW/errors.md#aws-authentication-failed)，並提示啟用該模型。354如果您設定了[備援模型鏈](https://code.claude.com/docs/zh-TW/model-config.md#fallback-model-chains)，Claude Code 會改為切換到您設定的備援模型。若沒有備援模型鏈，請求會在下列情況中失敗：

355 355 

356您設定的[備援模型鏈](https://code.claude.com/docs/zh-TW/model-config.md#fallback-model-chains)會取代層級切換：在這些拒絕上，Claude Code 會切換到您設定的備援模型。若要讓被拒絕的請求失敗而不是切換，請設定 [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](https://code.claude.com/docs/zh-TW/env-vars)。您設定的備援鏈仍會在這些拒絕上切換；如果您希望每個被拒絕的請求都失敗，也請移除該鏈。356* 您的工作階段使用的是釘選的模型、您選擇的特定版本，或[應用程式推論設定檔 ARN](#map-each-model-version-to-an-inference-profile)

357* [Claude Code 嘗試的模型](#startup-model-checks)都無法使用。在[自動模式](https://code.claude.com/docs/zh-TW/permission-modes.md#enable-auto-mode-on-bedrock-agent-platform-or-foundry)中，Claude Code 只會切換到自動模式在 Amazon Bedrock 上支援的模型。

358 

359若要繼續工作，請在工作階段中執行 `/model`，並在您的帳戶可使用的模型上按 `s`，這樣不會變更您的預設。`403` 會顯示為 [AWS authentication failed](https://code.claude.com/docs/zh-TW/errors.md#aws-authentication-failed)。

360 

361若要讓被拒絕的請求失敗而不是切換，請設定 [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](https://code.claude.com/docs/zh-TW/env-vars)。如果您設定了備援模型鏈，也請將其移除，因為 Claude Code 仍會改用該備援模型。

357 362 

358## 跨區域推論設定檔前綴363## 跨區域推論設定檔前綴

359 364 

315 {315 {

316 "matcher": "Edit|Write",316 "matcher": "Edit|Write",

317 "hooks": [317 "hooks": [

318 { "type": "command", "command": "npx prettier --write --ignore-unknown \"$(jq -r '.tool_input.file_path')\"" }318 { "type": "command", "command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\"" }

319 ]319 ]

320 }320 }

321 ]321 ]

74| PostgreSQL 11 或更新版本 | 支援裝置登入流程與速率限制計數器。受管理的 PostgreSQL 服務亦可使用，包括最小的方案；請參閱[支援哪些資料庫](https://code.claude.com/docs/zh-TW/claude-apps-gateway-deploy.md#postgres)。搭配[支出上限](https://code.claude.com/docs/zh-TW/claude-apps-gateway-spend-limits.md)使用時，它也會保存應備份的持久性支出、稽核與身分資料表。建議透過 `?sslmode=require` 使用 TLS。PostgreSQL 11、12 與 13 需要閘道伺服器上的 Claude Code 為 v2.1.290 或更新版本。PostgreSQL 專案已不再維護這些版本，因此請盡可能使用較新的版本。 |74| PostgreSQL 11 或更新版本 | 支援裝置登入流程與速率限制計數器。受管理的 PostgreSQL 服務亦可使用，包括最小的方案；請參閱[支援哪些資料庫](https://code.claude.com/docs/zh-TW/claude-apps-gateway-deploy.md#postgres)。搭配[支出上限](https://code.claude.com/docs/zh-TW/claude-apps-gateway-spend-limits.md)使用時，它也會保存應備份的持久性支出、稽核與身分資料表。建議透過 `?sslmode=require` 使用 TLS。PostgreSQL 11、12 與 13 需要閘道伺服器上的 Claude Code 為 v2.1.290 或更新版本。PostgreSQL 專案已不再維護這些版本，因此請盡可能使用較新的版本。 |

75| 模型上游 | Amazon Bedrock 憑證、Claude Platform on AWS 憑證、Google Cloud 憑證、Microsoft Foundry 資源或 Anthropic API 金鑰。支援具備容錯移轉的多個上游。 |75| 模型上游 | Amazon Bedrock 憑證、Claude Platform on AWS 憑證、Google Cloud 憑證、Microsoft Foundry 資源或 Anthropic API 金鑰。支援具備容錯移轉的多個上游。 |

76| HTTPS | 開發人員的筆記型電腦以及用於登入的任何瀏覽器都必須能透過 `https://` 連線到閘道；閘道會在同一個接聽程式上提供裝置驗證頁面。請透過 `listen.tls` 提供 TLS 憑證，或在終止 TLS 的 ingress 之後執行，兩種情況下都請將 `listen.public_url` 設為外部來源。在 `/login` 時，只有當閘道主機為迴路位址（`localhost`、`127.0.0.1` 或 `::1`）時，Claude Code 才接受純 `http://` 來源。 |76| HTTPS | 開發人員的筆記型電腦以及用於登入的任何瀏覽器都必須能透過 `https://` 連線到閘道；閘道會在同一個接聽程式上提供裝置驗證頁面。請透過 `listen.tls` 提供 TLS 憑證，或在終止 TLS 的 ingress 之後執行，兩種情況下都請將 `listen.public_url` 設為外部來源。在 `/login` 時，只有當閘道主機為迴路位址（`localhost`、`127.0.0.1` 或 `::1`）時，Claude Code 才接受純 `http://` 來源。 |

77| 私人網路位址 | 在 `/login` 時，Claude Code 要求閘道的主機名稱或 IP 位址僅解析為私人位址：RFC 1918、鏈路本機、CGNAT `100.64.0.0/10`、IPv6 ULA `fc00::/7` 或迴路位址。對於您自行託管的閘道，任何不在您所宣告區塊內的公用位址都會遭到拒絕；請參閱部署指南中的[威脅模型](https://code.claude.com/docs/zh-TW/claude-apps-gateway-deploy.md#threat-model-summary)。如果開發人員機器透過公司代理伺服器路由 HTTPS，登入時也要求代理伺服器主機解析為私人位址；若非如此，請將閘道主機加入 `NO_PROXY`，讓 CLI 直接連線。如果您的內部網路使用組織所擁有的公用 IPv4 位址空間進行編號，請[宣告這些區塊](#allow-a-gateway-on-public-address-space-you-own)，讓 `/login` 接受位於該處的閘道。 |77| 私人網路位址 | Claude Code 的 `/login` 要求閘道的主機名稱或 IP 位址僅解析為私人位址：RFC 1918 與鏈路本機範圍、CGNAT `100.64.0.0/10`、IPv6 ULA `fc00::/7` 以及迴路位址。請參閱[威脅模型](https://code.claude.com/docs/zh-TW/claude-apps-gateway-deploy.md#threat-model-summary)。如果您的內部網路使用組織所擁有的公用 IPv4 位址空間進行編號，請[宣告這些區塊](#allow-a-gateway-on-public-address-space-you-own)，讓 `/login` 接受位於該處的閘道。 |

78| Linux 執行環境 | 閘道伺服器只能在原生 Linux 二進位檔上執行。macOS 可用於本機開發。不支援以 Windows 作為伺服器平台。 |78| Linux 執行環境 | 閘道伺服器只能在原生 Linux 二進位檔上執行。macOS 可用於本機開發。不支援以 Windows 作為伺服器平台。 |

79 79 

80當 `HTTPS_PROXY` 或 `HTTP_PROXY` 適用於閘道主機時，登入還需要主機名稱解析為私人位址的代理伺服器，或在開發人員機器上將閘道主機加入 `NO_PROXY`，兩者擇一。如果這些機器也設定了 `no_proxy`，也請將閘道主機加入其中，否則模型請求仍會經過代理伺服器。

81 

80### 步驟82### 步驟

81 83 

82**1. 在您的 IdP 中註冊 OAuth 用戶端**84**1. 在您的 IdP 中註冊 OAuth 用戶端**

654 654 

655| 設定 | 方式 |655| 設定 | 方式 |

656| - | - |656| - | - |

657| RBAC | 授予閘道的身分識別在 Microsoft Foundry 資源上的 `Azure AI User` 或 `Cognitive Services User` |657| RBAC | 在 Microsoft Foundry 資源上授予閘道的身分 `Foundry User` 或 `Cognitive Services User` 角色 |

658| 部署 | Microsoft Foundry 使用管理員選擇的部署名稱，而不是規範模型 ID。新增 [`models:`](#models) 區塊，將每個規範 ID 對應到您的部署名稱。 |658| 部署 | Microsoft Foundry 使用管理員選擇的部署名稱，而不是規範模型 ID。新增 [`models:`](#models) 區塊，將每個規範 ID 對應到您的部署名稱。 |

659| AKS (工作負載身分識別) | 將使用者指派的受管身分識別與叢集的 OIDC 簽發者聯合，並將其繫結到閘道的服務帳戶。`use_azure_ad: true` 透過 `WorkloadIdentityCredential` 拾取它。 |659| AKS (工作負載身分識別) | 將使用者指派的受管身分識別與叢集的 OIDC 簽發者聯合，並將其繫結到閘道的服務帳戶。`use_azure_ad: true` 透過 `WorkloadIdentityCredential` 拾取它。 |

660| ACI / App Service | 在資源上啟用系統指派或使用者指派的受管身分識別。`use_azure_ad: true` 會拾取它。 |660| ACI / App Service | 在資源上啟用系統指派或使用者指派的受管身分識別。`use_azure_ad: true` 會拾取它。 |

999 999 

1000`upstream_model` 下的每個金鑰必須符合已設定上游的 `name`，預設為提供者名稱。不符合任何上游的金鑰會導致啟動失敗，因此省略您不使用的提供者的列。1000`upstream_model` 下的每個金鑰必須符合已設定上游的 `name`，預設為提供者名稱。不符合任何上游的金鑰會導致啟動失敗，因此省略您不使用的提供者的列。

1001 1001 

1002若要讓開發人員在 `auto_include_builtin_models: false` 時使用 `fable` 別名，請在 `models` 中加入 `claude-fable-5` 項目。對於登入閘道的開發人員，這就是 [`fable` 別名](https://code.claude.com/docs/zh-TW/model-config#fable-alias-resolution)解析成的 ID。若沒有此項目，他們的訊息會失敗，並出現以 `API Error: 400 model claude-fable-5 is not in the operator's model allowlist` 開頭的錯誤。

1003 

1002### `managed`1004### `managed`

1003 1005 

1004`managed` 區塊定義以 IdP 群組或電子郵件網域為鍵的角色型存取政策。政策會依序評估；預設會選取第一個符合的政策，然後合併到 `match: {}` 全包式基礎上。符合兩項角色政策的使用者只會取得第一項，因此除非您 [套用每一項符合的政策](#apply-every-matching-policy)，否則第二項政策的拒絕規則不會生效。政策會依使用者在 `GET /managed/settings` 提供，並使用 ETag/304 快取。1006`managed` 區塊定義以 IdP 群組或電子郵件網域為鍵的角色型存取政策。政策會依序評估；預設會選取第一個符合的政策，然後合併到 `match: {}` 全包式基礎上。符合兩項角色政策的使用者只會取得第一項，因此除非您 [套用每一項符合的政策](#apply-every-matching-policy)，否則第二項政策的拒絕規則不會生效。政策會依使用者在 `GET /managed/settings` 提供，並使用 ETag/304 快取。

1023`match: {}` 全部捕捉（按慣例列在最後）被視為基礎層。每個其他原則從全部捕捉繼承它未設定的任何金鑰，因此每個角色項目只需列出與組織預設不同的內容。合併規則取決於金鑰類型：1025`match: {}` 全部捕捉（按慣例列在最後）被視為基礎層。每個其他原則從全部捕捉繼承它未設定的任何金鑰，因此每個角色項目只需列出與組織預設不同的內容。合併規則取決於金鑰類型：

1024 1026 

1025* **允許清單**：`availableModels` 和 `permissions.allow`。特定原則的清單完全替換基礎的。1027* **允許清單**：`availableModels` 和 `permissions.allow`。特定原則的清單完全替換基礎的。

1026* **拒絕清單與 hook 陣列**：`permissions.deny`、`permissions.ask`、`disabledMcpjsonServers`、`deniedMcpServers`、`blockedMarketplaces`、`deniedModels`，以及每個 `hooks` 事件類型陣列。這些會取基礎與政策的聯集，因此全組織的拒絕規則或稽核 hook 不會因各角色的覆寫而被意外移除。1028* **拒絕清單與 hook 陣列**：這些會取基礎層與政策的聯集：

1029 * `permissions.deny` 與 `permissions.ask`

1030 * `disabledMcpjsonServers` 與 `deniedMcpServers`

1031 * `blockedMarketplaces` 與 `deniedModels`

1032 * `hooks` 事件類型陣列

1027* **記錄類型金鑰**：`env`、`modelOverrides` 和 `skillOverrides`。這些淺合併，因此每個角色 `env` 區塊覆寫它設定的金鑰並從基礎繼承其餘的。1033* **記錄類型金鑰**：`env`、`modelOverrides` 和 `skillOverrides`。這些淺合併，因此每個角色 `env` 區塊覆寫它設定的金鑰並從基礎繼承其餘的。

1028 1034 

1029`availableModels` 也在 `/v1/messages` 伺服器端強制執行，因此被拒絕的模型返回 `400`，無論用戶端傳送什麼。空清單會拒絕每個模型。此檢查也涵蓋開發者選擇模型之前工作階段啟動時所使用的模型，因此請[讓工作階段從原則允許的模型啟動](#start-sessions-on-a-model-the-policy-allows)。1035`availableModels` 也在 `/v1/messages` 伺服器端強制執行，因此被拒絕的模型返回 `400`，無論用戶端傳送什麼。空清單會拒絕每個模型。此檢查也涵蓋開發者選擇模型之前工作階段啟動時所使用的模型，因此請[讓工作階段從原則允許的模型啟動](#start-sessions-on-a-model-the-policy-allows)。

92 92 

93除了二進位檔案，映像還需要：93除了二進位檔案，映像還需要：

94 94 

95* **基於 glibc 的映像**：glibc 建置的唯一動態依賴項是 glibc 庫。基於 Musl 的映像需要 `linux-x64-musl` 或 `linux-arm64-musl` 建置加上額外套件；請參閱 [Alpine Linux 設定](https://code.claude.com/docs/zh-TW/setup.md#alpine-linux-and-musl-based-distributions)。95* **基於 glibc 的映像**：glibc 建置的唯一動態相依性是 glibc 函式庫。基於 Musl 的映像需要 `linux-x64-musl` 或 `linux-arm64-musl` 建置，其唯一的動態相依性是 musl。

96* **可寫入的狀態目錄**：閘道以任何使用者身份執行，但最小映像沒有可寫入的主目錄。將 `CLAUDE_CONFIG_DIR` 設定為可寫入的路徑，例如 `/tmp/.claude`。96* **可寫入的狀態目錄**：閘道以任何使用者身份執行，但最小映像沒有可寫入的主目錄。將 `CLAUDE_CONFIG_DIR` 設定為可寫入的路徑，例如 `/tmp/.claude`。

97* **容器命令**：`claude gateway --config /etc/claude/gateway.yaml`，設定檔案以唯讀方式掛載，祕密作為環境變數提供；閘道在 `listen.port` 上監聽，預設為 `8080`。97* **容器命令**：`claude gateway --config /etc/claude/gateway.yaml`，設定檔案以唯讀方式掛載，祕密作為環境變數提供；閘道在 `listen.port` 上監聽，預設為 `8080`。

98 98 

274 274 

275執行緒在 [auto mode](https://code.claude.com/docs/zh-TW/permission-modes.md#eliminate-prompts-with-auto-mode) 中執行，因此 Claude 在該資料夾中執行命令和編輯檔案而不每次都詢問您。如果 auto mode 在該電腦的 Claude Code 中不可用或關閉，執行緒執行而不使用它，並且它引發的任何權限提示等待您在執行緒中的回答，如 [解除等待批准的執行緒](#unblock-a-thread-waiting-on-approval) 所述。275執行緒在 [auto mode](https://code.claude.com/docs/zh-TW/permission-modes.md#eliminate-prompts-with-auto-mode) 中執行，因此 Claude 在該資料夾中執行命令和編輯檔案而不每次都詢問您。如果 auto mode 在該電腦的 Claude Code 中不可用或關閉，執行緒執行而不使用它，並且它引發的任何權限提示等待您在執行緒中的回答，如 [解除等待批准的執行緒](#unblock-a-thread-waiting-on-approval) 所述。

276 276 

277若要以其他模式執行執行緒，請使用 [`--settings`](https://code.claude.com/docs/zh-TW/remote-control#start-a-remote-control-session) 啟動 `claude remote-control`。然後，該檔案中或該電腦設定中的 [`permissions.defaultMode`](https://code.claude.com/docs/zh-TW/permission-modes#start-in-a-different-mode) 可以選擇其他模式。

278 

277當執行緒執行時，其標題中的筆記型電腦圖示顯示您的電腦是否已連接。點擊它以查看執行緒使用的資料夾或關閉連接。當該電腦睡眠時執行緒暫停，如果桌面應用程式或 `claude remote-control` 退出則停止。279當執行緒執行時，其標題中的筆記型電腦圖示顯示您的電腦是否已連接。點擊它以查看執行緒使用的資料夾或關閉連接。當該電腦睡眠時執行緒暫停，如果桌面應用程式或 `claude remote-control` 退出則停止。

278 280 

279* **要讓執行緒再次執行**：請參閱 [失去與您資料夾的聯繫](#lost-contact-with-your-folder)281* **要讓執行緒再次執行**：請參閱 [失去與您資料夾的聯繫](#lost-contact-with-your-folder)

35下表列出 Claude Code 中包含的所有命令。大多數是內建命令，其行為已編碼到 CLI 中。有兩種類型的項目被標記：35下表列出 Claude Code 中包含的所有命令。大多數是內建命令，其行為已編碼到 CLI 中。有兩種類型的項目被標記：

36 36 

37* **[Skill](https://code.claude.com/docs/zh-TW/skills.md#bundled-skills)**：一個隨附 skill。它的運作方式與您自己編寫的 skill 相同：一個交給 Claude 的提示詞。37* **[Skill](https://code.claude.com/docs/zh-TW/skills.md#bundled-skills)**：一個隨附 skill。它的運作方式與您自己編寫的 skill 相同：一個交給 Claude 的提示詞。

38 * `/verify` 僅在您調用時運行。

39* **[Workflow](https://code.claude.com/docs/zh-TW/workflows.md#bundled-workflows)**：一個隨附的[動態工作流程](https://code.claude.com/docs/zh-TW/workflows.md)，可將工作分散到多個 subagent 並在背景運行。38* **[Workflow](https://code.claude.com/docs/zh-TW/workflows.md#bundled-workflows)**：一個隨附的[動態工作流程](https://code.claude.com/docs/zh-TW/workflows.md)，可將工作分散到多個 subagent 並在背景運行。

40 * `/deep-research` 僅在您調用時運行。

41 39 

42要添加您自己的命令，請參閱 [skill](https://code.claude.com/docs/zh-TW/skills.md)。40要添加您自己的命令，請參閱 [skill](https://code.claude.com/docs/zh-TW/skills.md)。

43 41 

71 71 

72從您的應用程式啟動器啟動 **Claude**，或從終端機執行 `claude-desktop`，然後使用您的 Anthropic 帳戶登入。72從您的應用程式啟動器啟動 **Claude**，或從終端機執行 `claude-desktop`，然後使用您的 Anthropic 帳戶登入。

73 73 

74Linux 應用程式的登入方式與 macOS 和 Windows 上相同：使用 claude.ai 訂閱，或透過您組織的 SSO。若要使用 API 金鑰身分驗證，請使用 [CLI](https://code.claude.com/docs/zh-TW/quickstart.md)。若要改為搭配 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 或 LLM 閘道使用 Desktop，請參閱 [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)。關於這些部署中的代理伺服器和自訂憑證授權單位，請參閱 [網路設定](https://code.claude.com/docs/zh-TW/network-config.md)。74Linux 應用程式的登入方式與 macOS 和 Windows 上相同：使用 claude.ai 訂閱，或透過您組織的 SSO。若要改為搭配 Claude API 金鑰、Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 或 LLM 閘道使用 Desktop，請參閱 [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)。關於這些部署中的代理伺服器和自訂憑證授權單位，請參閱 [網路設定](https://code.claude.com/docs/zh-TW/network-config.md)。

75 75 

76### 從下載的檔案安裝76### 從下載的檔案安裝

77 77 

83 83 

84**8. 選擇權限模式和模型**84**8. 選擇權限模式和模型**

85 85 

86在指示方塊的工具列中，選擇[權限模式](#permissions-for-scheduled-tasks)和模型。如果保持不變，執行時會使用您的 Claude Code 設定和預設模型。86在指示方塊的工具列中，選擇[權限模式](#permissions-for-scheduled-tasks)和模型。

87 

88* **權限模式**：如果保持不變，執行時會使用您的 Claude Code 設定。

89* **模型**：如果模型選單顯示 **Default · Set by admin**，且您未選擇其他模型，執行時會使用您的組織在[受管設定](https://code.claude.com/docs/zh-TW/managed-settings.md)中設定的模型。在應用程式開啟時啟動的[補執行](#missed-runs)則可能改用[您帳戶的執行階段預設模型](https://code.claude.com/docs/zh-TW/model-config.md#default-model-setting)。

87 90 

88**9. 建立任務**91**9. 建立任務**

89 92 

90按一下 **Create**。如果您尚未信任該資料夾，Desktop 會在此時要求您信任它。任務的詳細資料頁面隨即開啟。93按一下 **Create**。如果您尚未信任該資料夾，Desktop 會在此時要求您信任它。任務的詳細資料頁面隨即開啟。

91 94 

95若要查看 **Default · Set by admin** 代表哪個模型，請在詳細資料頁面上按一下 **Run now** 以立即執行任務。接著[開啟該次執行的工作階段](#find-a-runs-session)，提示詞方塊下方的列會顯示模型名稱。

96 

92在詳細資料頁面上，按一下鉛筆圖示以開啟 [**Edit** 表單](#manage-scheduled-tasks)。您可以在其中變更 Desktop 根據您的指示填入的 **Description**、選擇 **Worktree**，或將排程切換為 **Manual** 或 **Custom**。97在詳細資料頁面上，按一下鉛筆圖示以開啟 [**Edit** 表單](#manage-scheduled-tasks)。您可以在其中變更 Desktop 根據您的指示填入的 **Description**、選擇 **Worktree**，或將排程切換為 **Manual** 或 **Custom**。

93 98 

94您也可以透過在任何工作階段中描述您想要的內容來建立任務。例如，「設定每天早上 9 點執行的每日程式碼審查」會建立定期任務。像「提醒我明天下午 3 點檢查部署」這樣的請求會建立一次性任務，在觸發後會自動停用。99您也可以透過在任何工作階段中描述您想要的內容來建立任務。例如，「設定每天早上 9 點執行的每日程式碼審查」會建立定期任務。像「提醒我明天下午 3 點檢查部署」這樣的請求會建立一次性任務，在觸發後會自動停用。

181 186 

182若要讓任務使用 `update_scheduled_task` MCP 工具變更其自己的排程或提示詞，請按一下 **Run now** 並每次核准該呼叫。187若要讓任務使用 `update_scheduled_task` MCP 工具變更其自己的排程或提示詞，請按一下 **Run now** 並每次核准該呼叫。

183 188 

184若要在磁碟上編輯任務的提示，請開啟 `~/.claude/scheduled-tasks/<task-name>/SKILL.md`（如果設定了 [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/zh-TW/env-vars)，則在其下）。該檔案使用 YAML frontmatter 作為 `name` 和 `description`，提示作為主體。變更在下一次執行時生效。Schedule、資料夾、模型和啟用狀態不在此檔案中：透過 Edit 表單變更它們或詢問 Claude。189若要在磁碟上編輯任務的提示詞，請開啟 `~/.claude/scheduled-tasks/<task-name>/SKILL.md`（如果設定了 [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/zh-TW/env-vars)，則在其下）。該檔案使用 YAML frontmatter 作為 `name` 和 `description`，提示詞作為主體。變更在下一次執行時生效。排程、資料夾和啟用狀態不在此檔案中：透過 Edit 表單變更它們或詢問 Claude。

185 190 

186## 相關資源191## 相關資源

187 192 

122| `A request to MCP server "<name>" was sent without your stored credentials` | [身分驗證](#couldnt-read-the-stored-credentials-for-mcp-server) |122| `A request to MCP server "<name>" was sent without your stored credentials` | [身分驗證](#couldnt-read-the-stored-credentials-for-mcp-server) |

123| `This server's URL is missing or not a valid URL, so sign-in can't start` | [身分驗證](#mcp-server-url-is-missing-or-not-a-valid-url) |123| `This server's URL is missing or not a valid URL, so sign-in can't start` | [身分驗證](#mcp-server-url-is-missing-or-not-a-valid-url) |

124| `Issuer mismatch in authorization response (RFC 9207)` | [身分驗證](#issuer-mismatch-in-authorization-response) |124| `Issuer mismatch in authorization response (RFC 9207)` | [身分驗證](#issuer-mismatch-in-authorization-response) |

125| `Stopped an OAuth request` | [身分驗證](#stopped-an-oauth-request) |

125| `Refusing to send credentials to non-https token endpoint` / `<short-name> from the MCP SDK for <server-url>` | [身分驗證](#refusing-to-send-credentials-to-non-https-token-endpoint) |126| `Refusing to send credentials to non-https token endpoint` / `<short-name> from the MCP SDK for <server-url>` | [身分驗證](#refusing-to-send-credentials-to-non-https-token-endpoint) |

126| `Cloud gateway session expired — run /login to reconnect.` | [身分驗證](#cloud-gateway-session-expired) |127| `Cloud gateway session expired — run /login to reconnect.` | [身分驗證](#cloud-gateway-session-expired) |

127| `Cloud gateway <url> no longer accepts this session` | [身分驗證](#cloud-gateway-session-expired) |128| `Cloud gateway <url> no longer accepts this session` | [身分驗證](#cloud-gateway-session-expired) |

251| `Ultrareview did not start` | [命令列錯誤](#ultrareview-did-not-start) |252| `Ultrareview did not start` | [命令列錯誤](#ultrareview-did-not-start) |

252| `Remote Control did not start: "<question>" got no answer` | [命令列錯誤](#remote-control-did-not-start-got-no-answer) |253| `Remote Control did not start: "<question>" got no answer` | [命令列錯誤](#remote-control-did-not-start-got-no-answer) |

253| `` `<flag>` before `remote-control` is not carried over to the sessions Remote Control starts `` | [命令列錯誤](#not-carried-over-to-the-sessions-remote-control-starts) |254| `` `<flag>` before `remote-control` is not carried over to the sessions Remote Control starts `` | [命令列錯誤](#not-carried-over-to-the-sessions-remote-control-starts) |

255| `Remote Control did not start, because sessions would skip part or all of the --settings file` | [命令列錯誤](#remote-control-did-not-start-because-of-the-settings-file) |

256| `The settings file <file> has changed since Remote Control started, so this session did not start` | [命令列錯誤](#settings-file-changed-since-remote-control-started) |

254| `--sandbox is not supported by claude remote-control` / `--no-sandbox is not supported by claude remote-control` | [命令列錯誤](#sandbox-is-not-supported-by-claude-remote-control) |257| `--sandbox is not supported by claude remote-control` / `--no-sandbox is not supported by claude remote-control` | [命令列錯誤](#sandbox-is-not-supported-by-claude-remote-control) |

255| `` `claude import` is not yet available in this build `` | [命令列錯誤](#claude-import-is-not-yet-available-in-this-build) |258| `` `claude import` is not yet available in this build `` | [命令列錯誤](#claude-import-is-not-yet-available-in-this-build) |

256| `Could not read Claude Code config` | [命令列錯誤](#could-not-read-claude-code-config) |259| `Could not read Claude Code config` | [命令列錯誤](#could-not-read-claude-code-config) |

825同一個 Claude 回應中的後續呼叫可能會以此原因遭到拒絕：828同一個 Claude 回應中的後續呼叫可能會以此原因遭到拒絕：

826 829 

827```text theme={null}830```text theme={null}

828another call in this response was changed by a hook after auto mode reviewed it, or could not be confirmed unchanged831another call in this response was changed after auto mode reviewed it, or could not be confirmed unchanged

829```832```

830 833 

831Claude 接著可以再次發出每個遭拒絕的呼叫，讓伺服器進行審查。若出現權限提示，請回應它。除非 Claude 在回覆中表示自動模式無法檢查該呼叫，否則您不需要做其他任何事。屆時，請停止該變更或自行核准該呼叫，並請 Claude 再試一次該呼叫：834Claude 接著可以再次發出每個遭拒絕的呼叫，讓伺服器進行審查。若出現權限提示，請回應它。除非 Claude 在回覆中表示自動模式無法檢查該呼叫，否則您不需要做其他任何事。屆時，請停止該變更或自行核准該呼叫，並請 Claude 再試一次該呼叫：

1822 1825 

1823在 v2.1.232 之前，Claude Code 只在逐步推出時或您設定 `MCP_SDK_GENERATION=v2` 時才使用 v2 執行階段。1826在 v2.1.232 之前，Claude Code 只在逐步推出時或您設定 `MCP_SDK_GENERATION=v2` 時才使用 v2 執行階段。

1824 1827 

1828### Stopped an OAuth request

1829 

1830此訊息表示 Claude Code 因 OAuth 端點將 [MCP 伺服器的 OAuth 請求](https://code.claude.com/docs/zh-TW/mcp.md#authenticate-with-remote-mcp-servers)重新導向，而停止了該請求。在此訊息的兩種形式中，第一個位址都是發出重新導向的位址：

1831 

1832```text theme={null}

1833Stopped an OAuth request, which can hold secrets: https://auth.example.com redirected it to https://other.example.com. Ask the owner of https://auth.example.com to remove that redirect.

1834Stopped an OAuth request: https://auth.example.com redirected it more than 5 times. Ask the owner of https://auth.example.com to fix those redirects.

1835```

1836 

1837**處理方式：**

1838 

1839* 請第一個位址的營運者（例如 MCP 伺服器的營運者）移除或修正該重新導向。然後從 `/mcp` 再試一次。

1840 

1825### 拒絕將憑證傳送至非 https 的 token 端點1841### 拒絕將憑證傳送至非 https 的 token 端點

1826 1842 

1827在 [v2 執行階段](https://code.claude.com/docs/zh-TW/mcp.md#mcp-client-runtimes)上，Claude Code 只會將 [MCP OAuth](https://code.claude.com/docs/zh-TW/mcp.md#authenticate-with-remote-mcp-servers) token 請求傳送至透過 HTTPS 提供，或位於 `localhost`、`127.0.0.1` 或 `::1` 的 token 端點。此訊息表示伺服器的 token 端點兩者皆非，因此 Claude Code 在傳送請求之前停止了。這發生在瀏覽器登入之後，因此瀏覽器步驟會先成功，之後每當 Claude Code 重新整理該伺服器的 token 時也會再次發生。1843在 [v2 執行階段](https://code.claude.com/docs/zh-TW/mcp.md#mcp-client-runtimes)上，Claude Code 只會將 [MCP OAuth](https://code.claude.com/docs/zh-TW/mcp.md#authenticate-with-remote-mcp-servers) token 請求傳送至透過 HTTPS 提供，或位於 `localhost`、`127.0.0.1` 或 `::1` 的 token 端點。此訊息表示伺服器的 token 端點兩者皆非，因此 Claude Code 在傳送請求之前停止了。這發生在瀏覽器登入之後，因此瀏覽器步驟會先成功，之後每當 Claude Code 重新整理該伺服器的 token 時也會再次發生。

2207 2223 

2208### 雲端工作階段中不允許主機2224### 雲端工作階段中不允許主機

2209 2225 

2210來自雲端工作階段或雲端排程任務的出站 HTTP 請求被環境的網路原則阻止。2226在雲端工作階段或雲端排程任務中，`403` 或 DNS 錯誤（例如 `ENOTFOUND`）可能表示所請求的主機不在[雲端環境的允許清單](https://code.claude.com/docs/zh-TW/cloud-environments.md#access-levels)上。若要確認，請將該主機與該清單進行比對。帶有此標頭的 `403` 可確認遭到封鎖，但並非每個遭封鎖請求的 `403` 都帶有此標頭：

2211 2227 

2212```text theme={null}2228```text theme={null}

2213HTTP 4032229HTTP 403

2565 2581 

2566Claude Code 通常會自動調整大型影像的大小。這些錯誤意味著影像無法解碼或調整大小以符合 API 限制。2582Claude Code 通常會自動調整大型影像的大小。這些錯誤意味著影像無法解碼或調整大小以符合 API 限制。

2567 2583 

2584您看到的錯誤可能會列出不同的像素上限，例如在這些範例顯示 `2000x2000px` 之處顯示 `2576x2576px`。

2585 

2568**該怎麼辦：**2586**該怎麼辦：**

2569 2587 

2570* 如果訊息要求您轉換影像，請將其轉換為 PNG、JPEG、GIF 或 WebP 並再次附加。Claude Code 可以從檔案標頭驗證這些格式的尺寸，而無需解碼影像。2588* 如果訊息要求您轉換影像，請將其轉換為 PNG、JPEG、GIF 或 WebP 並再次附加。Claude Code 可以從檔案標頭驗證這些格式的尺寸，而無需解碼影像。

3499* **`Error: Workspace not trusted. <folder> is your home directory`**：由於對家目錄的信任永遠不會被儲存，先在那裡執行 `claude` 並沒有幫助。請改從專案目錄執行 `claude ultrareview`（事先在那裡執行一次 `claude` 以接受信任對話框），或附加 `--trust-workspace`。3517* **`Error: Workspace not trusted. <folder> is your home directory`**：由於對家目錄的信任永遠不會被儲存，先在那裡執行 `claude` 並沒有幫助。請改從專案目錄執行 `claude ultrareview`（事先在那裡執行一次 `claude` 以接受信任對話框），或附加 `--trust-workspace`。

3500* **`No answer in time.` 後接 `Error: Workspace not trusted`**：`Trust <folder>? [y/N]` 問題在 5 分鐘內未獲回答。請再次執行 `claude ultrareview` 並回答它。3518* **`No answer in time.` 後接 `Error: Workspace not trusted`**：`Trust <folder>? [y/N]` 問題在 5 分鐘內未獲回答。請再次執行 `claude ultrareview` 並回答它。

3501* **`Ultrareview did not start: <folder> is not trusted`**：您在 `Trust <folder>? [y/N]` 問題中拒絕了，例如回答 `n` 或按下 Enter。若要啟動審查，請再次執行 `claude ultrareview` 並回答 `y`。3519* **`Ultrareview did not start: <folder> is not trusted`**：您在 `Trust <folder>? [y/N]` 問題中拒絕了，例如回答 `n` 或按下 Enter。若要啟動審查，請再次執行 `claude ultrareview` 並回答 `y`。

3502* **``Ultrareview did not start: `--trust-workspace` takes no value``**：`--trust-workspace` 後面接了旗標以外的內容，例如 PR 編號或 `false`。若您不信任該資料夾，請省略此旗標。若要在本次執行中信任它，請將 PR 編號或基底分支放在旗標之前：`claude ultrareview 1234 --trust-workspace`。3520* **``Ultrareview did not start: `--trust-workspace` takes no value``**：`--trust-workspace` 後面接了旗標以外的內容，例如 PR 編號或 `false`。如果您不信任該資料夾，請省略此旗標。若要在此次執行中信任它，請將 PR 編號或基礎分支放在旗標之前：`claude ultrareview 1234 --trust-workspace`。

3503 3521 

3504在 v2.1.309 之前，`claude ultrareview` 不接受 `--trust-workspace`。3522在 v2.1.309 之前，`claude ultrareview` 不接受 `--trust-workspace`。

3505 3523 

3522您在 `remote-control` 動詞之前加上了全域 `claude` 旗標來啟動 [Remote Control](https://code.claude.com/docs/zh-TW/remote-control.md)，而該旗標會限制或設定 Remote Control 所啟動的工作階段，例如 `--settings`、`--setting-sources`、`--permission-mode`、`--disallowed-tools` 或 `--mcp-config`。放在動詞之前的旗標永遠不會傳到這些工作階段。Claude Code 會改為拒絕啟動，並指出該旗標：3540您在 `remote-control` 動詞之前加上了全域 `claude` 旗標來啟動 [Remote Control](https://code.claude.com/docs/zh-TW/remote-control.md)，而該旗標會限制或設定 Remote Control 所啟動的工作階段，例如 `--settings`、`--setting-sources`、`--permission-mode`、`--disallowed-tools` 或 `--mcp-config`。放在動詞之前的旗標永遠不會傳到這些工作階段。Claude Code 會改為拒絕啟動，並指出該旗標：

3523 3541 

3524```text theme={null}3542```text theme={null}

3525Error: `--settings` before `remote-control` is not carried over to the sessions Remote Control starts, so Remote Control refuses to start rather than drop it — remove it, and give Remote Control's own options after the verb (see `claude remote-control --help`).3543Error: `--settings` before `remote-control` is not carried over to the sessions Remote Control starts, so Remote Control refuses to start rather than drop it — remove it, and give Remote Control's own options after the verb (see `claude remote-control --help`). Pass settings with `claude remote-control --settings <file>`.

3526```3544```

3527 3545 

3528對於捨棄後無害的全域旗標，例如 `--verbose`、`--model`，或由包裝程式注入的 `--session-id` 或 `--plugin-dir`，Claude Code 不會拒絕：它會忽略這些旗標，Remote Control 會照常啟動。3546對於捨棄後無害的全域旗標，例如 `--verbose`、`--model`，或由包裝程式注入的 `--session-id` 或 `--plugin-dir`，Claude Code 不會拒絕：它會忽略這些旗標，Remote Control 會照常啟動。

3536 3554 

3537在 v2.1.248 之前，當全域旗標在前時，`claude remote-control` 不接受其自身的旗標，該命令會以 `unknown option` 錯誤失敗。3555在 v2.1.248 之前，當全域旗標在前時，`claude remote-control` 不接受其自身的旗標，該命令會以 `unknown option` 錯誤失敗。

3538 3556 

3557### Remote Control 因 `--settings` 檔案而未啟動

3558 

3559您傳給 [`claude remote-control --settings`](https://code.claude.com/docs/zh-TW/remote-control#start-a-remote-control-session) 的檔案有問題：

3560 

3561```text theme={null}

3562Error: Remote Control did not start, because sessions would skip part or all of the --settings file ./rc-settings.json: Invalid or malformed JSON

3563```

3564 

3565**處理方式：**

3566 

3567* 修正訊息所指出的問題，然後重新執行您的 `claude remote-control` 命令

3568 

3569### The settings file has changed since Remote Control started

3570 

3571在執行 `claude remote-control` 的終端機中出現此訊息，表示工作階段不會以您傳給 [`--settings`](https://code.claude.com/docs/zh-TW/remote-control#start-a-remote-control-session) 之檔案的目前內容啟動：

3572 

3573```text theme={null}

3574Session failed: Error: The settings file /path/to/settings.json has changed since Remote Control started, so this session did not start. Restart `claude remote-control` to use it as it is now.

3575```

3576 

3577**處理方式：**

3578 

3579* 若要使用該檔案的目前內容，請停止 `claude remote-control` 並重新執行相同的命令。若要找回它原本服務的工作階段，請參閱[停止伺服器後繼續工作階段](https://code.claude.com/docs/zh-TW/remote-control.md#resume-sessions-after-stopping-the-server)。

3580* 若要保留 Remote Control 啟動時所使用的設定，請將檔案內容還原為原本的樣子，若 `claude remote-control` 已結束，再重新執行命令

3581 

3539### `--sandbox` or `--no-sandbox` is not supported by claude remote-control3582### `--sandbox` or `--no-sandbox` is not supported by claude remote-control

3540 3583 

3541此錯誤表示啟動您 [Remote Control](https://code.claude.com/docs/zh-TW/remote-control.md) 伺服器的命令在 `remote-control` 之後傳入了 `--sandbox` 或 `--no-sandbox`，而 `claude remote-control` 兩者皆不接受。伺服器會以退出碼 1 結束，而不會啟動：3584此錯誤表示啟動您 [Remote Control](https://code.claude.com/docs/zh-TW/remote-control.md) 伺服器的命令在 `remote-control` 之後傳入了 `--sandbox` 或 `--no-sandbox`，而 `claude remote-control` 兩者皆不接受。伺服器會以退出碼 1 結束，而不會啟動：

3806 3849 

3807以下同類字串會在命令執行之前就觸發：3850以下同類字串會在命令執行之前就觸發：

3808 3851 

3809* `Shell command permission check failed for pattern "..."`：命令的權限檢查未允許它。[注入命令的權限檢查](https://code.claude.com/docs/zh-TW/skills.md#permission-checks-on-injected-commands)說明了在各權限模式下哪些結果會中止，以及如何以 `allowed-tools` 預先核准命令3852* `Shell command permission check failed for pattern "..."`：命令的權限檢查不允許它執行。[注入命令的權限檢查](https://code.claude.com/docs/zh-TW/skills.md#permission-checks-on-injected-commands)說明了在各權限模式下哪些結果會中止，以及如何使用 `allowed-tools` 預先核准命令

3810* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``：skill 的 frontmatter 要求 bash，但機器上沒有 bash。請安裝 Git for Windows，或將 frontmatter 改為 `shell: powershell`。請參閱[注入命令的執行方式](https://code.claude.com/docs/zh-TW/skills.md#how-injected-commands-run)3853* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``：skill 的 frontmatter 要求使用 bash，但電腦上沒有它。請安裝 Git for Windows，或將 frontmatter 改為 `shell: powershell`。請參閱[注入命令的執行方式](https://code.claude.com/docs/zh-TW/skills.md#how-injected-commands-run)

3811 3854 

3812**處理方式：**3855**處理方式：**

3813 3856 

3960 4003 

3961* **您沒有傳入基底分支**：Claude Code 與儲存庫的預設分支進行比較，並建議您明確傳入基底分支，如上例所示4004* **您沒有傳入基底分支**：Claude Code 與儲存庫的預設分支進行比較，並建議您明確傳入基底分支，如上例所示

3962* **您傳入的基底分支已存在於您的複製中**：提示內容為 ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``4005* **您傳入的基底分支已存在於您的複製中**：提示內容為 ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``

3963* **您傳入的基礎分支不在您的複製中**：Claude Code 在比較前從 origin 擷取了該分支。提示內容為 ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``；當 Claude Code 無法判斷您的複製是否為淺層複製時，會改為建議 `git fetch --unshallow origin`。在 v2.1.221 之前，對於每個擷取的基礎分支，提示都會建議 `git fetch --unshallow origin`，而在完整的複製上，該命令會失敗並顯示 `fatal: --unshallow on a complete repository does not make sense`。4006* **您傳入的基礎分支不在您的複製中**：Claude Code 在比較之前從 origin 擷取了該分支。提示內容為 ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``；當 Claude Code 無法判斷您的複製是否為淺層複製時，它會改為建議 `git fetch --unshallow origin`。在 v2.1.221 之前，提示會針對每個擷取的基礎分支建議 `git fetch --unshallow origin`，而在完整的複製上，該命令會以 `fatal: --unshallow on a complete repository does not make sense` 失敗。

3964 4007 

3965**處理方式：**4008**處理方式：**

3966 4009 

63* **用戶端遙測**：當工作階段登入 Claude 應用程式閘道時，Claude Code 會停用其 Anthropic 繫結的用戶端分析。若要同時關閉登入前啟動分析，請在每個裝置上的 [用戶端側受管設定](https://code.claude.com/docs/zh-TW/claude-apps-gateway-config.md#client-side-managed-settings) 中傳遞 [`DISABLE_TELEMETRY`](https://code.claude.com/docs/zh-TW/managed-settings#turn-telemetry-off-for-your-organization)。63* **用戶端遙測**：當工作階段登入 Claude 應用程式閘道時，Claude Code 會停用其 Anthropic 繫結的用戶端分析。若要同時關閉登入前啟動分析，請在每個裝置上的 [用戶端側受管設定](https://code.claude.com/docs/zh-TW/claude-apps-gateway-config.md#client-side-managed-settings) 中傳遞 [`DISABLE_TELEMETRY`](https://code.claude.com/docs/zh-TW/managed-settings#turn-telemetry-off-for-your-organization)。

64* **其他閘道上的用戶端遙測**：Claude Code 是否傳送可選用戶端遙測流取決於您的提供者，[遙測預設值表](https://code.claude.com/docs/zh-TW/data-usage.md#default-behaviors-by-api-provider) 涵蓋每種情況。64* **其他閘道上的用戶端遙測**：Claude Code 是否傳送可選用戶端遙測流取決於您的提供者，[遙測預設值表](https://code.claude.com/docs/zh-TW/data-usage.md#default-behaviors-by-api-provider) 涵蓋每種情況。

65* **遙測目的地**：Claude Code 傳送閘道工作階段遙測的位置取決於工作階段如何登入，[開發人員上強制執行的項目](https://code.claude.com/docs/zh-TW/claude-apps-gateway#whats-enforced-on-developers) 說明每種工作階段的匯出位置。65* **遙測目的地**：Claude Code 傳送閘道工作階段遙測的位置取決於工作階段如何登入，[開發人員上強制執行的項目](https://code.claude.com/docs/zh-TW/claude-apps-gateway#whats-enforced-on-developers) 說明每種工作階段的匯出位置。

66* **公司 HTTP 代理**：`HTTPS_PROXY` 位於 Claude Code 和它與之通訊的每個伺服器之間，包括閘道。如果您的網路需要一個，[配置代理](https://code.claude.com/docs/zh-TW/network-config.md) 以及閘道。對於您託管的 Claude 應用程式閘道，[登入檢查代理主機也在私人網路上](https://code.claude.com/docs/zh-TW/claude-apps-gateway#prerequisites)；如果不是，將閘道主機新增到 `NO_PROXY`，以便 CLI 直接連接到它。66* **公司 HTTP 代理伺服器**：Claude Code 會透過 `HTTPS_PROXY` 中的代理伺服器傳送其請求，包括傳送至閘道的請求。如果您的網路需要代理伺服器，請[設定它](https://code.claude.com/docs/zh-TW/network-config.md)。如果代理伺服器適用於您託管的 Claude 應用程式閘道，[登入](https://code.claude.com/docs/zh-TW/claude-apps-gateway#prerequisites)需要代理伺服器的主機名稱解析為私人位址，或需要將閘道主機加入 `NO_PROXY`。

67 67 

68## 後續步驟68## 後續步驟

69 69 

83>83>

84> 按照 [Microsoft 從 GitHub Actions 驗證指南](https://learn.microsoft.com/en-us/azure/developer/github/connect-from-azure-openid-connect)，建立具有儲存庫聯盟認證的 Microsoft Entra 應用程式：84> 按照 [Microsoft 從 GitHub Actions 驗證指南](https://learn.microsoft.com/en-us/azure/developer/github/connect-from-azure-openid-connect)，建立具有儲存庫聯盟認證的 Microsoft Entra 應用程式：

85>85>

86> * 註冊 Microsoft Entra 應用程式並新增聯盟身分識別認證，該認證信任 GitHub 向您的儲存庫發出的權杖。使用者指派的受管身分識別可以代替應用程式。兩者都有您在下面記下的用戶端 ID86> * 註冊 Microsoft Entra 應用程式並新增聯盟身分識別憑證，該憑證信任 GitHub 向您的儲存庫發出的權杖。使用者指派的受管身分識別可以代替應用程式。兩者都有您在下面記下的用戶端 ID

87> * 在您的 Foundry 資源上為應用程式指派 `Azure AI User` 角色。請參閱 [Azure RBAC 設定](https://code.claude.com/docs/zh-TW/microsoft-foundry.md#azure-rbac-configuration)以了解更窄的自訂角色87> * 在您的 Foundry 資源上為應用程式指派 `Foundry User` 角色。請參閱 [Azure RBAC 設定](https://code.claude.com/docs/zh-TW/microsoft-foundry.md#azure-rbac-configuration)以了解另一個內建角色和自訂角色

88>88>

89> 記下應用程式的用戶端 ID、您的租用戶 ID 和您的訂閱 ID。您將在下一步中將它們新增為密鑰。89> 記下應用程式的用戶端 ID、您的租用戶 ID 和您的訂閱 ID。您將在下一步中將它們新增為密鑰。

90 90 

228 228 

229### 當模型在工作階段中被停用時229### 當模型在工作階段中被停用時

230 230 

231如果您的專案失去對工作階段執行所在模型的存取權，例如因為管理員在 [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) 中停用它，Claude Code 會將工作階段切換到另一個模型，而不是讓每個請求都失敗，並顯示 `Switched to <fallback> because <model> is not available`。它會嘗試與啟動回退相同的模型：先嘗試相同層級的較早版本，對於沒有可用 Opus 版本的 Opus 工作階段，則嘗試預設 Sonnet 模型。231當 Agent Platform 以工作階段的模型在您的專案或區域中無法使用為由拒絕時，Claude Code 會將您的工作階段切換到另一個模型，讓您可以繼續工作。您會看到一則以 `Switched to <fallback> because <model> is not available` 開頭的訊息。例如，當管理員在 [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) 中停用該模型，或該模型未在您的區域中提供時，就會發生這種情況。

232 232 

233切換僅適用於您未固定的層級，這與啟動回退的條件相同。在您選擇的特定版本上的工作階段會保持其模型，且沒有回退模型鏈，請求會失敗。在 [auto mode](https://code.claude.com/docs/zh-TW/permission-modes.md#enable-auto-mode-on-bedrock-agent-platform-or-foundry) 中，Claude Code 只會切換到 Agent Platform 上 auto mode 支援的模型。如果這些模型都無法使用，請求會失敗。233如果您設定了[備援模型鏈](https://code.claude.com/docs/zh-TW/model-config.md#fallback-model-chains)，Claude Code 會改為切換到您設定的備援。若沒有模型鏈，請求會在下列情況下失敗：

234 234 

235您設定的[回退模型鏈](https://code.claude.com/docs/zh-TW/model-config.md#fallback-model-chains)會取代層級切換：在這些拒絕上，Claude Code 會切換到您設定的回退。若要讓被拒絕的請求失敗而不是切換，請設定 [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](https://code.claude.com/docs/zh-TW/env-vars)。您設定的回退鏈仍會在這些拒絕上切換；如果您想讓每個被拒絕的請求都失敗，也請移除該鏈。235* 您的工作階段使用的是固定模型或您選擇的特定版本

236* [Claude Code 嘗試的模型](#startup-model-checks)都無法使用。在[自動模式](https://code.claude.com/docs/zh-TW/permission-modes.md#enable-auto-mode-on-bedrock-agent-platform-or-foundry)中，Claude Code 只會切換到 Agent Platform 上自動模式支援的模型。

237 

238若要繼續工作，請在工作階段中執行 `/model`，並在您的專案和區域中可用的模型上按 `s`，這樣不會變更您的預設值。

239 

240若要讓被拒絕的請求失敗而不是切換，請設定 [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](https://code.claude.com/docs/zh-TW/env-vars)。如果您設定了備援模型鏈，也請將其移除，因為 Claude Code 仍會切換到該備援。

236 241 

237## IAM 設定242## IAM 設定

238 243 

2999 2999 

3000在工作階段期間設定檔變更時執行。可用於稽核設定變更、強制執行安全政策，或封鎖對設定檔的未經授權修改。3000在工作階段期間設定檔變更時執行。可用於稽核設定變更、強制執行安全政策，或封鎖對設定檔的未經授權修改。

3001 3001 

3002當設定檔、受管政策檔案或 skill 檔案變更時，Claude Code 會執行 ConfigChange hook。對於受管政策，只有在 `managed-settings.json` 或 `managed-settings.d/` 中的檔案變更時才會執行。它會套用[伺服器受管設定](https://code.claude.com/docs/zh-TW/server-managed-settings.md)以及 macOS 受管偏好設定或 Windows 登錄政策的變更，但不會執行這些 hook。在啟用 [`wslInheritsWindowsSettings`](https://code.claude.com/docs/zh-TW/settings-reference#wslinheritswindowssettings) 的 WSL 上，它也會在政策輪詢時套用已變更的 Windows 端受管設定檔，而不執行這些 hook。3002當設定檔、受管原則檔案或 skill 檔案變更時，Claude Code 會執行 ConfigChange hook。對於受管原則，只有在 `managed-settings.json` 或 `managed-settings.d/` 中的檔案變更時才會執行。

3003 3003 

3004matcher 依設定來源進行篩選：3004matcher 依設定來源進行篩選：

3005 3005 

3011| `policy_settings` | `managed-settings.json` 或 `managed-settings.d/` 中的檔案變更 |3011| `policy_settings` | `managed-settings.json` 或 `managed-settings.d/` 中的檔案變更 |

3012| `skills` | `.claude/skills/` 中的 skill 檔案變更 |3012| `skills` | `.claude/skills/` 中的 skill 檔案變更 |

3013 3013 

3014以下範例會記錄所有設定變更以進行安全稽核：3014以下這類變更會在不執行 hook 的情況下生效：

3015 

3016* 透過 **Yes, and don't ask again**、`/permissions` 或 `/model` 儲存的規則與設定，在您儲存它們的那個工作階段中。若另一個開啟中的工作階段載入同一個檔案，hook 會在該工作階段中執行。

3017* [伺服器受管設定](https://code.claude.com/docs/zh-TW/server-managed-settings.md)、macOS 受管偏好設定或 Windows 登錄檔原則的更新

3018* 在啟用 [`wslInheritsWindowsSettings`](https://code.claude.com/docs/zh-TW/settings-reference#wslinheritswindowssettings) 的 WSL 上，Windows 端受管設定檔的變更，Claude Code 會在其原則輪詢時取得該變更

3019 

3020此範例會記錄設定變更以進行安全稽核：

3015 3021 

3016```json theme={null}3022```json theme={null}

3017{3023{

3334 "hooks": [3340 "hooks": [

3335 {3341 {

3336 "type": "command",3342 "type": "command",

3337 "command": "bash -c 'jq -r .worktree_path | xargs rm -rf'"3343 "command": "bash -c 'p=$(jq -er .worktree_path) && rm -rf -- \"$p\"'"

3338 }3344 }

3339 ]3345 ]

3340 }3346 }

50 "PostToolUse": [50 "PostToolUse": [

51 {51 {

52 "matcher": "Edit|Write",52 "matcher": "Edit|Write",

53 "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write" }]53 "hooks": [{ "type": "command", "command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\"" }]

54 }54 }

55 ],55 ],

56 "Notification": [56 "Notification": [

221 "hooks": [221 "hooks": [

222 {222 {

223 "type": "command",223 "type": "command",

224 "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"224 "command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\""

225 }225 }

226 ]226 ]

227 }227 }

336 336 

337追蹤工作階段期間設定檔或 skill 檔案的變更時間。`ConfigChange` 事件會在外部程序或編輯器修改設定檔時觸發，因此您可以記錄變更以符合法規要求，或封鎖未經授權的修改。337追蹤工作階段期間設定檔或 skill 檔案的變更時間。`ConfigChange` 事件會在外部程序或編輯器修改設定檔時觸發，因此您可以記錄變更以符合法規要求，或封鎖未經授權的修改。

338 338 

339此範例會將每次變更附加至稽核日誌。將此內容新增至 `~/.claude/settings.json`：339此範例會將每個事件附加至稽核日誌。將此內容新增至 `~/.claude/settings.json`：

340 340 

341```json theme={null}341```json theme={null}

342{342{

36| `Esc` | 中斷 Claude 或關閉對話框 | 停止目前的回應或工具呼叫中途，以便您可以重新導向。Claude 會保留迄今為止完成的工作。如果您有[訊息排隊](#queue-messages-while-claude-works)，Claude Code 會在下一步傳送它們。當對話框開啟時，`Esc` 會關閉對話框。當頁尾項目被選中時（例如提示下方的[子代理面板](https://code.claude.com/docs/zh-TW/sub-agents.md#run-subagents-in-foreground-or-background)中的一列），`Esc` 會[取消選中它](https://code.claude.com/docs/zh-TW/keybindings.md#footer-actions)而不是中斷。在權限提示上，`Esc` 會拒絕該操作，與[**否**（不含註解）](https://code.claude.com/docs/zh-TW/permissions.md#add-a-comment-when-you-answer-a-permission-prompt)相同 |36| `Esc` | 中斷 Claude 或關閉對話框 | 停止目前的回應或工具呼叫中途，以便您可以重新導向。Claude 會保留迄今為止完成的工作。如果您有[訊息排隊](#queue-messages-while-claude-works)，Claude Code 會在下一步傳送它們。當對話框開啟時，`Esc` 會關閉對話框。當頁尾項目被選中時（例如提示下方的[子代理面板](https://code.claude.com/docs/zh-TW/sub-agents.md#run-subagents-in-foreground-or-background)中的一列），`Esc` 會[取消選中它](https://code.claude.com/docs/zh-TW/keybindings.md#footer-actions)而不是中斷。在權限提示上，`Esc` 會拒絕該操作，與[**否**（不含註解）](https://code.claude.com/docs/zh-TW/permissions.md#add-a-comment-when-you-answer-a-permission-prompt)相同 |

37| `Esc` + `Esc` | 清除輸入草稿或回溯 | 當提示輸入包含文字時，雙 `Esc` 會清除它並將草稿儲存到歷史記錄，以便 `Up` 可以回憶它。當輸入為空時，雙 `Esc` 會開啟[回溯功能表](https://code.claude.com/docs/zh-TW/checkpointing.md)以從先前的時間點復原或摘要程式碼和對話 |37| `Esc` + `Esc` | 清除輸入草稿或回溯 | 當提示輸入包含文字時，雙 `Esc` 會清除它並將草稿儲存到歷史記錄，以便 `Up` 可以回憶它。當輸入為空時，雙 `Esc` 會開啟[回溯功能表](https://code.claude.com/docs/zh-TW/checkpointing.md)以從先前的時間點復原或摘要程式碼和對話 |

38| `Ctrl+Enter` 或 `Ctrl+X Ctrl+S` | 立即傳送排隊的訊息 | 傳送您的[排隊訊息](#queue-messages-while-claude-works)和您的草稿與它們一起立即發出。[Claude Code 何時傳送您排隊的內容](#when-claude-code-sends-what-you-queued)涵蓋了 Claude 正在處理的回合會發生什麼。在[shell 模式](#shell-mode-with-prefix)中，該鍵只會將您的命令排隊。在不報告延伸鍵的終端中，`Ctrl+Enter` 會以純 `Enter` 的形式到達；`Ctrl+X Ctrl+S` 在任何終端中都有效。需要 Claude Code v2.1.275 或更新版本 |38| `Ctrl+Enter` 或 `Ctrl+X Ctrl+S` | 立即傳送排隊的訊息 | 傳送您的[排隊訊息](#queue-messages-while-claude-works)和您的草稿與它們一起立即發出。[Claude Code 何時傳送您排隊的內容](#when-claude-code-sends-what-you-queued)涵蓋了 Claude 正在處理的回合會發生什麼。在[shell 模式](#shell-mode-with-prefix)中，該鍵只會將您的命令排隊。在不報告延伸鍵的終端中，`Ctrl+Enter` 會以純 `Enter` 的形式到達；`Ctrl+X Ctrl+S` 在任何終端中都有效。需要 Claude Code v2.1.275 或更新版本 |

39| `Shift+Tab` 或 `Alt+M`（當 Node 或 Bun 執行時間未啟用 VT 輸入模式時在 Windows 上） | 循環權限模式 | 循環通過 `default`（在模式指示器中標記為 Manual）、`acceptEdits`、`plan` 和（如果可用）`bypassPermissions`，然後是 `auto`。從 `auto`，第一次按下會切換到 `default`。請參閱[權限模式](https://code.claude.com/docs/zh-TW/permission-modes.md)。在檔案權限提示上，相同的鍵會關閉開啟的[註解欄位](https://code.claude.com/docs/zh-TW/permissions.md#add-a-comment-when-you-answer-a-permission-prompt)。沒有開啟欄位時，它會選擇允許該操作以供工作階段其餘部分的選項（當提示提供該選項時） |39| `Shift+Tab`，或在 Windows 上當 Node 或 Bun 執行環境未啟用 VT 輸入模式時使用 `Alt+M` | 循環權限模式 | 依序循環 `default`（在模式指示器中標記為 Manual）、`acceptEdits` 和 `plan`，然後在可用時循環 `bypassPermissions` 和 `auto`。請參閱[權限模式](https://code.claude.com/docs/zh-TW/permission-modes.md)。在檔案權限提示上，相同的鍵會關閉開啟的[註解欄位](https://code.claude.com/docs/zh-TW/permissions.md#add-a-comment-when-you-answer-a-permission-prompt)。沒有開啟欄位時，若提示提供該選項，它會選擇在工作階段其餘期間允許該操作的選項。在計畫核准提示上，它會核准該計畫 |

40| `Option+P`（macOS）或 `Alt+P`（Windows/Linux） | 切換模型 | 切換模型而不清除您的提示 |40| `Option+P`（macOS）或 `Alt+P`（Windows/Linux） | 切換模型 | 切換模型而不清除您的提示 |

41| `Option+T`（macOS）或 `Alt+T`（Windows/Linux） | 切換延伸思考 | 啟用或停用延伸思考模式。對 Opus 5.5、Sonnet 5.5、Haiku 5.5 或 Fable 模型沒有影響，它們始終使用延伸思考。在 macOS 上無需設定 Option 為 Meta 即可運作 |41| `Option+T`（macOS）或 `Alt+T`（Windows/Linux） | 切換延伸思考 | 啟用或停用延伸思考模式。對 Opus 5.5、Sonnet 5.5、Haiku 5.5 或 Fable 模型沒有影響，它們始終使用延伸思考。在 macOS 上無需設定 Option 為 Meta 即可運作 |

42| `Option+O`（macOS）或 `Alt+O`（Windows/Linux） | 切換快速模式 | 啟用或停用[快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md) |42| `Option+O`（macOS）或 `Alt+O`（Windows/Linux） | 切換快速模式 | 啟用或停用[快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md) |

81| :- | :- | :- |81| :- | :- | :- |

82| 快速逃脫 | `\` + `Enter` | 在所有終端中運作 |82| 快速逃脫 | `\` + `Enter` | 在所有終端中運作 |

83| Option 鍵 | `Option+Enter` | 在 macOS 上啟用[Option 為 Meta](https://code.claude.com/docs/zh-TW/terminal-config.md#enable-option-key-shortcuts-on-macos)後 |83| Option 鍵 | `Option+Enter` | 在 macOS 上啟用[Option 為 Meta](https://code.claude.com/docs/zh-TW/terminal-config.md#enable-option-key-shortcuts-on-macos)後 |

84| Shift+Enter | `Shift+Enter` | 在 iTerm2、WezTerm、Ghostty、Kitty、Warp、Apple Terminal、Windows Terminal 中原生。對於其他終端，請參閱[輸入多行提示](https://code.claude.com/docs/zh-TW/terminal-config.md#enter-multiline-prompts) |84| Shift+Enter | `Shift+Enter` | 在 iTerm2、WezTerm、Ghostty、Kitty、Warp、Windows Terminal 中原生支援。對於其他終端機，請參閱[輸入多行提示詞](https://code.claude.com/docs/zh-TW/terminal-config.md#enter-multiline-prompts) |

85| 控制序列 | `Ctrl+J` | 在任何終端中無需設定即可運作 |85| 控制序列 | `Ctrl+J` | 在任何終端中無需設定即可運作 |

86| 貼上模式 | 直接貼上 | 對於程式碼區塊、日誌 |86| 貼上模式 | 直接貼上 | 對於程式碼區塊、日誌 |

87 87 

137 137 

138透過 `/config` → Editor mode 啟用 vim 風格的編輯。138透過 `/config` → Editor mode 啟用 vim 風格的編輯。

139 139 

140Claude Code 會在您使用 `Ctrl+O` 切換[文字記錄檢視器](#transcript-viewer)或開啟和關閉面板（例如 `/config`）時保留您的 vim 模式和游標位置。如果您在 NORMAL 模式下離開提示，當您返回時它仍然處於 NORMAL 模式，游標位置與您離開時相同。

141 

142### 模式切換140### 模式切換

143 141 

144| 命令 | 動作 | 來自模式 |142| 命令 | 動作 | 來自模式 |

302 * 按 `Ctrl+C` 取消並還原您的原始輸入300 * 按 `Ctrl+C` 取消並還原您的原始輸入

303 * 在空搜尋上按 `Backspace` 取消301 * 在空搜尋上按 `Backspace` 取消

304 302 

305接受符合項目或取消搜尋會立即生效，即使 Claude Code 仍在載入歷史。

306 

307若要找出較早的提示詞，而您只記得曾在其中貼上某段很長的內容（例如錯誤日誌），請按 `Ctrl+R` 並輸入貼上內容中的某個字詞。需要 Claude Code v2.1.314 或更新版本。303若要找出較早的提示詞，而您只記得曾在其中貼上某段很長的內容（例如錯誤日誌），請按 `Ctrl+R` 並輸入貼上內容中的某個字詞。需要 Claude Code v2.1.314 或更新版本。

308 304 

309## 背景 Bash 命令305## 背景 Bash 命令

600 596 

601### Claude Code 加底線的內容597### Claude Code 加底線的內容

602 598 

603在您暫停輸入後不久，Claude Code 會為字典不知道的單詞加上底線。它在您仍在輸入時不理會該單詞，直到您超過它，並且它永遠不會改變您的文字。它也會跳過看起來像程式碼的文字：599在您暫停輸入後不久，Claude Code 會為字典不知道的單詞加上底線。對於您仍在輸入的單詞，它會先不予理會，直到您輸入超過該單詞為止。它也會跳過看起來像程式碼的文字：

604 600 

605* 命令，例如 `/help`、`@` 提及、URL、檔案路徑和旗標，例如 `--verbose`601* 命令，例如 `/help`、`@` 提及、URL、檔案路徑和旗標，例如 `--verbose`

606* 包含數字、底線或第一個字母後大寫字母的單詞，以及反引號中的文字602* 包含數字、底線或第一個字母後大寫字母的單詞，以及反引號中的文字

581 581 

582Claude Code 在 `ctrl+x` 前綴上繫結這些預設和弦，依內容分列如下：582Claude Code 在 `ctrl+x` 前綴上繫結這些預設和弦，依內容分列如下：

583 583 

584* `Chat`：`ctrl+x ctrl+k`、`ctrl+x ctrl+e`、`ctrl+x enter`、`ctrl+x ctrl+a`、`ctrl+x ctrl+s` 和 `ctrl+x tab`584* `Chat`：`ctrl+x ctrl+k`、`ctrl+x ctrl+e`、`ctrl+x enter`、`ctrl+x ctrl+a`、`ctrl+x ctrl+s`、`ctrl+x tab`、`ctrl+x ctrl+=`、`ctrl+x ctrl+-`、`ctrl+x ctrl+_`、`ctrl+x =` 和 `ctrl+x -`

585* `Task`：`ctrl+x ctrl+b`585* `Task`：`ctrl+x ctrl+b`

586* `DiffPanel`：`ctrl+x b`586* `DiffPanel`：`ctrl+x b`

587* `Pane`：`ctrl+x left`、`ctrl+x right`、`ctrl+x up`、`ctrl+x down` 和 `ctrl+x x`587* `Pane`：`ctrl+x left`、`ctrl+x right`、`ctrl+x up`、`ctrl+x down` 和 `ctrl+x x`

631 "ctrl+x ctrl+a": null,631 "ctrl+x ctrl+a": null,

632 "ctrl+x ctrl+s": null,632 "ctrl+x ctrl+s": null,

633 "ctrl+x tab": null,633 "ctrl+x tab": null,

634 "ctrl+x ctrl+=": null,

635 "ctrl+x ctrl+-": null,

636 "ctrl+x ctrl+_": null,

637 "ctrl+x =": null,

638 "ctrl+x -": null,

634 "ctrl+x": "chat:newline"639 "ctrl+x": "chat:newline"

635 }640 }

636 }641 }

156 156 

157### 與現有登入的衝突157### 與現有登入的衝突

158 158 

159閘道憑證變數優先於已保存的 claude.ai 登入或 Console 金鑰。使用 `ANTHROPIC_AUTH_TOKEN` 時，該變數會立即優先生效。使用 `ANTHROPIC_API_KEY` 時，系統會在互動模式下提示您一次以核准該金鑰，之後才會由其接管。159您的請求會使用閘道憑證變數，而非已儲存的 claude.ai 登入。使用 `ANTHROPIC_AUTH_TOKEN` 時，該變數會立即優先生效。使用 `ANTHROPIC_API_KEY` 時，系統會在互動模式下提示您一次以核准該金鑰，之後才會由其接管。

160 160 

161執行 `/status` 以確認哪個認證來源處於活動狀態。如果啟動顯示命名兩個來源的身份驗證衝突警告，請參閱[故障排除表](#troubleshoot-gateway-errors)的第一行以了解要刪除哪一個。要清除已保存的登入，以便只有閘道認證保留，請執行 `/logout`。161執行 `/status` 以確認哪個認證來源處於活動狀態。如果啟動顯示命名兩個來源的身份驗證衝突警告，請參閱[故障排除表](#troubleshoot-gateway-errors)的第一行以了解要刪除哪一個。要清除已保存的登入，以便只有閘道認證保留，請執行 `/logout`。

162 162 

506 506 

507| 錯誤 | 原因 | 修復 |507| 錯誤 | 原因 | 修復 |

508| :- | :- | :- |508| :- | :- | :- |

509| 啟動警告命名兩個認證來源並以 `auth may not work as expected` 結尾。較舊的版本顯示 `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set` 代替。 | 閘道認證和已保存的登入都處於活動狀態；變數用於請求，但過時的登入可能導致意外的身份驗證行為 | 取消設定變數以使用已保存的登入，或執行 `/logout` 以使用閘道認證 |509| 啟動警告指出兩個憑證來源，並以 `auth may not work as expected` 結尾。較舊的版本則改為顯示 `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set`。 | 閘道憑證和已儲存的登入同時處於作用中 | 取消設定該變數以使用已儲存的登入，或執行 `/logout` 以使用閘道憑證 |

510| `401` 錯誤命名無效或無法識別的令牌 | 認證不是閘道簽發的，或它位於閘道不讀取的標頭中 | 確認變數與[認證表](#set-the-credential-variable)中的認證類型匹配，並在閘道處重新生成金鑰（如果已撤銷） |510| `401` 錯誤命名無效或無法識別的令牌 | 認證不是閘道簽發的，或它位於閘道不讀取的標頭中 | 確認變數與[認證表](#set-the-credential-variable)中的認證類型匹配，並在閘道處重新生成金鑰（如果已撤銷） |

511| `Your apiKeyHelper script is failing`，或在非互動模式下 stderr 上的 `apiKeyHelper failed:` | [`apiKeyHelper`](https://code.claude.com/docs/zh-TW/settings-reference#apikeyhelper) 設定中的命令未產生可用的金鑰，因此請求帶有預留位置金鑰 | 直接執行命令以查看失敗原因，並在認證提供者報告過期會話時重新驗證；請參閱[錯誤參考](https://code.claude.com/docs/zh-TW/errors.md#your-apikeyhelper-script-is-failing) |511| `Your apiKeyHelper script is failing`，或在非互動模式下 stderr 上的 `apiKeyHelper failed:` | [`apiKeyHelper`](https://code.claude.com/docs/zh-TW/settings-reference#apikeyhelper) 設定中的命令未產生可用的金鑰，因此請求帶有預留位置金鑰 | 直接執行命令以查看失敗原因，並在認證提供者報告過期會話時重新驗證；請參閱[錯誤參考](https://code.claude.com/docs/zh-TW/errors.md#your-apikeyhelper-script-is-failing) |

512| 當沒有任何東西在地址應答時 `Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)`，或當主機名無法解析時 `Can't reach the API server — check your internet or DNS (ENOTFOUND)`，通常在 Claude Code [使用退避重試](https://code.claude.com/docs/zh-TW/errors.md#automatic-retries)時無聲暫停後。括號中的代碼會有所不同；[Unable to connect to API](https://code.claude.com/docs/zh-TW/errors.md#unable-to-connect-to-api) 涵蓋代碼拼寫和較早的措辭 | 沒有任何東西在基礎 URL 應答：地址錯誤，或 VPN 或防火牆阻止了到閘道的路徑 | 執行上面的 [curl 測試](#verify-the-connection)，它立即以相同的原因失敗，並與您的閘道團隊確認 URL 和網路路徑 |512| 當沒有任何東西在地址應答時 `Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)`，或當主機名無法解析時 `Can't reach the API server — check your internet or DNS (ENOTFOUND)`，通常在 Claude Code [使用退避重試](https://code.claude.com/docs/zh-TW/errors.md#automatic-retries)時無聲暫停後。括號中的代碼會有所不同；[Unable to connect to API](https://code.claude.com/docs/zh-TW/errors.md#unable-to-connect-to-api) 涵蓋代碼拼寫和較早的措辭 | 沒有任何東西在基礎 URL 應答：地址錯誤，或 VPN 或防火牆阻止了到閘道的路徑 | 執行上面的 [curl 測試](#verify-the-connection)，它立即以相同的原因失敗，並與您的閘道團隊確認 URL 和網路路徑 |

520| `/fast` 回報 `Fast mode unavailable due to network connectivity issues`，但推理請求正常運作 | [快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md)可用性檢查會直接連線到 `api.anthropic.com`，不遵循 `ANTHROPIC_BASE_URL`，因此被阻擋的直接出站連線會導致檢查失敗 | 如果出站連線被阻擋，請將 `api.anthropic.com` 加入允許清單，或設定跳過變數。請參閱[在代理伺服器和 LLM 閘道後使用快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |520| `/fast` 回報 `Fast mode unavailable due to network connectivity issues`，但推理請求正常運作 | [快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md)可用性檢查會直接連線到 `api.anthropic.com`，不遵循 `ANTHROPIC_BASE_URL`，因此被阻擋的直接出站連線會導致檢查失敗 | 如果出站連線被阻擋，請將 `api.anthropic.com` 加入允許清單，或設定跳過變數。請參閱[在代理伺服器和 LLM 閘道後使用快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |

521| 在以 `ANTHROPIC_API_KEY` 中閘道簽發的金鑰進行身分驗證的工作階段中，`/fast` 回報 `Fast mode is currently unavailable` | 當 `ANTHROPIC_BASE_URL` 指向您的閘道，且金鑰不是 Anthropic API 金鑰的格式時，Claude Code 不會送出[快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md)可用性檢查。若沒有先前成功檢查的快取結果，它會將快速模式視為不可用 | 設定 `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS=1`；請參閱[在代理伺服器和 LLM 閘道後使用快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |521| 在以 `ANTHROPIC_API_KEY` 中閘道簽發的金鑰進行身分驗證的工作階段中，`/fast` 回報 `Fast mode is currently unavailable` | 當 `ANTHROPIC_BASE_URL` 指向您的閘道，且金鑰不是 Anthropic API 金鑰的格式時，Claude Code 不會送出[快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md)可用性檢查。若沒有先前成功檢查的快取結果，它會將快速模式視為不可用 | 設定 `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS=1`；請參閱[在代理伺服器和 LLM 閘道後使用快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |

522| 在以 `ANTHROPIC_AUTH_TOKEN` 進行身分驗證的工作階段中，`/fast` 回報 `Fast mode has been disabled by your organization`，儘管組織已啟用快速模式 | 可用性檢查需要 claude.ai 登入或 API 金鑰；若僅有 bearer token，Claude Code 會將快速模式視為已停用，而不送出檢查 | 設定 `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1`；請參閱[在代理伺服器和 LLM 閘道後使用快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |522| 在以 `ANTHROPIC_AUTH_TOKEN` 進行身分驗證的工作階段中，`/fast` 回報 `Fast mode has been disabled by your organization`，儘管組織已啟用快速模式 | 可用性檢查需要 claude.ai 登入或 API 金鑰；若僅有 bearer token，Claude Code 會將快速模式視為已停用，而不送出檢查 | 設定 `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1`；請參閱[在代理伺服器和 LLM 閘道後使用快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |

523| 在使用 `ANTHROPIC_BASE_URL` 的工作階段中，`/feedback` 儲存了一個本機檔案 | 在閘道後方，`ANTHROPIC_AUTH_TOKEN` 以及不是 Anthropic API 金鑰格式的金鑰都不是 Anthropic 憑證。沒有 Anthropic 憑證時，Claude Code 會將報告寫入 `~/.claude/feedback-bundles/` 下的本機封存檔，而不是將其傳送出去 | 將該檔案傳送給您的 Anthropic 客戶代表，或將其附加到支援請求中。請參閱[遙測服務](https://code.claude.com/docs/zh-TW/data-usage.md#telemetry-services) |

523| Claude Code 要求您登入，儘管 [curl 測試](#verify-the-connection)成功 | CLI 沒有自己的認證：可達的基礎 URL 不是一個，在互動會話中，專案的 `.claude/settings.json` 或 `.claude/settings.local.json` 中的 `env` 區塊僅在首次執行嚮導和[信任提示](https://code.claude.com/docs/zh-TW/permissions.md#what-runs-before-you-trust-a-folder)後應用 | 在 Claude Code 在首次執行設定之前讀取的位置設定 `ANTHROPIC_AUTH_TOKEN`：shell 匯出、`~/.claude/settings.json` 中的 `env` 區塊或受管設定 |524| Claude Code 要求您登入，儘管 [curl 測試](#verify-the-connection)成功 | CLI 沒有自己的認證：可達的基礎 URL 不是一個，在互動會話中，專案的 `.claude/settings.json` 或 `.claude/settings.local.json` 中的 `env` 區塊僅在首次執行嚮導和[信任提示](https://code.claude.com/docs/zh-TW/permissions.md#what-runs-before-you-trust-a-folder)後應用 | 在 Claude Code 在首次執行設定之前讀取的位置設定 `ANTHROPIC_AUTH_TOKEN`：shell 匯出、`~/.claude/settings.json` 中的 `env` 區塊或受管設定 |

524| `ANTHROPIC_API_KEY` 已設定但被忽略，無提示 | 金鑰在互動會話中需要一次性批准，之前拒絕的金鑰被忽略而不再詢問 | 使用 `Use custom API key` 選項在 `/config` 下啟用它 |525| `ANTHROPIC_API_KEY` 已設定但被忽略，無提示 | 金鑰在互動會話中需要一次性批准，之前拒絕的金鑰被忽略而不再詢問 | 使用 `Use custom API key` 選項在 `/config` 下啟用它 |

525| `This machine's managed settings require a first-party login`，或當受管設定將 `forceLoginMethod` 設定為 `"gateway"` 或也設定 `forceLoginGatewayUrl` 時的 [`Administrator policy requires a Cloud gateway sign-in`](https://code.claude.com/docs/zh-TW/errors#administrator-policy-requires-a-cloud-gateway-sign-in) | 受管設定包括 `forceLoginMethod` 或 `forceLoginOrgUUID`，不能與 `ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN` 或 `apiKeyHelper` 共存 | 您的管理員必須從受管設定中移除 `forceLoginMethod`、`forceLoginOrgUUID` 和 `forceLoginGatewayUrl` 以使用閘道認證，或移除閘道認證以使用受管設定要求的登入。兩者無法結合 |526| `This machine's managed settings require a first-party login`，或當受管設定將 `forceLoginMethod` 設定為 `"gateway"` 或也設定 `forceLoginGatewayUrl` 時的 [`Administrator policy requires a Cloud gateway sign-in`](https://code.claude.com/docs/zh-TW/errors#administrator-policy-requires-a-cloud-gateway-sign-in) | 受管設定包括 `forceLoginMethod` 或 `forceLoginOrgUUID`，不能與 `ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN` 或 `apiKeyHelper` 共存 | 您的管理員必須從受管設定中移除 `forceLoginMethod`、`forceLoginOrgUUID` 和 `forceLoginGatewayUrl` 以使用閘道認證，或移除閘道認證以使用受管設定要求的登入。兩者無法結合 |

142claude -p "Reply with one word: connected"142claude -p "Reply with one word: connected"

143```143```

144 144 

145**檢查點**：提示返回回應，請求出現在閘道的日誌中，作為對 `/v1/messages` 路徑的 `POST`，狀態為 `200`。Claude Code 附加查詢字串，例如 `?beta=true`，因此匹配路徑，而不是完整 URL。兩個失敗訊息指向不同的方向：145**檢查點**：提示詞回傳回應，請求出現在閘道的日誌中，作為對 `/v1/messages` 路徑的 `POST`，狀態為 `200`。Claude Code 會附加查詢字串，例如 `?beta=true`，因此請比對路徑，而不是完整 URL。請檢查失敗訊息：

146 146 

147* `Not logged in`：檢查閘道日誌以區分兩個原因。如果它是空的，沒有認證到達工作階段，沒有請求離開機器；在您測試的殼層中重新執行匯出。如果它顯示被拒絕的請求，在 `401` 正文中有 `x-api-key`，閘道期望金鑰在該標頭中；改為切換到 `ANTHROPIC_API_KEY`147* `Not logged in`：檢查閘道日誌。如果它是空的，表示沒有憑證到達工作階段，也沒有請求離開機器；請在您測試的 shell 中重新執行匯出。如果它顯示來自閘道且指出 `x-api-key` 的 `401`，表示閘道期望金鑰在該標頭中；請改用 `ANTHROPIC_API_KEY`。如果它顯示來自 `api.anthropic.com` 或您的提供者端點的 `401`，請修正閘道持有的提供者憑證

148* `Failed to authenticate. API Error: 401` 表示認證已發送並被拒絕，閘道日誌說明位置：命名 `api.anthropic.com` 或您的提供者端點的 `401` 表示閘道到達上游但其提供者認證被拒絕，因此開發者金鑰有效，閘道持有的提供者認證有誤或是佔位符148* `Failed to authenticate. API Error: 401` 表示認證已發送並被拒絕，閘道日誌說明位置：命名 `api.anthropic.com` 或您的提供者端點的 `401` 表示閘道到達上游但其提供者認證被拒絕，因此開發者金鑰有效，閘道持有的提供者認證有誤或是佔位符

149 149 

150錯誤或無法到達的基本 URL 會產生不同的症狀：Claude Code [以退避方式重試連接](https://code.claude.com/docs/zh-TW/errors.md#automatic-retries)，在報告錯誤之前可能會坐著沒有輸出幾分鐘。如果命令似乎掛起，請檢查閘道日誌而不是等待；沒有到達的請求表示 `ANTHROPIC_BASE_URL` 未指向閘道。150錯誤或無法到達的基本 URL 會產生不同的症狀：Claude Code [以退避方式重試連接](https://code.claude.com/docs/zh-TW/errors.md#automatic-retries)，在報告錯誤之前可能會坐著沒有輸出幾分鐘。如果命令似乎掛起，請檢查閘道日誌而不是等待；沒有到達的請求表示 `ANTHROPIC_BASE_URL` 未指向閘道。

247 247 

248您應該看到 `data:` 行逐漸到達。整個回應在暫停後一次到達表示閘道正在緩衝，這會停滯 Claude Code；`404` 表示模型名稱未路由。針對每個模型名稱重複。248您應該看到 `data:` 行逐漸到達。整個回應在暫停後一次到達表示閘道正在緩衝，這會停滯 Claude Code；`404` 表示模型名稱未路由。針對每個模型名稱重複。

249 249 

250然後啟動 `claude` 並發送訊息。此步驟的每個症狀都有一個原因：250然後啟動 `claude`，發送訊息，並比對您看到的情況：

251 251 

252* 登入提示表示認證間隙。執行 `/status` 並開啟 **Status** 標籤：當 `Setting sources` 行不包括受管設定時，分發未到達機器；當它包括時，開發者認證未被傳遞，因此設定 `ANTHROPIC_AUTH_TOKEN` 或 `apiKeyHelper`252* 出現登入畫面，或出現 `Not logged in` 且閘道日誌中沒有新內容，表示憑證缺失。執行 `/status` 並開啟 **Status** 標籤：當 `Setting sources` 行不包括受管設定時，表示分發未到達機器；當它包括時，表示開發者憑證未被傳遞，因此請設定 `ANTHROPIC_AUTH_TOKEN` 或 `apiKeyHelper`

253* `Failed to authenticate` 錯誤表示閘道拒絕請求；其日誌說明哪個認證失敗。閘道自己記錄的拒絕命名開發者金鑰，而來自 `api.anthropic.com` 或您的提供者端點的 `401` 表示閘道持有的提供者認證被拒絕253* `Please run /login · API Error: 401`、`Not logged in` 或 `Invalid API key`，且閘道日誌中有 `401`：請檢查是誰產生了該 `401`。如果是閘道產生的，請修正開發者金鑰或其標頭；如果它來自 `api.anthropic.com` 或您的提供者端點，請修正閘道持有的提供者憑證

254* 當閘道期望金鑰在 `x-api-key` 標頭中（設定為 `ANTHROPIC_API_KEY`）時，首次使用時出現一次性的金鑰核准提示是預期的254* 當閘道期望金鑰在 `x-api-key` 標頭中（設定為 `ANTHROPIC_API_KEY`）時，首次使用時出現一次性的金鑰核准提示是預期的

255 255 

256如果您的組織使用[快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md)，請在此處也執行 `/fast`：可用性檢查直接呼叫 `api.anthropic.com` 而不是遵循閘道基本 URL，因此閘道路由的工作階段可以報告快速模式為不可用或已停用，即使推理有效。[在代理和 LLM 閘道後面使用快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways)將每個訊息對應到恢復它的變數，與[配置的其餘部分](#distribute-the-configuration)一起分發。256如果您的組織使用[快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md)，請在此處也執行 `/fast`：可用性檢查直接呼叫 `api.anthropic.com` 而不是遵循閘道基本 URL，因此閘道路由的工作階段可以報告快速模式為不可用或已停用，即使推理有效。[在代理和 LLM 閘道後面使用快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways)將每個訊息對應到恢復它的變數，與[配置的其餘部分](#distribute-the-configuration)一起分發。

147 147 

148## Azure RBAC 配置148## Azure RBAC 配置

149 149 

150`Azure AI User` 和 `Cognitive Services User` 預設角色包含叫用 Claude 模型所需的所有權限。150如果您使用 Microsoft Entra ID 或其核發的 bearer token 進行驗證，請在您的 Foundry 資源上為您的身分指派 `Foundry User` 或 `Cognitive Services User` 角色。您可能仍會看到 `Foundry User` 以其先前的名稱 `Azure AI User` 顯示。

151 151 

152如需更嚴格的權限，請建立具有以下內容的自訂角色：152如果這些角色無法滿足您的需求，請參閱 [Microsoft Foundry RBAC 文件](https://learn.microsoft.com/en-us/azure/foundry/concepts/rbac-foundry)以了解自訂角色。

153 

154```json theme={null}

155{

156 "permissions": [

157 {

158 "dataActions": [

159 "Microsoft.CognitiveServices/accounts/providers/*"

160 ]

161 }

162 ]

163}

164```

165 

166如需詳細資訊，請參閱 [Microsoft Foundry RBAC 文件](https://learn.microsoft.com/en-us/azure/ai-foundry/concepts/rbac-azure-ai-foundry)。

167 153 

168## 1M token 上下文視窗154## 1M token 上下文視窗

169 155 

903 903 

904### 為閘道或自訂模型 ID 修正視窗904### 為閘道或自訂模型 ID 修正視窗

905 905 

906出現下列任一啟動警告，都表示 Claude Code 無法辨識您工作階段的模型 ID，因此無法得知該模型的上下文視窗，並假定其為 200K token：906出現下列任一警告，都表示 Claude Code 無法辨識您工作階段的模型 ID，因此無法得知該模型的上下文視窗，並假定其為 200K token：

907 907 

908```text theme={null}908```text theme={null}

909⚠ Model "my-gateway-opus" isn't recognized · context assumed to be 200k tokens · ...909⚠ Model "my-gateway-opus" isn't recognized · context assumed to be 200k tokens · ...

431> * **不允許空格**：值不能包含空格。例如，`user.organizationName=My Company` 無效431> * **不允許空格**：值不能包含空格。例如，`user.organizationName=My Company` 無效

432> * **格式**：必須是逗號分隔的鍵值對：`key1=value1,key2=value2`432> * **格式**：必須是逗號分隔的鍵值對：`key1=value1,key2=value2`

433> * **允許的字元**：僅限 US-ASCII 字元，不包括控制字元、空格、雙引號、逗號、分號和反斜線433> * **允許的字元**：僅限 US-ASCII 字元，不包括控制字元、空格、雙引號、逗號、分號和反斜線

434> * **特殊字元**：允許範圍外的字元必須進行百分比編碼434> * **特殊字元**：允許範圍外的字元必須進行百分比編碼，且值內的 `=` 必須寫成 `%3D`

435>435>

436> 對於需要空格的值，請改用底線或 camelCase。以下範例使用每種形式設定 `org.name`：436> 對於需要空格的值，請改用底線或 camelCase。以下範例使用每種形式設定 `org.name`：

437>437>

304claude --permission-mode plan304claude --permission-mode plan

305```305```

306 306 

307再次按下 `Shift+Tab` 即可在不核准計畫的情況下離開 plan mode。307在沒有開啟核准提示的情況下，再次按下 `Shift+Tab` 即可離開 plan mode。在核准提示中，請先按下 `Esc`，因為在該處按下 `Shift+Tab` 會核准計畫。

308 308 

309### 審查並核准計畫309### 審查並核准計畫

310 310 

344 "PostToolUse": [344 "PostToolUse": [

345 {345 {

346 "matcher": "Write|Edit",346 "matcher": "Write|Edit",

347 "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npm run lint:fix" }]347 "hooks": [{ "type": "command", "command": "f=$(jq -r '.tool_input.file_path') && npm run lint:fix -- \"$f\"" }]

348 }348 }

349 ]349 ]

350 }350 }

196 196 

197### 使用 `expect` 檢查結果197### 使用 `expect` 檢查結果

198 198 

199套件提供以下斷言，您選用的斷言放在要檢查的值之後，例如 `expect(answer.text).toBe('ok')`：199`expect` 有一組自己的斷言，例如 `toEqual` 和 `toHaveLength`，這些斷言放在要檢查的值之後，例如 `expect(answer.text).toBe('ok')`。如需完整清單，請在[您的建置所對應的型別](https://code.claude.com/docs/zh-TW/plugins/mods/create.md#get-the-types-for-your-build)中，於 `claude-code/index.d.ts` 搜尋 `type Matchers`。在斷言前加上 `.not` 可檢查相反的情況。若要檢查 promise 最終的結果，請在 `expect(...)` 之後緊接著加上 `.resolves` 或 `.rejects`，並對該行使用 `await`，例如 `await expect(promise).rejects.toThrow()`。

200 

201* **相等**：`toBe` 用於相同的值或物件，`toEqual` 用於結構，`toStrictEqual` 用於結構加上 `undefined` 欄位與原型，`toMatchObject` 用於您指定的欄位

202* **文字**：`toMatch`（接受正規表示式或子字串）、`toStartWith` 和 `toEndWith`

203* **數字**：`toBeGreaterThan`、`toBeGreaterThanOrEqual`、`toBeLessThan`、`toBeLessThanOrEqual`

204* **內容**：`toContain` 用於子字串或成員，`toContainEqual` 用於依結構比較的成員，以及 `toHaveLength` 和 `toHaveProperty`

205* **存在與型別**：`toBeDefined`、`toBeUndefined`、`toBeNull`、`toBeTruthy`、`toBeFalsy`、`toBeNaN`、`toBeInstanceOf`

206* **拋出**：`toThrow`，用於由 `expect` 呼叫的函式，或用於您以 `.rejects` 檢查的 promise

207 

208在斷言前加上 `.not` 可檢查相反的情況，加上 `.resolves` 或 `.rejects` 則可檢查 promise 最終的結果。

209 200 

210當 `expect` 在您以一般函數（而非非同步生成器）傳給 `on` 的 stub 或 hook 內失敗時，測試會失敗。引擎會跳過該 hook，失敗輸出會指出它，例如 `in the test's store.set hook`。201當 `expect` 在您以一般函數（而非非同步生成器）傳給 `on` 的 stub 或 hook 內失敗時，測試會失敗。引擎會跳過該 hook，失敗輸出會指出它，例如 `in the test's store.set hook`。

211 202 

67> | `--capacity <N>` | 同時進行的工作階段數量上限。預設為 32。不可與 `--spawn=session` 一起使用。 |67> | `--capacity <N>` | 同時進行的工作階段數量上限。預設為 32。不可與 `--spawn=session` 一起使用。 |

68> | `--[no-]create-session-in-dir` | 在伺服器啟動時於目前目錄預先建立一個工作階段，讓您可以立即開始輸入。在 `worktree` 模式下，此工作階段會留在目前目錄，而隨需建立的工作階段則會取得隔離的 worktree。預設為開啟。若您傳入 `--no-create-session-in-dir` 以不建立任何工作階段的方式啟動，Claude Code 會在您停止伺服器時封存伺服器的工作階段，因此將沒有可[恢復](#resume-sessions-after-stopping-the-server)的工作階段。 |68> | `--[no-]create-session-in-dir` | 在伺服器啟動時於目前目錄預先建立一個工作階段，讓您可以立即開始輸入。在 `worktree` 模式下，此工作階段會留在目前目錄，而隨需建立的工作階段則會取得隔離的 worktree。預設為開啟。若您傳入 `--no-create-session-in-dir` 以不建立任何工作階段的方式啟動，Claude Code 會在您停止伺服器時封存伺服器的工作階段，因此將沒有可[恢復](#resume-sessions-after-stopping-the-server)的工作階段。 |

69> | `--permission-mode <mode>` | 設定伺服器工作階段的起始[權限模式](https://code.claude.com/docs/zh-TW/permission-modes.md)，例如 `acceptEdits`。接受 `manual` 作為 `default` 的別名；無法辨識的模式會在啟動時停止伺服器並列出有效的模式。 |69> | `--permission-mode <mode>` | 設定伺服器工作階段的起始[權限模式](https://code.claude.com/docs/zh-TW/permission-modes.md)，例如 `acceptEdits`。接受 `manual` 作為 `default` 的別名；無法辨識的模式會在啟動時停止伺服器並列出有效的模式。 |

70> | `--settings <file>` | 將 JSON 設定檔套用至伺服器的工作階段，其[優先順序](https://code.claude.com/docs/zh-TW/settings.md#settings-precedence)與 `claude --settings` 相同。請提供檔案路徑，而非 JSON 字串。需要 Claude Code v2.1.321 或更新版本。 |

70> | `--chrome` / `--no-chrome` | 在伺服器建立的工作階段中開啟或關閉 [Chrome 整合](https://code.claude.com/docs/zh-TW/chrome.md)，讓 Claude 能在您從其他裝置工作時使用您機器上的 Chrome。若未使用任一旗標，伺服器預先建立的工作階段，以及您自行從 claude.ai/code 或 Claude 應用程式啟動的任何工作階段，都會以 Chrome 關閉的狀態開始，即使您已[預設啟用 Chrome](https://code.claude.com/docs/zh-TW/chrome.md#enable-chrome-by-default) 亦然。伺服器為您的某個[專案](https://code.claude.com/docs/zh-TW/claude-projects.md)執行緒啟動的工作階段則會改為遵循該設定，但 `bypassPermissions` 模式除外。需要 Claude Code v2.1.273 或更新版本。 |71> | `--chrome` / `--no-chrome` | 在伺服器建立的工作階段中開啟或關閉 [Chrome 整合](https://code.claude.com/docs/zh-TW/chrome.md)，讓 Claude 能在您從其他裝置工作時使用您機器上的 Chrome。若未使用任一旗標，伺服器預先建立的工作階段，以及您自行從 claude.ai/code 或 Claude 應用程式啟動的任何工作階段，都會以 Chrome 關閉的狀態開始，即使您已[預設啟用 Chrome](https://code.claude.com/docs/zh-TW/chrome.md#enable-chrome-by-default) 亦然。伺服器為您的某個[專案](https://code.claude.com/docs/zh-TW/claude-projects.md)執行緒啟動的工作階段則會改為遵循該設定，但 `bypassPermissions` 模式除外。需要 Claude Code v2.1.273 或更新版本。 |

71> | `-d`, `--debug[=<filter>]` | 為伺服器開啟除錯日誌，可選擇依類別篩選。篩選條件只能以 `=` 形式傳入，例如 `--debug=api,hooks`。需要 Claude Code v2.1.282 或更新版本。 |72> | `-d`, `--debug[=<filter>]` | 為伺服器開啟除錯日誌，可選擇依類別篩選。篩選條件只能以 `=` 形式傳入，例如 `--debug=api,hooks`。需要 Claude Code v2.1.282 或更新版本。 |

72> | `--debug-file <path>` | 將除錯日誌寫入指定的檔案。 |73> | `--debug-file <path>` | 將除錯日誌寫入指定的檔案。 |

73> | `--verbose` | 顯示詳細的連線與工作階段日誌。 |74> | `--verbose` | 顯示詳細的連線與工作階段日誌。 |

74> | `--sandbox`, `--no-sandbox` | 已於 v2.1.300 移除。若您傳入任一旗標，伺服器會[以錯誤結束](https://code.claude.com/docs/zh-TW/errors.md#sandbox-is-not-supported-by-claude-remote-control)而不會啟動。 |75> | `--sandbox`, `--no-sandbox` | 已於 v2.1.300 移除。若您傳入任一旗標，伺服器會[以錯誤結束](https://code.claude.com/docs/zh-TW/errors.md#sandbox-is-not-supported-by-claude-remote-control)而不會啟動。 |

75>76>

76> 若您在 `remote-control` 之前傳入全域 `claude` 旗標，或包裝指令碼加入了此類旗標，Claude Code 不會將該旗標沿用至伺服器建立的工作階段。只有在已知捨棄該旗標不會改變這些工作階段的能力時，Claude Code 才會讓該旗標通過，例如 `--verbose` 或 `--model`。對於任何其他旗標，例如 `--settings`，Claude Code 會[拒絕啟動](https://code.claude.com/docs/zh-TW/errors.md#not-carried-over-to-the-sessions-remote-control-starts)，並指出需要移除的旗標名稱。77> 若您在 `remote-control` 之前傳入全域 `claude` 旗標，或包裝指令碼加入了此類旗標，Claude Code 不會將該旗標沿用至伺服器建立的工作階段。使用某些旗標時，例如 `--verbose` 或 `--model`，伺服器仍會啟動。使用任何其他旗標時，伺服器[不會啟動](https://code.claude.com/docs/zh-TW/errors.md#not-carried-over-to-the-sessions-remote-control-starts)。若要傳入設定檔，請將 `--settings` 放在 `remote-control` 之後。

77>78>

78> 若要將伺服器啟動的工作階段置於沙箱中，請在設定檔中開啟[沙箱機制](https://code.claude.com/docs/zh-TW/sandboxing.md)。79> 若要將伺服器啟動的工作階段置於沙箱中，請在設定檔中開啟[沙箱機制](https://code.claude.com/docs/zh-TW/sandboxing.md)。

79>80>

431 431 

432每個排程任務都使用一個[雲端環境](https://code.claude.com/docs/zh-TW/cloud-environments.md)，用來控制網路存取、環境變數和設定指令碼。任務在每次執行時都會繼承環境的網路政策。432每個排程任務都使用一個[雲端環境](https://code.claude.com/docs/zh-TW/cloud-environments.md)，用來控制網路存取、環境變數和設定指令碼。任務在每次執行時都會繼承環境的網路政策。

433 433 

434**Default** 環境使用 **Limited** 存取，並已勾選 **Allow package managers**，因此其執行可以連線到[預設允許清單](https://code.claude.com/docs/zh-TW/cloud-environments.md#default-allowed-domains)中的主機。對遭封鎖主機的請求會失敗，並傳回 `403` 和 `x-deny-reason: host_not_allowed`。MCP 連接器的流量會經由 Anthropic 的伺服器路由，因此您新增到任務的連接器無需將其主機加入 **Allowed domains** 即可運作。請在[連接器](#connectors)下移除您不需要的連接器。434**Default** 環境使用 **Limited** 存取，並已勾選 **Allow package managers**，因此其執行可以連線到[預設允許清單](https://code.claude.com/docs/zh-TW/cloud-environments.md#default-allowed-domains)中的主機。對遭封鎖主機的請求會失敗，並出現[例如 `403` 或 `ENOTFOUND` 之類的錯誤](https://code.claude.com/docs/zh-TW/errors#host-not-allowed-in-a-cloud-session)。MCP 連接器的流量會經由 Anthropic 的伺服器路由，因此您新增到任務的連接器無需將其主機加入 **Allowed domains** 即可運作。請在[連接器](#connectors)下移除您不需要的連接器。

435 435 

436若要在您自己的某個環境上允許其他網域，請依照以下步驟操作。[組織共用環境](https://code.claude.com/docs/zh-TW/cloud-environments.md#organization-shared-environments)在此處會以唯讀方式開啟，因此改由擁有者從[管理設定](https://claude.ai/admin-settings)中的 **Cloud environments** 頁面變更其網路存取。436若要在您自己的某個環境上允許其他網域，請依照以下步驟操作。[組織共用環境](https://code.claude.com/docs/zh-TW/cloud-environments.md#organization-shared-environments)在此處會以唯讀方式開啟，因此改由擁有者從[管理設定](https://claude.ai/admin-settings)中的 **Cloud environments** 頁面變更其網路存取。

437 437 

276 276 

277這些路徑在作業系統層級強制執行，因此所有在沙箱內執行的命令（包括其子程序）都會遵守這些路徑。當某個工具需要特定位置的寫入權限時，建議採用此方法，而不是使用 `excludedCommands` 將該工具完全排除在沙箱之外。277這些路徑在作業系統層級強制執行，因此所有在沙箱內執行的命令（包括其子程序）都會遵守這些路徑。當某個工具需要特定位置的寫入權限時，建議採用此方法，而不是使用 `excludedCommands` 將該工具完全排除在沙箱之外。

278 278 

279在 Linux 和 WSL2 上，針對尚不存在之路徑的項目不會有任何作用，因此請先建立該路徑。

280 

279當您在多個[設定範圍](https://code.claude.com/docs/zh-TW/settings.md#settings-precedence)中定義相同的檔案系統陣列時，Claude Code 會將它們合併，結合每個範圍中的路徑，而不是以某個範圍的陣列取代另一個範圍的陣列。當[防止開發人員擴大政策](#keep-developers-from-widening-the-policy)中所述的鎖定涵蓋某個項目時，Claude Code 會將該項目排除在合併之外。281當您在多個[設定範圍](https://code.claude.com/docs/zh-TW/settings.md#settings-precedence)中定義相同的檔案系統陣列時，Claude Code 會將它們合併，結合每個範圍中的路徑，而不是以某個範圍的陣列取代另一個範圍的陣列。當[防止開發人員擴大政策](#keep-developers-from-widening-the-policy)中所述的鎖定涵蓋某個項目時，Claude Code 會將該項目排除在合併之外。

280 282 

281如果您在 CLI 上使用 [`--setting-sources`](https://code.claude.com/docs/zh-TW/cli-reference) 或在 Agent SDK 中使用 [`settingSources`](https://code.claude.com/docs/zh-TW/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) 排除某個來源，Claude Code 在建置沙箱設定時會忽略該來源的 `sandbox.filesystem` 項目、其 `Edit` 權限規則，以及其 `Read` 拒絕規則。需要 Claude Code v2.1.246 或更新版本。283如果您在 CLI 上使用 [`--setting-sources`](https://code.claude.com/docs/zh-TW/cli-reference) 或在 Agent SDK 中使用 [`settingSources`](https://code.claude.com/docs/zh-TW/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) 排除某個來源，Claude Code 在建置沙箱設定時會忽略該來源的 `sandbox.filesystem` 項目、其 `Edit` 權限規則，以及其 `Read` 拒絕規則。需要 Claude Code v2.1.246 或更新版本。

376 378 

377由於關閉檔案系統隔離會擴大沙箱化命令能做的事，Claude Code 僅接受來自以下設定來源的 `filesystem.disabled`：379由於關閉檔案系統隔離會擴大沙箱化命令能做的事，Claude Code 僅接受來自以下設定來源的 `filesystem.disabled`：

378 380 

379* 使用者設定、受管設定和 `--settings` CLI 旗標可以設定它。`.claude/settings.json` 和 `.claude/settings.local.json` 中的專案設定則不行，因此簽出的專案無法關閉檔案系統隔離。381* 使用者設定、受管設定和 `--settings` CLI 旗標可以設定它。`.claude/settings.json` 和 `.claude/settings.local.json` 中的專案設定則無法設定它。

380* 當受管設定有設定任何 `sandbox.filesystem`，或列出任何 `"mode": "deny"` 的 `sandbox.credentials.files` 項目時，只有受管設定可以設定此鍵。這可防止開發人員在此類部署中關閉檔案系統隔離；若要為所有人關閉檔案系統隔離，請在受管設定中設定 `"disabled": true`。382* 當受管設定有設定任何 `sandbox.filesystem`，或列出任何 `"mode": "deny"` 的 `sandbox.credentials.files` 項目時，只有受管設定可以設定此鍵。若要為所有人關閉檔案系統隔離，請在受管設定中設定 `"disabled": true`。

381* 當設定了 [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](https://code.claude.com/docs/zh-TW/env-vars) 時，Claude Code 會忽略來自所有來源（包括受管設定）的 `filesystem.disabled`，並保持檔案系統隔離開啟。383* 當設定了 [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](https://code.claude.com/docs/zh-TW/env-vars) 時，Claude Code 會忽略來自所有來源（包括受管設定）的 `filesystem.disabled`。

382 384 

383[有效的](https://code.claude.com/docs/zh-TW/settings-reference.md#invalid-credential-entries-in-managed-settings) `mask` 項目不會鎖定此鍵，即使 Claude Code 在啟動時對其[退回 `deny`](#mask-credential-files) 也是如此。請將無法遮罩的路徑（例如憑證目錄）在受管設定中列為明確的 `deny` 項目，這樣會鎖定此鍵。385[有效的](https://code.claude.com/docs/zh-TW/settings-reference.md#invalid-credential-entries-in-managed-settings) `mask` 項目不會鎖定此鍵，即使 Claude Code 在啟動時對其[退回 `deny`](#mask-credential-files) 也是如此。請將無法遮罩的路徑（例如憑證目錄）在受管設定中列為明確的 `deny` 項目，這樣會鎖定此鍵。

384 386 

177 177 

178Claude Code 監視您的設定檔案並在它們變更時重新載入它們，因此它應用大多數編輯到執行中的工作階段而不需要重新啟動，包括對 `permissions`、`hooks` 和認證協助程式（例如 `apiKeyHelper`）的編輯。Claude Code 也在其資料夾在工作階段啟動時存在時載入您在中途建立的設定檔案。對於專案的 `.claude/` 資料夾，即使您在同一工作階段中建立資料夾，它也會載入檔案。178Claude Code 監視您的設定檔案並在它們變更時重新載入它們，因此它應用大多數編輯到執行中的工作階段而不需要重新啟動，包括對 `permissions`、`hooks` 和認證協助程式（例如 `apiKeyHelper`）的編輯。Claude Code 也在其資料夾在工作階段啟動時存在時載入您在中途建立的設定檔案。對於專案的 `.claude/` 資料夾，即使您在同一工作階段中建立資料夾，它也會載入檔案。

179 179 

180重新載入涵蓋使用者、專案、本機和受管設定，Claude Code 為它偵測到的每個設定檔案變更執行 [`ConfigChange` hook](https://code.claude.com/docs/zh-TW/hooks#configchange)，而不是來自 MDM 或 claude.ai 主控台的受管設定。來自 MDM 或 claude.ai 主控台的受管設定按排程而不是保存時到達執行中的工作階段；[傳遞表](https://code.claude.com/docs/zh-TW/managed-settings.md#choose-a-delivery-mechanism)按來源給出它。180重新載入涵蓋使用者、專案、本機和受管設定。Claude Code 會針對直接編輯設定檔案執行 [`ConfigChange` hook](https://code.claude.com/docs/zh-TW/hooks#configchange)，而不會針對來自 MDM 或 claude.ai 主控台的受管設定執行。來自 MDM 或 claude.ai 主控台的受管設定按排程而不是保存時到達執行中的工作階段；[傳遞表](https://code.claude.com/docs/zh-TW/managed-settings.md#choose-a-delivery-mechanism)按來源給出它。

181 181 

182Claude Code 只在工作階段啟動時讀取某些金鑰一次，因此對其中一個的編輯不會到達執行中的工作階段。也等待重新啟動的管理員端金鑰（例如 `requiredMinimumVersion`）列在[政策適用的位置和時間](https://code.claude.com/docs/zh-TW/managed-settings.md#where-and-when-a-policy-applies)下。您最可能在中途編輯的是：182Claude Code 只在工作階段啟動時讀取某些金鑰一次，因此對其中一個的編輯不會到達執行中的工作階段。也等待重新啟動的管理員端金鑰（例如 `requiredMinimumVersion`）列在[政策適用的位置和時間](https://code.claude.com/docs/zh-TW/managed-settings.md#where-and-when-a-policy-applies)下。您最可能在中途編輯的是：

183 183 

1533}1533}

1534```1534```

1535 1535 

1536在 Linux 和 WSL2 上，針對尚不存在之路徑的項目不會生效，因此請先建立該路徑。

1537 

1536Claude Code 會在工作階段載入的所有設定範圍之間合併 `allowWrite` 項目，以及您 `Edit(...)` 允許權限規則中的路徑；當 [`permissions.blockReadsOutsideWorkingDirectories`](#sandboxed-commands-under-the-block) 開啟時，會排除來自儲存庫設定的項目。[儲存庫鎖定](https://code.claude.com/docs/zh-TW/sandboxing.md#repository-settings-under-an-admin-required-sandbox)也可能排除儲存庫的項目。`allowWrite` 項目無法解除[受保護路徑](https://code.claude.com/docs/zh-TW/sandboxing.md#protected-paths)的限制。1538Claude Code 會在工作階段載入的所有設定範圍之間合併 `allowWrite` 項目，以及您 `Edit(...)` 允許權限規則中的路徑；當 [`permissions.blockReadsOutsideWorkingDirectories`](#sandboxed-commands-under-the-block) 開啟時，會排除來自儲存庫設定的項目。[儲存庫鎖定](https://code.claude.com/docs/zh-TW/sandboxing.md#repository-settings-under-an-admin-required-sandbox)也可能排除儲存庫的項目。`allowWrite` 項目無法解除[受保護路徑](https://code.claude.com/docs/zh-TW/sandboxing.md#protected-paths)的限制。

1537 1539 

1538### `sandbox.filesystem.denyWrite`1540### `sandbox.filesystem.denyWrite`

40>40>

41> **macOS、Linux、WSL：**41> **macOS、Linux、WSL：**

42>42>

43> ```bash theme={null}43> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

44> curl -fsSL https://claude.ai/install.sh | bash44> curl -fsSL https://claude.ai/install.sh | bash

45> ```45> ```

46>46>

48>48>

49> **Windows PowerShell：**49> **Windows PowerShell：**

50>50>

51> ```powershell theme={null}51> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

52> irm https://claude.ai/install.ps1 | iex52> irm https://claude.ai/install.ps1 | iex

53> ```53> ```

54>54>

55> **Windows CMD：**55> **Windows CMD：**

56>56>

57> ```batch theme={null}57> ```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

58> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd58> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

59> ```59> ```

60>60>

72 72 

73> [tab] Homebrew73> [tab] Homebrew

74>74>

75> ```bash theme={null}75> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

76> brew install --cask claude-code76> brew install --cask claude-code

77> ```77> ```

78>78>

84 84 

85> [tab] WinGet85> [tab] WinGet

86>86>

87> ```powershell theme={null}87> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

88> winget install Anthropic.ClaudeCode88> winget install Anthropic.ClaudeCode

89> ```89> ```

90>90>

141 141 

142### Alpine Linux 和 musl 型發行版142### Alpine Linux 和 musl 型發行版

143 143 

144在 Alpine 和其他 musl/uClibc 型發行版上安裝 Claude Code 需要 `bash` 和 `curl` 用於安裝命令，以及 `libgcc`、`libstdc++` 和 `ripgrep` 用於執行時。Alpine 預設不包含 `bash` 或 `curl`，因此在您安裝它們之前，文件中的安裝命令會失敗並出現 `not found` 錯誤。使用您的發行版套件管理員安裝這些套件，然後設定 `USE_BUILTIN_RIPGREP=0`。144在 Alpine 和其他 musl 型發行版上，[安裝命令](#install-claude-code)需要 `bash` 和 `curl`，而 Claude Code 本身需要 `bash` 或 `zsh`。Alpine 預設不包含 `bash` 或 `curl`，因此在您安裝它們之前，文件中的安裝命令會失敗並出現 `not found` 錯誤。

145 145 

146此範例在 Alpine 上安裝所需的套件：146此範例在 Alpine 上安裝所需的套件：

147 147 

148```bash theme={null}148```bash theme={null}

149apk add bash curl libgcc libstdc++ ripgrep149apk add bash curl

150```

151 

152在 Alpine 上，`ripgrep` 位於社群儲存庫中。如果 `apk` 報告套件遺失，請將社群儲存庫新增至 `/etc/apk/repositories`，使用您的 Alpine 版本：

153 

154```bash theme={null}

155echo "https://dl-cdn.alpinelinux.org/alpine/v3.22/community" >> /etc/apk/repositories

156```

157 

158執行 `apk update` 以重新整理套件索引，然後重試 `apk add` 命令。

159 

160然後在您的 [`settings.json`](https://code.claude.com/docs/zh-TW/settings-reference#all-settings) 檔案中將 `USE_BUILTIN_RIPGREP` 設定為 `0`：

161 

162```json theme={null}

163{

164 "env": {

165 "USE_BUILTIN_RIPGREP": "0"

166 }

167}

168```150```

169 151 

170## 驗證您的安裝152## 驗證您的安裝

443> wget -O /etc/apk/keys/claude-code.rsa.pub \425> wget -O /etc/apk/keys/claude-code.rsa.pub \

444> https://downloads.claude.ai/keys/claude-code.rsa.pub426> https://downloads.claude.ai/keys/claude-code.rsa.pub

445> echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories427> echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories

446> apk add claude-code428> apk add bash claude-code

447> ```429> ```

448>430>

449> 若要切換至 `latest` 通道，移除 `stable` 儲存庫行並新增 `latest` 儲存庫：431> 若要切換至 `latest` 通道，移除 `stable` 儲存庫行並新增 `latest` 儲存庫：

26 26 

27| 終端機 | Shift+Enter 用於換行 |27| 終端機 | Shift+Enter 用於換行 |

28| :- | :- |28| :- | :- |

29| Ghostty、Kitty、iTerm2、WezTerm、Warp、Apple Terminal、Windows Terminal | 無需設定即可使用 |29| Ghostty、Kitty、iTerm2、WezTerm、Warp、Windows Terminal | 無需設定即可使用 |

30| 支援 kitty 鍵盤協議的其他終端機，例如 foot 和 Alacritty 0.16 或更新版本 | 無需設定即可使用。需要 Claude Code v2.1.269 或更新版本 |30| 支援 kitty 鍵盤協議的其他終端機，例如 foot 和 Alacritty 0.16 或更新版本 | 無需設定即可使用。需要 Claude Code v2.1.269 或更新版本 |

31| VS Code、Cursor、Devin Desktop、Alacritty 0.16 之前的版本、Zed | 執行一次 `/terminal-setup` |31| VS Code、Cursor、Devin Desktop、Alacritty 0.16 之前的版本、Zed | 執行一次 `/terminal-setup` |

32| gnome-terminal、JetBrains IDE（例如 PyCharm 和 Android Studio） | 不可用；使用 Ctrl+J 或 `\` 然後 Enter |32| gnome-terminal、JetBrains IDE（例如 PyCharm 和 Android Studio） | 不可用；使用 Ctrl+J 或 `\` 然後 Enter |

127 127 

128Claude 使用 `AskUserQuestion` 在需要決策或澄清時向您提出多選題。透過選擇選項來回答，或透過 `Other` 列或備註欄位輸入您自己的文字。128Claude 使用 `AskUserQuestion` 在需要決策或澄清時向您提出多選題。透過選擇選項來回答，或透過 `Other` 列或備註欄位輸入您自己的文字。

129 129 

130當您透過輸入自己的文字來回答時，Claude Code 會以中立的措辭轉達答案，以便 Claude 遵循您所寫的內容，包括等待或先解釋的請求。

131 

132### 問題自動繼續逾時130### 問題自動繼續逾時

133 131 

134問題會保持開啟，直到您回答為止。如果您想讓未回答的問題最終關閉並讓 Claude 在沒有您的情況下繼續，請在您的使用者 `settings.json` 中或從 `/config` 中的 **Question auto-continue timeout** 列將 [`askUserQuestionTimeout`](https://code.claude.com/docs/zh-TW/settings-reference#askuserquestiontimeout) 設定為 `60s`、`5m` 或 `10m`。132問題會保持開啟，直到您回答為止。如果您想讓未回答的問題最終關閉並讓 Claude 在沒有您的情況下繼續，請在您的使用者 `settings.json` 中或從 `/config` 中的 **Question auto-continue timeout** 列將 [`askUserQuestionTimeout`](https://code.claude.com/docs/zh-TW/settings-reference#askuserquestiontimeout) 設定為 `60s`、`5m` 或 `10m`。

525 523 

526## Read 工具行為524## Read 工具行為

527 525 

528Read 工具接受檔案路徑並傳回包含行號的內容。Claude 被指示始終傳遞絕對路徑。526Read 工具接受檔案路徑並傳回包含行號的內容。

529 527 

530讀取空檔案會傳回通知，說明檔案存在但內容為空，而超過最後一行的 `offset` 會傳回通知，提供檔案的行數。528讀取空檔案會傳回通知，說明檔案存在但內容為空，而超過最後一行的 `offset` 會傳回通知，提供檔案的行數。

531 529 

388> Get-Command claude | Select-Object Source388> Get-Command claude | Select-Object Source

389> ```389> ```

390 390 

391在 Linux 上，檢查遺失的共用程式庫。如果 `ldd` 顯示遺失的程式庫，您可能需要安裝系統套件。在 Alpine Linux 和其他 musl 型發行版上，請參閱 [Alpine Linux 設定](https://code.claude.com/docs/zh-TW/setup.md#alpine-linux-and-musl-based-distributions)。391在 Linux 上，檢查遺失的共用程式庫。如果 `ldd` 顯示遺失的程式庫，您可能需要安裝系統套件。在 Alpine Linux 和其他 musl 型發行版上，請參閱 [Linux musl 或 glibc 二進位檔不符](#linux-musl-or-glibc-binary-mismatch)。

392 392 

393```bash theme={null}393```bash theme={null}

394ldd "$(command -v claude)" | grep "not found"394ldd "$(command -v claude)" | grep "not found"

906 906 

907### Linux musl 或 glibc 二進位不相符907### Linux musl 或 glibc 二進位不相符

908 908 

909如果在安裝後看到有關遺失共用程式庫的錯誤，如 `libstdc++.so.6` 或 `libgcc_s.so.1`，安裝程式可能為您的系統下載了錯誤的二進位變體。909如果在安裝後看到有關遺失共用程式庫的錯誤，如 `ld-linux-x86-64.so.2` 或 `ld-linux-aarch64.so.1`，安裝程式可能為您的系統下載了錯誤的二進位變體。

910 910 

911```text theme={null}911```text theme={null}

912Error loading shared library libstdc++.so.6: No such file or directory912Error loading shared library ld-linux-x86-64.so.2: No such file or directory

913```913```

914 914 

915這可能發生在已安裝 musl 交叉編譯套件的基於 glibc 的系統上，導致安裝程式將系統誤檢測為 musl。

916 

917**解決方案：**915**解決方案：**

918 916 

9191. **檢查您的系統使用哪個 libc**：9171. **檢查您的系統使用哪個 libc**：

924 922 

9252. **如果您在 glibc 上但得到了 musl 二進位檔**，移除安裝並重新安裝。您也可以使用 `https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json` 上的清單手動下載正確的二進位檔。使用 `ldd --version` 和 `ls /lib/libc.musl*` 的輸出提交 [GitHub 問題](https://github.com/anthropics/claude-code/issues)。9232. **如果您在 glibc 上但得到了 musl 二進位檔**，移除安裝並重新安裝。您也可以使用 `https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json` 上的清單手動下載正確的二進位檔。使用 `ldd --version` 和 `ls /lib/libc.musl*` 的輸出提交 [GitHub 問題](https://github.com/anthropics/claude-code/issues)。

926 924 

9273. **如果您實際上在 musl 上**，例如 Alpine Linux，請安裝所需的套件：9253. **如果您在 musl 上但得到了 glibc 二進位檔**，請[移除安裝](https://code.claude.com/docs/zh-TW/setup.md#uninstall-claude-code)。在 Alpine Linux 上，請先安裝 [Alpine Linux 設定](https://code.claude.com/docs/zh-TW/setup.md#alpine-linux-and-musl-based-distributions)中列出的套件。然後執行[安裝命令](https://code.claude.com/docs/zh-TW/setup.md#install-claude-code)，它會安裝 musl 二進位檔。

928 ```bash theme={null}

929 apk add libgcc libstdc++ ripgrep

930 ```

931 在 Alpine 上，`ripgrep` 在社群儲存庫中。如果 `apk` 報告套件遺失，請參閱 [Alpine Linux 設定](https://code.claude.com/docs/zh-TW/setup.md#alpine-linux-and-musl-based-distributions)。

932 926 

933### `Illegal instruction`927### `Illegal instruction`

934 928 

152> apk add ripgrep152> apk add ripgrep

153> ```153> ```

154>154>

155> `ripgrep` 在 Alpine 的社群儲存庫中。如果 `apk` 報告套件遺失，請參閱 [Alpine Linux 設定](https://code.claude.com/docs/zh-TW/setup.md#alpine-linux-and-musl-based-distributions)。155> `ripgrep` 在 Alpine 的社群儲存庫中。

156 156 

157> [tab] Arch157> [tab] Arch

158>158>

75| :- | :- |75| :- | :- |

76| `/deep-research <question>` | 在多個角度上展開網路搜尋問題，獲取並交叉檢查它找到的來源，對每項聲明進行投票，並返回引用的報告，其中未通過交叉檢查的聲明已被篩選出去。需要 [WebSearch 工具](https://code.claude.com/docs/zh-TW/tools-reference.md#websearch-tool-behavior)可用 |76| `/deep-research <question>` | 在多個角度上展開網路搜尋問題，獲取並交叉檢查它找到的來源，對每項聲明進行投票，並返回引用的報告，其中未通過交叉檢查的聲明已被篩選出去。需要 [WebSearch 工具](https://code.claude.com/docs/zh-TW/tools-reference.md#websearch-tool-behavior)可用 |

77 77 

78`/deep-research` 僅在您叫用時執行。

79 

80[您自己儲存的工作流程](#save-the-workflow-for-reuse)以相同方式成為命令，並在 `/` 自動完成中與捆綁的命令一起出現。78[您自己儲存的工作流程](#save-the-workflow-for-reuse)以相同方式成為命令，並在 `/` 自動完成中與捆綁的命令一起出現。

81 79 

82### 監視執行80### 監視執行