企业官网建设流程全解析

1. 百万行代码库下 Claude Code 的上下文压力从哪来

百万行代码库用 Claude Code，最先撞上的不是模型能力，而是上下文窗口的物理边界。一个中等规模的微服务仓库，算上依赖库、生成代码、测试快照，轻松突破几百万行。就算模型支持 1M token，也塞不下整个代码库。所以真正的问题不是「模型够不够大」，而是「Claude Code 怎么在有限窗口里精准找到要改的那几行」。

Claude Code 走的是 agentic search 路线，不建向量索引，靠 grep、读目录、看文件这种朴素方式，像真人工程师一样一步步探索。这套方式的好处是永远基于当下代码，没有索引过期问题，冷启动几乎为零，精确匹配比向量召回更靠谱。但代价也很明确：它严重依赖一个好的起点 context。起点不清晰，Claude 就会乱翻，等摸清结构时上下文已经烧得差不多了。

我试过在一个 80 万行的 Java 单体仓库里直接cd到根目录启动 Claude Code，结果它第一轮就把根目录那份 1200 行的 CLAUDE.md 全量加载，前端、后端、infra、数据管道的规则一股脑塞进来，还没开始改代码，上下文已经用掉三成。后面让它找一个getUserById，它 grep 出三千多个匹配，一个个读文件判断，读到第十几个的时候开始忘前面看过什么，最后改错了文件。

这就是大代码库下的典型症状：不是模型笨，是 harness 没搭好。Anthropic 官方有个说法叫「The harness matters as much as the model」，harness 指的是围绕模型搭的那套外壳——CLAUDE.md、Hooks、Skills、Plugins、MCP、LSP、subagent。模型是厨师，harness 是灶台和菜刀。灶台不行，再牛的厨师也炒不出锅气。

这篇就按 harness 的分层顺序，从 CLAUDE.md 分层约定、LSP 精准跳转、subagent 任务拆分到 MCP 外部工具接入，逐层拆解百万行代码库下 Claude Code 怎么扛得住。每一层都给可复制的配置片段和验证动作，最后用 TaoToken 统一 Key 完成一次跨仓库检索的验证。

适合谁看：手上有十万行以上代码库、正在用或准备用 Claude Code 的工程师；团队里负责推广 Claude Code 的 DRI；被上下文爆炸和改一半崩掉折磨过的开发者。读完你能拿到一套可落地的分层配置方案，而不是又一篇「装上就能用」的空话。

2. TaoToken 统一 Key 接入 Claude Code 的前置准备

在拆 harness 之前，得先把接入这步搞定。Claude Code 默认走 Anthropic 官方端点，但团队里多人协作、多项目切换时，Key 管理会变成一件麻烦事。TaoToken 提供统一 Key 接入，一个 Key 覆盖模型对话、Coding Plan、API 调用，省去每个项目单独配 Key 的重复劳动。

先说清楚 TaoToken 是什么：它是一个统一的大模型 API 接入层，提供兼容 Anthropic 协议的端点，Claude Code 可以直接把 Base URL 指过来。官网在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 端点是 https://taotoken.net/api ，注意 API 地址不带 UTM 参数。

前置准备分三步：拿 Key、配环境变量、验证连通。

第一步，拿 Key。打开 https://taotoken.net/api-keys ，登录后创建一个 API Key。建议按项目或按人建多个 Key，方便后续排查是谁的请求出了问题。Key 创建后只显示一次，复制下来存到密码管理器里。

第二步，配环境变量。Claude Code 读的是ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY两个环境变量。在~/.zshrc或~/.bashrc里加上：

export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_API_KEY="sk-你的TaoToken密钥"

改完执行source ~/.zshrc让配置生效。如果你用 Windows，在系统环境变量里加这两条，或者用 PowerShell 的$env:ANTHROPIC_BASE_URL="https://taotoken.net/api"临时设置。

第三步，验证连通。跑一个最简单的请求：

curl https://taotoken.net/api/v1/messages \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{ "model": "claude-sonnet-4-20250514", "max_tokens": 100, "messages": [{"role": "user", "content": "回复 ok"}] }'

