平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“Claude Code桌面版使用第三方模型的完整操作流程”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际使用顺序，把思路、关键写法和容易踩坑的地方讲清楚，方便你直接对照操作。
有两种主流方案：软件内原生图形化设置（官方自带，无需额外工具）、cc-switch 可视化多模型管理工具（适合频繁切换多服务商）落到代码里，，两种都要求目标API兼容 Anthropic / Claude 消息接口（/v1/messages、流式输出、工具调用）。
方案一：原生内置第三方推理设置（建议新手，不用装额外软件）
1. 开启开发者模式
- 结合项目来看，打开 Claude Code 桌面端，左上角菜单
Help → Troubleshooting - 点击
Enable Developer Mode，确认弹窗，完全重启软件 - 重启后顶部菜单栏出现
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. 生效并重启
- 点击
Apply locally（仅本机生效） - 点击
Relaunch now重启软件 - 重启后新建对话，顶部模型下拉框即可选择你设置的第三方模型
补充：免登录采用
理解这一步时，设置第三方网关后，登录界面直接选择 Start in Cowork on 3 P，不需登录 Anthropic 账号。
方案二：cc-switch 可视化多服务商一键切换（适合多模型轮换）
在这个场景下，cc-switch 是第三方管理工具，内置几十家模型服务商预设，一键切换API地址与密钥，不用反复改原生设置。
1. 安装cc-switch
GitHub Releases 下载对应系统安装包：github.com/farion1231/cc-switch/releases
2. 添加第三方模型服务商
- 理解这一步时，打开cc-switch，顶部切换到
Claude标签 - 右上角黄色
+ 添加供应商 - 在预设供应商直接选：DeepSeek、智谱GLM、OpenRouter、Kimi Coding、硅基流动、Ollama、通义千问等，不用手动填URL
- 填入服务商后台拿到的
API Key - 高级设置：映射Haiku/Sonnet/Opus三档对应的第三方模型（控制代码快慢调用）
3. 启用设置并生效
- 选中设置，点击「启用」设为激活状态
- 完全关闭 Claude Code 桌面版，重新打开自动加载新模型API
- 托盘图标可更快切换不同服务商
常用服务商完整设置示例
示例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
关键限制与排错
- 接口兼容性要求 落到代码里，服务商必须实现 Anthropic
/v1/messages流式接口，仅OpenAI兼容/chat/completions无法直接用，需中转网关。 - 模型不显示
- 手动在Model list填入完整模型ID；
- 在这个场景下，检查Base URL末尾是否带
/v1，少写会请求失败；
- 请求报错401 API Key复制错误、认证scheme选错；
- 代码工具失效 部分轻量化模型不兼容工具调用，优先选Coder专用模型。
两种方案怎么选
- 只用1-2个固定模型、不想装额外软件：原生Developer设置
- 经常切换DeepSeek/通义/OpenRouter/本地Ollama多模型：cc-switch工具
结合项目来看，总的来说，Claude这部分内容适合结合实际项目边做边理解。先抓住核心思路，再逐步补上细节和边界处理，最后效果会更稳定，也更容易复用。
