首页 › tips-tricks › Codex CLI八个暗门，别只当聊天框用

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 类工具做不到的。

安装一行搞定：

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 子命令，可以完全不进交互界面、跑完就退出：

# 一句话修 bug，全自动执行
codex exec "修复 src/utils/date.ts 里时区转换的越界bug，跑通测试后结束" \
  --sandbox workspace-write

配合 --json 参数还能拿到机器可读的结构化输出。这意味着你可以把它当零件嵌进任何自动化流程：

一个真实可抄的例子——提交前自动检查：

# .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 把每个会话都存在本地，恢复只要：

codex resume          # 弹出历史会话列表选择
codex resume --last   # 直接恢复最近一次

高手玩法是和 git worktree 组合：给每个并行任务开一个 worktree，每个 worktree 里跑一个 Codex 会话，互不干扰。掉线了 resume 回来继续，相当于免费的多开。

暗门五：config.toml + profile，一套配置吃三家模型

Codex 的行为全部由 ~/.codex/config.toml 控制，而它不锁 OpenAI 一家。通过 model_providers 配置，可以把本地 Ollama、OpenRouter 等兼容 OpenAI 协议的服务接进来：

model = "gpt-5-codex"
approval_policy = "on-request"

[model_providers.ollama]
name = "ollama"
base_url = "http://localhost:11434/v1"

再配合 profile 功能，一条命令切换人格：

[profiles.cheap]
model = "gpt-5-mini"
approval_policy = "never"

[profiles.safe]
approval_policy = "untrusted"
sandbox_mode = "read-only"

codex --profile cheap   # 干粗活，省钱省审批
codex --profile safe    # 碰生产代码，只读模式最稳

对国内用户的现实意义：网络不稳时切本地 Ollama 模型兜底，敏感代码走内网模型，一个工具三种姿势。

暗门六：~/.codex/prompts 自定义斜杠命令

把你反复用的提示词沉淀成专属命令：在 ~/.codex/prompts/ 下建一个 review.md，写好你的代码审查清单，之后在 Codex 里直接：

/review

就能调用。每个 .md 文件就是一个斜杠命令，支持传参。把你团队多年的 codebase 惯例、审查 checklist、部署流程都做成命令库，新同事装上这个目录就继承了全团队的“AI 工作经验”。这个目录建议直接放进 dotfiles 仓库做版本管理——它就是你个人的 AI 资产。

暗门七：@ 引用文件 + -i 喂截图

两个小但高频的效率开关：

暗门八：沙箱与审批不是开关，是四档变速箱

多数人只知道“要不要确认”的二元选择，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 等场景全覆盖。

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

📎 本分类最新文章