返回里带content字段就说明通了。如果返回 401，检查 Key 有没有复制全、有没有多余空格；如果返回local proxy failed，检查 Base URL 是不是写成了带路径的完整地址，正确写法就是https://taotoken.net/api，不要在后面加/v1。

这里有个容易踩的坑：Claude Code 内部会自己拼/v1/messages，所以 Base URL 只写到/api就行。我见过有人写成https://taotoken.net/api/v1，结果请求变成/api/v1/v1/messages，直接 404。

配好之后，在项目目录里跑claude启动，输入/status能看到当前用的 Base URL 和模型。确认无误再往下走。

如果你还没装 Claude Code，用 npm 装：

npm install -g @anthropic-ai/claude-code

装完claude --version确认版本。建议用 Node 18 以上，低版本会有兼容问题。

3. CLAUDE.md 分层配置与 LSP 启动参数可复制片段

这一节是全文的核心，给的是可以直接抄的配置。先说 CLAUDE.md 分层，再说 LSP 启动参数，最后给 subagent 拆分模板。

3.1 CLAUDE.md 分层约定

Anthropic 官方建议单文件控制在 200 行以内。超过 200 行，Claude 开始忽略指令的概率肉眼可见上升。大代码库规则多，解法是分层：根目录只放跨包通用约定，每个子目录放自己的 CLAUDE.md 写模块细节。Claude 会自动从当前目录往上走树，把沿途每个 CLAUDE.md 都加载进来。

根目录CLAUDE.md示例：

# 项目通用约定 ## 绝对禁止 - 不要动生产数据库，任何 schema 变更走 migration - 不要提交 .env 和密钥文件 - 提 PR 前必须跑 lint 和单测 ## 代码库地图 - services/auth/ 认证与授权服务 - services/payments/ 支付与结算 - services/orders/ 订单与履约 - packages/shared/ 跨服务共享库 - infra/ 部署与监控配置 ## 通用命令 - 全量 lint: make lint - 全量测试: make test - 单模块测试见各子目录 CLAUDE.md

子目录services/payments/CLAUDE.md示例：

# 支付服务约定 ## 本模块测试 - 单测: pytest tests/unit -x - 集成: pytest tests/integration -x --timeout=60 - lint: ruff check . && mypy . ## 关键约束 - 金额一律用 Decimal，禁止 float - 所有外部调用必须带超时和重试 - 幂等键格式: pay_{order_id}_{attempt} ## 常用入口 - 支付主流程: src/payment_service.py - 回调处理: src/callbacks.py - 对账任务: src/reconcile.py

判断某一行该不该留，有个实用检查法：问自己「如果删掉这行，Claude 还会按这条规则做事吗？」答案是「会」就删，答案是「不会」才留。每 3 到 6 个月做一次完整审查，因为模型在进化，三个月前为约束旧模型写的规则，可能在新模型上反而成了枷锁。

3.2 LSP 启动参数

LSP 让 Claude Code 按符号搜代码，而不是按字符串 grep。装法是在 Claude Code 里输入/plugin，搜lsp，找到对应语言的 code intelligence plugin 装上，再装语言服务器二进制。

TypeScript 项目：

npm install -g typescript-language-server typescript

Python 项目：

pip install pyright

Rust 项目：

rustup component add rust-analyzer

装完后在.claude/settings.json里配置 LSP 启用：

{ "lsp": { "typescript": { "command": "typescript-language-server", "args": ["--stdio"] }, "python": { "command": "pyright-langserver", "args": ["--stdio"] } }, "permissions": { "deny": [ "Read(**/node_modules/**)", "Read(**/dist/**)", "Read(**/.next/**)", "Read(**/build/**)", "Read(**/*.min.js)" ] } }

permissions.deny把生成文件、构建产物、第三方代码排除掉，提交到 git 后整个团队共享。这一步能省下大量上下文，因为 Claude 不会再浪费 token 去读压缩后的 bundle。

3.3 subagent 拆分模板

跨大量文件的改动，正确解法是把任务拆成多个会话加 subagent，不是写更长的 prompt。subagent 在独立上下文窗口里跑，读几十个文件烧的是自己的上下文，最后只把几百字摘要给主 agent。

