CLAUDE DESKTOP · GATEWAY / SETUP GUIDE

Claude 桌面端教程

适用于提供 Third-Party Inference / Gateway 入口的 Claude Desktop 版本。准备好支持 Claude 的分组与 API Key,再开始配置。

01安装与准备

从 Claude 官方下载页安装或更新桌面客户端,并在控制台确认 Key 所属分组支持 Claude 模型。

仅有 OpenAI 模型权限的 Key 不代表可以调用 Claude。不同版本或受组织管理的客户端,第三方推理入口可能不可用。

02找到 Gateway 入口

  1. 打开客户端的 Developer 菜单。
  2. 如果当前版本提供该功能,选择 Configure Third-Party Inference…。
  3. 将 Inference provider 设为 Gateway。

若没有该菜单,先核对客户端版本和组织策略。不要把下方参数填到 MCP 配置中;MCP 配置不是模型服务地址。

03填写连接参数

Inference provider
Gateway
Gateway base URL
https://mid-route.site
Gateway API key
你的 mid-route API Key
Gateway auth scheme
优先选择 x-api-key(以客户端支持的选项为准)
Model discovery
尝试自动发现;失败时按当前分组的模型列表手动配置
BASE URL

https://mid-route.site

这里填写根地址,客户端消息接口为 https://mid-route.site/v1/messages,不要把完整接口路径重复填写进 Base URL。

04测试并重新打开

  1. 点击 Test connection,确认返回结果后保存。
  2. 完全退出 Claude Desktop,再重新打开。
  3. 发送一条简短消息,在 mid-route 用量页确认请求记录。
打开用量记录

05连接排错

提示 401,应该检查哪里?

确认使用的是 mid-route 控制台创建的完整 API Key。登录密码、其他平台的 Key 都不能替代它。

提示 503 或模型不可用?

检查 Key 所属分组是否支持该模型,以及是否存在可调度账号。相同域名下,不同分组的模型和渠道可能不同。可到API 密钥核对分组。

如何确认请求走了 mid-route?

发送一条简短消息后,到用量记录核对模型和时间。只查询模型列表不等于完成了一次模型调用。

返回 404 或路径不正确?

检查 Base URL 为 https://mid-route.site,不要同时在两处添加 /v1/messages。

参考文档:Claude 官方下载 ↗Claude 第三方接入说明 ↗
客户端版本会影响菜单和配置项,请以当前版本及控制台生成的配置为准。