安装或启动失败
使用官方下载中心，并选择匹配的操作系统和处理器架构。重试前记录错误信息。Linux 选择适合发行版的软件包格式。macOS 不应默认旧版 Intel 安装包仍受支持。
登录或网络错误
先确认账号能否登录官网，记录时间和错误代码，并检查代理、VPN 或组织策略是否影响客户端。在区分账号问题与本地客户端问题之前，不要反复重装。
模型不可用或达到 Token 上限
检查当前套餐、剩余用量和模型选择器，再新建一个小型对话测试。账号额度耗尽后，重装编辑器不会恢复额度。启用额外付费前，先核对价格和用量控制。
MCP 服务端无法启动
验证 JSON，确认 IDE 能找到可执行文件，并检查服务端日志。能运行 npx 的终端，其 PATH 可能与桌面应用不同。请按照 MCP 指南逐步排查。
扩展或索引问题
尝试小型项目，并临时禁用可疑扩展来定位原因。检查工作区大小，在客户端支持时排除生成文件。重置前先备份设置，并为官方支持准备简短的复现步骤。
支持报告应包含哪些信息
提供客户端版本、操作系统、处理器架构、地区、套餐、最小复现步骤和已脱敏的错误日志。共享前未经审查，不要附加访问令牌、环境配置文件或私有源代码。