Claude Code 斜杠命令怎么写,从第一条到一套命令库
同一类任务,你第八次对 Claude Code 敲那段话,这次少写了一句边界,它就顺手把你没让动的文件改了,下次又漏掉了测试。你开始怀疑模型不行,换个模型重说一遍,折腾半天还是老样子。
问题多半不在模型笨,在你每次口述的边界都不完全一样。少写一句,它就按自己的理解补,补的方向每次还不同。
斜杠命令(Slash Commands)就是治这个的,把一段高频提示词存成命令文件,输入 /命令名 一次调用,还能传参数、跑 bash、引文件。这篇按 FDE 的交付视角,把该不该写、第一条怎么落、四大语法、命令库怎么长大、坑在哪,一次讲完。
先判断你该不该写命令
判断口诀就一句,一段提示词重复三次以上、边界稳定,才值得写成命令。每天只说一次的临时需求不值得,每周都要重复的检查、整理、发布前验证、生成摘要,才配拥有一条命令。
对号入座看一下起点。刚装好 Claude Code 还在熟悉对话的,先别写命令,用普通对话跑两周,把反复说的话记下来。已经在重复说同一类任务的,写一条只读低风险的检查类命令练手。团队里多人跑同一套流程的,直接写项目级命令提交 git,全队共用一个口径。命令已经超过十条有点乱的,用子目录按场景分组,顺手删掉不稳定的。
老雷的建议是动手前先攒一周复用记录,把说过三遍以上的话圈出来,那就是你的第一批命令候选。新手最常见的错误反过来,一上来写一堆命令,结果连一个重复动作都还没跑顺。命令的价值在被反复复用,不在数量。
第一条命令,五分钟落地
定义一句话,把一段提示词写成 markdown 文件,存进 Claude Code 的约定目录,输入 /文件名 就能整段调用,命令名直接取文件名去掉扩展名。
最简版本一分钟就能跑通。新建 ~/.claude/commands/changelog.md,正文只写一行,把当前未提交的改动总结成三条要点,并指出其中有风险的地方,比如缺错误处理、写死的值、需要更新的测试。存好,在 Claude Code 里输入 /changelog,它就按这段说明去做。一个文件一行字,就是一条能用的命令。
存哪有讲究,只有两级。个人级放 ~/.claude/commands/,你的所有项目都能用,不随项目共享,适合提交信息模板、代码审查清单这类跨项目通用的东西。项目级放项目根的 .claude/commands/,只在当前项目生效,提交 git 之后全队共享,适合本项目发布前检查、特定模块重构这类专属流程。判断标准,跨项目都想用的放个人级,只在这个项目用还想让队友用的放项目级。接手别人的项目,先翻一眼项目根的 .claude/commands/,能快速读懂这个项目约定了哪些标准动作。两条都用的注意别混,项目专属命令塞进个人级,它会出现在每个无关项目的菜单里,纯污染。
补一个 2026 年的现状,Claude Code 已经把自定义命令并进了 skills 体系,.claude/skills/deploy/SKILL.md 和 .claude/commands/deploy.md 都会创建 /deploy,行为一样,已有的命令文件继续可用、支持相同的配置头。按 .claude/commands/ 的写法上手完全没问题,等你想给一条命令带支持文件、或让它在合适时机自动触发,再去学 skills 形式不迟。
还有个误区要拆掉,命令文件不是给 Claude Code 装插件,也不是会自动后台运行的脚本。说到底它还是提示词,只是被存下来、加了名字、能传参数。它也不替你判断任务该不该做,里面写了什么、放行了哪些工具,才决定它的边界。

