CLAUDE.md 没被加载？TaoToken 这样填 Base URL 再查层级

把规则写进 CLAUDE.md，结果 Claude Code 完全不当回事——这个问题在社区里几乎每天都能看到。很多人的第一反应是「文件放错层级了」，然后去对照 Enterprise、Global、Project、Local 四层结构，折腾半天还是没效果。其实你漏了一个更基础的前提：模型通道是不是真的通了？如果 API 地址、密钥、模型 ID 任何一个环节有问题，模型根本不会按预期读取记忆文件，CLAUDE.md 写得再严谨也白搭。这时候可以先用 TaoToken 做一次通道自检。TaoToken 是一个统一 API 兼容通道，你只需要在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 注册并创建一把 Key，把 Claude Code 的 Base URL 填成 https://taotoken.net/api（注意不带 /v1），先确认模型能正常对话，再回来检查 CLAUDE.md 的层级位置。下面按这个顺序走一遍。

1. 排障顺序：CLAUDE.md 没加载，先查通道再查层级

1.1 症状：规则不生效，但错误不一定在记忆层

Claude Code 的配置系统分三层：记忆层（CLAUDE.md 等 Markdown 文件）、设置层（JSON / 环境变量）、技能层（Skills / MCP）。你在 CLAUDE.md 里写的规则属于记忆层，但模型的请求是否发出、走哪条 API 通道，由设置层决定。换句话说，记忆层决定模型「怎么思考」，设置层决定「怎么运行」。当规则不生效时，至少有四种可能：文件没放对位置、内容格式不对、被更高优先级的规则覆盖、或者 API 通道本身就没通。最后一种最隐蔽，因为终端可能只提示一句连接错误，但你误以为是记忆层的问题。一个很常见的现象是：你检查了所有 CLAUDE.md 的位置，甚至重新写了一遍，问题依旧。这时应该把注意力从记忆层移开，去看看设置层能不能正常工作。

1.2 TaoToken 在排障里的角色：通道自检入口

这里引出一个排障工具。TaoToken 不参与记忆文件本身的读写，它是一个 API 兼容通道，负责把 Claude Code 的请求转到可用的模型上。当你想确认「到底是记忆层没加载，还是 API 根本没通」，用 TaoToken 可以在两分钟内完成隔离：注册拿 Key、填 Base URL、发起一次对话。如果对话成功，说明设置层没问题，接下来只需要排查记忆层；如果对话失败，问题在通道，先不要去动 CLAUDE.md。注意，TaoToken 的落地页是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end ，创建 Key 也在这里；而填进 Claude Code 的 Base URL 是 https://taotoken.net/api ，两者不要混用。很多初阶用户把官网地址填进了工具，导致 404，这是另一个常见问题。先用这一招把「通道」和「记忆」分开，是效率最高的排障起点。

2. 记忆层加载顺序：Enterprise → Global → Project → Local 的合并规则

2.1 四层 CLAUDE.md 各管什么

Claude Code 的官方文档把记忆文件分成四个层级，你可以把它们想象成一套优先级递增的规则集：

本机上的~/.claude/CLAUDE.md决定你所有项目的通用习惯，比如代码风格、安全检查清单；项目的./CLAUDE.md决定这个仓库特有的构建命令、目录约定。Local 层一般用于你不希望提交到 Git 的个人覆盖。很多情况下，你只需要关注 Global 和 Project 两层，Enterprise 层只有在公司统一管控时才会出现。

2.2 加载顺序和覆盖关系

加载时，Claude Code 会从当前目录向上递归查找，把命中的所有 CLAUDE.md 都收集起来合并。顺序是 Enterprise → Global → Project → Local，后加载的层可以补充或覆盖先加载的层。这意味着，如果全局写着「统一用 TypeScript」，项目里写着「本项目用 JavaScript」，最终生效的是项目里的 JavaScript。很多人以为「没加载」，其实是「被覆盖了」。覆盖是静默发生的，不会在终端弹任何警告。所以当规则不生效时，你要先问自己：这条规则是不是在更高优先级的文件里被另一条规则压住了？尤其当你在多个层级里写了相似但不同的要求时，冲突很容易发生。

