已安裝 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 使用方式完全相同。
逐步說明
如何使用 RunAPI 設置 Claude Code API key
按順序運行這些命令。它們設置端點和密鑰，將其持久化到 Shell 配置文件，並確認 Claude Code 能夠讀取它們。將佔位符替換為你的真實 RunAPI 密鑰。
1
設置 base 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 Unauthorized | 錯誤或過期的 API key | 重新檢查 ANTHROPIC_API_KEY，如有需要在 RunAPI Dashboard 中創建新密鑰 |
| 請求仍發送到 Anthropic | 此 Shell 中未設置 ANTHROPIC_BASE_URL | 運行 echo $ANTHROPIC_BASE_URL；如果為空，重新加載你的配置文件或打開新終端 |
| 404 Not Found | base URL 中有尾部斜杠或錯誤路徑 | 將 base URL 精確設置為 https://api.runapi.ai，不帶任何尾部路徑 |
| 找不到模型 | 無效或拼寫錯誤的模型 ID | 使用有效的 ID，如 claude-sonnet-4-6 或 claude-opus-4-7 |
| 重啟後變量丟失 | 導出命令未寫入 Shell 配置文件 | 將兩個導出命令追加到 ~/.zshrc 或 ~/.bashrc，並重新加載 |
快速版本
四個步驟完成 Claude Code API key 設置
1
設置 base 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 FAQ
如何向 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 仍然按全價計費？
base URL 可能未在你的當前 Shell 中設置。運行 echo $ANTHROPIC_BASE_URL——如果為空，說明導出沒有持久化。將其追加到 ~/.zshrc 或 ~/.bashrc，使用 source 重新加載，然後打開新終端再次檢查。
我可以將密鑰存儲在配置文件中嗎？
可以。將值放在主目錄或項目目錄的 .claude.json 文件中，而無需每次會話都導出它們。兩種方式均可使用；文件更適合按項目設置密鑰，而導出更適合單一全局設置。
設置後如何監控費用？
打開 RunAPI Dashboard。它實時顯示每個密鑰和每個請求的消費。要控制輸出費用，設置 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 模型。