Documentation 2026-05-10 23:03 UTC to 2026-05-11 23:00 UTC

64受管設定可以鎖定工具、沙箱執行、限制 MCP 伺服器和外掛程式來源，以及控制哪些 hooks 執行。每一行都是一個控制表面，具有驅動它的設定鍵。64受管設定可以鎖定工具、沙箱執行、限制 MCP 伺服器和外掛程式來源，以及控制哪些 hooks 執行。每一行都是一個控制表面，具有驅動它的設定鍵。

65 65 

66| 控制 | 它的作用 | 關鍵設定 |66| 控制 | 它的作用 | 關鍵設定 |

67| :---------------------------------------------------------------------------------------- | :-------------------------------------------- | :--------------------------------------------------------------------------- |67| :---------------------------------------------------------------------------------------- | :--------------------------------------------- | :--------------------------------------------------------------------------- |

68| [Permission rules](/zh-TW/permissions) | 允許、詢問或拒絕特定工具和命令 | `permissions.allow`、`permissions.deny` |68| [Permission rules](/zh-TW/permissions) | 允許、詢問或拒絕特定工具和命令 | `permissions.allow`、`permissions.deny` |

69| [Permission lockdown](/zh-TW/permissions#managed-only-settings) | 僅受管權限規則適用；禁用 `--dangerously-skip-permissions` | `allowManagedPermissionRulesOnly`、`permissions.disableBypassPermissionsMode` |69| [Permission lockdown](/zh-TW/permissions#managed-only-settings) | 僅受管權限規則適用；禁用 `--dangerously-skip-permissions` | `allowManagedPermissionRulesOnly`、`permissions.disableBypassPermissionsMode` |

70| [Sandboxing](/zh-TW/sandboxing) | 作業系統級別的檔案系統和網路隔離，具有網域允許清單 | `sandbox.enabled`、`sandbox.network.allowedDomains` |70| [Sandboxing](/zh-TW/sandboxing) | 作業系統級別的檔案系統和網路隔離，具有網域允許清單 | `sandbox.enabled`、`sandbox.network.allowedDomains` |

72| [MCP server control](/zh-TW/mcp#managed-mcp-configuration) | 限制使用者可以新增或連接的 MCP 伺服器 | `allowedMcpServers`、`deniedMcpServers`、`allowManagedMcpServersOnly` |72| [MCP server control](/zh-TW/mcp#managed-mcp-configuration) | 限制使用者可以新增或連接的 MCP 伺服器 | `allowedMcpServers`、`deniedMcpServers`、`allowManagedMcpServersOnly` |

73| [Plugin marketplace control](/zh-TW/plugin-marketplaces#managed-marketplace-restrictions) | 限制使用者可以新增和安裝的市場來源 | `strictKnownMarketplaces`、`blockedMarketplaces` |73| [Plugin marketplace control](/zh-TW/plugin-marketplaces#managed-marketplace-restrictions) | 限制使用者可以新增和安裝的市場來源 | `strictKnownMarketplaces`、`blockedMarketplaces` |

74| [Hook restrictions](/zh-TW/settings#hook-configuration) | 僅受管 hooks 載入；限制 HTTP hook URL | `allowManagedHooksOnly`、`allowedHttpHookUrls` |74| [Hook restrictions](/zh-TW/settings#hook-configuration) | 僅受管 hooks 載入；限制 HTTP hook URL | `allowManagedHooksOnly`、`allowedHttpHookUrls` |

75| [Disable agent view](/zh-TW/agent-view#how-background-sessions-are-hosted) | 關閉 `claude agents`、`--bg`、`/background` 和隨選監督員 | `disableAgentView` |

75| [Version floor](/zh-TW/settings) | 防止自動更新安裝低於組織範圍最小值的版本 | `minimumVersion` |76| [Version floor](/zh-TW/settings) | 防止自動更新安裝低於組織範圍最小值的版本 | `minimumVersion` |

76 77 

77權限規則和沙箱涵蓋不同的層。拒絕 WebFetch 會阻止 Claude 的 fetch 工具，但如果允許 Bash，`curl` 和 `wget` 仍然可以到達任何 URL。沙箱透過在作業系統級別執行的網路網域允許清單來彌補這一差距。78權限規則和沙箱涵蓋不同的層。拒絕 WebFetch 會阻止 Claude 的 fetch 工具，但如果允許 Bash，`curl` 和 `wget` 仍然可以到達任何 URL。沙箱透過在作業系統級別執行的網路網域允許清單來彌補這一差距。

90 SDK 也支援透過第三方 API 提供者進行身份驗證：90 SDK 也支援透過第三方 API 提供者進行身份驗證：

91 91 

92 * **Amazon Bedrock**：設定 `CLAUDE_CODE_USE_BEDROCK=1` 環境變數並配置 AWS 認證92 * **Amazon Bedrock**：設定 `CLAUDE_CODE_USE_BEDROCK=1` 環境變數並配置 AWS 認證

93 * **Claude Platform on AWS**：設定 `CLAUDE_CODE_USE_ANTHROPIC_AWS=1` 和 `ANTHROPIC_AWS_WORKSPACE_ID`，然後配置 AWS 認證

93 * **Google Vertex AI**：設定 `CLAUDE_CODE_USE_VERTEX=1` 環境變數並配置 Google Cloud 認證94 * **Google Vertex AI**：設定 `CLAUDE_CODE_USE_VERTEX=1` 環境變數並配置 Google Cloud 認證

94 * **Microsoft Azure**：設定 `CLAUDE_CODE_USE_FOUNDRY=1` 環境變數並配置 Azure 認證95 * **Microsoft Azure**：設定 `CLAUDE_CODE_USE_FOUNDRY=1` 環境變數並配置 Azure 認證

95 96 

96 有關詳細資訊，請參閱 [Bedrock](/zh-TW/amazon-bedrock)、[Vertex AI](/zh-TW/google-vertex-ai) 或 [Azure AI Foundry](/zh-TW/microsoft-foundry) 的設定指南。97 有關詳細資訊，請參閱 [Bedrock](/zh-TW/amazon-bedrock)、[Claude Platform on AWS](/zh-TW/claude-platform-on-aws)、[Vertex AI](/zh-TW/google-vertex-ai) 或 [Azure AI Foundry](/zh-TW/microsoft-foundry) 的設定指南。

97 98 

98 <Note>99 <Note>

99 除非事先獲得批准，否則 Anthropic 不允許第三方開發人員為其產品（包括基於 Claude Agent SDK 構建的代理）提供 claude.ai 登入或速率限制。請改用本文件中描述的 API 金鑰身份驗證方法。100 除非事先獲得批准，否則 Anthropic 不允許第三方開發人員為其產品（包括基於 Claude Agent SDK 構建的代理）提供 claude.ai 登入或速率限制。請改用本文件中描述的 API 金鑰身份驗證方法。

2294 2294 

2295```python theme={null}2295```python theme={null}

2296{2296{

2297 "description": str, # A short (3-5 word) description of the task2297 "description": str, # 任務的簡短描述（3-5 個單詞）

2298 "prompt": str, # The task for the agent to perform2298 "prompt": str, # agent 要執行的任務

2299 "subagent_type": str, # The type of specialized agent to use2299 "subagent_type": str, # 要使用的專門 agent 類型

2300}2300}

2301```2301```

2302 2302 

2304 2304 

2305```python theme={null}2305```python theme={null}

2306{2306{

2307 "result": str, # Final result from the subagent2307 "result": str, # 來自 subagent 的最終結果

2308 "usage": dict | None, # Token usage statistics2308 "usage": dict | None, # Token 使用統計

2309 "total_cost_usd": float | None, # Estimated total cost in USD2309 "total_cost_usd": float | None, # 估計的美元總成本

2310 "duration_ms": int | None, # Execution duration in milliseconds2310 "duration_ms": int | None, # 執行持續時間（毫秒）

2311}2311}

2312```2312```

2313 2313 

2321 2321 

2322```python theme={null}2322```python theme={null}

2323{2323{

2324 "questions": [ # Questions to ask the user (1-4 questions)2324 "questions": [ # 要詢問使用者的問題（1-4 個問題）

2325 {2325 {

2326 "question": str, # The complete question to ask the user2326 "question": str, # 要詢問使用者的完整問題

2327 "header": str, # Very short label displayed as a chip/tag (max 12 chars)2327 "header": str, # 顯示為晶片/標籤的非常簡短標籤（最多 12 個字元）

2328 "options": [ # The available choices (2-4 options)2328 "options": [ # 可用的選擇（2-4 個選項）

2329 {2329 {

2330 "label": str, # Display text for this option (1-5 words)2330 "label": str, # 此選項的顯示文字（1-5 個單詞）

2331 "description": str, # Explanation of what this option means2331 "description": str, # 此選項含義的說明

2332 }2332 }

2333 ],2333 ],

2334 "multiSelect": bool, # Set to true to allow multiple selections2334 "multiSelect": bool, # 設定為 true 以允許多個選擇

2335 }2335 }

2336 ],2336 ],

2337 "answers": dict[str, str | list[str]] | None,2337 "answers": dict[str, str | list[str]] | None,

2338 # User answers populated by the permission system. Multi-select2338 # 由權限系統填入的使用者答案。多選

2339 # answers may be a list of labels or a comma-joined string2339 # 答案可能是標籤列表或逗號連接的字串

2340}2340}

2341```2341```

2342 2342 

2344 2344 

2345```python theme={null}2345```python theme={null}

2346{2346{

2347 "questions": [ # The questions that were asked2347 "questions": [ # 被詢問的問題

2348 {2348 {

2349 "question": str,2349 "question": str,

2350 "header": str,2350 "header": str,

2352 "multiSelect": bool,2352 "multiSelect": bool,

2353 }2353 }

2354 ],2354 ],

2355 "answers": dict[str, str], # Maps question text to answer string2355 "answers": dict[str, str], # 將問題文字對應到答案字串

2356 # Multi-select answers are comma-separated2356 # 多選答案以逗號分隔

2357}2357}

2358```2358```

2359 2359 

2365 2365 

2366```python theme={null}2366```python theme={null}

2367{2367{

2368 "command": str, # The command to execute2368 "command": str, # 要執行的命令

2369 "timeout": int | None, # Optional timeout in milliseconds (max 600000)2369 "timeout": int | None, # 可選的逾時時間（毫秒）（最多 600000）

2370 "description": str | None, # Clear, concise description (5-10 words)2370 "description": str | None, # 清晰、簡潔的描述（5-10 個單詞）

2371 "run_in_background": bool | None, # Set to true to run in background2371 "run_in_background": bool | None, # 設定為 true 以在背景執行

2372}2372}

2373```2373```

2374 2374 

2376 2376 

2377```python theme={null}2377```python theme={null}

2378{2378{

2379 "output": str, # Combined stdout and stderr output2379 "output": str, # 合併的 stdout 和 stderr 輸出

2380 "exitCode": int, # Exit code of the command2380 "exitCode": int, # 命令的結束代碼

2381 "killed": bool | None, # Whether command was killed due to timeout2381 "killed": bool | None, # 命令是否因逾時而被終止

2382 "shellId": str | None, # Shell ID for background processes2382 "shellId": str | None, # 背景程序的 Shell ID

2383}2383}

2384```2384```

2385 2385 

2393 2393 

2394```python theme={null}2394```python theme={null}

2395{2395{

2396 "command": str, # Shell script; each stdout line is an event, exit ends the watch2396 "command": str, # Shell 腳本；每個 stdout 行是一個事件，結束會停止監視

2397 "description": str, # Short description shown in notifications2397 "description": str, # 在通知中顯示的簡短描述

2398 "timeout_ms": int | None, # Kill after this deadline (default 300000, max 3600000)2398 "timeout_ms": int | None, # 在此期限後終止（預設 300000，最多 3600000）

2399 "persistent": bool | None, # Run for the lifetime of the session; stop with TaskStop2399 "persistent": bool | None, # 在工作階段的生命週期內執行；使用 TaskStop 停止

2400}2400}

2401```2401```

2402 2402 

2404 2404 

2405```python theme={null}2405```python theme={null}

2406{2406{

2407 "taskId": str, # ID of the background monitor task2407 "taskId": str, # 背景監視任務的 ID

2408 "timeoutMs": int, # Timeout deadline in milliseconds (0 when persistent)2408 "timeoutMs": int, # 逾時期限（毫秒）（持續時為 0）

2409 "persistent": bool | None, # True when running until TaskStop or session end2409 "persistent": bool | None, # 當執行到 TaskStop 或工作階段結束時為 True

2410}2410}

2411```2411```

2412 2412 

2418 2418 

2419```python theme={null}2419```python theme={null}

2420{2420{

2421 "file_path": str, # The absolute path to the file to modify2421 "file_path": str, # 要修改的檔案的絕對路徑

2422 "old_string": str, # The text to replace2422 "old_string": str, # 要替換的文字

2423 "new_string": str, # The text to replace it with2423 "new_string": str, # 用來替換的文字

2424 "replace_all": bool | None, # Replace all occurrences (default False)2424 "replace_all": bool | None, # 替換所有出現次數（預設 False）

2425}2425}

2426```2426```

2427 2427 

2429 2429 

2430```python theme={null}2430```python theme={null}

2431{2431{

2432 "message": str, # Confirmation message2432 "message": str, # 確認訊息

2433 "replacements": int, # Number of replacements made2433 "replacements": int, # 進行的替換次數

2434 "file_path": str, # File path that was edited2434 "file_path": str, # 被編輯的檔案路徑

2435}2435}

2436```2436```

2437 2437 

2443 2443 

2444```python theme={null}2444```python theme={null}

2445{2445{

2446 "file_path": str, # The absolute path to the file to read2446 "file_path": str, # 要讀取的檔案的絕對路徑

2447 "offset": int | None, # The line number to start reading from2447 "offset": int | None, # 開始讀取的行號

2448 "limit": int | None, # The number of lines to read2448 "limit": int | None, # 要讀取的行數

2449}2449}

2450```2450```

2451 2451 

2453 2453 

2454```python theme={null}2454```python theme={null}

2455{2455{

2456 "content": str, # File contents with line numbers2456 "content": str, # 包含行號的檔案內容

2457 "total_lines": int, # Total number of lines in file2457 "total_lines": int, # 檔案中的總行數

2458 "lines_returned": int, # Lines actually returned2458 "lines_returned": int, # 實際返回的行數

2459}2459}

2460```2460```

2461 2461 

2463 2463 

2464```python theme={null}2464```python theme={null}

2465{2465{

2466 "image": str, # Base64 encoded image data2466 "image": str, # Base64 編碼的影像資料

2467 "mime_type": str, # Image MIME type2467 "mime_type": str, # 影像 MIME 類型

2468 "file_size": int, # File size in bytes2468 "file_size": int, # 檔案大小（位元組）

2469}2469}

2470```2470```

2471 2471 

2477 2477 

2478```python theme={null}2478```python theme={null}

2479{2479{

2480 "file_path": str, # The absolute path to the file to write2480 "file_path": str, # 要寫入的檔案的絕對路徑

2481 "content": str, # The content to write to the file2481 "content": str, # 要寫入檔案的內容

2482}2482}

2483```2483```

2484 2484 

2486 2486 

2487```python theme={null}2487```python theme={null}

2488{2488{

2489 "message": str, # Success message2489 "message": str, # 成功訊息

2490 "bytes_written": int, # Number of bytes written2490 "bytes_written": int, # 寫入的位元組數

2491 "file_path": str, # File path that was written2491 "file_path": str, # 被寫入的檔案路徑

2492}2492}

2493```2493```

2494 2494 

2500 2500 

2501```python theme={null}2501```python theme={null}

2502{2502{

2503 "pattern": str, # The glob pattern to match files against2503 "pattern": str, # 要與檔案匹配的 glob 模式

2504 "path": str | None, # The directory to search in (defaults to cwd)2504 "path": str | None, # 要搜尋的目錄（預設為 cwd）

2505}2505}

2506```2506```

2507 2507 

2509 2509 

2510```python theme={null}2510```python theme={null}

2511{2511{

2512 "matches": list[str], # Array of matching file paths2512 "matches": list[str], # 匹配的檔案路徑陣列

2513 "count": int, # Number of matches found2513 "count": int, # 找到的匹配數

2514 "search_path": str, # Search directory used2514 "search_path": str, # 使用的搜尋目錄

2515}2515}

2516```2516```

2517 2517 

2523 2523 

2524```python theme={null}2524```python theme={null}

2525{2525{

2526 "pattern": str, # The regular expression pattern2526 "pattern": str, # 正規表達式模式

2527 "path": str | None, # File or directory to search in2527 "path": str | None, # 要搜尋的檔案或目錄

2528 "glob": str | None, # Glob pattern to filter files2528 "glob": str | None, # 用於篩選檔案的 glob 模式

2529 "type": str | None, # File type to search2529 "type": str | None, # 要搜尋的檔案類型

2530 "output_mode": str | None, # "content", "files_with_matches", or "count"2530 "output_mode": str | None, # "content"、"files_with_matches" 或 "count"

2531 "-i": bool | None, # Case insensitive search2531 "-i": bool | None, # 不區分大小寫搜尋

2532 "-n": bool | None, # Show line numbers2532 "-n": bool | None, # 顯示行號

2533 "-B": int | None, # Lines to show before each match2533 "-B": int | None, # 每個匹配前顯示的行數

2534 "-A": int | None, # Lines to show after each match2534 "-A": int | None, # 每個匹配後顯示的行數

2535 "-C": int | None, # Lines to show before and after2535 "-C": int | None, # 匹配前後顯示的行數

2536 "head_limit": int | None, # Limit output to first N lines/entries2536 "head_limit": int | None, # 將輸出限制為前 N 行/項目

2537 "multiline": bool | None, # Enable multiline mode2537 "multiline": bool | None, # 啟用多行模式

2538}2538}

2539```2539```

2540 2540 

2559 2559 

2560```python theme={null}2560```python theme={null}

2561{2561{

2562 "files": list[str], # Files containing matches2562 "files": list[str], # 包含匹配的檔案

2563 "count": int, # Number of files with matches2563 "count": int, # 包含匹配的檔案數

2564}2564}

2565```2565```

2566 2566 

2572 2572 

2573```python theme={null}2573```python theme={null}

2574{2574{

2575 "notebook_path": str, # Absolute path to the Jupyter notebook2575 "notebook_path": str, # Jupyter notebook 的絕對路徑

2576 "cell_id": str | None, # The ID of the cell to edit2576 "cell_id": str | None, # 要編輯的儲存格的 ID

2577 "new_source": str, # The new source for the cell2577 "new_source": str, # 儲存格的新來源

2578 "cell_type": "code" | "markdown" | None, # The type of the cell2578 "cell_type": "code" | "markdown" | None, # 儲存格的類型

2579 "edit_mode": "replace" | "insert" | "delete" | None, # Edit operation type2579 "edit_mode": "replace" | "insert" | "delete" | None, # 編輯操作類型

2580}2580}

2581```2581```

2582 2582 

2584 2584 

2585```python theme={null}2585```python theme={null}

2586{2586{

2587 "message": str, # Success message2587 "message": str, # 成功訊息

2588 "edit_type": "replaced" | "inserted" | "deleted", # Type of edit performed2588 "edit_type": "replaced" | "inserted" | "deleted", # 執行的編輯類型

2589 "cell_id": str | None, # Cell ID that was affected2589 "cell_id": str | None, # 受影響的儲存格 ID

2590 "total_cells": int, # Total cells in notebook after edit2590 "total_cells": int, # 編輯後 notebook 中的總儲存格數

2591}2591}

2592```2592```

2593 2593 

2599 2599 

2600```python theme={null}2600```python theme={null}

2601{2601{

2602 "url": str, # The URL to fetch content from2602 "url": str, # 要從中擷取內容的 URL

2603 "prompt": str, # The prompt to run on the fetched content2603 "prompt": str, # 在擷取的內容上執行的提示

2604}2604}

2605```2605```

2606 2606 

2608 2608 

2609```python theme={null}2609```python theme={null}

2610{2610{

2611 "response": str, # AI model's response to the prompt2611 "bytes": int, # 擷取內容的大小（位元組）

2612 "url": str, # URL that was fetched2612 "code": int, # HTTP 回應代碼

2613 "final_url": str | None, # Final URL after redirects2613 "codeText": str, # HTTP 回應代碼文字

2614 "status_code": int | None, # HTTP status code2614 "result": str, # 將提示應用於內容的處理結果

2615 "durationMs": int, # 擷取和處理內容的時間（毫秒）

2616 "url": str, # 被擷取的 URL

2615}2617}

2616```2618```

2617 2619 

2623 2625 

2624```python theme={null}2626```python theme={null}

2625{2627{

2626 "query": str, # The search query to use2628 "query": str, # 要使用的搜尋查詢

2627 "allowed_domains": list[str] | None, # Only include results from these domains2629 "allowed_domains": list[str] | None, # 僅包含來自這些網域的結果

2628 "blocked_domains": list[str] | None, # Never include results from these domains2630 "blocked_domains": list[str] | None, # 永遠不包含來自這些網域的結果

2629}2631}

2630```2632```

2631 2633 

2633 2635 

2634```python theme={null}2636```python theme={null}

2635{2637{

2636 "results": [{"title": str, "url": str, "snippet": str, "metadata": dict | None}],2638 "query": str, # 搜尋查詢

2637 "total_results": int,2639 "results": list[str | {"tool_use_id": str, "content": list[{"title": str, "url": str}]}],

2638 "query": str,2640 "durationSeconds": float, # 搜尋持續時間（秒）

2639}2641}

2640```2642```

2641 2643 

2649{2651{

2650 "todos": [2652 "todos": [

2651 {2653 {

2652 "content": str, # The task description2654 "content": str, # 任務描述

2653 "status": "pending" | "in_progress" | "completed", # Task status2655 "status": "pending" | "in_progress" | "completed", # 任務狀態

2654 "activeForm": str, # Active form of the description2656 "activeForm": str, # 描述的主動形式

2655 }2657 }

2656 ]2658 ]

2657}2659}

2661 2663 

2662```python theme={null}2664```python theme={null}

2663{2665{

2664 "message": str, # Success message2666 "message": str, # 成功訊息

2665 "stats": {"total": int, "pending": int, "in_progress": int, "completed": int},2667 "stats": {"total": int, "pending": int, "in_progress": int, "completed": int},

2666}2668}

2667```2669```

2674 2676 

2675```python theme={null}2677```python theme={null}

2676{2678{

2677 "bash_id": str, # The ID of the background shell2679 "bash_id": str, # 背景 shell 的 ID

2678 "filter": str | None, # Optional regex to filter output lines2680 "filter": str | None, # 用於篩選輸出行的可選正規表達式

2679}2681}

2680```2682```

2681 2683 

2683 2685 

2684```python theme={null}2686```python theme={null}

2685{2687{

2686 "output": str, # New output since last check2688 "output": str, # 自上次檢查以來的新輸出

2687 "status": "running" | "completed" | "failed", # Current shell status2689 "status": "running" | "completed" | "failed", # 目前 shell 狀態

2688 "exitCode": int | None, # Exit code when completed2690 "exitCode": int | None, # 完成時的結束代碼

2689}2691}

2690```2692```

2691 2693 

2697 2699 

2698```python theme={null}2700```python theme={null}

2699{2701{

2700 "shell_id": str # The ID of the background shell to kill2702 "shell_id": str # 要終止的背景 shell 的 ID

2701}2703}

2702```2704```

2703 2705 

2705 2707 

2706```python theme={null}2708```python theme={null}

2707{2709{

2708 "message": str, # Success message2710 "message": str, # 成功訊息

2709 "shell_id": str, # ID of the killed shell2711 "shell_id": str, # 被終止的 shell 的 ID

2710}2712}

2711```2713```

2712 2714 

2718 2720 

2719```python theme={null}2721```python theme={null}

2720{2722{

2721 "plan": str # The plan to run by the user for approval2723 "plan": str # 使用者要執行以供批准的計畫

2722}2724}

2723```2725```

2724 2726 

2726 2728 

2727```python theme={null}2729```python theme={null}

2728{2730{

2729 "message": str, # Confirmation message2731 "message": str, # 確認訊息

2730 "approved": bool | None, # Whether user approved the plan2732 "approved": bool | None, # 使用者是否批准計畫

2731}2733}

2732```2734```

2733 2735 

2739 2741 

2740```python theme={null}2742```python theme={null}

2741{2743{

2742 "server": str | None # Optional server name to filter resources by2744 "server": str | None # 可選的伺服器名稱以篩選資源

2743}2745}

2744```2746```

2745 2747 

75 SDK 還支持通過第三方 API 提供商進行身份驗證：75 SDK 還支持通過第三方 API 提供商進行身份驗證：

76 76 

77 * **Amazon Bedrock**：設置 `CLAUDE_CODE_USE_BEDROCK=1` 環境變量並配置 AWS 憑證77 * **Amazon Bedrock**：設置 `CLAUDE_CODE_USE_BEDROCK=1` 環境變量並配置 AWS 憑證

78 * **Claude Platform on AWS**：設置 `CLAUDE_CODE_USE_ANTHROPIC_AWS=1` 和 `ANTHROPIC_AWS_WORKSPACE_ID`，然後配置 AWS 憑證

78 * **Google Vertex AI**：設置 `CLAUDE_CODE_USE_VERTEX=1` 環境變量並配置 Google Cloud 憑證79 * **Google Vertex AI**：設置 `CLAUDE_CODE_USE_VERTEX=1` 環境變量並配置 Google Cloud 憑證

79 * **Microsoft Azure**：設置 `CLAUDE_CODE_USE_FOUNDRY=1` 環境變量並配置 Azure 憑證80 * **Microsoft Azure**：設置 `CLAUDE_CODE_USE_FOUNDRY=1` 環境變量並配置 Azure 憑證

80 81 

81 有關詳細信息，請參閱 [Bedrock](/zh-TW/amazon-bedrock)、[Vertex AI](/zh-TW/google-vertex-ai) 或 [Azure AI Foundry](/zh-TW/microsoft-foundry) 的設置指南。82 有關詳細信息，請參閱 [Bedrock](/zh-TW/amazon-bedrock)、[Claude Platform on AWS](/zh-TW/claude-platform-on-aws)、[Vertex AI](/zh-TW/google-vertex-ai) 或 [Azure AI Foundry](/zh-TW/microsoft-foundry) 的設置指南。

82 83 

83 <Note>84 <Note>

84 除非事先獲得批准，否則 Anthropic 不允許第三方開發人員提供 claude.ai 登錄或對其產品的速率限制，包括基於 Claude Agent SDK 構建的代理。請改用本文檔中描述的 API 密鑰身份驗證方法。85 除非事先獲得批准，否則 Anthropic 不允許第三方開發人員提供 claude.ai 登錄或對其產品的速率限制，包括基於 Claude Agent SDK 構建的代理。請改用本文檔中描述的 API 密鑰身份驗證方法。

173 174 

1742. **`prompt`**：您希望 Claude 執行的操作。Claude 根據任務確定要使用哪些工具。1752. **`prompt`**：您希望 Claude 執行的操作。Claude 根據任務確定要使用哪些工具。

175 176 

1763. **`options`**：代理的配置。此示例使用 `allowedTools` 預先批准 `Read`、`Edit` 和 `Glob`，並使用 `permissionMode: "acceptEdits"` 自動批准文件更改。其他選項包括 `systemPrompt`、`mcpServers` 等。請參閱 [Python](/zh-TW/agent-sdk/python#claude-agent-options) 或 [TypeScript](/zh-TW/agent-sdk/typescript#options) 的所有選項。1773. **`options`**：代理的配置。此示例使用 `allowedTools` 預先批准 `Read`、`Edit` 和 `Glob`，並使用 `permissionMode: "acceptEdits"` 自動批准文件更改。其他選項包括 `systemPrompt`、`mcpServers` 等。請參閱 [Python](/zh-TW/agent-sdk/python#claudeagentoptions) 或 [TypeScript](/zh-TW/agent-sdk/typescript#options) 的所有選項。

177 178 

178`async for` 循環在 Claude 思考、調用工具、觀察結果並決定下一步操作時持續運行。每次迭代都會產生一條消息：Claude 的推理、工具調用、工具結果或最終結果。SDK 處理編排（工具執行、上下文管理、重試），因此您只需使用流。當 Claude 完成任務或遇到錯誤時，循環結束。179`async for` 循環在 Claude 思考、調用工具、觀察結果並決定下一步操作時持續運行。每次迭代都會產生一條消息：Claude 的推理、工具調用、工具結果或最終結果。SDK 處理編排（工具執行、上下文管理、重試），因此您只需使用流。當 Claude 完成任務或遇到錯誤時，循環結束。

179 180 

210這就是 Agent SDK 的不同之處：Claude 直接執行工具，而不是要求您實現它們。211這就是 Agent SDK 的不同之處：Claude 直接執行工具，而不是要求您實現它們。

211 212 

212<Note>213<Note>

213 如果您看到"API key not found"，請確保您已在 `.env` 文件或 shell 環境中設置 `ANTHROPIC_API_KEY` 環境變量。有關更多幫助，請參閱[完整故障排除指南](/zh-TW/troubleshooting)。214 如果您看到「API key not found」，請確保您已在 `.env` 文件或 shell 環境中設置 `ANTHROPIC_API_KEY` 環境變量。有關更多幫助，請參閱[完整故障排除指南](/zh-TW/troubleshooting)。

214</Note>215</Note>

215 216 

216### 嘗試其他提示217### 嘗試其他提示

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# 使用 Agent view 管理多個代理

6 

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

8 

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

10 

11當您有多個獨立任務 Claude 可以同時處理時，請使用 agent view，例如修復錯誤、審查拉取請求或調查日誌。當您想一起解決問題時，附加到工作階段並像往常一樣以互動方式使用 Claude Code。工作階段在 agent view 中獨立執行，並且只向您報告。若要與 subagents、agent teams 和 worktrees 進行比較，請參閱 [平行執行代理](/zh-TW/agents)。

12 

13<Note>

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

15</Note>

16 

17本頁涵蓋：

18 

19* [快速開始](#quick-start)

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

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

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

23* [背景工作階段如何被託管](#how-background-sessions-are-hosted)，由監督程序

24 

25## 快速開始

26 

27本逐步解說開啟 agent view、分派工作階段、從查看面板回覆，以及附加到完整對話。

28 

29<Steps>

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

31 從您的 shell，執行：

32 

33 ```bash theme={null}

34 claude agents

35 ```

36 

37 Agent view 開啟，底部有輸入框，隨著工作階段啟動，表格會填入。隨時按 `Esc` 退出。您的工作階段繼續執行。

38 </Step>

39 

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

41 在輸入框中輸入提示，然後按 `Enter`。新工作階段啟動並顯示為一行，顯示它是否正在工作、等待您或已完成。重複此操作以並行執行任意數量的工作階段。

42 </Step>

43 

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

45 使用箭頭鍵選擇一行，然後按 `Space` 查看工作階段正在做什麼或需要您提供什麼。輸入回覆並按 `Enter` 發送，無需離開 agent view。

46 </Step>

47 

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

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

50 </Step>

51</Steps>

52 

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

54 

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

56 

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

58 

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

60 

61該列表對您的機器是全局的，包括每個背景工作階段，無論它在哪個專案或 worktree 中工作。您在其他終端中開啟的互動工作階段在您 [背景化它們](#from-inside-a-session) 之前不會出現，[subagents](/zh-TW/sub-agents) 在工作階段內執行時不會列為單獨的行。

62 

63```text theme={null}

64Pinned

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

66 

67Ready for review

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

69 

70Needs input

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

72 

73Working

74 ✽ collision detection Edit src/physics/CollisionSystem.ts 2m

75 ✢ playtest level 3 run 12 · all checkpoints cleared in 4m

76 

77Completed

78 ✻ title screen result: menu, options, and credits done 9m

79 ∙ sound effects result: 14 SFX exported to assets/audio 4h

80 … 6 more

81```

82 

83圖示告訴您工作階段的狀態：

84 

85| 圖示 | 狀態 | 含義 |

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

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

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

89| 淡化 | 閒置 | 工作階段正在等待輸入，但不會被特定問題阻止 |

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

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

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

93 

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

95 

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

97 

98工作階段在磁碟上持久化：關閉終端或自動更新不會丟失它們，重新開啟 `claude agents` 會顯示它們全部。如果您的機器進入睡眠或關閉，執行中的工作階段會停止；使用 `claude respawn --all` 重新啟動它們。

99 

100每行中的單行摘要由您配置的 [Haiku-class 模型](/zh-TW/model-config) 生成，因此該行可以告訴您工作階段正在做什麼、需要什麼或生成了什麼，無需開啟記錄。每個摘要是通過您的正常提供者的一個簡短 Haiku-class 請求，按照與工作階段本身相同的 [資料使用條款](/zh-TW/data-usage) 計費和處理。

101 

102當工作階段開啟拉取請求時，該行顯示 PR 連結和其 CI 檢查的狀態指示器。對於大多數任務，此行是您收集工作的方式：當其檢查通過時審查並合併拉取請求。

103 

104### 查看和回覆

105 

106在選定的行上按 `Space` 開啟查看面板。它顯示工作階段需要您提供什麼、其最近的輸出以及它開啟的任何拉取請求。大多數時候這就足夠了，您永遠不需要開啟完整記錄。

107 

108在查看面板中輸入回覆並按 `Enter` 將其發送到該工作階段。當工作階段詢問多選問題時，查看面板顯示選項，您可以按數字鍵選擇一個。對於其他被阻止的工作階段，按 `Tab` 用建議的回覆填充輸入，您可以在發送前編輯。使用 `!` 前綴回覆以發送 Bash 命令。

109 

110使用 `↑` 和 `↓` 查看相鄰工作階段而無需關閉面板，或按 `→` 附加。

111 

112### 附加到工作階段

113 

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

115 

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

117 

118在空提示上按 `←` 分離並返回 agent view。如果對話框有焦點且不響應 `←`，按 `Ctrl+Z` 立即分離。

119 

120分離永遠不會停止背景工作階段：`←`、`Ctrl+C`、`Ctrl+D`、`Ctrl+Z` 和 `/exit` 都會讓它繼續執行。要從內部結束工作階段，執行 `/stop`。

121 

122使用 agent view 後，在空提示上按 `←` 可從任何 Claude Code 工作階段工作，而不僅僅是您附加的工作階段。它開啟 agent view，預先選擇您的當前工作階段，因此您可以在不離開終端的情況下切換工作階段。

123 

124### 組織列表

125 

126Agent view 按狀態分組工作階段，需要輸入的工作階段在工作或完成的工作階段上方。按 `Ctrl+S` 改為按目錄分組。您的選擇在執行中保存。在組內，使用 `Ctrl+T` 將工作階段固定到頂部，使用 `Shift+↑` 和 `Shift+↓` 重新排序，或在組標題上按 `Enter` 摺疊它。要移除工作階段，按 `Ctrl+X` 停止它，然後在兩秒內再次按 `Ctrl+X` 刪除它。在組標題上按 `Ctrl+X` 會在確認後刪除該組中的每個工作階段。

127 

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

129 

130### 篩選列表

131 

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

133 

134| 篩選 | 顯示 |

135| :------------------- | :----------------------------------- |

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

137| `s:<state>` | 給定狀態中的工作階段，例如 `s:blocked` 表示需要您的工作階段 |

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

139 

140### 快捷鍵

141 

142在 agent view 中按 `?` 查看每個快捷鍵。最常見的：

143 

144| 快捷鍵 | 動作 |

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

146| `↑` / `↓` | 在行之間移動 |

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

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

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

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

151| `Alt+1`..`Alt+9` | 附加到焦點組中的第 N 個工作階段 |

152| `Tab` | 瀏覽所有 subagents，或應用突出顯示的建議 |

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

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

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

156| `Ctrl+G` | 在您的 `$EDITOR` 中開啟分派提示 |

157| `Ctrl+X` | 停止工作階段；在兩秒內再次按以刪除它 |

158| `Shift+↑` / `Shift+↓` | 重新排序選定的工作階段 |

159| `Esc` | 關閉查看面板、清除輸入或退出 |

160| `Ctrl+C` | 清除輸入；按兩次退出 |

161| `?` | 顯示所有快捷鍵 |

162 

163## 分派新代理

164 

165您可以從 agent view 分派新的背景工作階段、將現有互動工作階段發送到背景，或直接從 shell 啟動一個。

166 

167### 從 agent view

168 

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

170 

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

172 

173| 輸入 | 效果 |

174| :---------------------- | :---------------------------------------------------------------------------------------- |

175| `<agent-name> <prompt>` | 如果第一個單詞與自訂 [subagent](/zh-TW/sub-agents) 名稱匹配，該 subagent 以工作階段的主代理身份執行，其 frontmatter 中的配置 |

176| `@<agent-name>` | 在提示中的任何地方提及自訂 subagent 以將其作為主代理執行 |

177| `@<repo>` | 提及您開啟 agent view 的目錄下的存儲庫以在那裡執行工作階段 |

178| `/<skill>` | 建議 [skills](/zh-TW/skills) 作為提示分派 |

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

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

181 

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

183 

184#### 分派到特定目錄

185 

186新工作階段在您開啟 agent view 的目錄中執行。要針對不同的目錄：

187 

188* 在該目錄中開啟 `claude agents`。

189* 在包含多個存儲庫的父目錄中開啟 `claude agents`，並在提示中使用 `@<repo>` 提及一個以在那裡執行工作階段。

190* 從 shell，`cd` 進入目錄並執行 `claude --bg "<prompt>"`。

191 

192當 agent view 按目錄分組時，突出顯示的行的目錄成為分派目標，因此您可以滾動到組並在其中分派，無需重新輸入路徑。

193 

194#### 在 worktree 中隔離檔案編輯

195 

196從 agent view 分派的工作階段預設共享您的工作目錄，因此兩個代理編輯相同檔案可能會衝突。為了防止這種情況，Claude Code 阻止從 agent view 分派的工作階段寫入檔案，直到它移動到隔離的 [git worktree](/zh-TW/worktrees)。當 Claude 需要編輯檔案時，它會自動處理此問題。worktree 在專案目錄內的 `.claude/worktrees/` 下建立，當您刪除工作階段時移除。刪除工作階段也會刪除其 worktree，因此在刪除前合併或推送您想保留的更改。

197 

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

199 

200### 從工作階段內部

201 

202執行 `/background` 或其別名 `/bg` 分離當前對話並保持其執行。傳遞提示，例如 `/bg run the test suite and fix any failures`，在分離前發送一個額外的指令。

203 

204### 從 shell

205 

206傳遞 `--bg` 啟動直接進入背景的工作階段：

207 

208```bash theme={null}

209claude --bg "investigate the flaky SettingsChangeDetector test"

210```

211 

212要執行特定 subagent 作為工作階段的主代理，將 `--bg` 與 `--agent` 結合：

213 

214```bash theme={null}

215claude --agent code-reviewer --bg "address review comments on PR 1234"

216```

217 

218背景化後，Claude 列印工作階段的短 ID 和管理它的命令：

219 

220```text theme={null}

221backgrounded · 7c5dcf5d

222 claude agents list sessions

223 claude attach 7c5dcf5d open in this terminal

224 claude logs 7c5dcf5d show recent output

225 claude stop 7c5dcf5d stop this session

226```

227 

228## 從 shell 管理工作階段

229 

230每個背景工作階段都有一個短 ID，您可以從 shell 使用。這些命令對於指令碼編寫或當您不想開啟 agent view 時很有用。

231 

232| 命令 | 目的 |

233| :--------------------- | :----------------------- |

234| `claude agents` | 開啟 agent view |

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

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

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

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

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

240| `claude rm <id>` | 從列表中移除工作階段 |

241 

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

243 

244背景工作階段由每個使用者的監督程序託管，與您的終端和 agent view 分開。它在您第一次背景化工作階段或開啟 agent view 時自動啟動，您不直接管理它。監督程序及其工作階段使用與互動工作階段相同的認證進行身份驗證，並且除了模型 API 外不進行額外的網路連接。

245 

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

247 

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

249 

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

251 

252| 路徑 | 內容 |

253| :------------------------------- | :------------------------ |

254| `~/.claude/daemon.log` | 監督程序日誌 |

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

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

257 

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

259 

260## 故障排除

261 

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

263 

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

265 

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

267 

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

269 

270### 附加後工作階段響應緩慢

271 

272一旦工作階段完成並在未附加的情況下閒置約一小時，監督程序停止其程序以釋放資源。附加啟動從中斷的地方開始的新程序，這需要一些時間。正在工作或等待您的工作階段永遠不會以這種方式停止。

273 

274### `.claude/worktrees/` 正在填滿

275 

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

277 

278## 限制

279 

280Agent view 是研究預覽版本。要注意的當前限制：

281 

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

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

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

285 

286## 後續步驟

287 

288現在您了解了 agent view，探索這些相關功能：

289 

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

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

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

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

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# 並行運行代理

6 

7> 比較 Claude Code 同時處理多個任務的方式：子代理、代理視圖、代理團隊和隔離的 worktree 會話。

8 

9[子代理](/zh-TW/sub-agents)、[代理視圖](/zh-TW/agent-view)、[代理團隊](/zh-TW/agent-teams) 和 [worktrees](/zh-TW/worktrees) 各自以不同的方式並行化工作。正確的選擇取決於您是否想要自己留在每個對話中、交付任務並稍後檢查，或讓 Claude 為您協調一組工作人員。

10 

11| 方法 | 它提供什麼 | 何時使用 |

12| :---------------------------- | :----------------------------------------------- | :---------------------------------- |

13| [子代理](/zh-TW/sub-agents) | 在一個會話內的委派工作人員，在自己的上下文中執行側任務並返回摘要 | 側任務會用搜尋結果、日誌或您不會再次參考的文件內容淹沒您的主要對話 |

14| [代理視圖](/zh-TW/agent-view) | 一個屏幕來調度和監控在後台運行的會話，使用 `claude agents` 打開。研究預覽 | 您有多個獨立任務，想要交付它們，一目了然地檢查狀態，並且只在需要時介入 |

15| [代理團隊](/zh-TW/agent-teams) | 多個協調的會話，具有共享任務列表和代理間消息傳遞，由領導者管理。實驗性功能，默認禁用 | 您希望 Claude 將項目分成多個部分、分配它們並保持工作人員同步 |

16| [Worktrees](/zh-TW/worktrees) | 單獨的 git 檢出，以便並行會話永遠不會接觸彼此的文件 | 您正在自己運行多個會話，或您的子代理編輯重疊的文件 |

17| [`/batch`](/zh-TW/commands) | 將一個大型更改計劃分成 5 到 30 個 worktree 隔離的子代理，每個都打開一個拉取請求 | 您可以在一個指令中描述的存儲庫範圍遷移或機械重構 |

18 

19在每種方法中，工作人員都是 Claude 會話。要涉及不同的工具，請將其作為 [MCP server](/zh-TW/mcp) 公開給 Claude。

20 

21您可以組合這些方法。代理視圖在需要編輯文件時自動將每個調度的會話移動到自己的 worktree 中，而您正在處理的會話可以生成子代理，每個都獲得自己的 worktree。

22 

23<Note>

24 同時運行多個會話或子代理會增加令牌使用量。有關使用情況和速率限制詳細信息，請參閱 [Costs](/zh-TW/costs)。

25</Note>

26 

27## 選擇一種方法

28 

29正確的方法取決於誰協調工作、工作人員是否需要通信以及他們是否編輯相同的文件：

30 

31* **誰協調工作？** 如果您希望 Claude 在一個對話中委派和收集結果，請使用 [子代理](/zh-TW/sub-agents)。如果您正在交付獨立任務並檢查它們，請使用 [代理視圖](/zh-TW/agent-view)。如果您希望 Claude 計劃、分配和監督一組工作人員，請使用 [代理團隊](/zh-TW/agent-teams)，這是實驗性的且默認禁用。

32* **工作人員需要相互交談嗎？** 子代理將結果報告回生成它們的對話，代理視圖會話只向您報告。代理團隊中的隊友共享任務列表並直接相互發送消息。

33* **任務是否涉及相同的文件？** 使用 [worktrees](/zh-TW/worktrees) 隔離工作。子代理和您自己運行的會話可以各自使用單獨的 worktree。代理團隊不會在 worktrees 中隔離隊友，因此 [分區工作](/zh-TW/agent-teams#avoid-file-conflicts)，以便每個隊友擁有不同的文件集。

34 

35## 檢查運行中的工作

36 

37檢查運行中工作的命令取決於您使用的方法：

38 

39* 對於後台會話，`claude agents` 打開 [代理視圖](/zh-TW/agent-view)：一個屏幕顯示每個會話、其狀態以及哪些需要您的輸入。

40* 對於當前會話中的子代理，`/agents` 打開一個面板，其中 **Running** 選項卡列出實時子代理，**Library** 選項卡是您 [創建和編輯自定義子代理](/zh-TW/sub-agents#use-the-%2Fagents-command) 的地方。儘管名稱相似，但這與 `claude agents` 分開。

41* 對於當前會話後台運行的任何內容，`/tasks` 列出每個項目，並讓您檢查、附加到或停止它。

42 

43有關所有會話的桌面視圖，請參閱 [桌面應用中的並行會話](/zh-TW/desktop#work-in-parallel-with-sessions)。

44 

45## 了解更多

46 

47下面的每個指南涵蓋一種方法的設置和配置：

48 

49* [創建自定義子代理](/zh-TW/sub-agents)：定義可重用的專家並控制他們可以使用的工具。

50* [使用代理視圖管理代理](/zh-TW/agent-view)：調度會話、監視其狀態並在需要時附加。

51* [協調代理團隊](/zh-TW/agent-teams)：設置領導者和隊友、分配任務並審查他們的工作。

52* [使用 worktrees 運行並行會話](/zh-TW/worktrees)：在隔離的檢出中啟動 Claude、控制複製的內容並在之後進行清理。

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# AWS 上的 Claude Platform 上的 Claude Code

6 

7> 設定 Claude Code 以使用 Anthropic 營運的 Claude API，搭配 AWS 驗證、IAM 存取控制和 AWS Marketplace 計費。

8 

9export const ContactSalesCard = ({surface}) => {

10 const utm = content => `utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}`;

11 const iconArrowRight = (size = 13) => <svg width={size} height={size} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">

12 <line x1="5" y1="12" x2="19" y2="12" />

13 <polyline points="12 5 19 12 12 19" />

14 </svg>;

15 const STYLES = `

16.cc-cs {

17 --cs-slate: #141413;

18 --cs-clay: #d97757;

19 --cs-clay-deep: #c6613f;

20 --cs-gray-000: #ffffff;

21 --cs-gray-700: #3d3d3a;

22 --cs-border-default: rgba(31, 30, 29, 0.15);

23 font-family: inherit;

24}

25.dark .cc-cs {

26 --cs-slate: #f0eee6;

27 --cs-gray-000: #262624;

28 --cs-gray-700: #bfbdb4;

29 --cs-border-default: rgba(240, 238, 230, 0.14);

30}

31.cc-cs-card {

32 display: flex; align-items: center; justify-content: space-between;

33 gap: 16px; padding: 14px 16px; margin: 0;

34 background: var(--cs-gray-000); border: 0.5px solid var(--cs-border-default);

35 border-radius: 8px; flex-wrap: wrap;

36}

37.cc-cs-text { font-size: 13px; color: var(--cs-gray-700); line-height: 1.5; flex: 1; min-width: 240px; }

38.cc-cs-text strong { font-weight: 550; color: var(--cs-slate); }

39.cc-cs-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; }

40.cc-cs-btn-clay {

41 display: inline-flex; align-items: center; gap: 8px;

42 background: var(--cs-clay-deep); color: #fff; border: none;

43 border-radius: 8px; padding: 8px 14px;

44 font-size: 13px; font-weight: 500;

45 transition: background-color 0.15s; white-space: nowrap;

46}

47.cc-cs-btn-clay:hover { background: var(--cs-clay); }

48.cc-cs-btn-ghost {

49 display: inline-flex; align-items: center; gap: 8px;

50 background: transparent; color: var(--cs-gray-700);

51 border: 0.5px solid var(--cs-border-default);

52 border-radius: 8px; padding: 8px 14px;

53 font-size: 13px; font-weight: 500;

54}

55.cc-cs-btn-ghost:hover { background: rgba(0, 0, 0, 0.04); }

56.dark .cc-cs-btn-ghost:hover { background: rgba(255, 255, 255, 0.04); }

57@media (max-width: 720px) {

58 .cc-cs-actions { width: 100%; }

59}

60`;

61 return <div className="cc-cs not-prose">

62 <style>{STYLES}</style>

63 <div className="cc-cs-card">

64 <div className="cc-cs-text">

65 <strong>Deploying Claude Code across your organization?</strong> Talk to sales about enterprise plans, SSO, and centralized billing.

66 </div>

67 <div className="cc-cs-actions">

68 <a href={`https://claude.com/pricing?${utm('view_plans')}#plans-business`} className="cc-cs-btn-ghost">

69 View plans

70 </a>

71 <a href={`https://claude.com/contact-sales?${utm('contact_sales')}`} className="cc-cs-btn-clay">

72 Contact sales {iconArrowRight()}

73 </a>

74 </div>

75 </div>

76 </div>;

77};

78 

79export const Experiment = ({flag, treatment, children}) => {

80 const VID_KEY = 'exp_vid';

81 const CONSENT_COUNTRIES = new Set(['AT', 'BE', 'BG', 'HR', 'CY', 'CZ', 'DK', 'EE', 'FI', 'FR', 'DE', 'GR', 'HU', 'IE', 'IT', 'LV', 'LT', 'LU', 'MT', 'NL', 'PL', 'PT', 'RO', 'SK', 'SI', 'ES', 'SE', 'RE', 'GP', 'MQ', 'GF', 'YT', 'BL', 'MF', 'PM', 'WF', 'PF', 'NC', 'AW', 'CW', 'SX', 'FO', 'GL', 'AX', 'GB', 'UK', 'AI', 'BM', 'IO', 'VG', 'KY', 'FK', 'GI', 'MS', 'PN', 'SH', 'TC', 'GG', 'JE', 'IM', 'CA', 'BR', 'IN']);

82 const fnv1a = s => {

83 let h = 0x811c9dc5;

84 for (let i = 0; i < s.length; i++) {

85 h ^= s.charCodeAt(i);

86 h += (h << 1) + (h << 4) + (h << 7) + (h << 8) + (h << 24);

87 }

88 return h >>> 0;

89 };

90 const bucket = (seed, vid) => fnv1a(fnv1a(seed + vid) + '') % 10000 < 5000 ? 'control' : 'treatment';

91 const [decision] = useState(() => {

92 const params = new URLSearchParams(location.search);

93 const preBucketed = document.documentElement.dataset['gb_' + flag.replace(/-/g, '_')];

94 const force = params.get('gb-force');

95 if (force) {

96 for (const p of force.split(',')) {

97 const [k, v] = p.split(':');

98 if (k === flag) return {

99 variant: v || 'treatment',

100 track: false

101 };

102 }

103 }

104 if (navigator.globalPrivacyControl) {

105 return {

106 variant: 'control',

107 track: false

108 };

109 }

110 const prefsMatch = document.cookie.match(/(?:^|; )anthropic-consent-preferences=([^;]+)/);

111 if (prefsMatch) {

112 try {

113 if (JSON.parse(decodeURIComponent(prefsMatch[1])).analytics !== true) {

114 return {

115 variant: 'control',

116 track: false

117 };

118 }

119 } catch {

120 return {

121 variant: 'control',

122 track: false

123 };

124 }

125 } else {

126 const country = params.get('country')?.toUpperCase() || (document.cookie.match(/(?:^|; )cf_geo=([A-Z]{2})/) || [])[1];

127 if (!country || CONSENT_COUNTRIES.has(country)) {

128 return {

129 variant: 'control',

130 track: false

131 };

132 }

133 }

134 let vid;

135 try {

136 const ajsMatch = document.cookie.match(/(?:^|; )ajs_anonymous_id=([^;]+)/);

137 if (ajsMatch) {

138 vid = decodeURIComponent(ajsMatch[1]).replace(/^"|"$/g, '');

139 } else {

140 vid = localStorage.getItem(VID_KEY);

141 if (!vid) {

142 vid = crypto.randomUUID();

143 }

144 document.cookie = `ajs_anonymous_id=${vid}; domain=.claude.com; path=/; Secure; SameSite=Lax; max-age=31536000`;

145 }

146 try {

147 localStorage.setItem(VID_KEY, vid);

148 } catch {}

149 } catch {

150 return {

151 variant: 'control',

152 track: false

153 };

154 }

155 const variant = preBucketed === '1' ? 'treatment' : preBucketed === '0' ? 'control' : bucket(flag, vid);

156 return {

157 variant,

158 track: true,

159 vid

160 };

161 });

162 useEffect(() => {

163 if (!decision.track) return;

164 fetch('https://api.anthropic.com/api/event_logging/v2/batch', {

165 method: 'POST',

166 headers: {

167 'Content-Type': 'application/json',

168 'x-service-name': 'claude_code_docs'

169 },

170 body: JSON.stringify({

171 events: [{

172 event_type: 'GrowthbookExperimentEvent',

173 event_data: {

174 device_id: decision.vid,

175 anonymous_id: decision.vid,

176 timestamp: new Date().toISOString(),

177 experiment_id: flag,

178 variation_id: decision.variant === 'treatment' ? 1 : 0,

179 environment: 'production'

180 }

181 }]

182 }),

183 keepalive: true

184 }).catch(() => {});

185 }, []);

186 return decision.variant === 'treatment' ? treatment : children;

187};

188 

189<Experiment flag="docs-contact-sales-cta" treatment={<ContactSalesCard surface="claude_platform_on_aws" />} />

190 

191AWS 上的 Claude Platform 是 Anthropic 營運的 Claude API，具有 AWS 驗證、IAM 存取控制和 AWS Marketplace 計費。請求直接到達 Anthropic 的 API，因此您可以獲得與 [Claude API](https://platform.claude.com/docs) 相同的模型和功能，並遵循相同的發佈時程表。您使用 AWS 認證或工作區 API 金鑰進行驗證，並透過 AWS Marketplace 付款。

192 

193使用本指南將 Claude Code 指向您已透過 AWS 上的 Claude Platform 佈建的工作區。有關在此之前的 AWS 訂閱和工作區設定，請參閱 [AWS 上的 Claude Platform 文件](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws)。

194 

195<Note>

196 透過 AWS Marketplace 訂閱會佈建一個與您的 AWS 帳戶相關聯的新 Anthropic 組織。此組織與您已有的任何 Anthropic 組織分開，認證不會在它們之間轉移。使用來自 AWS 連結組織的工作區 ID 和 API 金鑰，而不是來自預先存在的 Claude Console 帳戶。

197</Note>

198 

199## 先決條件

200 

201在設定 Claude Code 之前，您需要：

202 

203* 透過 AWS Marketplace 的有效 AWS 上的 Claude Platform 訂閱

204* 您的 AWS 連結 Anthropic 組織中的工作區，及其工作區 ID

205* 具有叫用 Anthropic 服務權限的 IAM 主體，或限定於工作區的 API 金鑰

206* 您環境中的 AWS 認證、`~/.aws/credentials` 中的認證，或來自附加 IAM 角色的認證（如果您想要 SigV4 驗證）。AWS CLI 僅在 SSO 登入流程中需要。

207 

208## 設定

209 

210### 1. 設定 AWS 認證

211 

212Claude Code 支援 AWS 上的 Claude Platform 的兩種驗證方法。選擇適合您的團隊如何管理存取的方法。

213 

214**選項 A：使用 SigV4 的 AWS 認證**

215 

216Claude Code 使用標準 AWS 認證鏈使用 SigV4 簽署請求：環境變數、`~/.aws/credentials` 中的共享認證、IAM 角色、AWS SSO 工作階段，以及 AWS SDK 支援的任何其他來源。

217 

218對於本機使用，在啟動 Claude Code 之前使用 AWS CLI 登入。下面的範例使用 SSO 設定檔，但任何在標準位置產生認證的方法都有效。

219 

220```bash theme={null}

221aws sso login --profile my-profile

222export AWS_PROFILE=my-profile

223```

224 

225對於 CI 和自動化，給予執行器具有叫用 Anthropic 服務權限的 IAM 角色，並設定 `AWS_REGION`。認證鏈會自動選取該角色。

226 

227如果您的 SSO 認證在工作階段中途過期，請設定 [`awsAuthRefresh`](/zh-TW/amazon-bedrock#advanced-credential-configuration)，以便 Claude Code 重新執行您的登入命令並重試，而不是失敗。將命令新增至您的 `settings.json`：

228 

229```json theme={null}

230{

231 "awsAuthRefresh": "aws sso login --profile my-profile"

232}

233```

234 

235**選項 B：工作區 API 金鑰**

236 

237工作區 API 金鑰是長期有效的祕密，在您不想管理聯合 AWS 認證時很有用。在 AWS Console 中的 **Claude Platform on AWS → API keys** 下產生一個，並將其設定為 `ANTHROPIC_AWS_API_KEY`：

238 

239```bash theme={null}

240export ANTHROPIC_AWS_API_KEY=sk-ant-xxxxx

241```

242 

243金鑰以 `x-api-key` 形式傳送，優先於 SigV4，因此您環境中的任何 AWS 認證都會被忽略。來自單獨 Claude Console 組織的 API 金鑰在此不起作用。

244 

245將工作區 API 金鑰視為任何其他生產認證。[使用者設定檔](/zh-TW/settings) `env` 區塊是在不全域匯出的情況下將金鑰限定於您的機器的便利方式。

246 

247<Note>

248 `/login` 和 `/logout` 命令不會變更 AWS 上的 Claude Platform 驗證。驗證透過您的 AWS 認證或工作區 API 金鑰執行，而不是透過 Claude.ai 訂閱。

249</Note>

250 

251### 2. 設定 Claude Code

252 

253設定環境變數，將 Claude Code 路由透過 AWS 上的 Claude Platform，而不是預設的 Anthropic API。

254 

255```bash theme={null}

256export CLAUDE_CODE_USE_ANTHROPIC_AWS=1

257export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN

258export AWS_REGION=us-east-1

259```

260 

261`ANTHROPIC_AWS_WORKSPACE_ID` 是必需的，並在每個請求上作為 `anthropic-workspace-id` 標頭傳送。基礎 URL 從 `AWS_REGION` 計算為 `https://aws-external-anthropic.{region}.api.aws`。若要直接覆寫 URL，請設定 `ANTHROPIC_AWS_BASE_URL`。

262 

263即使您的環境中存在 AWS 認證，AWS 上的 Claude Platform 也是選擇加入的。Bedrock 和 Foundry 在提供者路由中優先，因此如果設定了 `CLAUDE_CODE_USE_BEDROCK` 和 `CLAUDE_CODE_USE_FOUNDRY`，請取消設定它們。

264 

265### 3. 固定模型版本

266 

267AWS 上的 Claude Platform 使用與直接 Claude API 相同的模型 ID。預設別名 `opus`、`sonnet` 和 `haiku` 解析為您工作區中可用的最新版本。

268 

269如果您將 Claude Code 部署到團隊，請明確固定模型 ID，以便新版本不會一次移動所有人：

270 

271```bash theme={null}

272export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-7

273export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6

274export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

275```

276 

277有關模型 ID 和別名的完整清單，請參閱[模型概述](https://platform.claude.com/docs/en/about-claude/models/overview)。有關其他模型相關變數，請參閱[模型設定](/zh-TW/model-config)。

278 

279[Prompt caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching) 會自動啟用。1 小時快取寫入的計費率高於 5 分鐘寫入。若要要求 1 小時快取 TTL 而不是 5 分鐘預設值，請設定 `ENABLE_PROMPT_CACHING_1H=1`。

280 

281## 使用 Agent SDK

282 

283[Agent SDK](/zh-TW/agent-sdk/overview) 讀取與 CLI 相同的環境變數，因此任何產生 Claude Code 子程序的程式都可以透過在呼叫前匯出 `CLAUDE_CODE_USE_ANTHROPIC_AWS`、`ANTHROPIC_AWS_WORKSPACE_ID` 和 `ANTHROPIC_AWS_API_KEY` 或 AWS 認證來針對 AWS 上的 Claude Platform。

284 

285```typescript theme={null}

286import { query } from "@anthropic-ai/claude-agent-sdk";

287 

288process.env.CLAUDE_CODE_USE_ANTHROPIC_AWS = "1";

289process.env.ANTHROPIC_AWS_WORKSPACE_ID = "wrkspc_01ABCDEFGHIJKLMN";

290process.env.AWS_REGION = "us-east-1";

291 

292for await (const msg of query({ prompt: "What's in this repo?" })) {

293 console.log(msg);

294}

295```

296 

297此範例依賴環境 AWS 認證鏈進行 SigV4。若要改用工作區 API 金鑰進行驗證，請以相同方式設定 `ANTHROPIC_AWS_API_KEY`。有關更廣泛的 Agent SDK 表面，請參閱 [Agent SDK 概述](/zh-TW/agent-sdk/overview)。

298 

299## 透過公司代理路由

300 

301若要透過代理或 [LLM gateway](/zh-TW/llm-gateway) 路由流量，請將 `ANTHROPIC_AWS_BASE_URL` 設定為代理的位址。Claude Code 將請求傳送至該 URL，並使用相同的工作區和驗證標頭，因此任何轉發它們不變的閘道都有效。

302 

303```bash theme={null}

304export CLAUDE_CODE_USE_ANTHROPIC_AWS=1

305export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN

306export ANTHROPIC_AWS_BASE_URL=https://anthropic-proxy.example.com

307```

308 

309如果您的閘道自行簽署請求，請設定 `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1`，以便 Claude Code 傳送未簽署的請求，並讓閘道在轉發到 AWS 之前新增 SigV4 標頭。如果閘道需要自己的權杖，請在 `ANTHROPIC_AUTH_TOKEN` 中設定它。

310 

311```bash theme={null}

312export CLAUDE_CODE_USE_ANTHROPIC_AWS=1

313export CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1

314export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN

315export ANTHROPIC_AWS_BASE_URL=https://anthropic-proxy.example.com

316```

317 

318## Troubleshooting

319 

320執行 `/status` 以查看已解析的提供者和任何明確設定的工作區 ID、區域、基礎 URL 覆寫和驗證跳過設定。這是確認 Claude Code 是否完全針對 AWS 上的 Claude Platform 的最快方式。

321 

322### 每個請求上都出現 `403 Forbidden` 或 `AccessDenied`

323 

324Claude Code 解析的 IAM 主體可能缺少在您的工作區中叫用 Anthropic 服務的權限。檢查附加到您的 AWS 設定檔或啟動 Claude Code 的執行器的角色，並驗證它具有 [IAM 動作參考](https://platform.claude.com/docs/en/api/claude-platform-on-aws-iam-actions)中記錄的 `aws-external-anthropic` 動作。

325 

326如果您設定了 `ANTHROPIC_AWS_API_KEY`，金鑰優先於 SigV4，過期的金鑰會產生相同的錯誤。在 AWS Console 中的 **Claude Platform on AWS → API keys** 下重新產生金鑰，或取消設定變數以回退到您的 AWS 認證。

327 

328### 請求失敗，出現遺失工作區錯誤

329 

330`ANTHROPIC_AWS_WORKSPACE_ID` 可能未設定或為空。每個 AWS 上的 Claude Platform 請求都必須包含工作區 ID。它不是由您的 AWS 認證隱含的。在 AWS Console 服務頁面上的 **Workspaces** 下找到 ID，並在啟動 Claude Code 之前匯出它。

331 

332### 請求仍然轉到 `api.anthropic.com`

333 

334`CLAUDE_CODE_USE_ANTHROPIC_AWS` 可能未設定或設定為不解析為真值的值。將其設定為 `1` 並執行 `/status` 以確認已解析的提供者。如果也設定了 `CLAUDE_CODE_USE_BEDROCK` 或 `CLAUDE_CODE_USE_FOUNDRY`，那些優先於 AWS 上的 Claude Platform。

335 

336## 其他資源

337 

338設定 Claude Code 之前的 AWS 上的 Claude Platform 訂閱、工作區和 IAM 設定涵蓋在平台文件中：

339 

340* [AWS 上的 Claude Platform 概述](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws)：訂閱、工作區設定和產品參考

341* [IAM 動作參考](https://platform.claude.com/docs/en/api/claude-platform-on-aws-iam-actions)：權限和受管原則

24| `claude auth login` | 登入您的 Anthropic 帳戶。使用 `--email` 預先填入您的電子郵件地址，使用 `--sso` 強制進行 SSO 驗證，使用 `--console` 以 Anthropic Console 登入以進行 API 使用計費，而不是 Claude 訂閱 | `claude auth login --console` |24| `claude auth login` | 登入您的 Anthropic 帳戶。使用 `--email` 預先填入您的電子郵件地址，使用 `--sso` 強制進行 SSO 驗證，使用 `--console` 以 Anthropic Console 登入以進行 API 使用計費，而不是 Claude 訂閱 | `claude auth login --console` |

25| `claude auth logout` | 從您的 Anthropic 帳戶登出 | `claude auth logout` |25| `claude auth logout` | 從您的 Anthropic 帳戶登出 | `claude auth logout` |

26| `claude auth status` | 以 JSON 格式顯示驗證狀態。使用 `--text` 以人類可讀的格式輸出。如果已登入則以代碼 0 退出，如果未登入則以代碼 1 退出 | `claude auth status` |26| `claude auth status` | 以 JSON 格式顯示驗證狀態。使用 `--text` 以人類可讀的格式輸出。如果已登入則以代碼 0 退出，如果未登入則以代碼 1 退出 | `claude auth status` |

27| `claude agents` | 列出所有已設定的 [subagents](/zh-TW/sub-agents)，按來源分組 | `claude agents` |27| `claude agents` | 開啟 [agent view](/zh-TW/agent-view) 以監控和分派平行背景工作階段。當輸出被管道化時，改為列出已設定的 [subagents](/zh-TW/sub-agents) | `claude agents` |

28| `claude attach <id>` | 在此終端中附加到 [background session](/zh-TW/agent-view#manage-sessions-from-the-shell) | `claude attach 7c5dcf5d` |

28| `claude auto-mode defaults` | 以 JSON 格式列印內建的 [auto mode](/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) 分類器規則。使用 `claude auto-mode config` 查看您的有效設定及套用的設定 | `claude auto-mode defaults > rules.json` |29| `claude auto-mode defaults` | 以 JSON 格式列印內建的 [auto mode](/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) 分類器規則。使用 `claude auto-mode config` 查看您的有效設定及套用的設定 | `claude auto-mode defaults > rules.json` |

30| `claude logs <id>` | 從 [background session](/zh-TW/agent-view#manage-sessions-from-the-shell) 列印最近的輸出 | `claude logs 7c5dcf5d` |

29| `claude mcp` | 設定 Model Context Protocol (MCP) 伺服器 | 請參閱 [Claude Code MCP 文件](/zh-TW/mcp)。 |31| `claude mcp` | 設定 Model Context Protocol (MCP) 伺服器 | 請參閱 [Claude Code MCP 文件](/zh-TW/mcp)。 |

30| `claude plugin` | 管理 Claude Code [plugins](/zh-TW/plugins)。別名：`claude plugins`。請參閱 [plugin 參考](/zh-TW/plugins-reference#cli-commands-reference) 以了解子命令 | `claude plugin install code-review@claude-plugins-official` |32| `claude plugin` | 管理 Claude Code [plugins](/zh-TW/plugins)。別名：`claude plugins`。請參閱 [plugin 參考](/zh-TW/plugins-reference#cli-commands-reference) 以了解子命令 | `claude plugin install code-review@claude-plugins-official` |

31| `claude project purge [path]` | 刪除專案的所有本機 Claude Code 狀態：文字記錄、工作清單、偵錯日誌、檔案編輯歷史記錄、提示歷史記錄行和專案在 `~/.claude.json` 中的項目。省略 `[path]` 以從互動式清單中選擇。旗標：`--dry-run` 以預覽，`-y`/`--yes` 以跳過確認，`-i`/`--interactive` 以確認每個項目，`--all` 用於每個專案。請參閱 [清除本機資料](/zh-TW/claude-directory#clear-local-data) | `claude project purge ~/work/repo --dry-run` |33| `claude project purge [path]` | 刪除專案的所有本機 Claude Code 狀態：文字記錄、工作清單、偵錯日誌、檔案編輯歷史記錄、提示歷史記錄行和專案在 `~/.claude.json` 中的項目。省略 `[path]` 以從互動式清單中選擇。旗標：`--dry-run` 以預覽，`-y`/`--yes` 以跳過確認，`-i`/`--interactive` 以確認每個項目，`--all` 用於每個專案。請參閱 [清除本機資料](/zh-TW/claude-directory#clear-local-data) | `claude project purge ~/work/repo --dry-run` |

32| `claude remote-control` | 啟動 [Remote Control](/zh-TW/remote-control) 伺服器以從 Claude.ai 或 Claude 應用程式控制 Claude Code。在伺服器模式下執行（無本機互動式工作階段）。請參閱 [伺服器模式旗標](/zh-TW/remote-control#start-a-remote-control-session) | `claude remote-control --name "My Project"` |34| `claude remote-control` | 啟動 [Remote Control](/zh-TW/remote-control) 伺服器以從 Claude.ai 或 Claude 應用程式控制 Claude Code。在伺服器模式下執行（無本機互動式工作階段）。請參閱 [伺服器模式旗標](/zh-TW/remote-control#start-a-remote-control-session) | `claude remote-control --name "My Project"` |

35| `claude respawn <id>` | 重新啟動已停止的 [background session](/zh-TW/agent-view#manage-sessions-from-the-shell)，保持其對話完整。使用 `--all` 重新啟動每個已停止的工作階段 | `claude respawn 7c5dcf5d` |

36| `claude rm <id>` | 從清單中移除 [background session](/zh-TW/agent-view#manage-sessions-from-the-shell) | `claude rm 7c5dcf5d` |

33| `claude setup-token` | 為 CI 和指令碼產生長期 OAuth 權杖。將權杖列印到終端而不儲存它。需要 Claude 訂閱。請參閱 [產生長期權杖](/zh-TW/authentication#generate-a-long-lived-token) | `claude setup-token` |37| `claude setup-token` | 為 CI 和指令碼產生長期 OAuth 權杖。將權杖列印到終端而不儲存它。需要 Claude 訂閱。請參閱 [產生長期權杖](/zh-TW/authentication#generate-a-long-lived-token) | `claude setup-token` |

38| `claude stop <id>` | 停止 [background session](/zh-TW/agent-view#manage-sessions-from-the-shell)。也接受 `claude kill` | `claude stop 7c5dcf5d` |

34| `claude ultrareview [target]` | 非互動式執行 [ultrareview](/zh-TW/ultrareview#run-ultrareview-non-interactively)。將發現列印到標準輸出，成功時以代碼 0 退出，失敗時以代碼 1 退出。使用 `--json` 取得原始承載，使用 `--timeout <minutes>` 覆蓋 30 分鐘的預設值 | `claude ultrareview 1234 --json` |39| `claude ultrareview [target]` | 非互動式執行 [ultrareview](/zh-TW/ultrareview#run-ultrareview-non-interactively)。將發現列印到標準輸出，成功時以代碼 0 退出，失敗時以代碼 1 退出。使用 `--json` 取得原始承載，使用 `--timeout <minutes>` 覆蓋 30 分鐘的預設值 | `claude ultrareview 1234 --json` |

35 40 

36如果您輸入錯誤的子命令，Claude Code 會建議最接近的匹配項並退出而不啟動工作階段。例如，`claude udpate` 會列印 `Did you mean claude update?`。41如果您輸入錯誤的子命令，Claude Code 會建議最接近的匹配項並退出而不啟動工作階段。例如，`claude udpate` 會列印 `Did you mean claude update?`。

50| `--append-system-prompt-file` | 從檔案載入額外的系統提示文字並附加到預設提示 | `claude --append-system-prompt-file ./extra-rules.txt` |55| `--append-system-prompt-file` | 從檔案載入額外的系統提示文字並附加到預設提示 | `claude --append-system-prompt-file ./extra-rules.txt` |

51| `--bare` | 最小模式：跳過 hooks、skills、plugins、MCP 伺服器、自動記憶體和 CLAUDE.md 的自動探索，以便指令碼呼叫啟動更快。Claude 可以存取 Bash、檔案讀取和檔案編輯工具。設定 [`CLAUDE_CODE_SIMPLE`](/zh-TW/env-vars)。請參閱 [bare mode](/zh-TW/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |56| `--bare` | 最小模式：跳過 hooks、skills、plugins、MCP 伺服器、自動記憶體和 CLAUDE.md 的自動探索，以便指令碼呼叫啟動更快。Claude 可以存取 Bash、檔案讀取和檔案編輯工具。設定 [`CLAUDE_CODE_SIMPLE`](/zh-TW/env-vars)。請參閱 [bare mode](/zh-TW/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |

52| `--betas` | 要包含在 API 請求中的 Beta 標頭（僅限 API 金鑰使用者） | `claude --betas interleaved-thinking` |57| `--betas` | 要包含在 API 請求中的 Beta 標頭（僅限 API 金鑰使用者） | `claude --betas interleaved-thinking` |

58| `--bg` | 以 [background agent](/zh-TW/agent-view) 身份啟動工作階段並立即返回。列印工作階段 ID 和管理命令。與 `--agent` 結合以執行特定 subagent | `claude --bg "investigate the flaky test"` |

53| `--channels` | （研究預覽）MCP 伺服器，其 [channel](/zh-TW/channels) 通知 Claude 應在此工作階段中監聽。以空格分隔的 `plugin:<name>@<marketplace>` 項目清單。需要 Claude.ai 驗證 | `claude --channels plugin:my-notifier@my-marketplace` |59| `--channels` | （研究預覽）MCP 伺服器，其 [channel](/zh-TW/channels) 通知 Claude 應在此工作階段中監聽。以空格分隔的 `plugin:<name>@<marketplace>` 項目清單。需要 Claude.ai 驗證 | `claude --channels plugin:my-notifier@my-marketplace` |

54| `--chrome` | 啟用 [Chrome 瀏覽器整合](/zh-TW/chrome) 以進行網頁自動化和測試 | `claude --chrome` |60| `--chrome` | 啟用 [Chrome 瀏覽器整合](/zh-TW/chrome) 以進行網頁自動化和測試 | `claude --chrome` |

55| `--continue`, `-c` | 載入目前目錄中最近的對話。包括使用 `/add-dir` 新增此目錄的工作階段 | `claude --continue` |61| `--continue`, `-c` | 載入目前目錄中最近的對話。包括使用 `/add-dir` 新增此目錄的工作階段 | `claude --continue` |

20 20 

21**在工作期間。** `/plan` 在大型變更前切換到 Plan Mode。`/model` 和 `/effort` 調整您花費的推理量。當對話變得冗長時，`/context` 顯示視窗的去向，`/compact` 將其總結下來；使用 `/btw` 進行快速旁註，不應該膨脹歷史記錄。21**在工作期間。** `/plan` 在大型變更前切換到 Plan Mode。`/model` 和 `/effort` 調整您花費的推理量。當對話變得冗長時，`/context` 顯示視窗的去向，`/compact` 將其總結下來；使用 `/btw` 進行快速旁註，不應該膨脹歷史記錄。

22 22 

23**並行執行工作。** `/agents` 開啟管理員以管理 [subagents](/zh-TW/sub-agents) Claude 可以委派側邊任務，`/tasks` 列出目前工作階段背景中執行的內容。`/background` 分離整個工作階段以繼續作為 [background agent](/zh-TW/agent-view) 執行並釋放您的終端機。對於跨越程式碼庫的大型變更，`/batch` 將其分解為獨立單位，並在各自的 [worktree](/zh-TW/worktrees) 中執行每個單位。請參閱 [Run agents in parallel](/zh-TW/agents) 以了解這些方法如何相關。

24 

23**在您推送前。** `/diff` 顯示變更的內容，`/simplify` 審閱最近的檔案並應用品質和效率修復，`/review` 或 `/security-review` 進行更深入的唯讀檢查。25**在您推送前。** `/diff` 顯示變更的內容，`/simplify` 審閱最近的檔案並應用品質和效率修復，`/review` 或 `/security-review` 進行更深入的唯讀檢查。

24 26 

25**在工作階段之間。** `/clear` 在保持專案記憶的同時開始新工作的新鮮開始。`/resume` 和 `/branch` 讓您返回或分叉較早的對話。`/teleport` 將網頁工作階段拉入此終端機，`/remote-control` 讓您從另一個裝置繼續此本地工作階段。27**在工作階段之間。** `/clear` 在保持專案記憶的同時開始新工作的新鮮開始。`/resume` 和 `/branch` 讓您返回或分叉較早的對話。`/teleport` 將網頁工作階段拉入此終端機，`/remote-control` 讓您從另一個裝置繼續此本地工作階段。

41| `/add-dir <path>` | 為目前工作階段期間的檔案存取添加工作目錄。大多數 `.claude/` 配置[未從添加的目錄發現](/zh-TW/permissions#additional-directories-grant-file-access-not-configuration)。您可以稍後使用 `--continue` 或 `--resume` 從添加的目錄繼續工作階段 |43| `/add-dir <path>` | 為目前工作階段期間的檔案存取添加工作目錄。大多數 `.claude/` 配置[未從添加的目錄發現](/zh-TW/permissions#additional-directories-grant-file-access-not-configuration)。您可以稍後使用 `--continue` 或 `--resume` 從添加的目錄繼續工作階段 |

42| `/agents` | 管理 [agent](/zh-TW/sub-agents) 配置 |44| `/agents` | 管理 [agent](/zh-TW/sub-agents) 配置 |

43| `/autofix-pr [prompt]` | 生成一個[網頁上的 Claude Code](/zh-TW/claude-code-on-the-web#auto-fix-pull-requests) 工作階段，監視目前分支的 PR 並在 CI 失敗或審閱者留下評論時推送修復。使用 `gh pr view` 檢測已簽出分支的開放 PR；若要監視不同的 PR，請先簽出其分支。預設情況下，遠端工作階段被告知修復每個 CI 失敗和審閱評論；傳遞提示以給予它不同的指示，例如 `/autofix-pr only fix lint and type errors`。需要 `gh` CLI 和訪問[網頁上的 Claude Code](/zh-TW/claude-code-on-the-web#who-can-use-claude-code-on-the-web) |45| `/autofix-pr [prompt]` | 生成一個[網頁上的 Claude Code](/zh-TW/claude-code-on-the-web#auto-fix-pull-requests) 工作階段，監視目前分支的 PR 並在 CI 失敗或審閱者留下評論時推送修復。使用 `gh pr view` 檢測已簽出分支的開放 PR；若要監視不同的 PR，請先簽出其分支。預設情況下，遠端工作階段被告知修復每個 CI 失敗和審閱評論；傳遞提示以給予它不同的指示，例如 `/autofix-pr only fix lint and type errors`。需要 `gh` CLI 和訪問[網頁上的 Claude Code](/zh-TW/claude-code-on-the-web#who-can-use-claude-code-on-the-web) |

44| `/batch <instruction>` | **[Skill](/zh-TW/skills#bundled-skills).** 在整個程式碼庫中並行協調大規模變更。研究程式碼庫，將工作分解為 5 到 30 個獨立單位，並呈現計劃。獲得批准後，在隔離的 [git worktree](/zh-TW/worktrees) 中為每個單位生成一個背景 agent。每個 agent 實現其單位、運行測試並開啟 pull request。需要 git 存放庫。示例：`/batch migrate src/ from Solid to React` |46| `/background [prompt]` | 分離目前的工作階段以作為[背景 agent](/zh-TW/agent-view) 運行並釋放此終端機。傳遞提示以在分離前發送一個額外的指示。使用 `claude agents` 監視工作階段。別名：`/bg` |

47| `/batch <instruction>` | **[Skill](/zh-TW/skills#bundled-skills).** 在整個程式碼庫中並行協調大規模變更。研究程式碼庫，將工作分解為 5 到 30 個獨立單位，並呈現計劃。獲得批准後，在隔離的 [git worktree](/zh-TW/worktrees) 中為每個單位生成一個背景 subagent。每個 subagent 實現其單位、運行測試並開啟 pull request。需要 git 存放庫。示例：`/batch migrate src/ from Solid to React` |

45| `/branch [name]` | 在此時刻建立目前對話的分支。切換到分支並保留原始分支，您可以使用 `/resume` 返回。別名：`/fork`。當設定 [`CLAUDE_CODE_FORK_SUBAGENT`](/zh-TW/env-vars) 時，`/fork` 改為生成[分叉的 subagent](/zh-TW/sub-agents#fork-the-current-conversation)，不再是此命令的別名 |48| `/branch [name]` | 在此時刻建立目前對話的分支。切換到分支並保留原始分支，您可以使用 `/resume` 返回。別名：`/fork`。當設定 [`CLAUDE_CODE_FORK_SUBAGENT`](/zh-TW/env-vars) 時，`/fork` 改為生成[分叉的 subagent](/zh-TW/sub-agents#fork-the-current-conversation)，不再是此命令的別名 |

46| `/btw <question>` | 提出快速[側邊問題](/zh-TW/interactive-mode#side-questions-with-%2Fbtw)，無需添加到對話中 |49| `/btw <question>` | 提出快速[側邊問題](/zh-TW/interactive-mode#side-questions-with-%2Fbtw)，無需添加到對話中 |

47| `/chrome` | 配置 [Chrome 中的 Claude](/zh-TW/chrome) 設定 |50| `/chrome` | 配置 [Chrome 中的 Claude](/zh-TW/chrome) 設定 |

65| `/feedback [report]` | 提交有關 Claude Code 的意見反應。別名：`/bug` |68| `/feedback [report]` | 提交有關 Claude Code 的意見反應。別名：`/bug` |

66| `/fewer-permission-prompts` | **[Skill](/zh-TW/skills#bundled-skills).** 掃描您的記錄以查找常見的唯讀 Bash 和 MCP 工具呼叫，然後將優先允許清單添加到專案 `.claude/settings.json` 以減少權限提示 |69| `/fewer-permission-prompts` | **[Skill](/zh-TW/skills#bundled-skills).** 掃描您的記錄以查找常見的唯讀 Bash 和 MCP 工具呼叫，然後將優先允許清單添加到專案 `.claude/settings.json` 以減少權限提示 |

67| `/focus` | 切換焦點檢視，僅顯示您的最後一個提示、帶有編輯 diffstats 的單行工具呼叫摘要和最終回應。選擇在工作階段之間保持。僅在[全螢幕渲染](/zh-TW/fullscreen)中可用 |70| `/focus` | 切換焦點檢視，僅顯示您的最後一個提示、帶有編輯 diffstats 的單行工具呼叫摘要和最終回應。選擇在工作階段之間保持。僅在[全螢幕渲染](/zh-TW/fullscreen)中可用 |

71| `/goal [condition\|clear]` | 設定[目標](/zh-TW/goal)：Claude 在各個回合中持續工作，直到滿足條件。不帶引數時，顯示目前或最近達成的目標。`clear`、`stop`、`off`、`reset`、`none` 或 `cancel` 會提前移除活躍的目標 |

68| `/heapdump` | 將 JavaScript 堆快照和記憶體分解寫入 `~/Desktop`，或在沒有 Desktop 資料夾的 Linux 上寫入您的主目錄，以診斷高記憶體使用情況。請參閱[故障排除](/zh-TW/troubleshooting#high-cpu-or-memory-usage) |72| `/heapdump` | 將 JavaScript 堆快照和記憶體分解寫入 `~/Desktop`，或在沒有 Desktop 資料夾的 Linux 上寫入您的主目錄，以診斷高記憶體使用情況。請參閱[故障排除](/zh-TW/troubleshooting#high-cpu-or-memory-usage) |

69| `/help` | 顯示說明和可用命令 |73| `/help` | 顯示說明和可用命令 |

70| `/hooks` | 檢視工具事件的 [hook](/zh-TW/hooks) 配置 |74| `/hooks` | 檢視工具事件的 [hook](/zh-TW/hooks) 配置 |

109| `/status` | 開啟設定介面（狀態標籤），顯示版本、模型、帳戶和連線狀態。在 Claude 回應時運作，無需等待目前回應完成 |113| `/status` | 開啟設定介面（狀態標籤），顯示版本、模型、帳戶和連線狀態。在 Claude 回應時運作，無需等待目前回應完成 |

110| `/statusline` | 配置 Claude Code 的[狀態列](/zh-TW/statusline)。描述您想要的內容，或不帶引數執行以從您的 shell 提示自動配置 |114| `/statusline` | 配置 Claude Code 的[狀態列](/zh-TW/statusline)。描述您想要的內容，或不帶引數執行以從您的 shell 提示自動配置 |

111| `/stickers` | 訂購 Claude Code 貼紙 |115| `/stickers` | 訂購 Claude Code 貼紙 |

116| `/stop` | 停止目前的[背景工作階段](/zh-TW/agent-view)。僅在附加到背景工作階段時可用；記錄和任何 worktree 都會保留。若要分離而不停止，請使用 `/exit` 或按 `←` |

112| `/tasks` | 列出並管理背景工作。也可用作 `/bashes` |117| `/tasks` | 列出並管理背景工作。也可用作 `/bashes` |

113| `/team-onboarding` | 從您的 Claude Code 使用歷史記錄產生團隊入職指南。Claude 分析您過去 30 天的工作階段、命令和 MCP 伺服器使用情況，並產生一份 markdown 指南，團隊成員可以貼上作為第一條訊息以快速設定 |118| `/team-onboarding` | 從您的 Claude Code 使用歷史記錄產生團隊入職指南。Claude 分析您過去 30 天的工作階段、命令和 MCP 伺服器使用情況，並產生一份 markdown 指南，團隊成員可以貼上作為第一條訊息以快速設定。對於 claude.ai 上 Pro、Max、Team 和 Enterprise 方案的訂閱者，也會返回一個分享連結，團隊成員可以直接在 Claude Code 中開啟 |

114| `/teleport` | 將[網頁上的 Claude Code](/zh-TW/claude-code-on-the-web#from-web-to-terminal) 工作階段拉入此終端機：開啟選擇器，然後擷取分支和對話。也可用作 `/tp`。需要 claude.ai 訂閱 |119| `/teleport` | 將[網頁上的 Claude Code](/zh-TW/claude-code-on-the-web#from-web-to-terminal) 工作階段拉入此終端機：開啟選擇器，然後擷取分支和對話。也可用作 `/tp`。需要 claude.ai 訂閱 |

115| `/terminal-setup` | 為 Shift+Enter 和其他快捷鍵配置終端機快捷鍵。僅在需要它的終端機中可見，例如 VS Code、Cursor、Windsurf、Alacritty 或 Zed |120| `/terminal-setup` | 為 Shift+Enter 和其他快捷鍵配置終端機快捷鍵。僅在需要它的終端機中可見，例如 VS Code、Cursor、Windsurf、Alacritty 或 Zed |

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

6 6 

7> 使用 Claude Code 探索程式碼庫、修復錯誤、重構、測試和其他日常任務的逐步指南。7> 使用 Claude Code 探索程式碼庫、修復錯誤、重構、測試和其他日常任務的逐步指南。

8 8 

9本頁涵蓋日常開發的實用工作流程：探索陌生程式碼、除錯、重構、編寫測試、建立 PR 和管理會話。每個部分都包含您可以根據自己的專案調整的範例提示。如需更高層級的模式和提示，請參閱[最佳實踐](/zh-TW/best-practices)。9本頁涵蓋日常開發的簡短食譜。如需更高層級的提示和背景資訊管理指導，請參閱[最佳實踐](/zh-TW/best-practices)。

10 10 

11## 了解新的程式碼庫11本頁涵蓋：

12 12 

13### 快速取得程式碼庫概覽13* [提示食譜](#prompt-recipes)，用於探索程式碼、修復錯誤、重構、測試、PR 和文件

14* [繼續之前的對話](#resume-previous-conversations)，以便任務可以跨越多個會話

15* [使用 worktrees 執行平行會話](#run-parallel-sessions-with-worktrees)，以便並行編輯不會衝突

16* [編輯前規劃](#plan-before-editing)，以在變更觸及磁碟前檢查變更

17* [將研究委派給 subagents](#delegate-research-to-subagents)，以保持主要背景資訊清潔

18* [將 Claude 管道輸入指令碼](#pipe-claude-into-scripts)，用於 CI 和批次處理

19 

20## 提示食譜

21 

22這些是日常任務的提示模式，例如探索陌生程式碼、除錯、重構、編寫測試和建立 PR。每個都可在任何 Claude Code 介面中工作；根據您的專案調整措辭。

23 

24### 了解新的程式碼庫

25 

26#### 快速取得程式碼庫概覽

14 27 

15假設您剛加入一個新專案，需要快速了解其結構。28假設您剛加入一個新專案，需要快速了解其結構。

16 29 

56 * 要求提供專案特定術語的詞彙表69 * 要求提供專案特定術語的詞彙表

57</Tip>70</Tip>

58 71 

59### 尋找相關程式碼72#### 尋找相關程式碼

60 73 

61假設您需要找到與特定功能相關的程式碼。74假設您需要找到與特定功能或功能相關的程式碼。

62 75 

63<Steps>76<Steps>

64 <Step title="要求 Claude 尋找相關檔案">77 <Step title="要求 Claude 尋找相關檔案">

90 103 

91***104***

92 105 

93## 有效地修復錯誤106### 有效地修復錯誤

94 107 

95假設您遇到了錯誤訊息，需要找到並修復其來源。108假設您遇到了錯誤訊息，需要找到並修復其來源。

96 109 

124 137 

125***138***

126 139 

127## 重構程式碼140### 重構程式碼

128 141 

129假設您需要更新舊程式碼以使用現代模式和實踐。142假設您需要更新舊程式碼以使用現代模式和實踐。

130 143 

164 177 

165***178***

166 179 

167## 使用專門的 subagents180### 使用測試

168 

169假設您想使用專門的 AI subagents 來更有效地處理特定任務。

170 

171<Steps>

172 <Step title="檢視可用的 subagents">

173 ```text theme={null}

174 /agents

175 ```

176 

177 這會顯示所有可用的 subagents 並讓您建立新的。

178 </Step>

179 

180 <Step title="自動使用 subagents">

181 Claude Code 會自動將適當的任務委派給專門的 subagents：

182 

183 ```text theme={null}

184 review my recent code changes for security issues

185 ```

186 

187 ```text theme={null}

188 run all tests and fix any failures

189 ```

190 </Step>

191 

192 <Step title="明確要求特定的 subagents">

193 ```text theme={null}

194 use the code-reviewer subagent to check the auth module

195 ```

196 

197 ```text theme={null}

198 have the debugger subagent investigate why users can't log in

199 ```

200 </Step>

201 

202 <Step title="為您的工作流程建立自訂 subagents">

203 ```text theme={null}

204 /agents

205 ```

206 

207 然後選擇「建立新 subagent」並按照提示定義：

208 

209 * 描述 subagent 目的的唯一識別碼（例如 `code-reviewer`、`api-designer`）。

210 * Claude 何時應使用此代理

211 * 它可以存取哪些工具

212 * 描述代理角色和行為的系統提示

213 </Step>

214</Steps>

215 

216<Tip>

217 提示：

218 

219 * 在 `.claude/agents/` 中建立專案特定的 subagents 以供團隊共享

220 * 使用描述性的 `description` 欄位來啟用自動委派

221 * 限制工具存取權限為每個 subagent 實際需要的內容

222 * 查看[subagents 文件](/zh-TW/sub-agents)以取得詳細範例

223</Tip>

224 

225***

226 

227## 使用 Plan Mode 進行安全的程式碼分析

228 

229Plan Mode 指示 Claude 通過使用唯讀操作分析程式碼庫來建立計畫，非常適合探索程式碼庫、規劃複雜變更或安全地檢查程式碼。在 Plan Mode 中，Claude 使用 [`AskUserQuestion`](/zh-TW/tools-reference) 在提出計畫之前收集需求並澄清您的目標。

230 

231### 何時使用 Plan Mode

232 

233* **多步驟實現**：當您的功能需要編輯許多檔案時

234* **程式碼探索**：當您想在進行任何變更之前徹底研究程式碼庫時

235* **互動式開發**：當您想與 Claude 迭代方向時

236 

237### 如何使用 Plan Mode

238 

239**在會話期間開啟 Plan Mode**

240 

241您可以在會話期間使用 **Shift+Tab** 循環切換權限模式。

242 

243如果您處於 Normal Mode，**Shift+Tab** 首先切換到 Auto-Accept Mode，在終端底部顯示 `⏵⏵ accept edits on`。隨後的 **Shift+Tab** 將切換到 Plan Mode，顯示 `⏸ plan mode on`。

244 

245**在 Plan Mode 中啟動新會話**

246 

247要在 Plan Mode 中啟動新會話，請使用 `--permission-mode plan` 標誌：

248 

249```bash theme={null}

250claude --permission-mode plan

251```

252 

253**在 Plan Mode 中執行「無頭」查詢**

254 

255您也可以使用 `-p` 直接在 Plan Mode 中執行查詢（即在[「無頭模式」](/zh-TW/headless)中）：

256 

257```bash theme={null}

258claude --permission-mode plan -p "Analyze the authentication system and suggest improvements"

259```

260 

261### 範例：規劃複雜的重構

262 

263```bash theme={null}

264claude --permission-mode plan

265```

266 

267```text theme={null}

268I need to refactor our authentication system to use OAuth2. Create a detailed migration plan.

269```

270 

271Claude 分析當前實現並建立全面的計畫。使用後續問題進行細化：

272 

273```text theme={null}

274What about backward compatibility?

275```

276 

277```text theme={null}

278How should we handle database migration?

279```

280 

281<Tip>按 `Ctrl+G` 在預設文字編輯器中開啟計畫，您可以在 Claude 繼續之前直接編輯它。</Tip>

282 

283當您接受計畫時，Claude 會自動從計畫內容命名會話。名稱會出現在提示欄和會話選擇器中。如果您已經使用 `--name` 或 `/rename` 設定了名稱，接受計畫不會覆蓋它。

284 

285### 將 Plan Mode 設定為預設值

286 

287```json theme={null}

288// .claude/settings.json

289{

290 "permissions": {

291 "defaultMode": "plan"

292 }

293}

294```

295 

296有關更多配置選項，請參閱[設定文件](/zh-TW/settings#available-settings)。

297 

298***

299 

300## 使用測試

301 181 

302假設您需要為未涵蓋的程式碼新增測試。182假設您需要為未涵蓋的程式碼新增測試。

303 183 

333 213 

334***214***

335 215 

336## 建立提取請求216### 建立提取請求

337 217 

338您可以直接要求 Claude 建立提取請求（「為我的變更建立 pr」），或逐步引導 Claude 完成：218您可以直接要求 Claude 建立提取請求（「為我的變更建立 pr」），或逐步引導 Claude 完成：

339 219 

357 </Step>237 </Step>

358</Steps>238</Steps>

359 239 

360當您使用 `gh pr create` 建立 PR 時，會話會自動連結到該 PR。您稍後可以使用 `claude --from-pr <number>` 繼續。240當您使用 `gh pr create` 建立 PR 時，會話會自動連結到該 PR。要稍後返回它，請執行 `claude --from-pr <number>` 或將 PR URL 貼到[`/resume` 選擇器](/zh-TW/sessions#use-the-session-picker)搜尋中。

361 241 

362<Tip>242<Tip>

363 在提交前檢查 Claude 產生的 PR，並要求 Claude 突出顯示潛在的風險或考慮事項。243 在提交前檢查 Claude 產生的 PR，並要求 Claude 突出顯示潛在的風險或考慮事項。

364</Tip>244</Tip>

365 245 

366## 處理文件246### 處理文件

367 247 

368假設您需要為程式碼新增或更新文件。248假設您需要為程式碼新增或更新文件。

369 249 

403 283 

404***284***

405 285 

406## 在筆記和非程式碼資料夾中工作286### 在筆記和非程式碼資料夾中工作

407 287 

408Claude Code 可在任何目錄中工作。在筆記保管庫、文件資料夾或任何 markdown 檔案集合中執行它，以搜尋、編輯和重新組織內容，就像您處理程式碼一樣。288Claude Code 可在任何目錄中工作。在筆記保管庫、文件資料夾或任何 markdown 檔案集合中執行它，以搜尋、編輯和重新組織內容，就像您處理程式碼一樣。

409 289 

411 291 

412***292***

413 293 

414## 使用影像294### 使用影像

415 295 

416假設您需要在程式碼庫中使用影像，並希望 Claude 幫助分析影像內容。296假設您需要在程式碼庫中使用影像，並希望 Claude 幫助分析影像內容。

417 297 

471 351 

472***352***

473 353 

474## 參考檔案和目錄354### 參考檔案和目錄

475 355 

476使用 @ 快速包含檔案或目錄，無需等待 Claude 讀取它們。356使用 @ 快速包含檔案或目錄，無需等待 Claude 讀取它們。

477 357 

512 392 

513***393***

514 394 

515## 使用擴展思考（Thinking Mode）395### 按排程執行 Claude

516 

517[擴展思考](https://platform.claude.com/docs/zh-TW/build-with-claude/extended-thinking)預設啟用，為 Claude 提供空間在回應前逐步推理複雜問題。此推理在詳細模式中可見，您可以使用 `Ctrl+O` 切換。在擴展思考期間，進度提示會出現在指示器下方，例如「still thinking」和「almost done thinking」，以指示 Claude 正在積極工作。

518 

519此外，[支援努力級別的模型](/zh-TW/model-config#adjust-effort-level)使用自適應推理：不是固定的思考令牌預算，而是模型根據您的努力級別設定和手邊的任務動態決定是否以及如何思考。自適應推理讓 Claude 對日常提示回應更快，並為受益於深度思考的步驟保留更深層的思考。

520 

521擴展思考對於複雜的架構決策、具有挑戰性的錯誤、多步驟實現規劃和評估不同方法之間的權衡特別有價值。

522 

523<Note>

524 「think」、「think hard」和「think more」等短語被解釋為常規提示指令，不分配思考令牌。

525</Note>

526 

527### 配置 Thinking Mode

528 

529思考預設啟用，但您可以調整或禁用它。

530 

531| 範圍 | 如何配置 | 詳細資訊 |

532| -------------------- | ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |

533| **努力級別** | 執行 `/effort`、在 `/model` 中調整，或設定 [`CLAUDE_CODE_EFFORT_LEVEL`](/zh-TW/env-vars) | 控制[支援的模型](/zh-TW/model-config#adjust-effort-level)上的思考深度 |

534| **`ultrathink` 關鍵字** | 在提示中的任何地方包含「ultrathink」 | 在該輪添加上下文指令，告訴模型進行更多推理。不會改變努力級別本身；請參閱[調整努力級別](/zh-TW/model-config#adjust-effort-level)以了解相關資訊 |

535| **切換快捷鍵** | 按 `Option+T`（macOS）或 `Alt+T`（Windows/Linux） | 切換當前會話的思考開/關（所有模型）。可能需要[終端配置](/zh-TW/terminal-config)來啟用 Option 鍵快捷鍵 |

536| **全域預設值** | 使用 `/config` 切換 Thinking Mode | 在所有專案中設定預設值（所有模型）。<br />儲存為 `~/.claude/settings.json` 中的 `alwaysThinkingEnabled` |

537| **限制令牌預算** | 設定 [`MAX_THINKING_TOKENS`](/zh-TW/env-vars) 環境變數 | 將思考預算限制為特定數量的令牌。在支援自適應推理的模型上，只有設定為 `0` 時才適用，除非禁用自適應推理。範例：`export MAX_THINKING_TOKENS=10000` |

538 

539要檢視 Claude 的思考過程，按 `Ctrl+O` 切換詳細模式，並查看顯示為灰色斜體文字的內部推理。

540 

541### 擴展思考如何運作

542 

543擴展思考控制 Claude 在回應前執行多少內部推理。更多思考提供更多空間來探索解決方案、分析邊界情況和自我糾正錯誤。

544 

545在[支援努力級別的模型](/zh-TW/model-config#adjust-effort-level)上，思考使用自適應推理：模型根據您選擇的努力級別動態分配思考令牌。這是調整速度和推理深度之間權衡的推薦方式。如果您想讓 Claude 比您的努力級別會產生的更多或更少地思考，您也可以直接在提示中或在 `CLAUDE.md` 中說明。

546 

547使用較舊的模型，思考使用固定令牌預算，從您的輸出分配中提取。預算因模型而異；有關詳細資訊，請參閱 [`MAX_THINKING_TOKENS`](/zh-TW/env-vars)。您可以使用該環境變數限制預算，或通過 `/config` 或 `Option+T`/`Alt+T` 切換完全禁用思考。

548 

549在支援自適應推理的模型上，`MAX_THINKING_TOKENS` 只在設定為 `0` 以禁用思考時適用，或當 `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` 將模型恢復為固定預算時適用。`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` 僅適用於 Opus 4.6 和 Sonnet 4.6。Opus 4.7 始終使用自適應推理，不支援固定思考預算。請參閱[環境變數](/zh-TW/env-vars)。

550 

551<Warning>

552 您需要為所有使用的思考令牌付費，即使思考摘要被編輯。在互動模式中，思考預設顯示為摺疊的存根。在 `settings.json` 中設定 `showThinkingSummaries: true` 以顯示完整摘要。

553</Warning>

554 

555***

556 

557## 繼續之前的對話

558 

559啟動 Claude Code 時，您可以繼續之前的會話：

560 

561* `claude --continue` 繼續當前目錄中最近的對話

562* `claude --resume` 開啟對話選擇器或按名稱繼續

563* `claude --from-pr 123` 繼續連結到特定提取請求的會話

564 

565從活躍會話內，使用 `/resume` 切換到不同的對話。

566 

567當選定的會話足夠舊且足夠大，以至於重新閱讀它會消耗您使用限額的大部分時，`--resume`、`--continue` 和 `/resume` 會提供從摘要繼續而不是載入完整記錄的選項。此提示在 Amazon Bedrock、Google Cloud Vertex AI 或 Microsoft Foundry 上不可用。

568 

569會話按專案目錄儲存。預設情況下，`/resume` 選擇器顯示來自當前 worktree 的互動式會話，帶有快捷鍵以擴展清單到其他 worktrees 或專案、搜尋、預覽和重新命名。有關完整的快捷鍵參考，請參閱下面的[使用會話選擇器](#use-the-session-picker)。

570 

571當您從同一儲存庫的另一個 worktree 選擇會話時，Claude Code 會直接繼續它，無需您先切換目錄。從不相關的專案選擇會話會將 `cd` 和繼續命令複製到您的剪貼簿。

572 

573按名稱繼續會在當前儲存庫及其 worktrees 中解析。`claude --resume <name>` 和 `/resume <name>` 都會尋找精確匹配並直接繼續它，即使會話位於不同的 worktree 中。

574 

575當名稱不明確時，`claude --resume <name>` 會開啟選擇器，並將名稱預先填充為搜尋詞。`/resume <name>` 從會話內報告錯誤，所以執行 `/resume` 不帶引數以開啟選擇器並選擇。

576 

577由 `claude -p` 或 SDK 調用建立的會話不會出現在選擇器中，但您仍然可以通過將其會話 ID 直接傳遞給 `claude --resume <session-id>` 來繼續。

578 

579### 命名您的會話

580 

581給會話起描述性名稱以便稍後找到它們。這是在處理多個任務或功能時的最佳實踐。

582 

583<Steps>

584 <Step title="命名會話">

585 在啟動時使用 `-n` 命名會話：

586 

587 ```bash theme={null}

588 claude -n auth-refactor

589 ```

590 

591 或在會話期間使用 `/rename`，這也會在提示欄上顯示名稱：

592 

593 ```text theme={null}

594 /rename auth-refactor

595 ```

596 

597 您也可以從選擇器重新命名任何會話：執行 `/resume`，導航到會話，然後按 `Ctrl+R`。

598 </Step>

599 

600 <Step title="稍後按名稱繼續">

601 從命令列：

602 

603 ```bash theme={null}

604 claude --resume auth-refactor

605 ```

606 

607 或從活躍會話內：

608 

609 ```text theme={null}

610 /resume auth-refactor

611 ```

612 </Step>

613</Steps>

614 

615### 使用會話選擇器

616 

617`/resume` 命令（或 `claude --resume` 不帶引數）開啟具有以下功能的互動式會話選擇器：

618 

619**選擇器中的快捷鍵：**

620 

621| 快捷鍵 | 動作 |

622| :----------------------- | :------------------------------------------------------------- |

623| `↑` / `↓` | 在會話之間導航 |

624| `→` / `←` | 展開或摺疊分組的會話 |

625| `Enter` | 選擇並繼續突出顯示的會話 |

626| `Space` | 預覽會話內容。`Ctrl+V` 在不將其捕獲為貼上的終端上也有效 |

627| `Ctrl+R` | 重新命名突出顯示的會話 |

628| `/` 或除 `Space` 外的任何可列印字元 | 進入搜尋模式並篩選會話 |

629| `Ctrl+A` | 顯示此機器上所有專案的會話。再次按下以恢復當前儲存庫 |

630| `Ctrl+W` | 顯示當前儲存庫所有 worktrees 的會話。再次按下以恢復當前 worktree。僅在多 worktree 儲存庫中顯示 |

631| `Ctrl+B` | 篩選為來自您當前 git 分支的會話。再次按下以顯示所有分支的會話 |

632| `Esc` | 退出選擇器或搜尋模式 |

633 

634**會話組織：**

635 

636選擇器顯示帶有有用中繼資料的會話：

637