想用 Claude Code 搭配 OpenRouter 使用 OX Alpha？本文教你建立 API Key、設定環境變數與專案級參數，並用 GUI 一鍵切換與驗證請求。
先認識 OX Alpha
OX Alpha 是透過 OpenRouter 上架的模型，識別碼為 stealth/ox-alpha。它的定位是長程 agentic coding 與 production workload，支援文字、圖片與影片輸入，內容視窗為 1,048,576 token，最大輸出為 131,072 token。目前 OpenRouter 標示為 $0 / M input、$0 / M output，但這可能是 preview 期間的促銷方案，正式定價仍以 OpenRouter 官方頁面為準。
Claude Code 原生設計是接 Anthropic API。只要把 API 端點改到 OpenRouter，並在環境變數指定模型，就能讓 Claude Code 把請求轉送到 stealth/ox-alpha。
準備工作：取得 OpenRouter API Key
- 前往 OpenRouter 網站註冊，可使用 GitHub 或 Google 登入。
- 進入 Settings → Keys。
- 點擊「Create new key」建立一組 API Key。
- 複製金鑰，格式通常為
sk-or-v1-...。
請不要把這個 Key 寫進公開 repo、聊天室或畫面錄製中。
方式一：手動設定環境變數
步驟 1：加入環境變數
把下面內容加到你的 shell profile（~/.zshrc、~/.bashrc 或 ~/.config/fish/config.fish）：
export OPENROUTER_API_KEY="sk-or-v1-YOUR_KEY_HERE"
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
export ANTHROPIC_API_KEY=""
export ANTHROPIC_DEFAULT_OPUS_MODEL="stealth/ox-alpha"
export ANTHROPIC_DEFAULT_SONNET_MODEL="stealth/ox-alpha"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="stealth/ox-alpha"
export CLAUDE_CODE_SUBAGENT_MODEL="stealth/ox-alpha"
修改後載入設定：
source ~/.zshrc
# 或 source ~/.bashrc
各變數用途
ANTHROPIC_BASE_URL：必須是https://openrouter.ai/api，不要再加上/v1。/v1是 OpenAI-compatible 端點，Claude Code 的 Anthropic 協定不會用到。ANTHROPIC_AUTH_TOKEN：填入 OpenRouter API Key。ANTHROPIC_API_KEY：設為空字串，避免與 Anthropic 官方認證衝突。ANTHROPIC_DEFAULT_*_MODEL：把 Claude Code 預設的 Opus / Sonnet / Haiku 模型槽全部指向stealth/ox-alpha。CLAUDE_CODE_SUBAGENT_MODEL：讓 subagent 任務也使用相同模型，避免部分請求跑到 Anthropic 官方。
步驟：登出 Anthropic 官方登入狀態
如果你之前用 Anthropic 帳號登入過 Claude Code，先登出：
claude /logout
然後完全重啟 terminal，或重新載入 shell profile。
步驟：驗證設定是否生效
切到你的專案資料夾，啟動 Claude Code：
cd /path/to/project
claude
在 Claude Code 對話視窗輸入：
/status
確認 base URL 顯示 https://openrouter.ai/api。
接著輸入：
/model
確認目前模型是否指向 stealth/ox-alpha。即使 /model 沒有直接顯示，也可以到 OpenRouter 後台確認。
方式二：專案層級設定
如果只想在特定專案使用 OX Alpha，不要改全域環境變數，改在專案根目錄建立 .claude/settings.local.json：
{
"env": {
"ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
"ANTHROPIC_AUTH_TOKEN": "sk-or-v1-YOUR_KEY_HERE",
"ANTHROPIC_API_KEY": "",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "stealth/ox-alpha",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "stealth/ox-alpha",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "stealth/ox-alpha"
}
}
這個方式不會影響其他專案與全域設定，適合測試或團隊協作。
方式三：macOS 用 CC Switch 一鍵切換
不想手動維護 .zshrc 的人，可以改用 CC Switch，它是支援 Claude Code、Codex、OpenCode 的桌面管理工具，也可以用 GUI 切換 API 供應商。
安裝 CC Switch
使用 Homebrew：
brew install --cask cc-switch
也可以到 CC Switch 的 GitHub Releases 下載 .dmg，拖入 Applications 資料夾。第一次開啟若被 macOS Gatekeeper 攔截，到「系統設定 → 隱私與安全性」點「仍要打開」。
設定 OpenRouter + OX Alpha
- 開啟 CC Switch，左側選擇「Claude Code」面板。
- 點擊新增供應商，選擇 OpenRouter，或自訂 Provider。
- 貼上 API Key（
sk-or-v1-...）。 - 展開 Advanced Options，將 Default Opus Model、Default Sonnet Model、Default Haiku Model 都設為
stealth/ox-alpha。 - 回到主介面，選中新增的設定並點擊 Enable。
- 重啟終端機。
驗證方式一樣：
claude
/status
CC Switch 也支援供應商快速切換、token 用量統計、MCP/Skills 管理，適合需要頻繁往返 OpenRouter 與 Anthropic 官方的人。
如何確認請求真的送到 OX Alpha
最可靠的方式是登入 OpenRouter 後台，進入 Activity 頁面，逐一查看每筆請求的 model 欄位是否為 stealth/ox-alpha。
如果要在 Claude Code 內切換更多 OpenRouter 模型，可以設定：
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1
這會啟用 gateway model discovery，讓 Claude Code 有機會探索 OpenRouter 支援的模型。
注意事項與限制
- 相容性：Claude Code 官方只保證與 Anthropic 自家模型完全相容。改用 OX Alpha 這類第三方模型，tool calling 行為可能與 Anthropic 原生模型不同，多元 agentic workflow 需要實測。
- 定價可能變動：OX Alpha 目前顯示為免費，但這是 preview 期間的促銷條件，之後可能調整計費方式。
- 隱私與資料使用：根據 OpenRouter 對 provider 的標示，目前不提供使用 prompts/completions 訓練模型。將來政策可能變更，建議使用前自行確認。
- 環境變數快取：如果
/status仍顯示 Anthropic 官方端點，請重新啟動 terminal 再測試。
結論
要在 Claude Code 使用 OX Alpha，核心就是把 ANTHROPIC_BASE_URL 指向 OpenRouter，並把模型指定的 stealth/ox-alpha。你可以透過 shell profile 設定全域改用，也可以用 .claude/settings.local.json 處理專案層級，或使用 CC Switch 一鍵切換。設定完成後，請用 /status、 /model，以及 OpenRouter Activity 頁面確認請求實際路由。