Claude API 代理

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

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

Anthropic SDK 和 Claude Code 会自动拼接 /v1/messages，因此它们的 base URL 末尾不能带 /v1；而 OpenAI 风格的工具则需要且只需要一个 /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

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

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="YOUR_MODEL_NAME",
    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: "YOUR_MODEL_NAME",
  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": "YOUR_MODEL_NAME",
    "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": "YOUR_MODEL_NAME",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

常见错误

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