使用指南

不会配置，也能用起来。

下面按你的情况分好了。只会用网页和 App，看第一块；要装 Claude Code、Codex，看第二块；已经会 API，直接往下看。

不知道选什么，问一下我是开发者

你是哪种情况？

只用网页和 App

我想让 AI 帮我写东西、看文件

开一个 ChatGPT 或 Claude 会员就行，不用装软件，也不用懂 API。

看怎么开始 →

要装软件

我想用 Claude Code 或 Codex

需要创建一把 Key，再填进软件里。不会弄可以远程帮你。

看具体步骤 →

已经会了

我只要 API、模型和配置

协议、模型名、Base URL、客户端配置和排错都在下面，可以直接看。

直接开始 →

01 / QUICK START · 给会配置的人

先确认能连上

已经知道 Base URL、Key 和模型名，就按下面三步试。第一次装的话，建议先看安装步骤。

创建统一 Key

在 API Keys 页面创建「全站模型 · 统一 Key」。图片生成等独立能力按页面提示选择对应分组。

打开 API Keys →

发送文本请求

curl https://tokenbuddy.cc/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"只回复 OK"}]}'

核对返回

返回 200 且正文为 OK，表示地址、鉴权与模型均可用。状态码含义：401 为 Key 或鉴权问题；404 通常为模型名或分组权限问题；429 为限流；5xx 先重试并核对服务状态。

02 / CORE RULES · 进阶

四条基础规则

统一 Key 与多个 Provider

同一把 Key 可用于 Codex、Claude Code、Gemini CLI、CC Switch 等；但不同 Provider 的协议与 Base URL 必须分别填写，不能混用。

分组由模型名区分

Claude 带 -full 为满血组、不带为经济组；GPT 带 -full 为稳定组、不带为经济组；其他模型为默认组，不加 -full。

以模型目录为准

可用模型、图片输入与推理档位会变化，以模型广场或 GET /v1/models 为准，不要沿用历史清单。

接口与能力对应

文本对话走对话接口；图片输入走含图片内容的对话请求；图片生成走 Images 接口。

03 / MODEL NAMING

模型命名

模型与价格以模型广场为准。本页不再维护静态模型清单，避免与在售目录不一致。

统一 Key 只使用正式产品名

模型与价格以模型广场为准。统一 Key 只有正式产品名；没有经济档的模型只提供 -full 正式产品，基础名不再作为产品或别名提供（会返回 model_not_found）。直连满血档分组仍按该分组文档使用基础名。

返回 model_not_found 时，请在模型广场复制正式产品名。

04 / MULTIMODAL

图片输入、图片与视频生成

「图片输入」指多模态模型读取图片内容；「图片生成」与「视频生成」指专用模型输出图片或视频。三者对应的模型与接口各不相同。是否支持图片输入由模型原厂决定，中转站不改变模型的多模态能力。

图片输入 / VISION

让模型读取图片

是否支持图片输入取决于模型原厂，下表结论以各厂商官方文档为准。

模型家族	图片输入	依据（原厂文档）
GPT	支持	OpenAI 模型页标注 `Input modalities: text, image`（gpt-5.6-sol、gpt-5.6-terra、gpt-6-astra、gpt-6-sol、gpt-6.1-sol、gpt-6.1-terra）
Claude	支持	Anthropic 模型概述：`All current models support … image input … vision`（claude-sonnet-5、claude-opus-5、claude-opus-5-5-full、claude-fable-5-full、claude-fable-5-1-full、claude-opus-4-6、claude-haiku-5-5-full）
Gemini	支持	Google 模型页：`Inputs: Text, Image, Video, Audio, PDF`（gemini-3.8-flash、gemini-4-argon）
Grok	支持	xAI 模型页：`Text and image input; text output`（grok-4.5、grok-4.7）
Kimi	支持	Moonshot：kimi-k3 支持图片与视频输入；仅接受 base64 data URL 或 Files API 的 file id，不接受公网 URL
GLM	支持	智谱：GLM-5.3-Flash（`glm-5.3-flash`）支持视频、图像、文本及文件输入。传入图片时，在 `image_url` 中提供图片 URL 或 Base64 Data URL。
DeepSeek	部分支持	DeepSeek 模型与价格页：`deepseek-v4.1-flash` 支持图片输入；`deepseek-v4-pro` 仅支持纯文本，传入图片会返回 `400`。

