配置与扩展

​

🌐

​

Codex 的学习曲线有两个阶段：会用解决单次任务，会配置能把 Codex 变成稳定的个人工作台和团队协作工具。​

​

​

​

​

​

​

55%

​

​

​

​

45%

​

​

先理解四层配置​

​

#oXmZdTmxnqVW text { white-space: pre; }#oXmZdTmxnqVW .fb0 { stroke: var(--N900-FG, 0.15); }#oXmZdTmxnqVW .fb0 {stroke: rgba(31,35,41, 0.15)}#oXmZdTmxnqVW .fx0 { stroke-miterlimit: 10; }#oXmZdTmxnqVW .fx0 {stroke-miterlimit: 10}#oXmZdTmxnqVW .fa1 { fill: rgb(187, 191, 196); }#oXmZdTmxnqVW .fa1 {fill: rgb(187, 191, 196)}#oXmZdTmxnqVW .fx1 { font: 400 12px MonospacedNumber, LarkHackSafariFont, LarkEmojiFont, LarkChineseQuote, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Tahoma, "PingFang SC", "Microsoft Yahei", Arial, "Hiragino Sans GB", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; }#oXmZdTmxnqVW .fx1 {font-style: normal}#oXmZdTmxnqVW .fx2 { text-anchor: middle; }#oXmZdTmxnqVW .fx2 {text-anchor: middle}#oXmZdTmxnqVW .fx3 { dominant-baseline: central; }#oXmZdTmxnqVW .fx3 {dominant-baseline: central}#oXmZdTmxnqVW .fx4 { stroke: none; }#oXmZdTmxnqVW .fx4 {stroke: none}#oXmZdTmxnqVW .fc0 { fill: var(--text-caption); }#oXmZdTmxnqVW .fc0 {fill: #646a73}#oXmZdTmxnqVW .fa2 { fill: var(--text-link-disabled); }#oXmZdTmxnqVW .fa2 {fill: rgb(187, 191, 196)}#oXmZdTmxnqVW .fa3 { fill: rgb(225, 234, 255); }#oXmZdTmxnqVW .fa3 {fill: rgb(225, 234, 255)}#oXmZdTmxnqVW .fx5 { font: 700 18px MonospacedNumber, LarkHackSafariFont, LarkEmojiFont, LarkChineseQuote, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Tahoma, "PingFang SC", "Microsoft Yahei", Arial, "Hiragino Sans GB", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; }#oXmZdTmxnqVW .fx5 {font-style: normal}#oXmZdTmxnqVW .fx6 { text-anchor: start; }#oXmZdTmxnqVW .fx6 {text-anchor: start}#oXmZdTmxnqVW .fx7 { dominant-baseline: alphabetic; }#oXmZdTmxnqVW .fx7 {dominant-baseline: alphabetic}#oXmZdTmxnqVW .fc1 { fill: rgb(0, 0, 0); }#oXmZdTmxnqVW .fc1 {fill: rgb(0, 0, 0)}#oXmZdTmxnqVW .fx8 { font: 400 16px MonospacedNumber, LarkHackSafariFont, LarkEmojiFont, LarkChineseQuote, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Tahoma, "PingFang SC", "Microsoft Yahei", Arial, "Hiragino Sans GB", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; }#oXmZdTmxnqVW .fx8 {font-style: normal}#oXmZdTmxnqVW .fx9 { font: 400 16px LarkHackSafariFont, LarkEmojiFont, "monospace", -apple-system, BlinkMacSystemFont, "Helvetica Neue", Helvetica, "Noto Sans", Tahoma, "Nimbus Sans L", Arial, "Liberation Sans", "PingFang SC", "Hiragino Sans GB", "Noto Sans CJK SC", "Source Han Sans SC", "Source Han Sans CN", "Microsoft YaHei", "Wenquanyi Micro Hei", "WenQuanYi Zen Hei", STHeiti, SimHei, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji", system-ui; }#oXmZdTmxnqVW .fx9 {font-style: normal}#oXmZdTmxnqVW .fb1 { fill: var(--N900-FG, 0.15); }#oXmZdTmxnqVW .fb1 {fill: rgba(31,35,41, 0.15)}#oXmZdTmxnqVW .fa4 { fill: var(--bg-body); }#oXmZdTmxnqVW .fa4 {fill: #fff}ABCD12345层级典型文件或入口解决的问题初学者建议项目规则本地配置扩展能力安全边界Skills、Plugins、SubagentsSandbox、Approvals、Admin policy让 Codex 理解仓库约定、测试命令、目录边界设置模型、沙盒、审批、profiles复用流程、连接外部工具、拆分复杂任务管控命令、网络、敏感文件、组织策略每个重要仓库都写一份先保守，再按任务放开权限先沉淀高频流程把高风险操作留给人工确认AGENTS.md~/.codex/config.toml

​

配置前的三条原则​

•

先写任务规则，再调工具开关。任务描述、AGENTS.md、测试命令经常比复杂配置更能提升结果质量。​

•

先小范围验证，再推广到团队。一个人的配置习惯直接复制到团队仓库，容易带来权限和环境差异问题。​

•

先保留审批，再逐步自动化。删除文件、访问网络、安装依赖、写入系统目录、读取敏感数据都应有明确理由。​

