22| `claude -c -p "query"` | 透過 SDK 繼續 | `claude -c -p "Check for type errors"` |22| `claude -c -p "query"` | 透過 SDK 繼續 | `claude -c -p "Check for type errors"` |
23| `claude -r "<session>" "query"` | 按 ID 或名稱繼續工作階段 | `claude -r "auth-refactor" "Finish this PR"` |23| `claude -r "<session>" "query"` | 按 ID 或名稱繼續工作階段 | `claude -r "auth-refactor" "Finish this PR"` |
24| `claude update` | 更新至最新版本 | `claude update` |24| `claude update` | 更新至最新版本 | `claude update` |
25| `claude gateway` | 啟動自託管 [Claude apps gateway](/zh-TW/claude-apps-gateway) 伺服器,供在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上部署 SSO 和原則在 Claude Code 前面的管理員使用。需要 `--config` 指向 [`gateway.yaml`](/zh-TW/claude-apps-gateway-config)。在 Claude Code v2.1.195 及更新版本中可用。 | `claude gateway --config gateway.yaml` |25| `claude gateway` | 啟動自託管 [Claude apps gateway](/docs/zh-TW/claude-apps-gateway) 伺服器,供在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上部署 SSO 和原則在 Claude Code 前面的管理員使用。需要 `--config` 指向 [`gateway.yaml`](/docs/zh-TW/claude-apps-gateway-config)。在 Claude Code v2.1.195 及更新版本中可用。 | `claude gateway --config gateway.yaml` |
26| `claude install [version]` | 安裝或重新安裝原生二進位檔。接受版本如 `2.1.118`、`stable` 或 `latest`。請參閱 [安裝特定版本](/zh-TW/setup#install-a-specific-version) | `claude install stable` |26| `claude install [version]` | 安裝或重新安裝原生二進位檔。接受版本如 `2.1.118`、`stable` 或 `latest`。請參閱 [安裝特定版本](/docs/zh-TW/setup#install-a-specific-version) | `claude install stable` |
27| `claude auth login` | 登入您的 Anthropic 帳戶。使用 `--email` 預先填入您的電子郵件地址,使用 `--sso` 強制進行 SSO 驗證,使用 `--console` 以 Anthropic Console 登入以進行 API 使用計費,而不是 Claude 訂閱 | `claude auth login --console` |27| `claude auth login` | 登入您的 Anthropic 帳戶。使用 `--email` 預先填入您的電子郵件地址,使用 `--sso` 強制進行 SSO 驗證,使用 `--console` 以 Anthropic Console 登入以進行 API 使用計費,而不是 Claude 訂閱 | `claude auth login --console` |
28| `claude auth logout` | 從您的 Anthropic 帳戶登出 | `claude auth logout` |28| `claude auth logout` | 從您的 Anthropic 帳戶登出 | `claude auth logout` |
29| `claude auth status` | 以 JSON 格式顯示驗證狀態。使用 `--text` 以人類可讀的格式輸出。如果已登入則以代碼 0 退出,如果未登入則以代碼 1 退出 | `claude auth status` |29| `claude auth status` | 以 JSON 格式顯示驗證狀態。使用 `--text` 以人類可讀的格式輸出。如果已登入則以代碼 0 退出,如果未登入則以代碼 1 退出 | `claude auth status` |
30| `claude agents` | 開啟 [agent view](/zh-TW/agent-view) 以監控和分派平行背景工作階段。使用 `--cwd <path>` 僅顯示在該目錄下啟動的工作階段,或使用 `--json` 將即時工作階段列印為 JSON 陣列以供指令碼使用(`--json --all` 也包括已完成的背景工作階段)。傳遞 `--permission-mode`、`--model`、`--effort` 或 `--agent` 以設定 [分派工作階段的預設值](/zh-TW/agent-view#permission-mode-model-and-effort)。接受 `--settings`、`--add-dir`、`--plugin-dir` 和 `--mcp-config`,如同頂層 `claude` 命令。開啟 agent view 需要互動式終端 | `claude agents --json` |30| `claude agents` | 開啟 [agent view](/docs/zh-TW/agent-view) 以監控和分派平行背景工作階段。使用 `--cwd <path>` 僅顯示在該目錄下啟動的工作階段,或使用 `--json` 將即時工作階段列印為 JSON 陣列以供指令碼使用(`--json --all` 也包括已完成的背景工作階段)。傳遞 `--permission-mode`、`--model`、`--effort` 或 `--agent` 以設定 [分派工作階段的預設值](/docs/zh-TW/agent-view#permission-mode-model-and-effort)。接受 `--settings`、`--add-dir`、`--plugin-dir` 和 `--mcp-config`,如同頂層 `claude` 命令。開啟 agent view 需要互動式終端 | `claude agents --json` |
31| `claude attach <id>` | 在此終端中附加到 [背景工作階段](/zh-TW/agent-view#manage-sessions-from-the-shell) | `claude attach 7c5dcf5d` |31| `claude attach <id>` | 在此終端中附加到 [背景工作階段](/docs/zh-TW/agent-view#manage-sessions-from-the-shell) | `claude attach 7c5dcf5d` |
32| `claude auto-mode defaults` | 以 JSON 格式列印內建的 [auto mode](/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) 分類器規則。使用 `claude auto-mode config` 查看您的有效設定及套用的設定。{/* min-version: 2.1.208 */}}`--label <prefix>` 列印標籤以該前綴開頭的規則,不區分大小寫匹配。需要 Claude Code v2.1.208 或更新版本 | `claude auto-mode defaults --label 'Git Destructive'` |32| `claude auto-mode defaults` | 以 JSON 格式列印內建的 [auto mode](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) 分類器規則。使用 `claude auto-mode config` 查看您的有效設定及套用的設定。}`--label <prefix>` 列印標籤以該前綴開頭的規則,不區分大小寫匹配。需要 Claude Code v2.1.208 或更新版本 | `claude auto-mode defaults --label 'Git Destructive'` |
33| `claude daemon status` | 列印背景工作階段 [supervisor](/zh-TW/agent-view#the-supervisor-process) 的狀態、版本、socket 目錄和工作者計數以進行診斷。如果 supervisor 未執行則以代碼 1 退出 | `claude daemon status` |33| `claude daemon status` | 列印背景工作階段 [supervisor](/docs/zh-TW/agent-view#the-supervisor-process) 的狀態、版本、socket 目錄和工作者計數以進行診斷。如果 supervisor 未執行則以代碼 1 退出 | `claude daemon status` |
34| `claude daemon stop --any` | 停止背景工作階段 [supervisor](/zh-TW/agent-view#the-supervisor-process) 及其託管的工作階段。傳遞 `--keep-workers` 以保持背景工作階段執行中,以便下一個 supervisor 重新連接到它們。`--any` 確認停止隨選 supervisor,這是預設值。使用此命令以從 [無回應的 supervisor](/zh-TW/agent-view#agent-view-says-the-background-service-did-not-respond) 復原 | `claude daemon stop --any --keep-workers` |34| `claude daemon stop --any` | 停止背景工作階段 [supervisor](/docs/zh-TW/agent-view#the-supervisor-process) 及其託管的工作階段。傳遞 `--keep-workers` 以保持背景工作階段執行中,以便下一個 supervisor 重新連接到它們。`--any` 確認停止隨選 supervisor,這是預設值。使用此命令以從 [無回應的 supervisor](/docs/zh-TW/agent-view#agent-view-says-the-background-service-did-not-respond) 復原 | `claude daemon stop --any --keep-workers` |
35| `claude doctor` | 從終端列印唯讀安裝和設定診斷而不啟動工作階段,包括安裝健康狀況、設定檔驗證錯誤和遠端控制資格。如需可以套用修復的工作階段內設定檢查,請執行 [`/doctor`](/zh-TW/commands#all-commands) | `claude doctor` |35| `claude doctor` | 從終端列印唯讀安裝和設定診斷而不啟動工作階段,包括安裝健康狀況、設定檔驗證錯誤和遠端控制資格。如需可以套用修復的工作階段內設定檢查,請執行 [`/doctor`](/docs/zh-TW/commands#all-commands) | `claude doctor` |
36| `claude logs <id>` | 從 [背景工作階段](/zh-TW/agent-view#manage-sessions-from-the-shell) 列印最近的輸出 | `claude logs 7c5dcf5d` |36| `claude logs <id>` | 從 [背景工作階段](/docs/zh-TW/agent-view#manage-sessions-from-the-shell) 列印最近的輸出 | `claude logs 7c5dcf5d` |
37| `claude mcp` | 設定 Model Context Protocol (MCP) 伺服器 | 請參閱 [Claude Code MCP 文件](/zh-TW/mcp)。 |37| `claude mcp` | 設定 Model Context Protocol (MCP) 伺服器 | 請參閱 [Claude Code MCP 文件](/docs/zh-TW/mcp)。 |
38| `claude mcp login <name>` | {/* min-version: 2.1.186 */}執行已設定的 MCP 伺服器的 OAuth 流程而不開啟互動式 `/mcp` 面板。適用於 HTTP、SSE 和 claude.ai 連接器伺服器。在 SSH 上新增 `--no-browser` 以列印授權 URL 而不是開啟瀏覽器,然後將重新導向 URL 貼回提示。需要 Claude Code v2.1.186 或更新版本。請參閱 [從命令列驗證](/zh-TW/mcp#authenticate-from-the-command-line) | `claude mcp login sentry` |38| `claude mcp login <name>` | 執行已設定的 MCP 伺服器的 OAuth 流程而不開啟互動式 `/mcp` 面板。適用於 HTTP、SSE 和 claude.ai 連接器伺服器。在 SSH 上新增 `--no-browser` 以列印授權 URL 而不是開啟瀏覽器,然後將重新導向 URL 貼回提示。需要 Claude Code v2.1.186 或更新版本。請參閱 [從命令列驗證](/docs/zh-TW/mcp#authenticate-from-the-command-line) | `claude mcp login sentry` |
39| `claude mcp logout <name>` | {/* min-version: 2.1.186 */}清除 MCP 伺服器的已儲存 OAuth 認證。需要 Claude Code v2.1.186 或更新版本 | `claude mcp logout sentry` |39| `claude mcp logout <name>` | 清除 MCP 伺服器的已儲存 OAuth 認證。需要 Claude Code v2.1.186 或更新版本 | `claude mcp logout sentry` |
40| `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` |40| `claude plugin` | 管理 Claude Code [plugins](/docs/zh-TW/plugins)。別名:`claude plugins`。請參閱 [plugin 參考](/docs/zh-TW/plugins-reference#cli-commands-reference) 以了解子命令 | `claude plugin install code-review@claude-plugins-official` |
41| `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` |41| `claude project purge [path]` | 刪除專案的所有本機 Claude Code 狀態:文字記錄、工作清單、偵錯日誌、檔案編輯歷史記錄、提示歷史記錄行和專案在 `~/.claude.json` 中的項目。省略 `[path]` 以從互動式清單中選擇。旗標:`--dry-run` 以預覽,`-y`/`--yes` 以跳過確認,`-i`/`--interactive` 以確認每個項目,`--all` 用於每個專案。請參閱 [清除本機資料](/docs/zh-TW/claude-directory#clear-local-data) | `claude project purge ~/work/repo --dry-run` |
42| `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"` |42| `claude remote-control` | 啟動 [Remote Control](/docs/zh-TW/remote-control) 伺服器以從 Claude.ai 或 Claude 應用程式控制 Claude Code。在伺服器模式下執行(無本機互動式工作階段)。請參閱 [伺服器模式旗標](/docs/zh-TW/remote-control#start-a-remote-control-session) | `claude remote-control --name "My Project"` |
43| `claude respawn <id>` | 重新啟動 [背景工作階段](/zh-TW/agent-view#manage-sessions-from-the-shell)(執行中或已停止),保持其對話完整。使用 `--all` 重新啟動每個執行中的工作階段,例如以取得更新的 Claude Code 二進位檔 | `claude respawn 7c5dcf5d` |43| `claude respawn <id>` | 重新啟動 [背景工作階段](/docs/zh-TW/agent-view#manage-sessions-from-the-shell)(執行中或已停止),保持其對話完整。使用 `--all` 重新啟動每個執行中的工作階段,例如以取得更新的 Claude Code 二進位檔 | `claude respawn 7c5dcf5d` |
44| `claude rm <id>` | 從清單中移除 [背景工作階段](/zh-TW/agent-view#manage-sessions-from-the-shell)。對話文字記錄保留在您的本機電腦上,可透過 `claude --resume` 取得 | `claude rm 7c5dcf5d` |44| `claude rm <id>` | 從清單中移除 [背景工作階段](/docs/zh-TW/agent-view#manage-sessions-from-the-shell)。對話文字記錄保留在您的本機電腦上,可透過 `claude --resume` 取得 | `claude rm 7c5dcf5d` |
45| `claude setup-token` | 為 CI 和指令碼產生長期 OAuth 權杖。將權杖列印到終端而不儲存它。需要 Claude 訂閱。請參閱 [產生長期權杖](/zh-TW/authentication#generate-a-long-lived-token) | `claude setup-token` |45| `claude setup-token` | 為 CI 和指令碼產生長期 OAuth 權杖。將權杖列印到終端而不儲存它。需要 Claude 訂閱。請參閱 [產生長期權杖](/docs/zh-TW/authentication#generate-a-long-lived-token) | `claude setup-token` |
46| `claude stop <id>` | 停止 [背景工作階段](/zh-TW/agent-view#manage-sessions-from-the-shell)。也接受 `claude kill` | `claude stop 7c5dcf5d` |46| `claude stop <id>` | 停止 [背景工作階段](/docs/zh-TW/agent-view#manage-sessions-from-the-shell)。也接受 `claude kill` | `claude stop 7c5dcf5d` |
47| `claude ultrareview [target]` | 非互動式執行 [ultrareview](/zh-TW/ultrareview#run-ultrareview-non-interactively)。將發現列印到標準輸出,成功時以代碼 0 退出,失敗時以代碼 1 退出。使用 `--json` 取得原始承載,使用 `--timeout <minutes>` 覆蓋 30 分鐘的預設值 | `claude ultrareview 1234 --json` |47| `claude ultrareview [target]` | 非互動式執行 [ultrareview](/docs/zh-TW/ultrareview#run-ultrareview-non-interactively)。將發現列印到標準輸出,成功時以代碼 0 退出,失敗時以代碼 1 退出。使用 `--json` 取得原始承載,使用 `--timeout <minutes>` 覆蓋 30 分鐘的預設值 | `claude ultrareview 1234 --json` |
48 48
49如果您輸入錯誤的子命令,Claude Code 會建議最接近的匹配項並退出而不啟動工作階段。例如,`claude udpate` 會列印 `Did you mean claude update?`。49如果您輸入錯誤的子命令,Claude Code 會建議最接近的匹配項並退出而不啟動工作階段。例如,`claude udpate` 會列印 `Did you mean claude update?`。
50 50
51{/* min-version: 2.1.199 */}自 v2.1.199 起,`claude --dangerously-skip-permissions daemon <subcommand>` 執行 `daemon` 子命令。較早的版本將 `daemon <subcommand>` 視為新互動式工作階段的提示,因此當旗標在前面時子命令永遠不會執行,這是 `claude` 別名為包含該旗標時的常見設定。只有前導 `--dangerously-skip-permissions` 或 `--allow-dangerously-skip-permissions` 會以這種方式路由到 `daemon`;任何其他前導旗標仍會啟動互動式工作階段。51自 v2.1.199 起,`claude --dangerously-skip-permissions daemon <subcommand>` 執行 `daemon` 子命令。較早的版本將 `daemon <subcommand>` 視為新互動式工作階段的提示,因此當旗標在前面時子命令永遠不會執行,這是 `claude` 別名為包含該旗標時的常見設定。只有前導 `--dangerously-skip-permissions` 或 `--allow-dangerously-skip-permissions` 會以這種方式路由到 `daemon`;任何其他前導旗標仍會啟動互動式工作階段。
52 52
53<h2 id="cli-flags">53<h2 id="cli-flags">
54 CLI 旗標54 CLI 旗標
57使用這些命令列旗標自訂 Claude Code 的行為。`claude --help` 不會列出每個旗標,因此旗標在 `--help` 中的缺失並不表示它無法使用。57使用這些命令列旗標自訂 Claude Code 的行為。`claude --help` 不會列出每個旗標,因此旗標在 `--help` 中的缺失並不表示它無法使用。
58 58
59| 旗標 | 描述 | 範例 |59| 旗標 | 描述 | 範例 |
60| :---------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------- |60| :---------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------- |
61| `--add-dir` | 新增額外的工作目錄供 Claude 讀取和編輯檔案。授予檔案存取權;大多數 `.claude/` 設定 [未從這些目錄探索](/zh-TW/permissions#additional-directories-grant-file-access-not-configuration)。驗證每個路徑是否存在為目錄。若要在工作階段之間持久化這些目錄,請在設定中設定 [`permissions.additionalDirectories`](/zh-TW/settings#permission-settings) | `claude --add-dir ../apps ../lib` |61| `--add-dir` | 新增額外的工作目錄供 Claude 讀取和編輯檔案。授予檔案存取權;大多數 `.claude/` 設定 [未從這些目錄探索](/docs/zh-TW/permissions#additional-directories-grant-file-access-not-configuration)。驗證每個路徑是否存在為目錄。若要在工作階段之間持久化這些目錄,請在設定中設定 [`permissions.additionalDirectories`](/docs/zh-TW/settings#permission-settings) | `claude --add-dir ../apps ../lib` |
62| `--advisor <model>` | 使用模型別名啟用此工作階段的伺服器端 [advisor tool](/zh-TW/advisor):`opus`、`sonnet` 或 `fable`({/* min-version: 2.1.170 */}v2.1.170+),或完整模型 ID。優先於工作階段的 `advisorModel` 設定 | `claude --advisor opus` |62| `--advisor <model>` | 使用模型別名啟用此工作階段的伺服器端 [advisor tool](/docs/zh-TW/advisor):`opus`、`sonnet` 或 `fable`(v2.1.170+),或完整模型 ID。優先於工作階段的 `advisorModel` 設定 | `claude --advisor opus` |
63| `--agent` | 為目前工作階段指定代理程式(覆蓋 `agent` 設定) | `claude --agent my-custom-agent` |63| `--agent` | 為目前工作階段指定代理程式(覆蓋 `agent` 設定) | `claude --agent my-custom-agent` |
64| `--agents` | 透過 JSON 動態定義自訂 subagents。使用與 subagent [frontmatter](/zh-TW/sub-agents#supported-frontmatter-fields) 相同的欄位名稱,加上代理程式指示的 `prompt` 欄位 | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |64| `--agents` | 透過 JSON 動態定義自訂 subagents。使用與 subagent [frontmatter](/docs/zh-TW/sub-agents#supported-frontmatter-fields) 相同的欄位名稱,加上代理程式指示的 `prompt` 欄位 | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |
65| `--allow-dangerously-skip-permissions` | 新增 `bypassPermissions` 到 `Shift+Tab` 模式循環而不立即啟動它。允許您以不同的模式(如 `plan`)開始,稍後切換到 `bypassPermissions`。請參閱 [permission modes](/zh-TW/permission-modes#skip-all-checks-with-bypasspermissions-mode) | `claude --permission-mode plan --allow-dangerously-skip-permissions` |65| `--allow-dangerously-skip-permissions` | 新增 `bypassPermissions` 到 `Shift+Tab` 模式循環而不立即啟動它。允許您以不同的模式(如 `plan`)開始,稍後切換到 `bypassPermissions`。請參閱 [permission modes](/docs/zh-TW/permission-modes#skip-all-checks-with-bypasspermissions-mode) | `claude --permission-mode plan --allow-dangerously-skip-permissions` |
66| `--allowedTools`、`--allowed-tools` | 無需提示權限即可執行的工具。請參閱 [permission rule syntax](/zh-TW/settings#permission-rule-syntax) 以了解模式匹配。若要限制可用的工具,請改用 `--tools` | `"Bash(git log *)" "Bash(git diff *)" "Read"` |66| `--allowedTools`、`--allowed-tools` | 無需提示權限即可執行的工具。請參閱 [permission rule syntax](/docs/zh-TW/settings#permission-rule-syntax) 以了解模式匹配。若要限制可用的工具,請改用 `--tools` | `"Bash(git log *)" "Bash(git diff *)" "Read"` |
67| `--append-subagent-system-prompt` | {/* min-version: 2.1.205 */}將自訂文字附加到每個 [subagent](/zh-TW/sub-agents) 系統提示的末尾,包括巢狀 subagents。僅適用於使用 `-p` 的非互動模式。需要 Claude Code v2.1.205 或更新版本 | `claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |67| `--append-subagent-system-prompt` | 將自訂文字附加到每個 [subagent](/docs/zh-TW/sub-agents) 系統提示的末尾,包括巢狀 subagents。僅適用於使用 `-p` 的非互動模式。需要 Claude Code v2.1.205 或更新版本 | `claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |
68| `--append-system-prompt` | 將自訂文字附加到預設系統提示的末尾 | `claude --append-system-prompt "Always use TypeScript"` |68| `--append-system-prompt` | 將自訂文字附加到預設系統提示的末尾 | `claude --append-system-prompt "Always use TypeScript"` |
69| `--append-system-prompt-file` | 從檔案載入額外的系統提示文字並附加到預設提示 | `claude --append-system-prompt-file ./extra-rules.txt` |69| `--append-system-prompt-file` | 從檔案載入額外的系統提示文字並附加到預設提示 | `claude --append-system-prompt-file ./extra-rules.txt` |
70| `--ax-screen-reader` | {/* min-version: 2.1.181 */}呈現螢幕閱讀器友善的輸出:平面文字,無裝飾邊框或動畫。強制使用經典渲染器,因此 [`tui`](/zh-TW/settings#available-settings) 設定在工作階段中無效;附加的 [background sessions](/zh-TW/agent-view) 仍會全螢幕呈現。優先於 [`CLAUDE_AX_SCREEN_READER`](/zh-TW/env-vars) 和 [`axScreenReader`](/zh-TW/settings#available-settings) 設定。需要 Claude Code v2.1.181 或更新版本 | `claude --ax-screen-reader` |70| `--ax-screen-reader` | 呈現螢幕閱讀器友善的輸出:平面文字,無裝飾邊框或動畫。強制使用經典渲染器,因此 [`tui`](/docs/zh-TW/settings#available-settings) 設定在工作階段中無效;附加的 [background sessions](/docs/zh-TW/agent-view) 仍會全螢幕呈現。優先於 [`CLAUDE_AX_SCREEN_READER`](/docs/zh-TW/env-vars) 和 [`axScreenReader`](/docs/zh-TW/settings#available-settings) 設定。需要 Claude Code v2.1.181 或更新版本 | `claude --ax-screen-reader` |
71| `--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"` |71| `--bare` | 最小模式:跳過 hooks、skills、plugins、MCP 伺服器、自動記憶體和 CLAUDE.md 的自動探索,以便指令碼呼叫啟動更快。Claude 可以存取 Bash、檔案讀取和檔案編輯工具。設定 [`CLAUDE_CODE_SIMPLE`](/docs/zh-TW/env-vars)。請參閱 [bare mode](/docs/zh-TW/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |
72| `--betas` | 要包含在 API 請求中的 Beta 標頭(僅限 API 金鑰使用者) | `claude --betas interleaved-thinking` |72| `--betas` | 要包含在 API 請求中的 Beta 標頭(僅限 API 金鑰使用者) | `claude --betas interleaved-thinking` |
73| `--bg`、`--background` | 以 [background agent](/zh-TW/agent-view) 身份啟動工作階段並立即返回。列印工作階段 ID 和管理命令。與 `--exec` 結合以執行 shell 命令作為背景工作而不是 Claude 工作階段,或與 `--agent` 結合以執行特定 subagent。{/* min-version: 2.1.198 */}無法與 `-p`/`--print` 結合;請參閱 [error reference](/zh-TW/errors#command-line-errors) | `claude --bg "investigate the flaky test"` |73| `--bg`、`--background` | 以 [background agent](/docs/zh-TW/agent-view) 身份啟動工作階段並立即返回。列印工作階段 ID 和管理命令。與 `--exec` 結合以執行 shell 命令作為背景工作而不是 Claude 工作階段,或與 `--agent` 結合以執行特定 subagent。無法與 `-p`/`--print` 結合;請參閱 [error reference](/docs/zh-TW/errors#command-line-errors) | `claude --bg "investigate the flaky test"` |
74| `--channels` | (研究預覽)MCP 伺服器,其 [channel](/zh-TW/channels) 通知 Claude 應在此工作階段中監聽。以空格分隔的 `plugin:<name>@<marketplace>` 項目清單。需要 Claude.ai 驗證 | `claude --channels plugin:my-notifier@my-marketplace` |74| `--channels` | (研究預覽)MCP 伺服器,其 [channel](/docs/zh-TW/channels) 通知 Claude 應在此工作階段中監聽。以空格分隔的 `plugin:<name>@<marketplace>` 項目清單。需要 Claude.ai 驗證 | `claude --channels plugin:my-notifier@my-marketplace` |
75| `--chrome` | 啟用 [Chrome 瀏覽器整合](/zh-TW/chrome) 以進行網頁自動化和測試 | `claude --chrome` |75| `--chrome` | 啟用 [Chrome 瀏覽器整合](/docs/zh-TW/chrome) 以進行網頁自動化和測試 | `claude --chrome` |
76| `--cloud` | 在 claude.ai 上建立新的 [web session](/zh-TW/claude-code-on-the-web),並提供工作描述 | `claude --cloud "Fix the login bug"` |76| `--cloud` | 在 claude.ai 上建立新的 [web session](/docs/zh-TW/claude-code-on-the-web),並提供工作描述 | `claude --cloud "Fix the login bug"` |
77| `--continue`、`-c` | 載入目前目錄中最近的對話。包括使用 `/add-dir` 新增此目錄的工作階段 | `claude --continue` |77| `--continue`、`-c` | 載入目前目錄中最近的對話。包括使用 `/add-dir` 新增此目錄的工作階段 | `claude --continue` |
78| `--dangerously-load-development-channels` | 啟用不在核准允許清單上的 [channels](/zh-TW/channels-reference#test-during-the-research-preview),用於本機開發。接受 `plugin:<name>@<marketplace>` 和 `server:<name>` 項目。提示確認 | `claude --dangerously-load-development-channels server:webhook` |78| `--dangerously-load-development-channels` | 啟用不在核准允許清單上的 [channels](/docs/zh-TW/channels-reference#test-during-the-research-preview),用於本機開發。接受 `plugin:<name>@<marketplace>` 和 `server:<name>` 項目。提示確認 | `claude --dangerously-load-development-channels server:webhook` |
79| `--dangerously-skip-permissions` | 略過權限提示。等同於 `--permission-mode bypassPermissions`。請參閱 [permission modes](/zh-TW/permission-modes#skip-all-checks-with-bypasspermissions-mode) 以了解此操作會和不會略過的內容。對於以 `--bg` 啟動的工作階段,該模式 [在監督者重新啟動工作階段時持續](/zh-TW/agent-view#permission-mode-model-and-effort) | `claude --dangerously-skip-permissions` |79| `--dangerously-skip-permissions` | 略過權限提示。等同於 `--permission-mode bypassPermissions`。請參閱 [permission modes](/docs/zh-TW/permission-modes#skip-all-checks-with-bypasspermissions-mode) 以了解此操作會和不會略過的內容。對於以 `--bg` 啟動的工作階段,該模式 [在監督者重新啟動工作階段時持續](/docs/zh-TW/agent-view#permission-mode-model-and-effort) | `claude --dangerously-skip-permissions` |
80| `--debug` | 啟用偵錯模式,可選類別篩選(例如,`"api,hooks"` 或 `"!statsig,!file"`) | `claude --debug "api,mcp"` |80| `--debug` | 啟用偵錯模式,可選類別篩選(例如,`"api,hooks"` 或 `"!statsig,!file"`) | `claude --debug "api,mcp"` |
81| `--debug-file <path>` | 將偵錯日誌寫入特定檔案路徑。隱含啟用偵錯模式。優先於 `CLAUDE_CODE_DEBUG_LOGS_DIR` | `claude --debug-file /tmp/claude-debug.log` |81| `--debug-file <path>` | 將偵錯日誌寫入特定檔案路徑。隱含啟用偵錯模式。優先於 `CLAUDE_CODE_DEBUG_LOGS_DIR` | `claude --debug-file /tmp/claude-debug.log` |
82| `--disable-slash-commands` | 為此工作階段停用所有 skills 和命令 | `claude --disable-slash-commands` |82| `--disable-slash-commands` | 為此工作階段停用所有 skills 和命令 | `claude --disable-slash-commands` |
83| `--disallowedTools`、`--disallowed-tools` | 拒絕規則。裸工具名稱會從模型的內容中移除該工具:`"Edit"` 移除 Edit、`"*"` 移除每個工具,`"mcp__*"` 移除每個 MCP 工具。範圍規則(例如 `Bash(rm *)` )會保留工具可用,但只拒絕符合的呼叫 | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |83| `--disallowedTools`、`--disallowed-tools` | 拒絕規則。裸工具名稱會從模型的內容中移除該工具:`"Edit"` 移除 Edit、`"*"` 移除每個工具,`"mcp__*"` 移除每個 MCP 工具。範圍規則(例如 `Bash(rm *)` )會保留工具可用,但只拒絕符合的呼叫 | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |
84| `--effort` | 為目前工作階段設定 [effort level](/zh-TW/model-config#adjust-effort-level)。選項:`low`、`medium`、`high`、`xhigh`、`max` 或 {/* min-version: 2.1.203 */}}`ultracode`。可用的層級取決於模型。`ultracode` 以 `xhigh` 努力開始工作階段,並啟用 [ultracode](/zh-TW/workflows#let-claude-decide-with-ultracode),需要 Claude Code v2.1.203 或更新版本。覆蓋此工作階段的 [`effortLevel`](/zh-TW/settings#available-settings) 設定,且不會持久化 | `claude --effort high` |84| `--effort` | 為目前工作階段設定 [effort level](/docs/zh-TW/model-config#adjust-effort-level)。選項:`low`、`medium`、`high`、`xhigh`、`max` 或 }`ultracode`。可用的層級取決於模型。`ultracode` 以 `xhigh` 努力開始工作階段,並啟用 [ultracode](/docs/zh-TW/workflows#let-claude-decide-with-ultracode),需要 Claude Code v2.1.203 或更新版本。覆蓋此工作階段的 [`effortLevel`](/docs/zh-TW/settings#available-settings) 設定,且不會持久化 | `claude --effort high` |
85| `--enable-auto-mode` | {/* max-version: 2.1.110 */}在 v2.1.111 中移除。Auto mode 現在預設在 `Shift+Tab` 循環中;使用 `--permission-mode auto` 以它開始 | `claude --permission-mode auto` |85| `--enable-auto-mode` | 在 v2.1.111 中移除。Auto mode 現在預設在 `Shift+Tab` 循環中;使用 `--permission-mode auto` 以它開始 | `claude --permission-mode auto` |
86| `--exclude-dynamic-system-prompt-sections` | 將每台機器的系統提示部分(工作目錄、環境資訊、記憶體路徑、git 狀態旗標)移至第一個使用者訊息。改善在執行相同工作的不同使用者和機器之間的提示快取重複使用。僅適用於預設系統提示;設定 `--system-prompt` 或 `--system-prompt-file` 時忽略。與 `-p` 搭配使用以進行指令碼化、多使用者工作負載 | `claude -p --exclude-dynamic-system-prompt-sections "query"` |86| `--exclude-dynamic-system-prompt-sections` | 將每台機器的系統提示部分(工作目錄、環境資訊、記憶體路徑、git 狀態旗標)移至第一個使用者訊息。改善在執行相同工作的不同使用者和機器之間的提示快取重複使用。僅適用於預設系統提示;設定 `--system-prompt` 或 `--system-prompt-file` 時忽略。與 `-p` 搭配使用以進行指令碼化、多使用者工作負載 | `claude -p --exclude-dynamic-system-prompt-sections "query"` |
87| `--exec` | 執行 shell 命令作為 PTY 支援的背景工作而不是啟動 Claude 工作階段。與 `--bg` 搭配使用以從 shell 啟動 | `claude --bg --exec 'pytest -x'` |87| `--exec` | 執行 shell 命令作為 PTY 支援的背景工作而不是啟動 Claude 工作階段。與 `--bg` 搭配使用以從 shell 啟動 | `claude --bg --exec 'pytest -x'` |
88| `--fallback-model` | 當主要模型過載或無法使用時啟用自動回退到指定的模型,例如已淘汰的模型。接受以逗號分隔的清單,依序嘗試。請參閱 [Fallback model chains](/zh-TW/model-config#fallback-model-chains)。若要在工作階段之間持久化鏈,請使用 [`fallbackModel` 設定](/zh-TW/settings#available-settings),此旗標會覆蓋它 | `claude --fallback-model sonnet,haiku` |88| `--fallback-model` | 當主要模型過載或無法使用時啟用自動回退到指定的模型,例如已淘汰的模型。接受以逗號分隔的清單,依序嘗試。請參閱 [Fallback model chains](/docs/zh-TW/model-config#fallback-model-chains)。若要在工作階段之間持久化鏈,請使用 [`fallbackModel` 設定](/docs/zh-TW/settings#available-settings),此旗標會覆蓋它 | `claude --fallback-model sonnet,haiku` |
89| `--fork-session` | 繼續時,建立新的工作階段 ID 而不是重複使用原始 ID(與 `--resume` 或 `--continue` 搭配使用) | `claude --resume abc123 --fork-session` |89| `--fork-session` | 繼續時,建立新的工作階段 ID 而不是重複使用原始 ID(與 `--resume` 或 `--continue` 搭配使用) | `claude --resume abc123 --fork-session` |
90| `--from-pr` | 繼續連結到特定提取請求的工作階段。接受 PR 編號、GitHub 或 GitHub Enterprise PR URL、GitLab 合併請求 URL 或 Bitbucket 提取請求 URL。當 Claude 建立提取請求時,工作階段會自動連結 | `claude --from-pr 123` |90| `--from-pr` | 繼續連結到特定提取請求的工作階段。接受 PR 編號、GitHub 或 GitHub Enterprise PR URL、GitLab 合併請求 URL 或 Bitbucket 提取請求 URL。當 Claude 建立提取請求時,工作階段會自動連結 | `claude --from-pr 123` |
91| `--ide` | 如果恰好有一個有效的 IDE 可用,在啟動時自動連線到 IDE | `claude --ide` |91| `--ide` | 如果恰好有一個有效的 IDE 可用,在啟動時自動連線到 IDE | `claude --ide` |
92| `--init` | 在工作階段前執行 [Setup hooks](/zh-TW/hooks#setup),使用 `init` 匹配器(僅列印模式) | `claude -p --init "query"` |92| `--init` | 在工作階段前執行 [Setup hooks](/docs/zh-TW/hooks#setup),使用 `init` 匹配器(僅列印模式) | `claude -p --init "query"` |
93| `--init-only` | 執行 [Setup](/zh-TW/hooks#setup) 和 `SessionStart` hooks,然後退出而不啟動對話 | `claude --init-only` |93| `--init-only` | 執行 [Setup](/docs/zh-TW/hooks#setup) 和 `SessionStart` hooks,然後退出而不啟動對話 | `claude --init-only` |
94| `--include-hook-events` | 在輸出串流中包含所有 hook 生命週期事件。`SessionStart` 和 `Setup` hook 事件始終包含,不需要此旗標。需要 `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-hook-events "query"` |94| `--include-hook-events` | 在輸出串流中包含所有 hook 生命週期事件。`SessionStart` 和 `Setup` hook 事件始終包含,不需要此旗標。需要 `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-hook-events "query"` |
95| `--include-partial-messages` | 在輸出中包含部分串流事件。需要 `--print` 和 `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-partial-messages "query"` |95| `--include-partial-messages` | 在輸出中包含部分串流事件。需要 `--print` 和 `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-partial-messages "query"` |
96| `--input-format` | 為列印模式指定輸入格式(選項:`text`、`stream-json`) | `claude -p --output-format json --input-format stream-json` |96| `--input-format` | 為列印模式指定輸入格式(選項:`text`、`stream-json`) | `claude -p --output-format json --input-format stream-json` |
97| `--json-schema` | 在代理程式完成其工作流程後取得符合 JSON Schema 的驗證 JSON 輸出(僅列印模式)。請參閱 [structured outputs](/zh-TW/agent-sdk/structured-outputs)。{/* min-version: 2.1.205 */}Claude Code 在無效的 schema 上以錯誤退出,並接受 `format` 關鍵字作為註解而不進行用戶端驗證。在 v2.1.205 之前,無效的 schema 產生無結構輸出且無錯誤,使用 `format` 的 schemas 被視為無效 | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |97| `--json-schema` | 在代理程式完成其工作流程後取得符合 JSON Schema 的驗證 JSON 輸出(僅列印模式)。請參閱 [structured outputs](/docs/zh-TW/agent-sdk/structured-outputs)。Claude Code 在無效的 schema 上以錯誤退出,並接受 `format` 關鍵字作為註解而不進行用戶端驗證。在 v2.1.205 之前,無效的 schema 產生無結構輸出且無錯誤,使用 `format` 的 schemas 被視為無效 | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |
98| `--maintenance` | 在工作階段前執行 [Setup hooks](/zh-TW/hooks#setup),使用 `maintenance` 匹配器(僅列印模式) | `claude -p --maintenance "query"` |98| `--maintenance` | 在工作階段前執行 [Setup hooks](/docs/zh-TW/hooks#setup),使用 `maintenance` 匹配器(僅列印模式) | `claude -p --maintenance "query"` |
99| `--max-budget-usd` | 在停止前在 API 呼叫上花費的最大美元金額(僅列印模式) | `claude -p --max-budget-usd 5.00 "query"` |99| `--max-budget-usd` | 在停止前在 API 呼叫上花費的最大美元金額(僅列印模式) | `claude -p --max-budget-usd 5.00 "query"` |
100| `--max-turns` | 限制代理程式轉數(僅列印模式)。達到限制時以錯誤退出。預設無限制。{/* min-version: 2.1.205 */}使用 `--input-format stream-json` 時,在 Claude 工作時傳送的訊息會保持佇列狀態,並在限制結束目前轉數時作為自己的轉數執行,具有自己的限制。在 v2.1.205 之前,Claude Code 丟棄該訊息 | `claude -p --max-turns 3 "query"` |100| `--max-turns` | 限制代理程式轉數(僅列印模式)。達到限制時以錯誤退出。預設無限制。使用 `--input-format stream-json` 時,在 Claude 工作時傳送的訊息會保持佇列狀態,並在限制結束目前轉數時作為自己的轉數執行,具有自己的限制。在 v2.1.205 之前,Claude Code 丟棄該訊息 | `claude -p --max-turns 3 "query"` |
101| `--mcp-config` | 從 JSON 檔案或字串載入 MCP 伺服器(以空格分隔) | `claude --mcp-config ./mcp.json` |101| `--mcp-config` | 從 JSON 檔案或字串載入 MCP 伺服器(以空格分隔) | `claude --mcp-config ./mcp.json` |
102| `--model` | 使用最新模型的別名(`sonnet`、`opus`、`haiku` 或 `fable`)或模型的完整名稱為目前工作階段設定模型。覆蓋 [`model`](/zh-TW/settings#available-settings) 設定和 [`ANTHROPIC_MODEL`](/zh-TW/model-config#environment-variables) | `claude --model claude-sonnet-5` |102| `--model` | 使用最新模型的別名(`sonnet`、`opus`、`haiku` 或 `fable`)或模型的完整名稱為目前工作階段設定模型。覆蓋 [`model`](/docs/zh-TW/settings#available-settings) 設定和 [`ANTHROPIC_MODEL`](/docs/zh-TW/model-config#environment-variables) | `claude --model claude-sonnet-5` |
103| `--name`、`-n` | 為工作階段設定顯示名稱,顯示在 `/resume` 和終端標題中。您可以使用 `claude --resume <name>` 繼續已命名的工作階段。<br /><br />[`/rename`](/zh-TW/commands) 在工作階段中途變更名稱,也會在提示列中顯示 | `claude -n "my-feature-work"` |103| `--name`、`-n` | 為工作階段設定顯示名稱,顯示在 `/resume` 和終端標題中。您可以使用 `claude --resume <name>` 繼續已命名的工作階段。<br /><br />[`/rename`](/docs/zh-TW/commands) 在工作階段中途變更名稱,也會在提示列中顯示 | `claude -n "my-feature-work"` |
104| `--no-chrome` | 為此工作階段停用 [Chrome 瀏覽器整合](/zh-TW/chrome) | `claude --no-chrome` |104| `--no-chrome` | 為此工作階段停用 [Chrome 瀏覽器整合](/docs/zh-TW/chrome) | `claude --no-chrome` |
105| `--no-session-persistence` | 停用工作階段持久性,使工作階段不會儲存到磁碟且無法繼續。僅列印模式。[`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/zh-TW/env-vars) 環境變數在任何模式中執行相同操作 | `claude -p --no-session-persistence "query"` |105| `--no-session-persistence` | 停用工作階段持久性,使工作階段不會儲存到磁碟且無法繼續。僅列印模式。[`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/zh-TW/env-vars) 環境變數在任何模式中執行相同操作 | `claude -p --no-session-persistence "query"` |
106| `--output-format` | 為列印模式指定輸出格式(選項:`text`、`json`、`stream-json`) | `claude -p "query" --output-format json` |106| `--output-format` | 為列印模式指定輸出格式(選項:`text`、`json`、`stream-json`) | `claude -p "query" --output-format json` |
107| `--permission-mode` | 以指定的 [permission mode](/zh-TW/permission-modes) 開始。接受 `default`、`acceptEdits`、`plan`、`auto`、`dontAsk`、`bypassPermissions` 或 {/* min-version: 2.1.200 */}}`manual` 作為 `default` 的別名。`manual` 別名選擇 UI 標記為「手動」的模式,需要 Claude Code v2.1.200 或更新版本;`claude --help` 會列出它以取代 `default`,兩個值都有效。覆蓋設定檔案中的 `defaultMode` | `claude --permission-mode plan` |107| `--permission-mode` | 以指定的 [permission mode](/docs/zh-TW/permission-modes) 開始。接受 `default`、`acceptEdits`、`plan`、`auto`、`dontAsk`、`bypassPermissions` 或 }`manual` 作為 `default` 的別名。`manual` 別名選擇 UI 標記為「手動」的模式,需要 Claude Code v2.1.200 或更新版本;`claude --help` 會列出它以取代 `default`,兩個值都有效。覆蓋設定檔案中的 `defaultMode` | `claude --permission-mode plan` |
108| `--permission-prompt-tool` | 指定 MCP 工具以在非互動模式下處理權限提示。{/* min-version: 2.1.206 */}Claude Code 會等待該工具的 MCP 伺服器連線,最多等待 [`MCP_TIMEOUT`](/zh-TW/env-vars) 啟動逾時 30 秒,然後執行第一個轉數。在 v2.1.206 之前,啟動緩慢的伺服器可能會導致執行 [以找不到 MCP 工具的錯誤退出](/zh-TW/errors#mcp-permission-prompt-tool-not-found)。<br /><br />{/* min-version: 2.1.199 */}提示工具無法核准標記為 [requiring user interaction](/zh-TW/mcp#require-approval-for-a-specific-tool) 的 MCP 工具:Claude Code 會將其 `allow` 結果轉換為拒絕。此限制需要 Claude Code v2.1.199 或更新版本 | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |108| `--permission-prompt-tool` | 指定 MCP 工具以在非互動模式下處理權限提示。Claude Code 會等待該工具的 MCP 伺服器連線,最多等待 [`MCP_TIMEOUT`](/docs/zh-TW/env-vars) 啟動逾時 30 秒,然後執行第一個轉數。在 v2.1.206 之前,啟動緩慢的伺服器可能會導致執行 [以找不到 MCP 工具的錯誤退出](/docs/zh-TW/errors#mcp-permission-prompt-tool-not-found)。<br /><br />提示工具無法核准標記為 [requiring user interaction](/docs/zh-TW/mcp#require-approval-for-a-specific-tool) 的 MCP 工具:Claude Code 會將其 `allow` 結果轉換為拒絕。此限制需要 Claude Code v2.1.199 或更新版本 | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |
109| `--plugin-dir` | 為此工作階段僅從目錄或 `.zip` 封存載入 plugin。每個旗標採用一個路徑。重複旗標以使用多個 plugins:`--plugin-dir A --plugin-dir B.zip` | `claude --plugin-dir ./my-plugin` |109| `--plugin-dir` | 為此工作階段僅從目錄或 `.zip` 封存載入 plugin。每個旗標採用一個路徑。重複旗標以使用多個 plugins:`--plugin-dir A --plugin-dir B.zip` | `claude --plugin-dir ./my-plugin` |
110| `--plugin-url` | 為此工作階段僅從 URL 擷取 plugin `.zip` 封存。重複旗標以使用多個 plugins,或在單一引用值中傳遞以空格分隔的 URL | `claude --plugin-url https://example.com/plugin.zip` |110| `--plugin-url` | 為此工作階段僅從 URL 擷取 plugin `.zip` 封存。重複旗標以使用多個 plugins,或在單一引用值中傳遞以空格分隔的 URL | `claude --plugin-url https://example.com/plugin.zip` |
111| `--print`、`-p` | 列印回應而不進入互動模式(請參閱 [Agent SDK 文件](/zh-TW/agent-sdk/overview) 以了解程式化使用詳細資訊) | `claude -p "query"` |111| `--print`、`-p` | 列印回應而不進入互動模式(請參閱 [Agent SDK 文件](/docs/zh-TW/agent-sdk/overview) 以了解程式化使用詳細資訊) | `claude -p "query"` |
112| `--prompt-suggestions` | 在每個轉數後發出 `prompt_suggestion` 訊息,其中包含預測的下一個使用者提示。需要 `--print`、`--output-format stream-json` 和 `--verbose`。請參閱 [Prompt suggestions](/zh-TW/interactive-mode#prompt-suggestions) | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |112| `--prompt-suggestions` | 在每個轉數後發出 `prompt_suggestion` 訊息,其中包含預測的下一個使用者提示。需要 `--print`、`--output-format stream-json` 和 `--verbose`。請參閱 [Prompt suggestions](/docs/zh-TW/interactive-mode#prompt-suggestions) | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |
113| `--remote` | `--cloud` 的已棄用別名 | `claude --remote "Fix the login bug"` |113| `--remote` | `--cloud` 的已棄用別名 | `claude --remote "Fix the login bug"` |
114| `--remote-control`、`--rc` | 啟動互動式工作階段,並啟用 [Remote Control](/zh-TW/remote-control#start-a-remote-control-session),以便您也可以從 claude.ai 或 Claude 應用程式控制它。可選擇傳遞工作階段的名稱 | `claude --remote-control "My Project"` |114| `--remote-control`、`--rc` | 啟動互動式工作階段,並啟用 [Remote Control](/docs/zh-TW/remote-control#start-a-remote-control-session),以便您也可以從 claude.ai 或 Claude 應用程式控制它。可選擇傳遞工作階段的名稱 | `claude --remote-control "My Project"` |
115| `--remote-control-session-name-prefix <prefix>` | [Remote Control](/zh-TW/remote-control) 工作階段名稱的前綴,當未設定明確名稱時自動產生。預設為您的機器主機名稱,產生如 `myhost-graceful-unicorn` 的名稱。設定 `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` 以獲得相同效果 | `claude remote-control --remote-control-session-name-prefix dev-box` |115| `--remote-control-session-name-prefix <prefix>` | [Remote Control](/docs/zh-TW/remote-control) 工作階段名稱的前綴,當未設定明確名稱時自動產生。預設為您的機器主機名稱,產生如 `myhost-graceful-unicorn` 的名稱。設定 `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` 以獲得相同效果 | `claude remote-control --remote-control-session-name-prefix dev-box` |
116| `--replay-user-messages` | 從 stdin 重新發出使用者訊息回到 stdout 以進行確認。需要 `--input-format stream-json` 和 `--output-format stream-json` | `claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |116| `--replay-user-messages` | 從 stdin 重新發出使用者訊息回到 stdout 以進行確認。需要 `--input-format stream-json` 和 `--output-format stream-json` | `claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |
117| `--resume`、`-r` | 按 ID 或名稱繼續特定工作階段,或顯示互動式選擇器以選擇工作階段。選擇器和名稱搜尋包括使用 `/add-dir` 新增此目錄的工作階段;傳遞工作階段 ID 只搜尋目前專案目錄及其 git worktrees。自 v2.1.144 起,[background sessions](/zh-TW/agent-view) 在選擇器中出現,標記為 `bg` | `claude --resume auth-refactor` |117| `--resume`、`-r` | 按 ID 或名稱繼續特定工作階段,或顯示互動式選擇器以選擇工作階段。選擇器和名稱搜尋包括使用 `/add-dir` 新增此目錄的工作階段;傳遞工作階段 ID 只搜尋目前專案目錄及其 git worktrees。自 v2.1.144 起,[background sessions](/docs/zh-TW/agent-view) 在選擇器中出現,標記為 `bg` | `claude --resume auth-refactor` |
118| `--safe-mode` | {/* min-version: 2.1.169 */}以所有自訂項目停用的狀態啟動以排除故障的設定:CLAUDE.md、skills、plugins、hooks、MCP 伺服器、自訂命令和代理程式、輸出樣式、工作流程、自訂主題、自訂快捷鍵、狀態列和檔案建議命令、LSP 伺服器和自動記憶體不會載入。驗證、模型選擇、內建工具和權限正常運作,這與 [`--bare`](/zh-TW/headless#start-faster-with-bare-mode) 不同。受管設定原則仍然適用,包括原則設定的 hooks、狀態列和檔案建議命令;受管 plugins、受管 skills、受管 CLAUDE.md 和原則設定的 MCP 伺服器不會。用於檢查自訂項目是否觸發 [automatic fallback from Fable 5](/zh-TW/model-config#automatic-model-fallback)。設定 [`CLAUDE_CODE_SAFE_MODE`](/zh-TW/env-vars) | `claude --safe-mode` |118| `--safe-mode` | 以所有自訂項目停用的狀態啟動以排除故障的設定:CLAUDE.md、skills、plugins、hooks、MCP 伺服器、自訂命令和代理程式、輸出樣式、工作流程、自訂主題、自訂快捷鍵、狀態列和檔案建議命令、LSP 伺服器和自動記憶體不會載入。驗證、模型選擇、內建工具和權限正常運作,這與 [`--bare`](/docs/zh-TW/headless#start-faster-with-bare-mode) 不同。受管設定原則仍然適用,包括原則設定的 hooks、狀態列和檔案建議命令;受管 plugins、受管 skills、受管 CLAUDE.md 和原則設定的 MCP 伺服器不會。用於檢查自訂項目是否觸發 [automatic fallback from Fable 5](/docs/zh-TW/model-config#automatic-model-fallback)。設定 [`CLAUDE_CODE_SAFE_MODE`](/docs/zh-TW/env-vars) | `claude --safe-mode` |
119| `--session-id` | 為對話使用特定的工作階段 ID(必須是有效的 UUID) | `claude --session-id "550e8400-e29b-41d4-a716-446655440000"` |119| `--session-id` | 為對話使用特定的工作階段 ID(必須是有效的 UUID) | `claude --session-id "550e8400-e29b-41d4-a716-446655440000"` |
120| `--setting-sources` | 要載入的設定來源的逗號分隔清單(`user`、`project`、`local`) | `claude --setting-sources user,project` |120| `--setting-sources` | 要載入的設定來源的逗號分隔清單(`user`、`project`、`local`) | `claude --setting-sources user,project` |
121| `--settings` | 設定 JSON 檔案的路徑或內嵌 JSON 字串。您在此設定的值會覆蓋此工作階段中 `settings.json` 檔案中的相同金鑰。您省略的金鑰保留其檔案型值。請參閱 [settings precedence](/zh-TW/settings#settings-precedence) | `claude --settings ./settings.json` |121| `--settings` | 設定 JSON 檔案的路徑或內嵌 JSON 字串。您在此設定的值會覆蓋此工作階段中 `settings.json` 檔案中的相同金鑰。您省略的金鑰保留其檔案型值。請參閱 [settings precedence](/docs/zh-TW/settings#settings-precedence) | `claude --settings ./settings.json` |
122| `--strict-mcp-config` | 僅使用 `--mcp-config` 中的 MCP 伺服器,忽略所有其他 MCP 設定 | `claude --strict-mcp-config --mcp-config ./mcp.json` |122| `--strict-mcp-config` | 僅使用 `--mcp-config` 中的 MCP 伺服器,忽略所有其他 MCP 設定 | `claude --strict-mcp-config --mcp-config ./mcp.json` |
123| `--system-prompt` | 用自訂文字取代整個系統提示 | `claude --system-prompt "You are a Python expert"` |123| `--system-prompt` | 用自訂文字取代整個系統提示 | `claude --system-prompt "You are a Python expert"` |
124| `--system-prompt-file` | 從檔案載入系統提示,取代預設提示 | `claude --system-prompt-file ./custom-prompt.txt` |124| `--system-prompt-file` | 從檔案載入系統提示,取代預設提示 | `claude --system-prompt-file ./custom-prompt.txt` |
125| `--teleport` | 在本機終端中繼續 [web session](/zh-TW/claude-code-on-the-web) | `claude --teleport` |125| `--teleport` | 在本機終端中繼續 [web session](/docs/zh-TW/claude-code-on-the-web) | `claude --teleport` |
126| `--teammate-mode` | 設定 [agent team](/zh-TW/agent-teams) 隊友的顯示方式:`in-process`(預設)、`auto`、`tmux` 或 {/* min-version: 2.1.186 */}}`iterm2`(在 v2.1.186 中新增)。預設在 v2.1.179 中從 `auto` 變更。覆蓋此工作階段的 [`teammateMode`](/zh-TW/settings#available-settings) 設定。請參閱 [選擇顯示模式](/zh-TW/agent-teams#choose-a-display-mode) | `claude --teammate-mode auto` |126| `--teammate-mode` | 設定 [agent team](/docs/zh-TW/agent-teams) 隊友的顯示方式:`in-process`(預設)、`auto`、`tmux` 或 }`iterm2`(在 v2.1.186 中新增)。預設在 v2.1.179 中從 `auto` 變更。覆蓋此工作階段的 [`teammateMode`](/docs/zh-TW/settings#available-settings) 設定。請參閱 [選擇顯示模式](/docs/zh-TW/agent-teams#choose-a-display-mode) | `claude --teammate-mode auto` |
127| `--tmux` | 為 worktree 建立 tmux 工作階段。需要 `--worktree`。在可用時使用 iTerm2 原生窗格;傳遞 `--tmux=classic` 以使用傳統 tmux | `claude -w feature-auth --tmux` |127| `--tmux` | 為 worktree 建立 tmux 工作階段。需要 `--worktree`。在可用時使用 iTerm2 原生窗格;傳遞 `--tmux=classic` 以使用傳統 tmux | `claude -w feature-auth --tmux` |
128| `--tools` | 限制 Claude 可以使用的內建工具。使用 `""` 停用全部、`"default"` 為全部,或工具名稱如 `"Bash,Edit,Read"`。MCP 工具不受影響;若要拒絕這些工具,請改用 `--disallowedTools "mcp__*"`,或傳遞 `--strict-mcp-config` 而不使用 `--mcp-config` 以便不載入 MCP 伺服器 | `claude --tools "Bash,Edit,Read"` |128| `--tools` | 限制 Claude 可以使用的內建工具。使用 `""` 停用全部、`"default"` 為全部,或工具名稱如 `"Bash,Edit,Read"`。MCP 工具不受影響;若要拒絕這些工具,請改用 `--disallowedTools "mcp__*"`,或傳遞 `--strict-mcp-config` 而不使用 `--mcp-config` 以便不載入 MCP 伺服器 | `claude --tools "Bash,Edit,Read"` |
129| `--verbose` | 啟用詳細記錄,顯示完整的逐轉輸出。覆蓋此工作階段的 [`viewMode`](/zh-TW/settings#available-settings) 設定 | `claude --verbose` |129| `--verbose` | 啟用詳細記錄,顯示完整的逐轉輸出。覆蓋此工作階段的 [`viewMode`](/docs/zh-TW/settings#available-settings) 設定 | `claude --verbose` |
130| `--version`、`-v` | 輸出版本號 | `claude -v` |130| `--version`、`-v` | 輸出版本號 | `claude -v` |
131| `--worktree`、`-w` | 在隔離的 [git worktree](/zh-TW/worktrees) 中啟動 Claude,位於 `<repo>/.claude/worktrees/<name>`。如果未提供名稱,則會自動產生一個。傳遞 `#<number>` 或 GitHub 提取請求 URL 以從 `origin` 擷取該 PR 並從它分支 worktree | `claude -w feature-auth` |131| `--worktree`、`-w` | 在隔離的 [git worktree](/docs/zh-TW/worktrees) 中啟動 Claude,位於 `<repo>/.claude/worktrees/<name>`。如果未提供名稱,則會自動產生一個。傳遞 `#<number>` 或 GitHub 提取請求 URL 以從 `origin` 擷取該 PR 並從它分支 worktree | `claude -w feature-auth` |
132 132
133<h3 id="system-prompt-flags">133<h3 id="system-prompt-flags">
134 系統提示旗標134 系統提示旗標
147 147
148根據 Claude Code 的預設身份是否仍適合您的工作來選擇。當 Claude 應保持編碼助手身份並同時遵循您的額外規則時,請使用附加旗標:每次呼叫的指示、輸出格式或 `-p` 指令碼的領域內容。附加會保留預設工具指導、安全指示和編碼慣例,因此您只需提供不同的部分。當表面、身份或權限模型與 Claude Code 不同時,請使用取代旗標,例如管道中沒有人監看的非編碼代理程式。取代會移除整個預設提示,包括工具指導和安全指示,因此您需要負責您的工作仍然需要的任何內容。148根據 Claude Code 的預設身份是否仍適合您的工作來選擇。當 Claude 應保持編碼助手身份並同時遵循您的額外規則時,請使用附加旗標:每次呼叫的指示、輸出格式或 `-p` 指令碼的領域內容。附加會保留預設工具指導、安全指示和編碼慣例,因此您只需提供不同的部分。當表面、身份或權限模型與 Claude Code 不同時,請使用取代旗標,例如管道中沒有人監看的非編碼代理程式。取代會移除整個預設提示,包括工具指導和安全指示,因此您需要負責您的工作仍然需要的任何內容。
149 149
150這些旗標僅適用於目前的呼叫。對於您可以在專案中切換和共享的持久人物,請使用 [output styles](/zh-TW/output-styles)。對於 Claude 應始終遵循的專案慣例,請使用 [CLAUDE.md](/zh-TW/memory)。[Agent SDK 系統提示指南](/zh-TW/agent-sdk/modifying-system-prompts#decide-on-a-starting-point) 涵蓋了更深入的相同決策。150這些旗標僅適用於目前的呼叫。對於您可以在專案中切換和共享的持久人物,請使用 [output styles](/docs/zh-TW/output-styles)。對於 Claude 應始終遵循的專案慣例,請使用 [CLAUDE.md](/docs/zh-TW/memory)。[Agent SDK 系統提示指南](/docs/zh-TW/agent-sdk/modifying-system-prompts#decide-on-a-starting-point) 涵蓋了更深入的相同決策。
151 151
152<h2 id="see-also">152<h2 id="see-also">
153 另請參閱153 另請參閱
154</h2>154</h2>
155 155
156* [Chrome 擴充功能](/zh-TW/chrome) - 瀏覽器自動化和網頁測試156* [Chrome 擴充功能](/docs/zh-TW/chrome) - 瀏覽器自動化和網頁測試
157* [互動模式](/zh-TW/interactive-mode) - 快捷鍵、輸入模式和互動功能157* [互動模式](/docs/zh-TW/interactive-mode) - 快捷鍵、輸入模式和互動功能
158* [快速入門指南](/zh-TW/quickstart) - Claude Code 入門158* [快速入門指南](/docs/zh-TW/quickstart) - Claude Code 入門
159* [常見工作流程](/zh-TW/common-workflows) - 進階工作流程和模式159* [常見工作流程](/docs/zh-TW/common-workflows) - 進階工作流程和模式
160* [設定](/zh-TW/settings) - 設定選項160* [設定](/docs/zh-TW/settings) - 設定選項
161* [Agent SDK 文件](/zh-TW/agent-sdk/overview) - 程式化使用和整合161* [Agent SDK 文件](/docs/zh-TW/agent-sdk/overview) - 程式化使用和整合