Back to blog

Claude 国内站正式上线!Claude Desktop 桌面端全流程指南(含下载安装与国内配置)

Claude Desktop 手把手保姆级教程:从官方下载、安装 CC Switch,到 momoai.asia 创建 Key、国内中转配置、彻底重启与短消息测试,以及常见报错排错。

Aug 23, 2026Maynor
Claude 国内站正式上线!Claude Desktop 桌面端全流程指南(含下载安装与国内配置)

Claude 国内站正式上线!Claude Desktop 桌面端全流程指南(含下载安装与国内配置)


这篇是给第一次配置的人看的手把手教程。建议按顺序做:先装好两个客户端,再去中转站创建 Key,接着用 CC Switch 填配置并启动路由,最后彻底退出 Claude Desktop 再打开测试。中间每一步都写了「你会看到什么」和常见卡住的处理办法。

你需要准备:

  • 一台 macOS 或 Windows 电脑,能正常上网
  • 大约 15–20 分钟
  • 一个 momoai.asia 账号(没有的话先在网站注册)
  • 两个软件:官方 Claude Desktop,以及路由工具 CC Switch

不需要先登录 Anthropic 官方账号。装好 Claude Desktop 后先不要点官方登录,后面会用中转 Key 走国内配置。


一、什么是 Claude Desktop?

Claude Desktop 是 Anthropic 官方推出的桌面端 AI 工作台。相比网页版,它和本地文件夹、项目目录、代码工作区的结合更紧,适合连续、稍复杂的任务。

你可以用它来:

  • 日常对话与整理:多轮问答、长文本总结、资料归纳
  • 多模态文件分析:直接上传 PDF、图片、Excel、代码文件 一起分析
  • 项目上下文管理:用 Projects 把一个长期项目的本地资料和历史对话放在一起
  • Artifacts 与交互生成:实时预览、修改代码或可视化内容
  • 本地代码集成:配合 Code 阅读项目、改代码,并做本地检查

可以先记住这三层关系,后面每一步都围着它转:

Claude Desktop(你每天点的窗口) + 大语言模型(真正回答问题) + CC Switch(把请求转到国内中转,并帮你切换 Key)


二、下载并安装两个客户端

先把软件装好,再去网站申请 Key。两个都要装;只装 Claude、不装 CC Switch,国内中转配置将无法生效。

下载渠道(请按这个优先级)

下载渠道 链接地址 适用系统 说明与建议
Claude Desktop 官方 官方下载页 macOS / Windows 首选,获取最新完整版
CC Switch 官方 ccswitch.asia / GitHub Releases macOS / Windows 首选。macOS 用 .dmg,也可以 brew install --cask cc-switch;Windows 用 .msi。不要用 Portable zip,否则 ccswitch:// 协议可能注册不上。装好后至少完整启动一次,让系统注册协议
Claude 客户端网盘(备用) Claude 客户端(夸克网盘) macOS / Windows 仅在官方下载页打不开时使用
CC Switch 网盘(备用) CC Switch 客户端(夸克网盘) macOS / Windows 仅在官网和 GitHub 都打不开时使用

2.1 安装 Claude Desktop(macOS)

  1. 打开 Claude Desktop 官方下载页,点击 Download for macOS。如果官方页打不开,再用 客户端网盘下载。
  2. 等浏览器下载完成。文件一般在「下载」文件夹里,名字类似 Claude.dmg。
  3. 双击这个 .dmg 文件,会弹出一个安装窗口,左边是 Claude 图标,右边是 Applications(应用程序) 文件夹。
  4. 按住 Claude 图标,拖到右边的 Applications 里,等复制结束。
  5. 打开「启动台」或「访达 → 应用程序」,找到 Claude,点一下打开。
  6. 如果系统提示「是否打开下载的应用」,选择打开。
  7. 先不要登录官方账号,先不要开始对话。 把窗口留着或先放下,接着去装 CC Switch。

2.2 安装 Claude Desktop(Windows)

  1. 打开 官方下载页,点击 Download for Windows。官方页打不开时,再用 客户端网盘下载。
  2. 下载完成后,双击安装程序(通常是 .exe),按向导点「下一步 / Next」直到完成。
  3. 打开「开始菜单」,搜索 Claude 并启动。
  4. 同样,先不要登录官方账号,接着去装 CC Switch。

2.3 安装 CC Switch(这一步不能省)

CC Switch 负责把 Claude Desktop 的请求转到中转站。请用正式安装包,不要用 Portable zip。

