핵심 요약: Pi와 Claude Code의 차이는 기본 제공 기능(Defaults)을 중시하느냐, 직접 제어할 수 있는 자유도(Control)를 중시하느냐로 귀결됩니다. Pi는 가볍게 설계된 MIT 라이선스의 무료 터미널 코딩 에이전트입니다. 서브 에이전트, 플랜 모드, 권한 승인 팝업 등을 과감히 생략하는 대신 TypeScript 확장 기능으로 원하는 기능을 직접 추가할 수 있도록 했습니다. 반면 Claude Code는 이러한 워크플로가 기본으로 내장되어 제공됩니다. Pi는 설치 비용이 들지 않으며(0달러), 연결한 모델 제공업체의 요금만 지불하면 됩니다.
이번 주 해커뉴스(Hacker News)에 올라온 “Goodbye Claude, hello Pi(Claude 안녕, Pi 반가워)”라는 제목의 게시물이 추천 수 700점과 430개 이상의 댓글을 기록했습니다. 터미널 프로그램 하나를 두고 개발자들 사이에서 상당한 논쟁이 벌어진 셈입니다. 매일 코딩 에이전트를 사용하는 개발자라면 이 논쟁 이면에 깔린 질문에 주목할 필요가 있습니다. 모델과 도구, 프롬프트를 감싸는 프로그램인 '하네스(harness)'를 내가 직접 구성하여 쓸 것인가, 아니면 제공되는 기본 환경을 그대로 받아들여 쓸 것인가?
이 가이드에서는 Pi가 무엇인지, 비용은 얼마나 들고 어떻게 설정하는지 살펴보며, 해당 스레드에서 양측이 제기한 불만을 포함해 Claude Code와의 솔직한 비교를 다룹니다. 마지막으로는 기존 워크플로를 다시 짤 필요 없이 두 에이전트를 함께 실행하는 방법을 소개합니다. Sharkly에서는 동일한 Computer 내에서 Pi와 Claude Code를 런타임(Runtime)으로 지원하기 때문입니다.
Pi 코딩 에이전트란 무엇인가?
Pi는 "사용자가 직접 원하는 대로 구성할 수 있는 미니멀하고 확장 가능한 에이전트 하네스"입니다. 터미널에서 실행되며, 파일을 읽고 편집하고, 명령어를 실행하며, 사용자가 선택한 모델과 상호작용합니다. Mario Zechner가 pi-mono 저장소에서 시작한 프로젝트로, 현재는 Earendil 산하에서 관리되고 있으며 최신 npm 릴리스 버전은 1.5.0입니다.
Pi를 정의하는 네 가지 특징은 다음과 같습니다.
- 모델 제공업체에 종속되지 않음(Provider neutral). Pi 공식 사이트에는 Anthropic, OpenAI, Google, Bedrock, Mistral, Groq, OpenRouter, Ollama 등 15개 이상의 제공업체와 수백 개의 모델이 나열되어 있습니다. 세션 도중에도
/model명령어로 모델을 변경할 수 있습니다. - 의도된 가벼움(Deliberately small). 공식 사이트의 '우리가 만들지 않은 기능(What we didn't build)' 목록에는 서브 에이전트, 권한 승인 팝업, 플랜 모드, 내장 To-do 목록, 백그라운드 bash 등이 명시되어 있습니다.
- TypeScript 기반의 확장성(Extensible in TypeScript). 확장 기능을 통해 도구, 명령어, 단축키, 모델 제공업체, 터미널 UI를 직접 등록할 수 있습니다. 스킬, 프롬프트 템플릿, 테마는 npm이나 git을 통해 Pi 패키지로 배포할 수 있습니다.
- 스크립트 작성 가능(Scriptable). 대화형 TUI뿐만 아니라 출력 및 JSON 모드(
pi -p), stdin 및 stdout 기반의 RPC 프로토콜, TypeScript SDK를 지원합니다.
세션이 트리 구조로 저장되므로, /tree 명령어를 통해 이전 시점으로 돌아가 새로운 브랜치를 만들어 작업을 이어갈 수 있습니다. 해커뉴스 댓글 중에는 "이제 /tree 없이는 작업할 수 없을 정도"라는 평도 있었습니다.
Pi는 무료인가요?
그렇습니다. Pi는 MIT 라이선스이며 설치 비용은 무료(0달러)입니다. 비용은 사용하는 모델에 대해서만 발생합니다. 퀵스타트 문서에 따르면 모델 접근은 "지원되는 제공업체를 통해 이루어져야 하며, 이는 구독 요금제, API 키 또는 로컬 모델일 수 있습니다."
이에 따라 세 가지 비용 지불 방식이 가능합니다.
| 방식 | 지불 비용 | 설정 방법 |
|---|---|---|
| API 키 | 제공업체의 토큰당 요금 | export ANTHROPIC_API_KEY=... then pi |
/login을 통한 구독 연결 |
기존에 이용 중인 요금제 | /login, pick a provider, follow the OAuth flow |
| 로컬 모델 (Ollama, llama.cpp) | 보유한 하드웨어 리소스 | Point Pi at the local server |
단, 구독 방식을 선택할 때는 주의할 점이 있습니다. Claude Code를 옹호하는 한 댓글 작성자는 서드파티 하네스에서 구독 요금제를 사용할 경우 "서비스 약관(ToS) 위반으로 인한 계정 정지 가능성"이 있다고 지적했습니다. Pi 공식 문서에서는 이 문제에 대해 명확한 결론을 내려주지 않습니다. 유료 요금제로 로그인하기 전에 해당 제공업체의 약관을 확인하거나, 이러한 모호함이 없는 API 키를 사용하는 것이 안전합니다.
Pi 설정 방법
Node.js 22.19 이상 버전이 설치되어 있다면 두 개의 명령어로 설정을 마칠 수 있습니다.
# Option 1: the installer (pins dependencies, updates with `pi update`)
curl -fsSL https://pi.dev/install.sh | sh
# Option 2: npm
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
# Start it in your project
cd ~/code/my-service
pi
Pi 실행 후 /login을 실행하여 제공업체를 연결하고, /model을 실행하여 모델을 선택합니다. Pi는 AGENTS.md 및 CLAUDE.md 컨텍스트 파일을 로드하므로 Claude Code용으로 이미 설정된 저장소의 지침도 그대로 활용할 수 있습니다.
본격적인 작업을 시작하기 전에 Pi의 보안 문서를 읽어보는 것을 권장합니다. 문서에 따르면 Pi는 "매 도구 호출마다 승인을 요청하지 않으며", 프로그램을 실행한 계정의 권한 그대로 작동합니다. 또한 문서에서는 컨테이너, 가상 머신(VM), 또는 샌드박스를 사용하는 것이 "가장 현실적이고 강력한 방법"이라고 권장하고 있습니다.
Pi vs Claude Code: 솔직한 비교
Claude Code는 Anthropic이 개발한 코딩 에이전트입니다. 서브 에이전트, 훅(hooks), MCP, 플랜 모드, 위험한 작업 전에 확인을 거치는 권한 시스템 등을 기본 탑재하고 있습니다. 반면 Pi는 핵심 기능만 가볍게 제공하며, 필요한 기능은 사용자가 직접 추가하도록 설계되었습니다.
| Pi | Claude Code | |
|---|---|---|
| 라이선스 | MIT | Anthropic 독점 라이선스 |
| 지원 모델 | 15개 이상의 제공업체, 로컬 모델 | Claude 모델 |
| 서브 에이전트 | 기본 내장되지 않음 (확장 기능으로 추가) | 기본 내장 |
| 플랜 모드 | 기본 내장되지 않음 | 기본 내장 |
| 권한 승인 프롬프트 | 설계상 없음 (컨테이너 격리 권장) | 설정 가능한 승인 방식 |
| 커스터마이징 | TypeScript 확장 기능, 패키지 | 훅(Hooks), MCP, 스킬, 설정 |
| 헤드리스(Headless) 활용 | Print, JSON, RPC, SDK | Print 모드, Agent SDK |
개발자들이 Pi로 전환하는 이유
해당 스레드의 계기가 된 Caleb의 글 Goodbye Claude, hello Pi에서는 특정 버그 하나 때문이 아니라 "자잘한 불만들이 누적된 결과"라고 설명합니다. 구체적인 이유는 다음과 같습니다.
- 프롬프트의 잦은 변경(Prompt churn). 작성자에 따르면 올해 Claude Code 릴리스가 244회 있었는데, 그중 4분의 3 이상에서 시스템 프롬프트나 도구 설명이 변경되었다고 합니다. 이는 미세 조정한 환경에서 모델의 동작 방식을 뒤흔들 수 있습니다.
- 토큰 오버헤드(Token overhead). 기본 Bash 도구 설명만 해도 작성자 측정 기준 "거의 3,000토큰"에 달하며, 대부분 git과 풀 리퀘스트에 관련된 내용입니다.
- IDE 연동의 불편함(IDE friction). 한 번에 하나의 VS Code 세션만 연결할 수 있었습니다. 작성자는 Pi에서 약 20분 만에 확장 기능을 직접 작성하여 이 문제를 해결했습니다.
- 방대해진 기능 범위(Scope). 에이전트 팀이나 리뷰 모드 같은 기능들은 1인 개발자가 아닌 엔터프라이즈의 토큰 소비를 늘리기 위한 기능처럼 느껴진다는 설명입니다.
다른 댓글 작성자들은 터미널 렌더링 및 스크롤백 버그, 그리고 AGENTS.md 지원이 뒤늦게 추가된 점 등을 불만으로 꼽았습니다.
일부 개발자들이 Claude Code를 고수하는 이유
스레드에는 이에 반박하는 의견도 많았습니다. 한 작성자는 Pi가 Claude Code 수준의 역량을 갖추려면 "엄청난 수준의 해킹과 튜닝이 필요하다"며 확장 기능 사용이 "거의 필수적"이라고 언급했습니다. 또한 Claude Code가 Anthropic 모델에서 보여주는 컨텍스트 압축(Compaction)과 프롬프트 캐싱 성능을 더 높게 평가했습니다. 서드파티 확장 기능을 설치하는 것은 결국 내 OAuth 토큰에 접근할 수 있는 코드를 신뢰해야 한다는 위험이 따른다는 지적도 있었습니다.
비용 측면에서의 주장도 있습니다. 토큰당 과금에 비해 구독 요금제에서 "말도 안 될 만큼 파격적인 보조금 혜택(가성비)을 누리고 있다"는 이유로 Claude Code를 유지한다는 댓글도 있었습니다. 사용량 제한에 도달한 적이 있다면 각 요금제별 제한 사항을 다룬 Claude Code 사용량 제한 안내를 참고하시기 바랍니다.
나에게 맞는 선택은?
하네스를 직접 완전히 제어하고 싶고, 다양한 모델을 자유롭게 전환하며, 프롬프트를 가볍고 안정적으로 유지하고자 하고, 컨테이너 내에서 에이전트를 실행하는 데 익숙하다면 Pi를 선택하세요. 반면 설치 첫날부터 서브 에이전트, 플랜 모드, 승인 프롬프트가 즉각 작동하기를 원하고 주로 Claude 모델을 사용하는 편이라면 Claude Code가 적합합니다. 실제로 많은 개발자가 두 도구를 병행하여 사용하고 있으며, 다음 섹션에서 그 방법을 소개합니다.
Sharkly에서 Pi와 Claude Code 병행 실행하기
하네스를 바꾸는 것은 간단하지만, 하네스를 둘러싼 업무 시스템 전체를 바꾸는 것은 결코 쉬운 일이 아닙니다. 작업, 컨텍스트, 진행 상황, 리뷰 등이 특정 에이전트 세션에 묶여 있는 경우가 많아 에이전트를 바꾸면 워크플로 전체를 새로 구성해야 하기 때문입니다.
Sharkly는 에이전트 상위에 존재하는 플랫폼 레이어입니다. 사용자가 작업을 생성해 에이전트에 할당하면, 해당 에이전트는 Computer(연결된 노트북, 서버 또는 VM) 위에서 런타임(해당 환경에 설치된 코딩 에이전트)을 통해 작업을 수행합니다. Computer의 런타임 목록에는 이미 Claude Code가 포함되어 있으며, 지원되는 런타임 목록에 Pi도 표시됩니다.
직접 사용해 보려면 Computer에 Pi를 설치한 다음, Computer 상세 페이지에서 Detect again을 클릭하세요. Sharkly 문서에 상태별 설명이 나와 있습니다. 'Not installed'로 표시된 런타임은 해당 도구의 설치가 필요하며, 'Available' 상태인 런타임만 에이전트 작업을 실행할 수 있습니다.
# On the Computer that runs your agents
curl -fsSL https://pi.dev/install.sh | sh
sharkly computer register --install-token <install-token> # once per Computer
sharkly computer list # confirm it is online
그 후에는 단일 작업 보드에서 두 에이전트 모두에 작업을 전달할 수 있습니다. 예를 들어 복잡한 리팩터링 작업은 Claude Code 기반 에이전트에, 의존성 업데이트 작업은 Pi 기반 에이전트에 맡긴 뒤 두 결과물을 한곳에서 검토할 수 있습니다. Sharkly는 토큰을 자체 판매하지 않으므로, 모델 사용량은 각 런타임에 이미 연결된 요금제나 API 키에 따라 청구됩니다. 요금제 페이지(2026년 11월 9일 확인 기준)에 따르면 최대 5인 규모의 조직까지 무료(Free) 플랜을 0달러에 이용할 수 있습니다.
여러 에이전트를 동시에 실행하는 방법에 대한 자세한 내용은 여러 개의 Claude Code 에이전트 실행하기 가이드를 확인하세요.
실제 활용 구성 사례
- 비용에 민감한 1인 개발자: 탐색적 작업이나 가벼운 작업에는 로컬 모델을 연결한 Pi를 사용하고, 까다로운 대규모 리팩터링에는 Claude Code를 사용합니다.
- 팀원별 선호도가 갈리는 개발 팀: 일부 엔지니어는 Pi를, 일부는 Claude Code를 사용하되 모든 작업을 하나의 보드에서 관리하여 "그 작업 어느 세션에서 했더라?" 하고 찾을 필요가 없게 만듭니다.
- 자동화 파이프라인: 스크립트 기반 실행에 적합한 Pi의 JSON 및 RPC 모드를 활용하고, 그 결과를 단순 로그 파일 대신 작업 카드로 바로 피드백합니다.
결론
Pi와 Claude Code는 서로 다른 방향의 해답을 제시합니다. Pi는 사용자가 나머지 부분을 직접 구축할 준비가 되어 있을 때 하네스를 어디까지 작고 단순하게 만들 수 있는지를 묻고, Claude Code는 즉시 사용할 수 있는 완성형 워크플로를 얼마나 풍부하게 제공할 수 있는지를 묻습니다. 어느 한쪽만 고집할 필요는 없습니다. 지금 바로 Computer에 Pi를 설치하고 Sharkly에서 부담 없는 작업부터 할당해 보면서 Claude Code의 결과와 직접 비교해 보세요.
FAQ
Pi가 Claude Code보다 더 좋은가요?
어느 한쪽의 일방적인 승리는 아닙니다. Pi는 더 가볍고 특정 제공업체에 종속되지 않으며 확장성이 뛰어난 반면, Claude Code는 서브 에이전트, 플랜 모드, 승인 프롬프트가 기본 내장되어 있습니다. 나만의 맞춤형 워크플로를 구축하고 싶은지, 이미 잘 갖춰진 워크플로를 도입하고 싶은지에 따라 최선의 선택이 달라집니다.
Pi는 오픈소스인가요?
네, Pi는 MIT 라이선스를 따르며 소스 코드는 GitHub의 earendil-works/pi 저장소에 공개되어 있습니다. 연결해 사용하는 모델들은 각 제공업체의 라이선스 및 이용 약관을 따릅니다.
기존 Claude 구독 요금제를 Pi에서 사용할 수 있나요?
Pi의 /login 명령어는 내장된 제공업체에 대해 OAuth를 통한 구독 계정 연결을 지원합니다. 다만 일반 소비자용 요금제를 서드파티 하네스에서 사용할 경우 약관 위반 소지가 있는지 제공업체의 이용 약관을 사전에 확인하세요. API 키를 사용하면 이러한 약관 문제에서 자유롭습니다.
Pi는 MCP를 지원하나요?
네, 지원합니다. Pi 공식 사이트에 따르면 현재 MCP가 기본 내장되어 있으며, 기존 MCP 확장 기능 역시 계속 지원됩니다. 초기 버전에는 이 기능이 포함되지 않았습니다.
Pi가 CLAUDE.md를 읽을 수 있나요?
네, 가능합니다. Pi의 보안 문서에 따르면 AGENTS.override.md, AGENTS.md, CLAUDE.md 파일을 컨텍스트 파일로 로드하여 인식합니다.
개인 노트북에서 Pi를 실행해도 안전한가요?
Pi는 도구를 호출할 때마다 매번 승인을 거치지 않습니다. 따라서 공식 문서에서는 가장 현실적이고 안전한 보호 장치로 컨테이너, 가상 머신(VM), 또는 샌드박스 환경에서 실행할 것을 권장합니다.
Pi는 누가 만드나요?
Pi는 Mario Zechner가 개발을 시작했으며, 현재는 Earendil Inc.와 오픈소스 기여자들에 의해 관리 및 배포되고 있습니다.
