安装前置条件:系统要求与账号档位
五个条件,缺任何一个装了也用不起来。花两分钟对一遍,比装到一半再回头省事。
装之前先对一遍。这五条里缺任何一条,装完也跑不起来——而且有两条是钱和时间都解决不了的。
一、系统版本
2026-08-05 查证的官方要求。
| 系统 | 最低版本 |
|---|---|
| macOS | 13.0(Ventura)或更高 |
| Windows | Windows 10 版本 1809 或更高,或 Windows Server 2019+ |
| Ubuntu | 20.04+ |
| Debian | 10+ |
| Alpine Linux | 3.19+ |
macOS 低于 13.0 是硬门槛。 装是能装上,但一运行就会报 dyld: cannot load 或 Symbol not found 这类错误——换安装方式不解决,因为所有安装方式下载的是同一个程序。只能升级系统。
怎么看自己的版本:
- macOS:左上角苹果菜单 → 关于本机
- Windows:
Win + R输入winver回车
二、硬件
- 内存 4 GB 以上
- 64 位处理器(x64 或 ARM64)
Claude Code 不支持 32 位 Windows。 如果报了这个错,先确认是不是你打开了开始菜单里带 (x86) 的那个 PowerShell——这是最常见的原因,而且和你的电脑是不是 64 位无关。 在报错的那个窗口里输入:
[Environment]::Is64BitOperatingSystem
结果是 True 就说明系统没问题,关掉这个窗口,改开不带 (x86) 的那一项。
三、订阅档位
免费档不含 Claude Code。
可用的档位:Pro、Max、Team、Enterprise,或者 Console 账号。
这一条不能绕。 在此之前你需要先有一个能正常登录的账号,见账号注册与手机号验证与三种订阅支付方式及其风险。
关于选哪个档:先从 Pro 开始,理由见订阅档位对比。唯一需要提前知道的是——Claude Code 里 Opus 的 1M 长窗口 Pro 要另外买,但换用 Sonnet 5 就有完整的 1M,不花钱。
四、地区
Claude Code 只在 Anthropic 支持的国家可用。
如果安装时看到 App unavailable in region,那不是网络故障,是地区判定。
我们不提供、也不建议任何与网络环境相关的方案。这属于你自己的环境,超出我们的服务范围——见账号风控机制与异常判定里的同一条说明。
五、Windows 用户:要不要装 Git
Git for Windows 是可选的,不是必需的。
这一点经常被讲错。实际情况是:
| Claude Code 用什么执行命令 | |
|---|---|
| 装了 Git for Windows | 用 Git Bash |
| 没装 | 用 PowerShell |
两种都能跑。 装 Git 的好处是让它能用 Bash——如果你后面会接触到 Bash 写的脚本或工具,装上更顺;如果只是让它整理文档、处理表格,不装也完全够用。
建议还是装上:安装过程一路点「下一步」,不需要你学 Git,而且以后不用回头补。下载地址 git-scm.com/downloads/win。安装时到「Adjusting your PATH environment」那一屏,保持推荐选项不动。
注意:Windows 上「装不装 Git」和「用原生还是 WSL」是两件独立的事。WSL 下不需要 Git for Windows。 详见 Windows 安装指引。
对照表
装之前逐条打钩:
| 检查项 | 不满足会怎样 | |
|---|---|---|
| ① | 系统版本达标 | 装得上,跑不起来 |
| ② | 内存 4 GB、64 位 | 安装中途被中止 |
| ③ | Pro 及以上订阅 | 登录后无法使用 |
| ④ | 所在地区受支持 | 下载即失败 |
| ⑤ | Windows:想清楚装不装 Git | 只影响它用哪种方式执行命令 |
前四条不满足就别往下走了,先解决条件问题。继续折腾安装流程不会有结果。
条件都齐了,按你的系统往下:
本节事实查证日期:2026-08-05。 依据:官方 Advanced setup 的 System requirements 与 Authenticate 两节。