在台灣、香港怎麼穩定使用 Claude API？

官方 API 和中轉各有什麼門檻？

Anthropic 官方 Console 要自己註冊、驗證、綁付款方式，額度按官方的使用層級慢慢往上調。香港不在 Anthropic 官方的支援地區清單裡，台灣的開發者則常遇到付款方式被拒、剛開始額度太低、或公司報帳不方便等問題。實際的地區和規定以 Anthropic 官方頁面為準。

中轉服務的做法是：你在中轉平台儲值、拿 Key，請求送到中轉平台，再由平台呼叫模型。你不用自己維護官方帳號，換模型也只是改一個參數。

開始使用的步驟

1. 註冊 MaCloud AI，驗證 Email 後第一次進控制台會拿到試用額度。
2. 要長期使用就到 儲值頁，選目前開放的付款方式儲值，最低 US$3；付不了就聯絡客服。
3. 到 API Key 建一把 Key，依專案命名，例如「台北官網客服機器人」。
4. 程式裡把 base URL 改成 https://api.macloudai.com（Anthropic SDK）或 https://api.macloudai.com/v1（OpenAI SDK）。
5. model 填 模型頁 上的名字，例如 hk-5-5。
6. 跑一次，到 用量 確認有記錄。

儲值位置：控制台左邊選單「儲值」→ 選金額 → 選付款方式。頁面上看到的就是目前開放的方式；如果沒有你能用的，聯絡客服處理，不要找第三方代付。

範例程式碼：Anthropic SDK

import anthropic

client = anthropic.Anthropic(base_url="https://api.macloudai.com", api_key="sk-...")
r = client.messages.create(
    model="hk-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "幫我把這段會議紀錄整理成三點重點"}],
)
print(r.content[0].text)

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({ baseURL: "https://api.macloudai.com", apiKey: process.env.MACLOUD_API_KEY });
const r = await client.messages.create({
  model: "hk-5-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "幫我把這段會議紀錄整理成三點重點" }],
});
console.log(r.content[0].text);

Anthropic 格式的 base URL 不加 /v1，SDK 會自己接上。鑑權可以用 x-api-key（SDK 預設）或 Authorization: Bearer sk-...。

範例程式碼：OpenAI SDK 呼叫 Claude

如果你的專案本來就用 OpenAI SDK，不用換套件，改 base URL 和模型名就能呼叫 Claude：

from openai import OpenAI

client = OpenAI(base_url="https://api.macloudai.com/v1", api_key="sk-...")
r = client.chat.completions.create(
    model="hk-5-5",
    messages=[{"role": "user", "content": "用繁體中文寫一段香港咖啡店的產品介紹"}],
)
print(r.choices[0].message.content)

curl https://api.macloudai.com/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{"model": "hk-5-5", "messages": [{"role": "user", "content": "你好"}]}'

要串流就加 stream=True（Node.js 是 stream: true）。換 GPT 或 Gemini 只要把 model 改成 tt-6-luna 或 gem-3.8-flash，Key 和網址都不用動。

API Key 怎麼保管才安全？

• Key 就等於你的餘額。不要寫死在前端程式（瀏覽器、App）裡，也不要推到公開的 GitHub repo。
• 用環境變數或伺服器的祕密設定讀取，例如 .env 檔，並把 .env 加進 .gitignore。
• 一個專案一把 Key。新竹的開發環境、台北的正式環境分開，出事只刪一把。
• Key 外流就到控制台刪掉，舊 Key 立刻失效，再建一把新的換上。
• 定期看 用量，發現不認得的呼叫就換 Key。

「穩定」可以期待到什麼程度？

我們不會說「絕不封號」或保證百分之百不中斷，因為上游模型本身也會有暫時出錯的時候。實際上你會遇到的狀況大概是：偶爾某個模型回 5xx，過一會兒重試就好；請求太密集會收到 429。程式裡加上簡單的重試（例如等 2 秒、4 秒、8 秒），就能處理大部分情況。

另外，對話內容我們不保存，只記錄 token 數、模型名和時間用來計費。做客服機器人或處理客戶資料時，仍然建議只送必要的內容。

常見問題

更多指南

• Claude Code 中轉怎麼設定？三個環境變數搞定
• Claude Code 錯誤排查：401、403、404、429 怎麼解
• Cursor 自訂 API 設定：用自己的 Key 呼叫 Claude
• Claude、GPT、Gemini、DeepSeek 怎麼選？
• AI API token 怎麼計費？公式和省錢方法
• 按量計費比月費划算嗎？AI 訂閱怎麼選