Zivv Docs

主题

Claude Desktop 第三方网关配置 ​

Claude Desktop 的第三方推理（Third-Party Inference）功能允许在不登录 claude.ai 的情况下，把模型请求发送到兼容网关。Zivv 提供 Anthropic Messages API 兼容接口，可按官方的 Gateway Provider 流程配置。

最近核验：2026-10-23。应用内配置入口在近期版本中改名为 Configure Third-Party Inference，本页已对照 Anthropic 官方 Claude Desktop 第三方推理文档更新菜单、字段和按钮名称。界面仍可能随版本调整，请优先参考官方文档。

与 Claude Code 不同

Claude Desktop 使用应用内的 Configure Third-Party Inference 窗口；Claude Code CLI 使用 ANTHROPIC_BASE_URL 等环境变量。两者不要混用配置方式。

准备工作 ​

1. 启用开发者模式 ​

  1. 打开 Claude Desktop。macOS 在顶部菜单栏操作；Windows 在登录页左上角的应用菜单 ☰ 中操作。
  2. 进入 Help → Troubleshooting → Enable Developer Mode。
  3. 按提示重启应用。

启用后应用会显示 Developer 菜单。注意：如果在应用已经运行某个第三方配置时才开启开发者模式，它会在重启后保留；如果是在此之前开启的，应用重新载入第三方配置后（例如执行 Apply Changes 之后）Developer 菜单可能消失，重新执行上面的 Enable Developer Mode 即可长期保留。

如果菜单名称与这里不同，请停止操作并查看 Claude Desktop 第三方推理官方文档，不要按旧版截图修改内部文件。

2. 配置 Zivv 网关 ​

  1. 打开 Developer → Configure Third-Party Inference…，进入应用内配置窗口。
  2. 在左侧分组中先填写 Connection。
  3. 将 Inference provider 设为 Gateway。
  4. 在 Gateway credentials 卡片中填写：
配置项值
Gateway base URLhttps://zivv.pro
Gateway API keyZivv 控制台创建的 Key
Credential kindStatic API key（默认）
Gateway auth schemeBearer（默认，Zivv 同时兼容 x-api-key）
  1. 点击 Apply Changes：该操作把配置写入本机并重启应用载入它（官方的单机 / 评估路径）。

Gateway base URL 不要追加 /v1/messages。Claude Desktop 会按 Anthropic 协议自动拼接 POST /v1/messages，并发送版本和 Beta 请求头。该功能要求网关实现 Anthropic Messages API（含流式与工具调用）。Zivv 同时提供 Anthropic 格式的 GET /v1/models，Claude Desktop 会据此自动发现模型，但只显示能识别为 Claude 的模型 ID。

导出给团队

配置窗口的 Export 菜单可生成 .mobileconfig（macOS）、.reg（Windows）、ADMX、Profile Manifest、JSON 配置或出口域名清单，用于 MDM 批量下发。个人接入只需用 Apply Changes 写入本机即可，不必导出。

3. 验证 ​

  1. 在新会话中发送“只回复 pong”。
  2. 确认响应可以正常流式输出。
  3. 在 用量日志 核对模型、Token 和状态码。
  4. 基础对话成功后，再测试 Cowork、工具调用和本地文件操作。

功能取决于网关与模型

普通对话成功不代表 Cowork、工具调用、扩展思考或所有 Claude 专属能力都可用。Claude 应用会使用随版本更新的模型和 Beta 功能，Zivv 需要兼容对应请求格式，所选模型也必须具备相应能力。

使用不同的 Key ​

应用内配置窗口每台设备写入一份生效配置。需要为不同用途隔离额度时，到 令牌管理 创建多个 Key，并为每个 Key 设置独立的额度、有效期和模型范围；切换时在配置窗口更新 Gateway API key 后重新 Apply Changes 即可。

安全说明 ​

  • Developer Mode 会增加本地调试能力，只在可信设备上启用
  • Gateway 凭证保存在本机，不要在截图或录屏中暴露
  • 不要为桌面端使用生产服务的高权限 Key
  • 为 Key 设置额度、有效期和模型范围
  • Claude Desktop 的隐私、遥测和第三方推理数据流以 Anthropic 当前说明为准

常见问题 ​

看不到 Configure Third-Party Inference ​

  • 确认已经启用 Developer Mode 并重启
  • 从 macOS 菜单栏或 Windows 登录页左上角的 ☰ 菜单查看 Developer 菜单
  • 如果重启后 Developer 菜单消失，重新执行 Help → Troubleshooting → Enable Developer Mode
  • 检查当前 Claude Desktop 版本和平台是否支持第三方推理
  • 若设备已被管理配置（MDM）接管，配置窗口会以只读方式打开，显示已下发的值

配置后仍要求登录或窗口只读 ​

确认已经点击 Apply Changes 并完成重启。如果窗口只读，说明本机存在管理配置；请在没有管理配置的设备上创建新配置，或联系管理员调整下发内容。

401 或无法连接 ​

  • Gateway base URL 使用 https://zivv.pro
  • 检查 Key 是否有效、未过期、未被轮换
  • 确认 Gateway auth scheme 与 Key 发送方式匹配（Zivv 同时兼容 Bearer 和 x-api-key）
  • 用 curl https://zivv.pro/health 检查网络
  • 查看 用量日志 是否收到请求

模型列表为空或 Cowork 功能不可用 ​

从模型广场确认当前模型。自动发现只显示能识别为 Claude 的模型 ID；列表为空或缺少所需模型时，在配置窗口的模型设置中显式填写模型广场里的完整模型 ID。并检查 Zivv 网关是否已兼容该 Claude Desktop 版本使用的请求字段；必要时先改用 Claude Code 验证基础 Anthropic 协议。

官方资料 ​

Zivv — OpenAI / Anthropic / Gemini 多协议 AI Gateway

© 2026 Zivv