跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / BashNode.jsAI

Claude Code 安装教程:macOS / Linux / Windows 一键脚本

综述由AI生成Claude Code 是 Anthropic 官方推出的 CLI AI 编程助手工具。在 macOS、Linux 及 Windows 系统下的安装流程。首先需确保 Node.js 版本不低于 18,随后通过 Bash 或 PowerShell 脚本完成一键部署。针对国内用户可能遇到的网络超时或连接失败问题,文中提供了通用的解决方案思路。内容涵盖环境检查、脚本执行、常见问题解答及跨平台兼容性说明,旨在帮助用户快速搭建本地 AI 开发辅助环境。

Kubernet发布于 2026/3/15更新于 2026/5/2321 浏览

一、什么是 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

✅ 完整安装脚本(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=
    v=
     major=
    [[  =~ ^[0-9]+$ ]] && (( major >= REQUIRED_NODE_MAJOR ))
}
() {
      -v apt >/dev/null 2>&1 ||  -v apt-get >/dev/null 2>&1; 
        curl -fsSL https://deb.nodesource.com/setup_20.x | maybe_sudo bash -
          -v apt >/dev/null 2>&1; 
            maybe_sudo apt install -y nodejs
        
            maybe_sudo apt-get install -y nodejs
        
        
    
      -v dnf >/dev/null 2>&1; 
        curl -fsSL https://rpm.nodesource.com/setup_20.x | maybe_sudo bash -
        maybe_sudo dnf install -y nodejs
        
    
      -v yum >/dev/null 2>&1; 
        curl -fsSL https://rpm.nodesource.com/setup_20.x | maybe_sudo bash -
        maybe_sudo yum install -y nodejs
        
    
      -v pacman >/dev/null 2>&1; 
        maybe_sudo pacman -Sy --needed --noconfirm nodejs npm
        
    
      -v brew >/dev/null 2>&1; 
        brew update
        brew install node@20
        brew  --overwrite --force node@20
        
    
     
     1
}
 ! node_ok; 
    install_node

npm install -g @anthropic-ai/claude-code || {
    prefix=
     -p 
    npm config  prefix 
    npm install -g @anthropic-ai/claude-code
     PATH=
}
 
 
"$(node --version 2>/dev/null || true)"
"${v#v}"
local
"${v%%.*}"
"$major"
install_node
if
command
command
then
if
command
then
else
fi
return
fi
if
command
then
return
fi
if
command
then
return
fi
if
command
then
return
fi
if
command
then
link
return
fi
echo
"请先手动安装 Node.js >= 18"
exit
if
then
fi
"${HOME:-$PWD}/.npm-global"
mkdir
"$prefix"
set
"$prefix"
export
"$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 稳定运行,建议使用国内中转配置。

支持:

  • 稳定访问
  • 低延迟
  • 简单配置
  • 无需复杂代理

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

七、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:

建议优先配置中转服务

目录

  1. 一、什么是 Claude Code?
  2. 二、Claude Code 安装前的环境要求
  3. 三、macOS / Linux 一键安装 Claude Code 脚本
  4. ✅ 完整安装脚本(Node >=18 版本)
  5. 四、Windows PowerShell 安装 Claude Code
  6. PowerShell 安装脚本
  7. 五、国内使用 Claude Code 的常见问题
  8. 六、国内稳定使用方案
  9. 七、Claude Code 常见 FAQ
  10. 1️⃣ 必须 Node 18 吗?
  11. 2️⃣ Windows 可以用吗?
  12. 3️⃣ 为什么安装成功却无法调用?
  13. 4️⃣ 是否支持 macOS?
  14. 八、总结
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • SBUS 协议详解:从原理到 STM32 实战
  • 基于 MCP Server - Figma AI Bridge 实现 Figma 设计稿前端代码自动化
  • 基于 DeepSeek 与 Cursor 构建智能代码审查工具实战
  • 本地 LLM 模型与 Ollama、Python 集成实战
  • Java 位运算算法题目练习
  • VSCode 搭建 Java 开发环境指南
  • 基于 AI 算法的全网比价系统设计与实现
  • Arduino BLDC 基于 6.5 寸轮毂电机的智能动态跟随机器人底盘
  • LeetCode 92 区间反转:递归与哨兵节点实战解析
  • Web-Check 结合 cpolar 实现异地远程访问与漏洞检测
  • 小智 ESP32 开源 AI 语音交互系统构建指南
  • Python __init__.py 文件详解
  • Spring AI 接入 Agent Skill 实战指南
  • 零经验面试 B 端产品经理:从被拒到拿到 Offer 的实战复盘
  • 2026 年前端技术演进趋势与核心面试题解析
  • C++ 标准库容器适配器:stack、queue 与 priority_queue
  • VS Code 配置 C/C++ 编程运行环境
  • Stable Diffusion UnCLIP 2.1 图像变体生成实战指南
  • Orbbec SDK Python 深度摄像头开发指南
  • Diffusion Transformer(DiT):将 U-Net 换成 ViT,应用于视频生成与机器人动作预测

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online