LuD1161/agentjail

这是什么？

核心功能

• 01在执行前用 OPA Rego 策略检查每一次智能体工具调用
• 02返回允许、询问或拒绝的决策并附带说明
• 03通过 `agentjail run` 添加操作系统沙箱限制文件系统访问
• 04默认拒绝的网络白名单，并可选开启流量可见性
• 05凭据代理仅向会话交付明确选择的密钥
• 06本地回放界面、终端面板与费用统计

适用场景

• 防止编码智能体执行强制推送或递归删除等破坏性命令
• 避免 .env 文件或云凭据被误读并进入智能体上下文
• 限制会话中智能体可以向哪些主机发送数据
• 通过会话回放复盘智能体做了什么以及为何被允许或拒绝

快速上手

1. 1

   先通过可信包管理器安装 minisign（macOS）

   brew install minisign
2. 2

   通过 Homebrew 安装 AgentJail

   brew install LuD1161/tap/agentjail
3. 3

   检查保护状态

   agentjail doctor
4. 4

   通过 AgentJail 启动你的智能体并启用操作系统沙箱

   agentjail run -- codex

使用前须知

• !仅支持 macOS 和 Linux。
• !仅靠钩子只是协作式检查，并非文件系统隔离边界；操作系统沙箱需要通过 agentjail run 启动。
• !部分保护依赖守护进程可用以及平台沙箱的覆盖范围。

收录于专题

标签

常见问题

agentjail 是什么？

为 Claude Code、Codex、Cursor 等编码智能体提供本地策略护栏，在工具调用执行前完成检查。 AgentJail 是为 Claude Code、Codex、Cursor 等编码智能体设计的安全护栏。安装后，它会向各个受支持的智能体注册 hook，使每次工具调用（包括 shell 命令、文件读写和 MCP 调用）在执行前都经过 OPA（Open Policy Agent）Rego 规则检查，结果为允许、询问或拒绝。本地常驻守护进程配合决策缓存，检查开销很小。

agentjail 可以免费使用吗？用的什么许可证？

agentjail 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

agentjail 还在维护吗？

半年内有更新。agentjail 最近一次提交是在 2026年9月24日。

agentjail 适合用来做什么？

防止编码智能体执行强制推送或递归删除等破坏性命令 避免 .env 文件或云凭据被误读并进入智能体上下文 限制会话中智能体可以向哪些主机发送数据 通过会话回放复盘智能体做了什么以及为何被允许或拒绝

agentjail 怎么安装和运行？

先通过可信包管理器安装 minisign（macOS）: brew install minisign 通过 Homebrew 安装 AgentJail: brew install LuD1161/tap/agentjail 检查保护状态: agentjail doctor 通过 AgentJail 启动你的智能体并启用操作系统沙箱: agentjail run -- codex

在哪里获取 agentjail？

源代码和安装说明在 GitHub 上：https://github.com/LuD1161/agentjail