3份配置喂给7个AI编程助手，直接抄

折腾半年 AI 编程助手，踩了无数坑后沉淀出 3 份全局配置，覆盖 Claude Code、Trae、Qwen、Codex、OpenCode、OpenClaw、Hermes Agent 等工具，全文可复制，拉到对应章节直接抄作业。

一、开篇：为什么你需要一份好的全局配置

我是一名后端开发者，平时用 AI 编程助手写代码。去年用 OpenCode 调一个前端页面，让 AI 改个位置，它改了五六次都不对，每次都信誓旦旦说"改好了"。手动一测，bug 还在。最后我自己打开 Chrome DevTools 一步步 debug，找到根因再告诉它，一次搞定。

那次把我整炸了。不是 AI 不好用，是我没给它清晰的协作规则。就像招了个能力超强的实习生，不告诉它团队编码规范和工作流程，只能凭训练数据里的"平均表现"做事。

后来在 X（原 Twitter）上搜 Claude Code（Anthropic 推出的 AI 编程终端工具）相关信息，刷到有人说可以写一份 CLAUDE.md 规则文件，AI 启动时就自动读取。半信半疑试了试，还真有用。再后来看到 Andrej Karpathy（前特斯拉 AI 总监、OpenAI 联合创始人）相关的 skill 在 GitHub 上被国内开发者整理开源①，直接冲上 GitHub 热搜，截至今天已经 141K star 了。

半年下来，我从网上抄配置到自己迭代，踩了各种坑，沉淀出 3 份不同风格的配置。现在分享出来，说清楚各自的适用场景，以及在不同工具下如何摆放。

没配规则前，AI 会这样：

"模型会代你做错误假设，然后不假思索地执行。它们不管理自身的困惑，不寻求澄清，不呈现矛盾，不展示权衡，在应该提出异议时也不反驳。"
"它们真的很喜欢把代码和 API 搞复杂，堆砌抽象概念，不清理死代码......明明 100 行能搞定的事情，非要实现成 1000 行的臃肿架构。"
"它们有时仍会改动或删除自己理解不足的代码和注释，即使这些内容与任务本身无关。"

------ Andrej Karpathy skill 文档

CLAUDE.md / AGENTS.md 是什么：

简单说：一份写在项目根目录或全局目录下的规则文件，AI 启动时会自动读取，告诉它"你是谁、代码风格什么样、做事原则是什么"。

CLAUDE.md：Claude Code 原生支持，自然语言写规则。
AGENTS.md：OpenCode、Hermes Agent 等工具遵循的规范，格式类似。

全局配置 vs 项目配置：

全局配置（~/.xxx/） ：所有项目通用规则（语言、协作原则），设置一次永久生效。
项目配置（项目根目录） ：每个项目的独有规则（技术栈、目录结构、代码风格），随项目走。
两者同时存在时，项目级配置覆盖全局配置的冲突项，不冲突的部分叠加生效。

全局配置的价值就在这：通用规矩说一次就够了，不用每建一个项目就重写一遍。

本文有什么：3 份经过实战验证的配置文件 + 7 个 AI 编程工具的摆放指南 + 全文可复制，拉到对应章节直接抄作业。

二、先搞清楚：CLAUDE.md 和 AGENTS.md 有什么区别

CLAUDE.md：Claude Code 原生读的配置文件，自然语言写规则，放在项目根目录或全局目录下。
AGENTS.md：OpenCode、Hermes Agent 等工具遵循的规范，格式和 CLAUDE.md 类似但独立发展。
很多工具两者都支持，但优先级顺序不同。
一个简单的判断标准：Claude 系 （Claude Code 这类以 Claude 模型为核心的工具）优先读 CLAUDE.md；Agent 系（OpenCode、Hermes Agent 这类采用通用 Agent 架构的工具）优先读 AGENTS.md。看你用的工具属于哪边。

行数限制同样适用于 AGENTS.md ：两者本质都是给 LLM 的规则文件，Token 预算（AI 能同时处理的信息量上限，规则越长占得越多）和遵从度规律完全相同。超长不只占 Token 预算，更关键的是 AI 对规则的遵从度会下降------规则厚度与执行力度成反比，靠后的规则最容易被"稀释"。

