Codex 升级：GPT-5.6 指令+SDK 稳定版

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

你可能已经注意到了：GPT-5.6 发布后，各家 AI 编码工具都在跟进适配。Codex 这次 v0.144.6 的更新，看起来只是「刷新了内置模型指令」，但拆开看，信息量不小。

一、GPT-5.6 三模型的 Codex 适配

这次更新的核心是 Codex CLI 的内置指令集。v0.144.6 刷新了 GPT-5.6 三个变体的捆绑指令，并修正了它们的上下文窗口。

GPT-5.6 的三个模型变体在 Codex 中的定位：

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

这次更新最值得关注的数据是 上下文窗口修正为 272,000 tokens。PR #34009 明确标注了这个数字------不是 200K 也不是 128K，整整 272K。

这意味着什么？如果你在 Codex CLI 里切到 GPT-5.6 系列模型，它能一次性看到约 20 万行代码的上下文。对于大型单体仓库的全量重构、跨 100+ 文件的 API 迁移这类场景，这是个实打实的能力提升。

typescript 复制代码

// Codex CLI 切换模型的配置方式（~/.codex/config.toml）
// 可用模型：gpt-5.6-sol / gpt-5.6-terra / gpt-5.6-luna
[models]
default = "gpt-5.6-terra"  // 日常用 Terra
// 复杂任务时手动切到 Sol

补充一个细节：这次 hotfix 是刻意做窄的。PR #33972 最初 backport 了更大范围的模型元数据变更，但 #34009 把无关改动全部回退，只保留 GPT-5.6 三模型的指令刷新和上下文窗口修正。OpenAI 在这个点上的谨慎程度比想象中高。

二、`@openai/codex-sdk` 稳定版

比 GPT-5.6 指令刷新更有意思的是另一件事------@openai/codex-sdk 在 npm 上同步到了 v0.144.6，并且标注为稳定版。

这个包和 @openai/codex（CLI 本身）是两回事。CLI 是终端工具，SDK 是程序化控制 Codex 的 TypeScript 库。从 2025 年 10 月开始走 alpha 发布，迭代了半年多，现在终于稳定了。

typescript 复制代码

import { Codex } from "@openai/codex-sdk";

const codex = new Codex();
const thread = codex.startThread();
const turn = await thread.run("诊断这个测试失败原因，并给出修复方案");

console.log(turn.finalResponse);

这个 SDK 做的事情说起来很简单：它在底层 spawn 一个 Codex CLI 进程，通过 JSONL 事件流在 Node.js 进程和 CLI 之间双向通信。你写代码调用 SDK，SDK 控制 CLI，CLI 执行 Agent 逻辑。

核心能力

SDK 不只是「把 CLI 包了一层 API」，它有几个值得注意的设计：

流式事件 ：run() 会缓冲到整轮执行完才返回。如果你需要实时进度，用 runStreamed() 拿到一个 async generator：

typescript 复制代码

const { events } = await thread.runStreamed("分析这个仓库的结构");

for await (const event of events) {
  switch (event.type) {
    case "item.completed":
      console.log("Codex 完成了:", event.item);
      break;
    case "turn.completed":
      console.log("token 用量:", event.usage);
      break;
  }
}

结构化输出：你可以给 Codex 一个 JSON Schema，让它返回结构化数据而不是自然语言：

typescript 复制代码

const turn = await thread.run("总结仓库状态", {
  outputSchema: {
    type: "object",
    properties: {
      summary: { type: "string" },
      status: { type: "string", enum: ["ok", "needs_fix"] },
    },
    required: ["summary", "status"],
  },
});

也支持 Zod schema 转 JSON Schema------如果你已经在用 Zod 做运行时校验，可以直接复用。

线程持久化 ：Codex 的对话线程保存在 ~/.codex/sessions/ 下。如果进程挂了，用 resumeThread(id) 就能恢复：

typescript 复制代码

