写了 CLAUDE.md 却不见效TaoToken 通道下用 /memory 先排查最近遇到一个典型排障场景项目里写了 CLAUDE.md规则也拆到 .claude/rules/但 Claude Code 新开会话后仍不按规则走/compact 后一些指令像消失了。TaoToken 通道下先别急着改文件先把请求层排除掉。你可以在 TaoToken 官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并创建 KeyBase 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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_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_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENYOUR_API_KEY # 如果当前版本要求 API Key 字段则改用 # export ANTHROPIC_API_KEYYOUR_API_KEYWindows PowerShell 可以这样$env:ANTHROPIC_BASE_URLhttps://taotoken.net/api $env:ANTHROPIC_AUTH_TOKENYOUR_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_MEMORY1。如果自定义了autoMemoryDirectory也要确认目录存在且可读写。大文件导致遵循率下降。CLAUDE.md 建议保持精简目标不超过 200 行。过长会占用更多上下文降低规则被注意到的概率。可以用/doctor找可精简内容再把规则拆到路径作用域文件里。排查时记住一个判断标准/memory能看到文件说明加载链路基本成立看不到文件先查请求通道、配置路径和文件位置。加载成立之后再去调整指令是否具体、是否可验证、是否和别处冲突。六、语义一致 CTA排障接入走 API Keys 与接入文档如果你还卡在 Key 或 Base URL 这一步先去 API Keys 页面创建或查看 Keyhttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaude_md_memory_troubleshootingClaude Code 的settings.json、ANTHROPIC_*环境变量、Anthropic 兼容接入细节可以对照接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaude_md_memory_troubleshooting本文是排障与接入场景核心动作就是用 TaoToken 拿到 Key把 Base URL 填成https://taotoken.net/api回到 Claude Code 里运行/memory和/doctor。先把请求通道和加载链路跑通再判断 CLAUDE.md 本身该怎么写。