【建议收藏】最全Claude Code 斜杠命令全指南：高效用法与避坑心得

Claude Code 是 Anthropic 推出的终端 AI 编码助手，在交互界面中通过 斜杠命令（Slash Commands）来控制 AI 助手的行为和上下文。合理使用斜杠命令可以大幅提升开发效率，但错误用法也可能带来困扰。本文将全面解读 Claude Code 提供的所有内置斜杠命令，包括但不限于 /clear、/compact、/permissions、/init、/model、/mcp、/cost、/login、/doctor 等。针对每个命令，我们说明其定义语法、推荐使用场景、潜在误用陷阱，并给出实战组合用法示例，帮助中高级开发者充分发挥这些命令的威力。

会话管理命令

在与 Claude Code 长时间交互时，管理对话上下文和令牌用量非常重要。以下命令可帮助我们清理或压缩对话，避免上下文过长导致的性能问题。

/clear – 清除对话历史

定义与语法： /clear 无参数。用于清除当前会话的对话历史，使 Claude 忘记之前的所有对话内容。执行后，相当于开启一个新会话，但不会退出 Claude Code 界面。

使用场景： 当对话持续很久、上下文累积过多时，可以使用 /clear 来重置上下文窗口，保持思路清晰。例如在完成一个独立任务后，开始新任务前执行 /clear，Claude 将从空上下文开始理解你的下一指令。这在任务切换时非常有用，可以避免旧话题干扰新需求。此外，当Claude的回答出现偏离正轨或上下文混乱时，/clear 可以一键“重启”对话。

潜在误用与避坑： 切记 /clear 会彻底清除对话记忆，之前分享的代码片段、讨论的细节都会丢失。如果后续仍需要用到先前内容，最好在清除前将重要信息添加到持久内存文件（如 CLAUDE.md）或者复制保存。频繁使用 /clear 虽可保证上下文简洁，但也可能降低效率——因为你需要重新向 Claude 描述背景。所以应在必要时才使用 /clear，避免每问一次就清上下文，这会让 Claude 失去逐步累积的理解。

实战示例： 当完成 Bug 修复进入下一个用户故事开发时，先执行：

/clear

清空旧对话。接着可以用 /init 载入项目记忆（详见下文），Claude 将基于新任务重新开始沟通，确保上下文干净而聚焦。

/compact – 压缩对话内容

定义与语法： /compact [instructions] 可选附加“指令”参数。此命令会将当前对话历史总结压缩，并以该摘要作为新对话的开场上下文。可选的 instructions 参数允许你指定压缩时的侧重点，例如 /compact "保留尚未解决的问题" 会让 Claude 在总结时侧重未解决问题部分。

使用场景： 当会话长度接近模型上下文长度上限时，/compact 是延续长对话的救星。Claude 会将已有对话自动总结为更短的内容，从而释放大量上下文令牌供后续交流使用。这类似于有个 AI 秘书在会议途中帮你记录会议纪要，确保你们不会因为对话太长而“忘记”前情。不过，与 /clear 不同，/compact 保留了上下文的精华——在新会话中Claude仍可以参考之前对话的摘要继续讨论。

推荐时机： 你可以定期主动压缩长对话，尤其是在大型讨论或代码走查过程中。当Claude提醒上下文接近95%容量时，最好立即 /compact。Anthropic提供的Claude Code默认在上下文用量达95%时也会自动触发压缩，但提前手动执行可保证重要信息按你的要求保留重点。另外，在关键结论达成后、深入新话题前，用 /compact 总结一下有助于Claude抓住重点继续下一部分讨论。

潜在误用与注意： 虽然压缩能节省令牌，但摘要毕竟是Claude生成的，可能遗漏细节或产生偏差。务必在压缩后检查摘要准确性，尤其对代码和需求细节，必要时手工补充关键点到 CLAUDE.md 内存文件中。另一个坑是过度压缩：如果一段对话本身并不长，却频繁 /compact，反而徒增不必要的总结步骤，可能打断思路。建议仅在对话相当长或接近限制时使用。本质上，/compact 是为长对话续航准备的，不需要对每次简短问答都用它。

实战示例： 假设你和 Claude 正在讨论一个大型重构提案，聊天已经持续几十轮，对话包含大量上下文。这时输入：

/compact "保留所有决定和未解决的问题"

Claude 会回复一段总结，突出先前达成的决策和待解决的问题（根据你的指令重点）。后续的新回答将基于这份简洁摘要继续，保证上下文不超载，又不遗忘关键结论。

/memory – 编辑会话记忆文件

定义与语法： /memory 无参数。用于直接打开并编辑当前项目的持久记忆文件 CLAUDE.md（或用户级别的全局记忆文件），方便查看和修改 Claude 的“长期记忆”。你也可以通过这个命令向 CLAUDE.md 添加或移除内容。

使用场景： CLAUDE.md 是 Claude Code 用于初始化上下文的指南文件，通常包含项目简介、架构要点、代码惯例等。通过 /memory 命令，你可以随时更新该文件的内容：比如在项目进展中添加新约定、在重要对话后把结论记录进去，或修正之前生成的 CLAUDE.md 中的错误信息。这有助于让 Claude 在后续会话（即使 /clear 之后的新会话）中拥有更准确的新知识。当 Claude 对某模块反复出现误解时，不妨手动编辑 CLAUDE.md 澄清。

