Bitget Agent CLI

bitget-agent-cli — Bitget 向けのエージェントネイティブな CLI

Bitget Agent Hub のシェルインターフェースです。Claude Code、Codex CLI、OpenClaw、またはシェルベースのあらゆる AI アシスタントから、少数の意図を表す動詞と、エージェントが実行時に探索できる自己記述型インターフェースを通じて、Bitget の Unified Trading Account（UTA / v3）API を操作できます。

クイックスタート · エージェントネイティブである理由 · 段階的な情報開示 · インストール · コマンド · 書き込みの安全性 · セキュリティ · トラブルシューティング · よくある質問

---

概要

bitget-agent-cli（実行ファイル：bgc）は、シェルベースの AI アシスタント（Claude Code、Codex CLI、OpenClaw、またはターミナル上で動作するその他のツール）から操作し、人間が結果を確認することを前提に構築された、Bitget の公式ターミナル取引ツールです。

多くの CLI は人間向けに作られ、自動化にも対応しているだけです。bgc はその逆で、すべての設計上の選択が、シェルから操作する AI アシスタントに最適化されています。少数の意図を表す動詞、実行時にエージェントが探索する自己記述型インターフェース、そして自律型エージェントに操作権限を安全に渡せる決定論的な書き込み安全機能を備えています。

Bitget Unified Trading Account（UTA / v3）API を基盤とし、bgc は7 つのドメイン（market、trade、account、funds、subaccount、loan、tax）にわたる 89 の操作を公開します。操作は、discover / raw のメタツールに加え、14 個の意図を表す動詞から利用できます。ホストアプリケーションの設定もプラグインも不要です。インストールして、AI に取引内容を伝えるだけです。

詳しくはbitget-agent-cli の製品ページをご覧ください。

Bitget Agent Hub の一部です — 公式のオープンソース AI エコシステムです。デスクトップ AI ツール（MCP）、基盤 SDK、市場分析スキルについては、Hub をご覧ください。

---

クイックスタート

前提条件

• Node.js ≥ 20 (ダウンロード)
• Bitget API Key (こちらで作成) — 読み取りと取引の権限を有効にしてください。プライベート（account / trade）呼び出しにのみ必要です。市場データは公開されています。

1 行でインストール

npm install -g @bitget-ai/bitget-agent-cli
npx @bitget-ai/bitget-agent-skill --target all

次に、認証情報を設定します。

export BITGET_API_KEY="your-api-key"
export BITGET_SECRET_KEY="your-secret-key"
export BITGET_PASSPHRASE="your-passphrase"

両方をインストールする理由は？ bitget-agent-cli は実行ツール（bgc）であり、bitget-agent-skill は AI にそれを「いつ」「どのように」使うかを教えます。スキルファイルがなければ、AI はツールを持っていても、使うべきタイミングを判断できません。CLI がなければ、スキルには呼び出すものがありません。両方が必要です。

npx ではなく npm install -g を使う理由は？ bgc は常時使う CLI です。AI アシスタントは 1 回のセッションで何十回も呼び出すため、呼び出しごとのオーバーヘッドなしで $PATH 上に置いておくのが望ましいです。その他の Bitget AI パッケージ（bitget-agent-skill、bitget-signal、bitget-agent-mcp）は単発実行またはサブプロセスとして起動するため、npx を使います。

インストールを確認する

bgc --version
bgc discover

期待される結果：discover に 7 つのドメイン（market、trade、account、funds、subaccount、loan、tax）と、raw／discover のメタツールが一覧表示されます。

---

エージェントネイティブである理由

AI エージェントが必要とするもの	bgc の対応方法
実行時に API を学ぶこと — LLM はドキュメントを読めず、100 個の操作カタログはコンテキストに収まりません	段階的な情報開示：discover でドメイン → 動詞 → アクション → 正確なパラメーターへと掘り下げ、タスクに必要な範囲だけを読み込みます
推論できるインターフェース	14 個の意図を表す動詞（order、position、market など）が、実行したいことに対応します。厳選された動詞以外の操作も、raw／--full ですぐに利用できます
推測せずに組み立てられる呼び出し	すべてのパラメーターの型、列挙値、認証、読み取り／書き込みフラグをリアルタイムで照会できます。SDK とのずれを起こす手動管理のスキーマはありません
無人実行時の安全性	決定論的な制御 — --dry-run、--read-only、--confirm、--paper-trading は純粋なフラグであり、対話型プロンプトはありません
プログラムで解析できる出力	Unix に適した入出力 — 標準出力には JSON の結果（終了コード 0）、標準エラー出力には構造化エラー（終了コード 1）を出力します。jq に渡したり、終了コードで分岐したりできます

