1. 先承认问题可能不在 Prompt而在通道和规则都没就位装好 Claude Code 之后很多人第一件事就是丢一句「帮我写个接口」然后发现它生成的代码和项目规范完全对不上该构造器注入的地方用了 Autowired 字段注入时间字段随手写个 Date。与其每次在 Prompt 里重复纠正不如先检查两个前提通道是否稳定、项目里有没有 CLAUDE.md。TaoToken 解决通道打开 TaoToken 创建 Key再把 Claude Code 的 Base URL 填成 https://taotoken.net/api。接下来 CLAUDE.md 负责把你常纠正的几条规则固定下来。1.1 你看到的「不规范」可能有两层原因第一层是链路问题。官方额度有限用着用着就出现连接中断或请求失败团队多人共用一把 Key随时可能有人把它顶下线想切到某个模型又发现控制台入口藏得深。Claude Code 把这些异常包装成「对话失败」「请求被拒绝」你会误以为是自己指示得不够好。实际上它可能根本没完成一次完整请求更不要说在启动时读取项目规则了。第二层才是规则问题。项目根目录没有 CLAUDE.md或者只有一个用 /init 自动生成的骨架里面只有技术栈和依赖列表没有「禁止 Autowired 字段注入」「时间字段用 LocalDateTime」这类约束。Claude Code 每次启动对话时会尝试读取 CLAUDE.md如果文件不存在它就靠通用知识去写代码自然和你们项目的编码规范南辕北辙。1.2 为什么要先用兼容通道把对话跑稳TaoToken 定位是统一 API 兼容通道它只解决 Key 和 Base URL 的可用性不替你约束代码风格。优点是模型切换不用反复清理环境变量用量在控制台统一查看。先把 Claude Code 的 Base URL 指到 https://taotoken.net/api确保每次对话能稳定发起CLAUDE.md 才会在每次启动时被正常加载。这个顺序别反过来文件写得再好通道是断的一切白搭。2. CLAUDE.md 是什么先看 /init 能帮你生成什么2.1 每次启动对话时自动读取的项目说明书CLAUDE.md 是放在项目根目录下的说明文件名字固定、位置固定。Claude Code 每次启动对话时会自动读取它把它当作理解项目的基准技术栈是什么、代码分几层、哪些写法被禁止、常用构建命令怎么敲。它相当于把你的隐性知识变成 AI 每次开工前必须读的入职手册。CLAUDE.md 不需要严格语法只要可读的 MarkdownAI 就能解析。关键是把「禁止」和「必须」写得足够短、足够明确而不是写一大段话描述背景。很多团队把代码规范写在 Confluence 或 Wiki 里Claude Code 看不见把它放进项目根目录Claude Code 才会真的遵守。2.2 执行 /init 生成基础版别指望它覆盖编码习惯在 Claude Code 会话里输入 /init它会扫描项目里的 pom.xml、package.json、目录结构等信息自动生成一份基础 CLAUDE.md。自动生成的内容通常包括技术栈、依赖和目录说明属于「项目是什么」的维度但它无法知道你们团队的编码偏好比如字段注入被禁止、对象拷贝要用 MapStruct。这些只能人工补写。可以把 /init 的结果理解成草稿它帮你省掉写技术栈的时间但你的工作才刚开始。你和团队最想让 AI 记住的规则往往不在公开依赖里而在日常 code review 的抱怨中。下面这节就是讲怎么把这些抱怨结构化。3. 把规范一条一行写进 CLAUDE.md3.1 从最近一周的纠正对话里提炼规则与其凭借记忆写规范不如直接翻你最近的对话记录。把反复纠正的地方逐条列出来ServiceImpl 又字段注入了、DTO 拷贝又用了 BeanUtils、时间字段又冒出来一个 java.util.Date。每一条整理成一个短句写进 CLAUDE.md 的「编码规范」区。这些规则最高价值因为它们正是当前模型最容易犯的错。以 Java 17 Spring Boot 3.2.x 的 admin-service 为例一个能落地的 CLAUDE.md 骨架长这样# admin-service 项目规范 ## 技术栈 - Java 17 Spring Boot 3.2.x - MyBatis-Plus MySQL 8.0 - Redis 7.xLettuce - Nacos 2.3.x配置中心 注册中心 - Maven 3.9.x - Lombok、Hutool、MapStruct ## 目录分层 - controllerREST 接口层 - service业务接口 - service/impl业务实现 - mapperMyBatis Mapper 接口 - entity数据库实体 - dto请求/响应对象SaveDTO/UpdateDTO/QueryDTO/VO - config配置类 - commonResult、PageResult、BusinessException、ErrorCode ## 编码规范每条一行AI 严格遵循 - 禁止 Autowired 字段注入使用构造器注入 RequiredArgsConstructor - 时间字段用 LocalDateTime不要用 Date - 集合为空返回 Collections.emptyList()不要返回 null - BigDecimal 使用 BigDecimal.valueOf()不要用 new BigDecimal() - 禁止使用 BeanUtils.copyProperties对象拷贝用 MapStruct - 业务异常统一抛 BusinessException ErrorCodeController 层不写 try-catch - 全局异常由 GlobalExceptionHandler 处理catch 块必须 log.error(消息, 异常对象) - 输入参数必须 Valid 校验SQL 一律 #{} 参数化禁止 ${} 直接拼接 - 密码使用 BCrypt 加密存储日志不打印手机号、身份证等敏感信息 ## 常用命令 mvn spring-boot:run -Dspring-boot.run.profilesdev mvn test -pl admin-service mvn clean install -DskipTests3.2 每条规则独立成行不要写成长篇大论模板里「禁止 Autowired 字段注入」已经是 AI 友好的写法。AI 解析 CLAUDE.md 时对「短句规则」的遵从度明显高于长段落先写你最近纠正最多的内容再写偶尔出现的低频约定。同时控制整个文件在 500 行以内过长可能被截断后半段规范就成了摆设。4. 有规范和没规范Claude Code 生成的代码差在哪4.1 没有 CLAUDE.md 时的典型输出还是那个 UserServiceImpl当项目里没有 CLAUDE.md且你在 Prompt 里也忘记强调规范时模型很自然生成Service public class UserServiceImpl implements UserService { Autowired private UserMapper userMapper; public User getUserById(Long id) { return userMapper.selectById(id); } }字段注入、没有 Lombok 的构造器注入注解时间字段如果涉及大概率是 java.util.Date。这些代码能运行但不符合团队规范code review 时不可避免要被说一顿。这也是很多人反复在 Prompt 里纠正的原因。4.2 有 CLAUDE.md 后的输出加入规范后同样一句话输出会变成这样Service RequiredArgsConstructor public class UserServiceImpl implements UserService { private final UserMapper userMapper; public User getUserById(Long id) { return userMapper.selectById(id); } }差异一目了然构造器注入 final 字段与项目里其他 Service 实现类保持一致。之所以能稳定输出是因为 CLAUDE.md 里明确写了那条规则且模型在每次启动时确实读到了它。4.3 这个对照生效的前提是通道没断要让上面的对照成立除了文件写对还得保证 Base URL 和 Key 真实可用。Base URL 必须是 https://taotoken.net/api末尾不要带 /v1也不要把网页地址填进去API Key 从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建。写完规范后直接在 Claude Code 里生成一个小 Service 验证顺便确认通道是否正常工作。5. 维护 CLAUDE.md让 AI 自己把规则记下来5.1 一条规则一句话先写最常纠正的内容维护 CLAUDE.md 不是一次性工作而是持续累积。原则很简单一条规则只写一句不要加「为了保持代码整洁、降低维护成本……」这类铺垫。AI 对短句的遵从度远高于长段落。先写最近对话中纠正频率最高的几条比如 Autowired、Date、BeanUtils.copyProperties这几条往往占掉你 80% 的重复纠正。5.2 下次犯错误时别只改代码顺手更新文件当 Claude Code 又生成了一段字段注入代码与其只在对话里说「改成构造器注入」不如补一句「把这条规则记到 CLAUDE.md禁止 Autowired 字段注入」。它会自动更新文件。这样同一个错误不会反复出现CLAUDE.md 会从最初的技术栈骨架慢慢长成你们团队真正的编码规范字典。5.3 把 CLAUDE.md 纳入 Git规范随分支走CLAUDE.md 建议提交到 Git 仓库和代码一起接受 review。团队里任何人发现 AI 总在某个点犯错都可以提出补一条规则。新同事配置好 Claude Code 和 TaoToken 的通道后只要项目里有这份文件就能自动按团队规范生成代码不用靠口头逐条讲解。6. 跑通之后用一份带规范的输出兜底6.1 配置 Claude Code 的两套写法通道配置在 Claude Code 里通常有两种方式。一是环境变量export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENYOUR_API_KEY export ANTHROPIC_MODELYOUR_MODEL_ID二是写到 ~/.claude/settings.json 的 env 段适合跨项目持久生效{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY, ANTHROPIC_MODEL: YOUR_MODEL_ID } }YOUR_API_KEY 换成你在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建的那把模型 ID 以模型广场当时列表为准。保存后先在 模型对话 里用同一把 Key 发一条消息确认 Key 和 Base URL 没填错再回 Claude Code 里让它生成一个 Controller 验证规范是否生效。6.2 两个高频报错按这个思路查如果 Claude Code 返回认证类错误先看 API Key 是否完整复制是否确实来自 控制台 API Keys 新建的那把 Key。如果提示 404多半是 Base URL 被填成了带 /v1 的地址改成 https://taotoken.net/api 即可。注意一个区别官网落地页、模型广场用于创建 Key 和查模型 ID永远不要把它直接填进 ANTHROPIC_BASE_URL。6.3 把清理提示词的时间省下来写业务通道稳定了、CLAUDE.md 也有规则了你会发现真正省下来的不是少写几行 Prompt而是不再被那些反复出现的低级问题打断思路。CLAUDE.md 调得越细Claude Code 越接近一个「懂你们项目」的协作者。想长期高强度用可以看看 Coding Plan 是否适合你的调用量。Claude Code 的环境变量细节接入文档 里写得更全。先修通道再让 CLAUDE.md 说话顺序对了这套组合才真正省心。