1. everything-claude-code 到底是什么能解决哪些 Agent 编码痛点如果你已经在用 Claude Code 写代码大概率遇到过这几个场景每次开新会话都要重新交代项目规范让它做代码审查输出风格飘忽不定长会话跑着跑着上下文爆了token 账单也跟着涨。everything-claude-code 就是冲着这些问题来的——它是一套面向 AI agent harness以编码为核心的代理运行时的性能优化系统把 agents、skills、rules、hooks、MCP 配置打包成可复用的工程资产。说人话Claude Code 本身是个能力很强的通用编码助手但它默认不知道你团队的代码规范、不知道你偏好的 TDD 流程、也不会自动帮你控制上下文成本。everything-claude-code 相当于给这个助手配了一套岗位手册 工具箱 质检流程让它从什么都能聊两句变成按你的规矩干活。它适合谁三类人最值得试一是已经在日常开发中重度使用 Claude Code、想把它工程化的开发者二是团队里想统一 AI 编码规范、让多人协作时输出一致的技术负责人三是正在研究 LLMs Agent 工作流、想找一个真实可跑的参考实现来学习的人。这个仓库标注为 Anthropic hackathon 获奖项目设计上支持跨 harness 使用Claude Code、Codex、Cursor、OpenCode 等都能复用大部分内容。它的核心结构分三层理解这三层是后面配置的基础Skills 是工作流定义每个 SKILL.md 带 YAML frontmatter描述一个可被调用的完整流程比如先写失败测试→实现最小代码→重构→验证覆盖率这样的 TDD 步骤。Rules 是始终生效的约束分 common 和语言特定目录typescript、python、golang 等管的是代码质量、样式、安全这类底线要求。Subagents 负责把复杂任务拆成独立上下文的小任务各自带工具集合适合并行探索再合并结果。这三层配合起来才能让 agent 在长任务里既守规矩又不失控。下面我从零开始把安装、配置、验证、排障整条链路走一遍。2. 接入前的环境准备与 TaoToken 前置配置在装 everything-claude-code 之前得先保证 Claude Code CLI 能正常工作。仓库明确要求 Claude Code CLI v2.1.0 或更高版本因为插件系统在 v2.1.0 之后对 hooks 行为做了变更低版本会出现 hooks 不生效的问题。先用这条命令确认版本claude --version如果版本低于 2.1.0先升级再往下走。版本没问题的话接下来要解决的是模型接入这一环——Claude Code 需要一个可用的 API 端点才能跑起来。我这边日常用的是 TaoToken 提供的接入服务它兼容 Anthropic 的接口协议配置方式和官方一致对 Claude Code 这类工具比较友好。TaoToken 在这里扮演的角色是模型调用入口你拿到 API Key 和 Base URL 之后Claude Code 就能通过它请求模型。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点是 https://taotoken.net/api 。注意 API 地址后面不加任何参数保持干净。具体要准备三样东西我把它整理成一张对照表配置时直接照着填配置项取值来源用途Base URLhttps://taotoken.net/apiClaude Code 请求模型的根地址API KeyTaoToken 控制台的 API Keys 页面生成身份鉴权Model ID按需选择如 claude-sonnet 系列指定调用的模型API Key 的生成入口在控制台的 API Keys 页面登录后新建一个 Key 复制出来即可。这里提醒一句Key 只显示一次复制后妥善保存别直接提交到 Git 仓库里。如果你还没生成可以先去 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 创建。环境变量是最省事的配置方式在 shell 配置文件~/.zshrc 或 ~/.bashrc里加上export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEY你的_TaoToken_API_Key改完执行source ~/.zshrc让它生效。这样 Claude Code 启动时会自动读取这两个变量不用每次手动传参。如果你更习惯用配置文件管理也可以写进 Claude Code 的 settings.json下一节会给出完整片段。环境准备好之后就可以进入 everything-claude-code 的安装了。整个前置环节的核心就一句话CLI 版本达标 模型端点可用这两条满足了后面的插件安装才不会卡在鉴权或版本兼容上。3. 可复制的安装与配置片段插件方式 手动方式everything-claude-code 提供两种安装路径README 里推荐插件方式手动方式适合想精细控制装哪些内容的人。我两种都试过先说插件方式。插件方式在 Claude Code CLI 里执行两条命令就行# 把仓库添加为 marketplace /plugin marketplace add affaan-m/everything-claude-code # 安装插件 /plugin install everything-claude-codeeverything-claude-code如果你更喜欢直接改配置文件可以在 ~/.claude/settings.json 里加上 marketplace 和启用插件的声明。这是一个完整的 JSON 片段路径和字段名都按官方结构来{ extraKnownMarketplaces: { everything-claude-code: { source: { source: github, repo: affaan-m/everything-claude-code } } }, enabledPlugins: { everything-claude-codeeverything-claude-code: true } }这里有个坑必须提前说Claude Code 的插件系统目前不支持通过插件分发 rules这是上游的限制。也就是说插件装完之后agents、commands、skills 这些能生效但 rules 目录下的约束不会自动加载。想让 rules 起作用得手动把 rules 复制到 ~/.claude/rules/。这一点很多人装完发现规则没生效根源就在这里。手动方式适合想挑着装的场景命令如下# 克隆仓库 git clone https://github.com/affaan-m/everything-claude-code.git # 复制 agents 和 commands cp everything-claude-code/agents/*.md ~/.claude/agents/ cp everything-claude-code/commands/*.md ~/.claude/commands/ # 复制 rulescommon 是通用约束typescript 按你的语言栈选 cp -r everything-claude-code/rules/common/* ~/.claude/rules/ cp -r everything-claude-code/rules/typescript/* ~/.claude/rules/ # 复制 skills建议只拷 core/general 和 search-first cp -r everything-claude-code/.agents/skills/* ~/.claude/skills/ cp -r everything-claude-code/skills/search-first ~/.claude/skills/hooks 的处理稍微特殊需要把 hooks/hooks.json 里的内容合并到你的 ~/.claude/settings.json 对应字段中不是简单复制文件。MCP 配置同理把 mcp-configs/mcp-servers.json 里需要的条目复制到 ~/.claude.json然后把里面的 YOUR_*_HERE 占位符替换成真实 API Key。装完之后建议顺手把成本优化配置也加上。README 推荐在 ~/.claude/settings.json 里加这段控制 token 消耗和自动 compact 行为{ model: sonnet, env: { MAX_THINKING_TOKENS: 10000, CLAUDE_AUTOCOMPACT_PCT_OVERRIDE: 50 } }把 model 设成 sonnet 是大多数任务的默认选择复杂架构推理再临时切 opus。MAX_THINKING_TOKENS 降到 10000 能明显压掉思考环节的隐含成本CLAUDE_AUTOCOMPACT_PCT_OVERRIDE 设 50 表示上下文用到一半就触发自动压缩避免长会话把窗口撑爆。这几个参数是我实测下来性价比比较高的组合你可以根据自己的任务复杂度微调。配置写完后用claude启动一个新会话如果没报鉴权错误、能正常对话说明模型接入这层通了。接下来验证 everything-claude-code 本身有没有装好。4. 验证安装是否成功命令、hooks 与首个 Agent 任务装完不等于生效得实际验证一遍。我一般分三步走先确认插件被识别再确认 skills 和 agents 能调用最后跑一个真实的小任务看输出。第一步在 Claude Code 会话里输入/plugin相关命令查看已安装插件列表确认 everything-claude-code 出现在里面。如果列表里没有多半是 marketplace 没添加成功回到上一节检查 settings.json 的 extraKnownMarketplaces 字段。第二步验证 skills 是否加载。everything-claude-code 里有个 search-first skill专门用于先搜索再动手的工作流。你可以在会话里直接描述一个需要检索的任务看 agent 是否会走 search-first 的流程。更直接的方式是检查 ~/.claude/skills/ 目录下有没有对应的 SKILL.md 文件ls ~/.claude/skills/ ls ~/.claude/agents/ ls ~/.claude/rules/三个目录都有内容说明手动复制这步没问题。如果是插件方式装的skills 和 agents 会由插件管理rules 仍需你手动确认。第三步跑一个真实的代码审查任务。everything-claude-code 内置了 code-reviewer subagent 模板你可以拿一段自己项目里的代码让它审。比如在会话里说用 code-reviewer 审查 src/utils/parser.ts重点看错误处理和边界条件。 观察它的输出是否结构化、是否引用了 rules 里的约束。如果它只是泛泛而谈、没有按规则给建议说明 rules 没生效回去检查 ~/.claude/rules/ 的复制路径。hooks 的验证稍微麻烦一点因为 hooks 是在特定事件触发时执行的。你可以故意提交一段带明显问题的代码看安全扫描 hook 有没有拦截或提示。如果 hooks 完全没反应检查 ~/.claude/settings.json 里 hooks 字段的 JSON 结构是否正确——这是最容易出错的地方多一个逗号少一个括号都会导致整个 hooks 静默失效。验证通过后日常使用就围绕几个命令展开。README 的 Daily Workflow Commands 部分列了这几个高频命令/model sonnet切默认模型/model opus处理复杂架构/clear在不相关任务间清上下文/compact在逻辑断点压缩/cost查 token 花费。我的习惯是每完成一个独立子任务就/compact一次跨天或换项目时/clear这样上下文始终保持在健康水位。到这一步如果 code-reviewer 能按规则输出、hooks 能触发、/cost能正常显示花费说明整套系统跑通了。接下来把常见报错过一遍避免你卡在细节上。5. 常见报错排查401、local proxy failed、reading choices 与 OAuth配置过程中最容易撞上的几类报错我按出现频率排一下每个都给排查方向。401 鉴权失败是最常见的。报错通常长这样401 Unauthorized或authentication_error。原因基本是 API Key 没配对或没生效。排查顺序先确认 ANTHROPIC_API_KEY 环境变量在当前 shell 里能echo出来再确认 Key 没有多余空格或换行最后确认 Base URL 是 https://taotoken.net/api 且没有拼错。如果你用的是 settings.json 配置注意环境变量和配置文件同时存在时优先级可能和你想的不一样建议只保留一处配置。local proxy failed 这类报错通常和网络层有关。报错信息里会出现local proxy或connection refused。先检查 Base URL 是否可达用 curl 测一下curl -I https://taotoken.net/api如果 curl 都连不上说明是网络环境问题不是配置问题。如果 curl 通但 Claude Code 报 proxy failed检查有没有残留的代理环境变量HTTP_PROXY、HTTPS_PROXY干扰把它们 unset 掉再试。reading choices 报错一般出现在模型返回结构不符合预期时报错类似error reading choices或unexpected response format。这通常意味着请求打到了不兼容的端点或者 Model ID 填错了。确认你用的 Model ID 是 TaoToken 支持的模型标识别直接抄别处的模型名。另外确认 Base URL 结尾没有多余的斜杠或路径。OAuth 相关报错比较特殊报错里会出现OAuth或token refresh failed。Claude Code 某些版本会尝试走 OAuth 流程如果你用的是 API Key 方式接入需要在配置里明确禁用 OAuth 或确保鉴权方式一致。检查 settings.json 里有没有冲突的鉴权字段只保留 API Key 这一种方式。还有一个不报错但很烦的问题rules 不生效。前面提过插件系统不支持分发 rules所以插件装完后 rules 是空的。解决办法就是手动把 rules/common 和对应语言目录复制到 ~/.claude/rules/。复制完重启会话才生效。排查时有个通用思路先看报错关键词定位到哪一层鉴权、网络、模型、配置再针对性检查。别一上来就重装大部分问题都是配置字段写错或路径不对。如果你在配置 Base URL、Key、Model ID 这三件套时反复出错建议回到第 2 节的对照表逐项核对三件套对齐了八成问题都能解决。6. 从零跑通一个 TDD 工作流案例演示与后续接入建议前面都是准备和排障这一节用一个完整案例把 everything-claude-code 跑起来。我选 TDD 工作流因为它最能体现 skills rules subagents 三层协作的价值。场景给一个 TypeScript 项目新增一个parseDuration函数输入类似 1h30m 的字符串输出毫秒数。要求走 TDD 流程先写失败测试再实现最后验证覆盖率。第一步在 Claude Code 会话里描述任务并明确要求走 TDD skill。everything-claude-code 的 TDD skill 会把流程拆成生成 failing tests → 实现最小代码 → 重构 → 验证覆盖率四步。你只需要说用 TDD 流程实现 parseDuration输入格式如 1h30m输出毫秒先写测试。第二步观察 agent 是否先产出测试文件。正常情况下它会生成类似这样的测试import { parseDuration } from ./parseDuration; describe(parseDuration, () { it(parses hours and minutes, () { expect(parseDuration(1h30m)).toBe(5400000); }); it(parses minutes only, () { expect(parseDuration(45m)).toBe(2700000); }); it(throws on invalid input, () { expect(() parseDuration(abc)).toThrow(); }); });第三步确认测试先失败这是 TDD 的关键然后让 agent 实现最小代码。实现完成后它会自动跑测试如果通过再进入重构和覆盖率检查。整个过程 rules 里的 TypeScript 约束会持续生效比如命名规范、错误处理方式输出风格会比你裸用 Claude Code 稳定得多。第四步用/cost看一下这次任务的 token 花费。因为配置了 MAX_THINKING_TOKENS 和自动 compact一个中等复杂度的 TDD 任务花费通常可控。如果发现花费偏高检查是不是 model 被切到了 opus或者上下文里混入了不相关的大文件。跑通这个案例后你基本就摸清了 everything-claude-code 的工作方式。后续想深入可以试这几个方向把团队常用的代码审查规则写进 rules 目录让每次审查都按统一标准走用 instincts 的持续学习机制让 agent 从重复会话里自动抽取模式再通过/evolve聚类成新 skill如果团队同时用多个 harness通过 AGENTS.md 和 MCP 配置把同一套 agents/skills 复用到 Cursor、Codex 上。最后给个实用建议别一上来就把所有 skills 全装上。everything-claude-code 内容很多全量加载会让上下文变重、启动变慢。我的做法是先装 core/general 和 search-first跑顺了再按需加。rules 也是先上 common语言特定的等你确认项目技术栈后再补。这样既能快速见效又不会因为配置过重把自己绕进去。如果你还没准备好 API Key可以先去 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 生成一个再对照 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 的接入文档把 Base URL 和 Model ID 对齐。想先感受一下模型对话效果也可以从 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 的模型对话入口试起。长期做编码和 Agent 任务的直接上 Coding Plan 会更划算入口在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。