Claude Code 安装教程:Windows、Mac 与 Linux 安装、登录和验证
Claude Code 安装推荐官方原生命令,装完用 claude --version 和 claude doctor 验证。本文按官方文档说明系统要求、账号前提、Windows 原生与 WSL 的选择、npm 安装注意事项和首次登录。
Claude Code 安装最稳的路径是用官方原生安装命令:macOS、Linux 和 WSL 在终端运行 curl -fsSL https://claude.ai/install.sh | bash,Windows 在 PowerShell 运行 irm https://claude.ai/install.ps1 | iex。装完后新开一个终端执行 claude --version 能看到版本号,再进入项目目录运行 claude 登录。真正容易卡住的地方通常不是下载,而是账号类型、PATH 和 Windows 上该用原生还是 WSL。
安装前先确认三件事
第一是系统版本。Anthropic 官方安装文档列出的最低要求是 macOS 13.0 以上、Windows 10 1809 以上或 Windows Server 2019 以上、Ubuntu 20.04 以上、Debian 10 以上、Alpine Linux 3.19 以上。硬件要求是 4 GB 以上内存和 x64 或 ARM64 处理器,运行时必须联网,终端可以是 Bash、Zsh、PowerShell 或 CMD。
第二是账号。官方文档写明,Claude Code 需要 Pro、Max、Ultra、Team、Enterprise 或 Console 账号,免费的 claude.ai 计划不包含 Claude Code。也可以通过 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 这类第三方云接入。很多人装好之后打不开会话,原因就是用的是免费账号,这一步应该在安装前确认,而不是装完再排查。
第三是地区。官方把“位于 Anthropic 支持的国家或地区”列为系统要求的一部分。如果你所在的网络环境无法访问官方安装地址,命令可能报 403 或返回网页内容,这时应先看官方的安装排错页,不要从来源不明的镜像下载二进制文件。
按系统选择安装方式
官方推荐原生安装,它会在后台自动更新。除了上面两条命令,Windows CMD 用户可以执行官方给出的 install.cmd 命令。安装过程中终端不会显示进度,这是正常现象,等命令结束即可。
如果你习惯包管理器,官方也提供了几种选择。Homebrew 用 brew install --cask claude-code,这个 cask 跟随 stable 通道,通常比最新版晚一周左右,并跳过有严重回归的版本;想要第一时间拿到新版可以装 claude-code@latest。Windows 可以用 winget install Anthropic.ClaudeCode。Debian、Ubuntu、Fedora、RHEL 和 Alpine 可以接入官方签名的 apt、dnf、apk 仓库。需要注意的是,Homebrew、WinGet 和这些 Linux 包管理器安装的版本默认不会自动更新,需要你自己定期升级。
npm 安装仍然可用,命令是 npm install -g @anthropic-ai/claude-code。官方说明 npm 包需要 Node.js 22 或更高版本,它安装的其实是和原生安装器相同的二进制文件,运行时并不依赖 Node。官方特别提醒不要用 sudo npm install -g,否则会带来权限问题,也会让后续自动更新失败。升级 npm 安装时用 npm install -g @anthropic-ai/claude-code@latest,不要用 npm update -g,后者可能不会升到最新版本。
怎么选可以按一个简单原则:个人电脑直接用原生安装,省掉手动更新;团队需要统一版本或已有包管理规范,再选 Homebrew、WinGet 或 Linux 仓库;只有在已经有 Node 工具链且明确需要 npm 管理时才走 npm 安装。
Windows 用原生还是 WSL
官方把 Windows 分成三种情况。原生 Windows 不需要额外组件,但不支持沙箱;WSL 2 需要先启用 WSL 2,支持沙箱化执行命令;WSL 1 只在 WSL 2 不可用时考虑,同样不支持沙箱。
如果你的项目本来就是 Windows 原生工具链,比如 .NET 或 PowerShell 脚本,原生安装更顺手。在 PowerShell 或 CMD 里运行安装命令即可,不需要管理员权限。官方推荐同时安装 Git for Windows:装了之后 Claude Code 用 Git Bash 执行 Bash 工具;没装时它会改用 PowerShell 工具。
如果项目依赖 Linux 工具链,或者你希望命令在沙箱里执行,就选 WSL 2。这时要在 WSL 的终端里运行 Linux 安装命令,并且在 WSL 里启动 claude,不要在 PowerShell 里装完又去 WSL 里找。WSL 环境不需要 Git for Windows。
两个常见报错也能帮你判断自己在哪个终端:看到 The token '&&' is not a valid statement separator 说明你在 PowerShell 却用了 CMD 命令;看到 'irm' is not recognized 说明你在 CMD 却用了 PowerShell 命令。
验证安装:claude --version 和 claude doctor
装完后先新开一个终端窗口,执行 claude --version,正常会输出类似“版本号 (Claude Code)”的结果。如果提示找不到 claude,通常是安装目录还没有进入 PATH。macOS 和 Linux 上原生安装器把启动器放在 ~/.local/bin/claude,可以先检查这个目录是否在 PATH 里。
更完整的检查用 claude doctor。官方说明它会输出只读的安装和设置诊断,不会启动会话,内容包括安装健康状态、设置文件校验错误和带修复建议的警告。遇到更新失败或怀疑装了两份时,先跑一遍它,比反复重装更快定位问题。
第一次登录和启动
进入你的项目目录后运行 claude。第一次使用会提示登录,订阅账号和 Console 账号都会在浏览器里完成授权,之后凭据会保存下来,不需要每次登录。用 Console 账号首次登录时,官方说明会自动在 Console 中创建一个名为“Claude Code”的工作区,便于集中追踪费用。
如果你设置了 ANTHROPIC_API_KEY 环境变量,并在 Claude Code 询问时同意使用这个 key,它会跳过登录提示。这条路径会按 API 计费,团队里共用电脑时要确认环境变量里到底是谁的 key。
进入会话后可以输入 /help 查看命令,/resume 继续之前的对话,/login 切换账号。按 Shift+Tab 可以切换权限模式,决定 Claude 在执行哪些操作前需要你确认。第一次在真实项目里使用时,建议先让它解释项目结构,再给一个范围很小的改动,确认它会在修改前征求同意。
更新、版本通道和卸载
原生安装会在启动时和运行中检查更新,下载后在下次启动生效。你可以在设置里用 autoUpdatesChannel 选择通道:默认的 latest 一发布就更新,stable 使用大约一周前的版本并跳过有严重回归的版本。想马上更新可以运行 claude update。需要完全关闭后台更新时,在 settings.json 的 env 里设置 DISABLE_AUTOUPDATER 为 1。
卸载原生安装时删除 ~/.local/bin/claude 和 ~/.local/share/claude;Homebrew、WinGet、npm 和 Linux 仓库各用对应的卸载命令。配置和会话记录保存在 ~/.claude、~/.claude.json 以及项目里的 .claude 和 .mcp.json,删除它们会清掉设置、已允许的工具、MCP 配置和会话历史,动手前先备份。
一套不容易出错的安装顺序
先确认账号是付费计划或 Console,再确认系统版本满足要求。个人电脑用原生安装,Windows 上根据项目工具链决定原生还是 WSL 2。装完新开终端执行 claude --version,有问题跑 claude doctor。最后进项目目录运行 claude 登录,先做小任务验证权限提示是否符合预期。按这个顺序,大部分安装问题都能在第一步或第二步被发现,而不是等到写代码时才暴露。
Claude Code 免费账号能用吗
不能。官方文档写明免费的 claude.ai 计划不包含 Claude Code,需要 Pro、Max、Ultra、Team、Enterprise、Console 账号或受支持的云服务商接入。
Claude Code 安装需要 Node.js 吗
原生安装、Homebrew 和 WinGet 不需要。只有 npm 安装需要 Node.js 22 或更高版本,而且安装后的二进制运行时也不依赖 Node。
装完提示 claude 找不到怎么办
先新开一个终端,再检查安装目录是否在 PATH 中,macOS 和 Linux 原生安装的启动器位于 ~/.local/bin/claude。仍有问题时运行 claude doctor 或参考官方安装排错页。
Windows 上 WSL 和原生安装哪个好
需要 Linux 工具链或沙箱执行时选 WSL 2;项目本身是 Windows 原生工具链时选原生安装,并建议安装 Git for Windows。
