프로젝트 소개

pi-claude-bridge는 Anthropic의 Agent SDK를 통해 Claude Code를 통합하는 Pi 확장입니다. claude-agent-sdk-pi의 포크로 시작했으며, 스트리밍, MCP 도구 브리징, 사용자 정의 Pi 도구 브리징, 세션 재개 및 지속성, 컨텍스트 동기화, 사고 지원, 스킬 전달 및 다양한 정확성 수정을 추가합니다. 두 가지 주요 기능을 제공합니다. 첫째, 프로바이더: Claude 모델(Opus, Sonnet, Haiku)을 Pi의 모델 선택기에서 선택할 수 있으며, 도구 호출은 Pi의 TUI를 통해 흐릅니다. Pi의 도구는 Claude Code로 브리징되고, bash 명령은 기본 120초 타임아웃을 가지며, Pi 스킬은 Claude Code의 시스템 프롬프트에 복사되고, 턴 중 조종이 지원됩니다. 모델 목록은 pi-ai의 Anthropic 카탈로그에서 가져오므로, 해당 패키지를 업데이트하면 새로운 Claude 모델이 나타납니다. 확장된 1M 컨텍스트는 명시적인 모델 목록에 대해 활성화되며, 플랜 유형 및 추가 사용량 청구에 대한 구성 옵션이 있습니다. 목록에 없는 새 모델은 지원되지 않는 요청을 피하기 위해 200K로 시작합니다. 둘째, 선택적 AskClaude 도구를 통해 Pi 자체 LLM이 다른 프로바이더를 사용할 때 질문이나 작업을 Claude Code에 위임할 수 있습니다. read, none, full 모드를 지원하며, 모델 및 사고 노력 선택, 깨끗한 세션을 위한 isolated 플래그가 있습니다. 위임된 호출은 사용자의 전역 Claude 구성을 피합니다. 구성은 전역 또는 프로젝트 JSON 파일에 있으며, 도구 등록, 기본 모드, 플랜, 컨텍스트 처리, MCP 제한, 자동 메모리 및 Claude 실행 파일 경로를 다룹니다. 디버그 로깅은 환경 변수를 통해 활성화할 수 있으며, 브리지 로그와 쿼리별 Claude Code CLI 로그를 작성합니다. README는 알려진 문제를 문서화합니다: 세션이 필요 이상으로 자주 재구성되고 재구성은 프롬프트 캐시 측면에서 비용이 많이 듭니다; Claude Code가 만든 파일 편집은 재구성 간에 전달되지 않습니다; 이전 브리지 버전은 Pi 0.86에서 실패합니다; 내보낸 Anthropic 환경 변수는 Claude Code 자식 프로세스를 재정의할 수 있습니다. 또한 다른 확장 및 subagents 확장과의 호환성 주의 사항을 언급하고, 단위 및 통합 테스트 명령을 설명합니다.