Codex
⚠️ 2026-10-02 核实更新：
- 当前稳定版 0.159.3（2026-09-30 发布），另有 0.161.0-alpha 预发布
- Star 127,026 / Fork 19,844（此前记 75K+，已大幅增长）
- ⚠️ 已并入 ChatGPT 全套餐（含 Free 和 Go）——此前笔记完全没记这一事实
- ⚠️ 登录方式已变：「Sign in with ChatGPT」成为 CLI 默认推荐路径
- 官方首推安装脚本：
curl -fsSL https://chatgpt.com/codex/install.sh | sh
产品介绍
Codex 是 OpenAI 推出的开源 CLI Agent Runtime，用 Rust 重写，Apache-2.0 开源。仓库 github.com/openai/codex。
⚠️ 已并入 ChatGPT 套餐（2026-10-02 新增）
官方原文：“Codex is included across ChatGPT plans, including Free 和 Go”，各套餐额度不同。
四个入口：ChatGPT 桌面端 Codex 模式、CLI、IDE 扩展、Codex Web。
已在 AWS 上限量预览：可在 Amazon Bedrock 使用（计入 AWS 云承诺）。
⚠️ 登录方式变更（2026-10-02 新增）
| 方式 | 说明 |
|---|---|
| Sign in with ChatGPT | ⭐ CLI 默认推荐路径 |
| API key | 仍支持，但按 API 标准价单独计费、不吃套餐额度，部分依赖 ChatGPT 工作区的功能不可用 |
| 设备码登录（beta） | 新增，适合无浏览器的服务器 |
| 企业 access token | 新增 |
| 凭证存储 | 可存系统钥匙串（cli_auth_credentials_store） |
⚠️ 用邮箱密码登录的用户必须先开 MFA，否则不能用 Codex cloud。
时间窗变更：自 2026-08-31 起，用 ChatGPT 账号登录 Codex 时不再提供 GPT-5.4 / 5.4 mini，需改用 GPT-5.6 Terra / Luna。
核心能力
1. OSS Mode（开源模式）
Codex 最大的特色是 OSS Mode，允许接入任意 OpenAI 兼容的模型，包括：
- DeepSeek（如 V4-Pro、V4-Flash）
- Ollama（本地运行的模型）
- Claude（通过兼容接口）
- 其他 OpenAI 兼容 API
这意味着用户可以使用 Codex 作为 Agent Runtime，但自由选择底层模型，不必绑定 OpenAI。
⚠️ 2026-10-02 提醒：OSS Mode 在官方 README 里已不再作为主推卖点，官方主推路径变成「ChatGPT 登录 + 官方模型」。自定义 provider 仍保留在配置文档的 advanced 章节（
requires_openai_auth/env_key）。
2. Rust 重写
- 性能更好，启动更快
- 内存管理更高效
- 安全性更高
3. 安装方式（2026-10-02 更新）
# ⭐ 官方首推
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# 仍支持
npm i -g @openai/codex
brew install --cask codex
# 桌面端
codex app4. 工作流程
- 通过 CLI 与 Agent 交互
- Agent 可以读写文件、执行命令、操作浏览器
- 支持多轮对话和上下文保持
- 可配置工作规则和工具访问权限
技术架构
| 组件 | 说明 |
|---|---|
| CLI | 用户交互入口，命令行界面 |
| Agent Runtime | 核心运行时，管理工具调用、上下文、任务规划 |
| Model Interface | 模型接口层，支持 OpenAI 兼容协议 |
| Tool System | 工具系统，文件操作、命令执行、浏览器控制等 |
| Session Manager | 会话管理，跨会话状态保持 |
与其他 Agent 的对比
| 维度 | Codex | ClaudeCode | TraeWork |
|---|---|---|---|
| 开发方 | OpenAI | Anthropic | 字节跳动 |
| 协议 | Apache-2.0 | 未开源 | 未开源 |
| 模型绑定 | 不绑定（OSS Mode） | 绑定 Claude | 多模型支持 |
| 语言 | Rust | TypeScript | TypeScript |
| 定位 | CLI Agent Runtime | IDE + Agent | AI 办公平台 |
适用场景
- 需要 OpenAI Agent Runtime 的能力
- 想用 Responses 协议的最新 GPT 系（5.6 系：Terra / Luna / Sol / Astra）
- 需要本地 CLI 工具
- 想用任意 OpenAI 兼容模型（DeepSeek、Claude、Ollama 等）
- 需要高性能的 Agent 运行时
接入 TraeWork 的考虑
- MCP 方式：Codex 原生支持 MCP 协议，可在 TraeWork 中配置 MCP client 连接
- 插件方式：可自行制作 TraeWork 插件封装 Codex 能力
- 互补性：TraeWork 主要用 Anthropic 协议，Codex 用 Responses 协议，两者互补
- OSS Mode：Codex 的 OSS Mode 能用任意 OpenAI 兼容模型，包括 DeepSeek
当前状态
- 已接入 DeepSeek Harness 作为子 Agent
- 已接入 openclaw 平台
- 尚未接入 TraeWork
相关笔记
- TraeWork - 接入的目标
- DeepSeek Harness - 集成了 Codex 的工具
- ClaudeCode和Codex接入TraeWork - 接入方案调研
- Butler - 家里用的 openclaw Agent（未接入 Codex）
- openclaw - Butler 跑在的平台（未接入 Codex）
- cc-haha和Codex开源仓库 - 两个开源仓库的详细信息
相关日记
- 2026-08-19 - 开始研究
- 2026-08-24 - 记录当天
- 2026-10-02 - 核实：版本 0.130→0.159.3、Star 75K→127K、补 ChatGPT 全套餐并入与登录方式变更