如何在国内安装 Claude Code？
Node 版本不够怎么办？
是否支持 Windows？
有没有一键安装脚本？

本教程提供：

• ✅ macOS 一键安装脚本

• ✅ Linux 一键安装脚本

• ✅ Windows PowerShell 安装方法

• ✅ Node.js 自动升级方案

• ✅ 国内稳定使用解决方案

---

一、什么是 Claude Code？

Claude Code 是 Anthropic 官方推出的 CLI AI 编程助手工具。

安装后可在终端中使用：

• 代码生成

• 项目分析

• Bug 修复

• 命令解释

• AI 辅助开发

官方 npm 包：

@anthropic-ai/claude-code

---

二、Claude Code 安装前的环境要求

最低要求：

• Node.js >= 18

• npm

检查方法：

node -v
npm -v

如果 Node 版本低于 18，脚本会自动升级。

---

三、macOS / Linux 一键安装 Claude Code 脚本

适用系统：

• macOS

• Ubuntu / Debian

• CentOS

• Fedora

• Arch Linux

---

✅ 一键安装命令

bash <(curl -fsSL https://yourdomain.com/install-claude.sh)

---

✅ 完整安装脚本（Node >=18 版本）

#!/usr/bin/env bash
set -euo pipefail

REQUIRED_NODE_MAJOR=18

maybe_sudo() {
  if [[ $EUID -eq 0 ]]; then "$@"
  elif command -v sudo >/dev/null 2>&1; then sudo "$@"
  else echo "need sudo"; exit 1
  fi
}

node_ok() {
  if ! command -v node >/dev/null 2>&1 || ! command -v npm >/dev/null 2>&1; then
    return 1
  fi
  local v="$(node --version 2>/dev/null || true)"
  v="${v#v}"
  local major="${v%%.*}"
  [[ "$major" =~ ^[0-9]+$ ]] && (( major >= REQUIRED_NODE_MAJOR ))
}

install_node() {
  if command -v apt >/dev/null 2>&1 || command -v apt-get >/dev/null 2>&1; then
    curl -fsSL https://deb.nodesource.com/setup_20.x | maybe_sudo bash -
    if command -v apt >/dev/null 2>&1; then
      maybe_sudo apt install -y nodejs
    else
      maybe_sudo apt-get install -y nodejs
    fi
    return
  fi

  if command -v dnf >/dev/null 2>&1; then
    curl -fsSL https://rpm.nodesource.com/setup_20.x | maybe_sudo bash -
    maybe_sudo dnf install -y nodejs
    return
  fi

  if command -v yum >/dev/null 2>&1; then
    curl -fsSL https://rpm.nodesource.com/setup_20.x | maybe_sudo bash -
    maybe_sudo yum install -y nodejs
    return
  fi

  if command -v pacman >/dev/null 2>&1; then
    maybe_sudo pacman -Sy --needed --noconfirm nodejs npm
    return
  fi

  if command -v brew >/dev/null 2>&1; then
    brew update
    brew install node@20
    brew link --overwrite --force node@20
    return
  fi

  echo "请先手动安装 Node.js >= 18"
  exit 1
}

if ! node_ok; then
  install_node
fi

npm install -g @anthropic-ai/claude-code || {
  prefix="${HOME:-$PWD}/.npm-global"
  mkdir -p "$prefix"
  npm config set prefix "$prefix"
  npm install -g @anthropic-ai/claude-code
  export PATH="$prefix/bin:$PATH"
}

echo "Claude Code 安装完成。"
echo "请继续执行【国内中转配置脚本】。"

---

四、Windows PowerShell 安装 Claude Code

适用系统：

• Windows 10

• Windows 11

---

PowerShell 安装脚本

$requiredMajor = 18

$nodeVersion = node -v 2>$null

if (-not $nodeVersion) {
    Write-Host "请先安装 Node.js 18 以上版本"
    exit
}

$nodeVersion = $nodeVersion.TrimStart("v")
$major = $nodeVersion.Split(".")[0]

if ([int]$major -lt $requiredMajor) {
    Write-Host "Node 版本低于 18，请升级 Node.js"
    exit
}

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

if ($LASTEXITCODE -ne 0) {
    $prefix = "$HOME\.npm-global"
    New-Item -ItemType Directory -Force -Path $prefix
    npm config set prefix $prefix
    npm install -g @anthropic-ai/claude-code
    $env:PATH="$prefix;$env:PATH"
}

Write-Host "Claude Code 安装完成"
Write-Host "请继续执行国内中转配置"

---

五、国内使用 Claude Code 的常见问题

在国内直接调用 API 常见问题：

• 请求超时

• API 连接失败

• 认证异常

• 延迟过高

如果你遇到这些问题，通常不是安装问题，而是网络访问问题。

---

六、国内稳定使用方案（推荐）

为了保证 Claude Code 稳定运行，建议使用国内中转配置。

国内中转配置获取地址：

👉 https://codexcli-china.com

支持：

• 稳定访问

• 低延迟

• 简单配置

• 无需复杂代理

获取配置后，执行覆盖脚本即可。

---

七、Claude Code 常见 FAQ

1️⃣ 必须 Node 18 吗？

是的，最低要求 Node >=18。

2️⃣ Windows 可以用吗？

可以，使用 PowerShell 安装即可。

3️⃣ 为什么安装成功却无法调用？

通常是 API 网络问题，建议使用中转配置。

4️⃣ 是否支持 macOS？

支持，包括 Apple Silicon。

---

八、总结

通过本教程，你可以：

• 自动安装 Node 18+

• 一键安装 Claude Code

• 支持 macOS / Linux / Windows

• 解决国内访问问题

如果你在国内使用 Claude Code：

建议优先配置中转服务