Claude Code 的强大之处不仅在于其 AI 能力,更在于其丰富的内置命令体系。熟练运用这些命令,能让你在编码、调试和项目管理中事半功倍。
在 Claude Code 中输入 / 可以查看所有可用命令,输入 / 后跟任何字母即可快速筛选。
在下表中,<arg> 表示必需的参数,[arg] 表示可选参数。
命令速查表
会话管理
| 命令 | 用途 |
|---|---|
/clear |
清除对话历史记录并释放上下文。 |
/compact [instructions] |
压缩对话,可选择性地提供焦点说明 |
/resume [session] |
按 ID 或名称恢复对话,或打开会话选择器。 |
/rename [name] |
重命名当前会话并在提示栏上显示名称 |
/branch [name] |
在此点创建当前对话的分支。 |
/rewind |
将对话和/或代码倒回到上一个点 |
/export [filename] |
将当前对话导出为纯文本 |
/add-dir <path> |
向当前会话添加新的工作目录 |
/context |
将当前上下文使用情况可视化为彩色网格 |
配置与环境
| 命令 | 用途 |
|---|---|
/init |
使用 CLAUDE.md 指南初始化项目 |
/hooks |
查看工具事件的 Hook 配置 |
/vim |
在 Vim 和普通编辑模式之间切换 |
实用工具
| 命令 | 用途 |
|---|---|
/diff |
打开交互式差异查看器,显示未提交的更改和每轮差异 |
/copy [N] |
将最后一个助手响应复制到剪贴板 |
/btw <question> |
提出快速问题,无需添加到对话中 |
/tasks |
列出并管理后台任务 |
/skills |
列出可用的 Skills |
下面,我将按类别逐一介绍每个命令的详细用法和日常开发中最常用的场景。
会话管理
/clear
详细解释 清空当前会话的所有历史记录。这会释放被占用的上下文。如果当前对话中有重要的信息,请确保已经导出或记住,因为执行后无法恢复。
使用场景
连续工作了几小时,上下文已经塞满,AI 响应变慢或开始忽略最初的指令。运行 /clear 开启一个全新的对话状态。
/compact [instructions]
详细解释
智能压缩当前对话,保留关键决策和代码状态,同时丢弃冗余细节。如果提供了 [instructions],AI 会按照你的重点进行总结。压缩后的对话会继续占用更少的上下文。
使用场景
对话已经进行了 50 多轮,上下文接近上限,但还想继续在当前任务基础上工作。运行 /compact 重点保留关于用户认证模块的修改记录,然后继续。
/resume [session]
详细解释 按会话 ID 或名称恢复之前的对话。如果不提供参数,会打开一个会话选择器,列出所有历史会话,支持上下键选择。
使用场景
下午 3 点开始重构一个复杂算法,下班时还没做完。第二天早上输入 /resume,选择昨天的重构任务,AI 能瞬间回忆起所有上下文继续工作。
/rename [name]
详细解释 给当前会话起一个有意义的名字。如果不提供名字,AI 会根据对话内容自动生成一个。名字会显示在提示栏上,便于区分。
使用场景
当你有 10 个未命名的会话时,很难分清哪个是"支付模块重构"。运行 /rename 支付模块重构,之后在 /resume 列表里就能一眼找到。
/branch [name]
详细解释 在不丢失当前主线上下文的情况下,创建一个分支对话。主线的历史不会消失,你可以在分支上放心尝试激进的重构方案。
使用场景 主线对话正在开发"用户登录"功能,你想让 AI 尝试两种不同的缓存策略,但又不想把两种策略的讨论混在一起。分别创建两个分支进行测试。
/rewind
详细解释 Claude Code 的"后悔药"。它允许你将对话回滚到之前的某个节点,同时也可以选择性地回滚代码变更。可以选择"仅回滚对话"或"回滚对话 + 代码"。
使用场景
AI 尝试修改了 5 个文件来解决一个 Bug,但方案走偏了。使用 /rewind 回到修改前的状态,然后重新描述问题,避免手动 git reset 的麻烦。
/export [filename]
详细解释 将当前完整的对话记录导出为纯文本文件。如果不指定文件名,会弹出一个对话框让你选择保存位置或复制到剪贴板。
使用场景 完成一个复杂功能的开发后,想把整个思考过程、AI 的推理逻辑导出发给同事进行 Code Review,或者作为技术文档存档。
/add-dir <path>
详细解释
默认情况下,Claude Code 只能感知当前工作目录下的文件。使用 /add-dir 可以将另一个目录加入当前会话,AI 在回答时会同时考虑这些目录中的内容。
使用场景 当你正在开发前端项目,但需要 AI 参考后端的 API 定义文件来生成请求代码时,用这个命令把后端目录添加进来,AI 就能跨目录理解上下文。
/context
详细解释 以彩色网格的形式可视化展示当前上下文的占用情况。它会高亮显示占用大量上下文的工具调用(如读取了超大文件),并给出优化建议。
使用场景
当你感觉 AI 开始"忘记"很久之前约定的编码规范时,运行此命令检查是否上下文已经过载。如果看到某个工具调用占用太多,可以考虑 /compact 或 /clear。
配置与环境
/init
详细解释
在项目根目录创建 CLAUDE.md 文件(或更新现有文件)。你可以在此文件中写入项目架构、编码规范、常用命令等。设置环境变量 CLAUDE_CODE_NEW_INIT=true 会启动交互式引导,帮助你配置 Skills 和 Hooks。
使用场景
接手一个新项目,运行 /init 并告诉 AI "这是一个用 Next.js 14 写的项目,使用 App Router,状态管理用 Zustand"。之后 AI 的建议会严格遵循这些约定,生成的代码风格也更统一。
/hooks
详细解释
显示当前配置的工具事件钩子(Hooks)。Hooks 允许你在 AI 执行特定工具(如 Bash、Edit)前后运行自定义脚本,用于自动化流程。
使用场景
你配置了一个 Hook,在 AI 每次修改代码后自动运行 prettier 格式化。当 Hook 没有按预期工作时,用 /hooks 查看当前配置是否正确加载。
/vim
详细解释
在终端的输入框中切换 Vim 模式(普通模式 / 插入模式)。开启后,你可以使用 j、k、w、b 等 Vim 键位来编辑输入框中的文本。
使用场景 习惯 Vim 键位的开发者,在长文本输入或修改指令时,可以高效编辑,大幅提升输入效率。
实用工具
/diff
详细解释 启动一个终端 UI 界面,可以横向对比当前的 Git 未提交变更和 AI 每一次工具调用产生的差异。使用左右箭头在全局 diff 和单个 Claude 轮次之间切换,上下箭头浏览文件。
使用场景
AI 帮你修改了一个复杂的函数,你想逐行确认它改的逻辑是否完全正确,而不是只看终端里刷过的输出。用 /diff 可以仔细审查每一处改动。
/copy [N]
详细解释
默认复制 AI 的最后一条回复到剪贴板。如果回复中包含多个代码块,会弹出一个交互式选择器让你挑选单个块或整个回复。传递数字 N 可以复制第 N 个最新响应(例如 /copy 2 复制倒数第二条)。
使用场景
AI 给出了三段代码(index.html、style.css、script.js),你只需要其中 style.css 的内容。使用 /copy 通过选择器精准复制,避免手动选中。
/btw <question>
详细解释 这是一个"旁白"式的问题。你提出的问题会被 AI 回答,但不会记录到主对话历史中,也不会占用主对话的上下文窗口。非常适合快速查询一些小知识点。
使用场景
正在让 AI 写一个排序算法,中途忘记了 Python 中 lambda 的写法。直接输入 /btw 如何在 sorted 中使用 lambda 按第二个元素排序?,得到答案后继续原来的对话,不会打断主任务的"记忆"。
/tasks
详细解释
当你让 AI 执行一个长期运行的任务(例如"扫描整个项目找出所有未使用的变量"),这个任务会在后台运行。/tasks 可以查看这些后台任务的进度、输出或终止它们。
使用场景
你让 AI 开始执行"全项目代码格式化",但不想阻塞当前对话。可以继续做其他事,随时用 /tasks 查看进度,完成后再进行下一步。
/skills
详细解释 列出当前可用的 Skills。Skills 类似于特定领域的专家知识包,可以扩展 AI 在特定技术栈或业务领域的能力。
使用场景 你想知道 AI 是否具备"React 性能优化"或"PostgreSQL 调优"方面的增强能力,可以运行此命令查看已安装的技能列表。
额外技巧
除了上述命令,还有几个实用的交互技巧值得了解:
! <command>:在输入框中输入!前缀可以直接执行 shell 命令,输出会直接显示在对话中。例如! git status。Escape键:随时按Escape可以中断 AI 的当前操作,适用于生成内容偏离预期时及时止损。/快速筛选:输入/后紧跟关键词可以快速过滤命令,无需记住完整命令名。
以上是我在日常开发中使用频率最高、也认为最实用的一些命令。掌握它们,能让你与 Claude Code 的交互更加行云流水。
默认评论
Halo系统提供的评论