快速开始

如果你是第一次使用，不需要先理解所有专业名词，按下面步骤操作即可。

1. 注册账号并登录控制台。
2. 进入充值页面充值额度，本站比例为 1 元 = 1$。
3. 进入「令牌管理」，创建一个 API Key。API Key 就是客户端调用模型时使用的密码。
4. 打开模型广场，确认你要使用的模型名称、分组和倍率。
5. 优先使用 CC Switch，把 API Key 导入到 Codex、Claude Code 或 Gemini。
6. 如果电脑还没有安装 Codex、Claude Code 或 Gemini CLI，先按本文的安装教程安装。
7. 如果你在 VS Code 或 Cursor 里使用插件，就在插件设置里填写 Base URL、API Key 和模型名称。
8. 发送一句“你好”测试，能正常回复就说明配置成功。

注册与登录

注册地址

https://opentoken.lol/register

登录地址

https://opentoken.lol/login

注册建议

• 建议使用真实可用的邮箱，方便接收验证、通知和找回账号。
• 密码请妥善保存，不要与其他网站共用。
• 在新设备登录时，可能需要重新验证账号。

充值与用量

如何充值

1. 登录账号。
2. 进入「充值」「钱包」或「钱包管理」页面。
3. 选择充值金额或套餐。
4. 按页面提示完成支付。
5. 支付完成后刷新余额。

消费说明

账户额度会在你调用模型时扣除。不同模型价格不同，具体可用模型和价格请以模型广场显示为准。

余额没有到账

如果支付成功后余额没有立即到账，可以先等待 1 到 3 分钟再刷新页面。仍未到账时，请准备账号邮箱、支付时间、支付金额、订单号或支付截图联系客服。

模型广场

模型广场用来查看本站目前提供哪些模型、每个模型属于哪个分组，以及不同分组的计费倍率。

访问地址

https://opentoken.lol/pricing

如果无法直接打开模型广场，请先登录 https://opentoken.lol，然后在控制台里点击「模型广场」。

新手需要看什么

创建令牌

令牌也叫 API Key，用于在客户端或代码中调用模型。

创建步骤

1. 登录中转站。
2. 进入「令牌管理」页面。
3. 点击「添加令牌」。
4. 填写令牌名称，方便自己区分用途。
5. 按需要设置分组、额度限制、过期时间或可用模型。
6. 保存后复制生成的 API Key。

字段建议

安全提醒

API Key 相当于你的调用凭证。不要发给别人，也不要发布到公开代码仓库。如果怀疑泄露，请立即删除旧令牌，并重新创建新的令牌。

从令牌页面导入 CC Switch

网站令牌页面支持手动配置 CC Switch。也就是说，你不需要自己复制很多配置项，可以在网页里选好令牌，然后让网页跳转到 CC Switch 应用，自动导入供应商配置。

1. 先安装并打开 CC Switch。
2. 回到 opentoken.lol 的「令牌管理」页面。
3. 找到你创建好的令牌。
4. 在该令牌最右侧，点击「聊天」按钮旁边的下拉箭头。
5. 在弹出的菜单里选择「CC Switch」。
6. 网页会唤起 CC Switch 应用，并自动带入供应商配置。
7. 在 CC Switch 中确认导入，然后点击「启用」。

Node.js 环境

如果只是使用 VS Code / Cursor 插件，通常不需要单独关心 Node.js。如果要安装和运行 Codex、Gemini CLI、本地文档站，通常需要 Node.js。Claude Code 的安装方式可能会自行处理依赖，但准备好 Node.js 会更稳。

Windows

推荐到 Node.js 官网下载 LTS 版本。安装目录可以是 C 盘，也可以是 D 盘，例如 D:\Program Files\nodejs。

检查安装

node --version
npm --version

国内网络下载慢

npm config set registry https://registry.npmmirror.com
npm config get registry

重点配置路线

这份文档的重点不是普通聊天客户端，而是开发工具和插件。新手建议先用 CC Switch，因为它可以统一管理 Codex、Claude Code 和 Gemini 的配置。

地址速记

CC Switch 配置（推荐）

CC Switch 是这份文档最推荐的方式。它可以统一管理 Claude Code、Codex、Gemini CLI 的供应商配置，适合需要经常切换模型、分组或中转地址的用户。

下载地址

https://github.com/farion1231/cc-switch/releases/latest

方式一：从网站令牌页面导入（推荐）

这是最适合新手的方式。网站会帮你生成 CC Switch 需要的供应商配置，浏览器会跳转到 CC Switch 应用完成导入。

1. 先安装 CC Switch，并确保它可以正常打开。
2. 登录 opentoken.lol。
3. 进入「令牌管理」页面，创建或选择一个令牌。
4. 在令牌所在行的右侧，点击「聊天」按钮旁边的下拉箭头。
5. 在菜单中选择「CC Switch」。
6. 浏览器会跳转并唤起 CC Switch 应用。
7. 在 CC Switch 弹窗里确认导入供应商配置。
8. 导入完成后点击「启用」，再打开 Codex、Claude Code 或 Gemini 测试。

方式二：手动新增供应商

