面向開發(fā)者的 Claude Code CLI操作手冊 ，覆蓋命令、參數(shù)、快捷鍵、工作流和工程實踐。

一、基本模型

Claude Code 基本操作：

• 輸入：Prompt + 文件（--file / stdin）
• 上下文：session（--resume / --continue）
• 執(zhí)行：單次 / 交互 / 后臺
• 輸出：文本 / JSON / 流式 JSON / 文件

核心原則：

0. 輸入越準確細致，輸出越穩(wěn)定。但也不是越多越好，而是恰到好處。
1. 上下文越清晰，結果越一致。上下文無雜質干擾，一件事一件事處理。
2. 任務越可驗證，風險越低。任務能通過Claude自身驗證最好。

二、交互式斜杠命令（Slash Commands）

在交互模式中輸入 / 開頭的命令來控制會話行為。

會話控制

模式切換

模型選擇策略

會話管理

工具與配置

項目與環(huán)境

賬戶與安裝

高級功能

自定義斜杠命令

在項目目錄 .claude/commands/ 或全局 ~/.claude/commands/ 下創(chuàng)建 .md 文件：

---
allowed-tools: Edit, Bash
model: sonnet
description: 審查當前分支的代碼變更
---
?
審查當前分支相對于 main 的所有變更：
1. 檢查代碼質量
2. 發(fā)現(xiàn)潛在 bug
3. 給出改進建議
?
$ARGUMENTS

文件名即命令名，使用 $ARGUMENTS 捕獲命令后的參數(shù)。

三、鍵盤快捷鍵

自定義快捷鍵

運行 /keybindings 編輯 ~/.claude/keybindings.json，修改后即時生效無需重啟。

四、CLI 啟動參數(shù)

核心參數(shù)

輸入與輸出

會話與上下文

模型與行為

工具與權限

Prompt 定制

集成與擴展

子命令

五、權限模式

使用 --permission-mode 或 Shift+Tab 在會話中切換：

六、運行模式

1. 交互模式（默認）

claude

特點：持續(xù)上下文、適合探索和迭代。

2. 單次模式（Print）

claude -p "一個問題"

特點：無狀態(tài)、適合自動化和管道。

3. 后臺任務

claude --background "運行測試"
?
# 查看任務
/tasks
?
# 查看詳情
/tasks <task-id>

適用：測試、構建、長時間分析。

七、輸入與輸出

輸入方式

# 文件輸入
claude < prompt.txt
?
# 管道輸入
cat diff.txt | claude -p "分析改動"
?
# 組合輸入
git diff | claude -p "代碼審查"
?
# 多文件分析
claude --file api.ts --file db.ts "分析依賴關系"
?
# 精確行范圍
claude --file src/api.ts:40-80 "是否存在邏輯錯誤"

輸出方式

# JSON 輸出
claude -p --output-format json "生成接口定義"
?
# 流式 JSON
claude -p --output-format stream-json "生成代碼"
?
# 結構化輸出
claude -p --json-schema '{"type":"object","properties":{"name":{"type":"string"}}}' "提取信息"
?
# 重定向
claude -p "生成代碼" > main.ts

八、工作流模板

1. 多步驟執(zhí)行

claude "
1. 設計數(shù)據庫
2. 實現(xiàn) API
3. 編寫測試
4. 生成文檔
"

2. 驗證型工作流

claude "
步驟1：實現(xiàn)功能
驗證：是否可運行
?
步驟2：編寫測試
驗證：是否通過
?
步驟3：覆蓋率檢查
驗證：是否 >80%
"

3. Bug 修復流程

1. 描述問題
2. 分析日志
3. 定位代碼
4. 修復問題
5. 編寫測試
6. 回歸驗證

4. 重構流程

1. 識別問題
2. 提出重構方案
3. 重寫代碼
4. 保持行為一致
5. 驗證測試

九、命令組合實踐

1. 代碼審查

