個(gè)人使用場景 claude 模型實(shí)在是太貴了，想使用 Claude Code 默認(rèn)只支持 Anthropic 的接口格式，所以本文記錄了如何把本地模型或者其他模型（Deepseek等）接入 Claude Code 使用的方法。

通過 Claude Code Router (CCR) 將 Claude Code CLI 連接到 Ollama（本地模型）或 DeepSeek（云端模型），從而使用非 Anthropic 模型運(yùn)行 Claude Code。

1. 原理概述

架構(gòu)圖

┌─────────────────┐      Anthropic Messages API       ┌──────────────────────────┐
│                 │  ──────────────────────────────?   │                          │
│   Claude Code   │      /v1/messages                 │  Claude Code Router      │
│   (CLI / VSC)   │  ?──────────────────────────────   │  (localhost:3456)        │
│                 │                                    │                          │
└─────────────────┘                                    └──────────┬───────────────┘
                                                                  │
                           ┌──────────────────────────────────────┼──────────────────────────┐
                           │                                      │                          │
                           ▼                                      ▼                          ▼
                  ┌──────────────────┐                  ┌──────────────────┐      ┌──────────────────┐
                  │   Ollama         │                  │   DeepSeek API   │      │   OpenAI API     │
                  │   (localhost)    │                  │   (云端)          │      │   (其他兼容)      │
                  │   :11434/v1      │                  │   api.deepseek   │      │                  │
                  └──────────────────┘                  └──────────────────┘      └──────────────────┘

工作流程

1. Claude Code 原生只支持 Anthropic Messages API 格式（/v1/messages）
2. Claude Code Router 運(yùn)行在本地，暴露一個(gè)兼容 Anthropic API 的端點(diǎn) http://127.0.0.1:3456
3. 通過設(shè)置 ANTHROPIC_BASE_URL=http://127.0.0.1:3456，Claude Code 將所有 API 請(qǐng)求發(fā)送到 CCR
4. CCR 內(nèi)部做協(xié)議轉(zhuǎn)換：將 Anthropic Messages 格式翻譯成 OpenAI Chat Completions 格式（Ollama / DeepSeek 都支持）
5. 響應(yīng)再從 OpenAI 格式翻譯回 Anthropic 格式返回給 Claude Code

關(guān)鍵事實(shí)

2. 安裝 Claude Code Router

系統(tǒng)要求

• macOS 10.15+ / Windows 10+ / Linux (支持 AppImage)
• 已安裝 Claude Code CLI

下載安裝

1. 訪問 GitHub Releases 頁面
2. 下載對(duì)應(yīng)系統(tǒng)的安裝包：
   • macOS: .dmg 文件
   • Windows: .exe 安裝程序
   • Linux: .AppImage 文件
3. 安裝并啟動(dòng)應(yīng)用

首次啟動(dòng)

啟動(dòng)后，CCR 會(huì)在以下位置創(chuàng)建配置文件：

• macOS / Linux: ~/.claude-code-router/config.json
• Windows: %APPDATA%\Claude Code Router\config.json

3. 配置 Ollama 提供商

前置條件

• 已安裝 Ollama
• 已拉取至少一個(gè)模型，例如：

ollama pull llama3.1
ollama pull qwen2.5
ollama pull deepseek-r1:7b

• Ollama 服務(wù)正在運(yùn)行（默認(rèn)監(jiān)聽 http://127.0.0.1:11434）

通過 CCR 界面配置

1. 打開 CCR 桌面應(yīng)用
2. 進(jìn)入 Providers → 點(diǎn)擊 Add Provider
3. 填寫以下信息：

4. 點(diǎn)擊 Save

為什么 Ollama 的 endpoint 是 :11434/v1？ Ollama 從 0.1.32 版本開始原生支持 OpenAI 兼容 API，路徑為 /v1/chat/completions。 CCR 通過 openai_chat_completions 協(xié)議將 Anthropic 請(qǐng)求轉(zhuǎn)換后發(fā)送到此端點(diǎn)。

通過 Deeplink 配置（可選）

也可以直接通過 URL Scheme 快速添加：

ccr://provider?name=Ollama&base_url=http%3A%2F%2F127.0.0.1%3A11434%2Fv1&api_key=ollama&models=llama3.1,qwen2.5&protocol=openai_chat_completions

在瀏覽器中打開此鏈接，CCR 會(huì)彈出確認(rèn)對(duì)話框。

測試 Ollama 連接

在終端驗(yàn)證 Ollama 的 OpenAI 兼容 API 是否正常：

curl http://127.0.0.1:11434/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "llama3.1",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

應(yīng)返回包含 choices 字段的 JSON 響應(yīng)。

4. 配置 DeepSeek 提供商

前置條件

• 注冊(cè) DeepSeek 平臺(tái)
• 獲取 API Key（在控制臺(tái)創(chuàng)建）

通過 CCR 界面配置

