Claude Code Router實現(xiàn)一鍵接入多種AI模型的智能路由器
我要評論什么是Claude Code Router？
Claude Code Router是一款革命性的開源代理工具，專為解決AI模型平臺鎖定問題而生。它作為Claude Code CLI與各大AI模型供應(yīng)商之間的智能中介，讓開發(fā)者無需Anthropic官方API即可享受Claude Code的優(yōu)秀體驗。支持Gemini、Ollama、Deepseek、OpenRouter等多種模型，提供智能路由、成本優(yōu)化和高度可定制化功能，真正實現(xiàn)AI模型的自由切換與靈活部署。
核心優(yōu)勢:
- 模型自由: 打破平臺鎖定，無縫接入Gemini, Ollama, Deepseek, OpenRouter等多種模型。
- 成本效益: 可根據(jù)任務(wù)需求選擇不同成本的模型，例如使用本地免費的Ollama模型或性價比高的 API服務(wù)。
- 功能強大: 支持基于任務(wù)類型的智能路由，為不同操作（如代碼生成、后臺索引）分配最合適的模型。
- 高度可定制: 通過自定義轉(zhuǎn)換器（Transformers），可以適配任意遵循OpenAI API格式的提供商。
GitHub：https://github.com/musistudio/claude-code-router
安裝
安裝Node.js 18+版本
進入 Node.JS 官網(wǎng)，選擇對應(yīng)的操作系統(tǒng)和版本下載
安裝claude code
npm install -g @anthropic-ai/claude-code
安裝Claude Code Router：
裝完成后，系統(tǒng)中將擁有 ccr 命令。
npm install -g @musistudio/claude-code-router
使用
啟動CCR
ccr code
首次運行時，CCR會引導完成交互式配置，讓你設(shè)置第一個AI提供商和模型。只需按照提示輸入提供商名稱、API Base URL、API 密鑰、模型命令即可。
C:\Users\Administrator>ccr code Enter Provider Name: Gemini Enter Provider API KEY: 123456 Enter Provider URL: https://xxx.com Enter MODEL Name: gemini-2.5-pro
授權(quán)信任Claude在當前目錄中進行操作，建議在新建且安全的目錄下啟動Claude Code
授權(quán)同意后，就可以像使用官方 claude-code 一樣與CCR互動了。
ccr命令參考
以下是 ccr CLI 的主要命令：
| 命令 (Command) | 描述 (Description) |
|---|---|
| ccr code | 啟動CCR代理會話。這是最常用的命令 |
| ccr start | 啟動CCR服務(wù) |
| ccr stop | 停止CCR服務(wù) |
| ccr restart | 重啟CCR服務(wù) |
| ccr status | 顯示CCR服務(wù)狀態(tài) |
| ccr ui | 在瀏覽器中打開Web UI管理界面 |
| ccr help | 顯示所有可用命令和選項的幫助信息 |
| ccr version | 顯示當前安裝的 Claude Code Router 的版本號 |
動態(tài)切換模型
如果在config.json配置有多個模型供應(yīng)商，此時可以在使用過程中動態(tài)切換模型
- 使用/model命令，動態(tài)切換模型命令格式： /model provider_name,model_name
示例:
/model openrouter,anthropic/claude-3.5-sonnet
配置示例說明
CCR的所有配置都存儲在 ~/.claude-code-router/config.json 文件中?？梢灾苯泳庉嫶宋募赃M行高級設(shè)置。
除開CCR引導的交互式配置自動生成外，還可以手動創(chuàng)建config.json配置文件進行手動配置，不同操作系統(tǒng)創(chuàng)建方式不同
Linux、Mac：
~/.claude-code-router/config.json
Wondows：
C:\Users\用戶名\.claude-code-router/config.json
config.json文件如何配置可以參考開源項目的config.example.json文件。關(guān)鍵部分如下：
PROXY_URL (可選): 為 API 請求設(shè)置代理，例如："PROXY_URL": "http://127.0.0.1:7890" LOG (可選): 通過將其設(shè)置為true來啟用日志記錄。日志文件將位于$HOME/.claude-code-router.log APIKEY (可選): 設(shè)置一個密鑰來進行身份驗證。設(shè)置后，客戶端請求必須在Authorization 請求頭 (例如, Bearer your-secret-key) 或 x-api-key 請求頭中提供此密鑰。例如："APIKEY": "your-secret-key" HOST (可選): 設(shè)置服務(wù)的主機地址。如果未設(shè)置APIKEY，出于安全考慮，主機地址將強制設(shè)置為 127.0.0.1，以防止未經(jīng)授權(quán)的訪問。例如："HOST": "0.0.0.0" NON_INTERACTIVE_MODE (可選): 當設(shè)置為 true 時，啟用與非交互式環(huán)境（如GitHub Actions、Docker容器或其他CI/CD系統(tǒng)）的兼容性。這會設(shè)置適當?shù)沫h(huán)境變量（CI=true、FORCE_COLOR=0 等）并配置stdin 處理，以防止進程在自動化環(huán)境中掛起。例如："NON_INTERACTIVE_MODE": true Providers: 用于配置不同的模型提供商 Router: 用于設(shè)置路由規(guī)則。default 指定默認模型，如果未配置其他路由，則該模型將用于所有請求 API_TIMEOUT_MS: API 請求超時時間，單位為毫秒
配置示例說明：
{
// 全局 API 密鑰，用于訪問此應(yīng)用程序自身的主要服務(wù)。
"APIKEY": "your-secret-key",
// 配置代理服務(wù)器的 URL，所有的網(wǎng)絡(luò)請求都將通過這個代理發(fā)出。
// "http://127.0.0.1:5555" 指向本地運行的代理服務(wù)。
"PROXY_URL": "http://127.0.0.1:5555",
// 日志記錄開關(guān)。如果設(shè)置為 true，應(yīng)用程序?qū)⑸刹⒂涗涍\行日志。
"LOG": true,
// API 請求的超時時間，單位為毫秒。
// 這里的 600000 毫秒等于 600 秒（10分鐘）。
"API_TIMEOUT_MS": 600000,
// 非交互模式開關(guān)。如果設(shè)置為 false，應(yīng)用程序可以與用戶進行交互（例如，請求輸入）。
// 設(shè)置為 true 時，它將在沒有用戶干預的情況下運行。
"NON_INTERACTIVE_MODE": false,
// “提供者”列表，定義了可以使用的不同 AI 模型服務(wù)。
"Providers": [
{
// 提供商的唯一名稱
"name": "gemini",
// 該提供者 API 的基礎(chǔ) URL 地址
"api_base_url": "https://generativelanguage.googleapis.com/v1beta/models/",
// 提供商的 API 密鑰
"api_key": "AIzaSyxxxxxxEfZDzBs1lC0Ac08",
// 提供商可用的模型名稱列表
"models": ["gemini-2.5-flash", "gemini-2.5-pro"],
// 指定用于處理請求和響應(yīng)的轉(zhuǎn)換器
"transformer": {
// 指定要使用的轉(zhuǎn)換器名稱
"use": ["gemini"]
}
}
],
// “路由器”配置，用于根據(jù)不同的任務(wù)類型，智能地選擇使用哪個“提供者”和“模型”。
"Router": {
// 默認模型提供商 默認使用模型
"default": "gemini,gemini-2.5-pro",
// 用于處理后臺任務(wù)的模型?？梢允且粋€較小的本地模型以節(jié)省成本。
"background": "gemini,gemini-2.5-flash",
// 用于需要深度思考或推理任務(wù)的模型。
"think": "gemini,gemini-2.5-flash",
// 用于處理長文本上下文任務(wù)的模型。
"longContext": "gemini,gemini-2.5-flash",
// 定義長文本的閾值（可能是字符數(shù)或 token 數(shù)）。當輸入超過此閾值時，將啟用 "longContext" 路由。
"longContextThreshold": 60000,
// 用于處理網(wǎng)絡(luò)搜索任務(wù)，需要模型本身支持
"webSearch": "gemini,gemini-2.5-flash"
}
}核心配置說明
providers- 定義AI提供商
此部分是一個數(shù)組，用于定義要使用的所有AI模型提供商。
name: 提供商的唯一標識符（例如 "gemini", "ollama"）api_base: API 的基礎(chǔ) URLapi_key: API 密鑰models：提供商可用的模型名稱列表transformer：(可選): 指定用于處理請求和響應(yīng)的轉(zhuǎn)換器
示例配置:
"Providers": [
{
"name": "gemini1",
"api_base_url": "https://generativelanguage.googleapis.com/v1beta/models/",
"api_key": "AIzaSyCvmL0_gwkJOH9d8jFlDFe3_9rZA1GO8OQ",
"models": ["gemini-2.5-flash", "gemini-2.5-pro"],
"transformer": {
"use": ["gemini"]
}
}
]routing- 智能路由規(guī)則
這是CCR的核心功能之一。可以為Claude Code的不同內(nèi)部操作指定不同的模型，以實現(xiàn)性能和成本的最佳平衡。
default: 默認模型，用于常規(guī)任務(wù)的默認模型。background: 后臺模型，用于后臺任務(wù)的模型。這可以是一個較小的本地模型以節(jié)省成本。think: 思考模型，用于在執(zhí)行任務(wù)前進行規(guī)劃和推理。longContext: 長上下文模型，用于處理和分析大型文件或長篇對話。longContextThreshold: 觸發(fā)長上下文模型的令牌數(shù)閾值。如果未指定，默認為 60000。webSearch: 用于處理網(wǎng)絡(luò)搜索任務(wù)，需要模型本身支持。如果使用openrouter需要在模型后面加上:online后綴。
示例配置:
// “路由器”配置，用于根據(jù)不同的任務(wù)類型，智能地選擇使用哪個“提供者”和“模型”。
"Router": {
// 默認模型提供商 默認使用模型
"default": "gemini,gemini-2.5-pro",
// 用于處理后臺任務(wù)的模型?？梢允且粋€較小的本地模型以節(jié)省成本。
"background": "gemini,gemini-2.5-flash",
// 用于需要深度思考或推理任務(wù)的模型。
"think": "gemini,gemini-2.5-flash",
// 用于處理長文本上下文任務(wù)的模型。
"longContext": "gemini,gemini-2.5-flash",
// 定義長文本的閾值（可能是字符數(shù)或 token 數(shù)）。當輸入超過此閾值時，將啟用 "longContext" 路由。
"longContextThreshold": 60000,
// 用于處理網(wǎng)絡(luò)搜索任務(wù)，需要模型本身支持
"webSearch": "gemini,gemini-2.5-flash"
}
transformers- 高級自定義
Transformers允許修改請求和響應(yīng)負載，以確保與不同提供商API的兼容性。
內(nèi)置Transformer：
Anthropic: 如果只使用這一個轉(zhuǎn)換器，則會直接透傳請求和響應(yīng)(可以用它來接入其他支持Anthropic端點的服務(wù)商) deepseek: 適配 DeepSeek API 的請求/響應(yīng) gemini: 適配 Gemini API 的請求/響應(yīng) openrouter: 適配OpenRouter API 的請求/響應(yīng)。它還可以接受一個provider路由參數(shù)，以指定OpenRouter應(yīng)使用哪些底層提供商
全局Transformer: 將轉(zhuǎn)換器應(yīng)用于提供商的所有模型。
openrouter轉(zhuǎn)換器將應(yīng)用于openrouter提供商下的所有模型。
{
"name": "openrouter",
"api_base_url": "https://openrouter.ai/api/v1/chat/completions",
"api_key": "sk-xxx",
"models": [
"google/gemini-2.5-pro-preview",
"anthropic/claude-sonnet-4",
"anthropic/claude-3.5-sonnet"
],
"transformer": { "use": ["openrouter"] }
}特定于模型的Transformer: 將轉(zhuǎn)換器應(yīng)用于特定模型。
deepseek轉(zhuǎn)換器應(yīng)用于所有模型，而額外的openrouter轉(zhuǎn)換器僅應(yīng)用于deepseek-chat模型。
{
"name": "deepseek",
"api_base_url": "https://api.deepseek.com/chat/completions",
"api_key": "sk-xxx",
"models": ["deepseek-chat", "deepseek-reasoner"],
"transformer": {
"use": ["deepseek"],
"deepseek-chat": { "use": ["openrouter"] }
}
}向Transformer 傳遞選項: 某些轉(zhuǎn)換器（如 maxtoken）接受選項。
要傳遞選項，使用嵌套數(shù)組，其中第一個元素是轉(zhuǎn)換器名稱，第二個元素是選項對象。
{
"name": "siliconflow",
"api_base_url": "https://api.siliconflow.cn/v1/chat/completions",
"api_key": "sk-xxx",
"models": ["moonshotai/Kimi-K2-Instruct"],
"transformer": {
"use": [
[
"maxtoken",
{
"max_tokens": 16384
}
]
]
}
}UI模式
為了獲得更直觀的體驗，可以使用UI模式來管理配置，在終端輸入以下命令
ccr ui
將打開一個基于Web的界面，輸入配置文件中的APIKEY進行認證登錄
然后可以在其中輕松查看和編輯config.json文件
異常
異常1：
執(zhí)行ccr code命令后可能會像執(zhí)行claude命令一樣出現(xiàn)登錄界面的提示操作，此時可以嘗試刪除.claude.json
Linux、Mac：
~/.claude.json
Windows：
C:\Users\用戶名\.claude.json
異常2：
如果使用Gemini，有可能出現(xiàn)400錯誤，可以查看C:\Users\用戶名\.claude-code-router\claude-code-router.log日志文件進行異常排除，例如這里遇到：User location is not supported for the API use.，此時意味著你所處國家不支持訪問
"error": {
"code": 400,
"message": "User location is not supported for the API use.",
"status": "FAILED_PRECONDITION"
}到此這篇關(guān)于Claude Code Router實現(xiàn)一鍵接入多種AI模型的智能路由器的文章就介紹到這了,更多相關(guān)Claude Code Router接入多種AI內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！
相關(guān)文章
詳解Claude Code Router 接入過程的爬坑記錄
本文詳細記錄了安裝Claude-code-router（CCR）過程中遇到的五個關(guān)鍵問題及其解決方案,包括配置文件錯誤、API路徑不完整、代理設(shè)置不當、settings.json沖突以及Warp終端上下2026-06-16