请求格式随接口而异：OpenAI Chat Completions 用 image_url（URL 或 base64 data URL）；OpenAI Responses 用 input_image（image_url）；Anthropic Messages 用 image 块（source 取 base64、url 或 file）。图片作为输入计入 token 计费。发送前请按模型的支持情况确认，不支持图片输入的模型会返回 400。

Chat Completions：图片 URL

{
  "model": "支持图片输入的模型",
  "messages": [{"role":"user","content":[
    {"type":"text","text":"请描述这张图"},
    {"type":"image_url","image_url":{"url":"https://example.com/a.png"}}
  ]}]
}

图片 Base64

{"type":"image_url","image_url":{"url":"data:image/png;base64,..."}}

图片生成 / IMAGES

生成图片

图片模型（如 gpt-image-2.5）不能填入文本模型字段，须直接调用 Images 兼容接口。

请求

curl --max-time 180 \
  https://tokenbuddy.cc/v1/images/generations \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2.5","prompt":"a red paper boat on a blue lake","n":1,"size":"1024x1024"}'

返回可能是图片 URL，也可能是 data:image/png;base64,...。前者直接下载，后者先做 Base64 解码。

视频生成 / VIDEOS

生成视频

视频模型（如 seedance-2.0、grok-imagine-video-1.5）不能填入文本对话接口的 model 字段。视频生成是异步任务：先提交请求，获取任务 ID 后轮询状态，完成后下载结果。按分辨率和视频时长（秒）计费，单价见模型广场。

1. 提交任务

curl https://tokenbuddy.cc/v1/videos \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"seedance-2.0","prompt":"一只白鹭从湖面起飞，镜头缓慢跟随","duration":5,"resolution":"480p"}'

2. 查询与下载

# 返回中的 id 即任务 ID；status 为 done 表示完成，failed 表示失败。
curl https://tokenbuddy.cc/v1/videos/TASK_ID -H "Authorization: Bearer YOUR_KEY"
curl -o out.mp4 https://tokenbuddy.cc/v1/videos/TASK_ID/content -H "Authorization: Bearer YOUR_KEY"

参数与在线工具

视频参数

resolution 可填 480p、720p、1080p；duration 单位为秒。生成通常需要一到几分钟，建议每 5 秒查询一次，不要反复提交同一任务。

如果不写代码，可以使用在线视频工具，填入统一 Key 和提示词即可生成视频。提示词写法见视频指南。

火山方舟原生协议（/api/v3/contents/generations/tasks）也可调用 seedance-2.0，Base URL 填 https://tokenbuddy.cc。

客户端能力限制

客户端支持上传图片，不等于它能将图片按本站要求的格式发送。若客户端仅支持纯文本，更换模型名也无法启用图片输入。

05 / REASONING

推理强度按接口设置

推理字段随接口而异，不要将某一工具的写法套用到所有工具。取值以模型目录中的 supported_reasoning_levels 为准。

OpenAI Responses

{"model":"gpt-6-astra","reasoning":{"effort":"high"}}

可选档位为 low、medium、high、xhigh、max，按模型实际支持的档位填写。

OpenAI Chat Completions

{"model":"gpt-6-astra","reasoning_effort":"high"}

仅当接口与模型均支持时传入；若返回参数错误，按模型目录降档或删除该字段。

Codex

model_reasoning_effort = "medium"

在配置文件中设置桌面版与 CLI 的默认值；临时调整可在工具自带的模型或推理设置中进行。

Claude / Gemini / 其他

不要直接套用 OpenAI 的 reasoning_effort。Claude 使用其原生 thinking 配置，Gemini 使用自身的 thinking 配置，其他工具按其界面与 Provider 协议设置。

原则

只传入模型支持的参数。传入不支持的推理档位不会带来更强推理，通常会直接返回 400。

06 / HARNESSES · 按软件查

客户端配置索引

下表按客户端分类。同一把统一 Key 均可使用，但每个客户端须按其自身协议配置。

