Claude Code 安装教程：Windows、Mac、Linux 一条命令装好

更新于 2026-10-13

Claude Code 现在的官方推荐装法是「原生安装」：复制一条命令到终端就行，不用先装 Node.js。网上很多旧教程还在教 npm 安装，那只是备选。下面的命令全部来自官方文档。

先看电脑够不够格

官方写明的系统要求：

  • 系统：macOS 13.0 及以上；Windows 10 1809 及以上；Ubuntu 20.04+、Debian 10+ 等 Linux。
  • 硬件：4 GB 以上内存，x64 或 ARM64 处理器。
  • 网络：需要联网。

不想用命令行的话，官方还有带图形界面的桌面版，下载入口在官方文档里（链接见文末）。

Mac / Linux：一条命令

打开「终端」，粘贴这条命令回车：

curl -fsSL https://claude.ai/install.sh | bash

官方提醒：下载过程中不显示进度，看着像卡住是正常的，等它结束即可。Mac 用户也可以用 Homebrew：

brew install --cask claude-code

区别是原生安装会在后台自动更新，Homebrew 装的要自己运行 brew upgrade claude-code 更新。

Windows：先分清 PowerShell 还是 CMD

Windows 有两种命令行，命令不一样。看提示符：开头是 PS C:\ 的是 PowerShell，只有 C:\ 没有 PS 的是 CMD。

PowerShell：

irm https://claude.ai/install.ps1 | iex

CMD：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
  • 不需要用管理员身份运行。
  • 官方建议顺手装上 Git for Windows，这样 Claude Code 可以用 Bash 工具；不装也能用，它会改用 PowerShell 执行命令。
  • 也可以用 WinGet：winget install Anthropic.ClaudeCode（不会自动更新，要手动 winget upgrade Anthropic.ClaudeCode）。
  • 习惯 Linux 环境的可以在 WSL 里装：进入 WSL 终端后用上面 Mac / Linux 那条命令。

验证装好了没有

装完后新开一个终端窗口，输入：

claude --version

能打印出版本号就是装好了。想做更详细的检查，运行：

claude doctor

它会列出安装状态、设置文件有没有错误，以及建议的修复办法，不会启动会话。

安装失败？对照这几种报错

现象原因和处理
提示 claude 找不到 / 不是内部或外部命令安装目录还没进 PATH。先新开一个终端再试；还不行按官方「Fix your PATH」处理
The token '&&' is not a valid statement separator你在 PowerShell 里用了 CMD 的命令，换成 PowerShell 那条
'irm' is not recognized…你在 CMD 里用了 PowerShell 的命令，换成 CMD 那条
syntax error near unexpected token '<'、403 等安装脚本没下载到正确内容，多半是网络访问不了 claude.ai。官方排错页有对照表和替代装法

网络始终连不上安装脚本时，可以试试下面的 npm 方式：官方文档说明 npm 包是通过 npm 的依赖拉取程序文件的，走的是你电脑配置的 npm 源。

备选：用 npm 安装

npm install -g @anthropic-ai/claude-code
  • 官方要求 Node.js 22 或更高版本。
  • 不要加 sudo：官方明确警告 sudo npm install -g 会带来权限问题和安全风险。
  • 以后升级用 npm install -g @anthropic-ai/claude-code@latest，官方不建议用 npm update -g。

装好之后：国内怎么用起来

第一次运行 claude 会让你登录。官方说明 Claude Code 需要 Pro、Max 等付费订阅或 Console 账号，免费的 claude.ai 账号不包含 Claude Code。

没有官方订阅的国内用户，常见做法是接入中转 API：设置 ANTHROPIC_BASE_URL 和令牌两个变量就能用，不需要登录官方账号。具体步骤看本站教程「Claude Code 国内怎么用」，选站看「写代码」场景。

更新和卸载

  • 更新：原生安装会自动更新；想马上更新运行 claude update。
  • 卸载（Mac / Linux 原生安装）：
    rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude
  • 卸载（npm）：npm uninstall -g @anthropic-ai/claude-code；Homebrew：brew uninstall --cask claude-code；WinGet：winget uninstall Anthropic.ClaudeCode。
  • Windows 原生安装的卸载命令，以及怎么清除设置文件，见官方文档。清除 ~/.claude 会删掉全部设置和会话记录，谨慎操作。

常见问题

claude code如何安装
Mac / Linux 在终端运行 curl -fsSL https://claude.ai/install.sh | bash；Windows PowerShell 运行 irm https://claude.ai/install.ps1 | iex。装完新开终端输入 claude --version 验证。
claudecode安装教程非nodejs
官方推荐的原生安装不需要 Node.js，一条命令即可。只有选择 npm 安装方式时才需要 Node.js 22 或更高版本。
claudecode安装失败怎么办
先看报错：命令找不到多半是 PATH 没生效，新开终端再试；Windows 上 && 或 irm 报错是 PowerShell 和 CMD 的命令用反了；403 或 syntax error 多半是网络没下到安装脚本，可以换 npm 方式或查官方排错页。
claude code 安装包在哪下载
命令行版没有单独的安装包，是用安装命令在线下载的；官方另有带图形界面的桌面版可以下载，入口在官方文档。

参考来源

所属场景

同场景其他教程