作者注：人在中國大陸走不通 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 驗收，別隻看窗口裏有沒有回覆。
