Claude Code 命令速查与实践手册Claude Code 命令速查与实践手册。面向开发者的 Claude Co

Claude Code 命令速查与实践手册

面向开发者的 Claude Code CLI操作手册，覆盖命令、参数、快捷键、工作流和工程实践。

一、基本模型

Claude Code 基本操作：

输入：Prompt + 文件（--file / stdin）
上下文：session（--resume / --continue）
执行：单次 / 交互 / 后台
输出：文本 / JSON / 流式 JSON / 文件

核心原则：

输入越准确细致，输出越稳定。但也不是越多越好，而是恰到好处。
上下文越清晰，结果越一致。上下文无杂质干扰，一件事一件事处理。
任务越可验证，风险越低。任务能通过Claude自身验证最好。

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

在交互模式中输入 / 开头的命令来控制会话行为。

会话控制

命令	功能	说明
`/help`	显示所有可用命令	包含内置命令、自定义命令和 MCP 命令
`/clear`	清除当前对话上下文	完全重置，适合切换任务
`/compact [指令]`	压缩对话历史	可指定保留重点，如 `/compact 保留错误处理模式`
`/undo`	撤销最近一次文件更改	仅回退上一步，多步回退用 git
`/exit`	退出会话	等同 Ctrl+D

模式切换

命令	功能	说明
`/plan`	切换计划模式	Claude 先给出方案等待确认后再执行
`/fast`	切换快速模式	同一模型的速度优化设置，约 2x 费用
`/model [名称]`	切换模型	`/model opus` `/model sonnet` `/model haiku`
`/effort [级别]`	设置推理深度	`low` / `medium` / `high` / `max`

模型选择策略

场景	推荐模型
简单探索、机械任务	`/model haiku`
日常编码	`/model sonnet`
复杂推理、架构设计、安全分析	`/model opus`

会话管理

命令	功能	说明
`/resume`	恢复历史会话	打开会话选择器
`/sessions`	列出所有会话	查看会话历史
`/tasks`	查看后台任务	`/tasks <id>` 查看详情
`/name [名称]`	命名当前会话	方便后续查找

工具与配置

命令	功能	说明
`/config`	查看/编辑配置	打开 settings.json
`/permissions`	管理权限设置	查看和修改工具权限
`/mcp`	管理 MCP 服务器	添加、删除、查看 MCP 服务器
`/cost`	查看费用统计	当前会话 token 和费用
`/keybindings`	编辑快捷键配置	修改 `~/.claude/keybindings.json`

项目与环境

命令	功能	说明
`/init`	初始化项目配置	创建 CLAUDE.md 等项目文件
`/add-dir <路径>`	添加工作目录	允许访问额外目录
`/ide`	连接 IDE	自动连接 VS Code / JetBrains
`/doctor`	健康检查	诊断 Claude Code 安装和配置问题
`/status`	查看状态	显示当前连接和配置状态

账户与安装

命令	功能	说明
`/login`	登录	认证 Anthropic 账户
`/logout`	登出	清除认证信息
`/install-github-app`	安装 GitHub App	启用 PR 工作流集成
`/bug`	报告问题	提交 bug 报告

高级功能

命令	功能	说明
`/listen`	监听模式	监听外部输入
`/vim`	Vim 模式	启用 Vim 风格的键绑定
`/review`	代码审查	审查当前变更
`/memory`	管理记忆	查看/编辑 Claude 的持久记忆
`/terminal-setup`	终端设置	配置终端集成
`!<命令>`	执行 Shell 命令	如 `!git status`，在当前会话中运行

自定义斜杠命令

在项目目录 .claude/commands/ 或全局 ~/.claude/commands/ 下创建 .md 文件：

---
allowed-tools: Edit, Bash
model: sonnet
description: 审查当前分支的代码变更
---

审查当前分支相对于 main 的所有变更：
1. 检查代码质量
2. 发现潜在 bug
3. 给出改进建议

$ARGUMENTS

文件名即命令名，使用 $ARGUMENTS 捕获命令后的参数。

三、键盘快捷键

快捷键	功能	说明
Shift+Tab	切换权限/计划模式	循环：default → acceptEdits → auto → plan
Ctrl+C	取消当前任务	停止执行但不退出会话
Ctrl+D	退出会话	等同 `/exit`
Ctrl+L	清屏	清除终端显示，保留上下文
Ctrl+R	搜索历史	搜索当前会话的命令历史
Ctrl+S	暂存 Prompt	暂存当前输入，提交其他内容后自动恢复
Escape	中断生成	第一次中断，输入 "go" 可继续
Escape×2	回溯模式	进入回溯模式，用方向键浏览历史

