Codex CLI 0.128.0의 /goal 명령과 Ralph Loop 기반 자율 에이전트
목차
개요
Codex CLI 0.128.0 버전에서 /goal 기능이 새롭게 추가되었다. 이 기능은 에이전트가 정해진 목표를 달성할 때까지 자동으로 실행을 반복하는 골 기반 자율 루프 메커니즘이다. 에이전트는 스스로 목표 달성 여부를 평가하면서 멈추지 않고 작업을 이어간다. 이 기능은 Codex CLI 팀의 공동 작업자이자 OpenAI 멘토인 Eric Traut(Pyright 개발자로 알려진 인물)가 구축했다고 소개되었다.
/goal 명령의 동작 방식
/goal 명령은 단발성 응답 방식이 아니라 여러 턴에 걸쳐 목표를 살아있는 상태로 유지한다. 에이전트는 매 턴마다 목표 달성 여부를 자체 평가하고, 미달성 상태라면 다음 턴에서 다시 시도한다. 이 루프는 목표가 완료되거나 토큰 예산이 소진될 때까지 지속된다.
Ralph Loop 개념
Ralph Loop는 에이전트가 단일 턴에서 작업을 종료하지 않고, 같은 목표를 향해 반복적으로 작업을 이어가는 구조를 의미한다. 일반적인 채팅 응답은 사용자의 한 번의 입력에 한 번의 응답을 돌려주지만, Ralph Loop를 따르는 에이전트는 목표가 충족될 때까지 자기 평가와 재시도를 반복한다. 이 방식은 단순한 chain-of-thought를 넘어, 매 턴 종료 시점에 “계속 진행할지”를 자체 판단하는 메타 루프를 갖춘다는 점이 핵심이다.
내부 프롬프트 템플릿 구조
Codex CLI의 /goal 기능은 두 개의 프롬프트 템플릿을 턴 종료 시 자동으로 주입한다.
| 템플릿 | 역할 |
|---|---|
| goals/continuation.md | 목표 추구를 계속할지 평가 |
| goals/budget_limit.md | 토큰 한도 도달 시의 동작 처리 |
continuation.md는 매 턴 종료 시 모델이 스스로 목표 진행 상황을 점검하도록 지시하는 메타 프롬프트의 역할을 한다. budget_limit.md는 토큰 예산이 소진된 상황에서 에이전트가 안전하게 작업을 마무리하거나 사용자에게 보고하도록 유도한다.
활성화 방법
0.128.0 버전을 사용하고 있지만 /goal 명령이 보이지 않는다면 수동 설정이 필요하다. config.toml 파일에 다음 설정을 추가하면 된다.
1
2
[features]
goals = true
데스크톱 버전은 아직 개발 중인 상태이며, Codex App을 사용할 경우 사용자가 요청하면 자동 구성도 가능하다고 안내되었다.
커뮤니티 반응
/goal 기능에 대한 사용자들의 실용적 가치 평가가 빠르게 나오고 있다. 한 사용자(@nodelay)는 자동 QA 테스트 케이스 검증 시나리오에서 특히 유용하다고 평가했다. 또 다른 사용자(@treestae)는 Codex App에서 사용자가 요청만 하면 자동으로 이 기능을 구성해 준다고 언급했다. QA 자동화처럼 “검증 → 실패 시 수정 → 재검증”의 루프가 명확한 작업에서, 자기 평가형 자율 루프가 사람의 개입 없이 끝까지 작업을 끌고 가는 것이 가장 큰 장점으로 꼽힌다.
의미와 시사점
/goal 기능은 코딩 에이전트의 패러다임이 “한 번의 입력 - 한 번의 응답”에서 “목표 달성까지 자율 반복”으로 이동하고 있음을 보여준다. 지금까지 자율 루프는 사용자가 직접 외부 스크립트로 구현하거나, 별도의 에이전트 프레임워크에서 다뤄야 했다. Codex CLI가 이를 일급 명령으로 통합했다는 점은, 자율 에이전트 패턴이 점점 표준 도구의 기본 기능으로 편입되고 있다는 신호로 읽힌다.
토큰 예산 관리가 별도의 템플릿으로 분리되어 있다는 점도 주목할 만하다. 무한 루프나 비용 폭증을 방지하는 안전장치가 처음부터 구조에 내장되어 있다는 의미이며, 자율 에이전트의 실전 운용에서 핵심이 되는 가드레일이 명령 단위에서 처리된다는 점이 실무적으로 중요하다.
결론
Codex CLI 0.128.0의 /goal 명령은 Ralph Loop 개념을 기반으로 에이전트가 목표 달성까지 자율적으로 반복 실행하도록 설계된 기능이다. continuation.md와 budget_limit.md 두 개의 메타 프롬프트가 매 턴 종료 시 자동 주입되어 자기 평가와 예산 관리를 동시에 수행한다. 설정은 config.toml의 goals = true 한 줄로 활성화할 수 있으며, QA 자동화처럼 검증 루프가 명확한 작업에서 즉각적인 효용이 보고되고 있다.