Claude Desktop 配置教程（桌面客户端）

Claude Desktop 是 Anthropic 的官方桌面客户端（Windows / macOS）。它内置「第三方推理网关」配置入口，不登录官方账号也能把对话请求接到 NextHub。

和 Claude Code 是两回事

Claude Desktop（桌面客户端）和 Claude Code（命令行 / VS Code 插件）是两个独立产品，配置互不相通，需要分别配置。这一页说的是桌面客户端；命令行配置请看手动配置 Claude Code。

准备工作

1. 一个 Claude 系分组的 ApiKey：claude code（0.37x）、Claude Max（0.5x）或 Claude-AWSB（0.7x），见 ApiKey 管理。Claude Desktop 走 Anthropic Messages 协议，地址口径与 Claude Code 相同
2. 从 claude.com/download 下载对应系统的安装包

Windows 安装注意

Windows 安装器运行时需要访问 Anthropic 官方服务。如果你的网络环境无法直连，可以在安装程序所在目录打开 cmd，设置代理环境变量后再启动安装程序（端口换成你自己的）：

set HTTP_PROXY=http://127.0.0.1:7897
set HTTPS_PROXY=http://127.0.0.1:7897
"Claude Setup.exe"

macOS 直接正常安装即可。

手动配置（开发者模式）

1. 开启开发者模式

打开 Claude Desktop 进入登录界面：

• Windows：鼠标点击邮件输入框获取焦点，用 Tab 键把焦点切到左上角菜单，按回车依次进入 Help → Troubleshooting → Enable developer mode
• macOS：直接在左上角菜单中依次进入 Help → Troubleshooting → Enable developer mode

开启后等待软件自动重启。

2. 配置第三方推理网关

用同样的方法打开菜单，依次进入 Developer → Configure third-party inference，按下表填写：

字段	填写内容
Gateway base URL	https://api.nexthub.cc
Gateway auth scheme	x-api-key
Gateway API key	你的 NextHub ApiKey（Claude 系分组）
Skip login-mode chooser	打开

点击右下角 Apply locally 使配置生效。

不要等「测试通过」

这个页面走的是第三方网关模式，不是 Anthropic 官方账号登录校验，不会有、也不用等一个「连接成功 / 测试通过」的提示。点完 Apply locally 直接回对话框发消息，能收到回复就说明配置生效。

3. 验证

新建对话发送一条消息，能正常收到 Claude 回复即接入成功。

第一条消息的小额调用

新建对话后，消费记录里可能出现一笔与你所选模型不同的小额调用——这是客户端自动为对话起标题产生的，金额很小，属正常现象。

用 CC-Switch 配置（可选）

嫌手动流程绕？CC-Switch 自带 Claude Desktop 面板，支持一键导入 Claude Code 里已配置的供应商：

1. 打开 CC-Switch，在左侧应用切换器选择 Claude Desktop（找不到时去 设置 → 通用 → 应用可见性 确认入口未被隐藏）
2. 首次进入点击「将 Claude Code 中已有的供应商导入」；或点右上角 + 手动添加：接口地址填 https://api.nexthub.cc，API Key 填 Claude 系分组的密钥
3. 在供应商卡片上点击「启用」，然后彻底退出并重新打开 Claude Desktop（它不像 Claude Code 那样热重载配置，关窗口不等于退出程序）

重启后的两个警告是误报

完全重启后，对话页面可能弹出「配置未验证」「网络连接」之类的警告条——这是网关模式的常规误报，直接忽略，能正常收发消息就是配置生效。若收不到回复，依次检查：CC-Switch 是否在运行、接口地址与 ApiKey 是否填对、是否忘了完全重启。