最近好几个朋友都在问同一个问题:Claude Code 里敲 /buddy 命令,结果终端直接给你来一句“command not found”,或者干脆提示 skill 没加载。明明前几天还用得好好的,怎么说失效就失效了?我一开始也以为是自己的配置出了问题,折腾了两天之后发现,这其实是个很典型的功能恢复问题,不只我一个人遇到,网上相关的讨论也炸了锅。聊到后面,大家甚至把“正常能跑 /buddy”戏称为解锁了“金色传说”——意思是你把这套命令链路彻底搞明白了,那种顺滑感确实值得高兴。
这篇文章我就围绕 /buddy 命令失效这件事,把为什么会出现、怎么排查、怎么恢复、以及如何进一步玩出花样的完整流程写清楚。文章里给的方案都是我自己实测过的,能直接在命令行、桌面端或者 VS Code 插件环境里操作。无论你是刚装好 Claude Code 的新手,还是已经用了挺久的开发者,只要你需要 /buddy 这种“配对编程搭子”能力,这篇都值得你花十分钟读完。
1. 先弄明白:/buddy命令到底是什么
1.1 它从哪里来
很多第一次接触 /buddy 的朋友会以为它是 Claude Code 内置的原生命令,其实不是。准确来说,它通常是通过自定义 skill 或 slash command 的方式注册进 Claude Code 的。
我在自己的环境里用到的 /buddy,本质上是一个 skill 目录,目录里放了一个 SKILL.md 文件,里面用 Markdown 描述了“我是一个结对编程伙伴,负责帮我审查代码、跑测试、提出重构建议”这类角色设定。当你在对话中输入 /buddy 时,Claude Code 会在技能目录里匹配到这个指令,然后把这个 Markdown 里的描述注入到当前对话上下文中,AI 接着就以“buddy”的角色开始工作了。
所以你能这么理解:/buddy 不是程序自带的魔法,而是一份能被 Claude Code 识别并加载的“角色设定文档”。这也就解释了为什么它经常会无缘无故“消失”——只要这个文档的位置变了、格式错了,或者被新版本扫描逻辑漏掉了,命令就失效了。
1.2 为什么叫“金色传说”
“金色传说”这个说法最早是怎么来的,我没仔细考证过,但用过的人应该都有体会:当你把 /buddy 调通、让它成功以“伙伴”身份接管对话之后,那种体验确实和普通模式不一样。
普通模式下,AI 更像一个“答题机器”:你问一句,它答一句。但 /buddy 模式下,它会主动看你的代码结构、主动提醒你测试可能漏了边界条件、主动在重构时给出分步建议。再加上 Claude 本身对代码上下文的理解能力很强,一旦配上这个角色设定,你就会感觉好像真有一个经验丰富的老同事坐在旁边。
所以大家把“/buddy 能正常用”比作“解锁金色传说”,不是没有道理的。它代表的是:你的环境配置完整、技能加载正常、角色提示词生效、模型也接对了。这几样缺一样,命令就起不来。而绝大多数失效问题,往往就卡在这几项中的某一项上。
2. 命令失效的真相:不是玄学,是配置在捣鬼
2.1 版本更新把你的自定义命令清掉了
我自己遇到的第一次失效,是 Clued Code CLI 自动更新之后发生的。那天我像往常一样打开终端输入 claude,然后习惯性敲 /buddy,结果提示说找不到这个命令。
当时我第一反应是“是不是我技能目录被删了?”但打开配置目录一看,SKILL.md 还躺在那儿。后来翻了半天才发现,新版本的 Claude Code 对 skill 目录的扫描逻辑做了调整:它开始要求 skill 目录下必须有特定的元信息结构,如果仅有一个 SKILL.md,不会自动加载,还会在日志里静默跳过。
这类问题最坑人的地方在于:它不报错,只是把你的功能静默屏蔽了。 你如果不去翻 verbose 日志,根本不知道发生了什么。所以排查 /buddy 失效问题时,我建议第一步就去看版本号,不要凭“我以前能用”来做判断。
2.2 配置路径和权限的坑
第二个特别容易踩的坑是路径问题。有段时间我为了图方便,直接在公司电脑上 clone
