comateservice未启动会导致所有ai功能失效,需手动启动:windows下双击comateservice.exe或管理员运行命令启动;macos下用launchctl加载并启动服务;最后访问http://127.0.0.1:8080/health验证响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

文心快码(Comate)插件安装完成后,本地服务 ComateService 未自动启动会导致代码补全、智能提示、文档生成等功能全部失效,编辑器内看不到任何 AI 辅助响应。
确认 ComateService 是否已在后台运行
打开任务管理器(Windows)或活动监视器(macOS),搜索进程名 ComateService 或 comate-service。若未找到该进程,说明服务尚未启动,需手动触发。
这一步不能跳过——即使插件图标已显示在编辑器侧边栏,没有 ComateService 运行,所有 AI 功能都只是静态界面,不会执行任何推理或调用模型。
Windows 系统下启动 ComateService
方法一:通过安装目录直接运行服务程序
进入 Comate 安装路径(默认为 C:\Program Files\Baidu\Comate 或你自定义的路径),找到 ComateService.exe 文件,双击运行。首次运行会弹出 Windows 安全警告,点击「更多信息」→「仍要运行」。
方法二:以管理员身份运行命令行启动
按 Win+R 输入 cmd → 右键「以管理员身份运行」→ 执行以下命令:
cd /d "C:\Program Files\Baidu\Comate" && ComateService.exe --start
【必须使用管理员权限】 否则服务无法绑定本地 127.0.0.1:8080 端口,后续插件将连接失败并报错“Connection refused”。
macOS 系统下启动 ComateService
第一步:打开终端,执行以下命令检查服务状态
launchctl list | grep comate
若无输出,说明服务未注册;若有类似 com.baidu.comate.service 的条目但状态为 -,说明已注册但未运行。
第二步:加载并启动服务
执行:launchctl load ~/Library/LaunchAgents/com.baidu.comate.plist
第三步:立即启动服务进程
执行:launchctl start com.baidu.comate.service
此时可在「活动监视器」中看到 ComateService 进程 CPU 占用率短暂上升,表示模型加载中。
验证服务是否正常响应
在浏览器地址栏输入 http://127.0.0.1:8080/health,回车。
如果返回 JSON 内容 {"status":"ok","version":"v3.2.1"}(版本号以实际安装为准),说明 ComateService 已就绪。
若返回 “Connection refused” 或超时,请回到前两步检查端口占用、防火墙拦截或杀毒软件阻止行为——【ComateService 默认仅监听 127.0.0.1,不对外网开放,无需修改 host 或配置反向代理】。











