Codex CLI 国内配置教程：Base URL 与 API Key 设置

Codex CLI 国内接入时，OpenAI 兼容 Base URL 填 https://api.apikl.ai/v1，再配置控制台创建的 API Key；本文提供 macOS、Linux、Windows、环境变量和 config.toml 完整示例。

💡

先决条件：已安装 Node.js（见上节），并在 控制台 创建好 API Key（形如 sk-...）。

安装 Codex CLI

BASH复制

npm install -g @openai/codex

方法一 · 环境变量（最快）

macOS / Linux复制

export OPENAI_BASE_URL="https://api.apikl.ai/v1"export OPENAI_API_KEY="sk-你的密钥"codex

Windows · PowerShell复制

$env:OPENAI_BASE_URL="https://api.apikl.ai/v1"$env:OPENAI_API_KEY="sk-你的密钥"codex

📌

提示：部分较新版本的 Codex CLI 会忽略 OPENAI_BASE_URL 环境变量。若上面环境变量法连不上，请改用下面方法二的 config.toml 自定义服务商（更稳妥），并用 -m gpt-5.5 或在 config.toml 里指定模型。

方法二 · 配置文件 ~/.codex/config.toml

TOML复制

model = "gpt-5.5"model_provider = "apikl"[model_providers.apikl]name = "apikl"base_url = "https://api.apikl.ai/v1"env_key = "OPENAI_API_KEY"wire_api = "chat"

📌

不同 Codex 版本的配置字段（如 wire_api、配置文件路径）可能有差异，以官方文档为准。

验证

BASH复制

codex "用一句话介绍你自己"

能返回模型回复即接入成功。

在 Codex 中通过 API 快连生成图片

📌

使用第三方 API 接入时，不要依赖 Codex 内置 Image Gen。该内置工具按 OpenAI 官方账号和工作区权限校验，可能返回 403 Forbidden，而且请求可能不会进入 API 快连。使用 API 快连密钥生图时，请改用 gpt-image-2 调用 /v1/images/generations。

1. 设置环境变量

macOS / Linux复制

export OPENAI_BASE_URL="https://api.apikl.ai/v1"export OPENAI_API_KEY="sk-你的密钥"

Windows · PowerShell复制

$env:OPENAI_BASE_URL="https://api.apikl.ai/v1"$env:OPENAI_API_KEY="sk-你的密钥"

请在 Codex 将要使用的同一个终端会话中设置变量。不要把完整 API Key 粘贴到聊天、截图或公开代码仓库中。

2. 把这段提示词复制给 Codex

提示词复制

不要调用 Codex 内置 Image Gen。请在终端调用 OpenAI 兼容的图片生成接口：Base URL: https://api.apikl.ai/v1Endpoint: /v1/images/generationsModel: gpt-image-2从 OPENAI_API_KEY 环境变量读取密钥，不要打印或展示密钥。根据我的要求生成图片，将结果保存到当前项目，并返回文件路径。

3. 直接验证图片接口

BASH复制

curl -sS "$OPENAI_BASE_URL/images/generations" \ -H "Authorization: Bearer $OPENAI_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"gpt-image-2","prompt":"电商产品图，白色棚拍背景，柔和灯光，无文字无水印，主体居中","size":"1024x1024"}'

💡

gpt-image-2 当前在此接口不支持透明背景，请改用白色或其他纯色背景。即使内置 Image Gen 仍返回 403，也不代表该图片接口不可用，请以上面的命令验证实际 API 链路。

✅

还没有 Key？去控制台创建 →  ·  看模型价格 →