Claude Code桌面版使用第三方模型的完整操作流程

聊到Claude Code接入第三方模型，其实不外乎两种主流方案：

，以及。两种方案都要求目标API兼容Anthropic/Claude的消息接口（/v1/messages、流式输出、工具调用）。下面挨个说清楚。

方案一：原生内置第三方推理配置（新手推荐，不用装额外软件）

1. 开启开发者模式

1. 打开Claude Code桌面端，左上角菜单 Help → Troubleshooting
2. 点击 Enable Developer Mode，确认弹窗，

   完全重启软件
3. 重启后顶部菜单栏出现 Developer 菜单

2. 进入第三方配置面板

点击顶部：Developer → Configure Third-Party Inference

3. 网关连接填写（核心参数）

Connection选择 Gateway（默认），按服务商填入：

配置项	说明&示例
Gateway base URL	服务商兼容Claude的接口地址 OpenRouter：https://openrouter.ai/api DeepSeek：https://api.deepseek.com/anthropic Ollama本地：http://127.0.0.1:11434/v1 阿里云通义千问：https://dashscope.aliyuncs.com/apps/anthropic
Gateway API key	服务商后台生成的sk密钥
Gateway auth scheme	绝大多数填 bearer；OpenRouter填 x-api-key
Gateway extra headers	无特殊需求留空

4. 手动添加模型列表（关键）

如果网关无法自动拉取 /v1/models，在下方 Model list 手动填入模型ID：

• OpenRouter：gpt-4o-mini、qwen3.6-coder、deepseek-v3
• DeepSeek：deepseek-chat、deepseek-coder-v2
• 本地Ollama：codellama:70b-code、qwen2.5-coder:32b

5. 生效并重启

1. 点击 Apply locally（仅本机生效）
2. 点击 Relaunch now 重启软件
3. 重启后新建对话，顶部模型下拉框即可选择你配置的第三方模型

补充：免登录使用

配置第三方网关后，登录界面直接选择 Start in Cowork on 3 P，不需要登录Anthropic账号。

方案二：cc-switch 可视化多服务商一键切换（适合多模型轮换）

cc-switch是第三方管理工具，内置几十家模型服务商预设，一键切换API地址与密钥，不用反复改原生配置。

1. 安装cc-switch

GitHub Releases下载对应系统安装包：github.com/farion1231/cc-switch/releases

2. 添加第三方模型服务商

1. 打开cc-switch，顶部切换到 Claude 标签
2. 右上角黄色 + 添加供应商
3. 在

   预设供应商
   直接选：DeepSeek、智谱GLM、OpenRouter、Kimi Coding、硅基流动、Ollama、通义千问等，不用手动填URL
4. 填入服务商后台获取的 API Key
5. 高级设置：映射Haiku/Sonnet/Opus三档对应的第三方模型（控制代码快慢调用）

3. 启用配置并生效

1. 选中配置，点击「启用」设为激活状态
2. 完全关闭Claude Code桌面版，重新打开自动加载新模型API
3. 托盘图标可快速切换不同服务商

常见服务商完整配置示例

示例1：OpenRouter（聚合全平台模型，推荐）

• Base URL：https://openrouter.ai/api
• Auth scheme：x-api-key
• API Key：sk-or-v1-xxx
• 可用模型：anthropic/claude-3.5-sonnet、openai/gpt-4o、qwen/qwen3.6-coder

示例2：DeepSeek（国产代码模型）

• Base URL：https://api.deepseek.com/anthropic
• Auth scheme：bearer
• API Key：sk-xxx
• 模型：deepseek-coder-v2、deepseek-chat

示例3：本地Ollama离线模型

• Base URL：http://127.0.0.1:11434/v1
• Auth scheme：bearer（无密钥随便填一串字符）
• 模型：qwen2.5-coder:14b、codellama:34b

关键限制与排错

1. 接口兼容性要求
   ：服务商必须实现Anthropic /v1/messages 流式接口，仅OpenAI兼容/chat/completions无法直接用，需要中转网关。
2. 模型不显示：
   • 手动在Model list填入完整模型ID；
   • 检查Base URL末尾是否带 /v1，少写会请求失败；
3. 请求报错401：API Key复制错误、认证scheme选错；
4. 代码工具失效：部分轻量化模型不支持工具调用，优先选Coder专用模型。

两种方案怎么选

• 只用1-2个固定模型、不想装额外软件：

  原生Developer配置
• 经常切换DeepSeek/通义/OpenRouter/本地Ollama多模型：

  cc-switch工具