1. 打開 CCR 桌面應(yīng)用
2. 進(jìn)入 Providers → 點(diǎn)擊 Add Provider
3. 填寫以下信息：

4. 點(diǎn)擊 Save

通過 Deeplink 配置（可選）

ccr://provider?name=DeepSeek&base_url=https%3A%2F%2Fapi.deepseek.com%2Fv1&api_key=sk-xxxxxxxxx&models=deepseek-chat,deepseek-reasoner&protocol=openai_chat_completions

DeepSeek 模型說明

5. 配置 Claude Code 連接到 CCR

5.1 啟動(dòng) CCR 網(wǎng)關(guān)

1. 在 CCR 桌面應(yīng)用中進(jìn)入 Server
2. 點(diǎn)擊 Start 啟動(dòng)網(wǎng)關(guān)服務(wù)
3. 確認(rèn)狀態(tài)：兩個(gè)端點(diǎn)應(yīng)處于運(yùn)行狀態(tài)：
   • Wrapper gateway: http://127.0.0.1:3456
   • Core gateway runtime: http://127.0.0.1:3457

建議勾選 Auto-start，這樣每次開機(jī) CCR 會(huì)自動(dòng)啟動(dòng)網(wǎng)關(guān)。

5.2 創(chuàng)建 Claude Code 配置文件

方法 A：全局配置（推薦）

編輯 ~/.claude/settings.json（macOS/Linux）或 %USERPROFILE%\.claude\settings.json（Windows）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:3456",
    "ANTHROPIC_API_KEY": "ccr-local"
  }
}

ANTHROPIC_API_KEY 的值可以是任意非空字符串——CCR 作為本地網(wǎng)關(guān)不驗(yàn)證這個(gè) key，但 Claude Code 要求必須有值才會(huì)繞過登錄流程。

方法 B：項(xiàng)目級(jí)配置

在項(xiàng)目根目錄創(chuàng)建 .claude/settings.local.json（此文件會(huì)自動(dòng)被 gitignore）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:3456",
    "ANTHROPIC_API_KEY": "ccr-local"
  }
}

方法 C：Shell 環(huán)境變量（臨時(shí)，適合測試）

export ANTHROPIC_BASE_URL=http://127.0.0.1:3456
export ANTHROPIC_API_KEY=ccr-local

5.3 使用 CCR Profiles 自動(dòng)配置（推薦）

CCR 提供了 Profile 功能，可以一鍵應(yīng)用配置：

1. 在 CCR 中進(jìn)入 Profiles
2. 選擇 Claude Code
3. 選擇目標(biāo)模型（例如你在 Ollama 中配置的 llama3.1）
4. 點(diǎn)擊 Apply — 這會(huì)自動(dòng)設(shè)置環(huán)境變量并打開 Claude Code

5.4 配置 CCR 路由

在 CCR 的 Routing 面板中設(shè)置：

你還可以配置針對(duì)不同工作負(fù)載的路由規(guī)則：

• Background（后臺(tái)任務(wù)）→ 可以用更便宜的模型
• Thinking（推理任務(wù)）→ 可以用更強(qiáng)的模型
• Subagent（子智能體）→ 可以用性價(jià)比更高的模型

6. 驗(yàn)證連接

6.1 快速測試（curl）

在配置好環(huán)境變量后，先用 curl 測試 CCR 網(wǎng)關(guān)是否正常響應(yīng)：

curl -X POST http://127.0.0.1:3456/v1/messages \
  -H "Authorization: Bearer ccr-local" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "llama3.1", "max_tokens": 50, "messages": [{"role": "user", "content": "Say hello"}]}'

注意：這里的 model 名稱必須與你之前在 CCR 中添加的模型名稱一致。 如果 DeepSeek 使用 deepseek-chat，如果 Ollama 使用你拉取的模型名如 llama3.1。

如果返回 JSON 且包含 content 字段，說明 CCR 工作正常。

6.2 啟動(dòng) Claude Code

cd your-project
claude

如果一切正常，Claude Code 應(yīng)該 跳過登錄界面，直接進(jìn)入會(huì)話。

6.3 檢查狀態(tài)

在 Claude Code 中運(yùn)行：

/status

查看以下關(guān)鍵信息：

6.4 發(fā)送測試消息

嘗試發(fā)送一條簡單的消息，比如：

Hello, what model are you running on?

如果 CCR 路由配置正確，你會(huì)收到模型回復(fù)，并能在 CCR 的 Dashboard 中看到請(qǐng)求記錄。

7. 進(jìn)階：路由規(guī)則與虛擬模型

7.1 多模型路由

CCR 支持根據(jù)請(qǐng)求特征將不同任務(wù)路由到不同模型：

配置方式：在 CCR → Routing → Add Routing Rule 中設(shè)置。

7.2 虛擬模型（Virtual Models）

可以創(chuàng)建虛擬模型名稱來簡化模型選擇：

