Codex 小白教程：使用 TokenC API Key 接入 Codex CLI

Codex 小白教程：使用 TokenC API Key 接入 Codex CLI

不用 OpenAI 官方 Key，也能让 Codex 通过 TokenC 的 OpenAI 兼容接口工作。本文从注册、创建 Key、写入配置到首次验证，一步步讲清楚。

适用：Windows + Codex CLI / Codex Desktop｜更新：2026 年 8 月 26 日

一、开始前，先记住这三个信息

TokenC 提供 OpenAI 兼容 API。完成接入后，Codex 会将模型请求发送到 TokenC，再由 TokenC 按你的令牌权限转发处理。

• API 地址：https://tokenc.cc/v1
• 模型名称：以 TokenC 令牌页面中该令牌实际允许使用的模型为准
• API Key：只保存在本机，不要发到聊天群、截图、工单或 Git 仓库

安全提示：API Key 等同于密码。本文的 Key 均为示例，不能直接使用；任何公开文章截图都应打码。

二、注册 TokenC 账号

第 1 步：打开官网

浏览器访问 https://tokenc.cc/，在右上角点击“注册”。

 

图 1：注册入口或注册页截图。页面字段以当日页面显示为准。

第 2 步：完成注册和登录

按页面要求填写邮箱、密码等信息。如站点要求邮箱验证、邀请码或人机验证，请按页面流程完成。注册成功后登录账号。

三、创建用于 Codex 的 API Key

第 3 步：进入“令牌”页面

登录后，在左侧菜单中找到“令牌”。部分界面也可能写成 Token 或 API Key；这是管理调用密钥的地方。

 

图 3：登录后进入控制台，再从导航栏找到“令牌”。控制台内容需要登录后才会显示。

第 4 步：新建令牌并立刻复制 Key

点击“新建令牌”，建议取一个容易识别的名称，例如 codex-laptop。如果页面提供模型限制、有效期或额度设置，按自己的使用场景配置即可。

令牌创建完成后，立即复制完整 API Key 并放进临时安全位置。许多平台只会在创建时完整显示一次，关闭后无法再次查看原文。

建议：一个设备或一个用途单独建立一个令牌。这样即使某台电脑不再使用，也能单独停用对应 Key。

四、配置 Codex 使用 TokenC

TokenC 的令牌页面通常提供“使用 API 密钥”或类似的复制配置入口。看到该入口时，优先复制它生成的配置；下面给出手动配置方式，便于检查。

第 5 步：编辑 config.toml

Windows 下，打开 %USERPROFILE%\.codex 文件夹；没有就新建。创建或编辑 %USERPROFILE%\.codex\config.toml，填写：

model_provider = "new_api"
model = "替换为令牌允许的模型名"
review_model = "替换为令牌允许的模型名"
model_reasoning_effort = "high"
model_context_window = 200000
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true

[agents]
max_threads = 20
max_depth = 1

[model_providers.new_api]
name = "New API"
base_url = "https://tokenc.cc/v1"
wire_api = "responses"
requires_openai_auth = true

[features]
responses_websockets_v2 = false
goals = true
js_repl = false
memories = true

[windows]
sandbox = "unelevated"

其中最重要的是 base_url、model 和 review_model。后两项一定要替换成令牌页面实际展示的完整模型名，不要根据网上示例猜测。

第 6 步：写入 API Key

在同一目录创建 %USERPROFILE%\.codex\auth.json：

{
  "OPENAI_API_KEY": "sk-粘贴你的TokenC真实APIKey"
}

保存后，完全退出并重新打开 Codex Desktop，或者重新启动 Codex CLI。已打开的旧任务可能仍在读取旧配置，因此建议新建一个任务验证。

五、验证是否接入成功

在一个普通测试目录打开终端，运行：

codex

进入新任务后，先发送一个不会修改文件的测试请求：

请只查看当前目录的文件结构，并用三句话说明这个项目的技术栈。不要修改文件。

如果 Codex 正常回复，同时 TokenC 的调用记录出现新的请求，就说明 API Key 接入完成。

六、常见问题

1. 报 401 或认证失败

• 检查 auth.json 是否为合法 JSON。
• 确认 Key 粘贴完整，没有多余空格、换行，也没有被停用或删除。
• 完全退出并重新启动 Codex 后再试。

2. 报模型不存在、404 或模型不可用

• 回到 TokenC 的令牌页面，复制实际可用模型名。
• 同步修改 model 和 review_model。
• 如果令牌启用了模型限制，确认目标模型已经被允许。

3. 要不要选 API Key Mode？

普通 Codex 接入优先使用默认的“兼容模式”，即上面配置中的 requires_openai_auth = true。只有当 TokenC 页面明确要求为客户端图片执行器授权时，才使用 API Key Mode，并完整复制它提供的配置。

结语

整个流程可以概括为：注册 TokenC → 新建令牌 → 复制 Key → 写入 config.toml 和 auth.json → 重启 Codex → 用只读请求验证。

说明：本文根据 2026 年 8 月 26 日 TokenC 的公开页面及其 Codex 配置生成逻辑整理。产品界面、注册规则、可用模型与计费规则都可能变化，请以 tokenc.cc 当日页面为准。