Claude Code /simplify와 /batch로 병렬 코드 리뷰·대규모 변경 자동화하기

AI 코딩 도구로 코드 생성 속도는 크게 높아졌습니다. 그러나 코드 리뷰와 대규모 변경에는 여전히 한계가 있는데요. 다면 심층 리뷰를 빠르게 진행하기 어려운 점, 대규모 변경을 효율적으로 진행하기 힘든 점이 그 예죠.

코드를 제대로 리뷰하려면 가독성, 성능, 설계 등 여러 측면을 평가해야 합니다. 그러나 한 번의 리뷰로 처음부터 모든 측면을 깊이 검토하며, 주요 문제를 빠짐없이 탐지하기란 쉽지 않죠. AI로 한 번 리뷰하고 사람이 보완하면 시간이 걸리고, 리뷰를 한 번으로 끝내면 놓치는 문제가 생길 수 있습니다.

아울러 프레임워크 교체, 라이브러리 전환, 네이밍 컨벤션 통일과 같은 변경은 수십 개 이상의 파일에서 진행하는데요. 작업 범위가 넓으면 무슨 작업부터 어떻게 시작할지 막막할 때가 있죠. 작업 단위를 잘게 분해해 AI에 맡겨도 순서대로 처리하느라 시간이 소요됩니다.

Claude Code의 /simplify와 /batch는 위의 두 문제를 효율적으로 해결하는 커맨드입니다. /simplify는 코드 재사용, 코드 품질, 효율성을 검토하는 3개 전문 에이전트가 동시에 코드를 리뷰하고요. Claude Code가 이를 종합해 ‘유효하다’고 판단한 문제를 자동으로 수정해 다면 심층 리뷰와 문제 해결 속도를 높입니다. /batch는 대규모 변경을 독립적인 작업 단위로 분해하고 승인 후 병렬 실행하는데요. 각 에이전트가 격리된 환경에서 독립적으로 작업해 작업 속도를 끌어올리죠.

이 글에서는 /simplify와 /batch의 개념과 동작 방식, 실전 사용법, 유의 사항을 살펴보겠습니다.

커맨드 개요

/simplify와 /batch는 Claude Code v2.1.63에서 도입된 번들 커맨드입니다. 각 커맨드의 개념과 동작 방식을 알아보겠습니다.

/simplify

개념

/simplify는 Claude Code의 AI 에이전트가 git diff 기준 변경된 코드를 세 가지 측면에서 동시에 리뷰한 뒤, 문제를 자동으로 수정하는 커맨드입니다. 린터가 문법·스타일을 검사한다면, /simplify는 아키텍처·구조·효율성을 검토하고 개선하는 게 특징이죠. PR을 제출하기 전 품질 게이트로 활용하면 리뷰어의 부담을 줄이고 리뷰 시간을 단축할 수 있습니다.

동작 방식

1. /simplify를 실행하면, Claude Code가 git diff 기준 변경된 코드를 대상으로 3개의 전문 리뷰 에이전트를 병렬로 실행합니다. git 변경 내역이 없으면, 대화에서 언급됐거나 최근 수정된 파일로 폴백합니다. 각 에이전트가 주로 검토하는 내용은 다음과 같습니다.
   1. Code Reuse 에이전트: 중복 로직, 기존 유틸리티로 대체 가능한 코드 등
   2. Code Quality 에이전트: 가독성, 구조, 컨벤션, 추상화 문제 등
   3. Efficiency 에이전트: 불필요한 연산, 놓친 동시성 기회, 핫패스 비용, 메모리 누수 등
2. 세 에이전트의 리뷰 결과가 모이면 Claude Code가 이를 종합해 유효하다고 판단한 문제를 수정하고 결과를 요약합니다.
3. 수정할 문제가 없으면 ‘코드가 깨끗하다’는 확인 결과를 출력합니다.

/batch

개념

/batch는 대규모 변경을 독립적인 작업 단위로 자동 분해하고, 각 작업 단위를 병렬로 실행한 뒤 작업 단위별 PR을 생성하는 커맨드입니다. 사용자가 변경 지시만 전달하면 Claude Code가 코드베이스 조사부터 분해, 실행, PR 생성까지 전체 과정을 처리하는 게 특징인데요. 각 PR은 독립적으로 merge 할 수 있어 하나에 문제가 있어도 나머지는 그대로 진행할 수 있습니다.

