Claude 桌面版接第三方 API：Configure Third-Party Inference 配置与排错

Wokey Team · 2026-09-24

结论先说： Claude 桌面版接第三方 API 只有一个入口：Developer → Configure Third-Party Inference。它不读 ANTHROPIC_BASE_URL，也不读 ~/.claude/settings.json，所以终端里好用的配置搬到桌面版会完全没反应。这篇按遇到的问题排查：菜单找不到、配置不生效、模型列表是空的，以及哪些功能在第三方模式下本来就用不了。完整的首次配置步骤见 Claude Desktop 接入文档。

正确的配置顺序

1. 启动桌面版，不要登录 Anthropic 账号。

2. 打开 Help → Troubleshooting → Enable Developer Mode。

3. 打开 Developer → Configure Third-Party Inference…。

4. 在 Connection 里把 Inference provider 设为 Gateway，然后填 Gateway credentials：

   字段	填什么
   Gateway base URL	https://api.wokey.ai（不带 /v1）
   Gateway API key	你的 Wokey API Key
   Credential kind	Static API key
   Gateway auth scheme	Bearer（Wokey 也接受 x-api-key，保持默认即可）

5. 点 Apply Changes，再点 Save & Restart。

系统要求：macOS 14（Sonoma）或更高，Apple 芯片和 Intel 都支持；Windows 10 build 19041 或更高，x64 和 Arm64 都支持。

找不到 Developer 菜单

Developer 菜单要先开启开发者模式才会出现：Help → Troubleshooting → Enable Developer Mode。Help 菜单里也没有这一项时，先把桌面版更新到最新版本，旧版本没有第三方推理的配置入口。

配置窗口是只读的

这台电脑上已经有一份管理员下发的配置（比如公司通过 MDM 推送的描述文件）时，配置窗口会以只读模式打开，本地改不了。这种情况要找管理员调整，或者换一台不受管理的电脑。

设了环境变量但不生效

这是最常见的误区。桌面版的网关设置只来自第三方推理配置，不读 ANTHROPIC_BASE_URL，也不读 settings.json。桌面版里的 Code 标签页也一样：它运行的是和 CLI 相同的 Claude Code 引擎，但网关地址和凭证直接继承自桌面版的配置，你在 ~/.claude/settings.json 里的用户级设置覆盖不了它们。

反过来，桌面版的配置也不影响终端里的 claude。两边要分别配置，终端的配置方法见 Claude Code base URL 指南。

模型列表是空的，或者少了模型

没有手动指定模型列表时，桌面版会请求网关的 GET /v1/models，并且只保留 ID 看得出是 Claude 的模型。所以通过 Wokey 自动发现时，列表里只会出现 claude-opus-5、claude-sonnet-5 这类模型，GPT、Grok 等模型会被过滤掉，这是正常现象。

想固定列表或指定默认模型，在配置窗口的模型列表（Model list，对应配置键 inferenceModels）里写完整的模型 ID。几条规则：

• 第一个就是默认模型，Code 标签页的新会话也用它。
• 所有条目都写完整 ID 时，桌面版会跳过 /v1/models 请求。
• /v1/models 请求失败、而模型列表又是空的，选择器就是空的。

报错排查

Gateway was unreachable：桌面版连不上网关。先检查 Gateway base URL 有没有拼错，再在终端里用 curl 测一次：

curl -X POST https://api.wokey.ai/v1/messages \
  -H "Authorization: Bearer 你的 Wokey API Key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":1,"messages":[{"role":"user","content":"."}]}'

curl 能通、桌面版不通，多半是代理：终端走了代理，桌面版没走，或者反过来。

401 且 code 是 invalid_api_key：请求到了 Wokey，但 key 缺失或写错。Wokey 两种认证方式都接受，所以不用改 auth scheme，重新粘贴 key 即可。

看到 invalid x-api-key：请求发到了 Anthropic 官方，说明第三方推理配置没有生效。通常是没点 Save & Restart，或者启动后又在登录页选了 Anthropic 账号登录。详见 invalid x-api-key 报错指南。

要看更多细节：用 Help → Troubleshooting → Generate Diagnostic Report 导出诊断报告，里面的 managed-config.txt、provider-status.txt 和 deployment-mode.txt 分别记录生效的配置、网关连接状态和当前模式。日志在：

• macOS：~/Library/Logs/Claude-3p/main.log
• Windows：%LOCALAPPDATA%\Claude-3p\Logs\main.log

第三方模式下用不了的功能

下面这些功能依赖 Anthropic 账号或 Anthropic 的云端服务，接网关后不可用，不是配置问题：

• 手机端同步和 claude.ai 网页版访问
• 语音模式
• 项目和插件分享
• Claude Design、Claude Security、Claude Tag
• Computer use
• Remote Control，以及 Anthropic 托管的云端环境

另外有两项默认关闭：

• 工具搜索（tool search）和实验性 beta 功能。 桌面版为了兼容严格的网关默认关掉了它们，需要时用 toolSearchEnabled 打开。
• SSH 远程会话。 第三方模式下还是 beta，需要管理员配置主机白名单才能用。

换回官方账号

在登录页选择 Anthropic 账号登录，就会回到普通的 Claude 桌面版。