1. 为什么你的 Claude Code 需要一个“小迷妹”Claude Code 本身是个很克制的工具你问它答你不问它就不说话。写代码的时候它安安静静提交完代码它也不会多看你一眼。但如果你希望它在你git commit成功之后主动夸你一句在你深夜还在改 bug 的时候提醒你休息甚至在你输入/fangirl的时候切换成一种更活泼的对话风格——这就需要给它装一套“人格化插件”。这套插件机制由三个部分组成Skill负责定义“小迷妹”的能力和说话方式Hooks负责在特定事件比如提交、测试通过、文件保存触发时自动执行动作Commands负责提供手动调用的快捷入口比如/fangirl。三者组合起来Claude Code 就不再只是一个冷冰冰的代码助手而是一个会主动打招呼、会看场合说话的“小迷妹”。这篇文章面向想让 Claude Code 具备个性化自动响应能力的开发者。我会给出可复制的 Skill 目录结构、Hooks 配置片段和 Commands 定义骨架并说明在 Claude Code 中加载验证的具体动作。你不需要改 Claude Code 的源码也不需要写复杂的插件框架只需要按目录放文件、按格式写配置就能搭出一个会主动打招呼的插件。如果你还没有可用的模型调用环境可以先通过 TaoToken 获取 API Key再配合 Claude Code 使用。TaoToken 提供统一的模型接入能力适合在本地开发环境中快速验证插件效果。下面先从环境准备开始。2. TaoToken 前置准备拿到可用的 API KeyClaude Code 的插件机制本身不依赖特定模型服务但你要让 Skill 和 Hooks 真正跑起来需要一个能调用的模型接口。TaoToken 的接入方式比较直接注册后在控制台创建 API Key然后在 Claude Code 的配置里指向对应的 API 地址。第一步打开 TaoToken 官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content完成账号注册。注册流程不复杂邮箱验证后就能进入控制台。第二步进入控制台创建 API Key。地址是https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite。在 API Keys 页面点击创建复制生成的 Key格式通常是一串以sk-开头的字符串。这个 Key 只显示一次建议先存到本地密码管理器里。第三步如果你需要查看接入文档可以访问https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite。文档里会说明 API 的基础地址和兼容格式。TaoToken 的 API 入口是https://taotoken.net/api注意这个地址不带 UTM 参数直接用于代码里的base_url配置。第四步在 Claude Code 的环境变量或配置文件中设置 API Key。通常 Claude Code 会读取ANTHROPIC_API_KEY或类似的变量。如果你用的是兼容 Anthropic 协议的方式可以把base_url指向 TaoToken 的 API 地址把 Key 填进去。具体配置方式取决于你使用的 Claude Code 版本建议先跑通一次普通对话确认模型能正常响应再继续装插件。注意API Key 不要硬编码在会提交到 Git 的文件里。建议用.env文件或系统环境变量管理.env要加入.gitignore。完成这一步后你应该已经能在 Claude Code 里正常对话了。接下来进入插件目录的搭建。3. 可复制配置Skill 目录、Hooks 片段与 Commands 骨架3.1 Skill 目录结构Claude Code 的 Skill 本质上是一个带SKILL.md的目录。SKILL.md里用自然语言描述这个 Skill 的用途、触发条件和行为风格。下面是一个“小迷妹”Skill 的最小目录结构~/.claude/skills/oh-my-fangirl/ ├── SKILL.md ├── hooks/ │ └── hooks.json └── commands/ └── fangirl.mdSKILL.md是核心文件内容大致如下--- name: fangirl description: 一个会主动打招呼、在特定事件后给出鼓励的对话风格插件 --- # Fangirl Skill 当用户触发 fangirl 或相关关键词时切换到活泼、鼓励式的对话风格。 ## 行为规则 - 在 git commit 成功后主动说一句鼓励的话 - 在测试全部通过后用轻松的语气祝贺 - 在深夜本地时间 23:00 - 05:00检测到用户仍在编码时提醒休息 - 保持简短不要打断正常的技术讨论 ## 触发词 - /fangirl - 彩虹屁 - 夸夸我 - 切换模式这个文件不需要复杂的语法Claude Code 会读取其中的描述来决定何时加载这个 Skill。name字段要和目录名一致方便后续引用。3.2 Hooks 配置片段Hooks 是让“小迷妹”主动说话的关键。Claude Code 支持在特定事件前后执行命令或注入提示。下面是一个hooks.json示例放在~/.claude/skills/oh-my-fangirl/hooks/hooks.json{ hooks: { PostToolUse: [ { matcher: Bash, hooks: [ { type: command, command: echo 检测到命令执行完成如果包含 git commit 或测试通过请用 fangirl 风格说一句鼓励的话 } ] } ], UserPromptSubmit: [ { hooks: [ { type: command, command: echo 如果用户输入包含 /fangirl 或 夸夸我请切换到 fangirl 模式 } ] } ] } }这个配置的意思是当 Bash 工具执行完成后向 Claude Code 注入一段提示让它判断是否需要以“小迷妹”风格回应当用户提交提示词时检测是否包含触发词。实际使用时你可以把command换成更复杂的脚本比如读取git log判断最近一次提交是否成功或者检查测试输出里是否有PASS。但建议先从简单的echo开始确认 Hooks 能被触发再逐步加逻辑。3.3 Commands 定义骨架Commands 提供手动入口。在~/.claude/skills/oh-my-fangirl/commands/fangirl.md里写入--- description: 切换到小迷妹模式 --- 请切换到 fangirl 模式。接下来用活泼、鼓励的语气回应但不要影响技术内容的准确性。 如果用户说“退出”或“正常模式”则恢复默认风格。这个文件定义了一个/fangirl命令。当你在 Claude Code 里输入/fangirl时它会加载这段提示让模型切换风格。三个部分组合起来目录结构就是~/.claude/skills/oh-my-fangirl/ ├── SKILL.md ├── hooks/ │ └── hooks.json └── commands/ └── fangirl.md如果你用的是项目级配置可以把~/.claude/skills/换成项目根目录下的.claude/skills/。项目级配置只对当前项目生效适合团队共享用户级配置对所有项目生效适合个人使用。4. 验证请求与成功结果配置写完后需要验证插件是否被正确加载。按下面三步操作第一步完全退出 Claude Code 再重新打开。插件机制通常在启动时加载热重载不一定生效。如果你用的是终端里的claude命令直接CtrlC退出后重新运行。第二步输入/fangirl观察是否切换到“小迷妹”风格。如果命令列表里能看到fangirl说明 Commands 加载成功。如果输入后没有反应检查commands/fangirl.md的路径和文件名是否正确。第三步执行一次git commit然后看 Claude Code 是否主动说话。比如你先改一个文件然后让 Claude Code 执行git add . git commit -m test: trigger fangirl hook如果 Hooks 配置生效Claude Code 应该在命令执行完成后用“小迷妹”风格说一句鼓励的话。如果没有反应先检查hooks.json的 JSON 格式是否合法可以用python -m json.tool hooks.json验证。一个成功的验证结果大致是这样的你输入/fangirlClaude Code 回复“好呀我切过来啦今天想写点什么”你提交代码后它说“提交成功你又离目标近了一步真棒。”如果达到这个效果说明 Skill、Hooks、Commands 三个部分都跑通了。如果你在验证模型响应是否正常时遇到问题可以先用 TaoToken 的模型对话功能单独测试 API Key 是否可用地址是https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite。确认模型能正常返回后再回到 Claude Code 排查插件配置。5. 本篇常见错排查5.1 Skill 不加载目录名和 name 不一致最常见的问题是SKILL.md里的name字段和目录名不一致。比如目录叫oh-my-fangirl但name写成了fangirl。Claude Code 在加载时可能按目录名索引导致找不到 Skill。解决方法是让两者保持一致或者统一用fangirl作为目录名和 name。5.2 Hooks 不触发matcher 写错或事件名不对Hooks 的matcher字段需要匹配工具名。比如你想在 Bash 命令后触发matcher要写Bash而不是bash或Shell。事件名也要区分大小写PostToolUse和postToolUse是不同的。建议先只配一个最简单的UserPromptSubmitHook确认能触发后再加PostToolUse。5.3 Commands 不显示文件扩展名或 frontmatter 格式错误Commands 文件必须是.md结尾并且 frontmatter 要用---包裹。如果description字段缺失有些版本的 Claude Code 可能不会在命令列表中显示。另外命令名来自文件名fangirl.md对应/fangirl不要写成fangirl-command.md。5.4 模型无响应API Key 或 base_url 配置错误如果 Claude Code 完全无法对话先检查 API Key 是否有效、base_url是否指向正确的地址。TaoToken 的 API 地址是https://taotoken.net/api不要多加路径或斜杠。如果用的是环境变量确认变量名和 Claude Code 读取的一致。可以在终端里echo $ANTHROPIC_API_KEY看是否为空。5.5 风格切换后不恢复缺少退出指令“小迷妹”模式如果一直不退出可能会影响正常的技术讨论。建议在fangirl.md里明确写“如果用户说退出或正常模式则恢复默认风格”。另外可以在 Skill 的行为规则里加一条“技术问题优先保证准确性风格只影响语气不影响内容”。6. 长期编码与 Agent 场景的接入建议如果你只是偶尔用 Claude Code 写写脚本上面这套配置已经够用了。但如果你打算长期用它做项目开发或者把它接入自动化 Agent 流程建议把插件配置和 API 调用分开管理。插件部分放在~/.claude/skills/或项目.claude/skills/里用 Git 管理版本。API Key 和 base_url 放在环境变量或.env里不要提交到仓库。如果你需要更稳定的调用额度可以了解 TaoToken 的 Coding Plan地址是https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite。它适合长期编码和 Agent 场景能减少频繁切换 Key 的麻烦。另外如果你用的是 Claude Code 的 Anthropic 兼容模式可以参考https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_codeutm_campaignrewrite里的配置说明。把 API 入口和插件目录都配好之后你的 Claude Code 就不只是一个代码工具而是一个会看场合说话、会在你提交代码后主动鼓励你的“小迷妹”。最后提醒一点Hooks 里执行的命令要控制好权限不要在里面跑来源不明的脚本。插件机制本身是为了提升体验安全边界还是要自己守住。