AI in IDE logoAI in IDE

在 pi 中使用 Claude：自訂 provider 設定

把 AI in IDE 加進 pi coding agent，作為相容 Anthropic 的自訂 provider，用一把 API Key 使用 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 Key。 打開 API Keys 建立金鑰，渠道選 AWSQ 或 CCMAX。Codex 或 Gemini 金鑰會在 Claude 端點被拒絕。
  2. 匯出金鑰。 在 ~/.zshrc 或 ~/.bashrc 加入 export AIINIDE_API_KEY="YOUR_DASHBOARD_API_KEY"，然後開一個新的終端機。
  3. 新增 provider。 建立或合併 ~/.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。

Base 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 要用哪個 Base URL？

https://api.aiinide.com，搭配 "api": "anthropic-messages"。pi 會加上 /v1/messages；自己再加 /v1 會回傳 404。

models.json 在哪裡？

~/.pi/agent/models.json。PI_CODING_AGENT_DIR 環境變數可以移動整個 agent 目錄。

為什麼 pi 預設還是用 Gemini？

pi 的預設 provider 是 Google。請加上 --model aiinide/claude-sonnet-5-5，或在工作階段中用 /model 選擇模型。

可以改用相容 OpenAI 的端點嗎？

可以，使用 "api": "openai-completions" 與 "baseUrl": "https://api.aiinide.com/v1"（注意這裡要加 /v1）。兩種方式都測試過。建議使用 Anthropic 端點：它支援 Fast mode、託管工具等 Claude 擴充功能，相容 OpenAI 的端點不支援。

相關頁面

在 pi 中使用 Claude：自訂 provider 設定｜AI in IDE