bgc— 專為 Bitget 打造的 AI 原生 CLI

透過 Claude Code、Codex CLI、OpenClaw 或任何基於 shell 的 AI 助手驅動 Bitget 的統一帳戶（UTA v3）。89 個操作、14 個意圖動詞、漸進式發現、零偏差 schema、確定性的寫入安全。
$
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
Layer 1
bgc discover
7 個領域：market、trade、account、funds、subaccount、loan、tax
02
Layer 2
bgc discover--domain trade
3 個動詞：order、position、strategy_order
03
Layer 3
bgc discover--tool order
10 種操作：place、cancel、modify、cancelAll、history...
04
Layer 4
bgc discover--tool order--action place
精確契約：必填參數、選填參數、驗證、讀寫標誌

快速開始

透過 3 個步驟快速上手。推薦使用 Agent Hub 安裝程式；手動安裝也可以。
安裝 CLI 和 Skill
推薦方式：Agent Hub 安裝程式可一步安裝 bgc 並部署 skill。手動方式：npm install-g 安裝 CLI，然後 npx 執行 skill。
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 個動詞之內。
Domain
Verb
Auth
描述
market
market
公開
行情、訂單簿、K 線、資金費率、未平倉量
trade
order
私有
下單、取消、修改、全部取消
trade
position
私有
倉位資訊、歷史記錄、ADL 排名、平倉
trade
strategy_order
私有
策略/觸發/計劃委託
account
account_overview
私有
單次呼叫獲取帳戶快照
account
account_config
私有
帳戶設定與 API 金鑰資訊
account
repayment
私有
全倉保證金 / 逐倉保證金還款
funds
transfer_funds
私有
在帳戶間劃轉資金
funds
deposit
私有
充值地址與記錄
funds
withdraw
私有
請求提領（高風險）
資金
funds_records
私有
劃轉 / 充值 / 提領歷史
子帳戶
subaccount
私有
管理子帳戶及其充值
貸款
loan
私有
借入 / 償還質押借貸
tax
tax
私有
查詢交易稅務記錄

Write-Safety

每個安全決策都在任何請求離開程序之前發生。無互動式提示 — 在無人值守的 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 個意圖動詞加上 discover 和 raw 元工具，在 7 個領域中公開了 89 個操作。
Bitget 提供名為 bitget-agent-cli（二進位：bgc）的自描述 CLI。它基於 Bitget 統一帳戶（UTA/v3）API 建置，涵蓋 7 個領域（market、trade、account、funds、subaccount、loan、tax）的 89 個操作，由 14 個意圖動詞加上 discover 和 raw 元工具引導。

該 CLI 透過漸進式發現進行自描述：代理執行 bgc discover 以列出 7 個領域，接著深入領域查看可用的動詞，再深入動詞查看可用的動作，最後深入動作查看確切的參數 — 僅載入任務所需的切片。每個參數的類型、列舉、認證要求和讀寫標誌都可以在運行時間即時查詢，無需手動維護可能與 SDK 產生偏差的 schema。
bitget-agent-cli（bgc）是 bash 腳本和 cron 任務的最佳選擇。它產生具有結構化 JSON 輸出的 Unix 風格 I/O，程式可以對其進行解析。該 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 代理而生，並非從人類優先的 CLI 改造而來。其設計理念明確指出：「大多數 CLI 是為人類設計的，僅僅是容忍自動化。bgc 則恰恰相反——每一個設計選擇都是為了優化由 shell 驅動的 AI 助手。」

AI 代理的核心功能：

  • 自然語言可發現性：discover 命令讓代理在運行時間透過漸進式揭露來探索 API 表面（領域 → 動詞 → 操作 → 精確參數），而無需閱讀文件。

  • 確定性的寫入安全：四個安全標誌（--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) 提供標準化的 JSON 輸出，被描述為「Unix-clean I/O」— 程式可以解析的輸出。該 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），而 skill 檔案則教導您的 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 上查看