Claude API 中转怎么用？国内 Claude Code 中转站配置教程（3 步完成）

想在国内稳定调用 Claude，最省事的方式就是 Claude API 中转：通过一个 Claude 中转站拿到 API Key，把 Claude Code 或你自己代码里的接口地址指向它，就能直接使用 Claude Sonnet 等模型，不需要 Anthropic 官方账号和海外信用卡。

本文用 3 步完成 Claude Code 中转站配置，并给出验证方法、省钱技巧和常见报错排查。如果你还在比较不同的服务商，建议先读《API中转站是什么？AI中转站选型避坑指南》。

---

为什么国内调用 Claude API 需要中转

直接使用 Anthropic 官方 API，国内开发者通常会遇到三个门槛：

1. 注册与支付：需要海外手机号和外币信用卡，账号还可能因地区限制被停用。
2. 网络：直连容易出现超时、握手失败和高延迟，Claude Code 这类长时间运行的 Agent 任务尤其容易中途断开。
3. 多模型管理：除了 Claude，团队往往还要用 GPT、Gemini、DeepSeek，分别对接成本很高。

Claude API 中转把这些问题集中到服务端处理：你只管 Base URL 和 Key，剩下的鉴权、路由、重试和计费由 Claude 中转站完成。

---

Claude API 中转的工作原理

Claude Code 使用的是 Anthropic 原生的 Messages 协议（/v1/messages），而不是 OpenAI 的 Chat Completions 协议。所以一个能用于 Claude Code 的 Claude 中转站，必须满足两点：

• 提供原生 /v1/messages 接口，而不仅仅是 OpenAI 兼容接口；
• 完整透传 tools、thinking、cache_control 等字段，否则 Claude Code 的工具调用和 Prompt 缓存都会失效。

SupaStore 同时提供这两种接口：Claude Code、Cline 等工具走 /v1/messages，你自己的代码也可以继续用 OpenAI SDK 调用 Claude 模型。

---

第一步：在 Claude 中转站创建 API Key

1. 登录 SupaStore，进入控制台的【令牌管理】。
2. 点击【添加令牌】，填写名称（例如 claude-code-laptop）。
3. 限制可用模型：只勾选你要用的 Claude 模型，Key 泄露时损失可控。
4. 设置额度上限：Claude Code 单次任务可能读取大量文件、消耗较多 Token，给 Key 设一个上限可以防止意外账单。
5. 复制生成的 sk- 开头的密钥。

---

第二步：Claude Code 中转站配置

方式一：修改 settings.json（推荐）

编辑 ~/.claude/settings.json（Windows 为 C:\Users\你的用户名\.claude\settings.json），在 env 中填入 Claude 中转站的地址和密钥：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-supastore-api-key",
    "ANTHROPIC_BASE_URL": "https://api.supastore.cc/v1",
    "API_TIMEOUT_MS": "300000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

保存后在项目目录运行 claude 即可，重启终端配置也不会丢失。

方式二：临时环境变量

只想快速试用，可以在当前终端设置环境变量：

# macOS / Linux
export ANTHROPIC_BASE_URL="https://api.supastore.cc/v1"
export ANTHROPIC_AUTH_TOKEN="sk-your-supastore-api-key"
claude

# Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://api.supastore.cc/v1"
$env:ANTHROPIC_AUTH_TOKEN="sk-your-supastore-api-key"
claude

Claude Code 的安装步骤（Node.js、Git Bash 等）以及 Windows / macOS / Linux 的完整配置，见文档《Claude Code 终端接入》。

---

第三步：验证 Claude API 中转是否生效

在启动 Claude Code 之前，先用 cURL 直接请求 Claude 中转站，确认 Key 和模型都可用：

curl https://api.supastore.cc/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk-your-supastore-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "用一句话介绍你自己"}]
  }'

返回 JSON 中有 content 和 usage 字段即表示成功。之后在 Claude Code 里输入 /model 可以切换模型，在控制台的使用日志里能看到每一次请求的 Token 数和扣费。

如果你的业务代码使用 OpenAI SDK，也可以通过同一个 Key 调用 Claude 模型：

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-supastore-api-key",
    base_url="https://api.supastore.cc/v1",
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "用三句话解释什么是 Prompt 缓存"}],
)
print(resp.choices[0].message.content)

---

用 Claude API 中转写代码，如何省钱

Claude Code 每一轮都会带上很长的系统提示词、工具定义和项目上下文，所以 Token 消耗主要在输入侧（输入、输出、缓存 Token 的区别见《AI Token 是什么？》）。下面两个方法效果最明显。

让 Prompt 缓存生效

以 2026-10-29 的价格为例，claude-sonnet-4-6 的普通输入为 $0.9/M，缓存输入为 $0.09/M，相差 10 倍。Claude Code 本身会自动使用 cache_control，只要 Claude 中转站完整透传并按缓存价计费，重复的上下文就能大幅降价。你可以在使用日志里查看每次请求的缓存 Token 数，确认缓存是否命中。

减少无关上下文

在项目根目录配置 .gitignore 或 .claudeignore，排除 node_modules、dist、.next 等目录。简单的批量任务（格式转换、写注释、生成测试数据）可以交给更便宜的模型。各 Claude 模型的官方单价见《Claude API 价格是多少？》，更多计算示例见《2026 主流大模型价格对比与 API 成本优化指南》，实时价格以模型广场为准。

---

Claude Code 中转站配置常见报错

报错	常见原因	处理方法
401 Invalid API Key / 提示 /login	环境变量未生效，或密钥复制时多了空格	运行 echo $ANTHROPIC_BASE_URL 检查；重开终端
402 余额不足	钱包余额或 Key 额度用完	充值或调高该 Key 的额度上限
429 请求过快	并发过高或触发速率限制	降低并发，稍后重试
400 模型不存在	模型 ID 拼写错误，或该 Key 未勾选此模型	在模型广场核对模型 ID，检查 Key 的可用模型

更完整的排查步骤见常见问题排查。

---

常见问题 (FAQ)

Q: 使用 Claude API 中转，需要 Anthropic 官方账号吗？

答： 不需要。Claude Code 读取到 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 后，所有请求都会发往 Claude 中转站，使用的是中转站的额度，不会用到也不会影响你的官方账号。

Q: Claude 中转站会保存我的代码吗？

答： 这取决于服务商。SupaStore 对话类接口的提示词与回复内容不写入数据库，日志只记录模型、Token 数和耗时等计费元数据。选择其他 Claude 中转站时，建议先看它的隐私政策，并按《API中转站选型避坑指南》里的 7 项清单逐一验证。

Q: 同一个 Key 能在 Cursor、Cline 里用吗？

答： 可以，但建议每个工具单独创建 Key，分别设置额度，方便在日志里区分消耗。Cursor、Cline / Roo Code 的配置方法见文档中心。