README の以降のセクションでは、それぞれについて詳しく説明します。最初の項目が、この仕組みの中核です。

---

段階的な情報開示 — 核となる考え方

AI エージェントのコンテキストウィンドウには限りがあります。Bitget のすべての操作とパラメーターを事前に読み込むと、その容量を無駄にするうえ、API が変更された瞬間に古くなります。代わりに bgc は自己記述型のインターフェースを公開し、エージェントが上から順にたどれるようにします。これから使う範囲だけを参照します。

bgc discover                               →  7 domains          market, trade, account, funds, subaccount, loan, tax
bgc discover --domain trade                →  3 verbs            order, position, strategy_order
bgc discover --tool order                  → 10 actions          place, cancel, modify, cancelAll, countdownCancel, open, detail, history, fills, maxOpen
bgc discover --tool order --action place   →  the exact contract  required + optional params · types · enums · auth · read/write

最後の段階で得られるのは、1 つのアクションに対する正確で機械可読な仕様です。

bgc discover --tool order --action place --pretty

{
  "tool": "order", "action": "place",
  "operationId": "placeOrder", "method": "POST", "path": "/api/v3/trade/place-order",
  "auth": "private", "isWrite": true,
  "required": [
    { "name": "category",  "type": "string", "enum": ["SPOT","MARGIN","USDT-FUTURES","COIN-FUTURES","USDC-FUTURES"] },
    { "name": "symbol",    "type": "string" },
    { "name": "side",      "type": "string", "enum": ["buy","sell"] },
    { "name": "orderType", "type": "string", "enum": ["limit","market"] },
    { "name": "qty",       "type": "string" }
  ],
  "optional": [
    { "name": "price", "type": "string" },
    { "name": "timeInForce", "type": "string", "enum": ["ioc","fok","gtc","post_only"] },
    { "name": "clientOid", "type": "string" },
    { "name": "takeProfit", "type": "string" }, { "name": "stopLoss", "type": "string" }
    /* … tp/sl trigger & limit params … */
  ]
}

これを使えば、エージェントはそのまま呼び出しを組み立てられます。フィールド名は同じ camelCase 形式で、変換レイヤーは不要です。

bgc order --action place --category SPOT --symbol BTCUSDT \
    --side buy --orderType market --qty 0.001 --dry-run

特にエージェントで機能する理由は、次の 2 つです。

• 自動で案内します。 すべての discover 応答に次の段階を示す hint フィールドが含まれるため、事前知識がまったくないエージェントでも、bgc discover だけでインターフェース全体をたどれます。
• ずれが発生しません。 開示されるスキーマは SDK からリアルタイムで導出されます。このリポジトリには同期がずれる可能性のある静的カタログはありません。discover が示す内容は、仕組み上、CLI が実行する内容と完全に一致します。

エージェントの考えが曖昧な場合でも、キーワードでインターフェース全体を検索できます。

bgc discover --search funding
# → matches: market (actions: fundingRate, fundingRateHistory), account_overview, …

---

インストール

ステップ 1 — CLI をインストールする

npm install -g @bitget-ai/bitget-agent-cli

これにより、システムの PATH に bgc が追加されます。

ステップ 2 — スキルファイルを配置する

npx @bitget-ai/bitget-agent-skill --target all

Claude Code、Codex、OpenClaw に同時に配置します。特定のツールを指定するには、--target claude または --target codex を使用します。

ステップ 3 — 認証情報を設定する

# Add to ~/.bashrc, ~/.zshrc, or similar
export BITGET_API_KEY="your-api-key"
export BITGET_SECRET_KEY="your-secret-key"
export BITGET_PASSPHRASE="your-passphrase"

シェルを再読み込みします。

source ~/.bashrc  # or source ~/.zshrc

ステップ 4 — 接続をテストする

# Public data (no auth needed)
bgc market --action tickers --category SPOT --symbol BTCUSDT

# Private data (requires auth)
bgc account_overview --coin USDT

---

コマンド

文法

