文心快码需百度账号登录才启用核心功能，离线仅支持基础补全；安装后须彻底重启VS Code并手动切回窗口完成认证；远程开发需本地登录，生成质量高度依赖注释与函数签名。

能装，但必须用百度账号登录才启用核心功能；离线可触发基础补全，但生成逻辑、解释、重构等能力需联网验证身份。

VS Code 扩展安装与激活流程

插件本身不收费，但激活依赖百度账号体系——没登录就只是个“哑巴补全框”，连 Ctrl+Space 都不会弹建议。

• 打开 VS Code，按 Ctrl+Shift+X（Win/Linux）或 Cmd+Shift+X（Mac）唤出扩展面板
• 搜索栏输入 文心快码 或 Baidu Comate，认准发布者是 Baidu 官方（非第三方仿冒）
• 点击 Install → 安装完成后务必 Restart VS Code（不是重载窗口，是彻底重启进程）
• 重启后右上角出现登录浮层，点击跳转浏览器；用百度账号登录后，**必须手动切回 VS Code 窗口**，它不会自动刷新状态

登录失败或提示“未授权”的常见原因

不是网络问题，而是账号权限/客户端状态没对齐。尤其 Mac 用户容易卡在“已登录网页，但 VS Code 仍灰显”这一步。

• 浏览器登录成功后，不要关闭该标签页，直接 Alt+Tab 切回 VS Code，插件会主动轮询认证状态
• 若持续显示“未登录”，检查 VS Code 是否启用了代理（Settings > Proxy），Comate 不走系统代理，需关掉或设为 none
• 企业账号或教育邮箱登录失败？换个人百度账号（手机号注册的普通账号）——部分组织域账号未开通 Comate API 权限
• 仍不行？手动填 License：访问 https://comate.baidu.com/zh/account，复制页面顶部的 Username 和下方 License Key，在 VS Code 设置里搜 comate.license 和 comate.username 手动粘贴

远程开发（SSH）场景下的配置要点

Remote-SSH 连接后，Comate 默认不自动加载——它只运行在本地 VS Code 主进程中，远程窗口里看不到图标、无法触发补全。

• 必须在本地 VS Code 安装并登录 Comate，且确保 Remote Development 扩展已启用
• 连接远程服务器后，打开任意文件（如 test.py），把光标放在函数内，按 Ctrl+Enter（默认快捷键）呼出 Comate 面板——此时调用的是本地模型服务，代码内容经加密传输，不落远程磁盘
• 注意：远程终端中运行的 python 或 node 进程无法被 Comate 直接感知，它的上下文仅来自当前编辑器打开的文件和选中文本

最容易被忽略的一点：Comate 的代码生成质量高度依赖注释和函数签名。写个空函数体然后让它“实现业务逻辑”，大概率返回通用模板；但如果你先写好 /** @param {string} userId - 用户唯一标识 */ 和清晰的函数名，生成结果会精准得多。