Codex Goal 사용법, 목표만 설정하면 끝까지 간다

Codex에 새로운 기능이 추가되었습니다. 바로 'Codex Goal'입니다. 사용자가 목표를 설정하면 Codex가 작업을 독립적으로 이어가고, 목표 달성 조건에 가까워질 때까지 실행을 계속하도록 설계된 방식입니다.

덕분에 AI가 요청한 작업을 끝까지 이어가지 못하고, 중간마다 다시 확인하거나 같은 맥락을 반복해서 설명해야 하는 불편함을 줄일 수 있게 되었습니다.

이 글에서는 Codex Goal의 사용법과 실무에서 유용하게 활용하는 방법을 다룹니다.

Codex Goal 핵심 요약 4가지

• Codex Goal은 목표 기반으로 작업을 이어가는 워크플로우를 갖춘 기능입니다. 사용자가 최종 목표와 완료 기준을 설정하면, Codex가 그 기준을 바탕으로 계획, 실행, 검증, 수정을 이어가도록 돕습니다.
• 반복 지시 없이 하나의 맥락 안에서 여러 작업을 처리할 수 있습니다. 코드베이스 탐색, 통제된 변경, 반복 작업 자동화, 프로덕션 품질 유지까지 하나의 흐름으로 이어갈 수 있다는 점이 핵심입니다.
• 완료 기준을 바탕으로 결과를 더 명확하게 검증할 수 있습니다.테스트 통과, 수정 범위 준수, 변경 내용 요약처럼 사용자가 정한 기준을 중심으로 작업 결과를 확인할 수 있습니다.
• 실무에서는 기능 개발, 버그 수정, 리팩토링에 특히 유용합니다. 작은 단위의 기능 구현부터 원인 파악이 필요한 버그 수정, 범위를 제한한 리팩토링까지 목표와 기준을 정해 활용할 수 있습니다.

Codex Goal이란?

Codex Goal(/goal)은 OpenAI Codex CLI 0.128.0 버전에서 도입된 목표 기반 실행 흐름 기능입니다. 

사용자가 최종 목표와 완료 기준을 설정하면, Codex가 그 목표를 기준으로 작업을 계획하고 실행하며, 필요한 경우 검증과 수정을 이어갑니다. 

단순한 코드 생성이 아니라 목표가 달성될 때까지 AI가 작업을 스스로 이어가는 방식입니다. 

반복 지시 없이 작업 흐름을 이어갑니다 

기존 AI CLI는 사용자의 단일 명령에 반응하는 방식에 가까워 실제 프로젝트를 하나의 맥락에서 처리하기에는 어려움이 있었습니다. 

Codex Goal은 이런 문제를 극복하기 위해 출시되었습니다. 사용자가 매번 다음 지시를 하지 않아도, 처음 설정한 목표를 중심으로 작업을 이어갑니다. 

코드베이스 탐색, 통제된 변경, 반복 작업의 자동화, 프로덕션 품질 유지까지 하나의 흐름 안에서 처리할 수 있습니다.

완료 기준을 바탕으로 더 명확하게 검증할 수 있습니다

Codex Goal은 사용자가 코딩 내역을 직접 검토해야 하는 불편함을 줄이기 위해, 사용자가 설정한 기준에 맞춰 작업 결과를 점검하는 흐름을 만듭니다. 

덕분에 사용자는 코딩 작업이 어디까지 진행됐는지, 무엇이 완료됐는지, 어떤 부분을 추가로 확인해야 하는지 파악할 수 있고, 설정한 목표와 완료 기준을 바탕으로 여러 작업을 같은 맥락 안에서 이어갈 수 있습니다. 

Codex Goal 사용법

Codex CLI 실행하기

Codex에 Goal 기능을 추가하는 방법을 알려드리겠습니다. 먼저 Codex를 실행합니다. Codex 설치 및 실행 방법 확인이 필요한 분은 아래 링크를 참고하시면 됩니다.

▶ Codex 설치 사용방법 보러가기

Codex CLI를 /goal 지원 버전으로 업데이트하기 

Codex Goal은 Codex CLI 0.128.0 업데이트에 포함된 기능입니다. 따라서 기존에 Codex CLI를 설치해둔 상태라면 먼저 버전을 확인하고, 0.128.0 이상 버전이 아니라면 업데이트합니다. 

Codex 0.128.0 버전으로 업데이트 한 뒤 /goal을 입력해 기능이 동작하는지 확인합니다. 동작하지 않는 경우에는 config.toml에서 Goals 기능을 활성화해야합니다.

 config.toml에서 Goals 기능을 활성화하는 방법

config.toml 파일은 사용자 경로의 Codex 폴더 안에 있습니다. 코드 에디터로 파일을 열어 수정합니다. 

코드 하단에 아래 내용을 추가하고 저장한 뒤 파일을 닫고 Codex를 다시 실행합니다. 

파일 안에 이미 [features] 섹션이 있다면 새로 만들지 않고 해당 섹션 안에 goals = true만 추가합니다. 

Codex에 /goal 기능이 추가된 것을 볼 수 있습니다.

* /goal 사용 시 "unstable feature" 경고가 계속 표시되는 경우

/goal 사용 시 "unstable feature" 경고가 계속 표시된다면 [features] 섹션 바깥, 파일 상단 루트 레벨에 아래 코드를 추가하면 경고를 숨길 수 있습니다. 

Codex Goal 기능 테스트: 잘못된 함수 찾아서 수정하기 

