企业官网建设流程全解析

1. 编码助手读完 AGENTS.md，先烧掉一轮 Token

在用 Claude Code 维护一个 Go 后端仓库的时候，仓库根目录躺着一份 AGENTS.md。最早写它是因为模型总喜欢把事情搞复杂：让它给一个 HTTP 客户端加上指数退避，它返回了一个包含RetryPolicy、BackoffStrategy、RetryInterceptor三个接口和五个实现的结构，最后调用方只用了client.Get(url)。后来这份文件越写越长，从"少写抽象"扩到"禁止使用某些连接词"、"禁止过程性总结"、"禁止虚空对比"，规则攒到七八十条。

问题出在上下文开销。每次会话开始，编码助手都会把 AGENTS.md 整份读进上下文，规则越多，输入 Token 越多。一个后端开发者一天开十几次会话，这些规则被重复读取十几遍，账单叠加得很快。约束本身是对的，读取约束的成本却是实打实的。于是有两件事要同步处理：把 AGENTS.md 压缩成篇幅短、含义明确、可以被检查的条款；把编码助手的请求指向 TaoToken 的接口地址，先到 TaoToken 官网 注册账号并获取 Key，再把 Base URL 设置为https://taotoken.net/api。

这套流程面向的是每天用编码助手改仓库的人，所以下面给出来的都是可以直接复制进配置文件的片段，以及终端里能对照的实际问答输出。

2. 精简 AGENTS.md：把"说人话"写成可检查的条款

原始版本的问题是条款数量多、互相重叠、语气重。精简的思路是合并同类项，只保留能直接改变模型输出行为的规则，把情绪化的措辞全部去掉。下面这份片段大约 300 字，覆盖了过度工程、输出语言、测试三个方面，放在仓库根目录即可生效。

# AGENTS.md ## 修改范围 - 只修改与当前任务直接相关的文件。新增接口、工厂、包装层之前， 先确认现有代码无法完成同一件事。 - 不为单一调用点创建抽象。一次性的逻辑写在调用处。 - 不引入新的第三方依赖来完成标准库已经覆盖的工作。 ## 输出语言 - 直接给出结论和改动，禁止在回答开头概述将要做什么。 - 禁止在回答结尾总结已经做了什么。 - 禁止使用对比句式，例如"不是 A，而是 B"、"要 A，不要 B"。 - 禁止列举被排除的候选方案。搜索 A 得到 B、C、D 不满足要求时， 只报告最终结论。 - 描述动作时写出完整的动宾结构，说明动作和对象。 ## 代码 - 出错时在出错位置终止程序，禁止捕获后继续执行，禁止降级处理。 - 禁止使用远程服务或数据库的模拟对象来通过测试。 - 禁止在 Bash 命令中内联多行脚本，需要执行脚本时先写入文件。 ## 验证 - 功能实现之后必须运行测试并迭代到测试通过。 - 报告结果时附上实际执行的命令和真实输出。

条款能省下 Token 的原因很直接：每条规则都对应一种高频出现的冗余输出。"禁止概述和总结"砍掉的是回答头尾各一段的废话；"禁止列举被排除的候选方案"砍掉的是搜索失败之后罗列 B、C、D 的段落；"不为单一调用点创建抽象"砍掉的是新增文件带来的额外输入输出。规则文本本身只有 300 字，换来的上下文节省远大于这个数字。

条款写完之后要做一次对照检查：把同一句提示分别发给未加载 AGENTS.md 的会话和加载之后的会话，比较返回内容的行数和改动文件数量。这个对照过程放在第 7 节。

3. 创建 API Key 并把 Base URL 指向 https://taotoken.net/api

编码助手要按 AGENTS.md 工作，第一步是让它有一个可用的接口地址。进入 TaoToken 控制台 完成注册，然后在页面左侧进入 API Keys 管理界面，创建一个新的 Key。创建时给 Key 起一个有辨识度的名字，例如backend-agent-dev，方便后面在账单里区分不同工具产生的调用。

