www.buytoken.work

接入文档

五分钟接进来

你已经在用的客户端不用换,也不用装插件。把请求地址和密钥换成网关的,就能继续照常干活。推荐用 CC Switch 图形化配置,不碰命令行;习惯终端的往下翻,有环境变量的写法。

开始之前

开通后你会拿到三样东西,用途各不相同,别混着填:

API Key
sk- 开头的一串。调 API 时当密钥用。
API 地址
https://api.buytoken.work。所有调用都发到这里。
账号和密码
登录控制台查用量、改密码用,和 API Key 是两码事。

客户端里只填 https://api.buytoken.work

控制台在 https://buytoken.work/console,浏览器打开登录就能查用量、管 Key、充值。注意别搞混两个地址:https://api.buytoken.work 是填进客户端的 API 地址,https://buytoken.work 是给人看的控制台,不能填进客户端当 API 地址。

能调哪些模型取决于你这把 Key 的分组:cc 分组调 Claude 系列,codex 分组调 GPT 系列,kimi 分组调 Kimi,DeepSeek 分组调 DeepSeek。支持的厂商见支持的模型。价格和分组说明在模型定价页。

接 Claude 系列

用 Claude Code,配合 CC Switch 管理供应商。CC Switch 装一次就够,下面的 Codex 也用同一个。

  1. 装 Node.js 和 Claude Code

    先装 Node.js 18 或更高版本(nodejs.org),然后打开终端——Windows 用 PowerShell,Mac 和 Linux 用 Terminal——执行:

    终端
    npm install -g @anthropic-ai/claude-code
  2. 装 CC Switch

    到 github.com/farion1231/cc-switch 下载对应系统的安装包,一路下一步装好即可。

  3. 在 CC Switch 里加供应商

    打开 CC Switch,添加供应商,选「自定义配置」,按下表填:

    名称
    随便填,比如「我的中转」
    请求地址
    https://api.buytoken.work(如果不生效,末尾加 /v1 再试)
    API Key
    你的 sk- 密钥
    API 格式
    Anthropic

    模型映射按这个填,然后保存并启用这条供应商:

    Default
    claude-sonnet-5
    Opus
    claude-opus-5
    Haiku
    claude-haiku-4-5-20251001
  4. 开始用

    终端里执行 claude,进到交互界面就成了。

    VSCode、Cursor、Trae 用户装 Claude Code for VSCode 插件即可,不需要登录,也不用额外配置。

接 Claude 桌面客户端

Claude 桌面版(Claude Desktop)和上面的 Claude Code 是两个独立的程序,配置互不相通,要各配一次。先装好桌面版,再选一种配法:用 CC Switch 图形化配置(推荐,和上面的 Claude Code 共用一个工具),或者不装 CC Switch、直接在桌面版里填。

桌面版只认 Claude 系列的模型

Claude 桌面版只接受名字是 claude-sonnet-…、claude-opus-…、claude-haiku-… 的模型。所以这里用的 Key,分组只留 Claude 系列(比如 cc),别和 GPT、DeepSeek 等分组混在同一把 Key 里,否则模型列表里会混进它不认的模型。到令牌管理新建一把专用的,把其它分组用 × 移掉。

先装好桌面版

软件下载

  1. 打开下载页面

    点击 Claude Desktop 下载链接,进入下载页面。

    Claude 官方下载页,红框标出的 Desktop 一块里有 macOS 和 Windows 的下载按钮
  2. 下载安装包

    在如上图 Desktop 一块,根据自己的系统,下载对应的安装包。

