TokensClubCC Switch 使用教程
用 CC Switch 保存和切换 TokensClub 的 Claude Code、Codex 配置。这是本地配置管理工具；模型用量仍由 TokensClub 账户计费。先为两个应用分别创建配置。
先用一键导入
TokensClub 控制台已内置 CC Switch 导入，通常无需手动粘贴 JSON 或 TOML。先安装 CC Switch，再登录本站的“API 密钥”，为所选分组创建或选择一把有效 Key。
在该 Key 的“⋯”菜单选择“CC Switch”，选 Claude 或 Codex，填写名称并选主模型。Claude 还可选填 Haiku／Sonnet／Opus 模型。只选该 Key 分组已开放的模型；列表中出现名称不代表该 Key 有使用权限。
点“打开 CC Switch”，若浏览器询问，允许打开已安装的 CC Switch；在应用中核对 TokensClub 地址、模型和密钥后确认导入。该链接会把所选 Key 交给本机 CC Switch，不要复制或分享包含 Key 的导入链接。
Claude 和 Codex 需要用各自对应分组的 Key 分别导入。完成后按下方“切换与核对”确认正在使用的提供者；Codex 需要重开客户端。如果没有弹出应用，先确认 CC Switch 已安装、浏览器未拦截外部应用链接，或使用下面的手动配置。
1. 安装与准备
按你的 Windows、macOS 或 Linux 系统选择安装包，并先安装需要使用的 Claude Code／Codex 客户端。CC Switch 无法运行尚未安装的客户端。界面名称可能随版本变化，下面以提供者的直接连接模式说明。
到 API 密钥创建 TokensClub Key · 核对分组和可用模型
为 Claude 和 GPT 分组分别准备有权限的 Key；不要把账户密码当成 API Key。先保留原来的提供者，方便切回；包含 Key 的配置和导出备份应私密保存。
2. 添加 Claude Code
在侧栏选 Claude Code → 直接连接（Direct）→ 添加提供者（Add Provider）→ 自定义配置（Custom Configuration）。名称填 TokensClub Claude，将下面 JSON 粘贴到配置编辑器，把占位文字替换为你自己的 Claude 分组 Key。
| Base URL | https://tokensclub.top |
|---|---|
| Model | claude-sonnet-4-6 |
| Haiku | claude-haiku-4-5 |
{
"env": {
"ANTHROPIC_BASE_URL": "https://tokensclub.top",
"ANTHROPIC_AUTH_TOKEN": "YOUR_TOKENSCLUB_API_KEY",
"ANTHROPIC_MODEL": "claude-sonnet-4-6",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
}
}地址不要加 /v1 或 /messages；Claude Code 会自行组合 Messages 路径。此示例使用 ANTHROPIC_AUTH_TOKEN；不要同时留下另一把 ANTHROPIC_API_KEY。保存后仍要点切换／使用，使提供者进入“使用中”。
3. 添加 Codex
切到 Codex → Direct → Add Provider → Custom Configuration，名称填 TokensClub Codex。如果表单有 API Key、端点和模型字段，可直接填写；选择原生 Responses 协议。如果显示两个编辑区，按下面分别填写。
| Base URL | https://tokensclub.top/v1 |
|---|---|
| Model | gpt-6.1-sol |
| API | Responses |
API Key／auth.json 编辑区：把占位文字替换为你自己的 GPT 分组 Key。这里是 CC Switch 的提供者字段，不是要求覆盖电脑上官方登录的 auth.json。
{
"OPENAI_API_KEY": "YOUR_TOKENSCLUB_API_KEY"
}config.toml 编辑区：下面配置使用原生 Responses，无需为了转换协议而开启本地代理。不要再添加手动教程的 env_key，避免混用两套密钥来源。
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"
requires_openai_auth = false当前官方说明中，切换到第三方提供者时，CC Switch 会把密钥写入本机 config.toml 的 experimental_bearer_token。它是明文敏感数据，不能提交到项目或分享截图。
4. 切换与核对
保存后，分别在 Claude Code 和 Codex 的提供者列表点切换／使用。两者独立：切换 Claude 不会代你切换 Codex。首次验证建议先退出客户端再打开；Codex CLI 必须退出后重开，桌面端要完全退出再开，IDE 扩展则重新加载窗口。
在客户端用 /status 核对模型和提供者，再发一条简短测试，例如“只回复 OK”。测试会消耗正常模型额度。到 TokensClub 用量记录核对模型、分组和扣费；仅看到“使用中”或延迟测试成功，不代表全部工具功能都已通过。
5. 常见问题
401／403：检查 Key 是否完整、有效并有对应分组权限；Claude 和 GPT 的 Key 不要混用。404：Claude 用根网址，Codex 用 /v1，两者都不要填完整请求路径。模型不可用：到模型页复制该分组当前可用的完整 ID。
切换后仍使用旧配置：检查当前生效的是 Direct 还是路由／聚合模式，以及终端、IDE 或启动脚本中是否另设旧 API 地址或密钥。先备份，再移除冲突的旧配置并重开客户端；不要删除整个配置目录或登录文件。