macOS:

  1. 打开 ccswitch.asia,或打开 GitHub Releases,下载最新的 .dmg 文件(名字里通常带 macos 或 .dmg)。如果你习惯 Homebrew,也可以在终端执行:brew install --cask cc-switch。
  2. 双击 .dmg,把应用拖进「应用程序」。
  3. 第一次打开时,如果系统提示「无法验证开发者」,到「系统设置 → 隐私与安全性」里选择仍要打开。
  4. 务必要真正启动一次 CC Switch,看到主界面再继续。这一步是为了让系统注册 ccswitch:// 协议,后面导入配置才不容易失败。

Windows:

  1. 从 ccswitch.asia 或 GitHub Releases 下载最新的 .msi 安装包。
  2. 双击安装,完成后从开始菜单打开 CC Switch。
  3. 同样,请完整启动一次,看到主界面即可。

如果官网和 GitHub 都打不开,再用 CC Switch 夸克网盘备用。

装好并启动过一次后,可以先把 CC Switch 留在后台,下面去中转站申请 Key。


三、在 momoai.asia 创建 API Key

国内第三方入口:https://momoai.asia

打开网站后,用已有账号登录;没有账号就先注册再登录。登录成功后,一般会进入控制台首页(仪表盘),左侧是菜单,中间是用量和概览。

momoai 控制台界面 图 1:momoai.asia 控制台首页(账号、余额和用量已打码)

第 1 步:找到「创建密钥」入口

  1. 看窗口左侧菜单,找到 API Keys(有的界面写作「令牌 / 密钥 / 令牌管理」)。它通常在「我的账户 / MY ACCOUNT」这一组下面。
  2. 点进去后,页面上会有密钥列表,以及一个 创建 / Create / 添加 按钮,点它。
  3. 会弹出「创建 API Key / Create API Key」窗口,如下图。控制台语言可能是中文或英文,按钮位置是一样的。

创建 Key 并选择 ClaudeMax 分组 图 2:在控制台中创建 API Key,并打开分组下拉菜单

第 2 步:按字段填写(对照上图点)

按弹窗里的字段一项一项填,不要急着点创建:

  1. 名称 / Name:给自己看的备注即可,例如 claude-desktop。不建议用「测试」这种以后分不清的名字。
  2. 协议 / Provider:如果有这一项,请选择 Anthropic(或界面上的 Anthropic / Claude 兼容项)。这一步是为了让 Key 走 Claude 接口,不要选成 OpenAI 或其他协议。
  3. 分组 / Group:点开下拉菜单,选一个当前账号可用、且支持你要使用的 Claude 模型的分组。常见名称是 ClaudeMax,控制台里也可能写作 ClaudeMax 余额分组、ClaudeOpus 分组 等,以当天页面上的实际名称为准。选之前可以先看一眼分组说明,有的分组会注明不支持某些模型。
  4. 额度、速率或过期时间:如果不是你明确要限制,可以先保持默认(不打开限速、不设过期)。
  5. 确认无误后,点击 创建 / Create。不要点取消。

第 3 步:立刻保存完整 Key

创建成功后,页面通常会只显示一次完整密钥,开头类似 sk- 后面一长串字符。

请立刻复制,保存到密码管理器或你自己能找到的安全地方。然后注意:

  • 不要把完整 Key 发到聊天、截图或公开网盘
  • 不要把 Key 提交到 Git 仓库
  • 如果没复制就关掉了窗口,去密钥列表往往只能看到前几位,这时只能注销旧 Key、再新建一把

同时请记下中转地址,后面填写要用:https://momoai.asia。不要填官方的 https://api.anthropic.com。


四、在 CC Switch 里填入配置并启动路由

现在回到刚才已经打开过的 CC Switch。如果被你关掉了,请重新打开。

第 1 步:新建一条 Claude Desktop 配置

  1. 在 CC Switch 里找到添加供应商 / 新建配置 / 添加的入口(不同版本用词可能略有差别,常见是「添加新供应商」或右上角加号)。
  2. 应用类型必须精确选择为 Claude Desktop,不要选成 Claude Code、Codex 或其他客户端。选错了,后面路由对不上,Claude 窗口怎么重启都不会走这条配置。
  3. 然后按下面这张表填写。填完先核对一遍,再保存。

在 CC Switch 中配置 Key 图 3:在 CC Switch 中填入中转地址和 API Key

配置项 填写/选择内容 详细说明
应用类型 Claude Desktop 必须精确选择,不能选错
中转地址 (Base URL / 请求地址) https://momoai.asia 填中转站根地址。不要填 https://api.anthropic.com。一般也不要自行加 /v1,除非控制台明确要求
API Key 刚才复制的 sk-... 粘贴完整 Key。输入框可能是圆点隐藏状态,属正常
模型 (Model) 按该 Key 所属分组支持的模型填写 以控制台当天列表为准,不要随便填一个官网宣传名

