Claude Code에 개발 전부 맡긴 엔지니어의 최후…1~2개월 뒤 진짜 지옥 펼쳐진다

“월수입 100만엔 초과 엔지니어를 다수 배출한 유우키는 Claude Code에 개발을 전부 맡기는 현장이 급증하고 있다며, 1~2개월 뒤 코드베이스가 붕괴하는 '지옥'이 온다고 경고했다. 초기 2주는 생산성이 급등하지만 1개월쯤부터 파일마다 API 응답 형태와 에러 처리, 명명 규칙이 제각각이 되고 유사 함수가 3~4개씩 생기며, 2개월 후에는 신기능 하나 추가할 때마다 다른 기능이 깨져 복구에 수주~수개월이 걸린다. 해법은 '판단은 사람, 작업은 AI'로 디렉터리 구조·API 설계·DB 테이블 설계는 직접 결정하고 테스트 작성·기존 패턴 구현·리팩터링만 AI에 맡기는 것이다.”

AI 요약

프리랜서 엔지니어 유키가 Claude Code 등 AI 코딩 도구에 개발을 전면 위임하는 현장의 위험성을 경고하는 글이다. 초기 2주는 생산성이 폭발적으로 오르지만, 1개월쯤 지나면 파일마다 API 응답 형식·에러 처리·명명 규칙이 제각각이 되는 증상이 나타나고, 2개월 후에는 새 기능 하나 추가할 때마다 다른 기능이 연쇄적으로 깨지는 지옥이 시작된다. 저자는 원인이 AI가 아니라 "판단까지 AI에 맡긴 엔지니어"라고 지적하며, 디렉터리 구조·API 설계·DB 설계 같은 전체 판단은 사람이 하고, 테스트 코드 작성·기존 패턴 구현·리팩터링 실행은 AI에 맡기라는 원칙을 제시한다.

핵심 포인트

  • AI 위임 후 1개월경 파일별 응답 형식·에러 처리·명명 규칙 불일치, 중복 함수 3~4개 발생
  • 2개월 후 신기능 추가 시 연쇄 장애로 릴리스 지연, 복구에 수주~수개월 소요
  • AI에 위임하면 안 되는 것: 디렉터리 구조, 신기능 배치, API 설계, 응답 형식, DB 테이블·관계 설계
  • AI에 맡겨도 되는 것: 테스트 코드 작성, 기존 패턴 준수 구현, 리팩터링 실행
  • 핵심 원칙: "판단은 사람이, 손은 AI가" — AI에 던지기 전 5분간 스스로 설계 메모

향후 전망

  • AI 코딩 도구 도입 현장의 약 90%가 1~2개월 내 기술 부채 지옥에 도달할 것으로 저자는 전망
  • CLAUDE.md·ADR 등 설계 근거 문서화와 사전 설계 습관이 AI 활용 생산성의 관건이 될 전망
출처:note (유키)
Share

이것도 읽어보세요

댓글

이 소식에 대한 의견을 자유롭게 남겨주세요.

댓글 (0)

불러오는 중...