首页 › tips-tricks › 别把Codex当聊天框：八道终端暗门

你大概率装过 OpenAI 的 Codex CLI——终端里 npm i -g @openai/codex 一行就跑起来的那个开源编码 agent。但据我观察，9 成的人装完只会敲 codex，问两个问题、让它改两行代码，就以为自己"用过了"。这就像买了台八缸跑车却只挂一挡。Codex CLI 现在已经长成一台带会话续跑、云端大脑分离、后台执行、旁路对话、持久目标、内置审查的完整终端作战平台，而这些能力九成藏在 codex features、slash 命令和 config.toml 里没人教。今天把这八道暗门一次性拆给你看，每道都附命令、预期效果和适用场景，看完你的 Codex 直接换一档。

先把背景对齐：你装的到底是哪个 Codex

很多人分不清。OpenAI 现在把"Codex"拆成了三张皮：Codex Web（云端 agent，在 chatgpt.com/codex）、Codex App / IDE 插件（桌面端和 VS Code/Cursor/Windsurf 里的那一版）、以及Codex CLI（开源、跑在你本机终端里的 Rust 程序）。本文讲的是第三个，仓库在 github.com/openai/codex，Apache-2.0 协议，文档在 developers.openai.com/codex。它最大的信息差在于：你可以用 ChatGPT 的 Plus/Pro/Team 订阅额度直接驱动它，不需要单独买 API key。装完 codex 回车，选 Sign in with ChatGPT 就行，你的 Plus 月费就把这个终端 agent 养活了。这是后面省钱逻辑的基础。

暗门一：会话不是一次性的，连"无人值守任务"都能接着跑

90% 的人以为 codex exec 是"跑完就扔"。错。Codex 会把每次会话的 transcript（对话记录）、plan history（计划历史）和 approvals（审批状态）都存到本地 ~/.codex/sessions/。

操作步骤：

预期效果：恢复后的会话保留原始上下文与之前的计划，你只需补充新指令，不用把背景重新喂一遍。这对长任务（比如昨晚让它重构、今天想继续）是降本利器——上下文不重传，token 直接省。

适用场景：多天的重构、CI 修复流水线、跨目录的大型改造。

暗门二：大脑放云端，终端在本地——Remote TUI 分离架构

这是我认为最具信息差、最该被中国开发者知道的一道门。Codex CLI 支持把 app-server（算力大脑）跑在一台机器上，TUI（终端界面）从另一台机器连过去。

操作步骤：

# 在配置好的云主机/大内存机器上启动 app server
codex app-server --listen ws://127.0.0.1:4500

# 在你的笔记本上连过去
codex --remote ws://127.0.0.1:4500

跨机器访问要绑定可达网卡并加 WebSocket 鉴权：

TOKEN_FILE="$HOME/.codex/app-server-token"
openssl rand -base64 32 > "$TOKEN_FILE"; chmod 600 "$TOKEN_FILE"
codex app-server --listen ws://0.0.0.0:4500 \
  --ws-auth capability-token --ws-token-file "$TOKEN_FILE"

# 客户端
export CODEX_REMOTE_TOKEN="$(cat "$TOKEN_FILE")"
codex --remote wss://remote-host:4500 --remote-auth-token-env CODEX_REMOTE_TOKEN

--remote 支持 ws://、wss://（TLS）、unix://（本地 socket）四种地址。最省事的姿势是 SSH 端口转发 + ws://localhost，鉴权 token 只在 wss:// 或纯本地 ws:// 上才会被接受。

预期效果：你的笔记本不需要装一堆重型依赖、不需要大显存，所有真正的模型调用和工具执行都在远端那台机器上发生，本地只负责渲染 TUI 和收发指令。

适用场景：本地机器是薄笔记本、想把"大脑"放在云上 GPU/CPU 大盘机；团队共享一台配好的开发机、各自从本地连；想要"关掉笔记本，任务还在远端跑"。

flowchart LR
    A["你的笔记本<br/>codex --remote wss://..."] -- "WebSocket + Bearer Token" --> B["云主机 / 大内存机<br/>codex app-server --listen"]
    B --> C["模型调用 + 工具执行"]
    B --> D["本地文件 / Git 仓库"]
    C --> E["结果流回 TUI"]
    D --> E
    E -. "SSH 端口转发<br/>ws://localhost" .-> A
    style A fill:#e8f4fd,stroke:#1f6feb
    style B fill:#fff4e6,stroke:#d97706

暗门三：codex features——藏起来的实验开关

极少有人知道 Codex 有个独立的 features 子命令，专门管实验性开关，而且直接写进 $CODEX_HOME/config.toml。

操作步骤：

codex features list            # 看有哪些可玩
codex features enable unified_exec   # 开启"统一执行"
codex features disable shell_snapshot

注意：features 子命令不接受 --profile，它全局生效。

预期效果：开 unified_exec 后，会话里会出现后台终端（background terminals）——长任务可以丢后台，主线索继续干别的。配合下面会讲的 /ps 看进度、/stop 一键停。shell_snapshot 等开关则影响命令执行快照的行为。

适用场景：跑测试、起 dev server、长构建这类"要等"的活，想后台化、不阻塞主线。

暗门四：/side 旁路对话 + /fork 分支探索——不污染主线索

这是 Codex 在"会话管理"上最优雅的设计。你在跑一个大重构时突然想问个不相干的小问题，又不想打断 agent 的思路。

操作步骤：

预期效果：主线索的上下文窗口保持干净，临时疑问和"如果换个方案呢"的探索都被隔离到旁支，主线不被无关内容稀释 token。

