代理面板中的 Codex
你的 ChatGPT 套餐通过 Codex 驱动 termide 的代理,周围是 termide 的权限卡片、审查模型和编辑器
你的 ChatGPT 套餐包含 Codex,机器上的 Codex CLI 也已登录。你可以在 termide 的某个终端面板里运行 codex,但它只是待在 termide 旁边,而不是融入其中:它的修改绕过打开的编辑器直接写入磁盘,确认提示是它自己的,会话也不属于 termide。
termide 的代理面板可以改为在 Codex 上运行。模型、套餐以及 Codex 自己的工作方式仍归 OpenAI;权限卡片、会话列表以及跟随每次修改的编辑器则归 termide。本指南介绍如何配置,以及与在终端中使用 Codex 相比有哪些不同。
准备工作
- Node.js,并且
npx在PATH中。termide 通过 Codex 的 Agent Client Protocol 适配器@agentclientprotocol/codex-acp驱动它,并用npx运行其最新版本。npm 缓存中的副本启动时不访问注册表;termide 每次运行时在后台检查一次新版本,新版本从下一个面板起生效。 - 已登录 Codex。 termide 本身不执行登录。如果你已经在用 Codex CLI,就无需再做什么;否则运行一次
codex login,用你的 ChatGPT 账号登录。也可以使用 API 密钥:在启动 termide 的环境中设置CODEX_API_KEY或OPENAI_API_KEY。
添加连接
按 Alt+P 打开设置,进入 AI。最上面是 连接。选择 + 添加连接,在新连接的页面上把 提供方 设为 Codex。页面会去掉 Codex 用不到的字段——基础 URL、API 密钥、后备上下文窗口——在你命名之前,连接名为 codex。

页面上的其余项:
- 模型:termide 会短暂启动 Codex,列出你登录账号可用的模型;加载期间字段中显示旋转指示。Codex 为每个推理强度分别列出一次模型。自动(由提供方决定) 把选择留给 Codex。这里选的只是预选模型:在面板中随时可以切换。
- 上下文窗口上限:留空则使用模型自身的窗口,也可以设得更小。Codex 通过
CODEX_CONFIG以model_context_window接收它(你自己的CODEX_CONFIG会保留),并在达到其 90% 时压缩对话,面板的Context:也不会超过它。 - 默认使用:勾选后,新的代理面板都会在 Codex 上启动。
在 config.toml 中写法相同:
[ai]
connection = "codex" # 新会话使用的连接
[ai.connections.codex]
provider = "codex" # 其他都不是必需的
# model = "" # 留空:使用 Codex 自己的默认模型
# context_window_limit = 200000
第一个请求
按 Alt+A 打开代理面板。横幅显示连接和模型;Codex 在后台启动期间,状态栏的 模型 标签会旋转,此时发送的请求会等待它就绪。之后面板的工作方式与其他连接相同:回答、推理和 Codex 的步骤以块的形式出现——读取、带文件名的修改、带命令行的命令——打开了该文件的编辑器会跟随每次修改,运行计时一直走到 Codex 完成为止。
这些标签可以随时切换 Codex 提供的选项,运行期间也可以:
- 模型:你登录账号的模型,名称与 Codex 给出的一致。
- 推理:推理强度。
- 选项:它的其余设置。
Codex 自己的 / 命令会加入面板的 / 列表,按原样发送给它;它的 /compact 取代 termide 的同名命令。在它工作时输入的消息会并入正在进行的回合,与在 Codex 中一样。
Codex 的工具,termide 的决定
与 Claude Code 不同,Codex 保留 自己的系统提示词和自己的工具:它像在终端中一样读取、修改和运行命令,它自己的配置——~/.codex/config.toml、它的 MCP 服务器、AGENTS.md——依然有效。termide 增加的是:
- 权限模式。 termide 让 Codex 进入与面板模式对应的模式,并由 termide 决定 Codex 请求确认的操作。
- termide 的 MCP 服务器。 它们的工具与 Codex 自己的工具一起提供给 Codex,并像 Codex 自己的调用一样接受检查。Codex 只在会话启动时读取一次工具列表,因此之后才连上的服务器要到下一个会话才可用。
- Codex 没有对应物的工具:用于搜索以往会话和 git 历史的
recall、在描述中列出你的技能的skill,以及question和suggest_command。
对话循环仍由 Codex 负责:它自己压缩上下文,运行也无法在步骤之间暂停。
权限与 auto 模式
权限 标签(或 Shift+Tab)设置模式,termide 把它映射到 Codex 的模式上:
| termide | Codex |
|---|---|
ask、configured、auto |
只读,需要确认 |
plan |
只读,并处于它的计划协作模式 |
edit |
可写工作目录 |
all |
完全访问 |
Codex 请求确认的一切都要经过 termide 的检查:你的规则、你在本会话中给出的答复,以及模式。它们未能决定的操作会以卡片形式出现在输入框上方:允许一次、本会话允许、在本项目中始终允许或处处允许、拒绝、拒绝并告诉代理原因,或停止运行。

