欢迎使用 ModelSet 原版代理服务！本指南适配 Linux 系统，手把手完成 Claude Code 安装、环境配置、多模型切换操作。ModelSet 订阅可通用 Claude Code、Codex、Cursor 等多款官方工具客户端。

前置要求

开始操作前，请确保环境满足以下条件：

  • 支持系统：Ubuntu、Debian、CentOS、Fedora、Arch Linux 等主流 Linux 发行版
  • 运行环境：Node.js 18 及以上版本
  • 授权凭证：已获取有效的 ModelSet API 密钥

步骤 1：安装 Node.js 环境

Claude Code 依赖 Node.js 运行，提供三种安装方式，优先推荐官方仓库安装。

方式一：官方仓库安装（推荐）

Ubuntu / Debian：

bash 
# 添加 NodeSource LTS 仓库
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -

# 安装 Node.js
sudo apt-get install -y nodejs

CentOS / RHEL / Fedora：

bash 
# 添加 NodeSource LTS 仓库
curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -

# 安装 Node.js
sudo dnf install -y nodejs

方式二：系统包管理器安装

版本非最新，可满足基础使用：

bash 
# Ubuntu / Debian
sudo apt update
sudo apt install nodejs npm

# CentOS / RHEL / Fedora
sudo dnf install nodejs npm

# Arch Linux
sudo pacman -S nodejs npm

方式三：离线安装

bash 
# 1. 先建目录
mkdir -p /opt/node18
cd /opt/node18

# 2. 国内镜像直下（替换成你要的版本）
wget https://r.cnpmjs.org/-/binary/node-unofficial-builds/v18.20.8/node-v18.20.8-linux-x64-glibc-217.tar.xz

# 3. 解压
tar -xJf node-v18.20.8-linux-x64-glibc-217.tar.xz --strip-components=1

# 4. 配环境变量
export PATH=/opt/node18/bin:$PATH
echo 'export PATH=/opt/node18/bin:$PATH' >> /root/.bashrc
source /root/.bashrc

# 验证
node --version   # 应输出 v18.20.8
npm --version    # 应输出 10.x.x

# 换国内 npm 镜像（加速）
npm config set registry https://registry.npmmirror.com
npm config get registry  # 确认是淘宝镜像

验证安装

终端执行以下命令，正常输出版本号即代表安装成功：

bash 
node --version
npm --version

注意事项：部分发行版需额外安装编译依赖 build-essential；遇到权限报错，可搭配 sudo 执行命令；保证当前用户对 npm 全局目录拥有写入权限。

步骤 2：安装 Claude Code 客户端

bash 
# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 权限不足时提权安装
sudo npm install -g @anthropic-ai/claude-code

验证安装：

bash 
claude --version

正常回显版本号，说明客户端安装完成。若提示 claude: 未找到命令，请重载 Shell 配置或重启终端；部分系统需手动将 npm 全局 bin 目录加入环境变量。

步骤 3：获取 ModelSet API 密钥

登录 ModelSet 控制台，进入「API 密钥」页面，创建专属有效密钥，用于后续环境变量配置。添加完令牌后会得到一串 sk- 开头的密钥，点击复制：

在 ModelSet 控制台创建 API 密钥 复制生成的 sk- 开头密钥

添加 key 时请选择对应的分组，不要选择 default，否则生成的 key 没法用，建议选择 cc-max 分组。

步骤 4：配置代理环境变量

需配置两组环境变量，实现 Claude Code 对接 ModelSet 代理，分为临时生效和永久生效两种方案。

方式一：临时设置（仅当前终端会话有效）

bash 
export ANTHROPIC_BASE_URL="https://ai.modelset.top/"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

请将 你的API密钥 替换为上一步获取的真实密钥。

方式二：永久设置（推荐，全局生效）

根据当前使用的 Shell 选择对应配置：

Bash（Linux 默认 Shell）：

bash 
# 写入环境变量
echo 'export ANTHROPIC_BASE_URL="https://ai.modelset.top/"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bashrc

# 重载配置生效
source ~/.bashrc

Zsh：

bash 
echo 'export ANTHROPIC_BASE_URL="https://ai.modelset.top/"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc

source ~/.zshrc

Fish：

fish 
echo 'set -x ANTHROPIC_BASE_URL "https://ai.modelset.top/"' >> ~/.config/fish/config.fish
echo 'set -x ANTHROPIC_AUTH_TOKEN "你的API密钥"' >> ~/.config/fish/config.fish

source ~/.config/fish/config.fish

校验环境变量

bash 
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

正常输出示例：https://ai.modelset.top/ + cr_xxxxxxxxxxxxxxxxxx。❗ 若输出为空，代表配置失败，请检查配置文件或重新执行配置。

步骤 5：启动 Claude Code

bash 
# 全局直接启动
claude

# 或进入项目目录后启动
cd /path/to/your/project
claude

Claude 原生模型使用 💡

Claude Code 默认调用原生 Claude 模型，ModelSet 已适配全量新版模型，可手动切换：

bash 
/model 模型ID

可用模型列表

模型名称特点适用场景
claude-opus-4-8最新旗舰模型极限推理、超复杂任务首选
claude-opus-4-7最新旗舰模型极限推理、超复杂任务首选
claude-opus-4-6高阶推理模型高强度逻辑、复杂工程任务
claude-sonnet-4-6性能 & 速度均衡（默认推荐）绝大多数开发场景，日常主力
claude-sonnet-4-5-20250929稳定版 Sonnet长上下文代码、稳定型开发
claude-opus-4-5-20251101经典 Opus 版本高性能推理任务
claude-haiku-4-5-20251001轻量极速模型简单查询、快速响应任务

Linux 常见问题排查

1. 安装提示权限错误

方案一：临时提权安装

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

方案二：根治权限（修改 npm 全局目录）

bash 
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

2. 系统缺少依赖库

bash 
# Ubuntu / Debian
sudo apt install build-essential

# CentOS / RHEL
sudo dnf groupinstall "Development Tools"

# Arch Linux
sudo pacman -S base-devel

3. 环境变量不生效

  1. 确认修改的配置文件与当前 Shell 匹配（.bashrc / .zshrc / config.fish）
  2. 执行 source 对应配置文件 或重启终端
  3. 再次执行 echo $ANTHROPIC_BASE_URL 校验

4. 提示 claude: 未找到命令

npm 全局路径未加入系统 PATH，执行以下命令修复：

bash 
# 查看 npm 全局路径
npm config get prefix

# 写入环境变量
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

5. CentOS/RHEL SELinux 权限拦截

建议优先配置 SELinux 策略，关闭仅作临时调试使用。

临时关闭（重启失效）：

bash 
sudo setenforce 0

永久关闭（谨慎操作）：

bash 
sudo vi /etc/selinux/config

将 SELINUX=enforcing 修改为 SELINUX=permissive，保存后重启系统。

技术支持

安装配置过程中遇到任何问题，可扫码添加官方客服微信，获取一对一技术支持。

官方客服微信二维码

🎉 配置完成！至此你已成功部署 Claude Code，可自由切换各大 AI 模型，享受高效 AI 编程辅助体验。

Claude Code Linux 安装配置

免费获取 API Key

创建密钥时记得选择 cc-max 分组

前往控制台