自定义快捷键

运行 /keybindings 编辑 ~/.claude/keybindings.json，修改后即时生效无需重启。

四、CLI 启动参数

核心参数

参数	缩写	功能	示例
`--print`	`-p`	单次输出模式	`claude -p "问题"`
`--continue`	`-c`	继续最近会话	`claude -c`
`--resume [id]`	`-r`	恢复指定会话	`claude -r abc123`
`--model <模型>`		指定模型	`claude --model opus`
`--help`	`-h`	显示帮助	`claude -h`
`--version`	`-v`	显示版本	`claude -v`

输入与输出

参数	功能	示例
`--file <路径>`	输入文件	`claude --file src/api.ts "分析"`
`--output-format <格式>`	输出格式	`text` / `json` / `stream-json`
`--input-format <格式>`	输入格式	`text` / `stream-json`
`--json-schema <schema>`	结构化输出验证	指定 JSON Schema

会话与上下文

参数	功能	示例
`--add-dir <目录>`	添加工作目录	`claude --add-dir ../lib`
`--name <名称>`	`-n` 命名会话	`claude -n "feature-auth"`
`--fork-session`	分叉会话	恢复时创建新会话 ID
`--from-pr [值]`	从 PR 恢复	`claude --from-pr 123`
`--session-id <uuid>`	指定会话 ID	使用特定 UUID
`--no-session-persistence`	禁用会话持久化	仅与 `--print` 搭配
`--worktree [名称]`	`-w` 创建 git worktree	隔离工作环境
`--tmux`	创建 tmux 会话	需搭配 `--worktree`

模型与行为

参数	功能	示例
`--effort <级别>`	推理深度	`low` / `medium` / `high` / `max`
`--permission-mode <模式>`	权限模式	见权限模式说明
`--fallback-model <模型>`	降级模型	主模型过载时自动切换
`--max-budget-usd <金额>`	费用上限	仅与 `--print` 搭配
`--verbose`	详细日志	显示更多运行信息
`--debug [过滤]`	调试模式	`--debug "api,hooks"`
`--debug-file <路径>`	调试日志文件	写入指定路径

工具与权限

参数	功能	示例
`--allowedTools <工具>`	允许的工具	`"Bash(git:*) Edit"`
`--disallowedTools <工具>`	禁止的工具	`"Bash(rm:*)"`
`--tools <工具>`	指定可用工具集	`"Bash,Edit,Read"` 或 `""` 禁用所有
`--dangerously-skip-permissions`	跳过所有权限检查	仅用于沙箱环境
`--allow-dangerously-skip-permissions`	允许跳过权限选项	不默认跳过，仅开放选项

Prompt 定制

参数	功能	示例
`--system-prompt <提示>`	自定义系统提示	替换默认系统提示
`--append-system-prompt <提示>`	追加系统提示	在默认提示后附加

集成与扩展

参数	功能	示例
`--agent <代理>`	指定代理	覆盖 settings 中的 agent
`--agents <json>`	自定义代理	JSON 定义多个代理
`--mcp-config <配置>`	MCP 服务器配置	加载 MCP JSON 配置
`--strict-mcp-config`	严格 MCP 模式	仅使用指定的 MCP
`--plugin-dir <路径>`	加载插件目录	指定插件路径
`--settings <文件>`	加载设置文件	额外的 settings.json
`--ide`	连接 IDE	自动连接可用的 IDE
`--chrome`	Chrome 集成	启用浏览器集成
`--bare`	最小模式	跳过 hooks、LSP、插件等
`--disable-slash-commands`	禁用斜杠命令	禁用所有 skills

子命令

子命令	功能
`claude doctor`	健康检查，诊断安装问题
`claude auth`	管理认证
`claude mcp`	管理 MCP 服务器
`claude install [target]`	安装指定版本（stable / latest / 版本号）
`claude update`	检查并安装更新
`claude agents`	列出已配置的代理
`claude auto-mode`	查看 auto 模式分类器配置
`claude setup-token`	设置长期认证 token
`claude plugin`	管理插件

五、权限模式

使用 --permission-mode 或 Shift+Tab 在会话中切换：

