Claude Code 桌面 App

这篇只写 Claude 桌面 App 里的 Code。命令行见Claude Code CLI 接入。VS Code 扩展和 JetBrains 插件见VS Code 与 JetBrains。

桌面 App 的 Code 页跑的是 Claude Code，不是 claude.ai 网页里的普通聊天。侧边栏顶部的 Code 才是 Claude Code。

claude.ai 网页和手机 App 里的普通聊天不能填第三方 Key。 那里只认 Claude 账号。claude.ai/code 上的云端会话同样走 Claude 订阅，不读你电脑上的配置。

下载安装

下面的地址核对自 Anthropic 官方页面（2026-11-02）：claude.com/download、桌面快速开始。

下载页：https://claude.com/download

官方文档给出的安装包直链：

系统	安装包
macOS（Intel 与 Apple 芯片通用）	下载 dmg
Windows x64	下载安装程序
Windows ARM64	下载安装程序

Windows 也可以走下载页上的 Microsoft Store 入口：Claude。

官方帮助中心写的系统要求：macOS 13（Ventura）或更高，Windows 10 或更高。装好后从应用程序文件夹（Mac）或开始菜单（Windows）打开。桌面 App 自带 Claude Code，用 Code 页不需要再装 Node.js 或命令行。

Linux 桌面端官方标为 beta。下载页没有单独的安装包直链，只指向文档：Claude Desktop on Linux。本文不转写那一页的 apt 步骤。

默认的 Code 页要求登录 Anthropic 账号，并且需要 Pro、Max、Ultra、Team 或 Enterprise 订阅。这是官方默认路径，登录 Claude 账号不会改走 ModelFold。要用 ModelFold，按下面的开发者模式配置。

用开发者模式配置第三方网关

官方写明：桌面 App 的网关不读 ANTHROPIC_BASE_URL，也不读 ~/.claude/settings.json。终端里 export 的变量同样无效。只改配置文件时，桌面 App 仍走 Claude 账号。那份文件是给命令行和 VS Code / JetBrains 用的。

先打开 控制台 → API Keys，创建一个 mf- 开头的 Key。下面只填原始 Key，不要自己加 Bearer 。

按官方步骤改成第三方推理（打开配置窗口、网关字段、各端怎么读网关）：

1. 打开 Claude 桌面 App。
2. Mac 用屏幕顶部菜单栏；Windows 用登录屏左上角的应用菜单 ☰。进入 Help → Troubleshooting → Enable Developer Mode。应用会带着 Developer 菜单重启。
3. 打开 Developer → Configure Third-Party Inference…。
4. 在 Connection 里把 Inference provider 设为 Gateway，Gateway credentials 填：

字段	值
Gateway base URL	https://modelfold.ai/anthropic
Gateway API key	你的 mf- Key，不要加 Bearer
Credential kind	Static API key
Gateway auth scheme	Bearer（官方默认就是 Bearer）

5. 保存后完全退出应用再打开。macOS 要退出进程，不要只关窗口。官方还提供导出 .mobileconfig（Mac）或 .reg（Windows）交给设备管理；自己的电脑用这个窗口即可。

地址只写到 /anthropic。应用自己会接上 /v1/messages。写成 https://modelfold.ai/anthropic/v1 或带 /v1/messages 会拼错。Gateway API key 放原始 Key。选 Bearer 时，应用把它放进 Authorization: Bearer。值里再写 Bearer 会变成 Bearer Bearer …，接口返回 401。不要改成 x-api-key：ModelFold 这条 Anthropic 接口认的是 Bearer。

限制按官方文档记录。本页没有在本机用桌面 App 对 ModelFold 完成一次对话：

• 没开开发者模式、没配第三方推理时，Code 页要求登录 Anthropic 账号，并要求付费订阅。
• 单位已经下发配置时，这个窗口是只读的，个人改动不会生效。
• 网关模式下，官方写明不提供 Anthropic 托管的云端环境，Remote Control 不可用。
• 网关需要提供 POST /v1/messages（含流式和工具调用）。ModelFold 的 Anthropic 兼容接口就是这个协议。GET /v1/models 官方标为可选；ModelFold 提供该接口，应用会用它填充模型列表，并且只显示它认得出是 Claude 的 id。发现失败时官方要另配 inferenceModels，本文没有在界面上逐项点过这个字段。
• Anthropic 写明不为「通过网关把 Claude Code 接到非 Claude 模型」提供支持。ModelFold 这条 Anthropic 接口当前列出的都是 Claude 模型。id 列表和拉取命令见 VS Code 与 JetBrains 的「可用模型」。

配好第三方推理之后，若 Developer 菜单消失，再走一次 Help → Troubleshooting → Enable Developer Mode。官方说明：在已经处于第三方配置时打开开发者模式，之后会保持；更早打开的话，应用切进第三方配置并重启后菜单会暂时消失。

怎么确认生效

配好第三方推理并完全退出进程再打开。打开 Code，选本机文件夹，发一句短消息。这一步会走生成，并消耗 ModelFold 积分。

到 控制台的调用记录 看这笔请求是否记在你的 Key 上。只改 settings.json、或者只在终端里 export，桌面 App 不会因此改走 ModelFold。

常见问题

现象	原因
401，或请求头里出现 Bearer Bearer	Key 写错、已作废，或 Gateway API key 里多写了 Bearer 。只填原始 mf- Key，Gateway auth scheme 保持 Bearer。
404，或地址变成 /v1/v1/messages	Gateway base URL 写成了带 /v1 或 /v1/messages 的完整地址。只写 https://modelfold.ai/anthropic。
仍要求登录 Claude 账号	桌面 App 不读 settings.json，也不读终端里的 export。必须走 Developer → Configure Third-Party Inference，保存后完全退出进程再开。
Developer 菜单不见了	切进第三方配置并重启后，更早打开的开发者模式会暂时消失。再走一次 Help → Troubleshooting → Enable Developer Mode。
402，billing_error，提示积分不足	ModelFold 账户积分不够（余额小于 1，或本次预扣超过余额）。到控制台充值。这不是 Key 格式错误。
提示模型不可用，或模型列表是空的	网关的模型发现没对上。先用 IDE 页 里的命令确认 GET /v1/models 返回 200。官方在发现失败时要另配 inferenceModels，本文没有在界面上逐项点过。
网页或手机上的 claude.ai 聊天不能用这个 Key	普通聊天界面不接受第三方 Key。用本页的桌面 App，命令行，或 VS Code / JetBrains。

命令行的其他坑见 Claude Code CLI 接入。