Claude API 国内怎么用?3 种接入方法:SDK / Cursor / Claude Code 配置教程(2026 最新)
更新于 2026-07-10
📌 本文要点
- 三种接入方式:OpenAI 兼容 SDK 写代码、Cursor 改 API 地址、Claude Code 设两个环境变量
- 关键差异:SDK 的 base_url 带 /v1,Claude Code 的 ANTHROPIC_BASE_URL 不带
- 模型名规则:Claude 系必须带日期后缀,完整名去价格页复制
- 适合人群:想在国内直连使用 Claude API / Claude Code 的开发者
不少人拿到 Claude 的接入需求后,第一步就卡住了:Anthropic 不向国内网络直接开放,注册要海外手机号,付款要海外信用卡,一套流程折腾下来半天没了。这篇教程讲一个省事得多的路线——通过本站(云雾API)接入:注册就能拿 Key,人民币充值,base_url 换一行,SDK、Cursor、Claude Code 全都能跑。
为什么国内直连 Claude API 这么难
三个老问题:
- 网络不通:Anthropic 的接口在国内网络环境下无法直接访问,自己搭代理不但麻烦,账号还容易被风控。
- 注册门槛:需要海外手机号验证,很多人第一步就过不去。
- 付款困难:绑卡要求海外信用卡,国内的储蓄卡、支付宝都用不上。
中转的思路很简单:本站在中间做一层转发,你用国内网络直接请求 api.yunwu.cloud,人民币充值,拿到的还是 Claude 模型的返回结果。而且同一个 Key 能调包括 Claude 全系在内的 200+ 模型,gpt-4o、gemini-2.5-pro、deepseek-v3 都在列,不用维护一堆账号。
准备工作:3 分钟拿到 API Key
- 打开注册页面,邮箱注册即可,不需要海外手机号。注册即送免费测试额度、自动到账,每日签到还能续领——先别急着充钱,拿测试额度把下面的代码跑通再说。
- 登录后进控制台,点左侧菜单的令牌,创建一个新令牌,会得到一个
sk-开头的 Key。建议给每个项目单独建一个令牌并设额度上限,哪个项目烧钱多一眼就能看出来。 - 测试额度用完后,在钱包菜单充值。人民币支付,约 0.5 元 = 1 美元 token 额度,最低 1 元起充,充得多有阶梯折扣(以充值页面实际显示为准)。第一次建议先充几块钱试试水,确认跑通了再加。充值步骤不清楚的看这篇:云雾API怎么充值。

方式一:用 OpenAI 兼容 SDK 调 Claude 模型
本站接口兼容 OpenAI 格式,也就是说不需要装 Anthropic 的 SDK,用最常见的 openai 库,把 base_url 和模型名一改就行:
from openai import OpenAI
client = OpenAI(
api_key="sk-你的Key",
base_url="https://api.yunwu.cloud/v1"
)
resp = client.chat.completions.create(
model="claude-sonnet-4-5-20250929", # Claude 系模型名必须带日期后缀
messages=[{"role": "user", "content": "用一句话介绍你自己"}]
)
print(resp.choices[0].message.content)
如果你现有代码用的是 Anthropic 原生 SDK 或 Gemini 接口格式,也不用改写——本站同时兼容 Claude / Gemini 的接口格式,把请求地址指向 https://api.yunwu.cloud 即可,细节见文档教程。
方式二:Cursor 里改 API 地址
Cursor 支持自定义 OpenAI 接口地址,配置只有两步:
- 打开 Cursor 设置,找到 Models(模型)相关的设置区域;
- 在 OpenAI API Key 处填入你的
sk-Key,开启自定义/覆盖 Base URL,填https://api.yunwu.cloud/v1,然后在模型列表里添加claude-sonnet-4-5-20250929这样的模型名。
界面细节以客户端当前版本为准——Cursor 更新很勤,入口位置偶尔会挪。配置完先在对话框发一句话验证,能正常回复就说明通了。
方式三:Claude Code 环境变量法
Claude Code(官方文档)是命令行工具,接入靠两个环境变量。macOS / Linux 在终端执行(想长期生效就写进 ~/.zshrc 或 ~/.bashrc):
export ANTHROPIC_BASE_URL=https://api.yunwu.cloud
export ANTHROPIC_AUTH_TOKEN=sk-你的Key
Windows 用户在 PowerShell 里用 $env:ANTHROPIC_BASE_URL="https://api.yunwu.cloud" 的形式设置,两个变量都要照此设好。设置完直接运行 claude 命令,就会走本站的通道。具体以文档教程为准,里面有更完整的排错说明。
跑起来之后,控制台的日志菜单能看到每一条调用明细——用了哪个模型、消耗多少 token、扣了多少额度。我自己每次对不上账,翻日志是最快的。

模型名注意事项:Claude 系必须带日期后缀
这是新手报错的重灾区。在本站:
gpt-4o、gemini-2.5-pro、deepseek-v3这类模型名可以直接用;- Claude 系模型必须带日期后缀,比如
claude-sonnet-4-5-20250929,只写claude-sonnet-4-5会报模型不存在。
完整的可用模型列表和各自的倍率,直接看模型价格表,以那里显示的为准,比任何文章都新。
FAQ:常见问题
Q:通过本站调用和直连 Anthropic 有什么区别?
A:调的是同样的 Claude 模型,接口格式一致,区别在接入方式:国内网络直连、人民币付款、无需海外账号。至于效果和速度,别听别人转述——注册就有免费测试额度,拿你自己的真实任务跑一遍最有说服力。
Q:支持哪些 Claude 模型?
A:Claude 各系列的主流版本都有,具体型号和价格以价格页显示为准,新模型上架也会先出现在那里。
Q:有月费或最低消费吗?
A:没有。按量计费,余额按实际 token 用量扣减,不用就不扣。不同模型有分组倍率,价格页写得很清楚。
Q:调用报 model not found 怎么排查?
A:九成是模型名写错了。先检查 Claude 模型是否带了日期后缀;再去价格页复制准确的模型名;还不行就看控制台日志里的报错详情。
Q:公司用量大,能对公充值吗?
A:可以,对公转账和大额充值联系客服支持处理。
三种方式选一种适合你的就行:写代码用 SDK,改配置用 Cursor,命令行党用 Claude Code。先拿测试额度跑通,再谈用量。
相关阅读:云雾API怎么充值(人民币充值教程) | 模型价格表 | 返回首页
