📚AI 编程官方教程中文版
📘 OpenAI Codex📚 官方教程中文版版本与迁移

查看版本更新脉络

Codex changelog 适合用来确认三类信息：

Codex changelog 适合用来确认三类信息：

  • 某个功能是在哪个时间点进入 Codex 的。
  • 某个 CLI / App 版本包含哪些行为变化。
  • 模型、沙箱、插件、Skills、MCP、GitHub / Slack / Linear 集成等能力的演进边界。

官方页面：

月份入口：

MonthLink
April 2026https://developers.openai.com/codex/changelog#month-2026-04
March 2026https://developers.openai.com/codex/changelog#month-2026-03
February 2026https://developers.openai.com/codex/changelog#month-2026-02
January 2026https://developers.openai.com/codex/changelog#month-2026-01
December 2025https://developers.openai.com/codex/changelog#month-2025-12
November 2025https://developers.openai.com/codex/changelog#month-2025-11
October 2025https://developers.openai.com/codex/changelog#month-2025-10
September 2025https://developers.openai.com/codex/changelog#month-2025-09
August 2025https://developers.openai.com/codex/changelog#month-2025-08
June 2025https://developers.openai.com/codex/changelog#month-2025-06
May 2025https://developers.openai.com/codex/changelog#month-2025-05

怎么读 Changelog

不要把 changelog 当成新手教程读。更实用的读法是：

  1. 先确认你关心的是 App、CLI、IDE、Cloud、模型，还是 integration。
  2. 如果是 CLI 行为，先找 Codex CLI x.y.z，再看安装命令和 GitHub release。
  3. 如果是 App 行为，先看 Codex app 26.xxx，注意它和 CLI 版本号不是同一套。
  4. 如果是模型选择，先看模型发布时间，再看它是否支持 App、CLI、IDE、Cloud、API。
  5. 如果是权限、sandbox、MCP、plugins、skills，优先看 April 2026 和 March 2026 的 CLI release。

CLI Release 索引

CLI release 可以按版本安装：

npm install -g @openai/codex@0.128.0
DateVersion安装命令关键变化Release
2026-04-300.128.0npm install -g @openai/codex@0.128.0persisted /goal workflows、codex update、TUI keymaps、permission profiles、plugin marketplace、external agent session import、MultiAgentV2 配置增强。https://github.com/openai/codex/releases/tag/rust-v0.128.0
2026-04-240.125.0npm install -g @openai/codex@0.125.0app-server Unix socket transport、resume/fork 分页、sticky environments、remote plugin install、permission profiles round-trip、codex exec --json reasoning-token usage。https://github.com/openai/codex/releases/tag/rust-v0.125.0
2026-04-230.124.0npm install -g @openai/codex@0.124.0Alt+, / Alt+. reasoning 快捷键、multi-environment app-server sessions、Amazon Bedrock provider、remote plugin marketplace、hooks 稳定化、Fast service tier 默认启用。https://github.com/openai/codex/releases/tag/rust-v0.124.0
2026-04-230.123.0npm install -g @openai/codex@0.123.0built-in amazon-bedrock provider、/mcp verbose、.mcp.json 兼容更多形态、background agents transcript handoff、remote_sandbox_config。https://github.com/openai/codex/releases/tag/rust-v0.123.0
2026-04-200.122.0npm install -g @openai/codex@0.122.0standalone installer 改进、/side conversations、Plan Mode 新上下文实现、plugin workflows、deny-read glob policies、tool discovery 和 image generation 默认启用。https://github.com/openai/codex/releases/tag/rust-v0.122.0
2026-04-150.121.0npm install -g @openai/codex@0.121.0codex marketplace add、TUI prompt history Ctrl+R、memory mode 控制、MCP Apps tool calls、secure devcontainer profile、WSL1 / WSL2 行为文档。https://github.com/openai/codex/releases/tag/rust-v0.121.0
2026-04-110.120.0npm install -g @openai/codex@0.120.0Realtime V2 background agent progress、hook activity rendering、custom TUI status line、MCP outputSchema、SessionStart hooks 区分 /clear。https://github.com/openai/codex/releases/tag/rust-v0.120.0
2026-04-100.119.0npm install -g @openai/codex@0.119.0Realtime voice sessions v2、MCP Apps/custom MCP server 增强、remote/app-server workflows、Ctrl+O 复制最新 agent response、/resume 按 ID 或 name 跳转。https://github.com/openai/codex/releases/tag/rust-v0.119.0
2026-03-310.118.0npm install -g @openai/codex@0.118.0Windows sandbox proxy-only networking、ChatGPT device-code sign-in、codex exec 支持 prompt + stdin、custom model providers 动态 bearer tokens。https://github.com/openai/codex/releases/tag/rust-v0.118.0
2026-03-260.117.0npm install -g @openai/codex@0.117.0plugins 进入 first-class workflow、Sub-agents path-based addresses、/title、remote websocket server bearer-token auth、image workflows。https://github.com/openai/codex/releases/tag/rust-v0.117.0

