跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像AI 生图工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / BashVScodeNode.js

Linux 安装 Claude Code 并通过 VS Code SSH 远程使用

在 Linux 上部署 Claude Code 的关键是先准备好 Node.js、Git 和环境变量,再通过 npm 全局安装并用 API Token、基础地址和模型名完成配置;随后在本地 VS Code 里通过 SSH 连接远程服务器,安装对应扩展并配置 ~/.claude/settings.json,即可把 Claude Code 无缝接入远程开发流程。

技术博主发布于 2026/2/17更新于 2026/7/2727 浏览
Linux 安装 Claude Code 并通过 VS Code SSH 远程使用

Linux 安装 Claude Code 并通过 VS Code SSH 远程使用

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

文章配图

一、在 Linux 上安装 Claude Code

先把运行环境准备好

Claude Code 依赖 Node.js 和 Git。前者提供运行环境,后者虽然不一定每一步都要用到,但在一些项目管理和扩展场景里很常见,提前装好省得后面来回补环境。

这里有个小提醒:下面这些操作建议都在普通用户下完成,不要直接用 root 去装,后面配环境变量和远程访问时会省很多麻烦。

安装 Node.js

  1. 先去 Node.js 官网下载 LTS 版本的安装包:https://nodejs.org/zh-cn/download

文章配图

  1. 把下载好的 .tar.xz 包上传到 Linux 用户目录下,比如 ~。然后创建一个本地安装目录:
cd ~
mkdir -p ~/local/node
  1. 解压并移动到目标目录,再把它加入环境变量。这里我用 bashrc 举例,照着做就行:
tar -xJf ~/你的node.tar.xz -C ~/local/node --strip-components=1
vim ~/.bashrc

在文件末尾补上这一行:

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

保存后让配置立即生效:

source ~/.bashrc
  1. 验证一下安装是否成功:
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 不要填错。把这些地方处理稳了,后面用起来会顺很多。

目录

  1. Linux 安装 Claude Code 并通过 VS Code SSH 远程使用
  2. 一、在 Linux 上安装 Claude Code
  3. 先把运行环境准备好
  4. 安装 Node.js
  5. 安装 Git
  6. 安装 Claude Code
  7. 配置 API 相关环境变量
  8. 启动 Claude Code
  9. 二、在 VS Code 中通过 SSH 远程使用 Claude Code
  10. 连接远程服务器并安装扩展
  11. 配置 Claude Code 的远程设置
  12. 结语
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • VMware Workstation Pro 官方下载指南(Windows/Linux)
  • ROS导航实战:如何用mpc_local_planner让机器人高效避障(附参数调优技巧)
  • EFSI-DETR:用于无人机图像实时小目标检测的高效频域 - 语义集成方法
  • AI 绘画建筑设计提示词:从基础到高级的完整指南
  • Vue3 人机对话界面实现:流式请求与 ECharts 图表集成
  • WebDAV 服务器快速部署指南:搭建个人文件共享平台
  • 网络安全基础与渗透测试全流程指南
  • Docker 拉取镜像失败报错及配置镜像源解决方案
  • @anthropic-ai/claude-code 快速上手指南
  • OpenClaw 六大开源替代方案深度对比
  • AI 大模型视角下的 To C 与 To B 本质区别
  • C++ STL list 容器深度剖析与模拟实现
  • GitHub 开源项目:30+ 个 OpenClaw 真实使用场景解析
  • WebPShop 插件:Photoshop 实现 WebP 格式全功能支持
  • 企业级中后台开源解决方案汇总
  • Qoder 和 Lingma IDE 的上手记录
  • AI-Goofish-Monitor:闲鱼商品智能监控与自动化分析工具
  • 大疆无人机常见故障提示及应对指南
  • Java 多线程之原子操作类
  • SBUS 协议详解:从原理到 STM32 实战

相关免费在线工具

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online

  • JSON美化和格式化

    将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online