不想手动配置？

把本页地址发给 Codex，让它帮你改配置文件。

登录官方账号 + 使用平台 API

Codex App 支持用自己的 ChatGPT 账号登录，同时让请求走 CodexZH 的 API 接口。

好处：

• 无需额外软件或插件，即可使用 Codex App 里的插件功能
• 支持最新版本的 Codex 手机 App
• 免费账号、Plus、Pro 均可
• 切换 API 平台后，账号历史记录不受影响

前提条件

• 已有 CodexZH 的 API Key（购买地址）
• 已安装 Codex App 并登录 ChatGPT 账号。

配置步骤

第一步：登录官方账号

打开 Codex App，用 ChatGPT 账号登录（免费账号、Plus、Pro 均可）。

第二步：找到配置文件

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

第三步：添加 API 配置

用文本编辑器打开 config.toml，在文件顶部添加：

model_provider = "codexzh"

[model_providers.codexzh]
name = "codexzh"
base_url = "https://api.codexzh.com/v1"
experimental_bearer_token = "sk-xxx"
requires_openai_auth = true

将 sk-xxx 替换为你的 CodexZH API Key。

注意

requires_openai_auth = true 让 Codex 在请求时同时携带 ChatGPT 账号认证信息，插件功能才能正常使用。

第四步：验证配置

1. 保存配置文件，新建一个 Codex 会话
2. 随便发一条消息
3. 打开「使用统计」→「日志」，查看是否有请求记录

如果没有请求记录，重启 Codex App 再试。