余小章 @ 大內殿堂

開發環境

• Windows 11 Pro
• WSL2 + Ubuntu 24.04
• Claude Code 1.0.113

---

安裝與設定

1. 安裝 Claude Code 與 Claude Code Router

npm install -g @anthropic-ai/claude-code
npm install -g @musistudio/claude-code-router

2. 建立設定檔

CCR 的設定檔預設放在：

~/.claude-code-router/config.json

 

以下是我串接 OpenRouter 與 DeepSeek 的範例：

{
  "LOG": false,
  "LOG_LEVEL": "debug",
  "CLAUDE_PATH": "",
  "HOST": "127.0.0.1",
  "PORT": 3456,
  "APIKEY": "9527",
  "API_TIMEOUT_MS": "600000",
  "PROXY_URL": "",
  "transformers": [],
  "Providers": [
    {
      "name": "openrouter",
      "api_base_url": "https://openrouter.ai/api/v1/chat/completions",
      "api_key": "sk-or-v1-xxxxxx",
      "models": [
        "deepseek/deepseek-chat-v3.1:free",
		"deepseek/deepseek-r1-0528:free",
		"qwen/qwen3-32b",
		"qwen/qwen3-235b-a22b:free",
		"google/gemma-3-27b-it:free"
      ],
      "transformer": {
        "use": [
          "openrouter"
        ]
      }
    }
  ],
  "StatusLine": {
    "enabled": false,
    "currentStyle": "default",
    "default": {
      "modules": []
    },
    "powerline": {
      "modules": []
    }
  },
  "Router": {
    "default": "openrouter,deepseek/deepseek-chat-v3.1:free",
    "background": "openrouter,deepseek/deepseek-chat-v3.1:free",
    "think": "openrouter,deepseek/deepseek-chat-v3.1:free",
    "longContext": "openrouter,deepseek/deepseek-chat-v3.1:free",
    "longContextThreshold": 60000,
    "webSearch": "openrouter,deepseek/deepseek-chat-v3.1:free",
    "image": "openrouter,deepseek/deepseek-chat-v3.1:free"
  },
  "CUSTOM_ROUTER_PATH": ""
}

---

啟動 Claude Code Router

ccr code

這會啟動 Claude Code，但背後的 API 請求會先經過 CCR，再依照 Router 規則轉送到對應的模型。

NOTE：如果一直無法啟動，可以試著重啟 WSL。

 

啟動畫面如下：

---

使用 UI 模式

CCR 提供 Web UI 方便編輯設定檔：

ccr ui

打開後可以直接在瀏覽器調整 Providers 與 Router 規則，省去手動改 JSON 的麻煩。

 

介面操作也蠻簡單

---

OpenRouter 使用方式

申請 API Key

1. 到 OpenRouter 官網 註冊帳號
2. 進入 API Keys 頁面建立金鑰
3. 在 CCR 設定檔的 api_key 欄位填入

模型選擇

OpenRouter 支援多家模型，包括：

• Anthropic Claude 系列
• Google Gemini 系列
• DeepSeek
• Qwen
• 甚至部分免費模型（每日請求次數有限制）

搜尋 free 關鍵字可以找到免費模型，適合測試或低成本應用。

---

實測與注意事項

1. Router 規則

• default：一般任務用的模型
• think：推理型任務（例如程式碼分析、規劃）
• longContext：長上下文任務（> 60K tokens）
• background：背景任務，可用便宜或本地模型節省成本

2. 模型切換

在 Claude Code 介面輸入：

/model openrouter,google/gemini-2.5-pro-preview

即可即時切換模型。

3. 常見坑

• API Key 錯誤：OpenRouter 與其他 Provider 的金鑰不能混用
• Proxy 設定：若地區限制，需設定 PROXY_URL
• 免費模型限制：OpenRouter 免費模型有每日次數與速率限制，超過會回 429

免費模型有次數上的限制，當超過限制會出現，下段描述，

free-models-per-day. Add 10 credits to unlock 1000 free model requests per day

---

心得

Claude Code Router 對我來說最大的價值是：

• 統一介面：不用切換不同 CLI 或 SDK
• 彈性路由：依任務自動選擇最適合的模型
• 成本優化：背景任務用便宜模型，免費模型的計費方式是用次，而不是 Token；重點任務切換到高階模型

對開發者來說，這就像在 Claude Code 上加了一層「智慧 API 交換機」，讓我們能在同一套工作流程中，靈活調度多家 LLM 資源。

若有謬誤，煩請告知，新手發帖請多包涵

Microsoft MVP Award 2010~2017 C# 第四季
Microsoft MVP Award 2018~2022 .NET