企业官网建设流程全解析

1. 为什么你的 Claude Code 每次都像失忆的新人

如果你正在用 Claude Code 写业务代码，大概率经历过这个场景：周一你花了十分钟教它“批量查询用 batchQuery()，异常用 BusinessException 包装，日志用 @Slf4j 的 log，禁止 e.printStackTrace()”，它改得挺好。周二新开一个终端，同样的需求，它又给你手写 for 循环单条查库，异常直接 printStackTrace。你怀疑自己是不是卡进了时间循环。

问题不在模型能力，而在于 Claude Code 每次启动都是一个全新会话。它看不到你上个会话敲过的约定，也读不懂你 pom.xml 里的依赖版本、application.yml 里的数据源配置、代码里 @Service 注解背后的分层约定。它就像一个每天第一次来上班的新人，你必须从零开始交代：项目叫什么、Java 几、Spring Boot 几、批量操作用哪个工具类、异常怎么包装。

CLAUDE.md 就是解决这件事的。它是写给 Claude Code 的“项目交接文档”——把那些你每周重复无数遍的话写进一个文件，Claude 每次启动会话时自动读取。技术栈、编码规范、常用命令、项目特有的坑，一次性写进去，从此不用每次对话从头教。

这篇是 Claude Code 通关手册第三篇，聚焦 CLAUDE.md 与 CLAUDE.local.md 的分层记忆设计，结合 Auto Memory 与 rules 机制，演示如何通过 TaoToken 统一 Key 和 API 通道接入模型，完成项目级指令注入与本地覆盖。我会给出可直接复制的 CLAUDE.md 模板、rules 目录结构、验证命令，以及如何检查记忆加载顺序和生效范围。适合已经在用 Claude Code 但被“重复解释”折磨的开发者，也适合想把团队规范沉淀下来的技术负责人。

核心检索词先明确：CLAUDE.md 是 Claude Code 的项目级指令文件，放在项目根目录，启动时自动加载；CLAUDE.local.md 是项目级个人覆盖，不提交 Git；Auto Memory 是 Claude 自己记的笔记；.claude/rules/ 是模块化规则目录。四者配合，构成 Claude Code 的完整记忆体系。

2. TaoToken 前置：统一 Key 与 API 通道接入 Claude Code

在讲记忆体系之前，先把接入通道说清楚。Claude Code 默认走 Anthropic 官方通道，但很多团队需要统一 Key 管理、统一计费、统一模型路由。TaoToken 提供的就是这样一个统一 API 通道，官网地址 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 入口 https://taotoken.net/api 。

你需要先拿到一个 API Key。登录后进入控制台，在 API Keys 页面创建一个新 Key，复制保存。这个 Key 就是后续所有配置里的核心凭证。

Claude Code 接入 TaoToken 的方式，是通过环境变量指定 Base URL 和 API Key。Claude Code 读取的是 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY 两个变量。你可以在 shell 配置文件里写死，也可以用项目级 .env 文件管理。推荐后者，因为不同项目可能用不同 Key。

先看全局配置方式。编辑 ~/.zshrc 或 ~/.bashrc，加入：

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

保存后执行 source ~/.zshrc 生效。验证是否生效：

echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_API_KEY

如果输出正确，说明环境变量已就位。接下来启动 Claude Code，它会自动走 TaoToken 通道。

如果你不想污染全局环境，可以在项目根目录创建 .env 文件：

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

然后用 direnv 或手动 source 加载。注意 .env 要加入 .gitignore，避免 Key 泄露。

模型 ID 方面，Claude Code 默认使用 claude-sonnet-4-5 或 claude-opus-4-1 这类模型标识。TaoToken 通道兼容 Anthropic 的模型命名，你不需要改模型 ID，只要 Base URL 和 Key 正确，Claude Code 发出的请求会被正确路由。

这里有个容易踩的坑：ANTHROPIC_BASE_URL 末尾不要带斜杠。写成 https://taotoken.net/api 而不是 https://taotoken.net/api/ 。带斜杠会导致部分请求路径拼接错误，出现 404。我实测下来，去掉末尾斜杠最稳。

