返回AI 通道

Claude Desktop 安装与配置

先安装 Claude Desktop,再选择 CC Switch 或 Magpie,按所选工具导入配置。配置前先完全退出客户端,完成后重新打开。

  1. 1

    安装 Claude Desktop

    Anthropic 官方桌面客户端,先装它。

    配置前先完全退出 Claude Desktop。Windows 在右下角系统托盘右键图标,选「退出 / Quit」;macOS 先点客户端窗口,再按 ⌘Q。只关窗口不算退出。若另一个配置工具正在管理这个客户端,先停止它的代理或接管,再退出那个工具。

  2. 选择并安装配置工具

    选择你正在使用的一个,下方会显示对应教程。已安装的可以直接进入下一步。

    你使用哪个配置工具?

    安装 Magpie

    下载后安装并打开,保持 Claude Desktop 完全退出。

    选择适合电脑系统的版本。配置完成后,使用 Claude Desktop 时也要保持 Magpie 运行。

  3. 3

    登录后导入到 Magpie

    获取导入配置,再点「打开 Magpie 导入」。浏览器询问时允许打开 Magpie,在「供应商 / Providers」的「来自链接 / From link」确认页核对名称与端点,点「添加 / Add」。已有同名配置时会显示「替换 / Replace」。

    界面示意按 Magpie 开源界面还原 · 示例数据
    1核对后在 Magpie 点「添加 / Add」。若同名配置已存在,按钮会显示「替换 / Replace」。

    添加后在供应商卡片查看模型是否加载成功。模型列表为空时,先检查供应商的端点、密钥和可用模型,再进行接入。

  4. 4

    在 Magpie 中接入 Claude Desktop

    打开「Agent」,找到 Claude Desktop,打开该行最右侧的接入开关。接入后,点击左侧「模型菜单」下的「全部 N 个模型 / All N models」,勾选要在 Claude Desktop 里显示的 Claude 模型。

    这里设置的是客户端的模型菜单。具体使用哪个模型,要在重新打开的 Claude Desktop 中选择。本教程仅导入原生 Claude 模型。

    界面示意按 Magpie 开源界面还原 · 示例数据
    1–3Agent → 右侧接入开关 → 模型菜单。完全退出并重开 Claude Desktop,再在 Desktop 内选模型。
    模型名称仅为示例,以你的密钥实际获取的列表为准。

    按下方步骤重启后,进入 Claude Desktop 的 Code / Cowork 模式,在客户端内选择刚加入菜单的模型,再发一条消息验证。接入第三方服务后,原有 Anthropic 聊天和项目不会删除;断开 Magpie 接入后可恢复访问。

    整个使用过程中保持 Magpie 运行;退出 Magpie 会让通过本机网关的请求无法连接。

  5. 5

    重启 Claude Desktop

    必须完整退出、再打开一次才生效。

    Windows

    1. 1在任务栏右下角点 ∧ 展开隐藏图标。
    2. 2找到 Claude 图标。
    3. 3右键点击,选「Quit」。
    4. 4重新打开 Claude Desktop。

    没看到 Claude 图标?它可能被收进了系统托盘的隐藏区,先点任务栏右下角的 ∧ 展开。

    macOS

    1. 1先点一下 Claude 窗口,让它处于最前面。
    2. 2点顶部菜单栏的 Claude 菜单(或直接按快捷键)。
    3. 3选「Quit ⌘Q」。
    4. 4重新打开 Claude Desktop。
    ⌘+Q窗口在最前时最快

    别停在浏览器页面按 ⌘Q,那样退出的是浏览器,不是 Claude。先点一下 Claude 窗口。

    能正常对话即说明已生效。

常见问题

Claude Desktop 怎么下载?

本页提供 Claude Desktop 最新安装包的公开 GitHub Release 下载:Windows 是 x64/ARM64 MSIX,macOS 是 Universal DMG,Linux 是 x64/ARM64 DEB。

可以选择哪些配置工具?

可以选择 CC Switch 或 Magpie,页面按你的选择显示对应教程。CC Switch 写入供应商配置,Magpie 通过本机网关接入;使用 Magpie 时需要保持它运行。配置前都应先完全退出 Claude Desktop,完成后再打开。

一键导入后,怎样让 Claude Desktop 生效?

先完全退出 Claude Desktop。CC Switch:先导入 Claude Code,再到 Claude Desktop 导入供应商并切换到使用中。Magpie:导入供应商,到接入页打开 Claude Desktop 开关,再设置模型菜单。两种方式配置完成后都要重新打开 Claude Desktop;Magpie 的具体模型在客户端内选择。

需要配置模型映射(Sonnet / Opus / Haiku)吗?

本教程使用 AI 通道 的原生 Claude 模型,可用型号以当前模型列表为准。CC Switch 使用「直连」模式;Magpie 选择要显示的模型菜单。按对应教程操作即可,无需手动编写模型映射。

导入后怎么重启 Claude Desktop?

Windows:在屏幕右下角任务栏的系统托盘里找到 Claude 图标(没看到就点 ∧ 展开隐藏图标),右键选「退出」,再重新打开。Mac:先点一下 Claude 窗口让它处于最前面,再按 Cmd + Q(⌘Q)完全退出,然后重新打开;不要停留在浏览器页面按 Cmd + Q,那样退出的是浏览器。

点导入按钮没弹出所选配置工具怎么办?

先确认你选择的 CC Switch 或 Magpie 已安装并至少启动过一次;浏览器询问时选择「打开」。仍无反应时,使用当前导入面板的复制链接功能,再将链接粘贴到浏览器地址栏打开。

不注册 AI 通道 也能按这篇配吗?

可以。两种工具均可手动添加自己的 Anthropic 兼容 base URL 和 API key。但要填真正的 Claude 中转、能返回 Claude 模型列表的服务,Claude Desktop 才能正常发现模型并对话。本页推荐 AI 通道 是因为 claude 分组是原生 Claude、开箱即用。