企业官网建设流程全解析

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_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 端点是 https://taotoken.net/api 。注意 API 地址后面不加任何参数，保持干净。

具体要准备三样东西，我把它整理成一张对照表，配置时直接照着填：

API Key 的生成入口在控制台的 API Keys 页面，登录后新建一个 Key 复制出来即可。这里提醒一句：Key 只显示一次，复制后妥善保存，别直接提交到 Git 仓库里。如果你还没生成，可以先去 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite 创建。

环境变量是最省事的配置方式，在 shell 配置文件（~/.zshrc 或 ~/.bashrc）里加上：

export ANTHROPIC_BASE_URL="https://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-code@everything-claude-code

如果你更喜欢直接改配置文件，可以在 ~/.claude/settings.json 里加上 marketplace 和启用插件的声明。这是一个完整的 JSON 片段，路径和字段名都按官方结构来：

{ "extraKnownMarketplaces": { "everything-claude-code": { "source": { "source": "github", "repo": "affaan-m/everything-claude-code" } } }, "enabledPlugins": { "everything-claude-code@everything-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/ # 复制 rules，common 是通用约束，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_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite 生成一个，再对照 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 的接入文档把 Base URL 和 Model ID 对齐。想先感受一下模型对话效果，也可以从 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite 的模型对话入口试起。长期做编码和 Agent 任务的，直接上 Coding Plan 会更划算，入口在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite 。