Documentation 2026-09-23 23:57 UTC to 2026-09-24 22:57 UTC

401 401 

402這些背景程序即使沒有主動互動也會消耗少量 token（通常每個工作階段不到 \$0.04）。402這些背景程序即使沒有主動互動也會消耗少量 token（通常每個工作階段不到 \$0.04）。

403 403 

404當啟用提示建議時，Claude Code 也會在 Claude 回應後向您的工作階段使用的模型發送簡短請求，以[建議您的下一個提示](/docs/zh-TW/interactive-mode#prompt-suggestions)。該請求會重複使用對話的提示快取，因此主要是快取讀取加上少數輸出 token。Claude Code [在您的帳戶接近或達到使用限制時會跳過此功能](/docs/zh-TW/interactive-mode#when-claude-code-skips-suggestions)。若要停止這些請求，[請關閉提示建議](/docs/zh-TW/interactive-mode#turn-prompt-suggestions-off)。

405 

404<h2 id="why-usage-climbs-in-a-long-session">406<h2 id="why-usage-climbs-in-a-long-session">

405 為什麼長時間工作階段中的使用量會增加407 為什麼長時間工作階段中的使用量會增加

406</h2>408</h2>

224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | 設定 [自動壓縮視窗](/docs/zh-TW/model-config#set-the-auto-compact-window)（權杖），從 `100000` 到 `1000000`。僅接受純整數（如 `500000`）：像 `500k` 這樣的值讀作 `500` 並限制在 100K 最小值。有效視窗也上限為模型的上下文視窗。優先於 `/autocompact` 命令、`--autocompact` 旗標和 `autoCompactWindow` 設定。狀態列的 `used_percentage` 始終針對模型的完整上下文視窗進行測量，因此一旦設定此變數，該百分比不再指示何時會執行壓縮 |224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | 設定 [自動壓縮視窗](/docs/zh-TW/model-config#set-the-auto-compact-window)（權杖），從 `100000` 到 `1000000`。僅接受純整數（如 `500000`）：像 `500k` 這樣的值讀作 `500` 並限制在 100K 最小值。有效視窗也上限為模型的上下文視窗。優先於 `/autocompact` 命令、`--autocompact` 旗標和 `autoCompactWindow` 設定。狀態列的 `used_percentage` 始終針對模型的完整上下文視窗進行測量，因此一旦設定此變數，該百分比不再指示何時會執行壓縮 |

225| `CLAUDE_CODE_AUTO_CONNECT_IDE` | 覆蓋自動 [IDE 連線](/docs/zh-TW/vs-code)。預設情況下，在支援的 IDE 的整合終端內啟動時，Claude Code 會自動連線。設定為 `false` 以防止此情況。設定為 `true` 以在自動偵測失敗時強制連線嘗試，例如當 tmux 隱藏父終端時。優先於 [`autoConnectIde`](/docs/zh-TW/settings-reference#autoconnectide) 全域配置設定 |225| `CLAUDE_CODE_AUTO_CONNECT_IDE` | 覆蓋自動 [IDE 連線](/docs/zh-TW/vs-code)。預設情況下，在支援的 IDE 的整合終端內啟動時，Claude Code 會自動連線。設定為 `false` 以防止此情況。設定為 `true` 以在自動偵測失敗時強制連線嘗試，例如當 tmux 隱藏父終端時。優先於 [`autoConnectIde`](/docs/zh-TW/settings-reference#autoconnectide) 全域配置設定 |

226| `CLAUDE_CODE_AUTO_MODE_SERVER` | 控制 Claude Code 是否要求伺服器 [檢查自動模式動作](/docs/zh-TW/permission-modes#server-side-classifier-review)。未設定時，Claude Code 在 Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry 和 Claude Platform on AWS 上要求伺服器，以及當您指向 `ANTHROPIC_BASE_URL` 至 LLM 閘道或代理時。設定為 `0` 以改用 Claude Code 自己的分類器請求。不在直接連線到 Anthropic API 時讀取。需要 Claude Code v2.1.271 或更新版本；預設要求伺服器需要 v2.1.278 或更新版本 |226| `CLAUDE_CODE_AUTO_MODE_SERVER` | 控制 Claude Code 是否要求伺服器 [檢查自動模式動作](/docs/zh-TW/permission-modes#server-side-classifier-review)。未設定時，Claude Code 在 Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry 和 Claude Platform on AWS 上要求伺服器，以及當您指向 `ANTHROPIC_BASE_URL` 至 LLM 閘道或代理時。設定為 `0` 以改用 Claude Code 自己的分類器請求。不在直接連線到 Anthropic API 時讀取。需要 Claude Code v2.1.271 或更新版本；預設要求伺服器需要 v2.1.278 或更新版本 |

227| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | 時間（毫秒）Claude Code 等待 AWS 預設認證提供者鏈產生認證，然後請求失敗，並出現 [`AWS default-chain credential resolve timed out`](/docs/zh-TW/errors#aws-default-chain-credential-resolve-timed-out)（預設：`60000`）。當鏈中的步驟合法需要更長時間時提高此值，例如透過 `aws-vault` 等包裝器進行基於瀏覽器的 SSO 登入（帶 MFA）。適用於 Claude Code 使用預設鏈簽署的任何地方：[Amazon Bedrock](/docs/zh-TW/amazon-bedrock#credential-caching-and-resolution-timeout)、[Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws) 和 [Mantle 端點](/docs/zh-TW/amazon-bedrock#use-the-mantle-endpoint)。需要 Claude Code v2.1.207 或更新版本 |227| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Claude Code 等待 AWS 預設認證提供者鏈產生認證的時間（毫秒），然後請求失敗，並出現 [`AWS default-chain credential resolve timed out`](/docs/zh-TW/errors#aws-default-chain-credential-resolve-timed-out)（預設：`60000`）。當鏈中的步驟合法需要更長時間時提高此值，例如透過 `aws-vault` 等包裝器進行基於瀏覽器的 SSO 登入（帶 MFA）。適用於 Claude Code 使用預設鏈簽署的任何地方：[Amazon Bedrock](/docs/zh-TW/amazon-bedrock#credential-caching-and-resolution-timeout)、[Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws) 和 [Mantle 端點](/docs/zh-TW/amazon-bedrock#use-the-mantle-endpoint)。需要 Claude Code v2.1.207 或更新版本 |

228| `CLAUDE_CODE_BASH_EDIT_DIFF` | 設定為 `0` 以關閉 [Bash 命令變更的檔案差異](/docs/zh-TW/hooks#bash)，或設定為 `1` 以在每個權限模式中記錄。優先於 [`bashEditDiffEnabled`](/docs/zh-TW/settings-reference#basheditdiffenabled) 設定。需要 Claude Code v2.1.269 或更新版本 |228| `CLAUDE_CODE_BASH_EDIT_DIFF` | 設定為 `0` 以關閉 [Bash 命令變更的檔案差異](/docs/zh-TW/hooks#bash)，或設定為 `1` 以在每個權限模式中記錄。優先於 [`bashEditDiffEnabled`](/docs/zh-TW/settings-reference#basheditdiffenabled) 設定。需要 Claude Code v2.1.269 或更新版本 |

229| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | 設定為 `0` 以使非互動工作階段在每個轉結束時向其主機報告閒置狀態，即使背景工作仍在執行。預設情況下，工作階段在背景工作（例如背景代理或 [工作流程](/docs/zh-TW/workflows) 執行）仍在進行時，保持在轉結束後報告執行狀態。這可防止監視狀態的主機（例如遠端工作階段清單）在工作中途宣佈 Claude 正在等待您的輸入。背景 shell 命令（例如開發伺服器）不保持執行狀態。執行狀態預設和 `0` 選擇退出需要 Claude Code v2.1.269 或更新版本；在較早版本上，設定 `1` 以保持執行狀態 |229| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | 設定為 `0` 以使非互動工作階段在每個轉結束時向其主機報告閒置狀態，即使背景工作仍在執行。預設情況下，工作階段在背景工作（例如背景代理或 [工作流程](/docs/zh-TW/workflows) 執行）仍在進行時，保持在轉結束後報告執行狀態。這可防止監視狀態的主機（例如遠端工作階段清單）在工作中途宣佈 Claude 正在等待您的輸入。背景 shell 命令（例如開發伺服器）不保持執行狀態。執行狀態預設和 `0` 選擇退出需要 Claude Code v2.1.269 或更新版本；在較早版本上，設定 `1` 以保持執行狀態 |

230| `CLAUDE_CODE_BRIDGE_SESSION_ID` | 在工作階段有活躍 [Remote Control](/docs/zh-TW/remote-control) 連線時，在 Bash 工具和 [hook 命令](/docs/zh-TW/hooks) 子程序中自動設定，連線結束時移除。值是工作階段在 `session_` 形式中的 ID，與出現在工作階段 `claude.ai/code` URL 中的識別碼相同，因此指令碼可以連結回執行它的工作階段。需要 Claude Code v2.1.199 或更新版本。在 [雲工作階段](/docs/zh-TW/claude-code-on-the-web) 中，改為讀取 `CLAUDE_CODE_REMOTE_SESSION_ID` |230| `CLAUDE_CODE_BRIDGE_SESSION_ID` | 在工作階段有活躍 [Remote Control](/docs/zh-TW/remote-control) 連線時，在 Bash 工具和 [hook 命令](/docs/zh-TW/hooks) 子程序中自動設定，連線結束時移除。值是工作階段在 `session_` 形式中的 ID，與出現在工作階段 `claude.ai/code` URL 中的識別碼相同，因此指令碼可以連結回執行它的工作階段。需要 Claude Code v2.1.199 或更新版本。在 [雲工作階段](/docs/zh-TW/claude-code-on-the-web) 中，改為讀取 `CLAUDE_CODE_REMOTE_SESSION_ID` |

272| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | 設定為 `1` 以停止 Claude Code 在 Claude Desktop 和 VS Code 擴充功能主機 Claude Code 的工作階段中為未回答的權限請求執行您的 [`Notification` hooks](/docs/zh-TW/hooks#notification)，這是 Claude Code 將它們傳送到 Agent SDK 的 `canUseTool` 回呼的方式。在終端工作階段中無效。需要 Claude Code v2.1.233 或更新版本 |272| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | 設定為 `1` 以停止 Claude Code 在 Claude Desktop 和 VS Code 擴充功能主機 Claude Code 的工作階段中為未回答的權限請求執行您的 [`Notification` hooks](/docs/zh-TW/hooks#notification)，這是 Claude Code 將它們傳送到 Agent SDK 的 `canUseTool` 回呼的方式。在終端工作階段中無效。需要 Claude Code v2.1.233 或更新版本 |

273| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | 設定為 `1` 以跳過從系統範圍受管 skills 目錄載入 skills。對於不應載入操作員佈建 skills 的容器或 CI 工作階段很有用 |273| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | 設定為 `1` 以跳過從系統範圍受管 skills 目錄載入 skills。對於不應載入操作員佈建 skills 的容器或 CI 工作階段很有用 |

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

275| `CLAUDE_CODE_DISABLE_THINKING` | 設定為 `1` 以從 API 請求中完全省略 `thinking` 參數。這是代理和閘道拒絕參數的相容性選項。在預設思考的模型上，省略參數意味著模型仍可能思考。若要在 Anthropic API 上明確停用 [擴展思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)，請改用 `MAX_THINKING_TOKENS=0`。兩個變數都不會在 Fable 模型上關閉思考，Fable 模型無法關閉思考。在 [第三方提供者](/docs/zh-TW/third-party-integrations) 上，`MAX_THINKING_TOKENS=0` 同樣省略參數，因此兩個變數在那裡的行為相同 |275| `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 或 Fable 模型上關閉思考，這些模型無法關閉思考。在 [第三方提供者](/docs/zh-TW/third-party-integrations) 上，`MAX_THINKING_TOKENS=0` 同樣省略參數，因此兩個變數在那裡的行為相同 |

276| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | 設定為 `1` 以在 Claude Code 不識別模型 ID（例如 [LLM 閘道](/docs/zh-TW/llm-gateway) 別名）時跳過主動 [自動壓縮](/docs/zh-TW/costs#reduce-token-usage)。沒有此變數，Claude Code 在它為 ID 假設的上下文視窗進行壓縮。`CLAUDE_CODE_MAX_CONTEXT_TOKENS` 可以改為更正假設的視窗；請參閱 [為閘道或自訂模型 ID 更正視窗](/docs/zh-TW/model-config#correct-the-window-for-a-gateway-or-custom-model-id) 以了解何時應用每個變數。需要 Claude Code v2.1.223 或更新版本 |276| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | 設定為 `1` 以在 Claude Code 不識別模型 ID（例如 [LLM 閘道](/docs/zh-TW/llm-gateway) 別名）時跳過主動 [自動壓縮](/docs/zh-TW/costs#reduce-token-usage)。沒有此變數，Claude Code 在它為 ID 假設的上下文視窗進行壓縮。`CLAUDE_CODE_MAX_CONTEXT_TOKENS` 可以改為更正假設的視窗；請參閱 [為閘道或自訂模型 ID 更正視窗](/docs/zh-TW/model-config#correct-the-window-for-a-gateway-or-custom-model-id) 以了解何時應用每個變數。需要 Claude Code v2.1.223 或更新版本 |

277| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | 設定為 `1` 以停用 [全螢幕呈現](/docs/zh-TW/fullscreen) 中的虛擬捲軸並呈現文字記錄中的每條訊息。如果全螢幕模式中的捲軸顯示應該出現訊息的空白區域，請使用此選項 |277| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | 設定為 `1` 以停用 [全螢幕呈現](/docs/zh-TW/fullscreen) 中的虛擬捲軸並呈現文字記錄中的每條訊息。如果全螢幕模式中的捲軸顯示應該出現訊息的空白區域，請使用此選項 |

278| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | 設定為 `1` 以在 Windows 上直接啟動 [PowerShell 工具](/docs/zh-TW/tools-reference#powershell-tool) 命令，而不是透過 `cmd.exe` 啟動器。預設情況下，啟動器讓在背景執行的 PowerShell 命令 [進行到工作階段的下一個程序](/docs/zh-TW/agent-view#the-supervisor-process)，例如當您 [背景化工作階段](/docs/zh-TW/agent-view#from-inside-a-session) 時。如果您設定變數，背景化的 PowerShell 命令在工作階段的程序退出時停止。Bash 命令不受影響。需要 Claude Code v2.1.269 或更新版本 |278| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | 設定為 `1` 以在 Windows 上直接啟動 [PowerShell 工具](/docs/zh-TW/tools-reference#powershell-tool) 命令，而不是透過 `cmd.exe` 啟動器。預設情況下，啟動器讓在背景執行的 PowerShell 命令 [進行到工作階段的下一個程序](/docs/zh-TW/agent-view#the-supervisor-process)，例如當您 [背景化工作階段](/docs/zh-TW/agent-view#from-inside-a-session) 時。如果您設定變數，背景化的 PowerShell 命令在工作階段的程序退出時停止。Bash 命令不受影響。需要 Claude Code v2.1.269 或更新版本 |

461| `IS_DEMO` | 設定為任何非空值（例如 `1`）以啟用演示模式：從標頭和 `/status` 輸出隱藏您的電子郵件和組織名稱，並跳過入門。**將其設定為 `0` 或 `false` 仍會啟用演示模式**，與大多數開啟/關閉變數不同；取消設定變數以關閉它。在串流或錄製工作階段時很有用 |461| `IS_DEMO` | 設定為任何非空值（例如 `1`）以啟用演示模式：從標頭和 `/status` 輸出隱藏您的電子郵件和組織名稱，並跳過入門。**將其設定為 `0` 或 `false` 仍會啟用演示模式**，與大多數開啟/關閉變數不同；取消設定變數以關閉它。在串流或錄製工作階段時很有用 |

462| `MAX_MCP_OUTPUT_TOKENS` | MCP 工具回應中允許的最大權杖數。Claude Code 在輸出超過 10,000 權杖時顯示警告。聲明 [`anthropic/maxResultSizeChars`](/docs/zh-TW/mcp#raise-the-limit-for-a-specific-tool) 的工具改為對文字內容使用該字元限制，但來自這些工具的影像內容仍受此變數約束（預設：25000） |462| `MAX_MCP_OUTPUT_TOKENS` | MCP 工具回應中允許的最大權杖數。Claude Code 在輸出超過 10,000 權杖時顯示警告。聲明 [`anthropic/maxResultSizeChars`](/docs/zh-TW/mcp#raise-the-limit-for-a-specific-tool) 的工具改為對文字內容使用該字元限制，但來自這些工具的影像內容仍受此變數約束（預設：25000） |

463| `MAX_STRUCTURED_OUTPUT_RETRIES` | 當模型的回應無法驗證 [`--json-schema`](/docs/zh-TW/cli-reference#cli-flags) 時，Claude Code 在非互動模式下使用 `-p` 旗標允許的嘗試次數；在那麼多次失敗嘗試後沒有有效輸出，執行失敗。當 [工作流程](/docs/zh-TW/workflows) 子代理的結構化輸出無法驗證時，相同的上限適用。預設為 5，第一次嘗試加四次重試 |463| `MAX_STRUCTURED_OUTPUT_RETRIES` | 當模型的回應無法驗證 [`--json-schema`](/docs/zh-TW/cli-reference#cli-flags) 時，Claude Code 在非互動模式下使用 `-p` 旗標允許的嘗試次數；在那麼多次失敗嘗試後沒有有效輸出，執行失敗。當 [工作流程](/docs/zh-TW/workflows) 子代理的結構化輸出無法驗證時，相同的上限適用。預設為 5，第一次嘗試加四次重試 |

464| `MAX_THINKING_TOKENS` | [擴展思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) 的固定權杖預算。Claude Code 將其上限設定為請求最大輸出權杖下方一個權杖，永遠不低於 1,024。請參閱 `CLAUDE_CODE_MAX_OUTPUT_TOKENS` 以了解該限制如何設定。未設定且思考啟用時，具有 [自適應推理](/docs/zh-TW/model-config#adjust-effort-level) 的模型選擇自己的思考深度，其他模型使用上限。設定為 `0` 以在 Anthropic API 上停用思考，除了 Fable 模型，無法關閉思考。在 [第三方提供者](/docs/zh-TW/third-party-integrations) 上，`0` 改為省略 `thinking` 參數。在 Anthropic API 上關閉思考時，Claude Code 向它知道 [不接受該組合](/docs/zh-TW/errors#effort-isnt-available-with-thinking-turned-off) 的模型（例如 Opus 5）傳送 effort `high` 而不是更高級別。Claude Code 在自適應推理模型上忽略非零值，除了 `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` 關閉自適應推理的模型 |464| `MAX_THINKING_TOKENS` | [擴展思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) 的固定權杖預算。Claude Code 將其上限設定為請求最大輸出權杖下方一個權杖，永遠不低於 1,024。請參閱 `CLAUDE_CODE_MAX_OUTPUT_TOKENS` 以了解該限制如何設定。未設定且思考啟用時，具有 [自適應推理](/docs/zh-TW/model-config#adjust-effort-level) 的模型選擇自己的思考深度，其他模型使用上限。設定為 `0` 以在 Anthropic API 上停用思考，但 Opus 5.5 和 Fable 模型除外，這些模型無法關閉思考。在 [第三方提供者](/docs/zh-TW/third-party-integrations) 上，`0` 改為省略 `thinking` 參數。在 Anthropic API 上關閉思考時，Claude Code 向它知道 [不接受該組合](/docs/zh-TW/errors#effort-isnt-available-with-thinking-turned-off) 的模型（例如 Opus 5）傳送 effort `high` 而不是更高級別。Claude Code 在自適應推理模型上忽略非零值，除了 `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` 關閉自適應推理的模型 |

465| `MCP_CLIENT_SECRET` | 需要 [預先配置認證](/docs/zh-TW/mcp#use-pre-configured-oauth-credentials) 的 MCP 伺服器的 OAuth 用戶端機密。在使用 `--client-secret` 新增伺服器時避免互動提示 |465| `MCP_CLIENT_SECRET` | 需要 [預先配置認證](/docs/zh-TW/mcp#use-pre-configured-oauth-credentials) 的 MCP 伺服器的 OAuth 用戶端機密。在使用 `--client-secret` 新增伺服器時避免互動提示 |

466| `MCP_CONNECTION_NONBLOCKING` | 控制啟動是否在第一個查詢前等待 MCP 伺服器連線。MCP 啟動預設非阻塞：伺服器在背景連線，其工具在完成時變為可用。設定為 `0` 以使 Claude Code 在第一個查詢前等待伺服器連線。配置 [`alwaysLoad: true`](/docs/zh-TW/mcp#exempt-a-server-from-deferral) 的伺服器仍使啟動等待，除非從 [發現快取](/docs/zh-TW/mcp#server-status-detail) 提供，因為它們的工具必須在建立第一個提示時存在。在非互動模式 (`-p`) 中，Claude Code 也在第一個轉前等待仍待處理的伺服器，無論此變數如何，當您明確傳遞 [`--mcp-config`](/docs/zh-TW/cli-reference#cli-flags) 時有更長的期限；請參閱該旗標的項目以了解快取伺服器例外 |466| `MCP_CONNECTION_NONBLOCKING` | 控制啟動是否在第一個查詢前等待 MCP 伺服器連線。MCP 啟動預設非阻塞：伺服器在背景連線，其工具在完成時變為可用。設定為 `0` 以使 Claude Code 在第一個查詢前等待伺服器連線。配置 [`alwaysLoad: true`](/docs/zh-TW/mcp#exempt-a-server-from-deferral) 的伺服器仍使啟動等待，除非從 [發現快取](/docs/zh-TW/mcp#server-status-detail) 提供，因為它們的工具必須在建立第一個提示時存在。在非互動模式 (`-p`) 中，Claude Code 也在第一個轉前等待仍待處理的伺服器，無論此變數如何，當您明確傳遞 [`--mcp-config`](/docs/zh-TW/cli-reference#cli-flags) 時有更長的期限；請參閱該旗標的項目以了解快取伺服器例外 |

467| `MCP_CONNECT_TIMEOUT_MS` | 阻塞 MCP 啟動在快照工具清單前等待連線批次的時間（毫秒）（預設：5000）。當 `MCP_CONNECTION_NONBLOCKING=0` 或伺服器標記 [`alwaysLoad: true`](/docs/zh-TW/mcp#exempt-a-server-from-deferral) 時適用。仍待處理的伺服器在期限後繼續在背景連線 |467| `MCP_CONNECT_TIMEOUT_MS` | 阻塞 MCP 啟動在快照工具清單前等待連線批次的時間（毫秒）（預設：5000）。當 `MCP_CONNECTION_NONBLOCKING=0` 或伺服器標記 [`alwaysLoad: true`](/docs/zh-TW/mcp#exempt-a-server-from-deferral) 時適用。仍待處理的伺服器在期限後繼續在背景連線 |

470| `MCP_DISCOVERY_CACHE_STRIKES` | 在 [發現快取](/docs/zh-TW/mcp#server-status-detail) 項目比 `MCP_DISCOVERY_CACHE_TTL_S` 更舊的啟動時，Claude Code 在背景刷新它。此變數設定在 Claude Code 丟棄項目並在下一次啟動時連線伺服器前，刷新可以連續失敗多少次（預設：1）。如果您的網路連線偶爾掉線，請提高它，以便一次失敗的刷新不會丟棄項目。需要 Claude Code v2.1.238 或更新版本 |470| `MCP_DISCOVERY_CACHE_STRIKES` | 在 [發現快取](/docs/zh-TW/mcp#server-status-detail) 項目比 `MCP_DISCOVERY_CACHE_TTL_S` 更舊的啟動時，Claude Code 在背景刷新它。此變數設定在 Claude Code 丟棄項目並在下一次啟動時連線伺服器前，刷新可以連續失敗多少次（預設：1）。如果您的網路連線偶爾掉線，請提高它，以便一次失敗的刷新不會丟棄項目。需要 Claude Code v2.1.238 或更新版本 |

471| `MCP_DISCOVERY_CACHE_TTL_S` | Claude Code 使用 [發現快取](/docs/zh-TW/mcp#server-status-detail) 項目而不刷新它的秒數（預設：900）。在項目比該年齡更舊的啟動時，Claude Code 仍使用它但在背景刷新它。一旦項目比 `MCP_DISCOVERY_CACHE_MAX_STALE_S` 更舊，Claude Code 改為丟棄它。Claude Code 將值上限為 `MCP_DISCOVERY_CACHE_MAX_STALE_S`，預設為 4 小時。在 v2.1.238 之前，Claude Code 未上限值 |471| `MCP_DISCOVERY_CACHE_TTL_S` | Claude Code 使用 [發現快取](/docs/zh-TW/mcp#server-status-detail) 項目而不刷新它的秒數（預設：900）。在項目比該年齡更舊的啟動時，Claude Code 仍使用它但在背景刷新它。一旦項目比 `MCP_DISCOVERY_CACHE_MAX_STALE_S` 更舊，Claude Code 改為丟棄它。Claude Code 將值上限為 `MCP_DISCOVERY_CACHE_MAX_STALE_S`，預設為 4 小時。在 v2.1.238 之前，Claude Code 未上限值 |

472| `MCP_OAUTH_CALLBACK_PORT` | OAuth 重新導向回呼的固定埠，作為使用 [預先配置認證](/docs/zh-TW/mcp#use-pre-configured-oauth-credentials) 新增 MCP 伺服器時 `--callback-port` 的替代方案 |472| `MCP_OAUTH_CALLBACK_PORT` | OAuth 重新導向回呼的固定埠，作為使用 [預先配置認證](/docs/zh-TW/mcp#use-pre-configured-oauth-credentials) 新增 MCP 伺服器時 `--callback-port` 的替代方案 |

473| `MCP_PROTOCOL_NEGOTIATION` | 在 [v2 MCP 用戶端執行時](/docs/zh-TW/mcp#mcp-client-runtimes) 上，Claude Code 是否探測伺服器以了解 MCP 協議修訂 2026-07-28。設定 `auto` 以探測 HTTP、claude.ai 連接器和 stdio 伺服器；不回答探測的伺服器在較早的協議上連線，SSE 和 WebSocket 伺服器始終這樣做。設定 `legacy` 以跳過每個伺服器的探測。沒有變數，Claude Code 在 Claude Code v2.1.232 或更新版本上探測 HTTP 和 claude.ai 連接器伺服器，除了 [MCP 用戶端執行時](/docs/zh-TW/mcp#mcp-client-runtimes) 部分列出的例外。任何其他值被忽略，並在偵錯日誌中出現警告。需要 Claude Code v2.1.221 或更新版本 |473| `MCP_PROTOCOL_NEGOTIATION` | 在 [v2 MCP 用戶端執行時](/docs/zh-TW/mcp#mcp-client-runtimes) 上，Claude Code 是否探測伺服器以了解 MCP 協議修訂 2026-07-28。設定 `auto` 以探測 HTTP、claude.ai 連接器和 stdio 伺服器；不回答探測的伺服器在較早的協議上連線，SSE 和 WebSocket 伺服器始終這樣做。設定 `legacy` 以跳過每個伺服器的探測。沒有變數，Claude Code 探測 HTTP 伺服器，並且在其 [擷取功能旗標](#features-that-need-feature-flag-fetching) 的工作階段中也探測 claude.ai 連接器伺服器。任何其他值被忽略，並在偵錯日誌中出現警告。需要 Claude Code v2.1.221 或更新版本 |

474| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | 在啟動期間並行連線的遠端 MCP 伺服器（HTTP/SSE）的最大數量（預設：20） |474| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | 在啟動期間並行連線的遠端 MCP 伺服器（HTTP/SSE）的最大數量（預設：20） |

475| `MCP_SDK_GENERATION` | 釘選此程序連線 MCP 伺服器的 [MCP 用戶端執行時](/docs/zh-TW/mcp#mcp-client-runtimes)：`v1`，建立在 MCP TypeScript SDK 1.x 上，或 `v2`，建立在 [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/) 上。沒有變數，Claude Code 在 Claude Code v2.1.232 或更新版本上使用 v2，除了該部分說明它使用 v1 的地方。在 Claude Code v2.1.221 或更新版本上，v2 執行時檢查 MCP OAuth 伺服器在其授權回應中返回的簽發者，並在不符合時失敗登入，並出現以 `Issuer mismatch in authorization response` 開頭的錯誤。v1 執行時不執行此檢查。如果您設定無法識別的值，Claude Code 會忽略它並在偵錯日誌中寫入警告。Claude Code 每個程序讀取值一次。需要 Claude Code v2.1.218 或更新版本 |475| `MCP_SDK_GENERATION` | 釘選此程序連線 MCP 伺服器的 [MCP 用戶端執行時](/docs/zh-TW/mcp#mcp-client-runtimes)：`v1`，建立在 MCP TypeScript SDK 1.x 上，或 `v2`，建立在 [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/) 上。沒有變數，Claude Code 使用 v2，從該部分列出的版本開始。在 Claude Code v2.1.221 或更新版本上，v2 執行時檢查 MCP OAuth 伺服器在其授權回應中返回的簽發者，並在不符合時失敗登入，並出現以 `Issuer mismatch in authorization response` 開頭的錯誤。v1 執行時不執行此檢查。如果您設定無法識別的值，Claude Code 會忽略它並在偵錯日誌中寫入警告。Claude Code 每個程序讀取值一次。需要 Claude Code v2.1.218 或更新版本 |

476| `MCP_SERVER_CONNECTION_BATCH_SIZE` | 在啟動期間並行連線的本機 MCP 伺服器（stdio）的最大數量（預設：3） |476| `MCP_SERVER_CONNECTION_BATCH_SIZE` | 在啟動期間並行連線的本機 MCP 伺服器（stdio）的最大數量（預設：3） |

477| `MCP_TIMEOUT` | MCP 伺服器啟動的逾時（毫秒）（預設：30000，或 30 秒） |477| `MCP_TIMEOUT` | MCP 伺服器啟動的逾時（毫秒）（預設：30000，或 30 秒） |

478| `MCP_TOOL_TIMEOUT` | MCP 工具執行的逾時（毫秒）（預設：100000000，約 28 小時）。對於 HTTP、SSE 或 claude.ai 連接器伺服器，每個請求也預設在 60 秒後逾時；將此變數或每個伺服器 `timeout` 設定為 60000 以上以提高該每個請求限制。較低的值仍會縮短整體工具執行逾時，但保持每個請求限制為 60 秒。Stdio 和 WebSocket 伺服器沒有每個請求計時器。`.mcp.json` 中的每個伺服器 `timeout` 欄位覆蓋此項用於該伺服器。至少 1000 的每個伺服器 `timeout` 也為該伺服器的工具呼叫設定最小閒置視窗，因此 `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` 永遠不會更早中止它們；此下限需要 Claude Code v2.1.203 或更新版本。對於 env 變數，低於 1000 的值下限為一秒；對於每個伺服器欄位，低於 1000 的值被忽略 |478| `MCP_TOOL_TIMEOUT` | MCP 工具執行的逾時（毫秒）（預設：100000000，約 28 小時）。對於 HTTP、SSE 或 claude.ai 連接器伺服器，每個請求也預設在 60 秒後逾時；將此變數或每個伺服器 `timeout` 設定為 60000 以上以提高該每個請求限制。較低的值仍會縮短整體工具執行逾時，但保持每個請求限制為 60 秒。Stdio 和 WebSocket 伺服器沒有每個請求計時器。`.mcp.json` 中的每個伺服器 `timeout` 欄位覆蓋此項用於該伺服器。至少 1000 的每個伺服器 `timeout` 也為該伺服器的工具呼叫設定最小閒置視窗，因此 `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` 永遠不會更早中止它們；此下限需要 Claude Code v2.1.203 或更新版本。對於 env 變數，低於 1000 的值下限為一秒；對於每個伺服器欄位，低於 1000 的值被忽略 |

439* 按 `Tab` 或 `Right arrow` 將建議放入提示輸入中，然後按 `Enter` 提交439* 按 `Tab` 或 `Right arrow` 將建議放入提示輸入中，然後按 `Enter` 提交

440* 開始輸入以關閉它440* 開始輸入以關閉它

441 441 

442Claude Code 使用背景請求產生每個這些下一個提示建議，該請求會重複使用對話的提示快取，因此額外成本最少。442Claude Code 使用背景請求產生每個這些下一個提示建議，該請求會計入您方案的使用限制或您的 API 成本。因為它會重複使用對話的提示快取，所以主要是快取讀取加上少數輸出權杖，因此額外成本最少。

443 443 

444<h3 id="when-claude-code-skips-suggestions">444<h3 id="when-claude-code-skips-suggestions">

445 當 Claude Code 跳過建議時445 當 Claude Code 跳過建議時

95 * **在完整 VM 沙箱中**：當您的 Claude Desktop 受管設定將 [`requireCoworkFullVmSandbox`](https://claude.com/docs/third-party/claude-desktop/configuration#requirecoworkfullvmsandbox) 設定時，Claude Code 在虛擬機器內執行，其中裝置的 MDM 原則和受管設定檔案不存在。95 * **在完整 VM 沙箱中**：當您的 Claude Desktop 受管設定將 [`requireCoworkFullVmSandbox`](https://claude.com/docs/third-party/claude-desktop/configuration#requirecoworkfullvmsandbox) 設定時，Claude Code 在虛擬機器內執行，其中裝置的 MDM 原則和受管設定檔案不存在。

96 * **遠端共同工作工作階段**：這些在 Anthropic 受管 VM 上執行，其中 Claude Code 沒有裝置原則可讀取。96 * **遠端共同工作工作階段**：這些在 Anthropic 受管 VM 上執行，其中 Claude Code 沒有裝置原則可讀取。

97 97 

98 [表面涵蓋](/docs/zh-TW/model-config#surface-coverage)表比較共同工作與其他表面。98 無論工作階段在何處執行，claude.ai 在任何人從 claude.ai 上的 git 儲存庫或從 Cowork 標籤中的**自訂**新增市集時，會自行應用管理主控台的 [`strictKnownMarketplaces`](/docs/zh-TW/settings-reference#strictknownmarketplaces) 和 [`blockedMarketplaces`](/docs/zh-TW/settings-reference#blockedmarketplaces) 列表。[限制如何運作](/docs/zh-TW/plugin-marketplaces#how-restrictions-work)描述該檢查。[表面涵蓋](/docs/zh-TW/model-config#surface-coverage)表比較共同工作與其他表面。

99* **執行中的工作階段**：大多數變更在[傳遞機制表](#choose-a-delivery-mechanism)中的排程上到達執行中的工作階段，無需重新啟動。99* **執行中的工作階段**：大多數變更在[傳遞機制表](#choose-a-delivery-mechanism)中的排程上到達執行中的工作階段，無需重新啟動。

100 * 對 [`forceRemoteSettingsRefresh`](/docs/zh-TW/settings-reference#forceremotesettingsrefresh)、[`requiredMinimumVersion`](/docs/zh-TW/settings-reference#requiredminimumversion) 和[某些使用者可編輯的金鑰](/docs/zh-TW/settings#when-edits-take-effect)的變更在下一個工作階段啟動時生效。100 * 對 [`forceRemoteSettingsRefresh`](/docs/zh-TW/settings-reference#forceremotesettingsrefresh)、[`requiredMinimumVersion`](/docs/zh-TW/settings-reference#requiredminimumversion) 和[某些使用者可編輯的金鑰](/docs/zh-TW/settings#when-edits-take-effect)的變更在下一個工作階段啟動時生效。

101 * 新的或變更的 [`policyHelper`](/docs/zh-TW/settings-reference#policyhelper) 項目在下一次啟動時生效。如果伺服器受管設定在該啟動時遮蔽協助程式，協助程式會在擷取報告這些設定已移除時立即執行。101 * 新的或變更的 [`policyHelper`](/docs/zh-TW/settings-reference#policyhelper) 項目在下一次啟動時生效。如果伺服器受管設定在該啟動時遮蔽協助程式，協助程式會在擷取報告這些設定已移除時立即執行。

461 What a run can access461 What a run can access

462</h2>462</h2>

463 463 

464`claude plugin eval` 載入目標 plugin 的 skills 和 hooks，並在您的機器上以您的身份執行其 eval 套件。將其指向 plugin 與 `claude --plugin-dir` 相同的信任決定，因此僅評估您信任的 plugins。本節中描述的隔離限制了被測試代理可以到達的內容；它不是針對 plugin 自己程式碼的邊界，通過套件的套件對 plugin 是否安全沒有說明。464`claude plugin eval` 載入目標 plugin 的 skills、hooks 和 agents，並在您的機器上以您的身份執行其 eval 套件。將其指向 plugin 與 `claude --plugin-dir` 相同的信任決定，因此僅評估您信任的 plugins。本節中描述的隔離限制了被測試代理可以到達的內容；它不是針對 plugin 自己程式碼的邊界，通過套件的套件對 plugin 是否安全沒有說明。

465 465 

466<h3 id="trust-the-plugin-directory">466<h3 id="trust-the-plugin-directory">

467 Trust the plugin directory467 Trust the plugin directory

648 648 

649如果 plugin 確實載入並且 `Δ` 仍然接近零，您的 `tool_used: Skill` 評分器失敗，這通常是真實發現，意味著 skill 的 `description` 不會在提示的措辭上觸發。調整描述並重新執行相同的套件。649如果 plugin 確實載入並且 `Δ` 仍然接近零，您的 `tool_used: Skill` 評分器失敗，這通常是真實發現，意味著 skill 的 `description` 不會在提示的措辭上觸發。調整描述並重新執行相同的套件。

650 650 

651<h3 id="agent-type-’-’-not-found-for-one-of-your-plugin’s-agents">

652 "Agent type '...' not found" for one of your plugin's agents

653</h3>

654 

655根據預設，每個案例都會同時執行您的 plugin 和不執行它，不執行它的執行是 [no-plugin baseline](#the-no-plugin-baseline)。當 Claude 在基準執行中分派您的 plugin 的其中一個代理時，Agent 工具呼叫失敗，並顯示 `Agent type '<plugin>:<agent-name>' not found. Available agents: ...`。該列表僅命名不含 plugin 的代理，例如 [built-in subagents](/docs/zh-TW/sub-agents#built-in-subagents)。

656 

657該錯誤是預期的，因為 `Δ` 將您的 plugin 執行與基準進行比較。在 JSON 結果中，基準執行位於 `cases[].arms.without` 下。

658 

659在載入您的 plugin 的執行中，在 `allowed_tools` 中列出 `Agent` 的案例可以透過其命名空間名稱分派您的 plugin 的其中一個代理，例如 `my-plugin:code-reviewer` 用於名為 `my-plugin` 的 plugin 中的 `code-reviewer` 代理。若要跳過基準執行，請傳遞 `--ablation none`。

660 

651<h3 id="everything-scores-zero-although-the-right-files-were-produced">661<h3 id="everything-scores-zero-although-the-right-files-were-produced">

652 Everything scores zero although the right files were produced662 Everything scores zero although the right files were produced

653</h3>663</h3>

1128 1128 

1129限制在任何網路或檔案系統操作之前進行檢查。檢查在 marketplace 新增以及 plugin 安裝、更新、重新整理和自動更新時執行。如果 marketplace 在配置原則之前被新增，且其來源不再符合允許清單，Claude Code 會拒絕從中安裝或更新 plugin。相同的強制執行也適用於 `blockedMarketplaces`。1129限制在任何網路或檔案系統操作之前進行檢查。檢查在 marketplace 新增以及 plugin 安裝、更新、重新整理和自動更新時執行。如果 marketplace 在配置原則之前被新增，且其來源不再符合允許清單，Claude Code 會拒絕從中安裝或更新 plugin。相同的強制執行也適用於 `blockedMarketplaces`。

1130 1130 

1131其中兩個清單被強制執行取決於您在何處設定它們：

1132 

1133* **claude.ai 管理員主控台**：Claude Code 在[讀取伺服器管理設定](/docs/zh-TW/managed-settings#where-and-when-a-policy-applies)的工作階段中強制執行兩個清單。claude.ai 也會在您組織中的任何人從 git 儲存庫在 claude.ai 上新增新 marketplace，或從 Claude Desktop 應用程式外其 Code 標籤中的**自訂**新增時檢查它們。這涵蓋成員為自己的帳戶新增的 marketplace 和在[**組織設定 > Plugins**](https://claude.ai/admin-settings/plugins)下為整個組織新增的 marketplace。claude.ai 拒絕允許清單不允許的儲存庫或封鎖清單命名的儲存庫。它不會重新檢查在您設定清單之前在任一位置新增的 marketplace，也不會檢查上傳的 plugin。

1134* **受管設定檔案、OS 層級原則或其他受管來源**：Claude Code 在讀取該來源的地方強制執行兩個清單。claude.ai 不讀取它。

1135 

1131若要阻止 GitHub 擁有者下的每個 marketplace 儲存庫，請在 `blockedMarketplaces` 項目中使用擁有者萬用字元形式：`{ "source": "github", "repo": "untrusted-org/*" }`。需要 Claude Code v2.1.223 或更新版本。有關匹配規則（在封鎖清單和允許清單之間不同），請參閱[擁有者萬用字元](/docs/zh-TW/settings-reference#owner-wildcards)。1136若要阻止 GitHub 擁有者下的每個 marketplace 儲存庫，請在 `blockedMarketplaces` 項目中使用擁有者萬用字元形式：`{ "source": "github", "repo": "untrusted-org/*" }`。需要 Claude Code v2.1.223 或更新版本。有關匹配規則（在封鎖清單和允許清單之間不同），請參閱[擁有者萬用字元](/docs/zh-TW/settings-reference#owner-wildcards)。

1132 1137 

1133當使用者新增 Claude Code [複製而不是取得](/docs/zh-TW/discover-plugins#add-from-other-git-hosts)的 `https://` 儲存庫 URL（例如裸 `github.com` 或 `gitlab.com` 儲存庫 URL）時，Claude Code 也會根據 `blockedMarketplaces` 中的 `url` 項目檢查它。如果項目命名相同的 URL，Claude Code 會阻止新增。在該比較中，Claude Code 忽略 `.git` 後綴和使用者在 `#` 後附加的任何 ref。需要 Claude Code v2.1.232 或更新版本。在 v2.1.232 之前，Claude Code 僅針對它作為託管 `marketplace.json` 檔案取得的 URL 符合 `url` 項目。1138當使用者新增 Claude Code [複製而不是取得](/docs/zh-TW/discover-plugins#add-from-other-git-hosts)的 `https://` 儲存庫 URL（例如裸 `github.com` 或 `gitlab.com` 儲存庫 URL）時，Claude Code 也會根據 `blockedMarketplaces` 中的 `url` 項目檢查它。如果項目命名相同的 URL，Claude Code 會阻止新增。在該比較中，Claude Code 忽略 `.git` 後綴和使用者在 `#` 後附加的任何 ref。需要 Claude Code v2.1.232 或更新版本。在 v2.1.232 之前，Claude Code 僅針對它作為託管 `marketplace.json` 檔案取得的 URL 符合 `url` 項目。

336 336 

337由 [`apiKeyHelper`](/docs/zh-TW/settings-reference#apikeyhelper) 指令碼傳回的金鑰和[工作負載身分識別聯盟](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation)認證都不會觸發設定擷取。337由 [`apiKeyHelper`](/docs/zh-TW/settings-reference#apikeyhelper) 指令碼傳回的金鑰和[工作負載身分識別聯盟](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation)認證都不會觸發設定擷取。

338 338 

339在 Claude Desktop 應用程式中的 [Cowork](https://claude.com/docs/cowork/overview) 工作階段中，Claude Code 不會從 claude.ai 管理員主控台擷取伺服器管理的設定，即使使用者使用 Team 或 Enterprise 帳戶登入也是如此。[原則適用的位置和時間](/docs/zh-TW/managed-settings#where-and-when-a-policy-applies)涵蓋了哪些原則會到達使用者機器上的 Cowork 工作階段和遠端 Cowork 工作階段。339在 Claude Desktop 應用程式中的 [Cowork](https://claude.com/docs/cowork/overview) 工作階段中，Claude Code 不會從 claude.ai 管理員主控台擷取伺服器管理的設定，即使使用者使用 Team 或 Enterprise 帳戶登入也是如此。[原則適用的位置和時間](/docs/zh-TW/managed-settings#where-and-when-a-policy-applies)涵蓋了哪些原則會到達使用者機器上的 Cowork 工作階段和遠端 Cowork 工作階段。claude.ai 在 Cowork 使用者從 git 儲存庫或從 Cowork 標籤中的**自訂**新增市集時，仍會套用您的 [`strictKnownMarketplaces`](/docs/zh-TW/settings-reference#strictknownmarketplaces) 和 [`blockedMarketplaces`](/docs/zh-TW/settings-reference#blockedmarketplaces) 清單。[限制如何運作](/docs/zh-TW/plugin-marketplaces#how-restrictions-work)說明了該檢查。

340 340 

341如果您在殼層中匯出 `CLAUDE_CODE_USE_*` 提供者變數或非預設的 `ANTHROPIC_BASE_URL`，Claude Code 會略過您工作階段的設定擷取。[`claude doctor` 和 `/status` 報告略過的擷取及其原因](#verify-settings-delivery)。341如果您在殼層中匯出 `CLAUDE_CODE_USE_*` 提供者變數或非預設的 `ANTHROPIC_BASE_URL`，Claude Code 會略過您工作階段的設定擷取。[`claude doctor` 和 `/status` 報告略過的擷取及其原因](#verify-settings-delivery)。

342 342