Linux

Claude Code 可以直接运行在 Linux 服务器上。你可以在服务器端安装 CLI，配置 AIOAGI API Key 和 Claude 模型，再通过本地 VS Code Remote SSH 连接服务器使用 Claude Code 辅助开发。

界面、模型名、端点和支持策略可能变化，请以控制台、开发者指南和 Anthropic 官方文档的最新说明为准。

参考原文

查看 Claude Code 配置与使用相关的原文说明。

准备条件

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，可以先完成控制台配置。

开发者指南

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

安装步骤

准备 Linux 用户环境

使用普通用户登录服务器。后续命令默认在该用户的 bash 终端中执行。

whoami
pwd

如果你使用的是 zsh，下文写入 ~/.bashrc 的配置可改写到 ~/.zshrc。

安装 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

安装 Git

在 Ubuntu 或 Debian 系统中，可使用：

sudo apt update
sudo apt install -y git

在 RHEL、CentOS、Rocky Linux 或 AlmaLinux 中，可使用：

sudo dnf install -y git

安装后验证：

git --version

安装 Claude Code

官方安装脚本适用于 Linux、macOS 和 WSL：

curl -fsSL https://claude.ai/install.sh | bash

如果你的团队已经统一使用 Node.js，也可以用 npm 安装 Claude Code CLI：

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

安装后执行下面两个命令确认安装结果：

claude --version
claude doctor

创建 AIOAGI API Key

写入 settings.json

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

安装界面示例

Linux 终端中验证 Node.js、Git 和 Claude Code 的示意图

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-your-aioagi-api-key",
    "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 或别名。模型名会随平台策略变化，请先在控制台或开发者指南中确认后再配置。

快速验证：使用 shell 环境变量

如果你只想在当前 SSH 会话中快速验证，可以临时导出环境变量：

export ANTHROPIC_BASE_URL="https://api.aiearth.dev/"
export ANTHROPIC_AUTH_TOKEN="sk-your-aioagi-api-key"
export ANTHROPIC_MODEL="claude-sonnet-4-6"
claude

如果要长期使用 bash，可以写入 ~/.bashrc：

cat <<'EOF' >> ~/.bashrc
export ANTHROPIC_BASE_URL="https://api.aiearth.dev/"
export ANTHROPIC_AUTH_TOKEN="sk-your-aioagi-api-key"
export ANTHROPIC_MODEL="claude-sonnet-4-6"
EOF
source ~/.bashrc

如果你使用 zsh，把上面的 ~/.bashrc 改成 ~/.zshrc。

服务器和 VS Code Remote SSH 场景优先使用 ~/.claude/settings.json。shell 环境变量适合临时测试、排障，或只想让某个终端会话使用独立配置的场景。

检查实际生效的配置

修改配置后，可以先检查命令路径和关键环境变量：

which claude
claude --version
env | grep '^ANTHROPIC_'

如果你主要依赖 settings.json，env | grep 不一定能看到这些变量。此时以 ~/.claude/settings.json 中的 env 配置为准。

启动和验证

进入你的代码项目后，执行：

claude

你可以先用下面这类简单提示词验证接入是否成功：

请先阅读当前仓库结构，再总结主要目录和入口文件。

如果 Claude Code 能正常读取仓库并返回结果，说明 CLI 安装、环境变量和 API Key 已基本可用。

集成到 VS Code SSH

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

安装 Remote SSH

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

配置 SSH 主机

在本机 ~/.ssh/config 中添加服务器配置。示例：

Host aioagi-linux
  HostName your-server-ip
  User your-linux-user
  IdentityFile ~/.ssh/id_rsa

连接服务器

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

安装 Claude Code 扩展

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

验证远程终端

打开 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-your-aioagi-api-key",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6"
  },
  "model": "sonnet[1m]"
}

保存后重新打开 VS Code Remote SSH 窗口，再在远程终端中执行 claude 验证。

不要把包含真实 API Key 的 settings.json、.bashrc 或截图提交到公开仓库。多人共用服务器时，建议每个 Linux 用户使用独立 API Key。

常见问题

执行 `claude` 提示命令不存在

先执行 which claude 和 echo $PATH，确认 Claude Code 安装目录已经加入 PATH。如果你使用 npm 安装，再执行 node --version、npm --version 和 npm prefix -g，确认 Node.js 与全局安装路径是否生效。

`npm install -g` 权限不足

不建议直接切换到 root 运行 Claude Code。优先使用官方安装脚本，或把 Node.js 安装到当前用户目录，再配置用户级 npm 全局目录并重新安装 @anthropic-ai/claude-code。

Claude Code 启动后认证失败或返回 403

检查 ~/.claude/settings.json 是否是合法 JSON，并确认 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL 和 model 是否填写正确。再检查 Token 组是否支持当前模型，并确认是否需要切换网络线路。你也可以继续参考常见问题中的 Claude Code 排障条目。

配置后仍未生效

如果配置后仍未生效，或仍返回 Anthropic 官方接口的认证、验证错误，请先重新打开本地终端、远程 shell 和 VS Code Remote SSH 窗口。再执行 claude 重新测试。如果仍不生效，请重启对应服务器或主机后再测试。问题仍存在时，可以通过微信或 QQ 联系平台管理员协助排查。

VS Code 扩展无法读取 API Key

先确认远程服务器当前用户存在 ~/.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，并定期到控制台核对模型可用性

常用客户端

Claude Code配置

Codex配置

参考原文

准备条件

Anthropic 安装文档

Anthropic Gateway 文档

AIOAGI API Key 指南

开发者指南

安装步骤

安装界面示例

Claude Code settings.json 配置

快速验证：使用 shell 环境变量

检查实际生效的配置

启动和验证

集成到 VS Code SSH

VS Code 远程配置

常见问题

使用建议

相关文档

参考原文

​准备条件

Anthropic 安装文档

Anthropic Gateway 文档

AIOAGI API Key 指南

开发者指南

​安装步骤

​安装界面示例

​Claude Code settings.json 配置

​快速验证：使用 shell 环境变量

​检查实际生效的配置

​启动和验证

​集成到 VS Code SSH

​VS Code 远程配置

​常见问题

​使用建议

​相关文档

准备条件

安装步骤

安装界面示例

Claude Code settings.json 配置

快速验证：使用 shell 环境变量

检查实际生效的配置

启动和验证

集成到 VS Code SSH

VS Code 远程配置

常见问题

使用建议

相关文档