方舟Coding Plan：存储容量查询及用量记录导出实操指南

[1] 一句话结论 #

本指南将讲解方舟Coding Plan存储容量规则及用量记录导出的全流程操作

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

适用场景

1. 适合每月需要统计AI编码工具成本、对存储用量做对账的10人以下中小研发团队
2. 适合企业版管理员需要按成员维度核算研发资源消耗、做内部成本分摊的场景
3. 适合个人开发者需要清理本地缓存、释放磁盘空间、查询存储占用明细的场景

不适用场景

1. 如果你的场景是需要实时统计单代码仓库的存储占用，不建议用本方案，建议参考火山引擎代码托管CodeUp的用量统计功能
2. 如果需要导出超过180天的历史用量记录，不支持直接通过控制台导出，建议提交工单申请后台导出
3. 如果是需要统计非Coding Plan产生的IDE插件存储占用，本方案不适用，建议直接查看IDE本地存储目录明细

[3] 前置准备 #

• 开发环境：无特殊要求，仅需Chrome 100+版本浏览器即可访问控制台
• 账号权限：个人版需账号所有者权限，企业版需管理员或用量查看权限
• 依赖项：无需额外安装SDK，仅需登录火山引擎方舟控制台
• 预计耗时：5-10分钟即可完成全流程操作

[4] 分步实现 #

步骤1：登录控制台进入用量管理页面

步骤说明：首先登录火山引擎账号进入方舟Coding Plan对应管理页，这是所有操作的入口，跳过的话无法访问用量数据。个人版用户进入「开通管理」页面，企业版用户进入专属管理后台的「用量监控」板块。
预期结果：成功进入对应管理页面，页面展示当前账号的基础存储配额、已用容量等概览数据。

⚠️ 常见错误：登录后找不到Coding Plan的用量入口
原因：账号未开通Coding Plan服务，或者当前使用的子账号没有对应权限
解决方法：先确认主账号已开通服务，子账号需要主账号在访问控制IAM中授予CodingPlanFullAccess或者CodingPlanReadOnlyAccess权限

步骤2：筛选用量统计时间范围

步骤说明：根据你需要导出的时间范围选择对应维度，个人版支持5小时、周、月三个固定维度，企业版支持自定义30天内的任意时间段，筛选后可以先预览用量数据确保是你需要的内容，跳过筛选直接导出会得到默认最近7天的用量，可能不符合需求。
预期结果：页面展示对应时间范围内的存储用量明细，包括总容量、已用容量、剩余容量、缓存占用占比等数据。

⚠️ 常见错误：筛选时间范围后数据加载失败，显示“暂无数据”
原因：时间范围选择超过了数据留存上限（个人版数据留存90天，企业版180天），或者当前账号在所选时间段内没有使用记录
解决方法：缩小时间范围到数据留存期内，或者确认所选时间段内有Coding Plan的使用记录

步骤3：导出云端存储用量记录

步骤说明：确认预览的数据无误后点击导出按钮，个人版直接在「开通管理」页面点击导出，企业版在用量监控板块右上角点击导出报表，导出的文件是CSV格式，方便后续用Excel或数据分析工具处理。
预期结果：浏览器自动开始下载CSV文件，文件命名格式为“coding_plan_storage_usage_起止时间.csv”，文件大小根据数据量一般在10KB-1MB之间。

步骤4：（可选）导出本地缓存存储记录

步骤说明：如果需要查看本地IDE中Coding Plan插件的缓存占用记录，可以在IDE的Coding Plan设置-扩展页面找到存储日志目录，手动导出对应日志文件，适合需要清理本地缓存的场景。
代码/命令（以VS Code为例）：

# MacOS日志目录
cd ~/Library/Application Support/Code/User/globalStorage/volcengine.ark-coding-plan/logs
# Windows日志目录
cd C:\Users\{你的用户名}\AppData\Roaming\Code\User\globalStorage\volcengine.ark-coding-plan\logs

预期结果：找到对应目录下的storage_log.log文件，里面包含近30天的本地缓存生成、清理、占用明细。

[5] 实际验证 #

我们以个人版导出最近7天用量为例做验证：

• 测试用例：登录个人版控制台，选择「周」维度时间范围，点击导出按钮
• 预期输出：CSV文件包含日期、总存储容量10GB（数据来源：火山引擎方舟Coding Plan官方定价页[1]）、已用容量、缓存占用、剩余容量5个字段，总容量字段值固定为10GB（个人版默认配额）
• 验证成功标志：浏览器返回HTTP 200状态码，CSV文件字段完整，数据和控制台预览一致

验证失败常见排查方法：

1. 文件下载后为空：检查浏览器下载权限，或者换Chrome浏览器重试
2. 导出数据和预览不一致：刷新页面重新筛选时间范围后再次导出
3. 导出文件乱码：用WPS或Numbers打开，不要用系统自带的记事本打开，编码格式为UTF-8

[6] 常见问题 FAQ #

Q1：个人版的代码存储容量默认是多少？
A1：个人版默认的云端代码缓存存储容量是10GB，本地缓存容量无上限，取决于你的磁盘剩余空间，容量满了之后会自动清理最早7天的缓存数据，不会影响正常使用。

Q2：导出的用量记录最多支持多长时间的？
A2：个人版最多支持导出最近90天的用量，企业版最多支持导出最近180天的用量，超过这个时长的需要提交工单申请后台导出，导出时效一般为1-3个工作日。

Q3：什么情况下不建议直接在控制台导出用量记录？
A3：如果需要导出超过180天的历史用量，或者需要按代码项目维度拆分存储用量，不建议直接在控制台导出，建议提交工单申请定制化的用量报表。

Q4：我可以跳过筛选时间范围直接导出吗？
A4：可以，但默认导出的是最近7天的用量记录，如果你需要其他时间段的还是建议先筛选再导出，避免导出无效数据。

Q5：企业版可以按单个成员维度导出存储用量吗？
A5：可以，在企业版用量监控板块选择「按成员统计」维度，筛选对应成员后即可导出该成员的单独用量记录，适合团队内部成本核算。

[7] 相关阅读 #

• 《方舟Coding Plan高效使用技巧指南》[/article/37264] 包含缓存清理、配额调整等实用操作技巧
• 《方舟Coding Plan企业版管理后台操作指南》[/article/37391] 讲解企业版权限配置、成员管理等功能
• 《方舟Coding Plan常见问题与使用攻略》[/article/37932] 汇总了各类高频问题的解决方案

[8] 参考资料 #

[1] 火山引擎方舟Coding Plan官方定价与配额说明，https://www.volcengine.com/article/37883，2026-08-20
[2] 火山引擎方舟Coding Plan用量统计全指南，https://www.volcengine.com/article/37264，2026-08-15
本文基于方舟Coding Plan v2.4.0版本编写

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

2026-08-27