Pi 서브에이전트 확장 프로그램 설치 방법 및 이유
How (and why) so install a pi subagents extension
핵심 요약
Pi 에이전트의 컨텍스트 관리를 효율적으로 돕는 서브에이전트 확장 프로그램 설치 가이드.
- 서브에이전트 활용 — 복잡한 작업을 분리하여 메인 컨텍스트를 깔끔하게 유지함.
- 확장 프로그램 추천 — 사용자들이 유용한 Pi 확장 프로그램들을 공유함.
- 토큰 효율성 논쟁 — 서브에이전트와 MCP 사용 시 발생하는 토큰 소모에 대해 의견이 갈림.
- 캐시 성능 이슈 — 시간 정보 주입 확장 프로그램이 캐시 적중률을 떨어뜨릴 수 있음.
한동안 이거 없이 Pi를 썼는데, 다른 코딩 에이전트들로 서브 에이전트 맛을 좀 보고 나니까... 음, Pi에선 진짜 뭐가 빠진 것 같은 느낌이 들더라고.
tintinweb/pi-subagents 패키지를 골랐는데, 서브 에이전트 구현 방식이 맘에 들어서야. claude code랑 같은 스타일인데, 이게 진짜 직관적이거든.
pi install npm:@tintinweb/pi-subagents
서브 에이전트 사용법
pi-subagents를 쓰면 Pi가 작업을 별도 컨텍스트로 넘겨서 처리할 수 있어.
난 주로 레포 탐색이나 의존성 체크할 때 써. 안 그러면 메인 컨텍스트가 파일 목록이랑 툴 출력값 수천 줄로 꽉 차버리거든.
예를 들어, 설치하고 나서 레포에서 Pi를 켜고 이렇게 물어보면 돼:
4개의 서브 에이전트를 써서 src 폴더를 병렬로 탐색해 줘.
결과를 취합해서 짧게 요약해 줘.
Pi가 잡일은 격리된 에이전트한테 던져버리고, 메인 에이전트한테는 딱 필요한 결과만 가져다주니까 메인 컨텍스트가 아주 깔끔해지지.
/agents 명령어로 서브 에이전트 타입마다 모델을 바꿀 수도 있어. 탐색 전용으로 미리 설정된 서브 에이전트도 있고.
여담인데, 기본 탐색 서브 에이전트에 함정이 하나 있어. 기본값이 haiku로 잡혀 있거든. 난 gpt-5.6-terra를 쓰고 있어서 당연히 그걸 쓸 줄 알았는데, 알고 보니 내 opencode API 토큰으로 haiku를 돌리고 있더라고. gpt-5.6-luna로 바꾸는 건 성공했어. 혹시 필요할까 봐 설정 방법 영상 남겨둘게:
Pi에 부족한 또 다른 기능
바로... MCP지. 당연한 거 아냐? 그래서 하는 김에 MCP 확장 기능도 Pi에 달아줬어. 뭐, 다들 알다시피 필수잖아. 에이전트 스킬만으로도 98%는 커버가 되는데, 가끔은 꼭 MCP가 필요한 순간이 오거든.
서브 에이전트랑 MCP 확장 기능 설치하고 테스트해 본 더 자세한 경험담이 궁금하면 내 블로그 글 확인해 봐:
https://zazencodes.com/blog/upgrade-your-pi-agent-with-subagents-mcp
다들 즐겁게 쓰고, 여기까지 읽었으면 너희는 어떤 확장 기능을 제일 잘 쓰는지 궁금하네. 댓글로 좀 알려줘. 한번 맛을 들이니까 더 욕심나네.
