首页 › tips-tricks › Codex CLI高阶八式：从写码到CI一条龙

Codex CLI高阶八式：从写码到CI一条龙

导语：你大概率已经知道 OpenAI 的 Codex CLI——开源终端 Agent，npm i -g @openai/codex 一行装完，ChatGPT Plus 订阅就能直接登录使用，和 Claude Code、Gemini CLI 三分终端天下。但多数人的用法停留在“打开终端→打字→看它改文件”，相当于买了个自动挡当自行车骑。这篇带你挖 8 个海外重度玩家天天在用、中文教程却很少细讲的高阶玩法：分层记忆文件、多项目配置档、CI 流水线非交互模式、会话续命、MCP 挂载……全部可立即上手。核心信息差一句话：Codex CLI 不是聊天框的替代品，是一套可以编排进工程流程的自动化执行器。

说明：Codex CLI 迭代极快（基本周更），文中命令和开关以你本地 codex --version 对应的官方 changelog 为准；以下功能均为已发布多月的稳定特性。

先补背景：三种登录姿势，成本天差地别

装完后第一次运行 codex，它会问你用什么身份：

ChatGPT 账号登录：Plus（$20/月）、Pro（$200/月）、Team/Enterprise 均包含 Codex 用量，在额度内不再按 token 计费——对重度用户这是最划算的路径；
API Key：按 token 付费，适合想精细控成本、或要在服务器上无人值守跑的场景；
开源模型本地跑：仓库支持接 Ollama 等本地推理端点，隐私敏感场景可用，效果自然打折。

国内用户注意：ChatGPT 账号登录需要相应网络与账号条件；纯 API Key 路径对网络要求更宽松，是很多人实际在用的方案。

八个高阶玩法

第1式：`/init` 生成 AGENTS.md，搭三层记忆体系

在项目根目录运行 codex 后输入 /init，它会扫描你的代码库，自动生成一份 AGENTS.md——这是 Codex 的“项目说明书”，等价于 Claude Code 的 CLAUDE.md。但多数人只用了第一层。真正的玩法是分层：

~/.codex/AGENTS.md：全局层，写你的个人偏好（比如“默认用 TypeScript 严格模式”、“commit message 用中文”）；
仓库根目录 AGENTS.md：项目层，写构建命令、目录结构、禁止改动的文件；
子目录 AGENTS.md：模块层，Codex 处理 packages/web/ 下的文件时会自动读取该子目录里的 AGENTS.md——monorepo 项目的神器，前端和后端可以有不同的规矩。

另外两个冷知识：TUI 里输入以 # 开头的内容，是“快速记忆”入口，Codex 会把这条信息持久化进 AGENTS.md 而不是只当本轮上下文；AGENTS.md 本身已演化成一个跨工具的开放标准（agents.md），Amp、Jules 等工具也认它，写一份多处受益。

第2式：config.toml 配 profiles，一个身份管所有项目

~/.codex/config.toml 是 Codex 的控制中枢，90% 的人从没打开过。最值钱的特性是 profiles（配置档）：

[model]
model = "gpt-5-codex"

[profiles.fast]
model = "gpt-5-mini"
model_reasoning_effort = "low"

[profiles.deep]
model = "gpt-5-codex"
model_reasoning_effort = "high"

[profiles.ci]
approval_policy = "never"
sandbox_mode = "read-only"

之后 codex --profile deep 跑架构级重构，codex --profile fast 干改文档这种杂活，codex --profile ci 进流水线。信息差在于推理档位（reasoning effort）直接决定速度和费用——杂活开 low 档，同样额度能多干几倍的活。

第3式：审批三档位，别一刀切开 YOLO

Codex 的安全模型是“沙箱 + 审批”双层。在 TUI 里用 /approvals 可切换：

Read Only：只读，改任何东西都要你点头；
Auto：工作目录内可读写、可联网跑命令，出目录才请示；
Full Access：全放开，接近无沙箱。

很多人图省事直接上 Full Access（社区戏称 YOLO 模式），然后在 /bin/sh 的怒火中重建仓库。老手的做法是：日常用 Auto，只有跑测试/装依赖这类明确需要网络和全局写权限的命令才临时放行。再配一条冷门配置 tui.notifications（桌面通知），任务跑完弹通知——你切去干别的，不用盯屏干等。

第4式：`codex exec` 进 CI，终端 Agent 变流水线工人

这是和其他“AI 编程工具”拉开差距最大的一式。codex exec "你的指令" 是非交互模式：不进 TUI，跑完输出结果直接退出，专为脚本和 CI 设计。海外团队的真实用法：

# GitHub Actions 片段
- run: codex exec --profile ci \
    "检查本次 diff 是否有未处理的错误分支，输出清单"

配合 read-only 沙箱和 approval_policy = "never"，它只能看不能改，当自动 Code Review 员用，零风险。再进一步，让它在 CI 里自动修 lint、生成 changelog、给老代码补测试——都是 codex exec 一行的事。国内还普遍停留在“人肉盯终端”阶段，这一式是降维打击。

第5式：`codex resume` 续命，昨天的会话今天接着用

