必须通过vs code remote-ssh插件建立连接后，在远程环境中安装fitten code扩展并配置remote.extensionkind，否则补全、聊天等功能无法生效；ssh服务、端口放行及本地直连验证为前置必要条件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Fitten Code中直接编辑远程Linux服务器上的代码，必须先让Fitten Code识别并接入远程环境——它不支持纯SSH连接，而是依赖VS Code Remote-SSH插件建立通道，再将Fitten Code作为远程扩展启用。这一步漏掉，后续所有补全、聊天、推理功能都无法生效。
确认远程服务器已启用SSH服务
登录远程服务器终端，执行 sudo systemctl status ssh 或 sudo systemctl status sshd。若显示 active (running)，说明服务就绪；若提示 Unit ssh.service not found，需先安装：Ubuntu/Debian运行 sudo apt install openssh-server，RHEL/CentOS/Rocky运行 sudo dnf install openssh-server。
确保防火墙放行22端口：sudo ufw allow 22（Ubuntu）或 sudo firewall-cmd --permanent --add-port=22/tcp && sudo firewall-cmd --reload（RHEL系）。
验证本地能否SSH直连：在你自己的电脑上运行 ssh username@server_ip。能成功登录，才进入下一步。连不通就别往下试了——Fitten Code不会帮你修SSH配置。
本地VS Code安装Remote-SSH插件
打开本地VS Code → 点击左侧扩展图标 → 搜索栏输入 Remote - SSH → 找到官方出品的 Remote - SSH（作者 Microsoft）→ 点击“安装”。
安装完成后，左下角状态栏会出现一个绿色的远程连接图标。点击它 → 选择 Connect to Host... → 再选 Add New SSH Host...。
按提示输入连接字符串，格式为：ssh username@server_ip。如果使用密钥登录且私钥不在默认路径（~/.ssh/id_rsa），需写成：ssh -i /path/to/private_key username@server_ip。这一步输错，后面所有窗口都打不开。
远程安装Fitten Code扩展
完成SSH连接后，VS Code会自动在远程服务器上部署VS Code Server，并弹出新窗口——此时你看到的就是远程文件系统。
Fitten Code 1.0.3是一款由清华博士团队打造的AI编程助手，基于国产计图（Jittor）深度学习框架开发。它支持VS Code、JetBrains系列等主流IDE及80多种编程语言。核心功能包括智能代码补全、注释生成、代码解释、Bug检测、单元测试生成等，旨在全方位提升开发效率。该工具对个人用户免费开放。
再次点击左侧扩展图标 → 在搜索框顶部切换为 Remote Extensions（图标为显示器+插头）→ 输入 Fitten Code → 找到 FittenTech.Fitten-Code → 点击“Install on SSH: [你的服务器名]”。
【关键提醒】必须在此处安装，不能在本地Extensions页装。装错位置会导致插件完全不可见、无法激活，且无任何报错提示。
安装完毕后，重启远程窗口（Cmd/Ctrl+Shift+P → 输入 “Developer: Reload Window” → 回车），Fitten Code侧边栏图标才会出现。
配置Fitten Code远程运行参数
按下 Cmd/Ctrl+Shift+P → 输入 Preferences: Open Settings (JSON) → 回车 → 打开的是远程服务器上的 settings.json 文件。
在文件末尾的 } 前插入以下配置块：
"remote.extensionKind": { "FittenTech.Fitten-Code": ["ui"] }
保存文件。这行配置告诉VS Code：Fitten Code需以UI模式在本地渲染界面，但逻辑运行在远程。没有它，插件可能加载失败或响应延迟极高。
若远程服务器离线或无法访问互联网，需手动把本地已配好的 fitten.code.* 相关字段（如 fitten.code.apiKey、fitten.code.model）复制进远程的 $HOME/.vscode-server/data/Machine/settings.json 文件末尾，然后重启VS Code Server进程：kill -9 $(pgrep -f "node.*vscode-server")。
