Claude 桌面版（App）

Claude 桌面版的 **第三方推理模式（3P）**提供网关入口，可用于 Chat、Cowork 和 Code。这里配置的是桌面 App；终端用户请看 Claude Code CLI。

三步配置

安装桌面版，打开第三方推理窗口

macOS
Windows
Linux

下载 macOS 安装包（Universal，兼容 Intel / Apple Silicon），安装后从 Applications / 应用程序打开 Claude。Help 入口在屏幕顶部菜单栏。

下载匹配 x64 或 ARM64 的 Windows 安装包，安装后从开始菜单打开 Claude，点击左上角应用菜单 ☰。这是 Windows 桌面版，不是在 WSL 中安装 Linux 桌面版。

Linux 测试版：Ubuntu 22.04+ / Debian 12+，x64 / ARM64。 先安装依赖并下载官方软件源签名密钥：

sudo apt update && sudo apt install curl gnupg
sudo curl -fsSLo /usr/share/keyrings/claude-desktop-archive-keyring.asc https://downloads.claude.ai/claude-desktop/key.asc
gpg --show-keys /usr/share/keyrings/claude-desktop-archive-keyring.asc

确认显示的指纹为 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE 后，添加软件源并安装：

echo "deb [arch=amd64,arm64 signed-by=/usr/share/keyrings/claude-desktop-archive-keyring.asc] https://downloads.claude.ai/claude-desktop/apt/stable stable main" | sudo tee /etc/apt/sources.list.d/claude-desktop.list
sudo apt update && sudo apt install claude-desktop

从应用启动器打开 Claude，或运行 claude-desktop，再打开应用的 Help 菜单。Fedora / RHEL / Arch 暂不在桌面版支持范围内，可用 Claude Code CLI。

在应用中打开 Help → Troubleshooting → Enable Developer Mode，等待重启后，再打开 Developer → Configure Third-Party Inference…。Linux 3P 本机配置也使用此窗口。设备已有管理员配置时，该窗口可能只读，需要管理员修改。

选择 Gateway，填写 ABCRelay 配置

在 Connection 中填写：

字段	填写内容
`Inference provider`	`Gateway`
`Gateway base URL`	`https://www.abcrelay.com`
`Credential kind`	`Static API key`
`Gateway API key`	你在 ABCRelay 创建的 API Key
`Gateway auth scheme`	`Bearer`

地址不带 /v1： Gateway base URL 填 https://www.abcrelay.com。桌面版使用完整的 /v1/messages 路径，最终请求为 https://www.abcrelay.com/v1/messages；模型发现使用 https://www.abcrelay.com/v1/models。三个系统相同。Key 不加 Bearer 。在 Models 检查可用 Claude 模型；如自动发现失败，关闭 Model discovery，在 Model list 添加控制台提供的准确 Claude 模型 ID。

应用配置，验证一条消息

点击 Apply Changes，让应用保存本机配置并重新启动。在模型选择器中选中配置的 Claude 模型，打开 Chat，发送 只回复 OK。在 ABCRelay 控制台核对同一时间、同一令牌和模型的调用记录。确认后再使用 Cowork 或 Code；实际调用会消耗额度，短消息成功不代表所有工具功能均已验证。

FAQ 与详细说明

为什么 Codex 带 /v1，Claude Code 却不带？

它们追加的接口路径不同：Codex 追加 /responses，Claude Code 追加 /v1/messages，所以基础地址不能互相照抄。此规则取决于客户端的配置字段和模式，与系统或模型品牌无关。其他客户端见API 地址对照表。

macOS、Windows、Linux 和 WSL 有什么差别？

上面的网关字段通用；桌面版的本机 3P 配置保存位置如下：

