L1D-Linux系统Node.js部署Claude Code完全指南 🚀

本文档将介绍如何使用 Node.js 在 Linux 系统中安装和部署 Claude Code！我们会一步步完成整个安装过程，从环境准备到内网部署，让你轻松上手！💪

1. 前提经验 ⚠️

在实际部署过程中，我遇到了一个关键问题：GLIBC 版本过低导致 Claude Code 安装失败。这个问题让我折腾了好久，所以先跟大家分享一下我的踩坑经验！😅

1.1 GLIBC版本兼容性问题 🔧

GLIBC（GNU C Library，GNU C库）是 Linux 系统的核心组件，很多程序都依赖它。当 GLIBC 版本过低时，新版本的 Node.js 就无法正常运行，这就像你想在旧手机上安装最新版APP一样，系统不支持！📱

错误日志示例：

bash 复制代码

Now using node v18.20.8
[root@localhost local]# node -V
'GLIBC 2.27' not found (required by node)
node: /lib64/libm.so.6: version 'GLIBC 2.25' not found (required by node)
node: /lib64/libc.so.6: version 'GLIBC_2.28' not found (required by node)
node: /lib64/libstdc++.so.6: version 'CxxABI_1.3.9' not found (required by node)
node: 'GLIBCXX 3.4.20' not found (required by node)
node: /lib64/libstdc++.so.6: version 'GLIBCXX_3.4.21' not found (required by node)

安装失败日志：

bash 复制代码

[root@localhost local]# npm install -g @anthropic-ai/claude-code
npm WARN config global --global, --local are deprecated. Use --location=global instead
npm WARN EBADENGINE Unsupported engine {
  package: '@anthropic-ai/claude-code@2.1.81',
  required: { node: '>=18.0.0' },
  current: { node: 'v17.9.1', npm: '8.11.0' }
}

核心问题分析： Linux 系统的 GLIBC 版本不能太低，否则只能安装最高支持 Node.js 17 的版本。但是 Claude Code 最低要求 Node.js 版本为 18，所以 GLIBC 版本过低会导致 Claude Code 安装失败，因为连 Node.js 18 都无法成功安装。这就像你想玩最新的3A游戏，但显卡太老带不动一样！🎮

2. 基础部署步骤 📦

接下来我们开始正式部署 Claude Code，我会一步步带大家完成整个过程！💪

2.1 第一步：安装NVM 🛠️

NVM（Node Version Manager，Node版本管理器）是一个超级好用的工具，可以让我们在同一台电脑上安装和切换不同版本的 Node.js！就像给手机装了应用商店，想装哪个版本就装哪个版本！📱

bash 复制代码

# 下载并安装NVM脚本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash

# 加载NVM到当前shell环境
\. "$HOME/.nvm/nvm.sh"

# 安装Node.js 17版本（这个版本对GLIBC要求较低）
nvm install 17

# 查看Node.js版本，确认安装成功
node -v

# 查看npm版本，确认包管理器也安装成功
npm -v

2.2 第二步：安装Claude Code 📥

现在我们有了 Node.js 环境，就可以安装 Claude Code 了！这个步骤就像在手机上安装APP一样简单！📲

bash 复制代码

# 全局安装Claude Code（-g表示全局安装，可以在任何地方使用）
npm install -g @anthropic-ai/claude-code

2.3 第三步：验证安装 ✅

安装完成后，我们需要验证一下是否安装成功！就像安装APP后打开看看能不能正常运行一样！✅

bash 复制代码

# 查看Claude Code版本，确认安装成功
claude --version

2.4 第四步：启动Claude Code 🚀

一切准备就绪，现在我们可以启动 Claude Code 开始使用了！🎉

bash 复制代码

# 启动Claude Code交互界面
claude

3. 内网部署经验 🔒

在实际工作中，我发现很多企业环境需要在内网使用 Claude Code，不能直接连接外网API，这样可以保护数据安全！🔒

3.1 版本锁定方案 🎯

因为我的 Claude 是内网使用，不能使用外网 API，怕泄露数据。因为 Claude 大于版本 20 不能指定本地模型，而且通过配置文件也不能指定，所以使用以下命令来启动 Claude。这个方案就像给软件装了个"锁"，防止它自动更新到不兼容的版本！🔐

bash 复制代码

# 卸载当前版本的Claude Code
npm uninstall -g @anthropic-ai/claude-code

# 安装v2.0.0版本并锁定版本（--save-exact确保精确安装指定版本）
npm install -g @anthropic-ai/claude-code@2.0.0 --save-exact

# 禁用npm自动更新提示（update-notifier false关闭更新通知）
npm config set update-notifier false

# 禁用npm资金提示（fund false关闭赞助提示）
npm config set fund false

# 锁定npm包版本（save-exact true确保所有包都精确安装指定版本）
npm config set save-exact true

# 启动配置（环境变量方式）
# Claude Code使用--model命令行参数指定模型，而不是CLAUDE_MODEL环境变量
# ANTHROPIC_API_KEY：你的API密钥
# ANTHROPIC_BASE_URL：内网API服务器地址
# claude --model deepseek-r1：指定使用deepseek-r1模型

ANTHROPIC_API_KEY="你的api_key" ANTHROPIC_BASE_URL="http://10.0.3.69:3000" claude --model deepseek-r1

通过以上配置，我们就可以在内网环境中安全地使用 Claude Code 了！🎉

最后更新时间：2026-03-25