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

Linux 下安装 Claude Code 的常见问题与解决方案

在 Linux 环境下安装 Claude Code 时,常遇到 Node.js 版本过低及 npm 全局目录权限不足的问题。通过安装 nvm 管理 Node 版本并配置 npm 全局路径至用户目录,可解决兼容性与权限报错,顺利完成工具部署。

极客零度发布于 2026/3/16更新于 2026/10/24104 浏览
Linux 下安装 Claude Code 的常见问题与解决方案

前言

在 Linux 环境下准备安装使用 Claude,配置步骤类似于 Windows。首先需要安装 Node.js 和 npm,然后执行 Claude 的安装。

使用 sudo apt-get install nodejs npm 安装依赖。

然后安装 Claude:

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

结果并不太顺利,报错如下:

在这里插入图片描述

问题原因

以上报错主要有两个:Node.js 版本过低和目录权限不足。

  • Node.js 版本过低:当前版本为 10.19.0,但 Claude Code 要求 Node.js >= 18.0.0。
  • 系统目录权限不足:默认安装路径 /usr/local/lib 需要 sudo 权限才能写入。

解决方案

步骤 1:安装 Node Version Manager (nvm)

nvm 是一个工具,可以让你在同一台机器上轻松安装、切换和管理多个 Node.js 版本。这是解决版本冲突的最佳方案。

通过以下命令安装 nvm:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

安装完成后,重新启动终端或执行 source ~/.bashrc(如果是 zsh 则执行 source ~/.zshrc)来加载 nvm。

步骤 2:使用 nvm 安装新版 Node.js

安装一个满足 Claude Code 要求的 Node.js 长期支持(LTS)版本,例如 v18 或 v20。

nvm install 18
nvm use 18
nvm alias default 18

安装完成后,请验证版本是否正确:

node -v
npm -v
步骤 3:配置 npm 全局安装路径

为了避免权限错误,最好的方法是将 npm 的全局包安装路径设置到当前用户拥有写权限的目录下,而不是系统级的 /usr/local/lib。

创建一个新的全局安装目录:

mkdir ~/.npm-global

配置 npm 使用此新路径:

npm config set prefix '~/.npm-global'

将新路径添加到系统的 PATH 环境变量中,这样终端才能找到全局安装的命令。 编辑你的 shell 配置文件(如 ~/.bashrc 或 ~/.zshrc),在文件末尾添加一行:

export PATH=~/.npm-global/bin:$PATH

让配置立即生效:

source ~/.bashrc
步骤 4:重新安装 Claude Code

现在环境已经配置正确,可以重新安装 Claude Code 了:

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

这次安装应该能够顺利完成了。

步骤 5:验证安装

安装成功后,可以通过以下命令检查 claude 命令是否可用:

claude --help

如果显示了帮助信息,说明安装成功!

重要提醒

关于 nvm:如果你关闭终端后重新打开,发现 node 命令找不到,请记得运行 nvm use 18 来切换到你安装的版本。执行过 nvm alias default 18 后则无需此操作。

上述配置完成后,今后使用 npm install -g 安装任何全局包都不会再遇到 EACCES 权限错误了。

目录

  1. 前言
  2. 问题原因
  3. 解决方案
  4. 步骤 1:安装 Node Version Manager (nvm)
  5. 步骤 2:使用 nvm 安装新版 Node.js
  6. 步骤 3:配置 npm 全局安装路径
  7. 步骤 4:重新安装 Claude Code
  8. 步骤 5:验证安装
  9. 重要提醒

更多推荐文章

查看全部
  • 树莓派 4B 连接大疆 M300 无人机开发指南
  • Spring AI Alibaba 快速入门指南
  • ReAct 与 Plan-and-Execute:AI Agent 推理架构对比与选择
  • SheetJS:全场景适用的 JavaScript 电子表格处理工具
  • Python 环境安装与配置 Gurobi 求解器指南
  • 并查集数据结构详解与实战应用
  • 大语言模型原理必读的 10 篇核心论文
  • Linux 基本操作与 Java 项目部署指南
  • 基于 LangGraph 实现模块化 Skills 型 AI Agent
  • OpenClaw iOS/Android 端部署教程:语音唤醒与随身 AI 助手
  • OpenAI Whisper 语音转文本入门与实战
  • Axure 制作 AI 自动对话机器人原型教程
  • Ubuntu 24.04 下使用 Docker Compose 本地部署 Whisper 语音识别
  • 基于 FPGA 的千兆以太网源代码实现与设计实战
  • 基于 FPGA 的多层感知机设计与逻辑门实现指南
  • 选择排序算法原理与实现
  • 位运算实战:两整数之和与只出现一次的数字
  • Python PyQt6 实战:从零构建简易记事本
  • 基于Vivado的RISC-V五级流水线CPU FPGA实现详解
  • Neo4j 知识图谱颜色定制方法与最佳实践

相关免费在线工具

  • 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