동작 방식

1. /batch로 변경 지시를 전달하면, Claude Code가 코드베이스를 조사해 영향 범위를 파악하고 작업을 5 ~ 30개 단위로 분해합니다. 검증 방법도 함께 결정해 사용자에게 계획을 제시합니다.
2. 사용자가 계획을 승인하면, 단위별로 백그라운드 에이전트가 격리된 git worktree에서 실행됩니다. 각 에이전트는 독립된 브랜치와 작업 디렉터리를 가지므로 에이전트 간 간섭은 없습니다.
3. 각 에이전트는 할당된 작업을 구현한 뒤 테스트를 실행하고, PR을 생성합니다.
4. 각 에이전트가 작업을 완료할 때마다 상태 테이블을 업데이트하고, 모든 에이전트가 작업을 완료하면 결과를 요약합니다.

두 커맨드의 핵심 차이를 정리하면 다음과 같습니다.

실전 사용법

프로젝트에서 /simplify와 /batch를 사용하는 방법을 단계별로 살펴보겠습니다.

사전 준비

• Claude Code v2.1.63 이상이 설치돼 있어야 합니다.
• Git이 초기화된 프로젝트 디렉터리에서 커맨드를 실행하세요. /batch는 git worktree를 사용해 Git 저장소가 필수입니다.
• /batch의 PR 자동 생성 기능을 사용하려면 GitHub 저장소에 연결된 프로젝트에서 실행하세요.

/simplify 사용법

1. 터미널에서 프로젝트 폴더로 이동하고 Claude Code를 실행합니다.

   bash

   cd [프로젝트 경로]
   claude
   

2. 기능 구현이나 버그 수정을 진행합니다.

   

3. 커밋하지 않은 상태에서 /simplify를 입력합니다.

   

4. 3개의 리뷰 에이전트(Code Reuse, Code Quality, Efficiency)가 병렬로 실행됩니다.

   

   

5. 에이전트의 코드 리뷰와 수정 작업이 끝나면 수정 결과 요약이 출력됩니다.

   

/batch 사용법

1. Claude Code에서 /batch [변경 지시]를 입력합니다.

   

2. Claude Code가 코드베이스를 조사하고 분해 계획을 제시합니다.

   

3. 분해 계획의 파일 범위와 그룹핑을 검토합니다.

   

4. 승인 옵션 중 “Yes, auto-accept edits”를 선택합니다.

   

5. 단위별 에이전트가 병렬로 작업을 진행합니다.

   

   

6. 상태 테이블에서 각 에이전트의 작업 진행 상황을 확인합니다.

   

7. 모든 에이전트가 작업을 완료하면 결과 요약과 PR 목록이 출력됩니다.

   

   

유의 사항

다음 사항을 참고하면, /simplify와 /batch를 효과적으로 활용할 수 있습니다.

/simplify

1. 리뷰 시점: /simplify는 git diff 기준 변경된 코드를 리뷰합니다. git 변경 내역이 없으면 최근 수정 파일로 폴백합니다. 기능 구현이나 버그 수정 직후에 실행하는 게 좋습니다.
2. 자동 수정 검증: 자동 수정 내용이 항상 올바른 건 아닙니다. 수정 후 git diff로 변경 내용을 확인하고, 문제가 있으면 git checkout으로 되돌리는 걸 권장합니다.
3. 관심사 지정: /simplify를 실행할 때 특정 관심사를 명시하면, 더 정밀한 리뷰 결과를 얻을 수 있습니다. 예를 들어, /simplify 에러 핸들링에 집중해, /simplify 메모리 효율에 집중해라고 구체적으로 지시하면 관심사에 초점을 맞춘 리뷰 결과를 도출할 수 있습니다.
4. 린터·포매터 병용: 린터·포매터와 함께 사용하세요. /simplify는 아키텍처·구조·효율성을 다루므로 문법·스타일을 검사하는 린터·포매터와 역할이 다릅니다. 대체재가 아닌 보완재로 활용하는 게 적절합니다.
5. CLAUDE.md 활용: CLAUDE.md에 프로젝트 컨벤션을 미리 정의하세요. Claude Code가 이를 참조해 /simplify 리뷰의 정확도를 높일 수 있습니다.

