Codex 是运行在终端中的 AI 编程工具。通过自定义 OpenAI-compatible endpoint，可将 Codex 连接到 PPIO 派欧云的大语言模型 API，用于代码理解、生成、重构和调试。
Codex 当前仅支持 Responses API。请按本文配置 wire_api = "responses"，不要切换到 Chat Completions 模式。
前置准备
开始前，请准备以下信息：
- API Key：前往 API 密钥管理 创建或复制 API Key。
- Base URL：
https://api.ppio.com/openai/v1
- Model ID：在模型广场或模型详情页复制模型 ID，例如
deepseek/deepseek-v4.1-flash。
请妥善保存 API Key。API Key 仅用于本地 Codex 配置，不要提交到 Git 仓库或公开文档。
安装 Codex
安装 Codex 前，请确保本地已安装 Node.js 18 或更高版本。
如果使用 macOS 且已安装 Homebrew，可执行：
检查 Node.js 与 npm 版本：
安装 Codex CLI：
检查 Codex 版本：
配置 API Key
打开 shell 配置文件，例如 ~/.zshrc：
写入环境变量：
保存后刷新配置，并确认变量已生效：
配置 Codex
打开 Codex 配置文件：
写入以下配置，将 model 替换为要使用的 PPIO 模型 ID：
启动 Codex
进入项目目录，启动 Codex：
启动后，可输入编程任务，例如：
如果 Codex 返回模型不存在或鉴权失败，请检查：
PPIO_API_KEY 是否已在当前终端会话中生效。model 是否与 PPIO 模型详情页中的 Model ID 完全一致。base_url 是否为 https://api.ppio.com/openai/v1。