官方建议：CLAUDE.md 和 AGENTS.md 均不超过 200 行

内容超 200 行时的拆分策略：

通用规矩放全局配置 （~/.claude/CLAUDE.md 或 ~/.xxx/AGENTS.md）
项目特有规则放项目根目录，两者冲突时项目级优先
仅特定场景需要的细节，移到 Skill 或路径 scoped rule，不要全塞进主文件

全局配置位置速览表：

工具	全局配置文件	路径
Claude Code	`CLAUDE.md`	`~/.claude/CLAUDE.md`
Trae	`AGENTS.md` / `CLAUDE.md`	`~/.trae/` 或项目根目录
Qwen（通义灵码）	`AGENTS.md` / `QWEN.md`	`~/.qwen/AGENTS.md` 或项目根目录
Codex	`AGENTS.md`	`~/.codex/AGENTS.md` 或项目根目录
OpenCode	`AGENTS.md`	`~/.opencode/AGENTS.md`
OpenClaw	`AGENTS.md` / `CLAUDE.md`	`~/.openclaw/`
Hermes Agent	`AGENTS.md`	`~/.hermes/AGENTS.md`
Windsurf	`.windsurfrules`	全局规则文件
Cursor	`.cursorrules`	项目级，无全局

三、Claude Code 配置推荐：12 条规则模板

适合人群：Claude Code 主力用户，追求精炼规则。

个人感受：从最初的长篇大论迭代精简到 12 条，AI 执行效果反而更好。CLAUDE.md 读写比很重要：太长 AI 在上下文中占预算但未必全用上。行数建议与拆分策略见第二节。

全文贴出：

shell 复制代码

# CLAUDE.md

## 语言
- 始终使用简体中文进行思考和回复
- 所有内部推理和外部响应必须使用简体中文

除非显式覆盖，否则本规则适用于本项目中的所有任务。
核心倾向：非琐碎工作，谨慎优先于速度；琐碎任务可自主判断处理。

## 规则一：先思后码
明确声明前提假设。遇不确定处，先提问而非盲目猜测。
存在歧义时，列出多种可能的理解路径。
若存在更简方案，应果断提出异议。

## 规则二：简单至上
仅用最少代码解决问题。杜绝任何"以防万一"的猜测性实现。
不实现需求之外的功能。不为仅用一次的代码强行设计抽象。
自检：资深工程师是否会认为此实现过度复杂？若是，立即简化。

## 规则三：外科手术式修改
仅改动绝对必要的部分。仅清理自身引入的冗余或错误。
切勿"顺手优化"相邻代码、注释或排版格式。
未出问题的代码绝不重构。严格贴合项目既有风格。

## 规则四：目标驱动执行
明确定义成功标准（验收条件）。持续迭代直至验证通过。
不要死板遵循步骤。定义成功形态并自主迭代。

## 规则五：仅将模型用于判断与裁量场景
适用于：分类、起草、摘要总结、信息提取。
切勿用于：路由分发、重试机制、确定性数据转换。
若常规代码能给出答案，就由代码处理。

## 规则六：Token 预算绝非软性建议
单任务上限：4,000 Token。单会话上限：30,000 Token。
接近预算上限时，执行上下文摘要并重置状态。
主动暴露超支。切勿静默越界消耗。

## 规则七：显式暴露冲突，拒绝折中调和
若两种模式相互矛盾，明确择一（优先更新或更经测试的版本）。
阐明选择理由。将另一处标记为待清理项。
切勿强行融合冲突范式。

## 规则八：落笔前先阅读
添加代码前，通读该文件的导出接口、直接调用方及公共工具函数。
"看似互不干涉"是最危险的判断。若不理解现有代码为何如此设计，先提问。

## 规则九：测试验证意图，而非仅验证行为
测试必须体现该行为为何重要（WHY），而非仅断言它做了什么（WHAT）。
若业务逻辑变更时测试仍不报错，则该测试设计错误。

