写了 CLAUDE.md 却不见效？TaoToken 通道下用 /memory 先排查-二趣网

写了 CLAUDE.md 却不见效？TaoToken 通道下用 /memory 先排查

最近遇到一个典型排障场景：项目里写了 CLAUDE.md，规则也拆到 .claude/rules/，但 Claude Code 新开会话后仍不按规则走；/compact 后一些指令像消失了。TaoToken 通道下先别急着改文件，先把请求层排除掉。你可以在 TaoToken 官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 注册并创建 Key，Base URL 填 https://taotoken.net/api。然后回到 Claude Code，用 /memory 和 /doctor 看加载结果。TaoToken 在这里只负责提供 Key 和 Base URL，/memory 与 /doctor 的排查动作仍由你在 Claude Code 里做。配通后能正常看到 /memory 列出的 CLAUDE.md 与规则文件，才谈得上判断问题出在指令本身。本文按“通道→加载→指令”的顺序，把写了 CLAUDE.md 却不见效的排查过程拆开。

一、原问题与场景：写了 CLAUDE.md 却不见效，先排除请求通道

Claude Code 的记忆机制大致分两套：一套是你主动写的 CLAUDE.md，用来放编码规范、项目架构、工作流程；另一套是 Auto Memory，由 Claude 在对话中自动积累构建命令、调试经验、代码风格偏好。Auto Memory 通常保存在~/.claude/projects/<项目标识>/memory/下，其中MEMORY.md更像索引文件，会话启动时会读取它的前 200 行或前 25KB。同一 Git 仓库的 worktree 一般共享同一份 Auto Memory，主题文件则按需读取。

这里有个关键前提：无论是启动时读取MEMORY.md，还是加载各级 CLAUDE.md，都要求 Claude Code 能正常发出请求、收到模型响应。如果请求通道没配通，会话可能看起来能打开，但记忆加载、规则注入、/compact 后的重载都会表现异常。此时你看到的现象很像“CLAUDE.md 写错了”，实际可能是 Base URL、Key 或环境变量没生效。

所以排障顺序建议改成：

先确认 Claude Code 的请求通道正常；
再进入会话，用/memory查看 CLAUDE.md 和规则文件是否被列出；
用/doctor检查配置和可精简内容；
最后才检查指令本身是否具体、是否冲突、是否在正确加载路径。

不要一上来就删 CLAUDE.md 或重写规则。先把“能不能加载”与“加载后听不听”分开。

二、TaoToken 前置：注册、创建 Key，并把 Base URL 填成 https://taotoken.net/api

如果你还没准备通道，先完成三件事：注册账号、创建 Key、记下 Base URL。打开 TaoToken 官网：

https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=

注册后进入控制台创建 API Key。Key 只用于本地配置，不要提交到 Git，也不要贴在公开截图里。本文示例里统一写成YOUR_API_KEY，你替换成自己的 Key 即可。

Base URL 一定按这个填：

https://taotoken.net/api

注意两个常见错误：第一，不要在后面加/v1；第二，不要用官网首页地址当作 Base URL。Claude Code 通过ANTHROPIC_BASE_URL或 settings.json 里的env读取它，填错层级就会导致请求发不出去，或者/memory看不到预期内容。

TaoToken 在这个流程里的角色很清晰：提供 Key 和 Base URL。/memory、/doctor、CLAUDE.md 加载路径、多级文件冲突这些排查动作，仍然在 Claude Code 里完成。不要把/memory的结果归因给通道，也不要把通道问题误判成指令问题。

三、可复制配置：settings.json 与 ANTHROPIC_* 环境变量

Claude Code 常见配置方式有两种：临时环境变量和 settings.json。两者选一种即可，不要一边改环境变量，一边又让旧配置覆盖。

先看 settings.json。用户级可以放在~/.claude/settings.json，项目级可以放在项目.claude/settings.json。示例：

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

如果你的 Claude Code 版本要求使用ANTHROPIC_API_KEY，可以替换为：

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

不建议在同一个配置里同时塞入两个不同 Key。具体用哪个字段，以你的 Claude Code 版本和接入文档为准。

再看环境变量。macOS、Linux 或 WSL 可以这样临时验证：

export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY" # 如果当前版本要求 API Key 字段，则改用： # export ANTHROPIC_API_KEY="YOUR_API_KEY"

Windows PowerShell 可以这样：

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

如果你希望长期生效，再写入 shell 配置文件或系统环境变量。改完后重新打开终端，确保 Claude Code 读取到新值。验证前不要同时保留旧的ANTHROPIC_BASE_URL，否则你很难判断到底哪一份配置在生效。

四、验证请求与成功结果：/memory、/doctor 应该看到什么

配置完成后，进入 Claude Code 会话。先运行：

/doctor

