# Claude Code API Key 設定

Claude Code 會讀取兩個環境變數來將請求路由到任何位置：ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY。將它們指向 RunAPI，即可以官方費率的一半執行每個 Claude 模型。本指南會示範 Mac、Linux 和 Windows 的確切指令。

*Updated 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://runapi.ai，使 Claude Code 透過 RunAPI 路由。
- **持久化設定**: 將兩個 export 加到你的 shell 設定檔（.zshrc 或 .bashrc），這樣你就不必每個工作階段都重新設定。Windows 使用者請在 PowerShell 中設定，並開啟新視窗。
- **50% 折扣**: 所有 Claude 模型以官方 Anthropic 費率一半計費。無訂閱，無上限。

## 設定 Claude Code 之前需要什麼？

設定只需幾分鐘。你需要已安裝 Claude Code、RunAPI 帳戶和終端機。請先執行 claude --version 確認 Claude Code 可正常運作，再處理任何 API 金鑰設定。

### 已安裝 Claude Code

從官方來源安裝 Claude Code，並在終端機中用 claude --version 確認可執行。如果該指令發生錯誤，請先修正安裝，再設定任何 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 實際讀取的變數。

## Claude Code 讀取哪些環境變數？

Claude Code 會讀取一小組變數來控制端點、驗證、模型和輸出長度。表格列出自訂端點設定中重要的變數，以及各自的作用。注意：請使用 ANTHROPIC_API_KEY（不是 CLAUDE_API_KEY）——這才是 Claude Code 實際讀取的變數。

| 變數 | 用途 | 範例值 |
|---|---|---|
| ANTHROPIC_BASE_URL | Claude Code 傳送請求的自訂端點 | https://runapi.ai |
| ANTHROPIC_API_KEY | 用於驗證請求的金鑰 | sk-your-runapi-key |
| ANTHROPIC_MODEL | 新作業的預設模型 | claude-sonnet-4-6 |
| CLAUDE_CODE_MAX_OUTPUT_TOKENS | 每次回應的 token 上限 | 8192 |

## 在 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://runapi.ai，不帶任何尾斜線或路徑 |
| 找不到模型 | 模型 ID 無效或拼寫錯誤 | 使用有效 ID，如 claude-sonnet-4-6 或 claude-opus-4-7 |
| 重新啟動後變數消失 | 匯出未寫入 shell 設定檔 | 將兩個匯出追加到 ~/.zshrc 或 ~/.bashrc 並重新載入 |

## 如何設定 Claude Code API key 與 RunAPI

1. **設定基礎 URL** — 匯出 ANTHROPIC_BASE_URL=https://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://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://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 相同。你只改變請求送往的位置和計費方式——程式碼撰寫體驗維持不變。