完整 PR 级 diff：

VersionCompare
0.128.0https://github.com/openai/codex/compare/rust-v0.125.0...rust-v0.128.0
0.125.0https://github.com/openai/codex/compare/rust-v0.124.0...rust-v0.125.0
0.124.0https://github.com/openai/codex/compare/rust-v0.123.0...rust-v0.124.0
0.123.0https://github.com/openai/codex/compare/rust-v0.122.0...rust-v0.123.0
0.122.0https://github.com/openai/codex/compare/rust-v0.121.0...rust-v0.122.0
0.121.0https://github.com/openai/codex/compare/rust-v0.120.0...rust-v0.121.0
0.120.0https://github.com/openai/codex/compare/rust-v0.119.0...rust-v0.120.0
0.119.0https://github.com/openai/codex/compare/rust-v0.118.0...rust-v0.119.0
0.118.0https://github.com/openai/codex/compare/rust-v0.117.0...rust-v0.118.0
0.117.0https://github.com/openai/codex/compare/rust-v0.116.0...rust-v0.117.0

2026 年关键变化

April 2026

DateUpdate要点
2026-04-30Codex CLI 0.128.0/goal 持久化、codex update、permission profiles、plugin workflows、external agent import、MultiAgentV2。
2026-04-24Codex CLI 0.125.0app-server transport、remote threads、remote plugin install、permission profiles、rollout tracing。
2026-04-23GPT-5.5 and Codex app updatesGPT-5.5 进入 Codex；App 支持 in-app browser；approval prompts 可走 automatic reviewer agent。
2026-04-23Codex CLI 0.124.0reasoning 快捷键、多环境 app-server sessions、Bedrock、remote marketplace、hooks 稳定化。
2026-04-23Codex CLI 0.123.0amazon-bedrock provider、/mcp verbose、remote sandbox requirements、model metadata 更新。
2026-04-20Codex CLI 0.122.0installer、Plan Mode、plugins、deny-read policies、tool discovery、image generation。
2026-04-15Codex can now help with more of your work 26.415App 增加 in-app browser、Computer Use、Chats、thread automations、task sidebar、artifact viewer、memories、PR workflow。
2026-04-15Codex CLI 0.121.0plugin marketplaces、prompt history、memory controls、MCP Apps、secure devcontainer、WSL 文档。
2026-04-11Codex CLI 0.120.0Realtime V2、hook rendering、status line、MCP output schema、SessionStart hooks。
2026-04-10Codex CLI 0.119.0Realtime voice v2、MCP Apps/custom MCP、remote/app-server workflows、Ctrl+O copy、/resume。
2026-04-07Codex model availability updateChatGPT 登录方式下移除旧模型入口；保留 gpt-5.4、gpt-5.4-mini、gpt-5.3-codex、gpt-5.2，Pro 用户可选 gpt-5.3-codex-spark。

GPT-5.5 切换方式：

codex --model gpt-5.5

如果 CLI、IDE extension 或 Codex App 中还看不到 GPT-5.5，先更新对应客户端。灰度期间可继续使用 GPT-5.4。

March 2026

