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

作者：袖梨 2026-08-19

平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“Claude Code桌面版使用第三方模型的完整操作流程”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际使用顺序，把思路、关键写法和容易踩坑的地方讲清楚，方便你直接对照操作。

有两种主流方案：软件内原生图形化设置（官方自带，无需额外工具）、cc-switch 可视化多模型管理工具（适合频繁切换多服务商）落到代码里，，两种都要求目标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：（链接已移除）
DeepSeek：（链接已移除）
Ollama本地：（链接已移除）
阿里云通义千问：（链接已移除）
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：（链接已移除）
  • 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：（链接已移除）
  • Auth scheme：bearer
  • API Key：sk-xxx
  • 模型：deepseek-coder-v2、deepseek-chat

示例3：本地 Ollama 离线模型

  • Base URL：（链接已移除）
  • 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工具

结合项目来看，总的来说，Claude这部分内容适合结合实际项目边做边理解。先抓住核心思路，再逐步补上细节和边界处理，最后效果会更稳定，也更容易复用。

相关文章

精彩推荐