CLI 参考

npx binference 的每个命令和选项、Agent 文件夹里有什么，以及如何更新它。

每个命令都以 npx binference <command> 的形式运行，并且都支持 --help。CLI 需要 macOS 或 Linux（在 Windows 上用 WSL2），以及 Node.js 22 或更高版本。

命令	作用
`agent-os <name>`	为一个 Agent 创建文件夹。参见设置 Agent
`start`	让文件夹的应用在 bInference 上启动。在文件夹中运行 `./start` 效果相同，更快
`doctor [folder]`	从头到尾检查文件夹，并告诉你需要修复什么
`link-wallet [folder]`	关联 Agent 的钱包，生成业绩记录。由你签名，不动资金

agent-os

npx binference agent-os my-agent --app codex --model deepseek/deepseek-v4.1-flash

选项	作用
`--app claude`, `codex`	由哪个应用运行 Agent。没有终端且两者都已安装时必须指定
`--model <id>`	Agent 一开始使用的模型，模型页面中的任意 id
`--yes`, `-y`	不再询问，直接安装 Binance 的钱包工具 `baw`
`--sandbox`	开启 Claude Code 的沙盒。第一次运行时，请允许 Binance 和 binference.io 的域名
`--no-wait`	显示验证码后停下
`--resume`	完成用 `--no-wait` 开始的设置
`--json`	以 JSON 事件代替文本输出

start 之后的参数会传给应用。要接着 Claude Code 上一次的对话：

./start --continue

要把 --help 传给应用，先加上 --：./start -- --help。

npx binference doctor --fix --dry-run

选项	作用
`--fix`	修复失败的项目。你自己的设置、hooks 和 MCP 服务器都保留
`--dry-run`	与 `--fix` 一起使用，只显示会改什么，不做任何改动
`--json`	以一个 JSON 对象输出结果

路径	存放什么
`.binference/key`	Agent 的密钥，只有你的用户可以读取。git 会忽略它
`.binference/config.json`	它的驾驶舱、应用和模型
`.binference/hooks/`	执行你的限额的 hooks，以及启动器
`start`	带着密钥启动应用
`AGENTS.md`, `CLAUDE.md`	行为准则
`.claude/` 和 `.mcp.json`，或 `.codex/`	应用的设置、hooks 和 Skill

文件夹之外的东西都不会改动，只有两个例外：你选择安装的 baw，以及你用 Codex 连接的 Binance MCP Server，它会添加到这台电脑上的每一个 Codex 会话。

文件夹会一直使用设置时的那版 hooks。新版本发布后，在文件夹中运行：

npx binference@latest doctor --fix

请保留 @latest：直接运行 npx binference 可能会用到 npx 之前缓存的旧版本。所有版本都列在 npm 上。

Agent 运行 CLI 时，它的行为完全一样。

--json 只向 stdout 输出 JSON。 错误是这样的：

{ "ok": false, "error": { "code": "usage", "message": "...", "hint": "..." } }

Agent 可以替你设置另一个 Agent。它会运行：

npx binference agent-os scout --app claude --no-wait --json

第一个事件带有验证码和批准它的地址：

{
  "event": "approval_required",
  "user_code": "WDJB-MJHT",
  "url": "https://binference.io/link?code=WDJB-MJHT",
  "expires_at": "..."
}

Agent 会把它们转告给你。你在 10 分钟内核对验证码，并用钱包批准。然后 Agent 完成设置：

npx binference agent-os scout --resume