Documentation 2026-10-03 23:57 UTC to 2026-10-04 12:00 UTC

347 347 

348若要組合篩選條件，請以 `a:`、`s:`、`n:` 或 `o:` 開頭，再加上更多條件，以空格分隔。清單會顯示符合所有條件的工作階段。例如，`s:blocked a:reviewer` 會列出正在等待您的 `reviewer` 工作階段。348若要組合篩選條件，請以 `a:`、`s:`、`n:` 或 `o:` 開頭，再加上更多條件，以空格分隔。清單會顯示符合所有條件的工作階段。例如，`s:blocked a:reviewer` 會列出正在等待您的 `reviewer` 工作階段。

349 349 

350篩選條件啟用時，您摺疊的群組會展開以顯示符合的項目，並選定第一個符合項目，因此按 `Enter` 即可開啟它。清除輸入即可移除篩選條件，這些群組會再次摺疊。350篩選條件啟用時，您摺疊的群組會展開以顯示符合的項目，並選定一個符合項目，因此按 `Enter` 即可開啟它。清除輸入即可移除篩選條件，這些群組會再次摺疊。

351 351 

352<h3 id="keyboard-shortcuts">352<h3 id="keyboard-shortcuts">

353 鍵盤快捷鍵353 鍵盤快捷鍵

369| `Tab` | 在空輸入上，瀏覽所有子代理。否則應用突出顯示的建議 |369| `Tab` | 在空輸入上，瀏覽所有子代理。否則應用突出顯示的建議 |

370| `Ctrl+S` | 在狀態和目錄之間切換分組 |370| `Ctrl+S` | 在狀態和目錄之間切換分組 |

371| `Ctrl+T` | 釘選或取消釘選選定的工作階段 |371| `Ctrl+T` | 釘選或取消釘選選定的工作階段 |

