CentOS7上离线安装Claude Code的完整部署方案

CentOS7上离线安装Claude Code的完整部署方案并不只看表面做法，关键还要理解相关条件、限制和后续影响。

背景

问题

虽然 Claude Code 官方声明支持 CentOS 7+，但系统 CentOS 7.9 存在一个关键的技术限制：系统核心库 glibc 版本为 2.17，而官方 Node.js 18+ 需要 glibc 2.27 或更高版本。如果直接安装官方 Node.js，会报错 GLIBC_2.27 not found。并且在公司服务器场景下无法联网，相关依赖需要离线安装。

解决思路

使用专门为旧版 glibc 编译的 Node.js 版本（由 unofficial-builds 提供）。如果服务器（CentOS 7）无法联网，则需要先离线下载兼容的NodeJS及Claude Code，整个安装分为两个阶段：

1. 在线准备阶段（在联网的linux上执行）：下载 Node.js 兼容版和 Claude Code 及其依赖，打包成离线安装包
2. 离线安装阶段（在 CentOS 7 上执行）：解压安装包，配置环境变量，安装 Node.js 和 Claude Code

一、离线安装包内容

最终生成的离线安装包包含：

1. centos7-claude-code-2.1.89-installer.tar.gz — Claude Code 2.1.89及依赖
2. install-offline-centos7.sh — 自动化安装脚本（推荐）

快速安装（推荐）

将centos7-claude-code-2.1.89-installer.tar.gz和install-offline-centos7.sh拷贝到服务器同级目录下，直接执行自动化安装：

chmod +x install-offline-centos7.sh./install-offline-centos7.sh

脚本会依次完成：解压安装包 → 安装 Node.js → 配置 npm → 安装 Claude Code → 创建软链接 → 验证安装 → 配置模型连接

二、准备工作（在联网的 Ubuntu/WSL 上执行）

创建工作目录

mkdir -p ~/claude-offline-v2.1.89cd ~/claude-offline-v2.1.89

下载 Node.js 兼容版（适用于 CentOS 7）

wget https://unofficial-builds.nodejs.org/download/release/v18.19.0/node-v18.19.0-linux-x64-glibc-217.tar.gz

下载 Claude Code 及其依赖

# 创建临时项目目录mkdir temp-projectcd temp-project# 初始化 package.jsonnpm init -y# 安装指定版本的 Claude Code（使用淘宝镜像加速）npm install @anthropic-ai/[email protected] --registry=https://registry.npmmirror.com

验证安装

# 确认文件存在ls -la node_modules/@anthropic-ai/claude-code/# 应该看到 cli.js 等文件

打包离线文件

# 回到工作目录cd ~/claude-offline-v2.1.89# 打包 Claude Code 依赖tar -czf claude-code-2.1.89-complete.tar.gz temp-project/# 打包最终安装包tar -czf centos7-claude-code-2.1.89-installer.tar.gz     node-v18.19.0-linux-x64-glibc-217.tar.gz     claude-code-2.1.89-complete.tar.gz

三、传输安装包

将 centos7-claude-code-2.1.89-installer.tar.gz 通过以下任一方式传输到 CentOS 服务器：

四、离线安装（在 CentOS 7 上执行）

方式一：自动化安装（推荐）

使用 install-offline-centos7.sh 脚本一键完成安装：

cd ~tar -xzvf centos7-claude-code-2.1.89-installer.tar.gzchmod +x install-offline-centos7.sh./install-offline-centos7.sh

脚本会自动完成以下步骤：

1. 检查安装包
2. 解压安装包
3. 安装 Node.js（适用于 CentOS 7 的 glibc 2.17 兼容版）
4. 配置 npm 用户级目录
5. 安装 Claude Code 到 npm 全局目录
6. 创建软链接
7. 验证安装
8. 配置本地模型连接（可选）

方式二：手动安装

如果不想使用脚本，可手动执行以下步骤：

解压安装包

cd ~tar -xzvf centos7-claude-code-2.1.89-installer.tar.gz

安装 Node.js

# 解压 Node.jstar -xzvf node-v18.19.0-linux-x64-glibc-217.tar.gzmkdir -p ~/localmv node-v18.19.0-linux-x64-glibc-217 ~/local/nodejs# 配置环境变量echo 'export PATH="$HOME/local/nodejs/bin:$PATH"' >> ~/.bashrcsource ~/.bashrc# 验证安装node --version   # 应输出 v18.19.0

配置 npm 用户级目录

# 创建用户级 npm 全局目录mkdir -p ~/.npm-global# 配置 npm prefixnpm config set prefix ~/.npm-global# 添加到 PATHecho 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrcsource ~/.bashrc

解压 Claude Code

# 清理可能存在的旧文件rm -rf ~/.npm-global/node_modules/@anthropic-ai# 创建临时目录解压mkdir -p /tmp/claude-extractcd /tmp/claude-extracttar -xzvf ~/claude-code-2.1.89-complete.tar.gz# 复制到 npm 全局目录cp -r temp-project/node_modules/@anthropic-ai ~/.npm-global/node_modules/# 清理临时目录cd ~rm -rf /tmp/claude-extract

验证文件存在

ls -la ~/.npm-global/node_modules/@anthropic-ai/claude-code/# 应该看到 cli.js 文件

创建软链接

# 创建软链接（v2.1.89 入口文件为 cli.js）ln -sf ~/.npm-global/node_modules/@anthropic-ai/claude-code/cli.js ~/.npm-global/bin/claudechmod +x ~/.npm-global/bin/claude

验证安装

# 测试版本claude --version# 应输出 v2.1.89

配置本地模型连接（可选）

如果使用本地模型服务，需要配置连接信息：

mkdir -p ~/.claudecat > ~/.claude/settings.json << EOF{  "env": {    "ANTHROPIC_BASE_URL": "http://localhost:8001",    "ANTHROPIC_AUTH_TOKEN": "your-local-token",    "ANTHROPIC_MODEL": "your-default-model",    "ANTHROPIC_DEFAULT_OPUS_MODEL": "opus",    "ANTHROPIC_DEFAULT_SONNET_MODEL": "sonnet",    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "haiku"  }}EOF

配置项说明：

提示: 使用自动化脚本安装时，安装过程会提示输入模型配置信息。