接入 Codex CLI #

Codex CLI 使用 OpenAI 兼容接口。极智网关的 Base URL 为：

https://api.aethesauce.space/v1

1. 安装 Codex CLI #

已经安装的用户可以跳过此步。

npm install -g @openai/codex

2. 设置密钥环境变量 #

环境变量名可以自定义，下面统一使用 AETHE_API_KEY。

Windows PowerShell #

$env:AETHE_API_KEY = "YOUR_API_KEY"

macOS / Linux #

export AETHE_API_KEY="YOUR_API_KEY"

以上命令只对当前终端会话生效，关闭窗口后不会保留密钥。

3. 配置供应商 #

打开 Codex 配置文件：

• Windows：%USERPROFILE%\.codex\config.toml
• macOS / Linux：~/.codex/config.toml

供应商和鉴权配置必须写入上面的用户级文件，不要写入项目目录中的 .codex/config.toml，否则 Codex 会忽略 model_provider 和 model_providers。

加入以下配置，将 <MODEL_ID> 替换为控制台中当前分组支持的 Codex 模型 ID：

model_provider = "aethe"
model = "<MODEL_ID>"

[model_providers.aethe]
name = "极智网关"
base_url = "https://api.aethesauce.space/v1"
env_key = "AETHE_API_KEY"
wire_api = "responses"

4. 启动并验证 #

codex

进入交互界面后发送一个简短请求。随后可在极智网关控制台的请求记录中确认调用是否成功、使用了哪个模型以及实际消耗。

分组建议 #

• CodexPro（0.6x）：满血顶配，无降频、无阉割，适合长任务和重要项目。
• Codex-Plus（0.2x）：Plus / Team 号池，适合日常编码。
• CodexPlus-不稳定（0.1x）：仅建议用于允许失败和重试的速刷任务。

常见问题 #

提示找不到模型 #

模型 ID 与显示名称不一定相同。请从控制台复制准确 ID，并确认当前分组包含该模型。

返回 401 #

确认当前终端已设置 AETHE_API_KEY，且 env_key 拼写一致。不要把 Bearer 前缀写进环境变量值。

请求没有走极智网关 #

检查 model_provider = "aethe" 是否位于配置文件顶层，并确认 base_url 为 https://api.aethesauce.space/v1。

配置字段的完整定义可查阅 Codex config.toml 官方参考。