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-v3.1。
请妥善保存 API Key。密钥仅用于本地 Codex 配置，不要提交到 Git 仓库或公开文档中。
安装 Codex
在安装 Codex 前，请确保本地环境已安装 Node.js 18 或更高版本。
如果您使用 macOS 且已安装 Homebrew，可以执行：
检查 Node.js 与 npm 版本：
安装 Codex CLI：
npm install -g @openai/codex
配置 API Key
打开您的 shell 配置文件，例如 ~/.zshrc：
写入环境变量：
export PPIO_API_KEY="<your-ppio-api-key>"
source ~/.zshrc
echo $PPIO_API_KEY
配置 Codex
打开 Codex 配置文件：
mkdir -p ~/.codex
nano ~/.codex/config.toml
model 替换为您要使用的 PPIO 模型 ID：
model_provider = "ppio"
model = "deepseek/deepseek-v3.1"
[model_providers]
[model_providers.ppio]
name = "PPIO"
wire_api = "responses"
requires_openai_auth = true
base_url = "https://api.ppio.com/openai/v1"
env_key = "PPIO_API_KEY"
启动 Codex
进入您的项目目录，然后启动 Codex：
cd <your-project-directory>
codex
PPIO_API_KEY 是否已在当前终端会话中生效。model 是否与 PPIO 模型详情页中的 Model ID 完全一致。base_url 是否为 https://api.ppio.com/openai/v1。
