先说一个关键前提：Fitten Code 要在远程服务器上正常运作，插件必须老老实实地安装在远端环境里，而不是你本地那个界面华丽的 VS Code 窗口中。否则，所谓的 AI 智能补全、自动化代码生成，统统只是摆设，无法真正调用。

在 Linux 系统下让 Fitten Code 顺利运行并接入远程开发工作流，必须确保该插件已部署至远程服务器环境。这一步一旦搞错方向，后续所有配置都是徒劳。

检查 VS Code 版本与远程连接状态

启动 VS Code，按下 Ctrl+Shift+P 调出命令面板，输入 Help: About 查看当前版本信息。请注意，版本号必须 ≥1.68.0，若低于此版本，Fitten Code 的核心模块将无法正常加载运行。

如果你采用 SSH 方式进行远程开发，先点击左下角状态栏的远程连接图标，选择 Connect to Host...，然后输入目标 Linux 服务器的地址及登录凭证，待状态栏右侧显示出 SSH: hostname 字样，才表示已成功连接。

需要特别留意的是：后续所有插件安装操作，都必须在这个已经建立连接的远程窗口中完成。千万不要在本地窗口里搜索“Fitten Code”进行安装——即使装上了也无法发挥作用，白白浪费时间精力。

安装 Fitten Code 插件（远程端）

以下提供两种方式，你可以根据自身情况选择最适合的一种。

方案一：图形界面安装（推荐新手用户）

点击左侧扩展图标（或按下 Ctrl+Shift+X），在搜索框中输入 Fitten Code。从结果列表中找到官方发布者为 FittenTech 的插件，然后点击 Install 按钮。操作非常简单直观。

方案二：终端命令安装（适合无图形界面或批量部署场景）

打开 VS Code 内置终端（Ctrl+`），首先确认当前处于远程 Linux 环境——执行 hostname 命令，返回的应当是远程服务器名称，而非你本地的主机名。确认无误后，运行以下命令：

code --install-extension FittenTech.Fitten-Code

安装完成后，VS Code 右下角会弹出登录提示浮层，点击“Sign in”进入网页授权流程；如果没有自动弹出，你可以手动点击左侧活动栏中的 Fitten Code 图标来触发登录操作。

配置远程扩展运行模式

这一步很多人容易忽略，但恰恰是决定功能能否正常使用的关键环节。

打开远程窗口的设置界面（Ctrl+,），在左侧树状菜单中切换到 Settings (Remote)。在搜索框中输入 remote.extensionKind，然后点击 Edit in settings.json。

在弹出的 settings.json 文件中，添加如下配置项（如果已存在 remote.extensionKind 对象，直接在其内部追加即可）：

"remote.extensionKind": { "FittenTech.Fitten-Code": ["workspace"] }

保存文件（Ctrl+S），然后关闭并重新打开一个远程文件夹。这一步会强制 Fitten Code 以 workspace 模式加载运行，从而避免因 UI 模式限制导致的补全延迟或功能缺失问题。

验证基础功能是否正常运行

花一分钟时间检验一下配置成果。

新建一个 .py 文件，输入 def hello()，然后按下 Tab 键。观察一下，IDE 是否自动补全为完整的函数结构——包括冒号、缩进以及 pass 占位符？

接着，选中任意一段代码，右键查看上下文菜单，确认是否出现了 Fitten Code – 解释代码、Fitten Code – 生成注释 等选项。

如果以上两项功能均能正常响应，说明安装与远程配置已全部完成。AI 代码补全、智能对话问答、Bug 检测分析等完整功能，现在就可以正式投入使用了。