系统	本机配置目录
macOS	`~/Library/Application Support/Claude-3p/configLibrary/`
Windows（资源管理器 / CMD）	`%LOCALAPPDATA%\Claude-3p\configLibrary\`
Windows（PowerShell）	`$env:LOCALAPPDATA\Claude-3p\configLibrary\`
Linux	`~/.config/Claude-3p/configLibrary/`

点击 Apply Changes 保存后，回到 App 的第三方推理配置窗口选择并修改正在使用的条目。上表中的完整目录路径可直接复制；这里是配置目录，没有通用的固定文件名。目录不存在时，请先通过 App 保存一份本机配置。推荐通过配置窗口修改；这里是已保存配置的目录，不是 CLI 的用户配置文件（~/.claude/settings.json；Windows 资源管理器：%USERPROFILE%\.claude\settings.json）。Linux 管理员也可下发 /etc/claude-desktop/managed-settings.json，需满足官方的所有者和权限要求。Windows 的 Code 本机会话需要 Git for Windows。Linux 的 Cowork 还需要硬件虚拟化、QEMU 与 KVM 权限，按官方 Linux 说明配置；Linux 测试版尚无 Computer Use 和语音输入。WSL 2 用户安装 Windows 桌面 App；本页网关模式仍遵循下方本机会话限制。若要在 WSL 发行版内工作，可使用独立配置的 Claude Code CLI。

Claude、Claude Code、Chat 和 Code 分别是什么？

Claude 桌面 App 包含 Chat、Cowork 和 Code 等入口；Claude Code CLI 是独立的终端客户端。本页使用官方的 Claude Desktop on 3P 部署模式，按配置将模型请求送往网关，本地保存会话。普通 Claude 账号登录模式、claude.ai 网页和手机 App 不能通过这一份桌面配置自动改走 ABCRelay。Claude 订阅与 ABCRelay API 余额也不互通。

为什么改 settings.json 或环境变量没效果？

官方说明桌面 App 的网关路由来自第三方推理配置，不从 ANTHROPIC_BASE_URL 或 CLI 用户配置（~/.claude/settings.json；Windows 资源管理器：%USERPROFILE%\.claude\settings.json）读取。请使用本页的配置窗口和 Apply Changes。Export 用于导出 MDM 或其他部署文件；单机配置不需要先导出。设备受组织管理时，管理员下发的配置优先，窗口会显示只读值。

模型列表为空，或选了模型后报不存在怎么办？

自动发现依赖网关的 GET /v1/models。若响应不能用于桌面版发现，在 Models 关闭 Model discovery，填写 Model list。模型名称必须是令牌可用的准确 Claude API ID。官方配置键对应 modelDiscoveryEnabled 和 inferenceModels，例如：

{
  "modelDiscoveryEnabled": false,
  "inferenceModels": ["YOUR_CLAUDE_MODEL_ID"]
}

这只是字段示例；推荐在窗口里编辑，不要覆盖其他配置。列表第一个模型为默认值。不要把展示名称或未经确认的 [1m] 变体当作模型 ID。

Gateway was unreachable、401 或 404 怎么办？

Gateway was unreachable：检查电脑能否访问根地址及本机网络路径。401：检查 Key 原文、撤销状态与权限；当前示例使用 Bearer，只有管理员明确要求时才切换 x-api-key。404：不要把 /v1、/messages 加到根地址末尾。网关必须支持 Anthropic POST /v1/messages、流式响应和工具调用；OpenAI 协议兼容不等于满足桌面版要求。更详细的错误见故障排查。

Code、Cowork 和远程功能都能直接使用吗？

官方 3P 模式涵盖 Chat、Cowork 和 Code，但可用功能仍取决于桌面版系统要求、所选 Claude 模型和渠道的工具与流式能力。网关配置生效后，Code 使用本地会话，不提供 SSH、Anthropic 托管云环境或 Remote Control。远程主机接入可在该主机使用 CLI。Cowork / Code 还依赖本地执行环境及官方组件下载。不要将一次聊天成功理解为完整代理功能通过实测。

为什么桌面版预估费用和 ABCRelay 账单不同？

桌面版可展示按 Anthropic 标价或自定义参数计算的预估费用；ABCRelay 的实际计费以本站控制台为准。多轮 Cowork / Code 会附带上下文并调用工具，使用量通常比一条普通聊天多。网关应正确转发 cache_control 和上游缓存用量字段。持续没有缓存命中时，应检查渠道缓存支持与请求转换，而非假定客户端显示的估算就是账单。

官方参考与核对日期

核对日期：2026-09-10。已核对官方第三方推理入口、字段与模式边界，未使用真实用户 Key 对 Chat、Cowork、Code 逐项完成端到端实测。请通过回复和 ABCRelay 调用记录确认自己的配置。

开始使用

官方桌面应用

图形聊天

终端编程

编辑器与插件

代理系统

帮助

Claude 桌面版（App）

三步配置

FAQ 与详细说明

​三步配置

​FAQ 与详细说明

三步配置

FAQ 与详细说明