failproofai

给AI编码代理装安全气囊,防死循环防泄密

failproofai 是一个面向 AI 编码代理的运行时故障解决方案库,通过钩子(hooks)机制集成到 Claude Code、Codex、Cursor 等主流编码代理工具中。它能在代理执行过程中实时监控,捕捉死循环、危险操作(如删除文件、执行高风险命令)和密钥泄露等潜在问题,在它们变成事故之前进行拦截和告警。项目以零延迟、本地运行为设计目标,不依赖云端服务,保障数据隐私。它解决了 AI 编码代理在自主执行时缺乏安全护栏、容易陷入无限循环或误操作的问题,为开发者提供了一层轻量级的安全保障。核心能力包括:事件钩子拦截、策略规则配置、实时告警与干预,以及跨多个代理框架的兼容性。当前项目处于早期阶段,但已获得一定关注。

开源 unknown 智能体
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 5137
维护状态 活跃
是否开源 是
定价模式 unknown

项目数据

分类智能体
开发团队FailproofAI
所属国家
定价模式unknown
价格说明定价信息待确认
访问状态
是否开源是
开源协议NOASSERTION
主要语言MDX
技术栈/模型agent-failure,agent-harness,agent-observability,agent-reliability,agent-tracing,ai-agent,claude-code,codex,enforcement,evals,guardrails,hermes,hooks,llm,llm-failures,llm-observability,npm-package,observability,openclaw,reliability
GitHub 星标★ 5137
30天Star增速
HF 下载量
上线时间2026-04-06 00:00:00
最近更新2026-09-23 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数2

使用教程

难度:入门 约 10 分钟 部署方式:命令行工具 4 步

环境要求

  • 已安装 npm(Node.js 环境,可执行全局安装)
  • 终端可访问 npm 全局包目录(必要时用 sudo 或管理员权限)
  • 本地可访问 localhost:8020 端口用于打开仪表盘

安装与启动步骤

  1. 1全局安装 CLI

    用 npm 全局安装 failproofai 命令行工具,安装完成后即可在终端直接调用 failproofai 命令。

    npm install -g failproofai
  2. 2安装内置策略

    执行策略安装命令,一次性启用 39 条内置策略规则;也可以跳过此步,直接运行 failproofai 并在首次运行提示中确认。

    failproofai policies --install
  3. 3启动 failproofai

    运行主命令启动本地服务,开始对已接入的编码代理进行实时监控与拦截;如需免交互可先设置环境变量。

    failproofai
  4. 4打开仪表盘

    服务启动后在本机浏览器访问仪表盘,查看代理运行记录与被拦截的危险工具调用。

关键配置

配置项必填说明示例
FAILPROOFAI_NO_FIRST_RUN否设为 1 可关闭首次运行提示,适合脚本化或自动化环境FAILPROOFAI_NO_FIRST_RUN=1
仪表盘端口否本地仪表盘默认监听端口,服务启动后访问该地址localhost:8020

如何确认成功

执行 failproofai 后进程正常驻留,浏览器打开 localhost:8020 能看到仪表盘,即表示启动成功。

常见问题

Q:每次启动都弹出首次运行提示,怎么关掉?

A:设置环境变量 FAILPROOFAI_NO_FIRST_RUN=1 后再次运行 failproofai,即可跳过首次运行提示。

Q:不想手动装策略可以吗?

A:可以。直接运行 failproofai,在首次运行提示中接受安装,效果等同于执行 failproofai policies --install。

Q:仪表盘在哪里看?

A:服务启动后,在浏览器访问 localhost:8020 即可打开本地仪表盘。

Q:需要联网或上传数据到云端吗?

A:不需要,failproofai 以本地运行、零延迟为设计目标,不依赖云端服务。

注意事项

  • 项目当前处于早期开发阶段,接口与行为可能变化。
  • README 提到可钩住 12 种代理 harness,包括 Claude Code、Codex、Hermes、OpenClaw 等,覆盖编码 CLI 与聊天/助手网关两类。
  • 内置 39 条策略,安装后立即生效。
  • 仪表盘默认地址为 localhost:8020,仅本机可访问。

核心亮点

  • 零延迟本地运行,不引入额外网络开销,保护代码隐私
  • 支持 Claude Code、Codex、Cursor 等多个主流代理,覆盖面广
  • 针对死循环、危险操作、密钥泄露等高频事故场景精准拦截

不足之处

  • 早期项目,文档和社区生态待观察
  • 策略规则配置可能需要学习成本,上手门槛未知

适用场景

  • 使用 Claude Code 或 Codex 进行自动化编码时,防止代理陷入死循环或执行危险命令
  • 团队内共享编码代理,需要统一安全策略,防止密钥或敏感信息泄露
  • 在 CI/CD 流水线中集成编码代理,需要额外的运行时安全监控层

替代项目

Claude Code Hooks、Codex Safety Harness、AgentGuard

项目介绍

failproofai 是智能体领域的开源项目,由 FailproofAI 开发,是 2026 年新上线的项目。

在全站 13,090 个收录项目中,它的 GitHub 星标数(5,137)位列前 9%,在智能体分类的 2,517 个项目里位列前 9%。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-23。从国内网络环境看,可直接访问。

它主要面向的使用场景是:使用ClaudeCode或Codex进行自动化编码时,防止代理陷入死循环或执行危险命令。同类可对比的替代方案包括 Claude Code Hooks、Codex Safety Harness、AgentGuard。

上一篇:local-ci

下一篇:youclaw

同类项目推荐

xinchao-dynamic-mind 开源

给 AI 装上疲惫和欲望,让交互更真实

独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。

★ 199 2026-08-09
deepseek-harness 开源

把 AI 能力拆成乐高积木,拼出你的专属智能体。

DeepSeek Harness: Everything is a Plugin.

★ 233327 2026-08-15
AutoGPT 开源

开箱即用的 AI 员工,交代任务就自己干完

AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mis···

★ 187492 2026-08-09
EvoAgentX 开源

让 AI 智能体自己迭代变强,越用越聪明

EvoAgentX: Building a Self-Evolving Ecosystem of AI Agents

★ 3351 2026-09-12