Skip to content

Node.js 与 Git 环境配置

Claude Code、Codex CLI 和部分辅助工具需要 Node.js、npm 与 Git。

检查环境

在终端执行:

bash
node -v
npm -v
git --version

能输出版本号即代表基础环境可用。

安装建议

Windows

推荐安装:

  • Node.js LTS
  • Git for Windows
  • Windows Terminal

安装完成后重新打开终端,再检查版本。

macOS

可使用 Homebrew:

bash
brew install node git

Linux

Ubuntu / Debian 可执行:

bash
sudo apt update
sudo apt install -y nodejs npm git

如果系统仓库中的 Node.js 版本过旧,建议改用 nvm 安装 LTS 版本。

npm 权限问题

Mac / Linux 如遇到全局安装权限错误,不建议直接使用 sudo。可以把 npm 全局目录改到用户目录:

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

zsh 用户把 ~/.bashrc 改为 ~/.zshrc