Claude Code 命令清单
基于 Claude Code 官方最新稳定版,涵盖 CLI 全局参数、会话内斜杠命令、内置快捷键、隐藏别名、高阶技巧与最佳实践,全量无遗漏。
目录
- 终端全局启动参数
- 终端子命令
- 会话内斜杠命令
- 键盘快捷键
- 隐藏别名与等价指令
- 高阶使用技巧
- 配置与环境变量
- 常见问题速查
一、终端全局启动参数
执行 claude [参数] 时传入的全局选项,决定会话初始状态。
1.1 基础通用
| 参数 | 长参数 | 说明 | 示例 |
|---|
claude | — | 默认启动交互式会话,加载当前目录上下文 | claude |
<prompt> | — | 直接携带文本启动会话,执行后进入交互 | claude "分析当前目录结构" |
-p | --prompt <text> | 单次执行模式,问答完成直接退出(非交互) | claude -p "生成 README" |
-h | --help | 展示全部 CLI 帮助文档 | claude --help |
-v | --version | 查看当前 Claude Code 版本号 | claude -v |
1.2 会话恢复与管理
| 参数 | 长参数 | 说明 | 示例 |
|---|
-c | --continue | 恢复最近一次历史会话 | claude -c |
-r | --resume <id|name> | 指定 ID 或名称恢复特定会话 | claude -r "项目重构" |
| — | --list-sessions | 列出所有本地会话列表 | claude --list-sessions |
| — | --new | 强制新建会话,不恢复历史 | claude --new |
1.3 模型与能力配置
| 参数 | 长参数 | 说明 | 可选值 | 示例 |
|---|
| — | --model <name> | 指定运行模型 | opus / sonnet / haiku | claude --model sonnet |
| — | --effort <level> | 设置推理强度 | low / medium / high / max | claude --effort high |
| — | --no-thinking | 关闭模型深度思考,提速降 token | — | claude --no-thinking |
| — | --max-tokens <num> | 限制单次输出最大 token 数 | 正整数 | claude --max-tokens 4096 |
| — | --temperature <num> | 控制输出随机性 | 0.0 ~ 1.0 | claude --temperature 0.2 |
1.4 目录与权限
| 参数 | 长参数 | 说明 | 示例 |
|---|
| — | --dir <path> | 指定工作目录(非当前目录启动) | claude --dir ~/projects/api |
| — | --add-dir <path> | 额外挂载多个工作目录 | claude --add-dir ~/shared-lib |
| — | --no-sandbox | 关闭沙箱限制,允许本地运行脚本/命令 | claude --no-sandbox |
| — | --sandbox | 强制开启沙箱(默认安全模式) | claude --sandbox |
| — | --allow-tools | 自动允许所有工具调用(免确认) | claude --allow-tools |
| — | --no-auto-commits | 禁用自动提交 Git 变更 | claude --no-auto-commits |
1.5 输出与日志
| 参数 | 长参数 | 说明 | 示例 |
|---|
| — | --json | JSON 结构化输出(适配脚本调用) | claude -p "分析" --json |
| — | --quiet | 静默模式,减少冗余日志 | claude --quiet |
| — | --verbose | 详细日志模式(排错用) | claude --verbose |
| — | --log-file <path> | 将运行日志写入指定文件 | claude --log-file ./claude.log |
| — | --no-color | 禁用终端彩色输出 | claude --no-color |
1.6 网络与代理
| 参数 | 长参数 | 说明 | 示例 |
|---|
| — | --proxy <url> | 指定网络代理地址 | claude --proxy http://127.0.0.1:7890 |
| — | --no-proxy | 禁用代理 | claude --no-proxy |
| — | --timeout <seconds> | 设置网络请求超时 | claude --timeout 60 |
二、终端子命令
claude <子命令> 形式,执行独立功能,不进入交互会话。
2.1 版本管理
| 子命令 | 说明 | 示例 |
|---|
claude update | 在线升级到最新版本 | claude update |
claude install [version] | 安装/重装指定版本,不带版本则装最新 | claude install / claude install 0.2.0 |
claude uninstall | 卸载 Claude Code | claude uninstall |
claude doctor | 一键诊断环境、依赖、权限、网络问题 | claude doctor |
2.2 账号管理
| 子命令 | 说明 | 示例 |
|---|
claude login | 登录账号/授权凭证 | claude login |
claude logout | 退出登录、清除本地凭证 | claude logout |
claude whoami | 查看当前登录账号信息 | claude whoami |
2.3 配置管理
| 子命令 | 说明 | 示例 |
|---|
claude config | 配置管理(交互式) | claude config |
claude config list | 列出所有全局配置项 | claude config list |
claude config set <key> <value> | 修改配置 | claude config set model sonnet |
claude config get <key> | 查看单项配置 | claude config get model |
claude config reset | 重置全局配置为默认 | claude config reset |
claude config path | 显示配置文件路径 | claude config path |
2.4 MCP 工具服务管理
| 子命令 | 说明 | 示例 |
|---|
claude mcp | MCP 工具服务管理(交互式) | claude mcp |
claude mcp list | 列出已安装 MCP 服务 | claude mcp list |
claude mcp add <name> | 添加 MCP 服务 | claude mcp add filesystem |
claude mcp remove <name> | 移除 MCP 服务 | claude mcp remove filesystem |
claude mcp start <name> | 启动 MCP 服务 | claude mcp start filesystem |
claude mcp stop <name> | 停止 MCP 服务 | claude mcp stop filesystem |
claude mcp status | 查看 MCP 服务状态 | claude mcp status |
2.5 IDE 集成管理
| 子命令 | 说明 | 示例 |
|---|
claude ide | IDE 集成管理(交互式) | claude ide |
claude ide install | 安装 VS Code 等 IDE 插件 | claude ide install |
claude ide uninstall | 卸载 IDE 集成 | claude ide uninstall |
claude ide status | 查看 IDE 集成状态 | claude ide status |
三、会话内斜杠命令
进入交互会话后,输入 / 调用。按 Tab 可自动补全。
3.1 会话生命周期
| 命令 | 说明 | 示例 |
|---|
/clear | 清空当前对话历史,新建会话 | /clear |
/reset | 同 /clear(别名) | /reset |
/new | 同 /clear(别名) | /new |
/exit | 退出交互式会话 | /exit |
/quit | 同 /exit(别名) | /quit |
3.2 历史回溯与会话分支
| 命令 | 说明 | 示例 |
|---|
/rewind | 回退到上一条对话节点,可多次执行 | /rewind |
/undo | 同 /rewind(别名) | /undo |
/checkpoint | 同 /rewind(别名) | /checkpoint |
/branch | 基于当前对话分叉出新会话 | /branch |
/resume [name|id] | 在当前会话内恢复其他历史会话 | /resume "重构方案" |
/continue [name|id] | 同 /resume(别名) | /continue |
3.3 会话编辑与导出
| 命令 | 说明 | 示例 |
|---|
/rename <name> | 给当前会话设置自定义名称 | /rename "API 重构方案" |
/copy | 将模型最后一条回复复制到系统剪贴板 | /copy |
/export [path] | 导出完整对话到本地文件;无路径则复制到剪贴板 | /export ./session.md |
/compact [note] | 压缩上下文历史,精简冗余内容降低 token 占用 | /compact "保留核心设计思路" |
3.4 项目与文件操作
| 命令 | 说明 | 示例 |
|---|
/init | 在当前目录自动生成 CLAUDE.md 项目规则文件 | /init |
/add-dir <path> | 临时追加目录到当前会话上下文 | /add-dir ../shared |
/diff | 查看本地文件未提交的代码变更、差异对比 | /diff |
/review [pr-url|path] | 评审本地 PR / 代码变更集 | /review / /review https://github.com/... |
/file <path> | 快速读取单个文件内容 | /file src/main.ts |
/find <pattern> | 在项目中搜索匹配内容 | /find "TODO:" |
/grep <pattern> | 同 /find,类 grep 搜索 | /grep "class.*Service" |
3.5 模型与参数动态调整
| 命令 | 说明 | 示例 |
|---|
/model <name> | 会话内动态切换模型 | /model opus |
/effort <level> | 会话内修改推理强度 | /effort high |
/thinking | 切换深度思考开关 | /thinking |
/no-thinking | 关闭深度思考 | /no-thinking |
/context | 查看当前上下文占用、token 统计、优化建议 | /context |
/cost | 查看本次会话累计 Token 用量、预估费用 | /cost |
/status | 全量状态:工作目录、当前模型、推理强度、沙箱、MCP、记忆配置 | /status |
3.6 目标与临时提问
| 命令 | 说明 | 示例 |
|---|
/goal <description> | 设置本次会话整体目标,模型会围绕目标执行 | /goal "重构用户认证模块" |
/reset-goal | 清空已设置的会话目标 | /reset-goal |
/btw <question> | 临时插话提问,不写入主对话历史 | /btw "这个函数是做什么的?" |
3.7 工具与沙箱管理
| 命令 | 说明 | 示例 |
|---|
/sandbox | 切换沙箱开关,查看/切换当前沙箱状态 | /sandbox |
/mcp | 会话内管理 MCP 工具、查看已加载工具列表 | /mcp |
/ide | 查看当前 IDE 集成、快捷调用 IDE 功能 | /ide |
/chrome | 配置/查看浏览器集成能力 | /chrome |
/tools | 查看当前可用的工具列表 | /tools |
3.8 批量与循环任务
| 命令 | 说明 | 示例 |
|---|
/loop <interval|times> <task> | 定时/次数循环执行指定任务 | /loop 5m "检查测试状态" |
/batch <files> <instruction> | 对多个文件批量执行相同指令 | /batch "src/**/*.ts" "添加 JSDoc" |
3.9 记忆与上下文
| 命令 | 说明 | 示例 |
|---|
/memory | 查看/管理长期记忆 | /memory |
/memory add <text> | 添加长期记忆 | /memory add "项目使用 pnpm" |
/memory clear | 清空长期记忆 | /memory clear |
3.10 帮助指令
| 命令 | 说明 | 示例 |
|---|
/help | 会话内展示所有可用斜杠命令列表 | /help |
/help <command> | 查看指定命令的详细帮助 | /help /compact |
四、键盘快捷键
终端交互全局生效的快捷键。
| 快捷键 | 功能 |
|---|
Ctrl + C | 强制中断当前模型生成、脚本执行 |
Ctrl + R | 重新生成上一轮模型回复 |
Ctrl + L | 清空终端屏幕(仅界面,不清除会话历史) |
Ctrl + D | 退出交互式会话(同 /exit) |
Esc | 关闭命令补全弹窗、取消当前输入 |
Tab | 命令/路径自动补全 |
Shift + Tab | 切换补全选项(反向) |
↑ / ↓ | 切换历史输入指令/对话 |
← / → | 移动光标 |
Home / End | 光标移动到行首/行尾 |
Ctrl + A | 光标移动到行首 |
Ctrl + E | 光标移动到行尾 |
Ctrl + K | 删除光标到行尾的内容 |
Ctrl + U | 删除光标到行首的内容 |
Ctrl + W | 删除光标前的一个单词 |
Ctrl + Y | 粘贴最近一次删除的内容 |
Ctrl + S | 暂停终端输出 |
Ctrl + Q | 恢复终端输出 |
Ctrl + Z | 挂起当前进程(后台运行) |
Ctrl + \ | 强制终止进程 |
五、隐藏别名与等价指令
官方原生兼容的等价写法,提升输入效率。
5.1 斜杠命令别名
| 主命令 | 等价别名 |
|---|
/exit | /quit |
/clear | /reset, /new |
/rewind | /undo, /checkpoint |
/resume | /continue |
5.2 终端参数别名
| 长参数 | 短参数 |
|---|
--continue | -c |
--resume | -r |
--prompt | -p |
--help | -h |
--version | -v |
六、高阶使用技巧
6.1 批量操作模式
claude -p "分析 package.json 中的依赖安全性" --json
claude --dir ./project-a --add-dir ./project-b -p "对比两个项目的依赖差异"
cat README.md | claude -p "优化这段文档的表述"
6.2 会话管理最佳实践
claude --list-sessions
claude -r "API 重构方案"
claude -r "重要方案" -p "/export ./archives/方案-$(date +%Y%m%d).md"
6.3 模型选择策略
| 场景 | 推荐模型 | 推理强度 |
|---|
| 快速问答、简单查询 | haiku | low |
| 日常编码、代码审查 | sonnet | medium |
| 复杂架构设计、深度重构 | opus | high |
| 关键核心模块、安全审计 | opus | max |
6.4 上下文优化技巧
/compact "保留核心业务逻辑,移除示例代码"
/context
/branch
6.5 安全与沙箱
claude --sandbox
claude --no-sandbox --allow-tools
/sandbox
七、配置与环境变量
7.1 全局配置文件
claude config path
claude config set model sonnet
claude config set effort medium
claude config set sandbox true
claude config set auto-commits false
7.2 环境变量
| 变量名 | 说明 | 示例 |
|---|
ANTHROPIC_API_KEY | API 密钥 | export ANTHROPIC_API_KEY=sk-... |
CLAUDE_MODEL | 默认模型 | export CLAUDE_MODEL=sonnet |
CLAUDE_EFFORT | 默认推理强度 | export CLAUDE_EFFORT=high |
HTTP_PROXY | HTTP 代理 | export HTTP_PROXY=http://127.0.0.1:7890 |
HTTPS_PROXY | HTTPS 代理 | export HTTPS_PROXY=http://127.0.0.1:7890 |
NO_PROXY | 不走代理的地址 | export NO_PROXY=localhost,127.0.0.1 |
八、常见问题速查
| 问题 | 解决方案 |
|---|
| 会话意外中断 | claude -c 恢复最近一次会话 |
| Token 超出限制 | /compact 压缩上下文,或 /branch 分叉新会话 |
| 模型回复太慢 | /model haiku 切换轻量模型,或 /no-thinking 关闭深度思考 |
| 沙箱阻止脚本执行 | /sandbox 关闭沙箱,或启动时加 --no-sandbox |
| 需要查看历史对话 | /export 导出完整对话 |
| 误操作回退 | /rewind 回退到上一步 |
| 多项目同时工作 | claude --add-dir 挂载额外目录 |
| 代理连接失败 | claude --proxy 或设置 HTTP_PROXY 环境变量 |
| 自动提交太频繁 | claude config set auto-commits false |
| MCP 工具不响应 | /mcp 检查服务状态,claude mcp restart <name> |
附录:命令速查卡
┌─────────────────────────────────────────────────────────────┐
│ Claude Code 速查卡 │
├─────────────────────────────────────────────────────────────┤
│ 启动 │
│ claude 交互会话 │
│ claude -p "..." 单次执行 │
│ claude -c 恢复会话 │
│ claude --model X 指定模型 │
│ │
│ 会话内 │
│ /clear 清空历史 │
│ /exit 退出会话 │
│ /rewind 回退一步 │
│ /branch 分叉会话 │
│ /compact 压缩上下文 │
│ /export 导出对话 │
│ /context 查看 token │
│ /cost 查看费用 │
│ /status 全量状态 │
│ │
│ 快捷操作 │
│ Ctrl+C 中断生成 │
│ Ctrl+R 重新生成 │
│ Ctrl+L 清屏 │
│ Tab 自动补全 │
└─────────────────────────────────────────────────────────────┘
所有评论(0)