## 规则十：关键步骤后强制设立检查点
总结已完成事项、已验证结果及剩余待办。
若无法向我清晰描述当前状态，绝不可继续推进。
若丢失上下文或逻辑偏离，立即暂停并重新声明当前状态。

## 规则十一：严格遵从代码库既有规范
在代码库内部：规范一致性 > 个人技术偏好。
若确信某规范存在实质危害，请显式提出。切勿暗中另起范式。

## 规则十二：显式失败
若有步骤被静默跳过，宣称"已完成"即为错误。
若有测试被跳过，宣称"测试通过"即为错误。
默认原则：主动暴露不确定性，绝不掩盖。

使用方式：

全局：放到 ~/.claude/CLAUDE.md（所有项目生效）
项目级：放到项目根目录 CLAUDE.md（覆盖全局）
加载优先级：项目级 > 全局。项目级缺失的规则从全局继承，冲突处以项目级为准

四、Trae / Qwen / Codex / OpenCode 配置推荐

适合人群：使用国产 AI 编程助手，以及 OpenCode 等 Agent 系工具的深度用户。

Trae （字节跳动出品）--- 国内新一代 AI IDE，支持 AGENTS.md / CLAUDE.md。
Qwen 通义灵码 （阿里出品）--- 默认自动加载 QWEN.md + AGENTS.md。
Codex （OpenAI 出品）--- 原生支持 AGENTS.md，最标准。
OpenCode --- 支持 AGENTS.md（优先级更高）和 CLAUDE.md。

以下配置为 AGENTS.md 格式，同时适用于这四类工具。配置包含完整的思考方式、开发规范、执行策略和任务管理章节。

全文贴出（放项目根目录的 AGENTS.md 或 CLAUDE.md） ：

markdown 复制代码

# AGENTS.md（通用版）

## 语言
- 始终使用简体中文进行思考和回复
- 所有内部推理和外部响应必须使用简体中文

## 核心原则

| 原则       | 含义                      |
| -------- | ----------------------- |
| **简洁优先** | 所有改动尽可能精简，实现最小代码侵入      |
| **杜绝敷衍** | 定位问题根因，不做临时修复，遵循资深工程师标准 |

## 思考方式

### 第一性原理

运用第一性原理思考，拒绝经验主义和路径盲从：
- 不要假设我完全清楚目标，保持审慎
- 从原始需求和问题出发，若目标模糊请停下讨论
- 若目标清晰但路径非最优，请直接建议更短、更低成本的办法

### 回答结构

所有回答必须分为两部分：
1. **直接执行**：按照当前要求和逻辑，直接给出任务结果
2. **深度交互**：基于底层逻辑对原始需求进行"审慎挑战"
   - 质疑动机是否偏离目标（XY 问题）
   - 分析当前路径弊端
   - 给出更优雅的替代方案

## 开发规范（按工作流程排序）

### 1. 研究优先

新增或优化功能前，**必须**先完成深度调研，严禁直接编码：

| 阶段     | 要求                          |
| ------ | --------------------------- |
| **调研** | 深入分析现有架构与数据流，检索业界生产级最佳实践    |
| **评估** | 对比至少 2 种技术方案，给出置信度评级（高/中/低） |
| **决策** | 交付可直接投产的高质量代码，禁止临时性方案       |
| **告知** | 在计划中明确阐述选择依据与权衡考量           |

### 2. 计划先行

输出代码或实施方案前，**必须**严格遵守"先计划，后执行"：
- **强制暂停** --- 先输出简明执行计划，随后**立即停止生成**
- **严禁抢跑** --- 禁止在同一回复中既输出计划又输出代码
- **等待确认** --- 必须等待用户明确回复（如"确认"）后方可开始执行

### 3. 任务拆解

- 非简单任务（含3步以上操作或架构决策），必须先进入规划模式
- 将任务逐级拆解至最小可执行单元，确保可独立完成、可明确验收
- 启动开发前，明确任务目标、成果及验收标准，确保与发起方理解一致，避免无效执行

### 4. 执行策略

**子代理策略**
- 灵活使用子代理，保持主对话上下文窗口整洁
- 将调研、探索、并行分析类工作分流给子代理执行
- 针对复杂问题，通过子代理投入更多算力解决
- 单个子代理仅负责一项任务，保证执行聚焦

