---
title: "developer_instructions 是追加，不是 AGENTS.md，也不是换内置指令"
summary: "顶层键，给会话多塞一段 developer 消息。仓库约定仍写 AGENTS.md。桌面应用自己开的线程可能根本不读这个键。"
category: config
level: starter
surfaces: [cli, app]
tags: ["developer_instructions", "AGENTS.md", "config.toml"]
canonical: /tips/developer-instructions-append/
---

# developer_instructions 是追加，不是 AGENTS.md，也不是换内置指令

顶层键，给会话多塞一段 developer 消息。仓库约定仍写 AGENTS.md。桌面应用自己开的线程可能根本不读这个键。

个人口吻、回复语言、默认要不要先列风险，可以写在用户 config 顶层，任何 `[table]` 之前：

```toml
developer_instructions = """
回答用简体中文。先给结论和风险，再给步骤。
不要把仓库约定写进这里。
"""
```

这是**追加**一段 developer 消息，不是替换 Codex 自带系统指令，也不是项目 `AGENTS.md`。团队测试命令、禁止事项、目录地图仍放仓库 `AGENTS.md`。要换掉内置系统指令，才用 `model_instructions_file`。顶层字符串键 `instructions` 是预留位，写了也不会当指令用。

写进 `[tui]` 或某个 profile 表后面，TOML 会把它收进上一张表，看起来像配了没反应。改完用 `codex debug prompt-input` 看模型真正吃到的指令。

桌面应用自己开的线程可能完全不注入这个键（Issue 仍开着）。那边要个人风格，用设置里的 Personalization，或 `~/.codex/AGENTS.md`。CLI 线程才把 `developer_instructions` 当稳定入口。

## 来源

- [OpenAI · Configuration reference](https://developers.openai.com/codex/config-reference)
- [openai/codex#11004](https://github.com/openai/codex/issues/11004)