클로드 코드 작동 원리: 단일 루프와 bash 중심 코딩 에이전트 설계 해부

핵심 메시지

• 코딩 에이전트가 급격히 쓸 만해진 이유는 화려한 기법이 아니라 아키텍처의 단순화와 모델 성능 향상이라는 분석이다.
• 클로드 코드의 뼈대는 도구 호출이 있는 동안 계속 도는 하나의 while 루프이며, 강연자는 이를 네 줄로 요약할 수 있다고 설명했다.
• 임베딩·벡터 검색·분류기 대신 사람이 터미널에서 하는 행동(grep, 파일 읽기, diff 편집, bash)을 그대로 도구로 준 것이 설계의 핵심이다.
• 가장 큰 적은 컨텍스트 오염이며, 서브에이전트·할 일 목록·요약 압축·파일 저장이 모두 이 문제를 우회하기 위한 장치다.
• 코딩 에이전트에는 단 하나의 정답이 없고, 클로드 코드·코덱스·커서·AMP가 각기 다른 철학으로 갈라져 있다는 것이 강연자의 결론이다.

쉽게 이해하기

AI 엔지니어 컨퍼런스의 마지막 워크숍에서 프롬프트레이어(PromptLayer) 창업자 재러드 조너라이크가 '클로드 코드는 어떻게 작동하는가'를 주제로 강연했다. 그는 앤트로픽과 아무 관계가 없으며 후원도 받지 않았다고 먼저 밝힌 뒤, 공개된 시스템 프롬프트 유출본과 직접 수행한 분석을 근거로 내부 구조를 재구성했다고 설명했다.

그가 던진 질문은 단순하다. 초기 자율 코딩 에이전트는 하나같이 쓸모가 없었는데, 왜 최근 들어 완전히 달라졌는가. 답으로 그는 두 가지를 들었다. 하나는 모델 자체가 도구 호출과 자율 실행에 맞게 좋아진 것이고, 다른 하나는 아키텍처가 오히려 단순해진 것이다. 그는 이 철학을 '도구를 주고 비켜라(give it tools and get out of the way)'라는 한 문장으로 요약했다.

구조의 중심은 하나의 마스터 루프다. 도구 호출이 있으면 도구를 실행하고 그 결과를 모델에 돌려주는 일을 반복하다가, 더 이상 호출이 없으면 사용자에게 묻는다. 도구 목록도 화려하지 않다. 토큰 제한 때문에 따로 만든 파일 읽기, 벡터 검색 대신 쓰는 grep과 glob, 파일 전체를 다시 쓰지 않고 변경분만 적용하는 diff 기반 편집, 그리고 강연자가 가장 중요하다고 꼽은 bash다. 그는 나머지를 다 없애고 bash만 남겨도 대부분 굴러갈 것이라며, 셸 명령은 학습 데이터가 압도적으로 많은 '범용 어댑터'라고 설명했다.

컨텍스트 관리는 강연 내내 반복된 주제였다. 컨텍스트가 가득 차면 모델이 급격히 멍청해지기 때문에, 긴 작업은 자체 컨텍스트를 가진 서브에이전트에 맡기고 결과만 돌려받는다. 대화가 한계에 가까워지면 중간을 덜어내고 앞뒤를 요약하는 압축이 돌아간다. 할 일 목록은 코드로 강제되는 구조가 아니라 시스템 프롬프트에 얹힌 규칙일 뿐인데, 최근 모델의 지시 따르기 능력이 좋아진 덕분에 그것만으로 작동한다는 점을 그는 흥미롭게 짚었다.

강연 후반부는 다른 코딩 에이전트와의 비교였다. 코덱스는 러스트로 짜인 오픈소스 구현에 커널 수준 샌드박싱을 쓰고, 소스그래프의 AMP는 모델 선택 기능을 아예 없앤 대신 압축 대신 '핸드오프'로 새 스레드를 시작하며, 커서는 UI를 앞세우고 자체 증류 모델로 속도를 무기로 삼는다. 그는 여기에 정답이 없다는 점을 강조하며, 벤치마크는 사실상 마케팅이 됐으니 실제 사용 이력을 다시 돌려보는 백테스트와 도구 호출 횟수·재시도 횟수 같은 '에이전트 냄새' 지표로 감을 잡으라고 권했다.

주요 인사이트

• 모델의 결함을 프롬프트와 분기문으로 메우려는 설계는 몇 달 뒤 모델이 개선되면 그대로 낭비가 된다. 강연자는 확신이 서지 않을 때는 모델의 탐색 능력에 맡기는 쪽을 택하라고 조언했다.
• 수백 개 노드로 짜인 분기 그래프를 걷어내고 단일 루프로 옮기면 개발과 유지보수가 훨씬 쉬워지지만, 분기 그래프가 막아주던 프롬프트 인젝션 공격 경로가 다시 열린다는 대가가 따른다.
• 결정론이 필요한 부분은 루프가 아니라 도구 안에 넣는 것이 현실적인 타협점이다. 도구는 입력과 출력이 분명한 함수로 두고 엄격하게 테스트하면, 나머지 탐색은 모델에 맡길 수 있다.
• diff 방식 편집은 토큰을 아낄 뿐 아니라 실수 자체를 줄인다. 강연자는 원고를 통째로 다시 쓰는 것과 빨간 줄로 고치는 것의 차이에 비유했다.
• 헤드리스 SDK로 코딩 에이전트를 파이프라인 부품처럼 쓰는 흐름이 시작됐다. 강연자는 매일 커밋을 읽어 문서를 갱신하고 PR까지 만드는 자동화를 예로 들며, 앞으로는 더 높은 추상화 위에서 에이전트를 조립하게 될 수 있다고 전망했다.

자주 묻는 질문

관련 AI 소식