/goal의 기능을 테스트하기 위해 잘못 작성된 계산기 함수가 테스트를 통과하도록 Codex Goal이 스스로 수정하고 검증하는지 확인하는 테스트를 진행했습니다. 

add 함수와 multiply 함수가 잘못 구현되어 테스트를 통과하지 못하는 상태입니다.

Codex Goal에 목표와 완료 기준을 설정한 뒤 실행하자, 38초 만에 작업이 완료됐습니다.

Codex는 calculator.js와 calculator.test.js를 모두 읽은 뒤, 테스트 파일은 수정하지 않고 구현 파일인 calculator.js만 수정했습니다. 

함수를 올바르게 수정한 뒤 동일한 명령으로 테스트를 재실행 해 1개 스위트, 2개 테스트 모두 통과한 것을 확인했습니다.

사용자가 중간에 개입하지 않아도 목표 설정 단계에서 명시한 완료 기준을 기준으로 작업을 검증하고  마무리했습니다.

Codex Goal, 이런 작업에 유용합니다.

Codex Goal은 모든 작업에 필요한 기능은 아닙니다. 목표 설정과 완료 기준까지 명시해야 하는 만큼, 단순한 작업에 쓰면 오히려 준비 과정이 더 번거롭습니다. Codex Goal을 유용하게 활용할 수 있는 작업을 3가지로 정리해 드립니다.

기능 개발: 작은 단위의 제품 기능을 끝까지 구현할 때

대시보드에 기간 필터를 추가하는 작업은 단순한 UI 수정처럼 보이지만, 실제로는 날짜 선택 UI, API 파라미터, 상태 관리, 빈 데이터 처리, 모바일 화면 확인까지 이어질 수 있습니다. 

Codex Goal을 사용하면 이런 흐름을 하나의 목표로 묶어 처리할 수 있습니다.

버그 수정: 원인 파악부터 검증까지 이어갈 때

버그 수정은 단순히 코드를 바꾸는 문제가 아니라, 왜 발생했는지 확인하고 재발 가능성을 줄이는 과정입니다. 

Codex Goal을 활용하면 의심되는 파일 하나만 고치는 것이 아니라, 관련 흐름을 따라가며 원인 파악부터 수정, 검증까지 이어갈 수 있습니다.

리팩토링: 기존 구조를 유지하면서 품질을 개선할 때

리팩토링은 AI에게 맡기기 조심스러운 작업입니다. 너무 많은 파일을 바꾸거나, 기존 코드 스타일을 무시하거나, 동작은 같아야 하는데 결과가 미묘하게 바뀔 수 있기 때문입니다.

Codex Goal을 사용하면 범위를 명확히 제한한 상태에서 리팩토링을 진행할 수 있습니다. "무엇은 바꾸고, 무엇은 바꾸지 말아야 하는지"를 목표에 함께 명시하면 Codex가 기존 구조를 유지하면서 중복 제거, 컴포넌트 분리 같은 품질 개선 작업을 이어갑니다. 

완료 기준으로 기존 테스트 통과와 변경 전후 동작 동일 여부를 설정해두면, 리팩토링이 끝난 뒤 결과를 명확하게 검증할 수 있습니다.

작업 퀄리티를 높이는 

Codex /Goal 활용 노하우 3가지

목표를 한 문장으로만 쓰지 않습니다

Codex Goal에서 가장 피해야 할 요청은 너무 짧은 목표입니다.

이렇게 쓰면 Codex가 무엇을 우선해야 하는지 판단하기 어렵습니다. 관리자 페이지가 사용자 관리인지, 매출 대시보드인지, 권한 관리인지, 어떤 기술 스택을 써야 하는지 불분명하기 때문입니다.

더 좋은 방식은 목표, 범위, 완료 기준을 함께 적는 것입니다.

이렇게 작성하면 Codex가 해야 할 일과 하지 말아야 할 일을 함께 이해할 수 있습니다.

완료 기준을 반드시 넣습니다

Codex Goal의 핵심은 ‘목표’입니다. 목표를 명시할 때는 완료 기준이 있어야 제대로 작동합니다. 예를 들어 버그 수정 목표라면 이렇게 작성할 수 있습니다.

"잘 고쳐줘”가 아니라 “어떤 상태가 되면 고친 것으로 볼지”를 AI에게 알려줄 수 있어 사용자의 요청에 맞는 결과를 만들 확률이 높아집니다.

실행 중에는 개입보다 검토에 집중합니다

Codex Goal을 사용하면 AI 코딩에서 사용자의 역할이 바뀝니다. 기존에는 사용자가 계속 다음 지시를 내려야 했다면, Goal 방식에서는 중간중간 방향이 맞는지 검토하는 역할이 더 중요해집니다.

Codex가 불필요한 파일까지 수정하고 있다면 /goal pause로 작업을 일시정지하고 범위를 다시 좁힌 뒤 /goal resume으로 재개하면 됩니다. 반대로 진행 방향이 맞다면 계속 진행하도록 두고, 마지막 diff와 테스트 결과를 중심으로 검토하면 됩니다.

개발 생산성을 높이는데 도움이 되는 AI 콘텐츠 

GLM-5.1, 개발 도구에 연동해 AI 에이전트로 활용하기

클로드 코드 에이전트 팀 사용법, 역할별 AI 팀으로 개발 자동화하기

Claude Code 사용법: 클로드 코드를 사용하지 않았던 게 가장 큰 실수였습니다