另一个坑是 Key 权限。TaoToken 控制台创建的 Key 默认有调用权限，但如果你在团队里用了子账号，要确认子账号的 Key 没有被限制模型范围。否则会出现 403，提示 model not allowed。

配置完成后，你可以先用一个简单请求验证通道是否通。在终端执行：

curl https://taotoken.net/api/v1/messages \ -H "x-api-key: sk-你的TaoToken密钥" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{ "model": "claude-sonnet-4-5", "max_tokens": 100, "messages": [{"role": "user", "content": "回复 OK"}] }'

如果返回 JSON 里包含 content 字段且文本是 OK，说明通道正常。这一步很关键，因为后面 CLAUDE.md 的加载验证都依赖通道可用。如果这里就报 401，先检查 Key 是否复制完整、是否有多余空格。

通道打通后，Claude Code 的所有会话都会走 TaoToken。这意味着你在 CLAUDE.md 里写的指令，会通过 TaoToken 通道发送给模型，模型返回的代码和解释也走同一条通道。统一 Key 的好处是，你可以在 TaoToken 控制台看到所有项目的调用量，方便做成本归因。

3. 可复制配置：CLAUDE.md 分层模板与 rules 目录结构

这一节是全文核心，直接给可复制的配置。先讲分层设计，再给模板，最后给 rules 目录结构。

Claude Code 的记忆分四层，加载顺序从先到后：用户级 ~/.claude/CLAUDE.md → 项目级 /your-project/CLAUDE.md → 项目级本地 /your-project/CLAUDE.local.md → 子目录级 /your-project/src/legacy/CLAUDE.md。后面的覆盖前面的冲突项。

用户级放个人偏好，所有项目继承。项目级放技术栈和团队规范。项目级本地放你个人的调试习惯，不提交 Git。子目录级放局部例外，比如老模块不想按新规范重构。

先看用户级模板，路径 ~/.claude/CLAUDE.md：

## 语言和沟通 - 用中文回答问题和写注释 - 代码中的变量名、函数名、commit message 用英文 - 解释技术概念时优先用类比和例子 ## 代码风格 - 缩进：2 个空格 - 引号：单引号（字符串） - 命名导入优先于默认导入 ## Git 习惯 - commit message 格式：type(scope): description - 不要自动 push，commit 后等我确认 ## 回答偏好 - 直接给解决方案，减少铺垫 - 代码修改时说明"为什么"改，不只是"改成什么" - 有多种方案时列出优劣对比，让我选择

再看项目级模板，路径 /your-project/CLAUDE.md：

# 项目概述 订单服务，负责订单创建、查询、状态流转。日均订单量 50 万。 # 技术栈 - Java 21 - Spring Boot 3.2 - MyBatis-Plus 3.1.0 - Redis 7.x（缓存） - MySQL 8.0 # 目录结构 - src/main/java/com/example/order/controller 接口层 - src/main/java/com/example/order/service 业务层 - src/main/java/com/example/order/mapper 数据访问层 - src/main/java/com/example/order/domain 领域模型 # 编码规范（关键差异点） - 批量查询用 JDBCTemplate.batchQuery()，禁止手写 for 循环单条查库 - 异常统一抛 BusinessException，禁止 e.printStackTrace() - 日志用 @Slf4j 的 log，禁止 System.out - 返回值用 Result<T> 包装 - 字段命名禁用下划线 # 常用命令 - 编译：mvn clean compile - 测试：mvn test - 本地启动：mvn spring-boot:run # 项目特有的坑 - 订单状态流转不要直接改状态字段，要调用 OrderService.transferStatus() - 用户 ID 从 UserContextHolder 获取，不要从参数传 - 缓存 key 统一用 CacheKeyBuilder.build() 生成，不要手拼字符串

项目级本地模板，路径 /your-project/CLAUDE.local.md：

