AI in IDE logoAI in IDE

사용자 지정 프로바이더로 pi에서 Claude 사용하기

pi 코딩 에이전트에 AI in IDE를 Anthropic 호환 사용자 지정 프로바이더로 추가해, API 키 하나로 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이 필요한가요?

"api": "anthropic-messages"와 함께 https://api.aiinide.com을 씁니다. 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, 호스팅 도구 같은 Claude 확장 기능을 지원하며, OpenAI 호환 엔드포인트는 이를 지원하지 않습니다.

관련 페이지

사용자 지정 프로바이더로 pi에서 Claude 사용하기 | AI in IDE