模式	行为	适用场景
`default`	每次操作需确认	谨慎操作，初次使用
`acceptEdits`	自动接受文件编辑	信任代码修改
`plan`	先计划再执行，修改需确认	复杂任务先审查方案
`auto`	自动执行所有操作	快速迭代，信任环境
`dontAsk`	不询问直接执行	自动化流水线
`bypassPermissions`	跳过所有权限检查	沙箱/测试环境

六、运行模式

1. 交互模式（默认）

claude

特点：持续上下文、适合探索和迭代。

2. 单次模式（Print）

claude -p "一个问题"

特点：无状态、适合自动化和管道。

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. 多步骤执行

claude "
1. 设计数据库
2. 实现 API
3. 编写测试
4. 生成文档
"

2. 验证型工作流

claude "
步骤1：实现功能
验证：是否可运行

步骤2：编写测试
验证：是否通过

步骤3：覆盖率检查
验证：是否 >80%
"

3. Bug 修复流程

1. 描述问题
2. 分析日志
3. 定位代码
4. 修复问题
5. 编写测试
6. 回归验证

4. 重构流程

1. 识别问题
2. 提出重构方案
3. 重写代码
4. 保持行为一致
5. 验证测试

九、命令组合实践

1. 代码审查

# 交互式审查
claude --file main.go "
1. 性能问题
2. 并发问题
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 与上下文管理

长会话中上下文会逐渐膨胀，影响性能和费用。

使用策略

场景	操作
上下文使用 >80%	`/compact` 压缩历史
切换完全不同的任务	`/clear` 清空重来
需要保留特定信息	`/compact 保留 API 设计决策`
会话过长效果下降	`/compact` 后继续

示例

/compact 保留错误处理的修复方案和测试结果

Claude 会压缩之前的对话，仅保留你指定的关键信息。

十一、Plan 模式实践

Plan 模式让 Claude 在执行前先给出方案。

启用方式

# 启动时指定
claude --permission-mode plan

# 会话中切换
/plan

# 快捷键
Shift+Tab  # 循环切换模式

适用场景

复杂重构：先看方案再执行
不熟悉的代码库：先探索再修改
高风险操作：数据库迁移、API 变更
团队协作：方案可以分享讨论

十二、环境变量

变量	功能
`ANTHROPIC_API_KEY`	API 密钥
`CLAUDE_CODE_SIMPLE`	简单模式（`--bare` 自动设置）
`CLAUDE_FORMAT`	默认输出格式

十三、参数总览

参数	缩写	功能
`--print`	`-p`	单次输出
`--continue`	`-c`	继续最近会话
`--resume`	`-r`	恢复指定会话
`--model`		指定模型
`--file`		输入文件
`--effort`		推理深度
`--output-format`		输出格式
`--permission-mode`		权限模式
`--allowedTools`		允许的工具
`--max-budget-usd`		费用上限
`--worktree`	`-w`	创建 worktree
`--verbose`		详细日志
`--debug`	`-d`	调试模式
`--help`	`-h`	帮助
`--version`	`-v`	版本

十四、场景速查

场景	命令
快速问答	`claude "问题"`
单次输出（管道）	`claude -p "问题"`
分析代码	`claude --file src/api.ts "分析"`
精确分析	`claude --file src/api.ts:40-80 "检查"`
继续上次	`claude -c`
恢复会话	`claude -r`
切换模型	`/model opus`
压缩上下文	`/compact`
计划模式	`/plan` 或 Shift+Tab
快速模式	`/fast`
低推理	`/effort low`
后台任务	`claude --background "任务"`
费用控制	`--max-budget-usd 1.00`
自动化	`-p --output-format json`
沙箱执行	`--dangerously-skip-permissions`
健康检查	`claude doctor`
命名会话	`claude -n "my-feature"`
隔离开发	`claude -w feature-x`

十五、Prompt 编写规范

十六、最佳实践

Prompt 结构化 — 明确目标、约束、验证条件
文件输入精确化 — 用行号范围而非整个文件
善用会话管理 — --continue 和 --resume 保持上下文
及时压缩上下文 — /compact 防止上下文膨胀
按需选择模型 — Haiku 做简单任务，Opus 做复杂推理
Plan 模式审查 — 复杂变更先看方案再执行
费用控制 — --max-budget-usd 限制自动化场景的费用
输出 JSON 用于自动化 — --output-format json 便于脚本处理
强制验证步骤 — Prompt 中包含验证条件

十七、常见问题

1. 输出质量不稳定

原因：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）

使用方式是从"提问"到"构建整体执行流程"。

参考来源

AI 编程核心知识库：microwind.github.io

Claude Code 命令速查与实践手册