一、三种命令形态
| 类型 |
触发方式 |
典型示例 |
| CLI 命令 |
终端启动时执行 |
claude -c, claude --print "query" |
| 斜杠命令 |
会话内 / 触发 |
/init, /compact, /model |
| 键盘快捷键 |
会话内直接生效 |
Ctrl+C, Ctrl+R, Shift+Tab |
输入 / 即可查看所有可用斜杠命令,支持边输入边筛选。
二、CLI 命令(终端启动)
基础启动命令
| 命令 |
功能 |
示例 |
claude |
启动交互式会话 |
claude |
claude "query" |
带初始提示进入会话 |
claude "explain this project" |
claude -p "query" |
一次性查询后退出 |
claude -p "explain this function" |
| `cat file |
claude -p "query"` |
处理管道内容 |
会话管理
| 命令 |
功能 |
示例 |
claude -c |
恢复最近会话 |
claude -c |
claude -c -p "query" |
恢复会话并通过 SDK 查询 |
claude -c -p "Check for type errors" |
claude -r "<session>" "query" |
按ID或名称恢复会话 |
claude -r "auth-refactor" "Finish this PR" |
账户与认证
| 命令 |
功能 |
示例 |
claude auth login |
登录 Anthropic 账户 |
claude auth login --email user@example.com --sso |
claude auth logout |
登出账户 |
claude auth logout |
claude auth status |
显示认证状态 |
claude auth status |
系统管理
| 命令 |
功能 |
示例 |
claude update |
更新到最新版本 |
claude update |
claude agents |
列出所有配置的子 Agent |
claude agents |
claude mcp |
配置 MCP 服务器 |
claude mcp |
claude remote-control |
启动远程控制会话 |
claude remote-control |
三、斜杠命令(会话内)
3.1 项目初始化与管理
3.2 会话管理
| 命令 |
功能 |
使用场景 |
/clear |
清除当前会话上下文 |
需要全新开始时 |
/compact [说明] |
整理对话内容,减少 token 使用 |
上下文接近上限(70-80%)时 |
/context |
显示上下文窗口用量 |
监控 token 使用情况 |
/diff |
查看最近更改 |
检查代码修改 |
/status |
查看会话状态 |
查看模型、token用量等信息 |
3.3 模型与配置
| 命令 |
功能 |
使用场景 |
/model |
切换当前使用模型 |
在 Haiku/Sonnet/Opus 之间切换 |
/permissions |
查看/修改权限设置 |
配置自动审批的操作 |
/config |
查看或修改配置 |
调整工具行为 |
3.4 资源与成本
| 命令 |
功能 |
示例输出 |
/cost |
显示当前会话 token 消耗和费用 |
Session cost: $2.47 |
/stats |
查看会话统计信息 |
输入/输出 token 详情 |
/usage |
用量统计 |
累计使用情况 |
费用参考:
- 典型会话:0.20--0.80(45分钟重构)
- 复杂任务:5--50
3.5 诊断与维护
| 命令 |
功能 |
使用场景 |
/doctor |
检查环境、认证和连通性 |
出现异常时首选诊断工具 |
/version |
显示 Claude Code 版本 |
确认版本信息 |
/login |
登录 Anthropic 账户 |
首次使用或 token 过期 |
/logout |
登出账户 |
切换账户 |
/upgrade |
升级到最新版本 |
保持工具更新 |
/doctor 检查项:
- Node.js 版本(≥18)
- API 连通性
- Token 有效性
- 配置文件一致性
3.6 代码质量与审查
| 命令 |
功能 |
使用场景 |
/simplify |
三并行 Agent 代码审查 |
替代已弃用的 /review,覆盖质量/安全/性能 |
/review |
请求代码审查 |
分析 diffs 找出 bug 和风格问题 |
3.7 工作模式控制
| 命令 |
功能 |
使用场景 |
/fast |
极速模式(API 优化) |
交互式快速迭代、实时调试 |
/plan |
计划模式(只读,仅展示方案) |
敏感操作前审批,避免误操作 |
/fork |
创建临时对话分支 |
测试高风险重构,效果不好即关闭 |
/rewind |
回退对话或代码(ESC×2) |
撤销错误更改,可分别回退对话/代码 |
/sandbox |
启动安全沙箱执行 |
隔离运行不可信代码 |
三种工作模式(Shift+Tab 切换):
- Default:每次工具执行需确认
- Auto-Accept:文件修改自动执行,shell 命令仍需确认
- Plan:只读,只展示方案等待审批
3.8 实用工具
| 命令 |
功能 |
使用场景 |
/btw |
不中断主任务提问,不污染上下文 |
执行长任务时临时查资料 |
/help |
获取命令帮助列表 |
查看所有可用命令 |
/vim |
进入 vim 编辑模式 |
习惯 vim 操作的用户 |
3.9 集成与共享
| 命令 |
功能 |
/mcp |
管理 MCP 服务器连接(GitHub、数据库等) |
/skills |
列出和管理技能工作流 |
/desktop |
将会话移交 Claude 桌面应用 |
/mobile |
将会话移交 Claude 移动应用 |
/share |
共享会话链接 |
3.10 Skills(技能)系统
| 命令 |
功能 |
使用场景 |
/commit |
智能提交 |
自动分析变更,生成规范的 commit message |
/update-config |
配置 Claude Code 行为 |
配置自动化行为(hooks)、权限、环境变量 |
/save-conversation |
保存对话 |
导出为 Markdown、JSON、HTML、纯文本 |
/claude-api |
调用 Claude API |
构建基于 Claude API 的应用 |
/loop |
定时循环执行 |
周期性任务,如每5分钟自动提交 |
/keybindings-help |
自定义快捷键 |
修改按键绑定 |
3.11 其他命令
| 命令 |
功能 |
/add-dir <path> |
添加额外工作目录供 Claude 访问 |
/bug |
上报错误给 Anthropic |
/pr_comments |
查看 Pull Request 评论 |
/terminal-setup |
一键配置 Shift+Enter 换行 |
/ls-sessions |
查看对话 session-id |
/export |
将会话保存为文档 |
/usage-report |
月度分析报告 |
四、键盘快捷键
| 操作 |
快捷键 |
| 中断当前操作 |
Ctrl+C |
| 退出 |
Ctrl+D 或 /exit |
| 清空上下文 |
/clear |
| 切换快速模式 |
/fast |
| 查看帮助 |
/help |
| 搜索命令历史 |
Ctrl+R |
| 切换工作模式 |
Shift+Tab |
五、CLI 标志参数
常用标志
| 标志 |
功能 |
示例 |
--print, -p |
打印响应后退出 |
claude -p "query" |
--continue, -c |
恢复最近会话 |
claude -c |
--resume, -r |
恢复指定会话 |
claude --resume auth-refactor |
--session-id |
使用指定会话 ID |
claude --session-id "550e8400-e29b-41d..." |
--remote |
创建 web 会话 |
claude --remote "Fix the login bug" |
目录与插件
| 标志 |
功能 |
示例 |
--add-dir |
添加额外工作目录 |
claude --add-dir ../apps ../lib |
--plugin-dir |
加载插件目录 |
claude --plugin-dir ./my-plugins |
系统提示
| 标志 |
功能 |
示例 |
--append-system-prompt |
追加到默认指令(安全) |
claude --append-system-prompt "Always use TypeScript strict mode" |
--system-prompt |
替换所有默认指令(危险) |
claude --system-prompt "You are a Python expert" |
高级选项
| 标志 |
功能 |
示例 |
--dangerously-skip-permissions |
跳过所有权限确认 |
claude --dangerously-skip-permissions |
--agents |
启动时定义子 Agent |
claude --agents ... |
--output-format json |
结构化输出 |
claude --print "query" --output-format json |
⚠️ 警告: --dangerously-skip-permissions 仅限可信容器环境(Docker、CI/CD)使用,绝不可在包含生产数据的本地机器上执行。
六、记忆系统
Claude Code 有持久化记忆,存储在 ~/.claude/projects/ 下:
| 类型 |
用途 |
user |
你的角色、偏好、技术背景 |
feedback |
你给过的指导(避免重复纠正) |
project |
项目背景、目标、决策 |
reference |
外部资源指针(Linear、Grafana 等) |
记忆命令示例:
你:记住我是后端工程师,不熟悉 React
你:忘掉关于部署流程的记录
七、权限与安全
操作分类:
- 本地可逆操作(读写文件、运行测试):Claude 会直接执行
- 高风险操作(force push、删除分支、外部发布):Claude 会先询问确认
权限配置:
通过 /update-config 可以预先授权特定命令,避免每次确认。
八、最佳实践
- 自动化需求用
/update-config --- 不要指望"记住每次帮我做X",要配 hooks
- 提交用
/commit --- 比手写 message 更规范,聚焦变更意图
- 代码写完跑
/simplify --- 防止过度工程化
- 长对话用
/save-conversation --- 重要决策存档备查
- 遇到问题先说背景 --- Claude 会结合项目记忆给出更准确的建议
- 上下文70-80%时主动执行
/compact --- 避免触及上限导致遗忘
九、常用工作流示例
场景 1:功能开发后提交
你:实现了用户登录功能,帮我提交
Claude:[读取改动、生成 message]
你:/commit
场景 2:配置自动化钩子
你:/update-config 每次工具调用前先检查 git status
场景 3:定期检查 CI
你:/loop 5m 查看最新的 GitHub Actions 状态
场景 4:构建 AI 应用
你:/claude-api 帮我写一个支持多轮对话的 CLI 聊天工具
场景 5:脚本中使用
# 提问,获取答案,退出
claude --print "Explain the difference between async/await and promises"
# 非常适合脚本使用
result=$(claude --print "Generate a random UUID")
echo $result
十、自定义命令
在 .claude/commands/ 目录下创建 markdown 文件即可定义自定义命令:
.claude/
└── commands/
├── deploy.md # 创建 /deploy 命令
└── review.md # 创建 /review 命令
文件内容作为提示词模板,支持 $ARGUMENTS 占位符接收动态输入。
附录:快速参考表
最常用命令
| 命令 |
说明 |
/help |
查看所有命令 |
/init |
初始化项目 |
/commit |
智能提交 |
/model |
切换模型 |
/cost |
查看费用 |
/clear |
清空上下文 |
/compact |
压缩上下文 |
/doctor |
诊断问题 |
紧急操作
| 情况 |
解决方案 |
| Claude 开始乱写代码 |
连按两次 ESC 或 /rewind |
| 上下文快满了 |
/compact |
| 想重新开始但保留记忆 |
/clear |
| 不确定做了什么修改 |
/diff |
| 出现奇怪错误 |
/doctor |
文档生成时间: 2026年4月22日
参考来源: Claude Code 官方文档、社区最佳实践