1. Claude Code 命令系统概述
Claude Code 的命令系统是其核心交互方式,通过斜杠(/)前缀触发各种功能。这套设计借鉴了现代聊天应用的快捷操作方式,但针对开发者工作流进行了深度优化。命令不仅仅是简单的功能触发器 - 每个命令都与Claude的AI能力深度整合,能够根据上下文智能调整行为。
命令输入有以下几个特点:
- 必须以斜杠开头,且必须位于消息开头
- 命令后的文本作为参数传递
- 从v2.1.199开始支持技能链式调用(最多6个技能)
- 输入/可查看所有可用命令,输入/加字母可过滤命令
典型工作流中,命令会随着项目阶段变化而发挥不同作用。例如项目初始化阶段常用/init创建CLAUDE.md,/memory完善项目记忆;开发过程中用/model切换模型,/compact优化上下文;代码审查时用/code-review进行多层级检查。
2. 核心命令分类解析
2.1 会话管理命令
会话管理是日常使用最频繁的命令类别:
/clear - 清空当前会话上下文,但保留项目记忆。相比直接开新会话的优势是保留了CLAUDE.md等长期记忆文件。实测发现不带参数使用时,旧会话会以时间戳命名保存在/resume列表中。
/compact - 智能压缩当前会话历史。这是处理长会话的利器,它会分析对话结构,保留关键决策点,压缩重复讨论。可选参数可指定压缩重点,如/compact focus on API design decisions。
/context - 可视化上下文使用情况。彩色网格展示各类型内容占用比例,特别实用的是会标出可以优化的部分,比如过长的代码块或冗余讨论。
/resume - 恢复历史会话。支持按ID或名称恢复,从v2.1.144开始会标注后台会话(bg)。个人经验:给重要会话命名比依赖自动生成的名字更可靠。
2.2 模型控制命令
/model - 切换AI模型并设为默认。模型切换时会重新读取整个会话历史,对于长会话可能耗时较久。技巧:在JetBrains终端中使用时,可以先/compact再/model减少等待时间。
/effort - 设置推理强度级别。从low到ultracode多个等级,不同模型支持不同级别。关键细节:ultracode结合了高强度推理和自动工作流编排,适合复杂任务。
/advisor - 启用第二模型顾问。在关键决策点获取不同视角的建议。实测发现对架构决策特别有用,可以设置如/advisor opus让最强模型提供建议。
2.3 代码操作命令
/diff - 交互式差异查看器。不仅显示git diff,还能按对话轮次查看变更历史。从v2.1.198开始会自动刷新外部仓库变更。
/code-review - 多层级代码审查。支持从快速检查(low)到深度审查(ultra)。--fix参数可自动修复问题,--comment提交PR评论。经验:medium级别适合日常提交,ultra适合重要合并。
/batch - 大规模并行修改。将大型重构分解为独立单元并行执行。实测处理过200+文件的TypeScript迁移项目,自动创建了23个并行工作区。
3. 高级工作流命令
3.1 后台任务管理
/background - 将当前会话转为后台任务。特别适合长时间运行的任务如测试或数据处理。配合claude agents命令可管理多个后台任务。
/tasks - 查看所有后台任务。显示每个任务的进度、资源占用和预计完成时间。技巧:对CPU密集型任务可先用/model sonnet再/background节省资源。
/fork - 创建子任务分支。不同于/branch的是子任务完成后会自动合并结果回主会话。在实现复杂功能时特别有用,可以分工协作。
3.2 团队协作命令
/team-onboarding - 自动生成团队入门指南。分析30天内的使用模式创建定制化指引。实测生成的指南包含项目特定的技能调用模式和权限设置建议。
/teleport - 将网页会话拉取到本地终端。完美衔接在claude.ai上开始的讨论。注意需要订阅账号,且在防火墙后可能需要特殊配置。
/permissions - 管理工具权限规则。团队项目中必用命令,可以设置不同目录的不同访问级别。建议将敏感操作设为ask而非直接allow。
4. 诊断与排错命令集
4.1 系统健康检查
/doctor - 全面的系统诊断工具。检查安装问题、重复技能、配置冲突等。比直接查看日志高效得多,能自动修复80%的常见问题。
/debug - 启用调试日志。关键参数可指定问题类型缩小日志范围,如/debug "MCP connection timeout"。日志会自动标记时间戳和会话ID。
/heapdump - 生成内存快照。当Claude Code占用内存异常高时使用,会在桌面创建.heapsnapshot文件供进一步分析。
4.2 会话恢复命令
/rewind - 回滚到检查点。不只是撤销代码变更,还能回退对话上下文。支持选择性回滚,比如只撤销最近3个消息。
/undo - 别名同样功能。经验:频繁使用/model或/effort后建议手动设置检查点,因为模型切换会重置部分状态。
/feedback - 提交问题报告。会自动附加会话上下文和系统信息。实测响应速度通常在24小时内,特别是加上/reproduce步骤时。
5. 实用技巧与注意事项
5.1 命令组合策略
• 链式技能调用:从v2.1.199开始支持如/skill-a /skill-b do XYZ的链式调用。注意最多6个技能,且参数会传递给每个技能。
• 模型切换工作流:复杂任务可先用/sonnet快速迭代,再用/opus深度优化,最后用/code-review ultra审查。
• 后台任务监控:/background后,用/tasks定期检查,配合/model调整资源占用。
5.2 常见问题解决
• "Unknown command"错误:通常是因为版本不匹配,先用/doctor检查,再用/upgrade升级。
• 权限拒绝问题:检查/permissions设置,临时解决方案是用/config approval_mode=auto。
• 内存泄漏迹象:表现为响应变慢,先用/compact释放上下文,仍无效则/heapdump分析。
• MCP连接问题:/mcp reconnect重连特定服务器,或/mcp disable all后再逐个启用。
5.3 性能优化建议
• 长会话优化:定期/compact,将不活跃部分存入CLAUDE.md,用/memory管理。
• 资源密集型任务:使用/background和/model sonnet减少前端卡顿。
• 本地审查加速:对大型PR先用/code-review medium --fix本地处理,再用/ultrareview重点检查。
• 上下文效率:用/context识别冗余内容,/config优化保留策略。