**自动化修复**
- 收到缺陷报告后直接修复，无需额外指导
- 定位日志、报错信息、未通过的测试用例，完成问题修复
- 主动修复未通过的CI测试

**追求优雅**
- 针对非复杂改动，暂停并反问「有没有更优雅的实现方式？」
- 若修复方案过于粗糙或临时，遵循「基于当前全部信息，重写优雅的解决方案」
- 简单、明确的修复可跳过此环节，避免过度设计

### 5. 验证与优化

**完成前强制验证**
- 未证明功能可正常运行前，绝对不能标记任务完成
- 必要时，比对主干分支与你的改动带来的行为差异
- 自我审视：「资深工程师会认可这份交付吗？」
- 运行测试、检查日志、证明代码正确性

**偏差处理**
- 若执行出现偏差，立即停止并重新规划，不得强行推进

**自我优化**
- 收到任何修正后，将对应模式更新至 `tasks/lessons.md`
- 为自身制定规则，杜绝重复犯错
- 对沉淀的教训严格迭代，直至错误率显著下降
- 启动对应项目的会话时，先回顾历史教训

## 任务管理规范

1. **优先规划**：将带可核对检查项的执行计划写入 `tasks/todo.md`
2. **计划校验**：启动开发前，先确认计划无误
3. **进度追踪**：随执行进度同步标记任务进度、风险等，确保信息透明
4. **改动说明**：每一步操作都补充高层级的摘要说明
5. **结果归档**：在 `tasks/todo.md` 中补充结果复盘章节
6. **教训沉淀**：收到修正后，同步更新 `tasks/lessons.md`

使用方式：

Trae：项目根目录放 CLAUDE.md 或 AGENTS.md
Qwen 通义灵码：项目根目录放 CLAUDE.md 或 AGENTS.md
Codex：支持 CLAUDE.md / AGENTS.md 格式，放项目根目录
OpenCode：~/.config/opencode/AGENTS.md（也支持 CLAUDE.md，但 AGENTS.md 优先级更高）
四者都兼容 CLAUDE.md / AGENTS.md 格式，以上内容可直接复用

五、OpenClaw 配置推荐：AGENTS.md / CLAUDE.md 双兼容版

适合人群：使用 OpenClaw 的用户。

OpenClaw 是国内开发者常用的 AI 编程助手，同时支持 AGENTS.md 和 CLAUDE.md 两种配置格式。推荐使用 AGENTS.md 格式（兼容性更好），或两者同时配置。推荐使用 12 条规则版或 AGENTS.md 通用版。

使用方式：

AGENTS.md 格式：~/.openclaw/AGENTS.md
CLAUDE.md 格式：~/.openclaw/CLAUDE.md
两者同时存在时，AGENTS.md 优先级更高

配置内容可直接复用上方「四、Trae / Qwen / Codex / OpenCode 配置推荐」的通用版配置，或「三、Claude Code 配置推荐」的 12 条规则模板。

六、Hermes Agent 配置推荐：AGENTS.md 版

适合人群：使用 Hermes Agent 的深度用户。

和 OpenCode 同属 Agent 系工具，配置方式类似。推荐使用 AGENTS.md 版配置。

使用方式 ：~/.hermes/AGENTS.md

注意优先级顺序：AGENTS.md > CLAUDE.md。

配置内容可直接复用上方「四、Trae / Qwen / Codex / OpenCode 配置推荐」的通用版配置。

七、团队推广特供：八荣八耻版

适合人群：团队内推 AI 编程、新人培训、做分享。

为什么需要"八荣八耻"：团队推广不能太死板，不如直接让 AI 背八荣八耻口诀。幽默但实用：每一条都是真金白银踩出来的坑。

全文贴出：

shell 复制代码

# Claude Code 八荣八耻（实战落地版）
## 语言
- 始终使用简体中文进行思考和回复
- 所有内部推理和外部响应必须使用简体中文

## 一、以乱猜接口为耻，以认真查询为荣

调用任何函数或组件前，必须先查阅相关源文件，严禁凭经验和训练数据乱编入参。

