최근 회사에서 Claude Code를 업무에 도입하며 경험한 여러가지 편리하고 강력한 경험들에 대해서 기록합니다.
Claude Code를 사용하며 가장 놀라웠던 점은 프로젝트 내의 기존 코드의 스타일 가이드, 디자인 시스템, 심지어 다국어 처리(i18n) 패턴까지 스스로 학습하여 완벽하게 적용한다는 점이었습니다.
어느정도 스크립트를 세밀하게 전달하거나 디자인 시안을 png로 업로드 하면, 기존의 코드와 거의 동일한 형식으로
화면UI와 컴포넌트를 생성해주기에, 정말 편리한 경험이었고 최근에 배포한 기능의 개발시간을 효과적으로 단축 시킬 수 있었습니다.
(물론, AI를 무조건적으로 신뢰할 수 없기에 코드 commit 전 변경사항을 꼼꼼히 검수하는 시간은 필요 했습니다.🥲)
어느떄보다 빠르게 개발했던 시간이었습니다.
본 글에서는 Claude Code를 활용해 git 워크플로우를 자동화하고, 생산성을 극대화하는 방법을 나누고자 합니다.
🏃♂️
🏃♂️
🏃♂️
Claude Code 맞춤형 커맨드 구축
프로젝트 루트의 .claude/commands/ 폴더 내 마크다운 파일을 통해 사용자 정의 명령어를 정의.
클로드에게 직접 작업 지침을 부여하는 것과 같다.
상세 커밋 & 푸시 자동화 (/cpush)
개발자가 가장 귀찮아하지만 협업에서 가장 중요한 것이 바로 상세한 커밋 메시지 입니다.
아래 예시와 같이 간단한 마크다운으로 커밋과 푸시를 자동화 할 수 있습니다.
.claude/commands/cpush.md
# Git Workflow Automation (/cpush)
## Purpose
모든 변경 사항을 스테이징하고, 코드 변경의 맥락을 분석하여 Semantic Commit 메시지를 작성한 후 푸시합니다.
## Instructions
1. **Context Analysis**: `git diff --cached`를 통해 변경된 로직, UI 컴포넌트, 다국어 키값 등을 분석하세요.
2. **Style Consistency**: 프로젝트 내 기존 커밋 히스토리를 참고하여 톤앤매너를 유지하세요.
3. **Drafting Message**:
- `type: description` 형식의 헤더 (예: `feat: 로그인 모달 유효성 검사 로직 추가`)
- 본문(Body)에는 변경된 이유(Why)와 주요 변경 파일별 상세 수정 사항을 포함하세요.
4. **Execution**:
- `git add .`
- 분석된 메시지로 `git commit`
- `git push` 실행
터미널에 /cpush를 실행하면
실제로 github에 push까지 자동화되어 간단명료하게 작업내용에 대해 커밋이 가능합니다.
더 활용 가능한 커맨드.
단순한 커밋 외에도 다음과 같은 자동화 커맨드를 구축해 볼 수 있습니다.
A. 코드 리뷰 사전 점검 (/check)
# Pre-Review Check
1. 변경된 코드에서 `console.log`나 테스트용 임시 코드가 있는지 확인해줘.
2. 우리 프로젝트의 ESLint 규칙을 위반할 가능성이 있는 부분을 리포트해줘.
3. 성능상 병목이 생길 수 있는 루프(Loop) 구조가 있다면 지적해줘.
B. 단위 테스트 자동 생성 (/testgen)
# Unit Test Generator
1. 최근 수정된 파일 중 로직이 포함된 파일을 식별하세요.
2. `Vitest` 또는 `Jest`를 사용하여 해당 로직의 엣지 케이스를 포함한 테스트 코드를 작성하세요.
3. 기존 테스트 코드 스타일(Mocking 방식 등)을 그대로 유지하세요.
마지막으로, AI 시대의 생존 전략...
이제는 "코드를 짤 줄 아는가?"보다 "AI를 얼마나 효율적으로 활용하는가?"가 앞으로의 미래를 결정 짓는 것 같습니다...
Claude Code를 통해 나만의 개발 도구를 구축하는 과정은 단순히 편의를 넘어, 프로젝트 전체를 설계하고 관리하는 구조적 사고를 기르는 데 큰 도움이 될 것 같다는 생각이 듭니다.
