무신사의 claude-code-action 기반 AI 코드 리뷰 전사 표준화

요약

AI 코드 리뷰를 도입하고 싶어도 인프라 구축 비용이 높았는데, Anthropic이 claude-code-action을 정식 출시하면서 YAML 몇 줄로 도입이 가능해졌습니다. 무신사가 이를 개인 실험에서 전사 표준 인프라로 발전시킨 과정에 대한 글입니다.

인사이트

• 커밋마다 AI 코멘트가 쌓여 PR이 지저분해지는 문제 — "미해결 + 사람 답글 없는 봇 코멘트"만 삭제하고, Resolved되었거나 사람이 답글 단 스레드는 보존하는 GraphQL 기반 정리
  로직으로 해결
• 프롬프트는 짧을수록 안정적 — 최신 모델의 제로샷 능력을 활용하여 핵심 지시만 주고, 반복적으로 발생하는 이슈만 점진적으로 추가
• Claude Pro/Max 구독 범위 내에서 추가 API 비용 없이 동작 — setup-token으로 발급하는 것은 API 키가 아닌 구독 인증 토큰

해결

1. 도입 3단계

• claude setup-token으로 토큰 발급 → GitHub Secrets에 등록 → workflow YAML 파일 추가
• 인라인 코멘트 + 커밋 Suggestion으로 문제 라인에 수정안을 바로 제안

2. 전사 표준화 — Composite Action

• 공용 워크플로우 저장소(musinsa/workflows)에 액션 패키징, 각 팀은 몇 줄의 YAML로 호출
• 고정 영역(코멘트 정리, 기본 프롬프트)은 중앙 관리, 가변 영역(언어, 프로젝트 컨텍스트, 추가 프롬프트)은 파라미터로 개방
• @main(최신)과 @v1.x(안정) 투트랙 버전 관리

3. 개인 토큰에서 전사 공용 토큰으로

• 코드 리뷰 전용 계정을 분리하여 Organization Secret으로 등록, 모든 레포지토리에서 키 발급 없이 사용

결과

Personalization 팀 전체(Frontend, Backend, ML Engineer)의 모든 레포지토리에 기본 탑재되어 운영 중입니다.