Codex 接入

Codex CLI 是 OpenAI 官方的命令行编程助手。接上 Aivisx Link 后可以用平台额度驱动它。

前置条件

• 已安装 Node.js 18+
• 已创建一把 gpt-plus 或 gpt-pro 分组的 API Key

分组必须是 gpt-*

Codex 走 OpenAI 协议。claude 分组的 Key 不能用，会报分组不匹配。

安装 Codex

npm install -g @openai/codex

验证：

codex --version

配置接入

Codex 的配置写在 ~/.codex/config.toml（Windows 是 %USERPROFILE%\.codex\config.toml）。

1. 创建配置文件

如果文件不存在，先创建目录和文件：

macOS / Linux

mkdir -p ~/.codex
nano ~/.codex/config.toml

Windows（PowerShell）

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex"
notepad "$env:USERPROFILE\.codex\config.toml"

2. 写入配置

model = "gpt-5.5"
model_provider = "aivisx"

[model_providers.aivisx]
name = "Aivisx Link"
base_url = "https://aivisx.link/v1"
env_key = "AIVISX_API_KEY"
wire_api = "responses"

这里的 base_url 要带 /v1

Codex 的 base_url 是完整的 API 前缀，需要以 /v1 结尾。这一点和 Claude Code 正好相反，注意区分。

3. 设置 API Key 环境变量

Codex 从 env_key 指定的环境变量里读取 Key。

macOS / Linux

echo 'export AIVISX_API_KEY="sk-你的KEY"' >> ~/.zshrc
source ~/.zshrc

Windows（PowerShell，永久生效）

[Environment]::SetEnvironmentVariable("AIVISX_API_KEY", "sk-你的KEY", "User")

设置后重新打开终端。

4. 验证

codex

随便提一个编码需求，能正常返回就说明接通了。

配置项说明

配置项	说明
model	默认模型，可用值见 模型选择
model_provider	指向下面定义的供应商名
base_url	Aivisx Link 的 API 地址，以 /v1 结尾
env_key	存放 API Key 的环境变量名，名字可以自己起
wire_api	固定 responses，Codex 使用 Responses API

推荐模型搭配

场景	模型
日常编码	gpt-5.5
复杂任务	gpt-6-astra 或 gpt-5.6-sol
轻量快速	gpt-5.4-mini

常见问题

Q：报 401 Unauthorized 检查环境变量名是否和 env_key 一致，以及是否重新打开了终端。

Q：报 404base_url 结尾少了 /v1，或者多写了一段路径。正确值是 https://aivisx.link/v1。

Q：Codex 提示登录 / 要求 ChatGPT 账号 说明它没读到自定义供应商配置。确认 config.toml 的路径正确、TOML 语法没有错误（尤其是引号）。

Q：想同时用 Claude Code 和 Codex 两者配置互不干扰：Claude Code 读 ANTHROPIC_* 环境变量，Codex 读 ~/.codex/config.toml。可以并存。

Q：高峰期不稳定 换 gpt-pro 分组的 Key（倍率 0.15，账号池更优）。

下一步

• 模型选择
• API 参考
• 疑难杂症