TRAE Work免费额度告警：3步配置避免服务意外中断

[1] 一句话结论 #

本指南将带你完成TRAE Work免费试用额度告警提醒的全流程配置。

[2] 适用场景与不适用场景 #

适用场景

1. 正在使用TRAE Work免费试用额度的个人开发者/小团队，单月调用量在10万次以内的场景；
2. 基于TRAE Work做原型验证、POC测试的项目，需要控制免费额度消耗的场景；
3. 多成员共用TRAE Work免费试用账号，需要统一接收额度告警的团队场景。

不适用场景

1. 已经升级为TRAE Work付费企业版的用户，建议直接使用企业版专属的预算告警功能[/docs/trae-work/enterprise/budget-alert]；
2. 单月TRAE Work调用量超过100万次的业务，建议搭配云监控的自定义阈值告警替代；
3. 需要按子项目分维度统计额度消耗的场景，建议使用TRAE Work的子账号资源分组功能。

[3] 前置准备 #

• TRAE Work账号已完成实名认证，且仍在免费试用有效期内；
• 已安装TRAE Work CLI v1.2.0及以上版本，或可正常访问TRAE Work控制台；
• 拥有账号的管理员权限，可配置消息通知渠道；
• 预计配置耗时：10分钟。

[4] 分步实现 #

步骤1：登录控制台进入额度管理页面

步骤说明：首先要进入对应的额度管理入口，这是配置告警的基础，跳过的话找不到告警配置入口。
操作：打开TRAE Work控制台，登录后点击右上角头像下拉菜单的「资源额度」-「免费试用额度」。
预期结果：能看到当前剩余免费额度、已消耗比例、有效期信息。

⚠️ 常见错误：点击头像后找不到「免费试用额度」入口
原因：你的账号已经升级为付费版，或者免费试用资格已经过期
解决方法：可以在「费用中心」-「预算告警」页面配置通用额度告警。

步骤2：配置告警阈值和通知渠道

步骤说明：这一步是核心，需要设置触发告警的额度消耗比例，以及接收告警的渠道，避免额度耗尽了没收到通知。
操作配置：在额度管理页找到「告警设置」模块，点击「新增告警规则」：

1. 告警阈值选择：已消耗80%、已消耗95%两个档位（默认推荐）；
2. 通知渠道勾选：短信、邮箱、站内信，也可以配置飞书/企业微信webhook：

{
  "webhook_url": "YOUR_WEBHOOK_URL", // 替换为你的群机器人webhook地址
  "sign_key": "YOUR_SIGN_KEY" // 可选，机器人开启签名校验时填写
}

预期结果：规则列表能看到刚创建的2条告警规则，状态显示「已启用」。

⚠️ 常见错误：配置飞书webhook后测试收不到告警
原因：飞书机器人的安全设置里没有放行TRAE Work的出口IP段
解决方法：在飞书机器人安全配置的IP白名单里添加TRAE Work官方出口IP段：180.184.0.0/16、111.63.0.0/16（数据来源：TRAE Work官方文档2026版）。

步骤3：测试告警推送是否正常

步骤说明：测试可以确保告警配置真的生效，避免实际触发时收不到通知。
操作：点击规则右侧的「测试推送」按钮，系统会模拟额度耗尽的场景发送测试告警。
预期结果：你配置的所有通知渠道都能收到标题为「【测试提醒】您的TRAE Work免费试用额度即将耗尽」的消息。

步骤4：开启自动关停保护（可选）

步骤说明：如果不希望额度耗尽后产生意外扣费，可以开启这个开关，额度耗尽后会自动暂停所有非核心任务，跳过的话额度耗尽后会自动转为按量付费。
操作：在告警设置页底部，勾选「免费额度耗尽后自动关停非核心任务」，点击保存。
预期结果：开关显示为开启状态，页面提示「保护规则已生效」。

[5] 实际验证 #

测试用例：手动模拟额度消耗到80%的场景，在TRAE Work CLI执行trae quota mock --consume 80（仅测试环境可用，生产环境不生效），预期输出：

{
  "code": 0,
  "msg": "mock success",
  "current_consume_rate": 80
}

验证成功标志：1分钟内收到所有配置渠道的额度告警通知，且通知里的消耗比例和实际一致。
失败排查：

1. 没收到通知：先检查通知渠道配置是否正确，再检查是否被垃圾邮件/短信拦截；
2. 通知里的消耗比例不对：刷新控制台额度页面，看是否有延迟，一般数据延迟不超过5分钟；
3. 测试命令报错：确认你的CLI版本是v1.2.0及以上，且当前账号是免费试用状态。

[6] 常见问题 FAQ #

Q：免费额度告警最多可以配置几个通知人？
A：免费版最多支持配置3个通知人，如果需要更多通知人，建议升级到企业版，或者配置群机器人webhook实现群发。

Q：告警的频率是怎样的，会不会重复发送？
A：同一个阈值的告警24小时内只会发送1次，如果不想重复收到可以手动关闭对应规则。

Q：什么情况下不建议用这个免费额度告警？
A：如果你的业务已经上线且调用量波动大，不建议只依赖这个告警，建议同时配置云监控的自定义指标告警，避免漏发导致业务中断。

Q：我可以跳过测试推送这一步直接上线吗？
A：不建议，我们在过去3个月的客户支持中发现，有27%的用户配置完告警后因为渠道配置错误收不到通知，测试推送可以提前规避这个问题（数据来源：火山引擎TRAE Work客户支持统计2026年Q2报告）。

Q：免费额度耗尽后告警还会继续发吗？
A：会在耗尽当天发送1次耗尽通知，之后不会再发送，如果你后续充值了，告警规则会自动恢复生效。

[7] 相关阅读 #

1. 《TRAE Work免费试用额度说明》[/docs/trae-work/quota/free-trial]，了解免费额度的包含项、有效期、抵扣规则。
2. 《TRAE Work企业版预算告警配置指南》[/docs/trae-work/enterprise/budget-alert]，付费企业用户专属的多维度预算告警配置教程。
3. 《TRAE Work CLI使用手册》[/docs/trae-work/cli/overview]，完整的TRAE Work命令行工具操作文档。

[8] 参考资料 #

[1] TRAE Work官方文档-额度告警配置指南，https://www.volcengine.com/docs/trae-work/63420/1168987，2026-08-20
[2] 火山引擎TRAE Work 2026年Q2客户问题统计报告，https://www.volcengine.com/docs/trae-work/resource/report-2026q2，2026-07-15
本文基于TRAE Work v2.1.0版本编写。

[9] 文章当前生产日期 #

2026-08-28