/batch

1. 적합한 변경: /batch는 각 작업 단위를 독립된 환경에서 병렬 실행하므로, 독립적으로 분해할 수 있는 대규모 변경에 적합합니다. 프레임워크 마이그레이션, 컨벤션 통일, 라이브러리 교체, 테스트 생성 등이 사용하기에 좋은 예입니다.
2. 부적합한 변경: 이는 작업 단위 간 의존성이 있는 변경에는 적합하지 않습니다. 각 에이전트가 독립적으로 작업하므로 단위 간 의존성이 있으면 제대로 동작하지 않습니다. 작업 단위 간 의존성이 있다면 일반 Claude Code 세션을 활용하세요.
3. 분해 계획 검토: 분해 계획을 승인하기 전에 반드시 검토하세요. 자동 분해 내용이 올바르지 않을 수 있어 파일 범위와 그룹핑의 적절성을 확인하는 걸 권장합니다.
4. 공유 유틸리티 생성: 공유 유틸리티가 필요하면 /batch 실행 전에 생성하세요. 각 에이전트는 독립적으로 작업하기에 다른 에이전트의 결과에 의존할 수 없습니다. 공유 유틸리티를 미리 생성해 두면 모든 에이전트가 이를 참조해 일관되게 작업할 수 있습니다.
5. 테스트 커버리지: 테스트 커버리지는 결과 품질에 직접 영향을 미칩니다. 테스트가 부족하면 에이전트가 문제 있는 코드를 그대로 통과시킬 수 있습니다. 충분한 테스트를 갖춘 상태에서 /batch를 실행하세요.
6. 변경 지시 작성: 변경 지시는 구체적으로 작성하는 게 좋습니다. 예를 들어, 코드베이스를 업데이트해 줘보다 모든 moment.js import를 dayjs로 교체하고, dayjs 구문에 맞게 API 호출을 업데이트해 줘라고 쓰면 분해 정확도가 높아집니다.
7. .gitignore 설정: /batch는 git worktree를 사용하므로 .claude/worktrees/를 .gitignore에 추가하는 걸 권장합니다. 이로써 임시 worktree 파일이 저장소에 추적되는 걸 방지할 수 있습니다.

맺음말

지금까지 Claude Code /simplify와 /batch의 개념과 동작 방식, 실전 사용법, 유의 사항을 살펴봤습니다. 이 글의 요점은 다음과 같은데요.

1. /simplify는 3개 전문 에이전트가 코드 재사용, 코드 품질, 효율성을 동시에 리뷰한 뒤 문제를 자동으로 수정하는 커맨드입니다. PR 제출 전 품질 게이트로 활용하면 리뷰어의 부담을 줄이고 리뷰 시간을 단축할 수 있습니다.
2. /batch는 대규모 변경을 독립적인 작업 단위로 자동 분해하고 병렬 실행한 뒤 작업 단위별 PR을 생성하는 커맨드입니다. 각 에이전트가 격리된 환경에서 독립적으로 작업해 하나에 문제가 있어도 나머지는 그대로 진행할 수 있습니다.
3. /simplify는 커밋 전에 실행해야 git diff 기준으로 변경 사항을 탐지합니다. 자동 수정 결과는 git diff로 반드시 확인하고, 문제가 있으면 되돌리세요.
4. /batch는 작업 단위 간 의존성이 없는 변경에 적합합니다. 분해 계획을 승인하기 전에 파일 범위와 그룹핑을 검토하고, 공유 유틸리티가 필요하면 실행 전에 미리 생성하세요.

참고 자료

1. “Extend Claude with skills”, Anthropic, https://code.claude.com/docs/en/skills
2. Claude Code Changelog, Anthropic GitHub 리포지터리, https://code.claude.com/docs/en/changelog
3. “Claude Code /simplify and /batch: Bundled Commands That Ship Code Faster”, Claude Fast, https://claudefa.st/blog/guide/mechanics/simplify-batch-commands
4. “Claude Code Batch Processing Complete Guide: /batch Command and Headless Mode in Practice”, SmartScope, https://smartscope.blog/en/generative-ai/claude/claude-code-batch-processing/

우리 회사에 딱 맞는 DevSecOps 관행과 프레임워크를 찾고 계시나요? DevOps 전문가, 인포그랩과 상담하세요!