【Claude Code】Windows11 国内 一键安装保姆级教程｜WinGet官方纯享版

在编程的艺术世界里代码和灵感需要寻找到最佳的交融点才能打造出令人为之惊叹的作品。而在这座秋知叶i博客的殿堂里我们将共同追寻这种完美结合为未来的世界留下属于我们的独特印记。【Claude Code】Windows11 国内 一键安装保姆级教程WinGet官方纯享版开发环境前言一、核心选型WinGet vs 官网脚本一眼选对二、前置环境检查2.1 检查WinGet是否可用2.2 检查Git环境Claude Code运行强依赖三、在线安装一行命令搞定90%用户首选3.1 查看 Claude Code 发行说明3.2 查看最新版本3.1 执行 Claude Code官方一键安装3.2 . 验证安装是否成功输出版本号即为安装完成四、官方升级一键升级五、官方标准卸载一键彻底清理无残留六、启动方式七、第一次使用教程7.1 进入项目目录7.2 打开 Claude Code7.3 选择主题7.4 Claude Code 的首次启动安全免责提示页7.5 授权信任文件夹7.6 成功进入八、高频必踩坑避坑指南九、常用全生命周期管理命令十、【 小课堂】精准搜索小技巧十一、【 编程冷笑话】十二、【✨ 今日金句】开发环境开发环境Windows11前言兄弟们装Claude Code别再跟官网那串PowerShell脚本死磕了国内IP直接锁地区、PowerShell权限报错、脚本执行红一片折腾一下午都装不上。这篇教程全用WinGet官方标准命令在线安装一行命令搞定离线安装3步走完零废话、全是可直接复制的操作小白照着做也能一次成功。一、核心选型WinGet vs 官网脚本一眼选对对比维度官网脚本安装irmiexWinGet包管理器安装地区限制下载环节前置锁死国内IP基本无法使用安装环节无地区校验国内网络可正常执行系统权限需修改PowerShell执行策略有安全风险无需修改系统配置仅需管理员终端权限操作复杂度黑盒执行报错难排查全流程有明确日志问题一眼定位国内适配性极差90%新手会翻车极佳零额外配置一次成功结论国内用户直接选WinGet安装没有任何悬念。二、前置环境检查⚠️核心前提全程必须以管理员身份运行Windows终端/PowerShell否则会因权限不足安装失败右键点击桌面左下角开始菜单选择「终端(管理员)」Windows11/「Windows PowerShell(管理员)」打开终端后依次执行以下命令2.1 检查WinGet是否可用输出版本号即为正常winget--version若提示命令不存在去微软商店搜索「应用安装程序」更新后即可恢复。2.2 检查Git环境Claude Code运行强依赖输出版本号即为正常git--version若提示命令不存在去Git官网下载最新版安装时勾选「Add to PATH」即可。三、在线安装一行命令搞定90%用户首选前置检查全部通过后直接执行以下核心命令全程无需额外操作3.1 查看 Claude Code 发行说明3.2 查看最新版本winget search--idAnthropic.ClaudeCode3.1 执行 Claude Code官方一键安装wingetinstallAnthropic.ClaudeCode3.2 . 验证安装是否成功输出版本号即为安装完成claude--version四、官方升级一键升级如果后续需要升级 Claude Code用WinGet官方命令可以一键升级最新版执行Claude Code官方一键升级命令winget upgrade Anthropic.ClaudeCode五、官方标准卸载一键彻底清理无残留如果后续不需要使用Claude Code用WinGet官方命令可以一键彻底卸载无残留文件无需去控制面板手动操作。执行Claude Code官方一键彻底卸载命令winget uninstall Anthropic.ClaudeCode六、启动方式终端启动任意终端输入claude回车即可进入交互模式现在已经安装好了没有魔法就是这样的 正常的七、第一次使用教程7.1 进入项目目录不要直接打开终端执行claude因为默认是在用户空间下避免删除了不必要的文件进入 D盘 的 ClaudeCodeTestcdD:\ClaudeCodeTest7.2 打开 Claude Code在终端执行claude命令claude7.3 选择主题这里是选择主题的键盘上下直接选第一个 Auto然后回车确定7.4 Claude Code 的首次启动安全免责提示页Security notes: 安全须知Claude can make mistakesAI 也会犯错你必须人工核对 Claude 输出的内容尤其是执行代码、修改系统 / 文件的时候避免误操作。Due to prompt injection risks, only use it with code you trust存在「提示注入」的网络安全风险只对你自己信任、来源干净可靠的代码 / 项目使用。直接回车下一步7.5 授权信任文件夹1 Yes, I trust this folder信任此文件夹2 No, exit拒绝、退出直接选 1 回车确认7.6 成功进入大功告成简要说明序号界面显示内容功能大白话说明1Claude Code v2.1.114本机安装的 Claude Code 客户端版本号2Welcome back!启动登录成功工具已经准备好3Sonnet 4.6当前在用 Claude 最强、最聪明的 Sonnet 4.6 AI模型4API Usage Billing后续可在这里查看AI调用量、用量统计、计费账单5D:\ClaudeCodeTest锁定工作文件夹AI只会碰这个文件夹里的东西不会乱改其他文件6Tips for getting started新手引导可以让AI新建程序、拉取代码仓库7Recent activity / No recent activity历史操作记录现在空白还没做过任何任务8底部输入栏✅ 核心输入区在这里打字给AI下指令、写博客9? for shortcuts输入单个?回车就能查看所有快捷键10右下角黄色提示字有新版本可更新升级命令winget upgrade Anthropic.ClaudeCode八、高频必踩坑避坑指南报错现象根因一键解决方案winget search Claude Code报错「在未预期的情况下找到位置参数: “Code”」WinGet把空格识别为参数分隔符带空格的搜索词必须用双引号括起winget search Claude Code提示「找不到与输入条件匹配的程序包」包名拼写错误漏了官方前缀严格使用官方唯一包IDAnthropic.ClaudeCode安装报错「权限不足」「写入文件失败」未用管理员身份运行终端关闭当前终端重新以管理员身份打开执行命令安装完成后claude命令不识别系统PATH环境变量未刷新关闭所有终端窗口重新打开即可仍无效则手动把安装目录加入系统PATH九、常用全生命周期管理命令操作需求直接复制执行的命令升级到最新版本winget upgrade Anthropic.ClaudeCode查看安装包详细信息winget show Anthropic.ClaudeCode一键彻底卸载winget uninstall Anthropic.ClaudeCode十、【 小课堂】精准搜索小技巧想避免搜出一堆无关软件直接用--id精准锁定官方包零冗余结果winget search--idAnthropic.ClaudeCode十一、【 编程冷笑话】程序员A我装Claude Code跟官网脚本斗了一下午结果地区锁死根本装不上。程序员B你早用WinGet啊一行命令的事非要绕远路踩坑。程序员A合着我一下午就干了件「脱裤子放屁」的事十二、【✨ 今日金句】高效开发的第一步就是用最官方、最简洁的方案解决最基础的环境问题把时间留给真正有价值的代码。