Blave Agent
让 Claude Code 或 Codex 把交易想法变成经检验并可实盘运行的策略。
- Star 数
- ★ 46
- 最近更新
- 今天
- License
- Apache-2.0
- 主语言
- Python
- FA 评分
- 87/100 · 表现良好
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 有免费版，另有付费云服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 使用 macOS、希望让 Claude Code 或 Codex 从自然语言生成并回测单标的策略的个人量化研究者。
- 不适合
- 需要在 Linux 或 Windows 上运行桌面应用的团队
- 要求桌面端在应用退出后仍继续下单的交易者
- 需要桌面端自动交易组合策略的用户
- 源码审查
- 87/100 · 表现良好
这个 Agent 能做什么，适合哪些场景？
Blave Agent 是一套面向量化研究与自动交易的 macOS 工作区，桌面外壳位于 `shell/`，由 Electron 提供交互界面。用户可连接自己的 Claude Code 或 Codex，也可选择按量计费的 Blave AI；代理负责研究、编写策略代码、执行回测并准备部署。共享的 `lib/` 提供数据访问、回测、Monte Carlo permutation test、参数扫描、滚动 walk-forward、报表、图表以及交易所账户和订单辅助模块。实盘环节不把 LLM 放进下单循环，而是由定时运行的确定性代码和 `manager/reconciler.py` 将账户调整到目标仓位，并通过 `state/HALT` 阻止新增风险敞口。它既可在本地 macOS 应用中运行，也提供付费的专用云端机器；云端可通过网页工作区、Telegram 或 SSH 使用。本地免费路径仍可能依赖用户自己的 AI 订阅、市场数据源和交易所账户，回测结果也不构成收益保证。
用户用自然语言描述交易想法后，系统先将其归为 A、B 或 C 型：A 型是单一标的、固定周期和单一仓位，C 型是按计划再平衡的多标的权重组合，两者必须回测；其他筛选、网格、套利、提醒和一次性执行归为不要求回测的 B 型。代理在 strategies/ 中生成策略，并调用 lib/runner.py 及相关模块运行回测；A 型默认通过 lib/validation.py 执行 MCPT 并记录 p 值，lib/param_scan.py 搜索有效参数平台，lib/walk_forward.py 衡量样本外表现，lib/quality_check.py 会把零手续费标记为问题。经过版本固定的 A、C 型策略若实盘代码发生变化，网页工作区会显示“Live · file changed”，但不会自动停止策略。实盘时，调度器执行确定性策略代码，manager/reconciler.py 根据目标仓位下单；state/HALT 可阻止新增敞口，同时仍允许平仓和止损。每次下单尝试写入 state/audit.jsonl，系统在报告订单成功前会向交易所回查。桌面版可连接 Binance、OKX、BingX、Gate.io 和 Bybit，也提供无需密钥、按最新收盘价成交的 lib/account_paper.py 与 lib/order_paper.py 模拟交易。
- 使用 macOS、希望让 Claude Code 或 Codex 从自然语言生成并回测单标的策略的个人量化研究者。
- 需要用 MCPT、参数平台扫描和滚动 walk-forward 检查策略是否可能只是过拟合的研究团队。
- 希望在 Binance、BingX、OKX、Gate.io 或 Bybit 上先模拟交易，再连接实盘账户的加密货币交易者。
- 研究台湾上市或上柜股票日线数据，并希望直接使用 TWSE、TPEx 免费公开数据的桌面用户。
- 需要电脑关机后策略仍持续运行，并愿意采用 Blave 付费专用云端机器的用户。
- 准备构建定期再平衡多资产组合并回测权重配置的策略开发者，但桌面端暂不能自动交易这类组合。
如何安装或部署这个 Agent？
从源码运行需要 macOS 13 或更新版本、Node.js 22.12 或更新版本与 npm，以及 PATH 中的 python3。还需安装并登录 Claude Code 或 Codex，或者准备一个 Blave 账户。执行：
git clone https://github.com/Blave-TW/blave-agent.git
cd blave-agent/shell
npm install
npm start首次启动时选择自己的 Claude Code/Codex 或 Blave AI。源码运行会使用系统 python3 创建虚拟环境；打包版则自带 Python 3.12。也可直接从 GitHub Releases 下载适用于 Apple Silicon 和 Intel 的通用 macOS 应用。若需要强制使用英文界面，可运行：
BLAVE_LANG=en npm start如何使用这个 Agent？
首次启动后选择代理提供方。若使用自己的 Claude Code 或 Codex，无需 Blave 账户，相关凭据仍由对应 CLI 管理；若使用 Blave AI，则登录 Blave 账户并按用量付费。随后在界面中输入具体策略要求，例如：
Backtest BTCUSDT on the 4h chart: long when the 20-period SMA crosses above the 60-period SMA, flat when it crosses back below. Use a 0.05% fee per side.也可以请求组合回测：
Build a portfolio of BTC, ETH and SOL with equal weights, rebalanced weekly, and backtest it.如需实盘，在桌面应用的 Auto trading › Connect an exchange 中连接受支持交易所；不要把密钥粘贴到聊天中。密钥只能授予读取和交易权限，不能包含提现权限。资金注入和恢复交易必须由用户本人在 Auto trading 页面操作。无需密钥的试运行可使用内置 paper trading。桌面端只有在 Blave 正在运行时才会发出订单，应用重启后还需手动按下 Start trading。
这个 Agent 有哪些优点和局限？
- A 型回测默认执行 MCPT 并记录 p 值，同时提供参数平台扫描和滚动 walk-forward，而不是只展示单次最优回测。
- 实盘调度执行确定性代码，不让 LLM 进入订单循环；
state/HALT可在订单库层阻止新增敞口。 - 可检测已版本化策略的实盘代码是否偏离回测版本，并在网页工作区明确标记文件变化。
- 提供五家加密货币交易所的已测试订单库、无需密钥的模拟交易，以及扩展其他经纪商的模板。
- 本地路径可使用自己的 Claude Code 或 Codex，核心代码采用 Apache-2.0，并允许商业使用、修改和再分发。
- 桌面应用明确要求 macOS 13 或更新版本；Capital Futures 集成则仅适用于 Windows 工作区。
- 桌面应用退出后不会继续下单，重新打开后交易保持暂停，必须由用户手动恢复。
- 桌面端目前不能自动交易 C 型组合策略。
- 本地免费数据覆盖有限；Blave 指标、台湾盘中与筹码数据、期货和宏观日历需要具备数据权限的 Blave 账户。
- 持续云端运行、Blave 市场数据和 Blave LLM 代理属于仓库之外的付费服务。
这个 Agent 与同类方案有什么区别？
使用自己的 Claude Code 或 Codex 时，桌面应用只负责启动相应 CLI，不要求 Blave 账户，Blave 也不收取 AI 费用；用户仍自行承担原有 AI 订阅或服务成本。Blave AI 是内置的替代路径，需要登录 Blave 账户并按用量计费。本地桌面模式免费且数据与密钥保存在用户机器上，但只有应用运行时才能下单；付费云端机器则可在电脑关闭后继续运行，并通过网页工作区、Telegram 或 SSH 访问。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Blave Agent 当前 | 87 · 表现良好 | 桌面应用免费版 + 付费版 | ★ 46 | 今天 | Python | Codex · Claude Code |
| Lumibot 量化交易框架 | 57 · 缺口较多 | 代码库 / SDK免费 + 模型费 | ★ 2.1k | 1 天前 | Python | Codex · Claude Code |
| Vibe 交易助手 | 64 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 34k | 今天 | Python | OpenAI API · Claude API |
| PRISM-INSIGHT | 49 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 767 | 1 天前 | Python | ChatGPT · OpenAI API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示交易密钥被限制为读取和交易权限，支持的场所会拒绝具有提款权限的密钥；资金投入、恢复交易和账户身份不明时的处理均保留给用户确认。停机开关、审计日志、重启后暂停、订单回查，以及更新前备份和原子替换，为外部影响与恢复提供了较完整的控制。README也清楚说明密钥在桌面、云端及网页绑定时的存放和数据来源，并由LICENSE、NOTICE说明来源归属。扣分在于代理仍可读取明文workspace .env，云端允许把密钥贴入聊天，Gate.io无法检查提款标志；依赖保护虽有锁文件、下载哈希、只读工作流权限和发布闸门，但给出的材料未证明所有Python/npm依赖均精确固定或持续进行漏洞审计。未发现红线行为。
README、离线契约测试和发布工作流在账户身份保护、失败时HALT、数据适配、版本检查及发布校验方面大体一致；测试明确要求缺失账户ID、错误端点和格式问题显式失败，工作流也提供具体错误信息。扣分在于这是未执行的静态审查，所给测试只是测试源码而非通过记录，而且核心实现文件和完整依赖清单未提供；系统还依赖外部交易所、公共数据端点、系统Python、AI CLI及部分付费Blave服务，其可用性并非仓库单独可保证。
材料清楚区分固定标的、组合和其他任务三类场景，规定哪些必须回测、哪些不能自动交易，并针对桌面、本地源码、云端、纸上交易及多个交易场所给出边界。意图分类和交易控制触发条件具体，包括账户变更、恢复、HALT及不支持区间的处理。扣分在于主要桌面路径限定macOS 13+，Capital接口限定Windows工作区，桌面组合策略尚不能自动交易，其他经纪商集成仅有未经验证的模板；因此跨环境适配并不完整。
README提供快速开始、目录导览、阅读顺序、示例、测试命令、贡献方式、安全限制、发布流程和更新契约；Apache-2.0全文、商标边界、日期版VERSION、运行时CHANGELOG及桌面语义版本均有说明。已公开已知限制，包括回测不代表未来、平台差异、密钥风险和未测试集成。扣分在于遗留的openclaw配置、API路径与主机名降低命名稳定性；维护主体虽在版权、仓库所有者审批、Issues/PR及发布流程中有所体现，但发布者未获企业登记验证，材料也未给出明确个人维护者或支持承诺。
产出被设计为可直接使用的策略、回测报告、p值、参数平台、滚动样本外结果、图表、实时版本偏移提示和审计记录；相较通用编码代理，交易类型契约、过拟合制动、确定性订单循环及账户保护提供了明显增量价值。扣分在于本地代码虽免费，实际使用仍可能需要Claude Code/Codex订阅、Blave数据或云端费用、交易所账户和较复杂环境配置；实盘交易的潜在损失也使成本收益高度依赖用户能力与使用情境。
重要声明通常指向具体文件、模块、测试、版本文件或工作流步骤，并明确区分已在真实账户验证的场所、未经Blave测试的模板、历史回测与未来表现，以及本地开源部分与付费服务。账户身份与Binance数据路径由所给测试源码形成一定交叉佐证，发布安全由工作流进一步佐证。扣分在于大多数回测、订单、密钥拒绝和实时一致性声明仍主要来自README；未提供相应核心实现、测试输出、CI结果或独立来源，故交叉佐证只能评为部分充分。
- 实盘前应创建仅具读取和交易权限、无提款权限且最好限制IP的独立API密钥；Gate.io权限必须人工核查。
- 不要在聊天中粘贴密钥；若曾粘贴，应立即轮换，并保护workspace .env、聊天历史和state目录。
- 先使用纸上交易或隔离的小额账户，并人工验证HALT、重启后暂停、账户变更确认及平仓路径。
- 不要把README中的“真实账户验证”或测试源码视为本次审查已复现的结果；应在固定修订上自行运行相关测试并审查核心订单实现。
- Windows正式发布轨当前会拒绝未由SignPath签名的安装包；测试轨产物明确可能未签名，不应作为可信正式更新分发。
常见问题
本地使用是否免费？
交易所密钥保存在哪里，需要哪些权限？
~/Blave/workspace/.env；云端工作区密钥位于用户的专用机器，网页绑定的密钥由 Blave 加密存储。密钥应仅授予读取和交易权限，不能授予提现权限；Gate.io 不报告提现权限标志，需用户自行核查。代理能自行入金或恢复交易吗？
回测能否保证实盘盈利？
能否接入未列出的交易所或经纪商？
lib/account_TEMPLATE.py 和 lib/order_TEMPLATE.py 编写辅助模块，但这类自定义连接未经 Blave 测试，需要用户自行验证。