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

时间：2026-07-24 08:24:03 来源：互联网

本教程详细讲解在Linux中安装Claude Code并集成到VS Code的全过程，从环境搭建到远程连接，每一步都有清晰说明，帮助新手快速掌握AI编程辅助工具。

本教程包含以下两个核心部分：

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中的更新方式。

在终端里直接复制整段执行即可。当前为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

访问相关平台注册账号

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

点击左侧令牌管理

点击添加令牌

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

（额度可以在令牌管理界面编辑）

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

3、配置环境变量

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

终端输入：

vim ~/.bashrc

添加以下环境变量：

变量名：ANTHROPIC_BASE_URL

变量值：相关API基地址

变量名：ANTHROPIC_AUTH_TOKEN

变量值：（你在令牌管理处的API密钥）

变量名：ANTHROPIC_MODEL

变量值：claude-opus-4-5-20251101-thinking（你所需要的模型，这里选择的是claude-opus-4-5-20251101-thinking，其他模型可在模型广场内寻找）

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"

如下图末尾三行所示：