Claude-code 插件 Hookify 配 TaoToken：settings.json 骨架与 Hooks 验证

1. 为什么要在 Claude-code 里给 Hookify 配统一通道Claude-code 的 Hookify 插件解决的是一个很具体的问题原生 Hooks 要手写 JSON事件、匹配器、命令三段结构一旦嵌套深了改起来容易漏字段。Hookify 把规则换成.claude/hookify.{规则名}.local.md这种 YAML frontmatter Markdown 的形式写一条「bash 里出现 rm -rf 就拦下来」的规则比翻 settings.json 快得多。它支持 bash、file、stop、prompt、all 这几类事件action 可选 block 或 warn适合做危险命令拦截、调试代码提醒、提交前格式化这类护栏。但插件本身只管规则触发不管模型请求走哪条链路。当你在本地同时跑多个项目、每个项目又各自配 Key 时Hooks 触发后的模型调用会散落在不同配置里排查一次「规则到底有没有生效」要翻好几处。把 Claude-code 的请求统一收敛到 TaoToken 的 API 通道好处是 Key 只有一份、调用日志集中、Hooks 触发后的链路可观测。这篇就按这个场景给出可复制的 settings.json 骨架再用 Hookify 的 Hooks 做一次触发验证确认插件加载和调用链路都符合预期。适合谁已经在用 Claude-code、想给 Hookify 规则接统一 Key 的开发者或者刚装完 Hookify想确认它到底有没有被 Claude-code 正确加载的人。下面所有配置都可以直接抄路径按你自己的项目改。2. TaoToken 前置Key、通道与项目目录准备TaoToken 在这里扮演的是统一 API 通道的角色Claude-code 通过它发起模型请求你只需要维护一份 Key。开始之前先把三样东西准备好。第一是 API Key。到控制台的 API Keys 页面创建一个复制出来先放临时位置后面要写进配置。地址是 https://taotoken.net/api-keys 注意这个页面不要带多余参数直接访问即可。第二是确认 API 基址。TaoToken 的 API 入口是 https://taotoken.net/api Claude-code 的 base_url 要指向它。如果你用的是 Anthropic 兼容协议路径拼接方式按官方文档来别自己猜。第三是项目目录结构。Hookify 的规则文件放在项目根目录的.claude/下命名格式是hookify.{规则名}.local.md。Claude-code 的 settings.json 一般也在.claude/里或者放在用户级配置目录。我建议项目级和用户级分开项目级放 Hookify 规则用户级放 API 通道配置这样换项目不用重配 Key。提示.claude/目录建议加进.gitignore规则文件里可能带路径信息Key 更不能进版本库。装 Hookify 用官方插件命令/plugin install hookifyclaude-plugins-official装完用/hookify:list看一眼能列出规则说明插件已加载。如果这条命令没反应先别急着配 settings.json回到第 5 节排查插件加载问题。3. 可复制的 settings.json 骨架Claude-code 的 settings.json 结构分几块模型通道、权限、Hooks。下面这份骨架把 TaoToken 通道和 Hookify 需要的 Hooks 入口都留好了你替换 Key 和路径就能用。{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoTokenKey, ANTHROPIC_MODEL: claude-sonnet-4-20250514 }, permissions: { allow: [ Bash(git status), Bash(git diff:*), Read ], deny: [ Bash(rm -rf:*), Bash(curl:* | sh) ] }, hooks: { PreToolUse: [ { matcher: Bash, hooks: [ { type: command, command: echo \[hookify] pre-bash check\ } ] } ], PostToolUse: [ { matcher: Edit|Write, hooks: [ { type: command, command: echo \[hookify] post-file check\ } ] } ] } }几个字段说明一下。env里的ANTHROPIC_BASE_URL指向 TaoToken 的 API 入口ANTHROPIC_API_KEY填你刚创建的 Key。permissions.deny是 Claude-code 自带的权限拦截和 Hookify 的 block 是两层保险建议都留着。hooks里的PreToolUse和PostToolUse是原生 Hooks 的挂载点Hookify 的规则最终也会落到这些事件上这里先放 echo 命令是为了验证 Hooks 通道本身通不通。如果你想让 Hookify 的规则文件接管拦截逻辑原生hooks里可以只留一个探针命令真正的 block/warn 交给.claude/hookify.*.local.md。两种方式不冲突但别在同一个事件上写重复规则否则一次 Bash 调用会触发两次提示日志看起来会乱。配置放哪项目级放项目根/.claude/settings.json用户级放~/.claude/settings.json。项目级优先级更高调试阶段建议先用项目级改完立刻能看到效果。4. 写一条 Hookify 规则并验证触发配置骨架就位后写一条最小规则来验证整条链路。在项目根目录建.claude/hookify.block-dangerous-rm.local.md--- name: block-dangerous-rm enabled: true event: bash pattern: rm\s-rf action: block --- Dangerous rm command detected. Verify the path and confirm backups exist before retrying.这条规则的意思是bash 事件里匹配到rm -rf就 block。pattern是正则rm\s-rf能匹配rm -rf、rm -rf这类写法。action选 block 会直接拦下命令选 warn 只提示不拦。验证分三步。第一步确认规则被识别/hookify:list输出里应该能看到block-dangerous-rm状态 enabled。如果没出现检查文件名格式和 frontmatter 的---是否闭合。第二步触发一次。在 Claude-code 里让它执行一条包含rm -rf的命令比如rm -rf /tmp/hookify-test-dir预期结果是命令被拦下并显示规则里的提示文本。如果命令照常执行了说明规则没生效回到第 5 节。第三步看调用链路。规则触发后Claude-code 会向 TaoToken 通道发一次请求来生成提示或决策。你可以在 TaoToken 控制台的调用记录里看到这次请求的时间、模型和状态码。这一步是整篇的关键它同时验证了 Hookify 规则加载、Hooks 事件触发、以及 API 通道连通三件事。三样都对上说明配置是通的。再补一条 file 事件的规则验证多事件类型--- name: warn-debug-code enabled: true event: file pattern: console\.log\(|debugger; action: warn --- Debug code detected. Remove before committing.保存后编辑一个含console.log的文件应该看到 warn 提示但不阻断写入。block 和 warn 的差别在这里能直观感受到。5. 本篇常见错排查插件没加载/hookify:list报未知命令。先确认/plugin install hookifyclaude-plugins-official执行成功再检查 Claude-code 版本是否支持插件系统。装完最好重启一次会话。规则文件不生效文件名必须是hookify.{规则名}.local.md放在项目根的.claude/下。frontmatter 的---要成对event和pattern拼写别错。enabled: true不能漏。Hooks 不触发settings.json 里hooks的 matcher 写的是工具名Bash 事件对应Bash文件事件对应Edit|Write。matcher 写错事件就不会进来。改完 settings.json 要重启 Claude-code 会话。API 请求 401Key 没填对或者ANTHROPIC_BASE_URL末尾多了斜杠。基址就用https://taotoken.net/api别自己拼路径。Key 去 https://taotoken.net/api-keys 重新复制一次注意别带空格。请求超时先确认网络能访问 TaoToken 的 API 入口再看模型名是否写对。ANTHROPIC_MODEL填错会返回模型不存在不是超时两者要分清。规则触发两次原生hooks和 Hookify 规则同时匹配了同一事件。把原生 hooks 里的探针命令去掉或者把 Hookify 规则的 event 收窄。block 没拦住action写成了warn或者 pattern 正则没匹配上。用rm\s-rf这种宽松写法先测通再收紧。排查顺序建议从插件加载开始再到规则文件最后到 API 通道。链路是一层层往下的跳步容易误判。6. 把通道和规则固定下来验证通过后把配置固化项目级 settings.json 提交到仓库Key 用环境变量注入别硬编码Hookify 规则文件按团队约定命名.claude/里只保留.local.md规则和 settings 模板。Key 统一从 TaoToken 控制台管理换 Key 只改一处。长期跑编码任务或 Agent 的话可以看下 Coding Plan把额度规划好避免规则触发频繁时请求被限。地址是 https://taotoken.net/coding-plan 。接入细节和协议兼容问题文档里有完整说明https://taotoken.net/doc 。想先手动验证模型响应用模型对话页面发一条测试请求最快https://taotoken.net/chat 。我自己的习惯是每加一条 Hookify 规则就用/hookify:list确认一次再手动触发一次最后去 TaoToken 调用记录里核对。三步走完规则才算真正上线。