Claude Auto-Commit: 코드 변경 사항 분석을 통한 자동 Git 커밋 메시지 생성 도구
요약
Claude Auto-Commit은 Claude Code SDK를 활용하여 코드 변경 사항을 분석하고, 지능적인 Git 커밋 메시지를 자동으로 생성하는 오픈 소스 도구입니다. 이 도구는 Conventional Commits 형식 지원, 이모지 추가, Dry Run 모드 등 다양한 기능을 제공하며 개발 워크플로우에 통합됩니다.
핵심 포인트
- Claude Code SDK 기반으로 코드 변경 사항을 분석하여 의미 있는 커밋 메시지를 생성합니다.
- Conventional Commits 및 이모지 지원 등 고급 기능이 포함되어 있습니다.
- 사용을 위해서는 Claude Pro 또는 Max 구독과 OAuth 인증(claude login)이 필요합니다.
- NPM/NPX를 통해 쉽게 설치하고 사용할 수 있으며, Dry Run 모드로 미리보기가 가능합니다.
Claude Auto-Commit은 Claude Code SDK를 사용하여 코드 변경 사항을 분석함으로써 지능적인 Git 커밋 메시지를 자동으로 생성하는 오픈 소스 도구입니다. 향상된 성능, 신뢰성 및 현대적인 JavaScript 아키텍처로 개발 워크플로우에 원활하게 통합됩니다.
모호한 커밋 메시지는 이제 안녕. Claude AI가 코드의 스토리를 전달하는 의미 있는 커밋을 작성하도록 하세요.
중요 참고 사항:
Claude Pro/Max 구독 및 Claude CLI 인증 필요 - API 키 불필요 - OAuth 인증을 사용하는 Claude Code SDK 사용 - 다음 명령어로 실행
claude login
(아직 인증되지 않은 경우 먼저 실행) - 기본적으로 이 도구는 모든 변경 사항을 자동으로 스테이징하고 커밋합니다.
- 원격 저장소로 자동 푸시를 활성화하려면
--push플래그를 사용하세요. - 커밋하지 않고 커밋 메시지를 미리 보려면
--dry-run플래그를 사용하세요.
방법 1: NPX 실행 (권장, 설치 불필요)
npx claude-auto-commit
방법 2: NPM 전역 설치
npm install -g claude-auto-commit
방법 3: 스크립트 설치
curl -fsSL https://raw.githubusercontent.com/0xkaz/claude-auto-commit/main/scripts/install.sh | bash
방법 4: 일회성 스크립트 실행
curl -fsSL https://raw.githubusercontent.com/0xkaz/claude-auto-commit/main/scripts/run-once.sh | bash
# 변경 사항 분석 및 커밋 메시지 생성
npx claude-auto-commit
# 이모지와 Conventional Commits를 사용한 일본어 예시
...
Claude Auto-Commit은 Claude Pro 또는 Max 구독이 필요한 Claude Code SDK를 사용합니다:
# 첫 사용 설정: Claude CLI에 로그인
claude login
# 옵션 선택:
- 🧠 **AI 분석**: Claude Code SDK를 활용하여 지능적인 코드 변경 사항 이해 - 🌍
**다국어 지원**: 영어와 일본어로 인터페이스 사용 가능 - 📝
**Conventional Commits**: 컨벤셔널 커밋(conventional commit) 형식 선택적 지원 - 😊
**이모지 지원**: 커밋 메시지에 상황별 이모지 추가 - 🔍
**Dry Run 모드**: 실제 커밋 없이 커밋 메시지 미리보기 - 📝
**템플릿 시스템**: 일반적인 커밋 메시지 패턴 저장 및 재사용 - ⚙️
**설정**: JSON 기반 설정 파일 지원 - 🔄
**재시도 메커니즘**: 지수 백오프(exponential backoff)를 통한 향상된 오류 처리 - ⚡
**성능**: 병렬 처리 및 지능형 캐싱 - 🚀
**자동 푸시**: 원격 저장소로의 선택적 자동 푸시 - 📊
**자세한 로깅 (Verbose Logging)**: 상세 실행 메트릭 및 통계 - 🛠️
**구성 가능성**: CLI 옵션 및 설정 파일을 통한 광범위한 사용자 정의 - 📦
**현대 아키텍처**: Node.js ES 모듈과 TypeScript 지원
전체 문서는 이 저장소에서 확인할 수 있습니다.
**Node.js 22.0.0 이상****Git 저장소****ANTHROPIC_API_KEY 환경 변수**
Claude API 접근 권한이 있는 Claude 계정이 필요합니다:
**Claude Pro**($20/월) - 소규모 저장소
**Claude Max**($100/월) - 일반 개발
**Claude Max**($200/월) - 대형 프로젝트/팀
API 키 설정하기:
`export ANTHROPIC_API_KEY=
## 최신 릴리스 다운로드
`curl -L -o claude-auto-commit https://github.com/0xkaz/claude-auto-commit/releases/latest/download/claude-auto-commit.sh`<br>`chmod +x claude-auto-commit`<br>...
`git clone https://github.com/0xkaz/claude-auto-commit.git`<br>`cd claude-auto-commit`<br>`chmod +x src/claude-auto-commit.sh`<br>...
## 개발 또는 테스트용
`git clone https://github.com/0xkaz/claude-auto-commit.git`<br>`cd claude-auto-commit`<br>...
`~/.claude-auto-commit/config.yml` 파일 생성
:
```yaml
auto_update:
enabled: true
frequency: daily # daily/weekly/manual/always
...
Claude Code SDK 마이그레이션: Claude CLI에서 최신 Claude Code SDK로 마이그레이션됨. 병렬 처리 및 지능형 캐싱을 통해 성능 향상
- 신뢰성 향상을 위한 지수 백오프(Exponential backoff) 재시도 메커니즘
- 영구 저장소와 함께 사용 가능한 템플릿 시스템
- JSON 설정 파일 지원
NPM 패키지 배포: npx claude-auto-commit을 통해 이용 가능
OAuth 인증: Claude Pro/Max 사용자에게는 API 키가 필요하지 않음
ES Modules 아키텍처: Node.js 22+를 지원하는 최신 JavaScript 사용
스마트 플레이스홀더(Smart placeholders): 템플릿에서 동적 값을 위해 {variable} 사용
기여 환영합니다! 자세한 내용은 CONTRIBUTING.md 파일을 참조해 주세요.
본 프로젝트는 MIT 라이선스 하에 배포됩니다 - 자세한 내용은 LICENSE 파일을 참고하세요.
- Claude CLI: Anthropic 제공
- Conventional Commits 명세
- 영감을 준 오픈 소스 커뮤니티
개발자 커뮤니티를 위한 ❤️로 제작되었습니다
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Claude Ecosystem의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기