返回AI 通道

Claude Desktop:装好两个软件,点一下导入,重启就能用

安装包通过公开 GitHub Release 下载,CCSwitch 把配置一键写进 Claude Desktop —— 不用手抄 base URL 和 API key

  1. 1

    安装 Claude Desktop

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

  2. 2

    安装 CCSwitch

    配置导入工具,第 3、4 步用它把配置写进 Claude Desktop。

  3. 3

    登录后一键导入到 CCSwitch

    登录后点一下,Claude 配置就进了 CCSwitch。

  4. 4

    在 CCSwitch 里推给 Claude Desktop

    CCSwitch 把刚才的配置写进 Claude Desktop 的设置里。

    1. 1打开 CCSwitch,点顶部第二个 Claude 图标(带显示器小角标的那个)切到 Claude Desktop。
    2. 2首次打开是空的,点蓝色大按钮「将 Claude Code 中已有的供应商导入」。

    导入后会提示「切换成功,重启 Claude Desktop 后生效」。AI 通道 的 claude 分组是原生 Claude 模型,会自动走 直连 模式(不会出现「需要路由」标记),不用配模型映射。

  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。

为什么要装 CCSwitch?不能直接在 Claude Desktop 里填吗?

Claude Desktop 接第三方推理要手写一段 Gateway 配置(base URL、API key、鉴权方式),手填容易出错。CCSwitch 帮你把 AI 通道 的 Claude 配置一键写进 Claude Desktop,不用自己抄 base URL 和 key。

一键导入后,为什么还要在 CCSwitch 里点一步?

浏览器上的一键导入会先把 Claude 配置放进 CCSwitch 的 Claude Code 里;再切到 CCSwitch 的 Claude Desktop 标签,点「将 Claude Code 中已有的供应商导入」,配置才会写进 Claude Desktop。两步都很快,合计不到一分钟。

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

不需要。AI 通道 的 claude 分组是原生 Claude 模型(claude-opus-4-8、claude-sonnet-4-6、claude-haiku-4-5),CCSwitch 会自动走「直连」模式(不出现「需要路由」标记),不需要你手动做模型名映射。

导入后怎么重启 Claude Desktop?

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

点导入按钮没弹出 CC Switch 怎么办?

先确认 CCSwitch 已安装并至少启动过一次;浏览器弹出询问时选择「打开」。仍无反应,点开导入按钮下方的「点了没反应?复制链接手动导入」,把链接粘贴到浏览器地址栏回车。

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

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