如果界面里有「需要官方鉴权」一类开关,走中转时通常应保持关闭。有「手动覆盖模型列表」等高级项,第一次配置可以先不动,等连通后再说。

保存后,列表里应该能看到你刚加的这一条,地址栏类似 https://momoai.asia。

第 2 步:选中这条配置,并点击「启动路由」

  1. 在列表中点选你刚保存的那一条,确认它处于选中 / 启用状态(常见是高亮或左边有选中标记)。不要停在「Claude Desktop Official」这类官方默认项上。
  2. 点击 启动路由(有的版本是开关,打开后变成绿色表示已启用)。
  3. 等到界面提示成功,或开关已经打开,再进行下一步。不要一闪而过后立刻去点 Claude,先看一眼状态是否真的亮了。

启动路由 图 4:在 CC Switch 中选中中转配置,并启动路由

到这里,只说明中转这边已经就绪。正在运行的 Claude Desktop 还不会自动换线路,必须按下一节彻底退出再打开,测试才准。


五、彻底退出 Claude Desktop,再打开测试

这是整个流程里最容易被跳过、也最容易误以为「配置失败」的一步。CC Switch 提示成功,只代表路由准备好了;已经打开的 Claude 进程仍可能走旧设置。

5.1 完全退出(请对照你的系统做)

macOS:

  1. 不要只是点一下 Dock 里的 Claude 图标,那往往只是把窗口藏起来,进程还在。
  2. 如果 Claude 正在前台,点屏幕最上方菜单栏的 Claude,选择 退出 Claude / Quit Claude。
  3. 打开「活动监视器」(启动台里搜这个名字),在右上角搜索 Claude。如果还能看到 Claude 相关进程,选中后点「退出」;退不掉再点「强制退出」。
  4. 确认列表里已经没有 Claude,再进行下一步。

Windows:

  1. 看任务栏右下角(系统托盘)里是否还有 Claude 图标。如果有,右键选择退出。
  2. 打开「任务管理器」,在「进程」里查找 Claude。还有残留就结束任务。
  3. 确认没有 Claude 进程后,再重新打开。

5.2 重新打开,新建对话,发送测试句

  1. 再打开 Claude Desktop。
  2. 新建一个空白对话。不要在之前已经报错过的旧对话里直接重试,旧会话可能还记着失败状态。
  3. 如已登录过官方账号,先退出官方登录,再测中转。
  4. 看输入框附近的模型名称,先选一个该分组明确支持的常用模型(下一节会说明怎么选)。
  5. 发送一句短消息,不要一上来就传大文件。可以复制下面这句:
请回复:连接测试成功。
  1. 如果在几秒到十几秒内收到正常中文回复,说明这一条链路已经打通。这时再去尝试长文本、上传文件或 Code 任务。

如果转圈很久、直接失败,或弹出报错,先不要反复重发,转到文末「常见错误与排错」对照处理。


六、怎么选择模型,怎样算验证成功

在 Claude Desktop 输入框附近(常见是右下角)点击当前模型名称,会展开模型列表:

模型选择菜单 图 5:在 Claude Desktop 里打开模型选择菜单

请注意:菜单里的显示名称有可能只是别名。请求能不能成功,取决于中转分组真正支持的模型 ID,而不是名字看起来像不像。

建议按这个顺序验证,不要第一步就上最复杂的模型或最大的文件:

  1. 先选一个分组里常见、明确支持的通用模型。
  2. 只发一句短文本,确认能收到回复。
  3. 通了以后,再试长文本、上传文件,或使用 Code / Project 功能。
  4. 如果某个模型一发就报「当前分组不支持」,先换回已经测通的模型,再去控制台核对分组支持列表,不要连续换好几个一起试,不容易判断问题出在哪。

七、打通之后可以怎么用(附 Prompt 示例)

1. 普通对话

点 New 新建对话。提问时尽量写清你要的输出格式,以及哪些信息不要它瞎补:

请把下面的内容整理成一份中文会议纪要,输出“结论、待办、负责人、截止时间”四列表格。没有明确的信息请标记为“待确认”,不要自行补全。

2. 分析文件

点击输入框旁边的 +(加号) 上传文件,支持 PDF、图片、表格、代码等,然后再发说明:

请先概括这份文件的核心结论,再列出 5 条可以执行的行动建议。引用原文时请标注具体页码。

如果文件很大,先传一小部分或先发短文本确认连接仍然正常,再上传完整文件。

3. 打开本地项目 / 代码库

点击 Project or folder,选择你的本地项目文件夹。建议按下面的顺序让它做事,而不是一上来就改文件:

  1. 先扫描后修改:让它先看目录结构,说明项目是干什么的。
  2. 确认环境:让它找出入口文件、启动或构建命令、测试怎么跑。
  3. 限定范围:明确告诉它可以改哪些路径,哪些文件不要动。
  4. 小步迭代:改完后让它跑最小的一组测试,确认没有把别的地方弄坏。

