🤖 하루 20분 일을 2초에? Claude Code의 비밀

 

처음에 Claude Code를 써봤을 때 저도 다른 사람들처럼 그냥 막연하게 접근했어요. "이거 좀 해줘"라고 던지고 엔터 치면서 기도하는 식으로 말이죠. 간단한 작업에는 이것도 나쁘지 않지만, 복잡한 프로젝트가 되면 진짜 문제가 생기더라고요.

폭발적인 성장, 그 뒤의 진짜 비밀

Anthropic은 2025년 9월 시리즈 F 라운드에서 130억 달러(약 18조원)를 투자받으며 기업가치가 1,830억 달러(약 254조원)로 평가받았습니다. 더 놀라운 건 2025년 초 10억 달러 수준이었던 런레이트 매출이 8개월 만인 8월에 50억 달러를 넘어섰다는 점이에요.

이런 무시무시한 성장 뒤에는 분명 개발자들의 생산성 향상이 있을 거예요. 그리고 그 중심에 Claude Code가 있습니다.

나이브한 접근법이 가져오는 함정

대화가 쌓이면서 점점 산으로 가는 거예요. 새로운 메시지가 옛날 지시사항을 덮어버리는데, 언제 그런 일이 벌어지는지 알 수가 없어요. 게다가 AI도 기억력 한계가 있어서, 대화가 길어지면 처음 얘기들을 까먹어버리죠.

이런 문제들 때문에 저는 새로운 방법을 시도해봤어요. Claude Code한테 계획서를 먼저 작성하게 하는 것이었죠.

계획서가 모든 것을 바꿨다

2025년 기준 인공지능 스타트업 매출의 85% 이상이 OpenAI와 Anthropic 단 두 곳에서 나오고 있습니다. 이런 폭발적인 성장 뒤에는 분명 개발자들의 생산성 향상이 있을 거예요.

Claude Code를 제대로 활용하려면 첫 번째 프롬프트에서 기능 구현에 대한 모든 디테일을 주고, 계획 문서를 작성하도록 해야 해요.

예를 들면 이런 식이죠:

"쿼리 빌더를 구현하고 싶어요. 페이지는 두 개 컬럼으로 나뉘는데, 첫 번째 컬럼에는 뷰 선택 박스(지금은 "Volume Metrics"만), 필드 선택 박스("field 1", "field 2", "field 3"), 필터 추가 박스가 있어요. 오른쪽 컬럼에는 사람이 읽기 쉬운 쿼리와 결과 테이블이 표시돼요. 기존 프로젝트 구조를 참고해서 라우팅과 아키텍처 디테일을 확인하고, 계획을 작성해서 제가 검토할 수 있게 해주세요."

진정한 협업 파트너가 되다

현재 앤트로픽의 기업 고객은 30만 곳 이상이며, 연간 10만 달러 이상 매출을 발생시키는 대형 계정은 지난 1년간 7배가량 증가했습니다. 이런 성장의 비밀은 Claude Code가 단순한 코드 생성기가 아닌 진정한 협업 파트너 역할을 하기 때문이에요.

때로는 제안된 구현이 마음에 안 들 때가 있어요. 그럴 때는 계획을 바로 수정하지 말고, 왜 틀렸는지 설명해주죠. 그러면 Claude Code가 접근 방식을 바꿔줘요.

"페이지는 /review가 아니라 /explore의 하위 경로여야 해요. 그리고 'admin' 권한이 있는 사용자만 접근할 수 있어야 합니다."

몇 번 주고받다 보면 처음 제안이 실제로 더 나았다는 걸 깨닫기도 해요. 이 과정이 혼자 코드를 짜기 시작했다가 나중에 접근법이 틀렸다는 걸 깨닫는 것보다 훨씬 효율적이에요.

살아있는 문서의 힘

2025년 5월 출시된 '클로드 코드(Claude Code)'는 출시 석 달 만에 사용량이 10배 이상 늘며 런레이트 매출 5억 달러를 기록했어요. 이런 성장의 비밀은 바로 '살아있는 문서' 접근법에 있을지도 몰라요.