## 二、以模糊执行为耻，以寻求确认为荣

遇到需求歧义，立刻停下并向用户提问，绝对禁止脑补补齐条件再执行。

## 三、以臆想业务为耻，以人类确认为荣

业务逻辑不在当前上下文中时，直接求证，禁止擅自推导业务因果关系。

## 四、以创造接口为耻，以复用现有为荣

写新逻辑前，必须先全局搜索现存的 utils、helpers 或基础组件，能复用绝不新建。

## 五、以跳过验证为耻，以主动测试为荣

代码产出后，必须主动执行终端测试命令。跑不通不许回复"任务完成"。

## 六、以破坏架构为耻，以遵循规范为荣

严格模仿当前项目的目录结构和命名习惯。哪怕祖传代码看着不顺眼，也必须对齐风格。

## 七、以乱猜理解为耻，以诚实无知为荣

遇到看不懂的复杂黑盒逻辑或无解报错，直接回答"我不确定/没把握"，禁止硬着头皮乱改。

## 八、以盲目修改为耻，以谨慎重构为荣

修 Bug 和加功能时，改动文件范围必须最小化，严禁夹带私货、顺手重构当前需求之外的代码。

使用方式：

放在团队知识库里，新人入职跑一遍就懂 AI 协作原则
同样可以放到 CLAUDE.md 全局位置
建议和 12 条版搭配使用：八荣八耻做团队文化，12 条做实操配置

八、Cursor / Windsurf 用户的特别说明

Cursor 的 .cursorrules：不支持全局配置文件，每个项目需单独放 .cursorrules 到根目录。不过 Cursor 编辑器设置里可以配置新建项目时的默认规则模板，算是半全局方案。

推荐从 12 条规则版复制到项目根目录 .cursorrules
或编辑器设置 → Rules → Default Rules 里配置通用规则

Windsurf 的 .windsurfrules：支持全局规则文件。

推荐使用 12 条规则版或通用版
放在 Windsurf 设置的全局规则路径下

九、配置速查表

配置版本	推荐工具	放置路径	适合谁
12 条规则模板	Claude Code / OpenClaw	`~/.claude/CLAUDE.md` / `~/.openclaw/CLAUDE.md`	Claude 主力用户
通用版（AGENTS.md/CLAUDE.md）	Trae / Qwen / Codex / OpenCode	`~/.trae/CLAUDE.md` / `~/.qwen/AGENTS.md` / `~/.codex/AGENTS.md` / `~/.config/opencode/AGENTS.md`	国产工具 / Agent 工具用户
八荣八耻版	全工具通用（团队推广）	任意全局位置	团队培训 / 新人引导

十、进阶建议：如何自定义自己的配置

不要照搬：拿我的配置做起点，删掉不认同的，加自己的原则
配置的迭代节奏：用 2-3 天感受，不合适的删除，缺什么补什么
关注工具的更新：Claude Code 和 OpenCode 都在快速迭代，配置格式可能变化
社区分享：欢迎 fork 出自己的版本，形成自己的规则风格

十一、结尾

配置是死的，思维方式是活的。AI 编程的瓶颈不在工具，在人。

我花半年踩的坑，总结起来就一句话：给 AI 清晰的规则，它才能给你超预期的结果。没有规则前，它是"凭训练数据做事"；有了规则后，它是"按你的方式协作"。

这些配置只是我的经验沉淀，不是铁律。真正好用的配置，一定是调出来的。你可以把 12 条规则和通用版合并，也可以从八荣八耻里挑几条加到自己的配置里，甚至完全重写一套。工具在迭代，你的项目在变化，配置也该跟着动。适合别人的不一定适合你，适合自己的才最重要。

希望这些配置能让你少走弯路，早点进入"AI 帮你思考，你来决策"的状态。

不知道怎么选？Claude Code 用户看第三节，国产工具用户看第四节，OpenClaw 用户看第五节，团队推广看第七节。找到你的定位，直接拉到对应章节抄作业。

你用的是哪个工具？做了哪些配置？欢迎留言讨论。

① Andrej Karpathy skill 的 GitHub 开源实现：github.com/forrestchan...