必须先确认ide版本为2021.3及以上且系统兼容，再通过插件市场安装并用实名百度主账号登录，否则插件无法加载模型服务或触发代码补全。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在PyCharm或GoLand中启用百度文心快码（Baidu Comate）AI编程助手，必须先确认IDE版本满足最低要求，再通过插件市场完成安装与登录，否则插件将无法加载模型服务或触发代码补全。
检查IDE版本与系统兼容性
打开PyCharm或GoLand → 点击Help → About（macOS为PyCharm/GoLand → About），查看版本号；【必须为2021.3及以上】，低于此版本会提示“Plugin is incompatible”且无法安装成功。Windows用户需确保系统为Win7+，macOS用户需为11.0+，Linux用户需glibc≥2.28。
若版本过旧，请前往JetBrains官网下载最新稳定版，旧版IDE即使强行安装Comate插件，也会在首次调用时因API不匹配而报错“Failed to initialize LSP client”。
安装Comate插件（图形界面操作）
方法一：在线安装（推荐）
File → Settings（macOS为PyCharm/GoLand → Preferences）→ Plugins → Marketplace，搜索“Baidu Comate” → 点击Install → 安装完成后弹出提示框，点击Restart IDE。
方法二：离线安装（网络受限时）
访问百度Comate官方插件发布页（plugins.jetbrains.com/plugin/24595-baidu-comate），下载对应IDE版本的.zip包 → Settings → Plugins → ⚙️齿轮图标 → Install Plugin from Disk → 选择下载的zip文件 → Restart IDE。
注意：离线安装后若右下角无登录弹窗，请手动进入Settings → Tools → Baidu Comate → 点击“Login”按钮，否则插件处于未激活状态。
登录并激活服务
第一步：重启IDE后，右下角自动弹出登录窗口；若未弹出，可点击右侧边栏Baidu Comate图标，或通过Tools → Baidu Comate → Login唤起登录面板。
第二步：使用百度账号扫码或输入账号密码登录；【必须是已实名认证的百度主账号】，子账号或企业邮箱绑定账号可能被拒绝授权。
第三步：登录成功后，状态栏显示“Comate Ready”，此时即可选中代码 → 右键 → “Ask Comate”生成注释，或按快捷键Alt+Q（Windows/Linux）/Option+Q（macOS）唤出对话框。
这一步不可跳过——未登录状态下所有AI功能均灰显，且IDE日志会持续报错“Unauthorized: missing access token”。
