OpenAI 同时做了两件事——给 Codex CLI 推送了一个小版本，顺手把 @openai/codex-sdk 标成了稳定版。

如果你已经在使用 Codex。或者正打算把它加入开发流程，这次更新带来的变化可以关注；如果你还在观望，下面的痛点解析可以方便你判断是否该升级。

一、GPT‑4 系列模型在 Codex 中的适配

这次更新的主要是 Codex CLI 的内置指令集。v0.x 刷新了 GPT‑4 三个变体的捆绑指令，并修正了它们的。

使用者常见痛点

• ❌ 大型单体仓库一次性无法加载完整代码，导致重构时上下文缺失。按理说，
• ❌ 不同任务切换模型繁琐。需要频繁修改配置，
• ❌ 大小不明确，难以评估能处理多少代码行。

模型定位与适用场景

变体	定位	适用场景
Sol	旗舰能力	复杂架构设计、全仓库重构、跨文件分析
Terra	均衡日常开发	PR Review、中等规模重构、日常编码任务
Luna	速度+低成本代码补全	简单 bugfix、快速原型、低资源环境下使用

已修正为 272K tokens。这代表着在 Codex CLI 中切换到任意 GPT‑4 系列模型时它能一次性读取约数万行代码，为大型仓库的全量重构或跨文件 API 迁移提供了实打实的能力提高。话说回来，

// ~/.codex/config.toml - 切换模型配置示例
default = "gpt-4-terra" // 日常使用 Terra
# 如需复杂任务可手动切换为 Sol
# gpt-4-sol / gpt-4-luna

细节补充：此次 hotfix 专注于窄范围改动。仅保留 GPT‑4 三模型指令刷新和修正，其他无关改动已回退。OpenAI 对此表现出比预期更高的审慎态度。

@openai/codex-sdk 稳定版发布

@openai/codex-sdk 在 npm 上同步升级至 v0.x，并标记为「稳定版」。说起来，该包与 CLI 本身是两回事：CLI 是终端工具。而 SDK 是用于程序化控制 Codex 的 TypeScript 库。

使用者痛点映射

• ❌ 想在 CI/CD 流水线中自动调用 Codex，却只能手动打开终端输入命令。
• ❌ 跨语言项目缺少统一 API，只能分别写 Bash 脚本或 Python 调用。话说回来，
• ❌ 实时获取执行进度困难。日志只能在命令行里滚动查看。按理说，

SdK 的出现直接解决了上述问题：它在后台 spawn 一个 Codex CLI 进程。 通过 JSONL 事件流实现 Node.js 与 CLI 的双向通信，让你像调用普通函数一样使用 Codex。

import { Codex } from "@openai/codex-sdk";const codex = new Codex;const thread = codex.startThread;const turn = await thread.run(
"诊断这个测试失败原因，并给出修复方案"
);console.log，

主要能力概览

• 流式事件：.runStreamed 返回 async generator，可实时监听每一步进度和 token 用量。
• 结构化输出：通过 JSON Schema让 Codex 返回机器可读的数据，避免后处理自然语言文本。

json

{

}

`

流式事件示例

const { events } = await thread.runStreamed(
"分析这个仓库的结构"
);for await {
switch {
case "item.completed":
console.log;break，case "turn.completed":
console.log;break，}
}

JSON Schema 输出示例

const turn = await thread.run(
"仓库状态"。{
outputSchema: {
再看type，"object",properties: {
summary: { type: "string" },status: {
至于type，"string",enum:
}
},required:
}
};console.log，// => { summary: "...",status: "ok" }

持久化线程

const savedThreadId = thread.id;// 保存 ID
// ... 程序意外退出 ...
const resumedThread = codex.resumeThread;话说回来，await resumedThread.run;

工作目录控制

const thread = codex.startThread({
workingDirectory: "/path/to/project",skipGitRepoCheck: true // 非 Git 项目也可运行
});await thread.run;

三、SDK 的典型场景

SdK 稳定后它最有价值的不是「取代 CLI」，而是\u5D4C'\u5165'\u81EA'\u52A8'化'流程'*?*，

---

---

---

---

---

--

* END OF RESPONSE *

。

---