Claude 桌面 APP 配置教程

在 MacOS / Linux / Windows 上配置 Claude 桌面 APP 接入 ApirelayApi

下载 Claude App

访问 Claude 官方下载页获取桌面 App。下载页面需要能访问外网。

https://claude.com/download

系统要求

MacOS 或 Linux 系统，已安装 Git，并能编辑本地 JSON 配置文件

配置步骤

配置文件： ~/Library/Application Support/Claude-3p/claude_desktop_config.json
1

完全退出 Claude App

先完全退出 Claude App，不能只是关闭窗口。确认菜单栏或进程里已经没有 Claude App 在运行。

2

找到配置文件目录

打开下面路径中的配置文件。如果文件不存在，可以手动新建 claude_desktop_config.json。

~/Library/Application Support/Claude-3p/claude_desktop_config.json
3

写入中转配置

将下面内容写入配置文件，并把 inferenceGatewayApiKey 替换为你在 ApirelayApi 创建的密钥。写入前建议先备份原配置；inferenceModels 可以按需调整为你希望在 App 内快速切换的模型。

{
  "enterpriseConfig": {
    "inferenceProvider": "gateway",
    "inferenceGatewayBaseUrl": "https://apirelay.aiserverapp.com",
    "inferenceGatewayApiKey": "替换为你的密钥",
    "inferenceGatewayAuthScheme": "auto",
    "disableAutoUpdates": true,
    "disableEssentialTelemetry": true,
    "disableNonessentialTelemetry": true,
    "disableNonessentialServices": true,
    "inferenceModels": [
      "claude-opus-4-7",
      "claude-sonnet-4-7"
    ],
    "deploymentOrganizationUuid": "00000000-0000-4000-8000-000000000001"
  }
}
4

首次启动等待 workspace 资源下载

首次启动会拉取 downloads.claude.ai 的 VM/rootfs 资源。如果卡在 Setting up Claude's workspace...，请临时切换到能访问外网的网络，完成一次下载即可。

重启 App 后新建对话测试

重新启动 Claude App，新建一个对话并发送测试消息，确认请求已经通过 ApirelayApi 网关转发。

首次启动注意事项

首次启动 Claude App 时，如果停在 Setting up Claude's workspace...，通常是 workspace 资源下载受阻。请临时切换到能访问外网的网络，完成第一次下载后再回到常用网络。