安装前置条件:系统要求与账号档位

五个条件,缺任何一个装了也用不起来。花两分钟对一遍,比装到一半再回头省事。

约 5 分钟

装之前先对一遍。这五条里缺任何一条,装完也跑不起来——而且有两条是钱和时间都解决不了的。

一、系统版本

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 loadSymbol not found 这类错误——换安装方式不解决,因为所有安装方式下载的是同一个程序。只能升级系统。

怎么看自己的版本:

  • macOS:左上角苹果菜单 → 关于本机
  • WindowsWin + 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 两节。

← 回到手册目录