# 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 values，每個請求都會透過 RunAPI 路由並享 50% off。想完全使用不同 provider？RunAPI 亦可作為 drop-in gateway，讓你無需直接 Anthropic 帳戶也能運行 Claude 模型。

- **兩個變量**: ANTHROPIC_BASE_URL 設定端點。ANTHROPIC_API_KEY 設定 key。這就是全部 config — 兩個變數，無需其他更改。
- **端點值**: 將 ANTHROPIC_BASE_URL 設定為 https://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 設定。

### 已安裝 Claude Code

從官方來源安裝 Claude Code，並在終端機用 claude --version 確認可運行。如果該指令報錯，請先修復安裝，再設定任何 API keys。

### 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 實際讀取的變數。

## 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 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://runapi.ai，不帶任何尾部路徑 |
| 找不到模型 | 無效或拼寫錯誤的模型 ID | 使用有效的 ID，如 claude-sonnet-4-6 或 claude-opus-4-7 |
| 重啟後變量丟失 | 導出命令未寫入 Shell 配置文件 | 將兩個導出命令追加到 ~/.zshrc 或 ~/.bashrc，並重新加載 |

## 如何使用 RunAPI 設置 Claude Code API key

1. **設置 base URL** — 導出 ANTHROPIC_BASE_URL=https://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://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://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 完全相同。你只改變請求送往哪裏，以及如何計費 — 編程體驗保持不變。