AI 對話模型價格文檔指南
繁體中文
MaCloud AI/指南

Claude Code 中轉怎麼設定？三個環境變數搞定

在 MaCloud AI 註冊並儲值，到控制台建一個 API Key，然後設定三個環境變數：ANTHROPIC_BASE_URL=https://api.macloudai.com、ANTHROPIC_AUTH_TOKEN=sk-...、ANTHROPIC_MODEL 填模型名，再照常執行 claude。也可以寫進 ~/.claude/settings.json 的 env，之後每次開終端機都會自動生效，用量按 token 從美元餘額扣。

更新於 2026-11-01 · MaCloud AI

設定前要準備什麼？

  • 電腦上已經裝好 Claude Code（照 Anthropic 官方的安裝說明裝，macOS、Linux、Windows 都支援）。
  • 一個 MaCloud AI 帳號。註冊 只要 Email 或 Google 帳號，不用綁卡；驗證過 Email 的新帳號第一次進控制台會送一點試用額度，夠你先把設定跑通。
  • 一個 API Key：控制台的 API Key 頁面建立，建議幫它取個名字，例如「公司 MacBook」。
  • 要用的模型名：到 模型頁 複製，大小寫、連字號都要一模一樣。

整個流程不需要申請 Anthropic 官方帳號，也不用自己處理官方的付款和地區限制。Claude Code 本身就支援把 API 網址換成別的服務，我們做的只是讓它指到 https://api.macloudai.com。

設定步驟

  1. 註冊登入 MaCloud AI，第一次進控制台確認試用額度已經入帳；要長期用就到 儲值頁 選目前開放的付款方式儲值，最低 US$3。
  2. 打開控制台左邊的 API Key，按「建立 Key」，取個名字後複製產生的 sk-...。
  3. 在終端機設定 ANTHROPIC_BASE_URL=https://api.macloudai.com（注意不要加 /v1）。
  4. 設定 ANTHROPIC_AUTH_TOKEN 為剛才複製的 Key。
  5. 設定 ANTHROPIC_MODEL 為模型頁上的 Claude 模型名，例如 hk-5-5。
  6. 在專案資料夾執行 claude，送一句短訊息，再到控制台的 用量 確認有記錄。

Key 只在建立當下完整顯示一次。位置：控制台左邊選單 API Key → 右上角「建立 Key」→ 跳出的視窗裡按複製。沒複製到就刪掉重建一把，不影響餘額。

macOS / Linux / Windows 的環境變數怎麼寫？

export ANTHROPIC_BASE_URL=https://api.macloudai.com
export ANTHROPIC_AUTH_TOKEN=sk-...
export ANTHROPIC_MODEL=hk-5-5
claude

上面的寫法只對目前這個終端機視窗有效，關掉就沒了。想永久生效：macOS 預設用 zsh，把三行 export 加到 ~/.zshrc；Linux 多半是 bash，加到 ~/.bashrc；存檔後開一個新的終端機視窗。Windows 可以用 setx，例如 setx ANTHROPIC_BASE_URL "https://api.macloudai.com"，三個都設完後把 PowerShell 整個關掉再開。

用 settings.json 設定（推薦）

比起改 shell 設定檔，更乾淨的做法是寫進 Claude Code 自己的設定檔 ~/.claude/settings.json。這樣不會影響其他程式，也不怕換了終端機軟體就失效。檔案不存在就自己建一個：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.macloudai.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-...",
    "ANTHROPIC_MODEL": "hk-5-5"
  }
}

Windows 上這個檔案在 C:\Users\你的使用者名稱\.claude\settings.json。如果檔案裡原本已經有別的設定（例如權限設定），把 env 那一段加進去就好，不要整個覆蓋。JSON 最後一項後面不能有逗號，存檔前多看一眼。

環境變數和 settings.json 同時設了不同的值，很容易搞不清楚到底用的是哪一個。建議只留一種：用 settings.json 就把 ~/.zshrc 裡的 export 刪掉。

怎麼確認真的走到 MaCloud AI？

最直接的方法是看用量記錄。在專案資料夾執行 claude，送一句「你好」，然後打開 控制台 → 用量：最近 50 次呼叫會列出模型名、輸入 / 輸出 token 和費用。看得到剛剛那一筆，就代表設定成功。

也可以先在終端機確認變數有讀到：

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_MODEL

如果 Claude Code 叫你登入 Anthropic 官方帳號、或者用量頁什麼都沒有，通常是變數沒生效或你之前登入過官方帳號，處理方式見 Claude Code 錯誤排查。

怎麼讓 Claude Code 少花一點 token？

Claude Code 每一步都會把相關檔案內容、指令輸出和前面的對話一起送出去，這些全部算輸入 token。所以對話拖得越長，每一步越貴。幾個實際有用的習慣：

  • 一個任務做完就開新對話（或用 /clear），不要在同一個 session 裡從早聊到晚。
  • 對話太長但還要繼續時，用 /compact 讓它把前面的內容壓縮成摘要。
  • 在專案根目錄放一份簡短的 CLAUDE.md，寫清楚專案結構和規矩，省得它每次都翻一堆檔案找答案。
  • 說清楚要改哪個檔案、哪個函式，比「幫我看看這個專案哪裡有問題」省很多。
  • 把 node_modules、建置產物、大型資料檔加進忽略清單，別讓它去讀。
  • 簡單的改名、格式化、寫測試樣板，可以換成比較便宜的模型；價格差異看 模型頁。

每次呼叫的費用都會出現在 用量，跑一兩天就知道自己的使用習慣大概花多少。token 怎麼算可以看 AI API token 怎麼計費。

換模型、多台電腦、團隊共用怎麼處理？

換模型只要改 ANTHROPIC_MODEL，Key 不用換。同一把 Key 可以用在好幾台電腦，但比較建議一台電腦一把 Key：例如台北辦公室的桌機一把、出差用的筆電一把，哪台電腦弄丟了，只要刪那一把，其他照常運作。團隊共用同一個帳號時也一樣，一人一把 Key，在用量頁比較好對帳。

常見問題

Q1Claude Code 中轉需要先申請 Anthropic 官方帳號嗎？
不需要。只要 MaCloud AI 的帳號和 API Key，把 ANTHROPIC_BASE_URL 指到 https://api.macloudai.com 就能用，不用自己註冊和維護官方帳號。
Q2ANTHROPIC_BASE_URL 要不要加 /v1？
不要。Claude Code 用的是 Anthropic 格式，網址填 https://api.macloudai.com 就好；加了 /v1 會變成錯誤的路徑，常見症狀是 404。
Q3註冊要綁信用卡嗎？怎麼付款？
註冊和領試用額度都不用綁卡。要儲值時，在控制台儲值頁選目前開放的付款方式，付不了就聯絡客服。
Q4在 Windows 上設定後還是沒反應？
用 setx 設的變數只對新開的視窗有效，要把 PowerShell 或 VS Code 整個關掉重開。更穩的做法是寫進 settings.json 的 env。
Q5餘額用完會怎樣？
請求會被拒絕（403），Claude Code 會顯示錯誤。儲值後馬上恢復，不用重新設定；餘額在帳號有效期間不會過期。
免費註冊 → 看模型和價格

更多指南