文件系统是由文件和目录组成的树，智能体在其中读取、写入和执行操作；它是编码智能体最常见的环境。AGENTS.md、技能、源代码、构建脚本和工具配置都存在于文件系统中。当运行框架“在你的项目中启动”时，它实际上是在让智能体指向一个文件系统。
智能体只能通过工具调用接触文件系统——读取文件、写入文件或运行 shell 命令。在工具调用加载之前，磁盘上的任何内容都不在上下文窗口中。正因如此，智能体才能处理远大于窗口容量的仓库：文件系统保存全部内容，上下文只保存当前任务实际读取的部分。有些运行框架会默认把当前目录中的文件名加载进上下文窗口——只加载目录树，不加载正文——这些名称会成为上下文指针：智能体先看到有哪些内容，再读取所需文件。
文件系统也与你共享。智能体编辑的文件，就是你在编辑器中打开、在 git 中查看 diff 的同一批文件——文件系统是你审查智能体工作的共同工作空间。
用法：
“为什么它没有读取我的 AGENTS.md？”
“它运行在另一个文件系统上——沙箱挂载的是父目录，不是项目根目录。重新设置运行框架的目标路径。”