TokensClubCodex 接入教程
将 TokensClub 接入 Codex CLI、桌面端或官方 IDE 扩展。本页适用于本机运行的客户端；浏览器中的 ChatGPT／云端任务不会应用你电脑的这份配置。
1. 准备 Key 与模型
先安装官方 Codex 客户端。登录 TokensClub，在 API 密钥页创建专用 Key，选择可用的 GPT 分组，并确认账户余额与 Key 权限。
| Base URL | https://tokensclub.top/v1 |
|---|---|
| API | OpenAI Responses |
| API Key | YOUR_TOKENSCLUB_API_KEY |
| Model | gpt-6.1-sol |
gpt-6.1-sol 是当前目录中的配置示例；实际可用性以你的 Key 分组为准。Base URL 填到 /v1 为止，不填 /responses，也不填登录页。
2. 配置提供者
先备份现有配置，再将下列字段合并到用户级 config.toml。macOS／Linux 路径为 ~/.codex/config.toml；Windows 为 %USERPROFILE%\.codex\config.toml。不要重复定义相同字段或表，也不要放到项目的 .codex/config.toml。
model = "gpt-6.1-sol"
model_provider = "tokensclub"
web_search = "disabled"
[model_providers.tokensclub]
name = "TokensClub"
base_url = "https://tokensclub.top/v1"
wire_api = "responses"
env_key = "TOKENSCLUB_API_KEY"首次接入先停用内置网络搜索。基本 Responses 连接不代表网络搜索、全部工具或每个模型功能都已兼容；请按实际需求逐项验证。保留原有的文件及命令执行权限设置。
3. 设置密钥并启动
将示例中的 YOUR_TOKENSCLUB_API_KEY 换成你在本站创建的 Key，在自己电脑执行。不要把真实 Key 留在公开示例、截图或代码仓库。
macOS / Linux
export TOKENSCLUB_API_KEY="YOUR_TOKENSCLUB_API_KEY"
codexWindows PowerShell
$env:TOKENSCLUB_API_KEY = "YOUR_TOKENSCLUB_API_KEY"
codex4. 桌面端与 IDE
官方桌面端与 IDE 扩展使用同一份用户配置；修改后重启程序并创建新的本地任务。只在终端 export 密钥，不能保证从 Dock 或开始菜单启动的程序能读到它。
优先将 TOKENSCLUB_API_KEY 提供给启动客户端的进程。如果 GUI 无法获取环境变量，官方也支持下面的本地文件方式：在同一个提供者表内，用这一行替换 env_key，不要两种方式并存。这会将 Key 明文保存在本机，因此只使用用户私有文件，不要放进项目或共享配置。
experimental_bearer_token = "YOUR_TOKENSCLUB_API_KEY"5. 核对连接与用量
在 CLI 使用 /status 查看提供者及模型，确认提供者是 tokensclub。先发送一个只要求回复 OK 的短请求，再到 TokensClub 使用日志核对模型、分组及扣费。这一步会产生实际用量；模型列表加载成功不能代替调用验证。
401：检查密钥及客户端进程是否获取它。404：检查模型与分组、重复 /v1 或误加 /responses。429：检查余额、Key 额度与并发。模型不被客户端识别时，先更新官方客户端并核对模型 ID；不要随意填写未提供的模型目录网址或上下文上限。