当前位置：首页 > news >正文

Claude Code 安装教程（macOS / Linux / Windows PowerShell 一键脚本）【2026 最新】

news 2026/3/27 3:52:42

如何在国内安装 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 "请继续执行国内中转配置"