pi-mono: Claude Code 대안 AI 코딩 에이전트 5.9k 스타

작성자:

pi-mono: 터미널에서 AI 코딩 에이전트를 직접 만든다

  • GitHub Stars: 5.9k
  • 언어: TypeScript 96.5%
  • 라이선스: MIT

이 프로젝트가 뜨는 이유

Claude Code가 너무 복잡해졌다고 느낀 개발자가 있었다. Mario Zechner는 3년간 LLM 코딩 도구를 실험하다가 결국 직접 만들기로 했다.[Mario Zechner]

pi-mono는 “필요 없으면 안 만든다”는 철학으로 탄생한 AI 에이전트 툴킷이다. 시스템 프롬프트 1000토큰, 핵심 도구 4개(read, write, edit, bash)로 시작한다. Claude Code의 수천 토큰짜리 프롬프트와 비교하면 극단적으로 가볍다.[GitHub]

뭘 할 수 있나?

  • 통합 LLM API: OpenAI, Anthropic, Google, Azure, Mistral, Groq 등 15개 이상 프로바이더를 하나의 인터페이스로 사용한다
  • 코딩 에이전트 CLI: 터미널에서 대화형으로 코드를 작성하고, 테스트하고, 디버깅한다
  • 세션 관리: 작업을 중단했다가 이어서 할 수 있고, 브랜치처럼 분기도 가능하다
  • Slack 봇: 슬랙 메시지를 코딩 에이전트에게 위임한다
  • vLLM 파드 관리: GPU 파드에 자체 모델을 배포하고 관리한다
  • TUI/Web UI 라이브러리: 직접 AI 채팅 인터페이스를 만들 수 있다

빠른 시작

# 설치
npm install @mariozechner/pi-coding-agent

# 실행
npx pi

# 또는 소스에서 빌드
git clone https://github.com/badlogic/pi-mono
cd pi-mono
npm install && npm run build
./pi-test.sh

어디에 쓰면 좋을까?

Claude Code 월 20만 원이 부담스럽고, 터미널 중심으로 작업하는 개발자라면 pi가 대안이 될 수 있다. API 비용만 내면 되니까.

셀프호스팅 LLM을 쓰고 싶은데 기존 도구들이 잘 지원 안 한다면 pi가 답이다. vLLM 파드 관리 기능까지 내장되어 있다.

개인적으로는 “투명성”이 가장 큰 장점이라고 본다. Claude Code는 내부에서 뭘 하는지 보이지 않는 서브에이전트가 돌아간다. pi는 모든 모델 상호작용을 직접 확인할 수 있다.

주의할 점

  • 미니멀리즘이 철학이다. MCP(Model Context Protocol) 지원이 의도적으로 빠져 있다
  • “YOLO 모드”라고 부르는 전체 접근 권한이 기본값이다. 권한 체크가 Claude Code보다 느슨하니 주의
  • 아직 문서화가 부족한 편이다. AGENTS.md 파일을 꼼꼼히 읽어야 한다

비슷한 프로젝트

Aider: 마찬가지로 오픈소스 터미널 코딩 도구. 모델에 구애받지 않는다는 점이 비슷하지만, pi는 더 넓은 범위(UI 라이브러리, 파드 관리 등)를 커버한다.[AIMultiple]

Claude Code: 기능은 더 많지만 월정액 구독이 필요하고, 커스터마이징 한계가 있다. pi는 TypeScript 확장으로 자유롭게 기능을 추가할 수 있다.[Northflank]

Cursor: IDE에 AI가 통합된 형태. 터미널보다 GUI를 선호한다면 Cursor가 낫다.

자주 묻는 질문 (FAQ)

Q: 무료로 사용할 수 있나?

A: pi 자체는 MIT 라이선스로 완전 무료다. 다만 OpenAI, Anthropic 등 외부 LLM API를 쓰면 해당 비용이 발생한다. 로컬에서 Ollama나 셀프호스팅 vLLM을 쓰면 API 비용 없이 사용 가능하다.

Q: Claude Code 대신 쓸 만큼 성능이 나오나?

A: Terminal-Bench 2.0 벤치마크에서 Claude Opus 4.5를 붙인 pi가 Codex, Cursor, Windsurf와 경쟁할 만한 결과를 보였다. 미니멀한 접근이 성능을 깎지 않는다는 걸 증명했다.

Q: 한국어 지원은?

A: UI는 영어지만, 연결하는 LLM이 한국어를 지원하면 한국어로 대화하며 코딩할 수 있다. Claude나 GPT-4를 연결하면 한국어 프롬프트로 코드 작성이 가능하다.

이 글이 유용했다면 AI Digester를 구독해주세요.

참고 자료

댓글 남기기