Claude Code 接入教程：Vana API 一地址三端通
§ 一个地址，三套协议
Vana API 把多种模型的调用收口在同一个地址 https://api.vanaapi.com。这个地址只响应 API 请求，密钥、余额和用量记录都在主站 https://vanaapi.com 的控制台里统一管理。无论你使用哪种操作系统，都不需要记忆多个端点，也不需要在不同平台之间切换配置。
在这个地址上，Vana API 同时支持三种协议，每种协议对应特定的客户端。Claude 模型走 Anthropic Messages（/v1/messages），只能从官方 Claude Code 或 Claude Desktop 2.1.285 及以上版本接入，不能通过其他客户端、任何 SDK、cURL 或脚本使用；Gemini 模型走 Gemini 原生协议（/v1beta/models/...），只能从 Gemini CLI 接入，并非 OpenAI 兼容格式；GPT、Grok、DeepSeek、GLM、Kimi、Qwen、MiniMax、MiMo 走 OpenAI 格式（/v1/chat/completions），可以从 Cursor、Cline、Roo Code、OpenCode、Cherry Studio 或任意 OpenAI SDK、cURL 接入。GPT 模型同时响应 /v1/responses 端点，这是 Codex 使用的格式。
对 Claude Code 用户来说，这意味着无论你在 Windows、macOS 还是 Linux 上工作，都只需要记住这一个 Vana API 地址。系统会自动识别协议类型并路由到对应的模型，你不需要关心底层细节。
§ 五分钟完成接入
首先在 https://vanaapi.com 注册并登录控制台，在密钥管理页面创建你的 API 密钥。新用户注册时会获得 ¥0.50 的体验金，这笔金额会自动充入余额，可以直接用于首次调用测试。然后在本地安装官方 Claude Code，安装完成后检查版本号，确保在 2.1.285 或以上，这个版本会自己使用 Anthropic Messages 协议与服务端通信，无需额外配置协议转换。
在 Claude Code 的配置文件中，把 API 基础地址设置为 https://api.vanaapi.com，并填入刚才在 Vana API 控制台创建的密钥。整个过程不需要编写任何代码，也不需要部署额外的代理、脚本或中间件服务，配置文件修改保存后立即生效，无需重启服务。
保存配置后，打开终端运行任意 Claude Code 命令即可看到效果。在 Windows 上你可以在 PowerShell 或 Windows Terminal 中操作，在 macOS 上使用系统自带的 Terminal 应用，在 Linux 上使用任意常用的 shell 环境如 bash 或 zsh。三种操作系统下的命令输入方式和配置步骤完全一致，所有请求都会通过同一个 Vana API 地址发出并返回结果，体验没有任何差别。
§ 三端一致的使用体验
当 Windows、macOS 和 Linux 上的 Claude Code 都接入 Vana API 后，实际使用行为保持一致。同一个密钥、同一个 API 地址、同一套用量记录，都会在 Vana API 的控制台里实时同步呈现，方便你在不同设备之间切换工作时对照查看消费情况。
对于习惯在多台设备间切换的开发者，Vana API 的统一地址意味着你不需要在每台机器上维护不同的配置文件。无论是从 Windows 切换到 macOS，还是在 Linux 服务器上远程工作，只要使用同一个 Vana API 密钥，所有的调用记录和余额都会保持同步，不会出现数据分散的情况。
Vana API 采用预付费余额制，严格按实际消耗的 token 数量计费，没有任何月费或最低消费要求。每一次 API 调用都会被详细记录在控制台的用量日志中，包括输入 token 和输出 token 的具体数量，让你对花费一目了然。如果某次充值后未使用的余额需要退回，可以在充值成功后 3 天内申请退款，退款金额为剩余未使用余额扣除已使用部分和支付通道收取的手续费。
§ 价格与套餐选择
在按量付费模式下，Vana API 的价格公开透明，按百万 token 计价。例如 Claude Haiku 4.5（模型 ID claude-haiku-4-5-20251001）的输入价格是每百万 token ¥2.50，输出价格是 ¥11.50；Claude Sonnet 5.5（模型 ID claude-sonnet-5-5）输入为每百万 ¥8.50，输出为 ¥41.50；Claude Opus 5.5（模型 ID claude-opus-5-5）输入 ¥10.50，输出 ¥50.00。这些价格相比官方列价都有明显优势。
如果你的日常开发工作高度依赖 Claude 模型且用量稳定可预期，可以选择月度套餐来锁定成本。Claude 最多 $1,000 / 30 天的套餐价格为 ¥466.00，有效期 30 天，期间每周消费上限为 $320，仅限 Claude 模型使用。Claude 最多 $2,400 / 30 天的套餐价格为 ¥1,106.00，每周上限 $750，同样仅限 Claude 模型。GPT 最多 $4,000 / 30 天的套餐价格为 ¥746.00，每周上限 $1,200，仅限 GPT 模型使用。
在推荐计划方面，邀请他人注册并使用 Vana API，你可以获得被邀请人实际消费金额 14% 的返利奖励，被邀请人再邀请其他人注册，你还可以获得下一级消费 5% 的返利。所有返利收益在账户中累积，满 ¥100.00 即可申请提现到你的账户。
§ 现在就开始使用
整个接入过程只需要一个 Vana API 地址和一个密钥，没有复杂的环境配置或额外的学习成本。现在就打开 https://vanaapi.com 注册账号，领取 ¥0.50 体验金，在控制台创建你的专属密钥，然后在 Windows、macOS 或 Linux 任意一台设备上安装官方 Claude Code 2.1.285 及以上版本，将 API 地址指向 https://api.vanaapi.com。按照上述步骤操作，五分钟之内你就可以在三个平台上通过同一个 Vana API 地址稳定地使用 Claude Code 了。