国内怎么使用 Claude API：免海外信用卡接入指南

Claude 在写代码、长文档分析和复杂推理上的表现，让越来越多国内开发者想把它接进自己的项目和工具里。但真正动手时，第一步往往就卡住：官网注册不了、手机号收不到验证码、绑卡被拒、账单按美元结算……这篇文章把国内使用 Claude API 的路径一次讲清楚：官方直连到底卡在哪、有哪几种可行方案、怎么用人民币充值后通过三种协议接入，以及接入后最常见的几个坑怎么排查。

如果你还不了解 API 中转是怎么工作的、数据会经过哪些环节，建议先读 AI API 中转站是什么，再回来看具体操作。

官方直连卡在哪里

直接使用 Anthropic 官方 API，国内开发者通常会依次遇到这几道门槛：

地区限制：中国大陆不在 Anthropic 官方支持的国家和地区列表中，控制台注册和使用都会受到限制
手机号验证：注册环节需要验证手机号，国内号码通常无法通过
支付方式：API 额度需要绑定国际信用卡预付，国内发行的卡经常被拒，虚拟卡也有被风控的风险
美元结算：即使绑卡成功，账单按美元计价，还要承担汇率波动和货币转换费
账号稳定性：通过非常规方式注册的账号存在被停用的风险，一旦停用，余额和项目都受影响

对个人开发者来说，这些门槛叠加起来的时间成本，往往远超 API 本身的费用。对团队来说，还会多一层问题：一个官方账号很难拆给多个成员独立对账。

三种可选方案对比

国内使用 Claude 模型，实际可行的路径大致有三条：

方案	注册与支付	接入难度	适合谁
官方直连	需海外手机号和国际信用卡，美元结算	高，且有账号停用风险	有海外主体和合规要求的企业
海外云平台托管	需要海外云账号和对应支付方式，部分模型需单独申请	中，需熟悉云平台的鉴权体系	已深度使用该云平台的团队
API 中转网关	国内邮箱注册，人民币充值	低，改 Base URL 和 Key 即可	个人开发者、创业团队、内部工具

前两种方案本质上都要求你有海外支付能力。对大多数国内开发者来说，API 中转网关是门槛最低的选择：Zivv 这类网关把上游账号、支付和调度都托管掉，你拿到的是一个和官方协议兼容的接口地址加一把 Key。各家中转的差异和挑选标准可以看中转站对比评测。

用 Zivv 接入：准备工作

整个准备过程大约几分钟：

在注册页用邮箱注册账号
在控制台充值，汇率为 ¥1 = $1，没有月费和最低消费，可以先小额充值测试
进入 API 令牌页面创建 Key，按用途选择分组：日常 API 调用选普通分组；主要给 Claude Code 用的，可以选 Claude MAX 分组
到模型广场确认你要用的模型 id 和单价，也可以用 Key 调用 GET /v1/models 拉取可用模型列表

Claude MAX 分组基于 Claude 订阅账号池，走原生 Anthropic 协议，专门为 Claude Code 这类重度编码场景设计，详细介绍见 Claude MAX 分组。

三种协议接入方式

Zivv 同一把 Key 同时支持三种协议入口，你可以根据项目现有的代码和工具选择：

协议	Base URL	适合场景
Anthropic 原生	https://zivv.pro	Anthropic SDK、Claude Code
OpenAI 兼容	https://zivv.pro/v1	OpenAI SDK、Cursor、Cline 等工具
Gemini 兼容	https://zivv.pro/v1beta	调用 Gemini 系列模型

调用 Claude 模型时，主要用前两种。

方式一：Anthropic 原生协议

如果你想完整使用 Claude 的原生能力（扩展思考、工具调用、多模态输入等），首选原生协议。先用 curl 验证 Key 是否可用：

curl https://zivv.pro/v1/messages \
  -H "x-api-key: sk-your-key-here" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "用三句话介绍你自己"}]
  }'

Python 项目用官方 anthropic SDK，只需要改 base_url：

import os
import anthropic

client = anthropic.Anthropic(
    api_key=os.environ["ZIVV_API_KEY"],
    base_url="https://zivv.pro",  # 注意不要加 /v1
)

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "解释一下 Python 的 GIL"}],
)
print(message.content[0].text)

这里有个高频坑：Anthropic SDK 会自动在 base_url 后面拼接 /v1/messages，所以 base_url 只写域名。写成 https://zivv.pro/v1 会变成 /v1/v1/messages，返回 404。

方式二：OpenAI 兼容协议

如果你的项目已经在用 OpenAI SDK，或者想用同一套代码混用 Claude、GPT 和 Gemini，用兼容协议更省事：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ZIVV_API_KEY"],
    base_url="https://zivv.pro/v1",  # 这里要带 /v1
)

resp = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[
        {"role": "system", "content": "你是一名资深后端工程师"},
        {"role": "user", "content": "给出 Redis 分布式锁的三个常见坑"},
    ],
)
print(resp.choices[0].message.content)

网关负责在两种协议之间转换请求和响应，业务代码完全不用关心上游是谁。把 model 换成 gpt-5.5 或 gemini-3.5-flash，同一段代码就能调用其他模型。更完整的 Python 写法（流式、重试、环境变量管理）见 Python 调用 AI API 入门。

方式三：在 Claude Code 中使用

Claude Code 走 Anthropic 原生协议，只需要两个环境变量：

export ANTHROPIC_BASE_URL=https://zivv.pro
export ANTHROPIC_AUTH_TOKEN=sk-your-key-here
claude

