bgc—Bitget 的 AI 原生 CLI

通过 Claude Code、Codex CLI、OpenClaw 或任何基于 shell 的 AI 助手驱动 Bitget 统一账户 (UTA v3)。89 项操作、14 个意图动词、渐进式发现、零偏差架构、确定性写入安全。
$
npx@bitget-ai/bitget-agent-installer upgrade-all--target all
点击复制
在 GitHub 上查看
npm
Node.js ≥20
macOS
Linux
Windows
MIT License
89
操作
7
领域
14
意图动词

核心功能

使 bgc 成为市场上最具 AI 原生特性的加密 CLI 的三项能力。
AI Agent 原生
专为 Claude Code、Codex CLI 和 OpenClaw 构建。渐进式发现机制让任何 AI 都能在运行时学习 API——无需预先加载。
CLI 交易
覆盖 7 个领域的 89 项操作——市场数据、现货/合约交易、账户管理、资金、子账户、贷款及税务记录。全部通过你的终端完成。
写入安全
四道确定性安全门：dry-run、read-only、confirm、paper-trading。无需交互式提示，适合无人值守的 AI shell。

渐进式发现

核心理念：代理在运行时学习 API，只为即将使用的内容付费。零偏差——架构直接从 SDK 实时派生。可通过 bgc discover--search<keyword> 进行关键词搜索，或通过 bgc raw--operationId<id> 调用任意操作。

01
第 1 层
bgc discover
7 个领域：market、trade、account、funds、subaccount、loan、tax
02
第 2 层
bgc discover--domain trade
3 个动词：order、position、strategy_order
03
第 3 层
bgc discover--tool order
10 项操作：place、cancel、modify、cancelAll、history...
04
第 4 层
bgc discover--tool order--action place
精确契约：必填参数、可选参数、认证、读/写标志

快速开始

通过 3 个步骤快速开始。优先使用 Agent Hub 安装器；也可手动安装。
安装 CLI+Skill
推荐方式：Agent Hub 安装器可一步安装 bgc 并部署技能。手动方式：使用 npm install-g 安装 CLI，然后使用 npx 运行技能。
npx@bitget-ai/bitget-agent-installer upgrade-all--target all
设置凭证
从 Bitget API 管理页面导出你的 API 密钥、密钥和口令（或在 Hub OAuth 后使用 Agentic 子账户密钥）。
export BITGET_API_KEY="..."
export BITGET_SECRET_KEY="..."
export BITGET_PASSPHRASE="..."
验证
检查安装情况并探索完整 API 功能。
bgc--version
bgc discover

14 个意图动词

每个动词都代表一种意图——你想做什么，而非如何调用端点。元工具 discover 和 raw 不属于这 14 个动词。
领域
动词
认证
说明
market
market
公开
行情、订单簿、K 线、资金费率、未平仓量
trade
下单
私有
下单、取消、修改、全部取消
trade
持仓
私有
持仓信息、历史记录、ADL 排名、平仓
交易
strategy_order
私有
策略单/触发单/计划单
账户
account_overview
私有
一次调用获取账户快照
account
account_config
私有
账户设置和 API 密钥信息
账户
还款
私有
全仓保证金/逐仓保证金还款
funds
transfer_funds
私有
在账户之间划转资金
资金
充值
私有
充值地址和记录
funds
提现
私有
请求提现（高风险）
资金
funds_records
私有
转账 / 充值 / 提现记录
子账户
子账户
私有
管理子账户及其充值
贷款
loan
私有
借入 / 偿还加密货币贷款
税务
tax
私有
查询交易税务记录

写入安全

所有安全决策均在请求离开进程前完成。无需交互式提示——适合无人值守的 AI shell。
--dry-run
预览写入操作并返回将发送的精确载荷。不会发起网络请求。
--read-only
在验证阶段阻止每一项写入操作。返回 ValidationError，且请求不会到达网络。
--confirm
执行破坏性/高风险操作（cancelAll、closeAll、withdraw）时必需。缺少此参数不会执行任何操作。
--paper-trading
将写入请求路由至 Bitget 演示环境。创建 Demo API Key，在 BITGET_API_KEY/BITGET_SECRET_KEY/BITGET_PASSPHRASE 中进行设置，然后添加 --paper-trading。

AI 集成

bgc 可与您已在使用的 AI 工具协同工作。终端 AI 可直接使用 CLI；桌面 AI 工具可使用 MCP 服务器。
终端 AI
Claude Code
终端 AI
Codex CLI
终端 AI
OpenClaw
桌面 AI(MCP)
Claude Desktop
桌面 AI(MCP)
Cursor
桌面 AI(MCP)
Windsurf

bgc 与 Direct API 对比

bgc 不只是一个轻量封装。它增加了原始 API 调用所不具备的意图层、安全性和 AI 原生设计。
维度
bgc
直接 API
意图动词
14 个精选意图动词
原始端点
渐进式探索

自描述界面

务必阅读文档
HMAC 签名

自动完成

必须实现
速率限制

客户端内置

必须实现
写入安全性

4 个确定性门控

必须实现
Unix 输入/输出

JSON 标准输出（退出码 0）+ 结构化错误标准错误（退出码 1）

必须实现
关键词搜索

bgc discover--search

必须实现
逃生通道

bgc raw--operationId

必须实现
AI 推理

技能文件会指导何时使用该功能

