快速接入

兼容 OpenAI / Anthropic 协议，几分钟即可接入 Claude Code、Codex、Cline 等主流 Agent 工具。

快速开始
1
登录控制台
2
获取兑换码充值
3
创建 API 令牌
4
接入工具
接入方式 · 选择你的工具
Claude Code 是 Anthropic 官方 CLI 编程助手，将 Claude 模型集成到终端中，可直接读写代码文件、执行命令与 Git 操作，是目前最主流的终端 AI 编程工具之一。推荐写入 ~/.claude/settings.json 的 env 字段，所有项目全局生效。Windows 路径为 C:\Users\<用户名>\.claude\settings.json。
~/.claude/settings.json
{ "env": { "ANTHROPIC_BASE_URL": "https://api.tokenclub.cc", "ANTHROPIC_AUTH_TOKEN": "你的令牌" } }
或使用环境变量方式（写入 shell 配置可永久生效）：
bash / zsh
export ANTHROPIC_BASE_URL=https://api.tokenclub.cc export ANTHROPIC_AUTH_TOKEN=你的令牌
注意：
① Base URL 末尾不要加斜杠，否则拼接路径会出现双斜杠导致报错。
② 使用第三方 API 时，需将 ~/.claude.json 的 hasCompletedOnboarding 设为 true，以跳过 Anthropic 官方登录引导。
③ 修改配置后请新开终端窗口再运行 claude，并可用 /status 确认地址已指向 TokenClub。
⚡ 一键导入 CC Switch
粘贴你的 API 令牌，生成专属导入链接，点击即可唤起本地 CC Switch 应用自动添加 TokenClub 供应商。
令牌仅在你的浏览器本地拼接为链接，不会上传到任何服务器。
未安装 CC Switch？前往 ccswitch.io 下载（支持 Windows / macOS / Linux）。
Claude Code 常见问题
未跳过官方登录引导。编辑 ~/.claude.json，将 hasCompletedOnboarding 设为 true；并确认 /status 中 Base URL 已指向 TokenClub。修改后需新开终端。
Base URL 末尾多了斜杠。请改为 https://api.tokenclub.cc（结尾无 /）。
部分模型默认开启思考模式，要求回传 thinking 字段。可在分组 / 模型配置中关闭思考模式，或改用未强制思考的模型。
Codex CLI 是 OpenAI 开源的命令行 AI 编程助手，可在终端中通过自然语言生成代码、修复 bug、构建项目。编辑 ~/.codex/config.toml，新增一个 provider 节点并设为默认。令牌通过 env_key 指定的环境变量提供。
~/.codex/config.toml
model = "你要使用的模型名" model_provider = "tokenclub" [model_providers.tokenclub] name = "TokenClub" base_url = "https://api.tokenclub.cc/v1" wire_api = "responses" requires_openai_auth = false env_key = "TOKENCLUB_API_KEY"
注意：
① 启动前设置环境变量：export TOKENCLUB_API_KEY=你的令牌。
② Codex 默认使用 Responses API。若调用报错提示协议不支持，将 wire_api 改为 "chat"。
③ model_provider / base_url 等键必须放在用户级配置（~/.codex/config.toml），放在项目级 .codex/config.toml 会被忽略。
⚡ 一键导入 CC Switch
粘贴你的 API 令牌，生成专属导入链接，点击即可唤起本地 CC Switch 应用自动添加 TokenClub 供应商。
令牌仅在你的浏览器本地拼接为链接，不会上传到任何服务器。
未安装 CC Switch？前往 ccswitch.io 下载（支持 Windows / macOS / Linux）。
Codex CLI 常见问题
该模型或分组未启用 Responses 协议转换。将 wire_api 由 "responses" 改为 "chat" 即可。
provider 与 base_url 必须写在用户级 ~/.codex/config.toml，项目级 .codex/config.toml 中的这些键会被忽略。
Codex 依赖模型的函数 / 工具调用能力，部分较小模型不支持。请选用支持工具调用的模型（如 GPT-5.x、Claude、Qwen Coder 32B+）。
OpenCode 是一个开源的终端 AI 编程代理（GitHub 3 万+ 星标），支持 Claude、GPT-4、Gemini 等多种模型，让你在终端中用自然语言写代码、修 Bug。使用 Anthropic 兼容协议，推荐写入 ~/.config/opencode/settings.json 或使用 /connect 命令交互式配置。
~/.config/opencode/settings.json
{ "env": { "ANTHROPIC_BASE_URL": "https://api.tokenclub.cc", "ANTHROPIC_AUTH_TOKEN": "你的令牌" } }
或通过交互命令配置（v1.14.24+）：
OpenCode
opencode # 在 OpenCode 界面输入： /connect # 输入你的 API 令牌，选择对应模型
注意：
① Base URL 末尾不要加斜杠。
② 使用第三方 API 时需设 hasCompletedOnboarding 为 true，跳过 Anthropic 官方登录引导。
③ 修改配置后需新开终端再运行。
⚡ 一键导入 CC Switch
粘贴你的 API 令牌，生成专属导入链接，点击即可唤起本地 CC Switch 应用自动添加 TokenClub 供应商。
令牌仅在你的浏览器本地拼接为链接，不会上传到任何服务器。
未安装 CC Switch？前往 ccswitch.io 下载（支持 Windows / macOS / Linux）。
OpenCode 常见问题
编辑 ~/.opencode.json（或类似路径），将 hasCompletedOnboarding 设为 true，并确认 Base URL 已指向 TokenClub。配置后新开终端。
OpenCode 原生使用 Anthropic 协议。若需使用 OpenAI 兼容接口，可通过 LiteLLM 等代理转换，或在 OpenCode 社区中搜索第三方 proxy 方案。
请升级 OpenCode 至 v1.14.24 或更高版本。旧版本需手动编辑 settings.json 配置。
OpenClaw 是一个开源的个人 AI 智能体网关，支持 Anthropic Messages API 与 OpenAI Completions API 双协议，可在本地统一管理多个模型供应商、编排工具链。推荐使用 ~/.openclaw/config.json 配置自定义 provider，以 Anthropic 原生格式接入可获得 Prompt Caching 与 Extended Thinking 等完整功能。
~/.openclaw/config.json
{ "models": { "mode": "merge", "providers": { "tokenclub": { "baseUrl": "https://api.tokenclub.cc", "apiKey": "你的令牌", "api": "anthropic-messages", "headers": { "anthropic-version": "2023-06-01" }, "models": [ { "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6", "contextWindow": 200000, "maxTokens": 16384 } ] } } }, "agents": { "defaults": { "model": { "primary": "tokenclub/claude-sonnet-4-6" } } } }
如使用 OpenAI 兼容格式，将 api 改为 "openai-completions"，Base URL 末尾加 /v1（注意：该模式下 Prompt Caching 与 Extended Thinking 不可用）：
OpenAI 兼容模式片段
"tokenclub": { "baseUrl": "https://api.tokenclub.cc/v1", "apiKey": "你的令牌", "api": "openai-completions", "models": [ { "id": "deepseek-chat", "name": "DeepSeek Chat" } ] }
注意：
① Anthropic 原生格式 Base URL不要加 /v1，并需携带 anthropic-version 请求头。
② api 可选 "anthropic-messages"（推荐，支持 Prompt Caching）或 "openai-completions"（无 /v1 限制）。
③ 配置修改后执行 openclaw gateway restart 使其生效，可用 openclaw models list 验证。
④ 模型 id 需与控制台模型广场中的名称一致。
⚡ 一键导入 CC Switch
粘贴你的 API 令牌，生成专属导入链接，点击即可唤起本地 CC Switch 应用自动添加 TokenClub 供应商。
令牌仅在你的浏览器本地拼接为链接，不会上传到任何服务器。
未安装 CC Switch？前往 ccswitch.io 下载（支持 Windows / macOS / Linux）。
OpenClaw 常见问题
推荐 "api": "anthropic-messages"，可获得 Prompt Caching（降低长对话成本）和 Extended Thinking 能力。仅调用非 Claude 模型时用 "openai-completions"。
执行 openclaw gateway restart 重启网关，然后 openclaw models list 查看。确认 provider 名称与 agents.defaults.model.primary 中的前缀一致。
"api": "anthropic-messages" 时不加 /v1（填 https://api.tokenclub.cc）。"api": "openai-completions" 时需要 /v1（填 https://api.tokenclub.cc/v1）。
WorkBuddy 是腾讯推出的 AI 桌面智能体工作台，用户可用自然语言下达任务，让它自主完成文件处理、文档生成等办公操作。它使用 ~/.workbuddy/models.json 配置自定义模型，URL 必须以 /v1/chat/completions 结尾。
~/.workbuddy/models.json
{ "models": [ { "id": "你的模型名", "name": "TokenClub", "vendor": "TokenClub", "apiKey": "你的令牌", "url": "https://api.tokenclub.cc/v1/chat/completions", "supportsToolCall": true, "maxInputTokens": 128000, "maxOutputTokens": 8192 } ], "availableModels": ["你的模型名"] }
注意：
① 配置完成后需完全退出并重启 WorkBuddy（Windows 从系统托盘退出，macOS 右键 Dock 图标退出），否则配置不生效。
② id 必须与控制台模型广场中的模型名完全一致（区分大小写）。
③ 如需 Agent 模式（函数调用），supportsToolCall 必须为 true。
WorkBuddy 常见问题
需完全退出重启 WorkBuddy（关闭窗口不等于退出）。同时检查 JSON 格式是否有错（如多余逗号、Key 未用双引号）。
supportsToolCall 必须设为 true，且使用的模型本身需支持函数调用能力。
id 字段值与服务端实际模型名不一致。请确认控制台模型广场中的准确模型名称（含连字符和大小写）。
CodeBuddy 是腾讯云 AI 编程助手，业界首个同时支持插件（VS Code/JetBrains）、独立 IDE 和 CLI 三种形态，深度融合 DeepSeek/混元等大模型。通过 models.json 可接入 OpenAI 兼容接口。安装：npm install -g @tencent-ai/codebuddy-code。
~/.codebuddy/models.json
{ "models": [ { "id": "你的模型名", "name": "TokenClub", "vendor": "TokenClub", "apiKey": "你的令牌", "url": "https://api.tokenclub.cc/v1/chat/completions", "supportsToolCall": true } ], "availableModels": ["你的模型名"] }
注意：
① 修改配置后需重启 CodeBuddy。
② CodeBuddy 也支持在设置界面中以图形化方式添加自定义 Provider（选择 OpenAI Compatible）。
CodeBuddy 常见问题
执行 npm install -g @tencent-ai/codebuddy-code，安装后 codebuddy 启动。首次使用需选择登录方式（国际站 / 中国站 / 企业版）。
不必须。可以在设置 → 模型配置 → 添加自定义模型，Provider 选择 OpenAI Compatible，填入 Base URL 和令牌。
必须以 /v1/chat/completions 结尾，基于 OpenAI 兼容格式。
Cursor 是基于 VS Code 构建的 AI 原生代码编辑器，深度集成大语言模型，支持通过自然语言对话实现智能代码生成与多文件编辑。在 Settings → Models 中填入 OpenAI API Key 并覆盖 Base URL 即可接入。Model Name 需严格匹配控制台模型广场中的名称。
  1. 打开 Cursor → Settings → Models
  2. 在 OpenAI API Key 栏粘贴你的令牌
  3. 展开 Override OpenAI Base URL，填入 https://api.tokenclub.cc/v1
  4. 在模型列表中输入模型名并勾选启用
