Claude Forge: Claude Code를 위한 oh-my-zsh 스타일 설정 프레임워크

Claude Code를 터미널에서 처음 실행했을 때를 떠올려 보세요. 강력한 AI가 손끝에 있지만, 에이전트 설정, 보안 훅, 워크플로우 커맨드를 하나씩 직접 구성해야 한다는 사실에 막막했던 경험이 있으실 겁니다. oh-my-zsh가 쉘 환경을 플러그인 하나로 강화했듯, Claude Forge는 Claude Code 설정을 통째로 자동화하는 오픈소스 프레임워크입니다.

공개 24시간 만에 GitHub에서 116 stars와 34 forks를 기록한 Claude Forge가 어떤 문제를 해결하고, 왜 주목받고 있는지 살펴보겠습니다.

Claude Code 설정, 왜 프레임워크가 필요한가

비유하자면, Claude Code를 "날것" 그대로 쓰는 건 리눅스를 데스크탑 환경 없이 쓰는 것과 비슷합니다. 할 수 있지만, 매번 수작업이 반복됩니다.

Claude Code는 에이전트, 슬래시 커맨드, 훅, 룰 파일 등 강력한 확장 포인트를 제공합니다. 문제는 이 모든 것을 직접 구성해야 한다는 점이에요. 프로젝트를 새로 시작할 때마다 같은 설정 파일을 복사하고, 보안 훅을 다시 작성하고, 에이전트 프롬프트를 조정하는 반복 작업이 발생합니다.

Claude Forge는 이 반복을 없앱니다. install.sh 한 번이면 검증된 설정이 통째로 적용됩니다.

git clone --recurse-submodules https://github.com/sangrokjung/claude-forge.git
cd claude-forge && ./install.sh

Claude Forge 핵심 구성 요소 한눈에 보기

Claude Forge는 11개 전문 에이전트, 36개 슬래시 커맨드, 15개 스킬 워크플로우, 14개 자동화 훅, 8개 룰 파일, 6개 MCP 서버를 하나의 패키지로 제공하는 Claude Code 설정 프레임워크입니다.

11개 전문 에이전트: Opus와 Sonnet의 역할 분담

Claude Forge의 에이전트 설계에서 가장 눈에 띄는 점은 모델별 역할 분리입니다. 마치 병원에서 전문의(Opus)가 진단하고, 간호사(Sonnet)가 처치하는 것처럼, 각 모델의 강점에 맞게 업무를 배분합니다.

이 분리가 중요한 이유는 비용 최적화입니다. 모든 작업에 Opus를 투입하면 토큰 비용이 급격히 늘어납니다. 빌드 에러 수정이나 문서 업데이트처럼 패턴이 명확한 작업은 Sonnet이 빠르고 저렴하게 처리하고, 아키텍처 설계나 보안 리뷰처럼 깊은 추론이 필요한 작업만 Opus가 맡습니다.

36개 슬래시 커맨드와 워크플로우 체이닝

Claude Forge는 개별 커맨드를 순서대로 연결하는 체이닝 패턴을 지원합니다. 기능 하나를 구현할 때 머릿속으로 "계획 → 테스트 → 구현 → 리뷰 → 커밋"을 떠올리며 각 단계를 수동으로 실행하는 대신, 이렇게 연결할 수 있습니다.

/plan → /tdd → /code-review → /handoff-verify → /commit-push-pr

각 단계의 출력이 다음 단계의 입력으로 자연스럽게 흘러가는 구조입니다.

6층 보안 자동화 파이프라인

보안은 "나중에 하자"고 미루다가 사고가 터지는 영역입니다. Claude Forge는 코드 생성부터 커밋까지 6개 층에서 자동으로 보안을 검증합니다.

하드코딩된 API 키가 커밋에 포함되려고 하면 3층에서 자동 차단됩니다. 개발자가 실수해도 시스템이 잡아주는 구조예요.

Claude Forge 설정 철학: 룰 파일이 시스템 프롬프트를 대체하는 이유

Claude Code에서 매 세션마다 "코드 리뷰 시 보안을 체크해 줘", "TDD로 작업해 줘"라고 반복 입력하는 건 비효율적입니다. Claude Forge는 ~/.claude/rules/ 디렉토리에 8개 룰 파일을 배치하여 이 문제를 해결합니다.

