Claude 桌面应用:自定义 Base URL 与 API 密钥
在 macOS 或 Windows 上把 Claude 桌面应用接入 LLMsRelay:开启开发者模式,打开“配置第三方推理”,填写 https://api.llmsrelay.com 和密钥,并在 Code 标签页中验证。
LLMsRelay 是独立运营的 API 网关,与 Anthropic, PBC 无隶属或授权关系。产品和模型名称仅用于说明兼容性。
位置: 开发者 → 配置第三方推理. Gateway base URL: https://api.llmsrelay.com. Gateway API key: sk-cs4-*. 密钥分组: Basic 或 Pro. Claude 订阅: 不需要.
准备工作
- macOS 或 Windows 版 Claude 桌面应用,从 claude.com/download 下载。如果很久没有更新,请先更新:新版本才有第三方推理表单。
- 有余额的 LLMsRelay 账户。余额为空时,请在 套餐 页面购买一次性用量包。
- 大约十分钟。不需要 Claude Pro 或 Max 订阅。
创建 LLMsRelay 密钥
- 在控制台中打开 API 密钥。
- 在 Basic 或 Pro 分组中创建密钥,它以
sk-cs4-开头。 - 复制密钥,先不要关闭页面:完整密钥只显示一次。
开启开发者模式
网关表单位于隐藏的 “开发者”菜单中。开发者模式只是让这个菜单显示出来,不会改动你的文件或聊天记录。
macOS
- 打开 Claude 应用,并点击其窗口中的任意位置。
- 在屏幕最上方的菜单栏中依次打开:
帮助故障排查启用开发者模式…
英文界面:Help › Troubleshooting › Enable Developer Mode…
Windows
- 打开 Claude 应用,点击窗口左上角带三条横线的菜单按钮(☰)。
- 依次打开:
帮助故障排查启用开发者模式…
英文界面:Help › Troubleshooting › Enable Developer Mode…
应用会弹出 “启用开发者模式?”对话框,并提示这会开放开发者工具和调试功能。点击 “启用”(Enable)。应用会自动重启。重启后,“帮助”旁边会出现 “开发者”(Developer)菜单;在 Windows 上,它位于 ☰ 按钮里。
打开第三方推理表单
开发者配置第三方推理…
英文界面:Developer › Configure Third-Party Inference…
此时会打开一个单独的设置窗口。即使应用界面是中文,这个窗口也是英文的。它保存的是应用把模型请求发往哪里、使用哪个密钥。
填写 LLMsRelay 网关
请严格按下表填写。表中没有列出的字段保持为空。
- Inference provider
- Gateway
- Gateway base URL
https://api.llmsrelay.com:结尾不要加/v1,也不要加斜杠- Credential kind
- Static API key(如果有这个字段)
- Gateway API key
- 第 1 步中的密钥,以
sk-cs4-开头 - Gateway auth scheme
- 保留 bearer。LLMsRelay 也支持
x-api-key。
https://api.llmsrelay.com点击 Apply Changes,再点击 Save & Restart。应用会自动重启。
通过 LLMsRelay 启动应用
重启后,登录界面会提供用你刚才填写的配置启动应用的选项。请选择它,而不是登录 Anthropic 账号。无需输入邮箱或密码。
现在应用以 Claude (third-party) 模式运行。这是一个独立的模式:Chat、Cowork 和 Code 都通过 LLMsRelay 工作,对话保存在这台电脑上,claude.ai 账号里的聊天和项目在这里不可见。
确认请求经过 LLMsRelay
- 打开 Code 标签页,在任意文件夹中开始一个会话。
- 发送一条简短的测试消息:
只回复一个词:pong- Claude 会回复
pong。在这个模式下,应用没有其他通往模型的路径,所以只要收到回复,就说明请求已经经过 LLMsRelay。 - 打开 LLMsRelay 控制台:这条请求会在一分钟内出现在用量记录中。
如需技术层面的确认,在消息框中输入 /status:Anthropic base URL 一行会显示 https://api.llmsrelay.com。
应用中显示的费用按 Anthropic 官方价格估算,仅供参考。实际扣费以 LLMsRelay 控制台为准。
如何选择模型
和平时一样,在 Code 标签页的模型选择器中选择模型。如果某个模型返回 model not found 之类的错误,请换一个,例如 Claude Opus 5.5。
你的密钥可用哪些模型,可以在 模型 页面查看,也可以直接询问网关:
curl https://api.llmsrelay.com/v1/models \
-H "x-api-key: 你的_SK_CS4_密钥"第三方模式下有哪些变化
- Chat、Cowork 和 Code 都通过 LLMsRelay 工作,费用从 LLMsRelay 余额中扣除。
- 对话保存在这台电脑上,而不是 Claude 账号中。
- Cowork 需要 macOS 14 或更高版本;在 Windows 上需要通过
.msix安装包安装的应用。Chat 和 Code 没有这个要求。 - Remote Control 不可用:无法在手机或 claude.ai/code 上继续这些会话。
- 环境选择器中不再提供 Anthropic 托管的云端环境。
- 配置只保存在这台电脑上。需要相同配置的每台电脑都要重复以上步骤。
如何切换回 Claude 账号
在登录界面选择 Anthropic 登录,而不是第三方选项。LLMsRelay 配置会保留,之后可以用同样的方式切换回来。如需修改密钥或地址,随时重新打开 开发者 → 配置第三方推理…。
开发者模式可以保持开启:它只是多了一个“开发者”菜单,不影响使用 Claude 账号。
常见问题排查
找不到“开发者”菜单
开发者模式没有开启,或者应用还没有重启。请重复第 2 步并等待重启。在 Windows 上,该菜单位于左上角的 ☰ 按钮中。如果“故障排查”里没有“启用开发者模式”,请更新应用。
登录界面没有第三方选项
应用没有读取到配置。如果在应用仍在运行时保存了配置,就会出现这种情况。请完全退出应用(macOS 上按 Cmd+Q,Windows 上在 ☰ 菜单中选择 Exit),然后重新打开。同时确认 Inference provider 选择的是 Gateway,地址和密钥都已填写。
提示“Gateway was unreachable”或“Can’t reach your inference provider”
应用无法连接到该地址。请确认 Gateway base URL 准确填写为 https://api.llmsrelay.com。在浏览器中打开 api.llmsrelay.com/healthz:如果打不开,说明 VPN、代理或防火墙拦截了连接。
提示“The configured API key was rejected by the inference provider”
网关没有接受这个密钥。重新打开表单,再粘贴一次密钥,注意不要带空格。在 API 密钥 中确认它属于 Basic 或 Pro 分组且没有被撤销。
因余额不足导致请求停止
在 套餐 页面充值。充值后密钥立即恢复可用,应用中无需任何改动。
应用仍在使用 Claude 账号
应用是通过 Anthropic 登录启动的,而不是用推理服务商配置启动,或者配置没有保存。打开表单检查各项值,重启应用;如果应用打开了 claude.ai 账号,先退出登录,再在登录界面选择推理服务商选项。LLMsRelay 控制台里看不到的请求,就没有经过 LLMsRelay。
终端可用而桌面应用不可用(或相反)
两者是分开配置的。终端和编辑器读取 ~/.claude/settings.json,桌面应用读取自己的第三方推理表单。同一个 LLMsRelay 密钥可以在两处使用。