# 本地调试偏好 - 测试数据库连接串：jdbc:mysql://localhost:3306/order_test - 本地启动时关闭 Redis 缓存，用 @Profile("local") 切换 - 调试日志级别设为 DEBUG，只对 com.example.order 包生效

记得把 CLAUDE.local.md 加入 .gitignore：

echo "CLAUDE.local.md" >> .gitignore

接下来是 rules 目录结构。当 CLAUDE.md 超过 200 行，就该拆到 .claude/rules/。目录结构如下：

your-project/ ├── .claude/ │ ├── CLAUDE.md # 总纲（可选） │ └── rules/ │ ├── code-style.md # 代码风格规范 │ ├── database.md # 数据库操作规范 │ ├── exception.md # 异常处理与日志 │ ├── transaction.md # 事务管理规范 │ ├── legacy.md # 老模块特别规则（限定路径） │ ├── testing.md # 测试规范 │ ├── security.md # 安全要求 │ ├── api-design.md # API 设计准则 │ └── git-workflow.md # Git 工作流规范

每个文件一个关注点。改代码风格只动 code-style.md，不影响其他规则。团队协作时不同成员维护各自擅长的文件。

如果需要只对特定文件生效，在文件顶部加 paths 的 YAML frontmatter。例如 .claude/rules/code-style.md：

--- paths: - "src/main/java/**/*.java" - "!src/main/java/**/legacy/**/*.java" --- # Java 代码风格规范 1. 类命名：大驼峰，Service/Controller/DAO 后缀明确 2. 方法长度：单个方法不超过 50 行，超过必须拆分 3. 依赖注入：使用构造器注入，禁止 @Autowired 字段注入 4. 注释：所有 public 方法必须有 JavaDoc，描述参数、返回值和异常 5. IDE 格式化：使用 Google Java Format 插件，提交前格式化

这个配置对所有 Java 文件生效，但排除 legacy 包。paths 支持 glob 模式，也支持 ! 排除。

没有 paths 限定的规则文件，启动时无条件加载进系统提示词。声明了 paths 的规则文件，按需加载——当且仅当 Claude 读取或处理匹配该路径的文件时，相关规则才动态加载进上下文。这是平衡上下文使用、精准控制规则生效范围的关键机制。

团队协作时，.claude/rules/ 提交到 Git，整个团队共用。个人本地偏好放 .claude/rules.local/，不提交 Git，作用和 rules/ 一样但只在你本地生效。

4. 验证请求与成功结果：检查记忆加载顺序与生效范围

配置写完，必须验证。Claude Code 提供了几个命令帮你检查记忆加载情况。

第一个命令是 /init。在项目根目录启动 Claude Code，输入 /init，它会扫描项目结构，生成一份 CLAUDE.md 初稿。这个初稿只作参考，项目特有的规范、约束、坑，需要你手动补充。我试过，/init 生成的初稿通常覆盖技术栈和目录结构，但编码规范部分很泛，必须手动改。

第二个命令是 /memory。输入 /memory，可以查看和编辑 Auto Memory 的 MEMORY.md 文件。Auto Memory 存储位置在 ~/.claude/projects/<项目名>/memory/。你可以通过交互式命令让 Claude 记住某些事，比如：

记住这个项目的测试数据库连接串是 jdbc:mysql://test-db:3306/order

Claude 会把这条记进 MEMORY.md。下次会话它会自动读取。

第三个命令是 /rules。输入 /rules，它会列出当前所有生效的规则文件及其路径限定。这是快速检查“Claude 到底听了哪些话”的好方法。如果某个 rules 文件没出现在列表里，说明路径不对或文件格式有问题。

验证记忆加载顺序，可以做一个实验。在用户级 CLAUDE.md 写“缩进用 2 个空格”，在项目级 CLAUDE.md 写“缩进用 4 个空格”，然后启动会话，让 Claude 生成一段代码。如果它用 4 个空格，说明项目级覆盖了用户级，加载顺序正确。

验证生效范围，可以用 paths 限定的规则做测试。在 .claude/rules/legacy.md 里写：

