Claude Code: CLI 参考手册
最后更新：2026-08-31
这是 Claude Code 的命令速查手册——日常使用的每个命令、参数和斜杠命令都在这里。
💡 提示：不需要一次记住所有命令。日常只需掌握
claude、claude "指令" 和几个常用斜杠命令，其余查手册即可。
📋 前置知识：第十八章 钩子系统
1. 你将学到
- CLI 启动参数完整列表
- 斜杠命令速查
- 控制与模式切换
- 配置选项
- 常用命令组合
2. CLI 启动参数
(1) 基本用法
BASH
# 交互模式
claude
# 带指令启动
claude "你的指令"
# 管道模式
echo "指令" | claude
# 打印模式（-p）
claude -p "快速查询"
(2) 完整参数列表
| 参数 | 说明 | 示例 |
|---|---|---|
-p, --print |
非交互模式，直接输出 | claude -p "查询" |
--model |
指定模型 | --model claude-opus-4-20250514 |
--resume |
恢复上次会话 | claude --resume |
--resume <id> |
恢复指定会话 | claude --resume abc123 |
--headless |
无界面模式 | claude --headless "任务" |
--output |
输出格式 | --output json |
--style |
输出样式 | --style concise |
--allowed-tools |
限定工具 | --allowed-tools Read,Write |
--allow-full-auto |
全自动模式 | --allow-full-auto |
--mcp-config |
MCP 配置文件 | --mcp-config ./mcp.json |
--no-hooks |
禁用钩子 | --no-hooks |
--sandbox |
沙箱模式 | --sandbox |
--version |
显示版本 | claude --version |
--help |
显示帮助 | claude --help |
▶ 示例 1: 参数组合
BASH
# 恢复会话 + 切换模型
claude --resume --model claude-opus-4-20250514
# 头部模式 + JSON 输出 + 限定工具
claude --headless --output json --allowed-tools Read,Write "审查代码"
# 简洁样式 + 指定 MCP
claude --style concise --mcp-config ./mcp.json "查询数据库"
3. 斜杠命令
(1) 会话控制
| 命令 | 说明 |
|---|---|
/help |
显示帮助信息 |
/clear |
清空对话历史 |
/compact |
压缩对话历史 |
/cost |
查看 Token 用量和费用 |
/exit |
退出 Claude Code |
/quit |
退出 Claude Code |
(2) 文件与项目
| 命令 | 说明 |
|---|---|
/init |
初始化项目，生成 CLAUDE.md |
/files |
查看已加载的文件 |
/diff |
查看当前会话的文件变更 |
/search <pattern> |
在项目中搜索模式 |
(3) 配置与工具
| 命令 | 说明 |
|---|---|
/model <name> |
切换模型 |
/style <name> |
切换输出样式 |
/mcp |
查看 MCP 服务器状态 |
/hooks |
查看钩子配置 |
/skills |
列出可用 Skills |
/skill <name> |
执行指定 Skill |
/plugins |
查看插件状态 |
/config |
查看当前配置 |
(4) Git 集成
| 命令 | 说明 |
|---|---|
/commit |
提交当前变更 |
/undo |
撤销上次操作 |
▶ 示例 2: 斜杠命令使用
TEXT
📖 仅展示
> /cost
Token usage: 45,230 / 200,000 (22.6%)
Session cost: $0.91
> /files
Loaded files:
- src/index.ts (2.1KB)
- src/routes/user.ts (4.5KB)
- src/services/user.service.ts (3.8KB)
> /model claude-opus-4-20250514
Model switched to claude-opus-4-20250514
> /style concise
Style switched to concise
> /diff
Modified files:
src/routes/user.ts | +12 -3
src/services/user.service.ts | +28 -0
4. 控制与模式
(1) 交互控制
| 操作 | 按键 | 说明 |
|---|---|---|
| 发送指令 | Enter | 发送当前输入 |
| 换行 | Shift+Enter | 多行输入 |
| 中断执行 | Ctrl+C | 停止当前操作 |
| 退出 | Ctrl+D | 退出 Claude Code |
| 历史指令 | ↑/↓ | 浏览历史指令 |
(2) 权限确认选项
| 选项 | 说明 |
|---|---|
y (yes) |
本次允许 |
n (no) |
拒绝 |
a (always) |
本次会话内自动允许 |
e (edit) |
编辑变更后再应用 |
(3) 模式切换
TEXT
📖 仅展示
# 会话内切换模型
> /model claude-opus-4-20250514
# 会话内切换样式
> /style verbose
# 从交互模式到只读
> /config set allowedTools Read
# 清空历史重新开始
> /clear
5. 配置文件位置
(1) 配置文件清单
| 文件 | 位置 | 作用 |
|---|---|---|
~/.claude/CLAUDE.md |
全局 | 个人偏好 |
~/.claude/settings.json |
全局 | 全局设置 |
~/.claude/hooks.json |
全局 | 全局钩子 |
~/.claude/mcp_settings.json |
全局 | MCP 配置 |
~/.claude/plugins.json |
全局 | 插件配置 |
项目/CLAUDE.md |
项目 | 项目约定 |
项目/.claude/hooks.json |
项目 | 项目钩子 |
项目/.claude/mcp_settings.json |
项目 | 项目 MCP |
项目/.claude/plugins.json |
项目 | 项目插件 |
项目/.claudeignore |
项目 | 排除文件 |
(2) 环境变量
| 变量 | 说明 | 示例 |
|---|---|---|
ANTHROPIC_API_KEY |
API 密钥 | sk-ant-api03-xxx |
ANTHROPIC_BASE_URL |
API 地址 | https://api.deepseek.com |
CLAUDE_MODEL |
默认模型 | claude-sonnet-4-20250514 |
CLAUDE_HOOK_DEBUG |
钩子调试 | 1 |
CLAUDE_STYLE |
默认样式 | concise |
6. 综合示例：常用命令速查
BASH
# 日常开发
claude # 交互模式
claude "修复登录 Bug" # 带指令启动
claude --resume # 恢复会话
# 自动化
claude -p "审查代码" --output json # 管道+JSON
claude --headless "跑测试修Bug" # CI模式
# 控制
claude --allowed-tools Read,Write # 限工具
claude --style concise # 简洁输出
claude --model claude-opus-4-20250514 # 切模型
# 会话内
/cost # 查费用
/clear # 清历史
/diff # 查变更
/commit # 提交代码
/skill code-review # 用Skill
❓ 常见问题
Q 如何查看 Claude Code 版本？
A
claude --version。Q
-p 和管道模式有什么区别？A
-p 是 print 模式的简写，直接输出结果不交互。管道模式通过 stdin 传入输入，也是非交互模式。Q 如何重置所有配置？
A 删除
~/.claude/ 目录，重启 Claude Code。会恢复默认配置。Q
/compact 和 /clear 选哪个？A 想保留上下文但减少 Token 用
/compact；想完全重新开始用 /clear。Q 斜杠命令可以缩写吗？
A 部分可以。
/h = /help，/c = /clear，/q = /quit。具体缩写见 /help。Q 如何列出所有历史会话？
A
claude --list-sessions。📖 小节
- 核心启动参数：
--model、--resume、--headless、--output - 常用斜杠命令：
/cost、/clear、/diff、/commit - Ctrl+C 中断，Ctrl+D 退出
- 配置文件分全局（
~/.claude/）和项目（.claude/） - 环境变量控制 API、模型、样式等
📝 作业
- 基础题（难度⭐）：使用
claude --help查看所有参数，尝试 3 个之前没用过的参数。 - 进阶题（难度⭐⭐）：在会话中使用 5 个不同的斜杠命令，记录每个的效果。
- 挑战题（难度⭐⭐⭐）：编写一个 Shell 脚本，用
claude -p --output json实现自动化代码审查流水线。