2.3 常见放错位置导致的问题

我见过三种典型情况。第一，把个人习惯写进了项目 CLAUDE.md，于是这个项目独享了你的全局偏好，其他项目却完全不受影响。第二，把项目规则放在了~/.claude/CLAUDE.md，导致你打开任何仓库，模型都会套用上一个项目的目录结构。第三，大小写拼错，在 Mac/Linux 下写了claude.md而不是CLAUDE.md，系统找不到文件。这些都属于记忆层的放置问题，需要等通道确认没问题后再来逐项排除。检查的时候别只盯着内容，先看路径和文件名，再用ls -la确认文件真实存在。

3. settings.json 里把 Claude Code 指向 TaoToken 的 Base URL

3.1 先分清官网和接口地址

这一步的关键是区分两个地址：官网落地页 TaoToken 用于注册账号、创建 API Key、查看模型广场和用量；而 Claude Code 里填的 Base URL 是接口入口，统一为 https://taotoken.net/api ，末尾不要加/v1，也不要附加任何查询参数。很多配置教程会教你写https://taotoken.net/api/v1，但 TaoToken 的兼容层不需要这个后缀，加了反而 404。记住一个原则：给人点的链接用官网，给工具用的链接用/api。两者一旦混填，就会出现「网页能打开、工具连不上」的怪现象。

3.2 可复制的 settings.json 配置

Claude Code 的settings.json位于~/.claude/settings.json，支持env字段注入环境变量。你可以这样写：

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

其中YOUR_API_KEY需要替换成你在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 创建的真实 Key。模型 ID 可以不在 JSON 里写，启动 Claude Code 后用/model选择，或执行：

claude config set preferredModel <你的模型ID>

模型 ID 以 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 模型广场当时列表为准，不要照搬其他文章里的过期写法。如果你不想用文件，也可以直接在 shell 里导出环境变量：

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

两种方式效果相同，但settings.json会持久化，建议优先。

3.3 用 claude config list 验证设置层

保存后，运行claude config list，你会看到当前生效的设置。如果ANTHROPIC_BASE_URL或ANTHROPIC_AUTH_TOKEN没有出现在列表里，说明环境变量覆盖顺序出了问题——比如系统级环境变量里还残留着旧的ANTHROPIC_BASE_URL。解决办法是在 shell 里执行unset ANTHROPIC_BASE_URL，然后重新启动 Claude Code。这一节只负责把设置层打通，打通后立刻发一条消息测试，能正常回复就可以进入下一步。如果这一步卡住，后面所有关于 CLAUDE.md 的排查都没有意义。

4. 层级核对：~/.claude/CLAUDE.md 与 ./CLAUDE.md 到底该放哪个

4.1 三条命令确认文件位置

通道确认没问题后，回来检查记忆层。先确认文件是否存在：

cat ~/.claude/CLAUDE.md

如果没有输出，说明全局文件不存在。再检查当前项目：

cat ./CLAUDE.md

以及本地覆盖文件：

cat ./CLAUDE.local.md 2>/dev/null

注意2>/dev/null是为了让不存在的文件安静地跳过。这三个文件就是绝大多数场景下 Claude Code 会读取的全部记忆层来源。如果你在这些路径之外的某个地方，比如~/CLAUDE.md，那抱歉，它不会被自动加载。另外，~/.claude目录本身可能还没创建，你可以用mkdir -p ~/.claude先建好。

4.2 优先级与覆盖：为什么规则被「吞掉」

假设全局文件里有「代码风格：TypeScript」，项目文件里也有「代码风格：TypeScript」，但项目里还多了一句「例外：src/legacy 下允许 JS」。最终模型会遵循项目级规则。这种覆盖关系不是报错，只是静默生效。你可以用 grep 验证同一条规则出现在几个层级：

grep -rn "统一用 TypeScript" ~/.claude/CLAUDE.md ./CLAUDE.md ./CLAUDE.local.md

