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

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

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

Kubernet发布于 2026/3/15更新于 2026/9/1073 浏览

一、什么是 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. 八、总结

更多推荐文章

查看全部
  • STM32 单片机智能家居语音控制系统
  • OpenClaw 本地 AI 智能体:从架构解析到实战部署
  • LLM 提示工程技巧总结:减少幻觉与提升一致性方法
  • 使用 OpenClaw 与 Chrome 插件自动化生成 AI 每日简报
  • Python 环境搭建指南:从下载到运行 Hello World
  • 计算机专业毕业生就业前景与岗位方向深度分析
  • 微信网页版访问受限?试试 wechat-need-web 插件方案
  • 前缀和算法实战:连续数组与矩阵区域和
  • LLaMA 3.1 模型部署与 Streamlit 聊天机器人实战
  • Web 开发中五种核心加密算法实战与原理
  • 使用 TRAE CN 与 MasterGo MCP 实现设计稿转前端代码
  • 使用 Kimi 快速撰写产品用户故事及提示词指南
  • To B 产品经理如何转型 AI 产品经理:路径与价值分析
  • 深入理解 C++ 异常机制
  • Linux 网络编程基础:UDP Socket 核心接口详解
  • 基于树莓派的智能家居系统 AI 辅助开发与部署实践
  • DIY Layout Creator:开源跨平台电路设计工具详解
  • Python 核心知识点汇总:从入门到精通的完整指南
  • 基于 OpenClaw 与飞书搭建多 Agent AI 助理团队
  • Vue 组件开发中的枚举值验证:从 Type 属性错误说起

相关免费在线工具

  • 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