Key 只会在创建时完整显示一次，复制之后保存到本地密码管理器。接下来把接口地址固定成https://taotoken.net/api，这个地址是所有工具配置里base_url字段要填入的值。它和 Key 一起构成两件套：地址决定请求发往哪里，Key 决定请求以谁的身份发出。

创建 Key 的入口在 API Keys 页面，页面里同时可以查看已经创建的 Key 列表和调用记录。建议在正式配置工具之前，先在模型对话页面发一条简单的消息，确认 Key 可以正常使用、目标模型可以正常返回内容。模型对话入口在 模型对话页面，页面里的模型列表就是当前账号可以调用的全部模型，配置工具时填写的模型名称要与此处保持一致。

4. Claude Code：settings.json 与环境变量

Claude Code 支持两种配置方式。第一种是写入用户目录下的settings.json，适合长期使用；第二种是设置进程环境变量，适合临时切换或者写进容器启动脚本。

settings.json的位置在用户主目录下的.claude文件夹里。配置内容如下，把YOUR_API_KEY替换成上一步创建的 Key：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY", "ANTHROPIC_MODEL": "YOUR_MODEL_ID" } }

ANTHROPIC_MODEL的值填模型对话页面里查到的模型标识。三个字段的作用分别是：ANTHROPIC_BASE_URL决定请求发送到https://taotoken.net/api；ANTHROPIC_AUTH_TOKEN携带身份凭据；ANTHROPIC_MODEL指定默认调用的模型。

如果只想在当前终端会话里生效，把同样的三个变量导出即可：

export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY" export ANTHROPIC_MODEL="YOUR_MODEL_ID"

配置完成后执行claude进入交互界面，先问一句和工作无关的短问题，例如让助手解释仓库里某个函数的用途。能正常返回内容就说明地址和 Key 都已经生效。这一步要确认的是连接通路，还没有涉及 AGENTS.md。

Claude Code 读取仓库根目录的 AGENTS.md 和 CLAUDE.md 文件，把内容拼进系统提示。第 2 节那份 300 字的文件放进仓库之后，每次会话的输入长度是可预期的。完整配置说明和字段含义可以在 Claude Code 文档 里查到。

5. Codex：config.toml 里的 provider 配置

Codex 的配置写在~/.codex/config.toml。它使用model_providers段落定义供应商，字段名称和 Claude Code 完全不同，ANTHROPIC_*系列变量在这边不起作用。配置内容如下：

model = "YOUR_MODEL_ID" model_provider = "taotoken" [model_providers.taotoken] name = "TaoToken" base_url = "https://taotoken.net/api" env_key = "TAOTOKEN_API_KEY" wire_api = "chat"

model_provider指向下面定义的段落名称，base_url填https://taotoken.net/api，env_key说明 Key 从哪个环境变量读取。然后导出这个变量：

export TAOTOKEN_API_KEY="YOUR_API_KEY"

把导出语句写进 shell 的启动文件，或者写进仓库外的环境配置脚本。Codex 启动时会读取config.toml，按照env_key指定的名称去环境变量里取凭据。两边的字段对应关系很容易记混，一个简单的对照是：Claude Code 用ANTHROPIC_BASE_URL加ANTHROPIC_AUTH_TOKEN，Codex 用base_url加env_key，把前者照搬到后者会直接导致鉴权失败。

两个工具可以同时配置，指向同一个https://taotoken.net/api，共用同一个 Key，也可以各建一个 Key 便于分别统计用量。

6. CC Switch 三件套：base_url、api_key、model

需要在多个项目、多个模型之间来回切换时，每次手改配置文件很费时间。CC Switch 是这类场景常用的切换工具，它管理的是三件套：base_url、api_key、model。在工具里新增一条配置，三个字段分别填写：

base_url = https://taotoken.net/api api_key = YOUR_API_KEY model = YOUR_MODEL_ID

保存之后可以在配置列表里一键切换。切换的实质是把这三项写入对应工具自己的配置文件：切换到 Claude Code 时写入settings.json的env段，切换到 Codex 时写入config.toml的 provider 段。理解了这一点，即使不用切换工具，手动维护两份配置也不容易出错。

