Claude API 代理

在 Claude Code、Anthropic SDK 或任何 OpenAI 兼容工具中使用 Claude 模型。

简短回答

APIVAI 是 Claude API 代理：把 Claude Code 或 Anthropic SDK 指向 https://api.apivai.com（不带 /v1），或把兼容 OpenAI 的工具指向 https://api.apivai.com/v1，用 APIVAI 密钥即可调用同样的 Claude 模型。截至 2026-10-10，Claude Sonnet 4.6（模型 ID claude-sonnet-4-6）每百万输入 / 输出 token 为 $1.15 / $5.74，Anthropic 官方标价为 $3.00 / $15.00。从预付余额按量扣费。

BASE URLhttps://api.apivai.com

APIVAI 以两种格式提供 Claude 模型。请按工具要求选择对应格式，两者混用是出现 404 最常见的原因。

格式	Base URL	接口	鉴权请求头	适用工具
Anthropic 原生	https://api.apivai.com	/v1/messages	x-api-key	Claude Code、Anthropic SDK
OpenAI 兼容	https://api.apivai.com/v1	/chat/completions	Authorization: Bearer	Cursor、Cline、Aider、OpenAI SDK

关键是最终请求地址：请求必须到达 https://api.apivai.com/v1/messages（Anthropic 格式）或 https://api.apivai.com/v1/chat/completions（OpenAI 格式）。各工具在 base URL 后面拼接的内容不同：Anthropic SDK 和 Claude Code 会加上 /v1/messages，所以填 https://api.apivai.com；大多数 OpenAI 风格的工具会加上 /chat/completions，所以填 https://api.apivai.com/v1。少数工具例外——Continue 的 anthropic 提供商和 Chatbox 的 Claude 模式只加 /messages，需要填 https://api.apivai.com/v1——请以对应工具的教程为准。

Claude Code

macOS / Linux

export ANTHROPIC_BASE_URL="https://api.apivai.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_APIVAI_API_KEY"
claude

Windows PowerShell

$env:ANTHROPIC_BASE_URL="https://api.apivai.com"
$env:ANTHROPIC_AUTH_TOKEN="YOUR_APIVAI_API_KEY"
claude

如果已经设置了 ANTHROPIC_API_KEY，请先删除，否则会用它代替 APIVAI 密钥：unset ANTHROPIC_API_KEY（PowerShell：Remove-Item Env:ANTHROPIC_API_KEY）。

正式开始长时间的 Agent 任务前，先发一条简短的提示确认连接正常。

设置这两个变量后，Claude Code 按 token 从 APIVAI 余额扣费，不需要 Claude Pro 或 Max 订阅。每月大概花多少、什么时候订阅更划算，见不订阅使用 Claude Code。

Anthropic SDK

Python

import anthropic

client = anthropic.Anthropic(
    api_key="YOUR_APIVAI_API_KEY",
    base_url="https://api.apivai.com",
)

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content[0].text)

Node.js

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  apiKey: process.env.APIVAI_API_KEY,
  baseURL: "https://api.apivai.com",
});

const message = await client.messages.create({
  model: "claude-sonnet-4-6",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Hello!" }],
});
// message.content is an array of content blocks
console.log(message.content.map((b) => (b.type === "text" ? b.text : "")).join(""));

cURL（Messages 接口）

curl https://api.apivai.com/v1/messages \
  -H "x-api-key: YOUR_APIVAI_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

在请求体中加入 "stream": true 即可通过 SSE 流式接收响应。

通过 OpenAI 格式调用 Claude

只支持 OpenAI 风格接入的工具同样可以使用 Claude 模型：把 base URL 指向 /v1，并传入 Claude 的模型 ID 即可。

curl https://api.apivai.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_APIVAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

常见错误

错误	常见原因
401	Key 缺失、格式错误，或启动工具的进程读取不到它。
404	base URL 多了、少了或重复了 /v1。
model_not_found	配置的模型不在当前 GET /v1/models 的返回结果中。

所有错误码的原因和解决方法见 Claude API 错误码。

常见问题

Claude Code 应该用哪个 Base URL？

https://api.apivai.com，结尾不带斜杠，也不带 /v1。Claude Code 会自己加上 /v1/messages。

为什么返回 404？

最终请求地址不对，通常是 /v1 少了、多了或重复了。它必须是 https://api.apivai.com/v1/messages 或 https://api.apivai.com/v1/chat/completions。Claude Code 和 Anthropic SDK 填 https://api.apivai.com；大多数 OpenAI 风格的工具填 https://api.apivai.com/v1；例外情况见对应工具的教程。

密钥正确为什么还是 401？

终端里很可能还设置了 ANTHROPIC_API_KEY，它优先生效。删除它，或在控制台确认密钥还有额度。

同一个密钥能调用 GPT 模型吗？

可以。通过 OpenAI 格式的 Base URL https://api.apivai.com/v1 使用 gpt-5.5 等 GPT 模型 ID 即可。

每分钟能发多少请求？

每个密钥默认每分钟 60 次请求，需要更高可以联系客服。