要在远程Linux服务器上通过SSH启用文心快码（Baidu Comate），需先确保VS Code已Remote-SSH连接，并安装Python 3.8+、git及gcc等编译工具；再通过pip或二进制方式安装comate CLI并登录；最后在VS Code中启用Comate远程服务并验证补全与问答功能。

要在远程Linux服务器上通过SSH环境安装并启用文心快码（Baidu Comate）插件能力，必须先确保VS Code已通过Remote-SSH连接到目标服务器，且服务器具备Python 3.8+、git及基础编译工具链——缺少任一依赖会导致Comate核心服务无法启动。

确认远程开发环境就绪

打开已连接的Remote-SSH窗口，在集成终端中执行：python3 --version && git --version && gcc --version。若任意命令报“command not found”，需先安装对应组件：Ubuntu/Debian系统运行sudo apt update && sudo apt install -y python3-pip git build-essential；CentOS/RHEL系统运行sudo yum groupinstall -y "Development Tools" && sudo yum install -y python3-pip git。

这一步不能跳过，【Comate后端服务启动时会硬依赖gcc和pkg-config，仅装Python而无编译工具将导致服务静默崩溃】。

安装Comate CLI并注册服务

方法一：使用pip全局安装（推荐）

在Remote-SSH终端中执行：pip3 install baidu-comate-cli。安装完成后运行comate version验证是否输出版本号（如v1.5.2+）。

方法二：手动下载二进制（适用于无pip权限场景）

访问Comate最新CLI下载页，复制Linux x86_64最新版tar.gz链接 → 在终端中执行：wget -O comate-cli.tar.gz <链接> && tar -xzf comate-cli.tar.gz && chmod +x comate && sudo mv comate /usr/local/bin/。

执行comate login，按提示用浏览器扫码完成百度账号绑定。登录成功后，终端会显示“✅ Login successful”并自动写入~/.comate/config.yaml。

配置VS Code Remote-SSH启用Comate

第一步：确保VS Code已安装Remote-SSH与Comate最新扩展（ID：baidubce.comate）。

第二步：在Remote-SSH窗口中，按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入“Comate: Enable in Remote”并回车。

第三步：VS Code会自动检测comate命令是否存在，并尝试启动后台服务。若弹出“Starting Comate server…”提示且右下角状态栏出现蓝色Comate图标，说明服务已就绪。

注意：首次启用可能需等待10–20秒，期间不要关闭终端或重启窗口——【服务启动失败时VS Code不会报错，只会静默停在“Initializing…”状态，此时需手动执行comate serve --port=3333排查日志】。

验证代码补全与智能问答功能

新建一个test.py文件，输入import os后换行，紧接着键入os.pa，稍等1秒，应自动弹出os.path.join等补全建议。

选中任意一行代码，右键→“Comate: Ask about selection”，输入“这段代码的作用是什么”，等待3秒内返回中文解释。

打开命令面板（Ctrl+Shift+P），运行“Comate: Show Logs”，滚动到底部确认最后两行含INFO server started on http://127.0.0.1:3333及INFO LSP initialized。