DateUpdate要点
2026-03-31Codex CLI 0.118.0Windows sandbox 可做 proxy-only networking；device-code sign-in；codex exec 支持 prompt + stdin；custom provider 支持动态 bearer tokens。
2026-03-26Codex CLI 0.117.0plugins first-class workflow；Sub-agents path-based addresses；app-server clients 支持 shell commands、filesystem watch、remote websocket。
2026-03-24Build and install plugins in Codexplugins 由 .codex-plugin/plugin.json 描述，可包含 skills、app mappings、MCP config、assets。
2026-03-24Codex app 26.323搜索历史 threads，一键 archive project local threads，同步 App 与 VS Code extension 设置。
2026-03-19Codex app 26.318@ menu 支持 skills，Cmd/Ctrl+F 从当前选择文本开始搜索。
2026-03-18Codex app 26.317可从历史消息 fork conversation；slash commands 支持模型和 reasoning 切换；plan mode 问题有通知。
2026-03-17GPT-5.4 mini更快、更省额度，适合 codebase exploration、large-file review、supporting documents 和较轻的 subagent work。
2026-03-16Codex app 26.313header back/forward；thread menu 可 Open in Finder / Explorer / File Manager。
2026-03-12Codex app 26.312themes、font、accent/background/foreground 配置；automations 支持 local/worktree、reasoning/model 和 templates。
2026-03-11Codex app 26.311Codex 可读取当前 thread 的 integrated terminal，理解 dev server 状态和失败构建输出。
2026-03-05GPT-5.4推荐用于多数 Codex 任务；支持 native computer-use capabilities 和 experimental 1M context window。
2026-03-05Codex app 26.305remote connections 错误、状态和 host labels 更清楚；修复 Windows terminal copy/paste。
2026-03-04Codex app 26.304Windows App 发布，可通过 Microsoft Store 下载，支持 native Windows sandbox 和 WSL。
2026-03-03Codex app 26.303worktree 自动清理设置、Local/Worktree handoff、language menu English 选项。

GPT-5.4 mini 切换：

codex --model gpt-5.4-mini

GPT-5.4 切换：

codex --model gpt-5.4

February 2026

DateUpdate要点
2026-02-28Codex app 26.228修复 conversation 和 task views 在 response streaming 中停止更新的问题。
2026-02-27Codex app 26.227PR status badges；Worktrees 保留数量设置；长 conversation/code review 的滚动和导航更稳定。
2026-02-26Codex app 26.226Composer 增加 MCP shortcuts；inline review comments 支持 @mentions 和 skill mentions。
2026-02-17Codex app 26.217queued messages 支持拖拽排序；模型降级时显示 warning。
2026-02-12GPT-5.3-Codex-Sparkresearch preview；ChatGPT Pro 用户可在 App、CLI、IDE extension 使用；text-only，128k context window。
2026-02-12Codex app 26.212支持 GPT-5.3-Codex-Spark；conversation forking；floating pop-out window；Windows App alpha sign-up。
2026-02-10Codex app 26.210branch picker 搜索、plan mode 提示、parallel approvals。
2026-02-09GPT-5.3-Codex in Cursor and VS CodeGPT-5.3-Codex 原生进入 Cursor 和 VS Code；API access 分阶段开放。
2026-02-08Codex app 26.208command palette 增加 MCP 和 personality actions；follow-up 默认 queue。
2026-02-06Codex app 26.206file-reference action 可在 OS file manager 中 reveal files；review pane 移除整体 diff-size cap。
2026-02-05GPT-5.3-Codex更强的 agentic coding model；更快；mid-turn collaboration 更好。
2026-02-05Codex app 26.205支持 GPT-5.3-Codex；mid-turn steering；任意文件类型 attachment/drop。
2026-02-04Codex app 26.204Open in editor 增加 Zed 和 Textmate；review panel 支持 PDF preview。
2026-02-03Codex app 26.203thread list 双击重命名；Sync 改名为 Handoff。
2026-02-02Introducing the Codex appmacOS Codex App 发布，支持 parallel agent threads、worktrees、Git tooling、skills、automations。

GPT-5.3-Codex-Spark 切换：

codex --model gpt-5.3-codex-spark

GPT-5.3-Codex 切换：

codex --model gpt-5.3-codex

January 2026

DateUpdate要点
2026-01-28Web search enabled by defaultCLI 和 IDE Extension 的 local tasks 默认启用 web search。web_search = "cached" 是默认；"live" 获取最新网页；"disabled" 关闭工具。
2026-01-23Team Config用 .codex/、~/.codex/、/etc/codex/ 分层共享 config.toml、rules/、skills/；requirements.toml 可强制约束。
2026-01-22Custom prompts deprecatedcustom prompts 弃用，复用型 instructions 和 workflows 改用 skills。
2026-01-14GPT-5.2-Codex API availabilityGPT-5.2-Codex 可在 API 和 API sign-in 的 Codex 中使用。

web_search 配置项：

web_search = "cached"
web_search = "live"
web_search = "disabled"

2025 年关键变化