1. 先在 opentoken.lol 创建令牌。
2. 打开 CC Switch，新增一个供应商配置。
3. 填写名称、Base URL 和 API Key。
4. 根据你要使用的工具选择 Claude Code、Codex 或 Gemini。
5. 保存后点击「启用」或「切换到该配置」。
6. 重新打开终端，运行对应工具测试。

名称：OpenToken
Base URL：https://opentoken.lol
API Key：你的令牌

安装 Codex / Claude Code / Gemini CLI

配置 API Key 之前，请先确认你电脑里已经安装好对应工具。否则后面运行 codex、claude 或 gemini 时会提示命令不存在。

安装 Codex

打开 PowerShell、CMD、Terminal 或 VS Code 终端，运行：

npm install -g @openai/codex@latest

安装完成后检查：

codex --version

能看到版本号，就说明 Codex 已安装成功。

安装 Claude Code

Claude Code 提供官方 npm 包，在终端运行：

npm install -g @anthropic-ai/claude-code

安装完成后检查：

claude --version

如果能看到版本号，说明 Claude Code 已安装成功。如果提示命令不存在，请先确认 Claude Code 是否已经安装，并检查安装目录是否加入系统 PATH。

安装 Gemini CLI

打开终端运行：

npm install -g @google/gemini-cli@latest

安装完成后检查：

gemini --version

能看到版本号，就说明 Gemini CLI 已安装成功。

Windows 新手常见问题

Codex / Claude Code / Gemini CLI

Codex

Codex 通常使用 OpenAI Responses API。推荐用 CC Switch 配置；如果手动配置，目录一般是 ~/.codex 或 Windows 的 %USERPROFILE%\.codex。

config.toml

model_provider = "opentoken"
model = "gpt-5.5"
model_reasoning_effort = "high"  # 仅对 gpt-5 / o 系列推理模型生效

[model_providers.opentoken]
name = "OpenAI"
base_url = "https://opentoken.lol"
wire_api = "responses"
requires_openai_auth = true

auth.json

{
  "OPENAI_API_KEY": "你的令牌"
}

测试命令：

codex

Claude Code

Claude Code 通常使用 Anthropic 协议，Base URL 一般填写 https://opentoken.lol，不要加 /v1。

Windows PowerShell

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://opentoken.lol", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的令牌", "User")

macOS / Linux

echo 'export ANTHROPIC_BASE_URL="https://opentoken.lol"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的令牌"' >> ~/.zshrc
source ~/.zshrc

测试命令：

claude

Gemini CLI

Gemini CLI 通过环境变量配置中转地址和密钥，否则会直连 Google 官方接口。

Windows PowerShell

[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://opentoken.lol", "User")
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "你的令牌", "User")

macOS / Linux

echo 'export GOOGLE_GEMINI_BASE_URL="https://opentoken.lol"' >> ~/.zshrc
echo 'export GEMINI_API_KEY="你的令牌"' >> ~/.zshrc
source ~/.zshrc

设置完后重开终端，模型名称从模型广场复制。测试命令：

gemini

VS Code / Cursor 插件

VS Code 和 Cursor 都可以使用支持 OpenAI Compatible、自定义 API 或自定义模型的插件。常见插件会让你填写 Provider、Base URL、API Key 和 Model。

通用填写方式

Kilo Code / Cline / Roo Code 这类插件

这类插件通常选择 OpenAI Compatible，然后填写：

Base URL：https://opentoken.lol/v1
API Key：你的令牌
Model：从模型广场复制

Cursor 中使用插件

Cursor 兼容很多 VS Code 插件。安装插件后，在插件自己的设置页里找到 API Provider、Base URL、API Key、Model，按上面的通用方式填写即可。

拓展：聊天客户端

聊天客户端不是本文重点。如果你只是想聊天，可以按下面方式填写。

API 地址：https://opentoken.lol/v1
API Key：你的令牌
模型名称：从模型广场复制

API Host：https://opentoken.lol/v1
API Key：你的令牌
Model：从模型广场复制

接口地址：https://opentoken.lol/v1
API Key：你的令牌

拓展：API 调用说明

本站提供 OpenAI 兼容接口，并可根据站点实际开放能力支持 Claude、Gemini 等模型调用。大多数应用只需要替换 Base URL 和 API Key。

鉴权方式

Authorization: Bearer sk-xxxxxxxxxxxxxxxx

拓展：OpenAI 格式

适合 OpenAI SDK、ChatBox、Cherry Studio、NextChat，以及支持 OpenAI Compatible 的工具。

Chat Completions

curl https://opentoken.lol/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {
        "role": "user",
        "content": "你好"
      }
    ]
  }'

Responses API

curl https://opentoken.lol/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
  -d '{
    "model": "gpt-5.5",
    "input": "你好，请用一句话介绍自己"
  }'

拓展：Anthropic 格式

适合 Claude Code、Anthropic SDK，以及直接调用 Claude Messages API 的场景。

curl https://opentoken.lol/v1/messages \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "你好" }
    ]
  }'

拓展：Gemini 格式

适合 Gemini CLI、Gemini SDK，以及兼容 Google Generative Language API 的工具。

curl "https://opentoken.lol/v1beta/models/gemini-2.0-flash:generateContent" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: sk-xxxxxxxxxxxxxxxx" \
  -d '{
    "contents": [
      {
        "parts": [
          { "text": "你好，请用一句话介绍自己" }
        ]
      }
    ]
  }'

常见错误