메인 콘텐츠로 건너뛰기

Pi란

Pi는 터미널용 미니멀 오픈 소스 코딩 에이전트입니다. models.json에서 사용자 지정 엔드포인트를 읽으며, 모델마다 다른 API 프로토콜을 사용할 수 있습니다. 이 구성은 이 파일에 Capriole AI를 제공자 하나로 추가합니다.

사전 준비

시작하기 전에 다음이 있는지 확인하세요.

설치

공식 설치 스크립트로 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는 고정된 thinking 예산을 거부합니다.
  • contextWindow와 maxTokens는 Pi에 각 모델의 한도를 알려 줍니다.

Pi 실행

API key를 설정한 다음 프로젝트 디렉터리에서 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 docs, Choose a model, Pi configuration.
마지막 수정일 2026년 10월 20일