​

​

推荐的最小配置路线​

第 1 天：个人可用​

•

安装 CLI。​

•

登录并完成一次只读仓库总结。​

•

创建项目级 AGENTS.md。​

•

学会 /status、/model、/approvals、/diff、/quit 等常用命令。​

第 1 周：稳定实践​

•

为常用仓库写清测试命令和代码风格。​

•

在 ~/.codex/config.toml 中配置适合自己的默认 profile。​

•

把修测试、代码审查、文档更新沉淀成任务模板。​

•

记录每次失败案例，补到排障手册。​

第 1 个月：团队知识库​

•

把项目规则合并到仓库。​

•

把团队流程沉淀成 Skills。​

•

为 Cloud / App / CLI 制定统一截图、演示和 PR 模板。​

•

对网络访问、凭据、发布、数据库变更设置审批要求。​

常见误区​

​

#rIudJLbKoGyk text { white-space: pre; }#rIudJLbKoGyk .fb0 { stroke: var(--N900-FG, 0.15); }#rIudJLbKoGyk .fb0 {stroke: rgba(31,35,41, 0.15)}#rIudJLbKoGyk .fx0 { stroke-miterlimit: 10; }#rIudJLbKoGyk .fx0 {stroke-miterlimit: 10}#rIudJLbKoGyk .fa1 { fill: rgb(187, 191, 196); }#rIudJLbKoGyk .fa1 {fill: rgb(187, 191, 196)}#rIudJLbKoGyk .fx1 { font: 400 12px MonospacedNumber, LarkHackSafariFont, LarkEmojiFont, LarkChineseQuote, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Tahoma, "PingFang SC", "Microsoft Yahei", Arial, "Hiragino Sans GB", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; }#rIudJLbKoGyk .fx1 {font-style: normal}#rIudJLbKoGyk .fx2 { text-anchor: middle; }#rIudJLbKoGyk .fx2 {text-anchor: middle}#rIudJLbKoGyk .fx3 { dominant-baseline: central; }#rIudJLbKoGyk .fx3 {dominant-baseline: central}#rIudJLbKoGyk .fx4 { stroke: none; }#rIudJLbKoGyk .fx4 {stroke: none}#rIudJLbKoGyk .fc0 { fill: var(--text-caption); }#rIudJLbKoGyk .fc0 {fill: #646a73}#rIudJLbKoGyk .fa2 { fill: var(--text-link-disabled); }#rIudJLbKoGyk .fa2 {fill: rgb(187, 191, 196)}#rIudJLbKoGyk .fa3 { fill: rgb(225, 234, 255); }#rIudJLbKoGyk .fa3 {fill: rgb(225, 234, 255)}#rIudJLbKoGyk .fx5 { font: 700 18px MonospacedNumber, LarkHackSafariFont, LarkEmojiFont, LarkChineseQuote, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Tahoma, "PingFang SC", "Microsoft Yahei", Arial, "Hiragino Sans GB", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; }#rIudJLbKoGyk .fx5 {font-style: normal}#rIudJLbKoGyk .fx6 { text-anchor: start; }#rIudJLbKoGyk .fx6 {text-anchor: start}#rIudJLbKoGyk .fx7 { dominant-baseline: alphabetic; }#rIudJLbKoGyk .fx7 {dominant-baseline: alphabetic}#rIudJLbKoGyk .fc1 { fill: rgb(0, 0, 0); }#rIudJLbKoGyk .fc1 {fill: rgb(0, 0, 0)}#rIudJLbKoGyk .fx8 { font: 400 16px MonospacedNumber, LarkHackSafariFont, LarkEmojiFont, LarkChineseQuote, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Tahoma, "PingFang SC", "Microsoft Yahei", Arial, "Hiragino Sans GB", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; }#rIudJLbKoGyk .fx8 {font-style: normal}#rIudJLbKoGyk .fx9 { font: 400 16px LarkHackSafariFont, LarkEmojiFont, "monospace", -apple-system, BlinkMacSystemFont, "Helvetica Neue", Helvetica, "Noto Sans", Tahoma, "Nimbus Sans L", Arial, "Liberation Sans", "PingFang SC", "Hiragino Sans GB", "Noto Sans CJK SC", "Source Han Sans SC", "Source Han Sans CN", "Microsoft YaHei", "Wenquanyi Micro Hei", "WenQuanYi Zen Hei", STHeiti, SimHei, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji", system-ui; }#rIudJLbKoGyk .fx9 {font-style: normal}#rIudJLbKoGyk .fb1 { fill: var(--N900-FG, 0.15); }#rIudJLbKoGyk .fb1 {fill: rgba(31,35,41, 0.15)}#rIudJLbKoGyk .fa4 { fill: var(--bg-body); }#rIudJLbKoGyk .fa4 {fill: #fff}AB123456误区更好的做法只调模型，不写上下文只让它改代码，不让它验证直接放开全部权限把所有规则塞进提示词团队成员各配各的给 Codex 明确仓库结构、任务范围、验收标准每个任务都指定最小验证命令先用只读和审批模式，确认命令意图后再执行长期规则放到 或 Skill关键规则进仓库，个人偏好留在本地AGENTS.md

​

​

​