Pi + JoinGonka Gateway — 安価なインファレンス上のターミナルエージェント

Piは、2026年に最も急速に成長しているオープンソースのコーディングエージェントの一つである、ミニマルなターミナル用コーディングエージェントです。プロバイダーは ~/.pi/agent/models.json に宣言的に記述され、OpenAI CompletionsまたはAnthropic Messagesに対応したあらゆるエンドポイントが使用可能です。つまり、JoinGonka Gatewayは両方の方法で接続できます。分散型ネットワークGonkaのモデルはベンダーのカード価格の数百分の1のコストであり、開始時の 3M トークンは無料です。

Pi自体はnpmからインストールします： npm install -g --ignore-scripts @earendil-works/pi-coding-agent。パッケージ名は新しくなっています。プロジェクトは earendil-works/pi リポジトリに移転しており、以前のパッケージ @mariozechner/pi-coding-agent は非推奨となり更新されません。Piが古い名前でインストールされている場合は再インストールしてください。設定ディレクトリ ~/.pi/agent は移転後も変更されません。

クイックパス: インストーラー

最も簡単な方法は、当社のインストーラーを使用することです：

npx @joingonka/setup --tool pi

これにより、ネットワークの最新モデルを含むプロバイダーが ~/.pi/agent/models.json に書き込まれ、デフォルトモデルが ~/.pi/agent/settings.json に設定されます（ユーザーが自分で選択したモデルは上書きされません。明示的な --model minimax|deepseek|glm フラグでのみ変更されます）。また、ゲートウェイがキーとモデルを受け入れることをライブリクエストで確認します。設定ディレクトリが PI_CODING_AGENT_DIR 変数で移動されている場合、インストーラーもそこに書き込みます。キーは 0600 権限で設定ファイルにリテラルとして格納されるため、環境変数をエクスポートする必要はありません。

手動設定: models.jsonのプロバイダー

登録時に jg-… キーを取得し、~/.pi/agent/models.json にプロバイダーを追加してください:

`baseUrl`	`https://gate.joingonka.ai/v1`
`api`	`openai-completions`
`apiKey`	あなたのキー `jg-…` をリテラルで指定します。Pi は `$VAR`/`${VAR}` 参照や `!command` も理解しますが、リテラルなら環境変数をエクスポートしなくても動作します — ファイルのパーミッションは `0600` に保ってください
`models`	配列: `id`、`name`、`contextWindow`、`maxTokens`

ネットワークのモデルの正しい値: deepseek-ai/DeepSeek-V4-Flash-0731 — contextWindow 380000、maxTokens 32768。MiniMaxAI/MiniMax-M2.7 — contextWindow 200000、maxTokens 8192。zai-org/GLM-5.3-Flash — contextWindow 390000、maxTokens 8192。Pi のデフォルト値(128000/16384)はネットワークの実際のリミットと一致しないため、両方のフィールドを明示的に設定してください。デフォルトモデルは別のファイル — ~/.pi/agent/settings.json の defaultProvider と defaultModel フィールドにあります。確認方法: pi --list-models で追加したモデルが表示されるはずです。

代替手段としてのAnthropicパス

ゲートウェイはAnthropic Messagesもサポートしています: api: "anthropic-messages" および baseUrl: "https://gate.joingonka.ai" (/v1/messages パスなし) を設定してください。クライアント側で補完されます。日常的な作業にはOpenAIパスで十分ですが、Piの拡張機能がMessagesフォーマット専用の場合はAnthropicオプションが役立ちます。

セキュリティに関する注意

Piにはデフォルトで完全なpermissionレイヤーがありません。より強力なハーネスにあるような段階的な確認なしで、エージェントがターミナルでコマンドを実行します。特に自律的なマルチステップタスクでは、サンドボックス（コンテナまたは別ユーザー）で実行してください。これはPi自体の仕様であり、ゲートウェイの仕様ではありません。

モデルの選択とコストについて

3つのネットワークモデルはすべて、tool callingとstreamingをサポートしています。長いセッションや大規模なリポジトリにはDeepSeek V4 Flash（ネットワーク内で最も長いコンテキストの一つで、出力は最大32768）が適しています。MiniMax M2.7は万能型で、GLM-5.3 Flashはネットワーク最長のコンテキスト（390K）を持つ推論モデルです。回答前に推論を行うため、maxTokensを低く設定しないでください。料金は一律で、最新価格はゲートウェイの価格表で確認できます。

Piのミニマリズムでは不十分な場合は、そのフォークであるomp (Oh My Pi)を検討してください。宣言的プロバイダーという考え方は同じですが、モデルロール、言語サーバー、サブエージェントが追加されています。設定ファイルが異なるため、ompは個別に設定する必要があります。

Pi は ~/.pi/agent/models.json への1行の設定で JoinGonka Gateway に接続できます： baseUrl gate.joingonka.ai/v1, api openai-completions, キーのリテラル指定、contextWindow/maxTokens を含むモデル設定。さらに簡単なのは npx @joingonka/setup --tool pi です。サンドボックスでエージェントを実行し、無料スタートトークンで始めてください。

← Zed + JoinGonka Gateway — エディタ内での安価な推論 Codex CLI：サブスクリプションの代わりに独自のキーを使用 →

もっと知りたいですか？

他のセクションを探索するか、Gonkaを今すぐ獲得し始めましょう。

無料トークンを取得 →