メインコンテンツへスキップ

Pi とは

Pi は、ターミナル向けのオープンソースでミニマルなコーディング エージェントです。カスタム エンドポイントを models.json から読み込み、モデルごとに異なる API プロトコルを使えます。このセットアップでは、このファイルに Capriole AI を 1 つのプロバイダーとして追加します。

前提条件

始める前に、次を用意してください。

インストール

公式のインストール スクリプトで Pi をインストールします。
または、npm でインストールします(Node.js 22.19 以降)。

設定

モデルの検証

Pi 1.3.0 は、下記の設定を使い、「対応モデル」のすべてのモデルで、Capriole AI 経由のファイル読み取り、ファイル書き込み、最終回答の確認に合格しています。 ~/.pi/agent/models.json を作成または更新します。
次に、~/.pi/agent/settings.json で Capriole AI をデフォルトに設定します。
各設定の役割は次のとおりです。
  • プロバイダーの api は openai-completions のため、Grok、GLM、Kimi は Chat Completions を使います。GPT モデルはこれを openai-responses で上書きし、Claude モデルは anthropic-messages と /v1 なしの baseUrl で上書きします。
  • $CAPRIOLE_AI_API_KEY は環境変数からキーを読み取ります。
  • authHeader: true により、どのプロトコルでもキーが Bearer トークンとして送られます。これがないと、Claude モデルはキーを x-api-key ヘッダーで送りますが、Capriole AI はこれを受け付けません。
  • forceAdaptiveThinking により、Claude モデルは adaptive thinking を使います。Opus 5.5 は固定の思考予算を拒否します。
  • contextWindow と maxTokens は各モデルの上限を Pi に伝えます。

Pi を実行する

API キーを設定してから、プロジェクト ディレクトリから Pi を起動します。
/model でモデルを切り替えます。非対話で実行するには、print モードを使います。

対応モデル

openai-latest と claude-latest は、常に各ファミリーの最新の旗艦モデルを指します。

トラブルシューティング

Capriole AI のモデルが /model に表示されないのはなぜですか?

Pi は、キーを解決できるまでカスタム モデルを表示しません。Pi を起動する前に、同じシェルで CAPRIOLE_AI_API_KEY をエクスポートしてください。

Pi が認証エラーを返すのはなぜですか?

プロバイダーに "authHeader": true があることを確認してください。

Opus 5.5 が requires adaptive thinking で失敗するのはなぜですか?

Claude モデルのエントリーに "compat": { "forceAdaptiveThinking": true } があることを確認してください。

Claude のリクエストが Unsupported Claude Messages model で失敗するのはなぜですか?

anthropic-messages 上の Claude モデルには、claude-opus-5-5 などのプレフィックスなしの Claude ID が必要です。anthropic/ プレフィックス付きの ID は Chat Completions 用です。

注意事項

  • Capriole AI の別のモデルを追加するには、同じファミリーのモデルのエントリーをコピーして ID を変更します。GET https://api.caprioletech.com/v1/models ですべてのモデル ID を一覧できます。
  • 公式リファレンス: Pi、Pi のドキュメント、モデルを選ぶ、Pi の設定。
最終更新日 2026年10月20日