Claude Code 命令完全指南：从入门到精通

前言理解斜杠命令在 Claude Code 的交互式会话中输入/即可弹出所有可用命令列表。斜杠命令不同于 CLI 标志如--model——它们在会话内部使用用于在对话过程中动态调整上下文、切换模型、管理会话、查看统计信息等。掌握这些命令能让你从只会输入提示词进阶到精准控制 AI 编码助手。按照功能我将这些命令分为六大类会话管理上下文管理规划与审查导航与回溯成本与性能控制系统工具一、会话管理/exit安全退出当前对话会话。功能说明结束当前 Claude Code 会话并返回终端。与直接按CtrlC/CtrlD不同/exit会触发清理流程确保未保存的修改得到妥善处理。适用场景完成编码任务、需要结束当前会话时。# 在交互式会话中输入 /exit/resume [session]恢复之前的会话。功能说明列出所有可恢复的历史会话支持按会话 ID 或名称精确恢复。每次会话都保留了完整的上下文恢复后可以继续之前的工作而不丢失状态。适用场景中断工作后回来继续、需要在多个项目会话间切换。# 打开交互式选择器 /resume # 按名称搜索恢复 /resume my-blog-project # 按会话ID恢复 /resume abc12345-xxxx-xxxx-xxxx-xxxxxxxxxxxx/fork [name]在当前时间点创建会话分支。功能说明将当前会话分叉出一个独立副本。这在探索不同方向时非常有用——你可以在分支上尝试一种方案而原始会话不受影响。适用场景想尝试不同的实现方案又不丢失原会话、需要保存当前进度但继续做实验。# 自动命名分支 /fork # 指定分支名称 /fork refactor-attempt-2二、上下文管理这一组命令是 Claude Code 高阶用户最常用、也最重要的命令。管理好上下文窗口Context Window直接关系到会话质量和成本。/compact [instructions]压缩对话历史以释放上下文空间。功能说明将早期对话内容智能摘要化腾出上下文窗口给后续对话。可以指定压缩时重点关注哪些内容。压缩后模型的短期记忆被清空但保留了对整体任务的理解。适用场景上下文使用率超过 80% 时、要在长会话中继续工作时、感觉模型开始忘记早期内容时。# 默认压缩 /compact # 带指令的压缩告诉 Claude 保留哪些关键上下文 /compact 重点关注用户认证模块和当前测试失败的详情最佳实践不要等到上下文完全耗尽才使用/compact。养成在上下文使用率超过 70-80% 时主动压缩的习惯。/clear清除当前会话的上下文。功能说明清空会话上下文。注意这并非完全的清空而是一个大幅度的压缩保留了对项目结构的基本理解但清除了详细的对话历史。适用场景在同一个项目中切换到一个完全不相关的任务、会话上下文已完全用尽需要重新开始。/clear/context查看当前会话的上下文使用统计。功能说明显示详细的上下文占用情况包括 Prompt系统提示词、Conversation对话历史、Files文件内容各自占用的 token 数以及总容量和剩余空间。适用场景在长时间会话中监控上下文水位、决定是否需要/compact、排查模型健忘问题。/context # 输出示例 # Prompt: 62,550 (31%) Conversation: 85,200 (42%) Files: 28,300 (14%) # Total: 176,050 capacity: 200,000 remaining: 23,950 (12%)/summary查看当前会话的变更摘要。功能说明显示本次会话中修改了哪些文件、新增/删除了多少行代码、执行了哪些关键操作。方便快速回顾工作进度。适用场景需要快速了解这轮会话做了什么、写 commit message 前回顾、向团队汇报工作。/summary # 输出示例 # Changes across 3 files, 83 lines added, 21 lines removed # - src/auth/Login.tsx: 添加了 OAuth 登录流程 # - src/api/user.ts: 修复了 token 刷新逻辑 # - tests/auth.test.ts: 新增认证单元测试/btw [message]在不打断当前任务的前提下补充额外信息。功能说明向模型传达一个顺便说一句的信息不会改变当前正在执行的任务方向。这在需要提醒模型某个约束条件或提供背景信息时特别有用而无需中断当前的工作流程。适用场景提醒模型某个约定这个项目的测试是用 Vitest 写的、补充约束条件注意兼容 IE11、提供背景信息。# 在执行任务过程中补充信息 /btw 注意这个项目的 Node.js 版本要求是 18三、规划与审查/plan [prompt]进入计划模式进行结构化的实现规划。功能说明启动计划模式Claude 会先探索代码库、理解现有架构然后设计实现方案最后提交给你审批。只有在你批准方案后才会开始写代码。这避免了直接开干结果方向不对的问题。适用场景实现复杂功能添加认证系统、重构数据库层、涉及多文件修改的任务、需要做架构决策时。# 进入计划模式 /plan 为博客系统添加标签云功能 # Claude 会探索现有代码 → 设计方案 → 等待你批准 → 实现黄金法则任何影响 3 个以上文件的修改都先用/plan。这通常能节省 30% 以上的返工时间。/diff查看当前会话的代码变更。功能说明显示自会话开始以来所有文件的修改差异diff类似于git diff但限定在当前 Claude Code 会话范围内。适用场景提交代码前审查变更、检查 Claude 的修改是否符合预期。/diff/commit智能提交代码。功能说明基于当前变更自动生成有意义的 commit message并执行 git commit。Claude 会分析变更内容理解改动的意图生成结构化的提交信息。适用场景完成一个功能后准备提交代码。/commit/review-pr [PR identifier]审查 Pull Request。功能说明分析指定 PR 的代码变更提供审查意见。包括潜在问题、改进建议、安全性检查等。适用场景代码审查、合并前检查 PR 质量。# 审查当前分支的 PR /review-pr # 审查特定 PR /review-pr 42/autofix-pr [prompt]自动修复 PR 中的 CI 失败。功能说明启动一个云端 Claude Code 会话持续监视当前分支的 PR。当 CI 失败或 reviewer 留下评论时自动推送修复。默认修复所有 CI 失败和评审意见。适用场景PR 有 CI 报错不想手动逐个修复、需要自动响应评审意见。# 默认修复全部问题 /autofix-pr # 限定修复范围 /autofix-pr 只修复 lint 错误和类型错误注意需要安装ghCLI 并有权访问 Claude Code on the Web。四、导航与回溯/rewind回退对话和/或代码到之前的状态。功能说明将会话和代码回滚到之前的某个时间点。你可以选择回退的幅度——回退几条消息或者回到某个关键节点。对于意外修改或走错方向的情况极其有用。适用场景模型做了不想要的修改想撤销、实验方向错了想回到之前的状态。/rewind # 交互式选择要回退到哪个时间点/branch将会话分支到新的方向。功能说明类似/fork在当前会话基础上创建一个分支。不同之处在于/branch更适用于在当前代码库中创建实验性分支的场景。适用场景想尝试不同实现方案、需要并行探索多个方向。/branch/background [prompt]将会话分离为后台代理运行。功能说明将当前会话异步后台化释放终端。Claude 会在后台继续执行任务你随时可以查看进度和结果。适用场景需要长时间运行的任务如大规模重构、不想阻塞终端做其他事情。/background 请继续重构 auth 模块完成后通知我五、成本与性能控制/cost查看本次会话的 token 消耗和费用。功能说明显示精确的 token 使用统计和累计费用。帮助你了解每次会话的开销优化使用策略。适用场景监控 API 花费、对比不同模型的成本差异、优化提示词减少 token 消耗。/cost # 输出示例 # Tokens used: 245,832 Estimated cost: $2.46 # Model: claude-sonnet-4-6/model [model]切换当前会话使用的模型。功能说明在不退出会话的情况下动态切换模型。支持通过别名sonnet、opus、haiku或完整模型名切换。适用场景复杂任务需要 Opus 的推理能力就切换过去、简单任务切换到 Sonnet/Haiku 省钱。# 使用别名切换 /model sonnet /model opus # 使用完整模型名 /model claude-sonnet-4-6策略建议先让 Opus 做架构设计再切到 Sonnet 写实现代码最后用 Haiku 做简单修改——可以在一个会话内完成。/effort [level]设置 Claude 的努力程度。功能说明控制模型推理的深度和资源投入。提供四个级别low快速响应适合简单任务、medium平衡模式、high深度推理、max最高质量适用于复杂问题。适用场景简单问题用low提高速度和降低成本复杂架构问题用high或max获得更深入的思考。# 简单问题快速响应 /effort low # 平衡模式 /effort medium # 复杂问题深度推理 /effort high # 极限模式追求最高质量 /effort max六、系统工具/help获取 Claude Code 的使用帮助。功能说明展示所有可用的斜杠命令列表和基本用法说明。新手入门的第一站。适用场景刚接触 Claude Code 时查看命令列表、忘记某个命令时快速查阅。/help/init初始化项目配置。功能说明为当前项目生成初始化的 Claude Code 配置文件如.claude/settings.json、CLAUDE.md。Claude 会分析项目结构并生成适合该项目的配置。适用场景新项目首次使用 Claude Code、需要为项目定制行为规则。/init/doctor检查 Claude Code 的健康状态。功能说明运行诊断检查验证自动更新、配置文件、MCP 服务器等关键组件的状态。适用场景遇到异常行为时、更新后检查是否正常、排查连接问题。/doctor/agents管理子代理Subagents。功能说明提示你如何使用子代理功能——你可以要求 Claude 创建和管理专门的子代理来处理特定任务或直接编辑.claude/agents/目录下的代理定义。适用场景需要并行处理多个独立任务、为项目配置专门的审查代理。/agents/skills列出当前可用的技能Skills。功能说明展示所有已加载的内置技能和自定义技能。技能是 Claude Code 的模块化能力包以斜杠命令的形式调用。适用场景查看当前有哪些技能可用、发现新的内置技能。/skills七、核心技能命令深度实战这一章聚焦几个含金量最高的内置技能命令。它们不是简单的开关而是一套完整的工作流引擎。掌握它们能直接改变你使用 Claude Code 的方式。/simplify —— 代码审查与重构建议/simplify是 Claude Code 最被低估的命令之一。它不是一个简单的检查代码而是一个结构化的代码审查流程专门审查你当前会话中修改过的代码。它能做什么评估代码的复用性是否存在大量重复逻辑可以抽取为共享函数/组件评估代码的质量是否有潜在的 bug、类型不安全、边界条件未处理评估代码的效率是否有不必要的复杂度、过度工程、或性能问题给出具体的重构建议不是泛泛的优化代码而是逐行指出哪里可以改进适用场景写完一个函数/组件后做快速自我审查提交 PR 前做最终检查接手旧代码或从其他工具迁移来的代码作为代码 Review 流程的一部分最佳实践# 场景 1写完核心逻辑后快速审查 # 刚实现了一个用户认证 hook立即运行 /simplify # 场景 2针对特定文件做深度审查 /simplify 请重点审查 src/hooks/useAuth.ts 的安全性 # 场景 3在提交前做全量审查 # 完成一轮修改后先 /diff 看改了什么再 /simplify 做审查与其他命令的配合# 完整的提交前工作流 /diff # 先看改了哪些内容 /simplify # 审查代码质量 # 根据建议修改 /commit # 提交进阶技巧/simplify的审查质量取决于上下文。如果会话中已经有了相关的架构文档、类型定义、测试文件审查会更准确。因此在复杂任务中先用/plan建立结构再实现最后/simplify是一个黄金组合。/ultracode —— 多代理工作流编排/ultracode是 Claude Code 最具威力的功能。它本质上是一个多代理工作流引擎——当你遇到一个复杂的任务时Claude 会将任务拆解动态生成一个协调脚本JavaScript orchestration script然后派生出多个子代理并行工作最后汇总结果。核心概念Fan-out扇出主任务被拆解成多个独立子任务每个子任务由一个独立的子代理负责Parallel并行不相关的子任务同时执行大幅提升效率Pipeline流水线有依赖关系的子任务按顺序执行前一个的输出是后一个的输入Adversarial Verification对抗验证一个代理写代码另一个代理审查防止自欺欺人Journaling日志记录工作流的每一步都有记录支持断点恢复resume什么时候该用/ultracode大型重构如将整个 utils 目录迁移到 TypeScript多文件、多模块的并行开发需要编写→审查→修复→再审查循环的关键代码需要同时探索多个方案并对比结果的调研任务工作流示例# 场景 1大型重构 /ultracode 将 src/utils/ 下的所有 .js 文件迁移到 TypeScript # 内部发生了什么 # 1. 列出所有需要迁移的文件 # 2. 分成若干批次每批由独立子代理并行迁移 # 3. 每个子代理迁移后自动调用 /simplify 审查 # 4. 汇总所有变更输出迁移报告# 场景 2多路调研 /ultracode 调研 Auth0、Clerk、NextAuth 这三个认证方案从以下维度对比 - 定价免费层和付费层 - 易用性集成复杂度 - 功能完备性SSO、MFA、社交登录 - 适用场景个人项目 vs 企业级重要提醒-/ultracode会消耗大量 token——复杂任务可能跑到数十万甚至上百万 token- 建议在开启前先用/cost检查当前会话花费- 可以先抽一部分子任务做小规模测试确认工作流正确后再全量运行/loop —— 定时循环任务/loop是 Claude Code 的调度引擎。它让你在会话中设置定时触发的循环任务无需离开终端。工作原理/loop背后使用CronCreate工具在系统层面创建 cron 任务。每次循环触发时Claude 会在当前会话中执行指定的 prompt并根据输出决定下一步行动。循环任务默认带有 3 天的安全过期时间防止任务遗忘在后台。语法# 格式/loop [interval] [prompt] # 每隔 5 分钟执行一次 /loop 5m 检查部署是否完成 # 每隔 30 秒执行一次 /loop 30s 当前测试进度如何 # 每隔 2 小时执行一次 /loop 2h 有没有新的 error log时间单位s秒、m分钟、h小时、d天典型场景# 场景 1监控部署 /loop 5m 检查 production 部署是否完成如果完成了告诉我最终状态 # 场景 2等待 CI /loop 2m 检查 CI pipeline 的状态全部通过时告诉我 # 场景 3定时数据采集 /loop 1h 抓取最新的服务器日志检查是否有异常 IP # 场景 4批量处理配合其他命令 /loop 10m 检查队列中还有多少待处理任务最佳实践间隔不要太短10s 可能触发 API 限流建议至少 30sprompt 要明确什么条件下通知你而不是简单重复——好的例子/loop 5m 检查构建状态完成了告诉我不好的例子/loop 5m 检查构建状态循环任务不会跨越会话——退出会话后循环停止对于需要长期运行的定时任务考虑使用系统的 cron 配合ccb -p/cron-list —— 查看定时任务用于列出当前所有活跃的定时循环任务。功能说明显示所有通过/loop或CronCreate创建的定时任务包括每个任务的 ID、触发间隔、任务描述、创建时间和剩余有效时间。# 列出所有定时任务 /cron-list # 输出示例 # ID: cron_abc123 间隔: 5m 描述: 检查部署状态 # ID: cron_def456 间隔: 2h 描述: 抓取最新 error log适用场景忘记之前设了哪些循环任务、需要清理不再需要的任务、排查怎么还有东西在运行。/cron-delete [id] —— 取消定时任务用于停止和删除指定的循环任务。# 先列出所有任务获取 ID /cron-list # 删除指定任务 /cron-delete cron_abc123 # 删除所有任务 /cron-delete --all最佳实践离开会话前养成好习惯——用/cron-list检查是否有忘记清理的循环任务避免资源浪费。/dream —— Auto-Dream记忆整理与优化/dream是 Claude Code 最独特的功能之一。它不是简单的记住东西而是一个四阶段记忆整理流程类比人类的 REM 睡眠快速眼动睡眠期间的大脑记忆巩固。为什么需要/dreamClaude Code 有自动记忆系统Auto Memory会在每次会话中自动记录关于项目的事实、偏好和决策。但长期使用后这些记忆文件会出现记忆腐烂memory rot重复同一个事实被记录了多次矛盾旧的决策和新的决策冲突过期这个 PR 本周合并变成了一个过期的指代碎片化相关的事实分散在多个文件中/dream的四个整理阶段阶段名称做什么1Orient定位读取当前的整个记忆目录了解有什么2Prune修剪删除矛盾的、过期的、无价值的记忆条目3Consolidate巩固将相关的记忆合并消除重复4Index索引重建 MEMORY.md 索引让记忆更容易被检索手动触发# 手动触发记忆整理 /dream自动触发Auto-Dream从 v2.1.59 开始Claude Code 支持Auto-Dream——在会话空闲超过一定时间后自动在后台运行记忆整理。你可以通过/memory检查 Auto-Dream 的状态# 查看记忆系统状态 /memory # 如果看到 Auto-dream: on说明自动整理已启用使用建议每周手动运行一次/dream特别是在长期项目上如果发现 Claude 开始忘记项目约定或重复问同样的问题立即跑一次在有重大架构决策后运行一次确保决策被固化到长期记忆/dream操作的是本地的记忆文件不会触发 API 调用——免费且安全注意/dream功能在 v2.1.59 中逐步开放。如果你使用的版本较旧可以创建一个自定义 skill 来模拟这个流程。/review —— 整体代码审查/review与/simplify的区别/simplify侧重于代码质量和复用性的微观审查而/review侧重于整体架构和功能的宏观审查。功能说明对当前会话的改动进行全面的代码审查包括功能完整性、边界情况、错误处理、性能影响等更广泛的维度。# 进行完整代码审查 /review典型反馈内容功能完整性改动是否覆盖了所有需求边界情况是否有遗漏的边界条件错误处理是否有适当的错误捕获和降级策略性能影响改动是否会引入性能瓶颈安全性是否有潜在的安全风险/use-artifacts —— 创建交付物功能说明当任务需要生成长篇文档、复杂的设计稿、或者可作为独立交付物的内容时/use-artifacts会启用 Artifact 工具在对话侧边栏或专门的面板中呈现内容。# 创建一个 HTML 交互式报告 /use-artifacts 生成一个交互式的项目健康仪表盘 HTML # 创建一个技术方案文档 /use-artifacts 为数据库迁移方案写一份详细的设计文档 # 创建一个 React 组件预览 /use-artifacts 创建一个带样式的用户信息卡片组件适用场景生成可分享的交付物、创建 HTML 原型、编写需要排版的文档。/update-config —— 运行配置管理功能说明如果不记得核心设置项的位置/update-config会引导你完成权限设置、环境变量、settings.json 等配置的修改。# 修改 Claude Code 配置 /update-config/keybindings-help —— 键盘快捷键参考功能说明列出所有可用的键盘快捷键并可以自定义键位绑定。# 查看快捷键列表 /keybindings-help/goal —— 任务目标管理功能说明设置或更新当前会话的目标。当会话变长、任务方向开始漂移时用/goal重新锚定 Claude 的工作方向。# 设置会话目标 /goal 完成用户认证模块的 OAuth 集成包括 Google 和 GitHub 登录 # 会话过程中更新目标 /goal 现在重点解决 CI 测试失败的问题九、如何创建自定义斜杠命令除了内置命令Claude Code 支持通过 Skills 系统创建自定义斜杠命令。这是一个非常强大的功能——你可以将自己频繁使用的提示词封装成可复用的命令。创建步骤在项目根目录创建.claude/skills/目录在其中创建一个 Markdown 文件文件名就是命令名在文件头使用 YAML frontmatter 配置元信息文件内容就是该命令展开后的提示词基础示例文件.claude/skills/add-test.md--- name: add-test description: 为指定函数生成单元测试 --- 请为以下函数编写全面的单元测试覆盖正常路径、边界条件和错误处理。 使用项目现有的测试框架和风格约定。之后在会话中即可使用/add-test调用。使用参数支持通过$ARGUMENTS变量接收参数--- name: create-component description: 创建新的 React 组件 --- 请创建一个 React 组件名为 $ARGUMENTS包含 - TypeScript 类型定义 - 组件的单元测试 - 配套的 CSS 模块文件使用/create-component UserProfile十、实用工作流组合掌握了单个命令后将它们组合使用才是真正的生产力提升工作流 1高效编码# 1. 进入会话 ccb # 2. 规划复杂功能 /plan 实现用户权限管理系统 # 3. 批准方案后切换到高效模型 /model sonnet /effort high # 4. 实现中... # 5. 检查上下文水位 /context # 6. 上下文接近 80%压缩 /compact 重点保留权限系统的设计决策 # 7. 提交代码 /diff # 审查变更 /commit # 智能提交工作流 2降本增效# 用 Opus 做架构决策 /model opus /plan 设计数据库迁移方案 # 批准方案后切到 Sonnet 写代码 /model sonnet /effort medium # 简单修改用 Haiku /effort low工作流 3长时任务不阻塞# 启动后台任务 /background 请将整个 utils 目录迁移到 TypeScript # 可以关闭终端做其他事稍后回来查看结果工作流 4代码质量守护# 完成编码后自动走质量流水线 /simplify # 微观审查代码复用性和质量 /review # 宏观审查功能和安全性 # 根据建议修改 /commit # 智能提交 # 次日回到项目整理记忆 /dream # 整理积压的记忆文件工作流 5重型并行重构# 1. 规划先行 /model opus /plan 将项目从 JavaScript 迁移到 TypeScript # 2. 批准方案后启用多代理并行 /ultracode 执行迁移计划分批并行迁移所有模块 # 3. 迁移过程中设置监控 /loop 10m 检查迁移进度报告还剩多少文件未处理 # 4. 迁移完成后的清理 /cron-list # 检查循环任务 /cron-delete --all # 清理不再需要的任务 /dream # 固化迁移决策到长期记忆工作流 624 小时无人值守# 下班前设置 /ultracode 对整个代码库做全面的安全审计 # 设置夜间循环任务 /loop 1h 如果安全审计完成就报告结果否则报告进度 # 早上回来查看 /cron-list # 查看审计结果十一、常见问题Q斜杠命令和 CLI 参数有什么区别斜杠命令在会话内部使用用于在对话过程中动态调整行为。CLI 参数如--model、-p、--resume在启动时指定。例如你可以在启动时用ccb --model opus指定模型也可以进入会话后用/model sonnet随时切换。Q我怎么知道当前版本有哪些命令在交互式会话中直接输入/即可看到所有可用命令的自动补全列表。也可以使用/help查看完整列表。Q自定义命令和内置命令冲突了怎么办自定义命令优先级更高——如果在.claude/skills/中创建了与内置命令同名的技能自定义版本会覆盖内置版本。总结Claude Code 的斜杠命令系统是其强大之处。掌握这些命令你就能精确控制会话的每个方面上下文管理/compact、/clear、/context——保持 AI 的记忆力规划审查/plan、/diff、/commit——确保代码质量成本控制/cost、/model、/effort——优化 API 花费导航回溯/rewind、/fork、/background——灵活管理会话代码质量/simplify、/review——微观到宏观的双重把关多代理协作/ultracode——重型任务并行加速定时调度/loop、/cron-list、/cron-delete——让 AI 在后台持续工作记忆系统/dream——长期项目中保持 AI 的经验不腐烂自定义扩展Skills 系统——打造自己的命令工具箱建议你花 15 分钟逐一尝试这些命令结合自己的实际工作流找到最适合的组合方式。下次遇到觉得 Claude 没用好的情况不妨先问自己有没有一个斜杠命令能改善当前的情况