同样，ANTHROPIC_BASE_URL 只写主域名，不加 /v1。Windows 用户的配置方法和常见问题见 Claude Code Windows 安装配置，官方文档版本见 docs.zivv.pro 的 Claude Code 指南。

怎么确认接入是否成功

跑通第一条请求后，建议再做三项检查，避免上线后才发现问题：

看响应里的 model 和 usage 字段：model 应与你请求的模型一致，usage 里的输入输出 Token 数应与控制台用量页的记录对得上
测一次流式输出：大多数聊天类应用依赖流式返回，确认首个片段能快速到达、结尾能正常收尾，没有中途断流
测一次长上下文：把一份几万 Token 的文档或代码文件喂给模型，确认没有超时，也顺便感受一下实际的响应耗时和费用

这三项都通过，基本可以放心把它接进开发工具或业务代码。如果某一项异常，先对照下文的常见坑排查，再看控制台的用量明细定位是哪一次请求出了问题。

选哪个 Claude 模型

模型	特点	推荐场景
claude-sonnet-5	能力与速度均衡，性价比高	日常编码、对话、文档处理、大多数生产调用
claude-opus-4-8	推理能力更强，单价更高	复杂架构设计、疑难 Bug、长链路 Agent 任务

一个实用的策略是默认用 Sonnet，只在 Sonnet 解决不了的任务上切到 Opus，具体的分流方法可以参考多模型路由策略。模型 id 会随版本更新，接入前请以模型广场或 /v1/models 返回为准。

费用怎么算

Zivv 的扣费公式是：分组倍率 × 模型官方价格 × 实际 Token 用量，充值按 ¥1 = $1 结算。也就是说，一个官方标价 $3 每百万输入 Token 的模型，在倍率为 1 的分组里，相当于每百万输入 Token 扣 ¥3 余额。不同分组倍率不同，以控制台和模型广场显示为准。

几点省钱建议：

长 Prompt 先用 /v1/messages/count_tokens 估算输入 Token，再决定是否精简
设置合理的 max_tokens，避免模型输出远超需要的内容
简单任务（分类、提取、改写）不必用 Opus

想自己估算月度成本，可以参考 Token 成本计算指南。

接入后最常见的坑

现象	常见原因	解决方法
404 Not Found	Base URL 多拼或少拼了 /v1，或模型 id 写错	Anthropic 原生只写域名，OpenAI 兼容带 /v1；模型 id 以模型广场为准
401 Unauthorized	Key 复制不完整、多了空格，或用错了请求头	重新复制 Key；原生协议用 x-api-key，兼容协议用 Authorization: Bearer
402 余额不足	账户余额或 Key 额度用完	充值或调整 Key 额度
429 Too Many Requests	短时间请求过多	加指数退避重试，降低并发
529 Overloaded	上游模型临时过载	稍后重试，长任务做好断点续跑
400 参数错误	原生协议漏了 max_tokens，或 system 放进了 messages	原生协议 max_tokens 必填，system 是顶层字段

逐个错误码的详细排查可以看这几篇：401 未授权、402 余额不足、404 模型不存在、429 请求过多。

还有一个容易忽略的点：如果你的机器上设置了全局代理环境变量（如 HTTPS_PROXY），请求会先经过代理再到 Zivv，代理节点不稳定时会表现为超时或连接重置。Zivv 在国内可以直接访问，排查网络问题时可以先去掉代理再测一次。

数据安全说明

请求经过网关时，Zivv 只记录 Token 用量用于计费，不存储 Prompt 和 Response 正文。建议的使用习惯：

不同项目、不同环境用不同的 Key，出问题时只需撤销一把
Key 放在环境变量或密钥管理工具里，不要提交到代码仓库
团队使用时为每位成员分配独立 Key，并设置日、月预算，具体做法见团队模式

对数据出境、行业审计有硬性合规要求的业务，应评估是否需要直接与模型厂商签订企业协议。

常见问题 FAQ

Q：国内可以直接注册 Claude 官方 API 吗？ A：中国大陆不在 Anthropic 官方支持的地区列表中，注册需要海外手机号和国际信用卡，且账号存在停用风险。通过 API 网关是门槛最低的方式，邮箱注册、人民币充值即可使用。

Q：通过中转调用的 Claude 和官方是同一个模型吗？ A：请求最终转发到 Claude 模型，响应结构与官方一致。你可以用同一组高难度问题对照测试回答质量，验证方法见 AI API 中转站是什么。

Q：没有海外信用卡怎么给 Claude API 充值？ A：在 Zivv 控制台用人民币充值，按 ¥1 = $1 结算，充值后余额对所有模型通用，按实际 Token 用量扣费。

Q：Claude API 的 Base URL 应该填什么？ A：Anthropic 原生协议和 Claude Code 填 https://zivv.pro（不加 /v1）；OpenAI SDK 和 Cursor、Cline 等兼容工具填 https://zivv.pro/v1。

Q：Claude API 能做向量嵌入（Embedding）吗？ A：Zivv 目前不提供 Embedding 接口。RAG 场景可以用其他服务生成向量，再把检索结果交给 Claude 生成回答。

Q：Claude Code 用 API 按量还是订阅更划算？ A：取决于用量和使用节奏，详细对比见 Claude 订阅与 API 按量怎么选。重度使用 Claude Code 可以优先考虑 Claude MAX 分组。

动手清单

注册 Zivv，小额充值
创建 Key，选择合适的分组
用上面的 curl 命令验证 Key 和模型 id
按项目现状选择原生协议或 OpenAI 兼容协议接入
跑一周真实任务，在用量页核对 Token 消耗，再决定是否扩大使用

接口规范和错误码的完整说明见 Zivv 文档，遇到问题可以通过联系我们反馈。