Claude Code 中转介绍
安装与环境检查
安装 Claude Code CLI 与必备环境（Node.js、Git）的步骤。
系统要求
| 项目 | 最低 | 推荐 |
|---|---|---|
| Node.js | 18.x | 20 LTS 或 22 LTS |
| 磁盘空间 | 200 MB | — |
| 操作系统 | macOS / Linux / Windows 10+ | — |
一、安装 Node.js
如果你已经装了 Node.js 18+，可跳过这步。
macOS
# 用 Homebrew（推荐）
brew install node
# 或用 nvm（多版本管理）
brew install nvm
nvm install 20 && nvm use 20
Linux
# Ubuntu / Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
# 或用 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install 20
Windows
从 nodejs.org 下载 LTS 安装包，全程默认即可。
Windows 安装时务必勾选「Add to PATH」，否则后续
npm 命令找不到。验证
node --version # v20.x.x
npm --version # 10.x.x
二、安装 Claude Code CLI
全局安装
npm install -g @anthropic-ai/claude-code
macOS / Linux 上不要用 sudo。如果遇到
EACCES 权限错误，是 npm 全局目录权限问题，请按下面方法修复，不要简单粗暴用 sudo。npm 权限修复（macOS / Linux）
# 让 npm 全局目录指向用户目录
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
# 加入 PATH
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
# 再次安装
npm install -g @anthropic-ai/claude-code
验证安装
claude --version
which claude # macOS / Linux
where claude # Windows
如果显示版本号即安装成功。如果 command not found，参考 故障排查 → claude 找不到命令。
三、（可选）安装 Git
Claude Code 在很多场景（commit message、diff 分析、PR 描述生成）会用 Git。如果你没装：
# macOS
brew install git
# Ubuntu / Debian
sudo apt install -y git
# Windows
# 从 https://git-scm.com/download/win 下载安装
四、（可选）安装 ripgrep
Claude Code 内置代码搜索用 ripgrep，性能比 grep 快几十倍。强烈推荐：
# macOS
brew install ripgrep
# Ubuntu / Debian
sudo apt install -y ripgrep
# Windows（用 Scoop）
scoop install ripgrep
# 或 Cargo
cargo install ripgrep
验证：
rg --version
五、环境检查脚本
把下面脚本保存为 check-env.sh / check-env.ps1，一次性检查所有依赖：
#!/usr/bin/env bash
echo "=== 环境检查 ==="
for cmd in node npm git rg claude; do
if command -v $cmd >/dev/null 2>&1; then
echo "✅ $cmd: $($cmd --version 2>&1 | head -1)"
else
echo "❌ $cmd: 未安装"
fi
done
echo ""
echo "=== Node.js 版本检查 ==="
node_major=$(node -v | sed 's/v//;s/\..*//')
if [ "$node_major" -ge 18 ]; then
echo "✅ Node.js >= 18"
else
echo "❌ Node.js < 18，请升级"
fi
Write-Host "=== 环境检查 ==="
foreach ($cmd in @("node", "npm", "git", "rg", "claude")) {
if (Get-Command $cmd -ErrorAction SilentlyContinue) {
$ver = & $cmd --version 2>$null | Select-Object -First 1
Write-Host "✅ $cmd: $ver"
} else {
Write-Host "❌ $cmd: 未安装"
}
}
Write-Host ""
Write-Host "=== Node.js 版本检查 ==="
$nodeMajor = ((node -v) -replace 'v', '' -split '\.')[0]
if ([int]$nodeMajor -ge 18) {
Write-Host "✅ Node.js >= 18"
} else {
Write-Host "❌ Node.js < 18，请升级"
}