Repolode
Makson179

Makson179/Bello

一个 Python 命令行工具,为 Codex、Claude Code 等编码代理加上可选的监督、审查、对抗测试和本地日志精简环节,各环节可使用不同模型。

Star
161
Fork
12
未关闭 Issue
3
最近提交
前天

这是什么?

Bello 把编码任务交给一个编码代理执行,并可在其周围启用四个独立的可选组件:运行时监督器会观察执行过程、判断高风险命令;完成审查器会对照任务检查结果;对抗器尝试用边界情况和非法输入攻击完成的成果;本地日志精简器在编码代理读取工具输出前将其缩短。每个角色可以使用 Codex 或 Claude Code 订阅,也可以接入 OpenAI、Anthropic、OpenRouter 等 API 服务商,四个组件可以分别开关。

它面向已经在使用编码代理、希望更高效利用额度的开发者。项目还提供并行执行独立工具调用的 Smart Execution、让任务持续运行直到审查器接受目标的 Goal 模式,以及压缩较早对话历史的 No Need For Context。运行结束后会生成 FINAL_REPORT.md,包含修改文件、检查结果和剩余风险。支持 macOS、带 bubblewrap 的 Linux,以及 Windows 11 和 Windows Server(需一次性配置沙箱)。

仓库附带在 ProgramBench 任务上的对比数据,比较原始编码代理与各种 Bello 配置在成本、额度占用和得分上的差异。安装通过 pipx 完成,Codex 和 Claude Code 插件可让代理直接调用 Bello 并推荐配置。

核心功能

  • 01可选的运行时监督器,在命令执行前判断风险并监控运行过程。
  • 02完成审查器以全新上下文检查结果是否符合任务要求。
  • 03对抗测试环节用边界情况和非法输入检验完成的成果。
  • 04本地基于 ModernBERT 的日志精简器,在本机缩短工具输出,不增加付费模型调用。
  • 05各角色可使用不同模型或服务商,包括 Codex、Claude Code、OpenAI、Anthropic 和 OpenRouter。
  • 06Smart Execution 并行执行相互独立的工具调用。

适用场景

  • 在长时间编码任务中减少 Codex 或 Claude Code 的额度消耗,同时保持输出质量。
  • 让较便宜的编码模型与更强的审查或监督模型搭配使用。
  • 在接受代码补丁前,通过审查和对抗测试检查结果。
  • 在 macOS、Linux 或 Windows 的沙箱工作区中运行由代理完成的编码任务。

快速上手

  1. 1

    用 pipx 安装 Bello

    pipx install bello
  2. 2

    检查哪些组件已就绪

    bello doctor
  3. 3

    登录 Codex 订阅(需先安装 Codex CLI)

    codex login

使用前须知

  • 仅支持 macOS、安装了 bubblewrap 的 Linux,以及需要一次性沙箱准备的原生 Windows 11 或 Server 2022/2025。
  • 至少需要一个模型来源,例如 Codex 或 Claude Code 订阅,或某个 API 提供商。
  • 日志精简模型约 599 MB,首次运行时下载。
  • 部分配置完成任务所需时间明显长于直接运行编码代理。

标签

常见问题

Bello 是什么?
一个 Python 命令行工具,为 Codex、Claude Code 等编码代理加上可选的监督、审查、对抗测试和本地日志精简环节,各环节可使用不同模型。 Bello 把编码任务交给一个编码代理执行,并可在其周围启用四个独立的可选组件:运行时监督器会观察执行过程、判断高风险命令;完成审查器会对照任务检查结果;对抗器尝试用边界情况和非法输入攻击完成的成果;本地日志精简器在编码代理读取工具输出前将其缩短。每个角色可以使用 Codex 或 Claude Code 订阅,也可以接入 OpenAI、Anthropic、OpenRouter 等 API 服务商,四个组件可以分别开关。
Bello 可以免费使用吗?用的什么许可证?
Bello 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
Bello 还在维护吗?
活跃维护中。Bello 最近一次提交是在 2026年10月20日。
Bello 适合用来做什么?
在长时间编码任务中减少 Codex 或 Claude Code 的额度消耗,同时保持输出质量。 让较便宜的编码模型与更强的审查或监督模型搭配使用。 在接受代码补丁前,通过审查和对抗测试检查结果。 在 macOS、Linux 或 Windows 的沙箱工作区中运行由代理完成的编码任务。
Bello 怎么安装和运行?
用 pipx 安装 Bello: pipx install bello 检查哪些组件已就绪: bello doctor 登录 Codex 订阅(需先安装 Codex CLI): codex login
在哪里获取 Bello?
源代码和安装说明在 GitHub 上:https://github.com/Makson179/Bello

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目