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（默认），按服务商填入：

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工具

到此这篇关于Claude Code桌面版使用第三方模型的完整操作流程的文章就介绍到这了,更多相关Claude Code桌面版使用第三方模型内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！

最新评论