注意：
① Base URL不要加 /chat/completions，Cursor 会自动拼接。
② 模型名需与控制台模型广场中的名称完全一致。
③ Cursor Agent Composer 模式可能限制非 Anthropic 官方模型，Chat / Composer 模式不受影响。
Cursor 常见问题
需要。填入 https://api.tokenclub.cc/v1（带 /v1）。不要加 /chat/completions。
Cursor 的 Agent Composer 模式对第三方 API 有限制。Chat 模式和普通 Composer 模式正常可用。
Model Name 必须与控制台模型广场中的名称严格一致（含大小写和连字符）。
Trae 是字节跳动推出的 AI IDE，v3.3.51 起原生支持自定义 Base URL，无需额外代理工具即可接入第三方 API。最低版本要求：Trae v3.3.51+。Base URL 需填写完整接口路径。
  1. 打开 Trae → Settings → Models → 添加模型
  2. 服务商选择 OpenAI
  3. 模型选择 自定义模型 (Custom Model)
  4. Model ID填写模型名（如 deepseek-chat）
  5. API Key填写你的令牌
  6. Base URL填写 https://api.tokenclub.cc/v1
注意：
① Base URL 必须填写完整路径，不能只填域名。OpenAI 兼容填 https://api.tokenclub.cc/v1。
② 低于 v3.3.51 的版本不支持原生自定义 API，请升级或使用 Cline 插件作为替代方案。
③ 若选择 Anthropic 服务商，Base URL 填 https://api.tokenclub.cc（无 /v1）。
Trae 常见问题
打开 Trae → 菜单 → 关于，查看版本号。需 ≥ v3.3.51 才支持原生自定义 Base URL。
升级到最新版 Trae。如果无法升级，可安装 Cline 插件（Trae 插件市场搜索 Cline），在插件中配置自定义 API。
Trae 要求 Base URL 为完整接口路径。OpenAI 兼容填 https://api.tokenclub.cc/v1，Anthropic 兼容填 https://api.tokenclub.cc。
Cline 与 Roo Code 是 VS Code 插件，在插件设置面板中按以下步骤填写即可：
  1. API Provider 选择 OpenAI Compatible
  2. Base URL 填 https://api.tokenclub.cc/v1
  3. API Key 填你的令牌
  4. Model ID 填你要使用的具体模型名（如 deepseek-chat）
