trae work启动失败的根本原因是vm沙箱超时，需强制终止进程、清理临时缓存、验证系统版本≥19044、关闭杀毒软件；macos需清solo进程并释放8080端口；中转配置须匹配key前缀与模型id；插件安装需核对ide版本及清理旧缓存；wsl2需更新内核并禁用systemd。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
TRAE Work 2.1/3.0 配置总报错，不是你操作错了，而是启动链路上某个环节卡死——VM沙箱超时、环境变量污染、中转模型ID不匹配、IDE版本越界，任何一个都足以让整个工作环境停在“启动失败”界面不动。
Windows平台：Work环境启动失败（992602错误）
第一步：强制终止所有 TRAE SOLO CN 进程
打开任务管理器 → 切换到“详细信息”页签 → 找到所有名称含 【trae-solo-cn】 或 【toolhost】 的进程 → 全部右键“结束任务”。这一步必须做全，残留一个进程都会导致后续启动被锁死。
第二步：清理临时沙箱缓存
手动删除目录：C:\Users\你的用户名\AppData\Local\Temp\trae-agent-to*（带星号通配符，实际删除所有以 trae-agent-to 开头的文件夹）。该路径下堆积的旧沙箱镜像会拖慢启动速度，尤其当磁盘IO负载高时，直接触发超时。
第三步：验证系统最低要求
按 Win+R 输入 winver → 确认 OS Build ≥ 19044。即使你是 Windows 11，也可能因未更新累积补丁而停留在低版本内核。若低于此值，必须安装 KB5037771 或更高补丁，否则 VM 沙箱根本无法初始化。
第四步：重试前关闭杀毒软件实时防护
某些国产安全软件（如火绒、360）会拦截 toolhost 进程的内存映射行为，表现为 fallback 启动也失败。临时禁用后重试，成功后再恢复。
macOS平台：Toolhost反复超时
方法一：清空 SOLO 进程并释放端口
先用 command + Q 彻底退出 TRAE Work；再打开“活动监视器” → 切换到“CPU”页签 → 搜索关键词 【SOLO】 → 选中 【TRAE SOLO CN】 进程 → 点击左上角“×”强制退出；最后在终端执行：lsof -i :8080 | grep LISTEN | awk '{print $2}' | xargs kill -9（8080 是默认 toolhost 通信端口，若改过请替换）。
方法二：绕过 VM 直接启用 fallback 模式
编辑 ~/Library/Application Support/TRAE SOLO CN/config.json，在根对象中添加："fallback_mode": true, "vm_disabled": true。保存后重启 TRAE Work，跳过沙箱直连本地执行环境。注意：此模式不支持敏感代码隔离，仅用于调试阶段。
配置中转服务时报 model_not_found
第一步：确认 Key 类型与中转商严格匹配
小米 MiMo 必须用 【tp-】开头的 Key，Anthropic 官方 Key（sk-开头）在此场景下必然失败。填错前缀会导致认证层直接拒绝，不进模型路由。
第二步：核对模型 ID 是否为中转站真实注册名
不要抄第三方文档里的通用写法。登录小米 MiMo 控制台 → 进入“模型管理”页 → 复制“服务名称”列的完整字符串（例如 【mimo-v2.5-pro】），粘贴到 TRAE 设置中对应字段。大小写、点号、连字符缺一不可。
第三步：关闭非必要流量开关
在 ~/.claude/settings.json 的 env 对象里，必须包含："CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC":"1"。不加这一行，Claude Code 会尝试上报遥测数据，而中转站通常不代理这类请求，造成连接中断假象。
PyCharm/IntelliJ插件安装失败
① 查 IDE 版本是否在兼容区间
Help → About → 看 Build Number。TRAE 插件 3.0 要求 IntelliJ 平台 ≥ 231（即 2023.1+），2.1 版本则需 ≥ 221。低于下限会静默加载失败，无任何提示。
② 清理旧版 MarsCode 缓存
卸载 MarsCode 插件后，必须手动删除：~/.config/JetBrains/PyCharm2023.3/options/marscode.*（Linux/macOS）%APPDATA%\JetBrains\PyCharm2023.3\options\marscode.*（Windows）。残留配置会劫持 TRAE 的账号登录流程。
③ 代理设置必须与系统一致
File → Settings → Appearance & Behavior → System Settings → HTTP Proxy → 选择“Auto-detect proxy settings”，不要勾选“Use system proxy settings”。TRAE 插件读取的是 IDE 自己的代理配置，而非系统全局设置。
WSL2环境无法启动Toolhost
确认 WSL2 内核已更新至 5.15.133.1 或更高：
在 PowerShell 中运行 wsl -l -v → 查看 Ubuntu 实例状态；若为 Stopped，先执行 wsl --shutdown；再运行 wsl --update。旧内核存在虚拟串口驱动缺陷，导致 toolhost 初始化时卡在 UART handshake 阶段。
检查 /etc/wsl.conf 是否禁用 systemd：
若存在 [boot]systemd=true，必须删除该行或设为 false。TRAE Work 的 toolhost 依赖传统 SysV init 流程，启用 systemd 会导致 service 启动顺序错乱，超时退出。
