Claude Desktop（Chat、Cowork、Code）
通过 Third-Party Inference 将官方 Claude Desktop 应用连接到 GetVibe API：启用 Developer Mode，设置 Gateway 基础 URL，并使用采用 x-api-key 方案的 sk-pv- 密钥。无需 Anthropic 账户即可进行 Chat、Cowork 和 Code。
官方 Claude Desktop 应用（macOS 和 Windows）可以通过第三方网关运行——即 Third-Party Inference 功能。GetVibe API 支持 Anthropic 原生格式（/v1/messages 和 x-api-key 请求头），因此应用可以直接连接，无需转换代理。Chat、Cowork 和 Code 三个标签页均可使用。不需要 Anthropic 账号——请不要登录。Anthropic 文档称，应用会在启动时根据配置的提供商检测第三方（3P）模式；当提供商和凭据存在时，登录界面会提供无需 Anthropic 账号的第三方启动方式，文档没有描述 3P 模式下的区域检查。请参阅 3P 概览 和 安装指南。
适合谁
- Windows 10/11 或 macOS。其它都不用装 —— 不用 Node.js，也不用终端。
- 你只需要 控制台 → API 密钥 里的
sk-pv-…密钥。
1. 安装应用
从官方网站下载 Claude Desktop，安装并启动。在登录界面上，不要登录 Anthropic 账户。
如果 Windows 提示“此应用无法在你的电脑上运行”，说明安装程序与你的处理器不匹配，或下载未完成。检查设置 → 系统 → 系统信息 → 系统类型（x64 或 ARM64），重新下载对应架构的安装程序并运行。
2. 启用开发者模式
在应用自身的菜单中（macOS 为菜单栏；Windows 为登录界面左上角的 ☰）打开 Help → Troubleshooting → Enable Developer Mode。菜单中会出现 Developer 项。
3. 配置 GetVibe API 网关
- 在新的 Developer 菜单中选择 Configure Third-Party Inference…。
- 在 Connection 下将类型切换为 Gateway。
- Gateway base URL：
https://getvibeapi.com，无需/v1，应用会自行追加/v1/messages。 - 凭证类型：静态 API key；认证方案：
x-api-key。 - Gateway API key：你从 Dashboard → API keys 获取的
sk-pv-…key。 - 在测试连接前，先在模型选项卡中手动添加模型：
claude-sonnet-5.5、claude-opus-5.5、claude-haiku-5.5。如果没有至少一个模型，连接测试就无法通过，而且并非所有应用版本都会自动从/v1/models填充列表。
4. 完全重启应用
点击 Apply Changes，然后完全退出应用（用菜单中的 Quit，而不是只关闭窗口）并重新打开。在登录界面选择保存配置后出现的第三方启动方式；不要登录 Anthropic。如果配置设置了 deploymentMode: "3p"（Claude Desktop 4.16336.0+），claude.ai 登录选项会被隐藏。
5. 检查连接
发送任意消息并打开控制台 → 使用情况：应出现带模型和扣费的新记录。若没有，请看下面的「常见问题」——检查不需要终端。
限制
- Windows 上的 Cowork 需要
.msix安装程序，并且必须启用硬件虚拟化（应用侧要求）。 - Anthropic 会为第三方网关禁用某些 beta 功能（例如工具搜索），这是应用限制，而不是你的密钥有问题。
常见问题
| 参数 | 类型 | 描述 |
|---|---|---|
App unavailable in region | screen | 这是应用的首次登录界面，不是我们的网关。Help/☰ 菜单在应用内，不在网站上。请配置 Gateway；如果没有该菜单，请使用 CLI。 |
401 | error | 检查密钥，并确认 Auth scheme 是 x-api-key，而不是 Bearer。 |
404 | error | 网关地址里不能有 /v1 —— 用上面显示的根地址。 |
Models did not appear / “The connection test needs at least one model” | config | 在 Models 选项卡中手动添加这些 ID：claude-sonnet-5.5、claude-opus-5.5、claude-haiku-5.5。 |
“Couldn’t load your organization’s model list”, “Gateway /v1/models was unreachable”, “Can’t reach … provider didn’t respond” | network | The request never reached us — Usage shows no new record. On the same computer open https://getvibeapi.com/v1/models in a browser: it must return a JSON error (the browser sends no key, that is expected). If the page does not open, a VPN, proxy, antivirus or corporate network is cutting the connection. Add the models by hand on the Models tab as well. |
Changes not applied | config | 通过 Quit/Exit 完全退出应用，然后重新打开应用，仅关闭窗口是不够的。 |