Claude Code 是 Anthropic 官方推出的 CLI AI 编程助手工具。在 macOS、Linux 及 Windows 系统下的安装流程。首先需确保 Node.js 版本不低于 18，随后通过 Bash 或 PowerShell 脚本完成一键部署。针对国内用户可能遇到的网络超时或连接失败问题，文中提供了通用的解决方案思路。内容涵盖环境检查、脚本执行、常见问题解答及跨平台兼容性说明，旨在帮助用户快速搭建本地 AI 开发辅助环境。
Claude Code 是 Anthropic 官方推出的 CLI AI 编程助手工具。
安装后可在终端中使用：
官方 npm 包：
@anthropic-ai/claude-code
最低要求：
检查方法：
node -v
npm -v
如果 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 "请继续执行国内中转配置脚本。"
适用系统：
$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 "请继续执行国内中转配置"
在国内直接调用 API 常见问题：
如果你遇到这些问题，通常不是安装问题，而是网络访问问题。
为了保证 Claude Code 稳定运行，建议使用国内中转配置。
支持：
获取配置后，执行覆盖脚本即可。
是的，最低要求 Node >=18。
可以，使用 PowerShell 安装即可。
通常是 API 网络问题，建议使用中转配置。
支持，包括 Apple Silicon。
通过本教程，你可以：
如果你在国内使用 Claude Code：
建议优先配置中转服务
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online