安裝或啓動失敗
使用官方下載中心，並選擇匹配的操作系統和處理器架構。重試前記錄錯誤資訊。Linux 選擇適合發行版的軟體包格式。macOS 不應默認舊版 Intel 安裝包仍受支援。
登入或網路錯誤
先確認賬號能否登入官網，記錄時間和錯誤程式碼，並檢查代理、VPN 或組織策略是否影響客戶端。在區分賬號問題與本地客戶端問題之前，不要反復重裝。
模型不可用或達到 Token 上限
檢查當前套餐、剩餘用量和模型選擇器，再新建一個小型對話測試。賬號額度耗盡後，重裝編輯器不會恢復額度。啓用額外付費前，先核對價格和用量控制。
MCP 服務端無法啓動
驗證 JSON，確認 IDE 能找到可執行檔案，並檢查服務端日誌。能執行 npx 的終端，其 PATH 可能與桌面應用不同。請按照 MCP 指南逐步排查。
擴充功能或索引問題
嘗試小型專案，並臨時禁用可疑擴充功能來定位原因。檢查工作區大小，在客戶端支援時排除生成檔案。重置前先備份設定，並為官方支援準備簡短的復現步驟。
支援報告應包含哪些資訊
提供客戶端版本、操作系統、處理器架構、地區、套餐、最小復現步驟和已脫敏的錯誤日誌。共享前未經審查，不要附加存取令牌、環境配置檔案或私有源程式碼。