CLI 使用方式和控制

開始使用

Claude Code 提供兩種主要的互動方式：

互動模式：執行 claude 開始 REPL 會話
單次模式：使用 claude -p "查詢" 進行快速命令

# 啟動互動模式
claude

# 以初始查詢啟動
claude "解釋這個專案"

# 執行單一命令後退出
claude -p "這個函數做什麼？"

# 處理管道內容
cat logs.txt | claude -p "分析這些錯誤"

CLI 命令

命令	說明	範例
`claude`	啟動互動式 REPL	`claude`
`claude "query"`	以初始提示啟動 REPL	`claude "解釋這個專案"`
`claude -p "query"`	執行一次性查詢後退出	`claude -p "解釋這個函數"`
`cat file \| claude -p "query"`	處理管道內容	`cat logs.txt \| claude -p "解釋"`
`claude -c`	繼續最近的對話	`claude -c`
`claude -c -p "query"`	以列印模式繼續	`claude -c -p "檢查型別錯誤"`
`claude -r "<session-id>" "query"`	透過 ID 恢復會話	`claude -r "abc123" "完成這個 PR"`
`claude config`	配置設定	`claude config set --global theme dark`
`claude update`	更新至最新版本	`claude update`
`claude mcp`	配置 Model Context Protocol 伺服器	查看教程中的 MCP 部分

CLI 標誌

使用這些命令列標誌來自訂 Claude Code 的行為：

標誌	說明	範例
`--print`, `-p`	不使用互動模式列印回應（請參閱下方詳細列印模式文件）	`claude -p "query"`
`--output-format`	指定列印模式的輸出格式（選項：`text`、`json`、`stream-json`）	`claude -p "query" --output-format json`
`--verbose`	啟用詳細日誌記錄，顯示完整的逐步輸出（在列印和互動模式下都有助於除錯）	`claude --verbose`
`--max-turns`	限制非互動模式下的代理回合數	`claude -p --max-turns 3 "query"`
`--permission-prompt-tool`	指定在非互動模式下處理權限提示的 MCP 工具	`claude -p --permission-prompt-tool mcp_auth_tool "query"`
`--resume`	透過 ID 恢復特定會話，或在互動模式下選擇	`claude --resume abc123 "query"`
`--continue`	載入當前目錄中最近的對話	`claude --continue`
`--dangerously-skip-permissions`	跳過權限提示（謹慎使用）	`claude --dangerously-skip-permissions`

--output-format json 標誌對腳本編寫和自動化特別有用，允許您以程式化方式解析 Claude 的回應。

列印模式詳情

-p（或 --print）標誌在 Claude Code 中啟用非互動模式，允許您為程式化使用管道輸入和輸出。此標誌支援各種輸出格式以適應不同的使用情境。

基本用法

# 基本列印模式 - 僅輸出最終回應文字
claude -p "解釋如何使用列印標誌"

# 使用標準輸入
echo "2+2等於多少？" | claude -p

# 在列印模式下以提示恢復會話
claude -p --resume <session-id> "用此提示恢復會話"

輸出格式

--output-format 選項（與 -p 一起使用）支援三種格式：

1. 文字輸出（預設）

claude -p "解釋輸出格式"
# 僅輸出回應文字

2. JSON 輸出

claude -p --output-format json "解釋如何使用 JSON 輸出"

輸出結構化 JSON 物件：

{
  "cost_usd": 0.003,
  "duration_ms": 1234,
  "duration_api_ms": 800,
  "result": "回應文字在此...",
  "session_id": "abc123"
}

3. 串流 JSON 輸出

claude -p --output-format stream-json "建立一個 Python 腳本"

在串流模式下，每個訊息在收到時都會以單獨的 JSON 物件輸出：

工具使用訊息
助手文字訊息
工具結果訊息
包含統計資料的最終系統訊息

列印模式的詳細輸出

當與 -p 一起使用 --verbose 時，必須搭配 --output-format json 或 --output-format stream-json：

claude -p --verbose --output-format json "除錯這段程式碼"

在詳細 JSON 模式下，輸出包含完整的對話記錄：

[
  {
    "role": "user",
    "content": "除錯這段程式碼"
  },
  {
    "role": "assistant",
    "content": "我來幫你除錯這段程式碼..."
  },
  {
    "role": "system",
    "cost_usd": 0.003,
    "duration_ms": 1234,
    "duration_api_ms": 800,
    "result": "回應文字在此...",
    "session_id": "abc123"
  }
]

列印模式的其他選項

最大回合數

claude -p --max-turns 3 "修復這段程式碼" < file.py

限制非互動模式下的代理回合數。

權限提示工具

claude -p --permission-prompt-tool mcp_auth_tool "建立檔案"

指定在非互動模式下處理權限提示的 MCP 工具。

恢復會話

claude -p --resume abc123 "用此提示恢復會話"

在列印模式下以新提示恢復特定會話。

繼續會話

claude -c -p "繼續執行下一個任務"

繼續此專案中的最後一次對話。

斜線命令

在互動會話期間控制 Claude 的行為：

命令	用途
`/bug`	回報錯誤（將對話傳送給 Anthropic）
`/clear`	清除對話歷史
`/compact [instructions]`	壓縮對話，可選擇性加入焦點指示
`/config`	查看/修改配置
`/cost`	顯示代幣使用統計
`/doctor`	檢查您的 Claude Code 安裝狀況
`/help`	獲取使用說明
`/init`	使用 CLAUDE.md 指南初始化專案
`/login`	切換 Anthropic 帳號
`/logout`	登出您的 Anthropic 帳號
`/memory`	編輯 CLAUDE.md 記憶檔案
`/pr_comments`	查看拉取請求評論
`/review`	請求程式碼審查
`/status`	查看帳號和系統狀態
`/terminal-setup`	安裝 Shift+Enter 換行鍵綁定（僅限 iTerm2 和 VSCode）
`/vim`	進入 vim 模式以切換插入和命令模式

特殊快捷鍵

使用 `#` 快速記憶

透過以 # 開始輸入來即時添加記憶：

# 始終使用描述性的變數名稱

系統會提示您選擇要將其儲存在哪個記憶檔案中。

終端機中的換行

使用以下方式輸入多行命令：

快速跳脫：輸入 \ 後按 Enter
鍵盤快捷鍵：Option+Enter（或已配置的 Shift+Enter）

要在終端機中設定 Option+Enter：

對於 Mac Terminal.app：

開啟設定 → 描述檔 → 鍵盤
勾選「使用 Option 作為 Meta 鍵」

對於 iTerm2 和 VSCode 終端機：

開啟設定 → 描述檔 → 按鍵
在一般設定下，將左/右 Option 鍵設為「Esc+」

iTerm2 和 VSCode 使用者提示：在 Claude Code 中執行 /terminal-setup 以自動配置 Shift+Enter 作為更直覺的替代方案。

查看設定中的終端機設定以了解配置詳情。

Vim 模式

Claude Code 支援一部分可以通過 /vim 啟用或通過 /config 配置的 Vim 按鍵綁定。

支援的功能包括：

模式切換：Esc（切換到 NORMAL），i/I，a/A，o/O（切換到 INSERT）
導航：h/j/k/l，w/e/b，0/$/^，gg/G
編輯：x，dw/de/db/dd/D，cw/ce/cb/cc/C，.（重複）

Claude 程式碼

​開始使用

​CLI 命令

​CLI 標誌

​列印模式詳情

​基本用法

​輸出格式