# 05. 基础配置: General、个性化、AGENTS.md

Codex 的配置分三层：当前对话里的要求、仓库里的 AGENTS.md、全局/项目设置。新手最应该先学 AGENTS.md。

## 三层配置

| 层级 | 适合放什么 | 举例 |
| --- | --- | --- |
| 当前提示词 | 这次任务临时要求 | “只改 docs 目录” |
| AGENTS.md | 仓库长期约定 | 测试命令、代码风格、安全边界 |
| 全局设置 | 个人默认偏好 | 默认语言、权限习惯、模型偏好 |

## AGENTS.md 是什么

AGENTS.md 可以理解为“写给 AI 代理看的 README”。它告诉 Codex：

- 项目结构。
- 常用命令。
- 代码风格。
- 哪些文件不能碰。
- 怎么验证完成。
- 输出格式偏好。

## 推荐 AGENTS.md 模板

```md
# AGENTS.md

## Project

这是一个 Codex 中文教程站，内容以 Markdown 和静态 HTML 为主。

## Commands

- 本地预览：python3 -m http.server 8765
- 搜索文件：rg "关键词"

## Rules

- 保留原有中转站、购买、飞书教程链接。
- 中文内容保持简洁、可直接发布。
- 不要把 API Key、token、cookie 写入仓库。
- 改动后说明文件列表和验证方式。

## Done

- 新增页面能被链接到。
- Markdown 链接尽量使用相对路径。
- 不引入不必要的网络请求或统计代码。
```

## 个性化设置怎么写

适合放：

- 默认用中文解释。
- 回答要简洁。
- 代码改动后列文件。
- 调试时给假设、实验和最小修复。

不适合放：

- 密钥。
- 私人账号密码。
- 一次性任务要求。
- 已经过期的下载地址。