探索型 subagent 的 prompt 模板：

你是探索型 subagent，任务是调查 [模块名] 的实现方式。 请完成： 1. 找到 [功能] 的入口文件和核心函数 2. 梳理调用链，列出涉及的文件路径 3. 记录关键数据结构定义位置 4. 找出测试文件位置和运行命令 输出格式： - 入口: 文件路径:行号 - 调用链: A -> B -> C - 数据结构: 名称 @ 文件路径 - 测试: 命令 + 文件路径 - 风险点: 需要主 agent 注意的坑 不要修改任何代码，只输出 findings 报告。

主 agent 拿到报告后再动手改，上下文干净，改起来准。会话拆分建议：会话 1 只探索写 plan 不动代码；会话 2 加载 plan 实现一个模块跑通测试；会话 3 实现下一个模块。plan 文件做桥梁串联。

4. 验证请求与成功结果：跨仓库检索实测

配置搭好后，得验证它真的生效。这一节演示一次跨仓库检索，确认 CLAUDE.md 分层、LSP、subagent 都工作正常。

4.1 验证 CLAUDE.md 分层加载

在services/payments/目录下启动 Claude Code：

cd services/payments claude

输入/context查看当前加载的上下文。你应该看到根目录 CLAUDE.md 和 payments 子目录 CLAUDE.md 都被加载，但 auth、orders 子目录的 CLAUDE.md 没有进来。如果看到所有子目录的 CLAUDE.md 都加载了，说明你是在根目录启动的，回到子目录重来。

4.2 验证 LSP 符号跳转

在 Claude Code 里输入：

用 LSP 找一下 payment_service.py 里 process_payment 函数的所有引用

如果 LSP 生效，Claude 会返回精确的引用列表，而不是 grep 出的一堆字符串匹配。对比一下：没有 LSP 时，grepprocess_payment可能返回几十个匹配，包括测试、mock、文档；有 LSP 时，只返回真正调用这个函数的代码位置。

4.3 验证 subagent 跨仓库检索

这是本文的核心验证动作。假设你要改支付服务，但需要先搞清楚订单服务怎么调用支付接口。在services/payments/下启动 Claude Code，输入：

先用 subagent 调查 services/orders/ 里怎么调用支付服务的， 写成 findings 文件，再回来告诉我调用链。

Claude 会派一个 subagent 去services/orders/探索，subagent 在独立上下文里读文件、追调用链，最后写一份 findings 报告。主 agent 拿到报告后，上下文里只有几百字摘要，而不是几十个文件的全文。

验证成功的标志：主 agent 的/context显示上下文占用没有暴涨，但你能拿到完整的调用链信息。如果上下文占用涨了很多，说明 subagent 没生效，可能是 prompt 没写清楚，或者 Claude 判断任务太简单直接自己做了。

4.4 通过 TaoToken 统一 Key 验证跨仓库请求

跨仓库检索时，请求会经过 TaoToken 的统一端点。在 Claude Code 里跑：

/batch 把 services/orders/ 里所有对 payment_client.charge 的调用 改成 payment_client.charge_with_idempotency，并跑对应测试

/batch会派出多个并行 subagent，每个在独立 git worktree 里跑、自测、开 PR。跑完后你会在终端看到一堆 PR 链接。这一步验证的是 TaoToken 统一 Key 在高并发请求下的稳定性——多个 subagent 同时发请求，Key 不会因为并发被限流。

如果/batch跑到一半报rate limit exceeded，说明 Key 的并发额度不够，去 https://taotoken.net/console 看用量，或者拆成更小的批次跑。

5. 本篇常见错误排查

这一节对照真实报错，给排查路径。每个报错都标了原因和修法。

5.1 401 Unauthorized

报错原文：

API Error: 401 {"type":"error","error":{"type":"authentication_error","message":"invalid x-api-key"}}

原因：Key 没配、配错、或者环境变量没生效。排查顺序：先echo $ANTHROPIC_API_KEY看有没有值；再看值有没有多余空格或换行；然后确认ANTHROPIC_BASE_URL是https://taotoken.net/api，不是别的地址。如果都对还是 401，去 https://taotoken.net/api-keys 重新生成一个 Key 试试。