软件安装:Windows

  1. 让安装程序走代理

    Windows 系统下软件安装需要请求 Anthropic 官方,需要你用梯子挂全局服务(TUN 模式),或是用命令行来运行安装程序,使其强制走代理,否则会出现以下报错:

    Windows 安装程序报错窗口:Download failed. Check your internet connection and try again.
  2. 打开 cmd

    如果出现以上报错无法安装,请在 Claude Desktop 安装程序所在目录运行 cmd 命令行。

  3. 确认代理端口号

    确认你当前使用梯子的端口号,比如我使用的是 Clash Verge,则端口号为 7897。

    代理软件 Clash Verge 的设置页,红框标出端口设置为 7897
  4. 用命令行运行安装程序

    在命令行中分别输入以下命令,运行安装程序,此时能够正常安装:

    cmd
    set HTTP_PROXY=http://127.0.0.1:7897
    set HTTPS_PROXY=http://127.0.0.1:7897
    "Claude Setup.exe"
    在命令行里依次输入 set HTTP_PROXY、set HTTPS_PROXY 和 Claude Setup.exe
  5. 正常安装

    Claude 安装程序正在下载并安装

软件安装:MacOS

  1. 直接安装

    MacOS 系统下直接正常安装即可。

    macOS 安装窗口:把 Claude 拖到 Applications

方式一:用 CC Switch 配置

前提是上面的 CC Switch 已经装好,它里面 Claude Code 和 Claude Desktop 也是两个独立的入口。

  1. 在 CC Switch 里切到 Claude Desktop

    打开 CC Switch,在左侧的应用列表里选 Claude Desktop(不是 Claude)。右边的供应商列表一开始只有官方的 Claude Desktop Official。

    CC Switch 主界面:左侧栏里的 Claude Code 和 Claude Desktop 是两个独立的入口,选 Claude Desktop;右上角是「添加供应商」

    侧栏里找不到这个入口的话,到「应用」页确认它没有被隐藏。

    CC Switch 的「应用」页:Claude Desktop 一行右侧的开关打开后,侧栏里才会出现这个入口

    截图取自 CC Switch 官方仓库(github.com/farion1231/cc-switch,MIT 协议)。不同版本的界面可能略有差异,以你装的版本为准。

  2. 添加供应商

    点右上角「添加供应商」,选「自定义供应商」,按下表填:

    名称
    随便填,比如「BuyToken」
    请求地址
    https://api.buytoken.work(不要带 /v1,结尾也不要带斜杠)
    API Key
    你的 sk- 密钥(分组里只留了 Claude 系列的那把)
    接入方式
    直连(不要打开「需要模型映射」)

    请求地址填的是 API 地址 https://api.buytoken.work,不是控制台网址 https://buytoken.work,后者是浏览器打开的网页,不能当接口地址用。这一项在不同版本里可能叫「请求地址」或「接口地址」。

  3. 确认模型列表

    点「获取模型列表」自动拉取,拉到 Claude 模型就不用再管。拉取失败,或者只想留几个模型的话,点「添加模型」手动填:

    Sonnet
    claude-sonnet-5
    Opus
    claude-opus-5
    Haiku
    claude-haiku-4-5-20251001

    模型右侧的「1M」只在确定该模型支持 1M 上下文时才勾,拿不准就不勾。

  4. 添加并重启

    点右下角「添加」,再在供应商卡片上点「切换」,直到它显示「使用中」。然后完全退出 Claude 桌面版再重新打开:它只在启动时读配置,不会热更新。

  5. 开始用

    随便发一条消息,收到回复就配好了。顶部如果弹出 Couldn't sign in to Gateway 之类的提示,先不用管,以能不能收到回复为准。

    配置由 CC Switch 写入,不要手动改 Claude 桌面版的配置文件,下次切换会被覆盖。想回到官方登录,在 CC Switch 里切回 Claude Desktop Official,不需要 Key。

方式二:不用 CC Switch,直接在桌面版里配

