Claude(桌面版) 配置教程
在模型映射中设置实际请求模型,开启路由后完全退出并重开 Claude。
先安装 Claude(桌面版),并创建 QuickRouter API Key。
推荐用 QuickRouter Switch 一键配置。已安装 CC-Switch 的用户也可选择备选方式。
使用 QuickRouter Switch 配置
还没安装?下载并安装 QuickRouter Switch。
- 添加供应商
打开 QuickRouter Switch,在左边选「Claude Desktop」,点「添加供应商」。
- 填写 API Key
把自己的 API Key 粘贴到同名输入框。地址和接口格式已经填好。模型可换成自己实际要用、当前 Key 能调用的模型。
图 4 核对桌面版的请求地址、模型类型与上游格式。 图 5 可换成自己实际要用的模型;填写当前 API Key 可调用的模型 ID。 - 开始路由
点右下角「添加」。回到列表,点「开始路由」,选中 QuickRouter 并确认。看到「路由中」后,完全退出 Claude 桌面版,再重新打开。使用时保持 QuickRouter Switch 开着。在模型菜单选你配置的模型。
查看具体参数和更多操作
请求地址用 https://api.quickrouter.ai。「模型类型」选「模型映射」,「上游格式」保留「OpenAI Chat Completions (需开启路由)」。各档实际请求模型预填 Sonnet claude-sonnet-5-5、Opus claude-opus-5-5、Fable claude-fable-5-1、Haiku claude-haiku-5-5。菜单显示名称填对应的模型 ID。预填模型仅作示例,可换成自己实际要用的模型。请填写当前 API Key 可调用的完整模型 ID。
点击「添加」。回到供应商列表,点「开始路由」,将「路由到」选为 QuickRouter,再确认「开始路由」。卡片显示「路由中」后,彻底退出并重新打开 Claude 桌面版,并保持 QuickRouter Switch 运行。 在模型菜单选择映射后的条目。切换路由供应商后也要重新打开桌面版,让它读取新的模型映射。
使用 CC-Switch 配置
还没安装?下载并安装 CC-Switch。
本节使用路由模式。供应商表单中的「模型映射」用于设置模型;保存供应商后,还需要按第 5 步开启 Claude Desktop 路由。
- 添加供应商
打开 CC Switch,在左侧选择Claude Desktop,点击添加供应商,选择自定义配置。
- 填写连接信息
- 名称填
QuickRouter,API Key 填自己的令牌,请求地址填https://api.quickrouter.ai/v1。 - 在模型配置 → 接入方式中选模型映射,上游格式选 OpenAI Chat Completions(需开启路由)。

Claude(桌面版):地址带 /v1,接入方式为模型映射,上游选择 Chat。 - 名称填
- 设置模型
- 按下表分别填写 Sonnet、Opus、Fable、Haiku 四档的实际请求模型 ID,菜单显示名复制同一行的完整模型 ID,1M 关闭。
模型档位 实际请求模型 ID 显示名称 Sonnet claude-sonnet-5-5claude-sonnet-5-5Opus claude-opus-5-5claude-opus-5-5Fable claude-fable-5-1claude-fable-5-1Haiku claude-haiku-5-5claude-haiku-5-5上表为 QuickRouter 当前模型 ID 示例;换用其他版本时,从 模型价格页复制令牌可用的完整 ID,并同步填写同一行的显示名称。

Sonnet、Opus、Fable、Haiku 分别填写对应模型 ID,菜单显示名与各自 ID 一致,1M 关闭。 - 保存供应商
在表单底部点击添加。返回 Claude Desktop 供应商列表后,确认出现
QuickRouter卡片。 - 启用并打开工具
回到 CC Switch 左侧的 Claude Desktop 页面,按下面步骤开启路由。
- 点击顶部的路由页签。
- 首次使用时点击开始路由,在确认框的路由到里选择
QuickRouter,再点击开始路由确认。 - 如果已经开启路由,在 QuickRouter 卡片上点击路由到此。卡片已经显示路由中时,直接进行下一步。
- 确认顶部显示路由 · QuickRouter或路由生效中,路由目标为 QuickRouter,且对应卡片显示路由中。
Claude 桌面版已启用路由的实际界面。选择「路由」,核对顶部的目标是 QuickRouter。 保持 CC Switch 运行,完全退出 Claude Desktop,再重新打开。在新对话的模型菜单里选择已配置的模型。
- 发送消息验证
在 Claude Desktop 新对话发送「请只回复 OK」。看到回复后,在QuickRouter 使用日志按发送时间和令牌核对本次请求及映射后的实际模型。
查看配置细节与排错
模型映射至少填写一个实际请求模型,空档会沿用第一条已填模型,Sonnet 优先。Claude Desktop 通过 CC Switch 的本地 /claude-desktop 网关访问 QuickRouter。出现「无法连接」时,先确认 Claude Desktop 页选择了「路由」、目标是 QuickRouter、本地路由服务正在运行,再完全退出并重开 Claude Desktop。
确认配置生效
打开 Claude(桌面版) 的新会话,选择刚配置的模型,发送「请只回复 OK」。在 QuickRouter 使用日志核对发送时间和实际请求模型。遇到 401 或 403 时,先检查令牌和模型权限。