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 から応答を返しました。
かんたん設定
- API キーを作成。 API Keys を開いてキーを作り、AWSQ または CCMAX チャンネルを選びます。Codex や Gemini のキーは Claude エンドポイントで拒否されます。
- キーをエクスポート。
~/.zshrcまたは~/.bashrcにexport AIINIDE_API_KEY="YOUR_DASHBOARD_API_KEY"を追加し、新しいターミナルを開きます。 - プロバイダーを追加。
~/.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 }
- 確認。
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-5 | AWSQ、CCMAX | 難しいリファクタリング、長時間のエージェント実行 |
aiinide/claude-sonnet-5-5 | AWSQ、CCMAX | 日常のコーディング |
aiinide/claude-haiku-4-5-20251001 | AWSQ、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 互換エンドポイントはこれらに対応していません。