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

一、基本模型

Claude Code 基本操作：

• 輸入：Prompt + 文件（--file / stdin）
• 上下文：session（--resume / --continue）
• 執(zhí)行：?jiǎn)未?/ 交互 / 后臺(tái)
• 輸出：文本 / JSON / 流式 JSON / 文件

核心原則：

0. 輸入越準(zhǔn)確細(xì)致，輸出越穩(wěn)定。但也不是越多越好，而是恰到好處。
1. 上下文越清晰，結(jié)果越一致。上下文無(wú)雜質(zhì)干擾，一件事一件事處理。
2. 任務(wù)越可驗(yàn)證，風(fēng)險(xiǎn)越低。任務(wù)能通過(guò)Claude自身驗(yàn)證最好。

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

在交互模式中輸入 / 開(kāi)頭的命令來(lái)控制會(huì)話行為。

會(huì)話控制

模式切換

模型選擇策略

會(huì)話管理

工具與配置

項(xiàng)目與環(huán)境

賬戶與安裝

高級(jí)功能

自定義斜杠命令

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

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

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

三、鍵盤快捷鍵

自定義快捷鍵

運(yùn)行 /keybindings 編輯 ~/.claude/keybindings.json，修改后即時(shí)生效無(wú)需重啟。

四、CLI 啟動(dòng)參數(shù)

核心參數(shù)

輸入與輸出

會(huì)話與上下文

模型與行為

工具與權(quán)限

Prompt 定制

集成與擴(kuò)展

子命令

五、權(quán)限模式

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

六、運(yùn)行模式

1. 交互模式（默認(rèn)）

claude

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

2. 單次模式（Print）

claude -p "一個(gè)問(wèn)題"

特點(diǎn)：無(wú)狀態(tài)、適合自動(dòng)化和管道。

3. 后臺(tái)任務(wù)

claude --background "運(yùn)行測(cè)試"
?
# 查看任務(wù)
/tasks
?
# 查看詳情
/tasks <task-id>

適用：測(cè)試、構(gòu)建、長(zhǎng)時(shí)間分析。

七、輸入與輸出

輸入方式

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

輸出方式

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

八、工作流模板

1. 多步驟執(zhí)行

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

2. 驗(yàn)證型工作流

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

3. Bug 修復(fù)流程

1. 描述問(wèn)題
2. 分析日志
3. 定位代碼
4. 修復(fù)問(wèn)題
5. 編寫測(cè)試
6. 回歸驗(yàn)證

4. 重構(gòu)流程

1. 識(shí)別問(wèn)題
2. 提出重構(gòu)方案
3. 重寫代碼
4. 保持行為一致
5. 驗(yàn)證測(cè)試

九、命令組合實(shí)踐

1. 代碼審查

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

2. Bug 定位

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

3. Git 集成

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

4. CI/CD 集成

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

5. 批處理

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

十、Compact 與上下文管理

長(zhǎng)會(huì)話中上下文會(huì)逐漸膨脹，影響性能和費(fèi)用。

使用策略

示例

/compact 保留錯(cuò)誤處理的修復(fù)方案和測(cè)試結(jié)果

Claude 會(huì)壓縮之前的對(duì)話，僅保留你指定的關(guān)鍵信息。

十一、Plan 模式實(shí)踐

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

啟用方式

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

適用場(chǎng)景

• 復(fù)雜重構(gòu)：先看方案再執(zhí)行
• 不熟悉的代碼庫(kù)：先探索再修改
• 高風(fēng)險(xiǎn)操作：數(shù)據(jù)庫(kù)遷移、API 變更
• 團(tuán)隊(duì)協(xié)作：方案可以分享討論

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

十三、參數(shù)總覽

十四、場(chǎng)景速查

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

推薦結(jié)構(gòu)

目標(biāo)：
約束：
輸入：
輸出：
驗(yàn)證：

示例：

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

十六、最佳實(shí)踐

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

十七、常見(jiàn)問(wèn)題

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

原因：Prompt 模糊 / 輸入過(guò)多

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

2. 上下文丟失

原因：未使用 session

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

3. 分析結(jié)果不準(zhǔn)確

原因：文件范圍過(guò)大

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

4. 上下文過(guò)長(zhǎng)導(dǎo)致效果下降

原因：長(zhǎng)會(huì)話積累過(guò)多歷史

解決：使用 /compact 壓縮，或 /clear 重新開(kāi)始

5. 費(fèi)用超出預(yù)期

原因：Opus 模型 + 長(zhǎng)會(huì)話

解決：簡(jiǎn)單任務(wù)用 /model haiku，CI 中用 --max-budget-usd

總結(jié)

Claude Code 的核心能力：

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

使用方式是從"提問(wèn)"到"構(gòu)建整體執(zhí)行流程"。

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

最新評(píng)論