最新版 Claude Code Desktop(桌面版)已经支持通过图形化界面配置第三方大模型。对于不想反复折腾 CLI、环境变量和本地配置文件的用户来说,这个更新非常实用。
不过在国内环境下,很多人使用 Claude时会遇到模型访问不稳定、官方额度不够、模型选择受限等问题。比较实用的方案是把 Claude code桌面版接入 QuickRouter API https://quickrouter.ai 。调用 Claude、Gemini、GPT 等主流模型。
一、Claude Code Desktop 第三方模型接入有什么用?
Claude Code Desktop 是 Claude Code 的桌面端形态,更适合不想长期使用命令行的用户。它的优势主要在于:
- 不需要一直在终端里操作;
- 可以通过桌面端完成模型配置;
- 支持第三方推理网关;
- 配置后可以在 Claude Code Desktop 中直接使用第三方模型;
- 对国内用户更友好,可以通过中转服务降低 API 访问门槛。
如果你已经有 QuickRouter API 的 API Key,就可以把它作为第三方 Gateway 接入 Claude Code Desktop。
二、安装或更新 Claude Code Desktop
开始之前,请先确保 Claude Code Desktop 已经更新到支持第三方推理配置的版本。
推荐方式:
- 官方下载
- Windows / macOS 用户可以安装对应桌面端版本
安装完成后,打开 Claude Code Desktop。
三、准备 QuickRouter API 配置信息
在正式配置前,先准备下面 3 项信息:
| 配置项 | 填写示例 | 说明 |
|---|---|---|
| Gateway base URL | https://api.quickrouter.ai | Claude Code Desktop 的第三方 Gateway 地址 |
| Gateway API key | sk-xxxxxxxxxxxxxxxx | 在 QuickRouter API 控制台获取 |
| 模型名称 | 按 QuickRouter API 实际支持模型填写 | 如果界面无法自动加载模型,需要手动添加 |
注意:这里接入的是 Claude Code Desktop 的 Third-Party Inference / Gateway 配置。和普通 OpenAI 兼容接口不同,这里优先填写
https://api.quickrouter.ai,不要随意改成其他路径。
四、开启 Developer Mode
下面以 macOS 系统为例,Windows 用户可以参考相同菜单路径进行配置。
1. 打开 Developer Mode 开关
2. 确认启用开发者模式
点击 Enable,应用会自动重启。
五、配置 Third-Party Inference
3. 进入第三方推理配置页面
应用重启后,顶部菜单栏会出现 Developer 菜单。
依次点击:
4. 选择 Gateway 并填写 QuickRouter API 信息
在 Connection 页面选择:
Gateway
然后填写 QuickRouter API 的网关地址和 API Key:
Gateway base URL: https://api.quickrouter.ai
Gateway API key: sk-你的QuickRouter_API_Key
Gateway auth scheme: bearer
5. 如果无法自动加载模型,手动添加模型名称
部分第三方网关可能不会自动返回模型列表,或者 Claude Code Desktop 没有自动识别模型。这种情况下,可以在 Model list 区域手动添加模型。
示例:
Model ID: claude-sonnet-4-6
或者
Model ID: claude-opus-4-6
或填写你在 QuickRouter API 控制台中实际可用的 Claude Gemini 型名称。
6. 应用配置并重启
配置完成后,点击:
Apply locally → Relaunch now
Claude Code Desktop 会把配置写入本地,并重新启动应用。
7. 重启后检查第三方模型是否出现
重启后,如果配置成功,界面中会出现你配置的第三方模型。
六、开始使用
配置完成后,就可以在 Claude Code Desktop 中直接选择第三方模型进行使用。
这套方式的好处是:
- 不需要反复修改命令行环境变量;
- 不需要每次都通过 CLI 启动;
- 可以把 Claude Code Desktop 当成图形化 AI 编程工作台;
- 通过 QuickRouter API,可以在国内直连使用 Claude 等大模型;
- 后续更换模型时,只需要调整模型 ID 或网关配置。
七、常见问题
1. Gateway base URL 应该填什么?
接入 QuickRouter API 时,建议填写:
https://api.quickrouter.ai
不要和普通 OpenAI 兼容接口混淆。普通应用、Cherry Studio、OpenCode、Cursor 等一般会使用带 /v1 的 OpenAI 兼容地址;Claude Code / Claude Code Desktop 的 Gateway 配置需要按实际适配方式填写。
2. API Key 从哪里获取?
登录 QuickRouter API 控制台后,在 API Key 页面创建并复制密钥。
填写时保留完整格式,例如:
sk-xxxxxxxxxxxxxxxx
3. 模型列表不显示怎么办?
可以手动添加模型 ID。
建议以 QuickRouter API 后台展示的可用模型为准,不要直接照抄图片里的本地模型名称。
4. 配置完成后没有生效怎么办?
可以按下面顺序检查:
- API Key 是否填写完整;
- Gateway base URL 是否填写为
https://api.quickrouter.ai; - Gateway auth scheme 是否选择
bearer; - 模型名称是否填写正确;
- 是否点击了
Apply locally; - 是否点击了
Relaunch now重启应用。
八、总结
Claude Code Desktop 支持第三方大模型后,配置方式比传统 CLI 更直观。用户只需要开启 Developer Mode,然后在 Configure Third-Party Inference 中选择 Gateway,填写 QuickRouter API 的地址、API Key 和模型名称,就可以把 Claude Code Desktop 接入第三方大模型服务。
对于国内开发者来说,使用 QuickRouter API 的价值在于:
- 可以国内直连使用 Claude 等大模型;
- 一个 API Key 统一管理多模型调用;
- 图形化配置更适合普通用户;
- 后续切换模型更方便;
- 适合代码辅助、项目分析、重构、文档生成等开发场景。
如果你想用 Claude Code Desktop,但又不想受限于官方账号、CLI 配置和网络环境,可以尝试通过 QuickRouter API 接入第三方大模型。