不想装 CC Switch,或者想自己确认每一项的话,可以直接在 Claude 桌面版里填网关。填的内容和方式一一样,只是自己动手。两种方式配一种就够,别重复配。

  1. 打开开发者模式

    打开桌面版,先停在登录界面,不要登录。Mac 用顶部菜单栏,依次选「Help(帮助)」→「Troubleshooting(故障排查)」→「Enable Developer Mode(启用开发者模式)」,在弹窗里点启用,软件会自动重启。

    Windows 登录界面左上角有个 ☰ 菜单,点它,菜单项一样。点不到的话,先用鼠标点一下邮箱输入框,再按 Tab 键,焦点会跳到左上角的菜单,按回车展开。

    菜单语言跟着系统语言走,位置是一样的,对照同名菜单项即可。

  2. 打开第三方推理配置

    重启后同样的菜单栏里多了「Developer(开发者)」,选「Configure Third-Party Inference…(配置第三方推理)」。看不到这个菜单的话,先把桌面版更新到最新版再试。

  3. 填网关地址和 Key

    在 Connection 里把 Inference provider 选成 Gateway。在 Gateway credentials 里按下表填:

    Gateway base URL
    https://api.buytoken.work(必须是 https 开头,不要带 /v1,结尾也不要带斜杠)
    Gateway API key
    你的 sk- 密钥(分组里只留了 Claude 系列的那把)
    Credential kind
    Static API key(默认,不用改)
    Gateway auth scheme
    bearer(默认,不用改)

    其余各项保持默认。填的是 API 地址 https://api.buytoken.work,不是控制台网址 https://buytoken.work。

  4. 确认模型列表

    网关支持自动拉取模型,一般不用动:桌面版会自己读取,只列出名字是 Claude 的模型。想自己指定,或者列表里没有模型的话,在 MODELS 里点 Add model,Model ID 和 Display name 都填模型名:

    Sonnet
    claude-sonnet-5
    Opus
    claude-opus-5
    Haiku
    claude-haiku-4-5-20251001

    「Offer 1M-context variant」只在确定该模型支持 1M 上下文时才勾,拿不准就不勾,勾了之后列表里会多出一个 1M 上下文的同名选项。

  5. 应用并重启

    在配置窗口里依次点 Apply Changes → Save & Restart(按钮名在不同版本里可能略有差别,按界面上的 Apply 和 Save 来)。桌面版重启后,登录界面会多出一个用第三方配置启动的入口,点它进去,不要再选 Anthropic 登录。

  6. 开始用

    回到对话页,打开模型选择器,确认能选到模型,随便发一条消息,收到回复就配好了。顶部如果弹出 Couldn't sign in to Gateway 之类的提示,先不用管,以能不能收到回复为准。

    界面里的 Test connection、Test model discovery 只是辅助检查,结果以实际能不能对话为准。

    想回到官方登录,在登录界面选 Anthropic 登录那一项就行。这套配置只在这台电脑、这个系统账号上生效,随时可以回到 Configure Third-Party Inference 里修改。

新建对话、发第一条消息后,用量日志里可能会多出一笔和你选的模型不一样的小额调用。这通常是桌面版自己在后台给对话起标题,金额很小,属于正常现象。

接 GPT · Codex 系列

要调 gpt-5.6-sol 这类模型看这里。前提是上面的 CC Switch 已经装好。

  1. 装 Codex CLI 或 Codex Desktop

    两个客户端共用一份配置,装哪个都行,装两个也行。CLI 需要 Node.js 18 以上:

    终端
    npm install -g @openai/codex

    要图形界面的话,到 openai.com/codex 下载官方桌面端。

  2. 在 CC Switch 里加 Codex 供应商

    打开 CC Switch,切到 Codex 选项卡,添加供应商,选「自定义配置」:

    名称
    随便填,比如「buytoken-codex」
    请求地址
    https://api.buytoken.work/v1(必须带 /v1)
    API Key
    你的 sk- 密钥
    API 格式
    OpenAI

    保存并启用后,CC Switch 会把地址和密钥写进 ~/.codex/config.toml,CLI 和桌面端都直接读这份配置。

  3. 开始用

    CLI 执行 codex 进入交互界面,用 /model gpt-5.6-sol 切换模型。桌面端新建会话时在模型选择里填模型 ID。

    改完 CC Switch 但客户端还走旧配置的话,重启一次客户端就行。

接 gpt-image 生图

Codex 自带的 image_gen 是 OpenAI 托管的能力,不走我们的地址;自带的兜底脚本又只认 b64_json,而我们的图片接口统一转存后返回链接,所以这两条都用不了。想在 Codex 里生图,把模型换成 gpt-image-2:中转会把这个请求当成生图处理,图片落到 ~/.codex/generated_images/,正文里同时给出图片链接。