llama3.1 → Ollama 上的 llama3.1
default-coding → deepseek-chat
default-reasoning → deepseek-reasoner

在 CCR → Routing → Virtual Models 中配置。

7.3 備用路由（Fallback）

當(dāng)主模型不可用時(shí)，CCR 可以自動(dòng)切換到備用模型：

Primary:   deepseek-chat (DeepSeek)
Fallback:  llama3.1 (Ollama，本地運(yùn)行，不需要網(wǎng)絡(luò))

在 Routing → 編輯路由規(guī)則 → 配置 Fallback 模型。

7.4 API Key 輪轉(zhuǎn)

對(duì) DeepSeek 等 API 服務(wù)，可以配置多個(gè) API Key 實(shí)現(xiàn)負(fù)載均衡和故障轉(zhuǎn)移：

在 Providers → 編輯 DeepSeek → API Key 字段使用逗號(hào)分隔多個(gè) key：

sk-key1,sk-key2,sk-key3

CCR 會(huì)在請(qǐng)求失敗時(shí)自動(dòng)輪換到下一個(gè) key。

8. 常見問題排查

8.1 Claude Code 仍然顯示登錄界面

原因：CCR 的網(wǎng)關(guān)配置未被 Claude Code 讀取到。

解決：

• 確認(rèn) ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY 都已正確設(shè)置
• 如果使用 settings.json，確認(rèn)文件路徑正確：
  • 全局：~/.claude/settings.json
  • 項(xiàng)目級(jí)：.claude/settings.local.json
• 運(yùn)行 echo $ANTHROPIC_BASE_URL 檢查環(huán)境變量是否生效
• 在 Claude Code 中運(yùn)行 /status 查看實(shí)際生效的 base URL

8.2 連接被拒絕（Connection Refused）

原因：CCR 網(wǎng)關(guān)未啟動(dòng)。

解決：

• 確認(rèn) CCR 桌面應(yīng)用正在運(yùn)行
• 在 CCR → Server 中確認(rèn) Gateway 狀態(tài)為 "Running"
• 檢查端口是否被占用：lsof -i :3456

8.3 模型返回錯(cuò)誤或不響應(yīng)

原因：可能存在多種問題。

解決步驟：

對(duì)于 Ollama：

# 檢查 Ollama 服務(wù)狀態(tài)
ollama list
# 確認(rèn)模型已加載
ollama run llama3.1
# 檢查 Ollama 日志
ollama serve

對(duì)于 DeepSeek：

# 直接測試 DeepSeek API
curl https://api.deepseek.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-chat", "messages": [{"role": "user", "content": "hi"}]}'

8.4 401 認(rèn)證錯(cuò)誤

原因：API Key 未正確傳遞。

解決：

• 如果使用 ANTHROPIC_API_KEY，CCR 收到的是 x-api-key 頭
• 如果使用 ANTHROPIC_AUTH_TOKEN，CCR 收到的是 Authorization: Bearer 頭
• 大多數(shù)情況下，兩者都可以，只需確保 settings.json 中的變量名與 CCR 期望的一致

8.5 協(xié)議轉(zhuǎn)換錯(cuò)誤

原因：CCR 在 Anthropic Messages ↔ OpenAI Chat Completions 之間轉(zhuǎn)換時(shí)可能遇到不兼容的字段。

解決：

• 在 Claude Code 中設(shè)置環(huán)境變量：CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1
• 這會(huì)讓 Claude Code 少發(fā)送一些實(shí)驗(yàn)性字段，降低協(xié)議轉(zhuǎn)換出錯(cuò)的概率
• 在 settings.json 中添加：

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:3456",
    "ANTHROPIC_API_KEY": "ccr-local",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

8.6 檢查 CCR 日志

CCR 桌面應(yīng)用中的 Network Logs 面板可以查看所有通過的請(qǐng)求和響應(yīng)，是排查問題的最佳工具。

8.7 重置配置

如果需要完全重置：

# 備份現(xiàn)有配置
cp ~/.claude-code-router/config.json ~/.claude-code-router/config.json.bak
# 刪除配置（CCR 會(huì)在下次啟動(dòng)時(shí)重新創(chuàng)建）
rm ~/.claude-code-router/config.json
# 清除 Claude Code 緩存
rm -rf ~/.claude/cache

9. 完整配置示例

最終~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:3456",
    "ANTHROPIC_API_KEY": "ccr-local",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

啟動(dòng)順序

正確的啟動(dòng)順序是：

1. 啟動(dòng) Ollama（如果用本地模型）：ollama serve
2. 啟動(dòng) CCR 并確保網(wǎng)關(guān)處于 Running 狀態(tài)
3. 啟動(dòng) Claude Code：claude

以上就是Claude Code配置本地Ollama模型或別的模型(Deepseek等)的實(shí)踐指南的詳細(xì)內(nèi)容，更多關(guān)于Claude Code配置本地Ollama模型的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論