YUNQIAO · CODEX GUIDE

订阅切换为 API

以当前使用订阅登录的 Codex 为例，切换到 API Key 配置。

← 返回教程目录

开始前请先备份

修改配置文件前，务必先备份。切换过程中会覆盖当前配置；如果需要恢复订阅登录，只需将备份文件改回原文件名即可。

Windows 配置目录

在文件资源管理器地址栏输入：

%USERPROFILE%\\.codex

例如你的 Windows 用户名是 Alice，实际路径就是：

C:\Users\Alice\.codex

配置文件位于该目录下的 config.toml 和 auth.json。

macOS 配置目录

在 Finder 中按 Command + Shift + G，输入：

~/.codex

也可以在终端执行 open ~/.codex 打开目录。

切换步骤

1. 备份当前订阅配置

将当前文件复制并重命名：

config.toml → config.toml.dy
auth.json   → auth.json.dy

2. 新建 API 配置文件

在同一配置目录新建 config.toml 和 auth.json。

3. 写入 config.toml

model = "gpt-5.6-sol"
model_provider = "tokencloud"
forced_login_method = "api"
cli_auth_credentials_store = "file"

[model_providers.tokencloud]
name = "云桥"
wire_api = "responses"
requires_openai_auth = true
base_url = "https://ai.aiyq.cloud/v1"

4. 写入 auth.json

{
  "OPENAI_API_KEY": "your api key"
}

将 your api key 替换为官网创建的 API Key。获取方式请参考获取 API Key 与 URL。

5. 保存 API 配置备份

config.toml → config.toml.api
auth.json   → auth.json.api

6. 重启并验证

完全退出 Codex 后重新打开，发送一条简短消息（例如“你好”）进行验证。能正常收到回复，说明 API 配置已生效。

7. 在订阅和 API 模式之间切换

完成前面的备份步骤后，配置目录中应该有三组配置文件：

config.toml
auth.json

这是当前正在生效的配置文件，Codex 启动时默认读取这一组。

config.toml.api
auth.json.api

这是 API 模式的备份配置。

config.toml.dy
auth.json.dy

这是原来的订阅登录模式备份配置。无论当前使用哪一种模式，Codex 实际读取的始终是不带后缀的 config.toml 和 auth.json；带有 .api 或 .dy 后缀的文件只是备份，不会被 Codex 自动读取。

切换到 API 模式

假设当前正在使用订阅模式。先完全退出 Codex，然后按以下顺序操作：

  1. 把当前订阅配置临时改名：
    config.toml → config.toml.dy
auth.json   → auth.json.dy
    如果原来已经存在同名的 .dy 文件，请先确认它就是订阅配置备份，不要直接覆盖重要文件。
  2. 把 API 配置备份改为 Codex 默认读取的文件名：
    config.toml.api → config.toml
auth.json.api   → auth.json
  3. 重新启动 Codex，发送一条简短消息进行测试。此时 Codex 读取的是不带后缀的文件，已经切换到 API 模式。

切换回订阅模式

假设当前正在使用 API 模式。先完全退出 Codex，然后按以下顺序操作：

  1. 先把当前 API 配置保存回 .api 文件：
    config.toml → config.toml.api
auth.json   → auth.json.api
  2. 把订阅配置备份恢复为不带后缀的文件名：
    config.toml.dy → config.toml
auth.json.dy   → auth.json
  3. 重新启动 Codex，发送一条简短消息进行测试。此时 Codex 已切换回订阅登录模式。

切换时的注意事项