1. 为什么我建议你从 hooks 和 MCP servers 开始拆配方库awesome-claude-code-workflows 这个仓库本质上是一本 Claude Code 的 cookbook。它把 hooks、MCP servers、skills、agents、CLAUDE.md 这些原语按场景组合成能直接跑的流程配方而不是简单堆一堆工具链接。仓库按功能分成十几个类别从虚拟工程团队、多 Agent 编排到上下文记忆管理、TDD 代码质量、浏览器验证基本覆盖了日常开发到部署的链路。但很多人第一次打开这个列表会懵配方太多Star 数从几十到几万不等到底先看哪个我的建议是先啃 hooks 和 MCP servers 这两块。原因很直接——它们是 Claude Code 工作流里最底层的两个扩展点。hooks 决定「什么时候自动触发什么动作」MCP servers 决定「Claude 能调用哪些外部能力」。把这两个跑通后面再叠加 skills、agents、多 Agent 编排就是顺水推舟的事。这篇内容面向的是想搭建可复用 Claude Code 工作流的开发者。我会给你可直接复制的 hooks 配置片段、MCP server 接入步骤以及逐条验证动作让你在本地跑通一条完整工作流。中间会用到 TaoToken 作为模型接入层把 Base URL、API Key、Model ID 三件套配好后面所有配方都能复用这套接入。先说清楚 hooks 是什么。你可以把它理解成 Claude Code 的事件回调在工具调用前后、会话开始结束、用户提交提示词这些节点上挂一段 shell 命令或脚本。比如「每次 Claude 改完文件自动跑一次格式化」「每次会话结束把上下文摘要写进记忆文件」。MCP servers 则是另一条线它给 Claude 挂上外部工具和数据源比如数据库查询、浏览器操作、文件系统之外的 API。awesome-claude-code-workflows 里那些高 Star 配方几乎都是这两者的组合。claude-mem 用 hooks 捕获操作再压缩注入后续会话gstack 的浏览器 QA 用 MCP 挂 Playwright 打开页面截图验证claude-review-loop 让 Claude 写代码、Codex 审代码靠的也是 hooks 在任务完成前触发验证。看懂这个结构你就能自己拆配方而不是照抄。2. TaoToken 前置把 Base URL、Key、Model ID 三件套配好在动 hooks 和 MCP 之前得先让 Claude Code 能稳定连上模型。我用 TaoToken 做接入层官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。它的作用是统一管理模型调用你拿到一个 Base URL 和一个 Key就能在 Claude Code、Cline、Codex 这些客户端里复用。第一步是拿 Key。打开 https://taotoken.net/api-keys 登录后创建一个 API Key复制保存。这个 Key 后面会写进环境变量或配置文件别直接硬编码到会提交到 Git 的文件里。第二步是确认 Base URL。TaoToken 的 API 根地址是 https://taotoken.net/api 注意这里不带 UTM 参数配置里就用这个干净地址。很多客户端要求填到/v1这一层具体看客户端文档Claude Code 一般填根地址即可。第三步是选 Model ID。这一步最容易踩坑因为不同客户端对模型名的写法不一样。你在 TaoToken 的模型列表里选一个比如 Claude 系列或 Codex 系列把准确的 Model ID 记下来。后面配置里出现的model字段必须和这个 ID 完全一致大小写、连字符都不能错。三件套配好后建议先做一次最小验证别急着上 hooks。用 curl 直接打一次接口确认 Key 和 Base URL 是通的curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: 你的ModelID, messages: [{role: user, content: ping}] }如果返回里有choices字段和正常内容说明接入层没问题。如果报 401多半是 Key 错了或没带上Bearer如果报 model not found就是 Model ID 写错了。这一步过了再往下配 Claude Code。Claude Code 侧的配置核心是让它知道走哪个 Base URL 和 Key。你可以用环境变量也可以写进配置文件。环境变量方式export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEY你的TaoTokenKey如果你用的是 Codex 或 Cline 这类客户端配置位置不同。Codex 会读~/.codex/auth.jsonCline 在 VS Code 设置里填 Base URL 和 Key。不管哪个客户端记住三件套Base URL 填https://taotoken.net/apiKey 填你创建的Model ID 填模型列表里那个准确名字。这三样对齐了后面 hooks 和 MCP 才有稳定的模型底座。3. 可复制配置hooks 片段与 MCP server 接入这一节给你能直接抄的配置。先讲 hooks再讲 MCP servers最后给一个把两者串起来的完整工作流。Claude Code 的 hooks 配置一般放在项目的.claude/settings.json里或者用户级的~/.claude/settings.json。结构是hooks对象下面按事件名分组每个事件挂一组匹配器和命令。下面是一个我实测可用的片段实现了「Claude 每次写完文件后自动跑格式化」和「会话结束时把摘要写进记忆文件」{ hooks: { PostToolUse: [ { matcher: Write|Edit, hooks: [ { type: command, command: npx prettier --write \$CLAUDE_FILE_PATH\ 2/dev/null || true } ] } ], Stop: [ { matcher: , hooks: [ { type: command, command: echo \[$(date)] session ended\ .claude/memory.log } ] } ] } }这里PostToolUse在工具调用之后触发matcher用正则匹配工具名Write|Edit表示写文件和编辑文件都命中。$CLAUDE_FILE_PATH是 Claude Code 注入的环境变量指向被操作的文件。Stop事件在会话结束时触发这里简单追加一行日志你可以换成更复杂的摘要脚本。注意|| true这个尾巴它的作用是即使 prettier 报错也不阻断主流程。hooks 里命令失败默认可能影响会话加这个兜底更稳。再讲 MCP servers。MCP 的配置通常放在.mcp.json或客户端的 MCP 设置里。下面是一个接入文件系统 MCP server 的配置让 Claude 能读取项目外的指定目录{ mcpServers: { filesystem: { command: npx, args: [ -y, modelcontextprotocol/server-filesystem, /Users/you/projects/shared-docs ] } } }command是启动命令args是参数最后那个路径是允许访问的目录。配好后重启 Claude Code它会加载这个 server你就能在对话里让 Claude 读那个目录的文件。如果你要接的是浏览器验证类的 MCP比如 Playwright配置类似把 command 换成对应的 server 包args 里带上浏览器参数。awesome-claude-code-workflows 里 gstack 的浏览器 QA 配方底层就是这个思路。现在把 hooks 和 MCP 串成一条完整工作流Claude 改完代码 → hook 自动格式化 → 通过 MCP 调 Playwright 打开页面截图 → 截图存到指定目录 → 会话结束写记忆日志。这条链路里hooks 负责「自动触发」MCP 负责「外部能力」两者配合就是配方库里的典型模式。配置时有个细节hooks 和 MCP 的配置文件路径要对。项目级配置放项目根目录的.claude/下用户级放~/.claude/下。如果你同时配了两处项目级一般优先。改完配置记得重启 Claude Code否则不生效。4. 验证请求逐条确认工作流真的跑通配完不等于跑通得逐条验证。我按「模型接入 → hooks → MCP → 串联」的顺序给你验证动作。先验证模型接入。在 Claude Code 里发一句最简单的提示比如「回复 pong」。如果正常返回说明 Base URL、Key、Model ID 三件套没问题。如果卡住或报错回到第 2 节的 curl 测试先确认接口层通不通。再验证 hooks。触发一次文件写入比如让 Claude 创建一个测试文件。然后看两件事文件是否被 prettier 格式化过如果内容有可格式化空间以及.claude/memory.log是否在会话结束后多了一行。如果格式化没生效检查matcher是否匹配到了工具名以及$CLAUDE_FILE_PATH是否被正确注入。你可以在 hook 命令里临时加echo $CLAUDE_FILE_PATH /tmp/hook-debug.log来调试。验证 MCP 时在对话里让 Claude 列出它能访问的工具或者直接让它读你配置的那个目录里的文件。如果 Claude 说找不到工具说明 MCP server 没加载成功。常见原因是npx包名写错或者路径不存在。手动在终端跑一遍npx -y modelcontextprotocol/server-filesystem /你的路径看能不能启动能启动再回 Claude Code 里试。最后验证串联。让 Claude 完成一个小任务改一个文件、触发格式化、再通过 MCP 读取另一个目录的文件做对比。整个过程如果不需要你手动干预说明工作流跑通了。这时候你可以把这条流程固化下来作为配方库里的一个可复用单元。验证时建议开两个终端一个跑 Claude Code一个tail -f看日志文件。这样 hook 有没有触发、MCP 有没有被调用一目了然。我踩过的坑是配置文件改了没重启白白排查半天所以每次改完配置先重启再验证。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth这一节对照真实报错给你排查路径。这些错在 hooks 和 MCP 工作流里出现频率最高。401 Unauthorized。这个基本是 Key 问题。检查三处Key 是否复制完整有没有漏字符、请求头是否带了Bearer前缀、Key 是否已过期或被删。如果你用的是环境变量确认ANTHROPIC_API_KEY真的被导出到了当前 shellecho $ANTHROPIC_API_KEY看一眼。TaoToken 的 Key 在 https://taotoken.net/api-keys 管理重新生成一个再试。local proxy failed。这个报错通常出现在客户端尝试走本地代理但代理没起来的时候。检查你的客户端配置里有没有多余的代理设置Base URL 是否被错误地指向了localhost或某个本地端口。正确做法是 Base URL 直接填https://taotoken.net/api不要经过本地转发。如果你之前配过代理相关的东西清掉再试。reading choices 相关报错。这个一般出现在解析响应时说明返回结构里没有预期的choices字段。原因可能是 Model ID 写错导致返回了错误结构或者 Base URL 填到了错误的路径层级。先确认 Model ID 和模型列表一致再确认 Base URL 是根地址而不是某个子路径。用第 2 节的 curl 命令直接打一次看返回的 JSON 结构对不对。OAuth 报错。如果你用的是 Codex 或某些需要 OAuth 的客户端可能会遇到 OAuth 流程失败。这时候检查~/.codex/auth.json是否存在且格式正确。如果你走的是 API Key 模式而不是 OAuth确认客户端配置里没有残留的 OAuth 设置。Codex 的 auth.json 里应该包含你的 Key 和 Base URL 信息格式参考客户端文档。还有一个高频问题hooks 命令不执行。先确认配置文件路径对不对项目级是.claude/settings.json用户级是~/.claude/settings.json。再确认 JSON 格式合法可以用jq . .claude/settings.json校验。最后确认命令本身在终端能跑通hooks 只是帮你自动执行命令本身有问题它也没办法。MCP server 加载失败时先手动跑启动命令。如果手动能跑、Claude Code 里不行多半是配置文件路径或格式问题。检查.mcp.json的 JSON 结构确认mcpServers下面每个 server 的command和args正确。改完重启 Claude Code。6. 把配方库变成你自己的工具箱跑通一条工作流之后你会发现 awesome-claude-code-workflows 里那些配方不再神秘。它们无非是 hooks 和 MCP 的不同组合方式。你可以按场景去拆需要自动触发就用 hooks需要外部能力就挂 MCP需要多步编排就叠加 agents。想继续深入的话模型对话入口在 https://taotoken.net/chat 可以拿来快速验证模型响应接入文档在 https://taotoken.net/doc 里面有各客户端的详细配置如果你要长期跑编码和 Agent 任务Coding Plan 在 https://taotoken.net/coding-plan 适合把工作流固化下来。API Keys 管理还是 https://taotoken.net/api-keys 。最后给你一个实用建议每跑通一条配方就把它写进自己项目的.claude/目录连同 hooks 配置和 MCP 配置一起版本化。这样换项目时直接复制不用重新配。配方库的价值不在于收藏了多少 Star而在于你真正跑通并复用了多少条。
1. 为什么我建议你从 hooks 和 MCP servers 开始拆配方库awesome-claude-code-workflows 这个仓库本质上是一本 Claude Code 的 cookbook。它把 hooks、MCP servers、skills、agents、CLAUDE.md 这些原语按场景组合成能直接跑的流程配方而不是简单堆一堆工具链接。仓库按功能分成十几个类别从虚拟工程团队、多 Agent 编排到上下文记忆管理、TDD 代码质量、浏览器验证基本覆盖了日常开发到部署的链路。但很多人第一次打开这个列表会懵配方太多Star 数从几十到几万不等到底先看哪个我的建议是先啃 hooks 和 MCP servers 这两块。原因很直接——它们是 Claude Code 工作流里最底层的两个扩展点。hooks 决定「什么时候自动触发什么动作」MCP servers 决定「Claude 能调用哪些外部能力」。把这两个跑通后面再叠加 skills、agents、多 Agent 编排就是顺水推舟的事。这篇内容面向的是想搭建可复用 Claude Code 工作流的开发者。我会给你可直接复制的 hooks 配置片段、MCP server 接入步骤以及逐条验证动作让你在本地跑通一条完整工作流。中间会用到 TaoToken 作为模型接入层把 Base URL、API Key、Model ID 三件套配好后面所有配方都能复用这套接入。先说清楚 hooks 是什么。你可以把它理解成 Claude Code 的事件回调在工具调用前后、会话开始结束、用户提交提示词这些节点上挂一段 shell 命令或脚本。比如「每次 Claude 改完文件自动跑一次格式化」「每次会话结束把上下文摘要写进记忆文件」。MCP servers 则是另一条线它给 Claude 挂上外部工具和数据源比如数据库查询、浏览器操作、文件系统之外的 API。awesome-claude-code-workflows 里那些高 Star 配方几乎都是这两者的组合。claude-mem 用 hooks 捕获操作再压缩注入后续会话gstack 的浏览器 QA 用 MCP 挂 Playwright 打开页面截图验证claude-review-loop 让 Claude 写代码、Codex 审代码靠的也是 hooks 在任务完成前触发验证。看懂这个结构你就能自己拆配方而不是照抄。2. TaoToken 前置把 Base URL、Key、Model ID 三件套配好在动 hooks 和 MCP 之前得先让 Claude Code 能稳定连上模型。我用 TaoToken 做接入层官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。它的作用是统一管理模型调用你拿到一个 Base URL 和一个 Key就能在 Claude Code、Cline、Codex 这些客户端里复用。第一步是拿 Key。打开 https://taotoken.net/api-keys 登录后创建一个 API Key复制保存。这个 Key 后面会写进环境变量或配置文件别直接硬编码到会提交到 Git 的文件里。第二步是确认 Base URL。TaoToken 的 API 根地址是 https://taotoken.net/api 注意这里不带 UTM 参数配置里就用这个干净地址。很多客户端要求填到/v1这一层具体看客户端文档Claude Code 一般填根地址即可。第三步是选 Model ID。这一步最容易踩坑因为不同客户端对模型名的写法不一样。你在 TaoToken 的模型列表里选一个比如 Claude 系列或 Codex 系列把准确的 Model ID 记下来。后面配置里出现的model字段必须和这个 ID 完全一致大小写、连字符都不能错。三件套配好后建议先做一次最小验证别急着上 hooks。用 curl 直接打一次接口确认 Key 和 Base URL 是通的curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: 你的ModelID, messages: [{role: user, content: ping}] }如果返回里有choices字段和正常内容说明接入层没问题。如果报 401多半是 Key 错了或没带上Bearer如果报 model not found就是 Model ID 写错了。这一步过了再往下配 Claude Code。Claude Code 侧的配置核心是让它知道走哪个 Base URL 和 Key。你可以用环境变量也可以写进配置文件。环境变量方式export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEY你的TaoTokenKey如果你用的是 Codex 或 Cline 这类客户端配置位置不同。Codex 会读~/.codex/auth.jsonCline 在 VS Code 设置里填 Base URL 和 Key。不管哪个客户端记住三件套Base URL 填https://taotoken.net/apiKey 填你创建的Model ID 填模型列表里那个准确名字。这三样对齐了后面 hooks 和 MCP 才有稳定的模型底座。3. 可复制配置hooks 片段与 MCP server 接入这一节给你能直接抄的配置。先讲 hooks再讲 MCP servers最后给一个把两者串起来的完整工作流。Claude Code 的 hooks 配置一般放在项目的.claude/settings.json里或者用户级的~/.claude/settings.json。结构是hooks对象下面按事件名分组每个事件挂一组匹配器和命令。下面是一个我实测可用的片段实现了「Claude 每次写完文件后自动跑格式化」和「会话结束时把摘要写进记忆文件」{ hooks: { PostToolUse: [ { matcher: Write|Edit, hooks: [ { type: command, command: npx prettier --write \$CLAUDE_FILE_PATH\ 2/dev/null || true } ] } ], Stop: [ { matcher: , hooks: [ { type: command, command: echo \[$(date)] session ended\ .claude/memory.log } ] } ] } }这里PostToolUse在工具调用之后触发matcher用正则匹配工具名Write|Edit表示写文件和编辑文件都命中。$CLAUDE_FILE_PATH是 Claude Code 注入的环境变量指向被操作的文件。Stop事件在会话结束时触发这里简单追加一行日志你可以换成更复杂的摘要脚本。注意|| true这个尾巴它的作用是即使 prettier 报错也不阻断主流程。hooks 里命令失败默认可能影响会话加这个兜底更稳。再讲 MCP servers。MCP 的配置通常放在.mcp.json或客户端的 MCP 设置里。下面是一个接入文件系统 MCP server 的配置让 Claude 能读取项目外的指定目录{ mcpServers: { filesystem: { command: npx, args: [ -y, modelcontextprotocol/server-filesystem, /Users/you/projects/shared-docs ] } } }command是启动命令args是参数最后那个路径是允许访问的目录。配好后重启 Claude Code它会加载这个 server你就能在对话里让 Claude 读那个目录的文件。如果你要接的是浏览器验证类的 MCP比如 Playwright配置类似把 command 换成对应的 server 包args 里带上浏览器参数。awesome-claude-code-workflows 里 gstack 的浏览器 QA 配方底层就是这个思路。现在把 hooks 和 MCP 串成一条完整工作流Claude 改完代码 → hook 自动格式化 → 通过 MCP 调 Playwright 打开页面截图 → 截图存到指定目录 → 会话结束写记忆日志。这条链路里hooks 负责「自动触发」MCP 负责「外部能力」两者配合就是配方库里的典型模式。配置时有个细节hooks 和 MCP 的配置文件路径要对。项目级配置放项目根目录的.claude/下用户级放~/.claude/下。如果你同时配了两处项目级一般优先。改完配置记得重启 Claude Code否则不生效。4. 验证请求逐条确认工作流真的跑通配完不等于跑通得逐条验证。我按「模型接入 → hooks → MCP → 串联」的顺序给你验证动作。先验证模型接入。在 Claude Code 里发一句最简单的提示比如「回复 pong」。如果正常返回说明 Base URL、Key、Model ID 三件套没问题。如果卡住或报错回到第 2 节的 curl 测试先确认接口层通不通。再验证 hooks。触发一次文件写入比如让 Claude 创建一个测试文件。然后看两件事文件是否被 prettier 格式化过如果内容有可格式化空间以及.claude/memory.log是否在会话结束后多了一行。如果格式化没生效检查matcher是否匹配到了工具名以及$CLAUDE_FILE_PATH是否被正确注入。你可以在 hook 命令里临时加echo $CLAUDE_FILE_PATH /tmp/hook-debug.log来调试。验证 MCP 时在对话里让 Claude 列出它能访问的工具或者直接让它读你配置的那个目录里的文件。如果 Claude 说找不到工具说明 MCP server 没加载成功。常见原因是npx包名写错或者路径不存在。手动在终端跑一遍npx -y modelcontextprotocol/server-filesystem /你的路径看能不能启动能启动再回 Claude Code 里试。最后验证串联。让 Claude 完成一个小任务改一个文件、触发格式化、再通过 MCP 读取另一个目录的文件做对比。整个过程如果不需要你手动干预说明工作流跑通了。这时候你可以把这条流程固化下来作为配方库里的一个可复用单元。验证时建议开两个终端一个跑 Claude Code一个tail -f看日志文件。这样 hook 有没有触发、MCP 有没有被调用一目了然。我踩过的坑是配置文件改了没重启白白排查半天所以每次改完配置先重启再验证。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth这一节对照真实报错给你排查路径。这些错在 hooks 和 MCP 工作流里出现频率最高。401 Unauthorized。这个基本是 Key 问题。检查三处Key 是否复制完整有没有漏字符、请求头是否带了Bearer前缀、Key 是否已过期或被删。如果你用的是环境变量确认ANTHROPIC_API_KEY真的被导出到了当前 shellecho $ANTHROPIC_API_KEY看一眼。TaoToken 的 Key 在 https://taotoken.net/api-keys 管理重新生成一个再试。local proxy failed。这个报错通常出现在客户端尝试走本地代理但代理没起来的时候。检查你的客户端配置里有没有多余的代理设置Base URL 是否被错误地指向了localhost或某个本地端口。正确做法是 Base URL 直接填https://taotoken.net/api不要经过本地转发。如果你之前配过代理相关的东西清掉再试。reading choices 相关报错。这个一般出现在解析响应时说明返回结构里没有预期的choices字段。原因可能是 Model ID 写错导致返回了错误结构或者 Base URL 填到了错误的路径层级。先确认 Model ID 和模型列表一致再确认 Base URL 是根地址而不是某个子路径。用第 2 节的 curl 命令直接打一次看返回的 JSON 结构对不对。OAuth 报错。如果你用的是 Codex 或某些需要 OAuth 的客户端可能会遇到 OAuth 流程失败。这时候检查~/.codex/auth.json是否存在且格式正确。如果你走的是 API Key 模式而不是 OAuth确认客户端配置里没有残留的 OAuth 设置。Codex 的 auth.json 里应该包含你的 Key 和 Base URL 信息格式参考客户端文档。还有一个高频问题hooks 命令不执行。先确认配置文件路径对不对项目级是.claude/settings.json用户级是~/.claude/settings.json。再确认 JSON 格式合法可以用jq . .claude/settings.json校验。最后确认命令本身在终端能跑通hooks 只是帮你自动执行命令本身有问题它也没办法。MCP server 加载失败时先手动跑启动命令。如果手动能跑、Claude Code 里不行多半是配置文件路径或格式问题。检查.mcp.json的 JSON 结构确认mcpServers下面每个 server 的command和args正确。改完重启 Claude Code。6. 把配方库变成你自己的工具箱跑通一条工作流之后你会发现 awesome-claude-code-workflows 里那些配方不再神秘。它们无非是 hooks 和 MCP 的不同组合方式。你可以按场景去拆需要自动触发就用 hooks需要外部能力就挂 MCP需要多步编排就叠加 agents。想继续深入的话模型对话入口在 https://taotoken.net/chat 可以拿来快速验证模型响应接入文档在 https://taotoken.net/doc 里面有各客户端的详细配置如果你要长期跑编码和 Agent 任务Coding Plan 在 https://taotoken.net/coding-plan 适合把工作流固化下来。API Keys 管理还是 https://taotoken.net/api-keys 。最后给你一个实用建议每跑通一条配方就把它写进自己项目的.claude/目录连同 hooks 配置和 MCP 配置一起版本化。这样换项目时直接复制不用重新配。配方库的价值不在于收藏了多少 Star而在于你真正跑通并复用了多少条。