룰 파일은 Claude Code가 세션 시작 시 자동으로 로드하므로, 매번 같은 지시를 반복할 필요가 없습니다. 프로젝트의 코딩 스타일, 보안 정책, Git 워크플로우가 영구적으로 적용됩니다.

~/.claude/rules/
├── coding-style.md      # 불변성, 파일 크기 제한
├── security.md          # 시크릿 환경 변수화
├── git-workflow.md      # 커밋 메시지 포맷
├── tdd.md               # RED → GREEN → IMPROVE
└── ... (8개 파일)

이 접근 방식의 장점은 팀 전체의 일관성입니다. 새 팀원이 합류해도 같은 룰 파일을 공유하면 동일한 기준으로 Claude Code가 동작합니다.

경쟁 프레임워크와 비교: Claude Forge의 포지션

Claude Code 생태계에는 이미 여러 설정 프레임워크가 존재합니다.

Claude Forge가 차별화되는 지점은 두 가지입니다. 첫째, Opus/Sonnet 모델을 역할에 따라 명시적으로 분리한 점. 둘째, 보안 자동화를 6개 층으로 체계화한 점입니다. 에이전트 수나 커맨드 수에서는 OMC에 비해 적지만, "적정 규모의 검증된 구성"이라는 접근이 Claude Forge의 설계 철학입니다.

시작하기: 5분 설치부터 첫 워크플로우까지

1단계: 설치

git clone --recurse-submodules https://github.com/sangrokjung/claude-forge.git
cd claude-forge && ./install.sh

--recurse-submodules 플래그는 MCP 서버 등 의존 모듈을 함께 가져옵니다.

2단계: 설정 확인

설치 후 ~/.claude/ 디렉토리에 에이전트, 룰, 커맨드가 배치되었는지 확인합니다. Claude Code를 실행하면 룰 파일이 자동 로드됩니다.

3단계: 첫 워크플로우 실행

새 기능을 구현한다면 체이닝 워크플로우를 시도해 보세요.

/plan "사용자 인증 기능"
→ /tdd
→ /code-review
→ /commit-push-pr

계획 수립부터 PR 생성까지 일관된 품질 기준으로 자동 진행됩니다.

마무리

Claude Forge는 Claude Code 설정의 반복 작업을 없애고, 검증된 에이전트 구성과 보안 파이프라인을 원클릭으로 적용하는 오픈소스 프레임워크입니다. Opus와 Sonnet의 역할 분리로 비용을 최적화하고, 6층 보안 자동화로 실수를 시스템이 잡아주며, 룰 파일 기반의 영구 설정으로 매 세션 반복 입력을 제거합니다.

Claude Code를 "날것"으로 쓰고 계시다면, Claude Forge로 개발 환경을 한 단계 업그레이드해 보세요. MIT 라이선스이므로 상업 프로젝트에서도 자유롭게 활용할 수 있습니다.

GitHub에서 Claude Forge 시작하기

자주 묻는 질문 (FAQ)

Q: Claude Forge와 oh-my-claudecode(OMC)는 함께 사용할 수 있나요?

독립적인 설정 프레임워크이므로, 동시에 설치하면 에이전트나 룰 파일이 충돌할 수 있습니다. 하나를 선택하거나, 필요한 부분만 수동으로 병합하는 것을 권장합니다.

Q: Claude Forge를 설치하면 기존 Claude Code 설정이 덮어씌워지나요?

install.sh는 기존 ~/.claude/ 디렉토리의 파일을 백업한 후 설치합니다. 다만, 커스텀 설정이 있다면 설치 전에 수동 백업을 권장합니다.

Q: Opus 에이전트만 사용하면 비용이 얼마나 드나요?

Opus는 Sonnet 대비 약 5배 높은 토큰 비용이 발생합니다. Claude Forge의 모델 분리 설계가 중요한 이유입니다. 빌드 에러 수정이나 리팩토링 같은 반복 작업을 Sonnet에 맡기면 전체 비용을 크게 절감할 수 있습니다.

Q: Claude Forge에 커스텀 에이전트를 추가할 수 있나요?

네, ~/.claude/agents/ 디렉토리에 마크다운 형식의 에이전트 파일을 추가하면 됩니다. Claude Forge의 기존 에이전트 파일을 참고하여 동일한 구조로 작성하세요.

참고 자료

• Claude Forge GitHub 리포지토리
• Claude Code 공식 문서 - Hooks
• oh-my-claudecode 공식 사이트
• SuperClaude Framework
• awesome-claude-code 커뮤니티 목록