Pi vs Claude Code: 하네스를 빌릴 것인가 소유할 것인가
노마드 코더의 Pi 전환 영상을 출처로 삼아 하네스 비유와 확장 방식을 해설하고, Pi와 Claude Code 공식 문서에서 확인되는 통제 지점을 구분한다.

노마드 코더 Nomad Coders의 영상 「지난주에 클로드를 삭제했어.」를 바탕으로 Pi와 Claude Code의 하네스 설계를 살펴본다. 화자는 1년 넘게 Claude Code를 매일 기본 도구로 쓰다가 Pi로 옮긴 뒤 48시간 만에 Claude Code를 열지 않게 됐다고 소개한다. 이는 영상 화자의 경험이며, 아래 비교도 그 발언과 공개 문서의 범위에서 읽어야 한다.
영상의 하네스 비유
영상은 모델을 CPU, 컨텍스트 윈도우를 RAM, 하네스를 운영체제에 비유한다. 이 비유에서 하네스는 도구 호출과 대화 맥락의 정리를 맡는다. 화자는 Claude Code, Cursor, Open Code를 서로 다른 하네스의 예로 들며 같은 모델도 실행 환경에 따라 다르게 작동할 수 있다고 말한다. 작은 모델이 더 비싼 모델을 능가할 수도 있다는 대목은 화자의 주장이지, 이 글에서 검증한 성능 결과가 아니다.
영상은 기능이 갖춰진 우주선과 사용자가 조립하는 레고를 대비하며, 하네스를 ‘빌리는가 소유하는가’라는 표현으로 Pi의 확장성을 설명한다. 이 제목의 대비도 화자의 관점에서 가져온 것이다.
Pi의 확장 방식
화자는 Pi의 미니멀리즘과 사용자 확장을 강조한다(영상). Pi 공식 확장 문서에 따르면 확장은 TypeScript 모듈로 도구, 이벤트 처리기, 명령, 터미널 UI 등을 추가할 수 있다. 문서는 로컬 TypeScript 확장에 별도 컴파일 단계가 필요하지 않다고 설명한다. 공식 문서와 예제의 조회일은 2026-09-28이다.
영상에서는 테마를 만든 뒤 다시 불러오는 장면과, 위험한 셸 명령을 실행하기 전에 확인을 요구하는 확장을 시연한다(영상). 현재 Pi 공식 권한 게이트 예제도 tool_call 이벤트에서 bash 명령을 검사하고, 위험한 패턴이면 UI에서 선택을 받은 뒤 실행을 막을 수 있음을 보여준다. 이 예제는 영상의 시연을 이해할 자료이며 필자의 구현 사례가 아니다.
화자는 여러 제공자의 모델을 대화 중 전환할 수 있다고 설명하고, 본인은 Kimi K2를 기본으로, 어려운 작업에는 Open Code Zen을 통해 Opus를 쓴다고 밝힌다(영상). 영상이 설명하는 Pi 세션 트리의 브랜치와 공유 역시 화자가 제시한 기능이다. 이 글은 그 설명을 독립적인 사용·성능 검증 결과로 제시하지 않는다.
영상에서 든 시연은 두 가지다. 하나는 “synthwave 테마, 네온, 핑크, 시안”을 요청해 테마 파일이 만들어지고 /reload 뒤 인터페이스 색상이 바뀐 장면이다. 다른 하나는 bash 명령을 실행 전에 가로채 rm -rf 패턴을 확인하고, 확인 없이는 차단하는 가드레일을 약 10줄의 TypeScript로 작성한 장면이다. 화자는 폴더 삭제를 요청했을 때 확인 대화상자가 떴다고 설명한다. 필자는 이 두 시연을 직접 재현하지 않았고, 영상 자막을 정리한 원자료에 적힌 내용만 옮긴다.
세션 기록에 대해서도 화자는 Pi의 세션이 트리 구조로 저장돼, 툴 비용과 토큰 수를 대화 안에서 확인할 수 있고 이전 메시지에서 브랜치를 만들어 사이드 작업을 분리할 수 있다고 말한다. 이것도 화자의 설명이며, 세션 관리 방식의 장단점을 평가한 자료는 아니다.
Claude Code와 대조할 지점
화자는 Claude Code의 도구와 내부 동작이 릴리스마다 바뀐다고 보고, Pi에서 가능한 방식의 압축 제어와 테마·가드레일 확장이 Claude Code에는 없다고 평가한다(영상). 이는 영상의 평가다. 실제 비교에는 Claude Code가 제공하는 확장 지점도 따로 확인해야 한다.
Claude Code 훅 공식 문서는 도구 호출 전 차단 가능한 PreToolUse와 압축 전 실행되는 PreCompact를 설명한다. 공식 예제는 PreToolUse에서 파괴적인 셸 명령을 거부한다. PreCompact는 수동·자동 압축에 반응하며 압축을 막을 수 있다. 세션 중 모델을 바꾸는 /model 명령도 같은 공식 문서에 나온다. 이 문서상의 가능성을 필자가 Pi 기능을 Claude Code로 옮겨 시험했다는 뜻으로 읽어서는 안 된다.
내 운영 기록에는 메인 에이전트가 도구 호출 직전 벤더 CLI 직접 호출 차단 훅을 작성해 설정한 세션이 남아 있다. 이 첫 번째 훅은 15가지 입력의 파이프 테스트를 통과했고 실제 호출도 차단됐다고 기록돼 있다. 이 기록의 훅 작업은 Pi 사용이나 Pi에서 아이디어를 옮긴 경험이 아니며, 첫 번째 차단 훅의 15가지 입력 테스트와 실제 차단 기록은 Claude Code 권한 게이트 글에 정리했다.
이와 별개로 작성 전용 에이전트의 실행 격리를 강제하는 두 번째 차단 훅은 이후 상위 노력 모델의 재검증에서 발견된 우회 4건이 모두 폐쇄됐다고 기록돼 있다. 이 훅은 Codex 작업 기록의 block-unsafe-omx-exec 항목으로, 1라운드에 처음 만들어졌다. 이 기록은 Claude Code 훅의 동작 검증이 아니며, Pi 사용 경험과도 무관하다. 훅으로 무엇을 막을 수 있는지 감을 잡는 참고 자료로만 읽는다.
메인 에이전트는 압축 안내 훅도 UserPromptSubmit에서 다음 입력 때 안내를 주입하도록 구성했으며, 그 훅은 /compact 명령을 직접 실행할 수 없다. 이 안내 훅의 6건 파이프 테스트는 통과했다고 기록돼 있을 뿐, 실제 세션에서 주입된 문구가 보이는지는 아직 실측하지 않았다.
화자는 Pi에서 압축 시점, 남길 메시지와 요약 모델을 조정할 수 있다고 설명하는 반면, Claude Code의 압축 방식은 통제할 수 없다고 평가한다(영상). 한편 Claude Code 공식 문서의 PreCompact는 압축 직전에 실행되거나 압축을 막는 훅이다. 두 설명은 ‘압축 방식의 선택’과 ‘압축 직전 훅’이라는 서로 다른 통제 범위를 가리킨다.
비교할 때 확인할 경계
필요한 동작을 먼저 적고, 그것이 하네스 내부 설정인지 외부 훅인지 구분하면 기능 이름만으로 비교하는 오류를 줄일 수 있다. 모델 전환은 선택 가능한 모델과 대화 맥락을, 압축은 조정 가능한 항목과 훅이 실행되는 시점을, 도구 차단은 확인 대화상자와 거부 결정의 차이를 각각 살펴볼 대상이다. Claude Code의 allow, deny, ask 판정 차이는 권한 게이트 해부 글에서 따로 다뤘다. 이 구분은 위 영상과 Claude Code 문서, Pi 문서를 대조해 읽기 위한 기준이다. 어느 하네스가 더 좋은 결과를 낸다는 실험 결론은 포함하지 않는다.
한계를 먼저 적는다. 영상 화자의 주장은 1년 넘게 Claude Code를 쓴 뒤 Pi로 옮긴 1인 경험담이다. 원자료는 Pi의 실제 프로덕션 안정성, 팀 협업 기능, 엔터프라이즈 지원 수준을 비교 범위에 넣지 않았고, 이 글도 그 세 가지를 확인하지 않았다. 원자료는 자막을 바탕으로 한 전문 정리이며 화자의 표현을 그대로 보존했고, 공식 자료와 대조한 기록은 없다. 압축 모델을 고를 수 있다는 점은 원자료의 해석 메모가 비용 최적화 관점의 차이로 꼽은 항목이다. 실제 비용 차이는 이 글에서 측정하지 않았다.
자주 묻는 질문
Pi의 권한 게이트와 Claude Code 훅은 같은 구현인가요?
같은 구현은 아니다. Pi 공식 예제는 확장의 도구 호출 이벤트에서 명령을 검사하고 사용자 선택에 따라 막는다. Claude Code 공식 문서는 PreToolUse 훅이 명령을 검사해 거부 결정을 돌려주는 예제를 제공한다.
Claude Code의 PreCompact가 Pi의 압축 설정과 같은가요?
같은 설정이라고 볼 수 없다. 영상 화자는 Pi의 압축 시점과 요약 방식 선택을 강조한다. Claude Code 공식 문서의 PreCompact는 압축 직전에 실행되고 압축을 막을 수 있는 훅이다.
아직 댓글이 없습니다.