finbarr/yolobox

解决的问题

AI 编码代理通常需要高权限才能发挥作用，但直接授予它们对主机的访问权限可能导致意外的数据丢失（例如运行 rm -rf ~）。yolobox 提供了一个安全的沙箱环境，允许 AI 代理在拥有完整权限的同时，不会危及用户的主目录。

工作原理

该工具在容器内运行 AI 代理。它将特定项目目录以真实路径挂载到容器中，但除非明确请求，否则会将主目录隔离。它提供持久化卷，以在会话之间保持工具和配置，并包含针对 Claude Code、Codex 和 Kimi Code 等代理的内置指导，使它们能够理解自己的沙箱环境。为进一步增强安全性，用户可以限制网络访问、环境变量和项目目录权限。

适用人群

使用 AI 编码代理（如 Claude Code、Codex、Gemini 和 Copilot）并希望允许这些代理自主执行命令和安装软件，同时不危及主系统文件的开发者。

主要亮点

• 隔离执行：保护主机主目录免受 AI 生成的破坏性命令的影响。
• 预装工具：开箱即用包含 Node.js、Python、Go、Bun、Git 和各种构建工具。
• 代理专用快捷命令：提供专用命令启动流行的 AI CLI（例如 yolobox claude、yolobox codex）。
• 项目自定义：支持 .yolobox.toml 文件，用于项目特定的环境变量和包安装。
• 灵活的安全选项：可选择禁用网络访问或以只读方式挂载项目目录。