接入 OpenAI Codex

将 OpenAI Codex CLI 连接到 Puyun AI，使用任意大模型进行 AI 编程。

概述

OpenAI Codex CLI 是 OpenAI 官方的命令行 AI 编程工具，原生使用 OpenAI Chat Completions API 协议。通过 Puyun AI，你可以在 Codex 中调用 Claude、Gemini 等其他模型。

配置方法

方法一：环境变量

在终端中设置以下环境变量：

bash
export OPENAI_API_KEY="sk-your-api-key"
export OPENAI_BASE_URL="https://ai.tracup.com/v1"

然后运行 Codex：

bash
codex

方法二：配置文件

编辑 Codex 配置文件 ~/.codex/config.json：

json
{
  "provider": "openai",
  "apiKey": "sk-your-api-key",
  "baseURL": "https://ai.tracup.com/v1",
  "model": "gpt-4o"
}

使用不同模型

Codex 支持通过参数或配置切换模型：

bash
# 使用 GPT-4o
codex --model gpt-4o

# 使用 Claude Sonnet（协议自动转换）
codex --model claude-sonnet-4-6

# 使用 Gemini 2.5 Pro（协议自动转换）
codex --model gemini-2.5-pro

# 使用 o3 推理模型
codex --model o3

协议自动转换

Codex 使用 OpenAI 协议发送请求。当你通过 Puyun AI 调用非 OpenAI 模型时（如 Claude、Gemini），Puyun AI 会自动完成：

  1. 将 OpenAI 格式的请求转换为目标模型的原生格式
  2. 将目标模型的原生响应转换为 OpenAI 格式
  3. 流式响应的 SSE 事件格式自动适配

验证连接

bash
codex --model gpt-4o "Hello, 验证连接"

如果收到正常响应，说明连接配置成功。

推荐模型

用途推荐模型说明
通用编程claude-sonnet-4-6代码理解和生成能力出色
快速补全gpt-4o-mini响应速度快，成本低
深度推理o3适合复杂逻辑和架构设计
高性价比deepseek-chat性能好，价格低

常见问题

OPENAI_BASE_URL 不生效

确保 URL 包含 /v1 后缀：https://ai.tracup.com/v1。Codex 会在 base URL 后面拼接端点路径（如 /chat/completions）。

模型名称错误

Codex 可能对模型名称有校验。如果遇到模型名称不识别的问题，尝试使用标准模型名称。

响应中断

如果在长代码生成过程中响应中断，可能是 max_tokens 限制或服务层级速率限制导致。尝试使用 Enterprise 层级或调低请求复杂度。