WorkBuddy / CodeBuddy腾讯 · OpenAI Compatible OpenClawOpenAI Compatible / Provider Hermes自定义端点 ZCode智谱 · Model Providers Qoder / 通义灵码阿里 · 自定义模型 DeepSeek HarnessDSH · 自定义提供方 TRAE字节 · 自定义模型 Claude 客户端Desktop / API 客户端 Codex CLI / DesktopOpenAI Responses CC Switch三个独立 Provider OpenCode通用 Agent 配置 Gemini CLI / Grok CLI原生协议

CODEX · OPENAI RESPONSES

Codex CLI / Desktop

Codex 使用 OpenAI Responses 协议。直连 TokenBuddy 时通过 Base URL 与 Key 鉴权，不使用 ChatGPT 官方登录态。配置写入 config.toml 的 model_providers 段。

配置文件路径：~/.codex/config.toml（Windows 为 %USERPROFILE%\.codex\config.toml），不存在则新建。
按右侧模板填写：base_url = "https://tokenbuddy.cc/v1"、wire_api = "responses"、requires_openai_auth = false，并在 experimental_bearer_token 填入你的 Key（官方字段，文档建议优先用 env_key 环境变量；直连时直接填写亦可，且二者不要同时设置）。
模型名使用模型广场的公共名：经济档如 gpt-5.6-sol；统一 Key 的稳定档在基础名后加 -full（如 gpt-5.6-sol-full）。
修改后完全退出应用再重新打开；CLI 可执行 codex app-server daemon restart。
若自建 codex-models.json（model_catalog_json），支持图片的模型声明 "input_modalities": ["text", "image"]；Codex 官方文档未列出该字段，字段名以官方仓库为准，默认按 text+image 处理。

官方文档：developers.openai.com/codex。桌面版仅使用 GPT 模型。

~/.codex/config.toml

model_provider = "tokenbuddy"
model = "gpt-5.6-sol"
model_reasoning_effort = "medium"
model_catalog_json = "~/.codex/codex-models.json"

[model_providers.tokenbuddy]
name = "TokenBuddy"
base_url = "https://tokenbuddy.cc/v1"
wire_api = "responses"
requires_openai_auth = false
experimental_bearer_token = "YOUR_KEY"

CLAUDE CODE · ANTHROPIC MESSAGES

Claude Code

使用 Anthropic Messages 协议：Base URL 填写站点根地址，客户端自行请求 /v1/messages，不要填完整路径。

设置 ANTHROPIC_BASE_URL=https://tokenbuddy.cc。
设置凭证：推荐 ANTHROPIC_AUTH_TOKEN=你的 Key（以 Authorization: Bearer 发送）；若网关使用 x-api-key，则改设 ANTHROPIC_API_KEY。两者同时设置时本站均接受。
模型名使用 Claude 公共名；统一 Key 的满血档在基础名后加 -full。
不要固定 ANTHROPIC_MODEL，由 /model 切换。
需要对所有项目生效时，将变量写入 ~/.claude/settings.json 的 env 块（优先于 shell 导出）。

官方文档：code.claude.com/docs（连接 LLM 网关）。配置后在会话中执行 /status，查看当前 Base URL 与凭证来源。

浏览器 / MCP 工具不生效？Claude Code 将本站识别为非 Anthropic 官方主机时，会关闭 MCP 工具的按需加载（ToolSearch），使 Playwright 等 MCP 工具不进入会话，模型只能改用 Bash 写脚本操作浏览器。修法：在 ~/.claude.json 对应 MCP 服务器条目里加 "alwaysLoad": true，让该服务器的工具始终随请求下发、不做延迟加载；也可改用环境变量 ENABLE_TOOL_SEARCH=true（需网关转发 tool_reference，不确定时优先用前者）。验证：新开会话执行 /mcp 确认目标 MCP 已连接，再让模型调用其工具。

环境变量 / settings.json

export ANTHROPIC_BASE_URL="https://tokenbuddy.cc"
export ANTHROPIC_AUTH_TOKEN="YOUR_KEY"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5-full"

# 或写入 ~/.claude/settings.json：
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://tokenbuddy.cc",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_KEY"
  }
}

CLAUDE CLIENTS

Claude 客户端：Claude Code 与其他客户端

Claude Code 是命令行 Harness；Claude Desktop 官方客户端是另一款产品，不提供可填写任意第三方 Base URL 的入口，不能将 TokenBuddy Key 用作 Claude 登录凭据。

