clauder-welcome-sleep.gif

📌한 시간마다 검토, 다음 지시는 딱 하나.

클로드 코드가 일하고, 코덱스가 매시간 결과와 근거를 뜯어본 뒤 다음 할 일 하나만 보내요. 성공하거나 멈출 조건이 될 때까지 알아서 반복해요.

코드를 짤 필요는 없어요. 설치는 명령어 몇 줄이고, 나머지는 문장으로 시켜요.

2026-10-24 기준 · 사용: Claude Code + Codex · MIT 라이선스 · claude-codex-loop 원문

🗺️ 한눈에 보기

단계 하는 일 필요한 것
1. 설치 코덱스 스킬 폴더에 연결 터미널, 명령어 4줄
2. 시작 문장 목표·성공 기준·멈춤 조건을 코덱스에 말하기 아래 복붙 문장
3. 맡기기 코덱스가 매시간 검토하고 다음 지시 1개를 보냄 컴퓨터와 앱 켜 두기
4. 확인 성공인지, 한도에 걸려 멈췄는지 기록 보기 감독 기록 폴더

<aside> ✅

솔직하게, 처음 세팅은 손이 좀 가요.

맥이나 리눅스, 파이썬 3.10 이상, 코덱스의 '같은 대화창 예약' 기능, 클로드 화면을 조작하는 컴퓨터 사용 기능이 있어야 해요. 대신 한 번 걸어 두면 매시간 검토는 따로 확인하지 않아도 돌아가요. 컴퓨터와 앱은 계속 켜 둬야 해요.

</aside>

🔧 1. 설치: 코덱스 스킬 폴더에 연결

저장소를 받은 뒤, 그 폴더를 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"

✍️ 2. 시작 문장: 목표·성공 기준·멈춤 조건을 한 번에

코덱스에 처음 보내는 문장에 세 가지를 꼭 넣어요. 무엇을 이룰지(목표), 어떤 근거가 있어야 성공인지(성공 기준), 언제 멈출지(멈춤 조건). 코덱스가 이걸 그 실행의 설정으로 저장해요.

$claude-codex-loop 를 써서 [프로젝트 폴더 경로]와 내 클로드 코드 대화 "[대화 이름]"(세션 [SESSION_ID])을 이어서 맡아 줘.
한 시간마다 검토하고, 다음 지시는 자동으로 보내 줘. 작업은 이 프로젝트 폴더 안에서만 해.

목표: [정확히 이루고 싶은 것]
성공 기준: 코덱스가 결과를 이 목표와 직접 대조해서 확인했고, 막는 반론이 하나도 남지 않았을 때만 성공으로 쳐.

멈춤 조건: 다음 지시 20번, 48시간, 또는 진전이 확인되지 않은 검토 3번 연속 중 먼저 오는 것.

숫자(20번 · 48시간 · 3번)는 README 예시 값이에요. 일에 맞게 바꾸세요.

🛑 3. 멈춤 조건: 한도에 걸린 건 성공이 아니에요

한도에 걸리면 '끝나지 않은 채 멈춤'으로 기록돼요. 설정은 시작할 때 고정돼서, 원래 설정 파일을 고쳐도 돌고 있는 실행에는 반영되지 않아요. 바꾸려면 새 설정으로 새로 시작하세요.

🧭 엉뚱한 데로 새지 않게 하는 장치