已安裝 Claude Code
從官方來源安裝 Claude Code，並在終端機中用 claude --version 確認可執行。如果該指令發生錯誤，請先修正安裝，再設定任何 API 金鑰。
Claude Code
Claude Code API Key 設定
Claude Code 會讀取兩個環境變數來將請求路由到任何位置：ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY。將它們指向 RunAPI，即可以官方費率的一半執行每個 Claude 模型。本指南會示範 Mac、Linux 和 Windows 的確切指令。
更新於 June 18, 2026
RunAPI Editorial
一覽
如何在 Claude Code 中設定自訂 API key？
Claude Code 使用兩個環境變數來決定請求送往何處以及如何驗證。將 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY 設為 RunAPI 的值，每個請求都會透過 RunAPI 路由並享 50% 折扣。想使用完全不同的提供者？RunAPI 也可作為隨插即用的閘道，讓你在沒有直接 Anthropic 帳戶的情況下執行 Claude 模型。
兩個變數
ANTHROPIC_BASE_URL 設定端點。ANTHROPIC_API_KEY 設定金鑰。這就是全部設定——兩個變數，不需要其他變更。
端點值
將 ANTHROPIC_BASE_URL 設定為 https://api.runapi.ai，使 Claude Code 透過 RunAPI 路由。
持久化設定
將兩個 export 加到你的 shell 設定檔（.zshrc 或 .bashrc），這樣你就不必每個工作階段都重新設定。Windows 使用者請在 PowerShell 中設定，並開啟新視窗。
50% 折扣
所有 Claude 模型以官方 Anthropic 費率一半計費。無訂閱，無上限。
開始之前
設定 Claude Code 之前需要什麼？
設定只需幾分鐘。你需要已安裝 Claude Code、RunAPI 帳戶和終端機。請先執行 claude --version 確認 Claude Code 可正常運作，再處理任何 API 金鑰設定。
RunAPI 帳戶
在 runapi.ai 註冊。免費方案包含點數，可在儲值前測試任何 Claude 模型。
API key
從 Dashboard → API Keys 建立金鑰。只複製一次——完整內容只會在建立時顯示。請勿將它貼到公開 repo，或在截圖中分享。
終端存取
你需要 shell 來設定環境變數。macOS 和 Linux 使用 .zshrc 或 .bashrc。Windows 使用者可以使用 PowerShell——設定變數後，開啟新的終端機視窗讓它生效。
逐步說明
如何設定 Claude Code API key 與 RunAPI
依序執行這些指令。它們會設定端點和金鑰、將它們持續保存到你的 shell 設定檔，並確認 Claude Code 能讀取到。請將 placeholder 替換成你真正的 RunAPI 金鑰。使用 ANTHROPIC_API_KEY（不是 CLAUDE_API_KEY）——這才是 Claude Code 實際讀取的變數。
1
設定基礎 URL
這告訴 Claude Code 將請求傳送到 RunAPI，而不是預設的 Anthropic 端點。
export ANTHROPIC_BASE_URL=https://api.runapi.ai
2
設定 API key
將佔位符替換為你的 RunAPI 金鑰。Claude Code 使用它來驗證每個請求。
export ANTHROPIC_API_KEY=sk-your-runapi-key
3
持久化兩個變數
將兩個 export 附加到 ~/.zshrc（或 ~/.bashrc），讓它們在新的終端機工作階段中保留。使用 source ~/.zshrc 重新載入。Windows 上，請在 PowerShell 中設定它們，並開啟新的終端機視窗讓變更生效。
echo 'export ANTHROPIC_BASE_URL=https://api.runapi.ai' >> ~/.zshrc
4
驗證設定
確認變數會印出 RunAPI URL。如果是空的，請重新載入你的 shell 設定檔或開啟新的終端機——在某個工作階段中設定的變數不會自動帶到其他工作階段。
echo $ANTHROPIC_BASE_URL
5
執行 Claude Code
在你的專案中啟動 Claude Code。它現在以官方費率 50% 透過 RunAPI 路由。
claude環境變數
Claude Code 讀取哪些環境變數？
Claude Code 會讀取一小組變數來控制端點、驗證、模型和輸出長度。表格列出自訂端點設定中重要的變數，以及各自的作用。注意：請使用 ANTHROPIC_API_KEY（不是 CLAUDE_API_KEY）——這才是 Claude Code 實際讀取的變數。
| 變數 | 用途 | 範例值 |
|---|---|---|
| ANTHROPIC_BASE_URL | Claude Code 傳送請求的自訂端點 | https://api.runapi.ai |
| ANTHROPIC_API_KEY | 用於驗證請求的金鑰 | sk-your-runapi-key |
| ANTHROPIC_MODEL | 新作業的預設模型 | claude-sonnet-4-6 |
| CLAUDE_CODE_MAX_OUTPUT_TOKENS | 每次回應的 token 上限 | 8192 |
你也可以將這些值儲存在主目錄或專案目錄下的 .claude.json 設定檔中，而無需每次作業都匯出它們。
選擇模型
在 Claude Code 中應該運行哪個 Claude 模型？
Claude Code 可透過 RunAPI 接受任何 Claude 模型 ID。依任務選擇：例行編輯用快速便宜的模型、日常寫程式用平衡型模型，或困難問題用最強模型。設定 ANTHROPIC_MODEL 來變更預設值，或在 Claude Code 內切換模型——計費會依你實際呼叫的模型而定。
claude-haiku-4-5
透過 RunAPI 最快且最便宜，輸入 $1/M，輸出 $5/M。最適合日常編輯和快速查詢。
claude-sonnet-4-6
日常程式碼撰寫的均衡預設選擇，透過 RunAPI 輸入 $3/M，輸出 $15/M。大多數開發者使用此模型。
claude-opus-4-7
解決困難問題最強的選擇，透過 RunAPI 輸入 $5/M，輸出 $25/M。用於複雜重構和程式碼審查。
隨時切換
隨時設定 ANTHROPIC_MODEL，或在 Claude Code 內變更模型。計費會依你實際呼叫的模型而定，全部皆享 50% 折扣。
修復常見錯誤
為什麼我的 Claude Code API key 無法使用？
大多數設定問題都來自三件事之一：env var 名稱錯誤（使用 ANTHROPIC_API_KEY，不是 CLAUDE_API_KEY）、尚未讀取設定檔變更的舊 shell 工作階段，或金鑰輸入錯誤。表格列出常見錯誤及各自的修正方式。
| 錯誤或症狀 | 可能原因 | 修復方式 |
|---|---|---|
| 401 未授權 | API key 錯誤或已過期 | 重新確認 ANTHROPIC_API_KEY，如有需要在 RunAPI 儀表板建立新金鑰 |
| 請求仍打到 Anthropic | 此 shell 中未設定 ANTHROPIC_BASE_URL | 執行 echo $ANTHROPIC_BASE_URL；如果為空，重新載入設定檔或開啟新終端 |
| 404 未找到 | 基礎 URL 有尾斜線或路徑錯誤 | 將基礎 URL 精確設定為 https://api.runapi.ai，不帶任何尾斜線或路徑 |
| 找不到模型 | 模型 ID 無效或拼寫錯誤 | 使用有效 ID，如 claude-sonnet-4-6 或 claude-opus-4-7 |
| 重新啟動後變數消失 | 匯出未寫入 shell 設定檔 | 將兩個匯出追加到 ~/.zshrc 或 ~/.bashrc 並重新載入 |
快速版本
四個步驟完成 Claude Code API key 設定
1
設定基礎 URL
匯出 ANTHROPIC_BASE_URL=https://api.runapi.ai 以透過 RunAPI 路由請求。
2
設定 API key
使用 Dashboard → API Keys 中的 RunAPI 金鑰匯出 ANTHROPIC_API_KEY。
3
持久化兩個變數
將兩個 export 附加到 ~/.zshrc 或 ~/.bashrc，並用 source ~/.zshrc 重新載入，讓它們在新工作階段中保留。Windows 上，請在 PowerShell 中設定它們，並開啟新的終端機視窗。
4
執行 Claude Code
執行 claude --version 確認已安裝，然後在你的專案中啟動 claude。請求現在會透過 RunAPI 路由，並享有官方費率 50% 折扣。
常見問題
Claude Code API Key 常見問題
如何在 Claude Code 中新增 API key？
設定兩個環境變數。將 ANTHROPIC_BASE_URL 匯出為 https://api.runapi.ai，並將 ANTHROPIC_API_KEY 匯出為你的 RunAPI 金鑰。將兩者附加到你的 shell 設定檔（.zshrc 或 .bashrc），讓它們在不同工作階段中持續生效。Claude Code 會在啟動時讀取它們，並透過 RunAPI 路由每個請求。
在哪裡取得 Claude Code API key？
在 runapi.ai 建立一個帳戶。註冊後，開啟 Dashboard → API Keys，並產生一組金鑰。立即複製——完整金鑰只會在建立時顯示。免費方案包含額度，可在儲值餘額前測試任何 Claude 模型。
ANTHROPIC_BASE_URL 的用途是什麼？
它告訴 Claude Code 將請求傳送到哪個端點。預設情況下，Claude Code 直接呼叫 Anthropic。將其設定為 https://api.runapi.ai 後，每個請求都會改由 RunAPI 處理，以官方費率的 50% 計費相同的模型。
我可以將 Claude Code 搭配 OpenAI 等其他 API 提供者使用嗎？
有辦法將 Claude Code 搭配 OpenAI 等其他 API 提供者使用嗎？可以——Claude Code 透過 ANTHROPIC_BASE_URL 支援任何 OpenAI 相容端點。RunAPI 提供相容閘道，讓你可以使用同一組金鑰跨 Claude、GPT 和其他模型切換提供者，而不必變更程式碼。
為什麼 Claude Code 仍以完整費率計費？
在終端機執行 echo $ANTHROPIC_BASE_URL。如果沒有輸出任何內容，表示 export 沒有持續生效。將兩個 export 附加到 ~/.zshrc 或 ~/.bashrc，執行 source ~/.zshrc，然後開啟新的終端機再檢查一次。Windows 使用者在設定 env vars 後需要開啟新的 PowerShell 視窗。
我可以改把金鑰存放在設定檔中嗎？
可以。將這些值放在家目錄或專案目錄中的 .claude.json 檔案，而不是每個工作階段都匯出。兩種方式都可行——檔案適合每個專案使用不同金鑰，而 export 則較適合單一全域設定。
設定完成後，我要如何監控成本？
開啟 RunAPI 儀表板。它會即時顯示每組金鑰和每個請求的花費。若要限制輸出成本，請設定 CLAUDE_CODE_MAX_OUTPUT_TOKENS，讓每個回應受到限制，並使用 claude-haiku-4-5 處理例行編輯。
這會改變 Claude Code 的行為嗎？
不會。RunAPI 會將請求直接代理到背後的 Claude 模型。輸出、工具使用和行為都與直接呼叫 Anthropic 相同。你只改變請求送往的位置和計費方式——程式碼撰寫體驗維持不變。
相關內容
繼續探索
用兩個命令將 Claude Code 指向 RunAPI。
建立免費 RunAPI 帳戶，在你的 shell 設定檔中設定 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY，並在 Claude Code 中以官方 Anthropic 定價 50% 折扣執行每個 Claude 模型。