设置 Agent
一条命令为一个 Agent 创建文件夹,带上它的密钥、限制、Skill 和 hooks。你用钱包批准它。
运行命令
在终端中,进入你想存放 Agent 的文件夹,运行:
npx binference agent-os my-agentmy-agent 会成为文件夹的名称,也是 Agent 在驾驶舱中的名称。这条命令会检查是否安装了 Node.js 22 或更高版本,以及 Claude Code 或 Codex。如果两者都装了,它会问你由哪一个来运行这个 Agent。在 Windows 上,请在 WSL2 中运行。
| 选项 | 作用 |
|---|---|
--app claude, codex | 提前选定应用 |
--model <id> | Agent 一开始使用的模型。模型页面中的任意 id |
--yes | 不再询问,直接安装 Binance 的钱包命令行工具 |
--sandbox | 开启 Claude Code 的沙盒,让 shell 命令无法改动这个文件夹的限额 |
--no-wait,然后 --resume | 显示登录码后停下,稍后再批准;--resume 完成剩下的步骤 |
Codex 需要 0.140 或更高版本,这是第一个支持 hooks 的版本。如果你的版本更旧,运行 codex update。所有选项都在 CLI 参考中。
用钱包批准
浏览器会打开 binference.io 并显示一个验证码。核对它与终端里的验证码一致,用钱包登录,然后选择:
- 由什么支付它的 AI: 你账户的额度,或者你发射过的某个 Agent 的预算。
- 密钥的消费上限, 按天、周或月计算。默认开启,每天 $5。
只批准你此刻在自己终端里看到的验证码。之后终端会自动继续。
等它完成
这条命令会写好文件夹,并安装 Agent 需要的东西:
| 内容 | 位置 |
|---|---|
| Agent 的密钥 | .binference/key,只有你的系统用户能读取,并且被 git 忽略 |
| 行为准则 | AGENTS.md,CLAUDE.md 指向它 |
| Hooks | .binference/hooks,接入 .claude/settings.json 或 .codex/ |
| Skill | bInference、Binance Agentic Wallet 和代币审计 |
Binance 的钱包工具 baw | 如果你同意,用 npm 安装 |
所有东西都在这个文件夹里,只有 baw 例外,npm 会把它安装到整台电脑上。
连接 Binance 的 MCP Server
如果要在 Binance 交易所上交易,在这个文件夹中原样运行 Binance 提供的命令:
claude mcp add binance-mcp-server --transport http https://agent.binance.com/mcp/agentic然后启动 Agent,打开 /mcp,选择 binance-mcp-server 并登录 Binance。
只授予你需要的最少权限范围。Binance 要求用户自己运行这条命令,所以我们的命令只会把它打印出来给你。
启动
cd my-agent && ./start每次都用这种方式启动。./start 会让应用使用 bInference,并把密钥交给应用,只对这次启动有效。npx binference start 的作用相同,只是稍慢一些。直接运行 claude 或 codex 会用别的模型思考,它的 AI 花费也不会出现在驾驶舱中。
第一次启动时,Claude Code 会请你信任这个文件夹。Codex 会请你信任它,并审查一次它的 hooks:它们在 .binference/hooks 中。
登录 Agentic Wallet
如需链上交易,对 Agent 说:
Sign in to Binance Agentic Wallet然后在 Binance App 中调低钱包的限额:Agentic Wallet → 设置。Binance 建议一开始设为每天 $50。参见 Agentic Wallet。
Agent 知道什么
每个会话开始时,驾驶舱会给出一段状态:
bInference cockpit for "my-agent" (https://binference.io/account/cockpit?id=12):
- AI budget: $41.20 to spend, about 6.5 days at the last day's pace. This key stops at $5.00 a day ($3.10 left).
- Trade limits: at most $50.00 a trade, $200.00 a day, the person confirms above $25.00. Hooks apply them before each trade.
- Agentic Wallet: signed in. Its sign-in ends in about 2 h and Binance signs it out silently: tell the person now.
- If a hook blocks an action, tell the person the reason. Never retry it another way or split it.你暂停 Agent 后,状态里会写明,它就不会交易,也不会开始长时间的工作。AGENTS.md 中的行为准则要求它:
- 用一句话复述每一笔交易,先获取报价,再等你确认
- 第一次买入某个代币前先审计它,绝不买入蜜罐代币,也不买入卖出税率超过 10% 的代币
- 限额拦下交易时,绝不尝试别的办法
- 长时间工作前先检查 AI 预算
- 等待订单成交或资金到账时,最多每分钟查询一次 Binance
- 收到 Binance 的限频回复(HTTP
429或418)后,在 Binance 给出的时间之前停止调用 Binance,并告诉你
随时检查
在这个文件夹中运行:
npx binference doctor它会检查应用、密钥和驾驶舱、AI 预算、hooks 以及上一次会话是否运行了它们、Skill、baw、钱包的登录状态以及 Binance 的 MCP Server,并告诉你需要修复什么。npx binference doctor --fix 会修复失败的项目,同时保留你自己的设置。加上 --dry-run 可以先查看会做哪些改动。新版本发布后,用 npx binference@latest doctor --fix 更新这个文件夹。