Claude Desktop

在 Claude Desktop 应用（Code 标签页）中通过 OneProvider 运行 Claude Code，无需 Claude 账号。

带有 Code 标签页的 Claude Desktop 应用

支持的功能

Code 标签页（带图形界面的 Claude Code）和 Cowork 通过 Claude Desktop 内置的网关模式（Anthropic 称之为第三方推理）在 OneProvider 上运行。不需要 Claude 或 Anthropic 账号。支持 macOS 14+ 和 Windows 10 (2004) 或更新版本，包括 Windows 11。

客户端限制

网关模式仅限本地：会话在您的电脑上运行，没有云端会话、SSH 或 Remote Control。Desktop 从下面的表单读取网关，而不是从 ANTHROPIC_BASE_URL 或 ~/.claude/settings.json（那些用于 Claude Code 命令行）。没有这个表单时，Desktop 只有在持有付费 Claude 订阅时才能打开。

设置

1. 安装 Claude Desktop，不要登录

   从 claude.com/download 下载应用（macOS：.dmg，把 Claude 拖到“应用程序”；Windows：.msix 安装包）并启动。请停留在登录界面：不要登录，也不要创建 Anthropic 账号。

2. 开启开发者模式

   macOS：在菜单栏选择 Help → Troubleshooting → Enable Developer Mode（帮助 → 故障排查 → 启用开发者模式）。Windows：点击登录界面左上角的应用菜单 ☰，然后选择 Help → Troubleshooting → Enable Developer Mode。应用会重启并出现 Developer 菜单，重启后它会一直保留。

3. 打开 Configure Third-Party Inference

   选择 Developer → Configure Third-Party Inference…（配置第三方推理）。在 Connection 部分把 Inference provider 设为 Gateway，并按所示填写 Gateway credentials 卡片。base URL 必须恰好如下，不带 /v1，也不带后续路径；把您的 OneProvider 密钥粘贴到 Gateway API key。

   Inference provider: Gateway
   Gateway base URL: https://api.oneprovider.dev
   Gateway API key: sk-your-key-here
   Credential kind: Static API key
   Gateway auth scheme: Bearer (x-api-key also works)

4. 检查模型列表

   先让 Models 留空：Desktop 会请求 https://api.oneprovider.dev/v1/models，并显示目录中的 Claude 模型。如果选择器仍然为空，请打开 Models 部分，从模型目录中添加准确的 Claude 模型 ID（<your-compatible-model-id>）；第一项是新 Code 会话的默认模型。

5. 应用、重启并以网关模式启动

   点击 Apply Changes，再点击 Save & Restart。重启后，登录界面会提供使用您的推理服务商配置启动的选项：请选择该选项，而不是 Anthropic 登录。打开 Code 标签页，选择一个本地项目文件夹并发送一条消息。

验证连接

在个人中心确认请求

在新的 Code 会话中发送一条简短消息。一分钟内，该请求应出现在个人中心的“用量”下，并显示模型、token 数和扣费。如果失败：

没有服务商选项的标准登录界面 → 表单没有生效：请完全退出应用（macOS 用 Cmd+Q，Windows 用任务管理器）后重新打开
"Gateway was unreachable" → 检查 base URL（必须恰好是 https://api.oneprovider.dev），并关闭 VPN 或代理
401 → 密钥有误、已被撤销或已过期：请在个人中心的“密钥”中检查
429 insufficient balance → 为个人中心充值余额，然后重新发送
模型选择器为空 → 在 Models 部分添加模型 ID
"Error 403: Forbidden" → 您走的是 Anthropic 登录路径：请改选服务商选项
Desktop 实际应用的内容：Help → Troubleshooting → Generate Diagnostic Report → Export to file（managed-config.txt、provider-status.txt）
日志：~/Library/Logs/Claude-3p/main.log（macOS）或 %LOCALAPPDATA%\Claude-3p\Logs\main.log（Windows）

连接信息

协议

anthropic

接口地址

https://api.oneprovider.dev

密钥安全

密钥只保存在这台电脑上 Desktop 的配置中。请使用带消费限额的专用密钥；如果电脑是共用的或密钥泄露，请在个人中心删除或暂停该密钥，您其余的余额仍然安全。

快速解答

该使用哪个 base URL？

Claude Code 和 Anthropic SDK 使用 https://api.oneprovider.dev。OpenAI SDK 和兼容 OpenAI 的客户端使用 https://api.oneprovider.dev/v1。同一个密钥可用于这两个地址；模型列表见模型页面 ，费率见价格页面 。

如何进行身份验证？

将完整的 sk-… 密钥放在 x-api-key 或 Authorization: Bearer 中，二选一，不要同时使用。请把密钥存放在环境变量中，不要写进会被提交的文件。了解更多身份验证说明 。

在哪里获取密钥？

在 Telegram 机器人 @oneprovider_robot 或 app.oneprovider.dev 打开您的个人中心，为余额充值，然后点击“签发密钥”。每个密钥都可以设置各自的消费限额。个人中心与 API 密钥 。

401、404 和 429 是什么意思？

401：密钥缺失、拼写有误或放错了请求头；请粘贴完整的密钥，不要带引号或空格。404：通常是 base URL 不对，例如缺少或重复了 /v1。429 且提示“Insufficient balance”：个人中心余额或密钥的消费限额已用完，请充值，不要反复重试；其他 429 属于速率限制，请等待 Retry-After 指定的时间。详情见：错误码 和故障排查 。

流式输出为什么会中断或被重置？

VPN 和 VLESS 代理常常会缓冲 SSE，或破坏 HTTP/2 协商。OneProvider 没有地区限制，也不会缓冲流式输出，请关闭代理后重试。

以上都没解决，该去哪里咨询？

请在 Telegram 联系 @Oneproviderhelpbot ，或在网页个人中心打开“客服”，并附上 HTTP 状态码和完整的错误信息。客服如何运作 。