본문으로 건너뛰기
블로그로 돌아가기
AI Agents

Claude Code 실무 도입기 — 4인 팀이 한 달 만에 일하는 방식을 바꾼 기록

하이프마크 AI팀
2026년 5월 17일
Claude Code 실무 도입기 — 4인 팀이 한 달 만에 일하는 방식을 바꾼 기록

처음에는 한 명이었습니다

2025년 10월, 우리 팀의 한 개발자가 Claude Code를 혼자 쓰기 시작했습니다. 11월 말, 팀 전체가 일하는 방식이 바뀌었습니다. 12월에는 이 워크플로우를 모르는 사람을 채용할 수 있을까? 라는 질문이 생겼습니다.

이 글은 그 한 달의 기록입니다. 자랑이 아니라 어디서 막혔는지, 어떤 결정이 살아남았는지를 사실 그대로.

우리 팀 구성

  • 4명 (프론트 1, 백엔드 1, AI/데이터 1, PM 1)
  • 모두 시니어 ~ 미드 (주니어 없음, 채용 진행 중)
  • 한국어 환경
  • 1주 단위 스프린트, 매주 금요일 회고

첫째 주 — 1인 실험

첫 사용자는 백엔드 개발자. 다음 작업을 Claude Code로 시도했습니다:

작업결과
Firebase Admin SDK 셋업 (보일러플레이트)30분 → 8분
API 라우트 5개 일괄 작성4시간 → 40분
기존 TypeScript 버그 디버깅2시간 → 2시간 (개선 없음)
마이그레이션 SQL 작성1.5시간 → 20분

관찰 — 패턴이 명확한 보일러플레이트와 마이그레이션에서는 5-6배 빨라졌지만, 원인 추적이 필요한 디버깅 은 사람이 더 빨랐습니다.

둘째 주 — 두 명 + 충돌

프론트엔드 개발자가 합류. 이때 첫 충돌이 발생:

"Claude Code가 우리 팀 컨벤션을 안 따라요. PR마다 코멘트 스타일이 달라요."

해결: 프로젝트 루트에 CLAUDE.md 파일을 만들고 다음을 명시했습니다.

  • 컴포넌트 명명 규칙
  • import 순서
  • 주석 작성 규칙 (한국어 vs 영어 — 우린 내부 코드 한국어, 오픈소스 영어)
  • 금지 사항 (any 타입, console.log)

그 다음 PR부터 일관성이 잡혔습니다. CLAUDE.md는 선택이 아니라 필수라는 게 첫 교훈.

셋째 주 — MCP 도입

세 번째 도입은 MCP 서버 연결. 우리가 박은 MCP는 세 가지:

  1. Marblo MCP — 우리 자체 태스크 관리. 작업 시작 시 티켓 생성, 진행 중 액티비티 로그, 완료 시 상태 변경. 모두 Claude Code 안에서.
  2. GitHub MCP — PR 생성, 이슈 확인, 브랜치 관리.
  3. Custom 도메인 MCP — 우리 운영 서버 로그 조회, 배포 트리거.

이 시점부터 작업 흐름 자체가 바뀌었습니다.

MCP 도입 전후 비교

도입 전 워크플로우:

1. Notion 열고 태스크 확인
2. 터미널에서 브랜치 체크아웃
3. 코드 작성
4. 다른 터미널에서 테스트
5. GitHub 웹에서 PR 생성
6. Notion 돌아가서 상태 업데이트

도입 후 워크플로우:

1. claude code .
2. "Marblo MCP에서 내 다음 태스크 가져와줘"
3. "코드 작성"
4. "PR 만들고 Marblo 상태 REVIEW로 바꿔줘"

3-5단계가 한 문장으로. 컨텍스트 전환이 거의 사라졌습니다.

넷째 주 — 팀 전체 합류

마지막 주에 AI/데이터 개발자와 PM이 합류. PM도 Claude Code를 기획 도구 로 씁니다 — 명세 작성, 사용자 시나리오 정리, 디자인 도구와의 핸드오프 문서.

PM의 한 마디:

"디자이너에게 넘기는 명세 문서를 작성하는 데 평소 3-4시간 걸렸는데, Claude Code로 1시간 안에 끝나요. 그리고 빠뜨리는 항목이 줄었어요."