四大语法,把死模板变活
配置头、传参、跑 bash、引文件,四个语法半小时能记完。
配置头(frontmatter)是文件顶部用三道横线包起来的一段配置,新手先用三个字段就够。description 写命令描述,显示在 / 菜单里,也帮 Claude 判断什么时候该自动调用。argument-hint 写参数提示,输入命令名时补全菜单会提醒你该补什么。allowed-tools 写这条命令免确认放行的工具,比如只给 Read 和 Grep,意思是它只读不改。其余字段等用熟了再加,特别是 model 字段别手贱把模型版本号写死,模型名会更新,写死的版本号过一阵就成了过期信息,别问老雷是怎么知道的。
传参用 $ARGUMENTS 系列占位。命令名后面跟的文字会原样填进去,$ARGUMENTS 拿全部参数组成的整串,$0、$1、$2 按位置取,索引从零开始。跑 /fix-issue 123 紧急,$0 就是 123,$1 就是紧急。注意含空格的参数要加引号,不然会被按空格拆开对错位置。
跑 bash 是最被低估的一个。命令文件里以感叹号开头、用反引号包起来的命令,会在 Claude 看到提示词之前先执行,输出替换那一行塞进提示词,这是预处理,Claude 只看到最终结果。比如总结改动的命令里写一行 git diff HEAD 的预处理,每次执行它都先读你此刻真实的 diff 再总结,比一句空泛的「总结我的改动」靠谱得多,前者每次基于真实状态,后者全靠猜。两个要点,跑 bash 要在 allowed-tools 里放行对应命令,比如 Bash(git diff *),否则被权限拦下;感叹号只有在行首才被识别,多行 bash 用围栏代码块包起来。
引文件用 @ 符号加路径,@README.md 引一个文件,@src/components/ 引整个目录,@加网址拉取网页内容,不用复制粘贴。它还能和参数组合,审查命令里写 @$0,运行时你传哪个文件路径,它就把哪个文件的内容塞进上下文。
四个语法串起来是一条能直接抄的完整命令。个人级的 changelog 命令,配置头写清描述、参数提示,allowed-tools 放行 git diff 和 git status;正文分三段,先用预处理行把真实改动读进来,再用 @ 引入团队的变更记录格式文件当约定,然后 $ARGUMENTS 留个口子让你运行时补一句临时说明。末尾再加两句边界,只总结不修改任何文件,没有未提交改动时直接说明。
这里有个多数人想反了的地方。
真正决定一条命令好不好用的,不是语法,是末尾那两句边界。语法只是把边界送进去的管道,写清失败路径和禁止动作,命令在真实项目里才不会乱来。

命令库怎么长,从一条到一套
命令库不是规划出来的,是按风险从低到高自然长出来的。
从一条检查类命令起步,只读、不改文件,发布前清单检查、依赖风险扫描、文章结构检查都算,风险最低、输出好验收,最适合练手。跑顺了加摘要类,把本轮改动总结成发布记录、把一个目录的任务状态整理成短报告,这类命令练的是写清输出格式,要求它只输出结论、路径、下一步,别展开成长文。执行类压轴,会改文件会跑命令的,边界要写得最窄,工作目录、允许改的文件范围、必须保留的用户改动、失败时是否停止,一条条写明。
组织方式跟着数量走,前五条平铺在 .claude/commands/ 下最直观,超过十条再按场景建子目录,git、refactor、test、deploy、db 各归各的,补全菜单会分类显示,团队里不同模块负责人各管一组。命名要朴素,article-check、release-notes、test-summary 这种名字直接说明用途,别起抽象名字,三个月后你自己也看不懂。
成熟与否有个很实在的信号,当你愿意在真实任务里直接调用它、不再每次重新解释,它就成熟了。反过来每次运行前都要补一堆说明的,还只是半成品提示词。用过几次发现不稳定、低频、边界说不清的,删掉或合并,命令库里堆了多少条不说明问题,值得反复用的有几条才说明问题。
外部能力走 MCP 命令,格式固定为 /mcp服务器名提示名,双下划线分隔,连上服务器命令就出现,断开就消失,用 /mcp 管理连接。它和你自己写的命令不是二选一,MCP 命令是别人封装好的外部能力一键调用,自定义命令是你自己工作流的沉淀,两者并存最实用。
五个坑和验收清单
老雷给大家提个醒,新手栽跟头基本都在这五处。
一条命令塞太多职责,又想检查又想修改又想发布,结果每次都要人盯着,拆小,检查归检查、发布前确认归发布前确认。把命令当权限放大器,命令只是入口,绕不过确认,涉及删除、发布、授权、付款、线上配置的动作,即使写进命令也要明确要求停下来等确认。写一堆判断口号不落到动作,真正有用的判断必须落到哪个文件改、哪个命令跑、哪个结果算通过。参数设计太自由,参数越多出错概率越大,从一个参数起步,等命令稳定再加第二个。不写失败路径,检查发现信息不完整是停下报告还是继续查,没有 git 仓库时怎么办,都写进命令,否则它会在真实任务里开始猜,猜得越多越要人盯着。
写完对照这张清单勾一遍。文件存对位置了吗,通用进个人级、专属进项目级。写清适合和不适合的任务了吗。写清要补什么输入了吗,用 argument-hint 提示。危险动作要求停下确认了吗。工具权限收窄到够用就够了吗。真实任务里跑过了吗。同一件事连跑三次,结果一致吗。
压轴那条是硬验收,同一件事连跑三次结果稳定,命令才算成熟。每次都要你补大量说明,说明边界还没写清,回去继续改命令文件,别把问题推给模型。
命令不是魔法,是把你已经成熟的工作方式保存下来。流程还没想清之前先别急着命令化,一段提示词反复说了三次、边界又稳定,就存成命令,之后你的注意力会从怎么跟 AI 解释,转回我要检查什么、交付什么、哪里不能碰。这也是老雷AI实验室一直强调的路数,把显式流程写进文件,把临场发挥挡在门外。
第一条命令从检查类写起,只读、不改文件、风险低,还能立刻验证你有没有把命令设计清楚。等检查和摘要类跑稳了,再去碰会改文件的执行类不迟。