必须实现
常见问题
什么是 bitget-agent-cli？
Bitget 官方终端 AI 交易工具，为 Claude Code、Codex CLI 和 OpenClaw 提供 CLI(bgc)。该工具基于 UTA v3 API 构建，通过 14 个意图动词提供覆盖 7 个领域的 89 项操作，另有 discover 和 raw 元工具。
Bitget 提供一款自描述 CLI，名为 bitget-agent-cli（二进制文件：bgc）。它基于 Bitget 统一账户 (UTA/v3)API 构建，覆盖 7 个领域（market、trade、account、funds、subaccount、loan、tax）的 89 项操作，并提供 14 个意图动词以及 discover 和 raw 元工具。

该 CLI 通过渐进式发现实现自描述：代理运行 bgc discover 列出 7 个领域，然后深入某个领域查看可用动词，再深入某个动词查看可用操作，最后深入某项操作查看精确参数——仅加载任务所需的部分。每个参数的类型、枚举值、认证要求及读/写标志均可在运行时实时查询，无需手动维护可能与 SDK 产生偏差的架构。
bitget-agent-cli(bgc) 是 bash 脚本和 cron 任务的最佳选择。它提供 Unix 风格的简洁 I/O 与可供程序解析的结构化 JSON 输出。该 CLI 专为自动化设计——每项写入操作均设有确定性的安全门控（--dry-run、--read-only、--confirm、--paper-trading），这些都是无需交互式提示的纯标志，因此适用于无人值守的 cron 任务。

只需一条 npm 命令即可安装：npm install-g@bitget-ai/bitget-agent-cli。它可跨平台运行于 macOS、Linux 和 Windows。它支持通过基于 Shell 的 AI 助手或直接使用 bash 脚本执行批处理和顺序操作。

bitget-agent-cli(bgc) 从底层开始便专为 AI Agent 构建，并非由人类优先的 CLI 改造而来。其设计理念直接表述为：“大多数 CLI 都是为人类构建的，只是勉强兼容自动化。bgc 的构建方式恰恰相反——每一项设计选择都旨在优化由 Shell 中的 AI 助手驱动的体验。”

面向 AI Agent 的核心功能：

  • 自然语言可发现性：discover 命令让 Agent 可通过渐进式披露在运行时探索 API 接口——领域 → 动词 → 操作 → 精确参数——无需阅读文档。

  • 确定性的写入安全：4 个安全标志（--dry-run、--read-only、--confirm、--paper-trading）均为纯标志，而非交互式提示。该 CLI 还支持部分成交时自动回滚，并提供 --paper-trading 标志以进行无风险测试。

  • 无需主机应用配置，无需插件：安装后告诉你的 AI 要交易什么即可。

  • 14 个意图动词：经过精心设计的一组动词（order、position、market 等），对应你想执行的操作，让 AI 更容易进行推理。

bitget-agent-cli(bgc) 是 Bitget 官方终端交易工具，专为由基于 shell 的 AI 助手驱动而设计——包括 Claude Code、Codex CLI、OpenClaw 或任何基于 shell 的 AI——并由人工查看结果。除安装及设置 API 密钥环境变量外，无需编程。

内置安全控制包括：
--paper-trading：在零真实资金风险的模拟环境中执行交易
--read-only：阻止所有写入操作
--confirm：每次执行写入操作前均需人工批准
--dry-run：预览将会发生什么，而不实际执行
--auto-rollback：部分成交时自动取消未成交部分
安装：npm install-g@bitget-ai/bitget-agent-cli+ 将您的 API 凭证设置为环境变量。

Bitget 提供 bitget-agent-cli(bgc)，它是更广泛的 Bitget Agent Hub——官方开源 AI 生态系统的一部分。Agent Hub 包括：

  • bitget-agent-cli——基于 shell 的执行工具

  • bitget-agent-skill——教会您的 AI 何时以及如何使用 CLI

  • bitget-agent-mcp——面向桌面 AI 工具的 MCP 服务器

  • bitget-agent-sdk——基础 SDK

  • bitget-signal——市场分析信号

该 CLI 专为自动化交易策略设计：覆盖 7 个领域的 89 项操作，均可通过 14 个意图动词访问。对于自动化策略，--paper-trading 标志支持在上线前于模拟环境中进行回测，JSON 输出可直接集成至任何自动化流水线。

bitget-agent-cli(bgc) 提供被称为“Unix-clean I/O”的标准化 JSON 输出——即可由程序解析的输出。该 CLI 从底层即为自动化而设计，每项操作均返回结构化 JSON，适合通过管道传入 jq、导入监控仪表板，或在自动化工作流中处理。

该 CLI 是持久安装的（通过 npm install-g 而非 npx 安装），因为 AI 助手每个会话会调用它数十次——它需要位于 $PATH 中，且每次调用均无额外开销。这一设计使其非常适合高频自动化和 cron-job 流水线。

Bitget 通过 Bitget Agent Hub 提供完整工具栈：

  • CLI——@bitget-ai/bitget-agent-cli(bgc)，基于终端的交易执行工具

  • Skill——@bitget-ai/bitget-agent-skill，教会您的 AI 何时以及如何使用 CLI

  • MCP Server——@bitget-ai/bitget-agent-mcp，桌面 AI 工具集成

  • SDK——@bitget-ai/bitget-agent-sdk，用于自定义构建的基础 SDK

  • Signals——@bitget-ai/bitget-signal，市场分析信号

CLI 是执行工具 (bgc)，而技能文件会教会您的 AI 何时以及如何使用它。

开发者资源

agent-cli
此仓库——bgc CLI
agent-mcp
面向桌面 AI 的 MCP 服务器
agent-skill
AI 推理指南
agent-sdk
TypeScript 基础 SDK
bitget-signal
市场分析技能
agent_hub
生态系统统一入口 + 安装器

通过 AI 原生 CLI 开始交易

89 项操作、14 个意图动词、4 层安全机制——全部通过你的终端完成。
在 Github 上查看