磁盘少了上百 G,很多人第一反应是去查模型缓存、查 IDE 插件,翻到最后才发现,元凶是那个天天在用的 Coding Agent。热点帖《opencode 的"恶果"来了,吃掉 100G 空间》里,作者就是被自己的 Agent 工具悄悄占满了硬盘。这篇文章拆开 Agent 工具的本地数据目录,说清空间都花在哪、哪些能删、哪些删了会后悔,最后给一条今天就能跑的排查命令。
会话数据是最大的一块,而且它不是缓存
Coding Agent 吃空间的主体,是按项目全量落盘的会话数据,而不是通常意义上的缓存。
机制要从工作方式说起:Agent 必须把每一轮对话、每一次工具调用的输入输出都记下来。你想恢复一个会话继续改代码,靠的就是这些持久化记录;工具要在长会话里重建上下文,同样依赖它们。所以这类数据的设计目标是完整、可回放,而不是用完就扔。它不像浏览器缓存有上限、有淘汰策略,只要你一直用,它就一直涨。
落地场景(示意):一个开发者用 Agent 做大型重构,一个会话跑几十轮,每轮都带着测试输出、文件 diff 和报错日志,单个会话累计几百 MB 属于常见量级。如果同时在多个仓库里开 Agent,每个仓库各存各的,空间是乘法关系。
边界:轻度使用、会话用完即弃,或者很少回看历史的用户,累积速度没有这么夸张,不必恐慌。
第二块是 provider 缓存,删了会自动重建
真正的缓存部分反而是安全可删的,删掉的代价只是重新下载。
机制:像 opencode 这类工具为了适配各家模型 API 的参数差异,会按需动态安装 provider 包并缓存在本地(Linux/macOS 默认在 ~/.cache/opencode)。缓存损坏或过期,就表现为调用报错、模型参数不兼容。官方排查文档里就有清掉这个缓存、重启工具重新拉取这一步。
落地场景:你换了新模型,Agent 突然报 ProviderInitError 一类的初始化错误,按文档清掉 ~/.cache/opencode 再重启,工具会重新下载最新版本的 provider 包。这个目录占的空间可以放心回收,唯一成本是下一次请求慢一点。
边界:清缓存解决的是报错问题,不解决会话数据堆积的空间问题,两件事别混着治。
删除要分级:哪些能删,哪些千万别碰
对待 Agent 的本地数据,正确姿势是按目录分级处置,而不是找到目录一键全删。
机制:以 opencode 为例,数据目录 ~/.local/share/opencode/ 下至少有三类东西:auth.json 存着 API Key 和登录凭证,删了就掉登录态;project/ 存着会话和消息数据,删了历史会话就找不回来;log/ 默认只保留最近 10 个日志文件,本身有自洁机制。同类工具的设计大同小异,核心都是凭证、会话、缓存三层。
落地场景:给你一份分级清单(示意,动手前先对照所用工具的文档)。日志目录里超过保留期的旧日志可删;缓存目录可整体清空;会话数据先按项目归档导出,确认不再需要回看再删;凭证文件一律不动。用 du 逐个目录看体积再决定动哪一个,永远比全删稳妥。
边界:如果会话历史本身就是团队资产------用来做复盘、交接,或者给后来的 Agent 当上下文------删之前必须先导出,否则丢的是工作记录,不只是磁盘空间。
空间问题的本质,是会话即资产的代价
Agent 工具吃空间不是设计失误,而是「会话即资产」这个产品选择的必然代价:它替你记住每一步,就得把每一步写进硬盘。你要管理的不是让它别存,而是分级、定期、有备份地处置。
今天就能验证的动作:在终端跑这条命令,看看你机器上的 Agent 到底占了多少:
bash
du -sh ~/.local/share/opencode/* ~/.cache/opencode 2>/dev/null | sort -h
Windows 用户在资源管理器地址栏粘贴 %USERPROFILE%.local\share\opencode 直接看目录体积。看完数字,对照上面的分级清单,决定第一刀落在哪里。