在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 Code1、安装必要工具1.1 Linux端安装Node.js和GitNode.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 24nvm 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 Codenpm 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.js1.访问Node.js官网下载 安装LTS版本的Node.js(https://nodejs.org/zh-cn/download)2.使用xftp或其他工具将下载好的解压包上传至Linux服务器中的用户文件夹~下。然后在用户文件夹下创建node项目文件夹使用终端执行cd /root cd ~ mkdir -p ~/node3.将你下载的tar.xz文件解压并移动到上一步创建的文件夹中,并使用终端配置环境变量(注意vim进入文件后按i打开编辑模式键盘上下左右调整光标编辑完成后按esc输入:wq保存退出即可)tar -xJf ~/你的node.tar.xz -C ~/node --strip-components1vim ~/.bashrc在文件中末尾添加export PATH$HOME/local/node/bin:$PATH添加完成后在终端生效该配置文件 source ~/.bashrc4.安装完成后终端运行下列命令验证安装node --versionnpm --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 git2.安装完成后再次在终端输入下列命令验证安装git --version如果显示版本号则安装成功1.2 Linux端安装Claude Code1.安装官方版本打开bash终端输入:npm install -g anthropic-ai/claude-code2.验证安装在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_URLhttp export ANTHROPIC_AUTH_TOKENsk-6xxxx export ANTHROPIC_MODELclaude-opus-4-6如下图末尾三行所示4、启动Claude Code打开终端运行以下命令claudeClaude Code就这样安装好啦小编这里尝试了用Claude Code写了一个俄罗斯方块伙伴们可以自己试一试哦二、将Claude Code集成到VS Code打开VS Code首先使用SSH远程连接到服务器中然后点击扩展搜索Claude Code下载插件:然后编辑VSCode SSH远程访问服务器Claude Code编程所需配置文件终端输入vim ~/.claude/settings.json将下面内容拷贝到文件里面去然后保存退出(TOKEN换成自己的)然后大家就可以在VS Code中使用Claude Code辅助了