● CODEX · DEVELOPER API

Codex开发工具下载 兼容OpenAI接口规范,支持Tool Calls与结构化输出

Codex API 与开发工具将 OpenAI 编码大模型能力以标准 OpenAI 接口暴露,便于任何熟悉 chat completions 的工程师快速接入。它原生支持 Tool Calls、Function Calling、JSON Schema 与结构化输出,能无缝嵌入 IDE、桌面端与流水线。

nodepythongorustjava.NETcurl
OpenAI Compatible

完全兼容 OpenAI 接口规范

所有 Codex API 端点与 OpenAI chat completions 兼容;只需更换 base_url 与 api_key,即可平滑迁移。

POST /v1/agents/codex/runs

执行一次 Codex 任务,支持对话上下文、工具调用与结构化输出。

POST /v1/agents/codex/threads/:id/messages

向现有线程追加消息,保持多智能体协作中的上下文延续。

GET /v1/agents/codex/runs/:id

查询一个运行的实时状态、当前步骤、输出与中间日志。

WS /v1/agents/codex/stream

建立 WebSocket 长连接,实时回传推理、工具调用与 diff。

GET /v1/skills

列出当前账号可用的 Skills,以及组织级共享技能市场。

POST /v1/sandboxes

申请一个隔离沙盒执行任务,可配置镜像、网络与生命周期。

Tool Calls

原生支持 Tool Calls 与 Function Calling

Codex 与 OpenAI Tool Calls 完全兼容:你可以声明一组工具,让 Codex 在推理过程中按需调用;调用结果会被 Codex 自动处理,再继续推理,直至任务完成。

  • 支持并行 Tool Calls:一次推理可触发多次工具执行
  • 工具声明接受 OpenAI JSON Schema 格式,零迁移成本
  • 工具执行失败自动重试,并返回可读错误信息
  • 支持把 Tool Calls 历史持久化到 Skills 中复用
Structured Output

结构化输出,原生 JSON Schema

Codex 支持 OpenAI 结构化输出能力。只要提供 JSON Schema,输出就会被强约束为 schema 指定的对象,便于自动化流水线直接解析,避免额外清洗与正则。

  • 支持 nested object、enum、$ref 等复杂 schema
  • 提供 strict 模式,强制 100% schema 符合
  • 可与 Tool Calls 组合,让推理过程同样可结构化
  • 支持流式结构化输出,逐步回传字段
SDKs

多语言 SDK & 开发工具

Codex 提供与 OpenAI SDK 接口一致的官方 SDK,几乎零学习成本。

Node.js / TypeScript

与 OpenAI Node SDK 接口一致,支持流式响应、Tool Calls、Tools 流式解析。

Python

提供 Pydantic 模型、Async/Sync 客户端、Skills CLI 与 IPython 集成。

Go

原生 Go SDK,Context 一等公民,适合高并发 Agent 服务。

Rust

tokio 异步运行时优先;常用于 CLI 与客户端库的高性能场景。

Java / Kotlin

面向 JVM 的 SDK,覆盖 Spring Boot 与 Android 编辑器场景。

.NET / curl

支持 .NET 8 与 curl 命令行,便于集成旧有系统与脚本环境。

FAQ

Codex API 与开发工具常见问题

关于接口兼容性、迁移路径与配额策略的解答。

Codex API 与 OpenAI Chat Completions 是否完全兼容?

几乎完全兼容。Base URL 与鉴权 Header 都遵循 OpenAI 规范,已使用 OpenAI SDK 的项目只需修改 base_url 即可切换到 Codex。结构化输出、流式响应、Tool Calls 等高级能力也都对齐。

Tool Calls 最多支持几个工具?

单次请求可声明最多 128 个工具;如需更多,可通过 Skills 把工具市场化为多个集合,由 Codex 按上下文动态加载。

结构化输出是否支持嵌套对象?

支持任意深度的 object、array、enum、$ref 与 additionalProperties 限制;strict 模式下输出会被 100% 验证。

SDK 是否开源?

是。多语言 SDK 均采用 Apache-2.0 协议开源,可在 GitHub 上提交 PR、Issue。

如何鉴权与计费?

使用 OpenAI API Key;Codex 会按 token 计费并显示在 OpenAI 账单,模型与用量可在管理后台查看。

WebSocket 流式协议如何使用?

建立 /v1/agents/codex/stream 连接,发送任务参数;服务端会持续推送 reasoning、tool_call、output 等事件。

是否能在自有环境部署?

开源 SDK 与 CLI 都可在私有环境运行;推理层支持替换为本地模型或第三方推理服务,满足合规与数据本地化需求。

Codex 是否提供 Open WebUI 之类的可视化?

提供官方桌面端,内置 ChatGPT 中的 Codex 与 IDE 扩展;同时兼容社区提供的 Open WebUI、Continue 等开源可视化方案。

把 Codex API 接入你的下一个工程

符合 OpenAI 接口规范、原生 Tool Calls 与结构化输出,让你的 IDE、桌面端与流水线立刻具备 AI 编程能力。

下载 Codex SDK
下载链接已就绪