Fence 将命令包裹在一个沙箱中，默认情况下会阻止网络访问，并根据可配置的规则限制文件系统操作。它最适合用于运行半可信代码（如包安装、构建脚本、CI 任务、不熟悉的代码仓库），以控制其副作用，同时也可以作为深度防御手段来补充 AI 编码助手。

# 阻止所有网络访问（默认）
fence curl https://example.com  # → 403 Forbidden

# 允许特定域名
fence -t code npm install  # → 使用 'code' 模板，允许 npm/pypi 等

# 阻止危险命令
fence -c "rm -rf /"  # → 被命令拒绝规则拦截

你也可以将 Fence 视为 CLI 助手的权限管理器。Fence 可以与流行的编码助手一起使用，例如 Claude Code、Codex、Amp、Gemini CLI、Cursor Agent、OpenCode、Factory (Droid) CLI 等。 更多信息请参阅 agents.md。

安装

macOS / Linux:

curl -fsSL https://cli.fencesandbox.com/install.sh | sh

Homebrew (macOS):

brew tap use-tusk/tap
brew install use-tusk/tap/fence

Nix (macOS、Linux、Windows (WSL)):

nix run nixpkgs#fence -- --help

这会直接从仓库运行，而无需安装 fence。如果你想安装它，请遵循 NixOS 或 nix-darwin 的指南。

go install github.com/Use-Tusk/fence/cmd/fence@latest

git clone https://github.com/Use-Tusk/fence
cd fence
go build -o fence ./cmd/fence

Linux 的额外要求：

• bubblewrap（用于沙箱）
• socat（用于网络桥接）
• bpftrace（可选，用于在使用 -m 监控时查看文件系统违规情况）

使用

基本用法

# 运行命令时完全阻止网络访问（默认不允许任何域名）
fence curl https://example.com

# 启用 shell 展开
fence -c "echo hello && ls"

# 开启调试日志
fence -d curl https://example.com

# 使用模板
fence -t code -- claude  # 使用 `code` 模板配置运行 Claude Code

# 监控模式（显示违规行为）
fence -m npm install

# 检查配置继承链和当前生效的合并配置
fence config show

# 显示所有命令和选项
fence --help

[!TIP] 如果需要向你要运行的命令传递参数，可以使用 -- 来分隔 Fence 的参数和命令的参数，例如：

fence -- claude --dangerously-skip-permissions

配置

当未提供 --settings 时，Fence 会首先在当前目录及其父目录中查找 fence.json 文件。如果未找到，则回退到 ~/.config/fence/fence.json。更多详细信息请参阅 配置参考。

{
  "$schema": "https://raw.githubusercontent.com/Use-Tusk/fence/main/docs/schema/fence.schema.json",
  "extends": "code",
  "network": { "allowedDomains": ["private.company.com"] },
  "filesystem": { "allowWrite": ["."] },
  "command": { "deny": ["git push", "npm publish"] }
}

对于每个用户常规 Fence 配置之上的仓库本地覆盖，可以使用：

{
  "extends": "@base",
  "filesystem": { "allowWrite": ["."] }
}

使用 fence --settings ./custom.json 可以指定不同的配置。

在不运行命令的情况下检查当前生效的配置：

fence config show
fence config show --settings ./custom.json
fence config show --template code

fence config show 会将配置链打印到 stderr，并将完全解析后的配置以纯 JSON 格式输出到 stdout，因此你可以将 JSON 管道到诸如 jq 之类的工具中。

创建一个带有合理默认值的初始配置：

# 在默认路径创建配置，内容为：
# { "extends": "code" }
fence config init

# 包含可编辑的提示性支架数组
fence config init --scaffold

从 Claude Code 导入

fence import --claude --save

特性

• 网络隔离 - 默认阻止所有出站连接；可通过配置允许特定域名
• 文件系统限制 - 控制读写访问路径
• 命令阻断 - 拒绝危险命令，如 rm -rf /、git push
• SSH 命令过滤 - 控制通过 SSH 允许访问的主机和执行的命令
• 内置模板 - 针对常见工作流的预配置规则集
• 违规监控 - 实时记录被拦截的请求（-m）
• 跨平台 - macOS（sandbox-exec）+ Linux（bubblewrap）

Fence 可以作为 Go 包或 CLI 工具使用。

文档

• 索引
• 快速入门指南
• 配置参考
• 安全模型
• 架构
• 库使用（Go）
• 示例

致谢

灵感来源于 Anthropic 的 sandbox-runtime。

Fence 快速上手指南

Fence 是一个命令行沙盒工具，默认阻断网络访问并根据可配置规则限制文件系统操作。它非常适合运行半信任代码（如包安装、构建脚本、CI 任务或不熟悉的仓库），也可作为 AI 编程助手（如 Claude Code、Cursor Agent 等）的防御层，防止意外副作用。

环境准备

系统要求

• macOS: 支持 sandbox-exec
• Linux: 需要以下依赖项
• Windows: 仅支持通过 WSL (Windows Subsystem for Linux) 使用

前置依赖 (Linux 用户必读)

在 Linux 上运行 Fence 前，请确保已安装以下工具：

• bubblewrap: 用于实现沙盒隔离
• socat: 用于网络桥接
• bpftrace (可选): 当使用 -m 监控模式时，用于可视化文件系统违规行为

提示: 大多数现代 Linux 发行版可通过包管理器安装，例如 Ubuntu/Debian:

sudo apt-get install bubblewrap socat bpftrace

安装步骤

请选择适合你系统的安装方式：

方式一：一键脚本 (推荐 macOS / Linux)

curl -fsSL https://cli.fencesandbox.com/install.sh | sh

方式二：Homebrew (macOS)

brew tap use-tusk/tap
brew install use-tusk/tap/fence

方式三：Nix (macOS, Linux, Windows WSL)

直接运行（无需安装）：

nix run nixpkgs#fence -- --help

若需永久安装，请参考 NixOS 或 nix-darwin 官方文档。

方式四：Go 安装

go install github.com/Use-Tusk/fence/cmd/fence@latest

基本使用

1. 默认阻断网络

运行命令时，默认禁止所有出站网络连接：

fence curl https://example.com  # 结果：403 Forbidden

2. 使用预设模板

Fence 内置了常用场景的模板。例如，使用 code 模板允许 npm/pypi 等包管理器的必要域名：

fence -t code npm install

结合 AI 助手使用（以 Claude Code 为例）：

fence -t code -- claude

3. 阻断危险命令

自动拦截配置中禁止的高危命令：

fence -c "rm -rf /"  # 结果：被命令拒绝规则拦截

4. 监控模式

实时查看被拦截的网络或文件系统请求：

fence -m npm install

5. 传递参数给子命令

如果需要向被执行的命令传递参数，请使用 -- 进行分隔：

fence -- claude --dangerously-skip-permissions

6. 配置管理

查看当前生效的配置（合并后的结果）：

fence config show

初始化一个包含合理默认的配置文件：

fence config init

注意: Fence 会优先查找当前目录及父目录下的 fence.json，若未找到则使用 ~/.config/fence/fence.json。