第五部分，自动化与 Codex SDK

Codex SDK 入门

用 TypeScript 或 Python Codex SDK 创建线程、运行任务、继续上下文并控制沙箱。

高级 / 12 分钟 / 第 30 篇

TypeScript SDK

Codex SDK 把与 Codex 代理交互的线程模型放进应用代码。TypeScript 包要求 Node.js 18 或更高版本。一个线程可以连续运行多个任务并保留上下文。

SDK 调用仍需要明确工作目录、身份验证、超时和权限。不要让来自用户的任意文本直接获得工作区写入。

bash
npm install @openai/codex-sdk
typescript
import { Codex } from "@openai/codex-sdk";

const codex = new Codex();
const thread = codex.startThread();
const result = await thread.run(
  "调查 CI 失败，给出修复计划，不要修改文件",
);
console.log(result.finalResponse);

Python SDK

Python Codex SDK 目前处于 beta，要求 Python 3.10 或更高版本。显式选择 sandbox 可以让服务端代码清楚表达权限边界。

生产封装应记录线程标识、任务版本和关键事件，并对进程崩溃或超时提供恢复策略。

bash
pip install openai-codex
python
from openai_codex import Codex, Sandbox

with Codex() as codex:
    thread = codex.thread_start(
        model="gpt-5.6",
        sandbox=Sandbox.read_only,
    )
    result = thread.run("解释仓库架构并列出风险")
    print(result.final_response)

官方资料

本页由 xueai 根据 OpenAI 官方资料重新组织并用中文讲解。产品会持续更新，涉及版本、模型和命令时请同时核对下列官方页面。