八、常见错误与排错指南

排错时请只改一个条件再测一次,测的时候仍然要:启动路由 → 彻底退出 Claude → 新建对话 → 发送短消息。

错误 1:API Error: requested model is not supported by this group

模型不受支持错误 图 6:当前分组不支持你选的这个模型

  • 原因:你现在这条 Key 所属的分组(例如 ClaudeMax 或 ClaudeOpus 分组)没有开放你选的那个模型。
  • 处理:
    1. 打开 momoai.asia,进入该 Key 的分组,查看它实际支持的模型名单。
    2. 回到 Claude Desktop,先改选名单里有的模型;或打开 CC Switch,把配置里的模型改成支持列表中的 ID。
    3. 保存后重新启动路由。
    4. 彻底退出并重启 Claude Desktop。
    5. 新建对话再发测试短消息。

错误 2:发送后一直转圈,或提示发送失败

按下面几条逐项看,看完一项就测一次短文本:

  • 是不是在传很大的文件?先改发一句短话。
  • 本机网络是否正常,中转网站能不能打开。
  • 账号是否还有额度,Key 是否过期或已被注销。
  • CC Switch 里当前启用的,是不是 Claude Desktop 那张卡片,而不是 Claude Code 或其他应用。
  • 路由开关是否还是开启状态。如果不确定,关闭后再重新启动路由。
  • 仍然不行时,先退出 CC Switch 再打开,接着再彻底退出 Claude Desktop 后重试。

错误 3:出现 401,或请求仍然走到官方接口

  • 原因:Base URL 还是官方地址,或者没有启用你刚配的那张卡片;也可能还处于官方账号登录状态。
  • 处理:
    1. 打开 CC Switch,把中转地址改成 https://momoai.asia,确认没有写成 https://api.anthropic.com。
    2. 确认启用的是 Claude Desktop 对应卡片,然后重新启动路由。
    3. 若之前登录过官方账号,先在 Claude Desktop 里退出官方登录。
    4. 彻底退出客户端,新建对话再测。

错误 4:提示「未安装或协议处理程序未注册」

  • 原因:CC Switch 不是正式安装版(例如用了 Portable zip),或者安装后还没有完整启动过,系统没注册 ccswitch:// 协议。
  • 处理:
    1. 卸载便携版或不完整的安装。
    2. 从 ccswitch.asia 或 GitHub Releases 重新下载 .dmg(macOS)或 .msi(Windows)并安装。
    3. 打开一次 CC Switch,看到主界面后再导入或手动填写供应商。
    4. 仍失败时,不要反复点导入链接,直接在 CC Switch 里按第四节手动填写并启动路由。

还是不行时的快速回溯

从后往前问自己这 6 句,哪一句答不上来,就回到对应章节重做:

  1. Claude Desktop 和 CC Switch 都装好了,并且 CC Switch 正式启动过一次吗?
  2. Key 是新创建的,分组选对了,完整密钥保存下来了吗?
  3. Base URL 是 https://momoai.asia,应用类型是 Claude Desktop 吗?
  4. 正确的那张卡片已选中,并且路由已经启动吗?
  5. 改完配置后,是否彻底退出过 Claude(不是只关窗口)?
  6. 是否在新对话里,用分组支持的模型,只发了短消息?

九、安全与隐私提醒

  • 🔒 保护 Key:不要把 API Key 放到公开 Git 仓库、截图、聊天或网盘分享里。
  • 🔑 怀疑泄露就立刻作废:到控制台注销这把 Key,再生成新的,并同步改掉 CC Switch 里的填写。

十、快速自查清单

每次配置完、或排错之前,可以用这张表对一下:

  • [ ] 已从官方渠道安装 Claude Desktop(打不开官方页时才用网盘备用)
  • [ ] 已从 ccswitch.asia 或 GitHub 安装 CC Switch 正式版,并至少完整启动过一次
  • [ ] 已在 momoai.asia 登录,创建 Key,并选择了当天实际存在的正确分组
  • [ ] 完整 Key 已保存到安全的地方,没有写进聊天或截图
  • [ ] CC Switch 的应用类型是 Claude Desktop,中转地址是 https://momoai.asia(不是官方 API)
  • [ ] 已选中这条配置,并成功启动路由
  • [ ] 已完全退出 Claude Desktop(macOS 查过活动监视器,Windows 查过托盘和任务管理器)后再打开
  • [ ] 已新建对话,并选择了该分组支持的模型
  • [ ] 短消息测试已经成功收到回复

🔗 相关链接汇总: