Claude Forge v4.0, 코드를 검토하는 두 번째 에이전트를 세우다
퀀텀점프클럽 정상록3 min read1 viewsClaude Forge v4.0, Claude Code가 자기 코드를 의심하게 만드는 방법 (2026)
에이전트 16개, 커맨드 35개, 스킬 32개를 묶은 오픈소스 클로드 코드 하네스입니다. 코드를 쓴 에이전트와 검토하는 에이전트를 분리해 실제 결함을 잡아내죠.
Claude Forge 구성 한눈에 보기: 에이전트 16개, 커맨드 35개, 스킬 32개, 안전 훅 21개
이미지: Claude Forge 공식 소개 이미지 · 직접 제작
클로드 코드에 왜 하네스가 필요한가
클로드 코드는 그 자체로 강력하지만, 매번 같은 규칙을 다시 설명하고 같은 실수를 반복 지적하는 일이 생깁니다. 에이전트 구성과 검증 방식이 프로젝트마다 제각각이면 결국 사람이 다시 확인하는 수밖에 없죠.
Claude Forge는 이 반복을 하나의 패키지로 정리한 오픈소스 프로젝트입니다. 흔히 "클로드 코드의 oh-my-zsh"라고 부르곤 해요. 셸을 켤 때마다 테마와 플러그인을 새로 설정하지 않듯, 매번 규칙을 다시 세팅할 필요가 없다는 뜻이죠.
v4.0의 핵심, 적대적 검증 루프
이번 버전의 중심은 maker와 checker를 분리하는 적대적 검증 루프입니다. 코드를 쓴 에이전트가 자기 작업을 스스로 검토하면 자기 논리 안에서만 맞는지 확인하게 되죠. 그래서 검토를 맡는 에이전트는 완전히 새로운 컨텍스트에서 시작합니다. 작성자가 무슨 생각으로 그렇게 짰는지는 모른 채, 목표와 스펙과 변경 내역(diff)만 받아서 보는 식이에요.
이 검토자가 승인(APPROVE)하기 전까지 루프는 닫히지 않습니다. 검토 에이전트는 스펙과 실제 코드를 기계적으로 대조하죠.
실제로 잡아낸 결함 세 가지
이 구조를 만드는 과정에서 관리자 본인의 풀리퀘스트(PR)에서 결함 세 건이 나왔습니다.
먼저 CI 정합성 가드 하나가 자기 자신의 회귀 테스트를 통과시키고 있었습니다(PR #58). 그 가드를 고치는 수정도 한 단계 아래에 똑같은 구멍을 그대로 갖고 있었고요. 세 번째는 1년 전 릴리스로 조용히 고정돼 있던 의존성 상한선이었습니다(PR #61).
셋 다 코드는 동작했고 테스트도 통과했습니다. 사람이 리뷰했다면 그대로 머지했을 거예요. 적대적 검증 루프가 잡아낸 건 "돌아가는가"가 아니라 "왜 이 조건이 여기 있는가"였습니다.
설치는 두 가지 방법
가장 쉬운 방법은 터미널 없이 클로드 코드 세션 안에서 바로 실행하는 거예요.
/plugin marketplace add sangrokjung/claude-forge
/plugin install claude-forge
macOS·리눅스 전체 구성은 터미널 한 줄로 끝납니다.
curl -fsSL https://raw.githubusercontent.com/sangrokjung/claude-forge/main/install.sh | bash
윈도우는 아직 한 줄 설치가 없어요. 저장소를 내려받아 PowerShell을 관리자 권한으로 열고 install.ps1을 실행해야 합니다. 어느 경로든 설치 뒤에는 클로드 코드를 재시작해야 규칙과 훅이 적용되죠. 클로드 코드 2.1.110 이상이 필요합니다.
솔직하게 말하는 한계
Claude Forge는 새 모델이 아니라 설정과 프롬프트로 이루어진 레이어입니다. 그래서 동작이 실제로 바뀌는 변경마다 토큰이 대략 두 배 들어가요. 검토자를 따로 세우는 만큼 비용이 붙으니, 사소한 수정보다는 실제 로직이 바뀌는 지점에 쓰는 게 맞습니다.
MIT 라이선스로 100% 무료이며 가입이나 카드 등록도 필요 없습니다. 입문자용 웹 가이드는 13개 언어를 지원하고 채팅 형태로 온보딩을 안내하죠.
자주 묻는 질문
설치에 비용이 드나요?
아니요. MIT 라이선스로 완전히 무료이고, 가입이나 결제 정보 등록 없이 바로 쓸 수 있습니다.
코드를 몰라도 설치할 수 있나요?
클로드 코드 세션 안에서 두 줄만 입력하면 되는 경로가 있습니다. 웹 가이드도 채팅형 온보딩이라 터미널 명령어가 낯설어도 따라갈 수 있어요.
기존 프로젝트에 적용하면 규칙이 충돌하지 않나요?
에이전트 16개와 규칙 14개는 독립적으로 동작하도록 설계돼 있어 기존 설정 위에 얹는 방식입니다. 설치 뒤 재시작이 필요하니 적용 전 현재 설정을 확인해두면 좋습니다.
마무리
이 글에서 다룬 적대적 검증 루프는 규칙 한 줄이 아니라 구조의 문제였어요. 지금 프로젝트에 Claude Code를 쓰고 있다면, 설치 명령 한 줄로 오늘부터 검토자를 따로 세워볼 수 있습니다. 사용법과 최신 소식은 Claude Forge 공식 가이드에서 확인해보세요.