Claude Desktop 官方客户端：设置中没有 Custom Provider / API Base URL，无法直接接入 TokenBuddy，不要在登录框填入 Key。
支持 Anthropic 自定义端点的客户端（如各类 Claude 代理前端）：Base URL 填 https://tokenbuddy.cc，凭证填 Key，模型填 Claude 公共名。
仅支持 OpenAI 兼容的客户端：Base URL 改为 https://tokenbuddy.cc/v1，模型填模型广场公共名。
凭证头二选一：Authorization: Bearer <Key> 或 x-api-key: <Key>，本站均支持。

协议选择

Anthropic 原生https://tokenbuddy.cc客户端自行请求 /v1/messages

OpenAI 兼容https://tokenbuddy.cc/v1客户端自行请求 /chat/completions

出现「登录 Claude」「订阅 Claude」字样时，为官方账号入口，不是自定义 API 入口。

TENCENT · WORKBUDDY / CODEBUDDY

WorkBuddy / CodeBuddy

腾讯两款工具均接入 OpenAI 兼容的 Chat Completions。CodeBuddy（IDE / CLI）通过 models.json 配置；WorkBuddy 桌面端在设置中图形化添加。

CodeBuddy：编辑用户级 ~/.codebuddy/models.json（或项目级 .codebuddy/models.json），url 必须是完整路径，以 /chat/completions 结尾。
CodeBuddy 的 apiKey 与 url 支持 ${TOKENBUDDY_KEY} 形式的环境变量引用；保存后热重载，无需重启。
WorkBuddy：头像 → 系统设置 → 模型 → 添加自定义模型；提供商选择「自定义 / Custom」。
WorkBuddy 填接口地址 https://tokenbuddy.cc/v1、API Key、模型名（如 gpt-5.6-sol）；「自定义协议」保持关闭，客户端会自动补全 /chat/completions。
能力开关按模型实际情况开启：CodeBuddy 的 supportsImages、WorkBuddy 的「图片输入」。仅当模型原厂支持图片输入时才开启（见本文档 §04）。

官方文档：CodeBuddy models.json；WorkBuddy 模型配置。

~/.codebuddy/models.json

{
  "models": [{
    "id": "gpt-5.6-sol",
    "name": "TokenBuddy GPT-5.6 Sol",
    "vendor": "TokenBuddy",
    "apiKey": "${TOKENBUDDY_KEY}",
    "url": "https://tokenbuddy.cc/v1/chat/completions",
    "maxInputTokens": 200000,
    "maxOutputTokens": 8192,
    "supportsToolCall": true,
    "supportsImages": true,
    "supportsReasoning": true
  }],
  "availableModels": ["gpt-5.6-sol"]
}

CodeBuddy 仅支持 OpenAI 接口格式，url 必须包含完整 /chat/completions。WorkBuddy 的用户级配置文件为 ~/.workbuddy-ai/models.json。

OPENCLAW · OPENAI COMPLETIONS

OpenClaw

OpenClaw 读取 ~/.openclaw/openclaw.json（JSON5）。自定义渠道添加在 models.providers 下，也可在控制台 Settings → Model Providers 中配置。

在 models.providers 下新增一个 provider（如 tokenbuddy），api 填 openai-completions。
baseUrl 填 https://tokenbuddy.cc/v1，apiKey 支持 ${VAR} 环境变量引用。
models 数组填入要使用的模型 id（如 gpt-5.6-sol）。支持图片输入的模型须声明 input: ["text", "image"]，否则不会注入图片。
将 agents.defaults.model.primary 指向 tokenbuddy/gpt-5.6-sol。

官方文档：docs.openclaw.ai（自定义 provider）。OpenClaw 只接受完全符合 schema 的配置，保存后可执行 openclaw doctor --fix 检查。

~/.openclaw/openclaw.json

{
  agents: {
    defaults: { model: { primary: "tokenbuddy/gpt-5.6-sol" } }
  },
  models: {
    mode: "merge",
    providers: {
      tokenbuddy: {
        baseUrl: "https://tokenbuddy.cc/v1",
        apiKey: "${TOKENBUDDY_KEY}",
        api: "openai-completions",
        models: [{ id: "gpt-5.6-sol", name: "GPT-5.6 Sol", input: ["text", "image"] }]
      }
    }
  }
}

