TRAE智能体任务执行日志查看全指南：4端通用操作步骤
[1] 一句话结论
本指南将教你在4个不同场景下快速查看TRAE智能体的任务执行日志。
[2] 适用场景与不适用场景
适用场景
- 适合需要排查TRAE智能体任务执行失败原因、单次调用错误的开发者
- 适合需要导出日志提交工单、申请技术支持的TRAE企业版用户
- 适合需要回溯历史任务执行细节、做性能优化的团队管理员
不适用场景
- 如果你的场景是需要做全量日志的长期存储与分析，建议使用火山引擎日志服务CLS
- 如果你的场景是需要实时监控智能体的运行指标与告警，建议使用TRAE企业版自带的观测面板
- 如果你的场景是需要查看第三方集成工具的调用日志，建议直接去对应工具的后台查询
[3] 前置准备
- 已安装TRAE IDE v1.2.0+ / TRAE VS Code插件v2.1.0+ / TRAE Work手机端v3.0.0+
- 已登录对应TRAE账号，且拥有目标智能体的查看权限
- 若需要导出日志，预留至少100MB的本地存储空间
- 预计操作耗时：1-3分钟
[4] 分步实现
步骤1：TRAE IDE端查看全量日志
步骤说明：IDE端的全量日志包含所有智能体的运行记录、调用链路、错误堆栈，适合我们排查本地调试时的异常问题，跳过这一步你无法获取到本地调试的完整链路信息。
操作：按下Ctrl/Command+Shift+P打开命令面板，输入"open all"搜索，选择「开发人员：Open All Logs Folder」即可自动打开日志目录。
预期结果：系统会自动打开本地日志文件夹，你可以看到按日期命名的.log格式日志文件。
⚠️ 常见错误：搜索后找不到「开发人员：Open All Logs Folder」选项
原因：你的TRAE IDE版本低于v1.2.0，该功能是2025年Q4版本新增的功能
解决方法：到TRAE官网下载最新版本的IDE，升级后重新操作即可
步骤2：插件端查看日志
步骤说明：VS Code/JetBrains插件端的日志只包含当前编辑器中智能体的执行记录，适合排查单个项目下的任务异常，不需要找全量日志的时候用这个方法更高效。
操作：VS Code端按下Ctrl/Command+Shift+P，JetBrains端双击shift，输入"TRAE AI: 打开日志并复制用户信息"选择对应选项；也可直接访问目录：macOS/Linux为~/.marscode/logs，Windows为%userprofile%.marscode\logs。
预期结果：打开后可以看到latest.log为最新的日志文件，同时用户信息会自动复制到剪贴板。
⚠️ 常见错误：访问本地目录找不到.marscode文件夹
原因：该文件夹默认是隐藏状态，你没有开启系统的隐藏文件显示功能
解决方法：macOS按下Command+Shift+.显示隐藏文件，Windows在文件管理器顶部勾选「隐藏的项目」选项即可
步骤3：TRAE Work手机端查看云端任务日志
步骤说明：手机端的日志是同步到云端的任务执行记录，适合你不在电脑旁时排查线上任务异常，不需要回到工位就可以快速定位问题。
操作：打开TRAE Work APP，点击底部「任务」图标，授予同步权限后找到目标任务，进入详情页滚动到底部点击「查看完整日志」即可。
预期结果：可以看到该任务完整的执行链路、入参出参、错误信息，支持长按复制内容。
步骤4：单个任务卡片查看指定命令日志
步骤说明：任务执行成功/失败后，直接在命令卡片查看单条命令的运行日志，适合快速排查单个命令的异常，不需要打开全量日志目录。
操作：在任务执行结果页，点击命令卡片右上角的终端按钮，即可直接查看该命令的运行日志。
预期结果：弹出终端窗口，显示该命令的实时运行输出、返回码、耗时等信息。
[5] 实际验证
你可以触发一个简单的智能体测试任务，比如让智能体写一个Hello World的Python脚本，然后按照上面的步骤查看日志。
验证成功的标志：日志中可以找到对应的任务ID，内容包含输入的prompt、智能体的执行步骤、最终输出的代码内容，且任务状态标记为success。
验证失败的常见排查方法：
- 看不到对应任务日志：检查是否登录了正确的TRAE账号，是否开启了任务同步权限
- 日志内容为空：任务还在执行中，或者任务触发失败没有生成日志，等待10秒后刷新重试
- 日志报错403无权限：你没有该智能体的查看权限，联系团队管理员开通权限即可。
[6] 常见问题 FAQ
Q1：日志最多可以保留多久？
A1：本地日志默认永久保留，只要你不手动删除就可以一直查看；云端免费版日志保留7天，企业版可以自定义保留时长，最长支持保留365天。【数据来源：火山引擎TRAE官方文档】
Q2：我可以把日志导出给技术支持吗？
A2：可以，你只需要在日志目录中打包对应日期的日志文件，或者在手机端长按复制完整日志内容，提交工单的时候附上即可，根据我们的经验这可以提升至少60%的问题排查效率。
Q3：什么情况下不建议用本地日志排查问题？
A3：如果是跨设备的云端任务执行异常，本地日志不会同步云端的运行记录，建议直接到TRAE Work网页端的观测面板查看全量云端日志。
Q4：日志里的敏感信息会被上传吗？
A4：本地日志只会存在你的设备中，不会自动上传；云端日志默认会对密钥、密码等敏感信息做脱敏处理，你也可以在设置中关闭日志同步功能。
Q5：我可以跳过IDE版本升级直接查看日志吗？
A5：不行，低于v1.2.0的IDE没有内置日志查看入口，你需要手动到系统临时目录查找日志，路径非常复杂，我们还是建议你升级到最新版本。
[7] 相关阅读
- 《TRAE智能体故障排查全指南》[/blog/7598410746695057435]：教你如何通过日志快速定位智能体的常见故障
- 《TRAE企业版观测面板使用教程》[/docs/86677/2335858]：介绍企业版全量日志存储、分析、告警的使用方法
- 《TRAE Agent日志分析指南》[/blog/582e45c6591f3ae601dc5a0066069d73]：教你如何从海量日志中提取关键信息，做性能优化
[8] 参考资料
[1] 火山引擎TRAE官方文档：获取日志或SessionID，https://www.volcengine.com/docs/86677/2335858?lang=zh，2026-08-28
[2] TRAE官方文档：TRAE Work移动版快速开始，https://docs.trae.cn/solo_get-started-with-trae-solo-mobile，2026-08-28
本文基于TRAE智能体API v2.3版本编写
[9] 文章当前生产日期
2026-08-28
