Documentation 2026-05-12 22:57 UTC to 2026-05-13 23:01 UTC

24 24 

25## 選擇您的 API 提供者25## 選擇您的 API 提供者

26 26 

27Claude Code 透過多個 API 提供者之一連接到 Claude。您的選擇會影響計費、驗證和您繼承的合規狀況。27Claude Code 透過多個 API 提供者之一連接到 Claude。您的選擇會影響計費、驗證、您繼承的合規狀況，以及您的開發人員可以使用的 Claude Code 功能。

28 28 

29| 提供者 | 在以下情況下選擇此選項 |29| 提供者 | 在以下情況下選擇此選項 |

30| :---------------------------- | :----------------------------------------------------- |30| :---------------------------- | :----------------------------------------------------- |

34| Google Vertex AI | 您希望繼承現有的 GCP 合規控制和計費 |34| Google Vertex AI | 您希望繼承現有的 GCP 合規控制和計費 |

35| Microsoft Foundry | 您希望繼承現有的 Azure 合規控制和計費 |35| Microsoft Foundry | 您希望繼承現有的 Azure 合規控制和計費 |

36 36 

37某些 Claude Code 功能需要 Claude.ai 帳戶。[Claude Code on the web](/zh-TW/claude-code-on-the-web)、[Routines](/zh-TW/routines)、[Code Review](/zh-TW/code-review)、[Remote Control](/zh-TW/remote-control) 和 [Chrome extension](/zh-TW/chrome) 無法透過 Console API 金鑰或雲端提供者認證單獨使用。如果您透過 Bedrock、Vertex 或 Foundry 部署，請規劃開發人員是否也需要 Claude for Teams 或 Enterprise 座位。每個功能頁面都列出其計畫要求。

38 

37有關涵蓋驗證、區域和功能奇偶性的完整提供者比較，請參閱 [企業部署概述](/zh-TW/third-party-integrations)。每個提供者的驗證設定位於 [Authentication](/zh-TW/authentication)。39有關涵蓋驗證、區域和功能奇偶性的完整提供者比較，請參閱 [企業部署概述](/zh-TW/third-party-integrations)。每個提供者的驗證設定位於 [Authentication](/zh-TW/authentication)。

38 40 

39無論提供者如何，[網路配置](/zh-TW/network-config) 中的代理和防火牆要求都適用。如果您想要在多個提供者前面有單一端點或集中式請求日誌記錄，請參閱 [LLM gateway](/zh-TW/llm-gateway)。41無論提供者如何，[網路配置](/zh-TW/network-config) 中的代理和防火牆要求都適用。如果您想要在多個提供者前面有單一端點或集中式請求日誌記錄，請參閱 [LLM gateway](/zh-TW/llm-gateway)。

