已安裝 Claude Code
從官方來源安裝 Claude Code，並確認它可以在你的終端中透過 claude 命令執行。
Claude Code
Claude Code API Key 設定
Claude Code 讀取兩個環境變數來決定請求路由：ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY。將它們指向 RunAPI，以官方費率一半運行所有 Claude 模型。本指南提供確切的命令。
更新於 June 18, 2026
RunAPI Editorial
一覽
如何在 Claude Code 中設定自訂 API key？
Claude Code 使用兩個環境變數來決定請求的去向和驗證方式。將它們設定為 RunAPI 的值，每個請求都會以官方費率 50% 透過 RunAPI 路由。以下卡片涵蓋完整說明前的要點。
兩個變數
ANTHROPIC_BASE_URL 設定端點。ANTHROPIC_API_KEY 設定金鑰。這就是整個設定。
端點值
將 ANTHROPIC_BASE_URL 設定為 https://api.runapi.ai，使 Claude Code 透過 RunAPI 路由。
持久化設定
將兩個匯出新增到 shell 設定檔或 .claude.json，這樣就不需要每次作業都重新設定。
50% 折扣
所有 Claude 模型以官方 Anthropic 費率一半計費。無訂閱，無上限。
開始之前
設定 Claude Code 之前需要什麼？
設定只需幾分鐘。你需要安裝 Claude Code、一個 RunAPI 帳戶和一個終端。以下清單涵蓋了執行第一個命令之前所需的一切。
RunAPI 帳戶
在 runapi.ai 註冊。免費方案包含點數，可在儲值前測試任何 Claude 模型。
API key
從 Dashboard → API Keys 建立一個金鑰。立即複製——完整金鑰僅在建立時顯示一次。
終端存取
你需要 shell 來設定環境變數。macOS、Linux 和 Windows 上的 WSL 使用方式相同。
逐步說明
如何設定 Claude Code API key 與 RunAPI
按順序執行這些命令。它們設定端點和金鑰，將其持久化到 shell 設定檔，並確認 Claude Code 正確讀取它們。將佔位符替換為你的實際 RunAPI 金鑰。
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
持久化兩個變數
將兩個匯出追加到 ~/.zshrc（或 ~/.bashrc），使其在新終端作業中持久有效。使用 source ~/.zshrc 重新載入。
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_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。根據任務選擇：快速廉價的模型用於日常編輯，均衡的用於日常程式碼撰寫，或最強的用於困難問題。
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 無法使用？
大多數設定問題來自變數未設定、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
持久化兩個變數
將兩個匯出追加到 ~/.zshrc 或 ~/.bashrc 並重新載入，使其在新作業中持久有效。
4
執行 Claude Code
在你的專案中啟動 claude。請求現在以官方費率 50% 透過 RunAPI 路由。
常見問題
Claude Code API Key 常見問題
如何在 Claude Code 中新增 API key？
設定兩個環境變數。將 ANTHROPIC_BASE_URL 匯出為 https://api.runapi.ai，將 ANTHROPIC_API_KEY 匯出為你的 RunAPI 金鑰。將兩者新增到你的 shell 設定檔中以使其永久生效。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 仍以全額費率計費？
基礎 URL 可能未在你目前的 shell 中設定。執行 echo $ANTHROPIC_BASE_URL——如果為空，表示匯出未持久化。將其新增到 ~/.zshrc 或 ~/.bashrc，使用 source 重新載入，然後開啟新終端再次確認。
我可以將金鑰儲存在設定檔中嗎？
可以。將值放在主目錄或專案目錄下的 .claude.json 檔案中，而不是每次作業都匯出。兩種方式都有效；檔案更適合每個專案使用不同金鑰，而匯出對於單一全域設定更簡單。
設定完成後如何監控費用？
開啟 RunAPI 儀表板。它即時顯示每個金鑰和每個請求的消費。要限制輸出費用，設定 CLAUDE_CODE_MAX_OUTPUT_TOKENS 以限制每次回應長度，並對日常編輯選擇較便宜的模型，如 Haiku。
這會改變 Claude Code 的行為嗎？
不會。RunAPI 直接將請求代理到底層 Claude 模型。輸出、工具使用和行為與預設設定完全相同。你只改變請求的去向和計費方式——程式碼撰寫體驗保持不變。
我應該將哪個模型設為預設？
大多數開發者將 ANTHROPIC_MODEL 設定為 claude-sonnet-4-6 用於日常程式碼撰寫。對於快速廉價的編輯使用 claude-haiku-4-5，對於困難的重構使用 claude-opus-4-7。你可以隨時在 Claude Code 中切換模型，計費跟隨你呼叫的模型。
用兩個命令將 Claude Code 指向 RunAPI。
建立免費 RunAPI 帳戶，設定 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY，以 Anthropic 官方定價的 50% 在 Claude Code 中運行所有 Claude 模型。