作者注：人在中国大陆走不通 Claude 官网，走通也有封号风险，无论你是大陆公民还是来中国旅游的外国人——本文带你用 API易 15 分钟把 claude-opus-5-5 接进聊天软件和写代码的 Agent，聊天软件以 Cherry Studio 为例，Agent 用 Magpie 统一管理。
人在中国大陆，想稳定用上 claude-opus-5-5，缺的其实是一个能用微信或支付宝充值、又能填进各种软件的 Key。API易（apiyi.com）是 AI 大模型 API 聚合平台，一个 API Key 可以调用 Claude、OpenAI、Gemini 等主流模型，支持 OpenAI 兼容接口，按量计费。本文用它把 claude-opus-5-5 接进聊天软件（以 Cherry Studio 为例），再接进写代码的 Agent（用 Magpie 统一管理），全程图形界面，从注册到发出第一句约 15 分钟。
官网走不通，走通也有封号风险
人在中国大陆，Claude 官网这条路走不通。网页、客户端和官方订阅这几个入口，大陆用户都没法正常用，这不是哪一个设置没调对，也不是换个浏览器能解决的事。
就算想办法走通了，账号也有很大的封号风险。账号一旦被封，里面的余额和历史记录都可能一起没了，官方不会替你恢复，你也没有地方申诉。花了钱、攒了对话，最后落得一场空，这笔账不划算。
所以更稳的是接 API易 上的 Claude，模型名用 claude-opus-5-5。你不需要 Claude 官网的登录，只需要一个地址、一个令牌和一个模型名，三样东西填进软件就能用。
先在 API易 拿到 Claude 的令牌
动手之前，先把下面 5 个注意事项过一遍。它们对应后面最容易踩的五个坑，每一条在后文都会再用到。
| 注意事项 | 怎么做 | 做错会怎样 |
|---|---|---|
| 模型名用连字符 | 写成 claude-opus-5-5，中间全是连字符 |
写成 claude-opus-5.5 会提示模型找不到 |
| 思考不能关 | 这个模型的思考无法关闭，不要发 disabled |
发 disabled 会返回 400，想省时间改用 effort 的 low |
地址是否带 /v1 |
Anthropic 协议的客户端填根域名，OpenAI 兼容的客户端要带 /v1 |
多一截或少一截都会 404 |
| 分组选对 | 聊天用 Default，写代码的 Agent 必须用 ClaudeCode | 分组不对，Agent 会调用失败或多花钱 |
| 先设小额度 | 第一把令牌只给很小的额度 | 配置写错时，损失被额度封住 |
准备工作很简单：一个邮箱、一个能正常打开 API易 站点的浏览器，再装一个你平时用的聊天软件，需要写代码的话再装 Magpie。难度按新手来写，每一步都会交代目标、会看到什么、点哪里、怎样算做完，以及大约要几分钟。整个流程的时间预算如下：
- 第一步 注册账号，约 3 分钟。
- 第二步 微信或支付宝充值，约 2 分钟。
- 第三步 建两把令牌，约 3 分钟。
- 第四步 在聊天软件里发出第一句，约 4 分钟。
- 第五步 用 Magpie 接上写代码的 Agent，约 3 分钟。
第一步：注册账号（约 3 分钟）
目标是拿到一个能登录的 API易 账号。在浏览器里打开 api.apiyi.com，点页面上的注册，按提示用邮箱完成注册并登录。登录成功后你会进入控制台页面，页面上能看到账户余额。
按文档说明，新账号有一笔很小的试用额度，大约够发一两句短消息，具体数额以你账号里显示的为准，不要把它当成一定有的余额。看到控制台、能看到余额数字，这一步就算过了。
如果注册后迟迟没有进入控制台，先看邮箱里是否有验证邮件，再检查垃圾邮件夹。登录之后建议把站点加进浏览器书签，后面建令牌、看日志都要回到这里，不用每次重新找入口。
第二步：充值（约 2 分钟）
目标是让账号里有一点可用余额。在控制台找到充值入口，选择微信或支付宝，扫码付款。建议第一次只充很小的金额，先把流程跑通，再按需要补充，这样即使中途哪里填错，损失也有限。付款完成后刷新页面，余额数字变大，就说明这一步过了。
充值之前，可以先看一眼价格。下面这些数字抄自 API易 的模型价格总表（docs.apiyi.com/models），价格页上标的数据更新时间是 2026-10-23 06:05，单位都是美元每百万 tokens，按 Default 分组倍率 1 计算。claude-opus-5 只作对照，不是本文要接的模型。
| 计费项目 | claude-opus-5-5 | claude-opus-5-5-thinking | claude-opus-5（对照） |
|---|---|---|---|
| 输入 | 4 美元 | 4 美元 | 5 美元 |
| 输出 | 20 美元 | 20 美元 | 25 美元 |
| 缓存读 | 0.20 美元 | 0.20 美元 | 0.50 美元 |
三个列名先解释清楚，才不会看错账。输入是发给模型的那部分 token，输出是模型回给你的那部分，缓存读是命中提示词缓存以后、这部分输入按哪个价格算。claude-opus-5-5 的缓存读是输入价的 5%，claude-opus-5 是 10%，所以反复带着同一大段上下文提问时，命中缓存能明显省钱；没命中的部分仍然按原价走。价格页上同一套数字也挂在 claude-opus-5-5-thinking 上，两个 ID 同价；这个模型支持 chat 和 messages 两种端点，分组列写的是 ClaudeCode、Claude_Reverse、Claude_Enterprise、Default、SVIP 五个，模型名后面也没有打阶梯计价的标记，请求多大都按这三行算。
再看一笔典型调用，按上面的标价推算，不是真实账单：2 万输入 token 加 2000 输出 token，Default 分组是 0.12 美元；同一笔换成倍率 0.95 的 ClaudeCode 分组，是 0.114 美元。具体到你的账单，以控制台日志里的记录为准。
这笔账可以这样读：输入部分 2 万 token 按每百万 4 美元算是 0.08 美元，输出部分 2000 token 按每百万 20 美元算是 0.04 美元，两项相加正好 0.12 美元。聊天窗口里问一两句话，用量通常远小于这个例子，所以第一次充一点点就足够跑完全部步骤。
充值这一头也有价格，一起写清楚。API易 按 1:7 的固定汇率结算，5 美元起充，也就是 35 元人民币左右；充值还有赠送，价格页写的是赠送之后实际成本可以降到标价的 1/1.1（约 91 折），活动期最高 1/1.2（约 83 折）。这笔赠送和表里的分组折扣可以叠加，所以同样的调用，实际扣掉的钱通常比按标价算出来的少一点。真实扣了多少，仍然以控制台为准。
另外，Anthropic 官方说 claude-opus-5-5 的生成速度比上一代 Opus 5 快 30% 以上，这是官方说法，不是本文测出来的数字。
第三步：建两把令牌（约 3 分钟）
目标是拿到两个 sk- 开头的密钥，一个给聊天软件，一个给写代码的 Agent。打开令牌页 api.apiyi.com/token，新建令牌，每次填写时注意下面几点：
- 名称随意，建议一把叫 chat，一把叫 code，以后一眼分得清。
- 分组：聊天那把选 Default，写代码的 Agent 那把选 ClaudeCode。
- 额度：第一把先设小额度，跑通以后再加大。不要为了省事选无限额度，也不要设成永不过期。
- 计费方式：令牌按量，不要按次。
- 模型限制：只放行
claude-opus-5-5也可以，这样别的模型调不走你的额度。
创建完成后，复制密钥保存好。令牌列表里出现两把状态为启用的令牌，这一步就算过了。如果你只打算聊天，并且聊天软件里选的是 Anthropic 类型，那么只建一把 ClaudeCode 分组的令牌就够用，聊天也可以用它。
令牌创建后，立刻把密钥复制并存进你自己的密码管理器，不要贴进聊天群，也不要写进会上传到公开仓库的文件里。万一贴错了地方，回到令牌页把那把令牌禁用，再新建一把即可，因为额度本来就设得小，影响有限。
几个分组该怎么选，下面这张表一次说清楚：
| 分组 | 倍率 | 怎么用 |
|---|---|---|
| Default | 1 | 聊天用，想和官网同价就选它 |
| ClaudeCode | 0.95 | 写代码的 Agent 必须用这一组，聊天软件也能用 |
| Claude_Enterprise | 1.2 | 更贵，不推荐 |
| Claude_Reverse | 0.5 | 来源没有核实，要稳定接入就不选 |
价格页的分组列里还列了 SVIP，倍率和 Default 一样都是 1，本文的接入流程用不到它。
聊天软件怎么接，以 Cherry Studio 为例
Cherry Studio 只是一个例子。你平时用哪款聊天软件，只要它能添加 Anthropic 类型的服务，就按同样三样填：根域名、sk- 令牌、模型名 claude-opus-5-5。下面保留 Cherry Studio 的点击步骤当例子，别的软件对着找同样的三个格子就行。
第四步：聊天软件发第一句（约 4 分钟）
目标是让 claude-opus-5-5 在聊天窗口里回你一句话。以 Cherry Studio 为例，先下载安装包，装好后打开。点左下角的设置，进入模型服务，点添加，然后依次填下面这些内容：
- 提供商类型：选 Anthropic。
- 名称：可以填
APIYI-CLAUDE，方便以后认。 - API 地址：
https://api.apiyi.com，填根域名，后面不要加/v1，也不要多一个斜杠。 - 密钥：粘贴刚才那把
sk-令牌，聊天用 Default 分组的那把。 - 模型：选择手动添加模型，ID 必须写
claude-opus-5-5，中间是连字符。
保存之后，回到对话窗口，在顶部选中刚加的这个模型，发一句短中文，比如「用一句话介绍你自己」。会看到的是：过几秒后出现回复。因为这个模型的思考关不掉，第一句比普通聊天模型慢一点，这是正常的，不要重复点发送。
验收分两处。第一处是聊天窗口里有回复；第二处是回到 API易 的控制台，打开令牌对应的日志页，最新一条记录里的模型名是 claude-opus-5-5。两处都对，这一步才算过。日志里出现的是别的模型名，说明窗口里选错了模型，回去重选。
配置时最容易出的岔子，是提供商类型选成了 OpenAI。两种类型的区别在于地址的写法：选 Anthropic 就填根域名，不带 /v1；如果你坚持选 OpenAI 兼容类型，地址才要在根域名后面加上 /v1。本文统一用 Anthropic 类型，是因为它和后面的 Claude Code 保持同一套地址，少记一个差异。保存后如果发消息直接报 404，先回设置页检查地址末尾有没有多出来的斜杠。
三个格子哪个最容易错，看下面这张示意图，别的聊天软件填的也是这三样：
写代码的 Agent 怎么接，用 Magpie
编程 Agent 不限某一个。Claude Code、Codex、Pi、Hermes 以及其他你正在用的 Agent，都可以接到同一把 API易 的 Claude 令牌上。接多个时用开源 Magpie，在一个窗口里管，不用每个工具各改一套配置。Magpie 的逐步图解已经有专门的文章，这里不重复，想看图可以读 一个 Key 接上所有 Agent 的 Magpie 教程。
第五步：用 Magpie 接上 Agent（约 3 分钟）
目标是让你在用的 Agent 通过 API易 调用 claude-opus-5-5。Magpie 是图形界面，装好打开后先配供应商，再给 Agent 开开关。
- 装好 Magpie，打开「供应商」，点添加，选 API易。
- 协议：选 Anthropic。
- 地址：
https://api.apiyi.com，填根域名，不要加/v1。 - Key：填 ClaudeCode 分组的令牌，不要用 Default 的。
- 模型：勾选
claude-opus-5-5。
保存之后，打开「Agent」页，给你要用的工具打开开关并选这个模型，然后重开那个工具，免得旧会话还带着上一份配置。会看到的是：让它做一件很小的事，比如「读一下当前目录并告诉我有哪些文件」，过几秒就有回复。
验收分两处。第一处是工具有回复；第二处是回到 API易 控制台的令牌日志，最新一条记录里的模型名是 claude-opus-5-5，令牌是 ClaudeCode 分组那把。两处都对，这一步才算过。如果工具报调用失败，先查令牌分组是不是 ClaudeCode，这是最常见的原因。
如果之后想临时换回别的供应商，在 Magpie 里切换即可，API易 这一项不用删，下次要用再切回来。只接 Claude Code、已经在用 CC Switch 的人，也能填同一组地址和令牌，但接多个 Agent 还是用 Magpie 更省事。
只接 Claude Code，不想装 Magpie
如果你只用 Claude Code 一个，也不想装 Magpie，可以直接改环境变量：把 ANTHROPIC_AUTH_TOKEN 填成 ClaudeCode 分组的令牌，把 ANTHROPIC_BASE_URL 填成根域名；也可以把这两项写进用户目录下 .claude/settings.json 的 env 里。走的同样是 API易 的令牌，不需要另外注册 Claude 官网账号。不熟悉配置文件的新手，直接用上面的 Magpie 更省心。
地址、分组和报错对照
这一节收纳接入之后最常用的对照表，先看三个节点怎么选。三个节点功能一样，区别只在线路和超时上限。
| 节点 | 地址 | 什么时候用 |
|---|---|---|
| 默认节点 | api.apiyi.com |
国内外都先用它 |
| 国内备用 | b.apiyi.com |
功能一样，主节点异常时再换 |
| 带 cf 的节点 | 地址里带 cf（具体以站点公布的为准） | 超时上限 100 秒，思考关不掉，长回复不要走它 |
遇到报错时，对照下面这张表，从最左边一列找现象：
| 现象 | 常见原因 | 怎么处理 |
|---|---|---|
| 404 | Anthropic 客户端多加了 /v1，或 OpenAI 兼容客户端漏了 /v1，或地址末尾多了斜杠 |
Anthropic 客户端填 https://api.apiyi.com，OpenAI 兼容的才带 /v1 |
| 提示模型找不到 | 写成了 claude-opus-5.5、claude-opus-5，或旧的 4 代 ID |
改成 claude-opus-5-5 |
| Agent 调用失败 | 令牌不是 ClaudeCode 分组 | 在令牌页新建 ClaudeCode 分组的令牌并替换 |
| 思考配置返回 400 | 请求里发了 disabled |
删掉这个参数，要降延迟改用 effort 的 low |
| 超时 | 余额用完，或令牌被停用 | 先看余额和令牌是否启用，再换国内备用节点，不要改去 100 秒的节点 |
| 账单偏贵 | 选了 1.2 倍的企业分组 | 改回 Default 或 ClaudeCode |
| 账单便宜一半 | 选了 Reverse 分组 | 便宜不等于同一条稳定通道，稳定接入不选它 |
下面这张图把最容易犯的三个错放在一起：
什么时候不该走这条路
下面几种情况，建议不要走这条路：
- 官网对你可用，而且月费对你更划算，直接用官网。
- 你要的是 claude.ai 网页：这里的令牌只能调用接口，换不来官网的登录。
- 你想和官网同价：用 Default 分组，不要为了便宜选 Reverse，也不要选 1.2 倍的企业分组。
- 你要跑长任务：不要用带 cf 的 100 秒节点，长回复会被中途掐断。
几个常被问到的问题
问：图形界面里能不能把 effort 调到高？答：这一点目前不确定，软件里有没有 effort 开关、叫什么名字，要以你装的版本界面为准，本文不替它编按钮名。编程任务想要 high 的效果，调不了就在提示词里把任务写具体：改哪个文件、期望什么结果、不要动哪些地方。
问：令牌设多少额度合适？答：第一把只给很小的额度，跑通日志里的模型名以后再加大。令牌按量计费，不要为了省事选无限额度，也不要设永不过期。
问：日志里的模型名和我选的不一样怎么办？答：多半是软件里选错了模型，或者同一个供应商下留着别的模型 ID。回到模型列表，只保留 claude-opus-5-5 这一个，再发一句短消息重新验收。
问：聊天软件和 Magpie 都要装吗？答：不用。只聊天装一款聊天软件，只写代码装 Magpie，两个都想要就都装，令牌分别用 Default 和 ClaudeCode 两组。
最后把整条路线收个尾：先认清官网走不通，再注册、充值、建两把令牌，然后在聊天软件里发出第一句，在 Magpie 里接上写代码的 Agent，最后用上面的表格排错。每一步都靠日志里的模型名 claude-opus-5-5 验收，别只看窗口里有没有回复。