/doctor适合看当前配置、检查潜在问题，也会提示哪些内容可以精简。然后运行：

/memory

/memory是本文排查的核心动作。正常情况下，它应该列出当前加载的 CLAUDE.md 和规则文件，例如组织策略、用户全局、项目共享、本地私有等层级。你还应该能看到 Auto Memory 的开关状态、记忆目录入口，以及可浏览或编辑的记忆文件。

如果你用的是项目级 CLAUDE.md，确认它在/memory列表里出现。若项目里还用了.claude/rules/，也应该能看到对应规则文件。只有这些文件被列出，后续讨论“Claude 为什么不遵循某条规则”才有意义。

还可以做一个轻量验证：在项目根 CLAUDE.md 中写一条可验证规则，例如“回答项目结构问题时先列出 src、tests、docs 三个目录”，然后新开会话提问，看模型是否按这条规则走。不要用复杂任务验证，先用简单、可观察的指令确认加载链路。

成功结果不是“模型说它看到了”，而是/memory确实列出了文件，请求也确实返回正常。如果/memory为空、报错或只显示部分文件，先回到通道配置和加载路径排查，不要急着改指令措辞。

另外注意/compact后的行为：项目根目录的 CLAUDE.md 通常会在 compact 后自动重新加载；子目录中的 CLAUDE.md 要等下次读取该目录时才会重新加载；纯对话中临时说的指令不会持久化，应该写进 CLAUDE.md。所以/compact后感觉“指令消失”，不一定是文件写错。

五、本篇常见错排查：/compact 后指令消失、多级 CLAUDE.md 冲突与加载路径

下面按排查优先级列出常见错误。

Base URL 填错。常见写法是https://taotoken.net/api/v1或直接填官网首页。正确值应保持为https://taotoken.net/api。改完后重启 Claude Code 或新开终端。
Key 没替换或已失效。配置里仍然是YOUR_API_KEY，或者复制时带了空格、换行。去控制台重新创建 Key，再写入 settings.json 或环境变量。
settings.json 位置不对或 JSON 语法错误。用户级、项目级配置不要混用；JSON 里多一个逗号都会导致读取失败。可以用/doctor辅助确认。
多级 CLAUDE.md 冲突。组织级、用户级、项目共享、本地私有可能同时存在。若两边规则矛盾，Claude 可能随机选择其中一条。用/memory查看所有已加载文件，把冲突规则合并到同一层级，或删除不再需要的文件。
规则文件路径作用域没匹配。path-scoped rules 通常靠 frontmatter 里的 paths 控制加载范围。如果 glob 写错，编辑目标文件时规则不会进入上下文。检查.claude/rules/下的路径是否匹配你正在改的目录。
@import没有展开或深度超限。CLAUDE.md 支持@path导入，但有递归深度限制；反引号包裹的路径不会导入。导入内容同样消耗上下文，不是“免费加载”。
AGENTS.md 没接进来。仓库已有 AGENTS.md 时，可以在 CLAUDE.md 里用@AGENTS.md导入，再补 Claude Code 专属指令。不要假设 Claude 会自动读取所有同名指令文件。
/compact后子目录规则没重新加载。项目根规则通常会自动重载，子目录规则要等下次读取该目录。若某条指令只在纯对话里说过，它不会自动持久化，应写入 CLAUDE.md 或规则文件。
Auto Memory 被关闭。检查 settings.json 中是否设置了autoMemoryEnabled: false，或环境变量是否设置了CLAUDE_CODE_DISABLE_AUTO_MEMORY=1。如果自定义了autoMemoryDirectory，也要确认目录存在且可读写。
大文件导致遵循率下降。CLAUDE.md 建议保持精简，目标不超过 200 行。过长会占用更多上下文，降低规则被注意到的概率。可以用/doctor找可精简内容，再把规则拆到路径作用域文件里。

排查时记住一个判断标准：/memory能看到文件，说明加载链路基本成立；看不到文件，先查请求通道、配置路径和文件位置。加载成立之后，再去调整指令是否具体、是否可验证、是否和别处冲突。

六、语义一致 CTA：排障接入走 API Keys 与接入文档

如果你还卡在 Key 或 Base URL 这一步，先去 API Keys 页面创建或查看 Key：

https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=claude_md_memory_troubleshooting

Claude Code 的settings.json、ANTHROPIC_*环境变量、Anthropic 兼容接入细节，可以对照接入文档：

https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=claude_md_memory_troubleshooting

本文是排障与接入场景，核心动作就是：用 TaoToken 拿到 Key，把 Base URL 填成https://taotoken.net/api，回到 Claude Code 里运行/memory和/doctor。先把请求通道和加载链路跑通，再判断 CLAUDE.md 本身该怎么写。

企业官网建设流程全解析