AI 에이전트 오피스 구축법: 클로드 코드·코덱스 역할 분담과 하네스 엔지니어링, 2026년 3가지 기준
퀀텀점프클럽 정상록5 min read6 viewsFree Resource
PDF · Free
에이전트 124개로 굴러가는 회사 — 비개발자를 위한 쉬운 가이드
Get the practical guide first, before diving into the full article.
AI 에이전트 오피스 구축법: 클로드 코드·코덱스 역할 분담과 하네스 엔지니어링, 2026년 3가지 기준
회사가 AI 에이전트로 돌아가려면 프롬프트보다 규칙 체계가 먼저입니다. 클로드 코드는 기획, 코덱스는 실무로 역할을 나누고, 램 중심 컴퓨터 사양과 하네스 엔지니어링으로 자동화 90개 이상을 무인 운영하는 방법을 정리했습니다.
결론부터 말하면, AI 에이전트 오피스는 프롬프트를 잘 쓰는 사람이 아니라 회사가 따를 규칙 체계를 설계하는 사람이 있어야 돌아갑니다. "우리 팀도 개발자 없이 이런 자동화가 되나요?" 이 질문을 자주 받아요. 충분히 궁금할 만합니다. 회사 전체가 사람 손 없이 돌아가는 그림은 쉽게 상상이 안 되니까요. 이번 글에서는 에이전트 124개로 돌아가는 실제 사무실 구조, 클로드 코드와 코덱스의 역할 분담, 컴퓨터 사양, 하네스 엔지니어링 개념, 그리고 8일 만에 시스템을 완성한 비용 계산까지 순서대로 짚어보겠습니다.
에이전트 124개, 스킬 115개가 돌아가는 하루
저희 회사에는 사람 손을 기다리지 않고 정해진 시간마다 움직이는 자동화가 90개 넘게 돌아갑니다. 그 자동화를 채우고 있는 건 에이전트 124개, 스킬 115개, 훅 99개, 규칙 173개예요. 자료를 찾고, 판단 기준을 적용하고, 결과물을 만들고, 문제가 생기면 스스로 멈추는 흐름까지 하나로 연결돼 있죠.
이 정도 규모의 AI 에이전트 오피스 구축은 챗봇 하나 켜놓는 것과는 완전히 다른 이야기입니다. 챗봇은 질문을 받으면 답을 적어주고 끝나지만, 여기서 말하는 에이전트는 컴퓨터 안에 실제로 상주하면서 계획하고 실행하고 결과를 관찰한 뒤 다음 판단을 조정하는 루프를 스스로 돌립니다. Anthropic이 공식 문서에서 정의하는 에이전트 개념과도 정확히 겹치는 부분이에요.
이 전체 구조가 실제로 어떻게 돌아가는지는 24분 분량 본편 영상에 화면 그대로 담겨 있습니다. AI가 네이버 부동산에서 아파트 시세를 직접 검색하고 분석하는 장면부터 문서 작성, 이메일 발송까지 이어지는 과정을 통째로 보고 싶다면 본편(https://youtu.be/kAbPSAQgR7U)에서 확인할 수 있어요.
클로드 코드와 코덱스, 역할을 어떻게 나누나
AI 에이전트 오피스를 도입하려는 분들이 가장 자주 묻는 질문 중 하나가 이겁니다. "클로드 코드 하나만 쓰면 되지 코덱스는 왜 따로 쓰나요?" 답은 간단해요. 두 도구가 잘하는 일이 서로 다르기 때문입니다.
클로드 코드 안에는 페이블, 오퍼스, 소넷처럼 여러 층의 모델이 있고, 그중 가장 비싸고 좋은 모델인 페이블은 큰 그림을 보는 기획 단계에 씁니다. 반면 코덱스는 클로드 코드가 못 하는 작업, 예를 들어 이미지 생성 같은 실무를 맡죠. 이 지점에서 나오는 게 클로드 코드 코덱스 역할 분담 기준입니다. 한쪽이 자료를 읽고 초안을 만들면 다른 쪽이 결과를 다시 검토하고 요청과 맞는지 확인하는 식으로, 상황에 따라 역할을 바꿔가며 씁니다.
중요한 건 어느 도구가 더 세냐를 따지는 게 아니에요. Anthropic 공식 문서도 CLAUDE.md·스킬·MCP·서브에이전트·훅을 각각 다른 문제를 푸는 확장 지점으로 규정하고, OpenAI도 AGENTS.md부터 스킬·MCP·서브에이전트까지 계층화된 커스터마이징 순서를 공식적으로 제시합니다. 두 회사 모두 한 도구가 아니라 여러 계층을 조합하라고 말하는 셈이죠.
컴퓨터 사양은 코어보다 램이 먼저입니다
AI 에이전트 컴퓨터 사양에서 가장 먼저 볼 건 코어가 아니라 램입니다. 여러 에이전트가 동시에 일할 공간이 필요해서예요. 추천 등급은 입문자 16GB, 실무자 2432GB, 본격 사용자 4864GB, 그리고 대표 본인 수준인 128GB로 나뉩니다.
참고로 신형 맥 스튜디오에는 M6가 아니라 M5 Max·M5 Ultra 칩이 들어갑니다. M6 칩은 맥 미니 쪽이고, 국내 가격은 149만 9,000원부터 시작해요. 대표가 새로 장만한 256GB 램 구성은 개인 구매 총액 기준 약 1,700만원인데, 이는 애플 공식 256GB 구성가(약 1,170만원)에 저장장치까지 늘려 구매한 총액이라 두 수치가 다르다는 점을 감안해야 합니다.
처음부터 비싼 컴퓨터를 살 필요는 없어요. 클로드 코드 두 개 정도만 돌릴 계획이면 16GB로도 충분하고, 필요에 맞춰 단계별로 늘려가면 됩니다.
관련 글: AI 에이전트 돌리는 맥 램 용량 정리
하네스 엔지니어링, 확인할 기준 3가지
예전에는 프롬프트를 얼마나 정교하게 쓰느냐가 AI 활용 실력을 보여주는 척도였어요. 하지만 이 방식엔 한계가 있었습니다. 같은 프롬프트를 써도 답이 다르게 나오고, 사람이 자리를 비우면 업무가 그대로 멈췄죠.
지금은 다릅니다. 질문 하나를 던지는 게 아니라 회사 전체가 따라야 하는 규칙을 AI에게 미리 정해주는 방식으로 일합니다. 이 규칙 체계를 설계하는 일을 하네스 엔지니어링이라고 불러요.
하네스 엔지니어링이란?: 모델을 제외한 에이전트의 모든 것, 즉 메모리·도구·권한·훅·관찰 가능성을 설계하는 작업을 뜻합니다. OpenAI, Anthropic, Thoughtworks의 마틴 파울러가 2026년 상반기부터 공통으로 쓰기 시작한 용어예요.
실무에 적용할 때 확인할 기준은 크게 세 가지입니다. 첫째, 어떤 자료를 참고해야 하는지와 하지 말아야 할 일을 미리 규칙으로 적어둡니다. 둘째, 도구별 역할을 클로드는 기획, 코덱스는 실무로 정확히 나눕니다. 셋째, 결과물이 예상과 다르면 자동으로 멈추고 사람에게 확인을 요청하는 검증 지점을 둡니다. 이 세 가지가 갖춰지면 사람이 잠든 시간에도 시스템이 정해진 대로 계속 움직여요.
8일 만에 만든 시스템, ROI는 얼마인가
AI 자동화 ROI를 계산해보면 답이 좀 더 선명해집니다. 응용 소프트웨어 개발자 한 명이 이 시스템을 처음부터 혼자 만든다고 가정해볼게요. 한국인공지능·소프트웨어산업협회(KOSA)가 발표한 2026년 적용 응용 SW 개발자 시간평균임금은 47,281원입니다. 소프트웨어 사업 대가 산정에서 흔히 쓰는 월 209시간 기준으로 환산하면 약 988만원이 나오는데, 이 988만원은 영상이 자체적으로 계산한 값이라는 점을 짚고 넘어가야 해요. KOSA가 공식 발표한 월평균임금은 산정 방식이 달라 약 775만원이고, 두 수치를 같은 것으로 혼동하면 안 됩니다.
여기에 다른 항목을 더한 최종 총액이 약 1,976만원이라는 게 영상 발화 인용입니다. 사람 한 명이 처음부터 만들면 이만큼 드는 시스템을, 대표와 AI 하네스가 함께 8일 만에 완성했어요. 돈으로만 따질 문제도 아닙니다. 사람이 잠든 시간에도 AI가 대신 일하니까, 담당자의 컨디션과 상관없이 업무가 계속 돌아가는 셈이죠.
마무리
프롬프트를 잘 쓰는 사람보다, 회사가 따를 규칙을 설계하는 사람이 필요한 시대가 왔습니다. 클로드 코드는 기획을 맡고 코덱스는 실무를 맡는 것처럼, 도구마다 잘하는 자리를 찾아 나눠주는 게 하네스 엔지니어링의 핵심이에요. 결국 AI 에이전트 오피스 구축은 이 역할 분담을 얼마나 명확한 규칙으로 정리하느냐에 달려 있습니다.
비슷한 고민을 하는 팀이 많습니다. 오늘 정리한 기준이 결정에 보탬이 되길 바랍니다. 자동화가 실제로 돌아가는 전체 흐름을 화면으로 직접 보고 싶다면 본편 영상(https://youtu.be/kAbPSAQgR7U)에서 처음부터 끝까지 확인할 수 있어요.
자주 묻는 질문 (FAQ)
Q: 하네스 최적화를 감에만 의존해도 되나요?
많은 팀이 아직 감(vibes)에만 의존해 하네스를 조정하는 게 현실이에요. 하지만 감으로 시작하더라도 참고 자료, 금지 행동, 검증 지점 이 세 가지만은 문서로 남겨두는 게 안전합니다. 규칙이 글로 남아 있어야 사람이 없을 때도 같은 기준으로 움직여요.
Q: 클로드 코드와 코덱스 중 어느 게 더 나은가요?
어느 쪽이 더 세냐를 따지는 논쟁은 이제 의미가 크지 않아요. 실제로는 클로드가 기획하고 코덱스가 실무를 맡거나, 반대로 코덱스가 기획하고 클로드가 실행하는 식으로 상황에 맞춰 역할을 바꿔가며 씁니다. 중요한 건 순위가 아니라 적재적소예요.
Q: 컴퓨터부터 새로 사야 하나요?
아닙니다. 클로드 코드 한두 개 정도만 돌릴 계획이면 16GB로도 충분히 시작할 수 있어요. 여러 에이전트를 동시에 돌리는 규모로 커질 때 2432GB, 4864GB로 단계별로 늘려가면 됩니다.
