入門

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

  • 互動模式:運行 claude 啟動 REPL 會話
  • 單次模式:使用 claude -p "查詢" 進行快速命令
# 啟動互動模式
claude

# 以初始查詢啟動
claude "解釋這個項目"

# 運行單個命令並退出
claude -p "這個函數做什麼?"

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

CLI 命令

命令描述示例
claude啟動互動式 REPLclaude
claude "查詢"以初始提示啟動 REPLclaude "解釋這個項目"
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指定打印模式的輸出格式(選項:textjsonstream-jsonclaude -p "查詢" --output-format json
--verbose啟用詳細日誌記錄,顯示完整的逐輪輸出(在打印和互動模式下對調試有幫助)claude --verbose
--max-turns限制非互動模式下的代理輪數claude -p --max-turns 3 "查詢"
--model使用最新模型的別名(sonnetopus)或模型的完整名稱設置當前會話的模型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:

  1. 打開 設置 → 配置文件 → 鍵盤
  2. 勾選”將 Option 用作 Meta 鍵”

對於 iTerm2 和 VSCode 終端:

  1. 打開 設置 → 配置文件 → 按鍵
  2. 在常規下,將左/右 Option 鍵設置為 “Esc+”

iTerm2 和 VSCode 用戶提示:在 Claude Code 中運行 /terminal-setup 自動配置 Shift+Enter 作為更直觀的替代方案。

有關配置詳情,請參閱設置中的終端設置

Vim 模式

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

支持的部分包括:

  • 模式切換:Esc(到 NORMAL),i/Ia/Ao/O(到 INSERT)
  • 導航:h/j/k/lw/e/b0/$/^gg/G
  • 編輯:xdw/de/db/dd/Dcw/ce/cb/cc/C.(重複)