想在 Windows 上用原生 Claude Code 官方客户端?不用瞎找第三方安装包,官方渠道几步就能装好。我把完整步骤和踩过的坑都整理清楚了。 装前先核对这几点,别白忙活一场
先讲最关键的一件事,Claude Code 只面向 Pro、Max、Team 这类付费订阅用户开放,免费账号就算装完客户端,核心的代码编辑、项目联动功能也用不了,别白费功夫下载一通。 系统版本也得卡准,官方要求 Windows 10 1809 版本以上,或者 Windows Server 2019 及更高,Win7、Win8 就别试了,装到一半报错、双击没反应都是常事。我之前帮同事装就踩过这个雷,他电脑还是好几年前的初始版 Win10,折腾半天才发现是版本不兼容,打了个系统补丁就好了。
硬件要求倒是不高,4G 内存是底线,现在的办公本基本都能满足,x64 和 ARM64 架构的处理器都支持,不用纠结机型。还有个特别容易漏掉的细节,如果你打算装命令行 CLI 版本,官方明确要求得提前装好 Git for Windows,缺了这个依赖,文件检索、项目联动这些核心功能都会出问题,很多人扫一眼文档就略过去了,装完跑不起来又回头找原因。桌面端不用额外装,内置了相关环境。
认准官方下载页,别碰野链接
桌面图形客户端的下载入口认准官方域名 claude.com/download,别去乱七八糟的下载站搜。我之前见过有人图快从第三方站点下,装完多了俩捆绑浏览器插件,卸载折腾了十几分钟,得不偿失。 打开浏览器输地址进去,页面会自动识别你的系统,直接点 Windows 对应的下载按钮就行,下来的是 exe 格式的安装包,大小也就几十兆,网速正常的话一分钟不到就能下完。
要是怕下错,下完可以看一眼文件的数字签名,官方安装包的发行方是 Anthropic 公司,碰到名字乱七八糟、签名对不上的直接删掉,别点开运行。
桌面端安装全程傻瓜式,点下一步也不会错
找到刚下好的安装包,双击运行,系统会弹出用户账户控制的提示,点 “是” 就可以进入安装向导了。
整个安装流程特别省心,新手直接一路点下一步都不会出问题。默认会装到 C 盘的 Program Files 文件夹里,要是 C 盘空间紧张,也可以自己改到其他盘,路径里尽量别出现中文,不然容易出一些说不清道不明的报错,老 Windows 用户应该都懂这个坑。
点完安装等着进度条走完就行,速度挺快的,普通电脑几十秒就能装完,比很多重型开发工具安装效率高多了。最后一步勾选 “启动 Claude”,点完成,桌面图形客户端这步就算装完了,自带完整的 Code 相关能力,不用额外再装命令行工具。
第一次启动怎么登录,数据都是通的
第一次打开客户端,会自动跳转到默认浏览器进行授权登录,你直接用平时登 Claude 网页版的账号就行,邮箱注册、第三方授权的账号都通用。
登录成功后浏览器会提示跳回客户端,确认一下就能进入主界面了。我最开始还担心桌面端和网页端数据不同步,后来发现完全是多虑,历史对话、自定义的系统提示、保存的代码片段全都会同步过来,网页上聊到一半的项目,打开桌面端直接接着弄,上下文一点不会断。
平时用得多的话,记得右键把图标固定到任务栏,点开比找浏览器书签方便太多。
不想手动下安装包?这两种命令行装法更省事
要是你平时习惯用命令行,其实不用特意去浏览器下安装包,有更快捷的方式,装的是独立的 CLI 版本,适合天天泡终端的开发者。不用开管理员权限,普通 PowerShell 窗口就能跑。
Win11 或者提前装了 WinGet 的用户,直接打开 PowerShell,输入 winget install Anthropic.ClaudeCode 回车,等着自动下载安装就行,全程不用手动点下一步,批量装工具的时候特别好用。要提一句的是 WinGet 装的版本不会自动更新,后续想升级得手动输 winget upgrade Anthropic.ClaudeCode 命令,这点不如原生脚本方便。装完记得把当前终端关掉重开,不然环境变量没加载,输命令会提示找不到程序,很多人第一次用都会踩这个小坑。
还有官方的原生脚本安装方式,直接打开 PowerShell,输入 irm https://claude.ai/install.ps1 | iex 回车,脚本会自动帮你完成下载、安装、配置环境变量全套操作,比手动装还省事儿,而且这个版本支持后台自动更新。要是碰到 “系统禁止运行脚本” 的报错,先执行一句 Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned 放开权限就行,十个人里有八个第一次装会碰到这个问题。不过国内网络不好的话,脚本可能会卡在下载环节,这时候还是老老实实下安装包更稳。 装完先验证,常见小问题这么处理
装完先别急着用,简单验证下是不是真装成功了。桌面端的话直接打开软件,能正常登录进入聊天界面就没问题;要是装的命令行版本,新开一个 PowerShell,输入 claude --version,能弹出版本号就说明安装成功。想查更详细的运行状态,输 claude doctor 也行,会自动帮你扫一遍依赖和配置有没有问题。 偶尔也会碰到一些小状况,大多不是大问题。比如安装进度条卡住不动,大概率是网络波动,取消了重开一次就行,不用动不动就重启电脑。
要是杀毒软件报毒,直接加白名单就行,官方安装包都是数字签名过的,不会有安全问题。还有人装完打不开,先去看自己的系统版本,很多人用的 Win10 是好几年前的老版本,没到 1809,升个系统补丁就能解决。
对了,别把安装路径设在中文文件夹里,比如 “编程工具” 这种名字,很容易导致功能异常,改成英文路径基本都能好。命令行版本要是跑项目的时候频繁报错,先去查一下自己有没有装 Git,十有八九是缺了这个依赖导致核心功能跑不起来。
桌面端和命令行版,到底该选哪个
很多人纠结到底装哪个版本,其实完全看你的使用习惯,俩是独立的形态,也可以都装。
如果你平时主要写代码、捋技术方案,喜欢图形化界面,需要同时开多个对话会话,那桌面端更适合你。可视化的侧边栏、历史记录分类、全局快捷键支持,用起来更顺手,不用记一堆命令,对新手也更友好。要是你天天泡在终端里,习惯用键盘搞定一切,经常要在项目目录里直接改代码查 bug,那命令行版本更贴合你的工作流,唤起就能用,不用来回切窗口,效率更高。
我自己是两个都装了,平时写需求文档、捋技术思路用桌面端,改项目代码的时候就切终端版,怎么顺手怎么来,不用非死磕选一个。
整个流程没什么技术门槛,跟着走几分钟就能搞定。原生客户端的流畅度,比网页版用着省心不少。