在 ~/.codex/config.toml 里加一段 profile,原来的对话模型不受影响:

~/.codex/config.toml
[model_providers.buytoken]
name = "buytoken"
base_url = "https://api.buytoken.work/v1"
wire_api = "responses"
requires_openai_auth = false
# 也可以删掉下面这行,改用 env_key = "BUYTOKEN_API_KEY"
experimental_bearer_token = "sk-你的Key"

[profiles.image]
model = "gpt-image-2"
model_provider = "buytoken"

用 --profile 起会话,单发最稳(Codex 只把最后一条消息当提示词):

终端
codex --profile image
codex exec --profile image "一只橘猫,写实摄影"

已经开着会话的话,直接 /model gpt-image-2 也行。

Codex 不会传尺寸和档位,所以固定 1024x1024、上游默认档。要控参数就直接打图片接口,返回里的 data[0].url 就是图:

终端
curl -sS https://api.buytoken.work/v1/images/generations \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2","prompt":"a red bicycle","size":"1536x1024","quality":"low","n":1}'

可用模型:gpt-image-2、gpt-image-2.5-flare、gpt-image-2.5-sunburst,都按张计费。生图要 30–120 秒,客户端超时别设太短;中途断开也会计费,批量出图建议直接用接口。

接 WorkBuddy

WorkBuddy 是腾讯的 AI 办公工作台,在图形界面里就能添加第三方模型,不用改配置文件。

开始前先确认两件事:WorkBuddy 已经装好并登录;手上有一把 sk- 开头的 Key,而且这把 Key 的分组包含你要用的模型。填进去的模型名必须和该分组里的模型 ID 一字不差,可以到支持的模型或模型与价格查。

  1. 打开模型设置

    点左下角的账户区域展开菜单,选「设置」,再在左侧导航栏选「模型」。

    WorkBuddy 左下角的账户菜单,箭头指向「设置」
    设置页的左侧导航,箭头指向「模型」
  2. 添加自定义模型

    在「自定义模型」区域点右上角的「添加模型」,展开「提供商」列表,在「其他」分类里选「自定义 / Custom」。

    模型页,箭头指向右上角的「添加模型」
    添加模型弹窗的提供商列表,箭头指向「自定义 / Custom」
  3. 填写模型配置

    接口地址
    https://api.buytoken.work/v1(必须带 /v1)
    API Key
    你的 sk- 密钥
    模型名称
    Key 所属分组下的模型 ID,比如 cc 分组填 claude-opus-4-8
    高级配置
    按模型实际能力勾选。Claude 系列可以勾上工具调用、思考模式和允许关闭思考,其余保持默认

    确认无误后点右下角的「保存」。WorkBuddy 会把配置写到本机的 ~/.workbuddy/models.json。

    填好接口地址、API Key 和模型名称的添加模型表单,箭头指向「保存」
  4. 开始用

    回到任务对话界面,点输入框右下角的模型选择器,选刚配好的模型,发一句话收到回复就接通了。

    对话界面里选中刚添加的模型,并收到了回复

    Key 不要发给别人,也不要公开展示。截图或录屏求助前,先把密钥完整遮住。

备选:直接配环境变量

不想装 CC Switch、习惯命令行的话,配两个环境变量就够了。

Mac / Linux

编辑 ~/.zshrc(bash 用户改 ~/.bashrc),追加两行,保存后 source 一下再运行 claude:

~/.zshrc
export ANTHROPIC_BASE_URL=https://api.buytoken.work
export ANTHROPIC_AUTH_TOKEN=sk-你的Key

Windows

PowerShell 里执行下面两行(永久生效)。设完必须关掉 PowerShell 重开,否则不生效。

PowerShell
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.buytoken.work", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的Key", "User")

OpenAI 协议的客户端

Codex 一类走 OpenAI 协议的工具,地址要带 /v1:

终端
export OPENAI_BASE_URL=https://api.buytoken.work/v1
export OPENAI_API_KEY=sk-你的Key