潜在误用与避坑： 注意 /memory 打开的可能是一个编辑器界面（取决于终端设置），你需要熟悉终端编辑操作才能正确修改文件。并且，请确保格式简洁：CLAUDE.md 不宜过长或杂乱，否则Claude会被冗余信息干扰。更新记忆文件后，重新 /clear 会话或下次启动Claude Code时新内容才会生效，所以修改后别忘了重启对话或告知Claude加载新记忆。避免把敏感信息写入 CLAUDE.md，因为它可能被发送给API（尽管仅用于上下文）。总体来说，/memory 强大但需谨慎使用，保持记忆文件及时维护、重点突出。

实战示例： 在初始化项目后发现 CLAUDE.md 漏掉了一些关键业务术语解释，可以输入 /memory 打开文件，在其中添加术语解释列表并保存。保存退出后，可以 /clear 然后开始新会话，Claude 将自动参照更新后的 CLAUDE.md 来回答问题，减少对术语的误解。

/status – 会话状态检查

定义与语法： /status 无参数。显示当前 Claude Code 会话和系统状态，包括工作目录、登录账户、所用模型、加载的项目记忆等。这是一条只读命令，不会更改任何设置。

使用场景： 当你需要确认当前环境时（例如切换目录后不确定Claude是否跟随了新项目，或刚切换模型后想验证当前模型名），/status 可以立刻给出答案。它也是排查问题的起点：如果Claude行为异常，先看一下 /status 是否仍指向正确的路径和模型，是否有正确加载 CLAUDE.md 等。对于团队协作场景，/status 还能让你核对自己是否登录了公司账户，以及当前使用哪个API订阅等信息。

潜在误用与提示： /status 基本没有风险，因为它只是查看状态。但需要注意不会实时刷新：它展示的是命令执行当下的信息。如果你在Claude Code中途切换了终端目录或修改了配置，Claude 可能还没意识到（通常Claude Code监听目录变化，但偶尔也需手动提醒）。这时 /status 反映的目录可能仍是旧的。这种情况下可以通过退出Claude Code并在新目录重启、或使用 claude --continue 等方式确保Claude跟随目录变化。总之，如果 /status 显示的和你预期不符，不妨重启会话或检查是否需要其他操作同步状态。

实战示例： 当Claude的回答似乎引用的不是当前项目（可能因为误认了路径），运行：

/status

查看状态输出。你发现工作目录仍是上个项目路径，于是立即退出并切换目录重新启动Claude Code，使其针对正确的项目提供建议。

/cost – 令牌与费用统计

定义与语法： /cost 无参数。用于显示当前会话的令牌使用量统计，包括提示和回答分别用了多少 token，以及预估的 API 消耗费用。这对掌控 Claude Code 的使用成本非常有帮助。

使用场景： 如果你使用按量计费的API密钥或免费额度，随时关注对话的 token 消耗情况是个好习惯。执行 /cost 可以让你了解目前这场对话累计用了多少 token，并据此估算花费。在长时间编程会话或密集代码生成功能中，偶尔检查 /cost 有助于及时止损：发现token飙升可以选择提问更具体、压缩上下文等节约开销。另外，当你打算结束当天工作时，可以用 /cost 获取会话用量总结，核对是否在预算之内。

潜在误用与注意： 对于订阅Pro等无限次调用的用户来说，/cost 统计仅供参考意义，因为超额部分不额外计费。但即便如此，也不意味可以忽视 token 数，因为上下文窗口仍有限制，过多 token 会导致模型遗忘早期内容或增加响应延迟。另一方面，不要过于频繁分心去查费用——如果每聊两句就 /cost，反而干扰流畅度。建议：把 /cost 当成阶段性检查工具，比如完成一个任务模块或每小时查看一次即可。同时记住，会话结束时Claude Code通常也会输出一次总结（类似 /logout 时），平时无需每次都手动查询。

实战示例： 你完成了一个大型代码重构会话，想知道消耗了多少资源，于是输入：

/cost

Claude Code 列出提示端用了 8k tokens，输出端用了 12k tokens，总计约20k tokens，并估算费用约 $1.20。如果你预算紧张，下次可以考虑更精简地提问或让Claude一次输出更多内容以减少轮数。

配置与初始化命令

Claude Code 提供了一些命令用于初始化项目记忆、调整配置参数、选择模型等，让AI更好地贴合你的项目和偏好。

/init – 初始化项目记忆指南

定义与语法： /init 无参数。运行此命令会扫描当前项目代码库，在项目根目录生成一个 CLAUDE.md 文件，作为该项目的知识指南。CLAUDE.md 通常包含项目结构摘要、主要模块说明、依赖列表等内容。

使用场景： 建议首次在新项目中使用 Claude Code时立即执行 /init。这样Claude会自动了解项目的大概结构和背景，相当于给Claude这个AI同事一本项目手册。/init 生成的 CLAUDE.md 可由Claude根据代码自动提取要点，你也可以在Claude的帮助下完善它——比如询问 “请列出项目架构的关键部分写入 CLAUDE.md” 等。完成后，将 CLAUDE.md 保存（甚至提交进仓库共享给团队）。之后每次在该项目目录启动Claude Code，它都会首先读取 CLAUDE.md，拥有持久的项目信息。

推荐时机： 除了项目初始设置，用 /init 重新生成记忆 也有用武之地：当项目发生重大变更（例如大规模重构或目录结构变化）时，重新运行 /init 可以更新 CLAUDE.md 内容，让Claude紧跟项目最新状况。如果Claude在交互中对项目情况的认知明显滞后或错误，也可以考虑手动 /init 一次以刷新记忆。当然，也要结合手动编辑 CLAUDE.md 确保内容准确。

