Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.aioagi.tech/llms.txt

Use this file to discover all available pages before exploring further.

Claude Code 可以直接运行在 Linux 服务器上。你可以在服务器端安装 CLI，配置 AIOAGI API Key 和 Claude 模型，再通过本地 VS Code Remote SSH 连接服务器使用 Claude Code 辅助开发。
界面、模型名、端点和支持策略可能变化，请以控制台、开发者指南和 Anthropic 官方文档的最新说明为准。

​
准备条件

  • Linux 服务器或云主机
  • 一个普通 Linux 用户账号，不建议使用 root 用户安装和运行 Claude Code
  • Node.js 18+ 或当前 LTS 版本
  • Git
  • 可用的 AIOAGI API Key
  • 本地 VS Code，并安装 Remote SSH 相关能力
  • 一个服务器端代码项目，用于验证 Claude Code 是否可正常工作

Anthropic 安装文档

查看 Claude Code 的系统要求、安装命令和验证方式。

Anthropic Gateway 文档

查看 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 和模型环境变量的配置方式。

AIOAGI API Key 指南

如果你还没有创建 API Key，可以先完成控制台配置。

开发者指南

核对当前端点、模型和接口说明。

​
安装步骤

1

准备 Linux 用户环境

使用普通用户登录服务器。后续命令默认在该用户的 bash 终端中执行。
whoami
pwd
如果你使用的是 zsh，下文写入 ~/.bashrc 的配置可改写到 ~/.zshrc。
2

安装 Node.js

你可以使用系统包管理器安装 Node.js，也可以使用 Node.js 官网下载的 Linux tar.xz 压缩包安装到用户目录。如果使用压缩包方式，可先把下载好的文件上传到服务器用户目录，然后执行：
cd ~
mkdir -p ~/local/node
tar -xJf ~/node-v*-linux-*.tar.xz -C ~/local/node --strip-components=1
echo 'export PATH="$HOME/local/node/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
验证安装结果：
node --version
npm --version
3

安装 Git

在 Ubuntu 或 Debian 系统中，可使用：
sudo apt update
sudo apt install -y git
在 RHEL、CentOS、Rocky Linux 或 AlmaLinux 中，可使用：
sudo dnf install -y git
安装后验证：
git --version
4

安装 Claude Code

使用 npm 安装 Claude Code CLI：
npm install -g @anthropic-ai/claude-code
安装后执行下面两个命令确认安装结果：
claude --version
claude doctor
5

创建 AIOAGI API Key

登录 AIOAGI 控制台，在 令牌管理 中创建可用于 Claude 模型的 API Key。确认令牌分组和额度设置满足当前模型调用需求。
6

写入 settings.json

把 AIOAGI 接入参数写入当前 Linux 用户的 ~/.claude/settings.json。该配置会应用到当前用户的所有 Claude Code 会话。

​
安装界面示例

Node.js 下载页面示例
Linux 终端中验证 Node.js、Git 和 Claude Code 的示意图
AIOAGI 控制台令牌管理界面示例

​
Claude Code settings.json 配置

Claude Code 可以从 settings.json 读取环境变量和默认模型。Linux 服务器建议使用当前用户的 ~/.claude/settings.json，避免把 API Key 写入项目仓库。 
mkdir -p ~/.claude
vim ~/.claude/settings.json
写入下面的内容，并把 ANTHROPIC_AUTH_TOKEN 改成你的 AIOAGI API Key： 
{
  "env": {
    "API_TIMEOUT_MS": "3000000",
    "ANTHROPIC_BASE_URL": "https://api.aiearth.dev/",
    "ANTHROPIC_AUTH_TOKEN": "sk-",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6"
  },
  "model": "sonnet[1m]"
}
保存后重新打开终端，或重新连接 VS Code Remote SSH 窗口，再执行 claude 验证。 如果你的网络更适合 CDN 加速线路，也可以把 ANTHROPIC_BASE_URL 改成 https://api.aiearth.vip/。端点、模型名和支持策略可能变化，请以控制台和开发者指南显示的信息为准。 如需只让某个项目使用独立配置，可在项目目录写入 .claude/settings.local.json。不要把包含真实 API Key 的 .claude/settings.json、.claude/settings.local.json 或截图提交到公开仓库。
ANTHROPIC_MODEL 和 model 应填写控制台当前可用的 Claude 系列模型 ID 或别名。模型名会随平台策略变化，请先在控制台或开发者指南中确认后再配置。

