文心快码需百度账号登录才启用核心功能，离线仅支持基础补全；安装后须彻底重启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 - 用户唯一标识 */ 和清晰的函数名，生成结果会精准得多。
