Claude(桌面版) 配置教程

在模型映射中设置实际请求模型,开启路由后完全退出并重开 Claude。

先安装 Claude(桌面版),并创建 QuickRouter API Key。

推荐用 QuickRouter Switch 一键配置。已安装 CC-Switch 的用户也可选择备选方式。

使用 QuickRouter Switch 配置

还没安装?下载并安装 QuickRouter Switch。

  1. 添加供应商

    打开 QuickRouter Switch,在左边选「Claude Desktop」,点「添加供应商」。

  2. 填写 API Key

    把自己的 API Key 粘贴到同名输入框。地址和接口格式已经填好。模型可换成自己实际要用、当前 Key 能调用的模型。

    核对桌面版的请求地址、模型类型与上游格式。
    图 4 核对桌面版的请求地址、模型类型与上游格式。
    可换成自己实际要用的模型;填写当前 API Key 可调用的模型 ID。
    图 5 可换成自己实际要用的模型;填写当前 API Key 可调用的模型 ID。
  3. 开始路由

    点右下角「添加」。回到列表,点「开始路由」,选中 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 路由。

  1. 添加供应商

    打开 CC Switch,在左侧选择Claude Desktop,点击添加供应商,选择自定义配置。

  2. 填写连接信息
    • 名称填 QuickRouter,API Key 填自己的令牌,请求地址填 https://api.quickrouter.ai/v1。
    • 在模型配置 → 接入方式中选模型映射,上游格式选 OpenAI Chat Completions(需开启路由)。
    Claude(桌面版) 的 Chat 供应商与模型映射接入方式
    Claude(桌面版):地址带 /v1,接入方式为模型映射,上游选择 Chat。
  3. 设置模型
    • 按下表分别填写 Sonnet、Opus、Fable、Haiku 四档的实际请求模型 ID,菜单显示名复制同一行的完整模型 ID,1M 关闭。
    模型档位实际请求模型 ID显示名称
    Sonnetclaude-sonnet-5-5claude-sonnet-5-5
    Opusclaude-opus-5-5claude-opus-5-5
    Fableclaude-fable-5-1claude-fable-5-1
    Haikuclaude-haiku-5-5claude-haiku-5-5

    上表为 QuickRouter 当前模型 ID 示例;换用其他版本时,从 模型价格页复制令牌可用的完整 ID,并同步填写同一行的显示名称。

    Claude(桌面版) 的四档独立模型映射,显示名称与各自实际模型 ID 一致
    Sonnet、Opus、Fable、Haiku 分别填写对应模型 ID,菜单显示名与各自 ID 一致,1M 关闭。
  4. 保存供应商

    在表单底部点击添加。返回 Claude Desktop 供应商列表后,确认出现 QuickRouter 卡片。

  5. 启用并打开工具

    回到 CC Switch 左侧的 Claude Desktop 页面,按下面步骤开启路由。

    1. 点击顶部的路由页签。
    2. 首次使用时点击开始路由,在确认框的路由到里选择 QuickRouter,再点击开始路由确认。
    3. 如果已经开启路由,在 QuickRouter 卡片上点击路由到此。卡片已经显示路由中时,直接进行下一步。
    4. 确认顶部显示路由 · QuickRouter或路由生效中,路由目标为 QuickRouter,且对应卡片显示路由中。
    Claude 桌面版 CC Switch 真实路由界面,红框标出路由页签与 QuickRouter 路由目标
    Claude 桌面版已启用路由的实际界面。选择「路由」,核对顶部的目标是 QuickRouter。

    保持 CC Switch 运行,完全退出 Claude Desktop,再重新打开。在新对话的模型菜单里选择已配置的模型。

  6. 发送消息验证

    在 Claude Desktop 新对话发送「请只回复 OK」。看到回复后,在QuickRouter 使用日志按发送时间和令牌核对本次请求及映射后的实际模型。

查看配置细节与排错

模型映射至少填写一个实际请求模型,空档会沿用第一条已填模型,Sonnet 优先。Claude Desktop 通过 CC Switch 的本地 /claude-desktop 网关访问 QuickRouter。出现「无法连接」时,先确认 Claude Desktop 页选择了「路由」、目标是 QuickRouter、本地路由服务正在运行,再完全退出并重开 Claude Desktop。

确认配置生效

打开 Claude(桌面版) 的新会话,选择刚配置的模型,发送「请只回复 OK」。在 QuickRouter 使用日志核对发送时间和实际请求模型。遇到 401 或 403 时,先检查令牌和模型权限。

返回工具教程列表

在线客服