​
启动和验证

进入你的代码项目后，执行： 
claude
你可以先用下面这类简单提示词验证接入是否成功： 
请先阅读当前仓库结构，再总结主要目录和入口文件。
如果 Claude Code 能正常读取仓库并返回结果，说明 CLI 安装、环境变量和 API Key 已基本可用。

​
集成到 VS Code SSH

本地 VS Code 可以通过 Remote SSH 连接 Linux 服务器，并在远程环境中使用 Claude Code。
1

安装 Remote SSH

在本地 VS Code 中点击 Extensions，搜索并安装 Remote - SSH。
2

配置 SSH 主机

在本机 ~/.ssh/config 中添加服务器配置。示例：
Host aioagi-linux
  HostName your-server-ip
  User your-linux-user
  IdentityFile ~/.ssh/id_rsa
3

连接服务器

在 VS Code 中执行 Remote-SSH: Connect to Host，选择刚刚配置的主机，并打开服务器上的项目目录。
4

安装 Claude Code 扩展

连接到远程服务器后，在远程扩展环境中搜索 Claude Code，安装 Claude Code 官方扩展。
5

验证远程终端

打开 VS Code 远程终端，执行 node --version、npm --version、git --version 和 claude --version，确认命令读取的是服务器端环境。
VS Code Remote SSH 连接 Linux 服务器并使用 Claude Code 的示意图

​
VS Code 远程配置

有些 VS Code Remote SSH 会话不会完整加载交互式 shell 的 ~/.bashrc。优先把 AIOAGI 接入参数写入服务器当前用户的 ~/.claude/settings.json，这样 CLI 和远程扩展可以读取同一份配置。 
mkdir -p ~/.claude
vim ~/.claude/settings.json
配置内容如下： 
{
  "env": {
    "API_TIMEOUT_MS": "3000000",
    "ANTHROPIC_BASE_URL": "https://api.aiearth.dev/",
    "ANTHROPIC_AUTH_TOKEN": "sk-",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6"
  },
  "model": "sonnet[1m]"
}
保存后重新打开 VS Code Remote SSH 窗口，再在远程终端中执行 claude 验证。
不要把包含真实 API Key 的 settings.json、.bashrc 或截图提交到公开仓库。多人共用服务器时，建议每个 Linux 用户使用独立 API Key。

​
常见问题

先执行 node --version 和 npm --version，确认 Node.js 已加入 PATH。如果你使用用户目录安装 Node.js，请检查 ~/.bashrc 中是否包含 export PATH="$HOME/local/node/bin:$PATH"，并重新执行 source ~/.bashrc。
不建议直接切换到 root 运行 Claude Code。优先把 Node.js 安装到当前用户目录，或配置用户级 npm 全局目录，再重新安装 @anthropic-ai/claude-code。
检查 ~/.claude/settings.json 是否是合法 JSON，并确认 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL 和 model 是否填写正确。再检查 Token 组是否支持当前模型，并确认是否需要切换网络线路。你也可以继续参考 常见问题 中的 Claude Code 排障条目。
先确认远程服务器当前用户存在 ~/.claude/settings.json，并检查文件中的 API Key 和模型配置。修改后重新加载 VS Code Remote SSH 窗口。
先到控制台确认当前 API Key 可访问的 Claude 模型列表，再核对模型 ID 是否完全一致。如果平台近期调整了模型别名或支持策略，请以控制台和开发者指南最新信息为准。

​
使用建议

  • 为服务器端 Claude Code 单独创建 API Key，便于统计用量和控制额度
  • 先用小额度 Token 组完成安装和连通性测试，再切换到正式额度
  • 多人共用服务器时，建议按 Linux 用户隔离 API Key 和 ~/.claude 配置
  • 使用 VS Code Remote SSH 时，确认扩展安装在远程服务器环境，而不是只安装在本地
  • 长期使用时，建议固定 Node.js 安装方式和模型 ID，并定期到控制台核对模型可用性

​
相关文档