
📌한 시간마다 검토, 다음 지시는 딱 하나.
클로드 코드가 일하고, 코덱스가 매시간 결과와 근거를 뜯어본 뒤 다음 할 일 하나만 보내요. 성공하거나 멈출 조건이 될 때까지 알아서 반복해요.
코드를 짤 필요는 없어요. 설치는 명령어 몇 줄이고, 나머지는 문장으로 시켜요.
2026-10-24 기준 · 사용: Claude Code + Codex · MIT 라이선스 · claude-codex-loop 원문
| 단계 | 하는 일 | 필요한 것 |
|---|---|---|
| 1. 설치 | 코덱스 스킬 폴더에 연결 | 터미널, 명령어 4줄 |
| 2. 시작 문장 | 목표·성공 기준·멈춤 조건을 코덱스에 말하기 | 아래 복붙 문장 |
| 3. 맡기기 | 코덱스가 매시간 검토하고 다음 지시 1개를 보냄 | 컴퓨터와 앱 켜 두기 |
| 4. 확인 | 성공인지, 한도에 걸려 멈췄는지 기록 보기 | 감독 기록 폴더 |
<aside> ✅
솔직하게, 처음 세팅은 손이 좀 가요.
맥이나 리눅스, 파이썬 3.10 이상, 코덱스의 '같은 대화창 예약' 기능, 클로드 화면을 조작하는 컴퓨터 사용 기능이 있어야 해요. 대신 한 번 걸어 두면 매시간 검토는 따로 확인하지 않아도 돌아가요. 컴퓨터와 앱은 계속 켜 둬야 해요.
</aside>
저장소를 받은 뒤, 그 폴더를 claude-codex-loop라는 이름으로 코덱스 스킬 폴더에 연결해요. 클로드 쪽에는 설치할 게 없어요. 설치만으로는 아무것도 시작되지 않아요.
git clone https://github.com/ajogalekar/claude-codex-loop.git
cd claude-codex-loop
mkdir -p "$HOME/.agents/skills"
ln -s "$PWD" "$HOME/.agents/skills/claude-codex-loop"
코덱스에 처음 보내는 문장에 세 가지를 꼭 넣어요. 무엇을 이룰지(목표), 어떤 근거가 있어야 성공인지(성공 기준), 언제 멈출지(멈춤 조건). 코덱스가 이걸 그 실행의 설정으로 저장해요.
$claude-codex-loop 를 써서 [프로젝트 폴더 경로]와 내 클로드 코드 대화 "[대화 이름]"(세션 [SESSION_ID])을 이어서 맡아 줘.
한 시간마다 검토하고, 다음 지시는 자동으로 보내 줘. 작업은 이 프로젝트 폴더 안에서만 해.
목표: [정확히 이루고 싶은 것]
성공 기준: 코덱스가 결과를 이 목표와 직접 대조해서 확인했고, 막는 반론이 하나도 남지 않았을 때만 성공으로 쳐.
멈춤 조건: 다음 지시 20번, 48시간, 또는 진전이 확인되지 않은 검토 3번 연속 중 먼저 오는 것.
숫자(20번 · 48시간 · 3번)는 README 예시 값이에요. 일에 맞게 바꾸세요.
max_rounds: 새로 보낸 다음 지시 횟수max_hours: 시작한 뒤 흐른 시간max_no_progress_reviews: 진전이 확인되지 않은 검토가 연속된 횟수한도에 걸리면 '끝나지 않은 채 멈춤'으로 기록돼요. 설정은 시작할 때 고정돼서, 원래 설정 파일을 고쳐도 돌고 있는 실행에는 반영되지 않아요. 바꾸려면 새 설정으로 새로 시작하세요.