MonthUpdate要点
December 2025Agent skills in CodexCodex 支持 agent skills。skill 是带 SKILL.md 的文件夹，可放在 ~/.codex/skills 或 repo 的 .codex/skills。
December 2025GPT-5.2-CodexGPT-5.2-Codex 成为 ChatGPT 登录用户在 CLI 和 IDE Extension 的默认模型；可用 codex --model gpt-5.2-codex 切换。
December 2025Codex for LinearLinear issue 中 assign 或 mention @Codex 可启动 Codex cloud task。
November 2025Usage and credits fixesusage dashboard 统一显示 limits remaining；修复购买 credits 和 CLI stale usage 信息。
November 2025GPT-5.1-Codex-Max新 frontier agentic coding model，增加 Extra High (xhigh) reasoning effort。
November 2025GPT-5.1-Codex / GPT-5.1-Codex-Mini引入 gpt-5.1-codex 和 gpt-5.1-codex-mini；macOS/Linux 默认 gpt-5.1-codex，Windows 默认 gpt-5.1。
November 2025GPT-5-Codex-Mini更省额度的小模型，达到 90% 5-hour usage limit 时 CLI 和 IDE Extension 会建议切换。
November 2025GPT-5-Codex model updateapply_patch 更可靠，减少 destructive actions，例如 git reset，更能处理用户同时编辑文件的场景。
October 2025Credits on ChatGPT Pro and PlusChatGPT Plus / Pro 用户可用 on-demand credits 扩展 Codex usage。
October 2025Tag @Codex on GitHub Issues and PRs可在 teammate PR 或 issue 中 tag @codex 发起问题、follow-up 或改动任务。
October 2025Codex GACodex generally available；新增 @Codex in Slack、Codex SDK、admin controls、analytics。
September 2025GPT-5-Codex in APIGPT-5-Codex 进入 Responses API，也可用 API Key 在 Codex CLI 中使用。
September 2025GPT-5-CodexGPT-5-Codex 进入 IDE extension、CLI、cloud agent 和 GitHub Code Review；CLI 新增 codex resume 和 context compaction。
August 2025Late August updateIDE extension、ChatGPT sign-in、local ↔ cloud handoff、code reviews。
August 2025Mid August updateimage inputs、container caching、automatic environment setup。
June 2025Best of N同一任务可生成多个 responses，方便对比方案；增加 shortcut explorer、task cancellation、setup script 时长等改进。
June 2025June updateagent internet access、update existing PRs、voice dictation、binary file handling、diff limit 提升。
May 2025Reworked environment page环境 setup 页面重做；retry failed tasks、network-off indicators、copy git patches、unicode branch names、错误信息和性能改进。
May 2025Codex in the ChatGPT iOS app可在 iOS app 中启动 tasks、查看 diffs、push PRs。

Skills 目录结构：

my-skill/
    SKILL.md       # Required: instructions + metadata
    scripts/       # Optional: executable code
    references/    # Optional: documentation
    assets/        # Optional: templates, resources

GPT-5.2-Codex 切换：

codex --model gpt-5.2-codex

默认模型配置：

model = "gpt-5.2-codex"

和本仓库文档对应

版本记录主题推荐文档
App、threads、worktrees、artifact viewer04 使用桌面版 Codex · 33 掌握 App 核心功能 · 43 用 Worktrees 并行开发
CLI release、命令和参数03 使用命令行版 Codex · 27 查询 CLI 参数
模型切换14 选择 Codex 模型
价格、用量和 credits15 理解价格和用量
sandbox、approval、full access07 设置审批和安全边界 · 49 理解沙箱边界
Windows App、Windows sandbox、WSL242 使用 Windows 版 App · 120 在 Windows 上使用 Codex
Skills09 用 Skills 复用能力
Plugins68 安装和管理插件 · 69 构建自己的插件
MCP08 MCP
GitHub、Slack、Linear60 用 Codex 做 GitHub 代码审查 · 61 从 Linear 使用 Codex · 62 从 Slack 使用 Codex
Team Config、enterprise admin54 做企业管理员初始化 · 55 下发托管配置 · 56 做治理和可观测

看官方演示视频

这一页整理 Codex 官方视频入口。它适合做两件事：

Hermes Agent 中文教程

基于 Nous Research Hermes Agent 官方资料重写的中文教程，作为 Agent 框架横向研究资料。

On this page

怎么读 ChangelogCLI Release 索引2026 年关键变化April 2026March 2026February 2026January 20262025 年关键变化和本仓库文档对应