68每個來源都會從特定位置載入設定，其中 `<cwd>` 是您透過 `cwd` 選項傳遞的工作目錄，或如果未設定則為程序的目前目錄。如需完整的型別定義，請參閱 [`SettingSource`](/zh-TW/agent-sdk/typescript#settingsource)（TypeScript）或 [`SettingSource`](/zh-TW/agent-sdk/python#settingsource)（Python）。68每個來源都會從特定位置載入設定，其中 `<cwd>` 是您透過 `cwd` 選項傳遞的工作目錄，或如果未設定則為程序的目前目錄。如需完整的型別定義，請參閱 [`SettingSource`](/zh-TW/agent-sdk/typescript#settingsource)（TypeScript）或 [`SettingSource`](/zh-TW/agent-sdk/python#settingsource)（Python）。

69 69 

70| 來源 | 載入的內容 | 位置 |70| 來源 | 載入的內容 | 位置 |

71| :---------- | :---------------------------------------------------------------------- | :------------------------------------------------------------ |71| :---------- | :---------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------- |

72| `"project"` | 專案 CLAUDE.md、`.claude/rules/*.md`、專案 skills、專案 hooks、專案 `settings.json` | `<cwd>/.claude/` 以及每個父目錄直到檔案系統根目錄（當找到 `.claude/` 或沒有更多父目錄時停止） |72| `"project"` | 專案 CLAUDE.md、`.claude/rules/*.md`、專案 skills、專案 hooks、專案 `settings.json` | `<cwd>/.claude/` 用於 `settings.json` 和 hooks；`<cwd>` 和每個父目錄用於 CLAUDE.md 和 rules；`<cwd>` 和每個父目錄直到儲存庫根目錄用於 skills |

73| `"user"` | 使用者 CLAUDE.md、`~/.claude/rules/*.md`、使用者 skills、使用者設定 | `~/.claude/` |73| `"user"` | 使用者 CLAUDE.md、`~/.claude/rules/*.md`、使用者 skills、使用者設定 | `~/.claude/` |

74| `"local"` | CLAUDE.local.md（gitignored）、`.claude/settings.local.json` | `<cwd>/` |74| `"local"` | CLAUDE.local.md、`.claude/settings.local.json` | `<cwd>/.claude/` 用於 `settings.local.json`；`<cwd>` 和每個父目錄用於 CLAUDE.local.md |

75 75 

76省略 `settingSources` 等同於 `["user", "project", "local"]`。76省略 `settingSources` 等同於 `["user", "project", "local"]`。

77 77 

78`cwd` 選項決定 SDK 在何處尋找專案設定。如果 `cwd` 及其任何父目錄都不包含 `.claude/` 資料夾，則專案層級功能將不會載入。78`cwd` 選項決定 SDK 在何處尋找專案層級輸入。CLAUDE.md 和 rules 從 `<cwd>` 和每個父目錄載入。Skills 從 `<cwd>` 和每個父目錄直到儲存庫根目錄載入。專案 `settings.json` 和 hooks 僅從 `<cwd>/.claude/` 載入，沒有父目錄回退。

79 79 

80### settingSources 不控制的內容80### settingSources 不控制的內容

81 81 

88| `~/.claude/projects/<project>/memory/` 的自動記憶體 | 預設載入到系統提示中 | 在設定中設定 `autoMemoryEnabled: false`，或在 `env` 中設定 `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` |88| `~/.claude/projects/<project>/memory/` 的自動記憶體 | 預設載入到系統提示中 | 在設定中設定 `autoMemoryEnabled: false`，或在 `env` 中設定 `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` |

89 89 

90<Warning>90<Warning>

91 不要依賴預設 `query()` 選項進行多租戶隔離。因為上述輸入無論 `settingSources` 如何都會被讀取，SDK 程序可能會拾取主機層級設定和每個目錄的記憶體。對於多租戶部署，在其自己的檔案系統中執行每個租戶，並在 `env` 中設定 `settingSources: []` 加上 `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1`。請參閱 [安全部署](/zh-TW/agent-sdk/secure-deployment)。91 不要依賴預設 `query()` 選項進行多租戶隔離。因為上述輸入無論 `settingSources` 如何都會被讀取，SDK 程序可能會拾取主機層級設定和每個目錄的記憶體。對於多租戶部署，在其自己的檔案系統中執行每個租戶，並設定 `settingSources: []` 加上在 `env` 中設定 `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1`。請參閱 [安全部署](/zh-TW/agent-sdk/secure-deployment)。

92</Warning>92</Warning>

93 93 

94## 專案指令（CLAUDE.md 和規則）94## 專案指令（CLAUDE.md 和規則）

98### CLAUDE.md 載入位置98### CLAUDE.md 載入位置

99 99 

100| 層級 | 位置 | 何時載入 |100| 層級 | 位置 | 何時載入 |

101| :------------- | :-------------------------------------------- | :------------------------------------------------ |101| :------ | :-------------------------------------------------------- | :------------------------------------------------ |

102| 專案（根目錄） | `<cwd>/CLAUDE.md` 或 `<cwd>/.claude/CLAUDE.md` | `settingSources` 包含 `"project"` |102| 專案（根目錄） | `<cwd>/CLAUDE.md` 或 `<cwd>/.claude/CLAUDE.md` | `settingSources` 包含 `"project"` |

103| 專案規則 | `<cwd>/.claude/rules/*.md` | `settingSources` 包含 `"project"` |103| 專案規則 | `<cwd>/.claude/rules/*.md` 和 `.claude/rules/*.md` 在每個父目錄中 | `settingSources` 包含 `"project"` |

104| 專案（父目錄） | `cwd` 上方目錄中的 `CLAUDE.md` 檔案 | `settingSources` 包含 `"project"`，在工作階段開始時載入 |104| 專案（父目錄） | `cwd` 上方目錄中的 `CLAUDE.md` 檔案 | `settingSources` 包含 `"project"`，在工作階段開始時載入 |

105| 專案（子目錄） | `cwd` 子目錄中的 `CLAUDE.md` 檔案 | `settingSources` 包含 `"project"`，當代理讀取該子樹中的檔案時按需載入 |105| 專案（子目錄） | `cwd` 子目錄中的 `CLAUDE.md` 檔案 | `settingSources` 包含 `"project"`，當代理讀取該子樹中的檔案時按需載入 |

106| 本機（gitignored） | `<cwd>/CLAUDE.local.md` | `settingSources` 包含 `"local"` |106| 本機 | `<cwd>/CLAUDE.local.md` 和 `CLAUDE.local.md` 在每個父目錄中 | `settingSources` 包含 `"local"` |

107| 使用者 | `~/.claude/CLAUDE.md` | `settingSources` 包含 `"user"` |107| 使用者 | `~/.claude/CLAUDE.md` | `settingSources` 包含 `"user"` |

108| 使用者規則 | `~/.claude/rules/*.md` | `settingSources` 包含 `"user"` |108| 使用者規則 | `~/.claude/rules/*.md` | `settingSources` 包含 `"user"` |

109 109 

108 108 

109#### 建立輸出樣式109#### 建立輸出樣式

110 110 

111輸出樣式是一個 markdown 檔案，其 frontmatter 中有 `name` 和 `description`，後面跟著提示詞內容。將其儲存到 `~/.claude/output-styles/` 以獲得在每個專案中可用的使用者級樣式，或儲存到您的儲存庫中的 `.claude/output-styles/` 以獲得可以提交並與您的團隊共享的專案級樣式。111輸出樣式是一個 markdown 檔案，其 [frontmatter](/zh-TW/output-styles#frontmatter) 中有中繼資料，後面跟著提示詞內容。將其儲存到 `~/.claude/output-styles/` 以獲得在每個專案中可用的使用者級樣式，或儲存到您的儲存庫中的 `.claude/output-styles/` 以獲得可以提交並與您的團隊共享的專案級樣式。

112 112 

113下面的範例定義了程式碼審查角色。將其儲存為 `~/.claude/output-styles/code-reviewer.md` 以在專案中提供：113預設情況下，自訂輸出樣式會用您自己的指令替換 `claude_code` 預設值的軟體工程指令。要保留它們並在其上分層您的指令，請在 frontmatter 中設定 `keep-coding-instructions: true`。當您的代理程式仍在進行軟體工程工作時保留它們。當您完全替換角色時省略它們。

114 

115下面的範例定義了程式碼審查角色，該角色保留編碼指令，因為審查程式碼仍然受益於 Claude Code 的安全性和程式碼品質指導。將其儲存為 `~/.claude/output-styles/code-reviewer.md` 以在專案中提供：

114 116 

115```markdown ~/.claude/output-styles/code-reviewer.md theme={null}117```markdown ~/.claude/output-styles/code-reviewer.md theme={null}

116---118---

117name: Code Reviewer119name: Code Reviewer

118description: Thorough code review assistant120description: Thorough code review assistant

121keep-coding-instructions: true

119---122---

120 123 

121You are an expert code reviewer.124You are an expert code reviewer.

306| **預設工具** | 保留 | 保留 | 保留 | 遺失（除非包含） |309| **預設工具** | 保留 | 保留 | 保留 | 遺失（除非包含） |

307| **內建安全** | 維持 | 維持 | 維持 | 必須新增 |310| **內建安全** | 維持 | 維持 | 維持 | 必須新增 |

308| **環境上下文** | 自動 | 自動 | 自動 | 必須提供 |311| **環境上下文** | 自動 | 自動 | 自動 | 必須提供 |

309| **自訂程度** | 僅新增 | 替換預設 | 僅新增 | 完全控制 |312| **自訂程度** | 僅新增 | 替換或擴展預設 | 僅新增 | 完全控制 |

310| **版本控制** | 與專案一起 | 是 | 與程式碼一起 | 與程式碼一起 |313| **版本控制** | 與專案一起 | 是 | 與程式碼一起 | 與程式碼一起 |

311| **範圍** | 專案特定 | 使用者或專案 | 程式碼會話 | 程式碼會話 |314| **範圍** | 專案特定 | 使用者或專案 | 程式碼會話 | 程式碼會話 |

312 315 

7> 使用 Claude Code 作為程式庫構建生產級 AI 代理7> 使用 Claude Code 作為程式庫構建生產級 AI 代理

8 8 

9<Note>9<Note>

10 Claude Code SDK 已重新命名為 Claude Agent SDK。如果您正在從舊 SDK 遷移，請參閱[遷移指南](/zh-TW/agent-sdk/migration-guide)。10 Starting June 15, 2026, Agent SDK and `claude -p` usage on subscription plans will draw from a new monthly Agent SDK credit, separate from your interactive usage limits. See [Use the Claude Agent SDK with your Claude plan](https://support.claude.com/en/articles/15036540-use-the-claude-agent-sdk-with-your-claude-plan) for details.

11</Note>11</Note>

12 12 

13構建能夠自主讀取檔案、執行命令、搜尋網路、編輯程式碼等的 AI 代理。Agent SDK 提供與 Claude Code 相同的工具、代理迴圈和上下文管理，可在 Python 和 TypeScript 中進行程式設計。13構建能夠自主讀取檔案、執行命令、搜尋網路、編輯程式碼等的 AI 代理。Agent SDK 提供與 Claude Code 相同的工具、代理迴圈和上下文管理，可在 Python 和 TypeScript 中進行程式設計。

14 14 

15<Note>

16 Opus 4.7 (`claude-opus-4-7`) 需要 Agent SDK v0.2.111 或更高版本。如果您看到 `thinking.type.enabled` API 錯誤，請參閱[故障排除](/zh-TW/agent-sdk/quickstart#troubleshooting)。

17</Note>

18 

19<CodeGroup>15<CodeGroup>

20 ```python Python theme={null}16 ```python Python theme={null}

21 import asyncio17 import asyncio

25與子代理不同（可以以編程方式定義），Skills 必須創建為文件系統工件。SDK 不提供用於註冊 Skills 的編程 API。25與子代理不同（可以以編程方式定義），Skills 必須創建為文件系統工件。SDK 不提供用於註冊 Skills 的編程 API。

26 26 

27<Note>27<Note>

28 Skills 通過文件系統設置源發現。使用默認 `query()` 選項時，SDK 加載用戶和項目源，因此 `~/.claude/skills/` 和 `<cwd>/.claude/skills/` 中的 Skills 可用。如果您明確設置 `settingSources`，請包含 `'user'` 或 `'project'` 以保持 Skill 發現，或使用 [`plugins` 選項](/zh-TW/agent-sdk/plugins) 從特定路徑加載 Skills。28 Skills 通過文件系統設置源發現。使用默認 `query()` 選項時，SDK 加載用戶和項目源，因此 `~/.claude/skills/`、`<cwd>/.claude/skills/` 和 `<cwd>` 的任何父目錄（直到存儲庫根目錄）中的 `.claude/skills/` 中的 Skills 可用。如果您明確設置 `settingSources`，請包含 `'user'` 或 `'project'` 以保持 Skill 發現，或使用 [`plugins` 選項](/zh-TW/agent-sdk/plugins) 從特定路徑加載 Skills。

29</Note>29</Note>

30 30 

31## 在 SDK 中使用 Skills31## 在 SDK 中使用 Skills

253 253 

254有關 `settingSources`/`setting_sources` 的更多詳細信息，請參閱 [TypeScript SDK 參考](/zh-TW/agent-sdk/typescript#settingsource) 或 [Python SDK 參考](/zh-TW/agent-sdk/python#settingsource)。254有關 `settingSources`/`setting_sources` 的更多詳細信息，請參閱 [TypeScript SDK 參考](/zh-TW/agent-sdk/typescript#settingsource) 或 [Python SDK 參考](/zh-TW/agent-sdk/python#settingsource)。

255 255 

256**檢查工作目錄**：SDK 相對於 `cwd` 選項加載 Skills。確保它指向包含 `.claude/skills/` 的目錄：256**檢查工作目錄**：SDK 從 `cwd` 選項中的 `.claude/skills/` 以及每個父目錄直到存儲庫根目錄加載 Skills。確保 `cwd` 指向包含 `.claude/skills/` 的目錄或其下方，在同一存儲庫內：

257 257 

258<CodeGroup>258<CodeGroup>

259 ```python Python theme={null}259 ```python Python theme={null}

260 # Ensure your cwd points to the directory containing .claude/skills/260 # Ensure your cwd points to the directory containing .claude/skills/

261 options = ClaudeAgentOptions(261 options = ClaudeAgentOptions(

262 cwd="/path/to/project", # Must contain .claude/skills/262 cwd="/path/to/project", # .claude/skills/ here or in a parent directory

263 setting_sources=["user", "project"], # Loads skills from these sources263 setting_sources=["user", "project"], # Loads skills from these sources

264 skills="all",264 skills="all",

265 )265 )

268 ```typescript TypeScript theme={null}268 ```typescript TypeScript theme={null}

269 // Ensure your cwd points to the directory containing .claude/skills/269 // Ensure your cwd points to the directory containing .claude/skills/

270 const options = {270 const options = {

271 cwd: "/path/to/project", // Must contain .claude/skills/271 cwd: "/path/to/project", // .claude/skills/ here or in a parent directory

272 settingSources: ["user", "project"], // Loads skills from these sources272 settingSources: ["user", "project"], // Loads skills from these sources

273 skills: "all"273 skills: "all"

274 };274 };

275 ```275 ```

276</CodeGroup>276</CodeGroup>

277 277 

278有關完整模式，請參閱上面的"在 SDK 中使用 Skills"部分。278有關完整模式，請參閱上面的「在 SDK 中使用 Skills」部分。

279 279 

280**驗證文件系統位置**：280**驗證文件系統位置**：

281 281 

1841 1841 

1842創建和管理結構化任務列表以跟蹤進度。1842創建和管理結構化任務列表以跟蹤進度。

1843 1843 

1844<Note>

1845 `TodoWrite` 已棄用，將在未來版本中移除。改用 `TaskCreate`、`TaskGet`、`TaskUpdate` 和 `TaskList`。設置 `CLAUDE_CODE_ENABLE_TASKS=1` 以選擇加入。見 [遷移到 Task 工具](/zh-TW/agent-sdk/todo-tracking#migrate-to-task-tools) 了解如何監視代碼更改。

1846</Note>

1847 

1848### TaskCreate

1849 

1850**工具名稱：** `TaskCreate`

1851 

1852```typescript theme={null}

1853// 尚未從 SDK 導出；在本地定義。

1854type TaskCreateInput = {

1855 subject: string;

1856 description: string;

1857 activeForm?: string;

1858 metadata?: Record<string, unknown>;

1859};

1860```

1861 

1862創建單個任務並返回其分配的 ID。

1863 

1864### TaskUpdate

1865 

1866**工具名稱：** `TaskUpdate`

1867 

1868```typescript theme={null}

1869// 尚未從 SDK 導出；在本地定義。

1870type TaskUpdateInput = {

1871 taskId: string;

1872 status?: "pending" | "in_progress" | "completed" | "deleted";

1873 subject?: string;

1874 description?: string;

1875 activeForm?: string;

1876 addBlocks?: string[];

1877 addBlockedBy?: string[];

1878 owner?: string;

1879 metadata?: Record<string, unknown>;

1880};

1881```

1882 

1883按 ID 修補一個任務。將 `status` 設置為 `"deleted"` 以移除它。

1884 

1885### TaskGet

1886 

1887**工具名稱：** `TaskGet`

1888 

1889```typescript theme={null}

1890// 尚未從 SDK 導出；在本地定義。

1891type TaskGetInput = {

1892 taskId: string;

1893};

1894```

1895 

1896返回一個任務的完整詳情，或在找不到 ID 時返回 `null`。

1897 

1898### TaskList

1899 

1900**工具名稱：** `TaskList`

1901 

1902```typescript theme={null}

1903// 尚未從 SDK 導出；在本地定義。

1904type TaskListInput = {};

1905```

1906 

1907返回當前列表中所有任務的快照。

1908 

1844### ExitPlanMode1909### ExitPlanMode

1845 1910 

1846**工具名稱：** `ExitPlanMode`1911**工具名稱：** `ExitPlanMode`

2273 2338 

2274返回之前和更新的任務列表。2339返回之前和更新的任務列表。

2275 2340 

2341<Note>

2342 `TodoWrite` 已棄用，將在未來版本中移除。改用 `TaskCreate`、`TaskGet`、`TaskUpdate` 和 `TaskList`。設置 `CLAUDE_CODE_ENABLE_TASKS=1` 以選擇加入。請參閱[遷移到 Task 工具](/zh-TW/agent-sdk/todo-tracking#migrate-to-task-tools)以了解如何監視代碼更改。

2343</Note>

2344 

2345### TaskCreate

2346 

2347**工具名稱：** `TaskCreate`

2348 

2349```typescript theme={null}

2350// Not yet exported from the SDK; define locally.

2351type TaskCreateOutput = {

2352 task: {

2353 id: string;

2354 subject: string;

2355 };

2356};

2357```

2358 

2359返回創建的任務及其分配的 ID。

2360 

2361### TaskUpdate

2362 

2363**工具名稱：** `TaskUpdate`

2364 

2365```typescript theme={null}

2366// Not yet exported from the SDK; define locally.

2367type TaskUpdateOutput = {

2368 success: boolean;

2369 taskId: string;

2370 updatedFields: string[];

2371 error?: string;

2372 statusChange?: {

2373 from: string;

2374 to: string;

2375 };

2376};

2377```

2378 

2379返回更新結果，包括哪些字段已更改。

2380 

2381### TaskGet

2382 

2383**工具名稱：** `TaskGet`

2384 

2385```typescript theme={null}

2386// Not yet exported from the SDK; define locally.

2387type TaskGetOutput = {

2388 task: {

2389 id: string;

2390 subject: string;

2391 description: string;

2392 status: "pending" | "in_progress" | "completed";

2393 blocks: string[];

2394 blockedBy: string[];

2395 } | null;

2396};

2397```

2398 

2399返回完整的任務記錄，或在找不到 ID 時返回 `null`。

2400 

2401### TaskList

2402 

2403**工具名稱：** `TaskList`

2404 

2405```typescript theme={null}

2406// Not yet exported from the SDK; define locally.

2407type TaskListOutput = {

2408 tasks: Array<{

2409 id: string;

2410 subject: string;

2411 status: "pending" | "in_progress" | "completed";

2412 owner?: string;

2413 blockedBy: string[];

2414 }>;

2415};

2416```

2417 

2418返回當前列表中所有任務的快照。

2419 

2276### ExitPlanMode2420### ExitPlanMode

2277 2421 

2278**工具名稱：** `ExitPlanMode`2422**工具名稱：** `ExitPlanMode`

6 6 

7> 從一個螢幕分派和管理許多 Claude Code 工作階段。Agent view 顯示每個工作階段正在做什麼，以及哪些需要您的輸入。7> 從一個螢幕分派和管理許多 Claude Code 工作階段。Agent view 顯示每個工作階段正在做什麼，以及哪些需要您的輸入。

8 8 

9Agent view（使用 `claude agents` 開啟）是所有背景工作階段的一個螢幕：什麼正在執行、什麼需要您的輸入，以及什麼已完成。分派新工作階段，一目瞭然地查看它們的狀態，而不是滾動瀏覽記錄，並且只在需要時才介入。工作階段在沒有終端連接的情況下在背景中繼續執行。9Agent view（使用 `claude agents` 開啟）是所有背景工作階段的一個螢幕：什麼正在執行、什麼需要您的輸入，以及什麼已完成。分派新工作階段，一目瞭然地查看它們的狀態，而不是滾動瀏覽記錄，並且只在需要時才介入。每個背景工作階段都是一個完整的 Claude Code 對話，在沒有終端連接的情況下持續執行，因此您可以隨時開啟、回覆和離開。

10 10 

11當您有多個獨立任務 Claude 可以同時處理時，請使用 agent view，例如修復錯誤、審查拉取請求或調查日誌。當您想一起解決問題時，附加到工作階段並像往常一樣以互動方式使用 Claude Code。工作階段在 agent view 中獨立執行，並且只向您報告。若要與 subagents、agent teams 和 worktrees 進行比較，請參閱 [平行執行代理](/zh-TW/agents)。11<img src="https://mintcdn.com/claude-code/1B48Qz2Z9hac4SLG/images/agent-view-light.png?fit=max&auto=format&n=1B48Qz2Z9hac4SLG&q=85&s=7a186c96ed47d6700d084d77e786be65" className="dark:hidden" alt="終端中的 Agent view：標題顯示 Claude Code v2.1.140、模型、工作目錄和摘要計數。工作階段分組在'需要輸入'、'執行中'和'已完成'下，底部有分派輸入，頁尾有快捷鍵提示。" width="1772" height="780" data-path="images/agent-view-light.png" />

12 

13<img src="https://mintcdn.com/claude-code/1B48Qz2Z9hac4SLG/images/agent-view-dark.png?fit=max&auto=format&n=1B48Qz2Z9hac4SLG&q=85&s=a5bed7434bae368faea3a8f023b52aa2" className="hidden dark:block" alt="終端中的 Agent view：標題顯示 Claude Code v2.1.140、模型、工作目錄和摘要計數。工作階段分組在'需要輸入'、'執行中'和'已完成'下，底部有分派輸入，頁尾有快捷鍵提示。" width="1772" height="780" data-path="images/agent-view-dark.png" />

14 

15當您有多個獨立任務 Claude 可以在不需要您監看每一步的情況下執行時，請使用 agent view。分派一個錯誤修復、一個拉取請求審查和一個不穩定測試調查作為三行，在另一個視窗中繼續工作，並在某一行顯示需要您或有結果時檢查。

16 

17當您想在任何代理的工作階段中更直接地工作時，附加到該行以進入完整對話。

18 

19若要比較 agent view 與 subagents、agent teams 和 worktrees，請參閱 [平行執行代理](/zh-TW/agents)。

12 20 

13<Note>21<Note>

14 Agent view 是研究預覽版本，需要 Claude Code v2.1.139 或更新版本。使用 `claude --version` 檢查您的版本。隨著功能的發展，介面和快捷鍵可能會改變，管理員可以使用 [`disableAgentView`](#how-background-sessions-are-hosted) 受管設定為組織禁用 agent view。22 Agent view 是研究預覽版本，需要 Claude Code v2.1.139 或更新版本。使用 `claude --version` 檢查您的版本。隨著功能的發展，介面和快捷鍵可能會改變。

15</Note>23</Note>

16 24 

17本頁涵蓋：25本頁涵蓋：

18 26 

19* [快速開始](#quick-start)27* [快速開始](#quick-start)：給 Claude 一個在背景中執行的任務，檢查它，並在需要時介入

20* [使用 agent view 監控工作階段](#monitor-sessions-with-agent-view)，包括狀態圖示、查看和回覆、附加、組織和快捷鍵28* [使用 agent view 監控工作階段](#monitor-sessions-with-agent-view)，包括狀態圖示、查看和回覆、附加、組織和快捷鍵

21* [分派新代理](#dispatch-new-agents)，從 agent view、從工作階段內部或從 shell29* [分派新代理](#dispatch-new-agents)，從 agent view、從工作階段內部或從 shell

22* [從 shell 管理工作階段](#manage-sessions-from-the-shell)30* [從 shell 管理工作階段](#manage-sessions-from-the-shell)

24 32 

25## 快速開始33## 快速開始

26 34 

27本逐步解說開啟 agent view、分派工作階段、從查看面板回覆，以及附加到完整對話。35本逐步解說涵蓋核心 agent view 迴圈：分派工作、觀看其列更新（Claude 正在工作）、查看以檢查並回覆，以及附加到完整對話。您分派的工作階段在關閉 agent view 後會繼續執行，因此您可以離開並稍後返回。

28 36 

29<Steps>37<Steps>

30 <Step title="開啟 agent view">38 <Step title="開啟 agent view">

34 claude agents42 claude agents

35 ```43 ```

36 44 

37 Agent view 開啟，底部有輸入框，隨著工作階段啟動，表格會填入。隨時按 `Esc` 退出。您的工作階段繼續執行。45 Agent view 開啟，底部有輸入框，隨著工作階段啟動，表格會填入。隨時按 `Esc` 返回您的 shell。您的工作階段在您離開時繼續執行，下次開啟 agent view 時會重新出現。

38 </Step>46 </Step>

39 47 

40 <Step title="分派工作階段">48 <Step title="分派工作階段">

41 在輸入框中輸入提示，然後按 `Enter`。新工作階段啟動並顯示為一行，顯示它是否正在工作、等待您或已完成。重複此操作以並行執行任意數量的工作階段。每個工作階段獨立使用您的訂閱配額，因此在一次分派許多工作階段之前，請參閱[限制](#limitations)。49 輸入描述工作的提示並按 `Enter`。新的背景工作階段在該工作上啟動並顯示為一列，顯示它是否正在工作、等待您或已完成。新工作階段使用 agent view 標題中顯示的模型和在該目錄中執行 `claude` 時會獲得的相同[權限模式](#permission-mode-and-settings)。

50 

51 您在此輸入的每個提示都會啟動自己的新工作階段。輸入另一個提示並按 `Enter` 會在第一個工作階段旁邊啟動第二個工作階段，而不是向其發送後續訊息。您可以以這種方式並行執行多個工作階段。

52 

53 每個工作階段獨立使用您的訂閱配額，因此在一次分派許多工作階段之前，請參閱[限制](#limitations)。

42 </Step>54 </Step>

43 55 

44 <Step title="查看和回覆">56 <Step title="查看和回覆">

45 使用箭頭鍵選擇一行，然後按 `Space` 查看工作階段正在做什麼或需要您提供什麼。輸入回覆並按 `Enter` 發送，無需離開 agent view。57 使用箭頭鍵選擇一列，然後按 `Space` 開啟查看面板。它顯示工作階段的最新輸出或它正在等待的問題，而不是完整的文字記錄。輸入回覆並按 `Enter` 發送，無需離開 agent view。

46 </Step>58 </Step>

47 59 

48 <Step title="附加和分離">60 <Step title="附加和分離">

49 在一行上按 `Enter` 或 `→` 以在需要完整對話時附加。工作階段接管終端，就像您執行了 `claude` 一樣。在空提示上按 `←` 分離並返回表格。61 在一列上按 `Enter` 或 `→` 以在需要完整對話時附加。工作階段接管終端，就像您執行了 `claude` 一樣。在空提示上按 `←` 分離並返回表格。

50 </Step>62 </Step>

51</Steps>

52 63 

53要將現有互動工作階段帶入 agent view，在其中執行 `/bg`，或在空提示上按 `←` 以在一個步驟中背景化工作階段並開啟 agent view。工作階段在背景中繼續執行並顯示為一行。要直接從 shell 啟動新背景工作階段，執行 `claude --bg "<prompt>"`。64 <Step title="帶入現有工作階段">

65 要將您已開啟的工作階段移入 agent view，在其中執行 `/bg`，或在空提示上按 `←` 以在一個步驟中背景化工作階段並開啟 agent view。工作階段繼續執行並顯示為一列，與您分派的工作階段並排。

66 </Step>

67</Steps>

54 68 

55您可以使用 `claude agents` 作為主要進入點而不是 `claude`：從 agent view 分派每個任務，在需要完整對話時附加，然後按 `←` 返回表格。69您可以使用 `claude agents` 作為主要進入點而不是 `claude`：從 agent view 分派每個工作，在需要完整對話時附加，然後按 `←` 返回表格。

56 70 

57## 使用 agent view 監控工作階段71## 使用 agent view 監控工作階段

58 72 

59執行 `claude agents` 開啟 agent view。它接管整個終端並列出按狀態分組的每個工作階段，固定的工作階段和需要您的工作階段在頂部。每行顯示工作階段的名稱、當前活動和上次更改的時間。73執行 `claude agents` 開啟 agent view。它接管整個終端並列出按狀態分組的每個工作階段，固定的工作階段和需要您的工作階段在頂部。每行顯示工作階段的名稱、當前活動和上次更改的時間。

60 74 

61該列表涵蓋您的 [config 目錄](#how-background-sessions-are-hosted) 下的每個背景工作階段，無論它在哪個專案或 worktree 中工作，因此在一個儲存庫中啟動的工作階段和在不同 worktree 中啟動的另一個工作階段都會一起出現。您在其他終端中開啟的互動工作階段在您 [背景化它們](#from-inside-a-session) 之前不會出現，[subagents](/zh-TW/sub-agents) 在工作階段內執行時不會列為單獨的行。75該列表涵蓋您啟動的每個背景工作階段，跨越所有您的專案。在一個儲存庫中工作的工作階段和在不同 worktree 中工作的另一個工作階段都會出現在這裡，無論您從哪個目錄開啟 agent view。您在其他終端中開啟的互動工作階段在您 [背景化它們](#from-inside-a-session) 之前不會出現。[Subagents](/zh-TW/sub-agents) 和 [teammates](/zh-TW/agent-teams) 工作階段產生的不會列為單獨的行。

62 76 

63```text theme={null}77```text theme={null}

64Pinned78Pinned

65 ✽ clawd walk cycle Write assets/sprites/clawd-walk.png 3m79 ✽ clawd walk cycle Write assets/sprites/clawd-walk.png 3m

66 80 

67Ready for review81Ready for review

68 ∙ jump physics github.com/anthropics/example/pull/2048 ● 2h82 ∙ jump physics github.com/example/game/pull/2048 ● 2h

69 83 

70Needs input84Needs input

71 ✻ power-up design needs input: double jump or wall climb? 1m85 ✻ power-up design needs input: double jump or wall climb? 1m

80 … 6 more94 … 6 more

81```95```

82 96 

83每行的圖示傳達兩個信號。指示器告訴您工作階段的狀態，圖示的形狀告訴您底層程序是否仍在執行。狀態如下：97### 讀取工作階段狀態

98 

99每行開始的圖示，其顏色和動畫顯示工作階段的狀態：

84 100 

85| 指示器 | 狀態 | 含義 |101| 狀態 | 圖示顯示為 | 含義 |

86| :-- | :--- | :---------------------------------- |102| :--- | :---- | :---------------------------------- |

87| 動畫 | 工作中 | Claude 正在主動執行工具或生成回應 |103| 工作中 | 動畫 | Claude 正在主動執行工具或生成回應 |

88| 黃色 | 需要輸入 | Claude 正在等待您的輸入，通常是權限決定或答案 |104| 需要輸入 | 黃色 | Claude 正在等待您的特定問題或權限決定 |

89| 淡化 | 閒置 | 工作階段正在等待輸入，但不會被特定問題阻止 |105| 閒置 | 淡化 | 工作階段沒有事情要做，準備好接收您的下一個提示 |

90| 綠色 | 已完成 | 任務成功完成 |106| 已完成 | 綠色 | 任務成功完成 |

91| 紅色 | 失敗 | 任務以錯誤結束 |107| 失敗 | 紅色 | 任務以錯誤結束 |

92| 灰色 | 已停止 | 工作階段已使用 `Ctrl+X` 或 `claude stop` 停止 |108| 已停止 | 灰色 | 工作階段已使用 `Ctrl+X` 或 `claude stop` 停止 |

93 109 

94圖示的形狀告訴您底層程序是否仍在執行。`✻` 或在 Claude 工作時的動畫 `✽` 表示工作階段處於活動狀態，您可以立即回覆。`∙` 表示程序已退出，但您仍然可以查看、回覆或附加：Claude 從中斷的地方重新啟動工作階段。`✢` 是 [`/loop`](/zh-TW/commands) 工作階段在迭代之間休眠，行顯示其執行計數和下一次迭代的倒計時。110另外，圖示的形狀顯示底層程序是否正在執行：

95 111 

96背景工作階段不需要任何開啟的終端即可繼續工作。單獨的 [監督程序](#how-background-sessions-are-hosted) 執行它們，因此您可以關閉 agent view、關閉 shell 或啟動新的互動工作階段，您分派的工作會繼續進行。112| 形狀 | 含義 |

113| :---------- | :------------------------------------------------------------- |

114| `✻` 或動畫 `✽` | 工作階段程序處於活動狀態並立即回覆 |

115| `∙` | 程序已退出。您仍然可以查看、回覆或附加，Claude 從中斷的地方重新啟動 |

116| `✢` | 一個 [`/loop`](/zh-TW/scheduled-tasks) 工作階段在迭代之間休眠。該行顯示其執行計數和倒計時 |

97 117 

98工作階段在磁碟上持久化：關閉終端或自動更新不會丟失它們，重新開啟 `claude agents` 會顯示它們全部。如果您的機器進入睡眠或關閉，執行中的工作階段會停止；使用 `claude respawn --all` 重新啟動它們。118背景工作階段不需要任何開啟的終端即可繼續工作。單獨的 [監督程序](#the-supervisor-process) 執行它們，因此您可以關閉 agent view、關閉 shell 或啟動新的互動工作階段，您分派的工作會繼續進行。

99 119 

100每行中的單行摘要由您配置的 [Haiku-class 模型](/zh-TW/model-config) 生成，因此該行可以告訴您工作階段正在做什麼、需要什麼或生成了什麼，無需開啟記錄。當工作階段主動工作時，摘要最多每 15 秒刷新一次，加上每個回合結束時刷新一次。每次刷新都是通過您的正常提供者的一個簡短 Haiku-class 請求，按照與工作階段本身相同的 [資料使用條款](/zh-TW/data-usage) 計費和處理。120工作階段狀態通過自動更新和監督程序重新啟動在磁碟上持久化。如果您的機器進入睡眠或關閉，執行中的工作階段會停止；使用 `claude respawn --all` 重新啟動它們。

121 

122### 行摘要

123 

124每行中的單行摘要由 [Haiku-class 模型](/zh-TW/model-config) 生成，因此該行可以告訴您工作階段正在做什麼、需要什麼或生成了什麼，無需開啟記錄。當工作階段主動工作時，摘要最多每 15 秒刷新一次，加上每個回合結束時刷新一次。

125 

126每次刷新都是通過您的正常提供者的一個簡短 Haiku-class 請求，按照與工作階段本身相同的 [資料使用條款](/zh-TW/data-usage) 計費和處理。

127 

128### 拉取請求狀態

101 129 

102當工作階段開啟拉取請求時，狀態點會出現在該行的右邊緣，在支援超連結的終端中連結到拉取請求。當工作階段開啟了多個拉取請求時，計數會出現在點之前，顏色反映最需要關注的那個。130當工作階段開啟拉取請求時，狀態點會出現在該行的右邊緣，在支援超連結的終端中連結到拉取請求。當工作階段開啟了多個拉取請求時，計數會出現在點之前，顏色反映最需要關注的那個。

103 131 

120 148 

121### 附加到工作階段149### 附加到工作階段

122 150 

123在選定的行上按 `Enter` 或 `→` 附加，或按 `Alt+1` 到 `Alt+9` 直接附加到焦點組中的第 N 個工作階段。Agent view 被完整的互動工作階段替換，就像您在該目錄中執行了 `claude` 一樣。附加時，Claude 發佈您離開時發生的簡短回顧。151在選定的行上按 `Enter` 或 `→` 附加。Agent view 被完整的互動工作階段替換，就像您在該目錄中執行了 `claude` 一樣。附加時，Claude 發佈您離開時發生的簡短回顧。

124 152 

125附加時，工作階段的行為與任何其他 Claude Code 工作階段相同：每個 [命令](/zh-TW/commands)、快捷鍵和功能都有效。153附加時，工作階段的行為與任何其他 Claude Code 工作階段相同：每個 [命令](/zh-TW/commands)、快捷鍵和功能都有效。

126 154 

132 160 

133### 組織列表161### 組織列表

134 162 

135Agent view 按狀態分組工作階段，需要輸入的工作階段在工作或完成的工作階段上方。按 `Ctrl+S` 改為按目錄分組。您的選擇在執行中保存。在組內，使用 `Ctrl+T` 將工作階段固定到頂部，使用 `Shift+↑` 和 `Shift+↓` 重新排序，或在組標題上按 `Enter` 摺疊它。要移除工作階段，按 `Ctrl+X` 停止它，然後在兩秒內再次按 `Ctrl+X` 刪除它。在組標題上按 `Ctrl+X` 會在確認後刪除該組中的每個工作階段。163Agent view 按狀態分組工作階段，需要輸入的工作階段在頂部，`Ready for review` 和 `Needs input` 在 `Working` 和 `Completed` 上方。這些組名稱不與上面的 [狀態](#read-session-state) 一一對應：當工作階段有開啟的拉取請求時，它會移動到 `Ready for review`，`Completed` 收集已完成、失敗和已停止的工作階段。按 `Ctrl+S` 改為按目錄分組。您的選擇在執行中保存。

164 

165在組內：

136 166 

137較舊的已完成工作階段摺疊為「… N 更多」行以保持列表簡短。失敗和具有開啟拉取請求的工作階段始終保持可見。167* 按 `Ctrl+T` 將工作階段固定到頂部

168* 按 `Shift+↑` 或 `Shift+↓` 重新排序工作階段

169* 按 `Ctrl+R` 重命名工作階段

170* 在組標題上按 `Enter` 摺疊它

138 171 

139### 篩選列表172要移除工作階段，按 `Ctrl+X` 停止它，然後在兩秒內再次按 `Ctrl+X` 刪除它。在組標題上按 `Ctrl+X` 會在確認後刪除該組中的每個工作階段。

173 

174刪除會從 agent view 中移除工作階段並清理其 [worktree](#how-file-edits-are-isolated)，包括其中的任何未提交的更改，因此在刪除前推送或提交您想保留的工作。對話記錄保留在磁碟上，並通過 `claude --resume` 保持可用。

175 

176較舊的已完成工作階段摺疊為 `… N more` 行以保持列表簡短。失敗和具有開啟拉取請求的工作階段始終保持可見。

177 

178### 篩選工作階段

140 179 

141在分派輸入中輸入以篩選而不是分派：180在分派輸入中輸入以篩選而不是分派：

142 181 

143| 篩選 | 顯示 |182| 篩選 | 顯示 |

144| :------------------- | :----------------------------------- |183| :------------------- | :----------------------------------------------------- |

145| `a:<name>` | 執行命名代理的工作階段 |184| `a:<name>` | 執行命名代理的工作階段 |

146| `s:<state>` | 給定狀態中的工作階段，例如 `s:blocked` 表示需要您的工作階段 |185| `s:<state>` | 給定狀態中的工作階段，例如 `s:working`。也接受 `s:blocked` 表示等待您的所有工作階段 |

147| `#<number>` 或 PR URL | 在該拉取請求上工作的工作階段 |186| `#<number>` 或 PR URL | 在該拉取請求上工作的工作階段 |

148 187 

149### 快捷鍵188### 快捷鍵

150 189 

151在 agent view 中按 `?` 查看每個快捷鍵。最常見的：190在 agent view 中按 `?` 查看每個快捷鍵。下表總結了它們。

152 191 

153| 快捷鍵 | 動作 |192| 快捷鍵 | 動作 |

154| :-------------------- | :------------------------ |193| :-------------------- | :------------------------------- |

155| `↑` / `↓` | 在行之間移動 |194| `↑` / `↓` | 在行之間移動 |

156| `Enter` | 附加到選定的工作階段，或如果輸入中有文字則分派 |195| `Enter` | 附加到選定的工作階段，或如果輸入中有文字則分派 |

157| `Space` | 開啟或關閉選定工作階段的查看面板 |196| `Space` | 開啟或關閉選定工作階段的查看面板 |

158| `Shift+Enter` | 分派並立即附加 |197| `Shift+Enter` | 分派並立即附加 |

159| `→` | 附加到選定的工作階段 |198| `→` | 附加到選定的工作階段 |

160| `Alt+1`..`Alt+9` | 附加到焦點組中的第 N 個工作階段 |199| `Alt+1`..`Alt+9` | 附加到當前組中的工作階段 1–9 |

161| `Tab` | 瀏覽所有 subagents，或應用突出顯示的建議 |200| `Tab` | 在空輸入上，瀏覽所有 subagents。否則應用突出顯示的建議 |

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

163| `Ctrl+T` | 固定或取消固定選定的工作階段 |202| `Ctrl+T` | 固定或取消固定選定的工作階段 |

164| `Ctrl+R` | 重命名選定的工作階段 |203| `Ctrl+R` | 重命名選定的工作階段 |

175 214 

176### 從 agent view215### 從 agent view

177 216 

178在 agent view 底部的輸入框中輸入提示，然後按 `Enter` 啟動新的背景工作階段。工作階段從提示自動命名。您稍後可以使用 `Ctrl+R` 重命名它。將圖像粘貼到提示中以包含螢幕截圖或圖表與任務。217在 agent view 底部的輸入框中輸入提示，然後按 `Enter` 啟動新的背景工作階段。工作階段從提示自動命名；稍後可以使用 `Ctrl+R` 重命名它。

218 

219將圖像粘貼到提示中以包含螢幕截圖或圖表與任務。

179 220 

180前綴或提及提示的部分以控制工作階段如何啟動：221前綴或提及提示的部分以控制工作階段如何啟動：

181 222 

188| `#<number>` 或拉取請求 URL | 如果工作階段已在該 PR 上工作，選擇它而不是分派 |229| `#<number>` 或拉取請求 URL | 如果工作階段已在該 PR 上工作，選擇它而不是分派 |

189| `Shift+Enter` | 分派並立即附加到新工作階段 |230| `Shift+Enter` | 分派並立即附加到新工作階段 |

190 231 

191輸入 `/` 分派 [skill](/zh-TW/skills)。將重複任務打包為 skill 可讓您從 agent view 多次啟動相同的工作流程，無需重新輸入提示。在空輸入上按 `Tab` 瀏覽每個可分派的 subagent，或在顯示建議時應用突出顯示的建議。232將重複任務打包為 [skill](/zh-TW/skills) 可讓您從 agent view 多次啟動相同的工作流程，無需重新輸入提示。

192 233 

193當相同的 `@name` 同時與 subagent 和同級存儲庫匹配時，subagent 優先。不帶 `@` 的第一個單詞形式也適用於任何 subagent 名稱，因此以與您的 subagent 名稱之一匹配的單詞開頭的提示會分派該 subagent。當您想要明確時，請使用 `@` 形式。234當相同的 `@name` 同時與 subagent 和同級存儲庫匹配時，subagent 優先。不帶 `@` 的第一個單詞形式也適用，因此以與您的 subagent 名稱之一匹配的單詞開頭的提示會分派該 subagent 而不是將該單詞視為純文本。當您想要明確時，請使用 `@` 形式，或以不同的單詞開頭提示以避免匹配。

194 235 

195#### 分派到特定目錄236#### 分派到特定目錄

196 237 

204 245 

205### 從工作階段內部246### 從工作階段內部

206 247 

207執行 `/background` 或其別名 `/bg` 分離當前對話並保持其執行。傳遞提示，例如 `/bg run the test suite and fix any failures`，在分離前發送一個額外的指令。248執行 `/background` 或其別名 `/bg` 將當前對話移動到背景工作階段。傳遞提示，例如 `/bg run the test suite and fix any failures`，在分派前發送一個額外的指令。

249 

250從互動工作階段背景化會啟動一個新的進程，該進程從保存的對話恢復，因此執行 subagents、[monitors](/zh-TW/tools-reference#monitor-tool) 和背景命令不會轉移到它。當任何正在執行時，Claude 會要求您在背景化前確認。進入背景後，工作階段可以啟動新的 subagents、monitors 和背景命令，這些命令在稍後分離和重新附加時保持執行。

208 251 

209### 從 shell252### 從 shell

210 253 

232 275 

233### 檔案編輯如何隔離276### 檔案編輯如何隔離

234 277 

235每個背景工作階段，無論是從 agent view、`/bg` 或 `claude --bg` 啟動，都在您的工作目錄中啟動，但被阻止在那裡寫入檔案。當工作階段需要編輯檔案時，Claude 會自動將其移動到 `.claude/worktrees/` 下的隔離 [git worktree](/zh-TW/worktrees) 中，因此並行工作階段可以讀取相同的檢出，但每個都寫入自己的。當工作階段已在 worktree 內、工作目錄不是 git 存儲庫或寫入工作目錄外時，該阻止不適用。278每個背景工作階段，無論是從 agent view、`/bg` 或 `claude --bg` 啟動，都在您的工作目錄中啟動。編輯檔案前，Claude 將工作階段移動到 `.claude/worktrees/` 下的隔離 [git worktree](/zh-TW/worktrees) 中，因此並行工作階段可以讀取相同的檢出，但每個都寫入自己的。當工作階段已在 `.claude/worktrees/` 下、工作目錄不是 git 存儲庫或寫入工作目錄外時，Claude 會跳過此操作。

279 

280在 git 存儲庫外，工作階段直接寫入工作目錄，彼此之間不隔離，因此避免分派編輯相同檔案的並行工作階段。

236 281 

237當您刪除工作階段時，worktree 被移除，因此在刪除前合併或推送您想保留的更改。要找到工作階段的 worktree 路徑，查看工作階段或附加並檢查其工作目錄。282當您刪除工作階段時，worktree 被移除，因此在刪除前合併或推送您想保留的更改。要找到工作階段的 worktree 路徑，查看工作階段或附加並檢查其工作目錄。

238 283 

239要使 subagent 始終在其自己的 worktree 中執行，無論如何啟動，請在其 frontmatter 中設定 [`isolation: worktree`](/zh-TW/sub-agents#supported-frontmatter-fields)。284要使 subagent 始終在其自己的 worktree 中執行，無論如何啟動，請在其 frontmatter 中設定 [`isolation: worktree`](/zh-TW/sub-agents#supported-frontmatter-fields)。

240 285 

286### 設定模型

287 

288agent view 標題中顯示的模型名稱是分派預設值。您從輸入啟動的新工作階段使用此模型，這與 [`/model`](/zh-TW/model-config) 在任何工作階段中控制的設定相同。

289 

290每個背景工作階段可以在不同的模型上執行。要為一個工作階段覆蓋它：

291 

292* 從 shell，使用 `claude --bg` 傳遞 `--model`。

293* 附加到執行中的工作階段並在那裡執行 `/model`。如果工作階段被重新生成，更改會持續。

294* 分派一個 [subagent](/zh-TW/sub-agents)，其 frontmatter 設定 `model` 欄位。

295 

241### 權限模式和設定296### 權限模式和設定

242 297 

243分派的工作階段從它執行的目錄讀取其 [settings](/zh-TW/settings) 和 [permission mode](/zh-TW/permissions)，就像您在那裡啟動了 `claude` 一樣。從 agent view 輸入分派不會傳遞權限模式，因此工作階段使用該目錄設定中的 `defaultMode` 或分派的 [subagent 的 frontmatter](/zh-TW/sub-agents#supported-frontmatter-fields) 中的 `permissionMode`。298分派的工作階段從它執行的目錄讀取其 [settings](/zh-TW/settings) 和 [permission mode](/zh-TW/permissions)，就像您在那裡啟動了 `claude` 一樣。從 agent view 輸入分派不會傳遞權限模式，因此工作階段使用該目錄設定中的 `defaultMode` 或分派的 [subagent 的 frontmatter](/zh-TW/sub-agents#supported-frontmatter-fields) 中的 `permissionMode`。

246 301 

247## 從 shell 管理工作階段302## 從 shell 管理工作階段

248 303 

249每個背景工作階段都有一個短 ID，您可以從 shell 使用。這些命令對於指令碼編寫或當您不想開啟 agent view 時很有用。304每個背景工作階段都有一個短 ID，您可以從 shell 使用。當您使用 `claude --bg` 啟動工作階段時會列印該 ID，每個工作階段的 ID 是其在 `~/.claude/jobs/` 下的目錄名稱。這些命令對於指令碼編寫或當您不想開啟 agent view 時很有用。

250 305 

251| 命令 | 目的 |306| 命令 | 目的 |

252| :--------------------- | :----------------------- |307| :--------------------- | :---------------------------------- |

253| `claude agents` | 開啟 agent view |308| `claude agents` | 開啟 agent view |

254| `claude attach <id>` | 在此終端中附加到工作階段 |309| `claude attach <id>` | 在此終端中附加到工作階段 |

255| `claude logs <id>` | 列印工作階段的最近輸出 |310| `claude logs <id>` | 列印工作階段的最近輸出 |

256| `claude stop <id>` | 停止工作階段。也接受 `claude kill` |311| `claude stop <id>` | 停止工作階段。也接受 `claude kill` |

257| `claude respawn <id>` | 重新啟動已停止的工作階段，保持其對話完整 |312| `claude respawn <id>` | 重新啟動已停止的工作階段，保持其對話完整 |

258| `claude respawn --all` | 重新啟動每個已停止的工作階段 |313| `claude respawn --all` | 重新啟動每個已停止的工作階段 |

259| `claude rm <id>` | 從列表中移除工作階段 |314| `claude rm <id>` | 從列表中移除工作階段。如果沒有未提交的變更，會清理其 worktree |

260 315 

261## 背景工作階段如何被託管316## 背景工作階段如何被託管

262 317 

263背景工作階段由每個使用者的監督程序託管，與您的終端和 agent view 分開。它在您第一次背景化工作階段或開啟 agent view 時自動啟動，您不直接管理它。監督程序及其工作階段使用與互動工作階段相同的認證進行身份驗證，並且除了模型 API 外不進行額外的網路連接。318agent view 中列出的每個工作階段都被視為背景工作階段，無論您目前是否連接到它。相比之下，直接執行 `claude` 啟動的工作階段與該終端相關聯，並在終端關閉時結束，除非您[將其發送到背景](#from-inside-a-session)。

319 

320### 監督程序

321 

322背景工作階段由每個使用者的監督程序託管，與您的終端和 agent view 分開。監督程序在您第一次背景化工作階段或開啟 agent view 時自動啟動，您不直接管理它。

323 

324監督程序及其工作階段使用與互動工作階段相同的認證進行身份驗證，並且除了模型 API 外不進行額外的網路連接。

325 

326每個背景工作階段都是其自己的 Claude Code 程序，由監督程序管理而不是與您的終端相關聯。正在主動工作、等待您的輸入或已連接終端的工作階段保持其程序執行。

264 327 

265每個背景工作階段都是其自己的 Claude Code 程序，父級是監督程序而不是您的終端。正在主動工作、等待您的輸入或已連接終端的工作階段保持其程序執行。一旦工作階段完成並在未附加的情況下閒置約一小時，監督程序停止其程序以釋放資源。記錄和狀態保留在磁碟上，下次您附加、查看或回覆時，監督程序從中斷的地方啟動新程序。當每個工作階段都完成且沒有終端連接時，監督程序本身退出，並在下次您背景化工作階段或開啟 agent view 時再次啟動。328一旦工作階段完成並在未附加的情況下閒置約一小時，監督程序停止其程序以釋放資源。記錄和狀態保留在磁碟上，下次您附加、查看或回覆時，監督程序從中斷的地方啟動新程序。當每個工作階段都完成且沒有終端連接時，監督程序本身退出，並在下次您需要它時再次啟動。

266 329 

267監督程序監視磁碟上已安裝的 Claude Code 二進位檔案，並在常規 [自動更新程序](/zh-TW/setup#auto-updates) 替換它後重新啟動到新版本。這是本地檔案監視，不是網路檢查。背景工作階段是分離的程序，因此它們在重新啟動期間繼續執行，新監督程序重新連接到它們。330監督程序監視磁碟上已安裝的 Claude Code 二進位檔案，並在常規[自動更新程序](/zh-TW/setup#auto-updates)替換它後重新啟動到新版本。這是本地檔案監視，不是網路檢查。背景工作階段是分離的程序，因此它們在重新啟動期間繼續執行，新監督程序重新連接到它們。

331 

332### 狀態存儲位置

268 333 

269工作階段狀態存儲在您的 Claude Code 配置目錄下。如果您設定 [`CLAUDE_CONFIG_DIR`](/zh-TW/env-vars)，監督程序改用該目錄而不是 `~/.claude`，並作為具有其自己工作階段的單獨實例執行。334工作階段狀態存儲在您的 Claude Code 配置目錄下。如果您設定 [`CLAUDE_CONFIG_DIR`](/zh-TW/env-vars)，監督程序改用該目錄而不是 `~/.claude`，並作為具有其自己工作階段的單獨實例執行。

270 335 

274| `~/.claude/daemon/roster.json` | 執行中的背景工作階段列表，用於在重新啟動後重新連接 |339| `~/.claude/daemon/roster.json` | 執行中的背景工作階段列表，用於在重新啟動後重新連接 |

275| `~/.claude/jobs/<id>/state.json` | 在 agent view 中顯示的每個工作階段狀態 |340| `~/.claude/jobs/<id>/state.json` | 在 agent view 中顯示的每個工作階段狀態 |

276 341 

277要完全關閉背景代理和 agent view，將 `disableAgentView` [設定](/zh-TW/settings) 設為 `true` 或設定 `CLAUDE_CODE_DISABLE_AGENT_VIEW` 環境變數。管理員可以通過 [受管設定](/zh-TW/permissions#managed-settings) 強制執行此操作。342### 關閉 agent view

343 

344要完全關閉背景代理和 agent view，將 `disableAgentView` [設定](/zh-TW/settings)設為 `true` 或設定 `CLAUDE_CODE_DISABLE_AGENT_VIEW` 環境變數。管理員可以通過[受管設定](/zh-TW/permissions#managed-settings)強制執行此操作。

278 345 

279## 故障排除346## 故障排除

280 347 

348### `claude agents` 列出子代理而不是開啟代理檢視

349 

350如果 `claude agents` 列印計數後跟著您設定的子代理，然後退出，代理檢視在您的環境中不可用。較早的版本不會在每個環境中開啟代理檢視，包括透過 Bedrock、Vertex AI 或 Foundry 連接時。執行 `claude update` 以安裝最新版本。

351 

352如果更新後代理檢視仍未開啟，請檢查它是否已被設定或環境變數[關閉](#turn-off-agent-view)。

353 

281### Agent view 開啟時沒有工作階段354### Agent view 開啟時沒有工作階段

282 355 

283Agent view 在您分派第一個工作階段之前為空。在底部的輸入框中輸入提示並按 `Enter`。356Agent view 在您分派第一個工作階段之前為空。在底部的輸入框中輸入提示並按 `Enter`。

284 357 

358### 無法開啟代理，因為背景工作正在執行

359 

360如果按 `←` 將目前工作階段放在背景中顯示 `Cannot open agents — N background task(s) running`，工作階段有進行中的工作，例如子代理、工作流程或背景 shell 命令，快捷鍵不會無聲地放棄它。執行 `/tasks` 以查看正在執行的內容，然後執行 `/bg` 以確認放棄它們。請參閱[從工作階段內部](#from-inside-a-session)以了解背景化時哪些會轉移，哪些不會。

361 

362### 提示被拒絕為過短

363 

364分派輸入期望任務描述，而不是對話開場白。短於四個字元的提示會被拒絕並顯示 `Too short` 提示，以便隨意按鍵不會啟動工作階段。描述您希望工作階段執行的操作，例如 `investigate the flaky checkout test`。

365 

285### 機器喚醒後工作階段顯示為已停止366### 機器喚醒後工作階段顯示為已停止

286 367 

287背景工作階段不能在睡眠或關閉後存活。附加、查看或回覆任何已停止的工作階段，它會從中斷的地方重新啟動。要一次重新啟動所有工作階段，執行 `claude respawn --all`。368背景工作階段不能在睡眠或關閉後存活。附加、查看或回覆任何已停止的工作階段，它會從中斷的地方重新啟動。要一次重新啟動所有工作階段，執行 `claude respawn --all`。

292 373 

293### `.claude/worktrees/` 正在填滿374### `.claude/worktrees/` 正在填滿

294 375 

295當您刪除建立 worktrees 的工作階段時，worktrees 會被移除。如果工作階段在沒有清理的情況下結束，在專案目錄中使用 `git worktree list` 列出剩餘條目，並使用 `git worktree remove <path>` 移除每個。請參閱 [清理 worktrees](/zh-TW/worktrees#clean-up-worktrees)。376當您刪除建立 worktrees 的工作階段時，worktrees 會被移除。如果工作階段在沒有清理的情況下結束，在專案目錄中使用 `git worktree list` 列出剩餘條目，並使用 `git worktree remove <path>` 移除每個。請參閱[清理 worktrees](/zh-TW/worktrees#clean-up-worktrees)。

296 377 

297## 限制378## 限制

298 379 

299Agent view 是研究預覽版本。要注意的當前限制：380Agent view 是研究預覽版本，具有以下限制：

300 381 

301* **速率限制適用**：背景工作階段與互動工作階段一樣消耗您的訂閱使用量，因此並行執行十個代理的使用配額速度快十倍。382* **速率限制適用**：背景工作階段與互動工作階段一樣消耗您的訂閱使用量，因此並行執行十個代理的使用配額速度快十倍。

302* **工作階段是本地的**：背景工作階段在您的機器上執行，如果它進入睡眠或關閉則停止。383* **工作階段是本地的**：背景工作階段在您的機器上執行，如果它進入睡眠或關閉則停止。

303* **Worktrees 隨工作階段刪除**：在刪除在其自己的 worktree 中編輯檔案的工作階段之前，合併或推送更改。384* **Worktrees 隨工作階段刪除**：在刪除在其自己的 worktree 中編輯檔案的工作階段之前，合併或推送更改。

304 385 

305## 後續步驟386## 相關資源

306 387 

307現在您了解了 agent view，探索這些相關功能：388如需了解在平行中執行 Claude 的其他方式，請參閱：

308 389 

309* [在平行中執行代理](/zh-TW/agents)：比較 agent view 與 subagents、agent teams 和 worktrees390* [在平行中執行代理](/zh-TW/agents)：比較 agent view 與 subagents、agent teams 和 worktrees

310* [Subagents](/zh-TW/sub-agents)：使用自訂提示、工具和隔離定義可重用的代理配置

311* [Agent teams](/zh-TW/agent-teams)：協調相互傳遞訊息的多個工作階段391* [Agent teams](/zh-TW/agent-teams)：協調相互傳遞訊息的多個工作階段

312* [Claude Code on the web](/zh-TW/claude-code-on-the-web)：在受管雲環境中執行工作階段，而不是本地執行392* [Claude Code on the web](/zh-TW/claude-code-on-the-web)：在受管雲環境中執行工作階段，而不是本地執行

143 143 

144### 產生長期令牌144### 產生長期令牌

145 145 

146<Note>

147 Starting June 15, 2026, Agent SDK and `claude -p` usage on subscription plans will draw from a new monthly Agent SDK credit, separate from your interactive usage limits. See [Use the Claude Agent SDK with your Claude plan](https://support.claude.com/en/articles/15036540-use-the-claude-agent-sdk-with-your-claude-plan) for details.

148</Note>

149 

146對於 CI 管道、指令碼或其他互動式瀏覽器登入不可用的環境，使用 `claude setup-token` 產生一年期 OAuth 令牌：150對於 CI 管道、指令碼或其他互動式瀏覽器登入不可用的環境，使用 `claude setup-token` 產生一年期 OAuth 令牌：

147 151 

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

33雲端工作階段需要存取您的 GitHub 儲存庫以複製程式碼和推送分支。您可以通過兩種方式授予存取權限：33雲端工作階段需要存取您的 GitHub 儲存庫以複製程式碼和推送分支。您可以通過兩種方式授予存取權限：

34 34 

35| 方法 | 運作方式 | 最適合 |35| 方法 | 運作方式 | 最適合 |

36| :--------------- | :------------------------------------------------------------------------------ | :--------------- |36| :--------------- | :------------------------------------------------------- | :----------------------------------------- |

37| **GitHub App** | 在[網頁上線](/zh-TW/web-quickstart)期間在特定儲存庫上安裝 Claude GitHub App。存取按儲存庫範圍。 | 想要明確的按儲存庫授權的團隊 |37| **GitHub App** | 在[網頁上線](/zh-TW/web-quickstart)期間授權 Claude GitHub App。 | 瀏覽器上線；想要[自動修復](#auto-fix-pull-requests)的團隊 |

38| **`/web-setup`** | 在您的終端中執行 `/web-setup` 以將您的本機 `gh` CLI 令牌同步到您的 Claude 帳戶。存取與您的 `gh` 令牌可以看到的內容相符。 | 已經使用 `gh` 的個人開發者 |38| **`/web-setup`** | 在您的終端中執行 `/web-setup` 以將您的本機 `gh` CLI 令牌同步到您的 Claude 帳戶。 | 已經使用 `gh` 的個人開發者 |

39 

40<Note>

41 使用任一方法，雲端工作階段都可以存取連接的 GitHub 帳戶可以看到的任何儲存庫，而不僅僅是安裝了 Claude GitHub App 的儲存庫。App 安裝啟用 PR webhooks 以進行[自動修復](#auto-fix-pull-requests)；它不是工作階段級別的存取控制。若要限制您的團隊可以從雲端工作階段存取的儲存庫，請在 GitHub 本身上限制存取，例如通過限制連接的 GitHub 帳戶的團隊或儲存庫成員資格。

42</Note>

39 43 

40任一方法都可以。[`/schedule`](/zh-TW/routines)檢查任一形式的存取，如果都未配置，會提示您執行 `/web-setup`。有關 `/web-setup` 的逐步說明，請參閱[從您的終端連接](/zh-TW/web-quickstart#connect-from-your-terminal)。44任一方法都可以。[`/schedule`](/zh-TW/routines)檢查任一形式的存取，如果都未配置，會提示您執行 `/web-setup`。有關 `/web-setup` 的逐步說明，請參閱[從您的終端連接](/zh-TW/web-quickstart#connect-from-your-terminal)。

41 45 

42[自動修復](#auto-fix-pull-requests)需要 GitHub App，它使用該應用程式接收 PR webhooks。如果您使用 `/web-setup` 連接，稍後想要自動修復，請在這些儲存庫上安裝該應用程式。46GitHub App 是[自動修復](#auto-fix-pull-requests)所必需的，它使用該應用程式接收 PR webhooks。如果您使用 `/web-setup` 連接，稍後想要自動修復，請在這些儲存庫上安裝該應用程式。

43 47 

44Team 和 Enterprise 管理員可以在 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) 使用快速網頁設定切換來禁用 `/web-setup`。48Team 和 Enterprise 管理員可以在 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) 使用快速網頁設定切換來禁用 `/web-setup`。

45 49 

739* **從行動應用程式**：告訴 Claude 自動修復 PR，例如「監視此 PR 並修復任何 CI 失敗或審查評論」743* **從行動應用程式**：告訴 Claude 自動修復 PR，例如「監視此 PR 並修復任何 CI 失敗或審查評論」

740* **任何現有 PR**：將 PR URL 貼到工作階段中並告訴 Claude 自動修復它744* **任何現有 PR**：將 PR URL 貼到工作階段中並告訴 Claude 自動修復它

741 745 

746自動修復是每個 PR 的切換開關。若要停止監視，請在網頁工作階段中開啟 CI 狀態欄並清除**自動修復**切換，或告訴 Claude 停止監視 PR。

747 

742### Claude 如何回應 PR 活動748### Claude 如何回應 PR 活動

743 749 

744當自動修復處於活動狀態時，Claude 會收到 PR 的 GitHub 事件，包括新的審查評論和 CI 檢查失敗。對於每個事件，Claude 會調查並決定如何進行：750當自動修復處於活動狀態時，Claude 會收到 PR 的 GitHub 事件，包括新的審查評論和 CI 檢查失敗。對於每個事件，Claude 會調查並決定如何進行：

772 778 

773* 檢查 [status.claude.com](https://status.claude.com) 以查找雲端工作階段事件779* 檢查 [status.claude.com](https://status.claude.com) 以查找雲端工作階段事件

774* 一分鐘後重試，因為容量是按需佈建的780* 一分鐘後重試，因為容量是按需佈建的

775* 確認您的儲存庫可到達。私人儲存庫需要在該儲存庫上安裝 GitHub App 存取，或通過 `/web-setup` 同步的 `gh` 令牌。請參閱 [GitHub 驗證選項](#github-authentication-options)。781* 確認您的儲存庫可到達。連接的 GitHub 帳戶必須能夠存取 GitHub 上的儲存庫，可以透過 Claude GitHub App 授權或透過 `/web-setup` 同步的 `gh` 令牌進行存取 — 不需要在儲存庫上安裝 App。請參閱 [GitHub 驗證選項](#github-authentication-options)。

776 782 

777### 遠端控制工作階段已過期或存取被拒絕783### 遠端控制工作階段已過期或存取被拒絕

778 784 

61| `/diff` | 開啟互動式差異檢視器，顯示未提交的變更和每個回合的差異。使用左/右箭頭在目前的 git 差異和個別 Claude 回合之間切換，使用上/下箭頭瀏覽檔案 |61| `/diff` | 開啟互動式差異檢視器，顯示未提交的變更和每個回合的差異。使用左/右箭頭在目前的 git 差異和個別 Claude 回合之間切換，使用上/下箭頭瀏覽檔案 |

62| `/doctor` | 診斷並驗證您的 Claude Code 安裝和設定。結果顯示狀態圖示。按 `f` 讓 Claude 修復任何報告的問題 |62| `/doctor` | 診斷並驗證您的 Claude Code 安裝和設定。結果顯示狀態圖示。按 `f` 讓 Claude 修復任何報告的問題 |

63| `/effort [level\|auto]` | 設定模型[努力程度](/zh-TW/model-config#adjust-effort-level)。接受 `low`、`medium`、`high`、`xhigh` 或 `max`；可用的程度取決於模型，`max` 僅限工作階段。`auto` 重設為模型預設值。不帶引數時，開啟互動式滑塊；使用左右箭頭選擇程度，按 `Enter` 應用。立即生效，無需等待目前回應完成 |63| `/effort [level\|auto]` | 設定模型[努力程度](/zh-TW/model-config#adjust-effort-level)。接受 `low`、`medium`、`high`、`xhigh` 或 `max`；可用的程度取決於模型，`max` 僅限工作階段。`auto` 重設為模型預設值。不帶引數時，開啟互動式滑塊；使用左右箭頭選擇程度，按 `Enter` 應用。立即生效，無需等待目前回應完成 |

64| `/exit` | 結束 CLI。別名：`/quit` |64| `/exit` | 結束 CLI。在附加的[背景工作階段](/zh-TW/agent-view#attach-to-a-session)中，這會分離並且工作階段繼續運行。別名：`/quit` |

65| `/export [filename]` | 將目前的對話匯出為純文字。使用檔案名稱時，直接寫入該檔案。不使用檔案名稱時，開啟對話框以複製到剪貼簿或儲存到檔案 |65| `/export [filename]` | 將目前的對話匯出為純文字。使用檔案名稱時，直接寫入該檔案。不使用檔案名稱時，開啟對話框以複製到剪貼簿或儲存到檔案 |

66| `/extra-usage` | 配置額外使用量以在達到速率限制時繼續工作 |66| `/extra-usage` | 配置額外使用量以在達到速率限制時繼續工作 |

67| `/fast [on\|off]` | 切換[快速模式](/zh-TW/fast-mode)開啟或關閉 |67| `/fast [on\|off]` | 切換[快速模式](/zh-TW/fast-mode)開啟或關閉 |

122| `/theme` | 變更色彩主題。包括跟隨您終端機深色或淺色背景的 `auto` 選項、淺色和深色變體、色盲無障礙（daltonized）主題、ANSI 主題（使用您終端機的色彩調色盤），以及來自 `~/.claude/themes/` 或 plugins 的任何[自訂主題](/zh-TW/terminal-config#create-a-custom-theme) |122| `/theme` | 變更色彩主題。包括跟隨您終端機深色或淺色背景的 `auto` 選項、淺色和深色變體、色盲無障礙（daltonized）主題、ANSI 主題（使用您終端機的色彩調色盤），以及來自 `~/.claude/themes/` 或 plugins 的任何[自訂主題](/zh-TW/terminal-config#create-a-custom-theme) |

123| `/tui [default\|fullscreen]` | 設定終端機 UI 渲染器並使用您的對話完整重新啟動到它。`fullscreen` 啟用[無閃爍 alt-screen 渲染器](/zh-TW/fullscreen)。不帶引數時，列印作用中的渲染器 |123| `/tui [default\|fullscreen]` | 設定終端機 UI 渲染器並使用您的對話完整重新啟動到它。`fullscreen` 啟用[無閃爍 alt-screen 渲染器](/zh-TW/fullscreen)。不帶引數時，列印作用中的渲染器 |

124| `/ultraplan <prompt>` | 在 [ultraplan](/zh-TW/ultraplan) 工作階段中草擬計劃，在您的瀏覽器中檢視它，然後遠端執行或將其發送回您的終端機 |124| `/ultraplan <prompt>` | 在 [ultraplan](/zh-TW/ultraplan) 工作階段中草擬計劃，在您的瀏覽器中檢視它，然後遠端執行或將其發送回您的終端機 |

125| `/ultrareview [PR]` | 在雲端沙箱中使用 [ultrareview](/zh-TW/ultrareview) 運行深度、多 agent 程式碼審閱。Pro 和 Max 上包括 3 次免費執行，至 2026 年 5 月 5 日，然後需要[額外使用](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |125| `/ultrareview [PR]` | 在雲端沙箱中使用 [ultrareview](/zh-TW/ultrareview) 運行深度、多 agent 程式碼審閱。Pro 和 Max 上包括 3 次免費執行，然後需要[額外使用](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

126| `/upgrade` | 開啟升級頁面以切換到更高的方案層級 |126| `/upgrade` | 開啟升級頁面以切換到更高的方案層級 |

127| `/usage` | 顯示工作階段成本、方案使用限制和活動統計資訊。請參閱[成本追蹤指南](/zh-TW/costs#using-the-%2Fusage-command)以了解訂閱特定的詳細資訊。`/cost` 和 `/stats` 是別名 |127| `/usage` | 顯示工作階段成本、方案使用限制和活動統計資訊。請參閱[成本追蹤指南](/zh-TW/costs#using-the-%2Fusage-command)以了解訂閱特定的詳細資訊。`/cost` 和 `/stats` 是別名 |

128| `/vim` | {/* max-version: 2.1.91 */}在 v2.1.92 中移除。若要在 Vim 和一般編輯模式之間切換，請使用 `/config` → Editor mode |128| `/vim` | {/* max-version: 2.1.91 */}在 v2.1.92 中移除。若要在 Vim 和一般編輯模式之間切換，請使用 `/config` → Editor mode |

364 364 

365官方 Anthropic 市場預設啟用自動更新。第三方和本機開發市場預設停用自動更新。365官方 Anthropic 市場預設啟用自動更新。第三方和本機開發市場預設停用自動更新。

366 366 

367管理員也可以在受管設定中的每個 [`extraKnownMarketplaces`](/zh-TW/settings#extraknownmarketplaces) 項目上設定 `"autoUpdate": true`，以為組織市場啟用自動更新，而無需每個使用者都切換它。

368 

367若要完全停用 Claude Code 和所有外掛程式的所有自動更新，請設定 `DISABLE_AUTOUPDATER` 環境變數。有關詳細資訊，請參閱[自動更新](/zh-TW/setup#auto-updates)。369若要完全停用 Claude Code 和所有外掛程式的所有自動更新，請設定 `DISABLE_AUTOUPDATER` 環境變數。有關詳細資訊，請參閱[自動更新](/zh-TW/setup#auto-updates)。

368 370 

369若要在停用 Claude Code 自動更新的同時保持外掛程式自動更新啟用，請設定 `FORCE_AUTOUPDATE_PLUGINS=1` 以及 `DISABLE_AUTOUPDATER`：371若要在停用 Claude Code 自動更新的同時保持外掛程式自動更新啟用，請設定 `FORCE_AUTOUPDATE_PLUGINS=1` 以及 `DISABLE_AUTOUPDATER`：

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

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

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

132| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | 設定為 `1` 以保持 [fast mode](/zh-TW/fast-mode) 在 Claude Opus 4.6 上。優先於 `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE`，因此如果您需要固定 Opus 4.6，無論預設如何變化，請設定此項 |

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

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

134| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | OpenTelemetry 匯出器在關閉時完成的逾時（以毫秒為單位）（預設值：2000）。如果指標在退出時被丟棄，請增加此值。請參閱 [Monitoring](/zh-TW/monitoring-usage) |135| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | OpenTelemetry 匯出器在關閉時完成的逾時（以毫秒為單位）（預設值：2000）。如果指標在退出時被丟棄，請增加此值。請參閱 [Monitoring](/zh-TW/monitoring-usage) |

143| `CLAUDE_CODE_REMOTE` | 當 Claude Code 作為 [cloud session](/zh-TW/claude-code-on-the-web) 執行時自動設定為 `true`。從 hook 或設定指令碼讀取此項以偵測您是否在雲端環境中 |144| `CLAUDE_CODE_REMOTE` | 當 Claude Code 作為 [cloud session](/zh-TW/claude-code-on-the-web) 執行時自動設定為 `true`。從 hook 或設定指令碼讀取此項以偵測您是否在雲端環境中 |

144| `CLAUDE_CODE_REMOTE_SESSION_ID` | 在 [cloud sessions](/zh-TW/claude-code-on-the-web) 中自動設定為目前工作階段的 ID。讀取此項以構造回到工作階段文字記錄的連結。請參閱 [Link artifacts back to the session](/zh-TW/claude-code-on-the-web#link-artifacts-back-to-the-session) |145| `CLAUDE_CODE_REMOTE_SESSION_ID` | 在 [cloud sessions](/zh-TW/claude-code-on-the-web) 中自動設定為目前工作階段的 ID。讀取此項以構造回到工作階段文字記錄的連結。請參閱 [Link artifacts back to the session](/zh-TW/claude-code-on-the-web#link-artifacts-back-to-the-session) |

145| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | 設定為 `1` 以在上一個工作階段在中途結束時自動繼續。在 SDK 模式中使用，以便模型繼續而無需 SDK 重新發送提示 |146| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | 設定為 `1` 以在上一個工作階段在中途結束時自動繼續。在 SDK 模式中使用，以便模型繼續而無需 SDK 重新發送提示 |

147| `CLAUDE_CODE_RESUME_PROMPT` | 覆蓋在繼續在中途結束的工作階段時注入的延續訊息。預設為 `Continue from where you left off.`。長時間執行的代理的生成指令碼可以將此設定為更具指令性的啟動訊息。空字串使用預設值 |

146| `CLAUDE_CODE_SCRIPT_CAPS` | JSON 物件，當設定 `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` 時限制特定指令碼在每個工作階段中可被呼叫的次數。鍵是針對命令文字進行比對的子字串；值是整數呼叫限制。例如，`{"deploy.sh": 2}` 允許 `deploy.sh` 最多被呼叫兩次。比對是基於子字串的，因此 shell 擴展技巧（如 `./scripts/deploy.sh $(evil)`）仍然計入上限。透過 `xargs` 或 `find -exec` 的執行時扇出未被偵測；這是深度防禦控制 |148| `CLAUDE_CODE_SCRIPT_CAPS` | JSON 物件，當設定 `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` 時限制特定指令碼在每個工作階段中可被呼叫的次數。鍵是針對命令文字進行比對的子字串；值是整數呼叫限制。例如，`{"deploy.sh": 2}` 允許 `deploy.sh` 最多被呼叫兩次。比對是基於子字串的，因此 shell 擴展技巧（如 `./scripts/deploy.sh $(evil)`）仍然計入上限。透過 `xargs` 或 `find -exec` 的執行時扇出未被偵測；這是深度防禦控制 |

147| `CLAUDE_CODE_SCROLL_SPEED` | 在 [fullscreen rendering](/zh-TW/fullscreen#mouse-wheel-scrolling) 中設定滑鼠滾輪捲動乘數。接受 1 到 20 的值。設定為 `3` 以符合 `vim`（如果您的終端在沒有放大的情況下每個刻度發送一個滾輪事件）。在 JetBrains IDE 終端中被忽略，Claude Code 使用其自己的捲動處理 |149| `CLAUDE_CODE_SCROLL_SPEED` | 在 [fullscreen rendering](/zh-TW/fullscreen#mouse-wheel-scrolling) 中設定滑鼠滾輪捲動乘數。接受 1 到 20 的值。設定為 `3` 以符合 `vim`（如果您的終端在沒有放大的情況下每個刻度發送一個滾輪事件）。在 JetBrains IDE 終端中被忽略，Claude Code 使用其自己的捲動處理 |

148| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | 覆蓋 [SessionEnd](/zh-TW/hooks#sessionend) hooks 的時間預算（以毫秒為單位）。適用於工作階段退出、`/clear` 和透過互動式 `/resume` 切換工作階段。預設情況下，預算為 1.5 秒，自動提高到設定檔案中配置的最高每個 hook `timeout`，最高 60 秒。外掛程式提供的 hooks 上的逾時不會提高預算 |150| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | 覆蓋 [SessionEnd](/zh-TW/hooks#sessionend) hooks 的時間預算（以毫秒為單位）。適用於工作階段退出、`/clear` 和透過互動式 `/resume` 切換工作階段。預設情況下，預算為 1.5 秒，自動提高到設定檔案中配置的最高每個 hook `timeout`，最高 60 秒。外掛程式提供的 hooks 上的逾時不會提高預算 |

198| `DISABLE_PROMPT_CACHING_HAIKU` | 設定為 `1` 以停用 Haiku 模型的提示快取 |200| `DISABLE_PROMPT_CACHING_HAIKU` | 設定為 `1` 以停用 Haiku 模型的提示快取 |

199| `DISABLE_PROMPT_CACHING_OPUS` | 設定為 `1` 以停用 Opus 模型的提示快取 |201| `DISABLE_PROMPT_CACHING_OPUS` | 設定為 `1` 以停用 Opus 模型的提示快取 |

200| `DISABLE_PROMPT_CACHING_SONNET` | 設定為 `1` 以停用 Sonnet 模型的提示快取 |202| `DISABLE_PROMPT_CACHING_SONNET` | 設定為 `1` 以停用 Sonnet 模型的提示快取 |

201| `DISABLE_TELEMETRY` | 設定為 `1` 以選擇退出遙測。遙測事件不包括使用者資料，如程式碼、檔案路徑或 bash 命令 |203| `DISABLE_TELEMETRY` | 設定為 `1` 以選擇退出遙測。遙測事件不包括使用者資料，如程式碼、檔案路徑或 bash 命令。也停用功能旗標，因此仍在推出的某些功能可能無法使用 |

202| `DISABLE_UPDATES` | 設定為 `1` 以阻止所有更新，包括手動 `claude update` 和 `claude install`。比 `DISABLE_AUTOUPDATER` 更嚴格。在透過您自己的管道分發 Claude Code 且使用者不應自行更新時使用 |204| `DISABLE_UPDATES` | 設定為 `1` 以阻止所有更新，包括手動 `claude update` 和 `claude install`。比 `DISABLE_AUTOUPDATER` 更嚴格。在透過您自己的管道分發 Claude Code 且使用者不應自行更新時使用 |

203| `DISABLE_UPGRADE_COMMAND` | 設定為 `1` 以隱藏 `/upgrade` 命令 |205| `DISABLE_UPGRADE_COMMAND` | 設定為 `1` 以隱藏 `/upgrade` 命令 |

204| `DO_NOT_TRACK` | 設定為 `1` 以選擇退出遙測。相當於設定 `DISABLE_TELEMETRY`。尊重 [standard cross-tool convention](https://consoledonottrack.com/) |206| `DO_NOT_TRACK` | 設定為 `1` 以選擇退出遙測。相當於設定 `DISABLE_TELEMETRY`。尊重 [standard cross-tool convention](https://consoledonottrack.com/) |

80 80 

81Opus 4.6 的快速模式仍可與 Opus 4.7 並行使用。兩者共享相同的快速模式速率限制池：任一模型上的使用都會從相同的限制中扣除。81Opus 4.6 的快速模式仍可與 Opus 4.7 並行使用。兩者共享相同的快速模式速率限制池：任一模型上的使用都會從相同的限制中扣除。

82 82 

83若要明確將快速模式固定到 Opus 4.6，設定 `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1`。此變數優先，因此無論是否設定 `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE`，快速模式都會在 Opus 4.6 上執行。

84 

83## 了解成本權衡85## 了解成本權衡

84 86 

85快速模式的每個 token 定價高於標準 Opus：87快速模式的每個 token 定價高於標準 Opus：

128 128 

129## 要求129## 要求

130 130 

131`/goal` 僅在你已接受信任對話框的工作區中執行，因為評估器是 hooks 系統的一部分。如果在受管原則設定中設定了 [`disableAllHooks`](/zh-TW/hooks#disable-or-remove-hooks)，`/goal` 不可用。在這兩種情況下，命令會告訴你原因，而不是默默地什麼都不做。131`/goal` 僅在你已接受信任對話框的工作區中執行，因為評估器是 hooks 系統的一部分。當在任何設定層級設定了 [`disableAllHooks`](/zh-TW/hooks#disable-or-remove-hooks) 時，或當在受管設定中設定了 [`allowManagedHooksOnly`](/zh-TW/settings#hook-configuration) 時，`/goal` 也不可用。在每種情況下，命令會告訴你原因，而不是默默地什麼都不做。

132 132 

133## 另請參閱133## 另請參閱

134 134 

6 6 

7> 使用 Agent SDK 從 CLI、Python 或 TypeScript 以程式方式執行 Claude Code。7> 使用 Agent SDK 從 CLI、Python 或 TypeScript 以程式方式執行 Claude Code。

8 8 

9[Agent SDK](/zh-TW/agent-sdk/overview) 提供與 Claude Code 相同的工具、agent 迴圈和上下文管理。它可作為 CLI 用於指令碼和 CI/CD，或作為 [Python](/zh-TW/agent-sdk/python) 和 [TypeScript](/zh-TW/agent-sdk/typescript) 套件供完整的程式控制。

10 

11<Note>9<Note>

12 CLI 之前稱為「無頭模式」。`-p` 旗標和所有 CLI 選項的工作方式相同。10 Starting June 15, 2026, Agent SDK and `claude -p` usage on subscription plans will draw from a new monthly Agent SDK credit, separate from your interactive usage limits. See [Use the Claude Agent SDK with your Claude plan](https://support.claude.com/en/articles/15036540-use-the-claude-agent-sdk-with-your-claude-plan) for details.

13</Note>11</Note>

14 12 

15若要從 CLI 以程式方式執行 Claude Code，請傳遞 `-p` 和您的提示以及任何 [CLI 選項](/zh-TW/cli-reference)：13[Agent SDK](/zh-TW/agent-sdk/overview) 提供與 Claude Code 相同的工具、agent 迴圈和上下文管理。它可作為 CLI 用於指令碼和 CI/CD，或作為 [Python](/zh-TW/agent-sdk/python) 和 [TypeScript](/zh-TW/agent-sdk/typescript) 套件供完整的程式控制。

14 

15若要以非互動模式執行 Claude Code，請傳遞 `-p` 和您的提示以及任何 [CLI 選項](/zh-TW/cli-reference)：

16 16 

17```bash theme={null}17```bash theme={null}

18claude -p "Find and fix the bug in auth.py" --allowedTools "Read,Edit,Bash"18claude -p "Find and fix the bug in auth.py" --allowedTools "Read,Edit,Bash"

754| [Plugin](/zh-TW/plugins) `hooks/hooks.json` | 啟用外掛時 | 是，與外掛捆綁 |754| [Plugin](/zh-TW/plugins) `hooks/hooks.json` | 啟用外掛時 | 是，與外掛捆綁 |

755| [Skill](/zh-TW/skills) 或[agent](/zh-TW/sub-agents) frontmatter | 當 skill 或 agent 處於活動狀態時 | 是，在元件檔案中定義 |755| [Skill](/zh-TW/skills) 或[agent](/zh-TW/sub-agents) frontmatter | 當 skill 或 agent 處於活動狀態時 | 是，在元件檔案中定義 |

756 756 

757在 Claude Code 中執行 [`/hooks`](/zh-TW/hooks#the-hooks-menu) 以瀏覽按事件分組的所有配置的 hooks。若要一次禁用所有 hooks，請在設定檔中設定 `"disableAllHooks": true`。757在 Claude Code 中執行 [`/hooks`](/zh-TW/hooks#the-hooks-menu) 以瀏覽按事件分組的所有配置的 hooks。若要一次禁用所有 hooks，請在設定檔中設定 `"disableAllHooks": true`。受管理的原則設定中配置的 Hooks 仍會執行，除非 `disableAllHooks` 也在那裡設定。

758 758 

759如果您在 Claude Code 執行時直接編輯設定檔，檔案監視程式通常會自動選取 hook 變更。759如果您在 Claude Code 執行時直接編輯設定檔，檔案監視程式通常會自動選取 hook 變更。

760 760 

6 6 

7> Claude Code 的法律協議、合規認證和安全資訊。7> Claude Code 的法律協議、合規認證和安全資訊。

8 8 

9<Note>

10 Starting June 15, 2026, Agent SDK and `claude -p` usage on subscription plans will draw from a new monthly Agent SDK credit, separate from your interactive usage limits. See [Use the Claude Agent SDK with your Claude plan](https://support.claude.com/en/articles/15036540-use-the-claude-agent-sdk-with-your-claude-plan) for details.

11</Note>

12 

9## 法律協議13## 法律協議

10 14 

11### 許可證15### 許可證

51 51 

52### 選擇 CLAUDE.md 檔案的位置52### 選擇 CLAUDE.md 檔案的位置

53 53 

54CLAUDE.md 檔案可以位於多個位置，每個位置都有不同的範圍。更具體的位置優先於更廣泛的位置。54CLAUDE.md 檔案可以位於多個位置，每個位置都有不同的範圍。下表按載入順序列出它們，從最廣泛的範圍到最具體的範圍，因此專案指令在使用者指令之後出現在上下文中。

55 55 

56| 範圍 | 位置 | 目的 | 使用案例示例 | 共享對象 |56| 範圍 | 位置 | 目的 | 使用案例示例 | 共享對象 |

57| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------- | ---------------- | ------------ |57| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------- | ---------------- | ------------ |

58| **受管理的原則** | • macOS：`/Library/Application Support/ClaudeCode/CLAUDE.md`<br />• Linux 和 WSL：`/etc/claude-code/CLAUDE.md`<br />• Windows：`C:\Program Files\ClaudeCode\CLAUDE.md` | 由 IT/DevOps 管理的組織範圍指令 | 公司編碼標準、安全原則、合規要求 | 組織中的所有使用者 |58| **受管理的原則** | • macOS：`/Library/Application Support/ClaudeCode/CLAUDE.md`<br />• Linux 和 WSL：`/etc/claude-code/CLAUDE.md`<br />• Windows：`C:\Program Files\ClaudeCode\CLAUDE.md` | 由 IT/DevOps 管理的組織範圍指令 | 公司編碼標準、安全原則、合規要求 | 組織中的所有使用者 |

59| **專案指令** | `./CLAUDE.md` 或 `./.claude/CLAUDE.md` | 專案的團隊共享指令 | 專案架構、編碼標準、常見工作流程 | 透過原始碼控制的團隊成員 |

60| **使用者指令** | `~/.claude/CLAUDE.md` | 所有專案的個人偏好 | 程式碼樣式偏好、個人工具快捷方式 | 僅您（所有專案） |59| **使用者指令** | `~/.claude/CLAUDE.md` | 所有專案的個人偏好 | 程式碼樣式偏好、個人工具快捷方式 | 僅您（所有專案） |

60| **專案指令** | `./CLAUDE.md` 或 `./.claude/CLAUDE.md` | 專案的團隊共享指令 | 專案架構、編碼標準、常見工作流程 | 透過原始碼控制的團隊成員 |

61| **本地指令** | `./CLAUDE.local.md` | 個人專案特定偏好；新增到 `.gitignore` | 您的沙箱 URL、偏好的測試資料 | 僅您（目前專案） |61| **本地指令** | `./CLAUDE.local.md` | 個人專案特定偏好；新增到 `.gitignore` | 您的沙箱 URL、偏好的測試資料 | 僅您（目前專案） |

62 62 

63工作目錄上方目錄層級中的 CLAUDE.md 和 CLAUDE.local.md 檔案在啟動時完整載入。子目錄中的檔案在 Claude 讀取這些目錄中的檔案時按需載入。有關完整的解析順序，請參閱 [CLAUDE.md 檔案如何載入](#how-claude-md-files-load)。63工作目錄上方目錄層級中的 CLAUDE.md 和 CLAUDE.local.md 檔案在啟動時完整載入。子目錄中的檔案在 Claude 讀取這些目錄中的檔案時按需載入。有關完整的解析順序，請參閱 [CLAUDE.md 檔案如何載入](#how-claude-md-files-load)。

231 231 

232Opus 4.7、Opus 4.6 和 Sonnet 4.6 支援[100 萬個 token 的 context window](https://platform.claude.com/docs/en/build-with-claude/context-windows#1m-token-context-window)，用於具有大型程式碼庫的長時間會話。232Opus 4.7、Opus 4.6 和 Sonnet 4.6 支援[100 萬個 token 的 context window](https://platform.claude.com/docs/en/build-with-claude/context-windows#1m-token-context-window)，用於具有大型程式碼庫的長時間會話。

233 233 

234可用性因模型和計畫而異。在 Max、Team 和 Enterprise 計畫上，Opus 會自動升級到 1M context，無需額外配置。這適用於 Team Standard 和 Team Premium 席位。234可用性因模型和計畫而異。在 Max、Team 和 Enterprise 計畫上，Opus 會自動升級到 1M context，無需額外配置。這適用於 Team Standard 和 Team Premium 席位。Sonnet 搭配 1M context 不是自動升級的一部分，需要在每個訂閱計畫上進行[額外使用](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)，包括 Max。

235 235 

236| 計畫 | Opus 搭配 1M context | Sonnet 搭配 1M context |236| 計畫 | Opus 搭配 1M context | Sonnet 搭配 1M context |

237| --------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |237| --------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |

6 6 

7> 將 Claude Code 適配用於軟體工程以外的用途7> 將 Claude Code 適配用於軟體工程以外的用途

8 8 

9輸出樣式改變 Claude 的回應方式，而不是 Claude 知道什麼。它們修改系統提示以設定角色、語氣和輸出格式，同時保留核心功能，例如執行指令碼、讀取和寫入檔案，以及追蹤待辦事項。當您每次都重新提示相同的語音或格式，或者當您希望 Claude 充當軟體工程師以外的角色時，請使用一個。9輸出樣式改變 Claude 的回應方式，而不是 Claude 知道什麼。它們修改系統提示以設定角色、語氣和輸出格式。當您每次都重新提示相同的語音或格式，或者當您希望 Claude 充當軟體工程師以外的角色時，請使用一個。

10 

11自訂輸出樣式將您的指令添加到系統提示，並讓您選擇是否保留 Claude Code 的內建軟體工程指令。當您改變 Claude 的溝通方式但仍在編碼時（例如始終用圖表回答），請保留它們。當 Claude 根本不進行軟體工程時（例如寫作助手或數據分析師），請省略它們。

10 12 

11有關您的專案、慣例或程式碼庫的說明，請改用 [CLAUDE.md](/zh-TW/memory)。13有關您的專案、慣例或程式碼庫的說明，請改用 [CLAUDE.md](/zh-TW/memory)。

12 14 

22 24 

23* **Learning**：協作式的邊做邊學模式，Claude 不僅會在編碼時分享「Insights」，還會要求您自己貢獻小的、策略性的程式碼片段。Claude Code 將在您的程式碼中添加 `TODO(human)` 標記供您實現。25* **Learning**：協作式的邊做邊學模式，Claude 不僅會在編碼時分享「Insights」，還會要求您自己貢獻小的、策略性的程式碼片段。Claude Code 將在您的程式碼中添加 `TODO(human)` 標記供您實現。

24 26 

25## 輸出樣式的工作原理

26 

27輸出樣式直接修改 Claude Code 的系統提示。

28 

29* 自訂輸出樣式排除了編碼指令（例如使用測試驗證程式碼），除非 `keep-coding-instructions` 為真。

30* 所有輸出樣式都在系統提示的末尾添加了自己的自訂指令。

31* 所有輸出樣式都會在對話期間觸發提醒，讓 Claude 遵守輸出樣式指令。

32 

33Token 使用量取決於樣式。將指令添加到系統提示會增加輸入 token，儘管 prompt caching 在工作階段中的第一個請求之後會降低此成本。內建的 Explanatory 和 Learning 樣式按設計會產生比預設更長的回應，這會增加輸出 token。對於自訂樣式，輸出 token 使用量取決於您的指令告訴 Claude 要產生什麼。

34 

35## 變更您的輸出樣式27## 變更您的輸出樣式

36 28 

37執行 `/config` 並選擇**輸出樣式**以從選單中選擇樣式。您的選擇會儲存到[本地專案層級](/zh-TW/settings)的 `.claude/settings.local.json`。29執行 `/config` 並選擇**輸出樣式**以從選單中選擇樣式。您的選擇會儲存到[本地專案層級](/zh-TW/settings)的 `.claude/settings.local.json`。

48 40 

49## 建立自訂輸出樣式41## 建立自訂輸出樣式

50 42 

51自訂輸出樣式是具有 frontmatter 和將添加到系統提示的文字的 Markdown 檔案：43自訂輸出樣式是一個 Markdown 檔案：frontmatter 用於中繼資料，然後是要添加到系統提示的指令。

52 44 

53```markdown theme={null}45<Steps>

54name: My Custom Style46 <Step title="建立 Markdown 檔案">

55description:47 將其儲存在三個層級之一。檔案名稱成為樣式名稱，除非您在 frontmatter 中設定 `name`。

56 A brief description of what this style does, to be displayed to the user

57 48 

58# Custom Style Instructions49 * 使用者：`~/.claude/output-styles`

50 * 專案：`.claude/output-styles`

51 * 受管原則：[受管設定目錄](/zh-TW/settings#settings-files)內的 `.claude/output-styles`

52 </Step>

59 53 

60You are an interactive CLI tool that helps users with software engineering54 <Step title="添加 frontmatter 和指令">

61tasks. [Your custom instructions here...]55 決定是否保留 Claude Code 的軟體工程指令。如果您改變 Claude 的溝通方式但仍希望它以相同方式編碼，請設定 `keep-coding-instructions: true`。如果 Claude 不會進行軟體工程，請省略它。

62 56 

63## Specific Behaviors57 此範例在保留 Claude 編碼行為的同時，在每個說明前面加上圖表：

64 58 

65[Define how the assistant should behave in this style...]59 ```markdown theme={null}

66```60 ---

61 name: Diagrams first

62 description: Lead every explanation with a diagram

63 keep-coding-instructions: true

64 ---

67 65 

68您可以在三個層級儲存這些檔案：66 When explaining code, architecture, or data flow, start with a Mermaid diagram showing the structure, then explain in prose.

69 67 

70* 使用者：`~/.claude/output-styles`68 ## Diagram conventions

71* 專案：`.claude/output-styles`69 

72* 受管原則：[受管設定目錄](/zh-TW/settings#settings-files)內的 `.claude/output-styles`70 Use `flowchart TD` for control flow and `sequenceDiagram` for request paths. Keep diagrams under 15 nodes.

71 ```

72 </Step>

73 

74 <Step title="切換到您的樣式">

75 執行 `/config` 並在**輸出樣式**下選擇您的樣式。它將在您下次啟動工作階段時生效。

76 </Step>

77</Steps>

73 78 

74[Plugins](/zh-TW/plugins-reference) 也可以在 `output-styles/` 目錄中提供輸出樣式。79[Plugins](/zh-TW/plugins-reference) 也可以在 `output-styles/` 目錄中提供輸出樣式。

75 80 

76### Frontmatter81### Frontmatter

77 82 

78輸出樣式檔案支援 frontmatter 以指定中繼資料：83輸出樣式檔案支援這些 frontmatter 欄位：

79 84 

80| Frontmatter | 用途 | 預設 |85| Frontmatter | 用途 | 預設 |

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

82| `name` | 輸出樣式的名稱，如果不是檔案名稱 | 繼承自檔案名稱 |87| `name` | 輸出樣式的名稱，如果不是檔案名稱 | 繼承自檔案名稱 |

83| `description` | 輸出樣式的描述，在 `/config` 選擇器中顯示 | 無 |88| `description` | 輸出樣式的描述，在 `/config` 選擇器中顯示 | 無 |

84| `keep-coding-instructions` | 是否保留 Claude Code 系統提示中與編碼相關的部分。 | false |89| `keep-coding-instructions` | 保留 Claude Code 的內建軟體工程指令 | `false` |

85| `force-for-plugin` | 僅限 Plugin 輸出樣式：在啟用 plugin 時自動應用此樣式，無需要求使用者選擇它。覆蓋使用者的 `outputStyle` 設定。如果多個啟用的 plugin 設定此項，則第一個載入的獲勝。 | false |90| `force-for-plugin` | 僅限 Plugin 輸出樣式：在啟用 plugin 時自動應用此樣式，無需要求使用者選擇它。覆蓋使用者的 `outputStyle` 設定。如果多個啟用的 plugin 設定此項，Claude Code 使用第一個載入的。 | `false` |

86 91 

87## 與相關功能的比較92## 輸出樣式的工作原理

93 

94輸出樣式直接修改 Claude Code 的系統提示。

88 95 

89### 輸出樣式 vs. CLAUDE.md vs. --append-system-prompt96* 所有輸出樣式都在系統提示的末尾添加了自己的自訂指令。

97* 所有輸出樣式都會在對話期間觸發提醒，讓 Claude 遵守輸出樣式指令。

98* 自訂輸出樣式排除了 Claude Code 的內建軟體工程指令，例如如何限定變更範圍、編寫註解和驗證工作，除非 `keep-coding-instructions` 設定為 `true`。

90 99 

91根據 Claude 是否應該停止充當編碼助手或保持其預設角色並學習更多內容來選擇。輸出樣式用您自己的角色和聲音替換 Claude Code 系統提示中的軟體工程部分，因此當 Claude 應該採用不同的身份（例如寫作編輯或數據分析助手）時，請使用一個。CLAUDE.md 和 `--append-system-prompt` 都保持 Claude Code 的預設身份並添加到它，因此當 Claude 應該保持編碼助手身份同時遵循您的專案慣例或額外指示時，請使用它們。100Token 使用量取決於樣式。將指令添加到系統提示會增加輸入 token，儘管 prompt caching 在工作階段中的第一個請求之後會降低此成本。內建的 Explanatory 和 Learning 樣式按設計會產生比預設更長的回應，這會增加輸出 token。對於自訂樣式，輸出 token 使用量取決於您的指令告訴 Claude 要產生什麼。

92 101 

93機制也不同。輸出樣式直接編輯系統提示。CLAUDE.md 在系統提示之後將其內容添加為使用者訊息。`--append-system-prompt` 將內容附加到系統提示的末尾，而不移除任何內容。102## 與相關功能的比較

94 103 

95### 輸出樣式 vs. [Agents](/zh-TW/sub-agents)104多個功能自訂 Claude Code 的行為方式。輸出樣式直接修改系統提示並應用於每個回應。其他功能添加指令而不改變預設系統提示，或將其限定於特定任務。

96 105 

97使用輸出樣式在每個工作階段中改變主對話的回應方式。當您想要一個單獨作用域的幫助程式，由主對話委派給它時，請使用 [subagent](/zh-TW/sub-agents)。輸出樣式僅影響主代理迴圈的系統提示。Agents 處理特定任務，可以攜帶自己的模型、工具和有關何時呼叫它們的上下文。106| 功能 | 工作原理 | 使用時機 |

107| :-------------------------- | :------------------- | :-------------------------- |

108| 輸出樣式 | 修改系統提示 | 您希望每次都有不同的角色、語氣或預設回應格式 |

109| [CLAUDE.md](/zh-TW/memory) | 在系統提示之後添加使用者訊息 | Claude 應該始終知道您的專案慣例和程式碼庫上下文 |

110| `--append-system-prompt` | 附加到系統提示而不移除任何內容 | 您希望為單個呼叫進行一次性添加 |

111| [Agents](/zh-TW/sub-agents) | 使用自己的系統提示、模型和工具運行子代理 | 您希望為專注任務提供單獨作用域的幫助程式 |

112| [Skills](/zh-TW/skills) | 在呼叫或相關時載入特定於任務的指令 | 您有可重複使用的工作流程 |

98 113 

99### 輸出樣式 vs. [Skills](/zh-TW/skills)114## 相關資源

100 115 

101輸出樣式修改 Claude 的回應方式（格式、語氣、結構），一旦選擇就始終處於活動狀態。Skills 是特定於任務的提示，您可以使用 `/skill-name` 呼叫或 Claude 在相關時自動載入。使用輸出樣式來實現一致的格式設定偏好；使用 skills 來實現可重複使用的工作流程和任務。116* [Settings](/zh-TW/settings)：`outputStyle` 欄位所在位置以及設定優先順序的工作原理

117* [Permission modes](/zh-TW/permission-modes)：Proactive 樣式鏡像自動模式而不改變您的權限模式

118* [Plugins](/zh-TW/plugins)：與 skills、hooks 和 agents 一起打包和分發輸出樣式

119* [Debug your configuration](/zh-TW/debug-your-config)：診斷為什麼輸出樣式沒有生效

138 138 

139#### 唯讀命令139#### 唯讀命令

140 140 

141Claude Code 將一組內建的 Bash 命令識別為唯讀，並在每種模式中無需權限提示即可執行它們。這些包括 `ls`、`cat`、`head`、`tail`、`grep`、`find`、`wc`、`diff`、`stat`、`du`、`cd` 和 `git` 的唯讀形式。該集合不可設定；若要要求其中一個命令的提示，請為其新增 `ask` 或 `deny` 規則。141Claude Code 將一組內建的 Bash 命令識別為唯讀，並在每種模式中無需權限提示即可執行它們。這些包括 `ls`、`cat`、`echo`、`pwd`、`head`、`tail`、`grep`、`find`、`wc`、`which`、`diff`、`stat`、`du`、`cd` 和 `git` 的唯讀形式。該集合不可設定；若要要求其中一個命令的提示，請為其新增 `ask` 或 `deny` 規則。

142 142 

143對於每個旗標都是唯讀的命令，允許未引用的 glob 模式，所以 `ls *.ts` 和 `wc -l src/*.py` 無需提示即可執行。具有寫入能力或執行能力旗標的命令，如 `find`、`sort`、`sed` 和 `git`，在存在未引用的 glob 時仍會提示，因為 glob 可能會擴展為像 `-delete` 這樣的旗標。143對於每個旗標都是唯讀的命令，允許未引用的 glob 模式，所以 `ls *.ts` 和 `wc -l src/*.py` 無需提示即可執行。具有寫入能力或執行能力旗標的命令，如 `find`、`sort`、`sed` 和 `git`，在存在未引用的 glob 時仍會提示，因為 glob 可能會擴展為像 `-delete` 這樣的旗標。

144 144 

290| `.claude/settings.json` 中的外掛設定 | 僅 `enabledPlugins` 和 `extraKnownMarketplaces` |290| `.claude/settings.json` 中的外掛設定 | 僅 `enabledPlugins` 和 `extraKnownMarketplaces` |

291| [CLAUDE.md](/zh-TW/memory) 檔案、`.claude/rules/` 和 `CLAUDE.local.md` | 僅當設定 `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1` 時。`CLAUDE.local.md` 另外需要 `local` 設定來源，預設啟用 |291| [CLAUDE.md](/zh-TW/memory) 檔案、`.claude/rules/` 和 `CLAUDE.local.md` | 僅當設定 `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1` 時。`CLAUDE.local.md` 另外需要 `local` 設定來源，預設啟用 |

292 292 

293其他所有內容，包括 subagents、命令、輸出樣式、hooks 和其他設定，僅從目前工作目錄及其父目錄、您在 `~/.claude/` 的使用者目錄和受管理設定發現。若要在專案間共享該設定，請使用以下方法之一：293Subagents、命令和輸出樣式是從目前工作目錄及其父目錄、您在 `~/.claude/` 的使用者目錄和受管理設定發現的。Hooks 和其他 `settings.json` 金鑰從目前工作目錄的 `.claude/` 資料夾載入，沒有父目錄回退，同時也從您的使用者 `~/.claude/settings.json` 和受管理設定載入。若要在專案間共享該設定，請使用以下方法之一：

294 294 

295* **使用者級別設定**：將檔案放在 `~/.claude/agents/`、`~/.claude/output-styles/` 或 `~/.claude/settings.json` 中，使其在每個專案中可用295* **使用者級別設定**：將檔案放在 `~/.claude/agents/`、`~/.claude/output-styles/` 或 `~/.claude/settings.json` 中，使其在每個專案中可用

296* **外掛**：將設定打包並分發為 [plugin](/zh-TW/plugins)，供團隊安裝296* **外掛**：將設定打包並分發為 [plugin](/zh-TW/plugins)，供團隊安裝

353 353 

354如果工具在任何級別被拒絕，沒有其他級別可以允許它。例如，受管理設定 deny 無法被 `--allowedTools` 覆蓋，`--disallowedTools` 可以新增超出受管理設定定義的限制。354如果工具在任何級別被拒絕，沒有其他級別可以允許它。例如，受管理設定 deny 無法被 `--allowedTools` 覆蓋，`--disallowedTools` 可以新增超出受管理設定定義的限制。

355 355 

356如果權限在使用者設定中被允許但在專案設定中被拒絕，專案設定優先，權限被阻止。356嵌入主機可以在 [`parentSettingsBehavior`](/zh-TW/settings#settings-precedence) 設定為 `"merge"` 時，透過 SDK `managedSettings` 選項提供額外的受管理原則；嵌入器值可以收緊原則但不能放寬它。

357 

358例如，如果使用者設定允許某項權限而專案設定拒絕它，deny 規則會阻止它。反之亦然：使用者級別的 deny 會阻止專案級別的 allow，因為來自任何範圍的 deny 規則會在 allow 規則之前進行評估。

357 359 

358## 範例設定360## 範例設定

359 361 

305claude --plugin-dir ./my-plugin.zip305claude --plugin-dir ./my-plugin.zip

306```306```

307 307 

308當 `--plugin-dir` plugin 與已安裝的市場 plugin 具有相同名稱時，本地副本在該工作階段中優先。這讓您可以測試已安裝的 plugin 的變更，而無需先卸載它。由受管設定強制啟用的市場 plugins 是唯一的例外，無法被覆蓋。308當 `--plugin-dir` plugin 與已安裝的市場 plugin 具有相同名稱時，本地副本在該工作階段中優先。這讓您可以測試已安裝的 plugin 的變更，而無需先卸載它。由受管設定強制啟用或強制停用的 plugins 是唯一的例外：`--plugin-dir` 無法覆蓋這些。

309 309 

310當您對 plugin 進行變更時，執行 `/reload-plugins` 以取得更新，無需重新啟動。這會重新載入 plugins、skills、agents、hooks、plugin MCP servers 和 plugin LSP servers。測試您的 plugin 元件：310當您對 plugin 進行變更時，執行 `/reload-plugins` 以取得更新，無需重新啟動。這會重新載入 plugins、skills、agents、hooks、plugin MCP servers 和 plugin LSP servers。測試您的 plugin 元件：

311 311 

516* **新增到預設值**：`skills`。預設 `skills/` 目錄始終被掃描，`skills` 中列出的目錄與其一起載入516* **新增到預設值**：`skills`。預設 `skills/` 目錄始終被掃描，`skills` 中列出的目錄與其一起載入

517* **自有合併規則**：[hooks](#hooks)、[MCP servers](#mcp-servers) 和 [LSP servers](#lsp-servers)。請參閱每個部分以了解多個來源如何組合517* **自有合併規則**：[hooks](#hooks)、[MCP servers](#mcp-servers) 和 [LSP servers](#lsp-servers)。請參閱每個部分以了解多個來源如何組合

518 518 

519當 plugin 同時具有預設資料夾和相符的 manifest 金鑰時，Claude Code v2.1.140 及更新版本會在 `/doctor`、`claude plugin list` 和 `/plugin` 詳細檢視中標記被忽略的資料夾。plugin 仍會使用 manifest 路徑載入。當 manifest 金鑰指向預設資料夾時不會顯示警告，例如 `"commands": ["./commands/deploy.md"]`，因為在這種情況下資料夾是明確定址的。

520 

519對於所有路徑欄位：521對於所有路徑欄位：

520 522 

521* 所有路徑必須相對於 plugin 根目錄，並以 `./` 開頭523* 所有路徑必須相對於 plugin 根目錄，並以 `./` 開頭

170 170 

171在啟用此設定之前，請確保您的網路原則允許連線到 `api.anthropic.com`。如果該端點無法到達，CLI 會在啟動時結束，使用者無法啟動 Claude Code。171在啟用此設定之前，請確保您的網路原則允許連線到 `api.anthropic.com`。如果該端點無法到達，CLI 會在啟動時結束，使用者無法啟動 Claude Code。

172 172 

173自 v2.1.139 起，`claude auth` 子命令（例如 `claude auth login`）不受此檢查限制，因此使用者可以在過期認證是設定擷取失敗原因時重新驗證。

174 

173### 安全核准對話方塊175### 安全核准對話方塊

174 176 

175某些可能造成安全風險的設定需要明確的使用者核准才能套用：177某些可能造成安全風險的設定需要明確的使用者核准才能套用：

207| :-------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------- |209| :-------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------- |

208| 使用者編輯快取的設定檔 | 篡改的檔案在啟動時套用，但正確的設定會在下次伺服器擷取時還原 |210| 使用者編輯快取的設定檔 | 篡改的檔案在啟動時套用，但正確的設定會在下次伺服器擷取時還原 |

209| 使用者刪除快取的設定檔 | 首次啟動行為發生：設定非同步擷取，有一個簡短的未強制執行視窗 |211| 使用者刪除快取的設定檔 | 首次啟動行為發生：設定非同步擷取，有一個簡短的未強制執行視窗 |

210| API 無法使用 | 如果可用，快取設定會套用，否則受管設定在下次成功擷取之前不會強制執行。使用 `forceRemoteSettingsRefresh: true` 時，CLI 會結束而不是繼續 |212| API 無法使用 | 如果可用，快取設定會套用，否則受管設定在下次成功擷取之前不會強制執行。使用 `forceRemoteSettingsRefresh: true` 時，CLI 會結束而不是繼續，除了 [`claude auth` 子命令](#enforce-fail-closed-startup) |

211| 使用者使用不同的組織進行身份驗證 | 不會為受管組織外的帳戶傳遞設定 |213| 使用者使用不同的組織進行身份驗證 | 不會為受管組織外的帳戶傳遞設定 |

212| 使用者設定[第三方模型提供者](#platform-availability) | 伺服器管理的設定會被略過。這包括設定 `CLAUDE_CODE_USE_BEDROCK`、`CLAUDE_CODE_USE_MANTLE`、`CLAUDE_CODE_USE_VERTEX`、`CLAUDE_CODE_USE_FOUNDRY` 或非預設的 `ANTHROPIC_BASE_URL` |214| 使用者設定[第三方模型提供者](#platform-availability) | 伺服器管理的設定會被略過。這包括設定 `CLAUDE_CODE_USE_BEDROCK`、`CLAUDE_CODE_USE_MANTLE`、`CLAUDE_CODE_USE_VERTEX`、`CLAUDE_CODE_USE_FOUNDRY` 或非預設的 `ANTHROPIC_BASE_URL` |

213 215 

49 49 

50### 範圍如何互動50### 範圍如何互動

51 51 

52當相同的設定在多個範圍中配置時，更具體的範圍優先：52當相同的設定在多個範圍中出現時，Claude Code 會按優先順序應用它們：

53 53 

541. **Managed**（最高）- 無法被任何東西覆蓋541. **Managed**（最高）- 無法被任何東西覆蓋

552. **命令列引數** - 臨時工作階段覆蓋552. **命令列引數** - 臨時工作階段覆蓋

574. **Project** - 覆蓋使用者設定574. **Project** - 覆蓋使用者設定

585. **User**（最低）- 當沒有其他東西指定設定時適用585. **User**（最低）- 當沒有其他東西指定設定時適用

59 59 

60例如，如果使用者設定中允許某個權限，但專案設定中拒絕該權限，則專案設定優先，該權限被阻止。60例如，如果您的使用者設定將 `spinnerTipsEnabled` 設定為 `true`，而專案設定將其設定為 `false`，則專案值適用。權限規則的行為不同，因為它們跨範圍合併而不是覆蓋。請參閱[設定優先順序](#settings-precedence)。

61 61 

62### 哪些功能使用範圍62### 哪些功能使用範圍

63 63 

268| :---------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------ |268| :---------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------ |

269| `worktree.baseRef` | 新 worktrees 分支的來源 ref。`"fresh"`（預設）從 `origin/<default-branch>` 分支以取得與遠端相符的乾淨樹。`"head"` 從您目前的本機 `HEAD` 分支，因此未推送的提交和功能分支狀態存在於 worktree 中。適用於 `--worktree`、`EnterWorktree` 工具和 subagent 隔離 | `"head"` |269| `worktree.baseRef` | 新 worktrees 分支的來源 ref。`"fresh"`（預設）從 `origin/<default-branch>` 分支以取得與遠端相符的乾淨樹。`"head"` 從您目前的本機 `HEAD` 分支，因此未推送的提交和功能分支狀態存在於 worktree 中。適用於 `--worktree`、`EnterWorktree` 工具和 subagent 隔離 | `"head"` |

270| `worktree.symlinkDirectories` | 要從主儲存庫符號連結到每個 worktree 的目錄，以避免在磁碟上複製大型目錄。預設不符號連結任何目錄 | `["node_modules", ".cache"]` |270| `worktree.symlinkDirectories` | 要從主儲存庫符號連結到每個 worktree 的目錄，以避免在磁碟上複製大型目錄。預設不符號連結任何目錄 | `["node_modules", ".cache"]` |

271| `worktree.sparsePaths` | 要在每個 worktree 中透過 git sparse-checkout（cone 模式）簽出的目錄。僅將列出的路徑寫入磁碟，在大型 monorepos 中速度更快 | `["packages/my-app", "shared/utils"]` |271| `worktree.sparsePaths` | 要在每個 worktree 中透過 git sparse-checkout 簽出的目錄。僅將列出的目錄加上根層級檔案寫入磁碟，在大型 monorepos 中速度更快 | `["packages/my-app", "shared/utils"]` |

272 272 

273若要將 gitignored 檔案（如 `.env`）複製到新的 worktrees，請改用專案根目錄中的 [`.worktreeinclude` 檔案](/zh-TW/worktrees#copy-gitignored-files-into-worktrees)，而不是設定。273若要將 gitignored 檔案（如 `.env`）複製到新的 worktrees，請改用專案根目錄中的 [`.worktreeinclude` 檔案](/zh-TW/worktrees#copy-gitignored-files-into-worktrees)，而不是設定。

274 274 

672* `hostPattern`：正規表達式模式以符合 marketplace 主機（使用 `hostPattern`）672* `hostPattern`：正規表達式模式以符合 marketplace 主機（使用 `hostPattern`）

673* `settings`：直接在 settings.json 中宣告的內嵌 marketplace，無需單獨的託管儲存庫（使用 `name` 和 `plugins`）673* `settings`：直接在 settings.json 中宣告的內嵌 marketplace，無需單獨的託管儲存庫（使用 `name` 和 `plugins`）

674 674 

675每個 marketplace 項目也接受選用的 `autoUpdate` 布林值。在 `source` 旁邊設定 `"autoUpdate": true`，使 Claude Code 在啟動時重新整理該 marketplace 並更新其已安裝的 plugins。省略時，官方 Anthropic marketplaces 預設為 `true`，所有其他 marketplaces 預設為 `false`。請參閱[設定自動更新](/zh-TW/discover-plugins#configure-auto-updates)。

676 

675使用 `source: 'settings'` 宣告一小組 plugins，無需設定託管 marketplace 儲存庫。此處列出的 Plugins 必須參考外部來源，例如 GitHub 或 npm。您仍需要在 `enabledPlugins` 中分別啟用每個 plugin。677使用 `source: 'settings'` 宣告一小組 plugins，無需設定託管 marketplace 儲存庫。此處列出的 Plugins 必須參考外部來源，例如 GitHub 或 npm。您仍需要在 `enabledPlugins` 中分別啟用每個 plugin。

676 678 

677```json theme={null}679```json theme={null}

99 99 

100#### 從巢狀目錄自動發現100#### 從巢狀目錄自動發現

101 101 

102當您在子目錄中使用檔案時，Claude Code 會自動從巢狀 `.claude/skills/` 目錄發現 skills。例如，如果您正在編輯 `packages/frontend/` 中的檔案，Claude Code 也會在 `packages/frontend/.claude/skills/` 中尋找 skills。這支援 monorepo 設定，其中套件有自己的 skills。102專案 skills 從您的起始目錄中的 `.claude/skills/` 以及直到儲存庫根目錄的每個父目錄中載入，因此在子目錄中啟動 Claude 仍會拾取在根目錄定義的 skills。當您在起始目錄下方的子目錄中使用檔案時，Claude Code 也會按需從巢狀 `.claude/skills/` 目錄發現 skills。例如，如果您正在編輯 `packages/frontend/` 中的檔案，Claude Code 也會在 `packages/frontend/.claude/skills/` 中尋找 skills。這支援 monorepo 設定，其中套件有自己的 skills。

103 103 

104每個 skill 是一個以 `SKILL.md` 作為進入點的目錄：104每個 skill 是一個以 `SKILL.md` 作為進入點的目錄：

105 105 

49Ultrareview 是一項高級功能，按額外使用量而非您計畫的包含使用量計費。49Ultrareview 是一項高級功能，按額外使用量而非您計畫的包含使用量計費。

50 50 

51| 計畫 | 包含的免費執行次數 | 免費執行次數後 |51| 計畫 | 包含的免費執行次數 | 免費執行次數後 |

52| ----------------- | ------------------------ | -------------------------------------------------------------------------------------------------- |52| ----------------- | --------- | -------------------------------------------------------------------------------------------------- |

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

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

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

56 56 

57Pro 和 Max 訂閱者獲得三次免費 ultrareview 執行以試用該功能。這三次執行是每個帳戶的一次性配額，不會刷新，並於 2026 年 5 月 5 日過期。使用完全部三次後，或在免費執行期結束後，每次審查都會計入額外使用量，通常成本為 $5 至 $20，具體取決於變更的大小。一次執行在遠端工作階段開始時計算，因此您提前停止或未能完成的審查仍會使用一次免費執行。對於付費審查，額外使用量僅針對執行的部分計費。57Pro 和 Max 訂閱者獲得三次免費 ultrareview 執行以試用該功能。這三次執行是每個帳戶的一次性配額，不會刷新。使用完全部三次後，或在免費執行期結束後，每次審查都會計入額外使用量，通常成本為 $5 至 $20，具體取決於變更的大小。一次執行在遠端工作階段開始時計算，因此您提前停止或未能完成的審查仍會使用一次免費執行。對於付費審查，額外使用量僅針對執行的部分計費。

58 58 

59由於 ultrareview 在免費執行次數外始終按額外使用量計費，您的帳戶或組織必須在啟動付費審查前啟用額外使用量。如果未啟用額外使用量，Claude Code 會阻止啟動並將您連結到計費設定，您可以在那裡開啟它。您也可以執行 `/extra-usage` 來檢查或變更您目前的設定。59由於 ultrareview 在免費執行次數外始終按額外使用量計費，您的帳戶或組織必須在啟動付費審查前啟用額外使用量。如果未啟用額外使用量，Claude Code 會阻止啟動並將您連結到計費設定，您可以在那裡開啟它。您也可以執行 `/extra-usage` 來檢查或變更您目前的設定。

60 60