Codex CLI 手动接入

本页适用于 Codex CLI（命令行）。第一次使用建议先按 CC Switch 接入教程操作；这里提供手动配置的备用方式。桌面端的启动环境与命令行可能不同，不要直接假定终端中的密钥变量会被桌面端读取。

准备信息

先安装 Codex CLI，安装步骤见官方说明。在终端运行 codex --version 能显示版本后，再继续配置。仅安装 CC Switch 不等于已经准备好命令行客户端。

先创建 API 密钥，确认分组支持 Codex 和所选模型。建议给密钥起名，例如 codex-macbook 或 codex-windows。

项目	填写内容
Base URL	`https://api.259aitoken.com/v1`
API Key	259AI 控制台创建的密钥
模型	当前密钥分组支持、可用于 Codex 的模型名称
密钥环境变量名	`SUB2API_API_KEY`

这里的 Base URL 用于手动配置 Codex CLI，保留 /v1，不要再加 /responses。通过 CC Switch 导入时，保留系统生成的根地址，见接入教程。

1. 配置 Provider

先备份现有配置，再用文本编辑器打开下列文件；文件不存在时可以创建：

系统	配置文件
macOS / Linux	`~/.codex/config.toml`
Windows	`%USERPROFILE%\.codex\config.toml`
Windows 下的 WSL	WSL 内的 `~/.codex/config.toml`

将下面配置合并到文件中。把 YOUR_CODEX_MODEL 替换为当前分组支持的模型名，不要将 API Key 填进这段 TOML。

toml

model = "YOUR_CODEX_MODEL"
model_provider = "sub2api"

[model_providers.sub2api]
name = "259AI"
base_url = "https://api.259aitoken.com/v1"
env_key = "SUB2API_API_KEY"
wire_api = "responses"
requires_openai_auth = false

model 和 model_provider 是顶层设置，要放在第一个 [表名] 之前。已有相同设置或 [model_providers.sub2api] 时修改原项，不要重复追加。控制台 “使用密钥” 提供的是完整的另一套配置；选择一种方式，不要混合它的鉴权字段与本页的 env_key。

2. 在当前终端安全输入密钥

下面的命令在提示出现后读取密钥，不会回显，也不会把密钥直接写进命令历史。只对当前终端及从它启动的程序生效；关闭终端后需重新设置。

macOS 默认终端（Zsh）

zsh

read -rs "SUB2API_API_KEY?粘贴 259AI API Key 后按回车："
export SUB2API_API_KEY
printf '\n'

Linux / WSL（Bash）

bash

read -rsp '粘贴 259AI API Key 后按回车：' SUB2API_API_KEY
export SUB2API_API_KEY
printf '\n'

Windows PowerShell

powershell

$sub2apiSecret = Read-Host '粘贴 259AI API Key 后按回车' -AsSecureString
$env:SUB2API_API_KEY = [System.Net.NetworkCredential]::new('', $sub2apiSecret).Password
Remove-Variable sub2apiSecret

3. 启动并做第一次测试

在刚才设置密钥的同一个终端运行：

codex

在会话内输入 /status，确认当前使用 259AI 的供应商配置，模型与刚才的配置一致。
新建会话发送：“请只回复：连接成功。不要读取文件或执行命令。”，等待完整回复。
回到 259AI 使用记录，核对该密钥、请求时间、模型和消耗。短消息测试按正常规则计费。

模型自述、模型列表或 HTTP 200 只提供部分信息；完整回复与本站对应记录一起，才说明这次测试完成。

常见排查

现象	先检查
401 / 缺少 API Key	从设置 `SUB2API_API_KEY` 的同一个终端启动；不要把 `requires_openai_auth` 改成 `true` 与 `env_key` 混用
模型不存在或不支持	核对完整模型名、密钥分组；需要模型目录时按控制台“使用密钥”的提示处理
Provider 没有切换	检查顶层设置位置、是否仍在旧会话，以及是否启用了其他 Profile 或项目配置
路径错误 / 404	手动 `base_url` 只到 `/v1`，不要重复 `/v1/v1` 或拼完整接口路径
回复中断、一直等待	保留请求时间和错误信息，查看错误排查，不要连续重试大任务

参考：OpenAI 官方网关配置、官方鉴权说明。

Codex CLI 手动接入 ​

准备信息 ​

1. 配置 Provider ​

2. 在当前终端安全输入密钥 ​