在Linux上使用Claude Code 并使用本地VS Code SSH远程访问的完整指南

想在Linux系统用Claude Code提升编程效率，却卡在系统适配门槛？想让 AI 助手深度融入 VS Code 开发流程，却不懂插件配置技巧？这篇"保姆级指南"专为你打造，从Claude Code的Linux 环境搭建到通过本地VS Code SSH远程访问服务器端Claude Code的无缝集成，每一步都配清晰操作说明，新手也能轻松上手。

本文有两个部分(干货满满！)：

Linux安装Claude Code

使用本机VS Code SSH远程访问服务器端Claude Code帮助AI编程

一、Linux安装Claude Code

1、安装必要工具

1.1 Linux端安装Node.js和Git

Node.js提供运行环境，支持 Claude Code 的 JavaScript 代码执行；Git 用于获取其代码仓库或管理版本依赖。所以这些工具是运行 Claude Code 的必要条件。需要注意的是，所有安装使用Linux的bash终端在某个人用户下进行，不要使用root用户安装。

1.1.0 安装Node.js---更新

下面1.1.1安装Node.js的方法比较旧，容易出错，建议采用本节的 1.1.0安装Node.js---更新的方法

在终端里直接复制整段执行即可。你现在是 root 用户，所以会安装到：

复制代码

/root/.nvm

先执行：

复制代码

conda deactivate

如果执行后 (base) 消失，就继续。然后一次性复制下面整段：

复制代码

export NVM_DIR="$HOME/.nvm"

if [ ! -s "$NVM_DIR/nvm.sh" ]; then
  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
fi

source "$NVM_DIR/nvm.sh"

接着确认 nvm 是否加载成功：

复制代码

nvm --version

如果显示类似：

复制代码

0.40.3

说明成功。

然后安装 Node.js 24：

复制代码

nvm install 24
nvm use 24
nvm alias default 24

检查版本：

复制代码

node --version
npm --version
which node

正常情况下应看到类似：

复制代码

v24.x.x
/root/.nvm/versions/node/v24.x.x/bin/node

之后重新安装 Claude Code：

复制代码

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

检查：

复制代码

claude --version

完整操作顺序如下：

复制代码

conda deactivate

export NVM_DIR="$HOME/.nvm"

if [ ! -s "$NVM_DIR/nvm.sh" ]; then
  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
fi

source "$NVM_DIR/nvm.sh"

nvm --version
nvm install 24
nvm use 24
nvm alias default 24

node --version
npm --version

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

claude --version

如果运行 curl 时提示：

复制代码

curl: command not found

可以改用：

复制代码

wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

以后重新登录服务器，如果出现 nvm: command not found，执行：

复制代码

export NVM_DIR="$HOME/.nvm"
source "$NVM_DIR/nvm.sh"

--------------------------------备注：如果之前安装的Node.js 22，想安装并使用Node.js 24在这个环境下安装claude code--------------------------------
你之前安装的 Node.js 22 不会被覆盖，两者会同时保留。需要切换时：

复制代码

nvm use 22
nvm use 24

查看已安装版本：

复制代码

nvm ls

确认 Claude Code 在 Node 24 环境下重新安装：

复制代码

nvm use 24
npm install -g @anthropic-ai/claude-code
claude --version

注意：nvm 的全局 npm 包通常按 Node 版本分别保存。你在 Node 22 下安装的全局包，切换到 Node 24 后可能需要重新安装。

1.1.1 安装Node.js

1.访问Node.js官网下载安装LTS版本的Node.js

(https://nodejs.org/zh-cn/download)

2.使用xftp或其他工具将下载好的解压包上传至Linux服务器中的用户文件夹~下。然后在用户文件夹下创建node项目文件夹，使用终端执行：

复制代码

cd /root
cd ~
mkdir -p ~/node

3.将你下载的tar.xz文件解压并移动到上一步创建的文件夹中,并使用终端配置环境变量(注意：vim进入文件后，按i打开编辑模式，键盘上下左右调整光标，编辑完成后按esc，输入:wq保存退出即可)：

复制代码

tar -xJf ~/你的node.tar.xz -C ~/node --strip-components=1


vim ~/.bashrc

在文件中末尾添加：

复制代码

export PATH="$HOME/local/node/bin:$PATH"

添加完成后在终端生效该配置文件：

复制代码

source ~/.bashrc

4.安装完成后，终端运行下列命令验证安装：

复制代码

node --version

npm --version

如果显示版本号，则安装成功。

1.1.2 安装Git

访问Git官网下载安装Git(https://git-scm.com/downloads/linux)

复制代码

Debian/Ubuntu
For the latest stable version for your release of Debian/Ubuntu

# apt-get install git   (-----执行这一个命令即可-----)
For Ubuntu, this PPA provides the latest stable upstream Git version

# add-apt-repository ppa:git-core/ppa
# apt update; apt install git

2.安装完成后，再次在终端输入下列命令验证安装：

复制代码

git --version

如果显示版本号，则安装成功

1.2 Linux端安装Claude Code

1.安装官方版本

打开bash终端输入:

复制代码

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

2.验证安装

在bash中输入:

复制代码

claude --version

如果显示版本号，则安装成功

2、获取Claude Code API

访问AIO通用智能服务平台注册账号(https://api.aiearth.dev)

点击左上方控制台，进入数据看板

点击左侧令牌管理

点击添加令牌

在这里，只需要选择令牌分组即可，可选择

(额度可以在令牌管理界面编辑)

完成上述操作后，即可在令牌管理界面查看API了

3、配置环境变量

编辑Claude配置文件，主要是后续使用VS Code 远程连接服务器时，用于VS Code读取API等信息然后辅助编程。

终端输入：

复制代码

vim ~/.bashrc

添加以下环境变量：

变量名：ANTHROPIC_BASE_URL

变量值：https://api.aiearth.dev

变量名：ANTHROPIC_AUTH_TOKEN

变量值：(你在令牌管理处的API密钥)

变量名：ANTHROPIC_MODEL

变量值：claude-opus-4-5-20251101-thinking(你所需要的模型，我这里选择的是claude-opus-4-5-20251101-thinking，其他模型可以在AIO通用智能服务平台的模型广场内寻找)

复制代码

export PATH=$PATH:/usr/local/cuda-12.4/bin
export PATH="$HOME/local/node/bin:$PATH"
export ANTHROPIC_BASE_URL="http"
export ANTHROPIC_AUTH_TOKEN="sk-6xxxx"
export ANTHROPIC_MODEL="claude-opus-4-6"

如下图末尾三行所示：