CLAUDE.md 写了规则还是漏Claude Code 照旧乱写。切到 TaoToken 通道先去 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建 Key再把它的 Base URL 指向 https://taotoken.net/api。项目里最典型的三条违规就摆在眼前Controller 里塞业务逻辑、Mapper 层直接 SELECT *、catch 块里 e.printStackTrace()。规则明明写在 CLAUDE.md 里新开一个对话就跟没写过一样。多数人的第一反应是继续往 CLAUDE.md 里加字加到几百行结果漏得更多。真正常见的两个原因规则挂在错误的层级上子目录没有自己的 CLAUDE.md根文件又太臃肿以及模型通道不一致同一份长规则在不同通道下的处理结果不一样。先把通道对齐再逐条对规则排障才有可比性。TaoToken 在这件事里只负责两样东西——Key 和 Base URLCLAUDE.md 的层级叠加和 import 机制还是 Claude Code 自己的事别指望换了通道规则就自动生效。1. 三层 CLAUDE.md 叠加顺序没搞清规则写了也白写1.1 用户级、项目根、子目录分别在什么时候进上下文Claude Code 的加载不是读一份最新的就完事而是按范围从小到大逐层叠加。启动时先读用户级 ~/.claude/CLAUDE.md进入仓库后读项目根的 /CLAUDE.md等它真的去读某个子目录下的文件时才把 /src/module/CLAUDE.md 追加进来。三份是合并关系不是覆盖关系越靠近当前正在编辑的文件进入上下文越晚对当下这次生成的约束越直接。文件位置生效范围进入上下文的时间点~/.claude/CLAUDE.md本机所有项目Claude Code 启动即加载项目根 /CLAUDE.md当前仓库进入仓库目录后加载/src/module/CLAUDE.md该子目录下的文件读到该目录文件时追加排障时第一件事就是确认那条规则到底在哪一层。Controller 禁止业务逻辑如果它只写在项目根的 CLAUDE.md 里而根文件里同时还有二十几条别的约定它大概率会被淹没。反过来把这条挪到 Controller 所在的子目录附近命中概率会明显上来。1.2 为什么禁止 SELECT *禁止 e.printStackTrace()最先被忽略这三条规则的共同点是它们约束的是不要做什么而模型天然更愿意执行要做什么。写成数据访问层应遵循规范等于没写写成禁止 SELECT *才有明确的判定边界。再叠加上位置问题——规则被放在文件末尾、放在一大段背景介绍后面、放在子目录文件里但那个文件根本没被读到——漏掉就不奇怪了。这里还有一个容易被忽略的变量通道。同一份 CLAUDE.md换一个模型通道后表现可能变化因为长上下文的截断策略和指令跟随强度不同。所以排查顺序建议是先把通道固定成 TaoToken再改动规则文件这样每次只动一个变量才判断得出是哪边的问题。2. Claude Code 通道切到 TaoToken 之后规则对照才有基准2.1 创建 Key模型 ID 以模型广场当时列表为准打开 TaoToken 注册登录进控制台创建一把 API Key本文一律用占位符 YOUR_API_KEY 表示。创建入口在控制台的 API Keys 页面同一把 Key 后面既能给 Claude Code 用也能在模型对话里做连通性测试。模型 ID 不要凭记忆拼也不要加日期后缀自己造。以 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 里的模型广场当时列表为准广场上叫什么就填什么。这一点很关键模型 ID 写错的时候Claude Code 的报错往往不是模型不存在这么直白而是各种超时或空响应很容易被误判成规则文件的问题。2.2 在 ~/.claude/settings.json 的 env 里写三个变量Claude Code 走自定义通道改的是它自己的配置文件不是某个通用 JSON。把下面三个键放进 ~/.claude/settings.json 的 env 对象{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY, ANTHROPIC_MODEL: 以模型广场当时列表为准的模型 ID } }两个细节必须说清楚。第一ANTHROPIC_BASE_URL 只填 https://taotoken.net/api末尾不要加 /v1第二不要把带 UTM 的官网地址填进 Base URL官网地址是给人点开注册、看用量用的填进工具里必然连不通。这两条占了我见过的问题里的一大半。2.3 临时用环境变量覆盖时的写法如果不想改配置文件也可以在终端里临时导出export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENYOUR_API_KEY export ANTHROPIC_MODELYOUR_MODEL_ID临时导出的好处是排查干净——同一个终端会话里改完立刻生效退出就恢复。但要留意 shell 配置文件里可能还留着一份旧的 ANTHROPIC_AUTH_TOKEN 或别的 Base URL两处同时存在时以哪一处为准并不直观。排查规则漏读的时候先把两边都清干净只保留一份配置避免把配置冲突误判成 CLAUDE.md 失效。3. 把 Controller、SELECT *、e.printStackTrace() 改成禁止句式3.1 描述句和禁止句的差别有多大同样是表达Controller 别写业务逻辑两种写法的执行结果差得很远。下面左侧是常见的描述式写法右侧是可以直接抄进 CLAUDE.md 的禁止式写法## 分层约定描述式容易被当成背景资料 - Controller 应保持轻薄业务逻辑建议下沉到 Service。 - 数据访问应遵循团队规范注意查询性能。 - 异常处理要统一避免直接打印堆栈。 ## 分层约定禁止式判定边界清晰 - 禁止在 Controller 中编写业务逻辑、事务控制、循环计算。 - 禁止在 Mapper 与 SQL 中使用 SELECT *必须显式列出字段。 - 禁止使用 e.printStackTrace()异常必须交给统一异常处理器。 - 禁止在 Controller 中直接注入 Mapper 或 DAO。禁止式的价值在于可判定。模型看到具体方法名、具体关键字才容易在生成代码的那一刻做拦截。全部改成禁止句之后还有一个位置问题要处理把这些禁止项整体前移到 CLAUDE.md 的开头部分而不是压在文件末尾。放在末尾的规则在长对话里最容易被挤掉。3.2 用 import 拆成子文件别让根文件变成一锅粥原文里提到 import 的用法这是解决根文件太长的正解。与其在一份 CLAUDE.md 里堆三十条规则不如按主题拆开只在根文件里做引用# 项目规则索引 import ./.claude-rules/layering.md import ./.claude-rules/sql.md import ./.claude-rules/exception.md import ./.claude-rules/hutool.md ## 项目背景 这里只放最必要的技术栈与目录说明控制在十行以内拆分的边界建议按容易违规的点来切而不是按文件类型切。layering.md 只管分层与 Controller 纪律sql.md 只管 SELECT * 和索引约定exception.md 只管 e.printStackTrace() 和统一异常处理器hutool.md 只管统一使用 Hutool禁止再引入第二个工具库。子文件别互相 import避免循环每个子文件控制在几十行读起来才有约束力。3.3 子目录 CLAUDE.md 只放该模块的私有约束如果 src/module 这个模块确实有自己的特殊约定就在 /src/module/CLAUDE.md 里写并且只写这一层才成立的东西。上面那些通用禁止项放在根文件即可子目录文件重复抄一遍没有额外收益反而会在合并时产生两套措辞让模型在两版规则之间摇摆。子目录文件更值得写的是这个模块专属的包名结构、这个模块禁止引用的外部依赖、这个模块特有的命名后缀。写少一点、写准一点比写多更能被遵守。4. 通道切完还是漏先分清是报错还是规则问题4.1 401、404 与路径异常逐点核对配完通道后如果连不上先看报错类型别急着改 CLAUDE.md。401 一般和 Key 有关Key 没复制全、用了别的项目下的 Key、或者把 Key 填到了错误的字段上。404 或者请求路径看起来很奇怪八成是 Base URL 写错了——末尾多了 /v1、协议头写错、或者把带 UTM 的官网落地页粘了进去。正确的写法只有一种https://taotoken.net/api。还有一类是看着像成功但内容不对常见原因是模型 ID 填成了广场上不存在的名字。这类问题在 Claude Code 里表现为长时间无响应或返回空内容而不是明确的错误码。修法是回 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 对着模型广场的列表逐字核对确认大小写和分隔符都对。4.2 规则仍被忽略时按三层顺序回查通道确认没问题、测试消息也能正常返回那就回到规则本身。回查顺序建议这样走确认当前编辑的文件属于哪个目录对应那一层的 CLAUDE.md 是否真的存在。打开根 CLAUDE.md看禁止项是不是被压到了文件后三分之一是的话前移。检查 import 的相对路径是否写对路径错掉时子文件等同于不存在而且不会报错。检查有没有两份措辞冲突的规则比如根文件写统一 Hutool子目录写优先 Apache Commons这种冲突会让模型随机选一边。把这四步走完绝大多数写了规则还是漏的情况都能定位到具体某一层。5. 回归验证同一条指令跑两遍再回控制台对账5.1 用固定指令做前后对比验证不要靠感觉。准备一条固定的指令比如在某个 Controller 里加一个查询接口然后记录三件事有没有在 Controller 里写业务逻辑、SQL 里有没有 SELECT *、catch 块里有没有 e.printStackTrace()。改规则前跑一遍改规则后再跑一遍两次结果放在一起看才知道是规则改了有效还是这次恰好没触发。这一步必须在通道固定之后做。通道来回换规则调整的效果就没有参照物最后只能靠猜。5.2 去控制台对一下这次调用记上了没有规则验证跑通之后回控制台确认这次调用有没有正常记上。可以在 TaoToken 模型对话 里用同一把 Key 发一条测试消息确认模型 ID 和 Base URL 没填错需要长期在项目里高频跑 Claude Code可以打开 Coding Plan 看套餐是否够用Key 随时可以在 控制台 API Keys 里重新创建或轮换环境变量和 settings.json 的完整字段说明对照 Claude Code 接入文档 逐项核一遍最稳妥。一点个人体会CLAUDE.md 的排障最忌改一堆再看。通道、层级、措辞这三样一次只动一样漏读的那一条很快就会自己冒出来。