潜在误用与避坑： /init 会自动读取大量文件来生成概要，大型项目执行时间可能较长，而且 CLAUDE.md 可能过于庞大而失去重点。避免在过深的目录误用 /init ——最好在项目根目录运行，以覆盖完整项目。如果生成的 CLAUDE.md 有不需要的细节（例如把第三方库代码摘要也写进来了），要手动删减无关内容，突出关键点。另外请确保敏感代码不要包含在 CLAUDE.md，例如私钥或密码，即使Claude Code不会故意泄露它们，但最好遵循最小披露原则。如果项目不需要记忆（如很小的脚本仓库），不一定每次都要 /init。简而言之，/init 非常适合复杂项目的上手，但生成内容需开发者把关和维护。

实战示例： 初次将 Claude Code 用于一个新的后端仓库：进入项目目录后，运行：

/init

Claude 扫描项目结构并生成 CLAUDE.md，内容涵盖“项目简介、主要模块说明、依赖库版本”等。生成后你可以打开 CLAUDE.md 查看，若发现遗漏比如关键业务流程未包含，可以手动增补。完成后，后续每次启动Claude Code，它都能“记住”这些信息，回答更贴合项目实际。

/config – 查看或修改配置

定义与语法： /config 可交互式查看和修改 Claude Code 配置参数。执行命令会显示配置菜单，你可以根据提示修改设置，例如启用/禁用自动压缩、设置主题、切换编辑模式等。部分配置也支持通过子命令直接设置，比如 /config set autocompact off 等。

使用场景： Claude Code 提供许多可定制选项，通过 /config 你可以根据个人习惯进行调整。例如：Autocompact（自动压缩）默认开启以防止上下文溢出，通常建议保持开启；待办事项（to-do）功能可以让Claude Code在长任务中列步骤，你可在配置中启用/停用；verbose输出用于调试，可通过 /config 打开，当需要看Claude内部推理步骤时很有用（对应快捷键 Ctrl+R 切换verbose模式）；还有主题配色、通知方式（如终端铃声提醒Claude完成思考）、编辑模式等。总之，/config 是你的个性化Claude控制面板。

潜在误用与建议： 修改配置要明白各选项含义，避免因为调整不当影响使用体验。比如不要随意关闭 autocompact，否则长对话可能因上下文超限而中断。打开 verbose 可以看到Claude的思考过程，但平时尽量保持关闭以免输出过于冗长干扰正常交流。改变editor mode为 Vim 后，如果你不熟悉 Vim 操作，可能反而不会输入了（见下文 /vim）。另外，通过 /config 设置的参数多数会保存到配置文件，下次使用仍有效，因此临时调试的改动记得改回。例如开启 terminal_bell 提醒在深夜可能一直响铃吓到人，就需要及时关闭。最佳实践是熟悉常用配置（官方文档有完整列表）再调整，确保Claude Code始终处于适合你的状态。

实战示例： 你觉得 Claude 对话输出太多不相关推理，想看看其内部想法，便使用：

/config

打开配置界面，将 “verbose reasoning” 打开。之后Claude每次回复都会附带“思考过程”内容供你参考。当调试完成后，再次 /config 关闭 verbose 模式，回归简洁输出。

/model – 切换AI模型版本

定义与语法： /model [model_name]。不带参数时通常会显示当前使用的模型，并提示可选模型列表；指定参数则可切换Claude所用的AI模型。Claude Code 常用的模型代号包括 Sonnet（较快、上下文较短）和 Opus（较慢但能力更强、上下文长度更大）等，或具体版本如 claude-4-100k 等。

使用场景： 根据任务需要选择合适的模型，能在速度和质量间取得平衡。默认情况下Claude Code启动用的是较快的模型（截至2025年一般是 Sonnet 系列，如 claude-3.7-sonnet-xxxx）。当你需要更深入的分析、更大的上下文或更高准确度时，可以通过 /model opus 切换到能力更强的模型。例如复杂架构设计讨论、批量代码重构等场景，Opus模型（类似GPT-4之于GPT-3.5的角色）会表现更佳。而在简单问答或需要快速响应的场景下，继续使用Sonnet模型更高效。/model 让你动态调整AI助手的大脑，以匹配任务要求。

潜在误用与注意： 切换模型可能重置部分上下文。通常Claude Code在切换模型时会载入已有对话，但不同模型可能理解略有差异。特别地，如果你在对话中段改模型，Claude可能风格和细节把握会改变，需注意衔接。强模型如 Opus 每次回复用时更长、消耗更多 token（也就是成本更高），不必为了“小事”滥用。模型名称必须拼写正确，例如有的版本号或后缀要完全匹配。使用 /model 时留意Claude Code的反馈确认是否成功切换。如果新模型不支持某些功能或token太多，也可能报错。建议：在新会话一开始就选好模型，中途尽量少换。如果必须切换，考虑在 /clear 或 /compact 后进行，以减少上下文不一致。另外，团队协作时确保每个人使用一致的模型，以避免结果差异。

实战示例： 你在一个大型项目上运行单元测试分析，由于日志非常长，默认模型处理有困难。你执行：

/model opus

Claude 切换到较强大的 Opus 模型（例如Claude-4），能够分析更长日志并给出深度建议。任务完成后，你可以再 /model sonnet 切回轻量模型继续日常对话，以节省资源和加快响应。

/login 与 /logout – 账户切换与退出

定义与语法： /login 无参数，执行后会触发Anthropic账户切换流程，你可以登入另一个账户（需在浏览器完成OAuth）。/logout 则登出当前账户，结束当前会话。/logout 常在Claude Code退出时自动执行，用于清理会话数据。

