已安裝 Claude Code
從官方來源安裝 Claude Code，並在終端機用 claude --version 確認可運行。如果該指令報錯，請先修復安裝，再設定任何 API keys。
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 values，每個請求都會透過 RunAPI 路由並享 50% off。想完全使用不同 provider？RunAPI 亦可作為 drop-in gateway，讓你無需直接 Anthropic 帳戶也能運行 Claude 模型。
兩個變量
ANTHROPIC_BASE_URL 設定端點。ANTHROPIC_API_KEY 設定 key。這就是全部 config — 兩個變數，無需其他更改。
端點值
將 ANTHROPIC_BASE_URL 設定為 https://api.runapi.ai，使 Claude Code 透過 RunAPI 路由。
持久化設置
將兩個 exports 加到你的 shell profile（.zshrc 或 .bashrc），就不用每個 session 重新設定。Windows 用戶在 PowerShell 設定它們並開啟新視窗。
50% 折扣
每個 Claude 模型均以官方 Anthropic 費率的一半計費。無需訂閱，無上限。
開始之前
配置 Claude Code 之前需要什麼？
設定只需幾分鐘。你需要已安裝 Claude Code、一個 RunAPI 帳戶，以及一個終端機。先執行 claude --version 確認 Claude Code 正常運作，再處理任何 API key 設定。
RunAPI 帳戶
在 runapi.ai 註冊。免費方案包含在充值餘額之前測試任何 Claude 模型的積分。
API key
從 Dashboard → API Keys 建立一個 key。只複製一次 — 完整內容只會在建立時顯示。不要將它貼到公開 repos，或在截圖中分享。
終端訪問
你需要 shell 來設定環境變數。macOS 和 Linux 使用 .zshrc 或 .bashrc。Windows 用戶可以使用 PowerShell — 設定變數後，開啟新的終端機視窗讓它生效。
逐步說明
如何使用 RunAPI 設置 Claude Code API key
按次序執行以下指令。它們會設定端點和 key、將它們持續儲存到你的 shell profile，並確認 Claude Code 能讀取。將 placeholder 換成你真正的 RunAPI key。使用 ANTHROPIC_API_KEY（而非 CLAUDE_API_KEY）— 這才是 Claude Code 實際讀取的變數。
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
持久化兩個變量
將兩個 exports 加入 ~/.zshrc（或 ~/.bashrc），讓它們在新的終端機 session 中仍然生效。用 source ~/.zshrc 重新載入。在 Windows 上，請在 PowerShell 設定它們並開啟新的終端機視窗，讓更改生效。
echo 'export ANTHROPIC_BASE_URL=https://api.runapi.ai' >> ~/.zshrc
4
驗證配置
確認變數會印出 RunAPI URL。如果是空白，請重新載入你的 shell profile 或開啟新的終端機 — 在一個 session 設定的變數不會自動延續到另一個 session。
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 model 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% off。
修復常見錯誤
為什麼我的 Claude Code API key 不起作用？
大多數設定問題來自三件事之一：env var 名稱錯誤（使用 ANTHROPIC_API_KEY，而不是 CLAUDE_API_KEY）、尚未讀取 profile 更改的舊 shell session，或 key 有 typo。表格列出常見錯誤及各自修正方法。
| 錯誤或症狀 | 可能原因 | 解決方法 |
|---|---|---|
| 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
持久化兩個變量
將兩個 exports 加入 ~/.zshrc 或 ~/.bashrc，並用 source ~/.zshrc 重新載入，讓它們在新 session 仍然生效。在 Windows 上，請在 PowerShell 設定它們並開啟新的終端機視窗。
4
運行 Claude Code
執行 claude --version 確認安裝，然後在你的專案中啟動 claude。請求現在會透過 RunAPI 路由，享官方價格 50% off。
常見問題
Claude Code API Key FAQ
如何向 Claude Code 添加 API key？
設定兩個環境變數。將 ANTHROPIC_BASE_URL export 到 https://api.runapi.ai，並將 ANTHROPIC_API_KEY export 到你的 RunAPI key。把兩者加入你的 shell profile（.zshrc 或 .bashrc），讓它們在不同 session 間持續生效。Claude Code 啟動時會讀取它們，並透過 RunAPI 路由每個請求。
從哪裡獲取 Claude Code API key？
在 runapi.ai 建立一個。註冊、打開 Dashboard → API Keys，然後產生一個 key。立即複製 — 完整 key 只會在建立時顯示。免費層級包含 credits，可在你充值餘額前測試任何 Claude 模型。
ANTHROPIC_BASE_URL 有什麼用？
它告訴 Claude Code 將請求發送到哪個端點。默認情況下，Claude Code 直接呼叫 Anthropic。將其設定為 https://api.runapi.ai 後，每個請求都會透過 RunAPI 路由，以官方費率的 50% 計費相同的模型。
我可以用 Claude Code 配合 OpenAI 等其他 API providers 嗎？
有冇方法用 Claude Code 配合 OpenAI 等其他 API providers？有 — Claude Code 透過 ANTHROPIC_BASE_URL 支援任何 OpenAI-compatible endpoint。RunAPI 提供相容 gateway，讓你可在不改動程式碼的情況下切換 providers，並用一個 key 存取 Claude、GPT 及其他模型。
為甚麼 Claude Code 仍然按全價收費？
在終端機執行 echo $ANTHROPIC_BASE_URL。如果沒有輸出，代表 export 沒有持續生效。將兩個 exports 加入 ~/.zshrc 或 ~/.bashrc，執行 source ~/.zshrc，然後開新終端機再檢查一次。Windows 用戶在設定 env vars 後需要開啟新的 PowerShell 視窗。
我可以將 key 儲存在 config file 入面嗎？
可以。將數值放入家目錄或專案目錄中的 .claude.json 檔案，而不是每個 session 都 export。兩種方法都可行 — 檔案適合每個專案使用不同 key，而 exports 對單一全域設定較簡單。
設定後如何監察成本？
打開 RunAPI dashboard。它會即時顯示每個 key 和每個請求的支出。要限制輸出成本，請設定 CLAUDE_CODE_MAX_OUTPUT_TOKENS，讓每個回應受限，並使用 claude-haiku-4-5 處理日常修改。
這會改變 Claude Code 的行為嗎？
不會。RunAPI 會直接將請求代理到背後的 Claude 模型。輸出、工具使用和行為都與直接呼叫 Anthropic 完全相同。你只改變請求送往哪裏，以及如何計費 — 編程體驗保持不變。
相關內容
繼續探索
用兩個命令將 Claude Code 指向 RunAPI。
建立免費 RunAPI 帳戶，在你的 shell profile 中設定 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY，並以官方 Anthropic 定價 50% off 在 Claude Code 中運行每個 Claude 模型。