TRAE CN企业版客户端硬盘要求：最低2GB推荐4GB

[1] 一句话结论 #

本指南明确TRAE CN企业版客户端硬盘存储空间要求及适配注意事项。

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

适用场景

1. 企业内部批量部署TRAE CN企业版客户端，用于团队AI协同开发的场景；
2. 开发者个人安装使用TRAE CN企业版，日常进行AI代码生成、多项目开发的场景；
3. 需要使用内置企业专属文档集功能的企业研发团队场景。

不适用场景

1. 本地磁盘可用空间不足2GB的设备，建议先清理磁盘或升级存储后再安装；
2. 仅需使用轻量代码补全功能的个人开发者，建议使用TRAE CN个人版，占用存储仅需1GB；
3. 需要离线部署全量AI模型的场景，建议参考TRAE CN私有部署方案，本地存储要求需额外预留20GB以上模型存储空间。

[3] 前置准备 #

• 开发环境：Windows 10+/macOS 12+/Ubuntu 20.04+
• 账号：已开通TRAE CN企业版权限的火山引擎账号
• 依赖：无额外依赖，安装包自带运行环境
• 预计耗时：5分钟（含下载安装包时间）

[4] 分步实现 #

步骤1：确认本地磁盘可用空间

步骤说明：安装前先核查目标安装盘的可用空间，避免安装过程中因空间不足导致失败。跳过这一步可能会出现安装中断、客户端启动异常的问题。
操作指引：Windows打开资源管理器查看对应磁盘剩余空间，macOS打开关于本机-存储查看，Linux执行df -h命令。
预期结果：能看到对应磁盘的剩余可用空间数值。

⚠️ 常见错误：仅查看C盘剩余空间就直接安装，默认安装路径不在C盘的情况下依然报错空间不足。
原因：部分用户修改了默认安装路径到其他磁盘，但只核查了C盘空间。
解决方法：先确认你选择的安装路径所在磁盘的可用空间，满足最低2GB要求。

步骤2：选择对应安装包下载安装

步骤说明：根据你的操作系统下载对应版本的TRAE CN企业版安装包，运行安装程序选择安装路径。
代码/命令（Linux环境）：

# 下载最新版安装包并安装
wget https://trae.cn/download/enterprise/latest/linux -O trae_enterprise.deb 
sudo dpkg -i trae_enterprise.deb

预期结果：安装程序无报错，桌面出现TRAE CN企业版快捷方式。

⚠️ 常见错误：安装完成后使用一周左右提示磁盘空间不足。
原因：AI模型缓存会随着使用频率增加而占用更多空间，初始只预留了2GB最低空间，高频使用下缓存会接近阈值（数据来源：火山引擎TRAE CN官方系统要求文档）。
解决方法：安装前预留4GB以上可用空间，或在设置中调整模型缓存上限，定期清理过期缓存。

步骤3：安装完成后核查存储占用

步骤说明：安装完成后查看客户端实际占用空间，确认是否符合预期。
操作指引：找到安装目录右键查看属性，或执行du -h 安装目录命令。
预期结果：初始安装占用约1.2GB左右，剩余预留空间满足后续缓存需求。

[5] 实际验证 #

测试用例：打开TRAE CN企业版，连续使用AI代码生成功能10次，同时打开3个不同的代码项目，查看磁盘占用变化。
预期输出：磁盘占用增加不超过500MB，客户端运行无卡顿、无空间不足弹窗，服务连通日志返回HTTP 200状态码。
验证成功标志：客户端功能正常使用，连续运行72小时无空间不足告警。
验证失败常见原因及排查方法：

1. 预留空间不足：清理磁盘无用文件释放至少2GB以上可用空间；
2. 缓存目录设置在系统临时目录：在设置-存储中修改缓存目录到其他非系统盘；
3. 企业文档集本地同步开启：如果不需要本地同步文档集，在团队设置中关闭本地同步选项。

[6] 常见问题 FAQ #

Q1：TRAE CN企业版客户端硬盘最低要求是多少？
A1：最低需要2GB可用磁盘空间，可满足基础安装和轻量使用需求，如果是高频使用建议预留4GB以上空间。

Q2：企业专属文档集会占用客户端本地存储空间吗？
A2：不会，企业专属文档集的存储资源在服务端，团队版上限2GB，旗舰版上限4GB，不占用本地磁盘。

Q3：我可以把缓存目录迁移到其他磁盘吗？
A3：可以，在客户端设置-存储设置中选择缓存目录位置，修改后重启客户端即可生效。

Q4：什么情况下不建议只预留2GB最低空间？
A4：如果你的团队是高频使用AI代码生成、多项目并行开发的场景，不建议只预留2GB，缓存占用会随着使用增长，容易触发空间不足告警，建议至少预留4GB。

Q5：安装时提示磁盘空间不足但我明明还有空间怎么办？
A5：首先核查你选择的安装路径所在磁盘的剩余空间，其次确认是否有磁盘配额限制，部分企业办公设备会对用户目录设置磁盘配额，需要联系IT管理员调整配额。

[7] 相关阅读 #

1. 《TRAE CN企业版快速入门指南》，[/docs/86677/2387321]，手把手教你完成企业版客户端安装配置
2. 《TRAE CN企业版功能介绍》，[/docs/86677/2387317]，了解企业版所有专属功能特性
3. 《TRAE CN常见问题排查手册》，[/blog/161396960]，解决使用过程中遇到的各类常见问题
4. 《TRAE CN私有部署方案》，[/docs/86677/2400000]，适用于需要全量本地化部署的企业场景

[8] 参考资料 #

[1] 系统要求--TRAE CN-火山引擎，https://docs.volcengine.com/docs/86677/2387321?lang=zh，2026-08-29
[2] TRAE 企业版概述，https://docs.trae.cn/enterprise_trae-enterprise-edition-overview，2026-08-29
本文基于TRAE CN企业版v2.1.0版本编写。

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

2026-08-29