AI エージェント向け:セットアップの手順ガイド — /docs/agents.md、ドキュメントのインデックス — /llms.txt。

Gonkaのモデルをあなたのツールに接続

OpenAIおよびAnthropic互換API。ツールを選んで、インストールコマンド・エージェント用プロンプト・動作確認を取得しましょう。

クイックファクト#

  • OpenAI APIクライアント用のベースURL: https://gate.joingonka.ai/v1
  • Anthropic APIクライアント用のベースURL(/v1なし): https://gate.joingonka.ai
  • キーはAuthorization: Bearer jg-…またはx-api-key: jg-…ヘッダーで渡します
  • 利用可能なモデル一覧: GET https://gate.joingonka.ai/v1/models
  • 推奨モデル: MiniMaxAI/MiniMax-M2.7

ツールを接続#

ツールを選ぶと、そのツール専用の3ステップが下に表示されます。インストーラーは下の表にあるツール(25個)を1コマンドで設定し、それ以外はガイドに沿って接続します。

Claude Code

  1. キー

    gate.joingonka.aiで登録し、マイページでキーを作成してください。 登録直後に3M分の無料トークンがアカウントに付与されます。

    APIキーを取得
  2. 接続

    インストーラーがClaude Codeを自動設定します。キーを非表示入力で尋ね、設定ファイルに書き込み、ゲートウェイへのリクエストで接続を確認します。

    Bash
    npx -y @joingonka/setup --tool claude-code --model MiniMaxAI/MiniMax-M2.7

    またはAIエージェントに設定を任せましょう。以下のプロンプトを送ってください:

    エージェント用プロンプト
    Claude CodeをJoinGonka Gateway(GonkaネットワークのOpenAIおよびAnthropic互換API)に、https://gate.joingonka.ai/docs/agents.mdの手順に従って接続してください。キーは私が渡します。リポジトリのファイルに保存したり、グローバル環境変数を変更したりしないでください。最後に短いリクエストで接続を確認し、結果を報告してください。

    ステップバイステップガイド: Claude Code。

  3. 確認

    アカウント残高 — このリクエストはトークンを消費しません:

    cURL
    curl -s https://gate.joingonka.ai/api/balance \
      -H "Authorization: Bearer $JOINGONKA_API_KEY"

    モデルへの短いリクエスト — ステータスコード200が返れば設定完了です:

    cURL
    curl -s https://gate.joingonka.ai/v1/chat/completions \
      -H "Authorization: Bearer $JOINGONKA_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"model": "MiniMaxAI/MiniMax-M2.7", "messages": [{"role": "user", "content": "Say OK"}], "max_tokens": 32}'

すべてのツール#

ツールタイプインストーラー
CursorIDE--tool cursor
Claude CodeCLIエージェント--tool claude-code
OpenClawCLIエージェント--tool openclaw
OpenCodeCLIエージェント--tool opencode
ContinueIDE--tool continue
ClineIDE--tool cline
AiderCLIエージェント--tool aider
LangChainフレームワーク—
n8nフレームワーク—
Open WebUIチャット—
LibreChatチャット—
HermesCLIエージェント--tool hermes
Kilo CodeIDE--tool kilo
Roo CodeIDE--tool roo
LlamaIndexフレームワーク—
PydanticAIフレームワーク—
Vercel AI SDKフレームワーク—
TanStack AIフレームワーク—
ZCodeCLIエージェント--tool zcode
JetBrainsIDE--tool jetbrains
Copilot BYOKIDE--tool copilot-byok
ZedIDE--tool zed
PiCLIエージェント--tool pi
Codex CLICLIエージェント--tool codex
DeepSeek HarnessCLIエージェント—
MiniMax CodeCLIエージェント--tool minimax-code
WarpCLIエージェント—
TraeIDE—
Cherry Studioチャット—
omp (Oh My Pi)CLIエージェント--tool omp
OpenHandsCLIエージェント—
Qwen CodeCLIエージェント--tool qwen-code
GooseCLIエージェント--tool goose
CrushCLIエージェント--tool crush
Zoo CodeIDE--tool zoo
Kimi CodeCLIエージェント--tool kimi-code
Factory DroidCLIエージェント--tool droid
MiMo CodeCLIエージェント--tool mimo-code

コードサンプル#

同じリクエストをOpenAI SDK、cURL、Anthropic SDKで。キーは環境変数JOINGONKA_API_KEYから取得します。

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://gate.joingonka.ai/v1",
    api_key=os.environ["JOINGONKA_API_KEY"],
)

response = client.chat.completions.create(
    model="MiniMaxAI/MiniMax-M2.7",
    messages=[{"role": "user", "content": "What is Gonka?"}],
)
print(response.choices[0].message.content)

ドキュメントセクション#

  • API — Gonka ネットワークのモデルを利用する OpenAI および Anthropic 互換 API のリファレンス:キー、パラメータ、ストリーミング、ツール、プラグイン。登録時には無料トークンも進呈。
  • モデル — Gonka ネットワークのモデルをひとつの API に:model フィールド用の id、コンテキスト、出力上限、料金、ステータス。同じオープンモデルを桁違いに安く。
  • エラーと制限 — ゲートウェイのエラーコード、リクエスト制限、タイムアウト:各レスポンスの意味と、リクエストを再試行すべきタイミングを解説。
  • 料金とアカウント — Gonka ネットワークのモデルをトークン単価で:始められる無料トークン、GNK・USDT・カードでのチャージ、すべて公開された手数料、そして支出を管理できるアカウント API。
  • エージェント向け — リンクを AI エージェントに渡すだけ。Claude Code、Cursor、Codex を Gonka ネットワークのモデルに自動で接続します:すぐ使えるプロンプト、ガイド、スキルを用意。