Claude 国内站正式上线!Claude Desktop 桌面端全流程指南(含下载安装与国内配置)
Claude Desktop 手把手保姆级教程:从官方下载、安装 CC Switch,到 momoai.asia 创建 Key、国内中转配置、彻底重启与短消息测试,以及常见报错排错。

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)
- 打开 Claude Desktop 官方下载页,点击 Download for macOS。如果官方页打不开,再用 客户端网盘下载。
- 等浏览器下载完成。文件一般在「下载」文件夹里,名字类似
Claude.dmg。 - 双击这个
.dmg文件,会弹出一个安装窗口,左边是 Claude 图标,右边是 Applications(应用程序) 文件夹。 - 按住 Claude 图标,拖到右边的 Applications 里,等复制结束。
- 打开「启动台」或「访达 → 应用程序」,找到 Claude,点一下打开。
- 如果系统提示「是否打开下载的应用」,选择打开。
- 先不要登录官方账号,先不要开始对话。 把窗口留着或先放下,接着去装 CC Switch。
2.2 安装 Claude Desktop(Windows)
- 打开 官方下载页,点击 Download for Windows。官方页打不开时,再用 客户端网盘下载。
- 下载完成后,双击安装程序(通常是
.exe),按向导点「下一步 / Next」直到完成。 - 打开「开始菜单」,搜索 Claude 并启动。
- 同样,先不要登录官方账号,接着去装 CC Switch。
2.3 安装 CC Switch(这一步不能省)
CC Switch 负责把 Claude Desktop 的请求转到中转站。请用正式安装包,不要用 Portable zip。
macOS:
- 打开 ccswitch.asia,或打开 GitHub Releases,下载最新的
.dmg文件(名字里通常带macos或.dmg)。如果你习惯 Homebrew,也可以在终端执行:brew install --cask cc-switch。 - 双击
.dmg,把应用拖进「应用程序」。 - 第一次打开时,如果系统提示「无法验证开发者」,到「系统设置 → 隐私与安全性」里选择仍要打开。
- 务必要真正启动一次 CC Switch,看到主界面再继续。这一步是为了让系统注册
ccswitch://协议,后面导入配置才不容易失败。
Windows:
- 从 ccswitch.asia 或 GitHub Releases 下载最新的
.msi安装包。 - 双击安装,完成后从开始菜单打开 CC Switch。
- 同样,请完整启动一次,看到主界面即可。
如果官网和 GitHub 都打不开,再用 CC Switch 夸克网盘备用。
装好并启动过一次后,可以先把 CC Switch 留在后台,下面去中转站申请 Key。
三、在 momoai.asia 创建 API Key
国内第三方入口:https://momoai.asia
打开网站后,用已有账号登录;没有账号就先注册再登录。登录成功后,一般会进入控制台首页(仪表盘),左侧是菜单,中间是用量和概览。
图 1:momoai.asia 控制台首页(账号、余额和用量已打码)
第 1 步:找到「创建密钥」入口
- 看窗口左侧菜单,找到 API Keys(有的界面写作「令牌 / 密钥 / 令牌管理」)。它通常在「我的账户 / MY ACCOUNT」这一组下面。
- 点进去后,页面上会有密钥列表,以及一个 创建 / Create / 添加 按钮,点它。
- 会弹出「创建 API Key / Create API Key」窗口,如下图。控制台语言可能是中文或英文,按钮位置是一样的。
图 2:在控制台中创建 API Key,并打开分组下拉菜单
第 2 步:按字段填写(对照上图点)
按弹窗里的字段一项一项填,不要急着点创建:
- 名称 / Name:给自己看的备注即可,例如
claude-desktop。不建议用「测试」这种以后分不清的名字。 - 协议 / Provider:如果有这一项,请选择 Anthropic(或界面上的 Anthropic / Claude 兼容项)。这一步是为了让 Key 走 Claude 接口,不要选成 OpenAI 或其他协议。
- 分组 / Group:点开下拉菜单,选一个当前账号可用、且支持你要使用的 Claude 模型的分组。常见名称是
ClaudeMax,控制台里也可能写作 ClaudeMax 余额分组、ClaudeOpus 分组 等,以当天页面上的实际名称为准。选之前可以先看一眼分组说明,有的分组会注明不支持某些模型。 - 额度、速率或过期时间:如果不是你明确要限制,可以先保持默认(不打开限速、不设过期)。
- 确认无误后,点击 创建 / Create。不要点取消。
第 3 步:立刻保存完整 Key
创建成功后,页面通常会只显示一次完整密钥,开头类似 sk- 后面一长串字符。
请立刻复制,保存到密码管理器或你自己能找到的安全地方。然后注意:
- 不要把完整 Key 发到聊天、截图或公开网盘
- 不要把 Key 提交到 Git 仓库
- 如果没复制就关掉了窗口,去密钥列表往往只能看到前几位,这时只能注销旧 Key、再新建一把
同时请记下中转地址,后面填写要用:https://momoai.asia。不要填官方的 https://api.anthropic.com。
四、在 CC Switch 里填入配置并启动路由
现在回到刚才已经打开过的 CC Switch。如果被你关掉了,请重新打开。
第 1 步:新建一条 Claude Desktop 配置
- 在 CC Switch 里找到添加供应商 / 新建配置 / 添加的入口(不同版本用词可能略有差别,常见是「添加新供应商」或右上角加号)。
- 应用类型必须精确选择为
Claude Desktop,不要选成 Claude Code、Codex 或其他客户端。选错了,后面路由对不上,Claude 窗口怎么重启都不会走这条配置。 - 然后按下面这张表填写。填完先核对一遍,再保存。
图 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 步:选中这条配置,并点击「启动路由」
- 在列表中点选你刚保存的那一条,确认它处于选中 / 启用状态(常见是高亮或左边有选中标记)。不要停在「Claude Desktop Official」这类官方默认项上。
- 点击 启动路由(有的版本是开关,打开后变成绿色表示已启用)。
- 等到界面提示成功,或开关已经打开,再进行下一步。不要一闪而过后立刻去点 Claude,先看一眼状态是否真的亮了。
图 4:在 CC Switch 中选中中转配置,并启动路由
到这里,只说明中转这边已经就绪。正在运行的 Claude Desktop 还不会自动换线路,必须按下一节彻底退出再打开,测试才准。
五、彻底退出 Claude Desktop,再打开测试
这是整个流程里最容易被跳过、也最容易误以为「配置失败」的一步。CC Switch 提示成功,只代表路由准备好了;已经打开的 Claude 进程仍可能走旧设置。
5.1 完全退出(请对照你的系统做)
macOS:
- 不要只是点一下 Dock 里的 Claude 图标,那往往只是把窗口藏起来,进程还在。
- 如果 Claude 正在前台,点屏幕最上方菜单栏的 Claude,选择 退出 Claude / Quit Claude。
- 打开「活动监视器」(启动台里搜这个名字),在右上角搜索
Claude。如果还能看到 Claude 相关进程,选中后点「退出」;退不掉再点「强制退出」。 - 确认列表里已经没有 Claude,再进行下一步。
Windows:
- 看任务栏右下角(系统托盘)里是否还有 Claude 图标。如果有,右键选择退出。
- 打开「任务管理器」,在「进程」里查找 Claude。还有残留就结束任务。
- 确认没有 Claude 进程后,再重新打开。
5.2 重新打开,新建对话,发送测试句
- 再打开 Claude Desktop。
- 新建一个空白对话。不要在之前已经报错过的旧对话里直接重试,旧会话可能还记着失败状态。
- 如已登录过官方账号,先退出官方登录,再测中转。
- 看输入框附近的模型名称,先选一个该分组明确支持的常用模型(下一节会说明怎么选)。
- 发送一句短消息,不要一上来就传大文件。可以复制下面这句:
请回复:连接测试成功。
- 如果在几秒到十几秒内收到正常中文回复,说明这一条链路已经打通。这时再去尝试长文本、上传文件或 Code 任务。
如果转圈很久、直接失败,或弹出报错,先不要反复重发,转到文末「常见错误与排错」对照处理。
六、怎么选择模型,怎样算验证成功
在 Claude Desktop 输入框附近(常见是右下角)点击当前模型名称,会展开模型列表:
图 5:在 Claude Desktop 里打开模型选择菜单
请注意:菜单里的显示名称有可能只是别名。请求能不能成功,取决于中转分组真正支持的模型 ID,而不是名字看起来像不像。
建议按这个顺序验证,不要第一步就上最复杂的模型或最大的文件:
- 先选一个分组里常见、明确支持的通用模型。
- 只发一句短文本,确认能收到回复。
- 通了以后,再试长文本、上传文件,或使用 Code / Project 功能。
- 如果某个模型一发就报「当前分组不支持」,先换回已经测通的模型,再去控制台核对分组支持列表,不要连续换好几个一起试,不容易判断问题出在哪。
七、打通之后可以怎么用(附 Prompt 示例)
1. 普通对话
点 New 新建对话。提问时尽量写清你要的输出格式,以及哪些信息不要它瞎补:
请把下面的内容整理成一份中文会议纪要,输出“结论、待办、负责人、截止时间”四列表格。没有明确的信息请标记为“待确认”,不要自行补全。
2. 分析文件
点击输入框旁边的 +(加号) 上传文件,支持 PDF、图片、表格、代码等,然后再发说明:
请先概括这份文件的核心结论,再列出 5 条可以执行的行动建议。引用原文时请标注具体页码。
如果文件很大,先传一小部分或先发短文本确认连接仍然正常,再上传完整文件。
3. 打开本地项目 / 代码库
点击 Project or folder,选择你的本地项目文件夹。建议按下面的顺序让它做事,而不是一上来就改文件:
- 先扫描后修改:让它先看目录结构,说明项目是干什么的。
- 确认环境:让它找出入口文件、启动或构建命令、测试怎么跑。
- 限定范围:明确告诉它可以改哪些路径,哪些文件不要动。
- 小步迭代:改完后让它跑最小的一组测试,确认没有把别的地方弄坏。
八、常见错误与排错指南
排错时请只改一个条件再测一次,测的时候仍然要:启动路由 → 彻底退出 Claude → 新建对话 → 发送短消息。
错误 1:API Error: requested model is not supported by this group
图 6:当前分组不支持你选的这个模型
- 原因:你现在这条 Key 所属的分组(例如 ClaudeMax 或 ClaudeOpus 分组)没有开放你选的那个模型。
- 处理:
- 打开 momoai.asia,进入该 Key 的分组,查看它实际支持的模型名单。
- 回到 Claude Desktop,先改选名单里有的模型;或打开 CC Switch,把配置里的模型改成支持列表中的 ID。
- 保存后重新启动路由。
- 彻底退出并重启 Claude Desktop。
- 新建对话再发测试短消息。
错误 2:发送后一直转圈,或提示发送失败
按下面几条逐项看,看完一项就测一次短文本:
- 是不是在传很大的文件?先改发一句短话。
- 本机网络是否正常,中转网站能不能打开。
- 账号是否还有额度,Key 是否过期或已被注销。
- CC Switch 里当前启用的,是不是
Claude Desktop那张卡片,而不是 Claude Code 或其他应用。 - 路由开关是否还是开启状态。如果不确定,关闭后再重新启动路由。
- 仍然不行时,先退出 CC Switch 再打开,接着再彻底退出 Claude Desktop 后重试。
错误 3:出现 401,或请求仍然走到官方接口
- 原因:Base URL 还是官方地址,或者没有启用你刚配的那张卡片;也可能还处于官方账号登录状态。
- 处理:
- 打开 CC Switch,把中转地址改成
https://momoai.asia,确认没有写成https://api.anthropic.com。 - 确认启用的是 Claude Desktop 对应卡片,然后重新启动路由。
- 若之前登录过官方账号,先在 Claude Desktop 里退出官方登录。
- 彻底退出客户端,新建对话再测。
- 打开 CC Switch,把中转地址改成
错误 4:提示「未安装或协议处理程序未注册」
- 原因:CC Switch 不是正式安装版(例如用了 Portable zip),或者安装后还没有完整启动过,系统没注册
ccswitch://协议。 - 处理:
- 卸载便携版或不完整的安装。
- 从 ccswitch.asia 或 GitHub Releases 重新下载
.dmg(macOS)或.msi(Windows)并安装。 - 打开一次 CC Switch,看到主界面后再导入或手动填写供应商。
- 仍失败时,不要反复点导入链接,直接在 CC Switch 里按第四节手动填写并启动路由。
还是不行时的快速回溯
从后往前问自己这 6 句,哪一句答不上来,就回到对应章节重做:
- Claude Desktop 和 CC Switch 都装好了,并且 CC Switch 正式启动过一次吗?
- Key 是新创建的,分组选对了,完整密钥保存下来了吗?
- Base URL 是
https://momoai.asia,应用类型是Claude Desktop吗? - 正确的那张卡片已选中,并且路由已经启动吗?
- 改完配置后,是否彻底退出过 Claude(不是只关窗口)?
- 是否在新对话里,用分组支持的模型,只发了短消息?
九、安全与隐私提醒
- 🔒 保护 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 查过托盘和任务管理器)后再打开
- [ ] 已新建对话,并选择了该分组支持的模型
- [ ] 短消息测试已经成功收到回复
🔗 相关链接汇总:
- 国内第三方中转入口:https://momoai.asia
- Claude 官方下载页:https://claude.com/download
- CC Switch 官网:https://ccswitch.asia/
- CC Switch GitHub Releases:https://github.com/farion1231/cc-switch/releases
- CC Switch 网盘备用:夸克网盘链接
- Claude 客户端网盘备用:夸克网盘链接