1. 为什么要在 Claude Code 里折腾 hooksClaude Code 的 hooks 机制说白了就是给 Agent 循环装几个「挂钩」用户提交输入后、工具执行前、工具执行后、任务收尾时各留一个固定插槽。你想加日志、加权限校验、加输出体积告警都往插槽上挂不用去改主循环。这个设计在官方文档里叫 hooks在社区里常被拿来和「中间件」「事件总线」类比本质是一回事。我这次要解决的具体问题是本地跑 Claude Code 时模型调用通道和 Key 管理太散。每个项目一份配置换台机器就要重新填一遍hooks 里想加个「调用前打印当前通道」的日志都无从下手。所以这一章的目标很明确——把 hooks 的事件声明写进settings.json同时用 TaoToken 统一 Key 和 API 通道让 hooks 触发的每一条命令都走同一条链路。适合谁看已经在用 Claude Code、想把手动配置沉淀成工程化骨架的人或者刚接触 hooks、想知道settings.json里到底能写什么的人。下面给的配置骨架可以直接复制改两个环境变量就能跑。2. TaoToken 前置Key 与通道怎么统一TaoToken 在这里扮演的角色是「统一入口」你不需要在每个项目的 hooks 脚本里硬编码不同的 Key而是把 Key 和 API 地址收敛到环境变量settings.json只引用变量名。这样 hooks 触发的命令、Claude Code 本身的模型请求走的是同一套凭证。先拿 Key。打开控制台在 API Keys 页面创建一个新 Key复制出来。地址是https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite创建完 Key 之后把它写进 shell 的环境变量。macOS / Linux 用~/.zshrc或~/.bashrcWindows 用系统环境变量面板。我习惯这样写export TAOTOKEN_API_KEYsk-你的Key export TAOTOKEN_BASE_URLhttps://taotoken.net/api注意TAOTOKEN_BASE_URL后面不带 UTM 参数API 调用地址就是干净的https://taotoken.net/api。UTM 只加在给人点的链接上别混进代码里否则某些客户端会把查询串当成路径的一部分。如果你用的是 Claude Code 的 Anthropic 兼容模式还需要一个指向文档的参考页配置字段名以它为准https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite环境变量设好之后开一个新终端echo $TAOTOKEN_API_KEY确认能打印出来。这一步没做对后面 hooks 里所有命令都会报鉴权失败排查起来很浪费时间。3. 可复制的 settings.json hooks 配置骨架Claude Code 的settings.json一般放在项目根目录的.claude/下或者用户级的~/.claude/settings.json。hooks 字段的结构是「事件名 → 匹配器 → 命令数组」。下面这份骨架我实测能跑事件覆盖了UserPromptSubmit、PreToolUse、PostToolUse、Stop四个节点。{ hooks: { UserPromptSubmit: [ { hooks: [ { type: command, command: echo \[HOOK] UserPromptSubmit: cwd$(pwd) channel$TAOTOKEN_BASE_URL\ } ] } ], PreToolUse: [ { matcher: Bash, hooks: [ { type: command, command: echo \[HOOK] PreToolUse Bash: $CLAUDE_TOOL_INPUT\ } ] } ], PostToolUse: [ { matcher: Bash, hooks: [ { type: command, command: echo \[HOOK] PostToolUse Bash done\ } ] } ], Stop: [ { hooks: [ { type: command, command: echo \[HOOK] Stop: session finished\ } ] } ] } }几个关键点解释一下。matcher用来限定工具名比如只对Bash生效不写就匹配所有工具。type目前主要是command表示执行一条 shell 命令。命令里可以直接引用环境变量所以$TAOTOKEN_BASE_URL会被展开成你前面设的地址这样 hooks 日志里就能看到当前走的是哪条通道。如果你想让 hooks 触发的命令也走 TaoToken 的模型调用比如在PreToolUse里做一次轻量的意图判断可以再包一层脚本#!/usr/bin/env bash # .claude/hooks/pre_check.sh set -euo pipefail payload${CLAUDE_TOOL_INPUT:-} echo [HOOK] checking tool input via $TAOTOKEN_BASE_URL curl -sS $TAOTOKEN_BASE_URL/v1/messages \ -H x-api-key: $TAOTOKEN_API_KEY \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d {\model\:\claude-3-5-sonnet-latest\,\max_tokens\:64,\messages\:[{\role\:\user\,\content\:\判断以下工具调用是否安全只回 safe 或 unsafe$payload\}]}然后在settings.json里把command换成bash .claude/hooks/pre_check.sh。这样 hooks 和主循环共用同一套 Key 与通道不用维护两份凭证。4. 验证请求与 hook 执行结果配置写完先做一次最小验证确认 hooks 真的被触发且请求链路能通。第一步在项目根目录启动 Claude Code随便输入一句列出当前目录。你应该在终端看到类似输出[HOOK] UserPromptSubmit: cwd/Users/you/project channelhttps://taotoken.net/api这说明UserPromptSubmit事件被触发环境变量也正确展开。如果channel后面是空的回去检查TAOTOKEN_BASE_URL有没有 export 成功。第二步触发一次工具调用比如让它读取 README.md。这时PreToolUse和PostToolUse应该依次打印[HOOK] PreToolUse Bash: {command:cat README.md} [HOOK] PostToolUse Bash done第三步验证模型请求本身走的是 TaoToken。单独跑一次 curl确认返回结构正常curl -sS $TAOTOKEN_BASE_URL/v1/messages \ -H x-api-key: $TAOTOKEN_API_KEY \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d {model:claude-3-5-sonnet-latest,max_tokens:32,messages:[{role:user,content:ping}]}返回里能看到content数组和usage字段就说明 Key 和通道都没问题。这一步过了hooks 里再调模型就是同一套链路不会出现「主循环能跑、hooks 报 401」的割裂情况。想直接在网页里对比模型输出可以用模型对话页https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite5. 本篇常见错排查报错一command not found: $TAOTOKEN_BASE_URL或变量为空。原因是 hooks 命令执行时的 shell 没有加载你的~/.zshrc。解决办法是在settings.json的命令里显式 source或者把变量写进~/.claude/settings.json的env字段。更稳的做法是 hooks 脚本里第一行source ~/.zshrc。报错二hooks 完全没触发。先确认settings.json的 JSON 语法合法用python -m json.tool .claude/settings.json校验。其次确认文件位置对项目级是.claude/settings.json用户级是~/.claude/settings.json放错层级不会生效。最后确认事件名大小写PreToolUse不能写成pretooluse。报错三401 Unauthorized。九成是 Key 没设对或者x-api-key头拼错。检查echo $TAOTOKEN_API_KEY是否有值再检查 curl 里的头名是不是x-api-key。如果用的是 Anthropic 兼容模式anthropic-version头也不能少。报错四hooks 命令阻塞主流程。hooks 默认是同步执行的命令里如果有交互式输入或长时间等待会卡住整个 Agent 循环。所以 hooks 脚本要尽量短、非交互需要长任务就丢到后台并立即返回。报错五matcher不生效。matcher匹配的是工具名不是命令内容。想按命令内容过滤得在脚本里读$CLAUDE_TOOL_INPUT自己判断。另外不同版本的 Claude Code 对matcher支持略有差异以你本地claude --version对应的文档为准。6. 把 hooks 沉淀成长期可用的编码配置单次跑通 hooks 只是第一步真正省事的是把它变成长期配置。如果你经常用 Claude Code 做编码和 Agent 任务可以把这套骨架固化下来配合 Coding Plan 使用Key 和通道一次配好后面新项目直接复制.claude/目录。https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite接入细节和字段说明以官方文档为准遇到版本差异先查文档再改配置https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite我自己的习惯是settings.json只放事件声明和命令引用具体逻辑全丢到.claude/hooks/下的脚本里脚本统一从环境变量读 Key 和 Base URL。这样换机器只需要重新 export 两个变量hooks 一行都不用改。
手搓Claude Code-第四章 hooks：用 TaoToken 统一 Key 打通 settings.json 配置骨架
1. 为什么要在 Claude Code 里折腾 hooksClaude Code 的 hooks 机制说白了就是给 Agent 循环装几个「挂钩」用户提交输入后、工具执行前、工具执行后、任务收尾时各留一个固定插槽。你想加日志、加权限校验、加输出体积告警都往插槽上挂不用去改主循环。这个设计在官方文档里叫 hooks在社区里常被拿来和「中间件」「事件总线」类比本质是一回事。我这次要解决的具体问题是本地跑 Claude Code 时模型调用通道和 Key 管理太散。每个项目一份配置换台机器就要重新填一遍hooks 里想加个「调用前打印当前通道」的日志都无从下手。所以这一章的目标很明确——把 hooks 的事件声明写进settings.json同时用 TaoToken 统一 Key 和 API 通道让 hooks 触发的每一条命令都走同一条链路。适合谁看已经在用 Claude Code、想把手动配置沉淀成工程化骨架的人或者刚接触 hooks、想知道settings.json里到底能写什么的人。下面给的配置骨架可以直接复制改两个环境变量就能跑。2. TaoToken 前置Key 与通道怎么统一TaoToken 在这里扮演的角色是「统一入口」你不需要在每个项目的 hooks 脚本里硬编码不同的 Key而是把 Key 和 API 地址收敛到环境变量settings.json只引用变量名。这样 hooks 触发的命令、Claude Code 本身的模型请求走的是同一套凭证。先拿 Key。打开控制台在 API Keys 页面创建一个新 Key复制出来。地址是https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite创建完 Key 之后把它写进 shell 的环境变量。macOS / Linux 用~/.zshrc或~/.bashrcWindows 用系统环境变量面板。我习惯这样写export TAOTOKEN_API_KEYsk-你的Key export TAOTOKEN_BASE_URLhttps://taotoken.net/api注意TAOTOKEN_BASE_URL后面不带 UTM 参数API 调用地址就是干净的https://taotoken.net/api。UTM 只加在给人点的链接上别混进代码里否则某些客户端会把查询串当成路径的一部分。如果你用的是 Claude Code 的 Anthropic 兼容模式还需要一个指向文档的参考页配置字段名以它为准https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite环境变量设好之后开一个新终端echo $TAOTOKEN_API_KEY确认能打印出来。这一步没做对后面 hooks 里所有命令都会报鉴权失败排查起来很浪费时间。3. 可复制的 settings.json hooks 配置骨架Claude Code 的settings.json一般放在项目根目录的.claude/下或者用户级的~/.claude/settings.json。hooks 字段的结构是「事件名 → 匹配器 → 命令数组」。下面这份骨架我实测能跑事件覆盖了UserPromptSubmit、PreToolUse、PostToolUse、Stop四个节点。{ hooks: { UserPromptSubmit: [ { hooks: [ { type: command, command: echo \[HOOK] UserPromptSubmit: cwd$(pwd) channel$TAOTOKEN_BASE_URL\ } ] } ], PreToolUse: [ { matcher: Bash, hooks: [ { type: command, command: echo \[HOOK] PreToolUse Bash: $CLAUDE_TOOL_INPUT\ } ] } ], PostToolUse: [ { matcher: Bash, hooks: [ { type: command, command: echo \[HOOK] PostToolUse Bash done\ } ] } ], Stop: [ { hooks: [ { type: command, command: echo \[HOOK] Stop: session finished\ } ] } ] } }几个关键点解释一下。matcher用来限定工具名比如只对Bash生效不写就匹配所有工具。type目前主要是command表示执行一条 shell 命令。命令里可以直接引用环境变量所以$TAOTOKEN_BASE_URL会被展开成你前面设的地址这样 hooks 日志里就能看到当前走的是哪条通道。如果你想让 hooks 触发的命令也走 TaoToken 的模型调用比如在PreToolUse里做一次轻量的意图判断可以再包一层脚本#!/usr/bin/env bash # .claude/hooks/pre_check.sh set -euo pipefail payload${CLAUDE_TOOL_INPUT:-} echo [HOOK] checking tool input via $TAOTOKEN_BASE_URL curl -sS $TAOTOKEN_BASE_URL/v1/messages \ -H x-api-key: $TAOTOKEN_API_KEY \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d {\model\:\claude-3-5-sonnet-latest\,\max_tokens\:64,\messages\:[{\role\:\user\,\content\:\判断以下工具调用是否安全只回 safe 或 unsafe$payload\}]}然后在settings.json里把command换成bash .claude/hooks/pre_check.sh。这样 hooks 和主循环共用同一套 Key 与通道不用维护两份凭证。4. 验证请求与 hook 执行结果配置写完先做一次最小验证确认 hooks 真的被触发且请求链路能通。第一步在项目根目录启动 Claude Code随便输入一句列出当前目录。你应该在终端看到类似输出[HOOK] UserPromptSubmit: cwd/Users/you/project channelhttps://taotoken.net/api这说明UserPromptSubmit事件被触发环境变量也正确展开。如果channel后面是空的回去检查TAOTOKEN_BASE_URL有没有 export 成功。第二步触发一次工具调用比如让它读取 README.md。这时PreToolUse和PostToolUse应该依次打印[HOOK] PreToolUse Bash: {command:cat README.md} [HOOK] PostToolUse Bash done第三步验证模型请求本身走的是 TaoToken。单独跑一次 curl确认返回结构正常curl -sS $TAOTOKEN_BASE_URL/v1/messages \ -H x-api-key: $TAOTOKEN_API_KEY \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d {model:claude-3-5-sonnet-latest,max_tokens:32,messages:[{role:user,content:ping}]}返回里能看到content数组和usage字段就说明 Key 和通道都没问题。这一步过了hooks 里再调模型就是同一套链路不会出现「主循环能跑、hooks 报 401」的割裂情况。想直接在网页里对比模型输出可以用模型对话页https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite5. 本篇常见错排查报错一command not found: $TAOTOKEN_BASE_URL或变量为空。原因是 hooks 命令执行时的 shell 没有加载你的~/.zshrc。解决办法是在settings.json的命令里显式 source或者把变量写进~/.claude/settings.json的env字段。更稳的做法是 hooks 脚本里第一行source ~/.zshrc。报错二hooks 完全没触发。先确认settings.json的 JSON 语法合法用python -m json.tool .claude/settings.json校验。其次确认文件位置对项目级是.claude/settings.json用户级是~/.claude/settings.json放错层级不会生效。最后确认事件名大小写PreToolUse不能写成pretooluse。报错三401 Unauthorized。九成是 Key 没设对或者x-api-key头拼错。检查echo $TAOTOKEN_API_KEY是否有值再检查 curl 里的头名是不是x-api-key。如果用的是 Anthropic 兼容模式anthropic-version头也不能少。报错四hooks 命令阻塞主流程。hooks 默认是同步执行的命令里如果有交互式输入或长时间等待会卡住整个 Agent 循环。所以 hooks 脚本要尽量短、非交互需要长任务就丢到后台并立即返回。报错五matcher不生效。matcher匹配的是工具名不是命令内容。想按命令内容过滤得在脚本里读$CLAUDE_TOOL_INPUT自己判断。另外不同版本的 Claude Code 对matcher支持略有差异以你本地claude --version对应的文档为准。6. 把 hooks 沉淀成长期可用的编码配置单次跑通 hooks 只是第一步真正省事的是把它变成长期配置。如果你经常用 Claude Code 做编码和 Agent 任务可以把这套骨架固化下来配合 Coding Plan 使用Key 和通道一次配好后面新项目直接复制.claude/目录。https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite接入细节和字段说明以官方文档为准遇到版本差异先查文档再改配置https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite我自己的习惯是settings.json只放事件声明和命令引用具体逻辑全丢到.claude/hooks/下的脚本里脚本统一从环境变量读 Key 和 Base URL。这样换机器只需要重新 export 两个变量hooks 一行都不用改。
.system Ⅴ共享内存)
