TRAE Work免费额度：可直接抵扣容器化部署消耗
[1] 一句话结论
本指南将明确TRAE Work免费额度是否支持容器化部署及相关使用规则
[2] 适用场景与不适用场景
适用场景
- 适合个人开发者每月容器化部署任务消耗低于500积分、并发任务不超过2个的开发测试场景
- 适合小团队做轻量CI/CD流水线集成、容器环境快速验证的协作场景
- 适合想体验TRAE Work容器化部署能力、无需长期高负载运行的试用场景
不适用场景
- 不适合日均容器化部署任务超过20次、月消耗超过500积分的生产级场景，建议升级TRAE Work付费专业版
- 不适合需要3个及以上并发容器任务执行的高负载场景，建议参考同类企业级CI/CD平台方案
- 不适合需要自定义底层容器镜像、专属计算资源的私有化部署场景，建议使用火山引擎容器服务
[3] 前置准备
- 已注册TRAE Work账号，完成实名认证，开通免费试用权限
- 本地开发环境安装TRAE Work CLI v1.2.0及以上版本，支持Python 3.9+/Node.js 18+
- 已获取个人API密钥，配置好本地CLI的权限认证
- 预计完成整个配置和验证流程耗时约15分钟
[4] 分步实现
步骤1：查询免费额度剩余量
步骤说明：首先要确认当前账号的免费积分剩余情况，避免执行容器任务时额度不足导致任务中断，跳过这一步可能出现任务执行到一半被强制终止的情况。
代码/命令：
trae account quota list # 输出中free_quota字段即为剩余免费积分，concurrent_task_limit为并发任务上限
预期结果：返回包含free_quota≥0、concurrent_task_limit=2的JSON格式结果。
⚠️ 常见错误：执行命令后返回403无权限错误
原因：本地CLI未配置正确的API密钥，或者账号未完成实名认证开通免费权益
解决方法：登录TRAE Work控制台进入「个人中心-API密钥」页面重新生成密钥，执行trae config set API_KEY=YOUR_API_KEY完成配置，确认账号已完成实名认证。
步骤2：编写容器化部署配置文件
步骤说明：需要按照TRAE Work的规范编写容器配置文件，定义镜像地址、资源配额、启动命令等参数，确保配置符合免费额度的资源限制，否则会无法使用免费额度抵扣。
代码/命令：
# trae-container.yaml version: v1 kind: ContainerTask spec: image: nginx:alpine # 替换为你的容器镜像地址 resources: cpu: 0.5 memory: 1G # 免费额度最高支持单任务1C2G资源配额 command: ["nginx", "-g", "daemon off;"] timeout: 3600 # 单任务最长执行1小时，超过会被自动终止
预期结果：配置文件语法校验通过，执行trae validate -f trae-container.yaml返回success。
⚠️ 常见错误：配置文件校验失败提示"resource quota exceed free limit"
原因：配置的CPU、内存资源超过免费额度的单任务资源上限，或者超时时间超过1小时
解决方法：调整CPU≤1核、内存≤2G，超时时间设置≤3600秒即可。
步骤3：提交容器任务使用免费额度抵扣
步骤说明：提交任务时默认优先使用免费额度抵扣，无需额外配置，确保任务并发数不超过2个即可。
代码/命令：
trae task run -f trae-container.yaml --use-free-quota # 加上--use-free-quota参数强制优先使用免费额度，避免误扣付费余额
预期结果：返回任务ID，状态为running，执行trae task logs [任务ID]可以看到容器启动日志。
[5] 实际验证
完整测试用例：提交一个nginx容器部署任务，配置0.5核1G内存，运行10分钟后停止。
- 输入：执行
trae task run -f trae-container.yaml --use-free-quota，等待任务执行完成。 - 预期输出：任务状态显示
success，执行trae account quota list查看免费积分减少对应消耗值（本次测试约消耗0.2积分，数据来源：TRAE官方定价页https://www.trae.cn/pricing）。
验证成功标志：API返回HTTP 200状态码，任务详情中quota_deduct_type字段为"free"，代表已使用免费额度抵扣。
验证失败常见排查方向：
- 若
quota_deduct_type为"paid"：检查是否提交了超过2个并发任务，或者配置的资源超过免费额度限制 - 若任务状态为
failed：查看任务日志，确认容器镜像是否可公网访问，启动命令是否正确 - 若返回额度不足错误：查看免费积分剩余量，若不足可以等待下个月免费额度重置，或者升级付费版
[6] 常见问题 FAQ
Q1：TRAE Work免费额度每月有多少，会清零吗？
A1：免费方案每月提供500积分，当月未使用完的额度会在次月1日清零，不可累积，数据来源TRAE官方定价文档。
Q2：容器化部署的积分消耗怎么计算？
A2：按容器实际运行的CPU、内存资源和时长计算，1核1G运行1小时约消耗0.4积分，500积分大约可以运行1核1G容器1250小时。
Q3：什么情况下不建议使用免费额度做容器化部署？
A3：如果你的容器任务需要长期24小时运行，或者并发数超过2个，不建议使用免费额度，免费额度只适合开发测试场景，生产场景建议升级专业版。
Q4：我可以跳过配置文件校验步骤直接提交任务吗？
A4：不可以，跳过校验可能出现配置不符合免费额度规则的情况，导致无法使用免费额度抵扣，甚至任务直接被拒绝执行。
Q5：免费额度支持私有镜像仓库的容器部署吗？
A5：支持，只需要在配置文件中添加私有镜像仓库的认证信息即可，不会额外消耗积分。
[7] 相关阅读
- TRAE Work CLI使用完整指南 [/docs/trae-work/cli-guide] 包含所有CLI命令的参数说明、使用示例和常见问题排查
- TRAE Work容器化部署最佳实践 [/blog/trae-work-container-best-practice] 覆盖从开发测试到生产的容器部署全流程优化方案
- TRAE Work定价与计费规则详解 [/docs/trae-work/pricing] 详细介绍免费额度、付费版的计费规则和权益差异
- 火山引擎容器服务与TRAE Work集成方案 [/docs/veec/integration/trae-work] 适合需要大规模容器部署的场景的集成方案
[8] 参考资料
[1] TRAE 个人方案与定价，https://www.trae.cn/pricing，2026-08-28
[2] Trae Agent容器化部署：终结环境依赖噩梦的开发效率引擎，https://blog.gitcode.com/f7a78a904770017147608972f8de006f.html，2026-08-28
[3] 本文基于TRAE Work v2.1.0版本编写
[9] 文章当前生产日期
2026-08-28
