클로드 코드 하네스 디자인을 활용하는 UXUI 디자이너
2026년 3월, 앤트로픽 하네스 디자인 방식을 제안하다.
2026년 3월, 인공지능 기술의 발전은 단순히 더 똑똑한 모델을 만드는 단계를 넘어 모델이 실제 환경에서 어떻게 '행동'하고 '지속'될 것인가를 설계하는 단계로 진입했다. 앤트로픽(Anthropic)은 이러한 흐름의 중심에서 하네스 디자인(Harness Design)이라는 새로운 아키텍처 방법론을 제안하며 인공지능 에이전트의 실질적인 활용 방안을 새롭게 정의했다. 과거의 UXUI 디자이너가 피그마(Figma) 화면 위에서 픽셀을 조정하는 데 시간을 보냈다면, 이제는 클로드 코드(Claude Code)와 같은 도구를 활용해 자신의 디자인 철학과 시스템 가이드라인을 자율적으로 수행하는 에이전트의 환경을 설계하는 것이 핵심 역량이 되었다.
하네스 디자인의 등장은 인공지능 모델이 가진 고질적인 한계, 즉 장기적인 작업 수행 시 발생하는 문맥 상실과 자가 평가의 편향성을 해결하기 위한 필연적인 결과물이다. 앤트로픽은 대규모 언어 모델이 단순히 텍스트를 생성하는 수준을 넘어 실제 소프트웨어 개발과 디자인 환경에서 수 시간, 수일 동안 일관성을 유지하며 작업할 수 있도록 만드는 인프라 층을 하네스라고 명명했다. 이는 인공지능 에이전트가 단발성 응답기가 아닌, 복잡한 프로젝트를 완수하는 능동적인 협업자로 진화했음을 의미한다.
하네스 디자인이란 무엇인가?
하네스 디자인의 근본적인 개념을 이해하기 위해서는 인공지능 에이전트의 구성 요소를 재정의할 필요가 있다. 기존의 관점에서는 인공지능 모델 자체가 에이전트라고 여겨졌으나, 앤트로픽의 정의에 따르면 에이전트는 'AI 모델'과 이를 감싸고 제어하는 '하네스(Harness)'의 결합으로 완성된다. 여기서 하네스는 모델이 도구에 접근하고, 기억을 관리하며, 외부 환경과 상호작용할 수 있도록 돕는 소프트웨어 시스템 전체를 의미한다.
하네스는 컴퓨터 시스템의 운영체제(OS)와 같은 역할을 수행한다. 모델이 연산을 담당하는 중앙처리장치(CPU)라면, 하네스는 이 CPU가 메모리에 접근하고 주변 장치를 제어하며 애플리케이션을 실행할 수 있게 해주는 하부 구조다. 따라서 하네스 디자인은 단순히 좋은 프롬프트를 작성하는 행위를 넘어 모델이 작업을 수행할 때 필요한 환경 설정, 권한 관리, 오류 복구 메커니즘, 그리고 지속적인 피드백 루프를 설계하는 포괄적인 공학적 활동을 포괄한다.
이러한 하네스 구조는 모델이 가진 '컨텍스트 윈도우'라는 물리적 한계를 극복하게 해준다. 모델은 대화가 길어지면 이전의 중요한 정보를 잊거나 성능이 저하되는 '컨텍스트 불안(Context Anxiety)'을 겪지만, 잘 설계된 하네스는 중요한 정보를 외부 파일(예: README.md, CLAUDE.md)로 기록하고 필요할 때만 불러오는 방식으로 이 문제를 해결한다. 즉 모델에게 모든 기억을 맡기는 대신 하네스가 기억의 저장과 인출을 관리함으로써 에이전트는 며칠 동안 이어지는 긴 프로젝트에서도 목표를 잃지 않고 작업을 지속할 수 있다.
UXUI 디자이너에게 하네스 디자인은 자신의 디자인 원칙과 시스템 가이드를 실행 가능한 코드의 형태로 구체화하는 과정이다. 단순히 "우리 브랜드 스타일로 디자인해줘"라고 말하는 대신 브랜드의 색상 팔레트, 타이포그래피 토큰, 컴포넌트 라이브러리 정보를 하네스의 일부로 포함하고 에이전트가 이를 엄격히 준수하도록 환경을 조성하는 것이다. 이처럼 모델을 지휘하는 것이 아니라 모델이 일할 수 있는 체계를 설계하는 것이 하네스 디자인의 핵심 철학이다.
하네스 디자인 적용 방식 (1) : 3인 에이전트 아키텍처
앤트로픽은 복잡하고 긴 시간이 소요되는 작업을 성공적으로 수행하기 위해 역할을 분담한 다중 에이전트 시스템을 제안한다. 특히 디자인과 개발이 결합된 프로젝트에서는 기획자(Planner), 생성자(Generator), 평가자(Evaluator)로 구성된 3인 에이전트 아키텍처가 가장 강력한 성능을 발휘한다. 이 구조는 생성적 적대 신경망(GAN)과 유사한 원리로 작동하며, 서로 다른 목적을 가진 에이전트들이 상호작용하면서 결과물의 품질을 점진적으로 높여나간다.
첫 번째 주체인 기획자 에이전트는 사용자의 고수준 요구사항을 분석하여 구체적인 제품 명세와 작업 계획을 수립한다. 기획자는 당장 코드를 작성하기보다 프로젝트의 목적과 사용자 여정을 정의하는 데 집중하며, 작업을 작은 단위의 스프린트로 쪼개어 생성자가 혼란을 겪지 않도록 가이드를 제시한다. 이 과정에서 기획자는 생성자와 '스프린트 계약'을 체결하여 작업 범위와 완료 기준을 명확히 함으로써 에이전트 루프가 엉뚱한 방향으로 흐르는 것을 방지한다.
두 번째 주체인 생성자 에이전트는 기획자가 수립한 계획에 따라 실제 코드와 디자인 결과물을 생산한다. 클로드 코드 환경에서 생성자는 리액트(React)나 테일윈드(Tailwind)와 같은 도구를 활용하여 인터페이스를 구축하며, 필요한 라이브러리를 설치하거나 파일을 생성하는 등 실제적인 구현 작업을 도맡는다. 생성자는 속도와 구현 가능성에 집중하지만, 모델 특유의 자가 평가 편향 때문에 자신의 작업물에 있는 시각적 오류나 논리적 허점을 스스로 발견하지 못하는 경우가 많다.
이때 세 번째 주체인 평가자 에이전트의 역할이 결정적이다. 평가자는 생성자의 작업물을 극도로 회의적인 시각으로 검토하는 리뷰어 역할을 수행한다. 앤트로픽은 디자인 평가를 위해 디자인 품질, 독창성, 기술적 완성도(Craft), 기능성이라는 네 가지 엄격한 기준을 도입했다. 평가자는 플레이라이트(Playwright)와 같은 도구를 사용해 실제 웹페이지를 렌더링하고 사용자의 입장에서 인터페이스를 조작하며 버그를 찾거나 미적 기준 위반 사례를 찾아낸다. 이러한 평가 결과는 다시 생성자에게 전달되어 다음 차례의 수정 작업으로 이어지며, 5~15회에 걸친 반복 주기를 통해 인간 디자이너의 개입 없이도 전문적인 수준의 결과물이 탄생하게 된다.
하네스 디자인 적용 방식 (2) : 컨텍스트 리셋 및 인수인계
인공지능 모델이 장시간 작업을 수행할 때 겪는 가장 큰 난제는 대화 기록이 길어짐에 따라 발생하는 기억의 파편화와 추론 능력의 저하다. 하네스 디자인은 모델의 컨텍스트 윈도우 내부에 모든 정보를 쌓아두는 대신, 중요한 상태 정보를 외부 시스템으로 분리하여 관리하는 방식을 채택한다. 이를 통해 모델은 매번 '신선한' 상태에서 작업을 시작하면서도 이전 작업의 맥락을 완벽하게 이어받을 수 있다.
구체적인 방법론 중 하나는 세션이 종료될 때마다 현재까지의 진행 상황과 다음 작업 목록을 담은 로그 파일을 업데이트하는 것이다. 앤트로픽의 C 컴파일러 구축 실험에서는 에이전트가 매번 새로운 컨테이너 환경에서 아무런 이전 기억 없이 시작됨에도 불구하고, 외부에 저장된 README와 진행 상황 파일을 읽어들임으로써 수천 번의 세션을 성공적으로 이어갈 수 있었다. 이는 모델의 내부 메모리에 의존하는 것이 아니라 하네스가 제공하는 외부 기록 장치를 통해 영속적인 기억을 구현한 사례다.
클로드 코드에서는 이러한 맥락 관리를 위해 CLAUDE.md 파일과 자동 요약(Compaction) 기능을 적극적으로 활용한다. 사용자는 CLAUDE.md에 프로젝트의 디자인 시스템 규칙, 코딩 스타일 가이드, 주요 디렉토리 구조를 명시하여 모델이 대화 내용이 요약되거나 삭제되더라도 핵심 지침만은 잊지 않도록 강제할 수 있다.
또한 대화 내용이 너무 길어져 모델이 성능 저하를 느낄 때 하네스가 자동으로 요약을 수행함으로써, 불필요한 과거 로그는 지우고 현재 작업에 필요한 핵심 맥락만 남기는 과정을 거친다.
UXUI 디자이너는 이러한 인수인계 구조를 활용해 디자인 의사결정의 이력을 관리할 수 있다. 예를 들어 특정 버튼의 색상을 변경한 이유나 레이아웃을 수정한 배경을 하네스가 기록하게 함으로써, 에이전트가 나중에 다른 부분을 수정할 때 이전의 디자인 결정을 무시하지 않도록 만든다. 또한 독립적인 작업을 수행하는 서브에이전트(Sub-agent)를 생성할 때도 메인 에이전트의 전체 컨텍스트를 복사하는 대신 요약된 지침만을 전달하여 효율적인 분업을 유도할 수 있다. 이처럼 컨텍스트를 리셋하고 정제된 정보만 인수인계하는 방식은 에이전트의 지능을 장기간 일정하게 유지하는 핵심 동력이 된다.
하네스 디자인 적용 방식 (3) : 환경 제어 및 도구화
하네스 디자인의 실질적인 위력은 모델이 단순히 텍스트를 내뱉는 것을 넘어 실제 환경을 조작하고 도구를 사용할 수 있는 권한을 가질 때 발휘된다. 클로드 코드는 모델이 로컬 파일 시스템을 읽고 쓰고, 터미널 명령어를 실행하며, 인터넷을 검색하고, 깃(Git)을 통해 버전 관리를 할 수 있는 강력한 도구 세트를 제공한다. 하네스는 이러한 도구들이 모델의 의도에 맞게 안전하고 효율적으로 작동하도록 제어하는 울타리 역할을 한다.
에이전트는 작업을 시작할 때 자신이 처한 환경을 먼저 탐색한다. 클로드 코드는 로컬 머신뿐만 아니라 클라우드 기반의 가상 머신(VM)이나 웹 브라우저를 통한 원격 제어 환경에서도 작동할 수 있다. 디자이너는 에이전트에게 부여할 자율성의 범위를 설정할 수 있는데, 예를 들어 파일을 마음대로 수정하게 두거나(Auto-accept), 명령어를 실행하기 전 반드시 승인을 구하게 하는 등의 권한 모드를 통해 작업의 안전성을 확보한다. 특히 '계획 모드(Plan mode)'에서는 모델이 도구를 사용하여 실제 작업을 수행하기 전 시뮬레이션을 거친 계획을 사용자에게 먼저 제안함으로써 실수를 방지한다.
도구화의 핵심 중 하나는 모델 지능 프로토콜(MCP, Model Context Protocol)을 통해 외부 서비스와 연결되는 것이다. UXUI 디자이너에게 피그마 MCP는 매우 유용한 도구로, 에이전트가 피그마 파일의 레이어 구조를 읽어오거나 스크린샷을 분석하여 코드로 변환하는 작업을 수행하게 해준다. 또한 플레이라이트 MCP를 활용하면 에이전트가 자신이 작성한 UI 코드를 실제 브라우저에서 실행하고 버튼을 클릭하거나 폼을 입력해보는 등 실시간으로 상호작용하며 디자인의 기능성을 검증할 수 있다.
하네스는 이러한 도구 사용의 흐름을 자동화한다. 예를 들어 "실패하는 테스트를 고쳐줘"라는 요청을 받으면 하네스 내부의 에이전트는 테스트 스위트를 실행하고, 오류 메시지를 읽고, 관련 소스 파일을 검색하여 수정한 뒤, 다시 테스트를 돌려 성공 여부를 확인하는 복잡한 연쇄 동작을 스스로 수행한다. 이러한 환경 제어 능력은 인공지능을 단순한 보조 도구에서 실질적인 업무를 완수하는 '자동화된 전문가'로 탈바꿈시킨다. 디자이너는 에이전트가 사용할 도구의 우선순위를 정하고, 각 도구의 실행 결과가 다음 단계의 입력으로 어떻게 들어갈지 설계함으로써 고도화된 디자인 자동화 워크플로우를 구축할 수 있다.
기존 프롬프트 디자인과 하네스 디자인의 차이점
인공지능 모델을 활용하는 초기 단계에서 많은 사용자들이 집중했던 프롬프트 엔지니어링과 하네스 디자인 사이에는 명확한 개념적 차이가 존재한다. 프롬프트 디자인이 모델에게 보낼 '질문'이나 '지침'의 문구 자체를 다듬는 예술에 가깝다면, 하네스 디자인은 모델이 작동하는 '시스템'과 '인프라'를 설계하는 공학에 해당한다. 프롬프트는 단기 응답의 품질을 결정하지만, 하네스는 장기적인 작업의 신뢰성과 성능을 결정짓는 요소다.
프롬프트 디자인의 한계는 모델의 컨텍스트 윈도우 크기에 갇혀 있다는 점이다. 아무리 정교한 프롬프트를 작성해도 대화가 길어지면 초기 지침의 영향력이 약해지고 모델은 일관성을 잃게 된다. 반면 하네스 디자인은 모델 외부에서 기억을 관리하고, 작업을 분할하며, 결과물을 검증하는 루프를 구축함으로써 이러한 물리적 제약을 우회한다. 즉 프롬프트 디자인이 '무엇을 말할 것인가'에 집중할 때, 하네스 디자인은 모델이 '어떠한 절차로 행동하고 어떻게 피드백을 받을 것인가'를 규정한다.
또한 하네스 디자인은 모델의 주관적인 평가를 배제하고 객관적인 지표를 도입한다는 점에서 프롬프트 디자인보다 한 단계 진보된 방식이다. 프롬프트 내에 "전문적으로 디자인해줘"라고 쓰는 것보다, 하네스 레벨에서 디자인 시스템 가이드라인 파일을 강제로 읽게 하고 플레이라이트와 같은 도구로 웹 표준 준수 여부를 검크하게 만드는 것이 훨씬 강력한 효과를 낸다. 이는 인공지능 활용의 중심이 모델과의 심리적 대화에서 시스템적인 제어와 오케스트레이션으로 이동하고 있음을 보여준다.
UXUI 디자이너의 관점에서 이 차이는 더욱 두드러진다. 프롬프트 디자인을 선호하는 디자이너는 인공지능이 내놓는 우연한 영감에 의존하지만, 하네스 디자인을 실천하는 디자이너는 에이전트가 어떤 상황에서도 일정 수준 이상의 품질을 유지하도록 만드는 프로세스를 설계한다. 하네스는 모델이 내놓는 창의적인 시도를 수용하면서도 그것이 브랜드 가이드라인이라는 울타리를 벗어나지 않도록 감시하는 역할을 수행한다. 따라서 하네스 디자인을 익히는 것은 인공지능을 통제 가능한 생산 도구로 길들이는 법을 배우는 것과 같다.
UXUI 디자이너도 하네스 디자인으로
AI 에이전트를 활용하자.
인공지능이 디자인의 영역으로 깊숙이 들어오고 있는 2026년 현재, 디자이너에게 요구되는 가장 중요한 변화는 '실행자'에서 '설계자'로의 전환이다. 앤트로픽의 하네스 디자인 방식은 인공지능이 단순히 디자인 시안을 만들어주는 비서를 넘어 수천 줄의 코드로 이루어진 복잡한 애플리케이션을 자율적으로 구축하는 파트너가 될 수 있음을 증명했다. 이러한 변화의 물결 속에서 UXUI 디자이너는 자신의 미적 감각과 사용자 경험에 대한 통찰을 하네스라는 시스템적 틀 속에 녹여내야 한다.
클로드 코드와 같은 에이전트 도구는 디자이너에게 전례 없는 자유를 선사한다. 디자이너는 더 이상 버튼의 픽셀 위치를 조정하거나 반복적인 마진 수치를 맞추는 데 시간을 낭비할 필요가 없다. 대신 에이전트가 준수해야 할 디자인 시스템의 핵심 논리를 수립하고, 생성된 결과물을 엄격하게 평가할 수 있는 기준을 하네스에 이식하며, 에이전트가 막혔을 때 적절한 환경적 도구를 제공하는 일에 집중하게 될 것이다. 이는 디자인의 가치가 '그려진 결과물'에서 '결과물을 만들어내는 논리'로 이동하고 있음을 의미한다.
결론적으로 하네스 디자인은 인공지능 모델의 잠재력을 현실의 복잡한 비즈니스 논리와 연결해주는 핵심 고리다. 전문 디자이너들은 이제 프롬프트를 넘어서 하네스 아키텍처를 이해하고 활용함으로써 자신의 디자인 역량을 수만 배로 증폭시킬 수 있는 기회를 맞이하고 있다. 인공지능 에이전트가 최상의 성과를 낼 수 있는 최적의 서식지를 디자인하는 것, 그것이 바로 인공지능 시대에 UXUI 디자이너가 맡게 될 새로운 소명이자 독보적인 경쟁력이 될 것이다. 하네스 디자인의 원칙을 내면화하고 이를 실무에 적용하는 디자이너만이 기술에 대체되지 않고 기술을 지휘하는 진정한 창조자로 남게 될 것이다.
AI를 활용하여 UX/UI 디자인을 공부하고 AI디자인 자격증도 취득하고 싶다면?
https://onoffmix.com/ch/aidesign
AI를 활용하는 UXUI 디자이너들과 함께 소통하며 성장하고 싶다면?
AI를 활용한 UX/UI 디자인을 책으로 공부하고 싶다면?
AI 시대에 나만의 AI스타트업/비즈니스 시스템을 만들고 싶다면?