Claude Code 下载与配置

Claude Code 在 Windows、macOS、Linux 上的完整安装、登录、更新与常见问题处理。

Claude Code 是 Anthropic 官方的命令行编程助手，直接在终端里读代码、改代码、跑命令。它支持 Windows、macOS、Linux。官方现在推荐用原生安装脚本（不依赖 Node.js，还能后台自动更新），也保留了 npm 安装方式。

本文把原生脚本、npm、以及 Windows 的其它几种方式都写清楚，你按自己的环境挑一种即可。

一、准备工作

安装本身免费，但使用需要付费账号：Claude Pro、Max、Team、Enterprise，或 Console（API）账号。免费版 Claude.ai 不含 Claude Code 权限。
走 npm 方式需要 Node.js 18 或更高版本；原生脚本方式不需要 Node.js。
确认网络能正常访问 Anthropic 相关地址。

⚠️ 不要用 sudo npm install -g 安装，容易造成权限和安全问题。如果遇到权限报错，正确做法是用 nvm（把 Node.js 装到用户目录），而不是用 root 跑 npm。

Windows，用 PowerShell 执行：

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

macOS / Linux / WSL，在终端执行：

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

这种方式会下载原生二进制、放进 PATH、并配置好后台自动更新，整个过程一般不到一分钟。

如果要指定版本安装（可选）：

# 安装最新版
curl -fsSL https://claude.ai/install.sh | bash -s latest

# 安装指定版本
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89

装好 Node.js 18+ 后，任意平台执行：

npm install -g @anthropic-ai/claude-code

npm 只是分发渠道：它装的其实是同一个原生二进制（通过按平台的可选依赖分发），运行时并不会调用 Node.js。适合想固定版本、或本来工作流里就用 npm 的人。

Git Bash：先装 Git for Windows，然后在 Git Bash 里执行 curl -fsSL https://claude.ai/install.sh | bash。
WinGet：winget install Anthropic.ClaudeCode。注意 WinGet 不会自动更新，所以更推荐原生脚本。
WSL：需要的话先 wsl --install -d Ubuntu，然后在 Ubuntu 终端里执行原生脚本安装。用 WSL 时，请始终从 Linux 终端里运行 Claude Code。

打开一个新的终端窗口，执行：

claude --version

能看到版本号即安装成功。想全面体检环境和登录状态，可以执行：

claude doctor

进入你的项目目录，直接运行：

claude

第一次启动会引导你登录授权。按提示在浏览器里用你的 Claude 账号（Pro / Max / Team / Enterprise 或 Console）完成登录即可。登录一次后，后续再运行 claude 就不用重复登录。

更新方式取决于你的安装渠道：

npm install -g @anthropic-ai/claude-code@latest

从 npm 切换到原生安装：先卸载 npm 版本，再跑原生脚本：

npm uninstall -g @anthropic-ai/claude-code

PowerShell 提示脚本被禁止执行

PowerShell 默认可能拦截脚本。先执行下面这行，再重新运行安装命令：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

claude: command not found（命令找不到）

多半是安装成功了，但 PATH 没生效。关掉再重开一个终端；还不行就跑 claude doctor 让它帮你排查环境问题。

权限报错

不要用 sudo 装。改用 nvm 把 Node.js 装到用户目录下，再重新安装即可。