Codex

为 Codex CLI 配置 Token Factory 自定义提供方，使用已开放 Responses 接口的国产模型。配置分为 API Key、提供方与模型三部分。

开始前准备

按OpenAI 官方 Codex CLI 安装指南安装，并用 codex --version 确认命令可用。
在控制台创建工具专用 API Key，确认通用余额充足。
在模型文档中选择明确开放 Responses 的模型，复制模型 ID；编程任务需要模型支持工具调用与流式输出。

先确认接口

Codex 使用 Responses。模型支持 Chat Completions，并不代表它能用于此配置。

配置连接

Responses Base URL

Base URL 填写 https://api.tokenfactory.cn/v1。Codex 追加 /responses 后，最终请求为 https://api.tokenfactory.cn/v1/responses。

1. 提供 API Key

在准备启动 Codex 的终端中输入 API Key。执行下面的命令后会等待输入，粘贴后按回车；Key 不会显示在终端或写入命令历史。

macOS / Linux · Bash 或 ZshWindows · PowerShell

bash

export TOKENFACTORY_API_KEY
read -r -s TOKENFACTORY_API_KEY

powershell

$tokenFactorySecret = Read-Host "Token Factory API Key" -AsSecureString
$env:TOKENFACTORY_API_KEY = [System.Net.NetworkCredential]::new("", $tokenFactorySecret).Password

2. 添加自定义提供方

编辑用户级配置 ~/.codex/config.toml，将 <model-id> 替换为实际模型 ID。已有文件时合并以下配置，保留其他设置；顶层的 model 与 model_provider 应放在第一个 TOML 表之前。

toml

model = "<model-id>"
model_provider = "tokenfactory"

[model_providers.tokenfactory]
name = "Token Factory"
base_url = "https://api.tokenfactory.cn/v1"
env_key = "TOKENFACTORY_API_KEY"
wire_api = "responses"

env_key 填环境变量的名字，真实 Key 由当前进程读取。提供方配置放在用户级文件中，具体字段见 OpenAI 官方自定义提供方文档。

发起首次对话

在同一终端进入测试目录，运行 codex。
确认当前提供方为 Token Factory、模型为填写的 ID，发送：“只回复‘连接成功’，不读取文件、不执行命令。”
得到正常回复后，再测试解释一个小文件，检查工具调用与流式回复。

需要临时更换模型时，可在启动时显式指定：

bash

codex --model "<model-id>"

本页请求使用 Token Factory 通用余额按量计费。更换模型时仍需确认新模型开放 Responses，不要照搬 Codex 内置提供方的模型名称。

常见问题

现象	检查方法
提示缺少环境变量或认证失败	确认 `env_key` 拼写正确，且在提供 Key 的同一终端启动 Codex。
仍显示其他提供方或模型	检查配置文件位置、启动参数和当前选择的配置，确认 `model_provider = "tokenfactory"`。
`/responses` 返回 `404`	确认 Base URL 带 `/v1`，且没有重复添加 `/responses`。
Chat Completions 成功，Codex 请求失败	分别核对 Responses 能力、模型 ID 和服务端错误；两个接口的可用性不能互相替代。
工具调用、长上下文或压缩失败	核对具体接口和参数支持范围。基础对话成功不代表客户端的所有辅助功能都已兼容。
`429`、余额不足或超时	按错误处理排查；文件操作已开始时先检查状态，避免重复执行。

Codex ​

开始前准备 ​

配置连接 ​

1. 提供 API Key ​

2. 添加自定义提供方 ​

发起首次对话 ​

常见问题 ​

相关文档 ​