Claude Code
CLI 使用方法和控制
了解如何從命令行使用 Claude Code,包括 CLI 命令、標誌和斜線命令。
入門
Claude Code 提供兩種主要的互動方式:
- 互動模式:運行
claude
啟動 REPL 會話 - 單次模式:使用
claude -p "查詢"
進行快速命令
CLI 命令
命令 | 描述 | 示例 |
---|---|---|
claude | 啟動互動式 REPL | claude |
claude "查詢" | 以初始提示啟動 REPL | claude "解釋這個項目" |
claude -p "查詢" | 運行一次性查詢,然後退出 | claude -p "解釋這個函數" |
cat file | claude -p "查詢" | 處理管道內容 | cat logs.txt | claude -p "解釋" |
claude -c | 繼續最近的對話 | claude -c |
claude -c -p "查詢" | 在打印模式下繼續 | claude -c -p "檢查類型錯誤" |
claude -r "<session-id>" "查詢" | 通過 ID 恢復會話 | claude -r "abc123" "完成這個 PR" |
claude update | 更新到最新版本 | claude update |
claude mcp | 配置模型上下文協議服務器 | 請參閱教程中的 MCP 部分 |
CLI 標誌
使用這些命令行標誌自定義 Claude Code 的行為:
標誌 | 描述 | 示例 |
---|---|---|
--add-dir | 添加額外的工作目錄供 Claude 訪問(驗證每個路徑是否存在為目錄) | claude --add-dir ../apps ../lib |
--allowedTools | 除了 settings.json 文件 之外,應該允許使用而無需提示用戶許可的工具列表 | "Bash(git log:*)" "Bash(git diff:*)" "Write" |
--disallowedTools | 除了 settings.json 文件 之外,應該禁止使用而無需提示用戶許可的工具列表 | "Bash(git log:*)" "Bash(git diff:*)" "Write" |
--print , -p | 不使用互動模式打印響應(有關程序化使用的詳細信息,請參閱 SDK 文檔) | claude -p "查詢" |
--output-format | 指定打印模式的輸出格式(選項:text 、json 、stream-json ) | claude -p "查詢" --output-format json |
--verbose | 啟用詳細日誌記錄,顯示完整的逐輪輸出(在打印和互動模式下對調試有幫助) | claude --verbose |
--max-turns | 限制非互動模式下的代理輪數 | claude -p --max-turns 3 "查詢" |
--model | 使用最新模型的別名(sonnet 或 opus )或模型的完整名稱設置當前會話的模型 | claude --model claude-sonnet-4-20250514 |
--permission-prompt-tool | 指定一個 MCP 工具來處理非互動模式下的權限提示 | claude -p --permission-prompt-tool mcp_auth_tool "查詢" |
--resume | 通過 ID 恢復特定會話,或在互動模式下選擇 | claude --resume abc123 "查詢" |
--continue | 加載當前目錄中最近的對話 | claude --continue |
--dangerously-skip-permissions | 跳過權限提示(謹慎使用) | claude --dangerously-skip-permissions |
--output-format json
標誌對腳本編寫和自動化特別有用,允許您以程序化方式解析 Claude 的響應。
有關打印模式(-p
)的詳細信息,包括輸出格式、流式傳輸、詳細日誌記錄和程序化使用,請參閱 SDK 文檔。
斜線命令
在互動會話期間控制 Claude 的行為:
命令 | 用途 |
---|---|
/bug | 報告錯誤(將對話發送給 Anthropic) |
/clear | 清除對話歷史 |
/compact [instructions] | 使用可選的焦點指令壓縮對話 |
/config | 查看/修改配置 |
/cost | 顯示令牌使用統計 |
/doctor | 檢查 Claude Code 安裝的健康狀況 |
/help | 獲取使用幫助 |
/init | 使用 CLAUDE.md 指南初始化項目 |
/login | 切換 Anthropic 帳戶 |
/logout | 從 Anthropic 帳戶登出 |
/memory | 編輯 CLAUDE.md 記憶文件 |
/model | 選擇或更改 AI 模型 |
/permissions | 查看或更新權限 |
/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 鍵綁定,可以通過 /vim
啟用或通過 /config
配置。
支持的部分包括:
- 模式切換:
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
,.
(重複)