首页 > AI教程 >Claude Code桌面版调用第三方模型完整教程

Claude Code桌面版调用第三方模型完整教程

来源：互联网 2026-07-11 06:22:07

Claude资讯合集

ClaudeCode桌面版接入第三方模型有原生图形化配置与cc-switch工具两种方案，均需服务商API兼容Anthropic消息接口。原生配置适合固定模型，cc-switch便于多服务商切换。配置时需正确填写网关地址、密钥及模型ID，并注意接口兼容性限制。

聊到Claude Code接入第三方模型，其实不外乎两种主流方案：软件内原生图形化配置（官方自带，不需要额外工具），以及cc-switch可视化多模型管理工具（适合频繁切换多服务商）。两种方案都要求目标API兼容Anthropic/Claude的消息接口（/v1/messages、流式输出、工具调用）。下面挨个说清楚。

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

Claude Code桌面版调用第三方模型完整教程

长期稳定更新的攒劲资源： >>>点此立即查看<<<

1. 开启开发者模式

打开Claude Code桌面端，左上角菜单 Help → Troubleshooting
点击 Enable Developer Mode，确认弹窗，完全重启软件
重启后顶部菜单栏出现 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. 生效并重启

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

补充：免登录使用

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

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

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

Claude Code桌面版调用第三方模型完整教程

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三档对应的第三方模型（控制代码快慢调用）

Claude Code桌面版调用第三方模型完整教程

3. 启用配置并生效

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

常见服务商完整配置示例

示例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

关键限制与排错

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