가이드Hill Climb중급약 10분7단계
코딩 에이전트의 "다 했어요"를 점수로 증명시키는 Hill Climb 설치·사용법
코딩 에이전트가 "다 했다"고 말하는 것을 점수로 확인하고 싶은 개발자를 위한 중급 가이드입니다. 설치부터 진행 상황 확인까지 따라 합니다.
시작하기 전에
- Claude Code 또는 Codex (SKILL.md 스킬을 읽는 다른 에이전트도 가능)
- Python 3.9 이상과 git. 패키지, 서버, 계정은 필요 없습니다.
- 테스트 실행기, 벤치마크, 번들 크기처럼 명령어로 측정할 수 있는 목표
Claude Code에서 먼저 마켓플레이스를 추가한 뒤 플러그인을 설치합니다. 플러그인으로 설치하면 명령어는 /hill-climb:hill-climb입니다.
마켓플레이스 추가 /plugin marketplace add Bil0000/Hill-Climb두 번째 명령어를 실행해 방금 추가한 마켓플레이스에서 플러그인을 설치하세요.
플러그인 설치 /plugin install hill-climb@hill-climb플러그인을 설치했다면 이 단계는 건너뛰세요. 저장소를 clone한 뒤 스킬 폴더를 사용하는 에이전트의 skills 디렉터리로 복사합니다. 원문에는 Claude Code용(~/.claude/skills)과 Codex용(~/.codex/skills) cp 명령이 하나씩 있습니다.
저장소 clone git clone https://github.com/Bil0000/Hill-Climb.git방법 B를 쓸 때만 실행하세요. Codex는 원문에서 같은 복사 명령의 대상만 ~/.codex/skills로 바꿔 사용합니다.
스킬 복사 (Claude Code) mkdir -p ~/.claude/skills && cp -R Hill-Climb/skills/hill-climb ~/.claude/skills/에이전트에 목표를 알려 주세요. 에이전트가 목표를 점수로 매기는 명령어(check)를 만들고 점수를 올려 갑니다. Codex에서는 프롬프트에 스킬 이름을 적으세요. README의 다른 예시는 "/hill-climb fix every finding from the billing audit, backend and frontend"와 "/hill-climb keep going until every test passes"입니다.
목표 예시 /hill-climb make the test suite 2x faster큰 목표라면 에이전트가 한 화면짜리 계획("card")을 먼저 보여 주고 go라는 답을 기다립니다. 작은 목표는 바로 시작합니다. 점수가 나아진 단계는 커밋하고 나머지는 모두 되돌리며, 잠긴 check를 고치는 단계는 거부됩니다.
디스크에 남은 로그가 기준입니다. status 명령은 점수, 이력, 메모를 보여 주므로 세션이 압축되거나 중단됐을 때 유용합니다. 마지막 단계의 check 전체 출력은 last.txt에 있습니다.
상태 보기 climb.py status이렇게 되면 성공: 작업이 끝나면 BAR REACHED: 0 meets 0.처럼 BAR REACHED가 출력됩니다.
주의할 점
- 점수가 나빠지거나 같거나 guard(기존 테스트, 타입 검사, lint)를 통과하지 못한 단계는 초기화됩니다. 일부 아이디어가 취소되는 것은 설계된 동작입니다.
- 잠긴 파일(테스트, 벤치마크, fixture)은 작업 중 바꿀 수 없습니다. 건드린 단계는 "Locked files changed"로 거부됩니다.
- 값이 흔들리는 벤치마크는 운 좋게 이긴 것처럼 보일 수 있습니다. README는 --runs 3 --paired --min-gain 3%를 권합니다.
- 개선 없는 단계가 5번 이어지면 PLATEAU를 알리고 막힌 원인을 점검하도록 강제합니다.
자주 묻는 질문
- Hill Climb을 쓰려면 무엇을 설치해야 하나요?
- Python 3.9 이상과 git이면 됩니다. 패키지, 서버, 계정은 필요 없습니다.
- 어떤 목표에 쓸 수 있나요?
- 명령어로 숫자로 바꿀 수 있는 목표라면 됩니다. 실패하는 테스트, 밀리초나 작업 횟수, 바이트 크기, 실제 도구와 출력 일치, 직접 만든 기준표로 모델 심사단이 매기는 점수 등이 예입니다.
- 변경이 도움이 되면 어떻게 되나요?
- 아이디어를 커밋 메시지로 단 커밋이 승리 하나당 하나씩, 작업이 건드린 모든 저장소에 남습니다. 브랜치에는 검증된 단계만 쌓입니다.
- 저장소나 테스트 실행기가 여러 개여도 쓸 수 있나요?
- 가능합니다. README에 climb.py init과 여러 --check 명령, --repo, --guard, --lock 옵션 예시가 있고, pytest, vitest, jest, rspec, unittest, node, cargo, go 패턴은 references/checks.md에 안내되어 있습니다.
출처
바탕이 된 소식
- Hill Climb (11월 2일)