HERMES AGENT · CUSTOM ENDPOINT

Hermes

Hermes（Nous Research）支持任意 OpenAI 兼容端点。推荐使用交互命令配置，配置会写入 ~/.hermes/config.yaml。

运行 hermes model，选择 Custom endpoint。
依次填写：API base URL https://tokenbuddy.cc/v1、API key、模型名 gpt-5.6-sol、上下文长度（按模型实际填写）。
保存后配置持久化到 ~/.hermes/config.yaml，重启不丢失。
也可手动编辑配置文件：在 model 段使用 provider: custom 与 base_url，密钥使用 key_env 指向环境变量。
Hermes 按模型的 vision 能力自动路由：支持则按原生像素发送，不支持则经辅助视觉模型（auxiliary.vision）先转成文字描述。可用 agent.image_input_mode 覆盖：auto（默认）、native（始终发像素）、text（始终转文字）。

官方文档：hermes-agent.nousresearch.com（AI Providers）。config.yaml 是模型与端点配置的唯一来源。另可在 providers.<name> 中配置，其字段为 api、api_key 或 key_env。

~/.hermes/config.yaml

model:
  default: gpt-5.6-sol
  provider: custom
  base_url: https://tokenbuddy.cc/v1
  api_key: YOUR_KEY
  # 或使用环境变量：
  # key_env: TOKENBUDDY_KEY
  context_length: 200000

ZCODE（智谱）· OPENAI / ANTHROPIC

ZCode

ZCode 支持将任意 Anthropic / OpenAI 兼容服务配置为自定义供应商。

打开「模型设置」面板（模型选择器底部的「管理模型」，或从设置进入）。
自定义供应商：在左侧供应商列表底部点「添加供应商」，名称填 TokenBuddy。自定义供应商只选择单一协议，填写对应的 API 格式与 Base URL。
OpenAI 协议：Base URL 填 https://tokenbuddy.cc/v1；Anthropic 协议：Base URL 填 https://tokenbuddy.cc。两者分别新建供应商，或按需只建一个。
填 API Key（统一 Key），点「添加模型」逐个填模型 ID，如 gpt-5.6-sol、claude-sonnet-5、gemini-3.8-flash。
自定义模型需在模型配置中声明图片能力；ZCode 官方未给出具体字段名，社区实测为 modalities.input: ["text", "image"]（并置 supportsImages: true）。
打开该供应商的启用开关。

官方文档：zcode.z.ai/cn/docs/configuration。供应商配置存于 ~/.zcode/v2/config.json，更换设备时可复制该文件。ZCode 不会自动读取系统代理，需要时在设置中显式配置。

字段速填

名称:             TokenBuddy
OpenAI 接口地址:   https://tokenbuddy.cc/v1
Anthropic 接口地址: https://tokenbuddy.cc
API Key:          YOUR_KEY
模型（示例）:      gpt-5.6-sol
                  claude-sonnet-5
                  gemini-3.8-flash

QODER（阿里）· 自定义模型

Qoder / 通义灵码

Qoder 桌面端支持自定义 Base URL（BYOK），可选 OpenAI Compatible 或 Anthropic Compatible。

进入「设置 → 模型」，点「+ 添加」→ 打开「供应商」→ 在「自定义」分组选择 OpenAI Compatible。
OpenAI Compatible 还需选择 Chat Completions API（或 Responses API）。
填「接口地址（Base URL）」https://tokenbuddy.cc/v1、API Key，以及至少一个 Model ID。
点「校验并添加模型」，Qoder 会先校验连接再保存。
模型支持图片输入时启用「Vision」开关。
Qoder CLI：输入 /model → 切到 Custom 页 → Add custom model...，按向导填写 Provider、模型、Key。

官方文档：docs.qoder.com（自定义模型）。官方示例格式为 https://api.example.com/v1，填写时以服务商提供的准确 Base URL 为准。Claude 系列 ID 放在 Anthropic Compatible，或放入 Chat Completions 条目。

字段速填

供应商:     OpenAI Compatible
API 类型:   Chat Completions API
接口地址:   https://tokenbuddy.cc/v1
API Key:    YOUR_KEY
Model ID:   gpt-5.6-sol
            claude-sonnet-5   # Claude 系列