Codex 把每个会话存成本地 JSONL（在 ~/.codex/sessions/ 目录，按日期组织）。冷知识：

codex resume：弹出历史会话选择器，挑一个接着聊，上下文完整带回；
codex resume --last：直接续最近一次，适合“昨天改到一半睡觉了”的场景；
这些 JSONL 是纯文本，可以直接 grep——想找“上周让它改过的那个函数”，grep -r "函数名" ~/.codex/sessions/ 比翻聊天记录快得多。

长会话别忘配合 /compact：手动压缩上下文，把前面几十轮浓缩成摘要，模型注意力回血，响应明显变快。

第6式：图片直喂 + `@` 引文件，喂料效率翻倍

两个输入侧技巧：

图片：启动时 codex -i 截图.png "按这张设计稿实现页面"，或对话中直接粘贴。报错截图、UI 稿、架构图都能喂，GPT 系模型的视觉能力在这里是真用得上的；
@ 引用：输入 @ 会弹出模糊搜索的文件选择器，@src/auth/login.ts 精确指路。比口头描述“那个登录文件”靠谱一个数量级——路径给得越准，改错文件的返工越少。

第7式：`Esc-Esc` 回改 + `/model` 档位微操，对话不再推倒重来

TUI 里按两下 Esc，可以回退编辑之前的消息再重发——发现三轮前那条指令写错了，不用整个会话重来。再配合 /model 随时切模型和推理档：探索期用低推理档快速试错，定稿前切高推理档让它深度检查。这套“档位微操”是订阅额度能否撑到月底的关键，也是同额度下产出质量差 2-3 倍的原因。

第8式：MCP 双向玩法，把 Codex 接进你的工具链

Codex CLI 支持 MCP（Model Context Protocol），而且是双向的：

作为客户端：在 config.toml 里加 [mcp_servers.xxx] 段落，挂上 GitHub、数据库、内部运维工具的 MCP server，Codex 就能直接查 PR、查库、调内部 API——从“改代码的”升级成“能操作整个研发系统的”；
作为服务端：codex mcp 相关子命令可以把 Codex 本身暴露成一个 MCP server，让其他 Agent（比如你的 Claude Code）调用 Codex 干活——两个顶级 Agent 互相调用，这是 2026 年海外玩家已经在玩的多 Agent 编排。

一条龙工作流总览

flowchart TD
    A["新项目 clone 下来"] --> B["codex 内执行 /init 生成 AGENTS.md"]
    B --> C["手改三层记忆：全局层加项目层加模块层"]
    C --> D{"这次要干什么"}
    D -->|日常开发| E["交互模式：@引文件 加 图片直喂"]
    D -->|批量重构| F["codex exec 加 deep 档跑批"]
    D -->|CI 流水线| G["codex exec 加只读沙箱当审查员"]
    E --> H["按任务切 /model 推理档控成本"]
    F --> H
    G --> H
    H --> I["上下文变长就 /compact"]
    I --> J["收工后 codex resume --last 次日续聊"]

信息差总结

维度	多数人知道的	老手在用的	差距
记忆	偶尔让它"记住"	三层 AGENTS.md + `#` 快捷记忆	每个会话少重复解释半小时
配置	默认配置跑天下	profiles 按项目/任务切档	同额度产出差 2-3 倍
安全	一刀切 Full Access	Auto 档 + 按需放行 + 桌面通知	零翻车记录
用途	人肉盯终端改代码	`codex exec` 进 CI 自动审查/修 lint	解放整段盯屏时间
会话	关掉就没了	resume 续聊 + sessions JSONL 可 grep	跨天任务不断档
集成	单打独斗	MCP 双向挂载，多 Agent 编排	从工具变平台

行动指南

今晚就能做完的五步：

npm i -g @openai/codex（或 brew install --cask codex），用 ChatGPT 账号或 API Key 登录；
在你最常维护的项目里跑 /init，然后花 10 分钟手改生成的 AGENTS.md，补上构建命令和禁区；
打开 ~/.codex/config.toml，照抄本文第2式的 profiles 模板，建 fast / deep / ci 三档；
把一个日常杂活（比如“每次发版后生成 changelog”）改写成 codex exec 脚本塞进 CI；
下班前跑个半成品任务，明早 codex resume --last 验证会话续命。

参考来源

Codex CLI 官方开源仓库（含完整 docs 目录与 changelog）：https://github.com/openai/codex
OpenAI Codex 官方文档站：https://developers.openai.com/codex
AGENTS.md 跨工具开放标准：https://agents.md
npm 安装页（含各平台安装命令）：https://www.npmjs.com/package/@openai/codex
Codex 产品页（订阅计划与包含关系）：https://openai.com/codex/

本文由「51学通信」技术团队出品。51学通信由通信行业18年老兵爱卫生（微信ID: gprshome201101）维护。聚焦5G/6G核心网、3GPP标准、AI工具实战。知识星球「51学通信」提供深度技术答疑和行业洞察。

[!tip] 51学通信知识星球 星主：爱卫生（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。 星球定位：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。 当前规模：5200 篇主题 / 990 个回答，198 元/年。 加入福利：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。 AI 加持：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。

51学通信知识星球海报-扫码加入