opencode 吃掉 100G 空间:Agent 会话数据要分级清理

磁盘少了上百 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 直接看目录体积。看完数字,对照上面的分级清单,决定第一刀落在哪里。

相关推荐
学无止境小袁同学17 分钟前
OpenAI Agents SDK 模板操作手册(可直接操作)
大模型·openai·agent·sdk·大模型应用
用户58333398166818 分钟前
RPA 流程的异常处理设计:重试、降级与告警,生产环境实战指南
人工智能
ZzT1 小时前
约 90% 代码由 Claude 写和审,Claude Code 团队如何做验证
ai编程·claude
一切皆有可能!!1 小时前
【SoduWork测评】本机跑源码,找到并修了7个Bug
windows·开源·bug·ai编程·soduwork
sanxing三省1 小时前
DeepSeek Harness 到底是什么?标题里最重的词其实不是「DeepSeek」
前端·人工智能·deepseek
jianqiang.xue1 小时前
把Agent塞进MCU:工具次数和上下文长度怎么卡
java·前端·网络·单片机·esp32·ai编程
莪_幻尘1 小时前
AI 编程的下一场战争,不在模型,在协议
agent·ai编程·mcp
合尘猫2 小时前
用 6GB 显卡搭短视频产线:MiniMax H3 + ffmpeg 全流程实录(55 秒片 / 40 分钟)
人工智能·音视频
mengrennwpu2 小时前
Kynvio: 新一代办公助手
llm·agent