OpenAI Codex API 配置教程

一、安装 Codex 客户端

根据使用习惯选择任一客户端安装即可，配置方式相同。

二、获取 API Key

1. 打开 AIOSS 并登录。
2. 在左侧导航栏找到 API 密钥 或 API Key 菜单。
3. 点击 新建 / 创建 API Key。
4. 填写名称，并选择 分组。分组决定使用的渠道和扣费倍率，详见下方说明。
5. 确认创建后，点击右侧 复制 按钮获取 Key，格式为 sk-xxxxxxxx。

关于分组与倍率

创建 Key 时必须指定分组，不同分组对应不同的渠道和扣费倍率：

• 倍率 0.2：每消耗上游 $1，账户额度扣除 $0.2。
• 倍率 1.0：每消耗上游 $1，账户额度扣除 $1.0。

倍率越低，同等额度可使用更多用量，请根据需求选择合适的分组。

三、配置 Codex

方式一：使用 cc-switch 可视化配置（推荐）

使用 cc-switch 可以通过图形界面一键配置 Codex。详细步骤见 cc-switch 配置。

方式二：手动配置

macOS

第一步：打开配置文件

在终端执行：

open -e ~/.codex/config.toml

第二步：配置 config.toml

写入以下内容：

model_provider = "aioss"
model = "gpt-5.6-sol"
disable_response_storage = true
model_reasoning_effort = "high"
model_verbosity = "high"

[features]
web_search_request = true

[model_providers.aioss]
name = "aioss"
base_url = "https://www.aioss.cc/v1"
wire_api = "responses"
requires_openai_auth = true

第三步：配置 auth.json

在终端执行：

open -e ~/.codex/auth.json

写入以下内容，将 xxx 替换为你的 API Key：

{
  "OPENAI_API_KEY": "xxx"
}

Windows

第一步：打开配置目录

按下 Win + R，输入以下内容后回车：

%userprofile%\.codex

第二步：配置 config.toml

在打开的目录中编辑 config.toml 文件，写入以下内容：

model_provider = "aioss"
model = "gpt-5.6-sol"
disable_response_storage = true
model_reasoning_effort = "high"
model_verbosity = "high"

[features]
web_search_request = true

[model_providers.aioss]
name = "aioss"
base_url = "https://www.aioss.cc/v1"
wire_api = "responses"
requires_openai_auth = true

第三步：配置 auth.json

在同一目录中编辑 auth.json 文件，写入以下内容，将 xxx 替换为你的 API Key：

{
  "OPENAI_API_KEY": "xxx"
}

四、重启 Codex

配置完成后重启 Codex。在会话框中输入 hi，能正常收到回复即代表配置成功。