SpyBara
Go Premium

Documentation 2026-06-25 23:58 UTC to 2026-06-26 23:00 UTC

17 files changed +83 −134. View all changes and history on the product overview
2026
Tue 30 23:02 Mon 29 23:02 Sat 27 01:01 Fri 26 23:00 Thu 25 23:58 Wed 24 22:02 Tue 23 22:00 Mon 22 23:59 Fri 19 22:58 Thu 18 22:00 Wed 17 17:02 Tue 16 21:57 Mon 15 23:02 Sat 13 21:59 Fri 12 22:00 Thu 11 23:01 Wed 10 23:57 Tue 9 06:34 Mon 8 06:52 Sat 6 06:24 Fri 5 06:45 Thu 4 06:52 Wed 3 06:53 Tue 2 06:51

agent-teams.md +0 −7

Details

18 本頁描述的是 v2.1.178 版本的 agent teams。設定 `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` 後,生成隊友不再需要設定步驟,工作階段退出時會自動清理。在 v2.1.178 之前,您需要要求 Claude 先建立並命名團隊,Claude 使用 `TeamCreate` 和 `TeamDelete` 工具來設定和移除它。這兩個工具已不存在。Agent 工具上的 `team_name` 輸入被接受但被忽略,`TaskCreated`、`TaskCompleted` 和 `TeammateIdle` [hook payloads](/zh-TW/hooks#taskcreated) 中的 `team_name` 欄位帶有工作階段衍生的名稱,已被棄用。18 本頁描述的是 v2.1.178 版本的 agent teams。設定 `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` 後,生成隊友不再需要設定步驟,工作階段退出時會自動清理。在 v2.1.178 之前,您需要要求 Claude 先建立並命名團隊,Claude 使用 `TeamCreate` 和 `TeamDelete` 工具來設定和移除它。這兩個工具已不存在。Agent 工具上的 `team_name` 輸入被接受但被忽略,`TaskCreated`、`TaskCompleted` 和 `TeammateIdle` [hook payloads](/zh-TW/hooks#taskcreated) 中的 `team_name` 欄位帶有工作階段衍生的名稱,已被棄用。

19</Note>19</Note>

20 20 

21本頁涵蓋:

22 

23* [何時使用 agent teams](#when-to-use-agent-teams),包括最佳使用案例以及與 subagents 的比較

24* [啟動您的第一個 agent team](#start-your-first-agent-team)

25* [控制您的 agent team](#control-your-agent-team),包括顯示模式、任務分配和委派

26* [並行工作的最佳實踐](#best-practices)

27 

28<h2 id="when-to-use-agent-teams">21<h2 id="when-to-use-agent-teams">

29 何時使用 agent teams22 何時使用 agent teams

30</h2>23</h2>

artifacts.md +0 −9

Details

18 <img src="https://mintcdn.com/claude-code/kaHIYYMIYMYPxQg9/images/artifacts-viewer.png?fit=max&auto=format&n=kaHIYYMIYMYPxQg9&q=85&s=dbfd671cdb0d15f49f808b9e89778fe1" alt="在 claude.ai/code/artifact 的瀏覽器中開啟的成品。檢視器標題顯示成品標題 acme-funnel-fix、分享按鈕和作者頭像。分享選單已開啟,顯示'始終分享最新版本'切換、版本選擇器顯示'分享版本 2'、'Acme 的所有人'受眾選擇器和複製連結按鈕。在標題下方,成品頁面顯示兩個並排的行動裝置模型、漏斗圖表和一行指標卡片。" width="2511" height="1890" data-path="images/artifacts-viewer.png" />18 <img src="https://mintcdn.com/claude-code/kaHIYYMIYMYPxQg9/images/artifacts-viewer.png?fit=max&auto=format&n=kaHIYYMIYMYPxQg9&q=85&s=dbfd671cdb0d15f49f808b9e89778fe1" alt="在 claude.ai/code/artifact 的瀏覽器中開啟的成品。檢視器標題顯示成品標題 acme-funnel-fix、分享按鈕和作者頭像。分享選單已開啟,顯示'始終分享最新版本'切換、版本選擇器顯示'分享版本 2'、'Acme 的所有人'受眾選擇器和複製連結按鈕。在標題下方,成品頁面顯示兩個並排的行動裝置模型、漏斗圖表和一行指標卡片。" width="2511" height="1890" data-path="images/artifacts-viewer.png" />

19</Frame>19</Frame>

20 20 

21本頁涵蓋如何:

22 

23* 決定[何時使用成品](#when-to-use-an-artifact)

24* [建立](#create-an-artifact)、[更新](#update-an-artifact)和[分享](#share-an-artifact)成品

25* 應用[提示模式](#what-you-can-build)以獲得更豐富的頁面

26* [應用您自己的設計系統](#improve-the-visual-design),使成品與您產品的品牌相符

27* 了解[頁面限制](#page-constraints)和[可用性要求](#availability)

28* [停用](#disable-artifacts)或[為您的組織管理成品](#manage-artifacts-for-your-organization)

29 

30<h2 id="when-to-use-an-artifact">21<h2 id="when-to-use-an-artifact">

31 何時使用成品22 何時使用成品

32</h2>23</h2>

channels.md +1 −9

Details

18 18 

19當 Claude 通過 channel 回覆時,您會在終端中看到入站訊息,但看不到回覆文字。終端顯示工具呼叫和確認(如「已傳送」),實際回覆會出現在另一個平台上。19當 Claude 通過 channel 回覆時,您會在終端中看到入站訊息,但看不到回覆文字。終端顯示工具呼叫和確認(如「已傳送」),實際回覆會出現在另一個平台上。

20 20 

21本頁涵蓋:21如果您管理 Team、Enterprise 或 Console 組織,請參閱[為您的組織啟用 channels](#enterprise-controls)。若要建立您自己的 channel,請參閱 [Channels 參考](/zh-TW/channels-reference)。

22 

23* [支援的 channels](#supported-channels):Telegram、Discord 和 iMessage 設定

24* [安裝並執行 channel](#quickstart),使用 fakechat(本地主機演示)

25* [誰可以推送訊息](#security):寄件者允許清單以及您如何配對

26* [為您的組織啟用 channels](#enterprise-controls)(如果您管理 Team、Enterprise 或 Console 組織)

27* [Channels 如何比較](#how-channels-compare)網路工作階段、Slack、MCP 和遠端控制

28 

29若要建立您自己的 channel,請參閱 [Channels 參考](/zh-TW/channels-reference)。

30 22 

31<h2 id="supported-channels">23<h2 id="supported-channels">

32 支援的 channels24 支援的 channels

devcontainer.md +1 −6

Details

8 8 

9[開發容器](https://containers.dev/)(或 dev container)讓您定義一個相同的隔離環境,您的團隊中的每位工程師都可以執行。安裝 Claude Code 在該容器中後,Claude 執行的命令會在容器內執行,而不是在主機上執行,同時對您的專案檔案的編輯會在您工作時出現在本地儲存庫中。9[開發容器](https://containers.dev/)(或 dev container)讓您定義一個相同的隔離環境,您的團隊中的每位工程師都可以執行。安裝 Claude Code 在該容器中後,Claude 執行的命令會在容器內執行,而不是在主機上執行,同時對您的專案檔案的編輯會在您工作時出現在本地儲存庫中。

10 10 

11本頁涵蓋[在開發容器中安裝 Claude Code](#add-claude-code-to-your-dev-container) 以及隨後的配置主題。每個主題都是獨立的因此請跳轉到與您需要設定的內容相符的主題11本頁涵蓋[在開發容器中安裝 Claude Code](#add-claude-code-to-your-dev-container),然後是一組獨立的配置主題在重新構建時保持身份驗證、強制執行組織政策、限制網路出站流量,以及無需權限提示即可執行。請閱讀與您的設定相符的主題。

12 

13* [在重新構建時保持身份驗證和設定](#persist-authentication-and-settings-across-rebuilds)

14* [強制執行組織政策](#enforce-organization-policy)

15* [限制網路出站流量](#restrict-network-egress)

16* [無需權限提示即可執行](#run-without-permission-prompts)

17 12 

18<Warning>13<Warning>

19 雖然開發容器提供了大量保護,但沒有任何系統完全免疫所有攻擊。14 雖然開發容器提供了大量保護,但沒有任何系統完全免疫所有攻擊。

env-vars.md +1 −1

Details

237| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Claude.ai 驗證的 OAuth 重新整理權杖。設定時,`claude auth login` 會直接交換此權杖,而不是開啟瀏覽器。需要 `CLAUDE_CODE_OAUTH_SCOPES`。對於在自動化環境中佈建驗證很有用 |237| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Claude.ai 驗證的 OAuth 重新整理權杖。設定時,`claude auth login` 會直接交換此權杖,而不是開啟瀏覽器。需要 `CLAUDE_CODE_OAUTH_SCOPES`。對於在自動化環境中佈建驗證很有用 |

238| `CLAUDE_CODE_OAUTH_SCOPES` | 重新整理權杖發出時所使用的空格分隔 OAuth 範圍,例如 `"user:profile user:inference user:sessions:claude_code"`。設定 `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` 時為必需 |238| `CLAUDE_CODE_OAUTH_SCOPES` | 重新整理權杖發出時所使用的空格分隔 OAuth 範圍,例如 `"user:profile user:inference user:sessions:claude_code"`。設定 `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` 時為必需 |

239| `CLAUDE_CODE_OAUTH_TOKEN` | Claude.ai 驗證的 OAuth 存取權杖。`/login` 對於 SDK 和自動化環境的替代方案。優先於鑰匙圈儲存的認證。使用 [`claude setup-token`](/zh-TW/authentication#generate-a-long-lived-token) 產生一個 |239| `CLAUDE_CODE_OAUTH_TOKEN` | Claude.ai 驗證的 OAuth 存取權杖。`/login` 對於 SDK 和自動化環境的替代方案。優先於鑰匙圈儲存的認證。使用 [`claude setup-token`](/zh-TW/authentication#generate-a-long-lived-token) 產生一個 |

240| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | {/* max-version: 2.1.159 */}在 v2.1.160 中移除,現在是無操作。先前將 [fast mode](/zh-TW/fast-mode) 固定到 Claude Opus 4.6,而不是目前的預設值。若要在 Opus 4.6 停用之前在其上執行快速模式,請先使用 `/model` 選擇模型,然後 `/fast on` |240| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | {/* max-version: 2.1.159 */}在 v2.1.160 中移除,現在是無操作。先前將 [fast mode](/zh-TW/fast-mode) 固定到 Claude Opus 4.6,而不是目前的預設值 |

241| `CLAUDE_CODE_OTEL_DIAG_STDERR` | {/* min-version: 2.1.179 */}設定為 `1` 以將 OpenTelemetry 匯出器診斷錯誤寫入 stderr。預設情況下,這些錯誤僅在 `--debug` 時出現,因此配置不當的匯出器(例如 Prometheus 連接埠衝突)會以其他方式無聲失敗。需要 Claude Code v2.1.179 或更新版本。請參閱 [Monitoring](/zh-TW/monitoring-usage) |241| `CLAUDE_CODE_OTEL_DIAG_STDERR` | {/* min-version: 2.1.179 */}設定為 `1` 以將 OpenTelemetry 匯出器診斷錯誤寫入 stderr。預設情況下,這些錯誤僅在 `--debug` 時出現,因此配置不當的匯出器(例如 Prometheus 連接埠衝突)會以其他方式無聲失敗。需要 Claude Code v2.1.179 或更新版本。請參閱 [Monitoring](/zh-TW/monitoring-usage) |

242| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | 刷新待處理 OpenTelemetry spans 的逾時(以毫秒為單位)(預設值:5000)。請參閱 [Monitoring](/zh-TW/monitoring-usage) |242| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | 刷新待處理 OpenTelemetry spans 的逾時(以毫秒為單位)(預設值:5000)。請參閱 [Monitoring](/zh-TW/monitoring-usage) |

243| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 刷新動態 OpenTelemetry 標頭的間隔(以毫秒為單位)(預設值:1740000 / 29 分鐘)。請參閱 [Dynamic headers](/zh-TW/monitoring-usage#dynamic-headers) |243| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 刷新動態 OpenTelemetry 標頭的間隔(以毫秒為單位)(預設值:1740000 / 29 分鐘)。請參閱 [Dynamic headers](/zh-TW/monitoring-usage#dynamic-headers) |

fast-mode.md +6 −8

Details

12 12 

13快速模式是 Claude Opus 的高速配置,使模型速度提升最高 2.5 倍,但每個 token 的成本更高。當您需要速度進行互動式工作(如快速迭代或實時調試)時,使用 `/fast` 切換開啟,當成本比延遲更重要時,切換關閉。13快速模式是 Claude Opus 的高速配置,使模型速度提升最高 2.5 倍,但每個 token 的成本更高。當您需要速度進行互動式工作(如快速迭代或實時調試)時,使用 `/fast` 切換開啟,當成本比延遲更重要時,切換關閉。

14 14 

15快速模式不是不同的模型。它使用 Claude Opus 搭配不同的 API 配置,優先考慮速度而非成本效率。您獲得相同的品質和功能,只是回應速度更快。快速模式在 Opus 4.8、Opus 4.7 和 Opus 4.6 上受支援。它在 Sonnet、Haiku 或其他模型上不可用。15快速模式不是不同的模型。它使用 Claude Opus 搭配不同的 API 配置,優先考慮速度而非成本效率。您獲得相同的品質和功能,只是回應速度更快。快速模式在 Opus 4.8 和 Opus 4.7 上受支援。它在 Sonnet、Haiku 或其他模型上不可用。

16 16 

17<Warning>17<Warning>

18 Opus 4.6 的快速模式已棄用將在 Opus 4.8 推出後約 30 天內移除。移除後,Opus 4.6 上的快速模式將回退至標準速度和標準定價。遷移至 Opus 4.8 或 Opus 4.7 以保持加速。18 Opus 4.7 的快速模式自 2026 年 6 月 25 日起已棄用將於 2026 7 24 日移除。移除後,Opus 4.7 上的快速模式請求將返回錯誤,不會回退至標準 Opus 4.7。遷移至 Opus 4.8 以保持加速。

19</Warning>19</Warning>

20 20 

21<Note>21<Note>


25需要了解的事項:25需要了解的事項:

26 26 

27* 使用 `/fast` 在 Claude Code CLI 中切換快速模式。VS Code 擴充功能不支援快速模式。27* 使用 `/fast` 在 Claude Code CLI 中切換快速模式。VS Code 擴充功能不支援快速模式。

28* 快速模式定價在 Opus 4.8 上為 $10/$50 MTok,在 Opus 4.7 和 Opus 4.6 上為 $30/$150 MTok。28* 快速模式定價在 Opus 4.8 上為 $10/$50 MTok,在 Opus 4.7 上為 $30/$150 MTok。

29* 適用於訂閱方案(Pro/Max/Team/Enterprise)上的所有 Claude Code 使用者和 Claude Console。29* 適用於訂閱方案(Pro/Max/Team/Enterprise)上的所有 Claude Code 使用者和 Claude Console。

30* 對於訂閱方案(Pro/Max/Team/Enterprise)上的 Claude Code 使用者,快速模式僅透過使用額度提供,不包含在訂閱速率限制中。30* 對於訂閱方案(Pro/Max/Team/Enterprise)上的 Claude Code 使用者,快速模式僅透過使用額度提供,不包含在訂閱速率限制中。

31 31 

32本頁涵蓋如何[切換快速模式](#toggle-fast-mode)、其[成本權衡](#understand-the-cost-tradeoff)、[何時使用](#decide-when-to-use-fast-mode)、[要求](#requirements)、[每個工作階段選擇加入](#require-per-session-opt-in)和[速率限制行為](#handle-rate-limits)。

33 

34<h2 id="toggle-fast-mode">32<h2 id="toggle-fast-mode">

35 切換快速模式33 切換快速模式

36</h2>34</h2>


62快速模式的每個 token 定價高於標準 Opus,乘數因模型而異:60快速模式的每個 token 定價高於標準 Opus,乘數因模型而異:

63 61 

64| 模型 | 輸入 (MTok) | 輸出 (MTok) |62| 模型 | 輸入 (MTok) | 輸出 (MTok) |

65| ------------------- | --------- | --------- |63| -------- | --------- | --------- |

66| Opus 4.8 | \$10 | \$50 |64| Opus 4.8 | \$10 | \$50 |

67| Opus 4.7 和 Opus 4.6 | \$30 | \$150 |65| Opus 4.7 | \$30 | \$150 |

68 66 

69快速模式定價在整個 1M token 上下文視窗中是固定的。如需與標準 Opus 費率進行比較,請參閱 [Claude 定價參考](https://platform.claude.com/docs/zh-TW/about-claude/pricing)。67快速模式定價在整個 1M token 上下文視窗中是固定的。如需與標準 Opus 費率進行比較,請參閱 [Claude 定價參考](https://platform.claude.com/docs/zh-TW/about-claude/pricing)。

70 68 


147 處理速率限制145 處理速率限制

148</h2>146</h2>

149 147 

150快速模式與標準 Opus 有不同的速率限制。Opus 4.8、Opus 4.7 和 Opus 4.6 的快速模式共享相同的速率限制池:任一模型上的使用都會從相同的限制中扣除。當您達到快速模式速率限制或用完使用額度時:148快速模式與標準 Opus 有不同的速率限制。Opus 4.8 和 Opus 4.7 的快速模式共享相同的速率限制池:任一模型上的使用都會從相同的限制中扣除。當您達到快速模式速率限制或用完使用額度時:

151 149 

1521. 快速模式自動回退到標準速度1501. 快速模式自動回退到標準速度

1532. `↯` 圖示變灰以指示冷卻1512. `↯` 圖示變灰以指示冷卻

fullscreen.md +1 −1

Details

22 啟用全螢幕渲染22 啟用全螢幕渲染

23</h2>23</h2>

24 24 

25在任何 Claude Code 對話中執行 `/tui fullscreen`。CLI 會儲存 [`tui` 設定](/zh-TW/settings#available-settings)並重新啟動進入全螢幕模式,您的對話保持完整,因此您可以在工作階段中途切換而不會失去上下文。執行 `/tui` 不帶任何引數以列印哪個渲染器處於活動狀態。25在任何 Claude Code 對話中執行 `/tui fullscreen`。CLI 會儲存 [`tui` 設定](/zh-TW/settings#available-settings)並重新啟動進入全螢幕模式,您的對話保持完整,因此您可以在工作階段中途切換而不會失去上下文。執行 `/tui default` 以切換回經典渲染器,或執行 `/tui` 不帶任何引數以列印哪個渲染器處於活動狀態。

26 26 

27您也可以在啟動 Claude Code 之前設定 `CLAUDE_CODE_NO_FLICKER` 環境變數:27您也可以在啟動 Claude Code 之前設定 `CLAUDE_CODE_NO_FLICKER` 環境變數:

28 28 

goal.md +0 −7

Details

19* 將大型檔案分割成專注的模組,直到每個模組都在大小預算內19* 將大型檔案分割成專注的模組,直到每個模組都在大小預算內

20* 處理標記的問題待辦清單,直到佇列為空20* 處理標記的問題待辦清單,直到佇列為空

21 21 

22本頁涵蓋以下內容:

23 

24* [比較自主工作流方法](#compare-ways-to-keep-a-session-running):`/loop`、Stop hooks 和自動模式

25* [設定目標](#set-a-goal)和[編寫有效條件](#write-an-effective-condition)

26* [檢查狀態](#check-status)、[提前清除](#clear-a-goal)和[非互動式執行](#run-non-interactively)

27* 查看[評估如何運作](#how-evaluation-works)和[要求](#requirements)

28 

29<h2 id="compare-ways-to-keep-a-session-running">22<h2 id="compare-ways-to-keep-a-session-running">

30 比較保持工作階段執行的方式23 比較保持工作階段執行的方式

31</h2>24</h2>

llm-gateway.md +3 −11

Details

8 8 

9LLM gateway 是您的組織在 Claude Code 和模型提供商之間運行的代理。Claude Code 將 API 流量發送到 gateway,gateway 使用您的組織控制的憑證將其轉發給提供商。9LLM gateway 是您的組織在 Claude Code 和模型提供商之間運行的代理。Claude Code 將 API 流量發送到 gateway,gateway 使用您的組織控制的憑證將其轉發給提供商。

10 10 

11此頁面涵蓋:

12 

13* [gateway 提供的功能](#what-a-gateway-provides)

14* [路由和憑證如何運作](#how-a-gateway-works)

15* [推出 gateway 的步驟](#roll-out-a-gateway)

16* [gateway 如何與 claude.ai 訂閱互動](#subscriptions-and-gateways)

17* [與 gateway 分開配置的內容](#configure-separately-from-the-gateway)

18 

19<Note>11<Note>

20 - 如果您是連接到現有 gateway 的開發人員:[將 Claude Code 連接到您的 gateway](/zh-TW/llm-gateway-connect)12 * 如果您是連接到現有 gateway 的開發人員:[將 Claude Code 連接到您的 gateway](/zh-TW/llm-gateway-connect)

21 - 如果您是為組織推出 gateway 的管理員:[部署和分發 gateway](/zh-TW/llm-gateway-rollout)13 * 如果您是為組織推出 gateway 的管理員:[部署和分發 gateway](/zh-TW/llm-gateway-rollout)

22 - 如果您正在配置 gateway 產品:[gateway 協議參考](/zh-TW/llm-gateway-protocol)14 * 如果您正在配置 gateway 產品:[gateway 協議參考](/zh-TW/llm-gateway-protocol)

23</Note>15</Note>

24 16 

25<h2 id="what-a-gateway-provides">17<h2 id="what-a-gateway-provides">

Details

8 8 

9隔離 Claude Code 會限制一個會話可以讀取、寫入和在網路上存取的內容。當您讓 Claude 在較少的權限提示下工作、無人值守地執行它,或將其指向您不完全信任的程式碼時,這一點最為重要。9隔離 Claude Code 會限制一個會話可以讀取、寫入和在網路上存取的內容。當您讓 Claude 在較少的權限提示下工作、無人值守地執行它,或將其指向您不完全信任的程式碼時,這一點最為重要。

10 10 

11Claude Code 可以在多種隔離環境中執行,範圍從輕量級的每個命令沙箱到完全獨立的虛擬機。本頁涵蓋如何:11Claude Code 可以在多種隔離環境中執行,範圍從輕量級的每個命令沙箱到完全獨立的虛擬機。本頁涵蓋如何比較它們隔離的內容和所需條件,幫助您為威脅模型選擇一個,並展示如何在整個組織中強制執行該選擇。

12 

13* [比較](#compare-sandboxing-approaches)可用的隔離方法,包括它們隔離的內容、所需的條件以及涉及的設定工作量

14* [選擇](#choose-an-approach)適合您的目標和威脅模型的方法

15* [開始使用](#sandboxed-bash-tool)您選擇的方法,從內建的 Bash 沙箱到專用虛擬機

16* [在整個組織中強制執行](#enforce-isolation-across-an-organization)隔離

17 12 

18<Info>13<Info>

19 有關更廣泛的安全模型,請參閱 [Security](/zh-TW/security)。有關 Agent SDK 部署,請參閱 [Secure deployment](/zh-TW/agent-sdk/secure-deployment)。14 有關更廣泛的安全模型,請參閱 [Security](/zh-TW/security)。有關 Agent SDK 部署,請參閱 [Secure deployment](/zh-TW/agent-sdk/secure-deployment)。

sandboxing.md +0 −7

Details

8 8 

9Bash 沙箱讓 Claude 執行大多數 shell 命令,而無需停下來請求權限。與其批准每個命令,您可以定義命令可以接觸哪些檔案和網路域,作業系統會為每個 Bash 命令及其子流程強制執行該邊界。9Bash 沙箱讓 Claude 執行大多數 shell 命令,而無需停下來請求權限。與其批准每個命令,您可以定義命令可以接觸哪些檔案和網路域,作業系統會為每個 Bash 命令及其子流程強制執行該邊界。

10 10 

11本頁涵蓋如何:

12 

13* [啟用沙箱](#get-started)並選擇沙箱化命令的批准方式

14* [設定](#configure-sandboxing)命令可以到達的路徑和網路域

15* [將沙箱化與權限規則和權限模式結合](#how-sandboxing-relates-to-permissions-and-permission-modes)

16* [在整個組織中強制執行沙箱化](#configure-the-sandbox-for-your-organization),使用受管設定

17 

18<Note>11<Note>

19 若要比較其他隔離方法,例如開發容器、自訂容器和虛擬機,請參閱 [Sandbox environments](/zh-TW/sandbox-environments)。若要減少 Bash 以外工具的權限提示,請參閱 [permission modes](/zh-TW/permission-modes)。12 若要比較其他隔離方法,例如開發容器、自訂容器和虛擬機,請參閱 [Sandbox environments](/zh-TW/sandbox-environments)。若要減少 Bash 以外工具的權限提示,請參閱 [permission modes](/zh-TW/permission-modes)。

20</Note>13</Note>

sessions.md +32 −10

Details

4 4 

5# 管理 sessions5# 管理 sessions

6 6 

7> 命名、恢復、分支和在 Claude Code 對話之間切換。涵蓋 `--continue`、`--resume`、`--from-pr`、`/resume` 選擇器、session 命名和文字記錄儲存位置7> 命名、恢復、分支和在 Claude Code 對話之間切換。涵蓋 `--continue`、`--resume`、`--from-pr`、`/resume` 選擇器、session 命名、匯出文字記錄,以及文字記錄的儲存位置

8 8 

9session 是與專案目錄相關聯的已儲存對話。Claude Code 在您工作時將其儲存在本地,因此您可以從中斷的地方繼續、分支以嘗試不同的方法,或在任務之間切換。9session 是與專案目錄相關聯的已儲存對話。Claude Code 在您工作時將其儲存在本地,因此您可以從中斷的地方繼續、分支以嘗試不同的方法,或在任務之間切換。

10 10 

11[桌面應用程式](/zh-TW/desktop#work-in-parallel-with-sessions)、[Claude Code 網頁版](/zh-TW/claude-code-on-the-web)和 [VS Code 擴充功能](/zh-TW/vs-code#resume-past-conversations)各自維護自己的 session 歷史記錄。本頁涵蓋 CLI11[桌面應用程式](/zh-TW/desktop#work-in-parallel-with-sessions)、[Claude Code 網頁版](/zh-TW/claude-code-on-the-web)和 [VS Code 擴充功能](/zh-TW/vs-code#resume-past-conversations)各自維護自己的 session 歷史記錄。本頁涵蓋 CLI

12 

13* 透過標誌、名稱或 PR [恢復](#resume-a-session)先前的對話

14* [命名](#name-your-sessions) sessions 以便稍後找到它們

15* 使用 `/resume` 選擇器 [瀏覽](#use-the-session-picker) sessions

16* [分支](#branch-a-session)對話以嘗試不同的方法

17* [匯出](#export-and-locate-session-data)文字記錄並在磁碟上找到它們

18 12 

19<h2 id="resume-a-session">13<h2 id="resume-a-session">

20 恢復 session14 恢復 session


125 119 

126執行 `/export` 將目前對話複製到您的剪貼簿或將其儲存為純文字檔案,訊息和工具輸出呈現為可讀文字。傳遞檔案名以直接寫入該檔案。120執行 `/export` 將目前對話複製到您的剪貼簿或將其儲存為純文字檔案,訊息和工具輸出呈現為可讀文字。傳遞檔案名以直接寫入該檔案。

127 121 

128文字記錄儲存為 JSONL,位置為 `~/.claude/projects/<project>/<session-id>.jsonl`,其中 `<project>` 衍生自您的工作目錄路徑。每一行都是訊息、工具使用或中繼資料項目的 JSON 物件。要將 sessions 儲存在 `~/.claude` 以外的位置,請設定 [`CLAUDE_CONFIG_DIR`](/zh-TW/env-vars)。這些本地檔案預設在 30 天後被移除;使用 [`cleanupPeriodDays`](/zh-TW/settings#available-settings) 變更此設定。122<h3 id="access-conversations-from-scripts">

123 從指令碼存取對話

124</h3>

125 

126`/export` 產生供人閱讀的呈現文字記錄。下列介面產生供指令碼解析的結構化資料:執行的 JSON 結果、session 文字記錄檔案的路徑,或事件的即時串流。根據觸發指令碼的內容選擇:

127 

128* **執行 Claude 一次並擷取結果**:使用 [`--output-format json` 或 `stream-json`](/zh-TW/headless#get-structured-output) 叫用 `claude -p`,以將非互動執行的結果、session ID、使用情況和成本擷取為結構化 JSON。

129* **詢問現有 session 一個問題**:將 session ID 傳遞給 [`claude -p --resume`](/zh-TW/headless#continue-conversations),以傳送後續提示(例如摘要要求),並擷取結構化回應。

130* **對 session 事件做出反應**:讀取 [hooks](/zh-TW/hooks#common-input-fields) 和 [status line commands](/zh-TW/statusline#available-data) 作為輸入接收的 `transcript_path` 欄位。`SessionEnd` hook 可在 session 結束時封存文字記錄。

131* **在 TypeScript 或 Python 應用程式中嵌入 Claude**:使用 [Agent SDK](/zh-TW/agent-sdk/overview) 以程式設計方式接收每條訊息。

132 

133下列範例使用第二個介面。它傳送後續提示給現有 session,並使用 `jq` 讀取答案:

134 

135```bash theme={null}

136claude -p --resume <session-id> --output-format json "summarize what we changed" | jq -r '.result'

137```

138 

139<h3 id="where-transcripts-are-stored">

140 文字記錄儲存位置

141</h3>

142 

143根據預設,文字記錄儲存為 JSONL,位置為 `~/.claude/projects/<project>/<session-id>.jsonl`,其中 `<project>` 是您的工作目錄路徑,非英數字元已被 `-` 取代。每一行都是訊息、工具使用或中繼資料項目的 JSON 物件。項目格式是 Claude Code 的內部格式,在版本之間會變更,因此直接解析這些檔案的指令碼可能在任何版本上中斷。若要建立在 session 資料上,請改用 `/export` 或 [指令碼介面](#access-conversations-from-scripts)。

144 

145位置、保留期和寫入行為可設定:

129 146 

130要完全禁止文字記錄寫入,請設定 [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/zh-TW/env-vars),或在非互動模式中使用 `--no-session-persistence`。147| 目的 | 設定 | 位置 |

148| ------------------- | --------------------------------------------------------- | ----------------------- |

149| 將儲存空間移出 `~/.claude` | [`CLAUDE_CONFIG_DIR`](/zh-TW/env-vars) | 環境變數 |

150| 變更 30 天保留期 | [`cleanupPeriodDays`](/zh-TW/settings#available-settings) | `settings.json` |

151| 在所有模式中禁止文字記錄寫入 | [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/zh-TW/env-vars) | 環境變數 |

152| 禁止一次非互動執行的寫入 | [`--no-session-persistence`](/zh-TW/cli-reference) | 搭配 `claude -p` 的 CLI 旗標 |

131 153 

132<h2 id="see-also">154<h2 id="see-also">

133 另請參閱155 另請參閱

settings.md +34 −35

Details

214| :-------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------ |214| :-------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------ |

215| `advisorModel` | {/* min-version: 2.1.98 */}伺服器端 [advisor tool](/zh-TW/advisor) 的模型。接受模型別名,例如 `"opus"`、`"sonnet"` 或 `"fable"`({/* min-version: 2.1.170 */}v2.1.170+),或完整模型 ID。當您執行 `/advisor` 時自動寫入。取消設定以停用 advisor。需要 Claude Code v2.1.98 或更新版本 | `"opus"` |215| `advisorModel` | {/* min-version: 2.1.98 */}伺服器端 [advisor tool](/zh-TW/advisor) 的模型。接受模型別名,例如 `"opus"`、`"sonnet"` 或 `"fable"`({/* min-version: 2.1.170 */}v2.1.170+),或完整模型 ID。當您執行 `/advisor` 時自動寫入。取消設定以停用 advisor。需要 Claude Code v2.1.98 或更新版本 | `"opus"` |

216| `agent` | 將主執行緒作為命名 subagent 執行,並為從 `claude agents` 分派的工作階段設定預設 agent。應用該 subagent 的系統提示、工具限制和模型。請參閱[明確叫用 subagents](/zh-TW/sub-agents#invoke-subagents-explicitly) | `"code-reviewer"` |216| `agent` | 將主執行緒作為命名 subagent 執行,並為從 `claude agents` 分派的工作階段設定預設 agent。應用該 subagent 的系統提示、工具限制和模型。請參閱[明確叫用 subagents](/zh-TW/sub-agents#invoke-subagents-explicitly) | `"code-reviewer"` |

217| `agentPushNotifEnabled` | {/* min-version: 2.1.119 */}當[遠端控制](/zh-TW/remote-control)已連線時,允許 Claude 主動傳送推播通知到您的手機,例如當長時間工作完成時。預設:`false`。在 `/config` 中顯示為**Claude 決定時推播**。請參閱[行動推播通知](/zh-TW/remote-control#mobile-push-notifications)。需要 Claude Code v2.1.119 或更新版本 | `true` |217| `agentPushNotifEnabled` | {/* min-version: 2.1.119 */}**預設**:`false`。當[遠端控制](/zh-TW/remote-control)已連線時,允許 Claude 主動傳送推播通知到您的手機,例如當長時間工作完成時。在 `/config` 中顯示為**Claude 決定時推播**。請參閱[行動推播通知](/zh-TW/remote-control#mobile-push-notifications)。需要 Claude Code v2.1.119 或更新版本 | `true` |

218| `allowAllClaudeAiMcps` | (Managed 設定僅限)載入 claude.ai connectors 以及部署的 `managed-mcp.json`,否則會取得獨佔控制並抑制它們。請參閱 [Managed MCP 設定](/zh-TW/managed-mcp) | `true` |218| `allowAllClaudeAiMcps` | (Managed 設定僅限)載入 claude.ai connectors 以及部署的 `managed-mcp.json`,否則會取得獨佔控制並抑制它們。請參閱 [Managed MCP 設定](/zh-TW/managed-mcp) | `true` |

219| `allowedChannelPlugins` | (Managed 設定僅限)可能推送訊息的頻道 plugins 白名單。在設定時替換預設 Anthropic 白名單。未定義 = 回退到預設值,空陣列 = 阻止所有頻道 plugins。需要 `channelsEnabled: true`。請參閱[限制哪些頻道 plugins 可以執行](/zh-TW/channels#restrict-which-channel-plugins-can-run) | `[{ "marketplace": "claude-plugins-official", "plugin": "telegram" }]` |219| `allowedChannelPlugins` | (Managed 設定僅限)可能推送訊息的頻道 plugins 白名單。在設定時替換預設 Anthropic 白名單。未定義 = 回退到預設值,空陣列 = 阻止所有頻道 plugins。需要 `channelsEnabled: true`。請參閱[限制哪些頻道 plugins 可以執行](/zh-TW/channels#restrict-which-channel-plugins-can-run) | `[{ "marketplace": "claude-plugins-official", "plugin": "telegram" }]` |

220| `allowedHttpHookUrls` | HTTP hooks 可能針對的 URL 模式白名單。支援 `*` 作為萬用字元。設定時,具有不匹配 URL 的 hooks 會被阻止。未定義 = 無限制,空陣列 = 阻止所有 HTTP hooks。陣列跨設定來源合併。請參閱 [Hook 設定](#hook-configuration) | `["https://hooks.example.com/*"]` |220| `allowedHttpHookUrls` | HTTP hooks 可能針對的 URL 模式白名單。支援 `*` 作為萬用字元。設定時,具有不匹配 URL 的 hooks 會被阻止。未定義 = 無限制,空陣列 = 阻止所有 HTTP hooks。陣列跨設定來源合併。請參閱 [Hook 設定](#hook-configuration) | `["https://hooks.example.com/*"]` |


225| `alwaysThinkingEnabled` | 為所有工作階段預設啟用[擴展思考](/zh-TW/model-config#extended-thinking)。通常透過 `/config` 命令而不是直接編輯來設定。若要強制思考關閉,無論此設定如何,請在 `env` 中設定 [`MAX_THINKING_TOKENS=0`](/zh-TW/env-vars),這會停用 Anthropic API 上的思考,除了 Fable 5,無法關閉思考。在[第三方提供者](/zh-TW/third-party-integrations)上,這會改為省略 `thinking` 參數,自適應推理模型仍可能思考 | `true` |225| `alwaysThinkingEnabled` | 為所有工作階段預設啟用[擴展思考](/zh-TW/model-config#extended-thinking)。通常透過 `/config` 命令而不是直接編輯來設定。若要強制思考關閉,無論此設定如何,請在 `env` 中設定 [`MAX_THINKING_TOKENS=0`](/zh-TW/env-vars),這會停用 Anthropic API 上的思考,除了 Fable 5,無法關閉思考。在[第三方提供者](/zh-TW/third-party-integrations)上,這會改為省略 `thinking` 參數,自適應推理模型仍可能思考 | `true` |

226| `apiKeyHelper` | 自訂指令碼,在系統 shell(macOS 和 Linux 上為 `/bin/sh`,Windows 上為 `cmd`)中執行,以產生驗證值。此值將作為 `X-Api-Key` 和 `Authorization: Bearer` 標頭傳送以進行模型請求。使用 [`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`](/zh-TW/env-vars) 設定重新整理間隔 | `/bin/generate_temp_api_key.sh` |226| `apiKeyHelper` | 自訂指令碼,在系統 shell(macOS 和 Linux 上為 `/bin/sh`,Windows 上為 `cmd`)中執行,以產生驗證值。此值將作為 `X-Api-Key` 和 `Authorization: Bearer` 標頭傳送以進行模型請求。使用 [`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`](/zh-TW/env-vars) 設定重新整理間隔 | `/bin/generate_temp_api_key.sh` |

227| `attribution` | 自訂 git 提交和拉取請求的歸屬。請參閱[歸屬設定](#attribution-settings) | `{"commit": "🤖 Generated with Claude Code", "pr": ""}` |227| `attribution` | 自訂 git 提交和拉取請求的歸屬。請參閱[歸屬設定](#attribution-settings) | `{"commit": "🤖 Generated with Claude Code", "pr": ""}` |

228| `autoCompactEnabled` | {/* min-version: 2.1.119 */}當內容接近限制時自動壓縮對話。預設:`true`。在 `/config` 中顯示為**自動壓縮**。若要透過環境變數停用,請在 `env` 中設定 [`DISABLE_AUTO_COMPACT`](/zh-TW/env-vars) | `false` |228| `autoCompactEnabled` | {/* min-version: 2.1.119 */}**預設**:`true`。當內容接近限制時自動壓縮對話。在 `/config` 中顯示為**自動壓縮**。若要透過環境變數停用,請在 `env` 中設定 [`DISABLE_AUTO_COMPACT`](/zh-TW/env-vars) | `false` |

229| `autoMemoryDirectory` | [自動記憶](/zh-TW/memory#storage-location)儲存的自訂目錄。接受絕對路徑或 `~/` 前綴的路徑。從專案或本機設定接受,此設定在您接受工作區信任對話後才受尊重,因為複製的儲存庫可能提供此檔案 | `"~/my-memory-dir"` |229| `autoMemoryDirectory` | [自動記憶](/zh-TW/memory#storage-location)儲存的自訂目錄。接受絕對路徑或 `~/` 前綴的路徑。從專案或本機設定接受,此設定在您接受工作區信任對話後才受尊重,因為複製的儲存庫可能提供此檔案 | `"~/my-memory-dir"` |

230| `autoMemoryEnabled` | 啟用[自動記憶](/zh-TW/memory#enable-or-disable-auto-memory)。當為 `false` 時,Claude 不會從自動記憶目錄讀取或寫入。預設:`true`。您也可以在工作階段期間使用 `/memory` 切換此設定。若要透過環境變數停用,請在 `env` 中設定 [`CLAUDE_CODE_DISABLE_AUTO_MEMORY`](/zh-TW/env-vars) | `false` |230| `autoMemoryEnabled` | **預設**:`true`。啟用[自動記憶](/zh-TW/memory#enable-or-disable-auto-memory)。當為 `false` 時,Claude 不會從自動記憶目錄讀取或寫入。您也可以在工作階段期間使用 `/memory` 切換此設定。若要透過環境變數停用,請在 `env` 中設定 [`CLAUDE_CODE_DISABLE_AUTO_MEMORY`](/zh-TW/env-vars) | `false` |

231| `autoMode` | 自訂[自動模式](/zh-TW/permission-modes#eliminate-prompts-with-auto-mode)分類器阻止和允許的內容。包含 `environment`、`allow`、`soft_deny` 和 `hard_deny` 陣列的散文規則。在陣列中包含字面字串 `"$defaults"` 以在該位置繼承內建規則。請參閱[設定自動模式](/zh-TW/auto-mode-config)。不從共享專案設定讀取 | `{"soft_deny": ["$defaults", "Never run terraform apply"]}` |231| `autoMode` | 自訂[自動模式](/zh-TW/permission-modes#eliminate-prompts-with-auto-mode)分類器阻止和允許的內容。包含 `environment`、`allow`、`soft_deny` 和 `hard_deny` 陣列的散文規則。在陣列中包含字面字串 `"$defaults"` 以在該位置繼承內建規則。請參閱[設定自動模式](/zh-TW/auto-mode-config)。不從共享專案設定讀取 | `{"soft_deny": ["$defaults", "Never run terraform apply"]}` |

232| `autoScrollEnabled` | 在[全螢幕渲染](/zh-TW/fullscreen)中,跟隨新輸出到對話的底部。預設:`true`。在 `/config` 中顯示為**自動捲軸**。當此設定關閉時,權限提示仍會捲軸進入檢視 | `false` |232| `autoScrollEnabled` | **預設**:`true`。在[全螢幕渲染](/zh-TW/fullscreen)中,跟隨新輸出到對話的底部。在 `/config` 中顯示為**自動捲軸**。當此設定關閉時,權限提示仍會捲軸進入檢視 | `false` |

233| `autoUpdatesChannel` | 遵循更新的發行頻道。使用 `"stable"` 以取得通常約一週舊的版本並跳過有重大迴歸的版本,或 `"latest"`(預設)以取得最新版本。若要完全停用自動更新,請在 `env` 中設定 [`DISABLE_AUTOUPDATER`](/zh-TW/setup#disable-auto-updates) | `"stable"` |233| `autoUpdatesChannel` | **預設**:`"latest"`。遵循更新的發行頻道。使用 `"stable"` 以取得通常約一週舊的版本並跳過有重大迴歸的版本,或 `"latest"` 以取得最新版本。若要完全停用自動更新,請在 `env` 中設定 [`DISABLE_AUTOUPDATER`](/zh-TW/setup#disable-auto-updates) | `"stable"` |

234| `availableModels` | 限制使用者可以為主工作階段、[subagents](/zh-TW/sub-agents)、[skills](/zh-TW/skills) 和 [advisor](/zh-TW/advisor) 選擇的模型。不影響預設選項,除非 `enforceAvailableModels` 也設定。請參閱[限制模型選擇](/zh-TW/model-config#restrict-model-selection) | `["sonnet", "haiku"]` |234| `availableModels` | 限制使用者可以為主工作階段、[subagents](/zh-TW/sub-agents)、[skills](/zh-TW/skills) 和 [advisor](/zh-TW/advisor) 選擇的模型。不影響預設選項,除非 `enforceAvailableModels` 也設定。請參閱[限制模型選擇](/zh-TW/model-config#restrict-model-selection) | `["sonnet", "haiku"]` |

235| `awaySummaryEnabled` | 在您離開終端機幾分鐘後返回時顯示單行工作階段摘要。設定為 `false` 或在 `/config` 中關閉工作階段摘要以停用。與 [`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](/zh-TW/env-vars) 相同 | `true` |235| `awaySummaryEnabled` | 在您離開終端機幾分鐘後返回時顯示單行工作階段摘要。設定為 `false` 或在 `/config` 中關閉工作階段摘要以停用。與 [`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](/zh-TW/env-vars) 相同 | `true` |

236| `awsAuthRefresh` | 修改 `.aws` 目錄的自訂指令碼(請參閱[進階認證設定](/zh-TW/amazon-bedrock#advanced-credential-configuration)) | `aws sso login --profile myprofile` |236| `awsAuthRefresh` | 修改 `.aws` 目錄的自訂指令碼(請參閱[進階認證設定](/zh-TW/amazon-bedrock#advanced-credential-configuration)) | `aws sso login --profile myprofile` |


240| `channelsEnabled` | (Managed 設定僅限)允許組織使用[頻道](/zh-TW/channels)。在 claude.ai Team 和 Enterprise 方案上,當此設定未設定或為 `false` 時,頻道會被阻止。對於使用 API 金鑰驗證的 [Anthropic Console](/zh-TW/authentication#claude-console-authentication) 帳戶,除非您的組織部署 managed 設定(在這種情況下此金鑰必須設定為 `true`),否則預設允許頻道 | `true` |240| `channelsEnabled` | (Managed 設定僅限)允許組織使用[頻道](/zh-TW/channels)。在 claude.ai Team 和 Enterprise 方案上,當此設定未設定或為 `false` 時,頻道會被阻止。對於使用 API 金鑰驗證的 [Anthropic Console](/zh-TW/authentication#claude-console-authentication) 帳戶,除非您的組織部署 managed 設定(在這種情況下此金鑰必須設定為 `true`),否則預設允許頻道 | `true` |

241| `claudeMd` | (Managed 設定僅限)CLAUDE.md 樣式的指示,作為組織管理的記憶注入。僅在 managed 或政策設定中設定時受尊重,在使用者、專案和本機設定中被忽略。請參閱[組織範圍的 CLAUDE.md](/zh-TW/memory#deploy-organization-wide-claude-md) | `"Always run make lint before committing."` |241| `claudeMd` | (Managed 設定僅限)CLAUDE.md 樣式的指示,作為組織管理的記憶注入。僅在 managed 或政策設定中設定時受尊重,在使用者、專案和本機設定中被忽略。請參閱[組織範圍的 CLAUDE.md](/zh-TW/memory#deploy-organization-wide-claude-md) | `"Always run make lint before committing."` |

242| `claudeMdExcludes` | 載入[記憶](/zh-TW/memory)時要跳過的 `CLAUDE.md` 檔案的 Glob 模式或絕對路徑。模式與絕對檔案路徑相符。僅適用於使用者、專案和本機記憶;managed 政策檔案無法排除 | `["**/vendor/**/CLAUDE.md"]` |242| `claudeMdExcludes` | 載入[記憶](/zh-TW/memory)時要跳過的 `CLAUDE.md` 檔案的 Glob 模式或絕對路徑。模式與絕對檔案路徑相符。僅適用於使用者、專案和本機記憶;managed 政策檔案無法排除 | `["**/vendor/**/CLAUDE.md"]` |

243| `cleanupPeriodDays` | 非使用中超過此期間的工作階段在啟動時刪除(預設:30 天,最少 1 天)。設定為 `0` 會被拒絕並出現驗證錯誤。也控制[孤立 subagent worktrees](/zh-TW/worktrees#clean-up-worktrees) 在啟動時自動移除的年齡截止。若要完全停用文字記錄寫入,請設定 [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/zh-TW/env-vars) 環境變數,或在非互動模式(`-p`)中使用 `--no-session-persistence` 旗標或 `persistSession: false` SDK 選項。 | `20` |243| `cleanupPeriodDays` | **預設**`30` 天,最少 `1`非使用中超過此期間的工作階段在啟動時刪除。設定為 `0` 會被拒絕並出現驗證錯誤。也控制[孤立 subagent worktrees](/zh-TW/worktrees#clean-up-worktrees) 在啟動時自動移除的年齡截止。若要完全停用文字記錄寫入,請設定 [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/zh-TW/env-vars) 環境變數,或在非互動模式(`-p`)中使用 `--no-session-persistence` 旗標或 `persistSession: false` SDK 選項。 | `20` |

244| `companyAnnouncements` | 在啟動時向使用者顯示的公告。如果提供多個公告,它們將隨機循環。 | `["Welcome to Acme Corp! Review our code guidelines at docs.acme.com"]` |244| `companyAnnouncements` | 在啟動時向使用者顯示的公告。如果提供多個公告,它們將隨機循環。 | `["Welcome to Acme Corp! Review our code guidelines at docs.acme.com"]` |

245| `defaultShell` | 輸入框 `!` 命令的預設 shell。接受 `"bash"`(預設)或 `"powershell"`。設定 `"powershell"` 會在 Windows 上透過 PowerShell 路由互動式 `!` 命令。需要 `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`。請參閱 [PowerShell tool](/zh-TW/tools-reference#powershell-tool) | `"powershell"` |245| `defaultShell` | **預設**:`"bash"`,或在 Bash 不可用時 Windows 上為 `"powershell"`。輸入框 `!` 命令的預設 shell。接受 `"bash"` 或 `"powershell"`。設定 `"powershell"` 會在 Windows 上透過 PowerShell 路由互動式 `!` 命令。需要 `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`。請參閱 [PowerShell tool](/zh-TW/tools-reference#powershell-tool) | `"powershell"` |

246| `deniedMcpServers` | 在 managed-settings.json 中設定時,明確阻止的 MCP servers 拒絕清單。適用於所有範圍,包括 managed servers。拒絕清單優先於白名單。請參閱 [Managed MCP 設定](/zh-TW/managed-mcp) | `[{ "serverName": "filesystem" }]` |246| `deniedMcpServers` | 在 managed-settings.json 中設定時,明確阻止的 MCP servers 拒絕清單。適用於所有範圍,包括 managed servers。拒絕清單優先於白名單。請參閱 [Managed MCP 設定](/zh-TW/managed-mcp) | `[{ "serverName": "filesystem" }]` |

247| `disableAgentView` | 設定為 `true` 以關閉[背景代理和代理檢視](/zh-TW/agent-view):`claude agents`、`--bg`、`/background` 和隨選主管。通常在 [managed 設定](/zh-TW/permissions#managed-settings) 中設定。等同於將 `CLAUDE_CODE_DISABLE_AGENT_VIEW` 設定為 `1` | `true` |247| `disableAgentView` | 設定為 `true` 以關閉[背景代理和代理檢視](/zh-TW/agent-view):`claude agents`、`--bg`、`/background` 和隨選主管。通常在 [managed 設定](/zh-TW/permissions#managed-settings) 中設定。等同於將 `CLAUDE_CODE_DISABLE_AGENT_VIEW` 設定為 `1` | `true` |

248| `disableAllHooks` | 停用所有 [hooks](/zh-TW/hooks) 和任何自訂[狀態行](/zh-TW/statusline) | `true` |248| `disableAllHooks` | 停用所有 [hooks](/zh-TW/hooks) 和任何自訂[狀態行](/zh-TW/statusline) | `true` |


254| `disabledMcpjsonServers` | 要拒絕的 `.mcp.json` 檔案中特定 MCP servers 的清單 | `["filesystem"]` |254| `disabledMcpjsonServers` | 要拒絕的 `.mcp.json` 檔案中特定 MCP servers 的清單 | `["filesystem"]` |

255| `disableRemoteControl` | {/* min-version: 2.1.128 */}停用[遠端控制](/zh-TW/remote-control):阻止 `claude remote-control`、`--remote-control` 旗標、自動啟動和工作階段內切換。通常放在[managed 設定](/zh-TW/permissions#managed-settings)中以進行每個裝置的 MDM 強制執行,但適用於任何範圍。需要 Claude Code v2.1.128 或更新版本 | `true` |255| `disableRemoteControl` | {/* min-version: 2.1.128 */}停用[遠端控制](/zh-TW/remote-control):阻止 `claude remote-control`、`--remote-control` 旗標、自動啟動和工作階段內切換。通常放在[managed 設定](/zh-TW/permissions#managed-settings)中以進行每個裝置的 MDM 強制執行,但適用於任何範圍。需要 Claude Code v2.1.128 或更新版本 | `true` |

256| `disableSkillShellExecution` | 停用 [skills](/zh-TW/skills) 和來自使用者、專案、plugin 或其他目錄來源的自訂命令中的內嵌 shell 執行(`` !`...` `` 和 ` ```! ` 區塊)。命令會被替換為 `[shell command execution disabled by policy]` 而不是被執行。Bundled 和 managed skills 不受影響。在[managed 設定](/zh-TW/permissions#managed-settings)中最有用,使用者無法覆蓋它 | `true` |256| `disableSkillShellExecution` | 停用 [skills](/zh-TW/skills) 和來自使用者、專案、plugin 或其他目錄來源的自訂命令中的內嵌 shell 執行(`` !`...` `` 和 ` ```! ` 區塊)。命令會被替換為 `[shell command execution disabled by policy]` 而不是被執行。Bundled 和 managed skills 不受影響。在[managed 設定](/zh-TW/permissions#managed-settings)中最有用,使用者無法覆蓋它 | `true` |

257| `disableWorkflows` | 停用[動態工作流程](/zh-TW/workflows#turn-workflows-off)和 bundled workflow 命令。預設:`false`。等同於將 `CLAUDE_CODE_DISABLE_WORKFLOWS` 設定為 `1` | `true` |257| `disableWorkflows` | **預設**:`false`。停用[動態工作流程](/zh-TW/workflows#turn-workflows-off)和 bundled workflow 命令。等同於將 `CLAUDE_CODE_DISABLE_WORKFLOWS` 設定為 `1` | `true` |

258| `editorMode` | 輸入提示的快捷鍵模式:`"normal"` 或 `"vim"`。預設:`"normal"`。在 `/config` 中顯示為**編輯器模式** | `"vim"` |258| `editorMode` | **預設**:`"normal"`。輸入提示的快捷鍵模式:`"normal"` 或 `"vim"`。在 `/config` 中顯示為**編輯器模式** | `"vim"` |

259| `effortLevel` | 跨工作階段持久化[努力等級](/zh-TW/model-config#adjust-effort-level)。接受 `"low"`、`"medium"`、`"high"` 或 `"xhigh"`。當您執行 `/effort` 時自動寫入,其中包含其中一個值。`--effort` 和 [`CLAUDE_CODE_EFFORT_LEVEL`](/zh-TW/env-vars) 會覆蓋此設定以進行一個工作階段。請參閱[調整努力等級](/zh-TW/model-config#adjust-effort-level)以了解支援的模型 | `"xhigh"` |259| `effortLevel` | 跨工作階段持久化[努力等級](/zh-TW/model-config#adjust-effort-level)。接受 `"low"`、`"medium"`、`"high"` 或 `"xhigh"`。當您執行 `/effort` 時自動寫入,其中包含其中一個值。`--effort` 和 [`CLAUDE_CODE_EFFORT_LEVEL`](/zh-TW/env-vars) 會覆蓋此設定以進行一個工作階段。請參閱[調整努力等級](/zh-TW/model-config#adjust-effort-level)以了解支援的模型 | `"xhigh"` |

260| `enableAllProjectMcpServers` | 自動批准專案 `.mcp.json` 檔案中定義的所有 MCP servers | `true` |260| `enableAllProjectMcpServers` | 自動批准專案 `.mcp.json` 檔案中定義的所有 MCP servers | `true` |

261| `enabledMcpjsonServers` | 要批准的 `.mcp.json` 檔案中特定 MCP servers 的清單 | `["memory", "github"]` |261| `enabledMcpjsonServers` | 要批准的 `.mcp.json` 檔案中特定 MCP servers 的清單 | `["memory", "github"]` |


264| `fallbackModel` | 當主模型過載或不可用時按順序嘗試的備用模型。Claude Code 會為該輪的其餘部分切換到鏈中的下一個可用模型並顯示通知。`"default"` 擴展為預設模型。鏈限制為三個模型;額外項目會被忽略。與大多數陣列設定不同,此金鑰不跨設定檔案合併:定義它的最高優先順序檔案提供整個鏈。[`--fallback-model`](/zh-TW/cli-reference#cli-flags) 旗標會覆蓋此設定以進行一個工作階段。請參閱[備用模型鏈](/zh-TW/model-config#fallback-model-chains) | `["claude-sonnet-4-6", "claude-haiku-4-5"]` |264| `fallbackModel` | 當主模型過載或不可用時按順序嘗試的備用模型。Claude Code 會為該輪的其餘部分切換到鏈中的下一個可用模型並顯示通知。`"default"` 擴展為預設模型。鏈限制為三個模型;額外項目會被忽略。與大多數陣列設定不同,此金鑰不跨設定檔案合併:定義它的最高優先順序檔案提供整個鏈。[`--fallback-model`](/zh-TW/cli-reference#cli-flags) 旗標會覆蓋此設定以進行一個工作階段。請參閱[備用模型鏈](/zh-TW/model-config#fallback-model-chains) | `["claude-sonnet-4-6", "claude-haiku-4-5"]` |

265| `fastModePerSessionOptIn` | 當為 `true` 時,快速模式不會跨工作階段持久化。每個工作階段都以快速模式關閉開始,需要使用者使用 `/fast` 啟用它。使用者的快速模式偏好仍會儲存。請參閱[需要每個工作階段的選擇加入](/zh-TW/fast-mode#require-per-session-opt-in) | `true` |265| `fastModePerSessionOptIn` | 當為 `true` 時,快速模式不會跨工作階段持久化。每個工作階段都以快速模式關閉開始,需要使用者使用 `/fast` 啟用它。使用者的快速模式偏好仍會儲存。請參閱[需要每個工作階段的選擇加入](/zh-TW/fast-mode#require-per-session-opt-in) | `true` |

266| `feedbackSurveyRate` | [工作階段品質調查](/zh-TW/data-usage#session-quality-surveys)出現時符合條件的機率(0–1)。設定為 `0` 以完全抑制,或設定 [`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`](/zh-TW/env-vars) 在 `env` 中。在使用 Bedrock、Vertex 或 Foundry 時很有用,其中預設樣本率不適用 | `0.05` |266| `feedbackSurveyRate` | [工作階段品質調查](/zh-TW/data-usage#session-quality-surveys)出現時符合條件的機率(0–1)。設定為 `0` 以完全抑制,或設定 [`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`](/zh-TW/env-vars) 在 `env` 中。在使用 Bedrock、Vertex 或 Foundry 時很有用,其中預設樣本率不適用 | `0.05` |

267| `fileCheckpointingEnabled` | {/* min-version: 2.1.119 */}在每次編輯前快照檔案,以便 [`/rewind`](/zh-TW/checkpointing) 可以還原它們。預設:`true`。在 `/config` 中顯示為**倒帶程式碼(檢查點)**。若要透過環境變數停用,請在 `env` 中設定 [`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`](/zh-TW/env-vars) | `false` |267| `fileCheckpointingEnabled` | {/* min-version: 2.1.119 */}**預設**:`true`。在每次編輯前快照檔案,以便 [`/rewind`](/zh-TW/checkpointing) 可以還原它們。在 `/config` 中顯示為**倒帶程式碼(檢查點)**。若要透過環境變數停用,請在 `env` 中設定 [`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`](/zh-TW/env-vars) | `false` |

268| `fileSuggestion` | 為 `@` 檔案自動完成設定自訂指令碼。請參閱[檔案建議設定](#file-suggestion-settings) | `{"type": "command", "command": "~/.claude/file-suggestion.sh"}` |268| `fileSuggestion` | 為 `@` 檔案自動完成設定自訂指令碼。請參閱[檔案建議設定](#file-suggestion-settings) | `{"type": "command", "command": "~/.claude/file-suggestion.sh"}` |

269| `footerLinksRegexes` | {/* min-version: 2.1.176 */}當 regex 符合輪次輸出時在頁尾中渲染額外的可點擊徽章。每個項目都有一個 `pattern`、一個包含 `{name}` 佔位符的 URL 範本(從命名擷取群組填入),以及一個選用的 `label`。僅從使用者設定、`--settings` 旗標和 managed 設定讀取。請參閱[頁尾連結徽章](#footer-link-badges)以了解 URL 限制、方案白名單和限制。需要 Claude Code v2.1.176 或更新版本 | `[{"type": "regex", "pattern": "\\b(?<key>PROJ-\\d+)\\b", "url": "https://issues.example.com/browse/{key}", "label": "{key}"}]` |269| `footerLinksRegexes` | {/* min-version: 2.1.176 */}當 regex 符合輪次輸出時在頁尾中渲染額外的可點擊徽章。每個項目都有一個 `pattern`、一個包含 `{name}` 佔位符的 URL 範本(從命名擷取群組填入),以及一個選用的 `label`。僅從使用者設定、`--settings` 旗標和 managed 設定讀取。請參閱[頁尾連結徽章](#footer-link-badges)以了解 URL 限制、方案白名單和限制。需要 Claude Code v2.1.176 或更新版本 | `[{"type": "regex", "pattern": "\\b(?<key>PROJ-\\d+)\\b", "url": "https://issues.example.com/browse/{key}", "label": "{key}"}]` |

270| `forceLoginMethod` | 使用 `claudeai` 限制登入到 Claude.ai 帳戶,`console` 限制登入到 Claude Console 帳戶。在 managed 設定中設定時,由 `ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN` 或 `apiKeyHelper` 驗證的工作階段在啟動時被阻止,因為兩個值都無法在沒有第一方 OAuth 的情況下滿足。第三方提供者工作階段(例如 Bedrock、Vertex 和 Foundry)不被阻止:它們針對您的雲端提供者而不是 Anthropic 進行驗證 | `claudeai` |270| `forceLoginMethod` | 使用 `claudeai` 限制登入到 Claude.ai 帳戶,`console` 限制登入到 Claude Console 帳戶。在 managed 設定中設定時,由 `ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN` 或 `apiKeyHelper` 驗證的工作階段在啟動時被阻止,因為兩個值都無法在沒有第一方 OAuth 的情況下滿足。第三方提供者工作階段(例如 Bedrock、Vertex 和 Foundry)不被阻止:它們針對您的雲端提供者而不是 Anthropic 進行驗證 | `claudeai` |


273| `gcpAuthRefresh` | 當 GCP Application Default Credentials 過期或無法載入時重新整理它們的自訂指令碼。請參閱[進階認證設定](/zh-TW/google-vertex-ai#advanced-credential-configuration) | `gcloud auth application-default login` |273| `gcpAuthRefresh` | 當 GCP Application Default Credentials 過期或無法載入時重新整理它們的自訂指令碼。請參閱[進階認證設定](/zh-TW/google-vertex-ai#advanced-credential-configuration) | `gcloud auth application-default login` |

274| `hooks` | 設定自訂命令以在生命週期事件執行。請參閱 [hooks 文件](/zh-TW/hooks)以了解格式 | 請參閱 [hooks](/zh-TW/hooks) |274| `hooks` | 設定自訂命令以在生命週期事件執行。請參閱 [hooks 文件](/zh-TW/hooks)以了解格式 | 請參閱 [hooks](/zh-TW/hooks) |

275| `httpHookAllowedEnvVars` | HTTP hooks 可能插入到標頭中的環境變數名稱白名單。設定時,每個 hook 的有效 `allowedEnvVars` 是與此清單的交集。未定義 = 無限制。陣列跨設定來源合併。請參閱 [Hook 設定](#hook-configuration) | `["MY_TOKEN", "HOOK_SECRET"]` |275| `httpHookAllowedEnvVars` | HTTP hooks 可能插入到標頭中的環境變數名稱白名單。設定時,每個 hook 的有效 `allowedEnvVars` 是與此清單的交集。未定義 = 無限制。陣列跨設定來源合併。請參閱 [Hook 設定](#hook-configuration) | `["MY_TOKEN", "HOOK_SECRET"]` |

276| `includeCoAuthoredBy` | **已棄用**:改用 `attribution`。是否在 git 提交和拉取請求中包含 `co-authored-by Claude` 署名(預設:`true`| `false` |276| `includeGitInstructions` | **預設**:`true`。 Claude 的系統提示中包含內建提交和 PR 工作流程指示和 git 狀態快照。設定為 `false` 以移除兩者,例如在使用您自己的 git 工作流程 skills 時。`CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` 環境變數在設定時優先於此設定 | `false` |

277| `includeGitInstructions` | 在 Claude 的系統提示中包含內建提交和 PR 工作流程指示和 git 狀態快照(預設:`true`設定為 `false` 以移除兩者,例如在使用您自己的 git 工作流程 skills 時。`CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` 環境變數在設定時優先於此設定 | `false` |277| `inputNeededNotifEnabled` | {/* min-version: 2.1.119 */}**預設**:`false`。當[遠端控制](/zh-TW/remote-control)已連線時,當權限提示或問題等待您的輸入時傳送推播通知到您的手機。在 `/config` 中顯示為**需要操作時推播**。請參閱[行動推播通知](/zh-TW/remote-control#mobile-push-notifications)。需要 Claude Code v2.1.119 或更新版本 | `true` |

278| `inputNeededNotifEnabled` | {/* min-version: 2.1.119 */}當[遠端控制](/zh-TW/remote-control)已連線時,當權限提示或問題等待您的輸入時傳送推播通知到您的手機。預設:`false`。在 `/config` 中顯示為**需要操作時推播**。請參閱[行動推播通知](/zh-TW/remote-control#mobile-push-notifications)。需要 Claude Code v2.1.119 或更新版本 | `true` |

279| `language` | 設定 Claude 的首選回應語言(例如 `"japanese"`、`"spanish"`、`"french"`)。Claude 預設會以此語言回應。也設定[語音聽寫](/zh-TW/voice-dictation#change-the-dictation-language)語言和自動產生的工作階段標題。{/* min-version: 2.1.176 */}自 v2.1.176 起,未設定時,工作階段標題符合您對話的語言 | `"japanese"` |278| `language` | 設定 Claude 的首選回應語言(例如 `"japanese"`、`"spanish"`、`"french"`)。Claude 預設會以此語言回應。也設定[語音聽寫](/zh-TW/voice-dictation#change-the-dictation-language)語言和自動產生的工作階段標題。{/* min-version: 2.1.176 */}自 v2.1.176 起,未設定時,工作階段標題符合您對話的語言 | `"japanese"` |

280| `maxSkillDescriptionChars` | {/* min-version: 2.1.105 */}[skill 清單](/zh-TW/skills#skill-descriptions-are-cut-short)中每個 skill 的字元上限,Claude 每輪看到的 `description` 和 `when_to_use` 文字的組合(預設:`1536`)。超過此長度的文字會被截斷。提高以保持長描述完整,代價是每輪更多內容;降低以在 [`skillListingBudgetFraction`](#available-settings) 下適應更多 skills。需要 Claude Code v2.1.105 或更新版本 | `2048` |279| `maxSkillDescriptionChars` | {/* min-version: 2.1.105 */}**預設**:`1536`。[skill 清單](/zh-TW/skills#skill-descriptions-are-cut-short)中每個 skill 的字元上限,Claude 每輪看到的 `description` 和 `when_to_use` 文字的組合。超過此長度的文字會被截斷。提高以保持長描述完整,代價是每輪更多內容;降低以在 [`skillListingBudgetFraction`](#available-settings) 下適應更多 skills。需要 Claude Code v2.1.105 或更新版本 | `2048` |

281| `minimumVersion` | 防止背景自動更新和 `claude update` 安裝低於此版本的版本。當從 `"latest"` 頻道切換到 `"stable"` 時透過 `/config` 提示您保持在目前版本或允許降級。選擇保持設定此值。也適用於[managed 設定](/zh-TW/permissions#managed-settings)以釘選組織範圍的最小值。如需完全阻止啟動的硬底線,請參閱 `requiredMinimumVersion` | `"2.1.100"` |280| `minimumVersion` | 防止背景自動更新和 `claude update` 安裝低於此版本的版本。當從 `"latest"` 頻道切換到 `"stable"` 時透過 `/config` 提示您保持在目前版本或允許降級。選擇保持設定此值。也適用於[managed 設定](/zh-TW/permissions#managed-settings)以釘選組織範圍的最小值。如需完全阻止啟動的硬底線,請參閱 `requiredMinimumVersion` | `"2.1.100"` |

282| `model` | 覆蓋 Claude Code 使用的預設模型。`--model` 和 [`ANTHROPIC_MODEL`](/zh-TW/model-config#environment-variables) 會覆蓋此設定以進行一個工作階段 | `"claude-sonnet-4-6"` |281| `model` | 覆蓋 Claude Code 使用的預設模型。`--model` 和 [`ANTHROPIC_MODEL`](/zh-TW/model-config#environment-variables) 會覆蓋此設定以進行一個工作階段 | `"claude-sonnet-4-6"` |

283| `modelOverrides` | 將 Anthropic 模型 ID 對應到提供者特定的模型 ID,例如 Bedrock 推論設定檔 ARN。每個模型選擇器項目在呼叫提供者 API 時使用其對應的值。請參閱[按版本覆蓋模型 ID](/zh-TW/model-config#override-model-ids-per-version) | `{"claude-opus-4-6": "arn:aws:bedrock:..."}` |282| `modelOverrides` | 將 Anthropic 模型 ID 對應到提供者特定的模型 ID,例如 Bedrock 推論設定檔 ARN。每個模型選擇器項目在呼叫提供者 API 時使用其對應的值。請參閱[按版本覆蓋模型 ID](/zh-TW/model-config#override-model-ids-per-version) | `{"claude-opus-4-6": "arn:aws:bedrock:..."}` |

284| `otelHeadersHelper` | 產生動態 OpenTelemetry 標頭的指令碼。在啟動時和定期執行。使用 [`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`](/zh-TW/env-vars) 設定重新整理間隔。請參閱[動態標頭](/zh-TW/monitoring-usage#dynamic-headers) | `/bin/generate_otel_headers.sh` |283| `otelHeadersHelper` | 產生動態 OpenTelemetry 標頭的指令碼。在啟動時和定期執行。使用 [`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`](/zh-TW/env-vars) 設定重新整理間隔。請參閱[動態標頭](/zh-TW/monitoring-usage#dynamic-headers) | `/bin/generate_otel_headers.sh` |

285| `outputStyle` | 設定輸出樣式以調整系統提示。請參閱[輸出樣式文件](/zh-TW/output-styles) | `"Explanatory"` |284| `outputStyle` | 設定輸出樣式以調整系統提示。請參閱[輸出樣式文件](/zh-TW/output-styles) | `"Explanatory"` |

286| `parentSettingsBehavior` | {/* min-version: 2.1.133 */}(Managed 設定僅限)控制由嵌入主機流程(例如 Agent SDK 或 IDE 擴充功能)以程式設計方式提供的 managed 設定在同時存在管理員部署的 managed 層級時是否適用。`"first-wins"`:父級提供的設定被丟棄,僅適用管理員層級。`"merge"`:父級提供的設定適用於管理員層級下方,經過篩選以便它們可以收緊 managed 政策但不能放鬆政策。當未部署管理員層級時無效。預設:`"first-wins"`。需要 Claude Code v2.1.133 或更新版本 | `"merge"` |285| `parentSettingsBehavior` | {/* min-version: 2.1.133 */}(Managed 設定僅限)**預設**:`"first-wins"`。控制由嵌入主機流程(例如 Agent SDK 或 IDE 擴充功能)以程式設計方式提供的 managed 設定在同時存在管理員部署的 managed 層級時是否適用。`"first-wins"`:父級提供的設定被丟棄,僅適用管理員層級。`"merge"`:父級提供的設定適用於管理員層級下方,經過篩選以便它們可以收緊 managed 政策但不能放鬆政策。當未部署管理員層級時無效。需要 Claude Code v2.1.133 或更新版本 | `"merge"` |

287| `permissions` | 請參閱下表以了解權限的結構。 | |286| `permissions` | 請參閱下表以了解權限的結構。 | |

288| `plansDirectory` | 自訂 Plan Mode 檔案的儲存位置。路徑相對於專案根目錄。預設:`~/.claude/plans` | `"./plans"` |287| `plansDirectory` | **預設**:`~/.claude/plans`。自訂 Plan Mode 檔案的儲存位置。路徑相對於專案根目錄。 | `"./plans"` |

289| `pluginSuggestionMarketplaces` | (Managed 設定僅限)其 plugins 可以作為內容相關安裝建議出現的 marketplace 名稱。沒有 marketplace 宣告的建議會出現而不需要此白名單;內建第一方前端設計提示不受影響。建議來自每個 plugin 在其 marketplace 項目中的 `relevance` 宣告。名稱僅在 marketplace 在機器上註冊且其註冊來源也在 managed 設定中宣告時才生效,作為該名稱的 `extraKnownMarketplaces` 項目或 `strictKnownMarketplaces` 的項目。從不同來源在白名單名稱下註冊的 marketplace 會被忽略。官方 marketplace 豁免於來源要求:白名單其名稱就足夠了,因為該名稱只能從官方 Anthropic 來源註冊。 | `["acme-corp-plugins"]` |288| `pluginSuggestionMarketplaces` | (Managed 設定僅限)其 plugins 可以作為內容相關安裝建議出現的 marketplace 名稱。沒有 marketplace 宣告的建議會出現而不需要此白名單;內建第一方前端設計提示不受影響。建議來自每個 plugin 在其 marketplace 項目中的 `relevance` 宣告。名稱僅在 marketplace 在機器上註冊且其註冊來源也在 managed 設定中宣告時才生效,作為該名稱的 `extraKnownMarketplaces` 項目或 `strictKnownMarketplaces` 的項目。從不同來源在白名單名稱下註冊的 marketplace 會被忽略。官方 marketplace 豁免於來源要求:白名單其名稱就足夠了,因為該名稱只能從官方 Anthropic 來源註冊。 | `["acme-corp-plugins"]` |

290| `pluginTrustMessage` | (Managed 設定僅限)在安裝前顯示的 plugin 信任警告中附加的自訂訊息。使用此選項新增組織特定的內容,例如確認來自您內部 marketplace 的 plugins 已經過審查。 | `"All plugins from our marketplace are approved by IT"` |289| `pluginTrustMessage` | (Managed 設定僅限)在安裝前顯示的 plugin 信任警告中附加的自訂訊息。使用此選項新增組織特定的內容,例如確認來自您內部 marketplace 的 plugins 已經過審查。 | `"All plugins from our marketplace are approved by IT"` |

291| `policyHelper` | {/* min-version: 2.1.136 */}管理員部署的可執行檔,在啟動時動態計算 managed 設定。僅從 MDM 或系統 `managed-settings.json` 檔案受尊重。請參閱[使用政策協助程式計算 managed 設定](#compute-managed-settings-with-a-policy-helper)。需要 Claude Code v2.1.136 或更新版本 | `{"path": "/usr/local/bin/claude-policy"}` |290| `policyHelper` | {/* min-version: 2.1.136 */}管理員部署的可執行檔,在啟動時動態計算 managed 設定。僅從 MDM 或系統 `managed-settings.json` 檔案受尊重。請參閱[使用政策協助程式計算 managed 設定](#compute-managed-settings-with-a-policy-helper)。需要 Claude Code v2.1.136 或更新版本 | `{"path": "/usr/local/bin/claude-policy"}` |

292| `preferredNotifChannel` | 工作完成和權限提示通知的方法:`"auto"`、`"terminal_bell"`、`"iterm2"`、`"iterm2_with_bell"`、`"kitty"`、`"ghostty"` 或 `"notifications_disabled"`。預設:`"auto"`在 iTerm2、Ghostty 和 Kitty 中傳送桌面通知,在其他終端機中不執行任何操作。設定 `"terminal_bell"` 以在任何終端機中響鈴字元。在 `/config` 中顯示為**通知**。請參閱[取得終端機鈴聲或通知](/zh-TW/terminal-config#get-a-terminal-bell-or-notification) | `"terminal_bell"` |291| `preferredNotifChannel` | **預設**:`"auto"`。工作完成和權限提示通知的方法:`"auto"`、`"terminal_bell"`、`"iterm2"`、`"iterm2_with_bell"`、`"kitty"`、`"ghostty"` 或 `"notifications_disabled"`。`"auto"` 在 iTerm2、Ghostty 和 Kitty 中傳送桌面通知,在其他終端機中不執行任何操作。設定 `"terminal_bell"` 以在任何終端機中響鈴字元。在 `/config` 中顯示為**通知**。請參閱[取得終端機鈴聲或通知](/zh-TW/terminal-config#get-a-terminal-bell-or-notification) | `"terminal_bell"` |

293| `prefersReducedMotion` | 減少或停用 UI 動畫(微調器、閃爍、閃光效果)以提高可訪問性 | `true` |292| `prefersReducedMotion` | 減少或停用 UI 動畫(微調器、閃爍、閃光效果)以提高可訪問性 | `true` |

294| `prUrlTemplate` | PR 徽章的 URL 範本,顯示在頁尾和工具結果摘要中。替換 `gh` 報告的 PR URL 中的 `{host}`、`{owner}`、`{repo}`、`{number}` 和 `{url}`。使用以指向內部程式碼審查工具而不是 `github.com`。不影響 Claude 散文中的 `#123` 自動連結 | `"https://reviews.example.com/{owner}/{repo}/pull/{number}"` |293| `prUrlTemplate` | PR 徽章的 URL 範本,顯示在頁尾和工具結果摘要中。替換 `gh` 報告的 PR URL 中的 `{host}`、`{owner}`、`{repo}`、`{number}` 和 `{url}`。使用以指向內部程式碼審查工具而不是 `github.com`。不影響 Claude 散文中的 `#123` 自動連結 | `"https://reviews.example.com/{owner}/{repo}/pull/{number}"` |

295| `remoteControlAtStartup` | {/* min-version: 2.1.119 */}當每個互動式工作階段啟動時自動連線[遠端控制](/zh-TW/remote-control),而不是等待 `/remote-control`。設定為 `true` 以始終自動連線,`false` 以永不自動連線,或保留未設定以遵循您組織的預設。在 `/config` 中顯示為**為所有工作階段啟用遠端控制**。請參閱[為所有工作階段啟用遠端控制](/zh-TW/remote-control#enable-remote-control-for-all-sessions) | `false` |294| `remoteControlAtStartup` | {/* min-version: 2.1.119 */}當每個互動式工作階段啟動時自動連線[遠端控制](/zh-TW/remote-control),而不是等待 `/remote-control`。設定為 `true` 以始終自動連線,`false` 以永不自動連線,或保留未設定以遵循您組織的預設。在 `/config` 中顯示為**為所有工作階段啟用遠端控制**。請參閱[為所有工作階段啟用遠端控制](/zh-TW/remote-control#enable-remote-control-for-all-sessions) | `false` |

296| `requiredMaximumVersion` | Managed 設定僅限。允許啟動的最大 Claude Code 版本。如果執行中的版本較新,Claude Code 會在啟動時結束並指示使用者透過組織的核准方法安裝核准的版本;`claude install <version>` 也可能有效。背景自動更新和 `claude update` 會跳過高於上限的版本,因此在範圍內的安裝保持在範圍內。`claude update`、`claude install` 和 `claude doctor` 在上限以上保持工作,以便使用者可以恢復。早於此設定的版本會忽略它 | `"2.1.150"` |295| `requiredMaximumVersion` | Managed 設定僅限。允許啟動的最大 Claude Code 版本。如果執行中的版本較新,Claude Code 會在啟動時結束並指示使用者透過組織的核准方法安裝核准的版本;`claude install <version>` 也可能有效。背景自動更新和 `claude update` 會跳過高於上限的版本,因此在範圍內的安裝保持在範圍內。`claude update`、`claude install` 和 `claude doctor` 在上限以上保持工作,以便使用者可以恢復。早於此設定的版本會忽略它 | `"2.1.150"` |

297| `requiredMinimumVersion` | Managed 設定僅限。啟動所需的最小 Claude Code 版本。如果執行中的版本較舊,Claude Code 會在啟動時結束並指示使用者透過組織的核准方法更新。`claude update`、`claude install` 和 `claude doctor` 在底線以下保持工作,以便使用者可以恢復。與 `minimumVersion` 不同,後者防止降級但永遠不會阻止啟動。早於此設定的版本會忽略它 | `"2.1.150"` |296| `requiredMinimumVersion` | Managed 設定僅限。啟動所需的最小 Claude Code 版本。如果執行中的版本較舊,Claude Code 會在啟動時結束並指示使用者透過組織的核准方法更新。`claude update`、`claude install` 和 `claude doctor` 在底線以下保持工作,以便使用者可以恢復。與 `minimumVersion` 不同,後者防止降級但永遠不會阻止啟動。早於此設定的版本會忽略它 | `"2.1.150"` |

298| `respectGitignore` | 控制 `@` 檔案選擇器是否尊重 `.gitignore` 模式。當為 `true`(預設)時,符合 `.gitignore` 模式的檔案會從建議中排除 | `false` |297| `respectGitignore` | **預設**:`true`。控制 `@` 檔案選擇器是否尊重 `.gitignore` 模式。當為 `true` 時,符合 `.gitignore` 模式的檔案會從建議中排除 | `false` |

299| `respondToBashCommands` | {/* min-version: 2.1.186 */}輸入框 `!` shell 命令執行後 Claude 是否回應。設定為 `false` 以將命令輸出新增到內容而不回應。預設:`true`。請參閱[使用 `!` 前綴的 Shell 模式](/zh-TW/interactive-mode#shell-mode-with-prefix)。需要 Claude Code v2.1.186 或更新版本 | `false` |298| `respondToBashCommands` | {/* min-version: 2.1.186 */}**預設**:`true`。輸入框 `!` shell 命令執行後 Claude 是否回應。設定為 `false` 以將命令輸出新增到內容而不回應。請參閱[使用 `!` 前綴的 Shell 模式](/zh-TW/interactive-mode#shell-mode-with-prefix)。需要 Claude Code v2.1.186 或更新版本 | `false` |

300| `showClearContextOnPlanAccept` | 在 Plan Mode 接受畫面上顯示「清除內容」選項。預設為 `false`。設定為 `true` 以還原選項 | `true` |299| `showClearContextOnPlanAccept` | **預設**:`false`。在 Plan Mode 接受畫面上顯示「清除內容」選項。設定為 `true` 以還原選項 | `true` |

301| `showThinkingSummaries` | 在互動式工作階段中顯示[擴展思考](/zh-TW/model-config#extended-thinking)摘要。未設定或 `false`(互動模式中的預設值)時,思考區塊由 API 編輯並顯示為摺疊的存根。編輯只會改變您看到的內容,而不是模型生成的內容:若要減少思考支出,請[降低預算或停用思考](/zh-TW/model-config#extended-thinking)。此設定在非互動模式(`-p`)、Agent SDK 或 IDE 擴充功能(例如 VS Code)中無效 | `true` |300| `showThinkingSummaries` | **預設**:`false`。在互動式工作階段中顯示[擴展思考](/zh-TW/model-config#extended-thinking)摘要。未設定或 `false` 時,思考區塊由 API 編輯並顯示為摺疊的存根。編輯只會改變您看到的內容,而不是模型生成的內容:若要減少思考支出,請[降低預算或停用思考](/zh-TW/model-config#extended-thinking)。此設定在非互動模式(`-p`)、Agent SDK 或 IDE 擴充功能(例如 VS Code)中無效 | `true` |

302| `showTurnDuration` | 在回應後顯示輪次持續時間訊息,例如「Cooked for 1m 6s」。預設:`true`。在 `/config` 中顯示為**顯示輪次持續時間** | `false` |301| `showTurnDuration` | **預設**:`true`。在回應後顯示輪次持續時間訊息,例如「Cooked for 1m 6s」。在 `/config` 中顯示為**顯示輪次持續時間** | `false` |

303| `skillListingBudgetFraction` | {/* min-version: 2.1.105 */}為 Claude 每輪看到的[skill 清單](/zh-TW/skills#skill-descriptions-are-cut-short)保留的模型內容視窗分數(預設:`0.01` = 1%)。當清單超過預算時,最少使用的 skills 的描述會摺疊為裸名稱,以便 Claude 仍可叫用它們,但不會看到原因。提高以保持更多描述可見,代價是每輪更多內容。`/doctor` 顯示目前的截斷計數和受影響的 skills。需要 Claude Code v2.1.105 或更新版本 | `0.02` |302| `skillListingBudgetFraction` | {/* min-version: 2.1.105 */}**預設**:`0.01`(1%)。為 Claude 每輪看到的[skill 清單](/zh-TW/skills#skill-descriptions-are-cut-short)保留的模型內容視窗分數。當清單超過預算時,最少使用的 skills 的描述會摺疊為裸名稱,以便 Claude 仍可叫用它們,但不會看到原因。提高以保持更多描述可見,代價是每輪更多內容。`/doctor` 顯示目前的截斷計數和受影響的 skills。需要 Claude Code v2.1.105 或更新版本 | `0.02` |

304| `skillOverrides` | {/* min-version: 2.1.129 */}按 skill 名稱鍵入的每個 skill 可見性覆蓋。值為 `"on"`、`"name-only"`、`"user-invocable-only"` 或 `"off"`。讓您隱藏或摺疊 skill 而無需編輯其 SKILL.md。不適用於 plugin skills,這些由 `/plugin` 管理。`/skills` 功能表將這些寫入 `.claude/settings.local.json`。請參閱[從設定覆蓋 skill 可見性](/zh-TW/skills#override-skill-visibility-from-settings)。需要 Claude Code v2.1.129 或更新版本 | `{"legacy-context": "name-only", "deploy": "off"}` |303| `skillOverrides` | {/* min-version: 2.1.129 */}按 skill 名稱鍵入的每個 skill 可見性覆蓋。值為 `"on"`、`"name-only"`、`"user-invocable-only"` 或 `"off"`。讓您隱藏或摺疊 skill 而無需編輯其 SKILL.md。不適用於 plugin skills,這些由 `/plugin` 管理。`/skills` 功能表將這些寫入 `.claude/settings.local.json`。請參閱[從設定覆蓋 skill 可見性](/zh-TW/skills#override-skill-visibility-from-settings)。需要 Claude Code v2.1.129 或更新版本 | `{"legacy-context": "name-only", "deploy": "off"}` |

305| `skipWebFetchPreflight` | 跳過[WebFetch 網域安全檢查](/zh-TW/data-usage#webfetch-domain-safety-check),該檢查在擷取前將每個請求的主機名稱傳送到 `api.anthropic.com`。在阻止流量到 Anthropic 的環境中設定為 `true`,例如 Bedrock、Vertex AI 或 Foundry 部署,具有限制性的出站。跳過時,WebFetch 嘗試任何 URL 而不諮詢黑名單 | `true` |304| `skipWebFetchPreflight` | 跳過[WebFetch 網域安全檢查](/zh-TW/data-usage#webfetch-domain-safety-check),該檢查在擷取前將每個請求的主機名稱傳送到 `api.anthropic.com`。在阻止流量到 Anthropic 的環境中設定為 `true`,例如 Bedrock、Vertex AI 或 Foundry 部署,具有限制性的出站。跳過時,WebFetch 嘗試任何 URL 而不諮詢黑名單 | `true` |

306| `spinnerTipsEnabled` | 在 Claude 工作時在微調器中顯示提示。設定為 `false` 以停用提示(預設:`true`) | `false` |305| `spinnerTipsEnabled` | **預設**:`true`。在 Claude 工作時在微調器中顯示提示。設定為 `false` 以停用提示 | `false` |

307| `spinnerTipsOverride` | 使用自訂字串覆蓋微調器提示。`tips`:提示字串陣列。`excludeDefault`:如果為 `true`,僅顯示自訂提示;如果為 `false` 或不存在,自訂提示會與內建提示合併 | `{ "excludeDefault": true, "tips": ["Use our internal tool X"] }` |306| `spinnerTipsOverride` | 使用自訂字串覆蓋微調器提示。`tips`:提示字串陣列。`excludeDefault`:如果為 `true`,僅顯示自訂提示;如果為 `false` 或不存在,自訂提示會與內建提示合併 | `{ "excludeDefault": true, "tips": ["Use our internal tool X"] }` |

308| `spinnerVerbs` | 自訂在微調器中顯示的動作動詞。將 `mode` 設定為 `"replace"` 以僅使用您的動詞,或 `"append"` 以將它們新增到預設值 | `{"mode": "append", "verbs": ["Pondering", "Crafting"]}` |307| `spinnerVerbs` | 自訂在微調器中顯示的動作動詞。將 `mode` 設定為 `"replace"` 以僅使用您的動詞,或 `"append"` 以將它們新增到預設值 | `{"mode": "append", "verbs": ["Pondering", "Crafting"]}` |

309| `sshConfigs` | 要在[桌面](/zh-TW/desktop#pre-configure-ssh-connections-for-your-team)環境下拉式清單中顯示的 SSH 連線。每個項目需要 `id`、`name` 和 `sshHost`;`sshPort`、`sshIdentityFile` 和 `startDirectory` 是選用的。在 managed 設定中設定時,連線對使用者是唯讀的。僅從 managed 和使用者設定讀取 | `[{"id": "dev-vm", "name": "Dev VM", "sshHost": "user@dev.example.com"}]` |308| `sshConfigs` | 要在[桌面](/zh-TW/desktop#pre-configure-ssh-connections-for-your-team)環境下拉式清單中顯示的 SSH 連線。每個項目需要 `id`、`name` 和 `sshHost`;`sshPort`、`sshIdentityFile` 和 `startDirectory` 是選用的。在 managed 設定中設定時,連線對使用者是唯讀的。僅從 managed 和使用者設定讀取 | `[{"id": "dev-vm", "name": "Dev VM", "sshHost": "user@dev.example.com"}]` |


311| `strictKnownMarketplaces` | (Managed 設定僅限)plugin marketplaces 白名單。未定義 = 無限制,空陣列 = 鎖定。在 marketplace 新增和 plugin 安裝、更新、重新整理和自動更新時強制執行,因此在設定政策之前新增的 marketplace 無法用於擷取 plugins。請參閱 [Managed marketplace 限制](/zh-TW/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "acme-corp/plugins" }]` |310| `strictKnownMarketplaces` | (Managed 設定僅限)plugin marketplaces 白名單。未定義 = 無限制,空陣列 = 鎖定。在 marketplace 新增和 plugin 安裝、更新、重新整理和自動更新時強制執行,因此在設定政策之前新增的 marketplace 無法用於擷取 plugins。請參閱 [Managed marketplace 限制](/zh-TW/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "acme-corp/plugins" }]` |

312| `strictPluginOnlyCustomization` | (Managed 設定僅限)阻止 skills、agents、hooks 和 MCP servers 來自使用者和專案來源,因此它們只能來自 plugins 或 managed 設定。`true` 鎖定所有四個表面;陣列僅鎖定命名的表面。請參閱 [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | `["skills", "hooks"]` |311| `strictPluginOnlyCustomization` | (Managed 設定僅限)阻止 skills、agents、hooks 和 MCP servers 來自使用者和專案來源,因此它們只能來自 plugins 或 managed 設定。`true` 鎖定所有四個表面;陣列僅鎖定命名的表面。請參閱 [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | `["skills", "hooks"]` |

313| `syntaxHighlightingDisabled` | 停用 diffs、程式碼區塊和檔案預覽中的語法醒目提示 | `true` |312| `syntaxHighlightingDisabled` | 停用 diffs、程式碼區塊和檔案預覽中的語法醒目提示 | `true` |

314| `teammateMode` | [agent team](/zh-TW/agent-teams) 隊友的顯示方式:`in-process`(預設)、`auto`(在 tmux 或 iTerm2 中選擇分割窗格,否則為進程內)、`tmux`(使用 tmux 或 iTerm2 選擇分割窗格,從您的終端機偵測)或 {/* min-version: 2.1.186 */}}`iterm2`(iTerm2 原生分割窗格透過 `it2` CLI,在 v2.1.186 中新增)。預設在 v2.1.179 中從 `auto` 變更。`--teammate-mode` 會覆蓋此設定以進行一個工作階段。請參閱[選擇顯示模式](/zh-TW/agent-teams#choose-a-display-mode) | `"auto"` |313| `teammateMode` | **預設**:`in-process`。[agent team](/zh-TW/agent-teams) 隊友的顯示方式:`in-process`、`auto`(在 tmux 或 iTerm2 中選擇分割窗格,否則為進程內)、`tmux`(使用 tmux 或 iTerm2 選擇分割窗格,從您的終端機偵測)或 {/* min-version: 2.1.186 */}}`iterm2`(iTerm2 原生分割窗格透過 `it2` CLI,在 v2.1.186 中新增)。預設在 v2.1.179 中從 `auto` 變更。`--teammate-mode` 會覆蓋此設定以進行一個工作階段。請參閱[選擇顯示模式](/zh-TW/agent-teams#choose-a-display-mode) | `"auto"` |

315| `terminalProgressBarEnabled` | 在支援的終端機中顯示終端機進度條:ConEmu、Ghostty 1.2.0+ 和 iTerm2 3.6.6+。預設:`true`。在 `/config` 中顯示為**終端機進度條** | `false` |314| `terminalProgressBarEnabled` | **預設**:`true`。在支援的終端機中顯示終端機進度條:ConEmu、Ghostty 1.2.0+ 和 iTerm2 3.6.6+。在 `/config` 中顯示為**終端機進度條** | `false` |

316| `theme` | {/* min-version: 2.1.119 */}介面的色彩主題:`"auto"`、`"dark"`、`"light"`、`"dark-daltonized"`、`"light-daltonized"`、`"dark-ansi"`、`"light-ansi"` 或自訂主題參考,例如 `"custom:<slug>"` 或 `"custom:<plugin-name>:<slug>"`。預設:`"dark"`。請參閱[建立自訂主題](/zh-TW/terminal-config#create-a-custom-theme)。在 `/config` 中顯示為**主題** | `"dark"` |315| `theme` | {/* min-version: 2.1.119 */}**預設**:`"dark"`。介面的色彩主題:`"auto"`、`"dark"`、`"light"`、`"dark-daltonized"`、`"light-daltonized"`、`"dark-ansi"`、`"light-ansi"` 或自訂主題參考,例如 `"custom:<slug>"` 或 `"custom:<plugin-name>:<slug>"`。請參閱[建立自訂主題](/zh-TW/terminal-config#create-a-custom-theme)。在 `/config` 中顯示為**主題** | `"dark"` |

317| `tui` | 終端機 UI 渲染器。使用 `"fullscreen"` 以取得無閃爍[替代螢幕渲染器](/zh-TW/fullscreen),具有虛擬化捲軸。使用 `"default"` 以取得經典主螢幕渲染器。透過 `/tui` 設定。您也可以設定 [`CLAUDE_CODE_NO_FLICKER`](/zh-TW/env-vars) 環境變數。背景工作階段從[代理檢視](/zh-TW/agent-view)開啟時,無論此設定如何,始終使用全螢幕渲染器 | `"fullscreen"` |316| `tui` | 終端機 UI 渲染器。使用 `"fullscreen"` 以取得無閃爍[替代螢幕渲染器](/zh-TW/fullscreen),具有虛擬化捲軸。使用 `"default"` 以取得經典主螢幕渲染器。透過 `/tui` 設定。您也可以設定 [`CLAUDE_CODE_NO_FLICKER`](/zh-TW/env-vars) 環境變數。背景工作階段從[代理檢視](/zh-TW/agent-view)開啟時,無論此設定如何,始終使用全螢幕渲染器 | `"fullscreen"` |

318| `ultracode` | 為工作階段開啟 [ultracode](/zh-TW/workflows#let-claude-decide-with-ultracode)。僅限工作階段,不從 `settings.json` 讀取。透過 `/effort ultracode`、`--settings` 或 Agent SDK 控制請求設定 | `true` |317| `ultracode` | 為工作階段開啟 [ultracode](/zh-TW/workflows#let-claude-decide-with-ultracode)。僅限工作階段,不從 `settings.json` 讀取。透過 `/effort ultracode`、`--settings` 或 Agent SDK 控制請求設定 | `true` |

319| `useAutoModeDuringPlan` | Plan Mode 在自動模式可用時是否使用自動模式語義。預設:`true`。不從共享專案設定讀取。在 `/config` 中顯示為「在計畫期間使用自動模式」 | `false` |318| `useAutoModeDuringPlan` | **預設**:`true`。Plan Mode 在自動模式可用時是否使用自動模式語義。不從共享專案設定讀取。在 `/config` 中顯示為「在計畫期間使用自動模式」 | `false` |

320| `verbose` | {/* min-version: 2.1.119 */}顯示完整工具輸出而不是截斷摘要。預設:`false`。在 `/config` 中顯示為**詳細輸出**。`--verbose` 旗標會覆蓋此設定以進行一個工作階段 | `true` |319| `verbose` | {/* min-version: 2.1.119 */}**預設**:`false`。顯示完整工具輸出而不是截斷摘要。在 `/config` 中顯示為**詳細輸出**。`--verbose` 旗標會覆蓋此設定以進行一個工作階段 | `true` |

321| `viewMode` | 啟動時的預設文字記錄檢視模式:`"default"`、`"verbose"` 或 `"focus"`。設定時覆蓋粘性 `/focus` 選擇。`--verbose` 旗標會覆蓋此設定以進行一個工作階段 | `"verbose"` |320| `viewMode` | 啟動時的預設文字記錄檢視模式:`"default"`、`"verbose"` 或 `"focus"`。設定時覆蓋粘性 `/focus` 選擇。`--verbose` 旗標會覆蓋此設定以進行一個工作階段 | `"verbose"` |

322| `voice` | [語音聽寫](/zh-TW/voice-dictation)設定:`enabled` 開啟聽寫,`mode` 選擇 `"hold"` 或 `"tap"`,`autoSubmit` 在保持模式中按鍵釋放時傳送提示。當您執行 `/voice` 時自動寫入。需要 Claude.ai 帳戶 | `{ "enabled": true, "mode": "tap" }` |321| `voice` | [語音聽寫](/zh-TW/voice-dictation)設定:`enabled` 開啟聽寫,`mode` 選擇 `"hold"` 或 `"tap"`,`autoSubmit` 在保持模式中按鍵釋放時傳送提示。當您執行 `/voice` 時自動寫入。需要 Claude.ai 帳戶 | `{ "enabled": true, "mode": "tap" }` |

323| `voiceEnabled` | `voice.enabled` 的舊版別名。偏好 `voice` 物件 | `true` |322| `voiceEnabled` | `voice.enabled` 的舊版別名。偏好 `voice` 物件 | `true` |

324| `wheelScrollAccelerationEnabled` | {/* min-version: 2.1.174 */}在[全螢幕渲染](/zh-TW/fullscreen#mouse-wheel-scrolling)中,加速滑鼠滾輪捲軸速度在快速捲軸期間。預設:`true`。設定為 `false` 以取得每個滾輪缺口的恆定捲軸速率。需要 Claude Code v2.1.174 或更新版本 | `false` |323| `wheelScrollAccelerationEnabled` | {/* min-version: 2.1.174 */}**預設**:`true`。在[全螢幕渲染](/zh-TW/fullscreen#mouse-wheel-scrolling)中,加速滑鼠滾輪捲軸速度在快速捲軸期間。設定為 `false` 以取得每個滾輪缺口的恆定捲軸速率。需要 Claude Code v2.1.174 或更新版本 | `false` |

325| `workflowKeywordTriggerEnabled` | {/* min-version: 2.1.157 */}提示中的單詞 `ultracode` 是否觸發[動態工作流程](/zh-TW/workflows#ask-for-a-workflow-in-your-prompt)。設定為 `false` 以輸入單詞而不觸發一個。Ultracode 努力設定、`/workflows` 和儲存的工作流程命令不受影響。預設:`true`。在 `/config` 中顯示為**Ultracode 關鍵字觸發**。在 v2.1.160 之前,觸發關鍵字是 `workflow` | `false` |324| `workflowKeywordTriggerEnabled` | {/* min-version: 2.1.157 */}**預設**:`true`。提示中的單詞 `ultracode` 是否觸發[動態工作流程](/zh-TW/workflows#ask-for-a-workflow-in-your-prompt)。設定為 `false` 以輸入單詞而不觸發一個。Ultracode 努力設定、`/workflows` 和儲存的工作流程命令不受影響。在 `/config` 中顯示為**Ultracode 關鍵字觸發**。在 v2.1.160 之前,觸發關鍵字是 `workflow` | `false` |

326| `wslInheritsWindowsSettings` | (Windows managed 設定僅限)當為 `true` 時,WSL 上的 Claude Code 除了 `/etc/claude-code` 外還會從 Windows 政策鏈讀取 managed 設定,Windows 來源優先。僅在 HKLM 登錄機碼或 `C:\Program Files\ClaudeCode\managed-settings.json` 中設定時受尊重,兩者都需要 Windows 管理員才能寫入。為了讓 HKCU 政策也在 WSL 上適用,旗標必須另外在 HKCU 本身中設定。對原生 Windows 無效 | `true` |325| `wslInheritsWindowsSettings` | (Windows managed 設定僅限)當為 `true` 時,WSL 上的 Claude Code 除了 `/etc/claude-code` 外還會從 Windows 政策鏈讀取 managed 設定,Windows 來源優先。僅在 HKLM 登錄機碼或 `C:\Program Files\ClaudeCode\managed-settings.json` 中設定時受尊重,兩者都需要 Windows 管理員才能寫入。為了讓 HKCU 政策也在 WSL 上適用,旗標必須另外在 HKCU 本身中設定。對原生 Windows 無效 | `true` |

327 326 

328<h3 id="global-config-settings">327<h3 id="global-config-settings">


336</Note>335</Note>

337 336 

338| 金鑰 | 說明 | 範例 |337| 金鑰 | 說明 | 範例 |

339| :------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------- |338| :------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------- |

340| `autoConnectIde` | 當 Claude Code 從外部終端機啟動時自動連線到執行中的 IDE。預設:`false`。在 VS Code 或 JetBrains 終端機外執行時在 `/config` 中顯示為**自動連線到 IDE(外部終端機)**。[`CLAUDE_CODE_AUTO_CONNECT_IDE`](/zh-TW/env-vars) 環境變數在設定時會覆蓋此設定 | `true` |339| `autoConnectIde` | **預設**:`false`。當 Claude Code 從外部終端機啟動時自動連線到執行中的 IDE。在 VS Code 或 JetBrains 終端機外執行時在 `/config` 中顯示為**自動連線到 IDE(外部終端機)**。[`CLAUDE_CODE_AUTO_CONNECT_IDE`](/zh-TW/env-vars) 環境變數在設定時會覆蓋此設定 | `true` |

341| `autoInstallIdeExtension` | 從 VS Code 終端機執行時自動安裝 Claude Code IDE 擴充功能。預設:`true`。在 VS Code 或 JetBrains 終端機內執行時在 `/config` 中顯示為**自動安裝 IDE 擴充功能**。您也可以設定 [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/zh-TW/env-vars) 環境變數 | `false` |340| `autoInstallIdeExtension` | **預設**:`true`。從 VS Code 終端機執行時自動安裝 Claude Code IDE 擴充功能。在 VS Code 或 JetBrains 終端機內執行時在 `/config` 中顯示為**自動安裝 IDE 擴充功能**。您也可以設定 [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/zh-TW/env-vars) 環境變數 | `false` |

342| `externalEditorContext` | 當您使用 `Ctrl+G` 開啟外部編輯器時,將 Claude 的前一個回應作為 `#` 註解內容前置。預設:`false`。在 `/config` 中顯示為**在外部編輯器中顯示最後回應** | `true` |341| `externalEditorContext` | **預設**:`false`。當您使用 `Ctrl+G` 開啟外部編輯器時,將 Claude 的前一個回應作為 `#` 註解內容前置。在 `/config` 中顯示為**在外部編輯器中顯示最後回應** | `true` |

343| `teammateDefaultModel` | [agent team](/zh-TW/agent-teams) 隊友在生成提示未指定時的預設模型。設定為模型別名(例如 `"sonnet"`),或 `null` 以繼承主管的目前 `/model` 選擇。在 `/config` 中顯示為**預設隊友模型** | `"sonnet"` |342| `teammateDefaultModel` | [agent team](/zh-TW/agent-teams) 隊友在生成提示未指定時的預設模型。設定為模型別名(例如 `"sonnet"`),或 `null` 以繼承主管的目前 `/model` 選擇。在 `/config` 中顯示為**預設隊友模型** | `"sonnet"` |

344 343 

345<h3 id="worktree-settings">344<h3 id="worktree-settings">

sub-agents.md +1 −8

Details

24 24 

25Claude 使用每個 subagent 的描述來決定何時委派任務。當您建立 subagent 時,請寫一個清晰的描述,以便 Claude 知道何時使用它。25Claude 使用每個 subagent 的描述來決定何時委派任務。當您建立 subagent 時,請寫一個清晰的描述,以便 Claude 知道何時使用它。

26 26 

27Claude Code 包括幾個內建 subagents,如 **Explore**、**Plan** 和 **general-purpose**。您也可以建立自訂 subagents 來處理特定任務。本頁涵蓋:27Claude Code 包括幾個內建 subagents,如 **Explore**、**Plan** 和 **general-purpose**。您也可以建立自訂 subagents 來處理特定任務。

28 

29* [內建 subagents](#built-in-subagents)

30* [如何建立您自己的](#quickstart-create-your-first-subagent)

31* [完整配置選項](#configure-subagents)

32* [使用 subagents 的模式](#work-with-subagents)

33* [Forked subagents](#fork-the-current-conversation)

34* [範例 subagents](#example-subagents)

35 28 

36<h2 id="built-in-subagents">29<h2 id="built-in-subagents">

37 內建 subagents30 內建 subagents

Details

32| `Error loading shared library` | [您的系統的二進位變體錯誤](#linux-musl-or-glibc-binary-mismatch) |32| `Error loading shared library` | [您的系統的二進位變體錯誤](#linux-musl-or-glibc-binary-mismatch) |

33| `Illegal instruction` | [架構或 CPU 指令集不相符](#illegal-instruction) |33| `Illegal instruction` | [架構或 CPU 指令集不相符](#illegal-instruction) |

34| WSL 中的 `cannot execute binary file: Exec format error` | [WSL1 原生二進位回歸](#exec-format-error-on-wsl1) |34| WSL 中的 `cannot execute binary file: Exec format error` | [WSL1 原生二進位回歸](#exec-format-error-on-wsl1) |

35| PowerShell 安裝程式完成但找不到 `claude` 或顯示舊版本 | [重新啟動您的終端並驗證 PATH](#verify-your-path) |35| PowerShell 安裝程式完成但找不到 `claude` 或顯示舊版本 | [新增安裝目錄到您的 PATH](#verify-your-path),然後開啟新的終端 |

36| macOS 上的 `dyld: cannot load`、`dyld: Symbol not found` 或 `Abort trap` | [二進位不相容](#dyld-cannot-load-on-macos) |36| macOS 上的 `dyld: cannot load`、`dyld: Symbol not found` 或 `Abort trap` | [二進位不相容](#dyld-cannot-load-on-macos) |

37| `Invoke-Expression: Missing argument in parameter list` | [安裝指令碼傳回 HTML](#install-script-returns-html-instead-of-a-shell-script) |37| `Invoke-Expression: Missing argument in parameter list` | [安裝指令碼傳回 HTML](#install-script-returns-html-instead-of-a-shell-script) |

38| `App unavailable in region` | Claude Code 在您的國家/地區不可用。請參閱[支援的國家/地區](https://www.anthropic.com/supported-countries)。 |38| `App unavailable in region` | Claude Code 在您的國家/地區不可用。請參閱[支援的國家/地區](https://www.anthropic.com/supported-countries)。 |

workflows.md +0 −7

Details

16 16 

17當任務需要超過一個對話可以協調的代理數量時,或當您想將協調編成可以讀取和重新執行的指令碼時,請使用工作流程。範例包括程式碼庫範圍的錯誤掃描、500 個檔案遷移、需要相互交叉檢查來源的研究問題,以及值得從多個獨立角度起草的困難計畫,然後再提交給其中一個。17當任務需要超過一個對話可以協調的代理數量時,或當您想將協調編成可以讀取和重新執行的指令碼時,請使用工作流程。範例包括程式碼庫範圍的錯誤掃描、500 個檔案遷移、需要相互交叉檢查來源的研究問題,以及值得從多個獨立角度起草的困難計畫,然後再提交給其中一個。

18 18 

19本頁涵蓋如何:

20 

21* 決定[何時使用工作流程](#when-to-use-a-workflow)而不是子代理或技能

22* [執行捆綁的工作流程](#run-a-bundled-workflow)與 `/deep-research`

23* [讓 Claude 為您的任務編寫工作流程](#have-claude-write-a-workflow)並儲存它

24* 瞭解[工作流程如何執行](#how-a-workflow-runs)和[管理執行](#manage-runs)

25 

26<h2 id="when-to-use-a-workflow">19<h2 id="when-to-use-a-workflow">

27 何時使用工作流程20 何時使用工作流程

28</h2>21</h2>