# 交互式審查
claude --file main.go "
1. 性能問題
2. 并發(fā)問題
3. 安全問題
4. 可維護性
"
?
# Git diff 審查
git diff main..HEAD | claude -p "審查代碼變更，標注風險點"

2. Bug 定位

# 日志分析
claude --file logs.txt "找出錯誤原因"
?
# 代碼定位
claude --file api.ts:40-80 "這里是否有問題"

3. Git 集成

git diff | claude -p "審查代碼"
git log --oneline -20 | claude -p "分析變更趨勢"

4. CI/CD 集成

# 自動審查（費用受控）
git diff main..HEAD | claude -p \
 ?--max-budget-usd 0.50 \
 ?--output-format json \
 ?"代碼審查，輸出 JSON 格式的問題列表"
?
# 降級策略
claude -p --model sonnet --fallback-model haiku "生成接口"

5. 批處理

for file in src/*.ts; do
  claude -p --file "$file" "檢查問題"
done

十、Compact 與上下文管理

長會話中上下文會逐漸膨脹，影響性能和費用。

使用策略

示例

/compact 保留錯誤處理的修復方案和測試結果

Claude 會壓縮之前的對話，僅保留你指定的關鍵信息。

十一、Plan 模式實踐

Plan 模式讓 Claude 在執(zhí)行前先給出方案。

啟用方式

# 啟動時指定
claude --permission-mode plan
?
# 會話中切換
/plan
?
# 快捷鍵
Shift+Tab ?# 循環(huán)切換模式

適用場景

• 復雜重構：先看方案再執(zhí)行
• 不熟悉的代碼庫：先探索再修改
• 高風險操作：數(shù)據庫遷移、API 變更
• 團隊協(xié)作：方案可以分享討論

十二、環(huán)境變量

十三、參數(shù)總覽

十四、場景速查

十五、Prompt 編寫規(guī)范

推薦結構

目標：
約束：
輸入：
輸出：
驗證：

示例：

目標：實現(xiàn)緩存
約束：Go + 并發(fā)安全
輸出：完整代碼
驗證：包含測試

十六、最佳實踐

0. Prompt 結構化 — 明確目標、約束、驗證條件
1. 文件輸入精確化 — 用行號范圍而非整個文件
2. 善用會話管理 — --continue 和 --resume 保持上下文
3. 及時壓縮上下文 — /compact 防止上下文膨脹
4. 按需選擇模型 — Haiku 做簡單任務，Opus 做復雜推理
5. Plan 模式審查 — 復雜變更先看方案再執(zhí)行
6. 費用控制 — --max-budget-usd 限制自動化場景的費用
7. 輸出 JSON 用于自動化 — --output-format json 便于腳本處理
8. 強制驗證步驟 — Prompt 中包含驗證條件

十七、常見問題

1. 輸出質量不穩(wěn)定

原因：Prompt 模糊 / 輸入過多

解決：限制范圍、增加約束、使用 /effort high

2. 上下文丟失

原因：未使用 session

解決：使用 --continue 或 --resume

3. 分析結果不準確

原因：文件范圍過大

解決：使用行號精確定位 --file src/api.ts:40-80

4. 上下文過長導致效果下降

原因：長會話積累過多歷史

解決：使用 /compact 壓縮，或 /clear 重新開始

5. 費用超出預期

原因：Opus 模型 + 長會話

解決：簡單任務用 /model haiku，CI 中用 --max-budget-usd

總結

Claude Code 的核心能力：

• 準確的輸入，盡量做細致清晰
• 上下文管理（/compact / --resume / --continue）
• 模式切換（/plan / /fast / /model / /effort）
• 可驗證工作流
• 自動化集成（-p / --output-format json）

使用方式是從"提問"到"構建整體執(zhí)行流程"。

到此這篇關于Claude Code 命令速查與實踐手冊的文章就介紹到這了,更多相關Claude Code 命令速查內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章，希望大家以后多多支持腳本之家！

最新評論