클로드 코드 2,500곳 분석: 대부분 얕게 쓴다

클로드 코드(Claude Code)를 쓰는 개발자는 빠르게 늘었지만, 대부분은 그 잠재력의 표면만 긁고 있다. 빌드 디스 나우(Build This Now)가 클로드 코드를 사용하는 공개 깃허브(GitHub) 저장소 2,500곳을 분석한 결과, 설정 파일 한 장만 두고 멈춘 경우가 압도적이었다. 전체의 84.9%가 프로젝트 지침 파일인 CLAUDE.md를 두고 있었지만, 맞춤형 서브에이전트를 정의한 곳은 24.6%에 그쳤다.

무슨 일인가

클로드 코드는 단순한 코드 자동완성 도구가 아니라, 서브에이전트·스킬(Skill)·훅(Hook)·MCP로 작업 전체를 위임하는 에이전트 플랫폼으로 설계됐다. 그러나 이번 조사는 대다수 사용자가 그 단계까지 가지 않았음을 보여준다. .claude 설정 디렉터리를 둔 곳은 62.1%였고, 에이전트·스킬·명령·훅·MCP 중 하나라도 쓴 곳은 53.9%였다. 훅을 쓰는 곳은 13.3%, 프로젝트 단위 MCP 설정은 17.0%에 불과했다. 사다리를 한 칸 오를 때마다 약 3분의 1씩 이탈하는 셈이다.

핵심 짚어보기

보고서가 짚은 핵심은 생태계가 '넓지만 얕다'는 것이다. 설치는 많이 했지만, 그 위에 자기만의 시스템을 쌓은 사람은 소수다. 흥미로운 건 한번 깊이 들어간 사용자들의 밀도다. 서브에이전트를 하나라도 정의한 614곳의 중앙값은 6개, 상위 10%는 25개 이상을 운용했다. 스킬을 쓰는 저장소의 중앙값은 8개였고, 수백 개에 이르는 경우도 있었다. CLAUDE.md도 더 이상 한 줄짜리가 아니다. 중앙값은 6.2KB(약 100~150줄)였고, 상위 1%는 62KB를, 가장 큰 파일은 341KB를 넘겼다. 사용 언어는 타입스크립트 30.2%, 파이썬 22.7%로 둘이 절반을 넘었고, 표본의 78.2%가 최근 90일 안에 갱신된 살아 있는 저장소였다.

1인기업 실전 적용 포인트

• CLAUDE.md만 두고 멈추지 말 것: 반복 작업(테스트·배포·리포트)을 서브에이전트 1개로 떼어내는 것만으로 상위 25% 그룹에 진입한다.
• 훅(13.3%만 사용)은 차별화 지점이다. 커밋 전 린트, 파일 저장 시 자동 검증처럼 '사람이 잊는 일'을 훅으로 자동화하면 품질이 일정해진다.
• 스킬·서브에이전트 중앙값(8개·6개)을 벤치마크로 삼아, 내 업무를 6~8개 역할로 쪼개 각각에 전용 에이전트를 배정해보라.
• CLAUDE.md를 프로젝트의 '기억 장치'로 키워라. 결정·관례·금지사항을 계속 축적하면 매 세션 설명을 반복하지 않아도 된다.

전망 / 주의점

넓고 얕은 생태계는 곧 '깊게 쓰는 소수에게 기회가 열려 있다'는 뜻이기도 하다. 도구를 자동완성으로 쓰는 다수와 플랫폼으로 쓰는 소수 사이의 격차가, 1인기업에게는 생산성 격차이자 경쟁 우위가 된다. 다만 표본의 중앙값 별점이 0이라는 점에서 보듯 대부분은 개인·소규모 프로젝트이며, 화려한 설정이 곧 성과를 보장하진 않는다. 핵심은 설정 개수가 아니라, 내 반복 업무 중 무엇을 위임할지 먼저 정하는 것이다.

출처: 빌드 디스 나우(Build This Now) (https://www.buildthisnow.com/blog/real-examples/state-of-claude-code-2026)