VSCode 远程调用 Claude 教程：告别繁琐，一步搞定 AI 编码助手

最近很多朋友在后台私信问，能不能在 VSCode 的远程开发环境（比如连接到服务器或 WSL）里直接调用 Claude 的能力？毕竟，大家写代码时最烦的就是来回切窗口，如果能像 GitHub Copilot 那样在编辑器里直接和 AI“灵魂对话”，那效率简直是起飞。

虽然官方的 Claude 扩展目前主要适配的是本地环境，但咱们折腾党从来不缺解决方案。今天就来细说一下，如何在 VSCode Remote 环境下顺滑地用上 Claude，以及这其中你可能会遇到的坑和解决办法。

为什么想要在远程环境用 Claude？

首先明确一下需求。很多后端开发或者运维同学，日常代码都是跑在远程 Linux 服务器上的。虽然 VSCode 的 Remote - SSH 功能已经解决了“用本地 IDE 写远程代码”的痛点，但 AI 辅助这一块，如果只是本地安装扩展，有时候网络代理或者环境隔离会有问题，或者你希望 AI 也能直接读取远程服务器的上下文文件。

核心思路：扩展装在哪里？

这里有个关键点：VSCode 的扩展安装位置取决于你的目标环境。

Local - SSH 模式：你在本地 UI 看到的 VSCode 实际上是一个壳，真正的计算（很多扩展）是跑在远程服务器上的。
Workbench 模式（如 Codespaces）：道理也是一样。

要让 Claude “懂”远程的代码，最稳妥的办法是在远程服务器上安装支持 Claude 的扩展。

解决方案一：使用 Continue.dev 扩展（推荐）

官方的渠道可能比较麻烦，或者网络受限，这里推荐一个目前社区非常火的开源方案——Continue。

这个扩展最大的优点就是高度自定义模型，不仅支持 GPT-4，也完美支持 Claude 3.5 Sonnet 等模型。

具体操作步骤：

安装扩展：在 VSCode 连接上远程服务器后，打开扩展商店，搜索 Continue 并安装。注意看左下角，确保此时处于 SSH:<your-server> 状态下，这样扩展是装在远端的。
配置 API Key：安装好后，Continue 会引导你进行配置。选择“Anthropic (Claude)”，填入你的 API Key（这里假设你已经有访问 Claude API 的途径）。
解决网络问题（重点）：如果你的远程服务器在国内，直接请求 Anthropic 的 API 肯定是连不上的。这时候你需要一个代理。Continue 的配置文件（通常是 ~/.continue/config.json）允许你设置 apiKey 和 baseURL。如果你有自建的代理中转服务，将 baseURL 指向你的代理地址即可。

解决方案二：Roo Code（Codeium）

另一个选择是 Roo Code（前身是 Codeium 的开源部分），它也支持自定义 API 接口。如果你的网络环境对某些服务商比较友好，这个也是个不错的备选。配置思路和 Continue 类似，核心就是在远端环境配置好能连通 Claude 的入口。

绕不开的坑与解决办法

在折腾过程中，新手最容易卡在下面两个地方：

1. LSP（Language Server Protocol）报错 有时候你会发现扩展安装了，但是输入框没反应，或者报错说连接 LSP 失败。这通常是因为远程服务器的 Node.js 版本过低或过高，导致扩展进程起不来。

解决办法：在远程终端查看扩展日志，检查 Node 版本。建议在远端安装 nvm，然后切换到一个 LTS（长期支持）版本的 Node.js，通常能解决大部分灵异问题。

2. 上下文读取权限 AI 需要读取你的代码文件才能给建议。如果你在远端的权限配置比较严格，扩展可能会报错说“无法读取文件”或“Permission denied”。

解决办法：检查你当前登录远程用户的文件读写权限。尽量在你有完整权限的项目目录下进行操作，避免遇到系统级目录的权限阻碍。

总结一下

想在 VSCode 远程环境里用 Claude，本质就是把支持自定义模型接口的扩展安装在远端，并配置好能访问 Claude API 的网络环境。

目前比较平滑的路径是使用 Continue 这个扩展，它的灵活性最高，对 Claude 的支持也最好。如果你还在为切浏览器问 Claude 而烦恼，不妨按上面的步骤试试，体验一下 AI 直接在代码行里写注释、修 Bug 的爽快感。

如果你在配置过程中遇到了其他奇怪的问题，欢迎在评论区交流，大家一起避坑！