372| `Ctrl+F` | 使用 [`n:` 篩選條件](#filter-sessions) 依名稱尋找工作階段 |

373| `Alt+↑` / `Alt+↓` | 跳至上一個或下一個群組標題 |

372| `Ctrl+R` | 重新命名選定的工作階段 |374| `Ctrl+R` | 重新命名選定的工作階段 |

373| `Ctrl+G` | 在您的 `$VISUAL` 或 `$EDITOR` 中開啟分派提示 |375| `Ctrl+G` | 在您的 `$VISUAL` 或 `$EDITOR` 中開啟分派提示 |

374| `Ctrl+J` | 在分派輸入中插入新行 |376| `Ctrl+J` | 在分派輸入中插入新行 |

378| `Ctrl+C` | 清除輸入；按兩次以退出 |380| `Ctrl+C` | 清除輸入；按兩次以退出 |

379| `?` | 顯示所有快捷鍵 |381| `?` | 顯示所有快捷鍵 |

380 382 

381`Ctrl+S`、`Ctrl+T` 和 `Ctrl+G` 遵循您的 [`keybindings.json`](/docs/zh-TW/keybindings)。在 [`Agents` 上下文](/docs/zh-TW/keybindings#agents-actions) 中使用 `agents:switchView` 和 `agents:togglePin` 動作重新繫結或取消繫結 `Ctrl+S` 和 `Ctrl+T`，以及透過 `Chat` 上下文的 `chat:externalEditor` 繫結重新繫結 `Ctrl+G`。表中的其他快捷鍵無法重新繫結。383在 [`Agents` 情境](/docs/zh-TW/keybindings#agents-actions) 中具有動作的快捷鍵會遵循您的 [`keybindings.json`](/docs/zh-TW/keybindings)。`Ctrl+G` 也是如此，透過 `Chat` 情境的 `chat:externalEditor` 繫結。

382 384 

383<h2 id="dispatch-new-agents">385<h2 id="dispatch-new-agents">

384 分派新 agent386 分派新 agent

1087 1089 

1088| 版本 | 變更 |1090| 版本 | 變更 |

1089| - | - |1091| - | - |

1092| v2.1.288 | `Ctrl+F` 會依名稱尋找工作階段，`Alt+↑` / `Alt+↓` 會在群組標題之間跳轉。這兩者以及 `Ctrl+R` 都可以[重新繫結](/docs/zh-TW/keybindings#agents-actions)。 |

1090| v2.1.287 | [`n:<text>` 篩選器](#filter-sessions)會依名稱或第一個提示詞尋找工作階段。當任何篩選器作用中時，您摺疊的群組會展開以顯示其符合項目，並選取第一個符合項目，因此 `Enter` 會開啟它。 |1093| v2.1.287 | [`n:<text>` 篩選器](#filter-sessions)會依名稱或第一個提示詞尋找工作階段。當任何篩選器作用中時，您摺疊的群組會展開以顯示其符合項目，並選取第一個符合項目，因此 `Enter` 會開啟它。 |

1091| v2.1.287 | 作為[查看回覆](#peek-and-reply)傳送的命令會在工作階段目前的回合結束時執行，包括在工作階段自己的輸入中一輸入就會立即執行的命令。內容恰好為 `/stop` 的回覆會立即停止工作階段。 |1094| v2.1.287 | 作為[查看回覆](#peek-and-reply)傳送的命令會在工作階段目前的回合結束時執行，包括在工作階段自己的輸入中一輸入就會立即執行的命令。內容恰好為 `/stop` 的回覆會立即停止工作階段。 |

1092| v2.1.281 | [`--setting-sources`](/docs/zh-TW/cli-reference#cli-flags) 限制[轉移](#what-carries-over-when-you-background)到您使用 `←` 或 `/bg` 背景化的工作階段，以及您從 agent view 分派的工作階段。在此版本之前，生成的工作階段載入每個設定來源。 |1095| v2.1.281 | [`--setting-sources`](/docs/zh-TW/cli-reference#cli-flags) 限制[轉移](#what-carries-over-when-you-background)到您使用 `←` 或 `/bg` 背景化的工作階段，以及您從 agent view 分派的工作階段。在此版本之前，生成的工作階段載入每個設定來源。 |

156 讓 Claude 自動回覆評論156 讓 Claude 自動回覆評論

157</h3>157</h3>

158 158 

159在您的工作階段發佈成品後，Claude Code 會在工作階段執行期間監視該成品的評論。當可以編輯成品的人向 Claude 發送評論時，它會立即到達您的工作階段，Claude 可以讀取執行緒並回覆，而無需您詢問。159在您的工作階段發佈 artifact 後，Claude Code 會監視該 artifact 的評論。當可以編輯 artifact 的人向 Claude 發送評論時，它會立即到達您的工作階段，Claude 可以讀取執行緒並回覆，而無需您詢問。

160 160 

161您需要 Claude Code v2.1.228 或更新版本。如果您關閉了[功能旗標擷取](/docs/zh-TW/env-vars#features-that-need-feature-flag-fetching)，Claude Code 不會監視評論。161您需要 Claude Code v2.1.228 或更新版本。如果您關閉了[功能旗標擷取](/docs/zh-TW/env-vars#features-that-need-feature-flag-fetching)，Claude Code 不會監視評論。

162 162 

174* **在 `/tasks` 中停止任務**：Claude 停止回覆該成品，直到您要求它在那裡恢復回覆。重新發佈成品不會再次開始回覆，當您稍後恢復工作階段時，停止仍然適用。174* **在 `/tasks` 中停止任務**：Claude 停止回覆該成品，直到您要求它在那裡恢復回覆。重新發佈成品不會再次開始回覆，當您稍後恢復工作階段時，停止仍然適用。

175* **在 3 秒內按兩次 `Ctrl+X Ctrl+K`**：[停止每個執行中背景子代理](/docs/zh-TW/interactive-mode#general-controls)的和弦也會停止 Claude 在工作階段的其餘時間內回覆每個成品。要求 Claude 恢復回覆不會撤銷此停止。175* **在 3 秒內按兩次 `Ctrl+X Ctrl+K`**：[停止每個執行中背景子代理](/docs/zh-TW/interactive-mode#general-controls)的和弦也會停止 Claude 在工作階段的其餘時間內回覆每個成品。要求 Claude 恢復回覆不會撤銷此停止。

176 176 

177由 Claude Code 自行啟動的監視，可能會在 artifact 數小時沒有活動後結束。若要重新啟動監視，請再次發佈 artifact 或要求 Claude 監視它。

178 

177如果傳遞評論的服務變得不可用或停止回應，Claude Code 會嘗試重新連接一段時間，然後停止監視您的工作階段正在監視的每個成品。179如果傳遞評論的服務變得不可用或停止回應，Claude Code 會嘗試重新連接一段時間，然後停止監視您的工作階段正在監視的每個成品。

178 180 

179<h2 id="pull-live-data-with-mcp-connectors">181<h2 id="pull-live-data-with-mcp-connectors">

450 鎖定不涵蓋的設定450 鎖定不涵蓋的設定

451</h4>451</h4>

452 452 

453六個父提供的設定即使設定了所有五個鎖定也會通過篩選器。在預設首次獲勝設定下，阻止父項的管理員值是最高優先級管理員來源中的值，除了 `allowedMcpServers` 當[MCP 伺服器鎖定](#lock-behavior-across-sources)開啟時。在 `managedSourcesBehavior` 合併選擇加入下，[Claude Code 如何合併受管來源](/docs/zh-TW/managed-settings#how-claude-code-combines-managed-sources)說明哪個來源的值改為適用。453即使設定了所有五個鎖定，這些父提供的設定仍會通過篩選器：

454 454 

455* **`forceLoginOrgUUID`**：當最高優先級管理員來源未設定組織 UUID 時，Claude Code 會接受父提供的值。閘道登入不檢查此金鑰。最高優先級管理員來源中的組織 UUID 會阻止父項的值，是 Claude Code 強制執行的值。455* **`forceLoginOrgUUID`**：當最高優先級管理員來源未設定組織 UUID 時，Claude Code 會接受父提供的值。閘道登入不檢查此金鑰。最高優先級管理員來源中的組織 UUID 會阻止父項的值，是 Claude Code 強制執行的值。

456* **`allowedMcpServers`**：當沒有管理員清單生效時，Claude Code 會接受父提供的允許清單。`allowManagedMcpServersOnly` 不會阻止它，因為鎖定強制執行無論哪個清單獲勝作為受管值，包括當沒有管理員來源提供清單時的父提供清單。最高優先級管理員來源中的清單會阻止父項的並是 Claude Code 強制執行的清單，因此在那裡設定 `allowedMcpServers`，在鎖定旁邊。在 v2.1.223 之前，任何管理員來源中任一金鑰的值都會阻止父項的。456* **`allowedMcpServers`**：當沒有管理員清單生效時，Claude Code 會接受父提供的允許清單。`allowManagedMcpServersOnly` 不會阻止它，因為鎖定強制執行無論哪個清單獲勝作為受管值，包括當沒有管理員來源提供清單時的父提供清單。最高優先級管理員來源中的清單會阻止父項的並是 Claude Code 強制執行的清單，因此在那裡設定 `allowedMcpServers`，在鎖定旁邊。在 v2.1.223 之前，任何管理員來源中任一金鑰的值都會阻止父項的。

457* **`availableModels`**：當獲勝的受管來源未設定模型清單時，Claude Code 會接受父提供的模型清單。如果您的機隊限制模型，在獲勝的來源中設定 `availableModels`。457* **`availableModels`**：當獲勝的受管來源未設定模型清單時，Claude Code 會接受父提供的模型清單。如果您的機隊限制模型，在獲勝的來源中設定 `availableModels`。

458* **`allowedProviders`**：當獲勝的受管來源未設定 API 提供商允許清單時，Claude Code 會接受父提供的 API 提供商允許清單。如果您的機隊限制開發人員可以使用的 API 提供商，請在獲勝的來源中設定 `allowedProviders`。需要 Claude Code v2.1.285 或更新版本。

458* **`strictKnownMarketplaces`**：當獲勝的受管來源未設定外掛程式市集允許清單時，Claude Code 會接受父提供的外掛程式市集允許清單。Claude Desktop 2.16120.0 或更新版本在其受管配置關閉使用者新增的外掛程式市集時傳送一個。如果您的機隊限制市集，在獲勝的來源中設定 `strictKnownMarketplaces`。需要 Claude Code v2.1.282 或更新版本。459* **`strictKnownMarketplaces`**：當獲勝的受管來源未設定外掛程式市集允許清單時，Claude Code 會接受父提供的外掛程式市集允許清單。Claude Desktop 2.16120.0 或更新版本在其受管配置關閉使用者新增的外掛程式市集時傳送一個。如果您的機隊限制市集，在獲勝的來源中設定 `strictKnownMarketplaces`。需要 Claude Code v2.1.282 或更新版本。

459* **`blockedMarketplaces`**：父提供的市集封鎖清單通過並新增至任何受管來源設定的封鎖清單，因為封鎖清單只能進一步限制。需要 Claude Code v2.1.282 或更新版本。460* **`blockedMarketplaces`**：父提供的市集封鎖清單通過並新增至任何受管來源設定的封鎖清單，因為封鎖清單只能進一步限制。需要 Claude Code v2.1.282 或更新版本。

460* **`strictPluginOnlyCustomization`**：此金鑰無論任何鎖定都通過篩選器，它使 Claude Code 忽略開發人員自己的自訂，包括保護性 hooks。沒有鎖定阻止它。461* **`strictPluginOnlyCustomization`**：此金鑰無論任何鎖定都通過篩選器，它使 Claude Code 忽略開發人員自己的自訂，包括保護性 hooks。沒有鎖定阻止它。

461 462 

463在預設的首次獲勝設定下，只有當管理員值位於最高優先級管理員來源時，才會阻擋父項的值，但 [MCP 伺服器鎖定](#lock-behavior-across-sources)開啟時的 `allowedMcpServers` 除外。在 `managedSourcesBehavior` 合併選擇加入下，[Claude Code 如何合併受管來源](/docs/zh-TW/managed-settings#how-claude-code-combines-managed-sources)說明改為套用哪個來源的值。

464 

462<h3 id="connect-claude-desktop">465<h3 id="connect-claude-desktop">

463 連接 Claude Desktop466 連接 Claude Desktop

464</h3>467</h3>

12 12 

13雲端工作階段是在雲端基礎設施上執行的 Claude Code 工作階段，而不是在您的機器上執行。預設情況下，它在 Anthropic 管理的基礎設施上執行，或在您的組織的[自託管環境](/docs/zh-TW/self-hosted-environments)上執行（如果路由到那裡）。工作階段在您關閉筆記型電腦後仍會繼續執行，您可以從任何裝置檢查或控制它。13雲端工作階段是在雲端基礎設施上執行的 Claude Code 工作階段，而不是在您的機器上執行。預設情況下，它在 Anthropic 管理的基礎設施上執行，或在您的組織的[自託管環境](/docs/zh-TW/self-hosted-environments)上執行（如果路由到那裡）。工作階段在您關閉筆記型電腦後仍會繼續執行，您可以從任何裝置檢查或控制它。

14 14 

15若要讓雲端工作階段從 GitHub 複製您的程式碼並推送分支，請使用其中一種 [GitHub 連接方式](#github-authentication-options)連接 GitHub。如果您的儲存庫位於 GitLab、Bitbucket 或其他主機上，請參閱[平台限制](#limitations)以了解可用的功能。

16 

15您可以從以下任何介面啟動雲端工作階段：17您可以從以下任何介面啟動雲端工作階段：

16 18 

17* **瀏覽器**：[claude.ai/code](https://claude.ai/code)，也稱為網頁版 Claude Code19* **瀏覽器**：[claude.ai/code](https://claude.ai/code)，也稱為網頁版 Claude Code

20* **終端**：[`claude --cloud`](#from-terminal-to-cloud)22* **終端**：[`claude --cloud`](#from-terminal-to-cloud)

21* **例行工作**：[排程和觸發的執行](/docs/zh-TW/routines)每次都作為雲端工作階段執行23* **例行工作**：[排程和觸發的執行](/docs/zh-TW/routines)每次都作為雲端工作階段執行

22 24 

23若要讓 Claude 為一項工作啟動並追蹤許多雲端工作階段，請使用[專案](/docs/zh-TW/claude-projects)。在您的終端、IDE 或選擇了 **Local** 的桌面應用程式中的工作階段在您自己的機器上執行。若要從您的手機或瀏覽器控制其中一個本機工作階段，請使用[遠端控制](/docs/zh-TW/remote-control)。25完成設定後，請使用本頁在終端機和雲端之間移動工作、管理和共享工作階段、為 pull request 開啟自動修復，以及進行疑難排解。

24 

25<Tip>

26 初次使用雲端工作階段？從[開始使用](/docs/zh-TW/web-quickstart)開始，連接您的 GitHub 帳戶並提交您的第一個任務。

27</Tip>

28 26 

29本頁涵蓋：27<Note>

28 以下情況在其他頁面中說明：

30 29 

31* [雲端環境](#cloud-environments)：工作階段執行的位置，以及如何配置該位置30 * **啟動您的第一個雲端工作階段**：[開始使用雲端工作階段](/docs/zh-TW/web-quickstart)會連接 GitHub，並引導您在瀏覽器中完成一項任務

32* [GitHub 驗證選項](#github-authentication-options)：連接 GitHub 的兩種方式31 * **為一項工作使用多個雲端工作階段**：[專案](/docs/zh-TW/claude-projects)會讓 Claude 為您啟動並追蹤這些工作階段

33* [在終端和雲端之間移動任務](#move-tasks-between-terminal-and-cloud)，使用 `--cloud` 和 `--teleport`32 * **從另一部裝置控制本機工作階段**：在您的終端機、IDE 或選擇了 **Local** 的 Desktop 應用程式中的工作階段會在您的機器上執行，而 [Remote Control](/docs/zh-TW/remote-control) 可讓您從手機或瀏覽器存取這些工作階段

34* [使用工作階段](#work-with-sessions)：權限模式、檢查、共享、封存、刪除33</Note>

35* [自動修復拉取請求](#auto-fix-pull-requests)：自動回應 CI 失敗和審查評論

36* [安全性和隔離](#security-and-isolation)：工作階段如何隔離

37* [限制](#limitations)：速率限制和平台限制

38 34 

39<h2 id="cloud-environments">35<h2 id="cloud-environments">

40 雲端環境36 雲端環境

41</h2>37</h2>

42 38 

43每個雲端工作階段都在一個[雲端環境](/docs/zh-TW/cloud-environments)中執行，這是一個已保存的設定，控制網路存取、環境變數和設定指令碼。如果您還沒有環境，上線會設定一個**預設**環境，具有[**信任**網路存取](/docs/zh-TW/cloud-environments#access-levels)，要麼為您建立它，要麼要求您建立它。請參閱[預設環境](/docs/zh-TW/cloud-environments#the-default-environment)，了解在您的計畫上會發生哪種情況，以及當您有多個環境時工作階段如何選擇環境。39每個雲端工作階段都在一個[雲端環境](/docs/zh-TW/cloud-environments)中執行，這是一個已保存的設定，控制網路存取、環境變數和設定指令碼。

44 40 

45相同的環境適用於您啟動雲端工作階段的任何地方：網頁、終端、[Claude Tag](https://claude.com/docs/claude-tag/overview)、[例行工作](/docs/zh-TW/routines)，以及行動和 Desktop 應用程式。Claude Tag 頻道工作階段僅使用組織級別環境，要麼是[共享環境](/docs/zh-TW/cloud-environments#organization-shared-environments)，要麼是[自託管環境](/docs/zh-TW/self-hosted-environments)。41* **您的第一個環境**：如果您還沒有環境，上線會設定一個**預設**環境，具有[**信任**網路存取](/docs/zh-TW/cloud-environments#access-levels)，要麼為您建立它，要麼要求您建立它。請參閱[預設環境](/docs/zh-TW/cloud-environments#the-default-environment)，了解在您的計畫上會發生哪種情況

46 42* **工作階段使用哪個環境**：請參閱[預設環境](/docs/zh-TW/cloud-environments#the-default-environment)，了解當您有多個環境時工作階段如何選擇環境

47請參閱[設定雲端環境](/docs/zh-TW/cloud-environments)以變更環境允許的內容、設定變數或新增設定指令碼，以及[已安裝的工具](/docs/zh-TW/cloud-environments#installed-tools)以了解工作階段在沒有任何設定的情況下包含的內容。43* **變更工作階段在啟動時可以存取或執行的內容**：請參閱[設定雲端環境](/docs/zh-TW/cloud-environments)

44* **在沒有任何設定的情況下已安裝的內容**：請參閱[已安裝的工具](/docs/zh-TW/cloud-environments#installed-tools)

48 45 

49<h2 id="github-authentication-options">46<h2 id="github-authentication-options">

50 GitHub 驗證選項47 GitHub 驗證選項

57| **GitHub App** | 在[網頁上線](/docs/zh-TW/web-quickstart)期間授權 Claude GitHub App | 任何公開儲存庫，以及安裝了 Claude GitHub App 的私人儲存庫 | 瀏覽器上線；想要[自動修復](#auto-fix-pull-requests)的團隊 |54| **GitHub App** | 在[網頁上線](/docs/zh-TW/web-quickstart)期間授權 Claude GitHub App | 任何公開儲存庫，以及安裝了 Claude GitHub App 的私人儲存庫 | 瀏覽器上線；想要[自動修復](#auto-fix-pull-requests)的團隊 |

58| **`/web-setup`** | 在您的終端中執行 `/web-setup` 以將您的本機 `gh` CLI 令牌傳送到您的 Claude 帳戶 | 您的 `gh` 令牌可以存取的任何儲存庫，無論是否安裝了 Claude GitHub App | 已經使用 `gh` 的個人開發者 |55| **`/web-setup`** | 在您的終端中執行 `/web-setup` 以將您的本機 `gh` CLI 令牌傳送到您的 Claude 帳戶 | 您的 `gh` 令牌可以存取的任何儲存庫，無論是否安裝了 Claude GitHub App | 已經使用 `gh` 的個人開發者 |

59 56 

60在儲存庫上安裝 Claude GitHub App 也會為其中的提取請求啟用[自動修復](#auto-fix-pull-requests)。57以下功能取決於儲存庫上是否已安裝 Claude GitHub App：

61 58 

62[專案](/docs/zh-TW/claude-projects)中的執行緒需要在它們複製的每個儲存庫上安裝 Claude GitHub App，無論您使用哪種方法連接。請參閱[設定 GitHub 存取](/docs/zh-TW/claude-projects#set-up-github-access)。59* **自動修復**：在儲存庫上安裝 Claude GitHub App 也會為其中的 pull request 啟用[自動修復](#auto-fix-pull-requests)

60* **專案**：[專案](/docs/zh-TW/claude-projects)中的執行緒需要在它們複製的每個儲存庫上安裝 Claude GitHub App，無論您使用哪種方法連接。請參閱[設定 GitHub 存取](/docs/zh-TW/claude-projects#set-up-github-access)

63 61 

64在 Anthropic 代管的環境中，您的 GitHub 認證保持在 Anthropic 伺服器上加密，永遠不會進入工作階段的虛擬機器。來自虛擬機器的 GitHub 操作會通過 [GitHub proxy](/docs/zh-TW/cloud-environments#github-proxy)，它在伺服器端附加認證。62在 Anthropic 代管的環境中，您的 GitHub 認證保持在 Anthropic 伺服器上加密，永遠不會進入工作階段的虛擬機器。來自虛擬機器的 GitHub 操作會通過 [GitHub proxy](/docs/zh-TW/cloud-environments#github-proxy)，它在伺服器端附加認證。

65 63 

66有關 `/schedule` 如何在建立例行工作之前檢查儲存庫存取，請參閱[儲存庫和分支權限](/docs/zh-TW/routines#repositories-and-branch-permissions)。有關 `/web-setup` 的逐步說明，請參閱[從您的終端連接](/docs/zh-TW/web-quickstart#connect-from-your-terminal)，包括 `/web-setup` 儲存的內容以及如何移除它。64有關 `/web-setup` 的逐步說明，請參閱[從您的終端機連接](/docs/zh-TW/web-quickstart#connect-from-your-terminal)，包括 `/web-setup` 儲存的內容以及如何移除它。

67 

68快速網頁設定是一個組織設定，讓成員使用 `/web-setup` 連接 GitHub，在瀏覽器上線期間跳過 Claude GitHub App 安裝提示，並讓瀏覽器上線為他們建立[**預設**環境](/docs/zh-TW/cloud-environments#the-default-environment)，而不是顯示環境表單。在 Team 和 Enterprise 計畫上，預設情況下它是關閉的，這會隱藏 `/web-setup`。[擁有者](/docs/zh-TW/server-managed-settings#access-control)可以在 [**管理設定 > Claude Code**](https://claude.ai/admin-settings/claude-code) 使用**快速網頁設定**切換來開啟它。

69 65 

70<Note>66<Note>

71 啟用[零資料保留](/docs/zh-TW/zero-data-retention)的組織無法使用 `/web-setup` 或其他雲端工作階段功能。67 啟用[零資料保留](/docs/zh-TW/zero-data-retention)的組織無法使用 `/web-setup` 或其他雲端工作階段功能。

72</Note>68</Note>

73 69 

70<h3 id="quick-web-setup-for-team-and-enterprise">

71 Team 和 Enterprise 的快速網頁設定

72</h3>

73 

74快速網頁設定是一個組織設定，可減少成員在 GitHub 和環境設定上的步驟。在 Team 和 Enterprise 計畫上，預設情況下它是關閉的。

75 

76開啟後，成員會有以下變化：

77 

78* **`/web-setup`**：成員可以使用 `/web-setup` 連接 GitHub。此設定關閉時，該命令會被隱藏

79* **GitHub App 提示**：瀏覽器上線會跳過 Claude GitHub App 安裝提示

80* **第一個環境**：瀏覽器上線會為成員建立[**預設**環境](/docs/zh-TW/cloud-environments#the-default-environment)，而不是顯示環境表單

81 

82[擁有者](/docs/zh-TW/server-managed-settings#access-control)可以在 [**管理設定 > Claude Code**](https://claude.ai/admin-settings/claude-code) 使用**快速網頁設定**切換來開啟它。

83 

74<h2 id="move-tasks-between-terminal-and-cloud">84<h2 id="move-tasks-between-terminal-and-cloud">

75 在終端機和雲端之間移動任務85 在終端機和雲端之間移動任務

76</h2>86</h2>

78這些工作流程需要 [Claude Code CLI](/docs/zh-TW/quickstart) 登入到同一個 claude.ai 帳戶。您可以從終端機啟動新的雲端工作階段，或將雲端工作階段拉入您的終端機以在本機繼續。雲端工作階段即使在您關閉筆記型電腦後仍會保留，您可以從任何地方（包括 Claude 行動應用程式）監控它們。88這些工作流程需要 [Claude Code CLI](/docs/zh-TW/quickstart) 登入到同一個 claude.ai 帳戶。您可以從終端機啟動新的雲端工作階段，或將雲端工作階段拉入您的終端機以在本機繼續。雲端工作階段即使在您關閉筆記型電腦後仍會保留，您可以從任何地方（包括 Claude 行動應用程式）監控它們。

79 89 

80<Note>90<Note>

81 從 CLI，工作階段交接是單向的：您可以使用 `--teleport` 將雲端工作階段拉入您的終端機，但您無法將現有的終端機工作階段推送到雲端。`--cloud` 旗標搭配任務描述會為您目前的儲存庫建立新的雲端工作階段；搭配 `-p` 和工作階段 ID 或 claude.ai/code URL 時，它會改為 [將訊息加入該現有工作階段的佇列](/docs/zh-TW/claude-code-on-the-web#send-follow-ups-from-the-cli)。[桌面應用程式](/docs/zh-TW/desktop#continue-in-another-surface) 提供 **Continue in** 功能表，可以將本機工作階段傳送到雲端。91 從 CLI，工作階段交接是單向的：您可以使用 `--teleport` 將雲端工作階段拉入您的終端機，但您無法將現有的終端機工作階段推送到雲端。`--cloud` 旗標搭配任務描述會為您目前的儲存庫建立新的雲端工作階段；搭配 `-p` 和工作階段 ID 或 claude.ai/code URL 時，它會改為 [將訊息加入該現有工作階段的佇列](/docs/zh-TW/claude-code-on-the-web#send-follow-ups-from-the-cli)。[桌面應用程式](/docs/zh-TW/desktop#continue-in-another-surface) 可以從其 **Open in** 功能表，將其 Code 分頁中的本機工作階段傳送到雲端。

82</Note>92</Note>

83 93 

84<h3 id="from-terminal-to-cloud">94<h3 id="from-terminal-to-cloud">

173 從 CLI 傳送後續訊息183 從 CLI 傳送後續訊息

174</h3>184</h3>

175 185 

176一旦雲端工作階段執行，無論它在何處執行，都可以從任何您使用 `claude auth login` 登入的機器上的 `claude` CLI 傳送後續訊息。CLI 使用您的 Anthropic 帳戶認證進行驗證，不傳送任何本機工作階段狀態，因此命令不需要從啟動工作階段的機器執行，在每個 shell 中都相同，包括 PowerShell。186一旦雲端工作階段執行，無論它在何處執行，都可以從任何您使用 `claude auth login` 登入的機器上的 `claude` CLI 傳送後續訊息。CLI 使用您的 Anthropic 帳戶憑證進行身分驗證，不傳送任何本機工作階段狀態，因此命令不需要從啟動工作階段的機器執行。

177 187 

178該命令發佈一條訊息並退出：188該命令發佈一條訊息並退出：

179 189 

189 `--cloud` 需要 Anthropic 帳戶。當 Claude Code 針對 Amazon Bedrock、Google Cloud 的 Agent Platform 或其他第三方提供者進行設定時，它不可用。僅透過 `ANTHROPIC_BASE_URL` 設定的 [LLM gateway](/docs/zh-TW/llm-gateway) 不算作此檢查的第三方提供者，但您仍需要使用 `claude auth login` 登入。您組織的 `allow_remote_sessions` 原則也必須啟用。擁有者可以在 claude.ai/admin-settings/claude-code 的 Claude Code 管理設定中開啟它。199 `--cloud` 需要 Anthropic 帳戶。當 Claude Code 針對 Amazon Bedrock、Google Cloud 的 Agent Platform 或其他第三方提供者進行設定時，它不可用。僅透過 `ANTHROPIC_BASE_URL` 設定的 [LLM gateway](/docs/zh-TW/llm-gateway) 不算作此檢查的第三方提供者，但您仍需要使用 `claude auth login` 登入。您組織的 `allow_remote_sessions` 原則也必須啟用。擁有者可以在 claude.ai/admin-settings/claude-code 的 Claude Code 管理設定中開啟它。

190</Note>200</Note>

191 201 

192<h4 id="output-and-errors">202<h4 id="output">

193 輸出和錯誤203 輸出

194</h4>204</h4>

195 205 

196成功時，命令會列印工作階段 ID 和檢視工作階段的連結：206成功時，命令會列印工作階段 ID 和檢視工作階段的連結：

203 213 

204傳遞 `--output-format json` 以取得機器可讀的結果：成功時為 `{ok, session_id, url}`，或當傳送失敗時為 `{ok: false, session_id, error}`，例如當工作階段遺失或已封存時。設定錯誤（例如不支援的提供者或已停用的組織原則）會列印到 stderr，不含 JSON。`--output-format stream-json` 不支援 `--cloud <session-id>`。214傳遞 `--output-format json` 以取得機器可讀的結果：成功時為 `{ok, session_id, url}`，或當傳送失敗時為 `{ok: false, session_id, error}`，例如當工作階段遺失或已封存時。設定錯誤（例如不支援的提供者或已停用的組織原則）會列印到 stderr，不含 JSON。`--output-format stream-json` 不支援 `--cloud <session-id>`。

205 215 

206CLI 會在錯誤前加上 `Error: ` 前綴。失敗的傳遞會包裝為 `failed to send message to cloud session <id>: <reason>`。216如果傳送失敗，請參閱 [傳送到雲端工作階段時的錯誤](#errors-when-sending-to-a-cloud-session)。

207 

208| 訊息 | 它的意思 |

209| - | - |

210| `Cloud sessions aren't available with <provider>. They run on Anthropic's infrastructure and require an Anthropic account.` | Claude Code 針對第三方提供者進行設定。訊息會使用您的設定使用的標籤命名提供者，例如 `Amazon Bedrock` 或 `Google Vertex AI`。移除該提供者的設定，例如取消設定 `CLAUDE_CODE_USE_BEDROCK`，並使用 Anthropic 帳戶登入（`claude auth login`）。 |

211| `Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.` | `allow_remote_sessions` 組織原則已關閉。 |

212| `Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.` | Claude Code 無法擷取您的組織原則，因此它拒絕傳送而不是假設雲端工作階段被允許。檢查您的網路連線並重試。 |

213| `Attaching to an existing cloud session is not enabled for your account.` | 您執行了 `--cloud <session-id>` 而沒有 `-p`。使用 `claude -p "your message" --cloud <session-id>` 傳送訊息。 |

214| `Session not found: <id>` | ID 或 URL 與您可以存取的工作階段不符。根據工作階段的 claude.ai/code URL 檢查它。 |

215| `cloud session <id> is archived and cannot accept new messages` | 工作階段已被封存。改為啟動新工作階段。 |

216 217 

217<h3 id="from-cloud-to-terminal">218<h3 id="from-cloud-to-terminal">

218 從雲端到終端機219 從雲端到終端機

239| 需求 | 詳細資訊 |240| 需求 | 詳細資訊 |

240| - | - |241| - | - |

241| 乾淨的 git 狀態 | 您的工作目錄必須沒有未提交的變更。如果需要，Teleport 會提示您隱藏變更。 |242| 乾淨的 git 狀態 | 您的工作目錄必須沒有未提交的變更。如果需要，Teleport 會提示您隱藏變更。 |

242| 正確的儲存庫 | 您必須從同一儲存庫的簽出執行 `--teleport`，而不是分叉。如果您從不同儲存庫的簽出執行它，Claude Code 會顯示一個錯誤，命名工作階段的儲存庫和您的簽出。在 v2.1.219 之前，錯誤沒有命名您的簽出的儲存庫。如果 Claude Code 無法將您的遠端解析為主機名稱，例如 SSH 主機別名如 `git@work:owner/repo.git`，它會要求您確認，並在遠端的擁有者和儲存庫名稱與工作階段的儲存庫相符時接受簽出。 |243| 正確的儲存庫 | 您必須從同一儲存庫的簽出執行 `--teleport`，而不是分叉。如果您從不同儲存庫的簽出執行它，Claude Code 會顯示一個錯誤，命名工作階段的儲存庫和您的簽出的儲存庫。如果 Claude Code 無法將您的遠端解析為主機名稱，例如 SSH 主機別名如 `git@work:owner/repo.git`，它會要求您確認，並在遠端的擁有者和儲存庫名稱與工作階段的儲存庫相符時接受簽出。 |

243| 分支可用 | 雲端工作階段的分支必須已推送到遠端。Teleport 會自動擷取並簽出它。 |244| 分支可用 | 雲端工作階段的分支必須已推送到遠端。Teleport 會自動擷取並簽出它。 |

244| 相同帳戶 | 您必須驗證到雲端工作階段中使用的同一 claude.ai 帳戶。 |245| 相同帳戶 | 您必須驗證到雲端工作階段中使用的同一 claude.ai 帳戶。 |

245 246 

249 `--teleport` 不可用250 `--teleport` 不可用

250</h4>251</h4>

251 252 

252Teleport 需要 claude.ai 訂閱驗證。如果您透過 API 金鑰進行驗證，請執行 `/login` 以改為使用您的 claude.ai 帳戶登入。如果錯誤命名您的提供者，雲端工作階段無法透過第三方提供者取得；請參閱 [error table](#output-and-errors)。如果您已透過 claude.ai 登入且 `--teleport` 仍然不可用，您的組織可能已停用雲端工作階段。253Teleport 需要 claude.ai 訂閱身分驗證。請找出符合您情況的項目：

254 

255* **您透過 API 金鑰進行身分驗證**：執行 `/login` 以改為使用您的 claude.ai 帳戶登入

256* **錯誤命名了您的提供者**：雲端工作階段無法透過第三方提供者取得。請參閱 [錯誤表](#errors-when-sending-to-a-cloud-session)

257* **您已透過 claude.ai 登入**：您的組織可能已停用雲端工作階段

253 258 

254<h2 id="work-with-sessions">259<h2 id="work-with-sessions">

255 使用工作階段260 使用工作階段

257 262 

258工作階段出現在 claude.ai/code 的側邊欄中。從那裡，您可以檢查變更、與隊友共享、封存完成的工作或永久刪除工作階段。263工作階段出現在 claude.ai/code 的側邊欄中。從那裡，您可以檢查變更、與隊友共享、封存完成的工作或永久刪除工作階段。

259 264 

260<h3 id="take-back-a-queued-message">265<h3 id="permission-modes-in-cloud-sessions">

261 取回已排隊的訊息266 雲端工作階段中的權限模式

262</h3>267</h3>

263 268 

264如果您在 Claude 工作時發送訊息，該訊息會排隊，直到 Claude 讀取它。若要取回已排隊的訊息，請點擊它上面的 ✕。文字會返回到訊息框，以便您可以編輯它或發送其他內容。269您可以從[模式下拉式功能表](/docs/zh-TW/permission-modes#switch-permission-modes)選擇雲端工作階段的[權限模式](/docs/zh-TW/permission-modes)，無論是在您建立任務時還是在工作階段執行時。

265 270 

266如果 Claude 已經讀取訊息，它會保留在對話中。271當您執行下列任一操作時，Claude Code 會以工作階段當時所在的權限模式恢復該工作階段：

272 

273* 重新開啟其 Anthropic 託管[環境已過期](#environment-expired)的工作階段

274* 向自託管執行器[在閒置時釋放](/docs/zh-TW/self-hosted-environments-reference#runner-cli-flags)的工作階段發送訊息

275 

276<h3 id="review-changes">

277 檢查變更

278</h3>

279 

280每個工作階段顯示一個差異指示器，其中包含新增和移除的行數，例如 `+42 -18`。選擇它以開啟差異檢視、在特定行上留下內聯評論，並使用您的下一條訊息將它們發送給 Claude。

281 

282差異檢視預設會將工作階段的變更與其基礎分支進行比較。若要與儲存庫中的任何其他分支進行比較，請選擇**比較對象**並選擇一個。

283 

284Claude Code 從原始 git blob 內容計算這些差異，因此儲存庫中設定的差異驅動器和 `textconv` 篩選器不適用。

285 

286以下步驟在其他地方有說明：

287 

288* **完整逐步說明，包括 PR 建立**：請參閱[檢查和迭代](/docs/zh-TW/web-quickstart#review-and-iterate)

289* **讓 Claude 自動監控 PR 以查找 CI 失敗和審查評論**：請參閱[自動修復 pull requests](#auto-fix-pull-requests)

267 290 

268<h3 id="manage-context">291<h3 id="manage-context">

269 管理上下文292 管理上下文

291 314 

292[Agent teams](/docs/zh-TW/agent-teams) 預設關閉，但可以通過將 `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` 新增到您的[環境變數](/docs/zh-TW/cloud-environments#set-environment-variables)來啟用。315[Agent teams](/docs/zh-TW/agent-teams) 預設關閉，但可以通過將 `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` 新增到您的[環境變數](/docs/zh-TW/cloud-environments#set-environment-variables)來啟用。

293 316 

294<h3 id="permission-modes-in-cloud-sessions">317<h3 id="take-back-a-queued-message">

295 雲端工作階段中的權限模式318 取回已排隊的訊息

296</h3>

297 

298您可以從[模式下拉式功能表](/docs/zh-TW/permission-modes#switch-permission-modes)選擇雲端工作階段的[權限模式](/docs/zh-TW/permission-modes)，無論是在您建立任務時還是在工作階段執行時。當您重新開啟其 Anthropic 託管[環境已過期](#environment-expired)的工作階段，或向工作階段發送訊息時，該工作階段的自託管執行器[在閒置時釋放](/docs/zh-TW/self-hosted-environments-reference#runner-cli-flags)，Claude Code 會在它所在的權限模式中恢復工作階段。

299 

300<h3 id="review-changes">

301 檢查變更

302</h3>319</h3>

303 320 

304每個工作階段顯示一個差異指示器，其中包含新增和移除的行數，例如 `+42 -18`。選擇它以開啟差異檢視、在特定行上留下內聯評論，並使用您的下一條訊息將它們發送給 Claude。321如果您在 Claude 工作時發送訊息，該訊息會排隊，直到 Claude 讀取它。若要取回已排隊的訊息，請點擊它上面的 ✕。文字會返回到訊息框，以便您可以編輯它或發送其他內容。

305 

306差異檢視預設會將工作階段的變更與其基礎分支進行比較。若要與儲存庫中的任何其他分支進行比較，請選擇**比較對象**並選擇一個。

307 

308Claude Code 從原始 git blob 內容計算這些差異，包括 Claude 編輯時顯示的每個檔案差異，因此儲存庫中配置的差異驅動器和 `textconv` 篩選器不適用。對於不是工作階段自己簽出之一的儲存庫中的檔案，例如在工作階段期間在工作區內複製的檔案，每個檔案差異會顯示 Claude 的編輯本身，而不是 git 比較。

309 322 

310請參閱[檢查和迭代](/docs/zh-TW/web-quickstart#review-and-iterate)以了解完整逐步說明，包括 PR 建立。若要讓 Claude 自動監控 PR 以查找 CI 失敗和審查評論，請參閱[自動修復拉取請求](#auto-fix-pull-requests)。323如果 Claude 已經讀取訊息，它會保留在對話中。

311 324 

312<h3 id="share-sessions">325<h3 id="share-sessions">

313 共享工作階段326 共享工作階段

319 從 Enterprise 或 Team 帳戶共享332 從 Enterprise 或 Team 帳戶共享

320</h4>333</h4>

321 334 

322對於 Enterprise 和 Team 帳戶，兩個可見性選項是**私人**和**Team**。Team 可見性使工作階段對您的 claude.ai 組織的其他成員可見。[Slack 中的 Claude](/docs/zh-TW/slack)工作階段會自動以 Team 可見性共享。335對於 Enterprise 和 Team 帳戶，共享的運作方式如下：

323 336 

324儲存庫存取驗證預設啟用，基於連接到收件者帳戶的 GitHub 帳戶。您帳戶的顯示名稱對所有有存取權限的收件者可見。337* **可見性選項**：**私人**和**Team**。Team 可見性使工作階段對您的 claude.ai 組織的其他成員可見

338* **儲存庫存取**：驗證預設啟用，基於連接到收件者帳戶的 GitHub 帳戶

339* **您的名稱**：您帳戶的顯示名稱對所有有存取權限的收件者可見

340* **Slack 工作階段**：[Slack 中的 Claude](/docs/zh-TW/slack)工作階段會自動以 Team 可見性共享

325 341 

326<h4 id="share-from-a-max-or-pro-account">342<h4 id="share-from-a-max-or-pro-account">

327 從 Max 或 Pro 帳戶共享343 從 Max 或 Pro 帳戶共享

328</h4>344</h4>

329 345 

330對於 Max 和 Pro 帳戶，兩個可見性選項是**私人**和**公開**。公開可見性使工作階段對任何登入 claude.ai 的使用者可見。346對於 Max 和 Pro 帳戶，共享的運作方式如下：

331 347 

332在共享之前檢查您的工作階段是否包含敏感內容。工作階段可能包含來自私人 GitHub 儲存庫的程式碼和認證。儲存庫存取驗證預設未啟用。348* **可見性選項**：**私人**和**公開**。公開可見性使工作階段對任何登入 claude.ai 的使用者可見

349* **儲存庫存取**：驗證預設未啟用

350* **敏感內容**：在共享之前檢查您的工作階段。工作階段可能包含來自私人 GitHub 儲存庫的程式碼和憑證

333 351 

334若要要求收件者具有儲存庫存取權限，或從共享工作階段中隱藏您的名稱，請前往 [**設定 > Claude Code > 共享設定**](https://claude.ai/settings/claude-code)。352若要要求收件者具有儲存庫存取權限，或從共享工作階段中隱藏您的名稱，請前往 [**設定 > Claude Code > 共享設定**](https://claude.ai/settings/claude-code)。

335 353 

421 無法取得組織 UUID439 無法取得組織 UUID

422</h3>440</h3>

423 441 

424`claude --cloud` 和 `claude --teleport` 需要使用 claude.ai 帳戶登入。如果您使用 API 金鑰進行驗證，或您的儲存帳戶詳細資訊已過期，這些命令會失敗，出現 `Unable to get organization UUID` 或訊息表示 API 金鑰驗證不足。使用 API 金鑰驗證或過期的帳戶詳細資訊，執行 `claude --teleport` 而不使用工作階段 ID 會在工作階段選擇器中顯示 `Error loading Claude Code sessions`，而不是任一訊息，相同的修復適用。442`claude --cloud` 和 `claude --teleport` 需要使用 claude.ai 帳戶登入。如果您使用 API 金鑰進行身分驗證，或您儲存的帳戶詳細資訊已過期，您會看到以下其中一項：

443 

444* `Unable to get organization UUID`

445* 表示 API 金鑰身分驗證不足的訊息

446* 在不提供工作階段 ID 的情況下執行 `claude --teleport` 時，工作階段選擇器中出現 `Error loading Claude Code sessions`

425 447 

426執行 `/login` 以使用您的 claude.ai 帳戶登入，然後重試命令。如果錯誤命名您的提供者，請參閱[錯誤表](#output-and-errors)：雲端工作階段無法通過第三方提供者使用。448執行 `/login` 以使用您的 claude.ai 帳戶登入，然後重試命令。如果錯誤改為指出您的提供者名稱，請參閱[錯誤表](#errors-when-sending-to-a-cloud-session)：雲端工作階段無法透過第三方提供者使用。

427 449 

428<h3 id="remote-control-session-expired-or-access-denied">450<h3 id="remote-control-session-expired-or-access-denied">

429 遠端控制工作階段已過期或存取被拒絕451 遠端控制工作階段已過期或存取被拒絕

435* 確認您登入到擁有工作階段的相同帳戶457* 確認您登入到擁有工作階段的相同帳戶

436* 如果您看到 `Remote Control may not be available for this organization`，擁有者尚未為您的組織啟用雲端工作階段458* 如果您看到 `Remote Control may not be available for this organization`，擁有者尚未為您的組織啟用雲端工作階段

437 459 

460<h3 id="errors-when-sending-to-a-cloud-session">

461 傳送至雲端工作階段時的錯誤

462</h3>

463 

464這些錯誤來自使用 [`--cloud <session-id>`](#send-follow-ups-from-the-cli) 執行 `claude`，無論是否搭配 `-p`。CLI 會在錯誤前加上 `Error: ` 前綴。傳送失敗會包裝為 `failed to send message to cloud session <id>: <reason>`。

465 

466| 訊息 | 含義 |

467| - | - |

468| `Cloud sessions aren't available with <provider>. They run on Anthropic's infrastructure and require an Anthropic account.` | Claude Code 已設定為使用第三方提供者。訊息會以您的設定所使用的標籤指出提供者名稱，例如 `Amazon Bedrock` 或 `Google Vertex AI`。請移除該提供者的設定，例如取消設定 `CLAUDE_CODE_USE_BEDROCK`，並使用 Anthropic 帳戶登入（`claude auth login`）。 |

469| `Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.` | `allow_remote_sessions` 組織政策已關閉。 |

470| `Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.` | Claude Code 無法取得您組織的政策，因此會拒絕傳送，而不是假設允許雲端工作階段。請檢查您的網路連線並重試。 |

471| `Attaching to an existing cloud session is not enabled for your account.` | 您在未使用 `-p` 的情況下執行了 `--cloud <session-id>`。請使用 `claude -p "your message" --cloud <session-id>` 傳送訊息。 |

472| `Session not found: <id>` | 該 ID 或 URL 與您可存取的任何工作階段都不相符。請對照工作階段的 claude.ai/code URL 進行檢查。 |

473| `cloud session <id> is archived and cannot accept new messages` | 該工作階段已封存。請改為啟動新的工作階段。 |

474 

438<h3 id="environment-expired">475<h3 id="environment-expired">

439 環境已過期476 環境已過期

440</h3>477</h3>

441 478 

442雲端工作階段在不活動一段時間後停止，工作階段的 VM 被回收。工作階段在等待您批准 [MCP 連接器](/docs/zh-TW/cloud-environments#network-access)工具呼叫或登入 MCP 伺服器時計為不活動，並且可以在該等待期間過期。479雲端工作階段在不活動一段時間後停止，工作階段的 VM 被回收。工作階段在等待您批准 [MCP 連接器](/docs/zh-TW/cloud-environments#network-access)工具呼叫或登入 MCP 伺服器時計為不活動，並且可以在該等待期間過期。

443 480 

444從 [claude.ai/code](https://claude.ai/code) 重新開啟工作階段以佈建新 VM，並恢復您的對話歷史記錄。在 VM 被回收時仍在執行的背景工作，例如 subagents 和 shell 命令，不會被恢復。481從 [claude.ai/code](https://claude.ai/code) 重新開啟工作階段以佈建新 VM：

482 

483* **會恢復**：您的對話歷史記錄

484* **不會恢復**：在 VM 被回收時仍在執行的背景工作，例如 subagents 和 shell 命令

445 485 

446<h2 id="limitations">486<h2 id="limitations">

447 限制487 限制

1455| `managed-settings.json` | 系統層級，因作業系統而異 | 企業強制執行的設定，您無法覆寫，除了[狹隘的例外](/docs/zh-TW/settings#security-keys-where-the-stricter-value-applies)。請參閱[檔案儲存位置](/docs/zh-TW/managed-settings#deploy-a-managed-settings-file)和 [Claude Code 使用的受管來源](/docs/zh-TW/managed-settings#precedence-within-the-managed-tier)。 |1455| `managed-settings.json` | 系統層級，因作業系統而異 | 企業強制執行的設定，您無法覆寫，除了[狹隘的例外](/docs/zh-TW/settings#security-keys-where-the-stricter-value-applies)。請參閱[檔案儲存位置](/docs/zh-TW/managed-settings#deploy-a-managed-settings-file)和 [Claude Code 使用的受管來源](/docs/zh-TW/managed-settings#precedence-within-the-managed-tier)。 |

1456| `CLAUDE.local.md` | 專案根目錄 | 您對此專案的私人偏好設定，與 CLAUDE.md 一起載入。手動建立它並將其新增至 `.gitignore`。 |1456| `CLAUDE.local.md` | 專案根目錄 | 您對此專案的私人偏好設定，與 CLAUDE.md 一起載入。手動建立它並將其新增至 `.gitignore`。 |

1457| `AGENTS.md` | 專案根目錄、`.claude/` 或任何目錄 | 您為 AI 編碼代理撰寫的專案指示。Claude Code 可以[自行載入它](/docs/zh-TW/memory#agents-md)或與 `CLAUDE.md` 一起載入。 |1457| `AGENTS.md` | 專案根目錄、`.claude/` 或任何目錄 | 您為 AI 編碼代理撰寫的專案指示。Claude Code 可以[自行載入它](/docs/zh-TW/memory#agents-md)或與 `CLAUDE.md` 一起載入。 |

1458| 已安裝的 plugins | `~/.claude/plugins` | 複製的市集、已安裝的 plugin 版本、`installed_plugins.json` 安裝記錄，以及各 plugin 資料，由 `claude plugin` 命令管理。從您的 claude.ai 帳戶[同步的 plugins](/docs/zh-TW/plugins/loading#synced-plugins) 會下載到 `~/.claude/plugins/synced/`。對於從市集[`command` 來源](/docs/zh-TW/plugins/marketplace-reference#command-plugin-source)以連結模式安裝的 plugin，Claude Code 會在此儲存連結而不是副本，plugin 的檔案保留在命令列印的目錄中。`command` 來源需要 Claude Code v2.1.229 或更新版本。本機目錄市集中以相對路徑列出的 plugin 也會[就地載入](/docs/zh-TW/plugins/loading#find-plugins-on-disk)其來源目錄，而不是從快取副本載入。請參閱[plugin 快取](/docs/zh-TW/plugins/loading#find-plugins-on-disk)以了解孤立版本如何被清理。 |1458| 已安裝的外掛 | `~/.claude/plugins` | 複製的市集、已安裝的外掛版本、`installed_plugins.json` 安裝記錄，以及各外掛資料，由 `claude plugin` 命令管理。從您的 claude.ai 帳戶[同步的外掛](/docs/zh-TW/plugins/loading#synced-plugins)會下載到 `~/.claude/plugins/synced/`。對於從市集[`command` 來源](/docs/zh-TW/plugins/marketplace-reference#command-plugin-source)以連結模式安裝的外掛，Claude Code 會在此儲存連結而不是副本，外掛的檔案保留在命令列印的目錄中。`command` 來源需要 Claude Code v2.1.229 或更新版本。在您從本機路徑新增的市集中以相對路徑列出的外掛，也會從其來源目錄[就地載入](/docs/zh-TW/plugins/loading#find-plugins-on-disk)，而不是從快取副本載入。請參閱[外掛快取](/docs/zh-TW/plugins/loading#find-plugins-on-disk)以了解孤立版本如何被清理。 |

1459 1459 

1460`~/.claude` 也保存 Claude Code 在您工作時寫入的資料：文字記錄、提示歷史記錄、檔案快照、快取和日誌。請參閱下方的[應用程式資料](#application-data)。1460`~/.claude` 也保存 Claude Code 在您工作時寫入的資料：文字記錄、提示歷史記錄、檔案快照、快取和日誌。請參閱下方的[應用程式資料](#application-data)。

1461 1461 

26 26 

27* **CLI 流程（例如 `/web-setup`）**：為您建立 **Default**27* **CLI 流程（例如 `/web-setup`）**：為您建立 **Default**

28* **Pro 和 Max 上的網頁上線設定**：為您建立 **Default**28* **Pro 和 Max 上的網頁上線設定**：為您建立 **Default**

29* **Team 和 Enterprise 上的網頁上線設定**：顯示 **Create your first cloud environment** 表單，除非擁有者已開啟[快速網頁設定](/docs/zh-TW/claude-code-on-the-web#github-authentication-options)；保持表單的預設值並點擊 **Create & finish** 以取得相同的 **Default** 環境29* **Team 和 Enterprise 上的網頁上線設定**：顯示 **Create your first cloud environment** 表單，除非擁有者已開啟[快速網頁設定](/docs/zh-TW/claude-code-on-the-web#quick-web-setup-for-team-and-enterprise)；保持表單的預設值並點擊 **Create & finish** 以取得相同的 **Default** 環境

30 30 

31**Default** 本身不帶有任何設定：31**Default** 本身不帶有任何設定：

32 32 

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* 在[全螢幕渲染](/docs/zh-TW/fullscreen#use-the-mouse)中，點擊省略了部分訊息的預覽行，即可就地展開。

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

196 197 

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

369* **Unhide apps when Claude finishes**：當電腦使用未在背景執行時，Claude 工作時會隱藏您的其他視窗，以便它僅與批准的應用程式互動。當 Claude 完成時，隱藏的視窗會被恢復，除非您關閉此設定。369* **Unhide apps when Claude finishes**：當電腦使用未在背景執行時，Claude 工作時會隱藏您的其他視窗，以便它僅與批准的應用程式互動。當 Claude 完成時，隱藏的視窗會被恢復，除非您關閉此設定。

370 370 

371<h2 id="manage-sessions">371<h2 id="manage-sessions">

372 管理會話372 管理工作階段

373</h2>373</h2>

374 374 

375每個會話都是一個獨立的對話，具有自己的上下文和變更。您可以並行執行多個會話、分支出側邊聊天、讓 Claude 檢查並傳送訊息到您的其他會話、將工作傳送到雲端，或讓 Dispatch 從您的手機為您啟動會話。375每個工作階段都是一個獨立的對話，具有自己的上下文和變更。您可以並行執行多個工作階段、分支出側邊聊天、讓 Claude 檢查並傳送訊息到您的其他工作階段、將工作傳送到雲端，或讓 Dispatch 從您的手機為您啟動工作階段。

376 376 

377<h3 id="work-in-parallel-with-sessions">377<h3 id="work-in-parallel-with-sessions">

378 使用會話並行工作378 使用工作階段並行工作

379</h3>379</h3>

380 380 

381點擊側邊欄中的 **+ New session**，或在 macOS 上按 **Cmd+N** 或在 Windows 上按 **Ctrl+N**，以並行處理多個任務。按 **Ctrl+Tab** 和 **Ctrl+Shift+Tab** 以循環瀏覽側邊欄中的會話。對於 Git 儲存庫，選擇分支名稱旁邊的 **worktree** 選項，以使用 [Git worktrees](/docs/zh-TW/worktrees) 為會話提供自己的隔離專案副本，因此一個會話中的變更不會影響其他會話，直到您提交它們。381點擊側邊欄中的 **+ New session**，或在 macOS 上按 **Cmd+N** 或在 Windows 上按 **Ctrl+N**，以並行處理多個任務。按 **Ctrl+Tab** 和 **Ctrl+Shift+Tab** 以循環瀏覽側邊欄中的工作階段。對於 Git 儲存庫，選擇分支名稱旁邊的 **worktree** 選項，以使用 [Git worktrees](/docs/zh-TW/worktrees) 為工作階段提供自己的隔離專案副本，因此一個工作階段中的變更不會影響其他工作階段，直到您提交它們。

382 382 

383若要同時檢視兩個會話，請在 macOS 上按住 **Cmd** 或在 Windows 上按住 **Ctrl**，然後點擊側邊欄中的會話。會話會在您已開啟的會話旁邊的第二個窗格中開啟。當分割處於活動狀態時，點擊另一個側邊欄會話會取代具有焦點的窗格。在 macOS 上按 **Cmd+\\** 或在 Windows 上按 **Ctrl+\\** 以關閉焦點窗格並返回單一會話。383若要同時檢視兩個工作階段，請在 macOS 上按住 **Cmd** 或在 Windows 上按住 **Ctrl**，然後點擊側邊欄中的工作階段。工作階段會在您已開啟的工作階段旁邊的第二個窗格中開啟。當分割處於活動狀態時，點擊另一個側邊欄工作階段會取代具有焦點的窗格。在 macOS 上按 **Cmd+\\** 或在 Windows 上按 **Ctrl+\\** 以關閉焦點窗格並返回單一工作階段。

384 384 

385Worktrees 預設儲存在 `<project-root>/.claude/worktrees/` 中。您可以在「設定」→「Claude Code」下的「Worktree location」中將其變更為自訂目錄。您也可以設定一個分支前綴，該前綴會被加在每個 worktree 分支名稱前面，這對於保持 Claude 建立的分支井然有序很有用。若要在完成後移除 worktree，請將滑鼠懸停在側邊欄中的會話上，然後點擊存檔圖示。若要在 PR 合併或關閉後自動存檔會話，請在「設定」→「Claude Code」中開啟 **Auto-archive after PR merge or close**。自動存檔僅適用於已完成執行的本機會話。385Worktrees 預設儲存在 `<project-root>/.claude/worktrees/` 中。您可以在「設定」→「Claude Code」下的「Worktree location」中將其變更為自訂目錄。您也可以設定一個分支前綴，該前綴會被加在每個 worktree 分支名稱前面，這對於保持 Claude 建立的分支井然有序很有用。若要在完成後移除 worktree，請將滑鼠懸停在側邊欄中的工作階段上，然後點擊存檔圖示。若要在 pull request 合併或關閉後自動存檔工作階段，請在「設定」→「Claude Code」中開啟 **Auto-archive after PR merge or close**。自動存檔僅適用於已完成執行的本機工作階段。

386 386 

387若要在新 worktrees 中包含 gitignored 檔案（如 `.env`），請在您的專案根目錄中建立 [`.worktreeinclude` 檔案](/docs/zh-TW/worktrees#copy-gitignored-files-into-worktrees)。387若要在新 worktrees 中包含 gitignored 檔案（如 `.env`），請在您的專案根目錄中建立 [`.worktreeinclude` 檔案](/docs/zh-TW/worktrees#copy-gitignored-files-into-worktrees)。

388 388 

389<Note>389<Note>

390 會話隔離需要 [Git](https://git-scm.com/downloads)。大多數 Mac 預設包含 Git。在終端機中執行 `git --version` 進行檢查；如果它列印版本號，表示已安裝 Git。如果您遇到 Git 錯誤，請在 [Cowork 標籤](https://claude.com/product/cowork) 中詢問 Claude 以幫助排除您的設定問題。390 工作階段隔離需要 [Git](https://git-scm.com/downloads)。大多數 Mac 預設包含 Git。在終端機中執行 `git --version` 進行檢查；如果它列印版本號，表示已安裝 Git。如果您遇到 Git 錯誤，請在 [Cowork 標籤](https://claude.com/product/cowork) 中詢問 Claude 以幫助排除您的設定問題。

391</Note>391</Note>

392 392 

393使用側邊欄頂部的控制項按狀態、專案或環境篩選會話，並按專案分組會話。若要重新命名會話，請點擊活動會話頂部工具列中的會話標題。393使用側邊欄頂部的控制項按狀態、專案或環境篩選工作階段，並按專案分組工作階段。若要重新命名工作階段，請點擊活動工作階段頂部工具列中的工作階段標題。

394 394 

395若要檢查上下文使用情況，請參閱[檢查使用情況](#check-usage)。當上下文填滿時，Claude 會自動總結對話並繼續工作。您也可以輸入 `/compact` 來更早觸發總結並釋放上下文空間。有關壓縮如何運作的詳細資訊，請參閱[上下文視窗](/docs/zh-TW/how-claude-code-works#the-context-window)。395若要檢查上下文使用情況，請參閱[檢查使用情況](#check-usage)。當上下文填滿時，Claude 會自動總結對話並繼續工作。您也可以輸入 `/compact` 來更早觸發總結並釋放上下文空間。有關壓縮如何運作的詳細資訊，請參閱[上下文視窗](/docs/zh-TW/how-claude-code-works#the-context-window)。

396 396 

397桌面應用程式會在 Code 會話完成任務且您目前未檢視該會話時傳送作業系統通知。對於屬於[專案](/docs/zh-TW/claude-projects#see-what-needs-you-in-overview)的會話，您會改為收到專案的通知。397桌面應用程式會在 Code 工作階段完成任務且您目前未檢視該工作階段時傳送作業系統通知。對於屬於[專案](/docs/zh-TW/claude-projects#see-what-needs-you-in-overview)的工作階段，您會改為收到專案的通知。

398 398 

399<h3 id="ask-a-side-question-without-derailing-the-session">399<h3 id="ask-a-side-question-without-derailing-the-session">

400 在不偏離會話的情況下詢問側邊問題400 在不偏離工作階段的情況下詢問側邊問題

401</h3>401</h3>

402 402 

403側邊聊天讓您詢問 Claude 一個使用您會話上下文的問題，但不會將任何內容新增回主對話。當您想要理解一段程式碼、檢查假設或探索想法而不引導會話偏離時，請使用它。403側邊聊天讓您詢問 Claude 一個使用您工作階段上下文的問題，但不會將任何內容新增回主對話。當您想要理解一段程式碼、檢查假設或探索想法而不引導工作階段偏離時，請使用它。

404 404 

405在 macOS 上按 **Cmd+;** 或在 Windows 上按 **Ctrl+;** 以開啟側邊聊天，或在提示框中輸入 `/btw`。側邊聊天可以讀取主執行緒中到該點為止的所有內容。完成後，關閉側邊聊天並在您離開的地方繼續主會話。405在 macOS 上按 **Cmd+;** 或在 Windows 上按 **Ctrl+;** 以開啟側邊聊天，或在提示詞輸入框中輸入 `/btw`。側邊聊天可以讀取主執行緒中到該點為止的所有內容。完成後，關閉側邊聊天並在您離開的地方繼續主工作階段。

406 406 

407側邊聊天在本機、SSH 和 WSL 會話中可用。桌面應用程式不會將側邊聊天儲存到磁碟，因此您在關閉應用程式後無法返回到一個。407側邊聊天在本機、SSH 和 WSL 工作階段中可用。桌面應用程式不會將側邊聊天儲存到磁碟，因此您在關閉應用程式後無法返回到一個。

408 408 

409<h3 id="watch-background-tasks">409<h3 id="watch-background-tasks">

410 觀看背景任務410 觀看背景任務

411</h3>411</h3>

412 412 

413任務窗格顯示在目前會話內執行的背景工作：子代理、背景 shell 命令和[動態工作流程](/docs/zh-TW/workflows)。從 **Views** 選單開啟它或將其拖入您的佈局。413任務窗格顯示在目前工作階段內執行的背景工作：subagents、背景 shell 命令和[動態工作流程](/docs/zh-TW/workflows)。從 **Views** 選單開啟它或將其拖入您的佈局。

414 414 

415點擊任何項目以在子代理窗格中查看其輸出或停止它。若要查看其他會話正在執行的操作，請使用[側邊欄](#work-in-parallel-with-sessions)，或詢問 Claude [為您檢查它們](#work-across-sessions)。415點擊任何項目以在 subagent 窗格中查看其輸出或停止它。若要查看其他工作階段正在執行的操作，請使用[側邊欄](#work-in-parallel-with-sessions)，或詢問 Claude [為您檢查它們](#work-across-sessions)。

416 416 

417<h3 id="work-across-sessions">417<h3 id="work-across-sessions">

418 跨會話工作418 跨工作階段工作

419</h3>419</h3>

420 420 

421Claude 可以列出您的其他 Code 標籤會話、讀取每個會話一直在執行的操作，以及在它們之間傳送訊息。以純文字詢問：「哪個會話涉及了身份驗證重構？」、「API 會話得出了什麼結論？」或「告訴付款會話架構已變更」。您也可以詢問 Claude 重新命名或存檔會話。Claude 存檔會話的方式與側邊欄的存檔圖示相同，因此詢問它清理 PR 已合併的會話。421Claude 可以列出您的其他 Code 標籤工作階段、讀取每個工作階段一直在執行的操作，以及在它們之間傳送訊息。以日常用語詢問：「哪個工作階段涉及了身份驗證重構？」、「API 工作階段得出了什麼結論？」或「告訴付款工作階段 schema 已變更」。您也可以詢問 Claude 重新命名或存檔工作階段。Claude 存檔工作階段的方式與側邊欄的存檔圖示相同，因此可以請它清理 PR 已合併的工作階段。

422 422 

423透過此介面，Claude 只能看到桌面應用程式本身執行的會話：本機、[SSH](#ssh-sessions) 和 Code 標籤中的 [WSL](/docs/zh-TW/desktop-wsl) 會話。Claude 看不到雲端會話，或您從終端機 CLI 或 VS Code 擴充功能啟動的會話，即使在同一專案的 worktrees 中也是如此，因此有九個終端機 worktrees 開啟和兩個桌面會話時，Claude 在其中一個回答會報告另一個桌面會話。Claude 永遠不會列出您詢問的會話。預設情況下，它會看到 20 個最近活躍的會話，並跳過已存檔的會話，除非您要求它們。[跨會話傳訊](/docs/zh-TW/cross-session-messaging)另外讓 Claude 傳送訊息到[您的其他 Claude Code 會話](/docs/zh-TW/cross-session-messaging#see-which-sessions-claude-can-reach)，包括終端機會話。423透過此使用介面，Claude 只能看到桌面應用程式本身執行的工作階段：Code 標籤中的本機、[SSH](#ssh-sessions) 和 [WSL](/docs/zh-TW/desktop-wsl) 工作階段。Claude 看不到雲端工作階段，或您從終端機 CLI 或 VS Code 擴充功能啟動的工作階段，即使在同一專案的 worktrees 中也是如此，因此有九個終端機 worktrees 開啟和兩個桌面工作階段時，Claude 在其中一個回答會報告另一個桌面工作階段。Claude 永遠不會列出您詢問的工作階段。預設情況下，它會看到 20 個最近活躍的工作階段，並跳過已存檔的工作階段，除非您要求它們。[跨工作階段傳訊](/docs/zh-TW/cross-session-messaging)另外讓 Claude 傳送訊息到[您的其他 Claude Code 工作階段](/docs/zh-TW/cross-session-messaging#see-which-sessions-claude-can-reach)，包括終端機工作階段。

424 424 

425當 Claude 透過此介面傳送訊息到另一個會話時，Claude Code 會在那裡將其顯示為一張卡片，標籤為傳送會話的標題和返回連結，因此您總是可以看到訊息來自何處。如果接收會話正在執行任務中，Claude Code 會保留訊息，Claude 會在目前工作完成後讀取它。接收 Claude 可以回覆，Claude Code 會透過此介面傳遞回覆。Claude 無法傳遞到已存檔的會話，並會在訊息未通過時告訴您。425當 Claude 透過此使用介面傳送訊息到另一個工作階段時，Claude Code 會在那裡將其顯示為一張卡片，標籤為傳送工作階段的標題和返回連結，因此您總是可以看到訊息來自何處。如果接收工作階段正在執行任務中，Claude Code 會保留訊息，Claude 會在目前工作完成後讀取它。接收端的 Claude 可以回覆，Claude Code 會透過此使用介面傳遞回覆。Claude 無法傳遞到已存檔的工作階段，並會在訊息未送達時告訴您。

426 426 

427Claude Code 在會話間應用四個安全行為：427Claude Code 在工作階段間應用四個安全行為：

428 428 

429* 在存檔任何會話之前，Claude 會先詢問您。您會在每個權限模式中看到批准卡片，包括自動和略過權限。429* 在存檔任何工作階段之前，Claude 會先詢問您。您會在每個權限模式中看到核准卡片，包括自動和略過權限。

430* 透過此介面，Claude 無法從沒有人監視的會話（例如排程任務執行）傳送跨會話訊息，也無法傳遞訊息到一個。430* 透過此使用介面，Claude 無法從沒有人監視的工作階段（例如排程任務執行）傳送跨工作階段訊息，也無法傳遞訊息到這類工作階段。

431* Claude Code 會根據接收會話的[入站控制](/docs/zh-TW/cross-session-messaging#control-inbound-messages)檢查來自此介面的每條訊息，即使接收會話本身沒有[跨會話傳訊](/docs/zh-TW/cross-session-messaging#availability)。如果您在接收會話中將 [`crossSessionInbound`](/docs/zh-TW/settings-reference#crosssessioninbound) 設定為 `refuse`，Claude Code 會丟棄來自此介面的訊息。Claude Code 會向 Claude 桌面應用程式報告拒絕。在 v2.1.234 之前，Claude Code 會丟棄來自此介面到沒有跨會話傳訊的接收會話的每條訊息。431* Claude Code 會根據接收工作階段的[入站控制](/docs/zh-TW/cross-session-messaging#control-inbound-messages)檢查來自此使用介面的每條訊息，即使接收工作階段本身沒有[跨工作階段傳訊](/docs/zh-TW/cross-session-messaging#availability)。如果您在接收工作階段中將 [`crossSessionInbound`](/docs/zh-TW/settings-reference#crosssessioninbound) 設定為 `refuse`，Claude Code 會丟棄來自此使用介面的訊息。Claude Code 會向 Claude 桌面應用程式報告拒絕。在 v2.1.234 之前，Claude Code 會丟棄來自此使用介面到沒有跨工作階段傳訊的接收工作階段的每條訊息。

432* Claude Code 引用每條傳入訊息並將其歸因於傳送它的會話，Claude 在對其進行操作時仍然遵循接收會話自己的權限設定。432* Claude Code 引用每條傳入訊息並將其歸因於傳送它的工作階段，Claude 在對其進行操作時仍然遵循接收工作階段自己的權限設定。

433 433 

434Claude 也可以建議新會話。當它注意到值得修復但超出目前任務範圍的內容時，它會在聊天中提供工作作為任務晶片。點擊晶片以在具有自己 worktree 的新會話中啟動該工作；Claude 會不中斷地繼續您的目前會話。434Claude 也可以建議新工作階段。當它注意到值得修復但超出目前任務範圍的內容時，它會在聊天中以任務晶片的形式提供該工作。點擊晶片以在具有自己 worktree 的新工作階段中啟動該工作；Claude 會不中斷地繼續您的目前工作階段。

435 435 

436<h3 id="run-long-running-tasks-in-the-cloud">436<h3 id="run-long-running-tasks-in-the-cloud">

437 在雲端執行長時間執行的任務437 在雲端執行長時間執行的任務

438</h3>438</h3>

439 439 

440對於大型重構、測試套件、遷移或其他長時間執行的任務，在開始會話時選擇 **Cloud** 而不是 **Local**。雲端會話預設在 Anthropic 管理的基礎設施上執行，即使您關閉應用程式或關閉電腦，也會繼續執行。隨時檢查以查看進度或引導 Claude 朝不同方向發展。您也可以從 [claude.ai/code](https://claude.ai/code) 或 [Claude 行動應用程式](/docs/zh-TW/mobile)監控雲端會話。440對於大型重構、測試套件、遷移或其他長時間執行的任務，在開始工作階段時選擇 **Cloud** 而不是 **Local**。雲端工作階段預設在 Anthropic 管理的基礎設施上執行，即使您關閉應用程式或關閉電腦，也會繼續執行。隨時檢查以查看進度或引導 Claude 朝不同方向發展。您也可以從 [claude.ai/code](https://claude.ai/code) 或 [Claude 行動應用程式](/docs/zh-TW/mobile)監控雲端工作階段。

441 441 

442雲端會話也支援多個儲存庫。選擇雲端環境後，點擊所選儲存庫旁邊的 **+** 按鈕，將其他儲存庫新增到會話。每個儲存庫都有自己的分支選擇器。這對於跨越多個程式碼庫的任務很有用，例如更新共用程式庫及其使用者。442雲端工作階段也支援多個儲存庫。選擇雲端環境後，點擊所選儲存庫旁邊的 **+** 按鈕，將其他儲存庫新增到工作階段。每個儲存庫都有自己的分支選擇器。這對於跨越多個程式碼庫的任務很有用，例如更新共用程式庫及其使用者。

443 443 

444有關雲端會話如何運作的更多資訊，請參閱[在網路上使用 Claude Code](/docs/zh-TW/claude-code-on-the-web)。當一項工作需要許多雲端會話時，請在側邊欄中選擇 **Projects** 以建立[專案](/docs/zh-TW/claude-projects)，Claude 會從一個對話中為您啟動並追蹤會話。444有關雲端工作階段如何運作的更多資訊，請參閱[在雲端使用 Claude Code](/docs/zh-TW/claude-code-on-the-web)。當一項工作需要許多雲端工作階段時，請在側邊欄中選擇 **Projects** 以建立[專案](/docs/zh-TW/claude-projects)，Claude 會從一個對話中為您啟動並追蹤工作階段。

445 445 

446<h3 id="continue-in-another-surface">446<h3 id="continue-in-another-surface">

447 在另一個介面中繼續447 在另一個使用介面中繼續

448</h3>448</h3>

449 449 

450**Continue in** 選單可從會話工具列右下角的 VS Code 圖示存取，可讓您將會話移至另一個介面：450若要在其他地方繼續工作階段，請從工作階段標題旁的插入符號或側邊欄中該工作階段的列開啟工作階段選單，然後選擇 **Open in**：

451 451 

452* **Claude Code on the Web**：將您的本機會話傳送到雲端繼續執行。Desktop 推送您的分支、產生對話摘要，並使用完整上下文建立新的雲端會話。然後您可以選擇存檔本機會話或保留它。這需要乾淨的工作樹，不適用於 SSH 會話。452* 選擇 **Cloud** 以將工作階段作為[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)繼續，您的對話會以摘要形式帶過去。在您確認之前，對話框會說明您的檔案是否也會一併移動，以及雲端工作階段準備就緒後是否會存檔此工作階段。透過 [SSH](#ssh-sessions) 或在 [WSL](/docs/zh-TW/desktop-wsl) 中執行的工作階段無法以此方式移動。

453* **Your IDE**：在目前工作目錄的支援 IDE 中開啟您的專案。453* 選擇已安裝的編輯器或您的檔案管理器，以在其中開啟該工作階段在磁碟上的資料夾。

454 454 

455<h3 id="sessions-from-dispatch">455<h3 id="sessions-from-dispatch">

456 來自 Dispatch 的會話456 來自 Dispatch 的工作階段

457</h3>457</h3>

458 458 

459[Dispatch](https://support.claude.com/en/articles/13947068) 是與 Claude 的持久對話，存在於 [Cowork](https://claude.com/product/cowork) 標籤中。您向 Dispatch 傳送任務，它決定如何處理它。459[Dispatch](https://support.claude.com/en/articles/13947068) 是與 Claude 的持久對話，存在於 [Cowork](https://claude.com/product/cowork) 標籤中。您向 Dispatch 傳送任務，它決定如何處理它。

460 460 

461任務可以透過兩種方式成為 Code 會話：您直接要求一個，例如「開啟 Claude Code 會話並修復登入錯誤」，或 Dispatch 決定任務是開發工作並自行產生一個。通常路由到 Code 的任務包括修復錯誤、更新相依性、執行測試或開啟提取請求。研究、文件編輯和試算表工作保留在 Cowork 中。461任務可以透過兩種方式成為 Code 工作階段：您直接要求一個，例如「開啟 Claude Code 工作階段並修復登入錯誤」，或 Dispatch 決定任務是開發工作並自行產生一個。通常路由到 Code 的任務包括修復錯誤、更新相依性、執行測試或開啟 pull request。研究、文件編輯和試算表工作保留在 Cowork 中。

462 462 

463無論哪種方式，Code 會話都會在 Code 標籤的側邊欄中出現，帶有 **Dispatch** 徽章。當它完成或需要您的批准時，您會在手機上收到推送通知。463無論哪種方式，Code 工作階段都會在 Code 標籤的側邊欄中出現，帶有 **Dispatch** 徽章。當它完成或需要您的核准時，您會在手機上收到推送通知。

464 464 

465如果您已[啟用電腦使用](#let-claude-use-your-computer)，Dispatch 產生的 Code 會話也可以使用它。這些會話中的應用程式批准在 30 分鐘後過期並重新提示，而不是像常規 Code 會話那樣持續整個會話。465如果您已[啟用電腦使用](#let-claude-use-your-computer)，Dispatch 產生的 Code 工作階段也可以使用它。這些工作階段中的應用程式核准在 30 分鐘後過期並重新提示，而不是像常規 Code 工作階段那樣持續整個工作階段。

466 466 

467有關設定、配對和 Dispatch 設定，請參閱 [Dispatch 幫助文章](https://support.claude.com/en/articles/13947068)。Dispatch 需要 Pro 或 Max 計畫，在 Team 或 Enterprise 計畫上不可用。467有關設定、配對和 Dispatch 設定，請參閱 [Dispatch 幫助文章](https://support.claude.com/en/articles/13947068)。Dispatch 需要 Pro 或 Max 計畫，在 Team 或 Enterprise 計畫上不可用。

468 468 

739 739 

740[Extended thinking](/docs/zh-TW/model-config#extended-thinking) 預設啟用，這改進了複雜推理任務的效能，但使用額外的 tokens。在 Anthropic API 上，在本機環境編輯器中將 `MAX_THINKING_TOKENS` 設定為 `0` 以關閉思考；這對 Opus 5.5、Sonnet 5.5 或 Fable 模型沒有影響，它們始終使用 extended thinking。在 Anthropic API 上關閉思考後，Claude Code 會傳送 effort `high` 而不是更高的級別給它知道[不接受該組合](/docs/zh-TW/errors#effort-isnt-available-with-thinking-turned-off)的模型，例如 Opus 5。740[Extended thinking](/docs/zh-TW/model-config#extended-thinking) 預設啟用，這改進了複雜推理任務的效能，但使用額外的 tokens。在 Anthropic API 上，在本機環境編輯器中將 `MAX_THINKING_TOKENS` 設定為 `0` 以關閉思考；這對 Opus 5.5、Sonnet 5.5 或 Fable 模型沒有影響，它們始終使用 extended thinking。在 Anthropic API 上關閉思考後，Claude Code 會傳送 effort `high` 而不是更高的級別給它知道[不接受該組合](/docs/zh-TW/errors#effort-isnt-available-with-thinking-turned-off)的模型，例如 Opus 5。

741 741 

742在具有[自適應推理](/docs/zh-TW/model-config#adjust-effort-level)的模型上，除了 `0` 以外的 `MAX_THINKING_TOKENS` 值會被忽略，因為自適應推理控制思考深度。在 Opus 4.6 和 Sonnet 4.6 上，將 `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` 設定為 `1` 以使用固定思考預算；Fable 模型、Sonnet 5 及更新版本，以及 Opus 4.7 及更新版本始終使用自適應推理，沒有固定預算模式。742在具有[自適應推理](/docs/zh-TW/model-config#adjust-effort-level)的模型上，對於正值的 `MAX_THINKING_TOKENS`，Claude Code 會忽略該數值本身，因為改由自適應推理控制思考深度。在 Opus 4.6 和 Sonnet 4.6 上，將 `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` 設定為 `1` 以使用固定思考預算；Fable 模型、Sonnet 5 及更新版本，以及 Opus 4.7 及更新版本始終使用自適應推理，沒有固定預算模式。

743 743 

744<h4 id="local-sessions-on-managed-devices">744<h4 id="local-sessions-on-managed-devices">

745 受管設備上的本機會話745 受管設備上的本機會話

135 135 

136**將 Claude 排程執行。** 設定[排程工作](/docs/zh-TW/desktop-scheduled-tasks)以定期自動執行 Claude：每天早上進行程式碼審查、每週進行相依性稽核，或從您連接的工具提取資訊的簡報。136**將 Claude 排程執行。** 設定[排程工作](/docs/zh-TW/desktop-scheduled-tasks)以定期自動執行 Claude：每天早上進行程式碼審查、每週進行相依性稽核，或從您連接的工具提取資訊的簡報。

137 137 

138**準備好時進行擴展。** 從側邊欄開啟[平行工作階段](/docs/zh-TW/desktop#work-in-parallel-with-sessions)以同時處理多個工作，可選擇每個工作都在自己的 Git worktree 中，並開啟[工作窗格](/docs/zh-TW/desktop#watch-background-tasks)以監控工作階段正在執行的子代理和背景命令。開啟[側邊聊天](/docs/zh-TW/desktop#ask-a-side-question-without-derailing-the-session)以提出問題而不會偏離主線。將[長期執行的工作發送到雲端](/docs/zh-TW/desktop#run-long-running-tasks-in-the-cloud)以便即使您關閉應用程式也能繼續執行，或[在網路或 IDE 中繼續工作階段](/docs/zh-TW/desktop#continue-in-another-surface)（如果工作耗時超過預期）。[連接外部工具](/docs/zh-TW/desktop#extend-claude-code)（例如 GitHub、Slack 和 Linear）以整合您的工作流程。138**準備好時進行擴展。** 從側邊欄開啟[平行工作階段](/docs/zh-TW/desktop#work-in-parallel-with-sessions)以同時處理多個任務，可選擇每個任務都在自己的 Git worktree 中，並開啟[任務窗格](/docs/zh-TW/desktop#watch-background-tasks)以監控工作階段正在執行的 subagents 和背景命令。開啟[側邊聊天](/docs/zh-TW/desktop#ask-a-side-question-without-derailing-the-session)以提出問題而不會偏離主線。將[長期執行的工作發送到雲端](/docs/zh-TW/desktop#run-long-running-tasks-in-the-cloud)以便即使您關閉應用程式也能繼續執行，或在任務耗時超過預期時，[將已開始的工作階段移至雲端](/docs/zh-TW/desktop#continue-in-another-surface)。[連接外部工具](/docs/zh-TW/desktop#extend-claude-code)（例如 GitHub、Slack 和 Linear）以整合您的工作流程。

139 139 

140<h2 id="what’s-next">140<h2 id="what’s-next">

141 接下來141 接下來

124 變數124 變數

125</h2>125</h2>

126 126 

127逾時、token 預算與重試次數等數值變數，除了純數字之外，也接受科學記號與數字分隔符號的寫法，但變數所在列註明僅接受純數字者除外。例如，Claude Code 會將 `2e3` 讀取為 2000，將 `64_000` 讀取為 64000。在 v2.1.211 之前，這些寫法可能會在無任何提示的情況下設定成小得多的值，例如 `1e6` 會將逾時設定為 1。127數值型變數（例如逾時、token 預算與重試次數）除了純數字之外，也接受科學記號與數字分隔符寫法，除非該變數所在列註明僅接受純數字。例如，Claude Code 會將 `2e3` 讀取為 2000，將 `64_000` 讀取為 64000。在 v2.1.211 之前，這些寫法可能會在無任何提示的情況下設定成小得多的值，例如 `1e6` 會將逾時設為 1。

128 128 

129<Note>129<Note>

130 對於開啟或關閉某項行為的變數，設定 `1`、`true`、`yes` 或 `on` 可將其開啟，設定 `0`、`false`、`no` 或 `off` 可將其關閉，不區分大小寫。130 對於用來開啟或關閉某項行為的變數，設定 `1`、`true`、`yes` 或 `on` 可將其開啟，設定 `0`、`false`、`no` 或 `off` 可將其關閉，大小寫皆可。

131 131 

132 部分變數只判斷是否有設定，因此任何非空值（包括 `0`）都會開啟該行為，若要關閉該行為，請取消設定該變數或將其設為空值。以下變數採用此方式：132 有些變數只判斷您是否有設定它們，因此任何非空值（包括 `0`）都會開啟該行為；若要關閉該行為，請取消設定該變數或將其設為空值。以下變數即是如此：

133 133 

134 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`134 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`

135 * `DISABLE_TELEMETRY`135 * `DISABLE_TELEMETRY`

138 * `FALLBACK_FOR_ALL_PRIMARY_MODELS`138 * `FALLBACK_FOR_ALL_PRIMARY_MODELS`

139 * `IS_DEMO`139 * `IS_DEMO`

140 140 

141 另有一個變數有其專屬規則：`FORCE_HYPERLINK` 讀取的是數字，因此只有 `0` 會將其關閉。每個變數所在列也會說明其專屬規則。141 另有一個變數有其專屬規則：`FORCE_HYPERLINK` 讀取的是數字，因此只有 `0` 會將其關閉。每個變數所在的列也會說明其各自的規則。

142</Note>142</Note>

143 143 

144| 變數 | 用途 |144| 變數 | 用途 |

145| :- | :- |145| :- | :- |

146| `ANTHROPIC_API_KEY` | 以 `X-Api-Key` 標頭傳送的 API 金鑰。設定後，即使您已登入，也會使用此金鑰，而非您的 Claude Pro、Max、Team 或 Enterprise 訂閱。在非互動模式（`-p`）中，只要存在此金鑰就一律會使用。在互動模式中，系統會在此金鑰覆寫您的訂閱之前，提示您核准一次。若要改用您的訂閱，請執行 `unset ANTHROPIC_API_KEY` |146| `ANTHROPIC_API_KEY` | 以 `X-Api-Key` 標頭傳送的 API 金鑰。設定後，即使您已登入，也會使用此金鑰，而非您的 Claude Pro、Max、Team 或 Enterprise 訂閱。在非互動模式（`-p`）中，只要有此金鑰就一律使用。在互動模式中，系統會提示您核准此金鑰一次，之後它才會覆寫您的訂閱。若要改用您的訂閱，請執行 `unset ANTHROPIC_API_KEY` |

147| `ANTHROPIC_AUTH_TOKEN` | `Authorization` 標頭的自訂值（您在此設定的值會加上 `Bearer ` 前綴） |147| `ANTHROPIC_AUTH_TOKEN` | `Authorization` 標頭的自訂值（您在此設定的值會加上 `Bearer ` 前綴） |

148| `ANTHROPIC_AWS_API_KEY` | [Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws) 的工作區 API 金鑰，於 AWS Console 中產生。以 `x-api-key` 傳送，且優先於 AWS SigV4 |148| `ANTHROPIC_AWS_API_KEY` | [Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws) 的工作區 API 金鑰，於 AWS Console 中產生。以 `x-api-key` 傳送，且優先於 AWS SigV4 |

149| `ANTHROPIC_AWS_BASE_URL` | 覆寫 [Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws) 端點 URL。用於自訂區域，或透過 [LLM 閘道](/docs/zh-TW/llm-gateway)路由時。預設為 `https://aws-external-anthropic.{region}.api.aws`。Claude Code 會以[與 Amazon Bedrock 相同的優先順序](/docs/zh-TW/amazon-bedrock#3-configure-claude-code)解析區域 |149| `ANTHROPIC_AWS_BASE_URL` | 覆寫 [Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws) 端點 URL。用於自訂區域，或透過 [LLM 閘道](/docs/zh-TW/llm-gateway)路由時。預設為 `https://aws-external-anthropic.{region}.api.aws`。Claude Code 解析區域時採用[與 Amazon Bedrock 相同的優先順序](/docs/zh-TW/amazon-bedrock#3-configure-claude-code) |

150| `ANTHROPIC_AWS_WORKSPACE_ID` | [Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws) 的必要項目。在每個請求中以 `anthropic-workspace-id` 標頭傳送 |150| `ANTHROPIC_AWS_WORKSPACE_ID` | [Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws) 必填。在每個請求中以 `anthropic-workspace-id` 標頭傳送 |

151| `ANTHROPIC_BASE_URL` | 覆寫 API 端點，以透過代理伺服器或閘道路由請求。設定為非第一方主機時，[MCP Tool Search](/docs/zh-TW/mcp#scale-with-mcp-tool-search) 預設會停用。如果您的代理伺服器會轉送 `tool_reference` 區塊，請設定 `ENABLE_TOOL_SEARCH=true`。自 v2.1.196 起，當此變數指向 `api.anthropic.com` 以外的主機時，[Remote Control](/docs/zh-TW/remote-control#requirements) 會停用，與其在 Amazon Bedrock、Google Cloud's Agent Platform 及 Microsoft Foundry 上的行為一致 |151| `ANTHROPIC_BASE_URL` | 覆寫 API 端點，以透過代理伺服器或閘道路由請求。設定為非第一方主機時，[MCP tool search](/docs/zh-TW/mcp#scale-with-mcp-tool-search) 預設會停用。若您的代理伺服器會轉送 `tool_reference` 區塊，請設定 `ENABLE_TOOL_SEARCH=true`。自 v2.1.196 起，當此變數指向 `api.anthropic.com` 以外的主機時，[Remote Control](/docs/zh-TW/remote-control#requirements) 會停用，與其在 Amazon Bedrock、Google Cloud's Agent Platform 與 Microsoft Foundry 上的行為一致 |

152| `ANTHROPIC_BEDROCK_BASE_URL` | 覆寫 Amazon Bedrock 端點 URL。用於自訂 Amazon Bedrock 端點，或透過 [LLM 閘道](/docs/zh-TW/llm-gateway)路由時。請參閱 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) |152| `ANTHROPIC_BEDROCK_BASE_URL` | 覆寫 Amazon Bedrock 端點 URL。用於自訂 Amazon Bedrock 端點，或透過 [LLM 閘道](/docs/zh-TW/llm-gateway)路由時。請參閱 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) |

153| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | 覆寫 Amazon Bedrock Mantle 端點 URL。請參閱 [Mantle 端點](/docs/zh-TW/amazon-bedrock#use-the-mantle-endpoint) |153| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | 覆寫 Amazon Bedrock Mantle 端點 URL。請參閱 [Mantle 端點](/docs/zh-TW/amazon-bedrock#use-the-mantle-endpoint) |

154| `ANTHROPIC_BEDROCK_REGION_PREFIX` | Claude Code 優先嘗試的跨區域推論設定檔前綴（`us`、`eu`、`apac`、`jp`、`au` 或 `global`），取代從 AWS 區域推導出的前綴。在 AWS GovCloud 區域中會被忽略。需要 Claude Code v2.1.224 或更新版本。請參閱 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock#cross-region-inference-profile-prefixes) |154| `ANTHROPIC_BEDROCK_REGION_PREFIX` | Claude Code 優先嘗試的跨區域推論設定檔前綴（`us`、`eu`、`apac`、`jp`、`au` 或 `global`），而非根據 AWS 區域推導出的前綴。在 AWS GovCloud 區域中會被忽略。需要 Claude Code v2.1.224 或更新版本。請參閱 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock#cross-region-inference-profile-prefixes) |

155| `ANTHROPIC_BEDROCK_SERVICE_TIER` | Amazon Bedrock [服務層級](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html)（`default`、`flex` 或 `priority`）。以 `X-Amzn-Bedrock-Service-Tier` 標頭傳送。請參閱 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock#service-tiers) |155| `ANTHROPIC_BEDROCK_SERVICE_TIER` | Amazon Bedrock [服務層級](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html)（`default`、`flex` 或 `priority`）。以 `X-Amzn-Bedrock-Service-Tier` 標頭傳送。請參閱 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock#service-tiers) |

156| `ANTHROPIC_BETAS` | 要包含在 API 請求中的額外 `anthropic-beta` 標頭值，以逗號分隔。Claude Code 已會傳送其所需的 beta 標頭；在 Claude Code 加入原生支援之前，可使用此變數選擇加入 [Anthropic API beta](https://platform.claude.com/docs/en/api/beta-headers)。與需要 API 金鑰身分驗證的 [`--betas` 旗標](/docs/zh-TW/cli-reference#cli-flags)不同，此變數適用於所有驗證方式，包括 Claude.ai 訂閱 |156| `ANTHROPIC_BETAS` | 要包含在 API 請求中的其他 `anthropic-beta` 標頭值，以逗號分隔。Claude Code 已會傳送其所需的 beta 標頭；在 Claude Code 加入原生支援之前，可使用此變數選擇加入 [Anthropic API beta](https://platform.claude.com/docs/en/api/beta-headers)。與需要 API 金鑰身分驗證的 [`--betas` 旗標](/docs/zh-TW/cli-reference#cli-flags)不同，此變數適用於所有驗證方式，包括 Claude.ai 訂閱 |

157| `ANTHROPIC_CUSTOM_HEADERS` | 要加入請求的自訂標頭（`Name: Value` 格式，多個標頭以換行分隔）。如果名稱或值包含 HTTP 標頭無法承載的字元，例如彎引號或零寬空格，請求會失敗，並顯示依位置指出該組標頭的錯誤。需要 Claude Code v2.1.227 或更新版本。[Invalid request header value](/docs/zh-TW/errors#invalid-request-header-value) 列出確切的字元集以及檢查執行的位置。設定憑證、組織或租用戶、路由或 API 行為標頭（例如 `Authorization` 或 `Host`）的值，在由伺服器管理的設定傳遞時，會被視為[需要核准的設定](/docs/zh-TW/server-managed-settings#environment-variables-and-the-approval-dialog)。若來自專案或本機設定，此類值會遵循[何時套用 `env` 值的規則](/docs/zh-TW/settings-reference#when-claude-code-applies-env-values) |157| `ANTHROPIC_CUSTOM_HEADERS` | 要加入請求的自訂標頭（`Name: Value` 格式，多個標頭以換行分隔）。若名稱或值包含 HTTP 標頭無法承載的字元，例如彎引號或零寬空格，請求會失敗，並顯示依位置指出該組名稱與值的錯誤。需要 Claude Code v2.1.227 或更新版本。[Invalid request header value](/docs/zh-TW/errors#invalid-request-header-value) 列出確切的字元集以及執行檢查的位置。若某個值設定的是憑證、組織或租用戶、路由或 API 行為相關的標頭（例如 `Authorization` 或 `Host`），當由伺服器管理設定傳遞時，該值會視為[需要核准的設定](/docs/zh-TW/server-managed-settings#environment-variables-and-the-approval-dialog)。若來自專案或本機設定，此類值則遵循 [`env` 值何時套用的規則](/docs/zh-TW/settings-reference#when-claude-code-applies-env-values) |

158| `ANTHROPIC_CUSTOM_MODEL_OPTION` | 要在 `/model` 選擇器中新增為自訂項目的模型 ID。可用此變數讓非標準或閘道專屬的模型可供選擇，而不取代內建別名。請參閱[模型設定](/docs/zh-TW/model-config#add-a-custom-model-option) |158| `ANTHROPIC_CUSTOM_MODEL_OPTION` | 要在 `/model` 選擇器中新增為自訂項目的模型 ID。可用來讓非標準或閘道專屬的模型可供選取，而不需取代內建別名。請參閱[模型設定](/docs/zh-TW/model-config#add-a-custom-model-option) |

159| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | `/model` 選擇器中自訂模型項目的顯示說明。未設定時預設為 `Custom model (<model-id>)` |159| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | `/model` 選擇器中自訂模型項目的顯示說明。未設定時預設為 `Custom model (<model-id>)` |

160| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | `/model` 選擇器中自訂模型項目的顯示名稱。未設定時，如果 Claude Code [能辨識該 ID](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities)，項目會顯示模型名稱，否則顯示模型 ID |160| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | `/model` 選擇器中自訂模型項目的顯示名稱。未設定時，若 Claude Code [能辨識該 ID](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities)，項目會顯示模型名稱，否則顯示模型 ID |

161| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | 自訂模型支援的[功能](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities)，以逗號分隔，例如 `effort,thinking`。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |161| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | 自訂模型支援的[功能](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities)清單，以逗號分隔，例如 `effort,thinking`。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |

162| `ANTHROPIC_DEFAULT_FABLE_MODEL` | `fable` 別名所解析成的模型 ID，也是 Claude Code 在第三方供應商上為[自動模型備援](/docs/zh-TW/model-config#automatic-model-fallback)辨識為 Fable 模型的 ID。請參閱[模型設定](/docs/zh-TW/model-config#environment-variables) |162| `ANTHROPIC_DEFAULT_FABLE_MODEL` | `fable` 別名所解析的模型 ID，也是 Claude Code 在第三方供應商上為了[自動模型備援](/docs/zh-TW/model-config#automatic-model-fallback)而辨識為 Fable 模型的 ID。請參閱[模型設定](/docs/zh-TW/model-config#environment-variables) |

163| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | `/model` 選擇器中固定 Fable 模型的顯示說明。未設定時，該列會顯示以 `Custom Fable model` 開頭的預設說明。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |163| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | `/model` 選擇器中所固定之 Fable 模型的顯示說明。未設定時，該列會顯示以 `Custom Fable model` 開頭的預設說明。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |

164| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | `/model` 選擇器中固定 Fable 模型的顯示名稱。未設定時，如果 Claude Code 能辨識固定的 ID，該列會顯示模型名稱，否則顯示固定的 ID。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |164| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | `/model` 選擇器中所固定之 Fable 模型的顯示名稱。未設定時，若 Claude Code 能辨識所固定的 ID，該列會顯示模型名稱，否則顯示所固定的 ID。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |

165| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | 固定 Fable 模型支援的[功能](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities)，以逗號分隔，例如 `effort,thinking`。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |165| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | 所固定之 Fable 模型支援的[功能](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities)清單，以逗號分隔，例如 `effort,thinking`。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |

166| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | `haiku` 別名所解析成的模型 ID，也用於[背景功能](/docs/zh-TW/costs#background-token-usage)。請參閱[模型設定](/docs/zh-TW/model-config#environment-variables) |166| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | `haiku` 別名所解析的模型 ID，也用於[背景功能](/docs/zh-TW/costs#background-token-usage)。請參閱[模型設定](/docs/zh-TW/model-config#environment-variables) |

167| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | `/model` 選擇器中固定 Haiku 模型的顯示說明。未設定時，該列會顯示以 `Custom Haiku model` 開頭的預設說明。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |167| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | `/model` 選擇器中所固定之 Haiku 模型的顯示說明。未設定時，該列會顯示以 `Custom Haiku model` 開頭的預設說明。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |

168| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | `/model` 選擇器中固定 Haiku 模型的顯示名稱。未設定時，如果 Claude Code 能辨識固定的 ID，該列會顯示模型名稱，否則顯示固定的 ID。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |168| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | `/model` 選擇器中所固定之 Haiku 模型的顯示名稱。未設定時，若 Claude Code 能辨識所固定的 ID，該列會顯示模型名稱，否則顯示所固定的 ID。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |

169| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | 固定 Haiku 模型支援的[功能](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities)，以逗號分隔，例如 `effort,thinking`。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |169| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | 所固定之 Haiku 模型支援的[功能](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities)清單，以逗號分隔，例如 `effort,thinking`。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |

170| `ANTHROPIC_DEFAULT_MODEL` | 新工作階段預設啟動時使用的模型。需要 Claude Code v2.1.236 或更新版本。請參閱[為新工作階段設定預設模型](/docs/zh-TW/model-config#set-a-default-model-for-new-sessions) |170| `ANTHROPIC_DEFAULT_MODEL` | 新工作階段預設使用的模型。需要 Claude Code v2.1.236 或更新版本。請參閱[為新工作階段設定預設模型](/docs/zh-TW/model-config#set-a-default-model-for-new-sessions) |

171| `ANTHROPIC_DEFAULT_OPUS_MODEL` | `opus` 別名所解析成的模型 ID，也是 `opusplan` 在 Plan Mode 啟用時使用的模型。請參閱[模型設定](/docs/zh-TW/model-config#environment-variables) |171| `ANTHROPIC_DEFAULT_OPUS_MODEL` | `opus` 別名所解析的模型 ID，也是 `opusplan` 在 Plan Mode 啟用時使用的模型。請參閱[模型設定](/docs/zh-TW/model-config#environment-variables) |

172| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | `/model` 選擇器中固定 Opus 模型的顯示說明。未設定時，該列會顯示以 `Custom Opus model` 開頭的預設說明。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |172| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | `/model` 選擇器中所固定之 Opus 模型的顯示說明。未設定時，該列會顯示以 `Custom Opus model` 開頭的預設說明。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |

173| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | `/model` 選擇器中固定 Opus 模型的顯示名稱。未設定時，如果 Claude Code 能辨識固定的 ID，該列會顯示模型名稱，否則顯示固定的 ID。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |173| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | `/model` 選擇器中所固定之 Opus 模型的顯示名稱。未設定時，若 Claude Code 能辨識所固定的 ID，該列會顯示模型名稱，否則顯示所固定的 ID。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |

174| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | 固定 Opus 模型支援的[功能](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities)，以逗號分隔，例如 `effort,thinking`。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |174| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | 所固定之 Opus 模型支援的[功能](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities)清單，以逗號分隔，例如 `effort,thinking`。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |

175| `ANTHROPIC_DEFAULT_SONNET_MODEL` | `sonnet` 別名所解析成的模型 ID，也是 `opusplan` 在 Plan Mode 未啟用時使用的模型。請參閱[模型設定](/docs/zh-TW/model-config#environment-variables) |175| `ANTHROPIC_DEFAULT_SONNET_MODEL` | `sonnet` 別名所解析的模型 ID，也是 `opusplan` 在 Plan Mode 未啟用時使用的模型。請參閱[模型設定](/docs/zh-TW/model-config#environment-variables) |

176| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | `/model` 選擇器中固定 Sonnet 模型的顯示說明。未設定時，該列會顯示以 `Custom Sonnet model` 開頭的預設說明。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |176| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | `/model` 選擇器中所固定之 Sonnet 模型的顯示說明。未設定時，該列會顯示以 `Custom Sonnet model` 開頭的預設說明。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |

177| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | `/model` 選擇器中固定 Sonnet 模型的顯示名稱。未設定時，如果 Claude Code 能辨識固定的 ID，該列會顯示模型名稱，否則顯示固定的 ID。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |177| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | `/model` 選擇器中所固定之 Sonnet 模型的顯示名稱。未設定時，若 Claude Code 能辨識所固定的 ID，該列會顯示模型名稱，否則顯示所固定的 ID。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |

178| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | 固定 Sonnet 模型支援的[功能](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities)，以逗號分隔，例如 `effort,thinking`。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |178| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | 所固定之 Sonnet 模型支援的[功能](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities)清單，以逗號分隔，例如 `effort,thinking`。請參閱[模型設定](/docs/zh-TW/model-config#customize-pinned-model-display-and-capabilities) |

179| `ANTHROPIC_FEDERATION_RULE_ID` | [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) 的聯合規則 ID。當您將其與 `ANTHROPIC_ORGANIZATION_ID` 一起設定時，Claude Code 會選用聯合憑證，其排序高於您的 `/login` 憑證。請參閱[身分驗證優先順序](/docs/zh-TW/authentication#authentication-precedence) |179| `ANTHROPIC_FEDERATION_RULE_ID` | [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) 的聯合規則 ID。當您將其與 `ANTHROPIC_ORGANIZATION_ID` 一起設定時，Claude Code 會選用聯合憑證，其優先順序高於您的 `/login` 憑證。請參閱[身分驗證優先順序](/docs/zh-TW/authentication#authentication-precedence) |

180| `ANTHROPIC_FOUNDRY_API_KEY` | 用於 Microsoft Foundry 身分驗證的 API 金鑰（請參閱 [Microsoft Foundry](/docs/zh-TW/microsoft-foundry)） |180| `ANTHROPIC_FOUNDRY_API_KEY` | 用於 Microsoft Foundry 身分驗證的 API 金鑰（請參閱 [Microsoft Foundry](/docs/zh-TW/microsoft-foundry)） |

181| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | 用於 Microsoft Foundry 身分驗證的 Bearer token，例如 Microsoft Entra 存取 token。Claude Code 會將其以 `Authorization: Bearer` 標頭傳送。優先於 `ANTHROPIC_FOUNDRY_API_KEY` 以及 Azure 預設憑證鏈。請參閱 [Microsoft Foundry](/docs/zh-TW/microsoft-foundry)。需要 Claude Code v2.1.203 或更新版本 |181| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | 用於 Microsoft Foundry 身分驗證的 Bearer token，例如 Microsoft Entra 存取 token。Claude Code 會以 `Authorization: Bearer` 標頭傳送。優先於 `ANTHROPIC_FOUNDRY_API_KEY` 與 Azure 預設憑證鏈。請參閱 [Microsoft Foundry](/docs/zh-TW/microsoft-foundry)。需要 Claude Code v2.1.203 或更新版本 |

182| `ANTHROPIC_FOUNDRY_BASE_URL` | Microsoft Foundry 資源的完整基礎 URL（例如 `https://my-resource.services.ai.azure.com/anthropic`）。為 `ANTHROPIC_FOUNDRY_RESOURCE` 的替代方式（請參閱 [Microsoft Foundry](/docs/zh-TW/microsoft-foundry)） |182| `ANTHROPIC_FOUNDRY_BASE_URL` | Microsoft Foundry 資源的完整基底 URL（例如 `https://my-resource.services.ai.azure.com/anthropic`）。可替代 `ANTHROPIC_FOUNDRY_RESOURCE`（請參閱 [Microsoft Foundry](/docs/zh-TW/microsoft-foundry)） |

183| `ANTHROPIC_FOUNDRY_RESOURCE` | Microsoft Foundry 資源名稱（例如 `my-resource`）。Claude Code [會拒絕 URL 或主機名稱](/docs/zh-TW/errors#anthropic-foundry-resource-must-be-a-foundry-resource-name)。若未設定 `ANTHROPIC_FOUNDRY_BASE_URL`，則為必要項目（請參閱 [Microsoft Foundry](/docs/zh-TW/microsoft-foundry)） |183| `ANTHROPIC_FOUNDRY_RESOURCE` | Microsoft Foundry 資源名稱（例如 `my-resource`）。Claude Code [不接受 URL 或主機名稱](/docs/zh-TW/errors#anthropic-foundry-resource-must-be-a-foundry-resource-name)。若未設定 `ANTHROPIC_FOUNDRY_BASE_URL` 則為必填（請參閱 [Microsoft Foundry](/docs/zh-TW/microsoft-foundry)） |

184| `ANTHROPIC_MODEL` | 要使用的模型設定名稱（請參閱[模型設定](/docs/zh-TW/model-config#environment-variables)） |184| `ANTHROPIC_MODEL` | 要使用的模型設定名稱（請參閱[模型設定](/docs/zh-TW/model-config#environment-variables)） |

185| `ANTHROPIC_ORGANIZATION_ID` | [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) 的組織 ID。請與 `ANTHROPIC_FEDERATION_RULE_ID` 一起設定。請參閱[身分驗證優先順序](/docs/zh-TW/authentication#authentication-precedence) |185| `ANTHROPIC_ORGANIZATION_ID` | [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) 的組織 ID。請與 `ANTHROPIC_FEDERATION_RULE_ID` 一起設定。請參閱[身分驗證優先順序](/docs/zh-TW/authentication#authentication-precedence) |

186| `ANTHROPIC_PROFILE` | 用於身分驗證的 Anthropic 設定檔名稱，例如由 [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) 或[在沒有 API 金鑰的情況下登入 Console 帳戶](/docs/zh-TW/authentication#sign-in-without-an-api-key)所建立的設定檔。請參閱[身分驗證優先順序](/docs/zh-TW/authentication#authentication-precedence) |186| `ANTHROPIC_PROFILE` | 用於身分驗證的 Anthropic 設定檔名稱，例如由 [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) 或[在沒有 API 金鑰的情況下登入 Console 帳戶](/docs/zh-TW/authentication#sign-in-without-an-api-key)所建立的設定檔。請參閱[身分驗證優先順序](/docs/zh-TW/authentication#authentication-precedence) |

187| `ANTHROPIC_SMALL_FAST_MODEL` | \[已棄用] [用於背景任務的 Haiku 等級模型](/docs/zh-TW/costs)名稱 |187| `ANTHROPIC_SMALL_FAST_MODEL` | \[已棄用] [用於背景任務的 Haiku 級模型](/docs/zh-TW/costs)名稱 |

188| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | 使用 Amazon Bedrock 或 Amazon Bedrock Mantle 時，覆寫 Haiku 等級模型的 AWS 區域。在 Amazon Bedrock 上，只有在同時設定 `ANTHROPIC_DEFAULT_HAIKU_MODEL` 或已棄用的 `ANTHROPIC_SMALL_FAST_MODEL` 時才會生效，因為否則 Amazon Bedrock 會在工作階段區域中以[預設 Sonnet 模型或主要模型](/docs/zh-TW/amazon-bedrock#4-pin-model-versions)執行背景任務 |188| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | 使用 Amazon Bedrock 或 Amazon Bedrock Mantle 時，覆寫 Haiku 級模型的 AWS 區域。在 Amazon Bedrock 上，只有在同時設定 `ANTHROPIC_DEFAULT_HAIKU_MODEL` 或已棄用的 `ANTHROPIC_SMALL_FAST_MODEL` 時才會生效，因為若非如此，Amazon Bedrock 會在工作階段區域中以[預設 Sonnet 模型或主要模型](/docs/zh-TW/amazon-bedrock#4-pin-model-versions)執行背景任務 |

189| `ANTHROPIC_VERTEX_BASE_URL` | 覆寫 Google Cloud's Agent Platform 端點 URL。用於自訂 Google Cloud's Agent Platform 端點，或透過 [LLM 閘道](/docs/zh-TW/llm-gateway)路由時。請參閱 [Google Cloud's Agent Platform](/docs/zh-TW/google-vertex-ai) |189| `ANTHROPIC_VERTEX_BASE_URL` | 覆寫 Google Cloud's Agent Platform 端點 URL。用於自訂 Google Cloud's Agent Platform 端點，或透過 [LLM 閘道](/docs/zh-TW/llm-gateway)路由時。請參閱 [Google Cloud's Agent Platform](/docs/zh-TW/google-vertex-ai) |

190| `ANTHROPIC_VERTEX_PROJECT_ID` | Google Cloud's Agent Platform 請求所指向的 GCP 專案 ID。請參閱[設定 GCP 憑證](/docs/zh-TW/google-vertex-ai#3-configure-gcp-credentials) |190| `ANTHROPIC_VERTEX_PROJECT_ID` | Google Cloud's Agent Platform 請求所指向的 GCP 專案 ID。請參閱[設定 GCP 憑證](/docs/zh-TW/google-vertex-ai#3-configure-gcp-credentials) |

191| `ANTHROPIC_WORKSPACE_ID` | [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) 的工作區 ID。當您的聯合規則範圍涵蓋多個工作區時請設定此變數，讓 token 交換知道要以哪個工作區為目標 |191| `ANTHROPIC_WORKSPACE_ID` | [workload identity federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) 的工作區 ID。當您的聯合規則範圍涵蓋多個工作區時請設定此變數，讓 token 交換知道要以哪個工作區為目標 |

192| `API_FORCE_IDLE_TIMEOUT` | 覆寫 5 分鐘的主體閒置逾時，此逾時會在沒有任何位元組抵達時中止串流模型回應。設為 `0` 可關閉此逾時，例如當緩慢的[閘道](/docs/zh-TW/llm-gateway)或本機模型在區塊之間暫停超過 5 分鐘時；設為 `1` 則會對每個供應商保持開啟。未設定時，此逾時會在直接 Anthropic API、[Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws)，以及設定了 `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` 的 Amazon Bedrock 以外的供應商上啟用。[串流監控程式](/docs/zh-TW/network-config#streaming-idle-watchdogs)獨立於此運作，即使您在此設定 `0`，也會中止長時間無回應的暫停 |192| `API_FORCE_IDLE_TIMEOUT` | 覆寫 5 分鐘的主體閒置逾時，該逾時會在沒有任何位元組傳入時中止串流模型回應。設定為 `0` 可關閉此逾時，例如當緩慢的[閘道](/docs/zh-TW/llm-gateway)或本機模型在區塊之間暫停超過 5 分鐘時；設定為 `1` 則可在所有供應商上保持開啟。未設定時，除了直接連線的 Anthropic API、[Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws)，以及設定了 `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` 的 Amazon Bedrock 之外，此逾時在其他供應商上都會啟用。[串流監視程式](/docs/zh-TW/network-config#streaming-idle-watchdogs)獨立於此運作，即使您在此設定 `0`，仍會中止長時間的無回應暫停 |

193| `API_TIMEOUT_MS` | API 請求的逾時，以毫秒為單位（預設：600000，即 10 分鐘；最大值：2147483647）。當請求在緩慢網路上逾時，或透過代理伺服器路由時，請調高此值。超過最大值的值會使底層計時器溢位，並導致請求立即失敗 |193| `API_TIMEOUT_MS` | API 請求的逾時，以毫秒為單位（預設：600000，即 10 分鐘；最大值：2147483647）。當請求在慢速網路上或透過代理伺服器路由時發生逾時，請調高此值。超過最大值的數值會使底層計時器溢位，導致請求立即失敗 |

194| `AWS_BEARER_TOKEN_BEDROCK` | 用於身分驗證的 Amazon Bedrock API 金鑰（請參閱 [Amazon Bedrock API 金鑰](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)） |194| `AWS_BEARER_TOKEN_BEDROCK` | 用於身分驗證的 Amazon Bedrock API 金鑰（請參閱 [Amazon Bedrock API 金鑰](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)） |

195| `BASH_DEFAULT_TIMEOUT_MS` | 前景 Bash 或 PowerShell 工具命令的預設逾時，以毫秒為單位（預設：120000，即 2 分鐘）。超過 30 分鐘的預設值也會成為無人值守工作階段中[背景命令的預設時間限制](/docs/zh-TW/tools-reference#time-limit-for-background-commands)。背景時間限制需要 Claude Code v2.1.285 或更新版本 |195| `BASH_DEFAULT_TIMEOUT_MS` | 前景 Bash 或 PowerShell 工具命令的預設逾時，以毫秒為單位（預設：120000，即 2 分鐘）。長於 30 分鐘的預設值也會成為無人值守工作階段中[背景命令時間限制](/docs/zh-TW/tools-reference#time-limit-for-background-commands)的預設值。背景時間限制需要 Claude Code v2.1.285 或更新版本 |

196| `BASH_MAX_OUTPUT_LENGTH` | Claude Code 讀回命令結果中的 bash 輸出最大字元數（預設：30000；最大值：150000）。如果您設定了 [`bashOutputMaxChars`](/docs/zh-TW/settings-reference#bashoutputmaxchars) 設定，Claude Code 會忽略此變數。請參閱[輸出限制](/docs/zh-TW/tools-reference#output-limits) |196| `BASH_MAX_OUTPUT_LENGTH` | Claude Code 讀回命令結果中的 bash 輸出最大字元數（預設：30000；最大值：150000）。若您設定了 [`bashOutputMaxChars`](/docs/zh-TW/settings-reference#bashoutputmaxchars) 設定，Claude Code 會忽略此變數。請參閱[輸出限制](/docs/zh-TW/tools-reference#output-limits) |

197| `BASH_MAX_TIMEOUT_MS` | 模型可為前景 Bash 或 PowerShell 工具命令設定的最大逾時，以毫秒為單位（預設：600000，即 10 分鐘）。實際上限為此值與 `BASH_DEFAULT_TIMEOUT_MS` 兩者中較大者。超過 2 小時的實際上限也會成為無人值守工作階段中[背景命令的最大時間限制](/docs/zh-TW/tools-reference#time-limit-for-background-commands)。背景時間限制需要 Claude Code v2.1.285 或更新版本 |197| `BASH_MAX_TIMEOUT_MS` | 模型可為前景 Bash 或 PowerShell 工具命令設定的最大逾時，以毫秒為單位（預設：600000，即 10 分鐘）。實際上限為此值與 `BASH_DEFAULT_TIMEOUT_MS` 中較大者。長於 2 小時的實際上限也會成為無人值守工作階段中[背景命令時間限制](/docs/zh-TW/tools-reference#time-limit-for-background-commands)的最大值。背景時間限制需要 Claude Code v2.1.285 或更新版本 |

198| `BETA_TRACING_ENDPOINT` | [詳細 beta 追蹤](/docs/zh-TW/monitoring-usage#traces-beta)的 OTLP 端點：搭配 `ENABLE_BETA_TRACING_DETAILED=1` 時，日誌與追蹤會傳送至此處，而非已設定的匯出器。請在您的 shell、使用者設定或受管設定中設定。在[專案與本機設定](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)中會被忽略 |198| `BETA_TRACING_ENDPOINT` | [詳細 beta 追蹤](/docs/zh-TW/monitoring-usage#traces-beta)的 OTLP 端點：搭配 `ENABLE_BETA_TRACING_DETAILED=1` 時，日誌與追蹤會傳送至此處，而非已設定的匯出器。請在您的 shell、使用者設定或受管設定中設定。在[專案與本機設定](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)中會被忽略 |

199| `CCR_FORCE_BUNDLE` | 設為 `1` 可強制 [`claude --cloud`](/docs/zh-TW/claude-code-on-the-web#send-local-repositories-without-github) 打包並上傳您的本機儲存庫，而非從其遠端複製 |199| `CCR_FORCE_BUNDLE` | 設定為 `1` 可強制 [`claude --cloud`](/docs/zh-TW/claude-code-on-the-web#send-local-repositories-without-github) 打包並上傳您的本機儲存庫，而非從其遠端複製 |

200| `CLAUDECODE` | 在 Claude Code 產生的子程序中設為 `1`（Bash 與 PowerShell 工具、tmux 工作階段、[hook](/docs/zh-TW/hooks) 命令、[狀態列](/docs/zh-TW/statusline)命令、stdio [MCP 伺服器](/docs/zh-TW/mcp)子程序）。IDE 擴充功能也會在其整合式終端機中設定此變數。可用於偵測指令碼是否在 Claude Code 產生的子程序中執行。若要檢查目前程序是否由工具呼叫或 hook 直接產生，而非在 Claude Code 啟動的 stdio MCP 伺服器內部，請改用 `CLAUDE_CODE_CHILD_SESSION` |200| `CLAUDECODE` | 在 Claude Code 產生的子程序中設定為 `1`（Bash 與 PowerShell 工具、tmux 工作階段、[hook](/docs/zh-TW/hooks) 命令、[狀態列](/docs/zh-TW/statusline)命令、stdio [MCP 伺服器](/docs/zh-TW/mcp)子程序）。IDE 擴充功能也會在其整合式終端機中設定此變數。用於偵測指令碼是否在 Claude Code 產生的子程序中執行。若要檢查目前程序是否由工具呼叫或 hook 直接產生，而非在 Claude Code 啟動的 stdio MCP 伺服器內執行，請改用 `CLAUDE_CODE_CHILD_SESSION` |

201| `CLAUDE_AFK_COUNTDOWN_MS` | 在未回答的 [`AskUserQuestion`](/docs/zh-TW/tools-reference) 對話方塊自動繼續之前多少毫秒，會出現畫面上的倒數計時。預設為 `20000`（20 秒），上限為自動繼續逾時。除非自動繼續已開啟，否則無效；請參閱 [`askUserQuestionTimeout`](/docs/zh-TW/settings-reference#askuserquestiontimeout) 設定與 `CLAUDE_AFK_TIMEOUT_MS`。需要 Claude Code v2.1.198 或更新版本 |201| `CLAUDE_AFK_COUNTDOWN_MS` | 在未回答的 [`AskUserQuestion`](/docs/zh-TW/tools-reference) 對話框自動繼續之前多少毫秒，畫面上會出現倒數計時。預設 `20000`（20 秒），上限為自動繼續逾時。除非自動繼續已開啟，否則沒有效果；請參閱 [`askUserQuestionTimeout`](/docs/zh-TW/settings-reference#askuserquestiontimeout) 設定與 `CLAUDE_AFK_TIMEOUT_MS`。需要 Claude Code v2.1.198 或更新版本 |

202| `CLAUDE_AFK_TIMEOUT_MS` | 未回答的 [`AskUserQuestion`](/docs/zh-TW/tools-reference) 對話方塊在閒置多少毫秒後，會在您未回應的情況下自動繼續。自動繼續預設為關閉；請透過 [`askUserQuestionTimeout`](/docs/zh-TW/settings-reference#askuserquestiontimeout) 設定選擇加入。此變數是用於示範與自動化測試的覆寫：設定後，它會優先於該設定，即使該設定未設定或為 `never`，也會開啟自動繼續。設定 `0` 不會關閉逾時，而是會立即關閉對話方塊。在 v2.1.198 與 v2.1.199 中，自動繼續預設為開啟，逾時為 `60000`（60 秒）。需要 Claude Code v2.1.198 或更新版本 |202| `CLAUDE_AFK_TIMEOUT_MS` | 未回答的 [`AskUserQuestion`](/docs/zh-TW/tools-reference) 對話框在閒置多少毫秒後，會不等待您而自動繼續。自動繼續預設為關閉；可透過 [`askUserQuestionTimeout`](/docs/zh-TW/settings-reference#askuserquestiontimeout) 設定選擇加入。此變數是供示範與自動化測試使用的覆寫：設定後，它會優先於該設定，即使該設定未設定或為 `never`，也會開啟自動繼續。設定 `0` 不會關閉逾時，而是會立即關閉對話框。在 v2.1.198 與 v2.1.199 中，自動繼續預設為開啟，逾時為 `60000`（60 秒）。需要 Claude Code v2.1.198 或更新版本 |

203| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | 設為 `1` 可停用所有內建的 [subagent](/docs/zh-TW/sub-agents) 類型，例如 Explore 與 Plan。僅適用於非互動模式（`-p` 旗標）。適合想要從零開始的 SDK 使用者。這也會移除 `general-purpose`，即 Agent 工具呼叫省略 `subagent_type` 時 Claude Code 執行的 subagent。此類呼叫隨後會以 [`subagent_type is required`](/docs/zh-TW/errors#subagent-type-is-required) 失敗 |203| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | 設定為 `1` 可停用所有內建 [subagent](/docs/zh-TW/sub-agents) 類型，例如 Explore 與 Plan。僅適用於非互動模式（`-p` 旗標）。適合想要從零開始的 SDK 使用者。這也會移除 `general-purpose`，即 Agent 工具呼叫省略 `subagent_type` 時 Claude Code 所執行的 subagent。此類呼叫接著會失敗，並顯示 [`subagent_type is required`](/docs/zh-TW/errors#subagent-type-is-required) |

204| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | 設為 `1` 可略過 SDK 建立的 MCP 伺服器工具名稱上的 `mcp__<server>__` 前綴。工具會使用其原始名稱。僅限 SDK 使用 |204| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | 設定為 `1` 可略過 SDK 建立之 MCP 伺服器工具名稱上的 `mcp__<server>__` 前綴。工具會使用其原始名稱。僅限 SDK 使用 |

205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | subagent 的停滯逾時，以毫秒為單位。預設為 `600000`（10 分鐘）；如果您在串流監控程式開啟時調高 `CLAUDE_STREAM_IDLE_TIMEOUT_MS`，預設值會隨之提高，如[處理緩慢或停滯的 API 回應](/docs/zh-TW/agent-sdk/typescript#handle-slow-or-stalled-api-responses)所述。計時器會在每個串流進度事件時重設；如果在時間範圍內沒有任何進度，Claude Code 會中止該 subagent 並向上層回報停滯 |205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | subagent 的停滯逾時，以毫秒為單位。預設 `600000`（10 分鐘）；若您在串流監視程式開啟時調高 `CLAUDE_STREAM_IDLE_TIMEOUT_MS`，預設值也會隨之提高，如[處理緩慢或停滯的 API 回應](/docs/zh-TW/agent-sdk/typescript#handle-slow-or-stalled-api-responses)所述。計時器會在每次串流進度事件時重設；若在時間範圍內沒有任何進度，Claude Code 會中止該 subagent，並向父層回報停滯 |

206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | 設定觸發自動壓縮時自動壓縮視窗的百分比（1-100）。使用較低的值（例如 `50`）可提早壓縮；此變數無法提高閾值，因此高於預設百分比的值會被忽略。僅適用於[在模型上下文限制之前壓縮](/docs/zh-TW/model-config#context-window-and-auto-compaction)的工作階段。同時適用於主要對話與 subagent |206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | 設定自動壓縮視窗中觸發自動壓縮的百分比（1-100）。使用較低的值（例如 `50`）可提早壓縮；此變數無法提高閾值，因此高於預設百分比的值會被忽略。僅適用於[在達到模型上下文限制之前壓縮](/docs/zh-TW/model-config#context-window-and-auto-compaction)的工作階段。同時適用於主要對話與 subagent |

207| `CLAUDE_AUTO_BACKGROUND_TASKS` | 設為 `1` 可強制啟用長時間執行之 agent 任務的自動背景化。啟用後，subagent 在執行約兩分鐘後會移至背景。在 Claude Code v2.1.212 或更新版本中，也會在非互動模式中啟用[長時間 MCP 工具呼叫的自動背景化](/docs/zh-TW/mcp#automatic-backgrounding-of-long-tool-calls) |207| `CLAUDE_AUTO_BACKGROUND_TASKS` | 設定為 `1` 可強制啟用長時間執行之 agent 任務的自動背景化。啟用後，subagent 執行約兩分鐘後會移至背景。在 Claude Code v2.1.212 或更新版本中，也會在非互動模式下啟用[長時間 MCP 工具呼叫的自動背景化](/docs/zh-TW/mcp#automatic-backgrounding-of-long-tool-calls) |

208| `CLAUDE_AX_PREPARK_MS` | 在[螢幕閱讀器模式](/docs/zh-TW/accessibility)中，Claude Code 寫入新的或變更的行之前等待的毫秒數。預設為 `0`，因此 Claude Code 不會等待。在 v2.1.287 之前，預設值為 `50`。Claude Code 將等待時間上限設為 `5000`。需要 Claude Code v2.1.233 或更新版本 |208| `CLAUDE_AX_PREPARK_MS` | 在[螢幕閱讀器模式](/docs/zh-TW/accessibility)中，Claude Code 在寫入新的或變更的行之前等待的毫秒數。預設 `0`，因此 Claude Code 不會等待。在 v2.1.287 之前，預設值為 `50`。Claude Code 將等待時間上限設為 `5000`。需要 Claude Code v2.1.233 或更新版本 |

209| `CLAUDE_AX_SCREEN_READER` | 設為 `1` 可呈現適合螢幕閱讀器的輸出：不含裝飾性邊框或動畫的純文字。設為 `0` 可強制關閉螢幕閱讀器模式，即使 [`axScreenReader`](/docs/zh-TW/settings-reference#axscreenreader) 為 `true` 亦然。[`--ax-screen-reader`](/docs/zh-TW/cli-reference#cli-flags) 旗標優先。需要 Claude Code v2.1.181 或更新版本 |209| `CLAUDE_AX_SCREEN_READER` | 設定為 `1` 可呈現適合螢幕閱讀器的輸出：不含裝飾性邊框或動畫的純文字。設定為 `0` 可強制關閉螢幕閱讀器模式，即使 [`axScreenReader`](/docs/zh-TW/settings-reference#axscreenreader) 為 `true` 亦然。[`--ax-screen-reader`](/docs/zh-TW/cli-reference#cli-flags) 旗標優先。需要 Claude Code v2.1.181 或更新版本 |

210| `CLAUDE_AX_STARTUP_QUIET_MS` | 在[螢幕閱讀器模式](/docs/zh-TW/accessibility)中，Claude Code 在啟動確認行之後延後第一次介面呈現的毫秒數，讓您的螢幕閱讀器能在新輸出打斷之前完整唸出該行。預設為 `3000`。設定 `0` 可立即呈現。Claude Code 將延後時間上限設為 `600000`（10 分鐘）。您的第一次按鍵會提早結束延後。需要 Claude Code v2.1.217 或更新版本 |210| `CLAUDE_AX_STARTUP_QUIET_MS` | 在[螢幕閱讀器模式](/docs/zh-TW/accessibility)中，Claude Code 在啟動確認行之後延遲第一次介面呈現的毫秒數，讓您的螢幕閱讀器能在新輸出打斷之前完整唸出該行。預設 `3000`。設定 `0` 可立即呈現。Claude Code 將延遲上限設為 `600000`（10 分鐘）。您的第一次按鍵會提早結束延遲。需要 Claude Code v2.1.217 或更新版本 |

211| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | 在主要工作階段中，每個 Bash 或 PowerShell 命令執行後返回原始工作目錄 |211| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | 在主要工作階段中，每次執行 Bash 或 PowerShell 命令後返回原始工作目錄 |

212| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | 位元組層級串流閒置監控程式的逾時，以毫秒為單位；設定後，對於該監控程式會優先於 `CLAUDE_STREAM_IDLE_TIMEOUT_MS`，且不影響事件層級監控程式。Claude Code 會將此變數限制在 10 秒到 30 分鐘之間。需要 Claude Code v2.1.210 或更新版本 |212| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | 位元組層級串流閒置監視程式的逾時，以毫秒為單位；設定後，就該監視程式而言，它會優先於 `CLAUDE_STREAM_IDLE_TIMEOUT_MS`，且不會變更事件層級監視程式。Claude Code 會將此變數限制在 10 秒到 30 分鐘之間。需要 Claude Code v2.1.210 或更新版本 |

213| `CLAUDE_CLIENT_PRESENCE_FILE` | 一個檔案的路徑，由外部工具（例如螢幕鎖定監聽程式）在您解鎖螢幕時建立、鎖定螢幕時刪除。檔案存在期間，Claude Code 會略過 [Remote Control 行動推播通知](/docs/zh-TW/remote-control#mobile-push-notifications)，讓您在積極使用電腦時不再收到推播。當檔案不存在或無法讀取時，通知會照常傳送。Claude Code 會在每個觸發推播的事件時檢查一次該檔案，而非輪詢。需要 Claude Code v2.1.181 或更新版本 |213| `CLAUDE_CLIENT_PRESENCE_FILE` | 一個檔案的路徑，由外部工具（例如螢幕鎖定監聽器）在您解鎖螢幕時建立，並在您鎖定螢幕時刪除。當該檔案存在時，Claude Code 會略過 [Remote Control 行動推播通知](/docs/zh-TW/remote-control#mobile-push-notifications)，讓您在積極使用電腦時不再收到推播。當檔案不存在或無法讀取時，通知會照常傳送。Claude Code 會在每次觸發推播的事件時檢查該檔案一次，而非持續輪詢。需要 Claude Code v2.1.181 或更新版本 |

214| `CLAUDE_CODE_ACCESSIBILITY` | 設為 `1` 可保持原生終端機游標可見，並停用反白文字游標指示器。讓 macOS 縮放等螢幕放大鏡能追蹤游標位置 |214| `CLAUDE_CODE_ACCESSIBILITY` | 設定為 `1` 可保持原生終端機游標可見，並停用反白文字游標指示器。讓 macOS 縮放等螢幕放大工具能追蹤游標位置 |

215| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | 設為 `1` 可從以 `--add-dir` 指定的目錄載入記憶檔案。會載入 `CLAUDE.md`、`.claude/CLAUDE.md`、`.claude/rules/*.md` 與 `CLAUDE.local.md`。預設情況下，額外目錄不會載入記憶檔案 |215| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | 設定為 `1` 可從以 `--add-dir` 指定的目錄載入記憶檔案。會載入 `CLAUDE.md`、`.claude/CLAUDE.md`、`.claude/rules/*.md` 與 `CLAUDE.local.md`。預設情況下，額外目錄不會載入記憶檔案 |

216| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | 設為 `1` 可在[全螢幕呈現](/docs/zh-TW/fullscreen)中每一影格重繪整個畫面，而非傳送增量更新。如果全螢幕模式顯示過時或錯位的文字片段，請使用此變數。Claude Code 會在 Windows 上為背景工作階段與 [agent view](/docs/zh-TW/agent-view) 自動啟用此功能 |216| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | 設定為 `1` 可在[全螢幕呈現](/docs/zh-TW/fullscreen)中於每一影格重繪整個畫面，而非傳送增量更新。若全螢幕模式顯示過時或錯位的文字片段，請使用此設定。Claude Code 會在 Windows 上的背景工作階段與 [agent view](/docs/zh-TW/agent-view) 中自動啟用此設定 |

217| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | 設為 `1` 可在每個請求中傳送 [effort](/docs/zh-TW/model-config#adjust-effort-level) 參數，即使 Claude Code 未將該模型 ID 辨識為支援 effort 亦然。當透過以自訂識別碼提供模型的 [LLM 閘道](/docs/zh-TW/llm-gateway)或第三方供應商路由時，請使用此變數。在 API 層級拒絕 effort 參數的模型（包括 Claude 3 模型、Sonnet 4.0 與 4.5、Opus 4.0 與 4.1，以及 Haiku 4.5）仍會被排除，以免請求失敗 |217| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | 設定為 `1` 可在每個請求中傳送 [effort](/docs/zh-TW/model-config#adjust-effort-level) 參數，即使 Claude Code 未將該模型 ID 辨識為支援 effort 的模型。當透過 [LLM 閘道](/docs/zh-TW/llm-gateway)或以自訂識別碼提供模型的第三方供應商路由時，請使用此設定。在 API 層級拒絕 effort 參數的模型（包括 Claude 3 模型、Sonnet 4.0 與 4.5、Opus 4.0 與 4.1，以及 Haiku 4.5）仍會被排除，以免請求失敗 |

218| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | 憑證應重新整理的間隔，以毫秒為單位（使用 [`apiKeyHelper`](/docs/zh-TW/settings-reference#apikeyhelper) 時） |218| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | 重新整理憑證的間隔，以毫秒為單位（使用 [`apiKeyHelper`](/docs/zh-TW/settings-reference#apikeyhelper) 時） |

219| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | 設為 `0` 可讓 Claude Code 在發布新的 [artifact](/docs/zh-TW/artifacts#create-an-artifact) 時不自動開啟瀏覽器 |219| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | 設定為 `0` 可在發布新的 [artifact](/docs/zh-TW/artifacts#create-an-artifact) 時，阻止 Claude Code 自動開啟瀏覽器 |

220| `CLAUDE_CODE_ARTIFACT_COMMENTS` | 設為 `0` 可讓 Claude 不再讀取與回覆 [artifact 上的留言](/docs/zh-TW/artifacts#collect-comments-on-an-artifact)。當 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 已[關閉 artifact](/docs/zh-TW/artifacts#availability) 時無效。需要 Claude Code v2.1.221 或更新版本 |220| `CLAUDE_CODE_ARTIFACT_COMMENTS` | 設定為 `0` 可阻止 Claude 讀取及回覆 [artifact 上的留言](/docs/zh-TW/artifacts#collect-comments-on-an-artifact)。當 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 已[關閉 artifact](/docs/zh-TW/artifacts#availability) 時沒有效果。需要 Claude Code v2.1.221 或更新版本 |

221| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | 設為 `0` 可讓 Claude 不再[自行回覆傳送給它的留言](/docs/zh-TW/artifacts#let-claude-reply-to-comments-on-its-own)。需要 Claude Code v2.1.228 或更新版本 |221| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | 設定為 `0` 可阻止 Claude [自行回覆傳送給它的留言](/docs/zh-TW/artifacts#let-claude-reply-to-comments-on-its-own)。需要 Claude Code v2.1.228 或更新版本 |

222| `CLAUDE_CODE_ATTRIBUTION_HEADER` | 設為 `0` 可從系統提示詞開頭省略[歸屬區塊](/docs/zh-TW/llm-gateway-protocol#system-prompt-attribution-block)，該區塊包含用戶端版本與提示詞指紋。無論如何設定，直接連線至 Anthropic API 時的快取都不受影響。在某些直接連線的設定中，即使您設定 `0`，Claude Code 仍會在[自動模式](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode)分類器請求中保留該區塊。請在[系統提示詞歸屬區塊](/docs/zh-TW/llm-gateway-protocol#system-prompt-attribution-block)中查看此情況涵蓋哪些連線與憑證。在 v2.1.181 之前，該區塊在自訂基礎 URL 與 Microsoft Foundry 連線上會包含每個請求專屬的 token，因此在這些版本上，當您的 LLM 閘道依請求主體進行快取或將請求轉送至第三方供應商，或您直接連線至 Microsoft Foundry 時，請將其設為 `0` |222| `CLAUDE_CODE_ATTRIBUTION_HEADER` | 設定為 `0` 可從系統提示詞開頭省略[歸屬區塊](/docs/zh-TW/llm-gateway-protocol#system-prompt-attribution-block)，該區塊包含用戶端版本與提示詞指紋。無論如何設定，直接連線至 Anthropic API 時的快取都不受影響。在某些直接連線設定中，即使您設定 `0`，Claude Code 仍會在[自動模式](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode)分類器請求中保留該區塊。請在[系統提示詞歸屬區塊](/docs/zh-TW/llm-gateway-protocol#system-prompt-attribution-block)中查看此情況涵蓋哪些連線與憑證。在 v2.1.181 之前，該區塊在自訂基底 URL 與 Microsoft Foundry 連線上包含每個請求專屬的 token，因此在這些版本上，當您的 LLM 閘道依請求主體進行快取或將請求轉送至第三方供應商，或當您直接連線至 Microsoft Foundry 時，請將其設定為 `0` |

223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | 啟用 `CLAUDE_AUTO_BACKGROUND_TASKS` 時，提醒 Claude 檢查仍在執行中之[背景 subagent](/docs/zh-TW/sub-agents#run-subagents-in-foreground-or-background) 的間隔秒數。僅接受 `1` 到 `86400` 的純整數；任何其他值或寫法都會視為未設定。未設定時，不會有檢查提醒。需要 Claude Code v2.1.248 或更新版本 |223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | 已於 v2.1.283 移除。請改用 `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` |

224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | 以 token 為單位設定[自動壓縮視窗](/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` | 以 token 為單位設定[自動壓縮視窗](/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)。設為 `0` 可改用 Claude Code 自身的分類器請求。在直接連線至 Anthropic API 時，需要 v2.1.281 或更新版本。連結的章節列出了變數未設定時哪些工作階段會詢問伺服器，以及從哪個版本開始。需要 Claude Code v2.1.271 或更新版本 |226| `CLAUDE_CODE_AUTO_MODE_SERVER` | 控制 Claude Code 是否要求伺服器[審查自動模式動作](/docs/zh-TW/permission-modes#server-side-classifier-review)。設定為 `0` 可改用 Claude Code 自己的分類器請求。在直接連線至 Anthropic API 時，需要 v2.1.281 或更新版本。連結的章節列出了未設定此變數時哪些工作階段會詢問伺服器，以及從哪個版本開始。需要 Claude Code v2.1.271 或更新版本 |

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` 等包裝程式進行含 MFA 的瀏覽器式 SSO 登入。適用於 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` 等包裝工具進行搭配 MFA 的瀏覽器 SSO 登入），請調高此值。適用於 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` 可讓非互動工作階段在每個回合結束時向其主機回報閒置狀態，即使背景工作仍在執行中亦然。預設情況下，當背景 agent 或[工作流程](/docs/zh-TW/workflows)執行等背景工作仍在進行時，工作階段在回合結束後仍會持續回報執行中狀態。這可避免監看狀態的主機（例如遠端工作階段清單）在工作進行中宣告 Claude 正在等待您的輸入。背景 shell 命令（例如開發伺服器）不會維持執行中狀態。執行中狀態的預設行為與 `0` 選擇退出需要 Claude Code v2.1.269 或更新版本；在較早版本上，請設定 `1` 以維持執行中狀態 |229| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | 設定為 `0` 可讓非互動工作階段在每個回合結束時向其主機回報閒置狀態，即使背景工作仍在執行中。預設情況下，當背景 agent 或[工作流程](/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` |

231| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | 設為 `0` 可讓 Claude Code 將 `0x08` 位元組（也寫作 `^H`）讀取為一般 Backspace，設為 `1` 則讀取為 Ctrl+Backspace。任一值都會取代平台預設值。預設情況下，Claude Code 在 Windows 上會將其讀取為 Ctrl+Backspace（但 `TERM_PROGRAM` 為 `mintty` 或 `TERM` 為 `cygwin` 時除外），在 macOS 與 Linux 上則讀取為一般 Backspace。若在 Windows 終端機中 [Backspace 會刪除整個單字](/docs/zh-TW/terminal-config#fix-backspace-deleting-a-whole-word-on-windows)，請設定 `0` |231| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | 設定為 `0` 可讓 Claude Code 將 `0x08` 位元組（也寫作 `^H`）讀取為一般 Backspace，設定為 `1` 則讀取為 Ctrl+Backspace。任一值都會取代平台預設值。預設情況下，Claude Code 在 Windows 上將其讀取為 Ctrl+Backspace（但 `TERM_PROGRAM` 為 `mintty` 或 `TERM` 為 `cygwin` 時除外），在 macOS 與 Linux 上則讀取為一般 Backspace。在 [Backspace 會刪除整個單字](/docs/zh-TW/terminal-config#fix-backspace-deleting-a-whole-word-on-windows)的 Windows 終端機中，請設定 `0` |

232| `CLAUDE_CODE_CERT_STORE` | TLS 連線的 CA 憑證來源，以逗號分隔。`bundled` 是 Claude Code 隨附的 Mozilla CA 集合。`system` 是作業系統信任存放區，僅在具有 `tls.getCACertificates` 的執行環境中讀取：原生二進位檔，或 npm 安裝時使用 Node 22.15 或更新版本。請參閱 [CA 憑證存放區](/docs/zh-TW/network-config#ca-certificate-store)。預設為 `bundled,system` |232| `CLAUDE_CODE_CERT_STORE` | TLS 連線的 CA 憑證來源清單，以逗號分隔。`bundled` 是 Claude Code 隨附的 Mozilla CA 集合。`system` 是作業系統信任存放區，僅在具有 `tls.getCACertificates` 的執行環境中讀取：原生二進位檔，或以 npm 安裝時的 Node 22.15 或更新版本。請參閱 [CA 憑證存放區](/docs/zh-TW/network-config#ca-certificate-store)。預設為 `bundled,system` |

233| `CLAUDE_CODE_CHILD_SESSION` | 在 Claude Code 透過 Bash、PowerShell 與 Monitor 工具、[hook](/docs/zh-TW/hooks) 命令以及[狀態列](/docs/zh-TW/statusline)命令產生的子程序中設為 `1`。不會為 stdio [MCP 伺服器](/docs/zh-TW/mcp)子程序設定，因為這些子程序長期存在，且會比產生它們的工作階段存活更久。與 `CLAUDECODE` 不同，此變數只會由 Claude Code 本身在啟動子程序時設定，而不會由 IDE 擴充功能設定，因此能可靠地區分巢狀工作階段與在 IDE 整合式終端機中啟動的頂層 `claude`。以此方式啟動的巢狀互動式 `claude` TUI 會自動從 `--resume`、`--continue`、向上鍵歷程記錄與 `claude agents` 清單中排除。非互動式 `claude -p` 工作階段仍會保存。設定 `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` 可覆寫此排除。需要 Claude Code v2.1.172 或更新版本 |233| `CLAUDE_CODE_CHILD_SESSION` | 在 Claude Code 透過 Bash、PowerShell 與 Monitor 工具、[hook](/docs/zh-TW/hooks) 命令以及[狀態列](/docs/zh-TW/statusline)命令所產生的子程序中設定為 `1`。不會為 stdio [MCP 伺服器](/docs/zh-TW/mcp)子程序設定，因為這些子程序會長時間存在，且存活時間超過產生它們的工作階段。與 `CLAUDECODE` 不同，此變數僅由 Claude Code 本身在啟動子程序時設定，IDE 擴充功能不會設定，因此能可靠地區分巢狀工作階段與在 IDE 整合式終端機中啟動的頂層 `claude`。以此方式啟動的巢狀互動式 `claude` TUI 會自動從 `--resume`、`--continue`、向上鍵歷史記錄以及 `claude agents` 清單中排除。非互動式 `claude -p` 工作階段仍會保存。設定 `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` 可覆寫此排除。需要 Claude Code v2.1.172 或更新版本 |

234| `CLAUDE_CODE_CLIENT_CERT` | 用於 mTLS 身分驗證的用戶端憑證檔案路徑 |234| `CLAUDE_CODE_CLIENT_CERT` | 用於 mTLS 身分驗證的用戶端憑證檔案路徑 |

235| `CLAUDE_CODE_CLIENT_KEY` | 用於 mTLS 身分驗證的用戶端私密金鑰檔案路徑 |235| `CLAUDE_CODE_CLIENT_KEY` | 用於 mTLS 身分驗證的用戶端私密金鑰檔案路徑 |

236| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | 加密的 CLAUDE\_CODE\_CLIENT\_KEY 的密碼片語（選用） |236| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | 已加密之 CLAUDE\_CODE\_CLIENT\_KEY 的密碼片語（選用） |

237| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | 已在 v2.1.186 中移除，現在不會有任何作用。先前用於為串流 API 請求的連線、TLS 與回應標頭階段設定個別的逾時。請使用 `API_TIMEOUT_MS` 設定每個請求的逾時。關於串流請求的回應標頭階段，請參閱 `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` |237| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | 已於 v2.1.186 移除，現在不會產生任何作用。先前用於為串流 API 請求的連線、TLS 與回應標頭階段設定獨立的逾時。請使用 `API_TIMEOUT_MS` 設定每個請求的逾時。關於串流請求的回應標頭階段，請參閱 `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` |

238| `CLAUDE_CODE_DEBUG_LOGS_DIR` | 覆寫偵錯日誌檔案路徑。儘管名稱如此，這是檔案路徑，而非目錄。需要另外透過 `--debug`、`/debug` 或 `DEBUG` 環境變數啟用偵錯模式：單獨設定此變數並不會啟用日誌記錄。[`--debug-file`](/docs/zh-TW/cli-reference#cli-flags) 旗標可同時完成兩者。預設為 `~/.claude/debug/<session-id>.txt` |238| `CLAUDE_CODE_DEBUG_LOGS_DIR` | 覆寫偵錯日誌檔案路徑。儘管名稱如此，這是檔案路徑而非目錄。需要另外透過 `--debug`、`/debug` 或 `DEBUG` 環境變數啟用偵錯模式：僅設定此變數不會啟用日誌。[`--debug-file`](/docs/zh-TW/cli-reference#cli-flags) 旗標可同時完成兩者。預設為 `~/.claude/debug/<session-id>.txt` |

239| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | 寫入偵錯日誌檔案的最低日誌等級。值：`verbose`、`debug`（預設）、`info`、`warn`、`error`。設為 `verbose` 可包含大量診斷資訊，例如完整的狀態列命令輸出；或提高至 `error` 以減少雜訊 |239| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | 寫入偵錯日誌檔案的最低日誌等級。值：`verbose`、`debug`（預設）、`info`、`warn`、`error`。設定為 `verbose` 可包含大量的診斷資訊，例如完整的狀態列命令輸出；或提高至 `error` 以減少雜訊 |

240| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | 設為 `1` 可停用 [1M 上下文視窗](/docs/zh-TW/model-config#extended-context)支援。設定後，模型選擇器中將無法使用 1M 模型變體，且 Claude Code 會將使用原生 1M 視窗模型（例如 [Sonnet 5.5](/docs/zh-TW/model-config#sonnet-5-5-and-sonnet-5-context-window) 與 Fable 模型）的工作階段限制在 200K 視窗；關於此限制的執行方式，請參閱[延伸上下文](/docs/zh-TW/model-config#extended-context)。適用於有合規需求的企業環境。關於其在修正無法辨識之 `[1m]` 模型 ID 視窗中的角色，請參閱[修正閘道或自訂模型 ID 的視窗](/docs/zh-TW/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |240| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | 設定為 `1` 可停用 [1M 上下文視窗](/docs/zh-TW/model-config#extended-context)支援。設定後，模型選擇器中將無法使用 1M 模型變體，且 Claude Code 會將使用原生 1M 視窗之模型（例如 [Sonnet 5.5](/docs/zh-TW/model-config#sonnet-5-5-and-sonnet-5-context-window) 與 Fable 模型）的工作階段限制在 200K 視窗；關於如何強制執行此限制，請參閱[延伸上下文](/docs/zh-TW/model-config#extended-context)。適用於有合規要求的企業環境。關於其在修正無法辨識之 `[1m]` 模型 ID 視窗時的作用，請參閱[修正閘道或自訂模型 ID 的視窗](/docs/zh-TW/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |

241| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | 設為 `1` 可在 Opus 4.6 與 Sonnet 4.6 上停用[自適應推理](/docs/zh-TW/model-config#adjust-effort-level)，並改用由 `MAX_THINKING_TOKENS` 控制的固定思考預算。對 [Fable 模型](/docs/zh-TW/model-config#extended-thinking)、Sonnet 5 及更新版本，或 Opus 4.7 及更新版本無效，這些模型一律使用自適應推理 |241| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | 設定為 `1` 可在 Opus 4.6 與 Sonnet 4.6 上停用[自適應推理](/docs/zh-TW/model-config#adjust-effort-level)，並改用由 `MAX_THINKING_TOKENS` 控制的固定思考預算。對 [Fable 模型](/docs/zh-TW/model-config#extended-thinking)、Sonnet 5 及更新版本，或 Opus 4.7 及更新版本沒有效果，這些模型一律使用自適應推理 |

242| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | 設為 `1` 可讓 Claude Code 不再跨管理來源依鍵合併[受管設定](/docs/zh-TW/managed-settings#precedence-within-the-managed-tier)的 `env` 區塊，因此只會套用最高優先順序來源的整個 `env` 區塊，與 v2.1.223 之前相同。請在啟動 Claude Code 的環境中設定，因為 Claude Code 會忽略透過設定 `env` 區塊傳遞的副本。需要 Claude Code v2.1.223 或更新版本 |242| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | 設定為 `1` 可阻止 Claude Code 跨管理來源依鍵合併[受管設定](/docs/zh-TW/managed-settings#precedence-within-the-managed-tier)的 `env` 區塊，使僅套用最高優先順序來源的整個 `env` 區塊，如同 v2.1.223 之前的行為。請在啟動 Claude Code 的環境中設定，因為 Claude Code 會忽略透過設定 `env` 區塊傳遞的副本。需要 Claude Code v2.1.223 或更新版本 |

243| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | 設為 `1` 可停用 [advisor 工具](/docs/zh-TW/advisor)。`/advisor` 命令會變成無法使用，任何已設定的 `advisorModel` 都會被忽略，而 `--advisor` 旗標仍會被接受但無效，因此傳遞此旗標的現有指令碼仍可正常運作而不會出錯 |243| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | 設定為 `1` 可停用 [advisor 工具](/docs/zh-TW/advisor)。`/advisor` 命令將無法使用，任何已設定的 `advisorModel` 都會被忽略，而 `--advisor` 旗標仍會被接受但沒有效果，因此傳入此旗標的現有指令碼可繼續運作而不會出錯 |

244| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | 設為 `1` 可關閉[背景 agent 與 agent view](/docs/zh-TW/agent-view)：`claude agents`、`--bg`、`/background` 以及隨需監督程式。等同於 [`disableAgentView`](/docs/zh-TW/settings-reference#disableagentview) 設定 |244| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | 設定為 `1` 可關閉[背景 agent 與 agent view](/docs/zh-TW/agent-view)：`claude agents`、`--bg`、`/background` 以及隨需啟動的監督程序。等同於 [`disableAgentView`](/docs/zh-TW/settings-reference#disableagentview) 設定 |

245| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | 設為 `1` 可停用[全螢幕呈現](/docs/zh-TW/fullscreen)並使用傳統的主畫面呈現器。對話會保留在終端機的原生捲動緩衝區中，因此 `Cmd+f` 與 tmux 複製模式可照常運作。優先於 `CLAUDE_CODE_NO_FLICKER` 與 [`tui`](/docs/zh-TW/settings-reference#tui) 設定。您也可以使用 `/tui default` 切換。不適用於從 [agent view](/docs/zh-TW/agent-view) 開啟的背景工作階段，這些工作階段一律使用全螢幕呈現 |245| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | 設定為 `1` 可停用[全螢幕呈現](/docs/zh-TW/fullscreen)並使用傳統的主畫面呈現器。對話會保留在終端機的原生捲動緩衝區中，因此 `Cmd+f` 與 tmux 複製模式可照常運作。優先於 `CLAUDE_CODE_NO_FLICKER` 與 [`tui`](/docs/zh-TW/settings-reference#tui) 設定。您也可以使用 `/tui default` 切換。不適用於從 [agent view](/docs/zh-TW/agent-view) 開啟的背景工作階段，這些工作階段一律使用全螢幕呈現 |

246| `CLAUDE_CODE_DISABLE_ARTIFACT` | 設為 `1` 可關閉 [Artifact](/docs/zh-TW/artifacts) 工具，該工具會將工作階段輸出發布為 claude.ai 上的私人網頁。一旦設定，任何設定檔都無法重新開啟此工具。若要改從設定檔關閉此工具，請將 [`enableArtifact`](/docs/zh-TW/settings-reference#enableartifact) 設為 `false`；已棄用的 [`disableArtifact`](/docs/zh-TW/settings-reference#disableartifact) 鍵也會將其關閉 |246| `CLAUDE_CODE_DISABLE_ARTIFACT` | 設定為 `1` 可關閉 [Artifact](/docs/zh-TW/artifacts) 工具，該工具會將工作階段輸出發布為 claude.ai 上的私人網頁。設定後，任何設定檔都無法重新開啟該工具。若要改從設定檔關閉該工具，請將 [`enableArtifact`](/docs/zh-TW/settings-reference#enableartifact) 設為 `false`；已棄用的 [`disableArtifact`](/docs/zh-TW/settings-reference#disableartifact) 鍵也會將其關閉 |

247| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | 設為 `1` 可停用附件處理。使用 `@` 語法的檔案提及會以純文字傳送，而不會展開為檔案內容 |247| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | 設定為 `1` 可停用附件處理。使用 `@` 語法的檔案提及會以純文字傳送，而不會展開為檔案內容 |

248| `CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK` | 設為 `1` 可讓 Claude Code 程序自行執行其 [`gcpAuthRefresh`](/docs/zh-TW/settings-reference#gcpauthrefresh) 或 [`awsAuthRefresh`](/docs/zh-TW/settings-reference#awsauthrefresh) 命令，而非在另一個程序執行時等待。需要 Claude Code v2.1.286 或更新版本 |248| `CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK` | 設定為 `1` 可讓 Claude Code 程序自行執行其 [`gcpAuthRefresh`](/docs/zh-TW/settings-reference#gcpauthrefresh) 或 [`awsAuthRefresh`](/docs/zh-TW/settings-reference#awsauthrefresh) 命令，而不是在另一個程序執行該命令時等待。需要 Claude Code v2.1.286 或更新版本 |

249| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | 設為 `1` 可停用[自動記憶](/docs/zh-TW/memory#auto-memory)。設為 `0` 可強制開啟自動記憶，即使 `--bare` 模式或 [`autoMemoryEnabled: false`](/docs/zh-TW/settings-reference#automemoryenabled) 原本會將其停用亦然。停用時，Claude 不會建立或載入自動記憶檔案 |249| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | 設定為 `1` 可停用[自動記憶](/docs/zh-TW/memory#auto-memory)。設定為 `0` 可強制開啟自動記憶，即使 `--bare` 模式或 [`autoMemoryEnabled: false`](/docs/zh-TW/settings-reference#automemoryenabled) 原本會將其停用。停用時，Claude 不會建立或載入自動記憶檔案 |

250| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | 設為 `1` 可停用所有背景任務功能，包括 Bash 與 subagent 工具上的 `run_in_background` 參數、自動背景化以及 Ctrl+B 快捷鍵 |250| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | 設定為 `1` 可停用所有背景任務功能，包括 Bash 與 subagent 工具上的 `run_in_background` 參數、自動背景化以及 Ctrl+B 快捷鍵 |

251| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | 設為 `1` 可讓 Claude Code 不再將缺少或為空 `Content-Type` 標頭的 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) 串流回應視為 Amazon Bedrock 的二進位事件串流。預設情況下，Claude Code 會假設閘道從原本未經修改的回應中移除了該標頭，因此會解碼主體，讓串流持續運作。僅在閘道也將串流重新以伺服器傳送事件形式發出時才設定此變數；Claude Code 接著會將無標頭的主體讀取為伺服器傳送事件。需要 Claude Code v2.1.239 或更新版本 |251| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | 設定為 `1` 可阻止 Claude Code 將缺少 `Content-Type` 標頭或該標頭為空的 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) 串流回應視為 Amazon Bedrock 的二進位事件串流。預設情況下，Claude Code 會假設是閘道從原本未經修改的回應中移除了該標頭，因此會解碼主體，讓串流繼續運作。僅在閘道同時將串流重新以伺服器傳送事件形式發出時才設定此變數；Claude Code 接著會將不含標頭的主體讀取為伺服器傳送事件。需要 Claude Code v2.1.239 或更新版本 |

252| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | 設為 `1` 可略過檢查 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) 串流回應是否帶有 `application/vnd.amazon.eventstream` content-type。若未設定此變數，當回應帶有不同的 content-type 時，Claude Code 會讓請求失敗並顯示指出該類型的錯誤，這表示[閘道或代理伺服器正在轉換回應](/docs/zh-TW/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy)。請將閘道設定為原封不動地轉送 `Content-Type` 標頭與主體，而非設定此變數。需要 Claude Code v2.1.208 或更新版本 |252| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | 設定為 `1` 可略過檢查 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) 串流回應是否帶有 `application/vnd.amazon.eventstream` content-type。若未設定此變數，當回應帶有不同的 content-type 時，Claude Code 會使請求失敗，並顯示指出該類型的錯誤，這表示[閘道或代理伺服器正在轉換回應](/docs/zh-TW/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy)。請將閘道設定為原封不動地轉送 `Content-Type` 標頭與主體，而不是設定此變數。需要 Claude Code v2.1.208 或更新版本 |

253| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | 設為 `1` 可在[監督程式](/docs/zh-TW/agent-view#the-supervisor-process)停止、重新啟動或更新[背景工作階段](/docs/zh-TW/agent-view)的程序時，停止該工作階段正在執行的背景 shell 命令、動態工作流程，以及自 v2.1.198 起的背景 subagent，而不是將它們移交給該工作階段的下一個程序。僅影響該移交：使用 `←` 或 [`/background`](/docs/zh-TW/agent-view#from-inside-a-session) 將工作階段背景化時，仍會延續進行中的工作，而 `CLAUDE_DISABLE_ADOPT` 會同時關閉兩者。需要 Claude Code v2.1.196 或更新版本 |253| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | 設定為 `1` 可在[監督程序](/docs/zh-TW/agent-view#the-supervisor-process)停止、重新啟動或更新[背景工作階段](/docs/zh-TW/agent-view)的程序時，停止該工作階段正在執行的背景 shell 命令、動態工作流程，以及自 v2.1.198 起的背景 subagent，而不是將其交給該工作階段的下一個程序。僅影響該交接：使用 `←` 或 [`/background`](/docs/zh-TW/agent-view#from-inside-a-session) 將工作階段移至背景時，仍會帶著進行中的工作，而 `CLAUDE_DISABLE_ADOPT` 會同時關閉兩者。需要 Claude Code v2.1.196 或更新版本 |

254| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | 設為 `1` 可讓 Claude Code 不再於記憶體壓力下終止[背景 shell 命令](/docs/zh-TW/interactive-mode#background-bash-commands)。預設情況下，在 macOS 與 Linux 上，當作業系統回報嚴重記憶體壓力，且工作階段已閒置 30 分鐘而沒有任何回合或 subagent 在執行時，Claude Code 會終止背景 shell。Windows 沒有記憶體壓力訊號，因此此變數在該平台上無效。需要 Claude Code v2.1.193 或更新版本 |254| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | 設定為 `1` 可阻止 Claude Code 在記憶體壓力下終止[背景 shell 命令](/docs/zh-TW/interactive-mode#background-bash-commands)。預設情況下，在 macOS 與 Linux 上，當作業系統回報嚴重記憶體壓力，且工作階段已閒置 30 分鐘、沒有任何回合或 subagent 在執行時，Claude Code 會終止背景 shell。Windows 沒有記憶體壓力訊號，因此此變數在 Windows 上沒有效果。需要 Claude Code v2.1.193 或更新版本 |

255| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | 設為 `1` 可停用 Claude Code 隨附的 [skill](/docs/zh-TW/skills) 與工作流程：隨附 skill 與工作流程會完全移除，而 `/init` 等內建命令仍可輸入，但會對模型隱藏。`/doctor` 如同內建命令一樣仍可輸入；請改用 `DISABLE_DOCTOR_COMMAND` 將其隱藏。來自外掛、`.claude/skills/` 與 `.claude/commands/` 的 skill 不受影響。等同於 [`disableBundledSkills`](/docs/zh-TW/settings-reference#disablebundledskills) 設定 |255| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | 設定為 `1` 可停用 Claude Code 隨附的 [skill](/docs/zh-TW/skills) 與工作流程：隨附 skill 與工作流程會被完全移除，而 `/init` 等內建命令仍可輸入，但會對模型隱藏。`/doctor` 與內建命令一樣仍可輸入；請改用 `DISABLE_DOCTOR_COMMAND` 將其隱藏。來自外掛、`.claude/skills/` 與 `.claude/commands/` 的 skill 不受影響。等同於 [`disableBundledSkills`](/docs/zh-TW/settings-reference#disablebundledskills) 設定 |

256| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | 設為 `1` 可保留 [Claude in Chrome](/docs/zh-TW/chrome) 瀏覽器工具，同時省略系統提示詞中的 Chrome 區段與 `/claude-in-chrome` [隨附 skill](/docs/zh-TW/skills#bundled-skills)。適用於嵌入 Claude Code 並提供自身瀏覽器指引的主機。需要 Claude Code v2.1.257 或更新版本 |256| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | 設定為 `1` 可保留 [Claude in Chrome](/docs/zh-TW/chrome) 瀏覽器工具，同時省略系統提示詞中的 Chrome 區段以及 `/claude-in-chrome` [隨附 skill](/docs/zh-TW/skills#bundled-skills)。適用於嵌入 Claude Code 並提供自己瀏覽器指引的主機。需要 Claude Code v2.1.257 或更新版本 |

257| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | 設為 `1` 可防止將任何 CLAUDE.md 記憶檔案載入上下文，包括使用者、專案與自動記憶檔案 |257| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | 設定為 `1` 可避免將任何 CLAUDE.md 記憶檔案載入上下文，包括使用者、專案與自動記憶檔案 |

258| `CLAUDE_CODE_DISABLE_CRON` | 設為 `1` 可停用[排程任務](/docs/zh-TW/scheduled-tasks)。`/loop` skill 與 cron 工具會變成無法使用，且任何已排程的任務都會停止觸發，包括已在工作階段中途執行的任務 |258| `CLAUDE_CODE_DISABLE_CRON` | 設定為 `1` 可停用[排程任務](/docs/zh-TW/scheduled-tasks)。`/loop` skill 與 cron 工具將無法使用，且任何已排程的任務都會停止觸發，包括在工作階段中已在執行的任務 |

259| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | 設為 `1` 可關閉[關鍵路徑移除](/docs/zh-TW/permission-modes#critical-paths)提示的時間限制。在 `auto` 模式中，Claude Code 接著會改將這些移除動作送交分類器；在 `bypassPermissions` 模式中，提示會等待您的回答。請在啟動 Claude Code 的環境中設定，因為 Claude Code 會忽略透過設定 `env` 區塊傳遞的副本。需要 Claude Code v2.1.281 或更新版本 |259| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | 設定為 `1` 可關閉[關鍵路徑移除](/docs/zh-TW/permission-modes#critical-paths)提示的時間限制。接著在 `auto` 模式中，Claude Code 會改將這些移除操作送交分類器；在 `bypassPermissions` 模式中，提示會等待您的回答。請在啟動 Claude Code 的環境中設定，因為 Claude Code 會忽略透過設定 `env` 區塊傳遞的副本。需要 Claude Code v2.1.281 或更新版本 |

260| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | 設為 `1` 可從 API 請求中移除預發布的 `anthropic-beta` 請求標頭、與其搭配的主體欄位，以及 `defer_loading` 與 `eager_input_streaming` 等 beta 工具結構描述欄位。當代理伺服器閘道針對 `anthropic-beta` 標頭以 `Unexpected value(s)` 錯誤或 `Extra inputs are not permitted` 錯誤拒絕請求時，請使用此變數。[停用預發布功能](/docs/zh-TW/llm-gateway-protocol#disable-pre-release-capabilities)列出此變數移除的項目（包括 [MCP Tool Search](/docs/zh-TW/mcp#scale-with-mcp-tool-search)），以及 Claude Code 仍會傳送的項目 |260| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | 設定為 `1` 可從 API 請求中移除預先發布的 `anthropic-beta` 請求標頭、與其搭配的主體欄位，以及 `defer_loading` 與 `eager_input_streaming` 等 beta 工具結構描述欄位。當代理伺服器閘道以針對 `anthropic-beta` 標頭的 `Unexpected value(s)` 錯誤或 `Extra inputs are not permitted` 錯誤拒絕請求時，請使用此設定。[停用預先發布功能](/docs/zh-TW/llm-gateway-protocol#disable-pre-release-capabilities)列出了此變數移除的項目（包括 [MCP tool search](/docs/zh-TW/mcp#scale-with-mcp-tool-search)），以及 Claude Code 仍會傳送的項目 |

261| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | 設為 `1` 可停用內建的 [Explore 與 Plan subagent](/docs/zh-TW/sub-agents#built-in-subagents)。Claude 會改用其搜尋工具或 general-purpose subagent 進行探索，而 [plan mode](/docs/zh-TW/permission-modes#analyze-before-you-edit-with-plan-mode) 會直接讀取檔案，而非啟動 Explore 與 Plan agent。名為 `Explore` 或 `Plan` 的自訂 subagent 不受影響。若要在 Agent SDK 或非互動模式中移除所有內建 subagent 類型，請改用 `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`。需要 Claude Code v2.1.198 或更新版本 |261| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | 設定為 `1` 可停用內建的 [Explore 與 Plan subagent](/docs/zh-TW/sub-agents#built-in-subagents)。Claude 會改用其搜尋工具或 general-purpose subagent 進行探索，而 [plan mode](/docs/zh-TW/permission-modes#analyze-before-you-edit-with-plan-mode) 會直接讀取檔案，而非啟動 Explore 與 Plan agent。名為 `Explore` 或 `Plan` 的自訂 subagent 不受影響。若要在 Agent SDK 或非互動模式中移除所有內建 subagent 類型，請改用 `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`。需要 Claude Code v2.1.198 或更新版本 |

262| `CLAUDE_CODE_DISABLE_FAST_MODE` | 設為 `1` 可停用[快速模式](/docs/zh-TW/fast-mode) |262| `CLAUDE_CODE_DISABLE_FAST_MODE` | 設定為 `1` 可停用[快速模式](/docs/zh-TW/fast-mode) |

263| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | 設為 `1` 可停用「How is Claude doing?」工作階段品質問卷。當設定了 `DISABLE_TELEMETRY`、`DO_NOT_TRACK` 或 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 時，問卷也會停用，除非 `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` 重新選擇加入。若要設定取樣率而非完全停用，請使用 [`feedbackSurveyRate`](/docs/zh-TW/settings-reference#feedbacksurveyrate) 設定。請參閱[工作階段品質問卷](/docs/zh-TW/data-usage#session-quality-surveys) |263| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | 設定為 `1` 可停用「How is Claude doing?」工作階段品質問卷。當設定了 `DISABLE_TELEMETRY`、`DO_NOT_TRACK` 或 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 時，問卷也會停用，除非 `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` 重新選擇加入。若要設定取樣率而非完全停用，請使用 [`feedbackSurveyRate`](/docs/zh-TW/settings-reference#feedbacksurveyrate) 設定。請參閱[工作階段品質問卷](/docs/zh-TW/data-usage#session-quality-surveys) |

264| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | 設為 `1` 可停用檔案[檢查點功能](/docs/zh-TW/checkpointing)。`/rewind` 命令將無法還原程式碼變更。覆寫 [`fileCheckpointingEnabled`](/docs/zh-TW/settings-reference#filecheckpointingenabled) 設定 |264| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | 設定為 `1` 可停用檔案[檢查點功能](/docs/zh-TW/checkpointing)。`/rewind` 命令將無法還原程式碼變更。覆寫 [`fileCheckpointingEnabled`](/docs/zh-TW/settings-reference#filecheckpointingenabled) 設定 |

265| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | 設為 `1` 可從 Claude 的上下文中移除內建的提交與 PR 工作流程指令，以及 git 狀態快照。在使用您自己的 git 工作流程 skill 時很有用。設定時優先於 [`includeGitInstructions`](/docs/zh-TW/settings-reference#includegitinstructions) 設定 |265| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | 設定為 `1` 可從 Claude 的上下文中移除內建的提交與 PR 工作流程指令以及 git 狀態快照。在使用您自己的 git 工作流程 skill 時很有用。設定後會優先於 [`includeGitInstructions`](/docs/zh-TW/settings-reference#includegitinstructions) 設定 |

266| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | 設為 `1` 可防止在 Anthropic API 上將 Opus 4.0 與 4.1 自動重新對應至目前的 Opus 版本。當您刻意想固定使用較舊的模型時使用。此重新對應不會在 Amazon Bedrock、Google Cloud's Agent Platform 或 Microsoft Foundry 上執行 |266| `CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT` | 設定為 `1` 可阻止 Claude Code 讀取以 `-c` 傳給 shell 的指令碼（例如 `bash -c 'rm -rf ~'`）來檢查[關鍵路徑](/docs/zh-TW/permission-modes#removals-inside-nested-commands-and-inline-scripts)移除。Claude Code 仍會檢查這些指令碼中的 shell 變數與位置參數目標，其他關鍵路徑檢查也會持續執行。請在啟動 Claude Code 的環境中設定，因為 Claude Code 會忽略透過設定 `env` 區塊傳遞的副本。需要 Claude Code v2.1.288 或更新版本 |

267| `CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK` | 設為 `1` 可在您的帳戶於工作階段中途失去對該工作階段模型的存取權時，讓 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock#when-a-model-is-disabled-mid-session) 與 [Google Cloud's Agent Platform](/docs/zh-TW/google-vertex-ai#when-a-model-is-disabled-mid-session) 上的 Claude Code 不再切換至較舊的模型；被拒絕的請求會立即失敗。您設定的[備援模型鏈](/docs/zh-TW/model-config#fallback-model-chains)仍會在該拒絕時切換，且[啟動模型檢查](/docs/zh-TW/amazon-bedrock#startup-model-checks)在啟動時仍會改用其他模型。需要 Claude Code v2.1.285 或更新版本 |267| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | 設定為 `1` 可避免在 Anthropic API 上將 Opus 4.0 與 4.1 自動重新對應至目前的 Opus 版本。當您刻意要固定使用較舊的模型時使用。此重新對應不會在 Amazon Bedrock、Google Cloud's Agent Platform 或 Microsoft Foundry 上執行 |

268| `CLAUDE_CODE_DISABLE_MOUSE` | 設為 `1` 可在[全螢幕呈現](/docs/zh-TW/fullscreen)中停用滑鼠追蹤。使用 `PgUp` 與 `PgDn` 的鍵盤捲動仍可運作。使用此變數可保留終端機原生的選取即複製行為 |268| `CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK` | 設定為 `1` 可在您的帳戶於工作階段中途失去對該工作階段模型的存取權時，阻止 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock#when-a-model-is-disabled-mid-session) 與 [Google Cloud's Agent Platform](/docs/zh-TW/google-vertex-ai#when-a-model-is-disabled-mid-session) 上的 Claude Code 切換至較舊的模型；被拒絕的請求會改為立即失敗。您設定的[備援模型鏈](/docs/zh-TW/model-config#fallback-model-chains)仍會在該拒絕發生時切換，且[啟動模型檢查](/docs/zh-TW/amazon-bedrock#startup-model-checks)仍會在啟動時改用其他模型。需要 Claude Code v2.1.285 或更新版本 |

269| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | 設為 `1` 可在[全螢幕呈現](/docs/zh-TW/fullscreen)中停用點選、拖曳與滑鼠懸停處理，同時保留滑鼠滾輪捲動。當您希望滾輪捲動在 Claude Code 中運作，但不希望點選會定位游標、展開工具輸出或開啟連結時使用。兩者皆設定時，`CLAUDE_CODE_DISABLE_MOUSE` 優先。需要 Claude Code v2.1.195 或更新版本 |269| `CLAUDE_CODE_DISABLE_MOUSE` | 設定為 `1` 可在[全螢幕呈現](/docs/zh-TW/fullscreen)中停用滑鼠追蹤。使用 `PgUp` 與 `PgDn` 的鍵盤捲動仍可運作。可用此設定保留終端機原生的選取即複製行為 |

270| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | 設為 `1` 可讓 Claude Code 在 API 請求因連線層級錯誤（例如連線重設或 TLS 交握錯誤）而失敗時，不再重新讀取 [mTLS 用戶端憑證與金鑰](/docs/zh-TW/network-config#mtls-authentication)。停用重新載入後，Claude Code 只會在下次套用設定時或下次啟動時載入輪替後的檔案。需要 Claude Code v2.1.232 或更新版本 |270| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | 設定為 `1` 可在[全螢幕呈現](/docs/zh-TW/fullscreen)中停用點擊、拖曳與懸停處理，同時保留滑鼠滾輪捲動。當您希望滾輪捲動在 Claude Code 中運作，但不希望點擊會定位游標、展開工具輸出或開啟連結時，請使用此設定。兩者都設定時，`CLAUDE_CODE_DISABLE_MOUSE` 優先。需要 Claude Code v2.1.195 或更新版本 |

271| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | 設為任何非空值（例如 `1`）可停用非必要的網路流量：自動更新、遙測、錯誤回報、`/feedback` 命令、[Claude 草擬的意見回饋](/docs/zh-TW/tools-reference#sendfeedback-tool-behavior)、版本資訊、[PR 與 MR 狀態徽章](/docs/zh-TW/interactive-mode#pr-review-status)檢查，以及[快速模式](/docs/zh-TW/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways)檢查等可用性檢查。它也會停止[外掛 `command` 來源的背景執行](/docs/zh-TW/plugins/loading#when-a-command-source-re-runs)，這些是本機命令而非網路流量，但因為它們可能觸發相依套件安裝。**將其設為 `0` 或 `false` 仍會停用此流量**，這與大多數開啟/關閉變數不同；請取消設定此變數以重新允許。也會停用功能旗標擷取，這會使 [Remote Control](/docs/zh-TW/remote-control#requirements) 以及其他[需要功能旗標擷取的功能](#features-that-need-feature-flag-fetching)無法使用。官方外掛市集自動安裝不在涵蓋範圍內；請使用 `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` 將其停用。不影響[閘道模型探索](/docs/zh-TW/llm-gateway-connect#add-gateway-models-to-the-model-picker)，該功能有其自己的選擇加入機制 |271| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | 設定為 `1` 可阻止 Claude Code 在 API 請求因連線層級錯誤（例如連線重設或 TLS 交握錯誤）而失敗時，重新讀取 [mTLS 用戶端憑證與金鑰](/docs/zh-TW/network-config#mtls-authentication)。停用重新載入後，Claude Code 僅在下次套用設定時或下次啟動時載入輪替後的檔案。需要 Claude Code v2.1.232 或更新版本 |

272| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | 設為 `1` 可在串流請求於串流中途失敗時停用非串流備援。串流錯誤會改為傳遞至重試層。當代理伺服器或閘道導致備援產生重複的工具執行時很有用 |272| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | 設定為任何非空值（例如 `1`）可停用非必要的網路流量：自動更新、遙測、錯誤回報、`/feedback` 命令、[Claude 草擬的意見回饋](/docs/zh-TW/tools-reference#sendfeedback-tool-behavior)、版本資訊、[PR 與 MR 狀態徽章](/docs/zh-TW/interactive-mode#pr-review-status)檢查，以及[快速模式](/docs/zh-TW/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways)檢查等可用性檢查。它也會停止[外掛 `command` 來源的背景執行](/docs/zh-TW/plugins/loading#when-a-command-source-re-runs)，這些是本機命令而非網路流量，但因為它們可能觸發相依套件安裝而一併停止。**將其設定為 `0` 或 `false` 仍會停用此流量**，這與大多數開關變數不同；請取消設定該變數以重新允許。也會停用功能旗標擷取，這會使 [Remote Control](/docs/zh-TW/remote-control#requirements) 以及其他[需要功能旗標擷取的功能](#features-that-need-feature-flag-fetching)無法使用。不涵蓋官方外掛市集的自動安裝；請使用 `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` 停用。不影響[閘道模型探索](/docs/zh-TW/llm-gateway-connect#add-gateway-models-to-the-model-picker)，其有自己的選擇加入機制 |

273| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | 設為 `1` 可讓 `PushNotification` 工具即使在您於終端機中輸入或終端機處於焦點時，仍傳送桌面通知。預設情況下，當工具偵測到最近的鍵盤活動或終端機焦點時，會同時略過桌面通知與[行動推播](/docs/zh-TW/remote-control#mobile-push-notifications)。此變數只停用該本機檢查，因此當伺服器偵測到您處於活動狀態時，仍可抑制行動推播。需要 Claude Code v2.1.193 或更新版本 |273| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | 設定為 `1` 可在串流請求於串流中途失敗時停用非串流備援。串流錯誤會改為傳遞至重試層。當代理伺服器或閘道導致備援產生重複的工具執行時很有用 |

274| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | 設為 `1` 可停用官方外掛市集的自動註冊。Claude Code 會在即將註冊市集時讀取此變數，通常是在電腦第一次互動式啟動期間。如果當時已設定此變數，Claude Code 會永久略過註冊。之後取消設定此變數並不會撤銷該略過。隨時執行 `claude plugin marketplace add anthropics/claude-plugins-official` 即可註冊該市集 |274| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | 設定為 `1` 可讓 `PushNotification` 工具即使在您正在終端機中輸入或終端機處於焦點時，仍傳送桌面通知。預設情況下，當工具偵測到最近的鍵盤活動或終端機焦點時，會同時略過桌面通知與[行動推播](/docs/zh-TW/remote-control#mobile-push-notifications)。此變數僅停用該本機檢查，因此伺服器在偵測到您處於活動狀態時，仍可抑制行動推播。需要 Claude Code v2.1.193 或更新版本 |

275| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | 設為 `1` 可讓 Claude Code 在將未回答的權限請求傳送至 Agent SDK 的 `canUseTool` 回呼的工作階段中（Claude Desktop 與 VS Code 擴充功能即以此方式託管 Claude Code），不再執行您[針對未回答權限請求的 `Notification` hook](/docs/zh-TW/hooks#notification)。在終端機工作階段中無效。需要 Claude Code v2.1.233 或更新版本 |275| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | 設定為 `1` 可停用官方外掛市集的自動註冊。Claude Code 會在即將註冊市集時讀取此變數，通常是在機器首次互動式啟動期間。若當時已設定此變數，Claude Code 會永久略過註冊。之後取消設定該變數並不會撤銷此略過。可隨時執行 `claude plugin marketplace add anthropics/claude-plugins-official` 註冊市集 |

276| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | 設為 `1` 可略過從全系統受管 skill 目錄載入 skill。適用於不應載入營運者佈建之 skill 的容器或 CI 工作階段 |276| `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 或更新版本 |

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_POLICY_SKILLS` | 設定為 `1` 可略過從全系統受管 skill 目錄載入 skill。適用於不應載入由操作人員佈建之 skill 的容器或 CI 工作階段 |

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_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 或更新版本 |

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_REFUSAL_FALLBACK` | 設定為 `1` 可關閉[安全分類器標記請求時的自動模型切換](/docs/zh-TW/model-config#automatic-model-fallback)，也就是 [`switchModelsOnFlag`](/docs/zh-TW/settings-reference#switchmodelsonflag) 設定所控制的行為 |

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

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` 同樣會省略此參數，因此兩個變數在該處的行為相同 |281| `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 或更新版本 |

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

283| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | 設為 `1` 可在[全螢幕呈現](/docs/zh-TW/fullscreen)中停用虛擬捲動，並呈現逐字稿中的每則訊息。如果在全螢幕模式中捲動時，訊息應出現的位置顯示空白區域，請使用此變數 |283| `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` 同樣會省略此參數，因此兩個變數在那裡的行為相同 |

284| `CLAUDE_CODE_DISABLE_WEB_FETCH` | 設為 `1` 可關閉 [WebFetch](/docs/zh-TW/tools-reference#webfetch-tool-behavior) 工具。[WebSearch](/docs/zh-TW/tools-reference#websearch-tool-behavior) 工具仍可使用。需要 Claude Code v2.1.285 或更新版本 |284| `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 或更新版本 |

285| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | 設為 `1` 可在 Windows 上直接啟動 [PowerShell 工具](/docs/zh-TW/tools-reference#powershell-tool)命令，而非透過 `cmd.exe` 啟動器。預設情況下，啟動器讓[在背景執行](/docs/zh-TW/tools-reference#background-commands)的 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 或更新版本 |285| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | 設定為 `1` 可在[全螢幕呈現](/docs/zh-TW/fullscreen)中停用虛擬捲動，並呈現逐字稿中的每則訊息。若在全螢幕模式中捲動時，應顯示訊息的地方出現空白區域，請使用此設定 |

286| `CLAUDE_CODE_DISABLE_WORKFLOWS` | 設為 `1` 可停用[工作流程](/docs/zh-TW/workflows#turn-workflows-off)。等同於 [`disableWorkflows`](/docs/zh-TW/settings-reference#disableworkflows) 設定 |286| `CLAUDE_CODE_DISABLE_WEB_FETCH` | 設定為 `1` 可關閉 [WebFetch](/docs/zh-TW/tools-reference#webfetch-tool-behavior) 工具。[WebSearch](/docs/zh-TW/tools-reference#websearch-tool-behavior) 工具仍可使用。需要 Claude Code v2.1.285 或更新版本 |

287| `CLAUDE_CODE_EFFORT_LEVEL` | 為支援的模型設定 effort 等級。值：`low`、`medium`、`high`、`xhigh`、`max`，或使用 `auto` 以採用模型預設值。可用的等級取決於模型。優先於 `--effort`、`/effort`，以及 `modelSettings` 與 `effortLevel` 設定。[`maxEffortLevel`](/docs/zh-TW/settings-reference#maxeffortlevel) 上限仍然適用。請參閱[調整 effort 等級](/docs/zh-TW/model-config#adjust-effort-level) |287| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | 設定為 `1` 可在 Windows 上直接啟動 [PowerShell 工具](/docs/zh-TW/tools-reference#powershell-tool)命令，而非透過 `cmd.exe` 啟動器。預設情況下，啟動器讓[在背景執行](/docs/zh-TW/tools-reference#background-commands)的 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 或更新版本 |

288| `CLAUDE_CODE_ENABLE_AUTO_MODE` | 為了與較舊版本相容而接受，但不會有任何作用。自動模式在每個供應商上預設皆可使用，包括 Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry，以及已登入的 [Claude apps gateway](/docs/zh-TW/claude-apps-gateway) 工作階段。在 v2.1.158 至 v2.1.206 中，必須將此變數設為 `1`，才能在這些供應商上使用[自動模式](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) |288| `CLAUDE_CODE_DISABLE_WORKFLOWS` | 設定為 `1` 可停用[工作流程](/docs/zh-TW/workflows#turn-workflows-off)。等同於 [`disableWorkflows`](/docs/zh-TW/settings-reference#disableworkflows) 設定 |

289| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | 覆寫[工作階段回顧](/docs/zh-TW/interactive-mode#session-recap)的可用性。設為 `0` 可強制關閉回顧，不論 `/config` 切換開關為何。設為 `1` 可在 [`awaySummaryEnabled`](/docs/zh-TW/settings-reference#awaysummaryenabled) 為 `false` 時強制開啟回顧。優先於該設定與 `/config` 切換開關 |289| `CLAUDE_CODE_EFFORT_LEVEL` | 設定支援模型的 effort 等級。值：`low`、`medium`、`high`、`xhigh`、`max`，或使用 `auto` 以採用模型預設值。可用的等級取決於模型。優先於 `--effort`、`/effort`，以及 `modelSettings` 與 `effortLevel` 設定。[`maxEffortLevel`](/docs/zh-TW/settings-reference#maxeffortlevel) 上限仍會套用。請參閱[調整 effort 等級](/docs/zh-TW/model-config#adjust-effort-level) |

290| `CLAUDE_CODE_ENABLE_AUTO_MODE` | 為了與舊版相容而接受，但沒有任何作用。自動模式在每個提供者上預設皆可使用，包括 Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry，以及已登入的 [Claude apps gateway](/docs/zh-TW/claude-apps-gateway) 工作階段。在 v2.1.158 至 v2.1.206 中，必須將此設為 `1`，才能在這些提供者上使用[自動模式](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) |

291| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | 覆寫[工作階段回顧](/docs/zh-TW/interactive-mode#session-recap)的可用性。設為 `0` 可強制關閉回顧，不論 `/config` 切換開關為何。當 [`awaySummaryEnabled`](/docs/zh-TW/settings-reference#awaysummaryenabled) 為 `false` 時，設為 `1` 可強制開啟回顧。優先於該設定與 `/config` 切換開關 |

290| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | 設為 `1` 可在[非互動模式](/docs/zh-TW/headless)中，於背景安裝完成後在回合邊界重新整理外掛狀態。預設為關閉，因為重新整理會在工作階段中途變更系統提示詞，導致該回合的[提示快取](/docs/zh-TW/prompt-caching)失效 |292| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | 設為 `1` 可在[非互動模式](/docs/zh-TW/headless)中，於背景安裝完成後在回合邊界重新整理外掛狀態。預設為關閉，因為重新整理會在工作階段中途變更系統提示詞，導致該回合的[提示快取](/docs/zh-TW/prompt-caching)失效 |

291| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | 設為 `1` 可在傳送至 Anthropic 的非必要流量遭封鎖時，將「How is Claude doing?」工作階段品質調查導向您自己的 [OpenTelemetry collector](/docs/zh-TW/monitoring-usage)。調查評分僅會以 OTEL 事件的形式傳送至您設定的 collector。在此模式下，不會有任何調查資料傳送給 Anthropic。適用於已設定 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`、`DISABLE_TELEMETRY` 或 `DO_NOT_TRACK` 的情況，否則不會有任何作用。`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` 與組織的產品意見回饋政策優先於此變數 |293| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | 設為 `1` 可在傳送至 Anthropic 的非必要流量遭封鎖時，將「How is Claude doing?」工作階段品質問卷導向您自己的 [OpenTelemetry collector](/docs/zh-TW/monitoring-usage)。問卷評分僅會以 OTEL 事件的形式傳送至您設定的 collector。在此模式下，不會有任何問卷資料傳送給 Anthropic。僅在設定了 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`、`DISABLE_TELEMETRY` 或 `DO_NOT_TRACK` 時適用，否則沒有作用。`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` 與組織的產品意見回饋政策優先於此變數 |

292| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | 控制工具呼叫輸入是否在 Claude 產生時從 API 串流傳輸。關閉此功能時，大型工具輸入（例如寫入長檔案）只會在 Claude 完成產生後才送達，看起來可能像是停滯。在 Anthropic API 上預設為啟用。在 Amazon Bedrock 與 Google Cloud's Agent Platform 上，會依模型在所部署的容器支援時啟用。設為 `0` 可選擇停用。透過 `ANTHROPIC_BASE_URL`、`ANTHROPIC_VERTEX_BASE_URL` 或 `ANTHROPIC_BEDROCK_BASE_URL` 經由代理伺服器路由時，設為 `1` 可強制啟用。在 Microsoft Foundry 與[閘道](/docs/zh-TW/llm-gateway)連線上預設為關閉 |294| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | 控制工具呼叫的輸入是否在 Claude 產生時從 API 串流傳送。關閉時，大型工具輸入（例如寫入長檔案）只會在 Claude 產生完畢後才送達，看起來可能像是卡住了。在 Anthropic API 上預設為啟用。在 Amazon Bedrock 與 Google Cloud's Agent Platform 上，會依模型在部署的容器支援時啟用。設為 `0` 可選擇退出。透過 `ANTHROPIC_BASE_URL`、`ANTHROPIC_VERTEX_BASE_URL` 或 `ANTHROPIC_BEDROCK_BASE_URL` 經由代理伺服器路由時，設為 `1` 可強制開啟。在 Microsoft Foundry 與[閘道](/docs/zh-TW/llm-gateway)連線上預設為關閉 |

293| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | 當 `ANTHROPIC_BASE_URL` 指向與 Anthropic 相容的閘道（例如 LiteLLM、Kong 或內部代理伺服器）時，設為 `1` 可從閘道的 `/v1/models` 端點填入 `/model` 選擇器。預設為關閉，否則以共用 API 金鑰為後端的閘道會向每位使用者顯示該金鑰可存取的所有模型。探索到的模型仍會依工作階段接收到的 [`availableModels`](/docs/zh-TW/settings-reference#availablemodels) 允許清單進行篩選；請透過 [MDM 或受管設定檔](/docs/zh-TW/managed-settings#delivery-mechanisms)提供此清單，因為[伺服器受管傳遞不適用於閘道設定](/docs/zh-TW/server-managed-settings#platform-availability) |295| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | 當 `ANTHROPIC_BASE_URL` 指向與 Anthropic 相容的閘道（例如 LiteLLM、Kong 或內部代理伺服器）時，設為 `1` 可從閘道的 `/v1/models` 端點填入 `/model` 選擇器。預設為關閉，因為以共用 API 金鑰為後端的閘道，否則會向每位使用者顯示該金鑰可存取的所有模型。探索到的模型仍會依工作階段收到的 [`availableModels`](/docs/zh-TW/settings-reference#availablemodels) 允許清單進行篩選；請透過 [MDM 或受管設定檔](/docs/zh-TW/managed-settings#delivery-mechanisms)提供該清單，因為[伺服器管理的傳遞方式在閘道設定上無法使用](/docs/zh-TW/server-managed-settings#platform-availability) |

294| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | 已於 v2.1.142 移除，當時[快速模式](/docs/zh-TW/fast-mode)的預設模型從 Opus 4.6 改為 Opus 4.7 |296| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | 已於 v2.1.142 移除，當時[快速模式](/docs/zh-TW/fast-mode)的預設從 Opus 4.6 改為 Opus 4.7 |

295| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | 設為 `false` 可關閉提示詞建議，也就是出現在提示詞輸入框中的灰色預測。優先於 [`promptSuggestionEnabled`](/docs/zh-TW/settings-reference#promptsuggestionenabled) 設定，即 `/config` 中 **Prompt suggestions** 切換開關所寫入的設定。Claude Code 也會[在您的帳戶接近或已達用量上限時暫停建議](/docs/zh-TW/interactive-mode#when-claude-code-skips-suggestions)。設為 `true` 可讓建議保持開啟，直到您達到上限為止。需要 Claude Code v2.1.238 或更新版本。請參閱[提示詞建議](/docs/zh-TW/interactive-mode#prompt-suggestions) |297| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | 設為 `false` 可關閉提示詞建議，也就是出現在提示詞輸入框中的灰色預測文字。優先於 [`promptSuggestionEnabled`](/docs/zh-TW/settings-reference#promptsuggestionenabled) 設定，`/config` 中的 **Prompt suggestions** 切換開關寫入的就是該設定。當您的帳戶接近或已達用量上限時，Claude Code 也會[暫停建議](/docs/zh-TW/interactive-mode#when-claude-code-skips-suggestions)。設為 `true` 可讓建議保持開啟，直到您達到上限為止。需要 Claude Code v2.1.238 或更新版本。請參閱[提示詞建議](/docs/zh-TW/interactive-mode#prompt-suggestions) |

296| `CLAUDE_CODE_ENABLE_TASKS` | 選擇 Claude Code 在[具備這些工具的工作階段](/docs/zh-TW/tools-reference#task-tool-availability)中提供哪些任務追蹤工具。預設情況下，Claude Code 提供 Task 工具 `TaskCreate`、`TaskUpdate`、`TaskGet` 與 `TaskList`。設為 `0` 可改用舊版的 `TodoWrite` 工具。請參閱[任務清單](/docs/zh-TW/interactive-mode#task-list) |298| `CLAUDE_CODE_ENABLE_TASKS` | 選擇 Claude Code 在[具備這些工具的工作階段](/docs/zh-TW/tools-reference#task-tool-availability)中提供哪些任務追蹤工具。預設情況下，Claude Code 提供 Task 工具 `TaskCreate`、`TaskUpdate`、`TaskGet` 與 `TaskList`。設為 `0` 可改用舊版的 `TodoWrite` 工具。請參閱[任務清單](/docs/zh-TW/interactive-mode#task-list) |

297| `CLAUDE_CODE_ENABLE_TELEMETRY` | 設為 `1` 可啟用用於指標與日誌的 OpenTelemetry 資料收集。設定 OTel exporter 之前必須先設定此變數。請在您的 shell、使用者設定或受管設定中設定它。在[專案與本機設定](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)中會被忽略。請參閱[監控](/docs/zh-TW/monitoring-usage) |299| `CLAUDE_CODE_ENABLE_TELEMETRY` | 設為 `1` 可啟用 OpenTelemetry 的指標與日誌資料收集。必須先設定此變數才能設定 OTel exporter。請在您的 shell、使用者設定或受管設定中設定。在[專案與本機設定](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)中會被忽略。請參閱[監控](/docs/zh-TW/monitoring-usage) |

298| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | 設為 `1` 可在每個模型上取得任務追蹤工具。若未設定，Claude Code 預設僅在 [Task 工具可用性](/docs/zh-TW/tools-reference#task-tool-availability)下列出的模型上提供這些工具。`CLAUDE_CODE_ENABLE_TASKS` 仍會選擇 Task 工具或 `TodoWrite`。需要 Claude Code v2.1.233 或更新版本 |300| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | 設為 `1` 可在所有模型上取得任務追蹤工具。若未設定，Claude Code 預設只會在 [Task 工具可用性](/docs/zh-TW/tools-reference#task-tool-availability)中列出的模型上提供這些工具。`CLAUDE_CODE_ENABLE_TASKS` 仍會決定使用 Task 工具或 `TodoWrite`。需要 Claude Code v2.1.233 或更新版本 |

299| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | 查詢迴圈進入閒置後，自動結束前要等待的時間（毫秒）。適用於使用 SDK 模式的自動化工作流程與腳本 |301| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | 查詢迴圈進入閒置後，自動結束前等待的時間（毫秒）。適用於使用 SDK 模式的自動化工作流程與指令碼 |

300| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | 設為 `1` 可啟用 [agent teams](/docs/zh-TW/agent-teams)。Agent teams 為實驗性功能，預設為停用 |302| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | 設為 `1` 可啟用 [agent teams](/docs/zh-TW/agent-teams)。Agent teams 為實驗性功能，預設為停用 |

301| `CLAUDE_CODE_EXTRA_BODY` | 要合併至每個 API 請求主體頂層的 JSON 物件。適用於傳遞 Claude Code 未直接公開的供應商專屬參數。在 shell 中匯出的值也會套用至您使用 `claude agents` 或 `--bg` 分派的[背景工作階段](/docs/zh-TW/agent-view)。在 v2.1.206 之前，背景工作階段會忽略 shell 匯出的值，而使用背景監督程序所繼承的副本 |303| `CLAUDE_CODE_EXTRA_BODY` | 要合併至每個 API 請求本文最上層的 JSON 物件。適用於傳遞 Claude Code 未直接提供的提供者專屬參數。在您的 shell 中匯出的值，也會套用至您以 `claude agents` 或 `--bg` 派送的[背景工作階段](/docs/zh-TW/agent-view)。在 v2.1.206 之前，背景工作階段會忽略 shell 匯出的值，而使用背景監督程序所繼承的那份值 |

302| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | 覆寫檔案讀取的預設 token 上限。適用於需要完整讀取較大檔案時 |304| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | 覆寫檔案讀取的預設 token 上限。適用於需要完整讀取較大檔案的情況 |

303| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | 設為 `1` 可強制保存逐字稿、提示詞歷史記錄與 `claude agents` 註冊，即使此 `claude` 是從另一個 Claude Code 工作階段內啟動的也一樣。當繼承的 `CLAUDE_CODE_CHILD_SESSION` 值（例如來自 `screen` 工作階段，或最初由 Claude Code 的 Bash 工具啟動的背景啟動器）導致真正的頂層工作階段被誤判為巢狀工作階段時使用。自 v2.1.178 起，Claude Code 會自動偵測 tmux 的情況並忽略繼承的標記，因此 tmux 不再需要此變數。在 v2.1.169 及更早版本中同樣有效；在 v2.1.170 與 v2.1.171 中沒有作用，因為這兩個版本移除了它所覆寫的巢狀工作階段偵測 |305| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | 設為 `1` 可強制保存逐字稿、提示詞歷史記錄，並進行 `claude agents` 註冊，即使此 `claude` 是從另一個 Claude Code 工作階段內啟動的。當繼承而來的 `CLAUDE_CODE_CHILD_SESSION` 值（例如來自 `screen` 工作階段，或最初由 Claude Code 的 Bash 工具啟動的背景啟動器）導致真正的最上層工作階段被誤判為巢狀工作階段時使用。自 v2.1.178 起，Claude Code 會自動偵測 tmux 的情況並忽略繼承的標記，因此 tmux 不再需要此變數。在 v2.1.169 及更早版本中也會採用此變數；在 v2.1.170 與 v2.1.171 中沒有作用，因為這兩個版本移除了它所覆寫的巢狀工作階段偵測 |

304| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | 設為 `1` 可在終端機支援但未被自動偵測時（例如透過 SSH 連線且未轉送 `TERM_PROGRAM`），強制以刪除線呈現 Claude 回應中的 `~~text~~`。若未設定，未被偵測到的終端機會顯示字面的 `~~` 標記，而不是以刪除線呈現文字。需要 Claude Code v2.1.186 或更新版本 |306| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | 當您的終端機支援刪除線但未被自動偵測到時（例如透過 SSH 連線且未轉送 `TERM_PROGRAM`），設為 `1` 可強制以刪除線呈現 Claude 回應中的 `~~text~~`。若未設定，未被偵測到的終端機會顯示字面上的 `~~` 標記，而不是將文字呈現為刪除線。需要 Claude Code v2.1.186 或更新版本 |

305| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | 設為 `1` 可在終端機支援但未被自動偵測時，強制啟用 DEC private mode 2026 [同步輸出](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036)。適用於實作了 BSU/ESU 但不回應功能探測的模擬器，例如 Emacs `eat`。在 tmux 下沒有作用。與會切換至[全螢幕呈現](/docs/zh-TW/fullscreen)的 `CLAUDE_CODE_NO_FLICKER` 不同，此變數不會變更渲染器 |307| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | 當您的終端機支援但未被自動偵測到時，設為 `1` 可強制啟用 DEC private mode 2026 [同步輸出](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036)。適用於實作了 BSU/ESU 但不回應功能探測的模擬器，例如 Emacs `eat`。在 tmux 下沒有作用。與會切換至[全螢幕呈現](/docs/zh-TW/fullscreen)的 `CLAUDE_CODE_NO_FLICKER` 不同，此變數不會變更呈現器 |

306| `CLAUDE_CODE_FORK_SUBAGENT` | 控制 [fork 模式](/docs/zh-TW/sub-agents#turn-fork-mode-on-or-off)，此模式可讓 Claude 自行產生 [fork 的 subagent](/docs/zh-TW/sub-agents#fork-the-current-conversation)，且僅在互動式工作階段中預設為開啟。設為 `1` 可在 `claude -p` 與 Agent SDK 中也開啟它，設為 `0` 則在所有類型的工作階段中關閉。無論 fork 模式是否開啟，您都可以執行 `/subtask`。互動式預設值需要 Claude Code v2.1.232 或更新版本；在較早版本中，請將此變數設為 `1` 以開啟 fork 模式 |308| `CLAUDE_CODE_FORK_SUBAGENT` | 控制[分支模式](/docs/zh-TW/sub-agents#turn-fork-mode-on-or-off)，此模式讓 Claude 能自行產生[分支 subagent](/docs/zh-TW/sub-agents#fork-the-current-conversation)，且預設僅在互動式工作階段中開啟。設為 `1` 可在 `claude -p` 與 Agent SDK 中也開啟，設為 `0` 則可在所有類型的工作階段中關閉。無論分支模式是否開啟，您都可以執行 `/subtask`。互動式預設需要 Claude Code v2.1.232 或更新版本；在較早的版本中，請將此變數設為 `1` 以開啟分支模式 |

307| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | 設為 `1` 可在 `claude -p --output-format stream-json` 輸出中發出 [subagent](/docs/zh-TW/sub-agents) 的文字與思考區塊，行為與 [`--forward-subagent-text`](/docs/zh-TW/cli-reference#cli-flags) 旗標相同。當呼叫 `claude` 的執行框架無法自行傳遞該旗標時，請使用此變數。該旗標在搭配 stream-json 輸出的非互動模式之外使用時會以錯誤結束，而此變數在這些情況下會被忽略，因此在整個程序範圍設定此變數時，巢狀呼叫仍可正常運作。需要 Claude Code v2.1.211 或更新版本 |309| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | 設為 `1` 可在 `claude -p --output-format stream-json` 輸出中發出 [subagent](/docs/zh-TW/sub-agents) 的文字與思考區塊，行為與 [`--forward-subagent-text`](/docs/zh-TW/cli-reference#cli-flags) 旗標相同。當執行框架呼叫 `claude` 但無法自行傳遞該旗標時，請使用此變數。該旗標在非 stream-json 輸出的非互動模式以外會以錯誤結束，而此變數在這些情況下會被忽略，因此在整個程序範圍內設定時，巢狀呼叫仍能正常運作。需要 Claude Code v2.1.211 或更新版本 |

308| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | 設為 `1` 可在自訂代理伺服器或第三方供應商（例如 Amazon Bedrock 或 Claude Platform on AWS）上傳送[閘道提示標頭](/docs/zh-TW/llm-gateway-protocol#gateway-hint-headers)，例如 `x-claude-code-request-class` 與 `x-claude-code-compaction`。設為 `0` 可在每個連線上停止傳送，包括直接連線至 Anthropic API 的情況，在該情況下 Claude Code 預設會傳送它們。需要 Claude Code v2.1.273 或更新版本 |310| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | 設為 `1` 可在自訂代理伺服器或第三方提供者（例如 Amazon Bedrock 或 Claude Platform on AWS）上傳送[閘道提示標頭](/docs/zh-TW/llm-gateway-protocol#gateway-hint-headers)，例如 `x-claude-code-request-class` 與 `x-claude-code-compaction`。設為 `0` 可在所有連線上停止傳送這些標頭，包括直接連線至 Anthropic API 的情況，Claude Code 在此情況下預設會傳送這些標頭。需要 Claude Code v2.1.273 或更新版本 |

309| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | 由 `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` 開啟的[閘道模型探索](/docs/zh-TW/llm-gateway-protocol#model-discovery)請求的逾時時間（毫秒）（預設：`3000`）。當您的閘道在啟動時需要超過三秒才能回應 `/v1/models` 時，請調高此值。僅接受純數字；`0`、負值及其他寫法會維持預設值。需要 Claude Code v2.1.269 或更新版本 |311| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | 由 `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` 開啟的[閘道模型探索](/docs/zh-TW/llm-gateway-protocol#model-discovery)請求的逾時時間（毫秒）（預設：`3000`）。當您的閘道在啟動時需要超過三秒才能回應 `/v1/models` 時，請調高此值。僅接受純數字；`0`、負值及其他寫法會維持預設值。需要 Claude Code v2.1.269 或更新版本 |

310| `CLAUDE_CODE_GIT_BASH_PATH` | 僅限 Windows：Git Bash 執行檔（`bash.exe`）的路徑。當 Git Bash 已安裝但不在您的 PATH 中時使用。若路徑不存在，或檔案名稱不是 `bash.exe`、`sh.exe`、`bash` 或 `sh`，Claude Code 會忽略此變數，並如同未設定一般自動偵測 Git Bash，同時記錄一則可透過 `--debug` 看到的警告。在 v2.1.219 之前，當路徑不存在時 Claude Code 會在啟動時結束，並且會將任何現有檔案當作 shell 使用，而不檢查它是否為 bash 或 sh。請參閱 [Windows 設定](/docs/zh-TW/setup#set-up-on-windows) |312| `CLAUDE_CODE_GIT_BASH_PATH` | 僅限 Windows：Git Bash 執行檔（`bash.exe`）的路徑。當已安裝 Git Bash 但不在您的 PATH 中時使用。若路徑不存在，或檔案名稱不是 `bash.exe`、`sh.exe`、`bash` 或 `sh`，Claude Code 會忽略此變數，並如同未設定般自動偵測 Git Bash，同時記錄一則可透過 `--debug` 查看的警告。在 v2.1.219 之前，路徑不存在時 Claude Code 會在啟動時結束，且會將任何現有檔案當作 shell 使用，而不檢查它是否為 bash 或 sh。請參閱 [Windows 設定](/docs/zh-TW/setup#set-up-on-windows) |

311| `CLAUDE_CODE_GLOB_HIDDEN` | 設為 `false` 可在 Claude 呼叫 [Glob 工具](/docs/zh-TW/tools-reference#glob-tool-behavior)時從結果中排除 dotfile。預設會包含。不影響 `@` 檔案自動完成、`ls`、Grep 或 Read |313| `CLAUDE_CODE_GLOB_HIDDEN` | 設為 `false` 可在 Claude 呼叫 [Glob 工具](/docs/zh-TW/tools-reference#glob-tool-behavior)時，從結果中排除以點開頭的檔案。預設會包含這些檔案。不影響 `@` 檔案自動完成、`ls`、Grep 或 Read |

312| `CLAUDE_CODE_GLOB_NO_IGNORE` | 設為 `false` 可讓 [Glob 工具](/docs/zh-TW/tools-reference#glob-tool-behavior)遵循 `.gitignore` 模式。預設情況下，Glob 會傳回所有相符的檔案，包括被 gitignore 的檔案。不影響 `@` 檔案自動完成，其有自己的 [`respectGitignore` 設定](/docs/zh-TW/settings-reference#respectgitignore) |314| `CLAUDE_CODE_GLOB_NO_IGNORE` | 設為 `false` 可讓 [Glob 工具](/docs/zh-TW/tools-reference#glob-tool-behavior)遵循 `.gitignore` 模式。預設情況下，Glob 會傳回所有相符的檔案，包括被 gitignore 的檔案。不影響 `@` 檔案自動完成，該功能有自己的 [`respectGitignore` 設定](/docs/zh-TW/settings-reference#respectgitignore) |

313| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Glob 工具檔案探索的逾時時間（秒）。在大多數平台上預設為 20 秒，在 WSL 上為 60 秒 |315| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Glob 工具檔案探索的逾時時間（秒）。在大多數平台上預設為 20 秒，在 WSL 上為 60 秒 |

314| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | 背景工作可讓進行中的目標等待多少分鐘，之後 Claude Code 會[要求 Claude 檢查該目標](/docs/zh-TW/goal#background-work-defers-evaluation)。預設為 `30`。設為 `0` 可關閉檢查。請以純數字提供整數分鐘，最多 `10080`，即一週。Claude Code 會將任何其他值視為未設定並使用預設值。需要 Claude Code v2.1.234 或更新版本 |316| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | 背景工作可讓進行中的目標等待多少分鐘，之後 Claude Code 會[請 Claude 檢查其狀態](/docs/zh-TW/goal#background-work-defers-evaluation)。預設為 `30`。設為 `0` 可關閉檢查。請以純數字填寫整數分鐘，最多 `10080`，即一週。Claude Code 會將其他任何值視為未設定並使用預設值。需要 Claude Code v2.1.234 或更新版本 |

315| `CLAUDE_CODE_HIDE_CWD` | 設為 `1` 可在啟動標誌中隱藏工作目錄。適用於路徑會洩漏作業系統使用者名稱的螢幕分享或錄影情境 |317| `CLAUDE_CODE_HIDE_CWD` | 設為 `1` 可在啟動標誌中隱藏工作目錄。適用於螢幕分享或錄影時，路徑會暴露您作業系統使用者名稱的情況 |

316| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | 覆寫用於連線至 IDE 擴充功能的主機位址。預設情況下，Claude Code 會自動偵測正確的位址，包括 WSL 至 Windows 的路由 |318| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | 覆寫用於連線至 IDE 擴充功能的主機位址。預設情況下，Claude Code 會自動偵測正確的位址，包括 WSL 至 Windows 的路由 |

317| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | 設為 `1` 可略過 IDE 擴充功能的自動安裝。相當於將 [`autoInstallIdeExtension`](/docs/zh-TW/settings-reference#autoinstallideextension) 設為 `false` |319| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | 設為 `1` 可略過 IDE 擴充功能的自動安裝。等同於將 [`autoInstallIdeExtension`](/docs/zh-TW/settings-reference#autoinstallideextension) 設為 `false` |

318| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | 設為 `1` 可在連線期間略過 IDE lockfile 項目的驗證。當 IDE 正在執行但自動連線仍找不到它時使用 |320| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | 設為 `1` 可在連線期間略過 IDE lockfile 項目的驗證。當 IDE 正在執行但自動連線仍找不到它時使用 |

319| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | 單一工作階段中可同時執行的 [subagent](/docs/zh-TW/sub-agents#concurrent-subagent-limit) 數量上限，超過時 Agent 工具會拒絕再產生新的 subagent（預設：20）。接受以純數字表示的正整數；其他任何值都會被忽略，因此此變數可以調整上限，但無法停用它。需要 Claude Code v2.1.217 或更新版本 |321| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | 在 Agent 工具拒絕產生新的 subagent 之前，一個工作階段中可同時執行的 [subagent](/docs/zh-TW/sub-agents#concurrent-subagent-limit) 數量（預設：20）。接受以純數字表示的正整數；其他任何值都會被忽略，因此此變數可調整上限，但無法停用上限。需要 Claude Code v2.1.217 或更新版本 |

320| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | 覆寫 Claude Code 為目前模型所假設的上下文視窗大小。自 v2.1.193 起，其套用方式取決於 Claude Code 如何解析模型 ID；請參閱[修正閘道或自訂模型 ID 的視窗](/docs/zh-TW/model-config#correct-the-window-for-a-gateway-or-custom-model-id)。當透過 `ANTHROPIC_BASE_URL` 路由至某個模型，而其上下文視窗與該名稱的內建大小不符時使用 |322| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | 覆寫 Claude Code 為目前模型假定的上下文視窗大小。自 v2.1.193 起，其套用方式取決於 Claude Code 如何解析模型 ID；請參閱[修正閘道或自訂模型 ID 的視窗](/docs/zh-TW/model-config#correct-the-window-for-a-gateway-or-custom-model-id)。當透過 `ANTHROPIC_BASE_URL` 路由至某個模型，而其上下文視窗與該名稱的內建大小不符時使用 |

321| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Claude Code 傳送給模型的每個 MCP 工具描述與每個 MCP 伺服器指令的最大長度（字元數）（預設：2048）。Claude Code 會[截斷較長的文字](/docs/zh-TW/mcp#for-mcp-server-authors)。接受以純數字表示的正整數。其他任何值都會被忽略並套用預設值。需要 Claude Code v2.1.280 或更新版本 |323| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Claude Code 傳送給模型的每個 MCP 工具描述與每個 MCP 伺服器指令的最大長度（字元數）（預設：2048）。Claude Code 會[截斷較長的文字](/docs/zh-TW/mcp#for-mcp-server-authors)。接受以純數字表示的正整數。其他任何值都會被忽略並套用預設值。需要 Claude Code v2.1.280 或更新版本 |

322| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | 設定大多數請求的最大輸出 token 數量。預設值與上限因模型而異；請參閱[最大輸出 token](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison)。若值超過模型上限，Claude Code 會將其降至上限。對於 Claude Code 無法解析為已知模型的模型 ID，預設值為 32000，上限為 128000。提高此值會減少觸發[自動壓縮](/docs/zh-TW/costs#reduce-token-usage)前可用的有效上下文視窗 |324| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | 設定大多數請求的最大輸出 token 數。預設值與上限因模型而異；請參閱[最大輸出 token](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison)。若值超過模型的上限，Claude Code 會將其降至上限。對於 Claude Code 無法解析為已知模型的模型 ID，預設值為 32000，上限為 128000。調高此值會減少觸發[自動壓縮](/docs/zh-TW/costs#reduce-token-usage)前可用的有效上下文視窗 |

323| `CLAUDE_CODE_MAX_RETRIES` | 覆寫失敗 API 請求的重試次數（預設：10）。自 v2.1.186 起上限為 15；自 v2.1.199 起，`CLAUDE_CODE_RETRY_WATCHDOG` 會提高預設值並移除上限。對於需要撐過較長服務中斷的無人值守工作階段，請改為設定 `CLAUDE_CODE_RETRY_WATCHDOG` |325| `CLAUDE_CODE_MAX_RETRIES` | 覆寫失敗 API 請求的重試次數（預設：10）。自 v2.1.186 起上限為 15；自 v2.1.199 起，`CLAUDE_CODE_RETRY_WATCHDOG` 會提高預設值並移除上限。對於需要撐過較長中斷時間的無人值守工作階段，請改為設定 `CLAUDE_CODE_RETRY_WATCHDOG` |

324| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | 已於 v2.1.224 移除，現在不具任何作用。先前用於限制 Claude 在單一工作階段中可使用 Agent 工具產生的 [subagent](/docs/zh-TW/sub-agents) 總數（預設：200）；超過上限時產生會失敗並顯示 `Subagent spawn limit reached`。[並行 subagent 限制](/docs/zh-TW/sub-agents#concurrent-subagent-limit)與[深度限制](/docs/zh-TW/sub-agents#let-subagents-spawn-their-own-subagents)仍然適用 |326| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | 已於 v2.1.224 移除，現在沒有作用。先前用於限制 Claude 在一個工作階段中可透過 Agent 工具產生的 [subagent](/docs/zh-TW/sub-agents) 總數（預設：200）；超過上限時產生會以 `Subagent spawn limit reached` 失敗。[同時執行的 subagent 上限](/docs/zh-TW/sub-agents#concurrent-subagent-limit)與[深度上限](/docs/zh-TW/sub-agents#let-subagents-spawn-their-own-subagents)仍然適用 |

325| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | 主對話之下允許的 [subagent 層數](/docs/zh-TW/sub-agents#let-subagents-spawn-their-own-subagents) （預設：3）。在預設值下，subagent 可以產生自己的 subagent，而位於第三層的 subagent 無法再繼續產生；設為 `1` 可關閉巢狀。在 v2.1.217 至 v2.1.218 中，預設值為 1，因此除非您提高限制，否則 subagent 無法產生自己的 subagent；v2.1.219 將預設值提高為 3。接受以純數字表示的正整數；其他任何值都會被忽略，因此此限制可以調整但無法移除。需要 Claude Code v2.1.217 或更新版本 |327| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | 主對話之下允許的 [subagent 層數](/docs/zh-TW/sub-agents#let-subagents-spawn-their-own-subagents)（預設：3）。在預設值下，subagent 可以產生自己的 subagent，而位於第三層的 subagent 無法再繼續產生；設為 `1` 可關閉巢狀產生。在 v2.1.217 至 v2.1.218 中，預設值為 1，因此除非您提高上限，否則 subagent 無法產生自己的 subagent；v2.1.219 將預設值提高為 3。接受以純數字表示的正整數；其他任何值都會被忽略，因此上限可以調整但無法移除。需要 Claude Code v2.1.217 或更新版本 |

326| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | 可平行執行的唯讀工具與 subagent 的最大數量（預設：10）。較高的值會提高平行度，但會消耗更多資源 |328| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | 可平行執行的唯讀工具與 subagent 的最大數量（預設：10）。較高的值可提高平行度，但會消耗更多資源 |

327| `CLAUDE_CODE_MAX_TURNS` | 在未傳遞明確限制時，限制 agentic 回合的數量。相當於傳遞 [`--max-turns`](/docs/zh-TW/cli-reference#cli-flags)，若兩者皆設定則以該旗標為優先。非正整數的值會在啟動時以錯誤拒絕，而不是被視為無上限 |329| `CLAUDE_CODE_MAX_TURNS` | 在未傳入明確上限時，限制 agentic 回合的數量。等同於傳入 [`--max-turns`](/docs/zh-TW/cli-reference#cli-flags)，兩者皆設定時以後者優先。非正整數的值會在啟動時以錯誤被拒絕，而不會被視為無上限 |

328| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | 單一工作階段可進行的 [WebSearch](/docs/zh-TW/tools-reference#websearch-tool-behavior) 呼叫總數上限（預設：200）。當 Claude 達到上限時，後續的 WebSearch 呼叫會傳回一則通知，告訴它以已蒐集的資訊繼續進行。接受沒有上限值的正整數。其他任何值都會被忽略並套用預設值，因此此上限可以提高但無法關閉。需要 Claude Code v2.1.212 或更新版本 |330| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | 一個工作階段可進行的 [WebSearch](/docs/zh-TW/tools-reference#websearch-tool-behavior) 呼叫總數上限（預設：200）。當 Claude 達到上限時，後續的 WebSearch 呼叫會傳回一則通知，告訴它以已收集到的資訊繼續進行。接受沒有上限的正整數。其他任何值都會被忽略並套用預設值，因此上限可以提高但無法關閉。需要 Claude Code v2.1.212 或更新版本 |

329| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | 設為 `1` 可讓 stdio MCP 伺服器僅以安全的基本環境加上伺服器所設定的 `env` 啟動，而不是繼承您的 shell 環境 |331| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | 設為 `1` 可讓 stdio MCP 伺服器僅以安全的基準環境加上該伺服器設定的 `env` 來產生，而不繼承您的 shell 環境 |

330| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | 仍在執行的 MCP 工具呼叫[移至背景任務](/docs/zh-TW/mcp#automatic-backgrounding-of-long-tool-calls)前經過的時間（毫秒）（預設：120000，即 2 分鐘）。設為 `0` 可關閉自動背景執行。需要 Claude Code v2.1.212 或更新版本 |332| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | 仍在執行中的 MCP 工具呼叫[移至背景任務](/docs/zh-TW/mcp#automatic-backgrounding-of-long-tool-calls)前經過的時間（毫秒）（預設：120000，即 2 分鐘）。設為 `0` 可關閉自動移至背景。需要 Claude Code v2.1.212 或更新版本 |

331| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | [非互動](/docs/zh-TW/headless)工作階段的第一個回合等待仍在連線中之 MCP 伺服器的時間（毫秒），取代預設的[第一回合等待](/docs/zh-TW/agent-sdk/mcp#connection-timing)。設定後，等待會涵蓋所有待處理的伺服器。設為 `0` 可略過等待。無論此值為何，[`--permission-prompt-tool`](/docs/zh-TW/cli-reference#cli-flags) 伺服器都會保留其自己的 `MCP_TIMEOUT` 等待。需要 Claude Code v2.1.274 或更新版本 |333| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | [非互動](/docs/zh-TW/headless)工作階段的第一個回合等待仍在連線中的 MCP 伺服器的時間（毫秒），用以取代預設的[第一回合等待](/docs/zh-TW/agent-sdk/mcp#connection-timing)。設定後，等待會涵蓋所有待處理的伺服器。設為 `0` 可略過等待。無論此值為何，[`--permission-prompt-tool`](/docs/zh-TW/cli-reference#cli-flags) 伺服器都會維持自己的 `MCP_TIMEOUT` 等待。需要 Claude Code v2.1.274 或更新版本 |

332| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | MCP 工具呼叫的閒置逾時（毫秒）。當 stdio、HTTP、SSE、WebSocket 或 [claude.ai 連接器](/docs/zh-TW/mcp#use-mcp-servers-from-claude-ai) MCP 伺服器在這段時間內未傳送任何回應或進度通知時，工具呼叫會以錯誤中止，而不是等待整體的 `MCP_TOOL_TIMEOUT`。覆寫各傳輸方式的預設值：網路伺服器為 300000（5 分鐘），stdio 伺服器為 1800000（30 分鐘）。設為 `0` 可停用閒置檢查。低於 1000 的值會提高至一秒，且此值的上限為有效的 `MCP_TOOL_TIMEOUT`。`.mcp.json` 中至少為 1000 的個別伺服器 `timeout` 會將該伺服器的閒置時段提高至至少 `timeout` 值。不適用於 IDE 伺服器或 SDK 程序內伺服器。需要 Claude Code v2.1.187 或更新版本。在 v2.1.203 之前，stdio 伺服器不受閒置逾時限制 |334| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | MCP 工具呼叫的閒置逾時時間（毫秒）。當 stdio、HTTP、SSE、WebSocket 或 [claude.ai 連接器](/docs/zh-TW/mcp#use-mcp-servers-from-claude-ai) MCP 伺服器在這段時間內沒有傳送任何回應或進度通知時，工具呼叫會以錯誤中止，而不是等待整體的 `MCP_TOOL_TIMEOUT`。覆寫各傳輸方式的預設值：網路伺服器為 300000（5 分鐘），stdio 伺服器為 1800000（30 分鐘）。設為 `0` 可停用閒置檢查。低於 1000 的值會提高為一秒，且此值的上限為有效的 `MCP_TOOL_TIMEOUT`。`.mcp.json` 中至少為 1000 的個別伺服器 `timeout`，會將該伺服器的閒置時間窗提高至至少 `timeout` 的值。不適用於 IDE 伺服器或 SDK 同程序伺服器。需要 Claude Code v2.1.187 或更新版本。在 v2.1.203 之前，stdio 伺服器不受閒置逾時限制 |

333| `CLAUDE_CODE_MESSAGING_SOCKET` | 由 Claude Code 設定，而非由您設定：在綁定[收件匣 socket](/docs/zh-TW/cross-session-messaging#the-sessions-inbox-socket) 的工作階段中，Claude Code 會在綁定 socket 時將該 socket 的路徑匯出給 hook 與 Bash 命令。在啟用傳訊功能啟動的工作階段中，Claude Code 會在任何 hook 執行之前綁定 socket。機器上的其他工作階段會將訊息傳遞至此路徑。每個工作階段都會匯出自己的 socket，而非從父工作階段繼承的 socket，抵達該 socket 的訊息會經過工作階段的[傳入控制](/docs/zh-TW/cross-session-messaging#control-inbound-messages)。設定中的 `env` 區塊無法設定它。需要 Claude Code v2.1.224 或更新版本 |335| `CLAUDE_CODE_MESSAGING_SOCKET` | 由 Claude Code 設定，而非由您設定：在綁定 [inbox socket](/docs/zh-TW/cross-session-messaging#the-sessions-inbox-socket) 的工作階段中，Claude Code 綁定 socket 時會將該 socket 的路徑匯出給 hook 與 Bash 命令。在開啟訊息功能啟動的工作階段中，Claude Code 會在任何 hook 執行之前綁定 socket。機器上的其他工作階段會將訊息傳遞至此路徑。每個工作階段都會匯出自己的 socket，而非從父工作階段繼承，且抵達該 socket 的訊息會經過該工作階段的[傳入控制](/docs/zh-TW/cross-session-messaging#control-inbound-messages)。設定中的 `env` 區塊無法設定此變數。需要 Claude Code v2.1.224 或更新版本 |

334| `CLAUDE_CODE_MESSAGING_TOKEN` | 由 Claude Code 設定，而非由您設定：在綁定[收件匣 socket](/docs/zh-TW/cross-session-messaging#the-sessions-inbox-socket) 的工作階段中，Claude Code 會將此工作階段專屬的 token 連同 `CLAUDE_CODE_MESSAGING_SOCKET` 一起匯出給 hook 與 Bash 命令。張貼至 socket 的腳本可以傳送 `{"type":"auth","token":"<token>"}` 作為第一行，以證明它屬於該工作階段。在原生 Windows 上，Claude Code 要求此行，並會關閉任何未以有效的此行開頭的連線。[自身子程序規則](/docs/zh-TW/cross-session-messaging#the-sessions-inbox-socket)說明 Claude Code 何時會參考此 token。每個工作階段都會匯出自己的 token，絕不會是從父工作階段繼承的 token。設定中的 `env` 區塊無法設定它。需要 Claude Code v2.1.228 或更新版本 |336| `CLAUDE_CODE_MESSAGING_TOKEN` | 由 Claude Code 設定，而非由您設定：在綁定 [inbox socket](/docs/zh-TW/cross-session-messaging#the-sessions-inbox-socket) 的工作階段中，Claude Code 會將此工作階段專屬的 token 與 `CLAUDE_CODE_MESSAGING_SOCKET` 一同匯出給 hook 與 Bash 命令。向 socket 發送訊息的指令碼可以在第一行傳送 `{"type":"auth","token":"<token>"}`，以證明它屬於該工作階段。在原生 Windows 上，Claude Code 要求必須有這一行，並會關閉任何未以有效的此行開頭的連線。[own-child 規則](/docs/zh-TW/cross-session-messaging#the-sessions-inbox-socket)說明 Claude Code 何時會參考此 token。每個工作階段都會匯出自己的 token，絕不會從父工作階段繼承。設定中的 `env` 區塊無法設定此變數。需要 Claude Code v2.1.228 或更新版本 |

335| `CLAUDE_CODE_NATIVE_CURSOR` | 設為 `1` 可在輸入插入點顯示終端機本身的游標，而非繪製的方塊。游標會遵循終端機的閃爍、形狀與焦點設定 |337| `CLAUDE_CODE_NATIVE_CURSOR` | 設為 `1` 可在輸入插入點顯示終端機本身的游標，而不是繪製的方塊。該游標會遵循終端機的閃爍、形狀與焦點設定 |

336| `CLAUDE_CODE_NEW_INIT` | 設為 `1` 可讓 `/init` 執行互動式設定流程。此流程會在探索程式碼庫並寫入檔案之前，詢問要產生哪些檔案，包括 CLAUDE.md、skill 與 hook。若未設定此變數，`/init` 會自動產生 CLAUDE.md 而不進行詢問 |338| `CLAUDE_CODE_NEW_INIT` | 設為 `1` 可讓 `/init` 執行互動式設定流程。該流程會先詢問要產生哪些檔案，包括 CLAUDE.md、skill 與 hook，然後才探索程式碼庫並寫入這些檔案。若未設定此變數，`/init` 會自動產生 CLAUDE.md 而不進行詢問 |

337| `CLAUDE_CODE_NONBLOCKING_STDOUT` | 設為 `1` 可透過第二個非阻塞檔案描述元寫入終端機輸出，讓停止讀取的終端機（例如已暫停的 tmux control-mode 窗格或停滯的 SSH 連線）無法在工作階段中途凍結 Claude Code。當 stdout 為終端機時，適用於 macOS、Linux 與 WSL。需要 Claude Code v2.1.261 或更新版本 |339| `CLAUDE_CODE_NONBLOCKING_STDOUT` | 設為 `1` 可透過第二個非阻塞式檔案描述元寫入終端機輸出，如此一來，停止讀取的終端機（例如暫停的 tmux control-mode 窗格或停滯的 SSH 連線）便無法讓 Claude Code 在工作階段中途凍結。當 stdout 為終端機時，適用於 macOS、Linux 與 WSL。需要 Claude Code v2.1.261 或更新版本 |

338| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | 限制 Claude Code 重新傳送逾時之[非串流請求](/docs/zh-TW/errors#streaming-response-ended-before-any-complete-data-was-received)的次數。設為 `0` 時，請求會在第一次逾時時失敗。預設為未設定，因此由 `CLAUDE_CODE_MAX_RETRIES` 限制這些重新傳送。有關逾時，請參閱[調整重試行為](/docs/zh-TW/errors#tune-retry-behavior)。需要 Claude Code v2.1.285 或更新版本 |340| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | 限制 Claude Code 重新傳送逾時的[非串流請求](/docs/zh-TW/errors#streaming-response-ended-before-any-complete-data-was-received)的次數。設為 `0` 時，請求會在第一次逾時即失敗。預設為未設定，因此由 `CLAUDE_CODE_MAX_RETRIES` 限制這些重新傳送。關於逾時時間，請參閱[調整重試行為](/docs/zh-TW/errors#tune-retry-behavior)。需要 Claude Code v2.1.285 或更新版本 |

339| `CLAUDE_CODE_NO_FLICKER` | 設為 `1` 可啟用[全螢幕呈現](/docs/zh-TW/fullscreen)，這是一項研究預覽功能，可減少閃爍並在長對話中維持記憶體用量穩定。覆寫 [`tui`](/docs/zh-TW/settings-reference#tui) 設定；您也可以使用 `/tui fullscreen` 切換 |341| `CLAUDE_CODE_NO_FLICKER` | 設為 `1` 可啟用[全螢幕呈現](/docs/zh-TW/fullscreen)，這是一項研究預覽功能，可減少閃爍並在長對話中維持穩定的記憶體用量。覆寫 [`tui`](/docs/zh-TW/settings-reference#tui) 設定；您也可以使用 `/tui fullscreen` 切換 |

340| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | 用於 Claude.ai 身分驗證的 OAuth refresh token。設定後，`claude auth login` 會直接交換此 token，而不是開啟瀏覽器。需要 `CLAUDE_CODE_OAUTH_SCOPES`。適用於在自動化環境中佈建身分驗證 |342| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | 用於 Claude.ai 身分驗證的 OAuth refresh token。設定後，`claude auth login` 會直接交換此 token，而不是開啟瀏覽器。需要 `CLAUDE_CODE_OAUTH_SCOPES`。適用於在自動化環境中佈建身分驗證 |

341| `CLAUDE_CODE_OAUTH_SCOPES` | 核發 refresh token 時所使用的 OAuth 範圍，以空格分隔，例如 `"user:profile user:inference user:sessions:claude_code"`。設定 `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` 時為必要 |343| `CLAUDE_CODE_OAUTH_SCOPES` | 核發 refresh token 時所用的 OAuth 範圍，以空格分隔，例如 `"user:profile user:inference user:sessions:claude_code"`。設定 `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` 時為必要項目 |

342| `CLAUDE_CODE_OAUTH_TOKEN` | 用於 claude.ai 身分驗證的 OAuth 存取 token。SDK 與自動化環境中 `/login` 的替代方案。優先於儲存在鑰匙圈中的憑證。使用 [`claude setup-token`](/docs/zh-TW/authentication#generate-a-long-lived-token) 產生一個。除非您執行 [`/login`](/docs/zh-TW/authentication#authentication-precedence)，否則 Claude Code 會在整個工作階段中使用您設定的 token。若要替換已過期的 token，請產生新的 token 並重新啟動 |344| `CLAUDE_CODE_OAUTH_TOKEN` | 用於 claude.ai 身分驗證的 OAuth access token。是 SDK 與自動化環境中 `/login` 的替代方案。優先於儲存在鑰匙圈中的憑證。可使用 [`claude setup-token`](/docs/zh-TW/authentication#generate-a-long-lived-token) 產生。除非您執行 [`/login`](/docs/zh-TW/authentication#authentication-precedence)，否則 Claude Code 會在整個工作階段中使用您設定的 token。若要替換已過期的 token，請產生新的 token 並重新啟動 |

343| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | 已於 v2.1.160 移除，現在不具任何作用。先前用於將[快速模式](/docs/zh-TW/fast-mode)固定為 Claude Opus 4.6，而非目前的預設值。Opus 4.6 已不再支援快速模式 |345| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | 已於 v2.1.160 移除，現在沒有作用。先前用於將[快速模式](/docs/zh-TW/fast-mode)固定為 Claude Opus 4.6，而非目前的預設值。Opus 4.6 已不再支援快速模式 |

344| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | 承載內容之 OpenTelemetry 屬性（模型回應、工具內容、系統提示詞、原始 API 主體）的最大長度，包含截斷標記在內，以 UTF-16 程式碼單元計算（預設：61440，即 60 KB）。僅在您的遙測後端接受大於 64 KB 的屬性值時才提高此值，或降低此值以減少遙測量。需要 Claude Code v2.1.214 或更新版本。請參閱[監控](/docs/zh-TW/monitoring-usage) |346| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | 承載內容的 OpenTelemetry 屬性（模型回應、工具內容、系統提示詞、原始 API 本文）的最大長度，包含截斷標記，以 UTF-16 code unit 計算（預設：61440，即 60 KB）。僅在您的遙測後端接受大於 64 KB 的屬性值時才調高，或調低以減少遙測量。需要 Claude Code v2.1.214 或更新版本。請參閱[監控](/docs/zh-TW/monitoring-usage) |

345| `CLAUDE_CODE_OTEL_DIAG_STDERR` | 設為 `1` 可將 OpenTelemetry exporter 的診斷錯誤寫入 stderr。預設情況下，這些錯誤只會在使用 `--debug` 時出現，因此設定錯誤的 exporter（例如 Prometheus 連接埠衝突）原本會無聲無息地失敗。需要 Claude Code v2.1.179 或更新版本。請參閱[監控](/docs/zh-TW/monitoring-usage) |347| `CLAUDE_CODE_OTEL_DIAG_STDERR` | 設為 `1` 可將 OpenTelemetry exporter 的診斷錯誤寫入 stderr。預設情況下，這些錯誤只會在使用 `--debug` 時出現，因此設定錯誤的 exporter（例如 Prometheus 連接埠衝突）否則會靜默失敗。需要 Claude Code v2.1.179 或更新版本。請參閱[監控](/docs/zh-TW/monitoring-usage) |

346| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | 清除待處理 OpenTelemetry span 的逾時時間（毫秒）（預設：5000）。請參閱[監控](/docs/zh-TW/monitoring-usage) |348| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | 清空待處理 OpenTelemetry span 的逾時時間（毫秒）（預設：5000）。請參閱[監控](/docs/zh-TW/monitoring-usage) |

347| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 重新整理動態 OpenTelemetry 標頭的間隔（毫秒）（預設：1740000 / 29 分鐘）。請參閱[動態標頭](/docs/zh-TW/monitoring-usage#dynamic-headers) |349| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 重新整理動態 OpenTelemetry 標頭的間隔（毫秒）（預設：1740000 / 29 分鐘）。請參閱[動態標頭](/docs/zh-TW/monitoring-usage#dynamic-headers) |

348| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | OpenTelemetry exporter 在關閉時完成作業的逾時時間（毫秒）（預設：2000）。若指標在結束時遺失，請提高此值。請參閱[監控](/docs/zh-TW/monitoring-usage) |350| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | OpenTelemetry exporter 在關閉時完成作業的逾時時間（毫秒）（預設：2000）。若結束時指標遺失，請調高此值。請參閱[監控](/docs/zh-TW/monitoring-usage) |

349| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | 設為 `1` 可讓 Claude Code 在有新版本可用時，於背景執行套件管理器的升級命令。適用於 Homebrew 與 WinGet 安裝。其他套件管理器仍會顯示升級命令而不執行。請參閱[自動更新](/docs/zh-TW/setup#auto-updates) |351| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | 設為 `1` 可讓 Claude Code 在有新版本時於背景執行您套件管理員的升級命令。適用於 Homebrew 與 WinGet 安裝。其他套件管理員會繼續顯示升級命令而不執行。請參閱[自動更新](/docs/zh-TW/setup#auto-updates) |

350| `CLAUDE_CODE_PERFORCE_MODE` | 設為 `1` 可啟用 Perforce 感知的寫入保護。設定後，若目標檔案缺少擁有者寫入位元（Perforce 會在同步的檔案上清除此位元，直到 `p4 edit` 開啟它們為止），Edit、Write 與 NotebookEdit 會失敗並顯示 `p4 edit <file>` 提示。這可防止 Claude Code 繞過 Perforce 變更追蹤 |352| `CLAUDE_CODE_PERFORCE_MODE` | 設為 `1` 可啟用感知 Perforce 的寫入保護。設定後，若目標檔案缺少擁有者寫入位元，Edit、Write 與 NotebookEdit 會失敗並顯示 `p4 edit <file>` 提示；Perforce 會清除已同步檔案的此位元，直到以 `p4 edit` 開啟為止。這可防止 Claude Code 繞過 Perforce 的變更追蹤 |

351| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | 覆寫外掛根目錄。儘管名稱如此，此變數設定的是父目錄，而非快取本身：市集與外掛快取位於此路徑下的子目錄中。預設為 `~/.claude/plugins` |353| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | 覆寫外掛根目錄。儘管名稱如此，此變數設定的是父目錄，而非快取本身：市集與外掛快取位於此路徑下的子目錄中。預設為 `~/.claude/plugins` |

352| `CLAUDE_CODE_PLUGIN_DIRS` | 要為工作階段載入的外掛目錄，每個目錄的載入方式與 [`--plugin-dir`](/docs/zh-TW/plugins/cli-reference#flags-that-load-a-plugin-for-one-session) 旗標相同。在 Unix 上以 `:` 分隔多個路徑，在 Windows 上以 `;` 分隔。請將每個路徑指定為絕對路徑或以 `~` 開頭，因為 Claude Code 會略過相對路徑。需要 Claude Code v2.1.280 或更新版本。請參閱[為單一工作階段載入外掛](/docs/zh-TW/plugins/create#load-a-directory-or-archive-for-one-session) |354| `CLAUDE_CODE_PLUGIN_DIRS` | 要為工作階段載入的外掛目錄，每個目錄的載入方式都與 [`--plugin-dir`](/docs/zh-TW/plugins/cli-reference#flags-that-load-a-plugin-for-one-session) 旗標相同。在 Unix 上以 `:` 分隔多個路徑，在 Windows 上則以 `;` 分隔。請將每個路徑指定為絕對路徑或以 `~` 開頭，因為 Claude Code 會略過相對路徑。需要 Claude Code v2.1.280 或更新版本。請參閱[為單一工作階段載入外掛](/docs/zh-TW/plugins/create#load-a-directory-or-archive-for-one-session) |

353| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | 複製或重新整理外掛市集的逾時時間（毫秒）（預設：120000）。對於大型儲存庫或緩慢的網路連線，請提高此值。請參閱 [Git clone timed out](/docs/zh-TW/plugins/troubleshooting#git-clone-timed-out-after-120s) |355| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | 複製或重新整理外掛市集的逾時時間（毫秒）（預設：120000）。對於大型儲存庫或緩慢的網路連線，請調高此值。請參閱 [Git clone 逾時](/docs/zh-TW/plugins/troubleshooting#git-clone-timed-out-after-120s) |

354| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | 設為 `1` 可在市集重新整理無法連線至遠端或無法向遠端驗證身分時，略過重新複製的嘗試並繼續使用現有的市集 checkout。適用於重新複製同樣會失敗的離線或氣隙環境。請參閱[市集更新在離線環境中失敗](/docs/zh-TW/plugins/troubleshooting#marketplace-updates-keep-failing-offline) |356| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | 設為 `1` 可在市集重新整理無法連線至遠端或無法通過遠端身分驗證時，略過重新複製的嘗試，並繼續使用現有的市集 checkout。適用於重新複製也會以相同方式失敗的離線或隔離環境。請參閱[市集更新在離線環境中失敗](/docs/zh-TW/plugins/troubleshooting#marketplace-updates-keep-failing-offline) |

355| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | 設為 `1` 可透過 HTTPS 而非 SSH 複製 GitHub `owner/repo` 簡寫來源。適用於外掛安裝與更新，以及 `/plugin marketplace add` 與 `update`。適用於 CI runner、容器或任何未針對 `github.com` 設定 SSH 金鑰的環境 |357| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | 設為 `1` 可透過 HTTPS 而非 SSH 複製 GitHub `owner/repo` 簡寫來源。適用於外掛的安裝與更新，以及 `/plugin marketplace add` 與 `update`。適用於 CI runner、容器，或任何沒有為 `github.com` 設定 SSH 金鑰的環境 |

356| `CLAUDE_CODE_PLUGIN_SEED_DIR` | 一個或多個唯讀外掛種子目錄的路徑，在 Unix 上以 `:` 分隔，在 Windows 上以 `;` 分隔。使用此變數可將預先填入的外掛目錄打包至容器映像中。Claude Code 會在啟動時從這些目錄註冊市集，並使用預先快取的外掛而無需重新複製。請參閱[為容器預先填入外掛](/docs/zh-TW/plugins/org#seed-containers-and-ci) |358| `CLAUDE_CODE_PLUGIN_SEED_DIR` | 一個或多個唯讀外掛種子目錄的路徑，在 Unix 上以 `:` 分隔，在 Windows 上以 `;` 分隔。用於將預先填入的外掛目錄打包至容器映像檔中。Claude Code 會在啟動時從這些目錄註冊市集，並使用預先快取的外掛而無需重新複製。請參閱[為容器預先填入外掛](/docs/zh-TW/plugins/org#seed-containers-and-ci) |

357| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | 設為 `1` 可讓 Claude Code 在為工具呼叫、hook 與狀態列命令產生 PowerShell 時，停止傳遞 `-ExecutionPolicy Bypass`，改為遵循機器的有效執行原則。預設情況下，Claude Code 會在程序範圍略過執行原則，讓 `.ps1` 腳本與模組匯入能在預設為 Restricted 的 Windows 安裝上運作。無論此設定為何，程序範圍的略過都絕不會覆寫群組原則 `MachinePolicy` 或 `UserPolicy` |359| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | 設為 `1` 可讓 Claude Code 在為工具呼叫、hook 與狀態列命令產生 PowerShell 時，不再傳遞 `-ExecutionPolicy Bypass`，改為遵循機器的有效執行原則。預設情況下，Claude Code 會在程序範圍內略過執行原則，讓 `.ps1` 指令碼與模組匯入能在預設為 Restricted 的 Windows 安裝上運作。無論此設定為何，程序範圍的略過都不會覆寫群組原則 `MachinePolicy` 或 `UserPolicy` |

358| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | 在使用 `-p` 旗標的[非互動模式](/docs/zh-TW/headless#background-tasks-at-exit)中，最後一個回合之後閒置等待背景 subagent 與工作流程的上限（毫秒）。每當 Claude 花一個回合處理背景結果時，閒置等待就會重新計時。預設：`600000`，即 10 分鐘。當閒置等待達到上限時，Claude Code 會停止等待剩餘的背景任務並結束。設為 `0` 可無限期等待。此上限與適用於一般背景 shell 的五秒寬限期是分開的。需要 Claude Code v2.1.182 或更新版本 |360| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | 在使用 `-p` 旗標的[非互動模式](/docs/zh-TW/headless#background-tasks-at-exit)中，最後一個回合結束後閒置等待背景 subagent 與工作流程的上限時間（毫秒）。每當 Claude 進行一個回合來處理背景結果時，閒置等待就會重新計時。預設：`600000`，即 10 分鐘。當閒置等待達到上限時，Claude Code 會停止等待剩餘的背景任務並結束。設為 `0` 可無限期等待。此上限與適用於一般背景 shell 的五秒寬限期是分開的。需要 Claude Code v2.1.182 或更新版本 |

359| `CLAUDE_CODE_PROCESS_WRAPPER` | 透過以 argv 前綴形式指定的企業啟動器（例如 `/opt/corp/launcher`），啟動 Claude Code 從其自身二進位檔啟動的程序，例如承載 [agent view](/docs/zh-TW/agent-view) 工作階段的背景服務。請在使用者設定或[受管設定](/docs/zh-TW/managed-settings)的 `env` 區塊中設定，而不是以 shell export 設定，讓分離的背景服務能繼承它；專案與本機設定無法設定它。相當於 [`processWrapper` 設定](/docs/zh-TW/settings-reference#processwrapper)，該設定需要 Claude Code v2.1.210 或更新版本；兩者皆設定時以此變數為優先。VS Code 擴充功能會透過其 `claudeProcessWrapper` 設定另外設定自己的啟動器。在 Windows 上會被忽略。有關值的格式、啟動器涵蓋的範圍，以及啟動器必須滿足的約定，請參閱[在企業啟動器後方執行 Claude Code](/docs/zh-TW/corporate-launcher)。需要 Claude Code v2.1.208 或更新版本 |361| `CLAUDE_CODE_PROCESS_WRAPPER` | 透過以 argv 前綴形式（例如 `/opt/corp/launcher`）指定的公司啟動器，啟動 Claude Code 從其自身二進位檔啟動的程序，例如承載 [agent view](/docs/zh-TW/agent-view) 工作階段的背景服務。請在使用者設定或[受管設定](/docs/zh-TW/managed-settings)的 `env` 區塊中設定，而非作為 shell 匯出，以便分離的背景服務能繼承它；專案與本機設定無法設定此變數。等同於 [`processWrapper` 設定](/docs/zh-TW/settings-reference#processwrapper)，該設定需要 Claude Code v2.1.210 或更新版本；兩者皆設定時以此變數優先。VS Code 擴充功能會透過其 `claudeProcessWrapper` 設定另外設定自己的啟動器。在 Windows 上會被忽略。關於值的格式、啟動器涵蓋的範圍，以及啟動器必須滿足的約定，請參閱[在公司啟動器後方執行 Claude Code](/docs/zh-TW/corporate-launcher)。需要 Claude Code v2.1.208 或更新版本 |

360| `CLAUDE_CODE_PROJECT_DIR_NAME` | 與 `CLAUDE_CONFIG_DIR` 一起設定，以選擇 Claude Code 儲存該工作階段逐字稿與自動記憶所使用的 `projects/` 目錄名稱，取代從工作目錄路徑衍生的名稱。例如，以 `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` 啟動 Claude Code 時，會將它們儲存在 `/srv/tenant-a/projects/work/` 下。當 `CLAUDE_CONFIG_DIR` 未設定時，Claude Code 會忽略此變數，且只會從您啟動 `claude` 的環境中讀取它，絕不會從[設定檔的 `env` 區塊](#in-settings-files)讀取。請參閱[自行命名專案目錄](/docs/zh-TW/sessions#name-the-project-directory-yourself)。需要 Claude Code v2.1.234 或更新版本 |362| `CLAUDE_CODE_PROJECT_DIR_NAME` | 與 `CLAUDE_CONFIG_DIR` 一起設定，以選擇 Claude Code 存放該工作階段逐字稿與自動記憶的 `projects/` 目錄名稱，取代從工作目錄路徑衍生的名稱。例如，以 `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` 啟動 Claude Code，會將它們存放在 `/srv/tenant-a/projects/work/` 下。未設定 `CLAUDE_CONFIG_DIR` 時，Claude Code 會忽略此變數，且只會從您啟動 `claude` 的環境中讀取此變數，絕不會從[設定檔的 `env` 區塊](#in-settings-files)讀取。請參閱[自行命名專案目錄](/docs/zh-TW/sessions#name-the-project-directory-yourself)。需要 Claude Code v2.1.234 或更新版本 |

361| `CLAUDE_CODE_PROMPT_CACHE_TTL` | 設為 `5m` 或 `1h`（Claude Code 僅接受這兩個值），以選擇主對話的[提示快取 TTL](/docs/zh-TW/prompt-caching#cache-lifetime)：包括您的互動式、`-p` 與 SDK 回合，以及與其一併內嵌執行的輔助程式。優先於 `promptCacheTtl` 設定與 `ENABLE_PROMPT_CACHING_1H`，而 `FORCE_PROMPT_CACHING_5M` 會覆寫它。API 會以較高的費率計費 1 小時快取寫入。需要 Claude Code v2.1.242 或更新版本 |363| `CLAUDE_CODE_PROMPT_CACHE_TTL` | 設為 `5m` 或 `1h`（Claude Code 僅接受這兩個值），以選擇主對話的[提示快取 TTL](/docs/zh-TW/prompt-caching#cache-lifetime)：包括您的互動式、`-p` 與 SDK 回合，以及與其同步執行的輔助程序。優先於 `promptCacheTtl` 設定與 `ENABLE_PROMPT_CACHING_1H`，而 `FORCE_PROMPT_CACHING_5M` 會覆寫此變數。API 對 1 小時快取寫入的計費費率較高。需要 Claude Code v2.1.242 或更新版本 |

362| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | 設為 `1` 可在 `ANTHROPIC_BASE_URL` 指向自訂代理伺服器時傳播 W3C trace context。傳播範圍涵蓋模型與 HTTP MCP 請求上的 `traceparent` 標頭，以及 Bash、PowerShell 與 hook 子程序的 `TRACEPARENT` 環境變數。預設情況下，僅在直接連線至 Anthropic API 時才會啟用傳播。於 v2.1.152 新增。請參閱[追蹤（beta）](/docs/zh-TW/monitoring-usage#traces-beta) |364| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | 當 `ANTHROPIC_BASE_URL` 指向自訂代理伺服器時，設為 `1` 可傳播 W3C trace context。傳播涵蓋模型與 HTTP MCP 請求上的 `traceparent` 標頭，以及 Bash、PowerShell 與 hook 子程序的 `TRACEPARENT` 環境變數。預設情況下，僅在直接連線至 Anthropic API 時才會啟用傳播。於 v2.1.152 新增。請參閱[追蹤（beta）](/docs/zh-TW/monitoring-usage#traces-beta) |

363| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | 由嵌入 Claude Code 並代為管理模型供應商路由的主機平台設定。設定後，Claude Code 會忽略設定檔中的供應商選擇、端點與身分驗證變數，例如 `CLAUDE_CODE_USE_BEDROCK`、`ANTHROPIC_BASE_URL` 與 `ANTHROPIC_API_KEY`，讓使用者設定無法覆寫主機的路由。Claude Code 也會忽略[受管設定](/docs/zh-TW/managed-settings)中的模型選擇鍵，例如 `model`、`fallbackModel` 與 `modelOverrides`，無論由哪個受管來源提供，讓主機的模型設定優先於過時的受管模型固定設定。Claude Code 也會忽略受管 `env` 區塊中的模型選擇變數，例如 `ANTHROPIC_MODEL` 與 `ANTHROPIC_DEFAULT_*_MODEL` 系列；受管設定中的 [`availableModels`](/docs/zh-TW/model-config#restrict-model-selection) 允許清單仍然適用，除非主機提供自己的允許清單。Claude Code 也會略過它原本在第三方供應商（例如 Amazon Bedrock、Claude Platform on AWS、Google Cloud's Agent Platform 與 Microsoft Foundry）上套用的自動遙測退出，讓遙測遵循標準的 `DISABLE_TELEMETRY` 退出機制。請參閱[依 API 供應商區分的預設行為](/docs/zh-TW/data-usage#default-behaviors-by-api-provider) |365| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | 由內嵌 Claude Code 並代為管理模型提供者路由的主機平台設定。設定後，Claude Code 會忽略設定檔中的提供者選擇、端點與身分驗證變數，例如 `CLAUDE_CODE_USE_BEDROCK`、`ANTHROPIC_BASE_URL` 與 `ANTHROPIC_API_KEY`，因此使用者設定無法覆寫主機的路由。Claude Code 也會忽略[受管設定](/docs/zh-TW/managed-settings)中的模型選擇鍵，例如 `model`、`fallbackModel` 與 `modelOverrides`，無論由哪個受管來源提供，因此主機的模型設定會優先於過時的受管模型固定設定。Claude Code 也會忽略受管 `env` 區塊中的模型選擇變數，例如 `ANTHROPIC_MODEL` 與 `ANTHROPIC_DEFAULT_*_MODEL` 系列；受管設定中的 [`availableModels`](/docs/zh-TW/model-config#restrict-model-selection) 允許清單仍然適用，除非主機提供了自己的允許清單。Claude Code 也會略過它原本在第三方提供者（例如 Amazon Bedrock、Claude Platform on AWS、Google Cloud's Agent Platform 與 Microsoft Foundry）上套用的自動遙測退出，因此遙測會遵循標準的 `DISABLE_TELEMETRY` 退出設定。請參閱[各 API 提供者的預設行為](/docs/zh-TW/data-usage#default-behaviors-by-api-provider) |

364| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | 設為 `1` 可允許代理伺服器執行 DNS 解析，而非由呼叫端執行。適用於應由代理伺服器處理主機名稱解析之環境的選擇加入設定 |366| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | 設為 `1` 可讓代理伺服器代替呼叫端執行 DNS 解析。適用於應由代理伺服器處理主機名稱解析的環境，需選擇加入 |

365| `CLAUDE_CODE_REMOTE` | 當 Claude Code 以[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)執行時，會自動設為 `true`。可從 hook 或設定腳本讀取此值，以偵測您是否在雲端工作階段中 |367| `CLAUDE_CODE_REMOTE` | 當 Claude Code 以[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)執行時，會自動設為 `true`。可從 hook 或設定指令碼讀取此變數，以偵測您是否位於雲端工作階段中 |

366| `CLAUDE_CODE_REMOTE_SESSION_ID` | 在[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)中會自動設為目前工作階段的 ID。讀取此值可建構返回工作階段逐字稿的連結。請參閱[將輸出連結回工作階段](/docs/zh-TW/cloud-environments#link-output-back-to-the-session) |368| `CLAUDE_CODE_REMOTE_SESSION_ID` | 在[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)中自動設為目前工作階段的 ID。讀取此變數可建構連回工作階段逐字稿的連結。請參閱[將輸出連結回工作階段](/docs/zh-TW/cloud-environments#link-output-back-to-the-session) |

367| `CLAUDE_CODE_RESTRICTED` | 設為 `1` 可以受限模式啟動工作階段，與傳遞 [`--restricted`](/docs/zh-TW/cli-reference#cli-flags) 相同。Claude Code 會忽略設定檔 `env` 區塊中的此變數。需要 Claude Code v2.1.248 或更新版本 |369| `CLAUDE_CODE_RESTRICTED` | 設為 `1` 可在受限模式下啟動工作階段，與傳入 [`--restricted`](/docs/zh-TW/cli-reference#cli-flags) 相同。Claude Code 會忽略設定檔 `env` 區塊中的此變數。需要 Claude Code v2.1.248 或更新版本 |

368| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | 設為 `1` 可在前一個工作階段於回合中途結束時自動繼續。用於 SDK 模式，讓模型無需 SDK 重新傳送提示詞即可繼續。若要關閉，請取消設定此變數或將其設為 `0`。關於 VS Code 聊天面板，請參閱[重新載入後繼續對話](/docs/zh-TW/vs-code#continue-conversations-after-a-reload) |370| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | 設為 `1` 可在前一個工作階段於回合中途結束時自動繼續。用於 SDK 模式，讓模型無需 SDK 重新傳送提示詞即可繼續。若要關閉，請取消設定此變數或將其設為 `0`。關於 VS Code 聊天面板，請參閱[重新載入後繼續對話](/docs/zh-TW/vs-code#continue-conversations-after-a-reload) |

369| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | 對於在回合中途結束的工作階段，若要在繼續時自動接續，其最後一則逐字稿訊息所允許的最長存在時間（毫秒）。當最後一則訊息早於此界限時，Claude Code 會略過 `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` 自動繼續及其 `CLAUDE_CODE_RESUME_PROMPT` 接續訊息，工作階段會以閒置狀態啟動，讓您明確地繼續。未設定或 `0` 表示沒有界限，但最後一個請求因 API 錯誤而失敗的回合，只有在該錯誤發生未滿六小時時才會繼續。正值會限制每個回合，包括上述回合；負值或非數值會套用一小時的界限。長時間執行 agent 的產生腳本可以設定此值，讓針對舊逐字稿的重新啟動不會重新執行過時的提示詞。當 Claude Code 重新啟動一個從互動式工作階段繼承對話而當機的 [agent view](/docs/zh-TW/agent-view) 工作階段時，會自行設定一小時的界限。需要 Claude Code v2.1.211 或更新版本 |371| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | 對於在回合中途結束的工作階段，其最後一則逐字稿訊息可在恢復時自動繼續的最大存在時間（毫秒）。當最後一則訊息早於此界限時，Claude Code 會略過 `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` 的自動繼續及其 `CLAUDE_CODE_RESUME_PROMPT` 接續訊息，工作階段會以閒置狀態啟動，讓您明確地繼續。未設定或設為 `0` 表示沒有界限，但最後一個請求因 API 錯誤而失敗的回合，只會在該錯誤發生未滿六小時時繼續。正值會限制所有回合，包括上述回合；負值或非數值會套用一小時的界限。長時間執行的 agent 的產生指令碼可以設定此變數，讓針對舊逐字稿的重新啟動不會重新執行過時的提示詞。當 Claude Code 重新啟動一個從互動式工作階段繼承對話的已當機 [agent view](/docs/zh-TW/agent-view) 工作階段時，會自行設定一小時的界限。需要 Claude Code v2.1.211 或更新版本 |

370| `CLAUDE_CODE_RESUME_PROMPT` | 覆寫當 `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` 接續中斷的回合而非重新傳送其提示詞時，或當您使用 `-p` 繼續[延後的工具呼叫](/docs/zh-TW/hooks#defer-a-tool-call-for-later)時，Claude Code 傳送給 Claude 的接續訊息。預設為 `Continue from where you left off.`。空字串會使用預設值 |372| `CLAUDE_CODE_RESUME_PROMPT` | 覆寫當 `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` 繼續中斷的回合而非重新傳送其提示詞時，或當您以 `-p` 恢復[延後的工具呼叫](/docs/zh-TW/hooks#defer-a-tool-call-for-later)時，Claude Code 傳送給 Claude 的接續訊息。預設為 `Continue from where you left off.`。空字串會使用預設值 |

371| `CLAUDE_CODE_RETRY_WATCHDOG` | 針對無人值守的工作階段（例如評估執行框架、CI 作業或遠端 worker）設為 `1`。會無限期重試 `429` 與 `529` 容量錯誤，而不是在 `CLAUDE_CODE_MAX_RETRIES` 次嘗試後失敗。當標準速度請求收到回報花費上限或用量點數耗盡的 `429` 時，Claude Code 會立即失敗，即使該錯誤來自依排程重設的[閘道花費上限](/docs/zh-TW/errors#spend-limit-reached)也一樣。在 v2.1.239 之前，watchdog 會無限期重試這些錯誤。關於快速模式請求，請參閱[處理速率限制](/docs/zh-TW/fast-mode#handle-rate-limits)。watchdog 會在兩次嘗試之間退避最多 5 分鐘，或在回應帶有速率限制重設時間時等到限制重設為止，因此達到用量上限的工作階段會等待剩餘的時段結束。在 v2.1.199 或更新版本中，它也會將其他暫時性錯誤（例如伺服器錯誤、逾時與連線中斷）的預設重試次數提高至 300 次（約三小時的退避），並在您明確設定 `CLAUDE_CODE_MAX_RETRIES` 時移除其 15 次的上限。需要 Claude Code v2.1.186 或更新版本 |373| `CLAUDE_CODE_RETRY_WATCHDOG` | 針對無人值守的工作階段（例如評估框架、CI 作業或遠端 worker）設為 `1`。會無限期重試 `429` 與 `529` 容量錯誤，而不是在 `CLAUDE_CODE_MAX_RETRIES` 次嘗試後失敗。當標準速度請求收到回報支出上限或用量點數耗盡的 `429` 時，Claude Code 會立即失敗，即使該錯誤來自依排程重設的[閘道支出上限](/docs/zh-TW/errors#spend-limit-reached)亦然。在 v2.1.239 之前，watchdog 會無限期重試這些錯誤。關於快速模式請求，請參閱[處理速率限制](/docs/zh-TW/fast-mode#handle-rate-limits)。watchdog 在兩次嘗試之間最多會退避 5 分鐘，或在回應帶有速率限制重設時間時等待至上限重設，因此達到用量上限的工作階段會等待剩餘的時間窗結束。在 v2.1.199 或更新版本中，它也會將其他暫時性錯誤（例如伺服器錯誤、逾時與連線中斷）的預設重試次數提高至 300 次，約三小時的退避時間，並在您明確設定 `CLAUDE_CODE_MAX_RETRIES` 時移除其 15 次的上限。需要 Claude Code v2.1.186 或更新版本 |

372| `CLAUDE_CODE_SAFE_MODE` | 設為 `1` 可以安全模式啟動：CLAUDE.md、skill、外掛、hook、MCP 伺服器、自訂命令與 agent、輸出風格、工作流程、自訂主題、自訂快捷鍵、狀態列與檔案建議命令、LSP 伺服器以及自動記憶都不會載入，以便對損壞的設定進行疑難排解。受管設定原則仍然適用，包括原則設定的 hook、狀態列與檔案建議命令；受管外掛、受管 skill、受管 CLAUDE.md 與原則設定的 MCP 伺服器則不會載入。相當於傳遞 [`--safe-mode`](/docs/zh-TW/cli-reference#cli-flags)。直接產生的子程序會繼承此變數 |374| `CLAUDE_CODE_SAFE_MODE` | 設為 `1` 可在安全模式下啟動：CLAUDE.md、skill、外掛、hook、MCP 伺服器、自訂命令與 agent、輸出風格、工作流程、自訂主題、自訂快捷鍵、狀態列與檔案建議命令、LSP 伺服器以及自動記憶都不會載入，用於疑難排解損壞的設定。受管設定政策仍然適用，包括政策設定的 hook、狀態列與檔案建議命令；受管外掛、受管 skill、受管 CLAUDE.md 與政策設定的 MCP 伺服器則不適用。等同於傳入 [`--safe-mode`](/docs/zh-TW/cli-reference#cli-flags)。直接產生的子程序會繼承此變數 |

373| `CLAUDE_CODE_SCRIPT_CAPS` | 當設定 `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` 時，用於限制特定腳本在每個工作階段中可被呼叫次數的 JSON 物件。鍵是與命令文字比對的子字串；值是整數呼叫上限。例如，`{"deploy.sh": 2}` 允許 `deploy.sh` 最多被呼叫兩次。比對以子字串為基礎，因此像 `./scripts/deploy.sh $(evil)` 這類 shell 展開技巧仍會計入上限。透過 `xargs` 或 `find -exec` 的執行階段擴散不會被偵測到；這是一項縱深防禦控制 |375| `CLAUDE_CODE_SCRIPT_CAPS` | 設定 `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` 時，限制特定指令碼每個工作階段可被呼叫次數的 JSON 物件。鍵為與命令文字比對的子字串；值為整數呼叫上限。例如，`{"deploy.sh": 2}` 允許 `deploy.sh` 最多被呼叫兩次。比對以子字串為基礎，因此像 `./scripts/deploy.sh $(evil)` 這類 shell 展開技巧仍會計入上限。透過 `xargs` 或 `find -exec` 的執行期擴散不會被偵測；這是一項縱深防禦控制 |

374| `CLAUDE_CODE_SCROLL_SPEED` | 設定[全螢幕呈現](/docs/zh-TW/fullscreen#mouse-wheel-scrolling)中的滑鼠滾輪捲動倍數。接受最高 20 的任何正值，包括低於 1 的小數值（例如 `0.5`），以在已會放大滾輪事件的終端機中減緩加速的觸控板與滾輪捲動。若您的終端機每格傳送一個滾輪事件而未放大，請設為 `3` 以與 `vim` 一致。在 JetBrains IDE 終端機中會被忽略，Claude Code 在其中使用自己的捲動處理 |376| `CLAUDE_CODE_SCROLL_SPEED` | 設定[全螢幕呈現](/docs/zh-TW/fullscreen#mouse-wheel-scrolling)中的滑鼠滾輪捲動倍率。接受最大為 20 的任何正值，包括低於 1 的小數值（例如 `0.5`），以便在已放大滾輪事件的終端機中減緩加速的觸控板與滾輪捲動。若您的終端機每一格只傳送一個滾輪事件且未放大，可設為 `3` 以符合 `vim`。在 JetBrains IDE 終端機中會被忽略，因為 Claude Code 在該處使用自己的捲動處理 |

375| `CLAUDE_CODE_SEND_FEEDBACK` | 設為 `0` 可為工作階段關閉 [Claude 草擬的意見回饋](/docs/zh-TW/tools-reference#sendfeedback-tool-behavior)。設為 `1` 可在您的帳戶已具備存取權時開啟；此變數本身無法授予存取權，且其他會關閉意見回饋的開關，例如 `DISABLE_FEEDBACK_COMMAND` 與 [`feedbackDrafts`](/docs/zh-TW/settings-reference#feedbackdrafts) 設定的 `off` 值，仍然適用 |377| `CLAUDE_CODE_SEND_FEEDBACK` | 設為 `0` 可關閉工作階段的 [Claude 草擬意見回饋](/docs/zh-TW/tools-reference#sendfeedback-tool-behavior)。在您的帳戶已具備存取權的情況下，設為 `1` 可將其開啟；此變數本身無法授予存取權，而其他會關閉意見回饋的開關，例如 `DISABLE_FEEDBACK_COMMAND` 與 [`feedbackDrafts`](/docs/zh-TW/settings-reference#feedbackdrafts) 設定的 `off` 值，仍然適用 |

376| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | 覆寫 [SessionEnd](/docs/zh-TW/hooks#sessionend) hook 的時間預算（毫秒）。此值也是每個未自行設定 `timeout` 之 hook 的逾時時間。適用於工作階段結束、`/clear`，以及透過互動式 `/resume` 切換工作階段。預設預算為 1.5 秒，會自動提高至設定檔中所設定的最高個別 hook `timeout`，最多 60 秒。外掛提供之 hook 的逾時不會提高預算 |378| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | 覆寫 [SessionEnd](/docs/zh-TW/hooks#sessionend) hook 的時間預算（毫秒）。此值也是每個未自行設定 `timeout` 的 hook 的逾時時間。適用於工作階段結束、`/clear`，以及透過互動式 `/resume` 切換工作階段。預設預算為 1.5 秒，會自動提高至設定檔中設定的最高個別 hook `timeout`，最多 60 秒。外掛提供之 hook 的逾時時間不會提高預算 |

377| `CLAUDE_CODE_SESSION_ID` | 在 Bash 與 PowerShell 工具子程序、[hook 命令](/docs/zh-TW/hooks)子程序及 stdio [MCP 伺服器](/docs/zh-TW/mcp)子程序中，會自動設為目前的工作階段 ID。對於 Bash、PowerShell 與 hook，此值與 hook JSON 輸入中的 `session_id` 欄位相符，並會在 `/clear` 時更新。MCP 伺服器子程序會保留其產生時的 ID。使用 `--resume <session-id>` 時，它會收到繼續的 ID，與 hook 和 Bash 相符。使用 `--continue` 或未指定明確 ID 的 `--resume` 時，它可能會改為收到初始啟動的 ID。用於將腳本與外部工具關聯至啟動它們的 Claude Code 工作階段 |379| `CLAUDE_CODE_SESSION_ID` | 在 Bash 與 PowerShell 工具子程序、[hook 命令](/docs/zh-TW/hooks)子程序，以及 stdio [MCP 伺服器](/docs/zh-TW/mcp)子程序中，自動設為目前的工作階段 ID。對於 Bash、PowerShell 與 hook，此值與 hook JSON 輸入中的 `session_id` 欄位相符，並會在 `/clear` 時更新。MCP 伺服器子程序會保留其產生時的 ID。在 `--resume <session-id>` 時，它會收到恢復後的 ID，與 hook 及 Bash 一致。在 `--continue` 或未指定明確 ID 的 `--resume` 時，它可能會改為收到最初啟動時的 ID。用於將指令碼與外部工具關聯至啟動它們的 Claude Code 工作階段 |

378| `CLAUDE_CODE_SHELL` | 設定 Claude Code 用來執行 Bash 工具命令的 shell。接受 `bash` 或 `zsh` 二進位檔的路徑，例如 `/opt/homebrew/bin/bash`。不支援 `fish` 等其他 shell。若此值不是可運作的 `bash` 或 `zsh` 路徑，Claude Code 會忽略它並改用自動偵測。自動偵測會在 `$SHELL` 指向 `bash` 或 `zsh` 時使用它，否則會從您的 `PATH` 與標準安裝位置中挑選第一個可運作的 `zsh`，其次是 `bash` |380| `CLAUDE_CODE_SHELL` | 設定 Claude Code 用來執行 Bash 工具命令的 shell。接受 `bash` 或 `zsh` 二進位檔的路徑，例如 `/opt/homebrew/bin/bash`。不支援其他 shell，例如 `fish`。若此值不是可運作的 `bash` 或 `zsh` 路徑，Claude Code 會忽略它並改用自動偵測。自動偵測會在您的 `$SHELL` 指向 `bash` 或 `zsh` 時使用它，否則會從您的 `PATH` 與標準安裝位置中，依序選擇第一個可運作的 `zsh`，其次是 `bash` |

379| `CLAUDE_CODE_SHELL_PREFIX` | 包裝 Claude Code 所產生之 shell 命令的命令前綴：Bash 工具呼叫、[hook](/docs/zh-TW/hooks) 命令、[狀態列](/docs/zh-TW/statusline)命令，以及 stdio [MCP 伺服器](/docs/zh-TW/mcp)啟動命令。PowerShell hook 與 exec 形式的 hook 執行時不會套用前綴。適用於記錄或稽核。設定裸執行檔路徑（例如 `/path/to/logger.sh`）時，每個命令會以 `/path/to/logger.sh '<command>'` 形式執行。包裝程式會在 `$1` 中以單一經 shell 引號處理的引數接收命令列，因此包裝程式必須以 shell 重新評估 `$1`，例如 `exec bash -c "$1"`。將 `$1` 視為裸執行檔路徑，會導致傳遞 `npx -y <package>` 等引數的 stdio MCP 伺服器失效。對於 Bash 工具呼叫，`$1` 包含 Claude Code 組裝的完整 shell 呼叫，包括環境設定，而不僅是 Claude 執行的命令 |381| `CLAUDE_CODE_SHELL_PREFIX` | 包裝 Claude Code 所產生 shell 命令的命令前綴：Bash 工具呼叫、[hook](/docs/zh-TW/hooks) 命令、[狀態列](/docs/zh-TW/statusline)命令，以及 stdio [MCP 伺服器](/docs/zh-TW/mcp)啟動命令。PowerShell hook 與 exec 形式的 hook 執行時不會加上前綴。適用於日誌記錄或稽核。設定單純的執行檔路徑（例如 `/path/to/logger.sh`）時，每個命令會以 `/path/to/logger.sh '<command>'` 的形式執行。包裝程式會在 `$1` 中以單一 shell 引號引數的形式收到命令列，因此包裝程式必須以 shell 重新評估 `$1`，例如 `exec bash -c "$1"`。將 `$1` 當作單純的執行檔路徑處理，會導致傳遞 `npx -y <package>` 等引數的 stdio MCP 伺服器無法運作。對於 Bash 工具呼叫，`$1` 包含 Claude Code 組合的完整 shell 呼叫，包括環境設定，而不只是 Claude 執行的命令 |

380| `CLAUDE_CODE_SIMPLE` | 設為 `1` 可使用精簡的系統提示詞執行，且僅提供 Bash、檔案讀取與檔案編輯工具。來自 `--mcp-config` 的 MCP 工具仍可使用。停用 hook、skill、自訂命令、subagent、已安裝外掛、MCP 伺服器、自動記憶與 CLAUDE.md 的自動探索。您以 `--add-dir` 傳遞之目錄中的 skill 仍會載入。不會讀取 OAuth token 與鑰匙圈憑證，因此 Anthropic 身分驗證必須來自 `ANTHROPIC_API_KEY` 或 `--settings` 中的 `apiKeyHelper`。相當於傳遞 [`--bare`](/docs/zh-TW/headless#start-faster-with-bare-mode) |382| `CLAUDE_CODE_SIMPLE` | 設為 `1` 可使用最精簡的系統提示詞執行，且僅提供 Bash、檔案讀取與檔案編輯工具。來自 `--mcp-config` 的 MCP 工具仍可使用。停用 hook、skill、自訂命令、subagent、已安裝外掛、MCP 伺服器、自動記憶與 CLAUDE.md 的自動探索。您以 `--add-dir` 傳入之目錄中的 skill 仍會載入。不會讀取 OAuth token 與鑰匙圈憑證，因此 Anthropic 身分驗證必須來自 `ANTHROPIC_API_KEY` 或 `--settings` 中的 `apiKeyHelper`。等同於傳入 [`--bare`](/docs/zh-TW/headless#start-faster-with-bare-mode) |

381| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | 設為 `1` 可在任何模型上使用較短的系統提示詞與簡化的工具描述。設為 `0`、`false`、`no` 或 `off` 可選擇退出，即使在實驗或伺服器設定原本會啟用它的模型上也一樣。完整的工具集、hook、MCP 伺服器與 CLAUDE.md 探索仍保持啟用 |383| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | 設為 `1` 可在任何模型上使用較短的系統提示詞與精簡的工具描述。設為 `0`、`false`、`no` 或 `off` 可選擇退出，即使在實驗或伺服器設定原本會啟用它的模型上亦然。完整的工具集、hook、MCP 伺服器與 CLAUDE.md 探索仍維持啟用 |

382| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | 略過 [Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws) 的用戶端身分驗證，適用於自行簽署請求的閘道 |384| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | 略過 [Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws) 的用戶端身分驗證，適用於自行簽署請求的閘道 |

383| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | 設為 `1` 可關閉從 AWS 預設憑證提供者鏈解析之憑證的程序內快取，讓 Claude Code 在每個 API 請求時都解析該鏈。關閉快取時，以 SSO 為基礎的設定檔會在每個請求時向 IAM Identity Center 請求憑證。請參閱[憑證快取與解析逾時](/docs/zh-TW/amazon-bedrock#credential-caching-and-resolution-timeout)。需要 Claude Code v2.1.207 或更新版本 |385| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | 設為 `1` 可關閉從 AWS 預設憑證提供者鏈解析而得之憑證的程序內快取，讓 Claude Code 在每個 API 請求時都解析該鏈。關閉快取時，以 SSO 為後端的設定檔會在每個請求時向 IAM Identity Center 請求憑證。請參閱[憑證快取與解析逾時](/docs/zh-TW/amazon-bedrock#credential-caching-and-resolution-timeout)。需要 Claude Code v2.1.207 或更新版本 |

384| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | 略過 Amazon Bedrock 的 AWS 身分驗證（例如使用 LLM 閘道時） |386| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | 略過 Amazon Bedrock 的 AWS 身分驗證（例如使用 LLM 閘道時） |

385| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | 設為 `1` 可將失敗的[快速模式](/docs/zh-TW/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways)可用性檢查視為可用，適用於封鎖該檢查直接傳送至 `api.anthropic.com` 之請求的網路。Claude Code 仍會遵循「disabled by your organization」回應 |387| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | 設為 `1` 可將失敗的[快速模式](/docs/zh-TW/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways)可用性檢查視為可用，適用於會封鎖該檢查直接傳送至 `api.anthropic.com` 之請求的網路。Claude Code 仍會遵循「disabled by your organization」回應 |

386| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | 設為 `1` 可略過用戶端的[快速模式](/docs/zh-TW/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways)可用性檢查，適用於攔截而非拒絕該檢查請求的代理伺服器。當您的組織停用快速模式時，API 仍會拒絕快速模式請求 |388| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | 設為 `1` 可略過用戶端的[快速模式](/docs/zh-TW/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways)可用性檢查，適用於會攔截而非拒絕該檢查請求的代理伺服器。當您的組織停用快速模式時，API 仍會拒絕快速模式請求 |

387| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | 略過 Microsoft Foundry 的 Azure 身分驗證，適用於注入自己 `Authorization` 標頭的代理伺服器或閘道。Claude Code 會在不附帶 Azure 憑證的情況下傳送請求，並保留您提供的 `Authorization` 標頭，例如透過 `ANTHROPIC_CUSTOM_HEADERS` 提供。設定 `ANTHROPIC_FOUNDRY_API_KEY` 或 `ANTHROPIC_FOUNDRY_AUTH_TOKEN` 時會被忽略。在 v2.1.203 之前，除非同時設定 API 金鑰，否則此變數會導致 Microsoft Foundry 用戶端無法傳送請求 |389| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | 略過 Microsoft Foundry 的 Azure 身分驗證，適用於會注入自己 `Authorization` 標頭的代理伺服器或閘道。Claude Code 會在不附帶 Azure 憑證的情況下傳送請求，並保留您提供的 `Authorization` 標頭，例如透過 `ANTHROPIC_CUSTOM_HEADERS` 提供。設定 `ANTHROPIC_FOUNDRY_API_KEY` 或 `ANTHROPIC_FOUNDRY_AUTH_TOKEN` 時會被忽略。在 v2.1.203 之前，除非同時設定了 API 金鑰，否則此變數會導致 Microsoft Foundry 用戶端無法傳送請求 |

388| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | 略過 Amazon Bedrock Mantle 的 AWS 身分驗證（例如使用 LLM 閘道時） |390| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | 略過 Amazon Bedrock Mantle 的 AWS 身分驗證（例如使用 LLM 閘道時） |

389| `CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY` | 在 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) 與 [Google Cloud's Agent Platform](/docs/zh-TW/google-vertex-ai) 上，[啟動模型檢查](/docs/zh-TW/amazon-bedrock#startup-model-checks)會在此機器上記住它們發現您的帳戶無法呼叫哪些模型，最長一天。設為 `1` 可關閉此記憶。需要 Claude Code v2.1.285 或更新版本 |391| `CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY` | [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) 與 [Google Cloud's Agent Platform](/docs/zh-TW/google-vertex-ai) 上的[啟動模型檢查](/docs/zh-TW/amazon-bedrock#startup-model-checks)，會在此機器上記住它們發現您的帳戶無法呼叫的模型，最長一天。設為 `1` 可關閉此記憶。需要 Claude Code v2.1.285 或更新版本 |

390| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | 設為 `1` 可略過將提示詞歷史記錄與工作階段逐字稿寫入磁碟。設定此變數後啟動的工作階段不會出現在 `--resume`、`--continue` 或向上鍵歷史記錄中。適用於臨時的腳本化工作階段 |392| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | 設為 `1` 可略過將提示詞歷史記錄與工作階段逐字稿寫入磁碟。在設定此變數的情況下啟動的工作階段，不會出現在 `--resume`、`--continue` 或上方向鍵歷史記錄中。適用於臨時的指令碼化工作階段 |

391| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | 略過 Google Cloud's Agent Platform 的 Google 身分驗證（例如使用 LLM 閘道時） |393| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | 略過 Google Cloud's Agent Platform 的 Google 身分驗證（例如使用 LLM 閘道時） |

392| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | 設為 `1` 可讓以 `--output-format stream-json` 啟動的工作階段，針對原本僅以 stderr 結束的啟動失敗，寫入一則[說明 Claude Code 拒絕啟動原因的結果訊息](/docs/zh-TW/agent-sdk/typescript#startup_failure_reason)。需要 Claude Code v2.1.274 或更新版本 |394| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | 設為 `1` 可讓以 `--output-format stream-json` 啟動的工作階段，針對原本僅以 stderr 結束的啟動失敗，寫入一則[說明 Claude Code 拒絕啟動原因的結果訊息](/docs/zh-TW/agent-sdk/typescript#startup_failure_reason)。需要 Claude Code v2.1.274 或更新版本 |

393| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | [Stop](/docs/zh-TW/hooks#stop) 或 [SubagentStop](/docs/zh-TW/hooks#subagentstop) hook 可連續阻止回合結束的最大次數，超過後 Claude Code 會覆寫它並仍結束回合（預設：8）。設為 `0` 可停用此上限。若您的 hook 確實需要更多次迭代才能解決，請提高此值 |395| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | [Stop](/docs/zh-TW/hooks#stop) 或 [SubagentStop](/docs/zh-TW/hooks#subagentstop) hook 可連續阻止回合結束的最大次數，超過後 Claude Code 會覆寫它並仍然結束回合（預設：8）。設為 `0` 可停用此上限。若您的 hook 確實需要更多次迭代才能解決，請調高此值 |

394| `CLAUDE_CODE_SUBAGENT_MODEL` | 未以其他方式指派模型的 [subagent](/docs/zh-TW/sub-agents#choose-a-model)、[agent team](/docs/zh-TW/agent-teams#specify-teammates-and-models) 隊員與[工作流程](/docs/zh-TW/workflows) agent 的預設模型。接受 `haiku` 等別名或完整模型名稱。有兩個來源優先於它：Claude 產生 agent 時傳遞的模型，以及 agent 定義中的 `model` 欄位（包括 `inherit`）。若要變更此行為，請設定 [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/zh-TW/sub-agents#run-every-subagent-on-one-model)。完整順序請參閱[選擇模型](/docs/zh-TW/sub-agents#choose-a-model)。將其設為 `inherit` 與不設定相同。在 v2.1.251 之前，此變數會覆寫每次呼叫的模型與定義的 `model` 欄位 |396| `CLAUDE_CODE_SUBAGENT_MODEL` | 未以其他方式指定模型的 [subagent](/docs/zh-TW/sub-agents#choose-a-model)、[agent team](/docs/zh-TW/agent-teams#specify-teammates-and-models) 隊員與[工作流程](/docs/zh-TW/workflows) agent 的預設模型。接受別名（例如 `haiku`）或完整模型名稱。有兩個來源優先於此變數：Claude 產生 agent 時傳遞的模型，以及 agent 定義中的 `model` 欄位（包括 `inherit`）。若要改變這一點，請設定 [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/zh-TW/sub-agents#run-every-subagent-on-one-model)。完整順序請參閱[選擇模型](/docs/zh-TW/sub-agents#choose-a-model)。將其設為 `inherit` 等同於不設定。在 v2.1.251 之前，此變數會同時覆寫每次呼叫的模型與定義中的 `model` 欄位 |

395| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | 設為 `1` 可強制 subagent、隊員與工作流程 agent 使用同一個模型。[在同一個模型上執行所有 subagent](/docs/zh-TW/sub-agents#run-every-subagent-on-one-model) 說明該模型為何。需要 Claude Code v2.1.257 或更新版本 |397| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | 設為 `1` 可將單一模型強制套用至 subagent、隊員與工作流程 agent。[在單一模型上執行所有 subagent](/docs/zh-TW/sub-agents#run-every-subagent-on-one-model) 說明了是哪一個模型。需要 Claude Code v2.1.257 或更新版本 |

396| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | 設為 `5m` 或 `1h`（Claude Code 僅接受這兩個值），以選擇主對話以外之請求的[提示快取 TTL](/docs/zh-TW/prompt-caching#cache-lifetime)，例如 [subagent](/docs/zh-TW/sub-agents)、工作流程與背景工作。優先於 `subagentPromptCacheTtl` 設定與 `ENABLE_PROMPT_CACHING_1H`，而 `FORCE_PROMPT_CACHING_5M` 會覆寫它。API 會以較高的費率計費 1 小時快取寫入。需要 Claude Code v2.1.242 或更新版本 |398| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | 設為 `5m` 或 `1h`（Claude Code 僅接受這兩個值），以選擇主對話以外之請求的[提示快取 TTL](/docs/zh-TW/prompt-caching#cache-lifetime)，例如 [subagent](/docs/zh-TW/sub-agents)、工作流程與背景工作。優先於 `subagentPromptCacheTtl` 設定與 `ENABLE_PROMPT_CACHING_1H`，而 `FORCE_PROMPT_CACHING_5M` 會覆寫此變數。API 對 1 小時快取寫入的計費費率較高。需要 Claude Code v2.1.242 或更新版本 |

397| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | 設為 `1` 可從子程序環境（Bash 工具、hook、MCP stdio 伺服器）中移除憑證：Anthropic 與雲端供應商憑證、Claude Code 識別為憑證的任何其他變數，以及內嵌在套件登錄 URL 中的憑證。父 Claude 程序會保留這些憑證以進行 API 呼叫，但子程序無法讀取它們，從而降低透過 shell 展開竊取機密的提示詞注入攻擊風險。在 v2.1.251 或更新版本中，清除作業也會移除 Claude Code 自己的設定儲存區指標變數（例如 `CLAUDE_CONFIG_DIR`），讓子程序無法找到已重新定位的設定目錄。若子程序需要這些變數，請勿設定此清除。在 Linux 上，這也會在隔離的 PID 命名空間中執行 Bash 子程序，使其無法透過 `/proc` 讀取主機程序環境；副作用是 `ps`、`pgrep` 與 `kill` 無法看到主機程序或向其傳送訊號。設定 `allowed_non_write_users` 時，`claude-code-action` 會自動設定此變數 |399| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | 設為 `1` 可從子程序環境（Bash 工具、hook、MCP stdio 伺服器）中移除憑證：Anthropic 與雲端提供者的憑證、Claude Code 識別為憑證的任何其他變數，以及嵌入在套件登錄 URL 中的憑證。父 Claude 程序會保留這些憑證以進行 API 呼叫，但子程序無法讀取它們，以降低遭受試圖透過 shell 展開竊取機密的提示詞注入攻擊的風險。在 v2.1.251 或更新版本中，清除作業也會移除 Claude Code 自身的設定儲存指標變數（例如 `CLAUDE_CONFIG_DIR`），讓子程序無法找到已遷移的設定目錄。若子程序需要這些變數，請勿設定此清除功能。在 Linux 上，這也會讓 Bash 子程序在隔離的 PID namespace 中執行，使其無法透過 `/proc` 讀取主機程序的環境；副作用是 `ps`、`pgrep` 與 `kill` 無法看見主機程序或向其傳送訊號。設定 `allowed_non_write_users` 時，`claude-code-action` 會自動設定此變數 |

398| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | 在非互動模式（`-p` 旗標）中設為 `1`，可在第一個查詢之前等待外掛安裝完成。若未設定，外掛會在背景安裝，第一個回合時可能無法使用。搭配 `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` 以限制等待時間 |400| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | 在非互動模式（`-p` 旗標）中設為 `1`，可在第一次查詢前等待外掛安裝完成。若未設定，外掛會在背景安裝，且在第一個回合時可能尚無法使用。可搭配 `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` 來限制等待時間 |

399| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | 同步外掛安裝的逾時時間（毫秒）。超過時，Claude Code 會在沒有外掛的情況下繼續並記錄錯誤。沒有預設值：若未設定此變數，同步安裝會等待至完成為止 |401| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | 同步外掛安裝的逾時時間（毫秒）。超過時，Claude Code 會在沒有外掛的情況下繼續執行並記錄錯誤。無預設值：若未設定此變數，同步安裝會一直等待至完成 |

400| `CLAUDE_CODE_SYNC_SKILLS` | 在使用 `-p` 旗標的非互動模式中設為 `1`，可讓 Claude Code 在該次執行中下載為您 claude.ai 帳戶啟用的 skill，並在執行第一個查詢之前等待其清單，最長 `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`。下載本身會在背景完成，Claude 在呼叫某個 skill 時會等待該 skill 下載完成。需要 claude.ai 身分驗證。您以 claude.ai 帳戶登入的終端機工作階段，即使未設定此變數，也會將這些 skill [下載](/docs/zh-TW/skills#where-synced-skills-load)至 `~/.claude/skills/synced/`，並大約每 10 分鐘重新同步一次，因此僅在 `-p` 執行需要在第一個查詢就使用您目前的 skill 時才設定此變數。在 v2.1.273 之前，終端機工作階段只會在設定此變數的 `-p` 執行中下載它們。`synced` 資料夾名稱[保留給此下載使用](/docs/zh-TW/skills#where-skills-live)。在 v2.1.227 之前，skill 會直接下載至 `~/.claude/skills/`。Claude Code 會對[下載的 skill 套用額外規則](/docs/zh-TW/skills#how-synced-skills-behave)，例如不在您的機器上執行其 `!` 命令 |402| `CLAUDE_CODE_SYNC_SKILLS` | 在使用 `-p` 旗標的非互動模式中設為 `1`，可讓 Claude Code 在該次執行中下載您 claude.ai 帳戶已啟用的 skill，並在執行第一次查詢前等待其清單，最長為 `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`。下載本身會在背景完成，而 Claude 在呼叫某個 skill 時會等待該 skill 下載完成。需要 claude.ai 身分驗證。以您的 claude.ai 帳戶登入的終端機工作階段，即使未設定此變數，也會將這些 skill [下載](/docs/zh-TW/skills#where-synced-skills-load)至 `~/.claude/skills/synced/`，並約每 10 分鐘重新同步一次，因此僅在 `-p` 執行需要在第一次查詢時取得您最新的 skill 時才需設定。在 v2.1.273 之前，終端機工作階段只會在設定了此變數的 `-p` 執行中下載它們。`synced` 資料夾名稱[保留供此下載使用](/docs/zh-TW/skills#where-skills-live)。在 v2.1.227 之前，skill 會直接下載至 `~/.claude/skills/`。Claude Code 會對[下載的 skill 套用額外規則](/docs/zh-TW/skills#how-synced-skills-behave)，例如不在您的機器上執行其 `!` 命令 |

401| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | 當建構於 [Agent SDK](/docs/zh-TW/agent-sdk/typescript#query-object) 的應用程式重新載入 skill 時，在工作階段中途執行之 skill 重新同步的逾時時間（毫秒）（預設：30000）。超過時，重新載入會以已抵達的 skill 繼續，剩餘的下載會在背景完成 |403| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | 當以 [Agent SDK](/docs/zh-TW/agent-sdk/typescript#query-object) 建構的應用程式重新載入 skill 時，於工作階段中途執行的 skill 重新同步的逾時時間（毫秒）（預設：30000）。超過時，重新載入會以已抵達的 skill 繼續進行，剩餘的下載則在背景完成 |

402| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | 設定 `CLAUDE_CODE_SYNC_SKILLS` 時，第一個查詢等待初始 skill 清單的逾時時間（毫秒）（預設：5000）。超過時，第一個查詢會以已抵達的 skill 執行。無論如何，下載都會在背景完成，Claude 在呼叫某個 skill 時會等待該 skill 下載完成 |404| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | 設定 `CLAUDE_CODE_SYNC_SKILLS` 時，第一次查詢等待初始 skill 清單的逾時時間（毫秒）（預設：5000）。超過時，第一次查詢會以已抵達的 skill 執行。無論如何下載都會在背景完成，而 Claude 在呼叫某個 skill 時會等待該 skill 下載完成 |

403| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | 設為 `false` 可停用差異輸出中的語法醒目提示。適用於色彩干擾終端機設定的情況。若要同時停用程式碼區塊與檔案預覽中的醒目提示，請使用 [`syntaxHighlightingDisabled`](/docs/zh-TW/settings-reference#syntaxhighlightingdisabled) 設定 |405| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | 設為 `false` 可停用差異輸出中的語法醒目提示。適用於色彩干擾您終端機設定的情況。若也要停用程式碼區塊與檔案預覽中的醒目提示，請使用 [`syntaxHighlightingDisabled`](/docs/zh-TW/settings-reference#syntaxhighlightingdisabled) 設定 |

404| `CLAUDE_CODE_TASK_LIST_ID` | 在工作階段之間共用任務清單。在[具備 Task 工具的工作階段](/docs/zh-TW/tools-reference#task-tool-availability)中，於多個 Claude Code 執行個體中設定相同的 ID，即可在共用任務清單上協調。請參閱[任務清單](/docs/zh-TW/interactive-mode#task-list) |406| `CLAUDE_CODE_TASK_LIST_ID` | 在多個工作階段之間共用任務清單。在多個 Claude Code 執行個體中設定相同的 ID，即可在[具備 Task 工具的工作階段](/docs/zh-TW/tools-reference#task-tool-availability)中協同處理共用的任務清單。請參閱[任務清單](/docs/zh-TW/interactive-mode#task-list) |

405| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | 以毫秒為單位，覆寫非互動式工作階段在結束時等待其 [agent team](/docs/zh-TW/agent-teams) 完成拆除的時間。接受 1000 至 60000；超出範圍的值會被忽略並套用預設值 10000。需要 Claude Code v2.1.206 或更新版本 |407| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | 覆寫非互動工作階段在結束時等待其 [agent team](/docs/zh-TW/agent-teams) 完成拆除的時間（毫秒）。接受 1000 至 60000；超出範圍的值會被忽略並套用預設值 10000。需要 Claude Code v2.1.206 或更新版本 |

406| `CLAUDE_CODE_TMPDIR` | 覆寫用於內部暫存檔案的暫存目錄。Claude Code 會在 Unix 上將 `/claude-{uid}/` 附加至此路徑，在 Windows 上則附加 `/claude/`。預設：macOS 上為 `/tmp`，Linux 與 Windows 上為 `os.tmpdir()`。在 macOS 與 Linux 上，當您的覆寫值為長路徑時，[沙箱化](/docs/zh-TW/sandboxing)的 Bash 子程序會在系統預設位置下收到一個較短的備援 `$TMPDIR`，因為某些工具在暫存路徑過長時會失敗。未沙箱化的 Bash 命令在您的 shell 設定了 `$TMPDIR` 時會繼承它。在原生 Windows 上，當您的 shell 未設定 `$TMPDIR` 時，參照 `$TMPDIR` 的 Bash 命令會收到您的覆寫值，若您未設定覆寫值則收到 `%TEMP%`。Claude Code 自己的暫存檔案一律使用您的覆寫值。請在您的 shell、使用者設定或受管設定中設定。在[專案與本機設定](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)中會被忽略 |408| `CLAUDE_CODE_TMPDIR` | 覆寫用於內部暫存檔的暫存目錄。Claude Code 在 Unix 上會在此路徑後附加 `/claude-{uid}/`，在 Windows 上則附加 `/claude/`。預設：macOS 上為 `/tmp`，Linux 與 Windows 上為 `os.tmpdir()`。在 macOS 與 Linux 上，當您的覆寫值為較長的路徑時，[沙箱化](/docs/zh-TW/sandboxing)的 Bash 子程序會收到位於系統預設位置下的較短備援 `$TMPDIR`，因為某些工具在暫存路徑過長時會失敗。未沙箱化的 Bash 命令會在您的 shell 設定了 `$TMPDIR` 時繼承它。在原生 Windows 上，當您的 shell 未設定 `$TMPDIR` 時，引用 `$TMPDIR` 的 Bash 命令會收到您的覆寫值，若您未設定則收到 `%TEMP%`。Claude Code 自身的暫存檔一律使用您的覆寫值。請在您的 shell、使用者設定或受管設定中設定。在[專案與本機設定](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)中會被忽略 |

407| `CLAUDE_CODE_TMUX_TRUECOLOR` | 設為任何非空值（例如 `1`）可在 tmux 中允許 24 位元 truecolor 輸出。**設為 `0` 或 `false` 仍會允許 truecolor**，這與大多數開關變數不同；請取消設定此變數以恢復 256 色限制。預設情況下，當設定了 `$TMUX` 時，Claude Code 會限制為 256 色，因為除非經過設定，否則 tmux 不會傳遞 truecolor 跳脫序列。請在將 `set -ga terminal-overrides ',*:Tc'` 加入 `~/.tmux.conf` 後設定此變數。其他 tmux 設定請參閱[終端機設定](/docs/zh-TW/terminal-config) |409| `CLAUDE_CODE_TMUX_TRUECOLOR` | 設為任何非空值（例如 `1`）可允許在 tmux 內輸出 24 位元 truecolor。**將其設為 `0` 或 `false` 仍會允許 truecolor**，這與大多數開關變數不同；請取消設定此變數以恢復 256 色限制。預設情況下，當設定了 `$TMUX` 時，Claude Code 會限制為 256 色，因為除非經過設定，否則 tmux 不會傳遞 truecolor 跳脫序列。請在將 `set -ga terminal-overrides ',*:Tc'` 加入您的 `~/.tmux.conf` 後設定此變數。其他 tmux 設定請參閱[終端機設定](/docs/zh-TW/terminal-config) |

408| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | 在 Linux 與 WSL 上，設為以逗號分隔的清單，列出 Claude Code [從工具記憶體上限中排除](/docs/zh-TW/tools-reference#memory-limit-on-linux-and-wsl)的程序種類，例如 `mcp` 或 `lsp`。設為 `none` 可限制所有種類，或設為 `all-new` 僅限制 Bash、PowerShell 與 Monitor 工具命令。無論您列出什麼，Claude Code 都會讓 Bash、PowerShell 與 Monitor 工具命令受到上限約束。需要 Claude Code v2.1.246 或更新版本 |410| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | 在 Linux 與 WSL 上，設為以逗號分隔的程序類型清單，這些類型的程序會被 Claude Code [排除在工具記憶體上限之外](/docs/zh-TW/tools-reference#memory-limit-on-linux-and-wsl)，例如 `mcp` 或 `lsp`。設為 `none` 可限制所有類型，或設為 `all-new` 僅限制 Bash、PowerShell 與 Monitor 工具命令。無論您列出什麼，Claude Code 都會讓 Bash、PowerShell 與 Monitor 工具命令受上限約束。需要 Claude Code v2.1.246 或更新版本 |

409| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | 在 Linux 與 WSL 上，設為 `4G` 等大小以[限制 Bash 與 PowerShell 工具命令可使用的記憶體](/docs/zh-TW/tools-reference#memory-limit-on-linux-and-wsl)，在 v2.1.246 或更新版本中也包括 Monitor 工具命令。請以純數字寫出大小，單獨表示位元組數，或加上 `K`、`M`、`G` 或 `T` 後綴。設為 `0` 或 `off` 可關閉上限。一旦 Claude Code 啟動的第一個程序已開啟或關閉上限，變更後的值會在您下次啟動 `claude` 時生效。需要 Claude Code v2.1.233 或更新版本 |411| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | 在 Linux 與 WSL 上，設為某個大小（例如 `4G`），可[限制 Bash 與 PowerShell 工具命令可使用的記憶體](/docs/zh-TW/tools-reference#memory-limit-on-linux-and-wsl)，在 v2.1.246 或更新版本中也包括 Monitor 工具命令。請以純數字填寫大小，單獨使用表示位元組數，或加上 `K`、`M`、`G` 或 `T` 後綴。設為 `0` 或 `off` 可關閉上限。一旦 Claude Code 啟動的第一個程序已開啟或關閉上限，變更後的值會在您下次啟動 `claude` 時生效。需要 Claude Code v2.1.233 或更新版本 |

410| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Claude Code 取消轉送至遠端用戶端（例如 [Remote Control](/docs/zh-TW/remote-control) 或 SDK 主機）之對話框，或[保留的跨工作階段訊息](/docs/zh-TW/cross-session-messaging#control-inbound-messages)之核准對話框前的期限（毫秒）；權限提示與 `AskUserQuestion` 問題使用各自的流程，不受此變數控制。在 Claude Code v2.1.236 或更新版本中，它也會限制可能在無人值守情況下執行之工作階段中，於工作階段中途出現的 [Fable 用量點數同意提示](/docs/zh-TW/model-config#fable-and-usage-credits)。[控制傳入訊息](/docs/zh-TW/cross-session-messaging#control-inbound-messages)與[非互動式工作階段](/docs/zh-TW/cross-session-messaging#non-interactive-sessions)涵蓋完整的保留訊息到期規則，包括期限不適用的情況。覆寫 [`dialogExpiry`](/docs/zh-TW/settings-reference#dialogexpiry) 設定。`0` 或負值會停用期限 |412| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Claude Code 取消其轉送至遠端用戶端（例如 [Remote Control](/docs/zh-TW/remote-control) 或 SDK 主機）之對話框，或[保留的跨工作階段訊息](/docs/zh-TW/cross-session-messaging#control-inbound-messages)之核准對話框前的期限（毫秒）；權限提示與 `AskUserQuestion` 問題使用各自的流程，不受此變數管轄。在 Claude Code v2.1.236 或更新版本中，它也會限制可能在無人值守狀態下執行之工作階段中，於工作階段中途出現的 [Fable 用量點數同意提示](/docs/zh-TW/model-config#fable-and-usage-credits)。[控制傳入訊息](/docs/zh-TW/cross-session-messaging#control-inbound-messages)與[非互動工作階段](/docs/zh-TW/cross-session-messaging#non-interactive-sessions)涵蓋了完整的保留訊息到期規則，包括期限不適用的情況。覆寫 [`dialogExpiry`](/docs/zh-TW/settings-reference#dialogexpiry) 設定。`0` 或負值會停用期限 |

411| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | 使用 [Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws) |413| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | 使用 [Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws) |

412| `CLAUDE_CODE_USE_BEDROCK` | 使用 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) |414| `CLAUDE_CODE_USE_BEDROCK` | 使用 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) |

413| `CLAUDE_CODE_USE_FOUNDRY` | 使用 [Microsoft Foundry](/docs/zh-TW/microsoft-foundry) |415| `CLAUDE_CODE_USE_FOUNDRY` | 使用 [Microsoft Foundry](/docs/zh-TW/microsoft-foundry) |

414| `CLAUDE_CODE_USE_MANTLE` | 使用 Amazon Bedrock [Mantle 端點](/docs/zh-TW/amazon-bedrock#use-the-mantle-endpoint) |416| `CLAUDE_CODE_USE_MANTLE` | 使用 Amazon Bedrock [Mantle 端點](/docs/zh-TW/amazon-bedrock#use-the-mantle-endpoint) |

415| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | 設為 `1` 可使用 Node.js 檔案 API 而非 ripgrep 來探索自訂命令、subagent 與輸出風格。若內建的 ripgrep 二進位檔在您的環境中無法使用或遭封鎖，請設定此變數。不影響 Grep 或檔案搜尋工具 |417| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | 設為 `1` 可使用 Node.js 檔案 API 而非 ripgrep 來探索自訂命令、subagent 與輸出風格。若隨附的 ripgrep 二進位檔在您的環境中無法使用或遭封鎖，請設定此變數。不影響 Grep 或檔案搜尋工具 |

416| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | 控制 PowerShell 工具。在未安裝 Git Bash 的 Windows 上，此工具會自動啟用；設為 `0` 可停用。在已安裝 Git Bash 的 Windows 上，此工具對 claude.ai 與 Console 帳戶預設為開啟；設為 `1` 可在 Amazon Bedrock、Google Cloud's Agent Platform 與 Microsoft Foundry 工作階段中啟用，或設為 `0` 關閉。在 Linux、macOS 與 WSL 上，設為 `1` 可啟用，這需要 `pwsh` 位於您的 `PATH` 中。在 Windows 上啟用時，Claude 可以原生執行 PowerShell 命令，而不需透過 Git Bash 路由。請參閱 [PowerShell 工具](/docs/zh-TW/tools-reference#powershell-tool) |418| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | 控制 PowerShell 工具。在未安裝 Git Bash 的 Windows 上，此工具會自動啟用；設為 `0` 可停用。在已安裝 Git Bash 的 Windows 上，此工具對 claude.ai 與 Console 帳戶預設為開啟；設為 `1` 可在 Amazon Bedrock、Google Cloud's Agent Platform 與 Microsoft Foundry 工作階段中啟用，或設為 `0` 將其關閉。在 Linux、macOS 與 WSL 上，設為 `1` 可啟用，這需要 `pwsh` 位於您的 `PATH` 中。在 Windows 上啟用時，Claude 可以原生執行 PowerShell 命令，而不必透過 Git Bash 路由。請參閱 [PowerShell 工具](/docs/zh-TW/tools-reference#powershell-tool) |

417| `CLAUDE_CODE_USE_VERTEX` | 使用 [Google Cloud's Agent Platform](/docs/zh-TW/google-vertex-ai) |419| `CLAUDE_CODE_USE_VERTEX` | 使用 [Google Cloud's Agent Platform](/docs/zh-TW/google-vertex-ai) |

418| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | 設為 [WebFetch](/docs/zh-TW/tools-reference#webfetch-tool-behavior) 快取每個擷取 URL 回應的毫秒數。預設為 `900000`，即 15 分鐘。僅接受純數字；`0`、小數或任何其他寫法會維持預設值。Claude Code 每次啟動時只讀取一次此值，因此設定 `env` 區塊中的變更會在您下次啟動 `claude` 時套用。需要 Claude Code v2.1.233 或更新版本 |420| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | 設定 [WebFetch](/docs/zh-TW/tools-reference#webfetch-tool-behavior) 將每個已擷取 URL 的回應保留在快取中的毫秒數。預設值為 `900000`，即 15 分鐘。僅接受純數字；`0`、小數或任何其他寫法都會保留預設值。Claude Code 每次啟動時讀取一次該值，因此在設定的 `env` 區塊中所做的變更會在您下次啟動 `claude` 時生效。需要 Claude Code v2.1.233 或更新版本 |

419| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | [WebFetch](/docs/zh-TW/tools-reference#webfetch-tool-behavior) 等待頁面下載完成的時間上限（毫秒），包括其所追蹤的任何重新導向。屆時仍未完成的下載會以期限錯誤失敗。預設為 `300000`，即五分鐘。設為 `0` 可移除限制。僅接受純數字；小數或任何其他寫法會維持預設值。需要 Claude Code v2.1.268 或更新版本 |421| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | [WebFetch](/docs/zh-TW/tools-reference#webfetch-tool-behavior) 等待頁面下載完成的時間上限（毫秒），包括其所跟隨的任何重新導向。屆時尚未完成的下載會以截止期限錯誤失敗。預設值為 `300000`，即五分鐘。設定為 `0` 可移除此限制。僅接受純數字；小數或任何其他寫法都會保留預設值。需要 Claude Code v2.1.268 或更新版本 |

420| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | 單一[工作流程](/docs/zh-TW/workflows)執行同時執行的 agent 數量，範圍為 `1` 至 `256`。預設情況下，一次執行最多同時執行 16 個 agent；當 Claude Code 可用的 CPU 較少時則更少。排入佇列的 `agent()` 呼叫會等待空閒的槽位。每個執行中 agent 的逐字稿都會保留在 Claude Code 的記憶體中，因此較高的值會增加記憶體使用量。僅接受純數字；超出範圍的值和其他寫法會保持預設值。需要 Claude Code v2.1.269 或更新版本 |422| `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` | 當 `CLAUDE_AUTO_BACKGROUND_TASKS` 設定為 `1` 時，Claude Code 每次提醒 Claude 檢查仍在執行中的[背景 subagent](/docs/zh-TW/sub-agents#run-subagents-in-foreground-or-background) 之前所等待的時間。接受一個或多個以逗號分隔、以整數秒表示的等待時間，範圍為 `1` 到 `86400`，例如 `600` 或 `600,1800,3600`。每個值都是下一次提醒之前的等待時間，最後一個值會重複使用。僅接受純數字；任何其他值或寫法都視為未設定。未設定時不會有任何提醒。需要 Claude Code v2.1.283 或更新版本 |

421| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | [工作流程](/docs/zh-TW/workflows) agent 在傳送自己的第一個請求之前，等待具有相同前綴的同層級 agent 開始第一個回應的時間上限（以毫秒為單位）。當 fan-out 啟動多個共用[提示快取前綴](/docs/zh-TW/workflows#prompt-caching-in-a-fan-out)的 agent 時，Claude Code 會讓第一個 agent 以外的所有 agent 最多等待這麼長的時間，讓其餘 agent 讀取已快取的前綴，而不是各自在未快取的情況下處理它。預設值為 `5000`。設定為 `0` 可停用等待。設定 `DISABLE_PROMPT_CACHING` 時，agent 永遠不會等待。需要 Claude Code v2.1.229 或更新版本 |423| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | 單次[工作流程](/docs/zh-TW/workflows)執行同時執行的 agent 數量，範圍為 `1` 到 `256`。預設情況下，單次執行最多同時執行 16 個 agent，當 Claude Code 可用的 CPU 較少時則更少；排入佇列的 `agent()` 呼叫會等待空閒的位置。每個執行中 agent 的逐字稿都保留在 Claude Code 的記憶體中，因此較高的值會增加記憶體使用量。僅接受純數字；超出範圍的值和其他寫法都會保留預設值。需要 Claude Code v2.1.269 或更新版本 |

422| `CLAUDE_CONFIG_DIR` | 覆寫設定目錄（預設：`~/.claude`）。所有設定、工作階段歷史記錄和外掛都儲存在此路徑下。關於憑證，請參閱 [Claude Code 儲存憑證的位置](/docs/zh-TW/authentication#credential-management)。適用於並行執行多個帳戶：例如 `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`。請在您的 shell、使用者設定或受管設定中設定它。在[專案和本機設定](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)中會被忽略 |424| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | [工作流程](/docs/zh-TW/workflows) agent 在傳送自己的第一個請求之前，等待具有相同前綴的同層 agent 開始其第一個回應的時間上限（毫秒）。當一次展開（fan-out）啟動多個共用[提示快取前綴](/docs/zh-TW/workflows#prompt-caching-in-a-fan-out)的 agent 時，Claude Code 會讓第一個以外的所有 agent 最多等待此時間，讓其餘 agent 讀取已快取的前綴，而不是各自在未快取的情況下處理它。預設值為 `5000`。設定為 `0` 可停用等待。設定 `DISABLE_PROMPT_CACHING` 時，agent 永遠不會等待。需要 Claude Code v2.1.229 或更新版本 |

423| `CLAUDE_DISABLE_ADOPT` | 設定為 `1` 可在您按下 `←` 或使用 [`/background`](/docs/zh-TW/agent-view#from-inside-a-session) 將工作階段移至背景時，停止進行中的背景工作，而非將其延續。Claude Code 會在移至背景前要求您確認，然後停止原本會延續的任務。需要 Claude Code v2.1.195 或更新版本 |425| `CLAUDE_CONFIG_DIR` | 覆寫設定目錄（預設值：`~/.claude`）。所有設定、工作階段歷史記錄和外掛都儲存在此路徑下。關於憑證，請參閱 [Claude Code 儲存憑證的位置](/docs/zh-TW/authentication#credential-management)。適用於同時執行多個帳戶：例如 `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`。請在您的 shell、使用者設定或受管設定中設定此變數。在[專案和本機設定](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)中會被忽略 |

426| `CLAUDE_DISABLE_ADOPT` | 設定為 `1` 時，當您按下 `←` 或使用 [`/background`](/docs/zh-TW/agent-view#from-inside-a-session) 將工作階段移至背景時，會停止進行中的背景工作，而不是將其延續下去。Claude Code 會在移至背景前請您確認，然後停止原本會延續下去的任務。需要 Claude Code v2.1.195 或更新版本 |

424| `CLAUDE_EFFORT` | 在 Bash 工具子程序和 hook 命令中自動設定為子程序啟動時生效的 [effort 等級](/docs/zh-TW/model-config#adjust-effort-level)：`low`、`medium`、`high`、`xhigh` 或 `max`。與傳遞給 [hook](/docs/zh-TW/hooks) 的 `effort.level` 欄位相符。僅在目前模型支援 effort 參數時設定 |427| `CLAUDE_EFFORT` | 在 Bash 工具子程序和 hook 命令中自動設定為子程序啟動時生效的 [effort 等級](/docs/zh-TW/model-config#adjust-effort-level)：`low`、`medium`、`high`、`xhigh` 或 `max`。與傳遞給 [hook](/docs/zh-TW/hooks) 的 `effort.level` 欄位相符。僅在目前模型支援 effort 參數時設定 |

425| `CLAUDE_ENABLE_BYTE_WATCHDOG` | 設定為 `1` 可強制啟用位元組層級的串流閒置監視程式，或設定為 `0` 可強制停用。`0` 也會在執行[首位元組期限](/docs/zh-TW/network-config#streaming-idle-watchdogs)的連線上關閉該期限。未設定時，監視程式預設會在直接 Anthropic API 和 [Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws) 連線上啟用，也會在透過 `ANTHROPIC_BASE_URL` 或 `ANTHROPIC_AWS_BASE_URL` 連接的[閘道](/docs/zh-TW/gateways)連線上的串流回應啟用；在 v2.1.222 之前，它不會在這些閘道連線上執行，因此即使 keep-alive ping 持續抵達，事件層級監視程式仍可能在那裡回報停滯。關於逾時以及計時器之間的交互作用，請參閱[串流閒置監視程式](/docs/zh-TW/network-config#streaming-idle-watchdogs) |428| `CLAUDE_ENABLE_BYTE_WATCHDOG` | 設定為 `1` 可強制啟用位元組層級的串流閒置監控程式，設定為 `0` 則強制停用。`0` 也會在執行[首位元組截止期限](/docs/zh-TW/network-config#streaming-idle-watchdogs)的連線上關閉該截止期限。未設定時，監控程式預設會在直接 Anthropic API 和 [Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws) 連線上啟用，也會在透過 `ANTHROPIC_BASE_URL` 或 `ANTHROPIC_AWS_BASE_URL` 連線的[閘道](/docs/zh-TW/gateways)連線的串流回應上啟用；在 v2.1.222 之前，它不會在這些閘道連線上執行，因此即使 keep-alive ping 持續送達，事件層級監控程式仍可能在該處回報停滯。關於逾時以及計時器之間的互動方式，請參閱[串流閒置監控程式](/docs/zh-TW/network-config#streaming-idle-watchdogs) |

426| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | 設定為 `1` 可在 Amazon Bedrock `vnd.amazon.eventstream` 回應上啟用位元組層級串流閒置監視程式，這也會在 Bedrock 串流請求上啟用[首位元組期限](/docs/zh-TW/network-config#streaming-idle-watchdogs)。預設關閉。使用 `CLAUDE_STREAM_IDLE_TIMEOUT_MS` 設定逾時 |429| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | 設定為 `1` 可在 Amazon Bedrock `vnd.amazon.eventstream` 回應上啟用位元組層級的串流閒置監控程式，這也會在 Bedrock 串流請求上啟用[首位元組截止期限](/docs/zh-TW/network-config#streaming-idle-watchdogs)。預設為關閉。使用 `CLAUDE_STREAM_IDLE_TIMEOUT_MS` 設定逾時 |

427| `CLAUDE_ENABLE_STREAM_WATCHDOG` | 設定為 `0` 可強制停用事件層級串流閒置監視程式，或設定為 `1` 可強制啟用。未設定時，監視程式預設對所有提供者開啟。在 v2.1.196 之前，未設定時的預設值在直接 Anthropic API 上由伺服器控制，在其他提供者上則為關閉。使用 `CLAUDE_STREAM_IDLE_TIMEOUT_MS` 設定逾時；關於與此監視程式一同執行的其他停滯計時器，請參閱[串流閒置監視程式](/docs/zh-TW/network-config#streaming-idle-watchdogs) |430| `CLAUDE_ENABLE_STREAM_WATCHDOG` | 設定為 `0` 可強制停用事件層級的串流閒置監控程式，設定為 `1` 則強制啟用。未設定時，監控程式預設對所有供應商皆為開啟。在 v2.1.196 之前，未設定時的預設值在直接 Anthropic API 上由伺服器控制，在其他供應商上則為關閉。使用 `CLAUDE_STREAM_IDLE_TIMEOUT_MS` 設定逾時；關於與此監控程式並行運作的其他停滯計時器，請參閱[串流閒置監控程式](/docs/zh-TW/network-config#streaming-idle-watchdogs) |