使用 Claude Desktop
本文说明如何通过 Claude Desktop 的第三方推理 Gateway 使用 ClawdRouter。该配置适用于支持 Developer Mode 和 Third-Party Inference 的 Claude Desktop 版本。
准备工作
- 已安装最新版 Claude Desktop。
- API Key。
- 可调用的 Claude 兼容模型 ID。
1. 启用开发者模式
- 启动 Claude Desktop。
- 打开 Help > Troubleshooting。
- 点击 Enable Developer Mode。
启用后,菜单栏会出现 Developer 菜单。
2. 打开第三方推理配置
在菜单栏中选择:
3. 填写 Gateway 信息
选择 Gateway (Anthropic-compatible),并填写:
| 字段 | 值 |
|---|---|
| Gateway base URL | __DOCS_API_ORIGIN__ |
| Gateway API key | YOUR_API_KEY |
| Gateway auth scheme | bearer |
点击 Apply locally 保存。
4. 重启并选择模型
-
完全退出 Claude Desktop,而不是只关闭窗口。
-
重新打开应用。
-
在启动页选择 Continue with Gateway 或 Local configuration。
-
在模型选择器中选择你有权限使用的模型。
常见问题
看不到 Developer 菜单
请确认已在 Help > Troubleshooting 中启用 Developer Mode,并完全重启应用。
看不到 Continue with Gateway
确认已点击 Apply locally,然后完全退出并重新启动 Claude Desktop。
无法连接或出现认证错误
检查 Gateway base URL、API Key 与 auth scheme。auth scheme 必须为 bearer。
模型列表为空
请确认 API Key 有可用模型权限;如有账户额度或权限控制,也需要先满足相关要求。
WebFetch 或联网工具被阻止
打开 Developer > Configure Third-Party Inference…,在 Sandbox & workspace 中将需要访问的主机加入允许列表。