--- paths: - "src/main/java/**/legacy/**/*.java" --- # 老模块规则 - 只修 bug，不要动结构 - 不要引入新的依赖 - 不要重构方法签名

然后让 Claude 修改 legacy 包下的一个文件，它应该遵守这些规则。再让它修改非 legacy 包的文件，它不应该受这些规则影响。如果 legacy 规则在非 legacy 文件上也生效了，说明 paths 配置有误。

验证通道和记忆是否同时生效，可以做一个综合测试。启动新会话，输入：

为 OrderService 添加一个根据订单 ID 查询订单详情的方法，并实现缓存功能。

如果 CLAUDE.md 配置正确，Claude 应该自动使用 MyBatis-Plus 查询、Redis 缓存、BusinessException 包装异常、@Slf4j 打日志，不需要你额外说明。如果它还是手写 for 循环、printStackTrace，说明 CLAUDE.md 没被加载。

检查 CLAUDE.md 是否被加载，可以在文件里写一条独特指令，比如“所有返回值必须用 Result 包装，禁止直接返回实体”。然后让 Claude 写一个查询方法，看它是否遵守。如果遵守，说明加载成功。

还有一个细节：CLAUDE.md 的加载发生在会话启动时。如果你在会话中途修改了 CLAUDE.md，当前会话不会重新加载。需要退出重启，新会话才会读取最新内容。这一点很多人踩坑，改了文件发现没生效，其实是没重启。

Auto Memory 的加载时机略有不同。它会在会话启动时读取 MEMORY.md，但在会话过程中如果 Claude 发现新信息，可能会追加写入。你可以用 /memory 随时查看当前记忆内容。

最后给一个验证清单，每次配置完照着过一遍：

5. 本篇常见错排查：401、local proxy failed、reading choices、OAuth

配置过程中最容易碰到几类报错，逐个说清楚。

第一类：401 Unauthorized。报错信息通常是：

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

原因有三个：Key 复制不完整、Key 前后有空格、Key 已失效。排查方法：先 echo $ANTHROPIC_API_KEY 看输出是否和 TaoToken 控制台一致。如果一致还报 401，去控制台确认 Key 状态是否正常，有没有被禁用或删除。如果 Key 没问题，检查 ANTHROPIC_BASE_URL 是否写成了 https://taotoken.net/api 而不是其他路径。Base URL 错误也会导致 401，因为请求发到了错误的端点。

第二类：local proxy failed。报错信息：

Error: local proxy failed to start: listen tcp 127.0.0.1:xxxxx: bind: address already in use

这是 Claude Code 本地代理端口被占用。原因通常是上一个 Claude Code 进程没退干净，或者别的程序占用了同一端口。排查方法：先 ps aux | grep claude 找到残留进程，kill 掉。如果还不行，换一个端口，在环境变量里加：

export CLAUDE_CODE_PROXY_PORT=8899

选一个没被占用的端口。我实测下来，8899 和 9999 比较稳，不容易冲突。

第三类：reading choices。报错信息：

Error: reading choices: unexpected end of JSON input

这个报错通常出现在流式响应解析失败时。原因可能是网络中断、TaoToken 通道返回了非预期格式、或者模型返回被截断。排查方法：先用 curl 直接请求 /v1/messages 看是否正常。如果 curl 正常但 Claude Code 报错，检查 Claude Code 版本是否过旧，升级到最新版。如果 curl 也报错，检查请求体 JSON 是否合法，特别是 messages 数组格式。

第四类：OAuth 相关报错。报错信息：

Error: OAuth token expired, please re-authenticate

Claude Code 默认走 OAuth 登录 Anthropic 账号。如果你已经配置了 ANTHROPIC_API_KEY 和 ANTHROPIC_BASE_URL，它应该走 API Key 模式，不会触发 OAuth。如果还报 OAuth 错误，说明环境变量没生效，Claude Code 还在尝试 OAuth 登录。排查方法：确认环境变量在当前 shell 会话里可见，用 env | grep ANTHROPIC 检查。如果是在 IDE 里启动 Claude Code，IDE 可能没继承 shell 环境变量，需要在 IDE 的终端设置里手动加。

