Documentation 2026-10-02 22:59 UTC to 2026-10-03 01:57 UTC

130在 VS Code 工作階段中，Claude Code 是否會在瀏覽器操作前詢問您，取決於該工作階段連線到瀏覽器的方式：130在 VS Code 工作階段中，Claude Code 是否會在瀏覽器操作前詢問您，取決於該工作階段連線到瀏覽器的方式：

131 131 

132* **您輸入了 `@browser`**：擴充功能會批准 Claude Code 原本會詢問您的每個瀏覽器操作。132* **您輸入了 `@browser`**：擴充功能會批准 Claude Code 原本會詢問您的每個瀏覽器操作。

133* **由[預設啟用](#enable-chrome-by-default)設定在啟動時連線**：在 Manual、Edit automatically、Auto 和 Bypass permissions 模式下，Claude Code 都會在瀏覽器操作前詢問您，直到您在該工作階段中輸入 `@browser` 為止。133* **由[預設啟用](#enable-chrome-by-default)設定在啟動時連線**：在 Manual、Edit automatically、Auto 和 Bypass permissions 模式下，Claude Code 都會在您尚未允許的網站上執行瀏覽器操作前詢問您，直到您在該工作階段中輸入 `@browser` 為止。

134 134 

135<h3 id="browser-tools-in-plan-mode">135<h3 id="browser-tools-in-plan-mode">

136 plan mode 中的瀏覽器工具136 plan mode 中的瀏覽器工具

77| 欄位 | 必需 | 說明 |77| 欄位 | 必需 | 說明 |

78| - | - | - |78| - | - | - |

79| `issuer` | 是 | OIDC 發現基礎。必須在 `/.well-known/openid-configuration` 提供發現。在生產環境中使用 HTTPS；閘道接受 `http://` 簽發者。環回簽發者（例如 `http://localhost:8081`）會被[SSRF 防護](/docs/zh-TW/claude-apps-gateway-deploy#threat-model-summary)拒絕，除非在閘道的環境中設定了 `CLAUDE_GATEWAY_ALLOW_LOOPBACK=1`。 |79| `issuer` | 是 | OIDC 發現基礎。必須在 `/.well-known/openid-configuration` 提供發現。在生產環境中使用 HTTPS；閘道接受 `http://` 簽發者。環回簽發者（例如 `http://localhost:8081`）會被[SSRF 防護](/docs/zh-TW/claude-apps-gateway-deploy#threat-model-summary)拒絕，除非在閘道的環境中設定了 `CLAUDE_GATEWAY_ALLOW_LOOPBACK=1`。 |

80| `client_id` / `client_secret` | 是 | 來自您的 OAuth 用戶端註冊 |80| `client_id` | 是 | 來自您的 OAuth 用戶端註冊 |

81| `client_secret` | 除非 `token_endpoint_auth_method` 為 `private_key_jwt` | 來自您的 OAuth 用戶端註冊。使用[憑證用戶端身分驗證](#certificate-client-authentication)時請省略。 |

81| `allowed_email_domains` | 否 | 拒絕 `email` 宣告不在這些網域之一中的 id\_token，不區分大小寫。針對多租戶 IdP 誤設定的深度防禦。獨立於此設定，`email_verified` 宣告明確為 `false` 的 id\_token 始終被拒絕。 |82| `allowed_email_domains` | 否 | 拒絕 `email` 宣告不在這些網域之一中的 id\_token，不區分大小寫。針對多租戶 IdP 誤設定的深度防禦。獨立於此設定，`email_verified` 宣告明確為 `false` 的 id\_token 始終被拒絕。 |

82| `allowed_groups` | 否 | 限制登入為這些 IdP 群組的成員，與 `groups_claim` 相符。允許電子郵件網域中但不在這些群組中的使用者被拒絕。需要 IdP 發出群組宣告。匹配是針對該宣告中值的精確、區分大小寫的字串比較，閘道不展開嵌套群組：若要允許子群組的成員，請在此列出子群組或設定 IdP 以發出扁平化成員資格。 |83| `allowed_groups` | 否 | 限制登入為這些 IdP 群組的成員，與 `groups_claim` 相符。允許電子郵件網域中但不在這些群組中的使用者被拒絕。需要 IdP 發出群組宣告。匹配是針對該宣告中值的精確、區分大小寫的字串比較，閘道不展開嵌套群組：若要允許子群組的成員，請在此列出子群組或設定 IdP 以發出扁平化成員資格。 |

83| `groups_claim` | 否 | 哪個 id\_token 宣告攜帶群組成員資格。預設 `groups`。Microsoft Entra 在 `roles` 下發出應用程式角色。接受平面鍵或 RFC 6901 JSON 指標，例如 `/resource_access/gateway/roles` 用於嵌套宣告。 |84| `groups_claim` | 否 | 哪個 id\_token 宣告攜帶群組成員資格。預設 `groups`。Microsoft Entra 在 `roles` 下發出應用程式角色。接受平面鍵或 RFC 6901 JSON 指標，例如 `/resource_access/gateway/roles` 用於嵌套宣告。 |

89| `userinfo_fallback` | 否 | 當 id\_token 省略電子郵件或群組時，從 `/userinfo` 擷取它們。Keycloak 輕量級存取令牌、Okta 組織伺服器和 ADFS 最小令牌需要。id\_token 保持權威；userinfo 僅填補空白。預設 `false`。 |90| `userinfo_fallback` | 否 | 當 id\_token 省略電子郵件或群組時，從 `/userinfo` 擷取它們。Keycloak 輕量級存取令牌、Okta 組織伺服器和 ADFS 最小令牌需要。id\_token 保持權威；userinfo 僅填補空白。預設 `false`。 |

90| `use_pkce` | 否 | 在授權請求上傳送 PKCE (S256) 挑戰。預設 `true`。僅當您的 IdP 為此機密用戶端拒絕 PKCE 時設定 `false`。 |91| `use_pkce` | 否 | 在授權請求上傳送 PKCE (S256) 挑戰。預設 `true`。僅當您的 IdP 為此機密用戶端拒絕 PKCE 時設定 `false`。 |

91| `clock_skew_seconds` | 否 | 驗證 id\_token 時間宣告時容許時鐘漂移。預設 `0`，這是嚴格的。如果您在登入後立即看到「令牌已過期/尚未有效」錯誤，請提高以應對主機/IdP 時鐘偏差。 |92| `clock_skew_seconds` | 否 | 驗證 id\_token 時間宣告時容許時鐘漂移。預設 `0`，這是嚴格的。如果您在登入後立即看到「令牌已過期/尚未有效」錯誤，請提高以應對主機/IdP 時鐘偏差。 |

92| `token_endpoint_auth_method` | 否 | 覆蓋令牌端點驗證方法。接受 `client_secret_basic` 或 `client_secret_post`。預設自動協商。 |93| `token_endpoint_auth_method` | 否 | 閘道向 IdP 的 token 端點進行身分驗證的方式：`client_secret_basic`、`client_secret_post`，或用於[憑證用戶端身分驗證](#certificate-client-authentication)的 `private_key_jwt`。預設情況下，閘道會根據 IdP 公告的內容，從兩種 `client_secret` 方法中選擇一種。 |

94| `client_assertion` | 使用 `private_key_jwt` 時 | 包含 `private_key_pem` 和 `certificate_pem` 的區塊：用於[憑證用戶端身分驗證](#certificate-client-authentication)的私密金鑰和憑證。需要 v2.1.284 或更新版本。 |

93| `id_token_signed_response_alg` | 否 | 預期的 id\_token 簽署演算法。預設 `RS256`。為使用 ES256、PS256 或 EdDSA 簽署的 IdP 設定。 |95| `id_token_signed_response_alg` | 否 | 預期的 id\_token 簽署演算法。預設 `RS256`。為使用 ES256、PS256 或 EdDSA 簽署的 IdP 設定。 |

94| `additional_authorized_parties` | 否 | 除了 `client_id` 之外要接受的額外 `azp` 值，用於 Keycloak 代理和令牌交換流程 |96| `additional_authorized_parties` | 否 | 除了 `client_id` 之外要接受的額外 `azp` 值，用於 Keycloak 代理和令牌交換流程 |

95| `discovery_url` | 否 | 從此 URL 擷取發現文件，而不是從 `issuer` 衍生，用於代理後面重寫簽發者主機的 IdP。路徑必須包含 `/.well-known/`。 |97| `discovery_url` | 否 | 從此 URL 擷取發現文件，而不是從 `issuer` 衍生，用於代理後面重寫簽發者主機的 IdP。路徑必須包含 `/.well-known/`。 |

97| `form_action_origins` | 否 | `/device` 頁面的 `Content-Security-Policy: form-action` 指令的其他來源。閘道已允許 `'self'` 和發現的 `authorization_endpoint` 來源，但 Chrome 對整個重新導向鏈強制執行 `form-action`。如果您的 IdP 透過第二個主機重新導向，例如 Azure AD 聯合到 ADFS、中樞輪輻 Okta 或公司 SSO 攔截器，列出授權請求可能重新導向的每個來源。 |99| `form_action_origins` | 否 | `/device` 頁面的 `Content-Security-Policy: form-action` 指令的其他來源。閘道已允許 `'self'` 和發現的 `authorization_endpoint` 來源，但 Chrome 對整個重新導向鏈強制執行 `form-action`。如果您的 IdP 透過第二個主機重新導向，例如 Azure AD 聯合到 ADFS、中樞輪輻 Okta 或公司 SSO 攔截器，列出授權請求可能重新導向的每個來源。 |

98| `ca_cert_pem` | 否 | PEM 編碼的 CA 憑證本身，而不是檔案的路徑。它替換 IdP 請求的系統信任存放區。若要載入掛載的檔案，請寫入 `${file:/etc/gateway/idp-ca.pem}`。用於公司 PKI 後面的 Keycloak 或 Dex。 |100| `ca_cert_pem` | 否 | PEM 編碼的 CA 憑證本身，而不是檔案的路徑。它替換 IdP 請求的系統信任存放區。若要載入掛載的檔案，請寫入 `${file:/etc/gateway/idp-ca.pem}`。用於公司 PKI 後面的 Keycloak 或 Dex。 |

99 101 

102<h4 id="certificate-client-authentication">

103 憑證用戶端身分驗證

104</h4>

105 

106如果您的身分識別提供者使用憑證而非用戶端密碼來驗證 OAuth 用戶端（如 Microsoft Entra 使用憑證認證的方式），請設定 `token_endpoint_auth_method: private_key_jwt`。需要閘道伺服器上的 Claude Code v2.1.284 或更新版本。

107 

108使用此設定時，閘道不會傳送任何密碼。當開發人員登入時，以及每次閘道重新整理其工作階段時，閘道都會使用以憑證私密金鑰簽署的短期 JWT 向 IdP 的 token 端點進行身分驗證。該 JWT 以 RS256 簽署，並透過 `x5t` 和 `x5t#S256` 指紋標頭（而非 `kid`）識別憑證。您的 IdP 必須能夠依指紋找到已註冊的憑證。

109 

110<Steps>

111 <Step title="建立金鑰和憑證">

112 建立至少 2048 位元、採用 PKCS#8 或 PKCS#1 PEM 格式的未加密 RSA 私密金鑰，並為其建立憑證。閘道會拒絕以任何不符合這些條件的金鑰啟動。此 `openssl` 命令會建立這樣的金鑰，以及有效期為一年的自我簽署憑證：

113 

114 ```bash theme={null}

115 openssl req -x509 -newkey rsa:2048 -nodes -keyout idp-client.key -out idp-client.crt -days 365 -subj "/CN=claude-gateway"

116 ```

117 

118 它會將 `idp-client.key` 和 `idp-client.crt` 寫入目前目錄。將這兩個檔案複製或掛載到閘道可讀取的位置。步驟 3 中的範例使用 `/etc/gateway/`。

119 </Step>

120 

121 <Step title="將憑證上傳到 IdP">

122 將憑證（而非私密金鑰）上傳到 IdP 上閘道的應用程式註冊。

123 </Step>

124 

125 <Step title="將金鑰和憑證新增到 gateway.yaml">

126 在 `client_assertion` 區塊中提供私密金鑰和憑證給閘道。省略 `client_secret`，因為當它與 `private_key_jwt` 一起設定時，閘道會拒絕啟動。此 `oidc` 區塊使用憑證讓閘道向 Microsoft Entra 租戶進行身分驗證：

127 

128 ```yaml theme={null}

129 oidc:

130 issuer: https://login.microsoftonline.com/<tenant-id>/v2.0

131 client_id: <application-id>

132 token_endpoint_auth_method: private_key_jwt

133 client_assertion:

134 private_key_pem: ${file:/etc/gateway/idp-client.key}

135 certificate_pem: ${file:/etc/gateway/idp-client.crt}

136 ```

137 

138 這兩個值都是 PEM 內容，而不是檔案路徑，因此請如範例所示使用 `${file:/path}` 載入掛載的檔案。除非 `certificate_pem` 是單一 PEM 憑證（不含其鏈的其餘部分），且其公開金鑰與 `private_key_pem` 相符，否則閘道會拒絕啟動。

139 </Step>

140 

141 <Step title="重新啟動閘道並檢查啟動日誌">

142 重新啟動閘道，並在啟動日誌中找到此行：

143 

144 ```text theme={null}

145 [gateway] 2026-10-01T23:07:40.512Z info oidc: client authentication private_key_jwt; certificate CN=claude-gateway, SHA-1 thumbprint DE92821854EE8BAA1D98C758FAA04AABE80B9F57, expires Oct 1 23:07:31 2027 GMT

146 ```

147 

148 將 SHA-1 指紋與 IdP 針對您上傳的憑證所顯示的指紋進行比較。如果憑證已過期或尚未生效，閘道仍會啟動，但會記錄一則警告，指出在您替換憑證之前，登入和重新整理都會失敗。若要確認 IdP 接受該憑證，請讓一位開發人員透過閘道登入。

149 </Step>

150</Steps>

151 

152<h4 id="rotate-the-client-certificate">

153 輪換用戶端憑證

154</h4>

155 

156閘道僅在啟動時讀取一次金鑰和憑證，因此變更的檔案僅在重新啟動後才會生效。請依照以下順序輪換，以確保沒有任何 token 請求出示 IdP 沒有的憑證：

157 

1581. 將新憑證上傳到 IdP，與舊憑證並存。

1592. 替換 `gateway.yaml` 載入的金鑰和憑證檔案，然後重新啟動閘道。

1603. 從 IdP 移除舊憑證。

161 

100<h4 id="idp-requests-through-a-forward-proxy">162<h4 id="idp-requests-through-a-forward-proxy">

101 透過轉發代理的 IdP 請求163 透過轉發代理的 IdP 請求

102</h4>164</h4>

25 身份提供者設定25 身份提供者設定

26</h2>26</h2>

27 27 

28向任何 OIDC 相容的身份提供者註冊機密 OAuth/OpenID Connect (OIDC) 網路應用程式，使用單一重新導向 URI `https://<gateway>/oauth/callback`，並將其分配給應該有閘道存取權限的使用者或群組。28註冊一個機密 OAuth/OpenID Connect (OIDC) 網路應用程式，使用單一重新導向 URI `https://<gateway>/oauth/callback`，並將其分配給應該有閘道存取權限的使用者或群組。閘道使用該註冊的用戶端密碼向 IdP 進行身分驗證；如果您的 IdP 改用[憑證式憑證](/docs/zh-TW/claude-apps-gateway-config#certificate-client-authentication)，則使用您上傳至該註冊的憑證進行身分驗證。

29 29 

30任何 OIDC 相容的 IdP 都可以使用：Okta、Microsoft Entra ID、Google Workspace、Keycloak、Dex、PingFederate 等。IdP 必須滿足三個要求：30任何 OIDC 相容的 IdP 都可以使用：Okta、Microsoft Entra ID、Google Workspace、Keycloak、Dex、PingFederate 等。IdP 必須滿足三個要求：

31 31 

178 178 

179當工作階段 A 傳訊息給工作階段 B 時，Claude Code 會告訴 B 的 Claude 該訊息來自另一個工作階段，而不是來自您，並限制訊息可以執行的操作：179當工作階段 A 傳訊息給工作階段 B 時，Claude Code 會告訴 B 的 Claude 該訊息來自另一個工作階段，而不是來自您，並限制訊息可以執行的操作：

180 180 

181* **無法批准任何事項**：來自另一個工作階段的訊息永遠不會被視為您的同意，因此無法代表您回答待處理的權限提示。181* **無法核准任何事項**：來自另一個工作階段的訊息永遠不會被視為您的同意，因此無法代表您回答待處理的權限提示。

182* **無法變更設定**：Claude Code 指示接收端的 Claude 永遠不要變更權限設定、`CLAUDE.md` 或其他設定，因為另一個工作階段要求。182* **無法變更設定**：Claude Code 指示接收端的 Claude 永遠不要因為另一個工作階段的要求而變更權限設定、`CLAUDE.md` 或其他設定。

183* **命令不執行**：訊息文字中的命令（例如 `/compact`）會以純文字形式送達。Claude Code 永遠不會執行它。183* **命令不執行**：訊息文字中的命令（例如 `/compact`）會以純文字形式送達。Claude Code 永遠不會執行它。

184* **權限提示仍會觸發**：如果根據訊息採取行動需要接收工作階段沒有的權限，您會看到與任何其他工作相同的提示。184* **權限提示仍會觸發**：如果根據訊息採取行動需要接收工作階段沒有的權限，您會看到與任何其他工作相同的提示。

185 185 

191 191 

192以下任一方式都可以顯示完整文字：192以下任一方式都可以顯示完整文字：

193 193 

194* 按 `Ctrl+O` 開啟[文字記錄檢視器](/docs/zh-TW/interactive-mode#transcript-viewer)，並在寄件者的工作階段名稱下閱讀完整文字。194* 按 `Ctrl+O` 開啟[逐字稿檢視器](/docs/zh-TW/interactive-mode#transcript-viewer)，並在寄件者的工作階段名稱下閱讀完整文字。

195* 在以 [`--verbose`](/docs/zh-TW/cli-reference#cli-flags) 啟動的工作階段中，Claude Code 會顯示完整文字而不是預覽。195* 在以 [`--verbose`](/docs/zh-TW/cli-reference#cli-flags) 啟動的工作階段中，Claude Code 會顯示完整文字而不是預覽。

196 196 

197預覽只會縮短您看到的內容。無論您是否展開它，Claude 都會讀取完整訊息。197預覽只會縮短您看到的內容。無論您是否展開它，Claude 都會讀取完整訊息。

217| `hold` | Claude Code 為每條訊息顯示通知，不傳遞它。如果稍後應用 `accept`，根據[優先順序規則](/docs/zh-TW/settings-reference#crosssessioninbound)，Claude Code 會釋放保留的訊息 |217| `hold` | Claude Code 為每條訊息顯示通知，不傳遞它。如果稍後應用 `accept`，根據[優先順序規則](/docs/zh-TW/settings-reference#crosssessioninbound)，Claude Code 會釋放保留的訊息 |

218| `refuse` | Claude Code 丟棄每條訊息，不傳遞它 |218| `refuse` | Claude Code 丟棄每條訊息，不傳遞它 |

219 219 

220除了編輯設定檔外，您可以在 `/config` 列中選擇**來自您其他工作階段的訊息**的值。Claude Code 會將您選擇的值寫入您的使用者設定。該列需要 Claude Code v2.1.232 或更新版本，當受管設定或 `--settings` 旗標設定金鑰時不會出現，因為使用者設定值在那時不適用。Claude Code 拒絕此金鑰的 `/config crossSessionInbound=value` 簡寫。220除了編輯設定檔外，您可以在 `/config` 列中選擇**來自您其他工作階段的訊息**的值。Claude Code 會將您選擇的值寫入您的使用者設定。該列需要 Claude Code v2.1.232 或更新版本，當受管設定或 `--settings` 旗標設定此設定鍵時不會出現，因為使用者設定值在那時不適用。Claude Code 拒絕此設定鍵的 `/config crossSessionInbound=value` 簡寫。

221 221 

222若要查看適用的值，請遵循[設定參考](/docs/zh-TW/settings-reference#crosssessioninbound)中的 `crossSessionInbound` 優先順序規則。當沒有值適用時，Claude Code 會根據兩個工作階段的權限模式決定每條訊息。它將[略過權限提示](/docs/zh-TW/permission-modes#skip-all-checks-with-bypasspermissions-mode)的工作階段分組為一個類別，將所有其他工作階段分組為另一個類別。Plan Mode 在具有可用的略過權限的工作階段中計為略過，[auto](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode)、`acceptEdits` 和 `dontAsk` 計為提示：222若要查看適用的值，請遵循[設定參考](/docs/zh-TW/settings-reference#crosssessioninbound)中的 `crossSessionInbound` 優先順序規則。

223 223 

224* **接收工作階段提示權限**：Claude Code 傳遞每條訊息。只有當傳送工作階段識別自己為略過權限提示時，它才會保留一條訊息以供您批准。224當沒有值適用時，Claude Code 會根據兩個工作階段的權限模式決定每條訊息。它將[略過權限提示](/docs/zh-TW/permission-modes#skip-all-checks-with-bypasspermissions-mode)的工作階段分組為一個類別，將所有其他工作階段分組為另一個類別。plan mode 在具有可用略過權限的互動式終端機工作階段中計為略過，[auto](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode)、`acceptEdits` 和 `dontAsk` 計為提示：

225* **接收工作階段略過權限提示**：Claude Code 保留每條訊息以供您批准。只有當傳送工作階段識別自己也略過時，它才會傳遞一條訊息。

226 225 

227當預設保留訊息時，Claude Code 會在接收工作階段中開啟批准對話框。對話框顯示寄件者和預覽：226* **接收工作階段提示權限**：Claude Code 傳遞每條訊息。只有當傳送工作階段識別自己為略過權限提示時，它才會保留一條訊息以供您核准。

227* **接收工作階段略過權限提示**：Claude Code 保留每條訊息以供您核准。只有當傳送工作階段識別自己也略過時，它才會傳遞一條訊息。

228 228 

229* **批准**會將該訊息傳遞給 Claude。229當預設在互動式終端機工作階段中保留訊息時，Claude Code 會在該處開啟核准對話框。對話框顯示寄件者和預覽：

230* **拒絕**或關閉對話框會丟棄它。230 

231* **Approve** 會將該訊息傳遞給 Claude。

232* **Deny** 或關閉對話框會丟棄它。

231* 當對話框在 [`dialogExpiry`](/docs/zh-TW/settings-reference#dialogexpiry) 截止時間後仍未回答時，Claude Code 會關閉它並丟棄訊息。截止時間預設為五分鐘。233* 當對話框在 [`dialogExpiry`](/docs/zh-TW/settings-reference#dialogexpiry) 截止時間後仍未回答時，Claude Code 會關閉它並丟棄訊息。截止時間預設為五分鐘。

232* 當沒有終端連接到[背景工作階段](/docs/zh-TW/agent-view)時，Claude Code 會將對話框保持在截止時間之後。連接後，如果對話框在完整截止時間內仍未回答，Claude Code 會關閉它並丟棄訊息。234* 當沒有終端機連接到[背景工作階段](/docs/zh-TW/agent-view)時，Claude Code 會將對話框保持在截止時間之後。連接後，如果對話框在完整截止時間內仍未回答，Claude Code 會關閉它並丟棄訊息。

233* 如果此工作階段的權限模式類別在保留訊息時變更，Claude Code 會重新應用傳入規則，傳遞它們現在接受的訊息，並顯示通知。235* 如果此工作階段的權限模式類別在保留訊息時變更，Claude Code 會重新應用傳入規則，傳遞它們現在接受的訊息，並顯示通知。

234 236 

237VS Code 擴充功能或 Desktop 應用程式中的工作階段無法顯示該對話框。Claude Code 會在該處保留訊息直到相同的截止時間，如[非互動式工作階段](#non-interactive-sessions)所述。

238 

235Claude Code 最多保留 100 條訊息，超過該數量會丟棄最舊的訊息。239Claude Code 最多保留 100 條訊息，超過該數量會丟棄最舊的訊息。

236 240 

237<h3 id="non-interactive-sessions">241<h3 id="non-interactive-sessions">

238 非互動式工作階段242 非互動式工作階段

239</h3>243</h3>

240 244 

241Claude Code 為 [`claude -p`](/docs/zh-TW/headless) 工作階段綁定收件匣套接字，就像互動式工作階段一樣，因此長時間執行的 `-p` 背景工作程式可以接收訊息並出現在列表中。當您以[裸機模式](/docs/zh-TW/headless#start-faster-with-bare-mode)啟動工作階段時，Claude Code 不會綁定套接字，因此該工作階段無法接收訊息，也不會出現在代理列表中。245Claude Code 為 [`claude -p`](/docs/zh-TW/headless) 工作階段綁定收件匣套接字，就像互動式工作階段一樣，因此長時間執行的 `-p` 背景工作程式可以接收訊息並出現在列表中。當您以 [bare 模式](/docs/zh-TW/headless#start-faster-with-bare-mode)啟動工作階段時，Claude Code 不會綁定套接字，因此該工作階段無法接收訊息，也不會出現在 agent 列表中。

242 246 

243`-p` 工作階段無法顯示批准對話框。當[傳入預設](#control-inbound-messages)在那裡保留訊息時，Claude Code 會為其保留相同的 [`dialogExpiry`](/docs/zh-TW/settings-reference#dialogexpiry) 截止時間，預設為五分鐘：247`-p` 工作階段無法顯示核准對話框。當[傳入預設](#control-inbound-messages)在那裡保留訊息時，Claude Code 會為其保留相同的 [`dialogExpiry`](/docs/zh-TW/settings-reference#dialogexpiry) 截止時間，預設為五分鐘：

244 248 

245* **在截止時間之前**：如果模式或設定變更允許訊息，Claude Code 會傳遞它。249* **在截止時間之前**：如果模式或設定變更允許訊息，Claude Code 會傳遞它。

246* **在截止時間之後**：Claude Code 會丟棄訊息，並向它可以到達的寄件者報告為已過期。250* **在截止時間之後**：Claude Code 會丟棄訊息，並向它可以到達的寄件者報告為已過期。

253 工作階段的收件匣套接字257 工作階段的收件匣套接字

254</h3>258</h3>

255 259 

256當您預期的工作階段不在代理列表中、當您想要指令碼或 hook 發佈到工作階段中，或當沙箱化命令無法到達套接字時，請閱讀本節。260當您預期的工作階段不在 agent 列表中、當您想要指令碼或 hook 發佈到工作階段中，或當沙箱化命令無法到達套接字時，請閱讀本節。

257 261 

258Claude Code 為啟用跨工作階段訊息的每個工作階段綁定收件匣套接字，其中機器上的其他工作階段傳遞訊息。套接字是 macOS 和 Linux 上的 Unix 網域套接字（包括 WSL 2 內的 Linux），以及原生 Windows 上的具名管道。有關哪些工作階段類型綁定一個，請參閱[非互動式工作階段](#non-interactive-sessions)。262Claude Code 為啟用跨工作階段訊息的每個工作階段綁定收件匣套接字，機器上的其他工作階段會透過它傳遞訊息。套接字是 macOS 和 Linux 上的 Unix 網域套接字（包括 WSL 2 內的 Linux），以及原生 Windows 上的具名管道。有關哪些工作階段類型綁定一個，請參閱[非互動式工作階段](#non-interactive-sessions)。

259 263 

260您可以在兩個位置找到套接字的路徑：264您可以在兩個位置找到套接字的路徑：

261 265 

262* `/status` 在 `Peer address` 列中顯示它。路徑前綴為 `uds:`。266* `/status` 在 `Peer address` 列中顯示它。路徑前綴為 `uds:`。

263* Claude Code 將其匯出到[hooks](/docs/zh-TW/hooks) 和 Bash 命令作為 [`CLAUDE_CODE_MESSAGING_SOCKET`](/docs/zh-TW/env-vars#variables) 環境變數：267* Claude Code 將其匯出到 [hooks](/docs/zh-TW/hooks) 和 Bash 命令作為 [`CLAUDE_CODE_MESSAGING_SOCKET`](/docs/zh-TW/env-vars#variables) 環境變數：

264 * 在以訊息開啟啟動的工作階段中，Claude Code 在任何 hook 執行前匯出變數，包括 `SessionStart`。268 * 在以訊息開啟啟動的工作階段中，Claude Code 在任何 hook 執行前匯出變數，包括 `SessionStart`。

265 269 

266在 macOS 和 Linux 上，Claude Code 將套接字限制為您的作業系統使用者。在原生 Windows 上，它改為要求每個連線首先使用只有您的作業系統使用者可以讀取的金鑰進行驗證。無論哪種方式，在共享機器上，另一個使用者的工作階段無法傳遞到它。270在 macOS 和 Linux 上，Claude Code 將套接字限制為您的作業系統使用者。在原生 Windows 上，它改為要求每個連線首先使用只有您的作業系統使用者可以讀取的金鑰進行驗證。無論哪種方式，在共享機器上，另一個使用者的工作階段無法傳遞到它。

267 271 

268在 macOS 和 Linux 上，Claude Code 也拒絕在無法接受的目錄中建立套接字，例如另一個使用者擁有的目錄，並改為使用私人的每使用者目錄 `/tmp/cc-socks-<uid>`。當它無法接受任何目錄時，工作階段會在沒有收件匣的情況下執行：Claude Code 會顯示通知，`/status` 在其 `Peer address` 列中顯示 `unavailable` 和原因，[`--debug`](/docs/zh-TW/cli-reference#cli-flags) 日誌會記錄完整拒絕。272在 macOS 和 Linux 上，Claude Code 也拒絕在無法接受的目錄中建立套接字，例如另一個使用者擁有的目錄，並改為使用私人的每使用者目錄 `/tmp/cc-socks-<uid>`。當它無法接受任何目錄時，工作階段會在沒有收件匣的情況下執行：Claude Code 會顯示通知，`/status` 在其 `Peer address` 列中顯示 `unavailable` 和原因，[`--debug`](/docs/zh-TW/cli-reference#cli-flags) 日誌會記錄完整拒絕。

269 273 

270除了套接字的路徑外，Claude Code 還會匯出每個工作階段的權杖作為 [`CLAUDE_CODE_MESSAGING_TOKEN`](/docs/zh-TW/env-vars#variables)。發佈到其自己工作階段套接字的指令碼可以發送 `{"type":"auth","token":"<token>"}` 作為其連線的第一行，其中 `<token>` 是 `CLAUDE_CODE_MESSAGING_TOKEN` 的值。Claude Code 是否需要該行取決於平台：274除了套接字的路徑外，Claude Code 還會匯出每個工作階段的 token 作為 [`CLAUDE_CODE_MESSAGING_TOKEN`](/docs/zh-TW/env-vars#variables)。發佈到其自己工作階段套接字的指令碼可以發送 `{"type":"auth","token":"<token>"}` 作為其連線的第一行，其中 `<token>` 是 `CLAUDE_CODE_MESSAGING_TOKEN` 的值。Claude Code 是否需要該行取決於平台：

271 275 

272* **macOS 和 Linux，包括 WSL 2**：該行是選擇性的。Claude Code 接受有或沒有它的連線。276* **macOS 和 Linux，包括 WSL 2**：該行是選擇性的。Claude Code 接受有或沒有它的連線。

273* **原生 Windows**：該行是必需的。Claude Code 會關閉任何第一行不是有效驗證行的連線，並且不會從該連線傳遞任何內容。277* **原生 Windows**：該行是必需的。Claude Code 會關閉任何第一行不是有效驗證行的連線，並且不會從該連線傳遞任何內容。

274 278 

275只有在您要發佈的訊息準備好時才開啟連線。Claude Code 會關閉在 30 秒內未發送完整行的連線，因此請先擷取緩慢命令的輸出，然後開啟連線以發送它。279只有在您要發佈的訊息準備好時才開啟連線。Claude Code 會關閉在 30 秒內未發送完整行的連線，因此請先擷取緩慢命令的輸出，然後開啟連線以發送它。

276 280 

277<span id="own-child-messages" />Claude Code 會透過與任何其他對等訊息相同的[傳入控制](#control-inbound-messages)執行到達套接字的訊息，但有一個例外和一個先決條件：281<span id="own-child-messages" />Claude Code 會透過與任何其他對等訊息相同的[傳入控制](#control-inbound-messages)處理到達套接字的訊息，但有一個例外和一個先決條件：

278 282 

279* **自有子訊息**：當沒有 `crossSessionInbound` 值適用時，Claude Code 會傳遞它驗證來自工作階段自己的子程序的訊息，例如 hook 或 Bash 命令發佈回其自己工作階段的套接字。283* **自有子訊息**：當沒有 `crossSessionInbound` 值適用時，Claude Code 會傳遞它驗證來自工作階段自己的子程序的訊息，例如 hook 或 Bash 命令發佈回其自己工作階段的套接字。

280 * 在 Linux 上（包括 WSL 2 內），Claude Code 即使對於已經退出的子程序也可以透過程序證據進行驗證。在 macOS 上，它只能在發佈程序仍在執行時以這種方式驗證，在 Claude Code 作為程序 ID 1 執行的容器中，它根本沒有程序證據。在原生 Windows 上也沒有。284 * 在 Linux 上（包括 WSL 2 內），Claude Code 即使對於已經退出的子程序也可以透過程序證據進行驗證。在 macOS 上，它只能在發佈程序仍在執行時以這種方式驗證，在 Claude Code 作為程序 ID 1 執行的容器中，它根本沒有程序證據。在原生 Windows 上也沒有。

281 * 在 macOS 上發佈程序已退出後，以及在 Claude Code 作為程序 ID 1 執行的容器中，該程序證據遺失，Claude Code 改為驗證在開啟其連線的驗證行中發送工作階段匯出的 [`CLAUDE_CODE_MESSAGING_TOKEN`](/docs/zh-TW/env-vars#variables) 的子程序。在原生 Windows 上，該權杖是 Claude Code 驗證自有子訊息的唯一方式。285 * 在 macOS 上發佈程序已退出後，以及在 Claude Code 作為程序 ID 1 執行的容器中，該程序證據遺失，Claude Code 改為驗證在開啟其連線的驗證行中發送工作階段匯出的 [`CLAUDE_CODE_MESSAGING_TOKEN`](/docs/zh-TW/env-vars#variables) 的子程序。在原生 Windows 上，該 token 是 Claude Code 驗證自有子訊息的唯一方式。

282 * 當 Claude Code 無法以任何方式驗證時，它會將訊息視為任何其他不聲稱權限類別的訊息，因此略過權限提示的工作階段會為您的批准保留它。286 * 當 Claude Code 無法以任何方式驗證時，它會將訊息視為任何其他不聲稱權限類別的訊息，因此略過權限提示的工作階段會保留它以供您核准。

283* **沙箱化工作階段**：使用沙箱的 Unix 套接字設定 [`sandbox.network.allowAllUnixSockets` 和 `sandbox.network.allowUnixSockets`](/docs/zh-TW/settings-reference#sandbox-settings) 控制 Bash 命令是否可以從[沙箱](/docs/zh-TW/sandboxing)內到達套接字。287* **沙箱化工作階段**：使用沙箱的 Unix 套接字設定 [`sandbox.network.allowAllUnixSockets` 和 `sandbox.network.allowUnixSockets`](/docs/zh-TW/settings-reference#sandbox-settings) 控制 Bash 命令是否可以從[沙箱](/docs/zh-TW/sandboxing)內到達套接字。

284 288 

285<h2 id="restrict-cross-session-messaging">289<h2 id="restrict-cross-session-messaging">

275| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | 設定為 `1` 可在 Claude Code 將未回應的權限請求傳送至 Agent SDK 的 `canUseTool` 回呼的工作階段中（這是 Claude Desktop 與 VS Code 擴充功能承載 Claude Code 的方式），阻止 Claude Code 執行您[針對未回應權限請求的 `Notification` hook](/docs/zh-TW/hooks#notification)。在終端機工作階段中沒有作用。需要 Claude Code v2.1.233 或更新版本 |275| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | 設定為 `1` 可在 Claude Code 將未回應的權限請求傳送至 Agent SDK 的 `canUseTool` 回呼的工作階段中（這是 Claude Desktop 與 VS Code 擴充功能承載 Claude Code 的方式），阻止 Claude Code 執行您[針對未回應權限請求的 `Notification` hook](/docs/zh-TW/hooks#notification)。在終端機工作階段中沒有作用。需要 Claude Code v2.1.233 或更新版本 |

276| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | 設定為 `1` 可略過從全系統受管 skill 目錄載入 skill。適用於不應載入由營運人員佈建之 skill 的容器或 CI 工作階段 |276| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | 設定為 `1` 可略過從全系統受管 skill 目錄載入 skill。適用於不應載入由營運人員佈建之 skill 的容器或 CI 工作階段 |

277| `CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY` | 設定為 `1` 可關閉 [PowerShell 工具](/docs/zh-TW/tools-reference#powershell-tool)的檢查，該檢查會拒絕在[系統路徑](/docs/zh-TW/permission-modes#remove-item-in-powershell)（例如磁碟機根目錄或您的家目錄）上使用 `cmd` 內建命令 `rd`、`rmdir`、`del` 與 `erase`。Claude Code 會忽略設定檔 `env` 區塊中的此變數。需要 Claude Code v2.1.283 或更新版本 |277| `CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY` | 設定為 `1` 可關閉 [PowerShell 工具](/docs/zh-TW/tools-reference#powershell-tool)的檢查，該檢查會拒絕在[系統路徑](/docs/zh-TW/permission-modes#remove-item-in-powershell)（例如磁碟機根目錄或您的家目錄）上使用 `cmd` 內建命令 `rd`、`rmdir`、`del` 與 `erase`。Claude Code 會忽略設定檔 `env` 區塊中的此變數。需要 Claude Code v2.1.283 或更新版本 |

278| `CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS` | 設為 `1` 可讓 Claude Code 停止傳送結構化輸出的 `output_config.format` 欄位以及與其搭配的 `anthropic-beta` 值，適用於上游會拒絕這些內容的 [LLM 閘道](/docs/zh-TW/llm-gateway-protocol#feature-pass-through)。這會保留 [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/zh-TW/llm-gateway-protocol#disable-pre-release-capabilities) 會關閉的其他預發行功能。需要 Claude Code v2.1.288 或更新版本 |

278| `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT` | 設定為 `1` 可關閉針對目標完全是命令替換輸出之遞迴 `rm`（例如 `rm -rf "$(pwd)"`）的[關鍵路徑](/docs/zh-TW/permission-modes#critical-paths)檢查。其他關鍵路徑檢查會持續執行。請在啟動 Claude Code 的環境中設定，因為 Claude Code 會忽略透過設定 `env` 區塊傳遞的副本。需要 Claude Code v2.1.281 或更新版本 |279| `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT` | 設定為 `1` 可關閉針對目標完全是命令替換輸出之遞迴 `rm`（例如 `rm -rf "$(pwd)"`）的[關鍵路徑](/docs/zh-TW/permission-modes#critical-paths)檢查。其他關鍵路徑檢查會持續執行。請在啟動 Claude Code 的環境中設定，因為 Claude Code 會忽略透過設定 `env` 區塊傳遞的副本。需要 Claude Code v2.1.281 或更新版本 |

279| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | 設定為 `1` 可停用根據對話上下文自動更新終端機標題。這也會略過用來[產生工作階段標題](/docs/zh-TW/sessions#name-your-sessions)的背景小型/快速模型請求 |280| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | 設定為 `1` 可停用根據對話上下文自動更新終端機標題。這也會略過用來[產生工作階段標題](/docs/zh-TW/sessions#name-your-sessions)的背景小型/快速模型請求 |

280| `CLAUDE_CODE_DISABLE_THINKING` | 設定為 `1` 可從 API 請求中完全省略 `thinking` 參數。這是針對會拒絕此參數之代理伺服器與閘道的相容性選項。在預設會思考的模型上，省略此參數意味著模型仍可能思考。若要在 Anthropic API 上明確停用[延伸思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)，請改用 `MAX_THINKING_TOKENS=0`。這兩個變數都無法在 Opus 5.5、Sonnet 5.5 或 Fable 模型上關閉思考，因為這些模型無法關閉思考。在[第三方供應商](/docs/zh-TW/third-party-integrations)上，`MAX_THINKING_TOKENS=0` 同樣會省略此參數，因此這兩個變數在那裡的行為相同 |281| `CLAUDE_CODE_DISABLE_THINKING` | 設定為 `1` 可從 API 請求中完全省略 `thinking` 參數。這是針對會拒絕此參數之代理伺服器與閘道的相容性選項。在預設會思考的模型上，省略此參數意味著模型仍可能思考。若要在 Anthropic API 上明確停用[延伸思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)，請改用 `MAX_THINKING_TOKENS=0`。這兩個變數都無法在 Opus 5.5、Sonnet 5.5 或 Fable 模型上關閉思考，因為這些模型無法關閉思考。在[第三方供應商](/docs/zh-TW/third-party-integrations)上，`MAX_THINKING_TOKENS=0` 同樣會省略此參數，因此這兩個變數在那裡的行為相同 |

4416 Teammate's agent definition was not restored4416 Teammate's agent definition was not restored

4417</h3>4417</h3>

4418 4418 

4419Claude 傳訊息給一位已停止的 [agent team](/docs/zh-TW/agent-teams) 隊員，Claude Code 將其恢復，但沒有重新套用它最初據以產生的 [subagent 定義](/docs/zh-TW/agent-teams#use-subagent-definitions-for-teammates)，因為其定義檔案來自沒有已儲存信任的資料夾。此通知會接在傳送端 agent 工具結果中的恢復報告之後：4419Claude 傳訊息給一位已停止的 [agent team](/docs/zh-TW/agent-teams) 隊員，Claude Code 將其恢復，但沒有重新套用它最初據以產生的 [subagent 定義](/docs/zh-TW/agent-teams#use-subagent-definitions-for-teammates)。此通知會接在傳送端 agent 工具結果中的恢復報告之後，並指出原因。當定義檔案來自沒有已儲存信任的資料夾時，內容如下：

4420 4420 

4421```text wrap theme={null}4421```text wrap theme={null}

4422Its 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.4422Its 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.

1931| 欄位 | 描述 |1931| 欄位 | 描述 |

1932| :- | :- |1932| :- | :- |

1933| `permissionDecision` | `"allow"` 跳過權限提示，除了 [任何模式自動核准的動作](/docs/zh-TW/permission-modes#actions-no-mode-auto-approves) 和 `AskUserQuestion` 和 `ExitPlanMode`，它們需要 [`updatedInput` 與它配對](#allow-with-updatedinput)。`"deny"` 防止工具呼叫。`"ask"` 提示使用者確認。`"defer"` 優雅地退出，以便稍後可以恢復工具。[拒絕和詢問規則](/docs/zh-TW/permissions#manage-permissions) 無論 hook 返回什麼都會被評估 |1933| `permissionDecision` | `"allow"` 跳過權限提示，除了 [任何模式自動核准的動作](/docs/zh-TW/permission-modes#actions-no-mode-auto-approves) 和 `AskUserQuestion` 和 `ExitPlanMode`，它們需要 [`updatedInput` 與它配對](#allow-with-updatedinput)。`"deny"` 防止工具呼叫。`"ask"` 提示使用者確認。`"defer"` 優雅地退出，以便稍後可以恢復工具。[拒絕和詢問規則](/docs/zh-TW/permissions#manage-permissions) 無論 hook 返回什麼都會被評估 |

1934| `permissionDecisionReason` | 對於 `"ask"`，顯示給使用者但不顯示 Claude。對於 `"deny"`，顯示給 Claude。對於 `"allow"` 和 `"defer"`，寫入 [debug log](#debug-hooks) 僅 |1934| `permissionDecisionReason` | 對於 `"ask"`，會在權限提示中顯示給使用者。當 Claude Code 在沒有人能回應該提示的 `-p` 執行中[拒絕呼叫](/docs/zh-TW/headless#turn-off-permission-prompts-in-unattended-runs)時，Claude 會改在工具結果中讀取原因。對於 `"deny"`，會顯示給 Claude。對於 `"allow"` 和 `"defer"`，只會寫入[偵錯日誌](#debug-hooks) |

1935| `updatedInput` | 在執行前修改工具的輸入參數。替換整個輸入物件，因此在修改的欄位旁邊包含未變更的欄位。Claude Code 根據您的 hook 返回的輸入評估權限規則和 Bash 命令的 [自動背景資格](/docs/zh-TW/tools-reference#foreground-commands-that-move-to-the-background)，而不是 Claude 傳送的輸入。與 `"allow"` 結合以自動核准，或與 `"ask"` 結合以向使用者顯示修改的輸入。對於 `"defer"`，忽略 |1935| `updatedInput` | 在執行前修改工具的輸入參數。替換整個輸入物件，因此在修改的欄位旁邊包含未變更的欄位。Claude Code 根據您的 hook 返回的輸入評估權限規則和 Bash 命令的 [自動背景資格](/docs/zh-TW/tools-reference#foreground-commands-that-move-to-the-background)，而不是 Claude 傳送的輸入。與 `"allow"` 結合以自動核准，或與 `"ask"` 結合以向使用者顯示修改的輸入。對於 `"defer"`，忽略 |

1936| `additionalContext` | 與工具結果一起新增到 Claude 背景資訊的字串。當 `permissionDecision` 為 `"defer"` 時忽略。有關詳細資訊，請參閱 [為 Claude 新增背景資訊](#add-context-for-claude) |1936| `additionalContext` | 與工具結果一起新增到 Claude 背景資訊的字串。當 `permissionDecision` 為 `"defer"` 時忽略。有關詳細資訊，請參閱 [為 Claude 新增背景資訊](#add-context-for-claude) |

1937 1937 

245| [上下文管理](https://platform.claude.com/docs/en/build-with-claude/context-editing) | 上下文管理測試版標頭與 `context_management` 請求體欄位配對 | `400` 搭配 `Extra inputs are not permitted`。常見於閘道接受 Anthropic 格式請求但將其轉發到 Amazon Bedrock 時 | 轉發兩者，或 [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) |245| [上下文管理](https://platform.claude.com/docs/en/build-with-claude/context-editing) | 上下文管理測試版標頭與 `context_management` 請求體欄位配對 | `400` 搭配 `Extra inputs are not permitted`。常見於閘道接受 Anthropic 格式請求但將其轉發到 Amazon Bedrock 時 | 轉發兩者，或 [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) |

246| [擴展上下文](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model)和[交錯思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) | 僅測試版標頭，無請求體欄位 | 當標頭被移除時無聲地不可用；上游永遠不會看到功能請求 | 逐字轉發 `anthropic-beta` |246| [擴展上下文](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model)和[交錯思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) | 僅測試版標頭，無請求體欄位 | 當標頭被移除時無聲地不可用；上游永遠不會看到功能請求 | 逐字轉發 `anthropic-beta` |

247| 測試版[工具欄位](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview) | 工具相關的測試版標頭與工具架構欄位（如 `strict` 和 `defer_loading`）配對 | 當請求體在沒有其標頭的情況下通過時，命名無法識別的工具架構欄位的 `400` | 轉發兩者，或 [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) |247| 測試版[工具欄位](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview) | 工具相關的測試版標頭與工具架構欄位（如 `strict` 和 `defer_loading`）配對 | 當請求體在沒有其標頭的情況下通過時，命名無法識別的工具架構欄位的 `400` | 轉發兩者，或 [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) |

248| [努力](https://platform.claude.com/docs/en/build-with-claude/effort)和[結構化輸出](https://platform.claude.com/docs/en/build-with-claude/structured-outputs) | `output_config` 請求體欄位攜帶努力、結構化輸出格式和任務預算設定；每個都與其自己的測試版標頭配對 | 在 Amazon Bedrock 和 Google Cloud 的 Agent Platform 上游上命名 `output_config` 的 `400`，通常是 `Extra inputs are not permitted` | 一起轉發欄位及其標頭，或讓開發人員設定 [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities)，這會移除格式和任務預算設定，但不會移除努力 |248| [努力](https://platform.claude.com/docs/en/build-with-claude/effort)和[結構化輸出](https://platform.claude.com/docs/en/build-with-claude/structured-outputs) | `output_config` 請求體欄位攜帶努力、結構化輸出格式和任務預算設定；每個都與其自己的測試版標頭配對 | 在 Amazon Bedrock 和 Google Cloud 的 Agent Platform 上游上命名 `output_config` 的 `400`，通常是 `Extra inputs are not permitted` | 一起轉發欄位及其標頭，或讓開發人員設定 [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities)，這會移除格式和任務預算設定，但不會移除努力。若只要移除格式，他們可以改為設定 [`CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS=1`](/docs/zh-TW/env-vars)，這需要 v2.1.288 或更新版本 |

249| [提示詞快取](/docs/zh-TW/prompt-caching) | 無測試版配對。Claude Code 將 `cache_control` 標記附加到 `system` 區塊和 `messages` 項目，包括在對話中途附加的 `role: "system"` 項目 | 無錯誤：對話在每個回合上都計費為未快取的輸入，在 `usage` 中可見為高 `input_tokens` 且很少或沒有快取活動 | 無論在何處出現，都逐字轉發 `cache_control`，並且不要將區塊形式的 `system` 或訊息內容轉換為純字串 |249| [提示詞快取](/docs/zh-TW/prompt-caching) | 無測試版配對。Claude Code 將 `cache_control` 標記附加到 `system` 區塊和 `messages` 項目，包括在對話中途附加的 `role: "system"` 項目 | 無錯誤：對話在每個回合上都計費為未快取的輸入，在 `usage` 中可見為高 `input_tokens` 且很少或沒有快取活動 | 無論在何處出現，都逐字轉發 `cache_control`，並且不要將區塊形式的 `system` 或訊息內容轉換為純字串 |

250| [令牌計數](https://platform.claude.com/docs/en/build-with-claude/token-counting) | 無測試版配對；使用 `count_tokens` 端點 | 無錯誤：Claude Code 回退到基於字元的估計，因此 `/context` 顯示近似計數 | 公開端點以取得精確令牌計數 |250| [令牌計數](https://platform.claude.com/docs/en/build-with-claude/token-counting) | 無測試版配對；使用 `count_tokens` 端點 | 無錯誤：Claude Code 回退到基於字元的估計，因此 `/context` 顯示近似計數 | 公開端點以取得精確令牌計數 |

251 251 

794 794 

795<span id="context-window-behind-a-gateway" />795<span id="context-window-behind-a-gateway" />

796 796 

797如果您將 `ANTHROPIC_BASE_URL` 設定為 [LLM 閘道](/docs/zh-TW/llm-gateway)或其他代理伺服器，Claude Code 會為它能識別的每個模型提供與該模型在 Anthropic API 上相同的上下文視窗。Fable 5.1、Fable 5、Sonnet 5 及更新版本，以及 Opus 4.7 及更新版本會取得 1M 視窗，無需選擇 `[1m]` 變體；而只能透過 `[1m]` 變體達到 1M 的模型（例如 Opus 4.6），在未使用該變體時會以 200K 執行。Claude Code 無法偵測閘道或其後方伺服器所強制執行的較低限制。如果您的閘道會拒絕超過 200K token 的請求，請執行 [`/autocompact 200k`](#set-the-auto-compact-window)，讓工作階段在該邊界進行壓縮。797如果您將 `ANTHROPIC_BASE_URL` 設定為 [LLM 閘道](/docs/zh-TW/llm-gateway)或其他代理伺服器，Claude Code 會為它能識別的每個模型提供與該模型在 Anthropic API 上相同的上下文視窗。Fable 5.1、Fable 5、Sonnet 5 及更新版本，以及 Opus 4.7 及更新版本會取得 1M 視窗，無需選擇 `[1m]` 變體；而只能透過 `[1m]` 變體達到 1M 的模型（例如 Opus 4.6），在未使用該變體時會以 200K 執行。Claude Code 無法偵測閘道或其後方伺服器所強制執行的較低限制。如果您的閘道會拒絕超過 200K token 的請求，請在啟動 Claude Code 的環境中設定 [`CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000`](/docs/zh-TW/env-vars)，讓所有模型上的工作階段都[在該邊界進行壓縮](#set-the-auto-compact-window)。

798 798 

799若要關閉 1M 上下文，請設定 `CLAUDE_CODE_DISABLE_1M_CONTEXT=1`。Claude Code 會從模型選擇器中移除 1M 模型變體。對於具有原生 1M 視窗的模型（例如 Sonnet 5 和 Fable 模型），它也會將該模型視為具有 200K 上下文視窗：799若要關閉 1M 上下文，請設定 `CLAUDE_CODE_DISABLE_1M_CONTEXT=1`。Claude Code 會從模型選擇器中移除 1M 模型變體。對於具有原生 1M 視窗的模型（例如 Sonnet 5 和 Fable 模型），它也會將該模型視為具有 200K 上下文視窗：

800 800 

840 設定自動壓縮視窗840 設定自動壓縮視窗

841</h3>841</h3>

842 842 

843您可以在三個地方設定自動壓縮視窗：843您可以在下列地方設定自動壓縮視窗：

844 844 

845* **適用於本次及之後的工作階段**：執行帶有值的 `/autocompact`，例如 `/autocompact 500k`。Claude Code 會將其以 [`autoCompactWindow`](/docs/zh-TW/settings-reference#autocompactwindow) 儲存至您的使用者設定，並套用至目前的工作階段；若受管設定等優先順序較高的[設定範圍](/docs/zh-TW/settings#settings-precedence)設定了此鍵，該命令仍會儲存您的值，但工作階段會維持該範圍的視窗，且命令會說明此情況。執行 `/autocompact auto` 可恢復為針對您的模型調校的視窗。845* **適用於目前模型，於本次及之後的工作階段**：執行帶有值的 `/autocompact`，例如 `/autocompact 500k`。Claude Code 會將其儲存至您的使用者設定中 [`modelSettings`](/docs/zh-TW/settings-reference#modelsettings) 下的目前模型，並套用至目前的工作階段。若受管設定等優先順序較高的[設定範圍](/docs/zh-TW/settings#settings-precedence)為該模型或所有模型設定了自己的視窗，該命令仍會儲存您的值，但工作階段會維持該範圍的視窗，且命令會說明此情況。執行 `/autocompact auto` 可恢復為針對您的模型調校的視窗。在 v2.1.288 之前，此命令會為所有模型儲存單一視窗，即頂層的 `autoCompactWindow`。

846* **適用於所有模型**：在設定檔中設定 [`autoCompactWindow`](/docs/zh-TW/settings-reference#autocompactwindow)，例如在 `~/.claude/settings.json` 中設定 `"autoCompactWindow": 200000`。對於某個模型，您透過 `/autocompact` 為該模型儲存的視窗會優先於同一檔案中的此設定鍵。

846* **適用於單次啟動**：啟動 Claude Code 時傳入 [`--autocompact`](/docs/zh-TW/cli-reference#cli-flags)。此旗標會在該次啟動中覆寫您已儲存的設定，但不會變更該設定；即使您已儲存的設定有值，`claude --autocompact auto` 仍會以調校後的視窗執行工作階段。與 `/autocompact` 不同，此旗標不會被受管設定等優先順序較高的設定範圍搶先覆寫。847* **適用於單次啟動**：啟動 Claude Code 時傳入 [`--autocompact`](/docs/zh-TW/cli-reference#cli-flags)。此旗標會在該次啟動中覆寫您已儲存的設定，但不會變更該設定；即使您已儲存的設定有值，`claude --autocompact auto` 仍會以調校後的視窗執行工作階段。與 `/autocompact` 不同，此旗標不會被受管設定等優先順序較高的設定範圍搶先覆寫。

847* **在指令碼與雲端環境中**：設定 [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/zh-TW/env-vars)。設定此變數期間，它會優先於命令、旗標與設定，且 `/autocompact` 會回報此覆寫，而不會變更視窗。848* **在指令碼與雲端環境中**：設定 [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/zh-TW/env-vars)。設定此變數期間，它會優先於命令、旗標與設定，且 `/autocompact` 會回報此覆寫，而不會變更視窗。

848 849 

145 提交到 Anthropic 的目錄145 提交到 Anthropic 的目錄

146</h2>146</h2>

147 147 

148Anthropic 的目錄是人們在 claude.ai 和 Cowork 中瀏覽以新增外掛程式和連接器的目錄。在那裡的一個列表可以觸及 claude.ai、Cowork 和 Claude Code 上的人。您可以從開發者入口網站 [claude.ai/directory/manage](https://claude.ai/directory/manage) 提交；[準備審查](https://claude.com/docs/directory/publish#prepare-for-review) 在 claude.com 上說明每個版本在發佈前會發生什麼。148[Anthropic 的目錄](https://claude.ai/directory)是人們在 claude.ai 和 Cowork 中瀏覽以新增外掛程式和連接器的目錄。在那裡的一個列表可以觸及 claude.ai、Cowork 和 Claude Code 上的人。您可以從開發者入口網站 [claude.ai/directory/manage](https://claude.ai/directory/manage) 提交，claude.com 上的[提交外掛程式](https://claude.com/docs/plugins/submit#submit-a-plugin)會逐步說明入口網站的操作。

149 149 

150提交需要付費的 claude.ai 方案。在 Pro 和 Max 上，您可以從自己的帳戶提交。在 Team 和 Enterprise 上，擁有者可以提交，在 Enterprise 上，擁有者也可以透過 **組織設定 > 角色** 下的自訂角色將 **目錄** 權限授予其他成員。請參閱 [確認您可以提交到目錄](https://claude.com/docs/directory/publish#confirm-you-can-submit-to-the-directory)。150Anthropic 的官方市集 `claude-plugins-official` 不透過目錄入口網站接受提交。如果您與 Anthropic 合作夥伴聯絡合作，請詢問他們有關官方市集列表。

151 151 

152提交步驟、每個版本必須通過的檢查，以及發佈後會發生什麼都記錄在 claude.com 上，因為無論您的使用者在哪個介面上，它們都是相同的：152若要提交外掛程式：

153 153 

154* [發佈到目錄](https://claude.com/docs/directory/publish#before-you-submit-to-the-directory)：您可以提交什麼以及誰可以提交154<Steps>

155* [提交外掛程式](https://claude.com/docs/plugins/submit#submit-a-plugin)：入口網站步驟和 [更新已發佈的外掛程式](https://claude.com/docs/plugins/submit#update-a-published-plugin)155 <Step title="確認您可以提交">

156* [外掛程式提交前檢查清單](https://claude.com/docs/plugins/pre-submission-checklist#run-the-checks-before-you-submit)：提交前要執行和修復的檢查156 提交需要付費的 claude.ai 方案。在 Pro 和 Max 上，您可以從自己的帳戶提交。在 Team 和 Enterprise 上，擁有者可以提交，在 Enterprise 上，擁有者也可以透過 **組織設定 > 角色** 下的自訂角色將 **目錄** 權限授予其他成員。請參閱 [確認您可以提交到目錄](https://claude.com/docs/directory/publish#confirm-you-can-submit-to-the-directory)。

157* [將較早的提交移至開發者入口網站](https://claude.com/docs/directory/publish#move-an-earlier-submission-to-the-developer-portal)：如果您透過較早的提交表單之一提交了外掛程式（在入口網站存在之前），該怎麼辦157 </Step>

158 158 

159在您開啟入口網站之前，在本機驗證並檢查您的哪些元件在 Claude Code 外載入：159 <Step title="在本機驗證外掛程式">

160 在您的 shell 中執行 `claude plugin validate ./your-plugin --strict`。用您的外掛程式目錄的路徑替換 `./your-plugin`。該命令在本機捕捉清單錯誤；[plugin validate](/docs/zh-TW/plugins/cli-reference#plugin-validate) 列出每次執行讀取的檔案。入口網站應用 CLI 不檢查的其他目錄規則，因此乾淨的本機執行不保證乾淨的入口網站驗證。

160 161 

161* **在您的 shell 中執行 `claude plugin validate ./your-plugin --strict`**：用您的外掛程式目錄的路徑替換 `./your-plugin`。該命令在本機捕捉清單錯誤；[plugin validate](/docs/zh-TW/plugins/cli-reference#plugin-validate) 列出每次執行讀取的檔案。入口網站應用 CLI 不檢查的其他目錄規則，因此乾淨的本機執行不保證乾淨的入口網站驗證。162 claude.com 上的[外掛程式提交前檢查清單](https://claude.com/docs/plugins/pre-submission-checklist#run-the-checks-before-you-submit)列出提交前要執行和修復的檢查。

162* **檢查在哪裡載入**：某些外掛程式元件僅限 Claude Code，不在 claude.ai 或 Cowork 中載入。[元件支援表](https://claude.com/docs/plugins/platform-support#compare-component-support-by-app) 按應用程式列出每個元件，因此您知道 Claude Code 外的使用者會得到什麼。163 </Step>

163 164 

164Anthropic 的官方市集 `claude-plugins-official` 不透過目錄入口網站接受提交。如果您與 Anthropic 合作夥伴聯絡合作，請詢問他們有關官方市集列表。165 <Step title="檢查在哪裡載入">

166 某些外掛程式元件僅限 Claude Code，不在 claude.ai 或 Cowork 中載入。[元件支援表](https://claude.com/docs/plugins/platform-support#compare-component-support-by-app) 按應用程式列出每個元件，因此您知道 Claude Code 外的使用者會得到什麼。

167 </Step>

168 

169 <Step title="在開發者入口網站中提交">

170 開啟開發者入口網站 [claude.ai/directory/manage](https://claude.ai/directory/manage)，並依照 claude.com 上的[提交外掛程式](https://claude.com/docs/plugins/submit#submit-a-plugin)操作。

171 </Step>

172</Steps>

173 

174流程的其餘部分記錄在 claude.com 上：

175 

176* [準備審查](https://claude.com/docs/directory/publish#prepare-for-review)：每個版本在發佈前會發生什麼

177* [更新已發佈的外掛程式](https://claude.com/docs/plugins/submit#update-a-published-plugin)：新版本如何送達已安裝您外掛程式的人

178* [提交您的外掛程式，以及將您的 MCP 伺服器作為連接器提交](https://claude.com/docs/directory/publish#submit-your-plugin-and-your-mcp-server-as-a-connector)：您可以提交什麼

179* [將較早的提交移至開發者入口網站](https://claude.com/docs/directory/publish#move-an-earlier-submission-to-the-developer-portal)：如果您透過較早的提交表單之一提交了外掛程式（在入口網站存在之前），該怎麼辦

165 180 

166<h3 id="how-a-listed-plugin-reaches-claude-code-users">181<h3 id="how-a-listed-plugin-reaches-claude-code-users">

167 列出的外掛程式如何觸及 Claude Code 使用者182 列出的外掛程式如何觸及 Claude Code 使用者

708| [`modelOverrides`](#modeloverrides) | [將模型 ID 對應](/docs/zh-TW/model-config#override-model-ids-per-version)到您提供者的 ID，例如 Bedrock ARN | 模型和回應 | Any file |708| [`modelOverrides`](#modeloverrides) | [將模型 ID 對應](/docs/zh-TW/model-config#override-model-ids-per-version)到您提供者的 ID，例如 Bedrock ARN | 模型和回應 | Any file |

709| [`modelPicker`](#modelpicker) | 選擇 [`/model` 選擇器](/docs/zh-TW/model-config#available-models)要列出的模型，並使用您自己的順序和標籤 | 模型和回應 | User or managed |709| [`modelPicker`](#modelpicker) | 選擇 [`/model` 選擇器](/docs/zh-TW/model-config#available-models)要列出的模型，並使用您自己的順序和標籤 | 模型和回應 | User or managed |

710| [`modelPricing`](#modelpricing) | 以您組織的合約費率而非定價報告支出 | 模型和回應 | Managed |710| [`modelPricing`](#modelpricing) | 以您組織的合約費率而非定價報告支出 | 模型和回應 | Managed |

711| [`modelSettings`](#modelsettings) | 為每個模型保留已儲存的 [effort 等級](/docs/zh-TW/model-config#adjust-effort-level)，或為單一模型設定 effort 上限 | 模型和回應 | Any file |711| [`modelSettings`](#modelsettings) | 為每個模型保留已儲存的 [effort 等級](/docs/zh-TW/model-config#adjust-effort-level)或[自動壓縮視窗](/docs/zh-TW/model-config#set-the-auto-compact-window)，或為單一模型設定 effort 上限 | 模型和回應 | Any file |

712| [`otelHeadersHelper`](#otelheadershelper) | 使用您自己的命令產生輪替的 [OpenTelemetry](/docs/zh-TW/monitoring-usage#dynamic-headers) 標頭 | 身分驗證和提供者 | Any file |712| [`otelHeadersHelper`](#otelheadershelper) | 使用您自己的命令產生輪替的 [OpenTelemetry](/docs/zh-TW/monitoring-usage#dynamic-headers) 標頭 | 身分驗證和提供者 | Any file |

713| [`outputStyle`](#outputstyle) | 使用[輸出風格](/docs/zh-TW/output-styles)變更 Claude 的角色、語調和輸出格式 | 模型和回應 | Any file |713| [`outputStyle`](#outputstyle) | 使用[輸出風格](/docs/zh-TW/output-styles)變更 Claude 的角色、語調和輸出格式 | 模型和回應 | Any file |

714| [`parentSettingsBehavior`](#parentsettingsbehavior) | 在您部署[受管設定](/docs/zh-TW/managed-settings)時，套用或捨棄 [SDK 或 IDE 主機](/docs/zh-TW/managed-settings#let-an-embedding-host-add-policy)傳遞的限制 | 企業和受管設定 | Managed |714| [`parentSettingsBehavior`](#parentsettingsbehavior) | 在您部署[受管設定](/docs/zh-TW/managed-settings)時，套用或捨棄 [SDK 或 IDE 主機](/docs/zh-TW/managed-settings#let-an-embedding-host-add-policy)傳遞的限制 | 企業和受管設定 | Managed |

1282要限制一個模型的努力而不是設定其級別，將 [`maxEffortLevel`](#maxeffortlevel) 欄位新增到該模型的項目。該欄位需要 Claude Code v2.1.267 或更新版本。1282要限制一個模型的努力而不是設定其級別，將 [`maxEffortLevel`](#maxeffortlevel) 欄位新增到該模型的項目。該欄位需要 Claude Code v2.1.267 或更新版本。

1283 1283 

1284* **範圍**: [`任何檔案`](#scopes)1284* **範圍**: [`任何檔案`](#scopes)

1285* **類型**: 將模型名稱對應到具有 `effortLevel` 欄位（其中之一 `"low"`、`"medium"`、`"high"` 或 `"xhigh"`）、[`maxEffortLevel`](#maxeffortlevel) 欄位或兩者的物件的物件1285* **類型**: 將模型名稱對應到物件的物件，該物件可包含下列任一欄位：

1286 * `effortLevel`: `"low"`、`"medium"`、`"high"` 或 `"xhigh"` 其中之一

1287 * [`maxEffortLevel`](#maxeffortlevel): 模型可執行的最高 effort 等級

1288 * `autoCompactWindow`: 介於 `100000` 到 `1000000` 的 token 數，或 `"auto"` 表示為該模型調校的視窗。[`/autocompact`](/docs/zh-TW/model-config#set-the-auto-compact-window) 會儲存於此。對於該模型，此值優先於同一設定檔中的頂層 [`autoCompactWindow`](#autocompactwindow)。需要 Claude Code v2.1.288 或更新版本

1286* **預設**: 未設定1289* **預設**: 未設定

1287 1290 

1288Claude Code 在模型的規範名稱下寫入每個項目，例如 `claude-opus-5-5`，並將該模型的別名、日期後綴、`[1m]` 和識別的提供者特定 ID 符合到同一項目。1291Claude Code 在模型的規範名稱下寫入每個項目，例如 `claude-opus-5-5`，並將該模型的別名、日期後綴、`[1m]` 和識別的提供者特定 ID 符合到同一項目。

2967}2970}

2968```2971```

2969 2972 

2970使用 [`/autocompact`](/docs/zh-TW/commands#all-commands) 命令設定它，該命令將此鍵寫入您的使用者設定。[設定自動壓縮視窗](/docs/zh-TW/model-config#set-the-auto-compact-window)涵蓋命令、旗標、變數和設定如何相互作用。2973[`/autocompact`](/docs/zh-TW/commands#all-commands) 命令會將目前模型的視窗保存在 [`modelSettings`](#modelsettings) 下，對於該模型，它優先於同一檔案中的此鍵。[設定自動壓縮視窗](/docs/zh-TW/model-config#set-the-auto-compact-window)涵蓋命令、旗標、變數和設定如何相互作用。

2971 2974 

2972<h3 id="automemorydirectory">2975<h3 id="automemorydirectory">

2973 `autoMemoryDirectory`2976 `autoMemoryDirectory`

45 <Tab title="原生安裝（建議）">45 <Tab title="原生安裝（建議）">

46 **macOS、Linux、WSL：**46 **macOS、Linux、WSL：**

47 47 

48 ```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}48 ```bash theme={null}

49 curl -fsSL https://claude.ai/install.sh | bash49 curl -fsSL https://claude.ai/install.sh | bash

50 ```50 ```

51 51 

52 **Windows PowerShell：**52 **Windows PowerShell：**

53 53 

54 ```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}54 ```powershell theme={null}

55 irm https://claude.ai/install.ps1 | iex55 irm https://claude.ai/install.ps1 | iex

56 ```56 ```

57 57 

58 **Windows CMD：**58 **Windows CMD：**

59 59 

60 ```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}60 ```batch theme={null}

61 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd61 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

62 ```62 ```

63 63 

75 </Tab>75 </Tab>

76 76 

77 <Tab title="Homebrew">77 <Tab title="Homebrew">

78 ```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}78 ```bash theme={null}

79 brew install --cask claude-code79 brew install --cask claude-code

80 ```80 ```

81 81 

87 </Tab>87 </Tab>

88 88 

89 <Tab title="WinGet">89 <Tab title="WinGet">

90 ```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}90 ```powershell theme={null}

91 winget install Anthropic.ClaudeCode91 winget install Anthropic.ClaudeCode

92 ```92 ```

93 93 

134| - | - | - |134| - | - | - |

135| Pro | 3 次免費執行 | 按 [額外使用量](https://support.claude.com/zh-TW/articles/12429409-extra-usage-for-paid-claude-plans) 計費 |135| Pro | 3 次免費執行 | 按 [額外使用量](https://support.claude.com/zh-TW/articles/12429409-extra-usage-for-paid-claude-plans) 計費 |

136| Max | 3 次免費執行 | 按 [額外使用量](https://support.claude.com/zh-TW/articles/12429409-extra-usage-for-paid-claude-plans) 計費 |136| Max | 3 次免費執行 | 按 [額外使用量](https://support.claude.com/zh-TW/articles/12429409-extra-usage-for-paid-claude-plans) 計費 |

137| Team 和 Enterprise | 無 | 按 [額外使用量](https://support.claude.com/zh-TW/articles/12429409-extra-usage-for-paid-claude-plans) 計費 |

138 137 

139* **免費執行次數**：Pro 和 Max 的三次執行是每個帳戶的一次性配額，不會刷新。138* **免費執行次數**：Pro 和 Max 的三次執行是每個帳戶的一次性配額，不會刷新。

140* **每次審查的成本**：使用完免費執行次數後，通常需要 $5 至 $25 的使用量額度，具體取決於變更的大小，與啟動對話框在每次執行前顯示的估計相符。139* **每次審查的成本**：使用完免費執行次數後，通常需要 $5 至 $25 的使用量額度，具體取決於變更的大小，與啟動對話框在每次執行前顯示的估計相符。

141* **何時計算執行次數**：一旦雲端工作階段開始。您提前停止或未能完成的審查仍會使用一次免費執行；付費審查僅針對執行的部分計費。140* **何時計算執行次數**：一旦雲端工作階段開始。您提前停止或未能完成的審查仍會使用一次免費執行；付費審查僅針對執行的部分計費。

142 141 

143由於 ultrareview 在免費執行次數外始終按使用量額度計費，您的帳戶或組織必須在啟動付費審查前啟用使用量額度。如果未啟用使用量額度，Claude Code 會阻止啟動，啟用方式取決於您的計費存取權限：142由於 ultrareview 在免費執行次數外始終按用量點數計費，您的帳戶或組織必須在啟動付費審查前啟用用量點數。如果未啟用用量點數，Claude Code 會阻止啟動。如果您可以管理帳戶的計費，Claude Code 會將您連結到計費設定，您可以在那裡開啟用量點數。

144 

145* 如果您可以管理帳戶的計費，Claude Code 會將您連結到計費設定，您可以在那裡開啟使用量額度。

146* 在 Team 和 Enterprise 計畫上，沒有計費存取權限的成員可以從 CLI 傳送請求，要求其管理員開啟使用量額度。

147 143 

148您也可以執行 `/usage-credits` 來檢查或變更您的使用量額度設定。144您也可以執行 `/usage-credits` 來檢查或變更您的使用量額度設定。

149 145