Linux 安装 Claude Code 并通过 VS Code SSH 远程使用
想在 Linux 上把 Claude Code 跑起来,再顺手接到本地 VS Code 里用,关键不在'会不会装',而在于环境、变量和远程配置这几处别踩坑。下面我按实际操作顺一遍,从 Linux 端安装到 SSH 远程集成,尽量把容易出错的地方都提前说明白。

一、在 Linux 上安装 Claude Code
先把运行环境准备好
Claude Code 依赖 Node.js 和 Git。前者提供运行环境,后者虽然不一定每一步都要用到,但在一些项目管理和扩展场景里很常见,提前装好省得后面来回补环境。
这里有个小提醒:下面这些操作建议都在普通用户下完成,不要直接用 root 去装,后面配环境变量和远程访问时会省很多麻烦。
安装 Node.js
- 先去 Node.js 官网下载 LTS 版本的安装包:https://nodejs.org/zh-cn/download

- 把下载好的
.tar.xz包上传到 Linux 用户目录下,比如~。然后创建一个本地安装目录:
cd ~
mkdir -p ~/local/node
- 解压并移动到目标目录,再把它加入环境变量。这里我用
bashrc举例,照着做就行:
tar -xJf ~/你的node.tar.xz -C ~/local/node --strip-components=1
vim ~/.bashrc
在文件末尾补上这一行:
export PATH="$HOME/local/node/bin:$PATH"
保存后让配置立即生效:
source ~/.bashrc
- 验证一下安装是否成功:
node --version
npm --version
能看到版本号,说明 Node.js 已经能正常用了。

安装 Git
Git 的安装方式很多,最直接的还是去官网按你的 Linux 发行版选择合适的安装方式:https://git-scm.com/downloads/linux
装完后同样检查一下:
git --version
输出版本号就说明没问题。

安装 Claude Code
环境准备好之后,直接通过 npm 全局安装即可:
npm install -g @anthropic-ai/claude-code
安装完成后验证一下:
claude --version
如果版本号正常输出,说明 Claude Code 已经装进系统了。

配置 API 相关环境变量
Claude Code 真正能不能用起来,通常卡在这一步。你需要把 API 地址、Token 和模型名写进环境变量里,这样后面无论是直接在终端使用,还是通过 VS Code 远程连接,工具都能读到这些信息。
编辑 ~/.bashrc:
vim ~/.bashrc
在文件末尾添加类似下面的配置,记得把 Token 换成你自己的:
export ANTHROPIC_BASE_URL="https://api.aiearth.dev"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"
export ANTHROPIC_MODEL="claude-opus-4-5-20251101-thinking"
如果你想用别的模型,也可以按实际情况替换 ANTHROPIC_MODEL 的值。保存后执行一次:
source ~/.bashrc
启动 Claude Code
到这里,直接在终端里启动即可:
claude

如果一切顺利,Claude Code 就已经在 Linux 上跑起来了。你甚至可以直接让它帮你生成一些小项目,比如做个简单的俄罗斯方块,实际体验一下它在代码生成和修改上的手感。

二、在 VS Code 中通过 SSH 远程使用 Claude Code
单机终端里能跑,不代表开发体验就够顺手。真正好用的地方在于:你可以在本地 VS Code 里通过 SSH 连到服务器,把远程环境当作自己的工作区来用,Claude Code 也能顺势融进去。
连接远程服务器并安装扩展
先在本机 VS Code 里通过 SSH 连接到目标服务器,然后打开扩展市场,搜索 Claude Code 并安装对应插件。


配置 Claude Code 的远程设置
接下来需要给 Claude Code 准备一个配置文件,让 VS Code 在 SSH 场景下也能读取到 API 信息。终端执行:
vim ~/.claude/settings.json
把对应配置写进去并保存。这里最关键的还是 Token 需要替换成你自己的,其他字段按你的实际环境保持一致即可。

配置完成后,重新回到 VS Code,就可以在远程工作区里调用 Claude Code 辅助编程了。


结语
这套流程看起来步骤不少,但拆开之后其实很清晰:先在 Linux 上把 Node.js、Git、Claude Code 和环境变量配好,再通过 VS Code SSH 把远程开发环境接起来。真正要注意的,反而是几个细节——普通用户安装、环境变量写对、Token 不要填错。把这些地方处理稳了,后面用起来会顺很多。


