Claude Code 完整命令手册
版本:Claude Code CLI
日期:2026/05/12
一、核心 Slash 命令
1. 会话与上下文管理
| 命令 | 说明 |
|---|---|
/resume |
恢复之前的会话状态,跨会话继续工作 |
/clear |
清除当前对话历史(不会删除记忆) |
/compact |
手动压缩对话上下文,减少 token 消耗 |
/cost |
查看当前会话的 token 消耗和预估成本 |
/history |
查看完整对话历史记录 |
/exit / quit |
退出 Claude Code CLI |
2. 配置与状态
| 命令 | 说明 |
|---|---|
/config |
交互式配置(模型、主题、权限模式等) |
/settings |
打开 settings.json 进行高级配置编辑 |
/status |
查看当前会话状态:模型、上下文长度、模式等 |
/version |
查看当前 Claude Code 版本号 |
/login |
登录 Anthropic 账号 |
/logout |
登出当前账号 |
3. 模型与性能
| 命令 | 说明 |
|---|---|
/model |
切换使用的模型(Opus / Sonnet / Haiku) |
/fast |
切换快速模式(使用 Claude Opus 4.6,输出更快) |
4. 任务与执行控制
| 命令 | 说明 |
|---|---|
/loop <间隔> <命令> |
循环执行某个命令,如 /loop 5m /test |
/tasks |
查看和管理所有后台任务 |
/undo |
撤销上一次的文件修改操作 |
/debug |
进入调试模式,显示更多内部执行信息 |
5. 代码库导航
| 命令 | 说明 |
|---|---|
/ls [路径] |
列出指定目录内容 |
/git <参数> |
执行 git 命令,如 /git status、/git log |
/search <查询> |
在代码库中全局搜索 |
/open <文件> |
将指定文件显式加入上下文 |
6. 开发工作流
| 命令 | 说明 |
|---|---|
/test [匹配模式] |
运行测试套件 |
/lint [文件] |
运行代码检查/格式化工具 |
/build |
执行构建命令 |
/doc [主题] |
查看相关文档或帮助 |
7. 项目管理
| 命令 | 说明 |
|---|---|
/init |
初始化 CLAUDE.md 代码库文档 |
/plan |
进入计划模式:设计实现方案,需用户确认后才能执行 |
/worktree |
创建/管理 git worktree(隔离的开发环境) |
8. MCP 与技能
| 命令 | 说明 |
|---|---|
/mcp |
管理 MCP(Model Context Protocol)服务器连接 |
/skills |
列出所有可用的技能(Skills) |
9. 协作与代码审查
| 命令 | 说明 |
|---|---|
/review [PR链接] |
审查 Pull Request |
/security-review |
对当前分支的变更进行安全审查 |
/pr <参数> |
PR 相关操作(创建、查看、合并等) |
10. 子代理
| 命令 | 说明 |
|---|---|
/agent <提示词> |
创建子代理执行独立任务,可并行运行 |
二、特殊前缀与快捷语法
Shell 执行前缀
| 语法 | 说明 | 示例 |
|---|---|---|
! <命令> |
在底层 shell 直接执行命令 | ! npm test |
! <命令> |
支持交互式登录等操作 | ! gcloud auth login |
搜索查询前缀
| 语法 | 说明 | 示例 |
|---|---|---|
? <问题> |
将内容视为搜索查询,避免误触发工具调用 | ? 什么是 MCP |
上下文引用
| 语法 | 说明 | 示例 |
|---|---|---|
@<文件路径> |
在消息中引用特定文件 | @src/main.py 这个函数做什么 |
@<目录路径> |
引用整个目录 | @src/components |
三、内置技能(Skills)
技能是 Claude Code 的扩展能力,可通过 /skill-name 调用。
| 技能名 | 触发命令 | 用途 |
|---|---|---|
init |
/init |
初始化 CLAUDE.md 代码库文档 |
review |
/review |
审查 Pull Request |
security-review |
/security-review |
安全审查当前分支变更 |
simplify |
/simplify |
审查修改后的代码,优化复用性和效率 |
update-config |
/update-config |
更新 settings.json(hooks、权限、环境变量) |
keybindings-help |
/keybindings-help |
自定义键盘快捷键配置 |
fewer-permission-prompts |
/fewer-permission-prompts |
扫描常用命令并添加到允许列表,减少权限提示 |
claude-api |
/claude-api |
构建/调试 Claude API 应用(含 prompt caching) |
四、常用连招组合
连招 1:接手遗留代码(探索流)
适合刚进入一个新项目或长时间未接触的代码库。
/resume # 恢复到之前的工作会话
/ls src/ # 快速浏览顶层目录结构
/search "auth middleware" # 搜索关键业务逻辑
/open src/auth/middleware.ts # 将关键文件加入上下文
/open src/auth/types.ts # 补充关联类型文件
效果:快速重建对代码库的心智模型,恢复工作状态。
连招 2:提交前检查流水线(质量控制流)
适合在 git commit 前确保代码质量。
/git diff --cached # 查看已暂存的变更
/lint # 自动检查并修复代码风格
/test # 运行全部测试
/review # 让 Claude 做人工级代码审查
效果:在提交前捕获风格问题、测试失败和设计缺陷。
连招 3:大规模重构(计划 + 验证流)
适合需要修改多文件、可能影响面广的重构任务。
/plan # 1. 进入计划模式,设计重构方案
# (Claude 会输出计划,等待你确认后才执行)
# 实施完成后:
/loop 2m /test # 每 2 分钟自动跑一次测试
/cost # 检查已消耗的 token 成本
/tasks # 如果有后台任务,查看进度
效果:确保重构有方案、有验证、有成本控制。
连招 4:长任务托管(压缩 + 监控 + 恢复流)
适合需要长时间运行或跨工作时段的任务。
# 工作过程中上下文增长时:
/compact # 压缩历史对话,保留关键决策
# 设置状态监控:
/loop 10m /status # 每10分钟检查一次会话状态
# 第二天继续工作:
/resume # 从断点精确恢复
/cost # 查看累计消耗
效果:防止上下文溢出,支持跨天工作连续性。
连招 5:安全敏感开发(审查流)
适合处理认证、支付、数据隐私等敏感代码。
/debug # 开启调试模式,看清每一步操作
/security-review # 先过自动安全审查
/git diff # 人工确认所有变更点
# 确认无误后再执行提交
效果:多层检查防止引入安全漏洞。
连招 6:多任务并行处理(代理流)
适合需要同时处理多个独立分析任务的场景。
/agent "找出所有未处理的 Promise 并列出风险等级"
/agent "检查测试覆盖率低于 50% 的模块"
/agent "扫描所有硬编码的 API 密钥或密码"
/tasks # 查看三个代理的执行进度
效果:并行利用算力,加速大型代码库审计。
连招 7:Bug 快速定位(诊断流)
适合生产环境出现问题后的紧急排查。
/search "Error: Connection timeout" # 搜索错误关键词
/open src/db/connection.ts # 打开疑似问题文件
! npm run test:connection # 在 shell 中跑针对性测试
/debug # 如果需要,开启调试看详细逻辑
效果:从错误信息快速收敛到根因文件。
连招 8:新功能完整开发(端到端流)
从需求到 PR 的完整工作流。
/plan # 1. 定技术方案
/open src/types.ts # 2. 先更新核心类型定义
# ... 开发过程中 ...
/test # 3. 运行测试验证
/lint # 4. 格式化代码
/git diff # 5. 审查最终变更
/pr create # 6. 创建 Pull Request
效果:结构化的开发流程,减少遗漏环节。
连招 9:MCP 集成调试(扩展流)
适合配置和使用 MCP 服务器。
/mcp # 查看当前 MCP 服务器状态
/mcp add <server-name> # 添加新的 MCP 服务器
/skills # 确认新能力是否已加载
/test # 验证集成是否破坏现有功能
效果:安全地扩展 Claude Code 的能力边界。
连招 10:上下文精确控制(精准流)
适合超大项目,需要精确控制 Claude 看到的内容。
@src/core/auth.ts 请分析这个文件的依赖关系
/ls src/core/ # 补充查看同级文件
/open src/core/auth.ts # 显式将文件加入长期上下文
/search "import.*auth" # 查找所有引用点
效果:避免无关文件干扰,提高大项目下的回答质量。
五、快捷键参考
| 快捷键 | 作用 |
|---|---|
Ctrl + C |
中断当前正在执行的命令/任务 |
Ctrl + D |
退出 Claude Code |
Tab |
自动补全命令和文件路径 |
↑ / ↓ |
浏览历史输入 |
六、配置优先级
Claude Code 的配置从低到高分为三层:
- 全局设置 :
~/.claude/settings.json - 项目设置 :
<project>/.claude/settings.json - 会话设置 :通过
/config实时修改
使用 /update-config 或 /settings 可编辑这些文件。
七、记忆系统
Claude Code 支持文件化记忆,存储在项目目录的 .claude/memory/ 中。
| 命令 | 作用 |
|---|---|
/remember <内容> |
保存信息到长期记忆 |
/forget <关键词> |
删除相关记忆 |
记忆类型包括:
user--- 用户角色和偏好feedback--- 用户对回答的纠正和确认project--- 项目背景和决策reference--- 外部系统指针
八、最佳实践提示
- 上下文管理 :大项目下多用
@文件和/open精确控制上下文,避免一次性塞入过多文件。 - 计划模式 :涉及 3 个以上文件的修改时,先用
/plan定方案,防止偏离预期。 - 成本控制 :长会话中定期使用
/cost和/compact,避免 token 过度消耗。 - 安全审查 :任何涉及权限、支付、数据的代码变更前,执行
/security-review。 - 任务并行 :独立的研究/分析任务用
/agent并行执行,再通过/tasks汇总结果。
本文档基于 Claude Code 当前版本整理,如有新命令或变更,以 /help 和 /skills 输出为准。