Codex 结合 API 中转站使用教程：api.airgt.cc 配置指南

为什么要用中转站

Codex CLI 默认直连 OpenAI 官方接口，但在国内网络环境下常遇到连接超时、访问不稳定等问题。API 中转站的作用是在中间架设一层代理：你的请求发给中转站，中转站转发给上游模型服务，再把结果返回给你。

使用中转站的好处：

• 网络可达：无需自建代理，国内网络直连即可
• 统一计费：按用量充值，比订阅制更灵活
• 多模型聚合：一个 Key 通常可切换多家模型

本教程以中转站 https://api.airgt.cc/ 为例，其他中转站配置方式相同，只需替换地址与 Key。

准备工作

1. 注册中转站并创建 API Key（形如 sk-xxxx）
2. 在中转站后台确认可用模型列表与接口地址（通常接口根地址为 https://api.airgt.cc，OpenAI 兼容路径为 /v1）
3. 本地已安装 Codex CLI（npm install -g @openai/codex）

方式一：环境变量（最简单）

Codex 支持通过 OpenAI 兼容环境变量覆盖默认接口地址：

# macOS / Linux（写入 ~/.zshrc 或 ~/.bashrc）
export OPENAI_BASE_URL="https://api.airgt.cc/v1"
export OPENAI_API_KEY="sk-你的中转站Key"

# Windows PowerShell
setx OPENAI_BASE_URL "https://api.airgt.cc/v1"
setx OPENAI_API_KEY "sk-你的中转站Key"

设置后重新打开终端，运行 codex 即可。适合个人电脑上快速启用。

方式二：config.toml（推荐，可长期固化）

Codex 的配置文件位于 ~/.codex/config.toml（Windows 在 C:\Users\你的用户名\.codex\config.toml）。添加自定义模型提供方：

# 默认使用的模型，按中转站后台支持的模型名填写
model = "gpt-4o"
model_provider = "airgt"

[model_providers.airgt]
name = "airgt"
# OpenAI 兼容接口地址，注意保留 /v1
base_url = "https://api.airgt.cc/v1"
# 从哪个环境变量读取 API Key
env_key = "AIRGT_API_KEY"
# 使用 OpenAI Chat Completions 兼容协议
wire_api = "chat"

再设置 Key 的环境变量：

# macOS / Linux
export AIRGT_API_KEY="sk-你的中转站Key"

# Windows PowerShell
setx AIRGT_API_KEY "sk-你的中转站Key"

这种方式的好处：官方登录与中转站配置互不干扰，切换时只需改 model_provider 一行。

验证是否配置成功

codex "回复 OK 两个字母即可"

能正常返回即配置完成。也可以先测试连通性：

curl https://api.airgt.cc/v1/models -H "Authorization: Bearer sk-你的中转站Key"

返回模型列表 JSON 说明地址与 Key 均有效。

常见问题排查

安全提醒

• 中转站能看到你请求的全部内容，切勿在代码或提示词中包含密码、密钥、生产数据
• 公司敏感项目建议使用官方渠道或自建网关
• Key 泄露立即在中转站后台重置

小结

通过中转站为 Codex 配置自定义 base_url，两分钟就能解决国内访问难题。推荐使用 config.toml 方式长期固化，配合环境变量管理 Key。配好之后，回到本站的《Codex CLI 入门教程》和《STM32 实战教程》开始你的 AI 结对编程之旅。