bgc <tool> [--action <name>] [--<param> <value> ...] [global flags]
bgc discover [--domain <d> | --tool <t> [--action <a>] | --search <q>]
bgc raw --operationId <id> [--args '<json>']

• <tool> は意図動詞（market、order、position など）、メタツールの discover／raw、または --full を指定した場合は、1:1 で生成される任意の操作です。
• --action <name> は、アクションルーティング方式の動詞でアクションを選択します（例：order --action place、order --action cancelAll）。SDK にそのまま転送されます。（account_overview、discover、raw では --action を指定しません。）
• 業務パラメーターは、SDK の正確な camelCase フィールド名を使ってそのまま転送します：--symbol BTCUSDT --side buy --orderType market --qty 0.001。値は自然な形式に変換されます。true／false はブール値に、[／{ で始まる値は解析済みの JSON に変換され（例：--orders '[{...}]'）、それ以外はすべて文字列のままです（数値は SDK が変換するため、数値 ID を誤った型で渡すことはありません）。

コマンドリファレンスを頭に入れておく必要はありません。bgc discover 自体がリファレンスであり、古くなることもありません。

意図動詞（7 ドメインにわたる 14 個）

デフォルトの（intent）インターフェースでは、7 ドメインにわたる 14 個の意図動詞を利用できます。そのうち 13 個はアクションルーティング方式（--action で操作を選択）で、残る 1 個は単一呼び出しの account_overview です。これらに discover／raw のメタツールが加わります。

ドメイン	動詞	認証	説明	例
market	market	公開	ティッカー、オーダーブック、ローソク足、ファンディングレート、未決済建玉、直近の約定	bgc market --action tickers --symbol BTCUSDT
trade	order	プライベート	注文の発注、キャンセル、変更、全キャンセル、カウントダウン、オープン注文／詳細／履歴／約定	bgc order --action place --side buy --qty 0.1
trade	position	プライベート	ポジション情報、履歴、ADL ランク、決済、全決済	bgc position --action info --category USDT-FUTURES
trade	strategy_order	プライベート	ストラテジー（トリガー／プラン）注文：発注、キャンセル、変更、オープン注文、履歴	bgc strategy_order --action open
account	account_overview	プライベート	1 回の呼び出しでアカウントのスナップショットを取得（資産＋設定＋ファンディング資産＋ポジション＋手数料）	bgc account_overview --coin USDT
account	account_config	プライベート	アカウント設定と API キー情報	bgc account_config --action info
account	repayment	プライベート	クロスマージン／分離マージンの返済	bgc repayment --action repay --coin USDT
funds	transfer_funds	プライベート	アカウント間の資金移動	bgc transfer_funds --fromAccountType spot --toAccountType futures --amount 100
funds	deposit	プライベート	入金アドレスと記録	bgc deposit --action address --coin USDT
funds	withdraw	プライベート	出金を申請（高リスク、--confirm）	bgc withdraw --action submit --coin USDT --amount 100
funds	funds_records	プライベート	振替／入金／出金の履歴	bgc funds_records --action list
subaccount	subaccount	プライベート	サブアカウントとその入金を管理	bgc subaccount --action list
loan	loan	プライベート	暗号資産ローンの借入／返済	bgc loan --action borrow --coin USDT
tax	tax	プライベート	取引の税務記録を照会	bgc tax --action history --year 2024

厳選された動詞でカバーされていない操作には、raw --operationId <id> を使用してください。

グローバルフラグ

フラグ	目的	例
--action <name>	アクションルーティングされた動詞で実行するアクション	bgc order --action place
--modules <list>	有効にするモジュール（デフォルト：すべてのto-Cモジュール）	bgc --modules account,trade ...
--surface <mode>	intent（デフォルト） | full（1:1の操作も公開）	bgc --surface full discover
--full	--surface fullの省略形	bgc --full discover
--read-only	すべての書き込みをブロックします（--paper-tradingとは併用できません）	bgc --read-only market ...
--paper-trading	書き込みをBitgetのデモ環境にルーティングします（デモ用認証情報が必要です）	bgc --paper-trading order ...
--dry-run	書き込みを送信せずにプレビューします	bgc order --action place ... --dry-run
--confirm	破壊的（高リスク）な書き込みに必要です	bgc order --action cancelAll ... --confirm
--base-url <url>	APIのベースURLを上書きします（指定がない場合はBITGET_API_BASE_URL）
--timeout <ms>	リクエストごとのタイムアウト（ミリ秒単位。指定がない場合はBITGET_TIMEOUT_MS、デフォルトは15000）
--pretty	JSON出力を整形します	bgc market ... --pretty
--help	ヘルプを表示します（動詞の一覧はSDKからリアルタイムで取得されます）	bgc --help
--version	バージョンを表示します	bgc --version

環境変数

BITGET_API_KEY        API key      ┐
BITGET_SECRET_KEY     API secret   ├─ required only for private (account / trade) calls
BITGET_PASSPHRASE     passphrase   ┘
BITGET_API_BASE_URL   override the API base URL (else --base-url, else Bitget default)
BITGET_TIMEOUT_MS     per-request timeout in ms (else --timeout, default 15000)

認証情報は環境変数からのみ読み込まれます。ログに記録されることも、ディスクに書き込まれることもありません。

実際の使用例

# Get BTC live price (no auth)
bgc market --action tickers --category SPOT --symbol BTCUSDT

# Check USDT balance (one-call snapshot)
bgc account_overview --coin USDT

# Preview a limit buy (dry run — nothing leaves the process)
bgc order --action place --category SPOT --symbol BTCUSDT \
  --side buy --orderType limit --price 60000 --qty 0.001 --dry-run

# Execute the order
bgc order --action place --category SPOT --symbol BTCUSDT \
  --side buy --orderType limit --price 60000 --qty 0.001

# Cancel a specific order
bgc order --action cancel --category SPOT --orderId 123456789

# Check futures positions
bgc position --action info --category USDT-FUTURES

# Set leverage to 10x
bgc position --action setLeverage --category USDT-FUTURES \
  --symbol BTCUSDT --leverage 10 --marginCoin USDT

# High-risk: cancel all orders (requires confirmation)
bgc order --action cancelAll --category SPOT --symbol BTCUSDT --confirm

# Pipe to jq for processing
bgc market --action tickers --category SPOT --symbol BTCUSDT | jq '.data[0].lastPr'

# Explore available actions for a tool
bgc discover --tool order --action place

# Escape hatch: call any operation by ID
bgc raw --operationId getTickers --args '{"category":"SPOT","symbol":"BTCUSDT"}'

---

書き込みの安全性

bgcは、SDKの多層的な書き込み安全性ゲートを継承しています。安全性に関するすべての判断は、リクエストがプロセスの外部へ送信される前に行われます。また、すべての制御は決定的なフラグであり、対話型のプロンプトはありません。そのため、無人環境やAI駆動のシェルでも安全に使用できます。

制御	効果
--dry-run	書き込みをプレビューし、送信されるはずの正確なペイロード（data.dryRun: true）を返します。ネットワーク呼び出しは行いません。
--read-only	検証時にすべての書き込みをブロックします。書き込み動詞はValidationErrorを返し、ネットワークには到達しません。
--confirm	破壊的／高リスクなアクション（order --action cancelAll、position --action closeAll、withdraw --action submitなど）に必要です。指定しない場合、呼び出しはdata.confirmationRequired: trueを返し、何も実行しません。
--paper-trading	書き込みをBitgetのデモ環境にルーティングします（デモ用認証情報が必要です）。--read-onlyとは併用できません。

# Dry-run: see what would be sent, send nothing
bgc order --action place --category SPOT --symbol BTCUSDT \
    --side buy --orderType market --qty 0.001 --dry-run

# Read-only: writes are refused before the network
bgc --read-only order --action place --category SPOT --symbol BTCUSDT --side buy ...
# → ValidationError: Operation "placeOrder" is a write and readOnly mode is enabled.

# High-risk gate: cancelAll does nothing until you confirm
bgc order --action cancelAll --category SPOT --symbol BTCUSDT
# → { data: { confirmationRequired: true, ... } }     (stdout, exit 0 — not an error)
bgc order --action cancelAll --category SPOT --symbol BTCUSDT --confirm
# → executes

---

出力仕様

• 成功 → 解決済みのToolResult（{ endpoint, requestTime, data }）がstdoutに出力され、終了コードは0です。dryRunのプレビューとconfirmationRequiredのゲートも正常な結果（stdout、終了コード0）であり、エラーではありません。
• 失敗 → 構造化されたエラーペイロード（{ ok: false, error: { type, category, message, suggestion, retryable }, timestamp }）がstderrに出力され、終了コードは1です。

成功時の出力はコンパクトなJSONです（2スペースのインデントを付けるには--prettyを追加します）。エラーペイロードは常に整形して出力されます。この出力分離はUnix環境に適しており、stdoutをjqにパイプしたり、終了コードに基づいて処理を分岐したり、error.retryableを確認して待機後に再試行するか判断したりできます。

---

bgcの仕組み

bgcは、Bitget Agent SDKを包む、薄いビジネスロジックを一切持たないシェルラッパーです。ルーティング、検証、書き込みの安全性、正規化、そしてディスカバリー機能自体はすべてSDKにあります。CLIが行うのは、argvを解析し、設定された機能を構築して呼び出しを転送し、結果を出力することだけです。

Terminal AI (Claude Code / Codex / OpenClaw)
        │  natural language → bgc … command
        ▼
bgc CLI  (argv → tool call → JSON on stdout / error on stderr)
        │
        ▼
@bitget-ai/bitget-agent-sdk  (intent verbs, action dispatch, progressive
        │                      discovery, write-safety, REST client, HMAC
        │                      signing, rate limiting)
        ▼
Bitget UTA (v3) REST API   (api.bitget.com)

ディスカバリーと安全性のロジックはSDKにあるため、CLIは新しい操作、パラメーター、ゲートを追加の作業なしで利用できます。仕様が変更されると、ここでコードを変更しなくても、その変更はbgc discoverに反映されます。各コマンドは、署名付きHTTPSリクエストを1つだけ生成します。テレメトリーも、プロキシも、リモート依存関係もありません。

---

bgc の役割

bgc は、シェルをすでに使っている AI アシスタント（Claude Code、Codex CLI、OpenClaw）が、追加の連携設定なしで Bitget を操作できるようにするためのものです。LLM が bgc … コマンドを書き、シェルが実行すると、JSON が返されます。

• MCP を使いたいですか？（Claude Desktop、Cursor、Continue、ChatGPT Desktop、Windsurf）→ @bitget-ai/bitget-agent-mcp — 同じ操作体系を MCP 形式で提供します。

• コマンドをひとつずつ教えなくても、アシスタントに bgc をいつ使うべきか 理解させたい場合は、Bitget Agent Skill を追加でインストールします。

  npx @bitget-ai/bitget-agent-skill --target all
  

  その後、「Bitget で BTC を 0.1、成行で買って」 や 「保有中の先物ポジションを表示して」 と伝えると、適切な bgc の呼び出しを組み立てます。

---

セキュリティ

認証情報の保護

• ✅ 環境変数のみ：API キーは BITGET_API_KEY、BITGET_SECRET_KEY、BITGET_PASSPHRASE から読み取られます。.env ファイルから読み取ることはなく、ログへの記録やディスクへの書き込みも行いません。
• ✅ ローカル署名：認証が必要なすべてのリクエストは、Bitget の API に送信される前に、プロセス内で HMAC-SHA256 によって署名されます。
• ✅ テレメトリーなし、プロキシなし：すべてのコマンドは、署名済み HTTPS リクエスト 1 件に変換され、api.bitget.com に直接送信されます。サードパーティのサーバーは介在しません。

安全機能

• --read-only モード：検証時にすべての書き込みツールを除外します。書き込み操作の動詞を指定すると ValidationError が返され、ネットワークには送信されません。AI は注文の発注、送金、キャンセルを確認することも実行することもできません。
• --dry-run：送信されるはずの正確なペイロードをプレビューします。ネットワーク呼び出しは行いません。
• --confirm による確認：リスクの高い操作（cancelAll、closeAll、withdraw、…）は confirmationRequired: true を返し、--confirm が渡されるまでは実行されません。
• --paper-trading：書き込み操作の送信先を Bitget のデモ環境にします。
• クライアント側のレート制限：AI が誤ってループし、Bitget の API 制限に達するのを防ぎます。

ベストプラクティス

1. まずデモ API キーを使います。bitget.com/api-management で作成し、--paper-trading を使ってテストしてください。
2. まず --read-only で開始します：書き込みを有効にする前に、クエリが動作することを確認してください。
3. 認証情報を絶対にコミットしないでください：BITGET_* 変数はリポジトリ外のシェルプロファイルに追加するか、シークレットマネージャーを使用してください。プロジェクトにコミットする .env ファイルには記載しないでください。
4. キーを定期的にローテーションします：API キーを 90 日ごとに再生成してください。

---

トラブルシューティング

「bgc: command not found」

原因：CLI がグローバルにインストールされていないか、npm のグローバル bin が $PATH に含まれていません。

解決方法：

npm install -g @bitget-ai/bitget-agent-cli
which bgc

それでも見つからない場合は、npm のグローバル bin を PATH に追加してください。

# macOS / Linux
export PATH="$(npm config get prefix)/bin:$PATH"
# Add to ~/.bashrc or ~/.zshrc

「Authentication failed」または「Invalid signature」

考えられる原因：

1. API キーの権限が不十分です（プライベートな呼び出しには Read + Trade が必要です）。
2. パスフレーズが正しくありません（大文字と小文字が区別されるため、正確にコピーしてください）。
3. システム時刻がずれています（HMAC には正確なタイムスタンプが必要です）。

解決方法：

• bitget.com/api-management で Read + Trade 権限を確認してください。
• 3 つの認証情報すべての値を再確認してください。
• システム時刻を同期します：sudo sntp -sS pool.ntp.org（macOS）／sudo ntpdate -s pool.ntp.org（Linux）。

「Skill not recognized by AI」

原因：スキルファイルがデプロイされていないか、デプロイ後に AI ツールが再起動されていません。

解決方法：

1. スキルを再デプロイします：npx @bitget-ai/bitget-agent-skill --target all
2. AI ツール（Claude Code／Codex CLI）を再起動します。
3. AI に 「利用可能な Bitget の取引モジュールは何ですか？」 と尋ねます。bgc discover が報告するドメインが一覧表示されるはずです。

「Rate limit exceeded」

原因：短時間に API 呼び出しを行いすぎています。CLI はクライアント側でスロットリングしますが、Bitget のサーバー側の制限に達する場合もあります。

解決方法：60 秒待ってから再試行してください。AI に短時間で数百件の注文を実行するよう依頼するのは避けてください。

「Module not loaded」エラー

原因：有効な設定で有効になっていないモジュールを使用しようとしています。

解決方法：

# Load specific modules
bgc --modules account,trade,market ...

# Or load every module
bgc --modules all ...

---

更新

最新バージョンに更新します：

npm install -g @bitget-ai/bitget-agent-cli@latest
npx @bitget-ai/bitget-agent-skill@latest --target all

リリース履歴については、CHANGELOG.md をご覧ください。

---

関連プロジェクト

パッケージ	用途	最適な用途
bitget-agent-cli（このリポジトリ）	シェル CLI（bgc） — 89 個の UTA v3 操作を実行する 14 個のインテント動詞	Claude Code、Codex CLI、OpenClaw
bitget-agent-mcp	MCP サーバー — 同じインテントを MCP 形式で提供	Claude Desktop、Cursor、Continue、Windsurf
bitget-agent-skill	AI 推論ガイド — bgc を使うタイミングを AI に教えます	bgc または MCP サーバーと併用
bitget-agent-sdk	TypeScript 基盤 SDK	カスタム統合を構築する開発者
bitget-signal	市場分析スキル（マクロ、オンチェーン、センチメント）	API キー不要
agent_hub	エコシステムの中心的なエントリーポイント	Bitget AI ツール全般の概要

---

FAQ

bitget-agent-cli とは何ですか？

bitget-agent-cli は Bitget の公式ターミナル AI 取引ツールです。Claude Code、Codex CLI、OpenClaw、その他のシェルベースの AI アシスタントが Bitget アカウントを操作するためのコマンドラインインターフェース（bgc）を提供します。Bitget Unified Trading Account（UTA／v3）API を基盤とし、14 個のインテント動詞を通じて、マーケットデータ、現物／先物取引、アカウント、資金、サブアカウント、ローン、税務の 7 つのドメインにわたる 89 個の操作を公開します。

bitget-agent-cli と bitget-agent-skill の両方が必要ですか？

はい。 ターミナル AI のユーザーは両方をインストールしてください。

• bitget-agent-cli は実行ツールです。リクエストに署名し、Bitget の API に送信します。
• bitget-agent-skill は AI の取扱説明書です。適切な bgc の呼び出しを、いつ、どのように組み立てるかを AI に指示します。

スキルがないと、AI はツールを持っていても、適切に使えない可能性があります。CLI がないと、スキルには呼び出す対象がありません。

Claude Desktop／Cursor を使っています。これをインストールすべきですか？

いいえ。 Claude Desktop と Cursor はデスクトップ AI ツールです。代わりに bitget-agent-mcp をインストールしてください。bitget-agent-cli はターミナル AI（Claude Code、Codex CLI、OpenClaw）向けに設計されています。

スキルが正しく読み込まれたか確認するにはどうすればよいですか？

AI に「bitget-agent-cli がサポートしている Bitget の取引モジュールは何ですか？」と尋ねてください。bgc discover が報告するドメイン（market、trade、account、funds、subaccount、loan、tax）が一覧表示されれば、スキルは有効です。bgc discover を直接実行して、現在利用できる機能を確認することもできます。

AI が誤って注文を出すのを防ぐにはどうすればよいですか？

--read-only を追加します：

bgc --read-only market --action tickers --symbol BTCUSDT

書き込み操作は検証時にブロックされます。書き込み動詞を実行すると ValidationError が返され、ネットワークには到達しません。

API キーは安全ですか？

はい。認証情報は次のように扱われます。

• 環境変数からのみ読み取られます。.env ファイルから解析されることも、ログに記録されることも、ディスクに書き込まれることもありません。
• HMAC-SHA256 を使ってローカルで署名されます。
• サードパーティのプロキシやテレメトリを介さず、api.bitget.com に直接送信されます。

実際の資金を危険にさらさずに練習できますか？

はい。ペーパートレードを利用してください。

1. Bitget で Demo API Key を作成します。
2. Demo の認証情報を環境変数に設定します。
3. bgc の呼び出しに --paper-trading を追加します。

すべての書き込み操作は Bitget のサンドボックス環境に送られます。

これと Bitget API を直接呼び出すことの違いは何ですか？

bgc には次の機能があります。

• 生のエンドポイントではなく、厳選された14個の意図を表す動詞を提供します。
• discover による段階的な情報開示に対応しています。エージェントはカタログ全体を読み込まずに、1つのアクションの正確な仕様を確認できます。
• HMAC 署名の自動処理とクライアント側のレート制限を備えています。
• スキルファイルによる自然言語での連携が可能です。
• 決定論的な書き込み安全機能（--dry-run、--read-only、--confirm、--paper-trading）を備えています。対話型のプロンプトがなく、無人のシェルでも安全に使用できます。
• Unix に適した入出力に対応しています。標準出力には JSON（終了コード 0）、標準エラー出力には構造化されたエラー（終了コード 1）を出力します。

API を直接呼び出すこともできますが、上記の機能はすべて自分で実装する必要があります。

bgc discover は何のためにありますか？

自己記述型のインターフェースです。bgc discover を実行するとドメインが一覧表示され、bgc discover --domain trade ではドメインの動詞が、bgc discover --tool order では動詞のアクションが一覧表示されます。bgc discover --tool order --action place を実行すると、1つのアクションで必須および任意のパラメーターを正確に確認できます。スキーマは SDK からリアルタイムで生成されるため、discover の表示内容は、CLI が実行する内容と必ず一致します。

無料ですか？

はい。MIT ライセンスで、無料で利用できます。Bitget が無償でメンテナンスしています。

更新するにはどうすればよいですか？

上記の更新をご覧ください。

---

コントリビューション

Issue とプルリクエストを歓迎します！提出する前に、コントリビューションガイドをお読みください。

• バグの報告：GitHub Issues
• 機能のリクエスト：GitHub Discussions
• セキュリティに関する問題：[email protected] までメールでご連絡ください（公開の場には投稿しないでください）

---

ライセンス

MIT ライセンス — 個人利用・商用利用ともに無料です。クレジット表記は推奨されますが、必須ではありません。

---

_{⚠️ リスクに関する免責事項：暗号資産の取引には大きなリスクが伴います。AI エージェントがお客様に代わって発注した注文については、お客様ご自身が責任を負います。実際の取引を始める前に、必ず --read-only と --paper-trading を使用して安全にリハーサルしてください。過去の実績は将来の成果を保証するものではありません。}

_{Bitget Agent Hub エコシステムの一部 · 取引スタック · サーフェス。
基盤：agent-sdk · その他のサーフェス：agent-mcp · agent-skill · 市場シグナル：bitget-signal}