Skip to main content
Glama

braintrust-lite

Claude Code 原生的多模型军师 — 并发调用 Codex + Gemini,主 Claude 担任 Judge 融合输出。

主 Claude → parallel:
  ├─ Task(subagent_type=Plan, prompt=X)       ← 正常子 agent
  └─ mcp__braintrust_lite__consult(prompt=X) ← Codex + Gemini 旁路咨询
          → 主 Claude 融合三方视角 → 最终方案

vs braintrust: 2 次 API 调用(省 50%),无独立 Judge,无落盘,原生集成 Claude Code。


安装

前置条件codexgemini CLI 均已登录。

# 克隆
git clone https://github.com/HongjieRen/braintrust-lite.git
cd braintrust-lite

# 安装依赖
npm install

# 可选:把 CLI 软链到 PATH
ln -sf "$(pwd)/bin/consult" ~/.local/bin/consult
chmod +x bin/consult

Related MCP server: codex-fusion-mcp

注册到 Claude Code(MCP)

claude mcp add braintrust-lite node "$(pwd)/src/server.js"

注册后,Claude Code 会话里会出现 mcp__braintrust_lite__consult tool,和 Read / Bash 并列可用。

重启 Claude Code 后生效。


安装 Skill 引导

把 skill 软链到 Claude Code 全局 skill 目录,让主 Claude 知道何时该主动使用 consult:

ln -sf "$(pwd)/skills/consult" ~/.claude/skills/consult

安装后可用 /consult slash command 激活"军师模式"引导。


使用方式

在 Claude Code 里(推荐)

Claude 会在处理规划/设计类任务时自动(或在 /consult 引导下)并发调用:

你处理一个架构选型任务时,Claude 会同时:
  1. 启动 Plan sub-agent 做深度分析
  2. 调用 mcp__braintrust_lite__consult 获取 Codex + Gemini 的独立视角
  3. 融合三方输出给你最终方案

终端 CLI(fallback / 调试)

consult "解释 CAP 定理"                   # 并发两模型,markdown 输出
consult --only codex "prompt"             # 只跑 codex
consult --skip gemini "prompt"            # 跳过 gemini
consult --timeout 60 "prompt"             # 超时秒数
consult --dir ~/myproject "review"        # 工作目录
cat app.ts | consult "review this code"   # stdin 拼接
consult --json "prompt"                   # JSON 结构化输出

参数

参数

默认

说明

prompt

必须

问题文本(MCP)/ 位置参数(CLI)

only

只调用: codex | gemini

skip

跳过模型列表

timeout_sec

90

每个模型超时秒数

cwd

server cwd

子进程工作目录

--json

false

CLI 专用:JSON 格式输出


输出格式

## CODEX (8.2s)

<codex 完整回答>

---

## GEMINI (6.5s)

<gemini 完整回答>

失败的 provider 显示 *调用失败: timeout*,另一个照常返回(Promise.allSettled 容错)。


架构

braintrust-lite/
├── src/
│   ├── server.js      MCP stdio server
│   ├── consult.js     核心并发逻辑
│   ├── providers.js   spawn + Codex/Gemini 解析器
│   └── format.js      Markdown / JSON 渲染
├── bin/
│   └── consult        CLI 入口
├── skills/
│   └── consult/
│       └── SKILL.md   Claude Code skill 引导
└── docs/
    └── spec.md        设计文档

成本

场景

API 调用

估算成本

简单问题

2

$0.05–0.15

中等问题

2

$0.15–0.40

复杂问题

2

$0.40–0.80


License

MIT

Related MCP Connectors

Related MCP Servers