跳转到内容
NoviaHub 文档

桌面应用

Claude Desktop

用 Claude Desktop 官方的「第三方推理」功能，把模型请求发到 NoviaHub：安装、开启开发者模式、填写网关、选择模型和排查问题。

Claude Desktop 是 Anthropic 的桌面应用。它官方支持一种「第三方推理」部署方式（Claude Desktop on 3P）：把所有模型请求转发到你配置的推理服务，包括你自己使用的兼容网关。这种方式覆盖 Chat、Cowork 和 Code 三个功能。官方文档主要面向企业部署，但也写了单台电脑的配置方法，本页按单台电脑的方法说明。

Claude Desktop 通过 Anthropic Messages 协议调用模型（必须支持流式输出和工具调用的 POST /v1/messages），NoviaHub 支持这个协议。

前提条件

Section titled “前提条件”
  • 一把 NoviaHub API 密钥，见 API 密钥；账户里有余额，见 钱包与充值。
  • macOS 14 或更新版本；或 Windows 10（build 19041）或更新版本。

安装

Section titled “安装”

从官方下载页 claude.com/download 下载安装：

  • macOS：.dmg 安装包。
  • Windows：.msix 安装包。官方说明 Cowork 功能需要 .msix 版本，不能用 .exe 版本。

配置 NoviaHub

Section titled “配置 NoviaHub”

  1. 打开 Claude Desktop。不要登录或创建 Anthropic 账号。

  2. 在菜单里依次选择 Help → Troubleshooting → Enable Developer Mode，开启开发者模式。

  3. 再选择 Developer → Configure Third-Party Inference…。在 Windows 上，这个菜单在登录界面左上角的 ☰ 按钮里。

  4. 在 Connection 部分，把 Inference provider 选为 Gateway，然后填写：

    字段 填写内容
    Gateway base URL https://noviahub.com
    Gateway API key 你的 NoviaHub 密钥（sk- 开头）
    Credential kind Static API key
    Gateway auth scheme 保持默认的 Bearer（NoviaHub 的 /v1/messages 也接受 x-api-key，两者都可以）

    官方示例里的网关地址只有域名，不带 /v1，所以这里填 https://noviahub.com。

  5. 点 Apply Changes，再点 Save & Restart，Claude Desktop 会重启并使用 NoviaHub。

以后想换回 Anthropic 官方账号，在登录界面选择 Anthropic 登录方式即可。

选择模型

Section titled “选择模型”

没有单独指定模型列表时，Claude Desktop 会请求网关的 GET /v1/models 来获取模型，并且只显示 ID 看得出是 Claude 的模型。NoviaHub 的 /v1/models 只返回你的密钥能用的模型。

2026-09-28 NoviaHub 上的 Claude 系列模型有 claude-opus-5-5、claude-opus-5、claude-sonnet-5、claude-haiku-4-5、claude-fable-5-1、claude-fable-5、claude-opus-4-8，模型会增减，请以 模型&价格 为准。如果给这把密钥设置了「模型限制」，只有被允许的模型会出现。

验证与排查

Section titled “验证与排查”
  • 配置后在对话里发一句话，能正常回答即表示接通；也可以到 NoviaHub 的 使用日志 查看这次调用。
  • 出问题时，选择 Help → Troubleshooting → Generate Diagnostic Report → Export to file 导出诊断报告，查看其中的 provider-status.txt 和 deployment-mode.txt。
  • 如果提示 Gateway was unreachable，说明 Claude Desktop 连不上填写的网关地址，检查 Gateway base URL 是否为 https://noviahub.com，以及网络是否能访问 NoviaHub。
  • 配置文件保存在：macOS ~/Library/Application Support/Claude-3p/configLibrary/，Windows %LOCALAPPDATA%\Claude-3p\configLibrary\。

参考资料

Section titled “参考资料”

以下资料查阅于 2026-09-28：