还有一个隐蔽的坑：Claude Code 的配置文件 ~/.claude/settings.json 里可能有旧的 OAuth 配置，覆盖了环境变量。检查这个文件，如果有 apiKeyHelper 或 oauth 相关字段，删掉或改成 API Key 模式。

关于 CC Switch、Cline MCP、Codex auth.json 这三件套，如果你同时用多个工具，配置要写全 Base URL、Key、Model ID。以 Codex 的 auth.json 为例，路径在 ~/.codex/auth.json：

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

Cline MCP 的配置在 VS Code 的 settings.json 里：

{ "cline.apiProvider": "anthropic", "cline.apiKey": "sk-你的TaoToken密钥", "cline.apiBaseUrl": "https://taotoken.net/api", "cline.model": "claude-sonnet-4-5" }

CC Switch 的配置类似，核心是三件套：Base URL 填 https://taotoken.net/api ，Key 填 TaoToken 密钥，Model ID 填 claude-sonnet-4-5。三者缺一不可，少一个就会报错。

排查完通道问题，再排查记忆问题。如果 CLAUDE.md 没生效，先确认文件路径对不对。项目级 CLAUDE.md 必须在项目根目录，不是 .claude/ 目录下。很多人把 CLAUDE.md 放进 .claude/ 里，结果不生效。正确路径是 /your-project/CLAUDE.md，而 rules 文件才放 /your-project/.claude/rules/。

如果 rules 文件没生效，检查 frontmatter 格式。paths 字段必须是 YAML 数组，缩进用空格不用 Tab。文件扩展名必须是 .md。文件名不影响加载，但建议用有意义的英文名。

如果 Auto Memory 没生效，检查 ~/.claude/projects/<项目名>/memory/MEMORY.md 是否存在。项目名通常是项目目录的哈希值，可以用 ls ~/.claude/projects/ 查看。如果目录不存在，说明 Auto Memory 还没初始化，让 Claude 记住一件事就会自动创建。

6. 语义一致 CTA：把统一 Key 和记忆体系用起来

配置和排查都讲完了，最后说怎么把这些用起来。

如果你主要做排障和接入，先去 TaoToken 控制台创建 API Key，然后参考接入文档把 Base URL 和 Key 配到 Claude Code 里。接入文档在 https://taotoken.net/doc ，里面有各工具的详细配置步骤。API Keys 管理页面在 https://taotoken.net/console/api-keys ，可以创建、禁用、删除 Key。

如果你想先验证模型效果，不想折腾本地配置，可以直接用模型对话页面测试。地址是 https://taotoken.net/model-chat ，在网页里选模型、输入 prompt，看返回是否符合预期。验证通过后再配到 Claude Code 里。

如果你长期用 Claude Code 做编码和 Agent 任务，建议上 Coding Plan。地址是 https://taotoken.net/coding-plan ，有更稳定的通道和更优惠的计费。Coding Plan 适合每天都要用 Claude Code 写代码的开发者，统一 Key 管理多个项目，成本可控。

Claude Code 的 Anthropic 接入专用页面在 https://taotoken.net/claude-code-anthropic ，里面有 Claude Code 专属的配置说明和常见问题。

最后给一个实用技巧：把 CLAUDE.md 当索引，不当百科。超过 200 行就拆到 rules/，用 paths 限定生效范围，零散偏好交给 Auto Memory。每月审计一次，删掉过时规则，用 /init 对比生成草稿。这样你的记忆体系不会膨胀，Claude 每次加载的都是最相关的指令。

维护策略总结成三招：最小集起步，只写技术栈、项目特有工具、最常踩的坑；痛点驱动，别预想完美；定期审计，每月检查过时、无用、冗余规则。用 @path/to/file 引入外部文档，避免重复。这样你的 CLAUDE.md 会越用越精，而不是越用越臃肿。