소개

/goal을 사용하면 Codex가 한 번의 응답으로 작업을 끝내지 않고 여러 턴에 걸쳐 하나의 목표를 향해 계속 작업합니다. 달성할 목표가 명확하고 진행 상황을 반복해서 검증할 수 있으며, 단계마다 지시하지 않아도 Codex가 스스로 진행할 수 있는 작업에 적합합니다. /goal을 사용하면 Codex가 추가 입력 없이 몇 시간 동안 독립적으로 작업할 수 있습니다.

/goal <objective>로 목표를 설정하고 /goal로 현재 목표를 확인하세요. 실행을 제어하려면 /goal pause, /goal resume 또는 /goal clear를 사용하세요.

/goal이 슬래시 명령어 목록에 보이지 않으면 features.goals 설정을 config.toml에서 다음과 같이 활성화하세요.

[features]
goals = true

CLI에서 codex features enable goals를 직접 실행하거나 Codex에 실행을 요청해도 됩니다.

목표에 맞는 작업 고르기

좋은 목표는 프롬프트 하나로 끝내기에는 크지만 범위가 정해져 있습니다. Codex가 무엇을 달성해야 하는지, 무엇을 변경하면 안 되는지, 진행 상황을 어떻게 검증할지, 언제 멈출지 명확히 정하세요.

다음과 같은 작업에 적합합니다.

• 목표 기술 스택과 제약 조건이 명확하고 기존 코드와 동일하게 동작하는지 확인할 방법이 있는 코드 마이그레이션
• Codex가 각 단계를 마칠 때마다 테스트를 실행할 수 있는 대규모 리팩터링
• Codex가 작동하는 결과물을 계속 개선할 수 있는 실험, 게임 또는 프로토타입 개발

서로 관련 없는 작업을 하나의 목표로 묶지 마세요.

작업과 검증을 반복하도록 설정하기

작업을 시작하기 전에 Codex가 무엇을 ‘완료’로 판단해야 하는지 명확히 정하세요. 마이그레이션이라면 새 코드 경로가 계약 테스트를 통과하고 필요할 때 기존 경로로 롤백할 수 있어야 완료로 볼 수 있습니다. 게임이나 프로토타입이라면 앱이 빌드되고 실행되며, 제공한 참고 자료와 일치하거나 예상대로 동작하는 것을 완료 기준으로 삼을 수 있습니다.

Codex가 독립적으로 작업하도록 하기

Codex가 목표를 향해 작업하는 동안에는 작업이 제대로 진행되는지 판단할 수 있도록 간단한 진행 보고를 요청하세요. 보고에는 현재 단계, 검증한 내용, 남은 작업, 진행을 가로막는 문제가 있는지가 드러나야 합니다. 상태 보고가 모호해지면 일회성 지시를 덧붙이기보다 목표를 더 구체화하세요. 다음으로 확인해야 할 단계와 그 단계의 완료 여부를 검증할 명령어, 작업을 일시 중지해야 할 조건을 정확히 알려 주세요.

목표를 설정하면 중간에 확인하지 않아도 Codex가 여러 시간 동안 독립적으로 작업할 수 있습니다. Codex는 종료 조건을 충족했다고 확신하면 작업을 멈춥니다. 따라서 /goal은 계속 지켜볼 필요가 없는 백그라운드 작업으로 생각하면 됩니다.

목표 예시

마이그레이션

게임을 새 기술 스택으로 옮기거나 모바일 앱을 새 플랫폼으로 이전하거나 코드베이스를 새 프레임워크로 전환할 때 /goal로 Codex에 마이그레이션을 맡길 수 있습니다.

프로토타입 만들기

앱을 처음부터 만들거나 새 게임이나 기능을 개발할 때 /goal을 사용하면 Codex가 완성도 높은 첫 버전을 구현할 수 있습니다. 만들고 싶은 것을 PLAN.md 파일에 구체적으로 설명하면 Codex가 그 계획에 따라 첫 버전을 만들 수 있습니다.

프롬프트 최적화

평가 스위트가 있다면 /goal로 평가 결과에 맞춰 프롬프트를 최적화할 수 있습니다. Codex는 실패 사례를 살펴보고 프롬프트를 수정한 다음 평가를 다시 실행합니다. 점수가 오르거나 지정한 종료 조건을 충족할 때까지 이 과정을 반복할 수 있습니다.