핵심 인사이트는 Claude Code가 계획을 단순한 청사진이 아니라 살아있는 문서로 취급하게 하는 것이에요. 구현하면서 계획을 계속 업데이트하도록 명시적으로 요청해요.

구현 과정에서, 특히 타입 체킹이나 린팅, 테스트 과정에서 원래 계획의 일부가 틀렸다는 걸 발견할 수 있거든요. 그래서 코드를 커밋할 때마다 계획이 최신 상태인지 확인하는 습관을 만들었어요.

"계획이 최신 상태인지 확인하고, 변경 사항을 커밋해주세요."

이 접근법은 AI 개발의 근본적인 문제인 컨텍스트 제한을 해결해줘요. 최신 계획 문서만 있으면 새로운 대화를 시작하고 구현을 계속할 수 있거든요.

개발 프로세스의 혁신적 변화

Anthropic은 B2B 분야의 최강자로 자리잡고 있어요. 이는 단순히 기술이 뛰어나서가 아니라, 개발자들의 실제 업무 방식을 근본적으로 바꾸고 있기 때문이에요.

구현이 시작되면 진행 상황을 검토해서 모든 게 제대로 진행되는지 확인해요. 만족스럽다면 자주 체크하지 않고도 계속 진행하게 할 수 있어요.

최종 코드를 검토할 때는 업데이트된 계획 문서가 구현 과정에서 내린 기술적 선택들에 대한 유용한 힌트를 줘요.

놀랍게도 구현에 뛰어들기 전에 기능들을 신중하게 계획해야 한다는 것이 저를 전반적으로 더 나은 개발자로 만들어주고 있어요.

구체적인 성과와 데이터

Claude Code는 몇 시간의 디버깅을 몇 초로 단축시킵니다. 복잡한 버그를 해결할 때 Claude Code와 함께 체계적으로 접근하니까 훨씬 빠르게 해결할 수 있었거든요.

Claude 4는 컨텍스트 윈도우가 1백만 토큰까지 지원되어서, 정말 큰 프로젝트도 한 번에 처리할 수 있어요. 이는 기존 20만 토큰에서 5배 증가한 수치예요.

혼돈에서 시스템으로

이 워크플로우는 제가 나이브한 접근법으로 겪었던 근본적인 문제들을 체계적으로 해결해줘요.

명확한 정보원을 만들어주고, 컨텍스트 제한 문제를 없애주며, 더 나은 아키텍처 사고를 강요해요.

살아있는 문서는 사양서이면서 동시에 구현 로그가 되어서, 무엇이 구축되었는지뿐만 아니라 왜, 어떻게 구축되었는지에 대한 완전한 기록을 만들어줘요.

결과적으로 개발 프로세스가 더 사려 깊고, 더 문서화되고, 더 신뢰할 수 있게 되었어요.

Claude Code는 전체 코드베이스를 이해하고 여러 파일에 걸쳐 조정된 변경을 수행할 수 있는 '에이전틱' 기능을 제공해요. AI는 단순한 구현자 역할에서 벗어나 진정한 협업 설계 파트너가 되었어요.

더 스마트한 협업을 위해

Claude Code는 단순히 코드를 생성해주는 도구가 아니에요. 제대로 사용하면 여러분의 사고 과정을 체계화하고, 더 나은 아키텍처 결정을 내리도록 도와주며, 프로젝트 전체에 대한 명확한 기록을 남겨주는 진정한 협업 파트너가 될 수 있어요.

핵심은 처음부터 계획을 세우고, 그 계획을 살아있는 문서로 유지하며, AI를 단순한 코드 생성기가 아닌 설계 파트너로 대우하는 것입니다.

이런 접근법으로 개발하면 더 나은 코드를, 더 빠르게, 더 체계적으로 만들 수 있을 거예요. 그리고 정말로 하루 20분짜리 일을 2초만에 끝낼 수 있는 날이 올지도 모르겠어요.