C++ 第 22 课：const —— 不允许随便修改的数据
2026/10/4 20:09:43
1. 为什么你的 Claude Code 每次都在“重新入职”
如果你已经在用 Claude Code 写代码，大概率经历过这个场景：新开一个终端，进入项目，第一句话不是让它干活，而是先花三分钟交代背景——“我们用的是 JPA 不是 MyBatis”“DTO 和 Entity 要分开”“接口返回统一用 Result 包装”“别动那个 legacy 目录”。说完这一长串，Claude 才终于像个“知道自己在哪”的员工，开始正常输出。
问题在于，这套交代是一次性的。关掉终端，下次再来，它又失忆了。你重复解释，它重复学习，时间全耗在“重新入职培训”上。
CLAUDE.md 就是解决这个问题的东西。一句话定义：它是 Claude Code 的项目级规则文件，每次启动 session 时被自动读取，作为初始上下文注入。你可以把它理解成给 Claude 立的一部“项目宪法”——不是通用法律，是这个项目专属的、必须遵守的约定。它持久化、跨会话、永远在线。
这篇要讲的不只是“怎么写 CLAUDE.md”，而是把它和TaoToken 统一接入串起来：用一份 CLAUDE.md 约束 Claude Code 的行为，用一套 TaoToken 的 Key 和 Base URL 统一所有工具的调用通道。前者管“怎么干活”，后者管“从哪调用”。两件事配合起来，才是完整的工程化落地。
适合谁看：正在用或准备用 Claude Code 的开发者；手上有多个 AI 编码工具、想统一入口的人；被“每次都要重新解释项目背景”折磨过的人。下面从零开始，给模板、给配置、给验证步骤，照着做就能跑通。
2. CLAUDE.md 是什么：从 /init 生成骨架到约束分层
先把这个文件的定位说清楚，再谈怎么写。
2.1 它到底在什么时候被读取
Claude Code 启动时，会按层级扫描 CLAUDE.md 并加载进上下文。层级从全局到局部依次叠加：
~/CLAUDE.md # 全局偏好，所有项目生效 ~/projects/CLAUDE.md # 团队公共规范 ~/projects/backend/CLAUDE.md # 后端专属规则 ~/projects/backend/src/CLAUDE.md # 更细的子目录规则规则是局部覆盖全局：越靠近当前工作目录的文件，优先级越高。这符合直觉——项目特有的约定应该压过个人通用偏好。
有一个必须记住的细节：文件名大小写敏感，必须是CLAUDE.md。写成claude.md或Claude.md不会被识别。macOS 文件系统默认不区分大小写，但 Claude Code 的识别逻辑区分，所以统一用大写，没有例外。
2.2 最快的起步：/init 命令
不要从空白文件开始写。进入项目根目录，启动 Claude Code 后输入：
/init它会扫描你的package.json、pom.xml、配置文件、目录结构，自动生成一份初版 CLAUDE.md。通常一两分钟就能拿到一个像样的骨架，你在此基础上删改即可。这一步的价值在于：它帮你把“项目里客观存在的事实”（技术栈、目录、命令）先填好，你只需要补“主观约定”（规范、坑、流程）。
2.3 该写什么，不该写什么
这是最容易踩错的地方。很多人第一次写，恨不得把所有规范都塞进去，结果写了两三百行，Claude 遵守得反而更差。
原因反直觉但逻辑成立：LLM 对上下文开头和结尾的注意力最高，中间内容会均匀衰减。指令堆得越多，平均注意力越低。所以核心原则是——少而精，胜过多而全。
值得写进去的：
- 运行项目的 CLI 命令（启动、测试、构建）
- 关键目录结构（哪里是业务代码，哪里是配置）
- 项目特有的约定（不是通用规范，是这个项目独有的）
- 你踩过的坑（“永远不要用字段注入，用构造器注入”）
- 需要操作前先确认的高危行为
- 标准 Workflow（比如新增 API 的固定流程）
不值得写进去的：
- 代码格式规范（交给 ESLint、Prettier、Checkstyle，别让 AI 做确定性工具能做的事）
- 通用编程最佳实践（“写清晰的变量名”这种，Claude 本来就知道）
- 过时信息（会造成混乱，定期清理比不断添加更重要）
2.4 一个真实的 Spring Boot + Vue 样本
下面这份大概二十几行，但每行信息密度都很高：
# 项目概况 用户管理系统，Spring Boot 后端 + Vue 前端。 架构变动前先讨论，不要擅自重构。 ## 技术栈 - 后端：Spring Boot 3.x / JPA / MySQL - 前端：Vue 3 + TypeScript + Vite - 认证：JWT + Spring Security ## 目录结构 - src/main/java/com/example/ — 业务代码 - src/main/resources/ — 配置文件 - frontend/src/ — Vue 前端代码 ## 常用命令 启动后端：./mvnw spring-boot:run 启动前端：cd frontend && npm run dev 跑测试：./mvnw test ## 代码约定 - Service 层统一用 @Transactional - DTO 和 Entity 严格分离，不要混用 - 接口返回统一用 Result<T> 包装 - 依赖注入用构造器注入，禁止 @Autowired 字段注入 ## 新增 API 流程 1. 先说明接口设计，等确认后再动手 2. 顺序：Controller → Service → Repository 3. 同步更新 Swagger 注解Claude 读完这份，基本就能上手干活，不用你再解释。
2.5 实时更新：用 # 命令写入记忆
Claude Code 有个很少人注意的用法：对话过程中，消息开头加#，这条规则会被自动写入 CLAUDE.md。
# 永远不要删除数据库记录，软删除用 is_deleted 字段标记不用退出对话，不用手动编辑文件。这就把 CLAUDE.md 变成了随使用不断进化的活文档——踩了新坑记进去，发现更好的约定更新进去，下次对话规则已经在那了。
2.6 不只是代码项目
写作仓库同样适用。我的写作仓库里有一份 CLAUDE.md，写着文章风格规范：用短句打节奏、哪些词不能用、结构怎么定、图片放哪个目录。每次启动 Claude Code，它直接按这套规范工作。CLAUDE.md 的本质是结构化的项目记忆，代码、写作、设计、研究项目都能用。
3. TaoToken 前置：统一 Key 与 Base URL 的接入配置
CLAUDE.md 管的是“Claude 怎么干活”，但还有一个问题没解决：它从哪个通道调用模型？如果你同时用 Claude Code、Cline、Codex 等多个工具，每个都配一套 Key 和 endpoint，管理成本很高。TaoToken 的作用就是把这些统一到一个入口。
3.1 先拿到 Key
访问控制台创建 API Key：
https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite创建后复制 Key，形如sk-xxxxxxxx。这个 Key 后面会同时用在 Claude Code 和其他工具里。
3.2 统一的两个核心参数
不管接哪个工具，本质都是改两个东西：
| 参数 | 值 | 说明 |
|---|---|---|
| Base URL | https://taotoken.net/api | 所有请求的入口地址 |
| API Key | sk-xxxxxxxx | 控制台创建的那串 |
| Model ID | 如claude-sonnet-4-5 | 按需选择，见文档 |
Base URL 注意不带 UTM 参数，就是干净的https://taotoken.net/api。UTM 只加在网页链接上用于归因，API 地址保持纯净。
3.3 Claude Code 的 settings 配置片段
Claude Code 通过环境变量或 settings 文件读取 endpoint 和 Key。推荐用 settings 文件，路径和内容如下：
{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "sk-xxxxxxxx", "ANTHROPIC_MODEL": "claude-sonnet-4-5" } }如果你用的是项目级配置，放在项目根目录的.claude/settings.json；全局配置放在~/.claude/settings.json。两者都会生效，项目级覆盖全局。
3.4 三件套：Base URL + Key + Model ID
无论你后面用 CC Switch、Cline MCP 还是 Codex 的auth.json，配置逻辑都是同一套三件套：
- Base URL：
https://taotoken.net/api - API Key：
sk-xxxxxxxx - Model ID：按文档选，比如
claude-sonnet-4-5
以 Codex 的auth.json为例，路径通常在~/.codex/auth.json：
{ "base_url": "https://taotoken.net/api", "api_key": "sk-xxxxxxxx", "model": "claude-sonnet-4-5" }Cline 的 MCP 配置则在扩展设置里填同样的三项。记住：任何工具接入，先找 Base URL、Key、Model ID 这三个字段，填对就通。
3.5 为什么要在 CLAUDE.md 里提这件事
因为 CLAUDE.md 是项目宪法，而“从哪个通道调用”是项目环境的一部分。你可以在 CLAUDE.md 里加一条约定，提醒自己或团队统一走 TaoToken：
## 环境约定 - 所有 AI 工具统一走 TaoToken 通道 - Base URL: https://taotoken.net/api - 不要在项目里硬编码其他 endpoint这样规则和行为就对齐了。
4. 验证请求：确认 endpoint 与 Base URL 生效
配置写完不算完，得验证请求真的走通了。这一步很多人跳过，结果出问题时不知道是配置错还是网络错。
4.1 用模型对话做最小验证
最直接的方式是先单独验证通道。打开模型对话页面：
https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite发一条简单消息，比如“回复 ok”。如果正常返回，说明 Key 和通道没问题。这一步把“通道问题”和“工具配置问题”隔离开——通道通了，再去查工具。
4.2 在 Claude Code 里验证
回到项目目录，启动 Claude Code，输入一个能触发模型调用的指令：
解释一下这个项目的目录结构如果它正确读取了 CLAUDE.md 里的目录说明并回答，说明两件事同时成立：CLAUDE.md 被加载了，模型通道也通了。
4.3 用 curl 直接打 API
想更底层地确认，可以直接 curl：
curl https://taotoken.net/api/v1/messages \ -H "Content-Type: application/json" \ -H "x-api-key: sk-xxxxxxxx" \ -H "anthropic-version: 2023-06-01" \ -d '{ "model": "claude-sonnet-4-5", "max_tokens": 64, "messages": [{"role": "user", "content": "回复 ok"}] }'返回里能看到content字段和正常响应，就说明 Base URL、Key、Model ID 三件套全部正确。这一步是排障的黄金标准——工具层出问题时，先用 curl 确认通道，能省掉大量猜测。
4.4 确认 CLAUDE.md 真的被读取
有个小技巧：在 CLAUDE.md 里写一条独特约定，比如“所有回复开头加[项目规则已加载]”，然后启动 Claude Code 问一句话。如果回复带了这个标记，说明文件被正确读取。验证完删掉这条即可。
5. 常见报错排查：401、local proxy failed、reading choices、OAuth
配置过程中会撞到几类典型报错，逐个拆。
5.1 401 Unauthorized
最常见。原因通常是 Key 没填对、填了多余空格、或者用了过期的 Key。
排查顺序：先确认 Key 是从控制台新复制的；再检查配置文件里有没有引号包裹导致的空格；最后用 4.3 的 curl 直接测，如果 curl 也 401，就是 Key 本身的问题，回控制台重新创建。
https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite5.2 local proxy failed
这个报错通常出现在工具尝试走本地代理但代理没起来，或者 Base URL 配成了本地地址。检查你的配置里 Base URL 是不是https://taotoken.net/api，而不是http://localhost:xxxx。如果你之前配过别的工具残留了本地代理设置，清掉。
5.3 reading choices 相关报错
这类报错一般出现在响应解析阶段，说明请求发出去了但返回格式不符合工具预期。常见原因是 Model ID 填错，或者 Base URL 少了/api路径。对照 3.2 的表格逐项核对：Base URL 必须是https://taotoken.net/api，Model ID 必须是文档里列出的有效值。
5.4 OAuth 相关报错
有些工具默认走 OAuth 登录流程，而不是 API Key。如果你看到 OAuth 报错，说明工具在尝试账号授权而非 Key 认证。解决办法是在工具设置里切换到 API Key 模式，填入三件套。Claude Code 用 settings 文件里的ANTHROPIC_API_KEY就是 Key 模式，不会触发 OAuth。
5.5 排错速查表
| 报错 | 最可能原因 | 处理 |
|---|---|---|
| 401 | Key 错误/过期/带空格 | 重新复制 Key，curl 验证 |
| local proxy failed | Base URL 指向本地 | 改为https://taotoken.net/api |
| reading choices | Model ID 错/路径缺 /api | 核对三件套 |
| OAuth | 工具走了授权模式 | 切换到 API Key 模式 |
排障时记住一个原则：先用 curl 确认通道，再查工具配置。通道通了，问题一定在工具层；通道不通，问题在 Key 或地址。
6. 把规则和通道都固定下来
到这里，两件事都落地了：CLAUDE.md 让 Claude 知道“这个项目该怎么干活”，TaoToken 让所有工具知道“从哪个通道调用”。前者是行为约束，后者是接入统一。
如果你还在频繁切换工具、每个都配一套 Key，建议把长期编码和 Agent 类的调用统一到 Coding Plan，减少重复配置：
https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite接入文档在这里，遇到配置细节可以对照：
https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite最后给一个实操建议：先 /init 生成骨架，删到只剩二十行，把三件套配好，curl 验证一次，再启动 Claude Code。顺序别乱，乱了就会在“到底是规则没生效还是通道没通”之间反复横跳。规则和通道都固定下来之后，你打开终端的第一句话，终于可以是“帮我改这个 bug”，而不是“我们项目是这样的……”。