# Codex CLI八个暗门，别只当聊天框用 **导语：** 你可能已经知道 OpenAI 的 Codex CLI（github.com/openai/codex，开源、Rust 写的那款终端 Agent），甚至装过、跑过几次。但海外高手的用法和普通用户完全是两个物种：他们把 Codex 当成**可编排的命令行零件**接进脚本、CI 和定时任务，而不是一个聊天框。这篇文章拆 8 个大多数中文教程没讲的暗门，全部有官方文档出处，今天就能抄走。 --- ## 先交代背景：为什么是 Codex CLI Codex CLI 是 OpenAI 官方的开源终端编码 Agent，2025 年用 Rust 重写后速度和稳定性上了一个台阶，配套的 GPT-5-Codex 模型也在去年 9 月上线（据 OpenAI 官方博客）。对国内用户最关键的一点是**入口便宜**：用 ChatGPT Plus（20 美元/月）账号登录就自带额度，不需要单独按 API 计费烧钱；也可以配 API Key 按量付费。对比国内同类（通义灵码、Trae 等），Codex 的差异化不在模型 alone，而在**终端生态位**——它能在任何 SSH 到的 Linux 服务器上跑，这是多数 IDE 类工具做不到的。 安装一行搞定： ```bash npm i -g @openai/codex # 或者 macOS: brew install codex ``` 下面进入正题，8 个暗门按“冷门程度”递增排列。 --- ## 暗门一：`#` 开头秒存记忆，AGENTS.md 不用手写 大多数人知道 AGENTS.md 是项目说明书（类似 Claude Code 的 CLAUDE.md），但手写太麻烦。Codex 有个几乎没人提的交互：**在输入框里以 `#` 开头发消息**，Codex 会把这条内容自动追加写进 AGENTS.md，变成项目长期记忆。 实操： ``` # 这个仓库的测试命令是 pnpm test:ci，不要用 npm test # 所有 API 路由都在 src/server/routes/ 下，新增接口必须过 zod 校验 ``` 敲完这两句，你的项目规范就固化了，下次任何会话自动生效。适合场景：每次你纠正 Codex 一个错误认知，顺手用 `#` 存下来，一周后项目就有一份“血的教训合集”。 进阶：AGENTS.md 是**分层**的——全局放 `~/.codex/AGENTS.md`（个人偏好），仓库根放一份（项目规范），子目录还能放一份（模块细节）。Codex 会按就近原则叠加读取。规范文件格式本身是开放的，详见 agents.md 网站，Cursor 等工具也在跟进支持。 ## 暗门二：`/init` 一键生成项目说明书 接手老项目不知道怎么写 AGENTS.md？在 Codex 交互界面输入： ``` /init ``` 它会扫描仓库结构、依赖和构建脚本，自动生成一份初版 AGENTS.md。国内教程讲 Claude Code 的 `/init` 讲烂了，但 Codex 的这个同款功能知道的人极少——效果一样：先让 AI 自己总结项目，再人工补两句团队约定，5 分钟完成过去半小时的文档活。 ## 暗门三：`codex exec` 非交互模式，这才是它和 IDE 工具拉开差距的地方 这是本文**含金量最高的一招**。Codex CLI 有个 `exec` 子命令，可以完全不进交互界面、跑完就退出： ```bash # 一句话修 bug，全自动执行 codex exec "修复 src/utils/date.ts 里时区转换的越界bug，跑通测试后结束" \ --sandbox workspace-write ``` 配合 `--json` 参数还能拿到机器可读的结构化输出。这意味着你可以把它当**零件**嵌进任何自动化流程： - CI 里让 AI 先审一遍 PR 再跑人工审查 - crontab 定时让 AI 每晚清理 deprecation warning - git pre-push hook 里自动补全缺失的注释和测试 一个真实可抄的例子——提交前自动检查： ```bash # .git/hooks/pre-push changed=$(git diff --name-only origin/main | tr '\n' ' ') codex exec "审查这些改动文件是否存在安全问题或遗留 TODO，有问题直接修复：$changed" ``` Cursor、Copilot 这类 IDE 工具做不了这件事——它们被锁在编辑器里，而 Codex 天生就是命令行原住民。这是它对国内用户最大的信息差价值。 ## 暗门四：`codex resume` 会长会话不丢，配合 worktree 是双倍快乐 终端断了、Ctrl+Z 手滑、SSH 掉线——会话全没？不会。Codex 把每个会话都存在本地，恢复只要： ```bash codex resume # 弹出历史会话列表选择 codex resume --last # 直接恢复最近一次 ``` 高手玩法是和 git worktree 组合：给每个并行任务开一个 worktree，每个 worktree 里跑一个 Codex 会话，互不干扰。掉线了 resume 回来继续，相当于免费的多开。 ## 暗门五：`config.toml` + profile，一套配置吃三家模型 Codex 的行为全部由 `~/.codex/config.toml` 控制，而它**不锁 OpenAI 一家**。通过 `model_providers` 配置，可以把本地 Ollama、OpenRouter 等兼容 OpenAI 协议的服务接进来： ```toml model = "gpt-5-codex" approval_policy = "on-request" [model_providers.ollama] name = "ollama" base_url = "http://localhost:11434/v1" ``` 再配合 profile 功能，一条命令切换人格： ```toml [profiles.cheap] model = "gpt-5-mini" approval_policy = "never" [profiles.safe] approval_policy = "untrusted" sandbox_mode = "read-only" ``` ```bash codex --profile cheap # 干粗活，省钱省审批 codex --profile safe # 碰生产代码，只读模式最稳 ``` 对国内用户的现实意义：网络不稳时切本地 Ollama 模型兜底，敏感代码走内网模型，**一个工具三种姿势**。 ## 暗门六：`~/.codex/prompts` 自定义斜杠命令 把你反复用的提示词沉淀成专属命令：在 `~/.codex/prompts/` 下建一个 `review.md`，写好你的代码审查清单，之后在 Codex 里直接： ``` /review ``` 就能调用。每个 `.md` 文件就是一个斜杠命令，支持传参。把你团队多年的 codebase 惯例、审查 checklist、部署流程都做成命令库，新同事装上这个目录就继承了全团队的“AI 工作经验”。这个目录**建议直接放进 dotfiles 仓库做版本管理**——它就是你个人的 AI 资产。 ## 暗门七：`@` 引用文件 + `-i` 喂截图 两个小但高频的效率开关： - 输入 `@` 会触发**文件名自动补全**，精确把某个文件塞进上下文，避免长篇描述“就是那个处理重试逻辑的文件” - 终端里 `codex -i screenshot.png "按这张设计稿还原页面"` 可以**直接传图**，设计稿转代码、报错截图分析都在终端里闭环，不用开浏览器 ## 暗门八：沙箱与审批不是开关，是四档变速箱 多数人只知道“要不要确认”的二元选择，Codex 实际是两个维度的组合拳： | 维度 | 档位 | 含义 | |------|------|------| | 沙箱 sandbox | read-only | 只能读，最安全 | | 沙箱 sandbox | workspace-write | 可写当前目录，网默认断 | | 沙箱 sandbox | danger-full-access | 全放开，仅限容器里用 | | 审批 approval | untrusted / on-failure / on-request / never | 从步步请示到完全放权 | 正确姿势不是“全自动一时爽”，而是**按任务风险配挡**：读代码分析用 read-only + never（不烦你），改代码用 workspace-write + on-request（写文件放行、跑网络命令请示），容器里跑批才用 full-auto。`/approvals` 命令可在会话中随时换挡。 --- ## Cloud 彩蛋：本地 CLI 和云端任务是一套拳 容易被忽略的一点：Codex 不只有 CLI。在 ChatGPT 网页端的 Codex 云端模式里，可以给同一个任务**并行跑多个尝试（best-of-N）**挑最好的结果，然后把 diff 拉回本地继续用 CLI 加工。云端干重活、本地干细活，本地终端保持清爽。据 OpenAI 官方文档，这套云-本打通是 Codex 相对其他终端工具的主打卖点之一，具体额度随套餐变化，以官方页面为准。 --- ## 信息差总结 | 你知道的 | 别人不知道的 | |---------|-------------| | Codex 是个终端聊天框 | `codex exec` + `--json` 是可嵌入 CI/cron 的自动化零件 | | AGENTS.md 要手写 | `#` 开头秒存记忆，`/init` 自动生成，还能分层 | | 只会用默认配置 | `config.toml` + profile 可接 Ollama/OpenRouter，按场景切挡 | | 会话断了就重来 | `codex resume --last` 无缝续命 | | 全自动 = 效率 | 沙箱×审批四档组合才是正确姿势 | ## 行动指南 1. **今天**：`npm i -g @openai/codex`，用 ChatGPT 账号登录，在任意项目里跑一次 `/init` 2. **本周**：建 `~/.codex/prompts/` 命令库，把你的 code review 清单做成 `/review` 命令 3. **本月**：挑一个重复性维护任务（升级依赖、清 warning），用 `codex exec` 写成 cron 定时任务，体验“AI 值夜班” 4. 进阶：配一个 Ollama provider 做离线兜底，敏感仓库切内网模型 ## 参考来源 1. Codex CLI 开源仓库：https://github.com/openai/codex 2. Codex 官方文档（含 exec/config/cloud）：https://developers.openai.com/codex/ 3. AGENTS.md 开放规范：https://agents.md 4. OpenAI 官方博客（GPT-5-Codex 发布说明）：https://openai.com/blog/ --- > 本文由「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 等场景全覆盖。