Zivv Docs

主题

Claude Desktop 第三方网关配置 ​

Claude Desktop 的第三方 LLM Gateway 功能允许在不登录 claude.ai 的情况下连接兼容网关。Zivv 提供 Anthropic Messages API 兼容接口，可按官方 Provider 流程配置。

最近核验：2026-07-24。该功能的菜单和可用平台仍可能调整，请优先参考 Anthropic 官方 Claude Apps Gateway 文档。

与 Claude Code 不同

Claude Desktop 使用应用内的 Configure Provider；Claude Code CLI 使用环境变量。两者不要混用配置方式。

准备工作 ​

1. 启用开发者模式 ​

  1. 打开 Claude Desktop。
  2. 进入 Help → Troubleshooting。
  3. 选择 Enable Developer Mode。
  4. 按提示重启应用。

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

2. 配置 Zivv Provider ​

  1. 回到 Claude Desktop 的起始页，暂时不要登录 claude.ai。
  2. 打开 Developer → Configure Provider。
  3. 新建或选择一个配置。
  4. 填写：
配置项值
Gateway base URLhttps://zivv.pro
Gateway API keyZivv 控制台创建的 Key
Add HTTP Headers通常留空
  1. 点击 Apply locally。
  2. 选择 Relaunch now。
  3. 重启后选择 Continue with gateway。

Base URL 不要追加 /v1/messages。Claude Desktop 会按 Anthropic 协议自动拼接请求路径，并发送版本和 Beta 请求头。

3. 验证 ​

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

功能取决于网关与模型

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

多个 Provider ​

如果当前版本提供配置下拉菜单，可选择 New configuration 创建多个 Provider。为每个 Provider 使用不同 Key，便于额度控制、轮换和审计。

安全说明 ​

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

常见问题 ​

看不到 Configure Provider ​

  • 确认已经启用 Developer Mode 并重启
  • 回到未登录的起始页再查看 Developer 菜单
  • 检查当前 Claude Desktop 版本和平台是否支持第三方网关
  • 对照官方文档，不使用旧教程里的隐藏入口

配置后仍要求登录 ​

确认已经点击 Apply locally 并完全重启，然后选择 Continue with gateway，不要选择 claude.ai 登录流程。

401 或无法连接 ​

  • Base URL 使用 https://zivv.pro
  • 检查 Key 是否有效、未过期、未被轮换
  • 用 curl https://zivv.pro/health 检查网络
  • 查看 用量日志 是否收到请求

模型或 Cowork 功能不可用 ​

从模型广场确认当前模型，并检查 Zivv 网关是否已兼容该 Claude Desktop 版本使用的请求字段。必要时先改用 Claude Code 验证基础 Anthropic 协议。

官方资料 ​

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

© 2026 Zivv