const thread = codex.resumeThread(savedThreadId);
await thread.run("接着刚才的继续------把这个方案的测试补上");

工作目录控制：默认跑在当前目录，但你可以指定任意 Git 仓库路径：

typescript 复制代码

const thread = codex.startThread({
  workingDirectory: "/path/to/project",
  skipGitRepoCheck: true,  // 非 Git 目录也可用
});

三、SDK 的典型场景

这个 SDK 稳定版出来后，最有想象力的用法不是「替代 CLI」，而是嵌入到自动化流水线里。

场景一：CI 门禁自动修复

PR 提交 → CI 检测到测试失败 → 触发 Codex SDK 拉起一个线程 → Codex 读 diff + 错误日志 → 输出修复建议 + 代码 patch。全程不需要人盯着终端。

场景二：批量代码审计

给 Codex SDK 传一组文件路径，每个文件起一个线程做安全审计/编码规范检查。结果通过结构化输出反哺回你的仪表盘。

场景三：Agent 编排中的子 Agent

如果你在用 Agent SDK 或类似框架做多 Agent 编排，可以把 Codex SDK 当作一个「编码专家」子 Agent 集成进去------它专精写代码改代码，父编排器负责调度和决策。

typescript 复制代码

const codex = new Codex({
  config: {
    sandbox_workspace_write: { network_access: false },
    show_raw_agent_reasoning: false,
  },
});

四、Python SDK 与生态

TypeScript SDK 稳定了，Python SDK 也在推进。包名叫 openai-codex，通过 pip install openai-codex 安装，目前仍在 beta：

python 复制代码

from openai_codex import Codex

with Codex() as codex:
    thread = codex.thread_start()
    result = thread.run("用三个要点解释这个仓库")
    print(result.final_response)

Python SDK 控制的是本地的 Codex app-server，走 JSON-RPC 协议。它自动携带已存在的 Codex 登录态------如果你已经登录了 ChatGPT，直接跑就行，不需要额外认证。

不过 Python SDK 目前还在 beta，文档和示例不如 TypeScript 丰富。如果你用 Python 生态，可以先观望，或者直接用 TypeScript SDK 做后端集成。

五、怎么看这次更新

这次 v0.144.6 不是一个「大版本」，但它透露了几个信号：

第一，GPT-5.6 在 AI 编码工具里的定位已经明确------Sol 冲上限、Terra 做主力、Luna 省成本。三模型的分工比之前的单一模型更清晰，你可以在 Codex 里按任务类型切换，不需要换工具。

第二，OpenAI 在推 Codex 作为平台 。SDK 稳定版的意义大于 GPT-5.6 指令刷新------它是一个信号：Codex 不只是终端里的 Agent，也是一个可以被其他系统集成的引擎。148 万周下载量的 @openai/codex-sdk，说明已经有人在用它了。

第三，如果你已经在用 Codex CLI，这次更新你不需要做任何操作------自动升级到 v0.144.6 后，GPT-5.6 三模型的指令就是最新的。但如果你还没试过 SDK，现在是个不错的切入点：TypeScript SDK 稳定了，文档也齐了，跑一个 npm install @openai/codex-sdk 就能开始玩。

不是工具更新了就一定要追。但 SDK 稳定这件事，比多几个 bugfix 更值得关注------它打开了「把 Agent 嵌入自己系统」的可能性。你可以从一条命令开始试：npm install @openai/codex-sdk，然后对着文档写 10 行代码。如果跑通了，接下来的想象空间比你想的大。项目地址在 github.com/openai/codex，SDK 文档在 learn.chatgpt.com/docs/codex-sdk。试过回来告诉我感受。

Codex 升级：GPT-5.6 指令+SDK 稳定版

一、GPT-5.6 三模型的 Codex 适配

二、@openai/codex-sdk 稳定版

核心能力

三、SDK 的典型场景

四、Python SDK 与生态

五、怎么看这次更新

二、`@openai/codex-sdk` 稳定版