使用场景： 账户管理命令在多账户、多环境情况下尤其有用。比如你个人有一个Claude账户，公司还有团队账户，需要在两者间切换时，用 /login 能快速换到另一身份，无需关闭工具。这也适用于更换API Key（本质也是不同账户）来执行不同额度的任务。/logout 则可用于结束工作：当你一天使用结束时主动 /logout，Claude Code 会打印本次会话摘要，包括用过的模型、对话消息数和累计 token 消耗等。这有助于记录每次会话的资源使用情况，尤其对于付费用户，可作为对账参考。

潜在误用与注意： 登录新账户可能改变使用上限和权限——确保在重要任务中不要突然切换到权限不足的账户，否则Claude可能无法访问项目或调用工具。如果频繁切换账号，要确认Claude Code对应的配置（如权限设置、个人命令等）在不同账户下可能不通用，需要重新配置。/logout 后当前上下文就失效了，再次使用需要重新 /login。提示：Claude Code 支持通过环境变量提供 API 密钥免登录，但若已登录账号又提供环境变量，可能出现冲突。因此在使用 /login 前建议清理或明确本地配置，避免混乱。一般来说，一个终端下同时只保持一个账户最简洁。

实战示例： 你在公司项目中用团队账号进行代码生成。下班后想用自己的账号做些个人项目实验，于是输入：

/logout

Claude Code 显示登出成功并列出会话共使用1.2万token、模型Claude-4等信息。接着你执行 /login 并按照提示在浏览器登录个人Anthropic账号。回来后Claude Code 切换至个人账号环境，你可以继续在新会话中工作而不影响公司额度。

权限与工具命令

Claude Code 强大的地方在于它可以执行各种工具操作（如读写文件、运行Shell命令、访问网络等）。为了安全，系统采用权限机制，以下命令帮助你管理权限和扩展 Claude 的能力。

/permissions – 查看/设置工具权限

定义与语法： /permissions 无参数。在会话中调用此命令会弹出一个交互界面，列出当前所有权限规则并允许你修改。Claude Code 将权限划分为允许规则和拒绝规则两类，各自对应 settings.json 配置中的白名单和黑名单。

使用场景： 当 Claude Code 第一次尝试执行敏感操作（如编辑文件、运行shell）时，会请求你的允许，并可选择“总是允许本会话”以创建相应规则。如果后来想调整这些规则，/permissions 就是你的利器。比如你发现某会话中反复允许 Bash(npm test) 很麻烦，可以打开 /permissions 将 Bash(npm test:*) 添加到允许列表，以后就不再询问。相反，如果你误选了“总是允许”某高风险命令，可以通过 /permissions 界面将其移除或加入拒绝列表，立刻收回Claude对该工具的自动使用权。总之，/permissions 提供了可视化管理当前会话工具授权的手段。