适用场景：长任务进行中插话、并行试两种实现思路、回到几步之前分叉重来。

暗门五：/goal 给 agent 装一个"持久目标"

很多人抱怨 agent "跑着跑着就忘了最初要干嘛"。Codex 的解法是显式的 goal 机制。

操作步骤：

/goal Finish the migration and keep tests green   # 设目标
/goal                                              # 看当前目标
/goal pause / /goal resume / /goal clear           # 暂停/恢复/清除

目标内容非空、最长 4000 字符；超长指令可以写进文件再把目标指向该文件。

预期效果：目标会常驻挂在线程上，agent 在多步执行中持续朝它对齐，相当于给它一个不会随上下文压缩而消失的"北极星"。

适用场景：多步骤、多文件的复杂改造；容易跑偏、需要反复拉回主线的任务。

暗门六：/usage + /fast + ChatGPT 订阅额度——把成本看穿

既然默认走 ChatGPT 订阅，那额度怎么花、花在哪、能不能省，就是关键信息差。

操作步骤：

预期效果：在 TUI 内就能实时看到配额消耗节奏，按"重要任务用 Fast、杂活用普通档、出图走 API"的分层把每一分订阅额度花在刀刃上。

适用场景：月底额度吃紧、想搞清楚哪个任务最烧 token、批量图像生产。

暗门七：/review 专职审查 + 三档审批 + /approve 重试

Codex 不只是"写代码"，它内置了一个不碰工作区的专职审查器。

操作步骤：

预期效果：写完立刻有"第二双眼睛"审查、不污染工作区；审批粒度可随时收紧/放松，配合 auto-review 形成"放权但有围栏"的安全区。

适用场景：提交 PR 前自检、CI 失败定位、对 agent 改动不放心想加一道关。

暗门八：网络搜索三态 + 批量出图 + 从 Claude Code 平迁

最后收三道小而美的开关。

网络搜索三态（默认走 OpenAI 维护的网页索引缓存，降低被 live 内容注入的风险）：

显式调用出图：在 prompt 里写 $imagegen 可直接触发图像生成 skill（默认 gpt-image-2）。

从 Claude Code 平迁：/import 一键把 Claude Code 的配置、项目文件、最近聊天迁进 Codex 的 config 和本地文件（注意：任务运行中、remote 会话、连着本地 app-server daemon 时不可用）。/init 则在当前目录生成 AGENTS.md 脚手架——相当于 Codex 版的"项目记忆"。

适用场景：需要实时资料的研究型任务；资产/图标批量生产；想从别的 agent 工具无痛切到 Codex。

信息差总结

维度 大多数人以为的 你现在知道的（信息差）
codex exec 跑完即弃 codex exec resume --last 可续跑，保留全部上下文
运行位置 只能在本机 app-server + --remote 大脑与终端分离，SSH 转发即可
实验功能 没有开关 codex features 独立子命令，unified_exec 开后台执行
临时插话 只能打断主任务 /side 旁路对话，不污染主线、还能看主线状态
跑偏控制 经常忘记目标 /goal 持久目标，pause/resume/clear
成本 订阅额度神秘蒸发 /usage 看日/周/累计 + /fast 档位 + 出图走 API 省
改完就提交 自己人肉 review /review 专职审查 + 三档审批 + /approve 重试
工具迁移 要从头配置 /import 从 Claude Code 平迁，/init 生成 AGENTS.md

行动指南（今晚就能做）

  1. 升级 + 登录：npm i -g @openai/codex（或 brew install --cask codex），codex 回车选 Sign in with ChatGPT，用你的订阅额度白嫖。
  2. 先吃透三条：把 /review、/side、codex resume --last 这三个高频命令用熟，立刻提升 30% 体验。
  3. 开后台执行：codex features enable unified_exec，之后长构建/测试用 /ps 盯、/stop 停。
  4. 省钱配置：/usage weekly 看消耗节奏；要批量出图就 export OPENAI_API_KEY 切 API 计费。
  5. 试一次分离架构：在一台云主机上 codex app-server --listen ws://127.0.0.1:4500，本地 SSH 转发后 codex --remote 连，感受"大脑在云上、终端在掌上"。
  6. 加一行配置：codex completion zsh 写进 ~/.zshrc，装好命令补全；/statusline 把 token 计数和 git 分支常驻底部。

一句话总结：Codex CLI 的价值不在"能聊天"，而在它把一个完整 agent 作战平台塞进了终端——会话可续、大脑可搬、目标可挂、改动可审、成本可看。这八道暗门，知道的和不知道的，用的是同一个工具，跑出的是两种生产力。

参考来源

完成摘要

下一步建议 - Round 3（use-cases 实战案例）可顺势写"Codex CLI 远程大脑 + GitHub Action 无人值守"的端到端实战，复用本轮挖掘到的 app-server / exec resume 知识，形成系列呼应。 - 优先级：① 选一个有真实数据/ROI 的案例 ② Mermaid 流程图展示工作流 ③ 附成本估算。

注意事项 - 模型命名以官方文档为准（当前默认推荐 gpt-5.5；slash 表里 gpt-4.1 系列为示例项），正文已据此表述，未夸大。 - ChatGPT 订阅驱动 Codex 的额度规则会随 OpenAI 调整而变，建议读者以官方 Pricing 页为准；本文 /usage、/fast、API-key 出图省钱等说法均直接对应官方说明。

[!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学通信知识星球海报-扫码加入

📎 本分类最新文章