Appearance
AGENTS.md行业标准:从Claude Code迁移到Codex Plus的智能体规则文件配置指南
Claude Code Pro额度很快见顶,切换到Codex Plus主力开发时,Skills已统一管理,只需把CLAUDE.md迁移到AGENTS.md格式。AGENTS.md已获得OpenAI、Google等AI巨头支持,成为智能体规则文件的行业开放标准。
为什么需要AGENTS.md?
Claude Code有CLAUDE.md,Gemini CLI有GEMINI.md,Cursor有.cursorrules……经常切换不同编码智能体,就需要维护多套配置。
AGENTS.md应运而生——不再是某家公司的"私有协议",而是由OpenAI、Google等AI巨头和社区共同倡议的开放标准,现由Linux基金会旗下的Agentic AI Foundation负责管理。
已支持AGENTS.md的编码智能体
| 智能体 | 支持状态 |
|---|---|
| Codex | ✅ 全面支持 |
| Claude Code | ✅ 支持CLAUDE.md(兼容) |
| Gemini CLI | ✅ 支持GEMINI.md(兼容) |
| TRAE | ✅ 全面支持 |
| Qoder | ✅ 全面支持 |
AGENTS.md与README.md的区别
| 文件 | 受众 | 内容 |
|---|---|---|
| README.md | 人类开发者 | 快速入门、项目简介、贡献准则 |
| AGENTS.md | AI智能体 | 构建步骤、测试流程、开发规范 |
以前这些内容实际上也放在README中,但AGENTS.md是AI时代的做法——内容要具体、简洁、结构良好。
如何维护规则文件
项目级规则
在项目根目录创建 AGENTS.md,定义该项目的开发规范。
markdown
# AGENTS.md
## 项目概述
[项目简介]
## 构建步骤
[如何构建项目]
## 测试流程
[如何运行测试]
## 开发规范
[代码风格、命名规范等]全局规则
对于跨项目的通用规则,在用户目录创建全局配置:
bash
# Windows
C:\Users\<用户名>\.claude\agents.md
# macOS/Linux
~/.claude/agents.md从CLAUDE.md迁移
如果你已有CLAUDE.md文件,可以直接复制到项目根目录并重命名为AGENTS.md,或者在CLAUDE.md中添加AGENTS.md的兼容说明:
markdown
# CLAUDE.md / AGENTS.md
本项目同时兼容Claude Code和Codex等支持AGENTS.md标准的智能体。最佳实践
| 实践 | 说明 |
|---|---|
| 具体简洁 | 避免模糊描述,给出明确指令 |
| 结构良好 | 使用标题、列表等清晰组织 |
| 分离关注点 | README管人类,AGENTS.md管AI |
| 持续更新 | 随着项目演进更新规则 |
关键词:AGENTS.md, CLAUDE.md, Codex Plus, Claude Code, 智能体规则, 行业标准, Linux基金会
