Nanako0129/pilotfish

Multi-model orchestration layer for Claude Code — the frontier model plans, cheaper models execute, verification guards quality. One-prompt install.

해결하는 문제

pilotfish는 Claude Code를 위한 멀티 모델 오케스트레이션 레이어입니다. 모든 작업에 프런티어 모델(Fable 5 또는 Opus 등)을 사용할 때 발생하는 높은 토큰 비용과 쿼리 소진 문제를 해결합니다. 일상적인 작업은 더 작고 저렴한 모델(Sonnet 및 Haiku)로 라우팅하고, 고도의 지능이 필요한 계획 및 검증에는 고성능 모델을 예약함으로써 품질 저하 없이 비용을 절감하고 쿼터를 보존합니다.

작동 방식

~/.claude/ 디렉토리의 세 가지 구성 레이어를 사용하여 역할 기반 위임 시스템을 구현합니다:

  1. Machine Layer (settings.json): 기본 오케스트레이터 모델(예: opus) 및 폴백 체인을 설정합니다.
  2. Roles Layer (agents/*.md): 필요한 노력과 역량에 따라 특정 모델 티어(Haiku, Sonnet 또는 Opus)에 고정된 8개의 전문 에이전트(예: scout, executor, verifier)를 정의합니다.
  3. Policy Layer (CLAUDE.md): 특정 모델을 지정하지 않고 이러한 역할에 작업을 위임하는 방법에 대한 규칙을 정의합니다.

작업은 메인 오케스트레이터 세션에서 탐색, 실행 및 검증을 위한 전문 서브 에이전트로 흐릅니다. 예를 들어, 새로운 Opus 컨텍스트의 verifier 에이전트는 품질 보증을 위해 완료된 작업에 대해 검증을 수행합니다.

대상

소프트웨어 엔지니어링 작업에 계층적 모델 접근 방식을 사용하여 API 비용 또는 구독 쿼터를 최적화하려는 Claude Code 사용자(개발자).

주요 특징

  • 비용 인식 라우팅: 저부하 작업(심볼 조회 등)은 Haiku로, 중간 부하 구현은 Sonnet으로 라우팅하고, 계획 및 보안 검토는 Opus에서 유지합니다.
  • 독립적 검증: 새로운 컨텍스트를 사용하는 verifier 서브 에이전트를 사용하여 자기 비판(self-critique)보다 뛰어난 성능을 발휘합니다.
  • 우아한 성능 저하(Graceful Degradation): 모델 별칭과 폴백 체인을 사용하여 기본 모델을 사용할 수 없는 경우에도 시스템이 기능을 유지하도록 합니다.
  • 글로벌 설치: 전역 Claude 설정에 한 번만 설정하면 모든 프로젝트에 적용됩니다.
  • 구독 최적화: Claude 구독에서 사용할 수 있는 추가 Sonnet 전용 쿼터 버킷을 특별히 활용합니다.