auto 适用于你信任其方向、但不想一张张回答卡片的运行。本该弹出卡片的操作会交给审查模型——一次独立的模型调用,判断这一步是否服务于你的请求。在 Codex 连接上,审查 通过你的套餐、在它提供的最便宜的模型上运行——名称中含 luna 的第一个模型,没有则用含 mini 的——无需 API 密钥:termide 保持适配器运行,每次审查都在一个简短的独立会话中进行,不带工具,也不带代理的对话,因此代理永远不会评判自己。一次审查需要一秒或更久,并计入套餐额度。可以在连接页面的 auto 模式审查模型 或 [ai.auto_reviewer] 中指定其他审查者:
[ai.auto_reviewer]
connection = "codex" # 留空:会话自己的连接
model = "mini" # 该连接的某个模型,按 id、名称或其中一部分匹配
Codex 自己的自动审查不会被使用:每个请求都由 termide 的审查模型判断。
额度用完时
套餐时间窗口的额度用完后,运行会结束并弹出卡片。Codex 的适配器只在错误文本中说明额度何时重置(“try again at 3:00 PM”),termide 从中读出时间:
- 等到 15:00 再重试,
- 立即重试,
- 停止(Esc)。

对于无人值守的 /goal 或 /loop,把 遇到限额或中断时([ai] 下的 on_limit)设为 wait,运行会等到重置后自行继续;ask_else_wait 会显示卡片,无人回应时则等待。这期间关闭 termide 也不会丢失任何东西:重新打开的会话会把卡片带回来。
如果不想等,可以准备第二个连接。卡片显示期间,状态栏的 连接 标签仍可点击:把会话切换过去,然后回答 立即重试。对话会一并带过去,另一个模型从 Codex 停下的地方接着做:
[ai.connections.codex]
provider = "codex"
[ai.connections.local]
provider = "openai_compatible"
base_url = "http://localhost:8080/v1" # llama.cpp、Ollama、omlx…
委派任务
Codex 不运行 termide 的委派任务:它有自己的分工方式,其页面上的 子代理 显示 (无)。委派任务也不能在 Codex 上运行:这需要模型连接或 Claude Code。
会话与开销
会话日志记录 Codex 自己的会话,因此重新打开的面板会继续该会话,Codex 了解完整的对话。从其他连接切换到 Codex 的会话,会先收到此前对话的记录。/goal 的判定请求和 /handoff 的简报请求会发送到 Codex 会话的一个分叉中,之后关闭,因此对话本身保持不变。
会话信息(F3 或 /usage)按花费者——对话、auto 审查等——和按模型细分 token 用量。Codex 单独统计推理,因此 推理 一行会显示输出中有多少用于思考。
须知
- termide 不提供沙箱。 termide 的权限是一种控制手段,而不是隔离:你允许的操作以你的权限运行,范围以 Codex 自己的沙箱模式为限。
- Claude Code 和 Gemini CLI 的接入方式相同:
provider = "claude_code"或"gemini_cli"。参见 代理面板中的 Claude Code 和 代理面板中的 Gemini CLI。 - 任何 OpenAI 或 Anthropic 兼容的 API 都可以作为备用连接,额度用完时把会话切换过去:OpenAI、OpenRouter 或 Anthropic 这样的托管 API,或你自己的服务器,使用 termide 自己的代理。llama.cpp 和 omlx 是后者的两个例子。
- 详细说明 见 代理指南。