coipond/coi

解决的问题

Coi 为运行 AI 编码代理（如 Claude Code 或 Codex）提供了一个安全、隔离的环境，而不会危及主机。它防止代理访问敏感凭证、SSH 密钥和环境变量，同时允许它们在受控的 Linux 容器内拥有完整的 root 权限和系统级功能。

运作原理

Coi 使用 Incus 系统容器来建立一个轻量级、完整的操作系统环境，其行为类似于虚拟机，但可在几秒钟内启动。它将项目目录挂载到容器中，同时确保主机上的文件所有权保持正确。为了保护主机，它实现了内核级监控，以在检测到反向 Shell 或数据外泄等威胁时自动暂停或终止容器，并使用 nftables 进行网络出口控制。

适用对象

• 希望 AI 编码代理拥有完整机器访问权限（root、Docker、包管理器）但又不损害主机安全性的开发者。
• 需要为同一个项目并行运行多个隔离代理的用户。
• 希望通过配置文件共享标准化、持久化开发环境的团队。

特点

• 系统级隔离：使用 Incus 提供一个完整的操作系统，在沙盒内支持 root 和原生 Docker。
• 主动防御：实时内核级监控，根据威胁严重程度自动暂停或终止会话。
• 凭证保护：默认排除主机 SSH 密钥和 Token，除非明确转发。
• 可重复使用的配置文件：针对镜像、资源限制和网络模式的命名设置，可通过单一标志应用。
• 代码防护栏：针对 git hooks 和 IDE 配置文件的只读挂载，防止代理修改供应链设置。
• 无头编排：能够为 CI/CD 或 cron 作业运行提示直到完成，并提供用于安全取证的 JSONL 审计日志。