快速开始
安装Node.js 和 Git
注意：这是必须的安装通用环境步骤
快速开始
如果你还没有安装 Node.js 和 Git，请按照以下步骤操作，以确保你的环境配置正确。
安装 Node.js
推荐使用 Node.js LTS（长期支持）版本，当前推荐版本为 v22.x 或更高版本。
Windows 系统
- 访问 Node.js 官网
- 下载 LTS 版本的安装包
- 运行下载的
.msi安装文件 - 按照安装向导完成安装（建议勾选"自动安装必要工具"选项）
macOS 系统
推荐方式：使用 nvm (Node Version Manager)
nvm 可以方便地管理多个 Node.js 版本，推荐使用此方式安装。
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 重新加载配置文件
source ~/.zshrc # 如果使用 bash，则运行: source ~/.bashrc
# 安装 Node.js LTS 版本
nvm install --lts
# 设置默认版本
nvm alias default lts/*
# 使用 LTS 版本
nvm use --lts
nvm 的优势： 可以轻松切换不同 Node.js 版本，适合需要在多个项目间工作的开发者。
备选方式：使用 Homebrew
brew install node
Linux 系统
推荐方式：使用 nvm (Node Version Manager)
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 重新加载配置文件
source ~/.bashrc # 如果使用 zsh，则运行: source ~/.zshrc
# 安装 Node.js LTS 版本
nvm install --lts
# 设置默认版本
nvm alias default lts/*
# 使用 LTS 版本
nvm use --lts
备选方式：使用包管理器
Ubuntu/Debian:
# 使用 NodeSource 存储库安装 Node.js 22.x
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
Fedora/RHEL/CentOS:
# 使用 NodeSource 存储库安装 Node.js 22.x
curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
sudo dnf install -y nodejs
验证安装
安装完成后，打开终端或命令提示符，运行以下命令验证安装：
# 检查 Node.js 版本
node -v
# 检查 npm 版本
npm -v
如果正确显示版本号，说明 Node.js 安装成功。
安装 Git
Git 是一个分布式版本控制系统，用于代码管理和协作开发。
Windows 系统
- 访问 Git 官网
- 下载最新版本的 Git 安装包
- 运行安装程序，推荐配置：
- 选择 "Git from the command line and also from 3rd-party software"
- 选择 "Use Windows' default console window"
- 其他选项保持默认即可
- 完成安装
macOS 系统
方式一：使用 Homebrew
brew install git
方式二：使用 Xcode Command Line Tools
xcode-select --install
方式三：下载官方安装包
访问 Git 官网 下载并安装。
Linux 系统
Ubuntu/Debian:
sudo apt-get update
sudo apt-get install git
Fedora/RHEL/CentOS:
sudo dnf install git
验证安装
# 检查 Git 版本
git --version
配置 Git
安装完成后，建议配置您的用户信息：
# 配置用户名
git config --global user.name "您的名字"
# 配置邮箱
git config --global user.email "[email protected]"
# 查看配置
git config --list
提示： 这些配置信息会在您提交代码时使用，建议使用真实的名字和邮箱。
常见问题
Node.js 安装失败
如果在 Windows 上安装 Node.js 遇到问题：
- 确保以管理员权限运行安装程序
- 关闭杀毒软件后重试
- 检查系统是否有足够的磁盘空间
npm 命令无法使用
如果安装后 npm 命令无法识别：
- Windows 系统： 检查环境变量中是否包含 Node.js 路径
- macOS/Linux： 重新打开终端窗口或运行
source ~/.bashrc（或~/.zshrc）
Git 中文乱码
如果 Git 显示中文文件名为乱码，可以执行：
git config --global core.quotepath false
下一步
安装完成后，您可以继续查看 Claude Code配置文档 了解如何开始使用。