VanaAPI
登录

← 文章

Claude Desktop 接入教程：Vana 三协议一个地址

终端里的 AgentZH2026-10-31

§ 示例说明：只迁移 Claude Desktop

下面是一个完整示例。假设你手头有一个已经能正常使用的项目，Claude Desktop 是你每天和 Claude 模型对话的工具，代码、文档、目录结构和提示词都已经就位。这个示例的目标只有一个：把 Claude Desktop 的模型调用切到 Vana API，同时不改动项目的其余部分。

示例之所以能做得这么短，是因为 Vana API 把接入面收敛到了一个地址：https://api.vanaapi.com。同一个地址上跑三种协议，Claude 模型对应 Anthropic Messages（/v1/messages），Gemini 模型对应 Gemini 原生协议（/v1beta/models/...），GPT、Grok、DeepSeek、GLM、Kimi、Qwen、MiniMax、MiMo 对应 OpenAI 格式（/v1/chat/completions）。你不必为不同模型准备不同的网关地址。

需要先讲清楚的是，https://api.vanaapi.com 只处理 API 请求。key、余额、用量日志都在主站 https://vanaapi.com 的 dashboard 中管理。两边分工明确，示例的每一步都会用到。

§ 示例准备：在 dashboard 里拿到 key 和余额

示例从 dashboard 开始。先注册账号，注册赠送 ¥0.50 额度。接着在 dashboard 创建一枚 API key，再为账户充值。Vana API 采用预付余额计费，按实际消耗的 token 收费，没有月费，充值只是把钱先放进账户，用多少扣多少。

退款规则也一并写在这里，方便安排充值节奏：充值后 3 天内，未使用的余额可以申请退款，退款金额会扣除已经使用的部分以及支付处理方的费用。短期内的小额试用因此更容易控制成本。

如果账户里还有其他调用，Vana API 的用量日志会逐条列出每一次调用，方便核对实际 token 与费用。推荐奖励是另一套规则：你邀请的人消费金额的 14% 归你，再下一层为 5%，收益累计到 ¥100.00 可以提现。示例流程不依赖推荐，但了解它有助于理解账户的整体结构。

§ 示例核心：只改 Claude Desktop 的接入信息

Claude 模型只能从官方 Claude Code 或 Claude Desktop 调用，并且要求版本 2.1.285 或更新，因为这两个客户端自身就说 Anthropic Messages（/v1/messages）。这一条直接决定了示例的客户端选择，也意味着接入步骤集中在客户端设置里，而不是散落在项目各处。

在这个示例中，要做的改动集中在 Claude Desktop 的接入设置，一共两项：把请求地址填为 https://api.vanaapi.com，把 key 填成 dashboard 里刚创建的那一枚。改完之后，Claude Desktop 里原有的会话、提示词、项目文件和使用习惯都保持原样，项目其他部分不需要跟着调整，也不需要改代码。

  • 确认 Claude Desktop 版本为 2.1.285 或更新。
  • 在 dashboard 创建 API key，并完成充值。
  • 在 Claude Desktop 的接入设置中填写地址 https://api.vanaapi.com。
  • 填入刚创建的 key，保存后发一条普通消息。
  • 回到 dashboard 的用量日志，确认这次调用已被记录。

示例的顺序是有意安排的：先确认版本，再准备 key 和余额，然后才改客户端设置。这样如果在哪一步遇到问题，你能立刻分辨是版本、余额还是地址填写的问题，而不必回头翻整个项目。

§ 示例验证：用日志和价格表核对

发出第一条消息后，到 dashboard 的用量日志里查看这次调用。Vana API 会把每一次调用都列出来，包括实际消耗的 token。你可以用日志里的消耗量，对照下面的每百万 token 价格（输入 / 输出）：

  • Claude Fable 5.1（claude-fable-5-1）：Vana API ¥24.00 / ¥120.50；官方标价 ¥72 / ¥360。
  • Claude Haiku 4.5（claude-haiku-4-5-20251001）：Vana API ¥2.50 / ¥11.50；官方标价 ¥7.2 / ¥36。
  • Claude Opus 5.5（claude-opus-5-5）：Vana API ¥10.50 / ¥50.00；官方标价 ¥28.8 / ¥144。
  • Claude Sonnet 5.5（claude-sonnet-5-5）：Vana API ¥8.50 / ¥41.50；官方标价 ¥21.6 / ¥108。

这些价格用来说明单价结构，实际支出仍以用量日志为准。日常短对话可以看 Haiku 4.5，需要更强推理时再看 Opus 5.5 或 Sonnet 5.5，风格化写作可以试 Fable 5.1。在 Vana API 上，它们都通过 Anthropic Messages 提供，模型 id 直接填进 Claude Desktop 的模型设置即可。

§ 示例延伸：按量付费之外的选择

如果使用节奏比较稳定，也可以考虑 Vana API 的月度方案，其中与 Claude 相关的有两个。Claude $1,000 / 30 天，30 天 ¥466.00，每周上限 $320，仅限 Claude 模型；Claude $2,400 / 30 天，30 天 ¥1,106.00，每周上限 $750，同样仅限 Claude 模型。

这两个方案只覆盖 Claude 模型，其他模型仍然按量付费。可以这样理解：日常零散使用时，按真实 token 结算的余额更直观；用量固定且可预期时，月度方案的周期价格与上限更容易纳入计划。两种方式在同一个地址上使用，切换的是计费方式，不是接入方式。

§ 示例边界：换模型就要换协议

示例特意只覆盖 Claude Desktop，是为了把改动控制在一处。当你需要其他模型时，协议也要跟着换。Gemini 模型只能在 Gemini CLI 中通过 Gemini 原生协议使用，它不是 OpenAI 兼容格式，这一点在设计阶段就要确认清楚。

另一条路线是 OpenAI 格式。GPT、Grok、DeepSeek、GLM、Kimi、Qwen、MiniMax、MiMo 使用 /v1/chat/completions，可以在 Cursor、Cline、Roo Code、OpenCode、Cherry Studio、任何 OpenAI SDK 或 cURL 中调用；GPT 模型还会在 /v1/responses 上响应，Codex 走的就是这条路径。

所以在 Vana API 上扩展项目时，规则很直接：同一个地址，按模型选择对应协议，客户端随之确定。把这一步提前弄清楚，就不用在错误的接入方式上反复尝试。

回到示例本身：改一个地址、换一枚 key，Claude Desktop 就接上了 Vana API，项目其余部分保持原状，费用在 dashboard 的日志里逐条可查。这就是 Vana API 的思路，一个地址，三种协议，尽量少的设置。

再读一篇