排查

连接与运行

• 插件角标是 OFF（红色）：运行 curxor status 确认本地服务已启动；未启动则执行 curxor start。
• CLI 未运行：curxor status 应显示绿色 ● running 与 Local: http://127.0.0.1:51999；首次使用需要 curxor start。
• 端口被占导致起不来：本地服务固定用 127.0.0.1:51999，先释放该端口。

AI 不生效

• AI 不认识 CX 码：MCP 未生效。跑 curxor mcp --print-config，核对编辑器配置里的 command 是否与输出的绝对路径一致，然后重启编辑器 / 新开会话。
• Code 无效或已失效：粘贴的 code 可能拼写有误、不存在或已过期，请回浏览器重新复制。
• 选择器里显示「模型加载失败」：该 Agent 的 CLI 未安装、未登录或未启动。Claude Code 确认 claude 可运行且已登录；Cursor 确认 cursor-agent 在 PATH；其他 Agent 确认 probe 字段指向的二进制可运行且已登录。
• 改了配置没反应：MCP 配置改动要重启编辑器 / 新开会话；agents.toml 保存后，下一次请求生效。

定位不到源码

• 确认项目跑在 dev 模式：生产构建没有可用的源码路径，curxor 只解析已关联的 dev 项目。
• 项目没关联上：Windows 需要手动 curxor attach http://localhost:PORT。

看日志

curxor status 会打印日志位置：

还是没解决？带上 curxor status 的输出和日志片段去 GitHub 开 issue。