5.2 local proxy failed

报错原文：

Error: local proxy failed: connection refused

原因：Base URL 写错了，或者网络到不了端点。先确认ANTHROPIC_BASE_URL没有多余路径，正确写法就是https://taotoken.net/api。然后curl -I https://taotoken.net/api看能不能通。如果 curl 通但 Claude Code 不通，检查是不是有别的环境变量覆盖了配置，比如ANTHROPIC_API_URL之类的旧变量。

5.3 reading choices 报错

报错原文：

Error: reading choices: unexpected end of JSON input

原因：请求返回的不是合法 JSON，通常是端点返回了 HTML 错误页。检查 Base URL 是不是漏了/api，或者多写了/v1。正确写法https://taotoken.net/api，Claude Code 自己会拼/v1/messages。如果写成https://taotoken.net/api/v1，请求变成/api/v1/v1/messages，端点返回 404 HTML，解析就报这个错。

5.4 OAuth 相关报错

报错原文：

Error: OAuth token expired, please re-authenticate

原因：Claude Code 尝试走 OAuth 登录流程，但你用的是 API Key 模式。修法：确认环境变量ANTHROPIC_API_KEY已设置，然后跑claude logout清掉 OAuth 状态，再claude重新启动。如果还报 OAuth，检查~/.claude/目录下有没有残留的 credentials 文件，删掉重来。

5.5 CC Switch / Cline MCP / Codex auth.json 三件套

如果你用 CC Switch 管理多个 Claude Code 配置，或者用 Cline 接 MCP，或者用 Codex 的 auth.json，这三处都要写全 Base URL、Key、Model ID 三件套，缺一个就连不上。

CC Switch 配置示例：

{ "name": "taotoken", "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的TaoToken密钥", "model": "claude-sonnet-4-20250514" }

Cline MCP 配置示例：

{ "mcpServers": { "taotoken": { "url": "https://taotoken.net/api", "headers": { "x-api-key": "sk-你的TaoToken密钥" }, "model": "claude-sonnet-4-20250514" } } }

Codex auth.json 示例：

{ "base_url": "https://taotoken.net/api", "api_key": "sk-你的TaoToken密钥", "model": "claude-sonnet-4-20250514" }

三件套里 Model ID 最容易漏。漏了 Model ID，请求会走默认模型，可能不是你想要的。Base URL 统一写https://taotoken.net/api，不要加/v1。

5.6 上下文爆炸排查

如果/context显示上下文占用异常高，按这个顺序查：先看是不是在根目录启动的，回到子目录；再看.claude/settings.json的permissions.deny有没有排除node_modules、dist、build；然后看 CLAUDE.md 有没有超过 200 行；最后看是不是没装 LSP，导致 Claude 用 grep 读了一堆无关文件。

6. 长期编码与 Agent 工作流的接入建议

百万行代码库下用 Claude Code，不是装上就能用，是要在 harness 上花一次性功夫的。最高 ROI 的三个动作：CLAUDE.md 砍到 200 行以内、在子目录启动 Claude、装 LSP。这三件事做完，体验立刻不一样。

如果你长期做编码和 Agent 工作流，建议走 Coding Plan，统一 Key 覆盖多个项目和多个 Agent，省去每个项目单独配 Key 的麻烦。接入地址在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。

验证模型能力用模型对话，地址在 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，里面有各语言的完整示例。API Key 管理在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。

最后给一个实用技巧：把每天做超过一次的事做成 skill。Boris 有句话叫「如果一件事你一天做超过一次，就把它做成 skill」。大项目里高频操作就那么几十种，每个都做成 skill 全队共享，效率是几何级提升。skill 还可以绑定到特定路径，比如支付部署 skill 绑定到services/payments/，只有 Claude 在这个目录下工作时才加载，避免上下文污染。

现在打开你的项目，对照 CLAUDE.md 分层、LSP、subagent 这三层逐一过一遍，看看哪几个已经做对了，哪几个还差一截。