如果结果显示两个文件都有，那高优先级（Project 或 Local）会赢。把你想强制生效的规则放到更高优先级文件里，或者删掉低优先级文件的冲突项。还有一种情况是规则本身没有问题，但被另一条语义相近的规则覆盖，比如「禁止修改 .env」和「不要动 config/」其实指向同一件事，模型可能会取后一条而忽略前一条。这种不确定性在多层合并时尤其明显。

4.3 Monorepo 下的分层放法

在 Monorepo 里，建议根目录放一份CLAUDE.md描述全仓构建和通用规范，每个子包再放各自的CLAUDE.md，描述该包特有的命令。Claude Code 会在进入子包时递归读取根目录和子包的记忆文件，合并成一份上下文。注意子包的规则不要和根目录冲突，否则会覆盖掉根目录的重要约束。如果你要把个人开发机的临时偏好放进去，可以用CLAUDE.local.md，并确认它被.gitignore忽略。这样既保持了项目规则的共享性，又留出了个人自由度。

5. 验证加载：用 /context 和 TaoToken 控制台对账单

5.1 /context 查看记忆层实际加载

启动 Claude Code，进入项目目录，输入/context。这个命令会列出当前会话加载的所有上下文文件，包括各级 CLAUDE.md。如果列表里没有你预期的那份文件，说明文件路径不对。你也可以直接问模型：「请复述你读到的 CLAUDE.md 中关于测试的规则。」如果它能准确说出来，说明记忆层生效。如果它说「我没有看到相关文件」，但/context里明明有，那可能是内容格式有问题——比如 YAML front matter 写错、文件编码不是 UTF-8。另外，某些特殊字符，比如尖括号、反引号，在 Markdown 里会被当成语法解析，也会影响模型的读取结果。

5.2 到 TaoToken 控制台确认请求已到达

对话完成后，打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 登录控制台，查看最近的调用记录。你刚才那次提问应该出现在用量明细里，并且带有正确的模型 ID、Token 消耗和请求时间。如果控制台里没有记录，说明 Claude Code 没有把请求发到 TaoToken，这时回头看 settings.json 是否被其他配置覆盖。如果记录存在但模型回答依然不遵守 CLAUDE.md，问题才真正回到记忆层本身。这一招能帮你精确区分「通道故障」和「记忆故障」，而不是靠猜。很多人在这一步才发现自己同时开了代理、环境变量和 settings.json，三处配置互相打架，请求根本没走到你预期的那条链路上。

6. 排障清单与下一课：SOUL / MEMORY 体系

6.1 六步排障清单

把上面的过程压缩成清单，方便下次快速排查：

1. 在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 创建 API Key。
2. 在~/.claude/settings.json里填https://taotoken.net/api作为 Base URL。
3. 启动 Claude Code，发一句「你好」，确认模型能回复。
4. 输入/context，检查 CLAUDE.md 是否在加载列表中。
5. 用cat和grep确认文件位置、大小写、优先级覆盖。
6. 到 TaoToken 控制台核对调用记录，排除「假通」的情况。

清单里第 3 步和第 6 步是很多人会跳过的。你可能会觉得「模型能对话就说明通道通了啊」，但有时模型是从缓存或者其他备用通道回复的，并没有真正走你配置的 Base URL。只有控制台里出现对应记录，才能算完全确认。

6.2 从 CLAUDE.md 到社区记忆体系

CLAUDE.md 只是记忆层的起点。社区在实践中又演化出了 SOUL.md（角色定位）、USER.md（用户画像）、MEMORY.md（长期记忆）和 memory/YYYY-MM-DD.md（短期记忆）这套分层方案。很多 OpenClaw 的配置系统也借鉴了它。等这一轮排障结束，你可以把全局 CLAUDE.md 当作基底，再叠加 SOUL 和 USER 文件，让模型在不同项目里自动切换人格和偏好。这些内容换一篇再展开，眼下先把「规则不生效」这个问题彻底解决掉。配置保存后，先在 TaoToken 模型对话 里用同一把 Key 发一条测试消息，确认模型 ID 和 Base URL 没填错。若要长期写代码，可以打开 Coding Plan 看套餐是否够用；Key 在 控制台 API Keys 创建。Claude Code 环境变量对照见 接入文档。