https://codexer.com/tags/%E9%85%8D%E7%BD%AE/Recent content in 配置 on CodexerHugozh-cnTue, 09 Jun 2026 09:00:00 +0800https://codexer.com/posts/2026-06-09-codex-configuration-guide/Tue, 09 Jun 2026 09:00:00 +0800https://codexer.com/posts/2026-06-09-codex-configuration-guide/<h2 id="一个让人困惑的现象">一个让人困惑的现象</h2> <p>你和同事都在用 Codex，他那边运行顺畅，你的却频频报错。检查了半天，发现问题出在一个隐藏在项目根目录的 <code>AGENTS.md</code> 文件上。他写了，你没写。</p> <p>Codex 的配置体系不像传统 IDE 那样&quot;改个设置就完事&quot;。它有一套分层合并机制，指令文件、工具连接、权限控制各自独立又互相影响。搞懂这套体系，Codex 才真正从&quot;能用&quot;变成&quot;好用&quot;。</p> <h2 id="codex-的配置心智模型">Codex 的配置心智模型</h2> <p>在深入细节之前，先建立一个整体框架。Codex 的配置可以归纳为四层：</p> <table> <thead> <tr> <th>层级</th> <th>职责</th> <th>对应文件</th> </tr> </thead> <tbody> <tr> <td><strong>指令层</strong></td> <td>告诉 Codex &ldquo;怎么干活&rdquo;</td> <td><code>AGENTS.md</code></td> </tr> <tr> <td><strong>工具层</strong></td> <td>告诉 Codex &ldquo;能用什么&rdquo;</td> <td>MCP Server 配置</td> </tr> <tr> <td><strong>技能层</strong></td> <td>告诉 Codex &ldquo;怎么做特定任务&rdquo;</td> <td>Skills 目录</td> </tr> <tr> <td><strong>偏好层</strong></td> <td>告诉 Codex &ldquo;用什么模型、什么权限&rdquo;</td> <td><code>config.toml</code></td> </tr> </tbody> </table> <p>这四层各司其职，但最终会被 Codex 合并成一个统一的执行上下文。理解它们的边界和交互方式，是高效使用 Codex 的前提。</p> <h2 id="三种界面一套配置栈">三种界面，一套配置栈</h2> <p>Codex 提供了三种使用方式：CLI（命令行）、VS Code 扩展、macOS 桌面应用。很多人以为它们是三个独立产品，其实它们底层读的是同一套配置文件。</p> <p><strong>CLI</strong> 是最灵活的入口。终端里的 Codex 速度快、支持完整的 MCP 和 Skills，适合脚本化和自动化场景。</p> <p><strong>VS Code 扩展</strong> 把 Codex 的能力嵌入编辑器侧边栏。它和 CLI 共享同一套配置，你在 CLI 里配好的 AGENTS.md、MCP、Skills，在 VS Code 里直接生效。</p>