PM의 도입은 예상 못한 효과를 만들었습니다 — 개발자와 PM이 같은 환경에서 같은 언어로 대화하니까 명세 핸드오프 단계가 거의 사라졌습니다.

한 달 후 — 측정한 변화

지표이전이후
PR 평균 소요 시간2.4일1.1일
코드 리뷰 라운드2.4회1.6회
명세 → 디자인 핸드오프 시간3.5일1.5일
야근 빈도주 2.3회주 0.8회
신규 컴포넌트 작성 시간4시간1.2시간

이게 한 달입니다. 시니어 4명 기준입니다. 주니어 비율이 높은 팀은 다를 수 있습니다.

살아남지 못한 패턴들

성공만 쓰는 건 거짓말입니다. 시도했다가 폐기한 것들:

폐기 1 — Claude Code의 자동 커밋 첫 주에 자동 커밋을 켰다가 우리 pre-commit 훅 (린팅·타입체크·시크릿 스캔)을 우회하는 사고가 났습니다. 그 이후로 모든 커밋은 사람이 확인.

폐기 2 — 무제한 권한 모드 초기에 bypassPermissions 모드로 썼다가 원치 않은 파일 삭제가 한 번 발생. 그 이후 acceptEdits 모드로 고정.

폐기 3 — 사용자별 다른 설정 파일 각자 ~/.claude/ 설정이 다르니까 같은 작업이 사람마다 다른 결과. 팀 공통 dotfiles 리포로 통합.

폐기 4 — 영어로만 대화 한국어로 대화하는 게 더 정확합니다. 시스템 프롬프트는 영어로 두지만, 사용자 메시지는 한국어가 표현이 정확함.

비용

월 LLM 비용 (4명 합산):

  • 도입 전: 약 80만원 (개별 사용)
  • 도입 후: 약 140만원 (Claude Code Max 4계정 + 기타)

+60만원/월.

회수는?

  • PR 시간 단축 × 4명 × 시급 환산 = 월 600만원 이상 효과
  • 순효과 +540만원/월

회수기간은 첫 주. 비용은 거의 무의미한 항목이 됐습니다.

신규 채용에 미친 영향

마지막 변화: 채용 공고에 "Claude Code + MCP 환경에 적응 가능한 분" 을 명시.

면접에서 묻는 질문도 바뀌었습니다:

  • "AI 코딩 도구를 어떤 작업에 안 쓰시나요?" (= AI를 무비판적으로 쓰지 않는 판단력)
  • "AI가 만든 코드를 어떻게 검증하시나요?" (= 비판적 리뷰 능력)

도구를 잘 쓰는 사람보다 언제 도구를 쓰지 말지 아는 사람을 찾는 방향으로 채용 기준이 바뀌었습니다.

다른 팀에 추천할 때

질문 4개:

  1. 시니어 비율이 50% 이상인가? — 그렇다면 도입이 빠릅니다.
  2. CLAUDE.md를 작성할 수 있는가? — 팀 컨벤션을 글로 쓸 수 있어야 합니다.
  3. MCP를 박을 사람이 1명 있는가? — 처음 셋업은 1주 정도 걸립니다.
  4. dotfiles를 팀 공통으로 운영할 의지가 있는가? — 개별 설정으로는 효과의 절반밖에 못 얻습니다.

4개 모두 YES면 한 달 안에 변화가 보입니다. 1-2개 NO면 더 천천히 가는 게 안전합니다.

다음에 우리가 할 일

  • 주니어 개발자 1명 채용 후, 그 사람이 Claude Code 환경에서 얼마나 빨리 시니어 수준 산출물을 내는지 측정
  • MCP 서버 추가 (Slack 알림, Notion 동기화)
  • 디자인 → 코드 자동 변환 워크플로우 (Figma MCP 시도)

직접 도입 상담

같은 도입을 검토 중이시라면 무료 30분 상담 을 신청하실 수 있습니다. 우리 한 달의 기록을 귀사 컨텍스트에 맞춰 분해해드립니다.

관련 글


마지막 업데이트: 2026-05-17.

더 많은 인사이트가 필요하신가요?

AI 마케팅 전문가와 상담하고 비즈니스를 성장시키세요

문의하기
Claude Code 실무 도입기 — 4인 팀이 한 달 만에 일하는 방식을 바꾼 기록 - Hypemarc Blog | Hypemarc