Claude Code 系统要求与环境准备

在安装 Claude Code 之前，确保你的系统满足以下要求。

1. Node.js 和 npm 要求

Claude Code 的命令行工具依赖 Node.js 和 npm，因此需要先确保它们已正确安装。

检查 Node.js 和 npm 版本

打开终端或命令提示符，运行以下命令检查 Node.js 和 npm 版本：

node --version
npm --version

如果输出显示 Node.js 版本 ≥ 16.0 和 npm 版本 ≥ 8.0，则可以跳过安装步骤。

安装 Node.js

如果没有安装 Node.js 或版本不符合要求，可以通过以下方式安装：

使用 Node 版本管理器可以方便地管理多个 Node.js 版本，推荐使用 nvm（Node Version Manager）：

对于 macOS 和 Linux：

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 或使用 wget
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 安装最新 LTS 版本
nvm install --lts

2. Git 要求

Claude Code 使用 Git 进行代码管理和插件安装，因此需要确保 Git 已正确安装。

检查 Git 版本

打开终端或命令提示符，运行以下命令检查 Git 版本：

git --version

如果输出显示 Git 版本 ≥ 2.0，则可以跳过安装步骤。

安装 Git

对于 macOS：
macOS 系统可能已预装 Git，你可以通过以下方式更新到最新版本：

# 使用 Homebrew 安装 Git
brew install git

配置 Git 用户信息

安装 Git 后，需要配置用户名和电子邮件，这些信息将用于代码提交：

git config --global user.name "你的用户名"
git config --global user.email "你的邮箱地址"

3. 环境验证

完成上述安装后，运行以下命令验证环境是否准备就绪：

node --version
npm --version
git --version

如果所有命令都能正常输出且版本符合要求，则说明环境准备就绪，可以开始安装 Claude Code 了。

4. 常见问题解决方案

问题：运行 node --version 时显示 "command not found"

解决方案：

• 确保 Node.js 已正确安装并添加到系统 PATH 环境变量中
• 重启终端或命令提示符
• 对于使用 nvm 安装的情况，确保已通过 nvm use 命令激活相应版本

问题：使用 npm 安装包时显示网络错误或权限错误

解决方案：

• 检查网络连接是否正常
• 尝试使用淘宝镜像源：npm config set registry https://registry.npmmirror.com
• 对于权限问题，可以尝试使用 sudo（Linux/macOS）或以管理员身份运行（Windows）
• 或者修改 npm 全局安装目录权限

问题：Git 提交时显示用户名或电子邮件未配置

解决方案：
运行以下命令配置 Git 用户信息：

git config --global user.name "你的用户名"
git config --global user.email "你的邮箱地址"

5. 其他包管理器支持

如果你更喜欢使用 yarn 或 pnpm 作为包管理器，Claude Code 也支持它们：

安装 yarn：

npm install -g yarn

安装 pnpm：

npm install -g pnpm

6. 网络配置

配置 npm 镜像

为了提高 npm 包的下载速度，可以配置 npm 镜像：

npm config set registry https://registry.npmmirror.com

配置代理设置

如果你的网络环境需要使用 HTTP 代理，可以配置 npm 和 Git 的代理设置：

配置 npm 代理：

npm config set proxy http://proxy.example.com:8080
npm config set https-proxy http://proxy.example.com:8080

配置 Git 代理：

git config --global http.proxy http://proxy.example.com:8080
git config --global https.proxy http://proxy.example.com:8080