验证是否配通

进 claude 随便打句话有回复,就说明通了。也可以直接用 curl 测,返回 JSON 即成功:

Anthropic 协议
curl -sS https://api.buytoken.work/v1/messages \
  -H "x-api-key: sk-你的Key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}'

网关同时支持 /v1/messages、/v1/responses 和 /v1/chat/completions;密钥用 x-api-key 或 Authorization: Bearer 传都行。

在控制台能做什么

浏览器打开 https://api.buytoken.work/console,用开户时给的账号密码登录,能看到这些:

总览
剩余额度、本月花费、最近调用一眼看完。
令牌管理
查看和复制 Key,改名、停用、新建。Key 弄丢了在这里找回。
用量日志
每一次调用的时间、模型、token 数和扣费,点开一行能展开这笔钱是怎么算出来的。
账号设置
改密码。建议首次登录就改掉。

首次登录建议做三件事:改掉初始密码、在用量日志里确认能看到自己的调用、看一眼当前额度。充值在控制台「钱包」页,微信扫码支付、实时到账。

常见问题

401 Unauthorized

Key 没生效,通常是别处还留着旧配置。依次检查:在 claude 里输 /status 看 Base URL 是不是网关地址;CC Switch 里是否还启用着别的供应商;~/.claude/settings.json(Windows 在 %USERPROFILE%\.claude\settings.json)里有没有旧的地址或密钥。

403 Your client is not authorized

在 claude 里输 /logout 退出登录,然后重新进入即可。

提示余额不足,但控制台里额度还有

装过别家中转站留下的残留配置。删掉整个配置目录后按文档重新配一遍。

清掉残留配置
# Mac / Linux
rm -rf ~/.claude

# Windows PowerShell
Remove-Item "$env:USERPROFILE\.claude" -Recurse -Force
模型名没写错,请求却失败

多半是分组不对:Claude 分组的 Key 调不了 gpt-*,Codex 分组的 Key 调不了 claude-*。到「令牌管理」看这把 Key 属于哪个分组,或到定价页对照该分组能调哪些模型。另外模型 ID 要原样填,带日期后缀的不能省——claude-haiku-4-5 会失败,必须写 claude-haiku-4-5-20251001。

Unable to connect 或提示国家限制

是配置没生效,不是网络问题——本服务不需要代理。Windows 改完环境变量必须重开 PowerShell;Mac / Linux 确认 ~/.zshrc 或 ~/.bashrc 已经 source 过,或者直接重开终端。

Windows:提示禁止运行脚本 / claude.ps1 无法加载

PowerShell 的执行策略挡住了。跑一次下面的命令,提示确认时输 Y 或 A。

PowerShell
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
Windows:无法将 claude 识别为命令

npm 的全局安装路径不在 PATH 里。用下面的命令查出路径(通常是 C:\Users\<用户名>\AppData\Roaming\npm),加进系统环境变量 PATH,然后重开终端。

PowerShell
npm config get prefix
Windows:提示需要 git-bash

装一下 Git for Windows(git-scm.com/downloads/win),一路默认下一步,装完关闭并重开 PowerShell。

VSCode / Cursor / Trae 插件要我登录

不需要登录。先试卸载重装插件;还不行就在插件的 settings.json 里显式写死地址和密钥。

settings.json
{
  "claudeCode.preferredLocation": "panel",
  "claudeCode.environmentVariables": [
    {"name": "ANTHROPIC_BASE_URL", "value": "https://api.buytoken.work"},
    {"name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的Key"}
  ]
}
400 context_management: Extra inputs are not permitted

客户端发了上游不认的实验性字段。在 CC Switch 的 env 里加一行,保存后重开终端。

CC Switch · env
"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"

两个万能办法

大部分疑难杂症都能靠「删掉 ~/.claude 目录 → 重开终端 → 按文档重新配一遍」解决。另外 Claude Code 同一个会话开久了上下文会越堆越大、越来越卡,做完一个任务输 /clear 清一下就好。

还是不行的话,联系我们:QQ 3963059079。