앤트로픽의 클로드 코드 활용법: 인터뷰형 스펙과 검증 자동화 워크숍

핵심 메시지

• 모델이 점점 유능해지면서 에이전트가 더 오래·복잡한 작업을 수행하게 되었고, 그만큼 사람의 작업 습관도 바꿔야 한다.
• 리처드 서턴의 '쓰라린 교훈'처럼, 모델을 억지로 제약하기보다 모델이 사용자에게서 요구사항을 끌어내도록 맡기는 편이 낫다.
• 긴 마크다운보다 정보 밀도가 높은 HTML 파일이 결과물을 검토하기에 더 효율적이고 사람 친화적이다.
• 검증을 산출물 자체에 내재화하면, 컴포넌트가 상태를 DOM에 게시해 에이전트가 직접 검증을 수행할 수 있다.
• 검증은 사람용 대시보드, 브라우저에서 에이전트 주도, CI에서 헤드리스(bun verify)의 세 가지 표면에서 동일하게 돌아간다.

쉽게 이해하기

앤트로픽 응용 AI 팀의 아르노가 사내에서 클로드 코드를 쓰는 방식을 워크숍으로 소개한다. 타리크가 샌프란시스코에서 한 발표와 'HTML 파일의 비합리적 효용'이라는 글에 기반하며, 마크다운에서 HTML로 옮겨 가자는 제안이 핵심이다. 모델이 유능해질수록 에이전트는 더 오래 돌고 더 복잡한 작업을 맡게 되는데, 잘못된 방향으로 가면 토큰을 크게 낭비하므로 검증을 앞단으로 끌어와 사람이 보기 좋은 HTML에 담는다.

첫 번째 수준은 '모델을 제약하지 말라'다. 강화학습의 아버지 리처드 서턴의 쓰라린 교훈처럼, 사람이 앞단에서 모든 것을 하드코딩하기보다 데이터와 연산을 부어 모델 능력에 맡기는 편이 낫다. 사용자도 자신이 원하는 바를 정확히 말로 옮기지 못하므로, 클로드가 ask user question 도구로 거꾸로 인터뷰하게 한다. 좋은 프롬프트는 '더 좋게 만들어' 같은 모호한 지시가 아니라, 관심 영역(도메인)을 짚어 주되 결과를 과하게 못 박지 않는 것이다.

도구 사용 팁도 강조된다. shift+tab으로 들어가는 자동(auto) 모드는 작업을 훨씬 수월하게 하고, 비용은 더 들지만 빠른(fast) 모드는 스펙을 빠르게 다듬을 때 좋다. effort 파라미터는 X high 또는 max를 권한다. 청구 분할 앱 예제에서 클로드는 인터뷰로 스펙을 만들고, 200줄을 넘기면 잘 읽히지 않는 마크다운 대신 HTML로 네 가지 디자인 방향(브루탈리스트, 도쿄 핀테크 등)을 만들어 보여 준다. 스크린샷이나 Playwright MCP로 피드백을 주고받으면 프런트엔드 수정이 한결 쉬워진다.

가장 비중 있는 부분은 '검증의 내재화'다. 작은 React 투두 앱에서 컴포넌트가 자신의 상태를 DOM에 게시(data 속성)하도록 만들면, 에이전트는 DOM을 긁어모으는 대신 그 계약을 그대로 읽어 검증할 수 있다. 스키마·픽스처·알려진 상태·불변식을 정의하고 프로브로 행복 경로 밖을 찌른다. 같은 검증을 사람용 대시보드, 브라우저에서 에이전트 주도, CI의 헤드리스(bun verify)로 돌릴 수 있고, 결과를 영상 클립으로 기록해 S3 등에 저장·공유한다. 실제로 클로드 코드 팀은 프런트엔드 변경을 이런 식으로 기록한다. HTML 스펙이 토큰을 더 쓰는 것 아니냐는 질문에는, 풍부한 스펙 덕에 장기적으로 반복이 줄어 오히려 효율적이라고 답한다.

주요 인사이트

• 요구사항은 사용자 안에 잠재해 있을 뿐 잘 표현되지 않는다. 모델이 인터뷰로 끌어내게 하면, 앞단에서 모든 것을 명세하려는 부담과 누락을 줄일 수 있다.
• 마크다운은 길어지면 사람도 동료도 읽지 않는다. 정보 밀도가 높고 시각적으로 확인 가능한 HTML 스펙은 검토와 피드백의 질을 높인다.
• 컴포넌트가 상태를 DOM에 명시적으로 게시하면, 에이전트가 React 내부에 의존하지 않고도 앱 상태와 무관하게 검증을 독립적으로 실행할 수 있다.
• 검증을 산출물에 내재화하고 클립으로 기록하면, 사람의 개입 지점을 줄이면서 빠른 배포 속도에서도 변경의 신뢰성을 증거로 남길 수 있다.

자주 묻는 질문

관련 AI 소식