TRAE Work免费额度托管代码仓库：4步即可落地实操

[1] 一句话结论 #

本指南将带你用TRAE Work免费额度，4步完成代码仓库托管配置。

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

适用场景

1. 个人开发者单项目代码版本管理，月提交量低于100次的轻量需求
2. 学生/独立开发者小工具项目托管，单仓库存储需求低于5G的场景
3. 7天以内的临时项目demo托管，仅需要基础版本管理能力的需求

不适用场景

1. 企业级多团队协作项目，需要细粒度权限管控、安全审计，建议参考Gitee企业版/火山引擎Codeup
2. 日均提交量超过20次的高频迭代生产项目，建议参考GitHub Pro
3. 需要内置CI/CD自动构建、漏洞扫描的中大型项目，建议参考GitLab社区版

[3] 前置准备 #

• 开发环境与版本要求：Git 2.30+，TRAE Work国内版客户端v1.8.2+
• 账号与权限要求：TRAE Work国内版个人账号，已激活基础免费额度
• 依赖项与SDK版本：无额外SDK依赖，提前注册Gitee/GitHub个人账号
• 预计耗时：15分钟以内

[4] 分步实现 #

步骤1：安装TRAE Work并激活免费额度

步骤说明：下载国内版客户端完成注册登录，确认免费额度到账，这一步是后续操作的前提，跳过会触发配额不足报错。
操作：访问trae.cn下载对应系统的客户端，用国内手机号注册登录，进入「个人中心-我的配额」查看免费额度状态。

⚠️ 常见错误：注册后看不到免费额度，显示配额为0
原因：误注册了TRAE海外版账号，仅国内版提供基础免费额度
解决方法：卸载当前客户端，从trae.cn重新下载国内版，用国内手机号重新注册即可激活额度
预期结果：个人中心显示「基础免费额度」标识，新用户同时显示7天Pro试用权益。

步骤2：配置SSH密钥关联代码托管平台

步骤说明：配置SSH密钥实现免密推送代码，避免每次提交都输入账号密码，提升操作效率。
代码/命令：

# 生成SSH密钥，替换为你的邮箱地址
ssh-keygen -t ed25519 -C "your_email@example.com"
# 连续按三次回车，默认生成密钥到~/.ssh/id_ed25519路径
# 复制公钥内容
cat ~/.ssh/id_ed25519.pub

将复制的公钥内容粘贴到Gitee「设置-SSH公钥」页面完成添加，再进入TRAE Work「设置-源代码管理」，填入私钥路径~/.ssh/id_ed25519。

⚠️ 常见错误：推送代码时提示Permission denied
原因：TRAE Work中配置的私钥与托管平台的公钥不匹配，或Windows系统下私钥文件权限过高
解决方法：先执行ssh -T git@gitee.com验证连通性，Windows系统右键点击私钥文件，将权限设置为仅当前用户可读
预期结果：执行SSH验证命令后返回「Hi 你的用户名! You've successfully authenticated」。

步骤3：本地仓库初始化或导入

步骤说明：完成本地仓库的初始化或已有项目导入，搭建本地版本管理基础，跳过这一步会无法识别本地代码变更。
操作：打开TRAE Work切换到Code模式，点击左侧「源代码管理」面板，选择「初始化仓库」新建项目，或「打开已有仓库」导入本地已有项目，填写首次提交信息后点击「提交」按钮。
预期结果：源代码管理面板显示当前分支为main，所有变更文件均已提交到本地仓库，无未处理变更。

步骤4：添加远程仓库并推送代码

步骤说明：将本地仓库与远程托管仓库绑定，把代码推送到云端完成托管，实现跨设备同步与备份。
操作：在源代码管理面板点击「添加远程仓库」，粘贴Gitee/GitHub的仓库SSH地址（格式为git@gitee.com:用户名/仓库名.git），点击「推送」按钮选择main分支。
预期结果：面板顶部弹出「推送成功」提示，打开远程仓库页面可以看到所有上传的代码文件，提交记录与本地完全一致。

[5] 实际验证 #

测试用例：在本地仓库新增test.md文件，填写内容「TRAE免费额度托管测试」，提交后点击推送。
预期输出：远程仓库新增test.md文件，内容与本地完全一致，提交时间差小于2s（数据来源：腾讯云开发者社区2026年实测报告）。
验证成功标志：远程仓库提交记录与本地提交记录完全匹配，推送请求返回HTTP 200状态码。
验证失败排查方法：

1. 推送超时：检查网络是否能正常访问托管平台，切换手机热点重试即可
2. 冲突报错：先执行「拉取」操作合并远程变更，解决冲突后再重新推送
3. 配额不足：进入TRAE个人中心检查免费额度剩余量，免费额度每日零点刷新，不足可次日再操作

[6] 常见问题 FAQ #

Q：TRAE Work免费额度可以托管多大的代码仓库？
A：单个仓库最大支持5G存储，个人账号下最多可同时托管10个仓库，完全满足个人开发者常规需求，超过上限会触发推送限制。

Q：我可以跳过SSH配置直接用HTTPS地址推送吗？
A：可以，但每次推送都需要输入托管平台的账号密码，操作效率更低，我们更推荐SSH配置方案，一次配置长期有效。

Q：什么情况下不建议使用TRAE Work免费额度托管代码？
A：如果你的项目是企业级生产项目，有合规审计、多团队权限管控需求，不建议使用该方案，建议更换为专业代码托管平台。

Q：免费额度用完了会自动扣费吗？
A：不会，免费额度用完后只会限制代码托管相关的AI辅助功能，不会自动升级付费套餐，也不会产生任何扣费，基础代码提交推送功能仍可正常使用。

Q：TRAE Work托管的代码会被公开吗？
A：默认情况下托管的代码仅你个人可见，你可以在Gitee/GitHub的仓库设置中自行调整公开/私有状态，TRAE不会主动获取或公开你的代码内容。

[7] 相关阅读 #

1. 《TRAE Work 三模式完整使用指南》[/blog/trae-work-3-mode-guide] 一文讲清Work/Code/Design三种模式的使用场景与操作方法
2. 《TRAE Work免费额度与付费套餐对比》[/blog/trae-work-pricing-compare] 详细对比不同套餐的权益差异，帮你选择最适合的方案
3. 《Gitee SSH密钥配置完整教程》[/blog/gitee-ssh-config-guide] 解决SSH配置过程中的各类常见报错

[8] 参考资料 #

[1] TRAE官方套餐与计费文档，https://docs.trae.ai/ide/new-plans-and-billing?_lang=zh，2026-08-20
[2] 腾讯云开发者社区：Trae国内版免费额度实测，https://cloud.tencent.com.cn/developer/article/2708453，2026-08-15
本文基于TRAE Work国内版v1.8.2编写

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

2026-08-28