网站首页 收藏本站
广告位联系

APP正在开发中...
返回顶部
您的位置： 主页 > Ai >

收藏
分享到

CentOS7上离线安装Claude Code的完整部署教程

Ai 来源：互联网 作者：佚名 发布时间：2026-08-11 23:20:04 人浏览
摘要

问题 虽然 Claude Code 官方声明支持 CentOS 7+，但系统CentOS 7.9存在一个关键的技术限制：系统核心库 glibc 版本为 2.17，而官方 Node.js 18+ 需要 glibc 2.27 或更高版本。如果直接安装官方 Node.js，会报错

问题

虽然 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

一、离线安装包内容

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

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

快速安装（推荐）

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

1

2

chmod +x install-offline-centos7.sh

./install-offline-centos7.sh

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

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

创建工作目录

1

2

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

cd ~/claude-offline-v2.1.89

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

1

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

下载 Claude Code 及其依赖

1

2

3

4

5

6

7

# 创建临时项目目录

mkdir temp-project

cd temp-project

# 初始化 package.json

npm init -y

# 安装指定版本的 Claude Code（使用淘宝镜像加速）

npm install @anthropic-ai/claude-code@2.1.89 --registry=https://registry.npmmirror.com

验证安装

1

2

3

# 确认文件存在

ls -la node_modules/@anthropic-ai/claude-code/

# 应该看到 cli.js 等文件

打包离线文件

1

2

3

4

5

6

7

8

# 回到工作目录

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 脚本一键完成安装：

1

2

3

4

cd ~

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

chmod +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. 配置本地模型连接（可选）

方式二：手动安装

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

解压安装包

1

2

cd ~

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

安装 Node.js

1

2

3

4

5

6

7

8

9

# 解压 Node.js

tar -xzvf node-v18.19.0-linux-x64-glibc-217.tar.gz

mkdir -p ~/local

mv node-v18.19.0-linux-x64-glibc-217 ~/local/nodejs

# 配置环境变量

echo 'export PATH="$HOME/local/nodejs/bin:$PATH"' >> ~/.bashrc

source ~/.bashrc

# 验证安装

node --version   # 应输出 v18.19.0

配置 npm 用户级目录

1

2

3

4

5

6

7

# 创建用户级 npm 全局目录

mkdir -p ~/.npm-global

# 配置 npm prefix

npm config set prefix ~/.npm-global

# 添加到 PATH

echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc

source ~/.bashrc

解压 Claude Code

1

2

3

4

5

6

7

8

9

10

11

# 清理可能存在的旧文件

rm -rf ~/.npm-global/node_modules/@anthropic-ai

# 创建临时目录解压

mkdir -p /tmp/claude-extract

cd /tmp/claude-extract

tar -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

验证文件存在

1

2

ls -la ~/.npm-global/node_modules/@anthropic-ai/claude-code/

# 应该看到 cli.js 文件

创建软链接

1

2

3

# 创建软链接（v2.1.89 入口文件为 cli.js）

ln -sf ~/.npm-global/node_modules/@anthropic-ai/claude-code/cli.js ~/.npm-global/bin/claude

chmod +x ~/.npm-global/bin/claude

验证安装

1

2

3

# 测试版本

claude --version

# 应输出 v2.1.89

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

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

1

2

3

4

5

6

7

8

9

10

11

12

13

mkdir -p ~/.claude

cat > ~/.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

配置项说明：

环境变量 说明 示例值
ANTHROPIC_BASE_URL 模型服务地址 http://localhost:8001
ANTHROPIC_AUTH_TOKEN API Token your-local-token
ANTHROPIC_MODEL 默认模型 claude-opus-4-7
ANTHROPIC_DEFAULT_OPUS_MODEL 默认 Opus 模型 opus
ANTHROPIC_DEFAULT_SONNET_MODEL 默认 Sonnet 模型 sonnet
ANTHROPIC_DEFAULT_HAIKU_MODEL 默认 Haiku 模型 haiku

提示: 使用自动化脚本安装时，安装过程会提示输入模型配置信息。
版权声明 : 本文内容来源于互联网或用户自行发布贡献，该文观点仅代表原作者本人。本站仅提供信息存储空间服务和不拥有所有权，不承担相关法律责任。如发现本站有涉嫌抄袭侵权， 违法违规的内容， 请发送邮件至2530232025#qq.cn(#换@)举报，一经查实，本站将立刻删除。

您可能感兴趣的文章 :

原文链接 :
相关文章
推荐阅读
最新更新
友情链接
  • 本站所有内容来源于互联网或用户自行发布，本站仅提供信息存储空间服务，不拥有版权，不承担法律责任。如有侵犯您的权益，请您联系站长处理！
  • Copyright © 2017-2022 F11.CN All Rights Reserved. F11站长开发者网 版权所有 | 苏ICP备2022031554号-1 | 51LA统计