1. Trae 工作环境启动失败到底卡在哪如果你在 Windows 上用 Trae 跑 Work 任务突然弹出「工作环境启动失败请重试」大概率不是你的系统版本太低也不是网络断了而是 Trae 的 Toolhost 沙箱环境启动超时了。这个报错完整长这样Toolhost startup failed: VM start failed: Timeout waiting for toolhost to be ready; fallback also failed。翻译成人话就是Trae 想给你的任务开一个隔离的执行环境结果等了好久没等到它准备好连降级方案不走 VM 沙箱直接启动也一起超时了。这个报错最迷惑的地方在于官方排查页给的建议是「检查 Windows 系统版本低于 19044 就升级到 Win10 21H2 以上」。但很多人明明是 Windows 11版本号早就超了照样报错。我实测下来真正的原因往往藏在另一个地方%LOCALAPPDATA%\Temp\trae-agent-toolhost\jobs\这个目录里堆积了大量历史 job 文件。Toolhost 启动时要逐个读取这些文件几百上千个还好一旦堆到几千个启动时间就被拖到超时阈值之外于是报错。这篇文章适合三类人一是刚遇到这个报错、搜到官方文档但没解决的 Windows 用户二是想搞清楚 Trae 工作环境机制、避免反复踩坑的开发者三是打算把 Trae 接到统一 API 通道比如 TaoToken做长期编码任务的人。我会从 PowerShell 执行策略检查开始一路讲到 settings.json 骨架配置和 TaoToken 接入每一步都给可复制的命令和验证动作。2. 先确认 PowerShell 和终端环境没拖后腿在动手清理之前先排除一个低级但常见的干扰项PowerShell 执行策略。Trae 在 Windows 下调用工具链时很多脚本是通过 PowerShell 跑的。如果执行策略被设成Restricted脚本根本跑不起来表现也可能是「工作环境启动失败」。打开 PowerShell建议用管理员身份先看当前策略Get-ExecutionPolicy -List你会看到类似这样的输出分作用域列出策略Scope ExecutionPolicy ----- --------------- MachinePolicy Undefined UserPolicy Undefined Process Undefined CurrentUser Undefined LocalMachine Restricted如果LocalMachine或CurrentUser是Restricted把它改成RemoteSigned这是微软推荐的开发机策略本地脚本可跑远程脚本需签名Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser改完再确认一次Get-ExecutionPolicy -Scope CurrentUser返回RemoteSigned就对了。这一步不是万能药但能排掉一类「脚本被拦」的假性故障。顺手再检查磁盘和内存Toolhost 启动至少需要 2G 磁盘空间和 1G 可用内存Get-PSDrive C | Select-Object Used,Free Get-CimInstance Win32_OperatingSystem | Select-Object {nFreeMemGB;e{[math]::Round($_.FreePhysicalMemory/1MB,2)}}Free低于 2GB 或FreeMemGB低于 1先清盘再说否则后面清理 job 文件也是白搭。3. 定位并清理拖慢启动的 job 目录这是整个排查的核心。先别急着删先数一数到底堆了多少$jobPath $env:LOCALAPPDATA\Temp\trae-agent-toolhost\jobs if (Test-Path $jobPath) { $count (Get-ChildItem -Path $jobPath -Directory | Measure-Object).Count Write-Host job 目录数量: $count } else { Write-Host 目录不存在可能路径变了 }我第一次跑的时候输出是job 目录数量: 7493。7493 个目录一个月内正常使用根本不可能产生这么多这明显是清理逻辑有 bug 或者任务异常重试导致的堆积。Toolhost 启动时挨个读这些目录不超时才怪。确认数量后直接整个目录删掉。注意这个目录是临时工作区删掉不影响你的项目代码Trae 下次启动会重建Remove-Item -Path $env:LOCALAPPDATA\Temp\trae-agent-toolhost -Recurse -Force -ErrorAction SilentlyContinue如果目录太大Remove-Item卡住不动几千个目录时很常见用robocopy的空目录镜像法速度会快很多$empty $env:TEMP\empty_folder New-Item -ItemType Directory -Path $empty -Force | Out-Null robocopy $empty $env:LOCALAPPDATA\Temp\trae-agent-toolhost /MIR /NFL /NDL /NJH /NJS /NC /NS Remove-Item -Path $env:LOCALAPPDATA\Temp\trae-agent-toolhost -Recurse -Force -ErrorAction SilentlyContinue Remove-Item -Path $empty -Recurse -Force -ErrorAction SilentlyContinuerobocopy /MIR会把目标目录镜像成空目录等于清空比逐个删文件快得多。删完再跑一次第 3 步的计数命令确认返回 0 或目录不存在。注意清理前确保 Trae 已经完全退出。任务管理器里搜TRAE把所有相关进程结束掉再操作否则文件被占用删不干净。4. 清理 work-mode 缓存并配置 settings.json 骨架job 目录清完后如果问题还在再清一层 work-mode 项目缓存Remove-Item -Path $env:APPDATA\TRAE SOLO CN\ModularData\ai-agent\work-mode-projects -Recurse -Force -ErrorAction SilentlyContinue这层缓存清掉后Work 模式的项目状态会重新初始化下次启动任务会慢一点但能排掉缓存损坏导致的启动失败。接下来是配置骨架。如果你打算把 Trae 接到统一的 API 通道比如 TaoToken避免每个模型单独配 Key可以在 Trae 的 settings.json 里做统一接入。先找到配置文件位置通常在%APPDATA%\TRAE SOLO CN\User\settings.json用 PowerShell 打开它notepad $env:APPDATA\TRAE SOLO CN\User\settings.json一个可用的接入骨架大概长这样重点是baseUrl指向统一通道apiKey用你在 TaoToken 控制台生成的 Key{ trae.modelProvider: { baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, defaultModel: claude-sonnet-4-20250514, timeout: 60000, retry: { maxAttempts: 3, backoffMs: 2000 } }, trae.workMode: { toolhostTimeoutMs: 120000, cleanupJobsOnStart: true } }几个参数说明一下。baseUrl填https://taotoken.net/api这是统一 API 入口不加任何多余路径。timeout给 60 秒Work 任务链路长太短容易误判超时。toolhostTimeoutMs我调到 120 秒给 Toolhost 启动留足余量避免历史文件多时又踩超时。cleanupJobsOnStart设成true让 Trae 每次启动时自动清理旧 job从根上防止再次堆积。提示Key 不要硬编码在会提交到 Git 的文件里。settings.json 是本机配置一般不进版本库但养成用环境变量引用的习惯更好。5. 验证请求确认报错真的消失了配置改完重启 Trae然后跑一个最小验证任务。别一上来就跑复杂任务先用一个简单请求确认通道通了。在 Trae 的对话里输入帮我列出当前目录下的文件并告诉我系统是睡眠还是关机状态这个任务会触发 Work 模式启动 Toolhost。观察两个地方一是任务是否正常返回结果不再弹「工作环境启动失败」二是任务管理器里TRAE SOLO CN相关进程是否正常拉起。如果想更直接地验证 API 通道可以用 PowerShell 发一个请求到 TaoToken 的模型对话接口$headers { Authorization Bearer sk-你的TaoToken密钥 Content-Type application/json } $body { model claude-sonnet-4-20250514 messages ( { role user; content 回复 OK 两个字母即可 } ) } | ConvertTo-Json -Depth 5 Invoke-RestMethod -Uri https://taotoken.net/api/v1/chat/completions -Method Post -Headers $headers -Body $body返回里能看到choices字段和模型回复内容就说明 Key 和通道都正常。这一步过了再回 Trae 里跑 Work 任务基本不会再报启动失败。成功的结果长这样任务正常执行日志里不再出现Timeout waiting for toolhost to be ready%LOCALAPPDATA%\Temp\trae-agent-toolhost\jobs目录保持干净因为开了自动清理。6. 本篇常见错排查报错依旧job 目录又涨回来了。说明cleanupJobsOnStart没生效或者 Trae 版本不支持这个配置项。手动加一个计划任务每天清理一次$action New-ScheduledTaskAction -Execute powershell.exe -Argument -Command Remove-Item -Path $env:LOCALAPPDATA\Temp\trae-agent-toolhost -Recurse -Force -ErrorAction SilentlyContinue $trigger New-ScheduledTaskTrigger -Daily -At 3am Register-ScheduledTask -TaskName CleanTraeToolhost -Action $action -Trigger $trigger -RunLevel HighestPowerShell 报「无法加载文件因为在此系统上禁止运行脚本」。回到第 2 步把执行策略改成RemoteSigned。如果公司组策略锁死了MachinePolicySet-ExecutionPolicy会失败这时候只能找 IT 放开或者改用-Scope Process临时绕过Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope ProcessAPI 请求返回 401。Key 错了或者过期了。去 TaoToken 控制台的 API Keys 页面重新生成一个注意复制时别带空格。请求头格式是Bearer sk-xxxBearer和 Key 之间一个空格。API 请求返回 404。baseUrl路径写错了。统一入口就是https://taotoken.net/api后面接/v1/chat/completions别自己拼多余的路径段。Trae 里配置改了但没生效。settings.json 改完必须完全重启 Trae不是关窗口是任务管理器里确认进程全退出再启动。改配置不重启等于没改。清理命令跑一半卡死。几千个目录时Remove-Item会卡换第 3 步的robocopy /MIR方案。如果 robocopy 也慢先把目录改名再后台删Rename-Item -Path $env:LOCALAPPDATA\Temp\trae-agent-toolhost -NewName toolhost_old_$(Get-Date -Format yyyyMMddHHmm)改名是瞬间完成的Trae 下次启动会建新目录旧目录你抽空慢慢删。7. 长期编码任务怎么接得更稳如果你只是偶尔跑个 Work 任务上面清理加配置就够了。但如果你打算用 Trae 做长期编码、跑 Agent 任务反复手动清理不是办法得从接入层做统一管理。TaoToken 的 Coding Plan 就是为这种场景准备的把模型调用统一到一个通道Key 集中管理换模型不用改代码。接入文档里有完整的配置示例从环境变量到各编辑器的 settings 骨架都有。我自己的做法是Trae 的 settings.json 里baseUrl固定指向https://taotoken.net/apiKey 用环境变量注入这样换机器、换项目都不用重新配。具体操作路径先去控制台生成一个长期 Key然后在 Trae 里按第 4 步的骨架填进去。跑通之后Work 任务的模型调用就走统一通道了配合cleanupJobsOnStart自动清理基本不会再遇到「工作环境启动失败」这种启动期报错。最后留个实用习惯每次 Trae 大版本更新后跑一次第 3 步的 job 计数命令。如果数字又开始异常增长说明清理逻辑又出问题了提前手动清一次别等它堆到几千个再报错。这个报错的本质是「启动超时」而超时的根源是「历史文件堆积」抓住这条线排查就不会跑偏。
1. Trae 工作环境启动失败到底卡在哪如果你在 Windows 上用 Trae 跑 Work 任务突然弹出「工作环境启动失败请重试」大概率不是你的系统版本太低也不是网络断了而是 Trae 的 Toolhost 沙箱环境启动超时了。这个报错完整长这样Toolhost startup failed: VM start failed: Timeout waiting for toolhost to be ready; fallback also failed。翻译成人话就是Trae 想给你的任务开一个隔离的执行环境结果等了好久没等到它准备好连降级方案不走 VM 沙箱直接启动也一起超时了。这个报错最迷惑的地方在于官方排查页给的建议是「检查 Windows 系统版本低于 19044 就升级到 Win10 21H2 以上」。但很多人明明是 Windows 11版本号早就超了照样报错。我实测下来真正的原因往往藏在另一个地方%LOCALAPPDATA%\Temp\trae-agent-toolhost\jobs\这个目录里堆积了大量历史 job 文件。Toolhost 启动时要逐个读取这些文件几百上千个还好一旦堆到几千个启动时间就被拖到超时阈值之外于是报错。这篇文章适合三类人一是刚遇到这个报错、搜到官方文档但没解决的 Windows 用户二是想搞清楚 Trae 工作环境机制、避免反复踩坑的开发者三是打算把 Trae 接到统一 API 通道比如 TaoToken做长期编码任务的人。我会从 PowerShell 执行策略检查开始一路讲到 settings.json 骨架配置和 TaoToken 接入每一步都给可复制的命令和验证动作。2. 先确认 PowerShell 和终端环境没拖后腿在动手清理之前先排除一个低级但常见的干扰项PowerShell 执行策略。Trae 在 Windows 下调用工具链时很多脚本是通过 PowerShell 跑的。如果执行策略被设成Restricted脚本根本跑不起来表现也可能是「工作环境启动失败」。打开 PowerShell建议用管理员身份先看当前策略Get-ExecutionPolicy -List你会看到类似这样的输出分作用域列出策略Scope ExecutionPolicy ----- --------------- MachinePolicy Undefined UserPolicy Undefined Process Undefined CurrentUser Undefined LocalMachine Restricted如果LocalMachine或CurrentUser是Restricted把它改成RemoteSigned这是微软推荐的开发机策略本地脚本可跑远程脚本需签名Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser改完再确认一次Get-ExecutionPolicy -Scope CurrentUser返回RemoteSigned就对了。这一步不是万能药但能排掉一类「脚本被拦」的假性故障。顺手再检查磁盘和内存Toolhost 启动至少需要 2G 磁盘空间和 1G 可用内存Get-PSDrive C | Select-Object Used,Free Get-CimInstance Win32_OperatingSystem | Select-Object {nFreeMemGB;e{[math]::Round($_.FreePhysicalMemory/1MB,2)}}Free低于 2GB 或FreeMemGB低于 1先清盘再说否则后面清理 job 文件也是白搭。3. 定位并清理拖慢启动的 job 目录这是整个排查的核心。先别急着删先数一数到底堆了多少$jobPath $env:LOCALAPPDATA\Temp\trae-agent-toolhost\jobs if (Test-Path $jobPath) { $count (Get-ChildItem -Path $jobPath -Directory | Measure-Object).Count Write-Host job 目录数量: $count } else { Write-Host 目录不存在可能路径变了 }我第一次跑的时候输出是job 目录数量: 7493。7493 个目录一个月内正常使用根本不可能产生这么多这明显是清理逻辑有 bug 或者任务异常重试导致的堆积。Toolhost 启动时挨个读这些目录不超时才怪。确认数量后直接整个目录删掉。注意这个目录是临时工作区删掉不影响你的项目代码Trae 下次启动会重建Remove-Item -Path $env:LOCALAPPDATA\Temp\trae-agent-toolhost -Recurse -Force -ErrorAction SilentlyContinue如果目录太大Remove-Item卡住不动几千个目录时很常见用robocopy的空目录镜像法速度会快很多$empty $env:TEMP\empty_folder New-Item -ItemType Directory -Path $empty -Force | Out-Null robocopy $empty $env:LOCALAPPDATA\Temp\trae-agent-toolhost /MIR /NFL /NDL /NJH /NJS /NC /NS Remove-Item -Path $env:LOCALAPPDATA\Temp\trae-agent-toolhost -Recurse -Force -ErrorAction SilentlyContinue Remove-Item -Path $empty -Recurse -Force -ErrorAction SilentlyContinuerobocopy /MIR会把目标目录镜像成空目录等于清空比逐个删文件快得多。删完再跑一次第 3 步的计数命令确认返回 0 或目录不存在。注意清理前确保 Trae 已经完全退出。任务管理器里搜TRAE把所有相关进程结束掉再操作否则文件被占用删不干净。4. 清理 work-mode 缓存并配置 settings.json 骨架job 目录清完后如果问题还在再清一层 work-mode 项目缓存Remove-Item -Path $env:APPDATA\TRAE SOLO CN\ModularData\ai-agent\work-mode-projects -Recurse -Force -ErrorAction SilentlyContinue这层缓存清掉后Work 模式的项目状态会重新初始化下次启动任务会慢一点但能排掉缓存损坏导致的启动失败。接下来是配置骨架。如果你打算把 Trae 接到统一的 API 通道比如 TaoToken避免每个模型单独配 Key可以在 Trae 的 settings.json 里做统一接入。先找到配置文件位置通常在%APPDATA%\TRAE SOLO CN\User\settings.json用 PowerShell 打开它notepad $env:APPDATA\TRAE SOLO CN\User\settings.json一个可用的接入骨架大概长这样重点是baseUrl指向统一通道apiKey用你在 TaoToken 控制台生成的 Key{ trae.modelProvider: { baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, defaultModel: claude-sonnet-4-20250514, timeout: 60000, retry: { maxAttempts: 3, backoffMs: 2000 } }, trae.workMode: { toolhostTimeoutMs: 120000, cleanupJobsOnStart: true } }几个参数说明一下。baseUrl填https://taotoken.net/api这是统一 API 入口不加任何多余路径。timeout给 60 秒Work 任务链路长太短容易误判超时。toolhostTimeoutMs我调到 120 秒给 Toolhost 启动留足余量避免历史文件多时又踩超时。cleanupJobsOnStart设成true让 Trae 每次启动时自动清理旧 job从根上防止再次堆积。提示Key 不要硬编码在会提交到 Git 的文件里。settings.json 是本机配置一般不进版本库但养成用环境变量引用的习惯更好。5. 验证请求确认报错真的消失了配置改完重启 Trae然后跑一个最小验证任务。别一上来就跑复杂任务先用一个简单请求确认通道通了。在 Trae 的对话里输入帮我列出当前目录下的文件并告诉我系统是睡眠还是关机状态这个任务会触发 Work 模式启动 Toolhost。观察两个地方一是任务是否正常返回结果不再弹「工作环境启动失败」二是任务管理器里TRAE SOLO CN相关进程是否正常拉起。如果想更直接地验证 API 通道可以用 PowerShell 发一个请求到 TaoToken 的模型对话接口$headers { Authorization Bearer sk-你的TaoToken密钥 Content-Type application/json } $body { model claude-sonnet-4-20250514 messages ( { role user; content 回复 OK 两个字母即可 } ) } | ConvertTo-Json -Depth 5 Invoke-RestMethod -Uri https://taotoken.net/api/v1/chat/completions -Method Post -Headers $headers -Body $body返回里能看到choices字段和模型回复内容就说明 Key 和通道都正常。这一步过了再回 Trae 里跑 Work 任务基本不会再报启动失败。成功的结果长这样任务正常执行日志里不再出现Timeout waiting for toolhost to be ready%LOCALAPPDATA%\Temp\trae-agent-toolhost\jobs目录保持干净因为开了自动清理。6. 本篇常见错排查报错依旧job 目录又涨回来了。说明cleanupJobsOnStart没生效或者 Trae 版本不支持这个配置项。手动加一个计划任务每天清理一次$action New-ScheduledTaskAction -Execute powershell.exe -Argument -Command Remove-Item -Path $env:LOCALAPPDATA\Temp\trae-agent-toolhost -Recurse -Force -ErrorAction SilentlyContinue $trigger New-ScheduledTaskTrigger -Daily -At 3am Register-ScheduledTask -TaskName CleanTraeToolhost -Action $action -Trigger $trigger -RunLevel HighestPowerShell 报「无法加载文件因为在此系统上禁止运行脚本」。回到第 2 步把执行策略改成RemoteSigned。如果公司组策略锁死了MachinePolicySet-ExecutionPolicy会失败这时候只能找 IT 放开或者改用-Scope Process临时绕过Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope ProcessAPI 请求返回 401。Key 错了或者过期了。去 TaoToken 控制台的 API Keys 页面重新生成一个注意复制时别带空格。请求头格式是Bearer sk-xxxBearer和 Key 之间一个空格。API 请求返回 404。baseUrl路径写错了。统一入口就是https://taotoken.net/api后面接/v1/chat/completions别自己拼多余的路径段。Trae 里配置改了但没生效。settings.json 改完必须完全重启 Trae不是关窗口是任务管理器里确认进程全退出再启动。改配置不重启等于没改。清理命令跑一半卡死。几千个目录时Remove-Item会卡换第 3 步的robocopy /MIR方案。如果 robocopy 也慢先把目录改名再后台删Rename-Item -Path $env:LOCALAPPDATA\Temp\trae-agent-toolhost -NewName toolhost_old_$(Get-Date -Format yyyyMMddHHmm)改名是瞬间完成的Trae 下次启动会建新目录旧目录你抽空慢慢删。7. 长期编码任务怎么接得更稳如果你只是偶尔跑个 Work 任务上面清理加配置就够了。但如果你打算用 Trae 做长期编码、跑 Agent 任务反复手动清理不是办法得从接入层做统一管理。TaoToken 的 Coding Plan 就是为这种场景准备的把模型调用统一到一个通道Key 集中管理换模型不用改代码。接入文档里有完整的配置示例从环境变量到各编辑器的 settings 骨架都有。我自己的做法是Trae 的 settings.json 里baseUrl固定指向https://taotoken.net/apiKey 用环境变量注入这样换机器、换项目都不用重新配。具体操作路径先去控制台生成一个长期 Key然后在 Trae 里按第 4 步的骨架填进去。跑通之后Work 任务的模型调用就走统一通道了配合cleanupJobsOnStart自动清理基本不会再遇到「工作环境启动失败」这种启动期报错。最后留个实用习惯每次 Trae 大版本更新后跑一次第 3 步的 job 计数命令。如果数字又开始异常增长说明清理逻辑又出问题了提前手动清一次别等它堆到几千个再报错。这个报错的本质是「启动超时」而超时的根源是「历史文件堆积」抓住这条线排查就不会跑偏。
