Brig

技能简介

Brig 是由 NOFire AI 团队开发的开源 microVM 沙箱工具（Apache 2.0 协议），专为在本地 Mac 和 Linux 机器上安全运行 AI 编程 Agent 而设计。与传统容器不同，Brig 在硬件虚拟化层面为每个 Agent 分配独立的 Linux 访机内核，通过 CPU 架构级别的内存和进程边界隔离，将 AI Agent 的所有操作严格限制在可审计的虚拟环境内——即使 Agent 执行恶意操作或被敌意提示词诱导，也无法穿透硬件级隔离边界触及宿主系统的敏感资源。

核心能力

• 硬件级 microVM 隔离：每个沙箱拥有独立的 Linux 内核，内存和进程边界由底层 CPU 架构强制执行，Agent 代码在虚拟化层面与宿主机完全隔离。
• 支持主流 AI 编程 Agent：开箱即用提供 Claude Code、Codex、Cursor、Gemini、Grok、opencode 等常用 Agent 的预设配置文件，一行命令即可启动针对特定 Agent 优化过的沙箱环境。
• 极小信任边界：microVM 核心代码量控制在 20,000 行以内，任何安全研究人员均可独立审计，无需信任闭源组件。
• 跨平台支持：macOS Apple Silicon 原生使用苹果 Virtualization.framework；Linux 支持 x86_64 和 ARM 架构，可选 nerdctl/containerd+urunc 技术栈或传统 runc。
• OCI 镜像兼容：除预设配置文件外，也支持使用任意 OCI 镜像（如 Ubuntu）启动自定义沙箱环境。
• 零成本开源：所有组件均为 Apache 2.0 许可证，软件本身免费使用，无商业授权费用。

安装配置

方式一：官方安装脚本（推荐）

curl -fsSL https://brig.sh/install | sh

方式二：macOS Apple Silicon

安装后 Brig 调用 hull microVM runtime，通过苹果 Virtualization.framework 启动虚拟机。需确保系统版本支持该框架。官方发布的构建版本已签名、 notarize 并 staple，可直接使用。

方式三：Linux

默认依赖 nerdctl 和 containerd 并配合 urunc shim，使沙箱以 microVM 形式运行而非普通容器。也可切换为 runc 模式获得标准容器体验。

验证安装

brig --version

使用步骤

第一步：选择 Agent 配置文件

brig run claude

这将使用 Claude Code 专用配置文件启动一个 ephemeral microVM。

第二步：进入沙箱环境

Brig 启动后会建立工作目录 ~/brig/claude-code，所有 Agent 的文件操作都在此目录内进行，宿主机其他路径对沙箱内进程不可见。

第三步：可选——使用自定义 OCI 镜像

brig run --image ubuntu:22.04

第四步：可选——镜像签名验证（推荐）

cosign verify ... 

在启动镜像前验证其签名，确保未被篡改。

第五步：使用 Agent 工作

在沙箱内正常启动你的 Agent 工具，Brig 会自动将所有文件操作、网络请求和命令执行限制在 microVM 边界内。

适用场景

• 开启 auto-approval 后安全运行 Agent：AI Agent 在无人工确认的情况下执行代码修改、依赖安装等操作时，Brig 确保即使执行了恶意代码也只在沙箱内生效。
• 防范供应链攻击：从 PyPI、npm 等包管理器安装来历不明的包时，沙箱将恶意代码的影响范围限制在虚拟机内，防止其访问真实用户目录和凭据。
• 团队共享开发机：在多人共用一台开发机的场景下，用 Brig 为不同成员或项目创建独立沙箱，环境之间互不干扰、无信息泄露风险。
• 安全测试未知代码：对来源不明的开源项目或演示代码进行试用时，Brig 提供安全的执行边界，避免意外损害宿主机系统。

适用人群

个人开发者、在团队开发环境中使用 AI 编程 Agent 的工程师，以及对软件供应链安全有严格要求的企业的安全团队。

工作原理

Brig 的隔离核心依赖两个技术层：Linux user namespace（提供进程、挂载、网络、IPC、cgroup 的命名空间隔离，且无需 root 权限）和可选 gVisor 用户态内核（在传统 namespace 之上额外增加一层内核级边界，防止程序直接调用宿主机内核系统调用）。在 macOS 上，Brig 通过苹果 Virtualization.framework 实现硬件虚拟化隔离，整个过程对用户透明，不需要手动配置任何虚拟化基础设施。

官方链接

• 官网：https://brig.sh
• GitHub：https://github.com/brig-sh/brig
• 安全模型文档：https://github.com/brig-sh/brig/blob/main/docs/security.md