授权规则细节： 权限规则格式如 工具(可选说明符)。不带说明符表示所有该工具的使用都匹配，例如允许规则 Bash 将无条件允许Claude执行任何Shell命令而不再询问（极不建议这么泛泛允许）。带说明符可以细粒度控制，如 Bash(git diff:*) 只允许执行 git diff ... 开头的命令。内置工具如文件编辑用 Edit 关键字，文件读取用 Read。这些规则遵循 .gitignore 通配符语法，支持限定目录或文件。通过 /permissions 界面，可以方便地添加例如 Edit(src/**) 来一次性允许修改项目 src 目录下的文件，而无需每次确认。

潜在误用与安全提示： 切勿滥用宽泛权限！例如允许整个 Bash 或 Edit，等于打开“超级用户模式”，Claude可能执行任意系统命令，存在安全隐患。默认每次敏感操作都询问是为了让你检查Claude的意图，盲目全部允许会失去这层防护。如果真的需要无人值守地执行多步操作，Anthropic也提供 --dangerously-skip-permissions 这样的命令行参数直接跳过所有确认（俗称“YOLO模式”），但官方强烈不建议普通用户使用。在多人协作环境下，团队可能通过版本控制提供 .claude/settings.json 预设好允许/拒绝规则，你用 /permissions 修改只是临时会话内的，重启会话会恢复默认，所以不要企图用它绕过团队安全策略。另外，/permissions 目前是会话级别，改动不会影响其他并行会话。综上，谨慎赋权，定期复查：用完及时收紧权限，确保Claude的“自由”始终在你掌控之中。

实战示例： 你在一次代码生成中，需要Claude多次调用 ls 和 cat 查看文件。每次都弹权限确认让人烦恼，于是输入：

/permissions

在打开的权限列表中，将 Read 工具的规则添加 *.md 以允许读取Markdown文件，将 Bash(ls *) 加入允许。保存退出后，Claude随即可以无须反复确认地执行 ls 和读取 .md 文件内容。完成批处理任务后，你可以考虑重新打开 /permissions 将某些广泛权限删除，以防后续不经意执行其他命令。

/mcp – 模型上下文协议扩展管理

定义与语法： /mcp 无参数。用于管理 MCP（Model Context Protocol）服务器连接及认证信息。MCP 是 Anthropic 提供的一种扩展接口，允许将外部工具/服务接入Claude Code，作为模型可以调用的扩展“能力”。通过 /mcp 命令可以查看和配置当前Claude Code连接了哪些MCP服务、各服务的连接状态、可用工具列表等。

使用场景： MCP 的存在让Claude Code不仅局限于本地环境，还能远程调用外部API或服务。典型例子包括：连接浏览器自动化工具（如 Playwright MCP）以让Claude直接控制浏览器进行操作，连接数据库查询MCP等。在设置好MCP服务器后（通常需要通过命令行 claude mcp add 添加服务），/mcp 可以触发OAuth认证流程，完成Claude对该服务的授权。之后Claude就能使用该服务提供的自定义斜杠命令。/mcp 还能列出各服务器提供的工具和命令，帮助你知道Claude当前具备哪些额外能力。简而言之，当你要让Claude接入新的**“超能力”**时，/mcp 是必经步骤。

潜在误用与注意： 首先，只有在已配置MCP服务器的情况下，/mcp 才真正有意义——如果你什么MCP都没连，调用它只会看到一个空列表或者帮助信息。配置MCP需要一定技术门槛（自行架设MCP服务或使用Anthropic提供的插件），所以确保自己明白MCP如何工作。其次，MCP工具往往涉及更敏感的操作（如真的对互联网执行操作、修改云资源等），一定要谨慎给Claude授权。例如不要随便连接一个未知来源的MCP服务，因为Claude获得其权限后可能被诱导执行危害操作。/mcp 可能要求在浏览器完成OAuth认证，你需要确保自己的终端环境支持打开浏览器。如果在无GUI服务器上使用Claude Code，这部分操作会比较麻烦，需要移至有浏览器的环境进行。最后，管理多个MCP连接时要注意命名冲突：不同服务的命令如果同名Claude也许难以区分，但一般MCP命令都会加前缀区分（格式为 /mcp__服务器__命令）。总之，善用 /mcp 带来扩展性的同时，务必了解其背后的配置与安全影响。

实战示例： 你希望Claude能自动在浏览器执行E2E测试，于是在终端外先运行：

claude mcp add playwright "npx @playwright/mcp@latest"

添加了Playwright MCP服务。进入Claude Code后，执行：

/mcp

Claude 列出当前已配置的 MCP 服务，包括 playwright，显示未认证。你选择该服务并按照提示通过浏览器OAuth登录了Playwright服务账号。回到终端，Claude 提示连接成功，并罗列出可用的MCP命令，比如 /mcp__playwright__open_page <URL> 等。现在你就能在对话中使用这些命令，指挥Claude通过浏览器完成测试了。

/pr-comments 与 /review – PR 评论与代码审查

定义与语法： /pr-comments 无参数（注意实际命令可能需使用连字符 /pr-comments）。执行后Claude Code会获取当前仓库关联的拉取请求（PR）的评论并显示。/review 则会触发代码审查流程：通常针对当前代码改动或打开的PR，请求Claude给出审查意见。

使用场景： 这两个命令主要用于GitHub 集成场景。Claude Code 可以通过 GitHub CLI 或 API 来读取PR数据，因此当你在一个git仓库中，分支有打开的Pull Request时，使用 /pr-comments 能让Claude列出该PR下团队成员的所有评论反馈，方便你在终端中直接查看 review 意见，不用切换浏览器。紧接着，你可以执行 /review，Claude 会综合代码差异和评论内容，给出自动化的代码审查结果，指出潜在问题、改进建议，甚至直接在代码中做出修改建议。这相当于让Claude充当你的代码审查助手，在终端内完成查看评论和给出审查报告的闭环。

使用前提： 为使 /pr-comments 和 /review 正常工作，你需要保证GitHub CLI已登录并且仓库远程关联正确（Claude Code依赖本地Git信息来定位PR）。可能还需要设置 GitHub API Token 等。Anthropic 的 GitHub Actions 文档提到Claude Code有GitHub Action模式，可用于PR自动回复。本地使用时，要确保当前目录是一个Git仓库，有上游远程仓库，否则Claude无法找到 PR。通常 /review 会针对你当前分支相对于主分支的改动来做审查，因此先提交或stash未提交的改动，确保Claude看到正确的diff。

潜在误用与注意： 这些命令强依赖环境，如果在无关目录或没有PR的情况下使用，它们基本不会有输出（甚至可能没有任何提示）。使用 /review 不等于替代人工审查——AI的建议需谨慎采纳，尤其对安全相关代码。Claude可能无法识别非常上下文相关的业务逻辑问题，但对于风格问题或简单bug还不错。每次调用 /review 可能消耗较多token（因为PR diff可能很长），所以别频繁调用，可以等代码改动积累到一定程度再使用。还有，注意保密：Claude读取PR评论和代码意味着这些内容发送到模型，如果PR中有敏感信息要三思。不过Claude Code作为本地工具，评论内容通常也是你本地可见的信息。

实战示例： 你正在一个 feature 分支开发，准备提交PR。此时团队已经在PR下留下了一些初步评论。你可以执行：

/pr-comments

Claude 列出当前PR的评论，例如 “请优化函数命名”、“这里可能有空指针风险” 等。接着输入：

/review

Claude 会读取当前代码改动diff，结合评论意见，生成一份代码审查报告。报告中列出了：有哪些尚未解决的评论、代码中潜在问题段落及改进建议。根据Claude的审查结果，你可以逐一修改代码并回复PR。最后再让Claude协助检查一遍，确保所有反馈都得到处理。

终端与编辑器命令

Claude Code还提供一些命令来改善在终端中输入多行文本或使用特定编辑模式，使与AI协作更顺畅。

/terminal-setup – 终端换行键配置

定义与语法： /terminal-setup 无参数。执行后会检查当前终端（支持 iTerm2、VSCode 内置终端等）并尝试设置快捷键，使 Shift+Enter 可以插入换行，而不会直接提交输入。这方便在 Claude Code 提示中输入多行内容。

使用场景： 默认情况下，在大多数终端里按 Enter 就提交了当前输入给Claude，有时你需要输入一个多行的 prompt（比如一段代码、日志或者长描述）。Claude Code 本身支持几种方式输入多行：例如在行末输入反斜杠 \ 然后回车，或 Mac 下 Option+Enter 等。/terminal-setup 提供了一个一键配置手段，特别针对 iTerm2 和 VSCode Terminal：运行后它会自动绑定 Shift+Enter 为插入新行，让你像在文本编辑器里一样输入回车而不发送。如果你发现自己经常需要写长消息，不妨在会话开始时用一次 /terminal-setup 完善终端行为。

潜在误用与提示： 此命令对特定终端有效。如果你的终端不支持这些设置（例如 Windows 的某些命令行，或者不在VSCode/iTerm2环境），执行 /terminal-setup 可能不会有什么效果，最多输出一条提示说明哪些终端被支持。如果按了 /terminal-setup 提示成功，但 Shift+Enter 仍无法换行，可能需要手动检查终端设置（如 VSCode 需要关闭 快捷键Enter发送 等冲突选项）。另外，此设置通常在当前终端会话中有效，换个窗口可能要重设。/terminal-setup 虽小，但对于不了解终端换行技巧的用户非常实用，可以省去记忆 \ + Enter 这些小窍门。执行后Claude Code一般会提示配置结果，例如在 iTerm2 会提示启用了通知和换行绑定等。

实战示例： 你使用 VSCode 内置终端运行 Claude Code，需要输入一段多行伪代码给Claude。为了避免每行都手动加 \，你输入：

/terminal-setup

Claude Code 返回消息：“已配置 Shift+Enter 用于换行。”。接下来你在提示中按 Shift+Enter 就能直接换行，输入完多行内容后再按普通 Enter 提交，大大提升了输入长消息的效率。

/vim – Vim 模式切换

定义与语法： /vim 无参数。调用该命令后，Claude Code 将切换输入编辑模式为 Vim 风格，在命令行中实现 Vim 的 NORMAL/INSERT 双模式编辑。再次输入 /vim 则退出 Vim 模式（或通过 /config 永久设置）。

使用场景： 熟悉 Vim 的开发者常常希望在任何编辑环境都使用 Vim 按键操作。Claude Code 内置的 /vim 模式满足了这种需求：你可以用 Esc 切换到 NORMAL 模式在终端输入行内移动光标、删除文本、上一条命令编辑等，就像在 Vim 中一样。例如，按 dd 可以删除一整行输入、w 移动到下一个单词开头、0 跳到行首等。在需要编辑长提示或做复杂修改时，Vim 模式提供了更高效的键盘操作方式。不喜欢 Vim 的用户则完全可以不碰这个命令。

潜在误用与避坑： 不熟悉 Vim 切勿轻易开启！ Vim 模式下最容易让新手困惑的是按键不再直接输入字符，而是被当作命令。例如开启 /vim 后，随便敲字母可能导致光标乱跳、文本消失。很多用户一旦误进NORMAL模式甚至不知道怎么回到可输入状态（答案是按 i 切换INSERT模式）。因此，如果你无意间开启了 Vim 模式且不知道如何操作，可以通过再次 /vim 或 /config 将其关闭，恢复常规输入模式。另一方面，Vim模式目前仅影响Claude Code的输入行编辑，对Claude输出浏览没有vi那样的翻页或搜索功能，预期不要搞混。总而言之，这个命令是给Vim高阶玩家准备的利器，一般用户谨慎使用即可。

实战示例： 你准备让Claude生成一份复杂的代码模板，提示内容较长且需要局部多次修改。你本人是 Vim 用户，于是输入：

/vim

Claude Code 提示已进入 Vim 模式。此后你敲 Esc 进入NORMAL模式，熟练地用 b、w 移动光标，x 删除多余字符，p 粘贴剪切板内容，在一行上按 o 插入新行……完成编辑后按 Enter 提交给Claude生成代码。几轮交互下来，你几乎没碰鼠标就完成了复杂提示的编辑。在结束使用时，再次 /vim 切回普通模式，确保下次不误触。

其他辅助命令

最后介绍几条零散但重要的命令：用于调试诊断Claude Code状态，或者获取帮助和反馈支持。

/doctor – 环境健康检查

定义与语法： /doctor 无参数。执行后Claude Code会检查当前安装环境的健康状态，验证所需依赖和权限是否正确配置，并报告潜在问题。

使用场景： 当Claude Code行为异常（比如无法读取文件、工具调用总是失败等），/doctor 是排查问题的第一步。它会自动检查：Anthropic API连通性、已登录账户有效性、必需的依赖（git、GitHub CLI、ripgrep等）是否安装、Claude Code所需的文件权限是否授予等等。检查完后会输出一份报告，指出哪些项目通过，哪些存在问题。例如 “✘ 未检测到 GitHub CLI，请安装以使用 PR 功能” 或 “⚠ 当前Anthropic API凭据无效” 等。有了这些信息，你可以据此修复环境，然后重试之前的操作。

潜在误用与提示： /doctor 大多只读检查，不会更改设置，因此很安全。唯一需要注意的是阅读报告：不少用户运行了 /doctor 看到一大堆输出却没有仔细查看，就以为没问题。事实上里面的警告和失败项要认真处理才能真正解决问题。另外，/doctor 不可能覆盖所有情况，只检查已知的环境要求。如果问题依旧，也要考虑日志和 verbose 模式进一步诊断。一般建议每次升级或首次安装Claude Code后都跑一次 /doctor，预先发现环境漏项。修复环境问题后，可再次 /doctor 确认都绿灯了再继续使用。

实战示例： 你发现Claude Code无法执行任何bash命令，每次都提示权限被拒绝。怀疑配置不对，于是输入：

/doctor

检查结果显示：Claude Code缺少对shell的执行权限，建议在 ~/.claude/settings.json 中调整权限设置或者在启动时提供 --allow 参数。根据提示你编辑了 settings.json 增加 Bash(*) 的临时允许配置（或选择更细粒度的安全配置）。再次 /doctor 验证无误后，Claude Code 的 Bash 工具调用恢复正常。

/bug – 反馈 Bug 给官方

定义与语法： /bug 无参数。执行该命令会将当前对话内容打包发送给Anthropic官方用于错误报告。你可以附加一些对错误的描述，Claude Code会将其一并提交。

使用场景： 如果你在使用Claude Code时遇到了明显的Bug（例如命令无响应、崩溃、生成结果与预期大相径庭等），可以使用 /bug 快速向开发团队反馈。相较于手动去GitHub或论坛反馈，/bug 命令省去了复制日志的麻烦。官方收到报告后，能够通过你的对话重现问题（请勿包含敏感信息）。建议在反馈前，尽量用简要描述告诉Claude “我要报告Bug：现象是…”，这样 /bug 会附上你的说明，帮助官方定位问题。

潜在误用与注意： /bug 是面向Anthropic的匿名数据提交，所以切勿在对话中透露公司机密或个人敏感信息然后用此命令发送！虽然Anthropic会承诺合理使用这些数据，但信息安全最好掌握在自己手中。如果问题涉及敏感内容，还是走正式的支持渠道更妥。当你误触 /bug 时可能已经发送了一些对话内容，目前无法撤回，只能尽快联系官方。还有，/bug 不是万应灵药，它只是一种快捷提交途径，并不会即时得到回复或解决，所以报Bug后仍需自行尝试解决当下问题（比如寻求替代方案或社区帮助）。在Claude Code不断更新的beta阶段，欢迎积极提交Bug，但也别滥用把正常咨询当Bug发。

实战示例： 你让Claude生成代码时，它总是在某个文件卡死不回应。怀疑是特定模式下的Bug，于是和Claude对话说明了情况，然后输入：

/bug

Claude Code 回复：“已收集日志并提交Bug报告，非常感谢！”。过了两天，你在更新日志中看到该Bug已被修复。虽然中间你自己也找到了绕过办法，但提交Bug帮助改进了Claude Code的稳健性。

/help – 获取命令帮助列表

定义与语法： /help 无参数。用于列出所有可用斜杠命令及简要说明。相当于一个内置的帮助文档。

使用场景： 当你忘记某个命令名字或用法时，/help 最直接。它会把 Claude Code 当前版本支持的所有斜杠命令都罗列出来，每条附一句简短用途描述。这是比翻阅文档更快的查询方式，尤其离线或不方便浏览网页时。新版本发布后，/help 也能体现新增命令，让你及时了解有无新功能。

潜在误用与提示： /help 本身没有风险，但输出内容可能很多，需要在终端翻页查看。如果命令过多超出屏幕，可配合终端滚动或管道到 less 查看。另外要注意，自定义命令（见下节）通常不会在 /help 列表中列出，或者只列出基础形式。因此不要误以为 /help 没有显示就没有那些功能。例如 /project:... 自定义命令不会一一列举。/help 信息有时比较简略，如果看不懂某条，可以再咨询Claude “这个命令具体怎么用”，Claude通常会进一步解释。总之，/help 是起点而非终点，需要时多利用它快速导航，然后深入了解具体命令用法。

实战示例： 你记得有个命令可以切换编辑模式但不确定名字，于是输入：

/help

Claude Code 输出了一长串命令清单，其中看到 /vim 的描述是“进入vim模式以交替插入和命令模式”。这提醒了你想用的正是 /vim。随即你就可以尝试该命令了。

自定义斜杠命令

除了以上内置命令，Claude Code 还允许用户创建自定义的斜杠命令，以便快捷执行经常使用的提示或任务逻辑。这部分对于高级用户非常有价值。

定义与机制： 自定义命令本质上是一些特殊格式的 Markdown 文件，放置在特定目录下。按照【格式】：

/<prefix>:<command-name> [arguments]

• prefix：project 或 user，决定命令作用域（项目命令仅当前仓库可用，共享给团队；个人命令在所有项目可用，仅自己使用）。
• command-name：对应Markdown文件名（不含 .md），可以使用子目录形成命名空间。
• arguments：可选参数，在命令文件内容中可用 $ARGUMENTS 占位符引用。

创建示例： 假设你想快速让Claude审计代码中的安全问题，而且希望各项目都可用，则可以创建个人命令：在本机 ~/.claude/commands/ 下新建文件 security-review.md，内容写入你经常使用的提示如“请检查此代码的安全漏洞并给出改进建议”。保存后，在Claude Code中任何地方都能通过命令：

/user:security-review

来调用这段提示。Claude会读取该Markdown内容，将其中文字当作你的新提问来执行。如果命令需要参数，比如审查特定Issue号，可以在文件中写 #$ARGUMENTS，使用时 /project:fix-issue 123 Claude会把123填入提示。

使用场景： 自定义命令适合将繁琐提示一句话搞定。比如项目中经常要“优化性能”、“检查代码风格”，那就写成 /project:optimize、/project:lint 等命令，Claude就能随时跑这些特定任务。团队协作时，可以把这些命令文件放入仓库 .claude/commands/ 下供所有人使用，保证大家调用AI工具的一致性。甚至可以结合MCP，让自定义命令去调用外部API完成复杂流程。在Agentic场景下（AI自主多步执行任务），预先设计好自定义命令库会让Claude如虎添翼。

维护建议： 建立自定义命令需要一定成本，所以逐步积累即可，不用一开始就写一堆。先从重复性最高的几个操作入手。编写命令Markdown时尽量简单明了，一句话或几句话说明任务，不要夹杂太多不相干内容。测试确认效果符合预期，再推广使用。另外注意文件名不要与内置命令冲突，也不要在不同命名空间重复，否则Claude可能混淆。对于长期不用的命令可以删除或迁移，以免命令列表过杂。总之，把自定义命令当成你的AI助手小工具库，好钢用在刀刃上。

实战示例： 你的团队有严格的代码格式检查标准，每次提交前都要检查一遍。你创建了 .claude/commands/ 目录，并新建 format-check.md 内容如下：

检查以下代码是否符合我们的风格指南，并列出需要修改的地方：

将此文件提交仓库。以后在Claude Code中，任何人可以进入项目目录，执行：

/project:format-check @src/utils/helpers.js

这里我们把目标文件内容通过 @文件路径 引用嵌入提示。Claude收到命令后，会读取文件内容并根据风格指南给出具体的格式问题列表。这样一个常规任务变成了一条命令，极大方便了持续集成中的人工检查环节。

进阶技巧

善用以上斜杠命令不仅在各自场景下提升效率，更可以串联起来，形成流畅的工作流。下面通过一个实际开发流程，展示如何组合命令完成复杂任务：

场景： 你接手一个新项目，需要先熟悉代码，再开发新功能，最后提交PR并做审查。使用Claude Code，你计划如下操作：

1. **初始化项目记忆：**进入项目目录，启动 Claude Code 后，首先运行 /init 创建 CLAUDE.md 项目指南。这样Claude对项目有基本认识。接着你询问 “> summarize this project”，Claude很快给出代码库概览，得益于刚生成的记忆文件提供的上下文。
2. **配置模型与权限：**你发现默认模型对架构问题思考稍显吃力，于是输入 /model opus 切换到更强大的模型，以更好理解复杂代码结构。接着，在交流中Claude频繁要求运行 npm test 来理解测试失败原因，每次都弹权限请求，你通过 /permissions 将 Bash(npm test:*) 永久允许。此时Claude可以自主多次运行测试指令，帮你找到问题根源。
3. **编写代码与反馈：**在Claude的协助下，你开始编写新功能代码。Claude 直接在终端提议修改文件并执行了编辑。过程中会话变长，你适时使用 /compact "保留新功能相关讨论" 将上下文压缩，让Claude聚焦当前任务。当一个模块修改完成，你又用 /clear 清理对话历史，针对下一个模块重新开始，确保Claude不被上一部分内容干扰。
4. **自定义工具辅助：**你为加快调试，事先写了个个人命令 /user:log-insights 来分析日志错误模式。Claude 在调试遇到复杂日志时，你直接调用 /user:log-insights "NullPointerException"，Claude 执行你预定义的提示，很快定位了多个潜在问题点。这展示了自定义命令在特殊任务中的价值。
5. **提交PR并审查：**代码完成后，你提交了Pull Request。然后在Claude Code中执行 /pr-comments 获取同事反馈评论，逐条阅读。针对未修改的意见，你和Claude讨论改进方案并直接编辑代码。最后调用 /review，Claude 产出一份综合审查报告，确认所有问题都解决了。你根据报告完善PR描述，准备合并。
6. **结束会话：**工作告一段落，你运行 /logout 登出团队账户，Claude Code 显示本次对话用了多少token和哪些模型。你截屏保存费用信息留档。至此，一个完整的工作流在Claude Code的辅助下高效完成。

通过以上步骤可以看到，Claude Code 的斜杠命令贯穿开发全流程：从环境准备、到编码调试、再到收尾复盘，每一步都有相应命令支持。灵活地组合运用这些命令，能把重复繁杂的操作交给AI处理，开发者则专注于高层逻辑，实现真正的人机协作高效编程。

结语

Claude Code 的斜杠命令体系赋予了开发者前所未有的掌控力，可以像使用操作系统命令一样调遣AI助手完成各种任务。从清理上下文的 /clear、节省令牌的 /compact，到初始化项目的 /init、安全管控的 /permissions，再到模型切换 /model、成本检查 /cost 等，每个命令都解决了开发流程中的特定痛点。在实际使用中，我们应当充分利用这些命令来提升效率，同时也要注意避免潜在的误用陷阱，例如谨慎授权、合理清理上下文等。

最后，随着Claude Code不断演进，新的命令和功能还会增加。建议开发者养成使用 /help 查阅的习惯，保持对新工具的好奇心。在掌握本文介绍的技巧后，你完全可以根据自身项目需求，自定义更丰富的命令，与Claude形成默契的合作关系。让AI做擅长的琐事，让你专注创造的乐趣——这正是Claude Code斜杠命令设计的初心和愿景。相信经过一段时间实践，你也会发现：高效编程，可以如此优雅而有趣！

参考资料： 本文内容基于官方文档和实践经验整理等，希望对你深入掌握 Claude Code 有所帮助。如需了解更详细的配置和案例，可查阅 Anthropic 发布的相关文档和社区分享。Happy Coding!