OpenRouter 是甚麼？為何可以替 Claude Code 換模型？
Claude Code 是 Anthropic 推出的 AI 編程助手，可以自行讀寫檔案、執行終端指令、幫你寫程式和除錯。它的設計分成兩層：
- 框架層：自主決策迴圈、工具調用、檔案操作、終端控制，這些是 Claude Code 本身的能力
- 模型層：背後負責思考的語言模型。按 Claude Code 官方文件，Pro、Max 和 API 用戶目前預設使用 Claude Opus 5.5
兩層之間透過標準 API 溝通，只要把 API 位址指向另一個相容的服務，框架就可以照常運作，背後的模型則可以換掉。OpenRouter 正是這類服務：一個 API Key 可以接入數百個不同供應商的模型，其中包括標示為「free」的免費模型。OpenRouter 亦有官方 Claude Code 接駁教學，本文的設定步驟以這份文件為準。
成本方面，Claude 官方的 Pro 方案每月 20 美元，Max 方案每月 100 美元起（Claude 官方價格頁），而免費版不包括 Claude Code。改用 OpenRouter 之後，你只需按實際用量付費，選免費模型更可以零成本試用。
香港用戶要先知道的地區限制
動手設定之前，香港讀者要先了解三件事：
- Anthropic 官方的支援地區名單並不包括香港和澳門。
- OpenRouter 服務條款寫明，部分模型供應商不准許位於某些國家或地區的用戶使用其模型，而且供應商可以隨時調整受限模型名單。換言之，經 OpenRouter 調用 Claude 系列模型，同樣受 Anthropic 的地區政策約束，有機會被拒絕或違反供應商條款。
- Claude Code 軟件本身受 Anthropic 標準條款規管，官方法律頁寫明不論經哪個平台使用都一樣。
所以本文的做法，是用 Claude Code 框架配搭 OpenRouter 上的非 Anthropic 模型（免費或低成本），並不教授任何繞過地區限制的方法。各平台條款會隨時修改，使用前請自行閱讀最新版本，以官方公佈為準。
OpenRouter 接 Claude Code 設定教學
整個設定只需要三個環境變數，不用額外安裝代理程式。以下步驟適用於 macOS 和 Linux，Windows 用戶可以用 WSL 或 PowerShell 版安裝指令。
步驟一至三：註冊、取得 API Key、安裝 Claude Code
- 註冊 OpenRouter：前往 openrouter.ai，按畫面指示建立帳戶，註冊免費。
- 建立 API Key：登入後進入帳戶設定的「Keys」頁面（openrouter.ai/settings/keys），按「Create Key」，複製以 sk-or- 開頭的 Key。這串 Key 只會完整顯示一次，請妥善保存，不要上載到 GitHub 或分享給別人。
- 安裝 Claude Code：打開終端機，輸入官方原生安裝指令（Windows PowerShell 的指令見 OpenRouter 官方教學）。
curl -fsSL https://claude.ai/install.sh | bash
下面這段影片是 MB 較早前錄製的設定示範，部分介面和步驟（例如 Antigravity）與本文最新步驟不同，實際設定請以本文為準。
步驟四至六：設定環境變數、登出舊帳戶、確認連線
- 設定環境變數：把以下四行加入 ~/.zshrc（用 bash 的話是 ~/.bashrc），把引號內的文字換成你的 OpenRouter API Key。
export OPENROUTER_API_KEY="你的 OpenRouter API Key"
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
export ANTHROPIC_API_KEY=""
- 重新載入並登出舊帳戶：儲存後輸入 source ~/.zshrc，或直接開一個新終端機。如果你以前用 Claude 帳戶登入過 Claude Code，啟動後先輸入 /logout，再關閉並重新啟動 claude，否則程式會繼續用舊的登入資料。
- 確認連線：在專案資料夾輸入 claude 啟動，再輸入 /status。畫面顯示 Auth token 為 ANTHROPIC_AUTH_TOKEN、Anthropic base URL 為 https://openrouter.ai/api，就代表已經接上 OpenRouter。
設定時最常見的三個錯誤：
- ANTHROPIC_API_KEY 必須明確設為空值（兩個引號中間沒有內容），不可以直接刪走，否則 Claude Code 可能改用 Anthropic 帳戶驗證。
- OPENROUTER_API_KEY 一定要寫在 ANTHROPIC_AUTH_TOKEN 那一行之前。官方文件提醒，順序調轉的話，Token 會變成空白，每個請求都會出現驗證錯誤。
- 不要把設定寫在 .env 檔，Claude Code 不會讀取它。只想在單一專案使用的話，可以在專案根目錄建立 .claude/settings.local.json，在 env 區塊填入同樣的值。
設定完成後，先用免費模型問一個簡單問題，再到 OpenRouter 的 Activity 頁面確認請求有被記錄，才開始處理真正的專案。
想在 VS Code 內使用？
Claude Code 有官方 VS Code 擴充套件，Cursor 等以 VS Code 為基礎的編輯器亦可以從擴充套件市場安裝。按官方 VS Code 文件，使用 OpenRouter 這類第三方服務時：
- 把上面的環境變數寫入 ~/.claude/settings.json 的 env 區塊，讓擴充套件和終端機版共用同一套設定。
- 在 VS Code 設定中勾選「Disable Login Prompt」，跳過 Anthropic 帳戶登入畫面。
如果擴充套件裝不到，也可以直接在編輯器的內置終端機輸入 claude，效果相同。
如何切換模型？
接上 OpenRouter 之後，Claude Code 內部仍然用 opus、sonnet、haiku 三個「模型位置」分配工作。你可以用環境變數指定每個位置實際用哪個 OpenRouter 模型：
export ANTHROPIC_DEFAULT_OPUS_MODEL="nvidia/nemotron-3-super-120b-a12b:free"
export ANTHROPIC_DEFAULT_SONNET_MODEL="cohere/north-mini-code:free"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="openrouter/free"
- 複製模型 ID：在 OpenRouter 模型頁面複製完整 ID，免費模型的 ID 以 :free 結尾。
- 寫入設定：把 ID 填入上面三個變數，存檔後重新載入終端機。
- 隨時切換：在 Claude Code 內輸入 /model 開啟選單，或輸入 /model 加上模型名稱即時切換；啟動時亦可以用 claude –model 指定該次使用的模型。
- 開啟模型選單：加入 export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 之後，/model 選單會列出 OpenRouter 上的模型。
注意：舊版教學流傳的「/model openrouter,模型名稱」寫法，屬於另一個第三方工具 Claude Code Router 的格式，直接接 OpenRouter 時不適用，照輸入會出錯。
想切回 Claude 官方帳戶，只要把上述環境變數刪除、重新載入終端機，再用 /login 登入即可。
目前可用的免費模型（2026 年 10 月 6 日更新）
OpenRouter 的免費模型名單變化很快，2026 年上半年仍然有人推薦的 DeepSeek 免費版，目前已經不在免費清單之內，DeepSeek 系列只剩付費版本。以下名單取自 2026 年 10 月 6 日 OpenRouter 官方模型 API，只列出支援工具調用（Claude Code 必需）的模型：
| 模型 ID | 特點 | 適合用途 |
|---|---|---|
| openrouter/free | 官方免費路由器，按請求需要的功能（例如工具調用）自動挑選一個免費模型 | 新手第一次測試，不用自己選模型 |
| cohere/north-mini-code:free | Cohere 首個 Agent 編程模型，256K 上下文 | 寫程式、改 bug |
| nvidia/nemotron-3-super-120b-a12b:free | 1,200 億參數，官方定位為多 Agent 應用 | 較複雜的多步任務 |
| google/gemma-4-31b-it:free | Google DeepMind 開源模型，支援函數調用和圖片輸入，256K 上下文 | 一般編程和文字處理 |
| poolside/laguna-s-2.1:free | 編程模型，但 OpenRouter 標示 2026 年 10 月 31 日下架 | 只適合短期試用 |
免費模型名單每隔數星期就會變動，用之前請到 OpenRouter 免費模型頁 確認模型仍然在列。如果某個模型突然報錯，最簡單的做法是改用 openrouter/free，讓路由器替你挑選。
OpenRouter 的條款亦提到，部分供應商在某些地區不提供服務，所以你在模型頁看到的名單，有機會與上表不同，以你帳戶實際顯示為準。
免費額度有多少？每日用量限制
按 OpenRouter 官方限制文件，所有以 :free 結尾的模型受以下上限約束：
| 帳戶狀態 | 每分鐘請求上限 | 每日請求上限 |
|---|---|---|
| 累計購買少於 10 個 credits | 20 次 | 50 次 |
| 累計購買 10 個 credits 或以上 | 20 次 | 1,000 次 |
幾點要留意：
- 每日上限按整個帳戶計算，不是每個模型各自計算，於 UTC 午夜（香港時間早上 8 時）重設。
- 只要累計買過 10 個 credits，即使之後餘額用完，每日 1,000 次的上限仍然保留。使用免費模型不會扣除這筆餘額。
- Claude Code 完成一個任務，往往要連續發出多個請求（讀檔、改檔、執行指令各算一次），所以每日 50 次的額度很快用完。打算經常使用的話，先儲值 10 美元會實際得多。
不同用途應該選哪個模型？
- 學習和體驗：用 openrouter/free 或上表的免費模型，零成本了解 Claude Code 的工作方式。
- 個人專案：考慮 OpenRouter 上的低價付費模型，例如 deepseek/deepseek-v4-flash、z-ai/glm-5.3-flash、minimax/minimax-m3、qwen/qwen3-coder-next。按 2026 年 10 月 6 日官方清單，這幾個模型在主要供應商的輸入價大多約每百萬 token 0.1 至 0.3 美元，以模型頁即時顯示為準。
- 專業開發：工作代碼質素直接影響收入的話，修正錯誤所花的時間，可能比工具費用更貴，官方 Claude 方案或 Claude 原生模型仍然是較穩定的選擇。作為參考，OpenRouter 上 Claude Sonnet 5.5 的標價為每百萬輸入 token 2 美元、輸出 10 美元，但要留意上文提到的地區限制。
- 混合配置：把需要深入思考的 opus 和 sonnet 位置設為較強的模型，把處理簡單工作的 haiku 位置設為 openrouter/free，可以在質素和成本之間取得平衡。
設定好之後，如果你想讓 AI 助理處理更多日常工作，可以參考 Openclaw 龍蝦 AI 新手指南。
免費使用的四個取捨
零成本確實可行，但你要清楚背後的代價：
- 效能差距：免費模型生成的代碼出錯率一般較高。OpenRouter 官方文件亦提醒，Claude Code 是為 Anthropic 模型而優化，配搭其他模型時可能出現不正常的情況。學生或業餘開發者影響不大，但如果你按時間收費，多花在修正上的時間就是隱性成本。
- 工具調用不穩定：Claude Code 依賴模型按固定格式調用工具。部分替代模型偶爾會格式出錯，令操作失敗要重試；單步任務影響不大，連續多步的任務則較易中斷。
- 用量和速度限制：免費模型有每日次數上限，繁忙時段可能排隊或暫時無法使用，而且名單隨時變動，上星期可用的模型，這星期可能已經下架。
- 數據經過第三方：你的代碼會經 OpenRouter 轉送到模型供應商。OpenRouter 表示，除非你在帳戶設定主動開啟記錄，否則不會記錄你的提示內容；但部分免費模型的供應商可能會用輸入內容訓練模型，OpenRouter 的私隱設定對免費和付費模型分開控制。個人專案問題不大，公司專有代碼或敏感資料則不建議經免費模型處理。
另外一個實用提示：按 Claude Code 官方數據文件，Claude Code 的網頁擷取功能（WebFetch）在擷取網址前，會先把網域名稱送到 api.anthropic.com 做安全檢查，這一步不論你用哪個模型供應商都會執行。如果你的網絡連不上該網域，網頁擷取就會失敗，官方提供的處理方法是在 settings.json 加入 skipWebFetchPreflight: true，但這樣會同時關閉安全黑名單檢查。
想進一步了解 AI Agent 如何與加密市場結合，可以閱讀 AI Agent 經濟完整解析。
常見問題
OpenRouter 真的可以免費使用嗎？
可以。以 :free 結尾的模型不收費，帳戶零餘額亦可使用，但每日只有 50 次請求；累計購買 10 個 credits 之後，每日上限提升至 1,000 次。付費模型則按實際 token 用量收費。
香港可以用 OpenRouter 接 Claude Code 嗎？
技術上，設定步驟與其他地區相同。但 Anthropic 的官方支援地區不包括香港，OpenRouter 條款亦寫明部分供應商限制某些地區的用戶，因此經 OpenRouter 調用 Claude 系列模型有機會被拒或違反條款。本文建議配搭非 Anthropic 的免費或低成本模型，並在使用前自行閱讀各平台最新條款。
為甚麼照舊教學設定 DeepSeek 免費模型會失敗？
因為 DeepSeek 的免費版已經不在 OpenRouter 免費清單之內，舊教學的模型 ID 已失效。另外，「/model openrouter,模型名稱」是 Claude Code Router 的寫法，直接接 OpenRouter 時應該用完整模型 ID，或用 ANTHROPIC_DEFAULT_SONNET_MODEL 等環境變數指定。
切換模型後，對話記錄會不會消失？
不會。Claude Code 把對話記錄以純文字形式儲存在你電腦的 ~/.claude/projects/ 資料夾，預設保留 30 天，與你用哪個模型無關。
輸入 /status 仍然顯示 Claude 帳戶，應該怎樣處理？
代表環境變數沒有傳到 Claude Code。先確認 ANTHROPIC_API_KEY 已設為空值，重新載入終端機，然後在 Claude Code 內輸入 /logout，關閉後再重新啟動。如果你用 macOS 而問題持續，舊的登入資料可能仍然留在鑰匙圈，官方文件有教如何清除。
下一步
建議先用 openrouter/free 跑一個小專案，確認 AI 編程助手真的能提升你的效率，再決定是否儲值或升級到付費模型。最適合你的工具，不一定最貴，也不一定最便宜，而是最能解決你手上問題的那一個。
免費模型名單每隔數星期就會變動，MB 會定期更新本文。如果你想知道最新可用的模型和設定技巧，歡迎加入我們的社群交流，亦可以閱讀 GPT Image 2.5 完整解析，了解另一個熱門 AI 工具的用法。
網站聲明
本文內容僅供參考，投資人應獨立判斷，審慎投資，並自負風險，本文不提供或嘗試遊說觀眾做交易或投資之依據，內容僅用於分享目的，不應視為投資建議，亦不代表 Monsterblockhk 觀點和立場，所有資訊及看法為特定日期所為之判斷具時效性。此外，如在本網站中有任何內容涉及尚未於香港取得虛擬資產交易平台經營牌照的虛擬資產交易平台，包括但不限於文字介紹、圖片、優惠、活動等，均只提供予香港特別行政區以外地區的用戶。
根據香港《2022 年打擊洗錢及恐怖分子資金籌集（修訂）條例》，在 2023 年 6 月 1 日後，所有於香港經營業務或向香港投資者積極推廣其服務之中央虛擬資產交易平台，將須獲香港證監會發牌並受其監管，任何相關無牌活動乃屬刑事罪行。如用戶欲了解法例詳情和細節，可查詢香港證監會網頁。