Codex 可用特性速览(截至 2026-05-18)
更新时间:2026-05-18。本文以 OpenAI 官方 Codex 文档为准,面向想快速理解“今天的 Codex 能做什么”的读者。
一句话结论
Codex 已经不是单一 CLI,而是一组覆盖本地、IDE、终端、云端和移动远程控制的 coding agent 产品形态。它可以读写代码、运行命令、审查 diff、创建 PR、管理 worktree、使用 MCP/插件/Skills、生成图片、处理非代码文件,并通过 Cloud、App、IDE extension、CLI 与远程连接覆盖不同工作方式。
当前入口与支持平台
| 入口 | 状态与用途 |
|---|---|
| Codex App | macOS 和 Windows 桌面应用;主打并行线程、worktree、自动化、Git、浏览器和本机工具协作 |
| IDE Extension | 支持 VS Code、Cursor、Windsurf、VS Code Insiders;在编辑器侧栏中使用 Agent mode |
| Codex CLI | 支持 macOS、Windows、Linux;通过 npm install -g @openai/codex 或 brew install codex 安装 |
| Codex Cloud | https://chatgpt.com/codex;在浏览器中连接 GitHub 环境,后台执行任务、查看日志、审阅 diff、创建 PR |
| GitHub PR 评论 | 在 GitHub PR 评论中 @codex 委派任务,需登录 ChatGPT |
| 移动远程控制 | ChatGPT 手机 App 可连接 Codex App host,远程发指令、批批准、看结果 |
官方 Quickstart 写明:Every ChatGPT plan includes Codex;也可以通过 OpenAI API key 使用 API credits 登录,但部分功能,例如 cloud threads,可能不可用。
核心工作模式
1. Agent mode:读文件、跑命令、写改动
在 IDE extension 和 CLI 中,Codex 默认以 Agent mode 工作:它可以读取项目文件、运行命令、修改代码。典型任务包括:
- 解释一个项目的结构。
- 找 bug 并给出最小修复。
- 根据现有框架实现小功能。
- 跑测试、lint、build,并根据结果继续修复。
- 生成变更总结、风险说明和后续步骤。
2. Local / Worktree / Cloud 三种执行位置
Codex App 线程可以选择不同模式:
| 模式 | 含义 | 适合场景 |
|---|---|---|
| Local | 直接在当前项目目录工作 | 小改动、快速修复、你希望直接作用于当前 checkout |
| Worktree | 创建 Git worktree 隔离改动 | 并行任务、实验性方案、避免污染当前分支 |
| Cloud | 在配置好的远程云环境运行 | 长任务、后台任务、需要浏览器中管理的 GitHub 工作流 |
官方还说明,Automations 在 Git 仓库中会使用 dedicated background worktrees;非版本控制项目则直接在项目目录运行。
Codex App 可用特性
1. 多项目与多线程并行
Codex App 是一个桌面工作台,可以在一个窗口里管理多个项目和多个线程。对 monorepo 或多服务仓库,官方建议把不同 app/package 拆成独立项目,这样 sandbox 边界更清晰。
2. Skills 支持
Codex App 支持和 CLI、IDE extension 相同的 agent skills。Skills 可以封装任务说明、脚本、领域知识和固定工作流,适合把团队里的重复操作标准化。
3. Automations 与 thread automations
Codex App 可以创建自动化任务,用于周期性工作,例如:
- 定期检查 telemetry 错误并提交修复。
- 生成最近代码变更报告。
- 周期性唤醒一个长期线程继续跟进。
Standalone/project automation 适合每次开启新任务;thread automation 适合保留同一线程上下文的持续任务。
4. 内置 Git 工具
Codex App 内置常见 Git 工作流:
- 查看 diff。
- 对 diff 添加 inline comments,让 Codex 按评论继续改。
- stage 或 revert 单个 chunk / 文件。
- commit、push、创建 pull request。
这让“让代理改代码 -> 人审 diff -> 再让代理修 -> 创建 PR”的闭环可以在一个界面中完成。
5. Worktree 支持
Worktree 是 Codex App 的重要能力。它让 Codex 在隔离 checkout 里试方案,不直接碰你当前工作目录。对并行探索和大改动尤其有用。
6. 集成终端
每个线程都有内置终端,作用域限定在当前 project 或 worktree。你可以用它运行测试、lint、build、Git 命令;Codex 也能读取当前终端输出,用失败日志或运行中服务状态继续推理。
7. Windows 原生 sandbox
在 Windows 上,Codex 可以在 PowerShell 中使用 native Windows sandbox,不必依赖 WSL 或虚拟机。这让 Windows 原生开发流也能保留权限边界。
8. 语音输入、浮动窗口与通知
Codex App 支持语音 dictation、活跃线程 pop-out 浮动窗口、后台完成或需要批准时通知,以及防止电脑在任务运行时睡眠的设置。
浏览器、Computer Use 与非代码产物
1. In-app browser 与 Browser Use
Codex App 有内置浏览器,可预览本地开发服务器、文件预览和无需登录的公共页面。你可以在页面上添加 browser comments,让 Codex 针对某个元素或区域修改。对本地开发服务器和文件页面,还可以使用 Browser Use 让 Codex 直接操作页面。
限制也很明确:内置浏览器不支持认证流程、登录态页面、常规浏览器 profile、cookies、扩展或已有标签页。
2. Computer Use
Computer Use 让 Codex 通过看、点击、输入来操作 macOS app,适合测试桌面 app、复现 GUI-only bug、检查模拟器流程、使用没有插件的数据源等。因为它可能影响项目外的 app 或系统状态,官方建议任务保持窄范围,并仔细审阅权限提示。
发布时限制:Computer Use 在 EEA、英国、瑞士不可用。
3. 非代码 artifact 预览
Codex App 的 task sidebar 可以预览 PDF、电子表格、文档和演示文稿。对于报告、表格、slides 等非代码输出,可以要求 Codex 说明保存位置、结构和检查方式。
扩展与工具生态
1. MCP 支持
Codex App、CLI、IDE Extension 共享 MCP 配置。已经在一个入口配置的 MCP server,会被其他入口自动采用。MCP 适合连接外部系统,例如 GitHub、日历、邮件、数据库、内部工具或自定义服务。
2. Plugins / Apps connectors
Codex CLI 有 /plugins 和 /apps 等命令;配置文档里也列出 Apps/connectors 支持。Apps/connectors 仍属于 experimental 特性,适合把 Gmail、Calendar、Drive、Slack、GitHub 等外部工具作为可控连接器交给 Codex 使用。
3. Hooks
Hooks 是稳定功能,默认开启。它们可以在生命周期事件中运行脚本或检查,例如工具调用前、权限请求、工具调用后、会话开始、用户提交 prompt、停止等。插件自带 hooks 在当前版本中默认关闭,需要显式启用。
4. Subagents / multi-agent
Codex 的 multi-agent 功能为稳定特性,默认开启。它允许把任务拆给子代理,例如只读探索、实现某个模块、验证某个风险等。CLI 中也有 /agent 用于切换和检查 spawned subagent thread。
5. Skills
Skills 是 Codex 的可复用能力包。官方 migration 文档显示,Codex 可以从其他 agent setup 导入 Skills,也可以把 slash commands 映射为 Codex skills。
CLI 可用命令亮点
Codex CLI 提供丰富 slash commands,常用的包括:
| 命令 | 用途 |
|---|---|
/permissions | 调整 Codex 可以自动执行什么、什么时候需要审批 |
/plan | 进入计划模式,先让 Codex 给执行计划 |
/diff | 查看当前 Git diff,包括未跟踪文件 |
/review | 请求 Codex 审查当前 working tree |
/mcp | 查看已配置 MCP 工具 |
/plugins | 浏览已安装和可发现插件 |
/apps | 浏览 Apps/connectors 并插入 prompt |
/agent | 切换 spawned subagent thread |
/compact | 压缩长对话,释放上下文 |
/model | 选择模型和 reasoning effort |
/fast | 切换 Fast mode |
/fork / /side / /resume / /new | 分叉、临时侧聊、恢复历史、新建线程 |
/status / /debug-config | 查看 session 与配置状态 |
Web search、图片与多模态
Codex App 中本地任务默认启用第一方 web search,并从缓存结果服务;如果配置 full access sandbox,web search 默认使用 live results。配置里也可以禁用或切换模式。
Codex 还支持:
- 直接在 thread 中生成或编辑图片。
- 使用
$imagegen显式调用图片生成 skill。 - 内置图片生成使用
gpt-image-2,计入 Codex usage limits。 - 拖拽图片作为上下文,或让 Codex 查看本地图片/截图来验证 UI。
远程连接与移动控制
Remote connections 让你不在主机旁也能使用 Codex。ChatGPT 手机 App 可以连接到 Codex App host,远程:
- 开新线程或继续已有线程。
- 发送后续指令。
- 批准命令和其他动作。
- 查看输出、diff、测试结果、终端输出和截图。
- 收到任务完成或等待注意的通知。
- 在 connected hosts 和 threads 之间切换。
重要边界:手机发送 prompt、审批和 follow-up;实际文件、shell、插件、MCP、skills、浏览器、Computer Use、sandbox 和权限控制都来自 connected host。Codex 通过安全 relay 让可信机器在授权设备间可达,而不是直接暴露到公网。
Codex App 还可以连接 SSH host,让线程在远程文件系统和 shell 上运行。
配置层面的稳定/实验特性
OpenAI 官方配置文档列出的 feature flags 中,当前比较重要的状态包括:
| Feature | 默认 | 成熟度 | 说明 |
|---|---|---|---|
multi_agent | true | Stable | 子代理协作工具 |
hooks | true | Stable | 生命周期 hooks |
fast_mode | true | Stable | Fast mode / fast service tier |
personality | true | Stable | 交流风格选择 |
shell_snapshot | true | Stable | shell 环境快照,加速重复命令 |
shell_tool | true | Stable | 默认 shell 工具 |
unified_exec | true except Windows | Stable | PTY-backed exec 工具 |
memories | false | Stable | 记忆功能,可手动启用 |
undo | false | Stable | per-turn git ghost snapshots 撤销支持 |
apps | false | Experimental | ChatGPT Apps/connectors 支持 |
codex_git_commit | false | Experimental | Codex 生成 git commit 与 attribution trailer |
plugin_hooks | false | Under development | 插件自带 hooks |
最新模型背景
OpenAI 当前 “latest model” 文档显示最新模型是 gpt-5.5。官方对 GPT-5.5 的定位包括:复杂生产工作流、coding use cases、tool-heavy agents、grounded assistants、long-context retrieval、product-spec-to-plan workflows 等。对 Codex 这类 coding agent,官方也强调需要更强的 orchestration:规划、工具使用、代码库导航、验证、多步执行、子代理委派和测试期望都要清楚。
这并不等于每个 Codex 入口都只固定使用一个模型;实际可选模型取决于账号、工作区、产品入口和配置。但理解 GPT-5.5 的官方定位,有助于解释为什么 Codex 的最新形态越来越强调 tool orchestration、subagents、sandbox、approval 和长任务管理。
适合怎么用
- 小修复:用 Local 或 CLI,要求最小改动、跑测试、给证据。
- 多方案探索:用 Worktree 或 fork/thread,让不同方向隔离推进。
- 大型排查:用 subagents 分头读模块,再汇总判断。
- 周期性维护:用 Automations 或 thread automations。
- Web/UI 验证:用 in-app browser、browser comments、截图和 Browser Use。
- 桌面/GUI 问题:在支持地区用 Computer Use,但保持任务窄。
- 外部系统任务:优先用 MCP、Apps/connectors 或插件,而不是让 Codex 猜网页操作。
- 团队规范:把稳定规则写进
AGENTS.md、Skills、hooks 和配置,而不是每次 prompt 重复。
资料来源
- Codex Quickstart:
https://developers.openai.com/codex/quickstart - Codex App features:
https://developers.openai.com/codex/app/features - Codex Remote connections:
https://developers.openai.com/codex/remote-connections - Codex CLI slash commands:
https://developers.openai.com/codex/cli/slash-commands - Codex Config basics / feature flags:
https://developers.openai.com/codex/config-basic#supported-features - Migrate to Codex:
https://developers.openai.com/codex/migrate - Latest model / GPT-5.5:
https://developers.openai.com/api/docs/guides/latest-model