Cline / Roo Code 常见问题
选择 OpenAI Compatible（OpenAI 兼容），不要选 Anthropic 或官方 OpenAI。
Model ID 需填写控制台「模型广场」中的准确模型名称，区分大小写。
OpenAI 兼容接口需带 /v1，即 https://api.tokenclub.cc/v1。
平台兼容 OpenAI 接口协议，只需把 base_url 指向 TokenClub 即可。
Python
from openai import OpenAI client = OpenAI( base_url="https://api.tokenclub.cc/v1", api_key="你的令牌", ) resp = client.chat.completions.create( model="deepseek-chat", messages=[{"role": "user", "content": "你好"}], ) print(resp.choices[0].message.content)
JavaScript
import OpenAI from "openai"; const client = new OpenAI({ baseURL: "https://api.tokenclub.cc/v1", apiKey: "你的令牌", }); const resp = await client.chat.completions.create({ model: "deepseek-chat", messages: [{ role: "user", content: "你好" }], }); console.log(resp.choices[0].message.content);
curl
curl https://api.tokenclub.cc/v1/chat/completions \ -H "Authorization: Bearer 你的令牌" \ -H "Content-Type: application/json" \ -d '{ "model": "deepseek-chat", "messages": [{"role": "user", "content": "你好"}] }'
SDK 接入常见问题
OpenAI SDK 使用 https://api.tokenclub.cc/v1（带 /v1）。Anthropic SDK 使用 https://api.tokenclub.cc（不带）。
SDK 传 api_key 即可；裸 HTTP 请求用 Authorization: Bearer 你的令牌 头。
高负载时服务器会发送空行保持连接，不影响 OpenAI SDK 解析。若自行解析 HTTP 响应，请忽略这些空行。
通用问题
以下错误码与说明适用于所有接入方式。
状态码含义原因与解决
400格式错误请求体格式有误。按错误信息修正请求体格式与字段。
401认证失败令牌错误、过期或无权限。检查并更新 API 令牌。
402余额不足账户余额不足。请联系 TokenClub 获取兑换码充值。
422参数错误请求体参数不合法。按错误信息修正相关参数。
429请求达到上限请求速率（RPM/TPM）超限。降低请求频率或稍后重试。
500服务器故障服务内部错误。稍后重试，持续出现请联系客服。
503服务器繁忙负载过高，暂时无法处理。请稍后重试。
其他常见问题
创建令牌时需选择分组，不同分组对应不同的可用模型与价格倍率。请根据你要调用的模型选择合适分组，详见控制台「模型广场」。
超过速率上限会返回 429。请合理控制并发与请求频率；高负载时单次请求响应可能稍有延迟，属正常现象。
登录控制台进入「模型广场」，可查看所有已接入模型的实时定价、分组倍率与特殊计费说明。
平台暂不提供公开线上充值，请联系 TokenClub 获取兑换码，在控制台兑换入账。
计费
按量计费，无月费
以平台算力 µ 为定价单位，按实际 Token 用量扣费。各模型实时价格以控制台模型广场为准。
查看完整定价 ›