同一台机器上准备多条配置是合理的做法。例如一条配置使用响应速度较快的模型处理日常小改动，另一条配置使用推理能力较强的模型处理重构任务。两条配置的base_url都是https://taotoken.net/api，区别只在model字段。

配置完成之后，在项目根目录执行一次git status，确认没有把包含 Key 的文件加进版本控制。配置文件放在用户主目录下，天然不会被仓库收录，手动写进项目目录的环境文件则需要加入.gitignore。

7. 终端问答对照：同一句提示，约束前后的差别

对照实验的对象是 AGENTS.md 里的过度工程条款。仓库里有一个函数FetchUser，直接调用数据库查询用户记录。提示语句统一为：

给 FetchUser 加上失败重试。

第一次在没有加载 AGENTS.md 的会话里执行，返回的改动如下：

新增文件 retry/strategy.go 新增文件 retry/backoff.go 新增文件 retry/interceptor.go 修改 profile/fetch.go，调用 Interceptor 包装原始查询 FetchUser 现在通过 RetryInterceptor 执行，支持固定间隔、指数退避、 自定义判定函数三种策略，默认使用指数退避。

第二次在加载了第 2 节那份 AGENTS.md 的会话里执行同一句提示，返回的改动如下：

修改 profile/fetch.go 在 FetchUser 内部加入重试循环，最多重试 3 次，间隔 200 毫秒。 失败到第 3 次时返回原始错误。

两次结果的差别体现在新增文件数量、接口数量和调用方改动范围上。约束条款并没有教模型写重试循环，它限制的是抽象的规模。把这条对照记录下来，作为后续调整 AGENTS.md 的依据。

环境变量同样要做一次验证。在两个不同的终端窗口里分别导出配置，一个运行 Claude Code，一个运行 Codex，各自发一条消息，确认两个工具都能返回内容。这一步能排除环境变量串用的问题。

8. 报错处理：鉴权失败、路径错误、模型名称不匹配

配置完成后最常见的三类报错如下。

第一类是401 Unauthorized。原因是 Key 没有设置、设置成了占位符YOUR_API_KEY，或者环境变量名和配置文件里声明的名称不一致。排查方法是打印当前 shell 里的相关变量，确认值已经替换成真实 Key。Codex 的env_key字段如果写成TAOTOKEN_API_KEY，环境变量就必须用同名导出，写成别的名字同样会返回 401。

第二类是404 Not Found。原因是base_url填成了完整的接口路径，例如在末尾追加了/v1/messages。base_url只需要填写https://taotoken.net/api，具体的接口路径由工具自己拼接。出现 404 时先检查地址末尾是否多写了路径段。

第三类是模型名称不匹配的报错，通常表现为接口返回模型不存在的提示。原因是在配置里手写了一个不在账号可用范围内的模型标识。处理方式是打开模型对话页面，从模型列表里复制准确的标识，粘贴进ANTHROPIC_MODEL或者config.toml的model字段。模型标识区分大小写和连字符，手工输入容易出错。

排查过程中遇到无法判断的返回内容，可以在 TaoToken 官网 查阅接口说明，或者在控制台的调用记录里查看请求的完整状态。日志里会保留请求时间、使用的模型和返回状态，对照这些字段可以快速定位是凭据问题还是参数问题。

9. 把两件事固定下来

一件是仓库根的 AGENTS.md，它控制输出的规模和形状，篇幅保持在几百字，条款写成可以直接判断是否违反的形式。另一件是工具的接口配置，两台工具、一个地址、一个或两个 Key，base_url全部指向https://taotoken.net/api。

需要试用模型效果，可以从 模型对话页面 直接发起对话，用第 7 节那句"给 FetchUser 加上失败重试"测试不同模型在约束下的输出差异。

准备长期在仓库里使用编码助手，可以查看 Coding Plan，按使用强度选择合适的方案。

还没有创建凭据的话，进入 API Keys 页面 新建一个，替换掉配置里的YOUR_API_KEY。

Claude Code 的字段含义、环境变量优先级和更多配置项，集中在 Claude Code 文档 里，配置过程中遇到字段疑问可以直接查阅。