pi でカスタムプロバイダーを使って Claude を使う

pi コーディングエージェントに AI in IDE を Anthropic 互換のカスタムプロバイダーとして追加し、API キー 1 本で Claude Opus 5.5、Sonnet 5.5、Haiku 4.5 を使います。

2026-11-06 に @earendil-works/pi-coding-agent からインストールした pi で確認しました。以下のファイルで、pi -p が claude-sonnet-5-5 と claude-haiku-4-5-20251001 から応答を返しました。

かんたん設定

  1. API キーを作成。 API Keys を開いてキーを作り、AWSQ または CCMAX チャンネルを選びます。Codex や Gemini のキーは Claude エンドポイントで拒否されます。
  2. キーをエクスポート。 ~/.zshrc または ~/.bashrc に export AIINIDE_API_KEY="YOUR_DASHBOARD_API_KEY" を追加し、新しいターミナルを開きます。
  3. プロバイダーを追加。 ~/.pi/agent/models.json を作成、または既存内容に統合します。
1
{
2
  "providers": {
3
    "aiinide": {
4
      "baseUrl": "https://api.aiinide.com",
5
      "api": "anthropic-messages",
6
      "apiKey": "$AIINIDE_API_KEY",
7
      "models": [
8
        { "id": "claude-sonnet-5-5", "name": "Claude Sonnet 5.5", "reasoning": true, "input": ["text", "image"], "contextWindow": 200000, "maxTokens": 64000 },
9
        { "id": "claude-opus-5-5", "name": "Claude Opus 5.5", "reasoning": true, "input": ["text", "image"], "contextWindow": 200000, "maxTokens": 64000 },
10
        { "id": "claude-haiku-4-5-20251001", "name": "Claude Haiku 4.5", "input": ["text", "image"], "contextWindow": 200000, "maxTokens": 64000 }
11
      ]
12
    }
13
  }
14
}
  1. 確認。 pi --model aiinide/claude-sonnet-5-5 -p "Reply with exactly: OK" を実行します。応答は OK になり、リクエストは Usage に表示されます。

ベース URL はホスト名だけにする

"api": "anthropic-messages" のとき、pi は自分で /v1/messages を付けます。https://api.aiinide.com/v1 にすると /v1/v1/messages になり、404 Not Found ページが返ります。これは Claude Code と同じルールで、OpenCode とは逆です。

"apiKey": "$AIINIDE_API_KEY" は pi の起動時に環境変数から読まれるため、キーがファイルに残りません。models.json を編集した後は、セッションで /model を開くと再読み込みされます。

対応モデル

pi でのモデルチャンネル向いている用途
aiinide/claude-opus-5-5AWSQ、CCMAX難しいリファクタリング、長時間のエージェント実行
aiinide/claude-sonnet-5-5AWSQ、CCMAX日常のコーディング
aiinide/claude-haiku-4-5-20251001AWSQ、CCMAX素早い修正、安価な確認

キーを付けて GET /v1/models を呼ぶと、そのチャンネルが受け付けるすべてのモデル ID が返ります。どれでも models 配列に追加できます。ファイルに cost フィールドがないため、pi 自身のコスト表示は $0 のままです。実際の請求額は Usage、料金はモデルで確認してください。

よくある質問

pi で AI in IDE を使うにはどのベース URL が必要ですか。

https://api.aiinide.com と "api": "anthropic-messages" の組み合わせです。pi が /v1/messages を付けるので、自分で /v1 を加えると 404 が返ります。

models.json はどこにありますか。

~/.pi/agent/models.json です。PI_CODING_AGENT_DIR 環境変数を設定すると、エージェントのディレクトリ全体の場所が変わります。

pi が既定で Gemini を使い続けるのはなぜですか。

pi の既定プロバイダーが Google だからです。--model aiinide/claude-sonnet-5-5 を渡すか、セッションで /model からモデルを選んでください。

代わりに OpenAI 互換エンドポイントを使えますか。

使えます。"api": "openai-completions" と "baseUrl": "https://api.aiinide.com/v1" を指定します(こちらは /v1 が付く点に注意してください)。どちらも確認済みです。ただし Anthropic エンドポイントをおすすめします。Fast mode や hosted tools などの Claude 拡張機能に対応しており、OpenAI 互換エンドポイントはこれらに対応していません。

関連ページ

pi でカスタムプロバイダーを使って Claude を使う | AI in IDE