Claude Code를 유지보수에 적용할 때 봐야 할 세 가지
AI가 코드를 작성할 수 있는지는 더 이상 핵심 질문이 아니다. 반복적인 유지보수 작업을 맡기고, 검토를 거쳐 실제 제품에 반영할 수 있는지가 더 중요하다.
Anthropic은 최근 몇 주간 Claude Code를 사내 소프트웨어의 일일 유지보수에 시험했다. Claude Code는 Anthropic 저장소에서 388개의 풀 리퀘스트를 생성했고, 자동 검토와 사람의 검토를 거친 180개가 병합됐다. 병합률은 약 46%였으며 대상은 iOS, Android, 데스크톱, 웹, CLI, Agent SDK였다.1
이 결과를 실무 관점에서 이해하려면 세션, 프로젝트 규칙, 검토 절차라는 세 가지 요소를 살펴봐야 한다.
작업 범위는 세션 단위로 관리한다
Claude Code는 특정 디렉터리에서 실행을 시작해 종료할 때까지를 하나의 세션으로 본다. 각 세션의 대화 기록은 독립적이지만, 프로젝트 메모리인 CLAUDE.md는 세션이 바뀌어도 유지된다.2
CLAUDE.md는 프로젝트 규칙과 자주 사용하는 명령, 작업 제약을 기록하는 마크다운 파일이다. 프로젝트 루트, 홈 디렉터리 또는 하위 폴더에 둘 수 있으며 Claude Code가 세션을 시작할 때 자동으로 읽는다.2 반복 작업마다 같은 지침을 다시 설명하지 않고도 일관된 기준을 적용할 수 있는 장치다.
세션의 컨텍스트에는 프롬프트와 응답뿐 아니라 읽은 파일의 내용도 포함된다. 컨텍스트 창이 가득 차면 오래된 내용은 압축되거나 제거된다.2 따라서 유지보수 작업은 목표와 변경 범위를 명확히 나누고, 세션에 필요한 정보만 제공하는 편이 합리적이다.
46%는 품질 판정이 아니라 운영 지표다
병합되지 않은 풀 리퀘스트를 모두 잘못된 코드로 볼 수는 없다. 반대로 46%라는 수치만으로 완전 자동화가 가능하다고 결론 내릴 수도 없다. 이 수치가 보여주는 것은 Claude Code가 변경안을 생성하고, 자동 검토와 사람의 검토를 거쳐 일부가 실제 저장소에 반영되는 운영 흐름이다.
따라서 생성된 풀 리퀘스트 수만 보는 것보다 다음 단계를 구분해 살펴보는 것이 중요하다.
Claude Code가 변경안을 생성했는가
자동 검사와 검토를 통과했는가
사람이 확인한 뒤 병합했는가
Claude Code의 역할은 모든 변경을 자동으로 통과시키는 것이 아니라, 검토 가능한 수정안을 반복적으로 제안하는 데 가깝다. 최종 품질 기준과 병합 결정은 기존 개발 절차 안에서 관리해야 한다.
도입 전 준비할 세 가지
실무에 Claude Code를 적용하려면 다음과 같은 운영 기준이 필요하다.
작업 범위 제한: 반복적인 유지보수 작업을 명확하고 작은 단위로 정의한다.
프로젝트 규칙 기록:
CLAUDE.md에 명령, 제약, 금지 사항 등 세션마다 유지해야 할 기준을 적는다.검토 절차 유지: 테스트와 자동 검토, 사람의 승인을 병합 조건으로 둔다.
결국 Claude Code의 가치는 모든 코드를 자동으로 병합하는 데 있지 않다. 프로젝트 규칙과 검토 절차 안에서 변경안을 꾸준히 만들고, 그중 적합한 결과를 실제 제품에 반영하는 데 있다.
한 줄 요약: Claude Code의 약 46% 병합률은 완전 자동화의 증거라기보다, 명확한 작업 범위와 프로젝트 규칙, 검토 절차가 있을 때 AI 기반 유지보수를 실무에 연결할 수 있음을 보여준다.
1Claude Code now runs daily maintenance on Anthropic's software with a 46 percent merge rate
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.