返回控制台

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 密钥

  1. 在控制台中打开 API 密钥。
  2. 在 Basic 或 Pro 分组中创建密钥,它以 sk-cs4- 开头。
  3. 复制密钥,先不要关闭页面:完整密钥只显示一次。

开启开发者模式

网关表单位于隐藏的 “开发者”菜单中。开发者模式只是让这个菜单显示出来,不会改动你的文件或聊天记录。

macOS

  1. 打开 Claude 应用,并点击其窗口中的任意位置。
  2. 在屏幕最上方的菜单栏中依次打开:

帮助故障排查启用开发者模式…

英文界面:Help › Troubleshooting › Enable Developer Mode…

Windows

  1. 打开 Claude 应用,点击窗口左上角带三条横线的菜单按钮(☰)。
  2. 依次打开:

帮助故障排查启用开发者模式…

英文界面: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。
Gateway base URLtext
https://api.llmsrelay.com

点击 Apply Changes,再点击 Save & Restart。应用会自动重启。

通过 LLMsRelay 启动应用

重启后,登录界面会提供用你刚才填写的配置启动应用的选项。请选择它,而不是登录 Anthropic 账号。无需输入邮箱或密码。

现在应用以 Claude (third-party) 模式运行。这是一个独立的模式:Chat、Cowork 和 Code 都通过 LLMsRelay 工作,对话保存在这台电脑上,claude.ai 账号里的聊天和项目在这里不可见。

确认请求经过 LLMsRelay

  1. 打开 Code 标签页,在任意文件夹中开始一个会话。
  2. 发送一条简短的测试消息:
测试消息text
只回复一个词:pong
  1. Claude 会回复 pong。在这个模式下,应用没有其他通往模型的路径,所以只要收到回复,就说明请求已经经过 LLMsRelay。
  2. 打开 LLMsRelay 控制台:这条请求会在一分钟内出现在用量记录中。

如需技术层面的确认,在消息框中输入 /status:Anthropic base URL 一行会显示 https://api.llmsrelay.com。

应用中显示的费用按 Anthropic 官方价格估算,仅供参考。实际扣费以 LLMsRelay 控制台为准。

如何选择模型

和平时一样,在 Code 标签页的模型选择器中选择模型。如果某个模型返回 model not found 之类的错误,请换一个,例如 Claude Opus 5.5。

你的密钥可用哪些模型,可以在 模型 页面查看,也可以直接询问网关:

密钥可用的模型bash
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 密钥可以在两处使用。

准备好开始了吗?

2 分钟即可获得 Claude 全系列模型 API 接入。

查看价格