# 需 Anthropic 原生时另加一条：
供应商:     Anthropic Compatible
接口地址:   https://tokenbuddy.cc
Model ID:   claude-sonnet-5

DEEPSEEK HARNESS · 自定义提供方

DeepSeek Harness（DSH）

DSH 将「提供方路由」与「模型」分开：提供方决定凭据、端点与协议，模型 ID 决定实际请求的目标。自定义端点通过「添加自定义提供方」添加。

打开「设置 → 模型」→「添加自定义提供方」。
填写：小写且稳定的 Provider ID、显示名称、API 地址 https://tokenbuddy.cc/v1、API 协议 openai-completions、凭据。
「获取可用模型」会调用 OpenAI 兼容的 GET /models；不支持该接口的端点需手动填模型 ID（如 gpt-5.6-sol）。
保存后改动在下次请求生效，无需重启。

官方文档：github.com/deepseek-ai/deepseek-harness。底层配置位于 $DSH_HOME/settings.yaml 的 llm-pi-ai.providers 下；Provider ID 创建后不可改名。手动填写的模型默认按纯文本处理，需要图片输入时在 settings.yaml 中为该模型加 input: [text, image]。

$DSH_HOME/settings.yaml

llm-pi-ai:
  providers:
    tokenbuddy:
      apiKeyEnv: TOKENBUDDY_KEY
      api: openai-completions
      baseURL: https://tokenbuddy.cc/v1
      models:
        - id: gpt-5.6-sol
          input: [text, image]

TRAE（字节）· 自定义模型

TRAE

TRAE 通过「添加模型 → 自定义模型」接入未预设的服务，可选 OpenAI Chat Completions 或 Anthropic Messages 格式。

设置 → 模型 → 添加模型 → 选择「自定义模型」。
API 格式：GPT / DeepSeek / Kimi / GLM 选择 OpenAI Chat Completions；Claude 选择 Anthropic Messages。
请求地址：关闭「完整 URL」时填基础地址 https://tokenbuddy.cc/v1，由 TRAE 拼接路径；打开时可填完整地址。
填模型 ID（如 gpt-5.6-sol）与 API 密钥，保存后新建对话测试。
在「高级配置」中启用「支持图片输入」；该项要求所选模型本身具备视觉理解能力。
TRAE CLI：使用 traecli config edit 编辑 trae_cli.yaml，添加 open_ai.base_url。

官方文档：docs.trae.cn（内置与自定义模型）。常见错误为地址多写或漏写 /chat/completions，以及将模型 ID 填成展示名。

字段 / trae_cli.yaml

# IDE：自定义模型
API 格式:       OpenAI Chat Completions
自定义请求地址:  https://tokenbuddy.cc/v1   # 关闭「完整 URL」
模型 ID:        gpt-5.6-sol
API 密钥:       YOUR_KEY

# CLI：trae_cli.yaml
models:
  - name: "TokenBuddy GPT"
    open_ai:
      base_url: https://tokenbuddy.cc/v1
      api_key: "YOUR_KEY"
      model: "gpt-5.6-sol"

CC SWITCH

CC Switch：三个独立 Provider，共用统一 Key

同一把 Key 可重复使用，但不同协议不能合并在同一 Provider 中。Codex、Claude、Gemini 各建一个配置，分别填写端点、协议、Key 与模型映射。

Codex ProviderEndpoint: https://tokenbuddy.cc/v1Protocol: ResponsesKey: YOUR_KEY模型：GPT / Grok / 国产

Claude ProviderBase URL: https://tokenbuddy.cc协议：Anthropic MessagesKey: YOUR_KEY模型：Claude 经济 + -full

Gemini ProviderBase URL: https://tokenbuddy.cc协议：GeminiKey: YOUR_KEY模型：Gemini 经济模型

在 CC Switch 对应标签中创建或编辑 Provider，先选协议再填地址。
保存并激活，再补全模型映射；不要将三个协议合并到一个 Provider。
Codex 模型变化后执行 codex app-server daemon restart。
站内导入仅生成默认模型；完整列表需在高级选项中手动添加。

OPENCODE

OpenCode

