AI 에이전트 도구 호출의 판을 바꾼다는 '코드모드' 정리 글

요약 유명 개발자 아르민 로나허(Armin Ronacher)가 자신의 블로그를 통해 AI 하네스 'Pi 1.0'에 새롭게 도입된 '코드모드(Codemode)'의 개념과 배경을 상세히 정리했습니다. 과거 그는 LLM 컨텍스트에 커스텀 도구나 MCP 서버를 무리하게 올리기보다 가벼운 스크립트 실행 방식을 권장했으나, 이번 업데이트를 통해 코드모드 기반의 MCP 지원을 공식 추가했습니다. 그가 설명하는 핵심은 AI 구동부인 '두뇌(Harness)'와 실제 명령이 수행되는 '손(Execution Environment)'의 분리입니다. 기존의 Bash 환경은 샌드박스 내부의 타깃 환경에서 돌기 때문에 멀티모달 이미지 파싱이나 서브 에이전트 오케스트레이션처럼 하네스 자체의 고유 도구를 처리하는 데 구조적 한계가 있었습니다. 이를 해결하기 위해 도입된 '코드모드'는 하네스 측 내부 샌드박스(WASM 환경 내 QuickJS)에서 자바스크립트로 동작합니다. 네트워크, 파일 시스템, 타이머 접근이 차단되고 메모리도 제한된 상태에서 순수하게 하네스 내부 도구 호출을 묶어주는 역할만 담당합니다. 모델은 대량의 컨텍스트를 소모하지 않고도 구조화된 데이터를 받아 병렬 작업이나 워크플로를 처리할 수 있으며, 호출 간의 상태를 트랜스크립트에 저장해 재사용할 수도 있습니다. 나아가 기존 일반 도구로 노출하면 컨텍스트 낭비가 심했던 이미지 생성이나 단발성 텍스트 분류 같은 특수 기능도 코드모드를 통해 효율적으로 제어할 수 있게 되었습니다.