Agent on philipjkim

에이전트 하네스와 Pi Part 4: Pi 를 옆에 두기

Fri, 23 Oct 2026 18:50:00 +0900

이 글은 Claude Opus 5.5 를 이용해 초안이 작성되었으며, 이후 퇴고를 거쳤습니다.

같은 저장소에서 세 하네스에게 “안녕” 한마디만 보내고, 모델에게 실제로 나간 요청을 받아 크기를 쟀습니다. 저장소에는 두 줄짜리 규칙 파일(AGENTS.md 또는 CLAUDE.md)과 파이썬 파일 하나만 두었어요.

하네스 (버전, 깨끗한 기본 설정)	시스템 지시문	도구 정의	그 밖에 끼워 넣은 것	합계
Pi 1.4.0	3,243자	2,956자 (4개)	없음	약 6,200자
Codex CLI 0.160.0 (gpt-5.5)	21,299자	9,511자 (10개)	5,792자 (개발자 메시지·규칙 파일·환경)	약 36,600자
Claude Code 2.1.287	5,967자	46,484자 (20개)	9,497자 (환경 정보·리마인더·규칙 파일)	약 61,900자

대략 4자를 1토큰으로 어림하면 Pi 는 1,500 토큰 남짓, Codex 는 9천, Claude Code 는 1만 5천 토큰쯤을 사용자의 첫 문장보다 먼저 씁니다. Claude Code 의 도구 20개에는 Bash·Read·Edit 같은 기본 도구 말고도 서브 에이전트(Agent), 예약 작업(Cron 계열), worktree, 웹 검색, 워크플로가 들어 있어요. 3편에서 Mario Zechner 가 말한 “우주선” 이 이 표의 한 줄입니다.

에이전트 하네스와 Pi Part 3: Pi 라는 하네스

Fri, 23 Oct 2026 18:40:00 +0900

이 글은 Claude Opus 5.5 를 이용해 초안이 작성되었으며, 이후 퇴고를 거쳤습니다.

Over the past few months, Claude Code has turned into a spaceship with 80% of functionality I have no use for.

Mario Zechner 가 2025년 11월 30일 블로그에 쓴 문장입니다. 지난 몇 달 사이 Claude Code 가 쓸 일 없는 기능이 80% 인 우주선이 됐다고요. 그는 Cursor 를 1년 반 쓰다가 2025년 4월 Claude Code 로 갔고 대부분의 일을 Claude Code 로 했는데, 릴리스마다 시스템 프롬프트와 도구가 바뀌어 작업 흐름이 깨지고 모델의 행동이 달라지는 게 싫었다고 했어요. 화면이 깜빡이는 것도요. 그래서 직접 만든 게 Pi 이고, 원칙은 한 줄이었습니다. “if I don’t need it, it won’t be built.”

에이전트 하네스와 Pi Part 2: 하네스 이전과 지금

Fri, 23 Oct 2026 18:37:00 +0900

이 글은 Claude Opus 5.5 를 이용해 초안이 작성되었으며, 이후 퇴고를 거쳤습니다.

Anthropic 이 2026년 2월에 낸 Claude Code 회고 글에 이런 문장이 있습니다. “Another tricky problem we hit in 2022 was harness design.” 2022년에 이미 모델이 실제로 행동하게 해 주는 비계(scaffolding), 즉 하네스 설계가 골치 아픈 문제였다는 거예요. 컨테이너 안에서 셸을 계속 살려 두고 입출력을 흘려보내고 타임아웃과 잘 지내게 만드는 일이었다고 합니다. 그런데 이 단어가 회사 공지문에 등장한 건 그로부터 3년 뒤입니다. 2025년 9월 29일 Anthropic 은 Claude Code SDK 의 이름을 Claude Agent SDK 로 바꾸면서 “Claude Code 를 움직이는 agent harness 가 다른 종류의 에이전트도 움직일 수 있다” 고 썼어요.

에이전트 하네스와 Pi Part 1: 하네스란 무엇인가

Fri, 23 Oct 2026 18:34:00 +0900

이 글은 Claude Opus 5.5 를 이용해 초안이 작성되었으며, 이후 퇴고를 거쳤습니다.

2025년 12월 초 Terminal-Bench 2.0 리더보드에서 GPT-5.1-Codex 는 4위였습니다. 57.8%. 같은 표의 21위에도 GPT-5.1-Codex 가 있었는데 점수는 36.9% 였어요. 모델은 같고, 바뀐 건 모델을 감싸고 돌린 프로그램뿐입니다. 위쪽은 OpenAI 의 Codex CLI, 아래쪽은 벤치마크 쪽이 만든 범용 에이전트 Terminus 2. 같은 두뇌를 다른 몸에 넣었더니 21점이 차이 난 셈입니다.

그 “몸” 을 요즘은 하네스(harness)라고 부릅니다. 저는 업무에서 Claude Code 를 쓰고 Codex 도 써 봤는데, 둘을 같은 종류의 물건으로 묶어 부르는 말이 생긴 건 꽤 최근 일이에요. 이 말을 제대로 들여다보게 된 건 개발자 친구가 Pi 라는 하네스를 소개해 준 뒤였습니다. Pi 가 무엇인지 알아보려다 보니 하네스가 무엇인지부터 정리해야 했어요. 그리고 Claude Code 를 쓰면서 아쉬웠던 것들, 컨텍스트에 무엇이 얼마나 들어가는지 보이지 않는다거나 세션을 되돌리고 갈라 보기가 불편하다는 것들이 사실은 모델이 아니라 하네스의 성질이라는 걸 이 글을 준비하면서 알았습니다.