可使用站内「API Keys → 使用 → OpenCode」生成器，或在 opencode.json 中添加自定义 provider：OpenCode 通过 @ai-sdk/openai-compatible 接入任意 OpenAI 兼容端点。支持图片输入的模型需声明图片能力（capabilities.input；旧版本为 modalities 或 attachment）。

Base URLhttps://tokenbuddy.cc/v1

API KeyYOUR_KEY

Modelgpt-5.6-sol

provider npm@ai-sdk/openai-compatible

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "tokenbuddy": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "TokenBuddy",
      "options": {
        "baseURL": "https://tokenbuddy.cc/v1",
        "apiKey": "YOUR_KEY"
      },
      "models": {
        "gpt-5.6-sol": { "name": "GPT-5.6 Sol", "capabilities": { "input": ["text", "image"], "output": ["text"] } },
        "claude-sonnet-5": { "name": "Claude Sonnet 5", "capabilities": { "input": ["text", "image"], "output": ["text"] } }
      }
    }
  }
}

GEMINI / GROK

Gemini CLI / Grok CLI

两者均通过环境变量或自有配置文件配置，协议不同：Gemini CLI 走 Gemini 入口，Grok CLI 走 Responses / Chat Completions。

Gemini CLI：设置 GOOGLE_GEMINI_BASE_URL=https://tokenbuddy.cc、GEMINI_API_KEY、GEMINI_MODEL。
Grok Build（xAI 官方）：编辑 ~/.grok/config.toml，在 [model."别名"] 中填 base_url、env_key、api_backend。
Grok 社区 CLI（superagent-ai/grok-cli）：使用 GROK_BASE_URL、GROK_API_KEY、GROK_MODEL，与官方 CLI 不是同一套变量。
两种 Grok 均不要混入 Gemini 协议。

官方文档：docs.x.ai、Gemini CLI。Grok 的 api_backend 可选 chat_completions、responses、messages。

环境变量 / config.toml

# Gemini CLI
GOOGLE_GEMINI_BASE_URL="https://tokenbuddy.cc"
GEMINI_API_KEY="YOUR_KEY"
GEMINI_MODEL="gemini-3.8-flash"

# Grok Build：~/.grok/config.toml
[models]
default = "tokenbuddy"
[model.tokenbuddy]
model = "gpt-5.6-sol"
base_url = "https://tokenbuddy.cc/v1"
name = "TokenBuddy"
env_key = "TOKENBUDDY_KEY"
api_backend = "chat_completions"

找人帮忙

照着做还是不行？别硬试。

把报错截图和你在做什么发过来，能远程就直接帮你看。

不知道买什么会员还是 API，问清楚再买 软件不会装Claude Code、Codex、Cursor 都能帮 报错、连不上把提示或截图发来 会员售后没到账、掉订阅、退款

07 / TROUBLESHOOTING · 报错翻译

常见报错

完全不会写代码，应该看哪里？

写作、看文件、开会员都不用写代码。要装 Claude Code 或 Codex，可以看快速开始，也可以直接找客服。

API Key 和 ChatGPT / Claude 会员有什么区别？

API Key 是给软件/客户端用的，按量扣费；官方会员是登录官网和 App 用的月卡。普通 API Key 不能当会员登录。

经济档和满血档选哪个？

刚开始用默认推荐就行。想要更稳或更好，再去模型广场比较。-full 是本站完整档的写法。

Muse 现在能开通吗？

以页面实时状态为准。热门工具可能排队或暂时不可用；不可用时不要提前付款。

401 / 403

确认 Key 完整、无多余空格、未被禁用，且 Base URL 与协议匹配。不要先更换模型名。

404 model not found

模型名或分组权限不正确。请在模型广场复制公共名；GPT/Claude 的高档位模型加 -full，直连上游通常不加。

400 reasoning 参数错误

删除推理字段，或改为模型目录支持的档位。Claude / Gemini 不要直接传 OpenAI 的 reasoning_effort。

图片输入失败

先确认模型支持图片输入，再检查请求格式为 URL 或 data URL；不要把图片输入请求发到 Images 生成接口。

CC Switch / Codex 仍显示旧模型

保存并激活 Provider；执行 codex app-server daemon restart。桌面应用则完全退出后重新打开，并新建对话。

No available accounts / 5xx

通常为该模型的上游池暂时无可用账号，或网络波动。稍后重试，或改用同家族模型，并保留完整报错信息。