Claude Code 安装指南（macOS / Linux / Windows WSL）

前几篇把核心概念都捋清楚了，这篇直接动手装。macOS 和 Linux 原生支持，Windows 用户走 WSL 方案------三种环境全覆盖，一个步骤不省。

前置依赖：装之前先确认三件事

Claude Code 不挑硬件，但有几个必须满足的条件：

Node.js 18 或更高版本 ：Claude Code 是基于 Node.js 的 CLI 工具。推荐用 nvm（Node Version Manager）管理 Node 版本，可以灵活切换。终端输入 node -v 确认当前版本，版本号低于 18 的话先升级。

npm 或 yarn ：安装 Node.js 时通常自带 npm，输入 npm -v 确认已可用。

Git ：Claude Code 需要 Git 来跟踪代码变更和生成 diff。输入 git --version 确认已安装。基本上开发者的电脑上都有，如果没有，macOS 上 brew install git，Linux 上 apt install git。

网络环境：Claude Code 的所有操作都需要和 Anthropic 的 API 通信。如果你在国内且用直连出现频繁超时，建议提前配好稳定的代理环境。

macOS 安装

macOS 安装最简单，一条命令：

bash 复制代码

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

-g 表示全局安装，安装后 claude 命令在任何目录下都可用。安装耗时取决于网络，通常在 30 秒到 2 分钟之间。

安装完成后验证：

bash 复制代码

claude --version

输出类似 claude-code v1.x.x 表示安装成功。

首次运行 ：在项目目录下输入 claude，首次启动会引导你完成初始配置------

登录 Anthropic 账号：浏览器会自动打开登录页，用你的 Anthropic 账号授权
选择 API 计费方式：可以选 API Key（按用量计费）或 Pro 订阅（固定月费）。API Key 方式自由度高但需要去 Anthropic Console 生成 Key；Pro 订阅最省心但额度受限
设置权限级别：默认是"手动批准所有操作"，可以在配置中调为半自动模式

首次配置完成后 Clouse Code 进入交互界面，看到 > 提示符就可以开始对话了。

常用可选配置：

bash 复制代码

# 全局允许自动批准 Bash 命令（不推荐新手开）
claude config set --global permissions.allowBash true

# 设置在指定项目目录下自动批准
claude config set permissions.allowBash true

# 查看当前配置
claude config list

Linux 安装

Linux 的安装命令和 macOS 完全一致：

bash 复制代码

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

但有几个 Linux 特有的注意点：

权限问题 ：如果在全局安装时遇到 EACCES 权限错误，不要加 sudo------这会导致后续使用时的权限混乱。正确的做法是用 nvm 管理 Node.js，nvm 安装的 Node 会把全局包装在用户目录下，不需要 root 权限。

如果已经装了 Node 但不在 nvm 下，可以手动配置 npm 的全局安装路径：

bash 复制代码

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

字体和终端兼容性：Claude Code 的交互界面使用了 Unicode 字符来展示进度和状态。确保你的终端字体支持这些字符。推荐使用支持 Nerd Fonts 的终端（如 iTerm2、Windows Terminal、Kitty）。

X11 / Wayland 依赖：首次登录时 Claude Code 会尝试打开浏览器做 OAuth 认证。确保你的 Linux 环境能正常打开浏览器------如果没有图形界面，Claude Code 会给出一个手动认证的链接，复制到有浏览器的机器上完成授权。

Windows 安装（WSL）

Claude Code 目前没有 Windows 原生版本，Windows 用户通过 WSL（Windows Subsystem for Linux）运行。

第一步：安装 WSL

打开 PowerShell（管理员），输入：

bash 复制代码

wsl --install

这会安装 WSL 2 和默认的 Ubuntu 发行版。安装完成后重启电脑。重启后首次进入 Ubuntu 终端，设置用户名和密码。

如果之前已经装了 WSL 1，建议升级到 WSL 2：

bash 复制代码

wsl --set-default-version 2

第二步：在 WSL 中装 Node.js

进入 WSL 终端（在 Windows Terminal 中选择 Ubuntu 或运行 wsl 命令），安装 nvm 和 Node.js：

bash 复制代码

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 18

确认版本：

bash 复制代码

node -v  # 应该 >= 18
npm -v

第三步：安装 Claude Code

bash 复制代码

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

验证安装：

bash 复制代码

claude --version

第四步：在 WSL 中开发

Claude Code 在 WSL 里操作的文件，必须放在 WSL 的文件系统内（/home/用户名/ 下），不能放在 Windows 的文件系统下（/mnt/c/ 下）。WSL 访问 Windows 文件系统有性能损耗，Claude Code 执行文件操作时容易因为 I/O 延迟导致超时。

建议把你的项目 clone 到 WSL 的用户目录下，用 VS Code 的 Remote-WSL 插件在 Windows 端编辑，Claude Code 在 WSL 终端里运行------两条路径配合，体验最好。

第五步：OAuth 登录

首次运行 claude 时，WSL 会自动调用 Windows 端的默认浏览器完成登录。如果自动跳转失败，终端里会显示一个手动授权链接，复制出来在浏览器里打开即可。

首次启动验证

不管哪个系统，装完后做一个基础验证确认一切正常：

bash 复制代码

# 进入你的项目目录
cd ~/your-project

# 启动 Claude Code
claude

# 输入第一个测试指令
> 请列出当前目录下有哪些文件

Claude Code 应该能正确列出文件。如果它说"我无法访问当前目录"，检查工作目录是否正确（pwd 确认路径）以及文件权限。

升级和卸载

升级到最新版：

bash 复制代码

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

卸载：

bash 复制代码

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

卸载后 API Key 和配置文件不会自动删除。如果想彻底清理：

bash 复制代码

rm -rf ~/.claude

这会删除所有配置和对话历史，操作前确认你不再需要。

总结

三条命令搞定安装：

bash 复制代码

# macOS / Linux
npm install -g @anthropic-ai/claude-code

# 验证
claude --version

# 启动
claude

Windows 用户多一步 WSL 环境准备，但核心安装命令一模一样。

下一篇我带你跑通第一个小功能------从提需求到出代码到验证，完整走一遍 Claude Code 的开发闭环。

如果这篇安装指南帮你顺利装好了 Claude Code，欢迎分享给身边也在折腾安装的朋友。你用的哪个系统？安装过程有没有遇到什么奇怪的报错？评论区聊聊~