어두운 공간에서 반쯤 열린 문틈으로 빛이 새어 나오고, 문턱 앞에 작은 빛 하나가 놓여 있는 모습

Blog

Codex 자동 검토(Auto-review), 승인을 에이전트에 맡길 때 확인할 기준

이정민

2026년 10월 7일, OpenAI가 Codex 문서에 Auto-review(자동 검토) 기능 안내를 공개했습니다. Auto-review는 Codex의 샌드박스 경계에서 사람이 하던 수동 승인을 별도의 검토 에이전트가 대신 맡는 기능입니다. 승인 요청이 올 때마다 사람이 확인할 때까지 작업이 멈추던 구간을 이제 검토 에이전트가 처리합니다.

에이전트에게 일을 맡기는 조직에서 승인은 가장 민감한 지점입니다. 누가, 어떤 기준으로, 어떤 기록을 남기며 허락하는지가 곧 운영 원칙이 되기 때문입니다. 이번 문서를 바탕으로 Auto-review가 어떻게 동작하는지, 도입 전에 무엇을 정해야 하는지 정리했습니다.

사람 대신 검토 에이전트가 승인을 판단합니다

Codex는 샌드박스라는 경계 안에서 작업합니다. 경계를 넘는 동작에는 승인이 필요하고, 지금까지는 사람이 그 요청을 확인했습니다. 설정에서 approvals_reviewer 값을 auto_review로 지정하면 이 흐름이 바뀝니다. Codex는 사람을 기다리며 멈추지 않고, 승인 요청을 별도의 검토 에이전트에게 보냅니다.

작업하는 에이전트와 그 작업을 허락하는 에이전트가 나뉘는 구조입니다. 사람은 매 요청에 응답하는 역할에서 벗어나고, 검토 에이전트가 내린 판단을 필요할 때 다시 살펴보는 역할을 맡게 됩니다.

대화형 승인에서만 동작합니다

Auto-review에는 전제 조건이 있습니다. 승인이 대화형으로 이루어지는 설정에서만 동작합니다. on-request 승인 정책이 대표적인 예입니다.

반대로 승인 요청 자체가 생기지 않는 설정에서는 검토할 대상이 없습니다. approval_policy를 never로 두거나, danger-full-access로 실행하거나, –yolo 옵션을 사용하면 동작이 승인 요청을 거치지 않을 수 있습니다. 이 경우 Auto-review를 켜 두었더라도 검토 에이전트가 개입할 기회가 없습니다.

조직 입장에서는 이 부분이 가장 중요합니다. 검토 에이전트를 도입했다고 안심하기 전에, 개발자들이 실제로 어떤 승인 정책으로 Codex를 실행하는지부터 확인해야 합니다.

권한을 늘리는 기능이 아닙니다

OpenAI는 Auto-review를 검토자를 바꾸는 기능이라고 설명합니다. 권한을 새로 주는 기능이 아닙니다. 원래 승인이 필요했던 동작은 여전히 승인이 필요하고, 그 판단을 누가 내리는지만 달라집니다.

이 구분은 보안 담당자와 논의할 때 유용합니다. Auto-review를 켠다고 에이전트가 할 수 있는 일의 범위가 넓어지지는 않습니다. 범위는 샌드박스와 승인 정책이 정하고, Auto-review는 그 범위를 넘으려는 요청을 누가 판단할지만 바꿉니다.

OpenAI는 Auto-review가 결정론적인 보안 보장이 아니라는 점도 분명히 밝혔습니다. 같은 요청에 늘 같은 판단이 나온다고 기대할 수 없다는 뜻입니다. 검토 에이전트는 보안 통제를 대신하는 장치가 아니라, 승인 부담을 덜어 주는 장치로 보는 편이 정확합니다.

거부가 이어지면 작업을 멈춥니다

검토 에이전트가 요청을 거부하는 경우를 위한 장치도 있습니다. 문서는 이를 회로 차단기(circuit breaker)라고 부릅니다. 한 턴 안에서 거부가 3번 연속으로 나오거나, 최근 50번의 검토 가운데 거부가 10번에 이르면 Codex가 그 턴을 중단합니다. 거부가 반복되는 상황에서 작업이 그대로 이어지지 않도록 막는 장치입니다.

거부된 동작을 사람이 되살릴 수도 있습니다. 터미널 화면(TUI)에서 /approve 명령을 입력하면 거부된 동작을 승인할 수 있습니다. Codex는 작업마다 최근 거부 기록을 최대 10건까지 보관합니다. 검토 에이전트가 판단을 맡더라도 마지막 결정은 사람이 내릴 수 있는 구조입니다.

검토 에이전트가 보는 것과 남는 기록

검토 에이전트는 주 에이전트의 숨겨진 추론을 보지 못합니다. 주 에이전트가 왜 그 동작을 하려는지 내부 사고 과정까지 확인하고 판단하는 것은 아니라는 뜻입니다. 승인 기준을 설계할 때 이 점을 감안해야 합니다.

기록은 사용자 환경에 남습니다. Auto-review 세션 기록은 기본적으로 ~/.codex/sessions 아래에 저장됩니다. 감사 대응이 필요한 조직이라면 이 기록을 어디로 모으고 얼마나 보관할지 따로 정해야 합니다. 기본 위치에만 두면 기록이 개발자마다 흩어진 채 남습니다.

도입 전에 확인할 것

첫째, 승인 정책을 먼저 정리합니다. Auto-review는 대화형 승인에서만 동작하므로, never 정책이나 danger-full-access, –yolo로 실행하는 관행이 있다면 검토 에이전트를 도입해도 효과가 없습니다. 어떤 설정을 허용할지 팀 규칙으로 정해 두는 것이 출발점입니다.

둘째, 사람이 개입할 지점을 정합니다. 회로 차단기가 턴을 멈췄을 때 누가 확인할지, /approve로 거부를 뒤집는 권한을 누구에게 줄지 미리 합의해 두어야 합니다. 거부를 뒤집은 판단도 따로 기록해 두는 것이 좋습니다.

셋째, 기록 보관 방식을 정합니다. 세션 기록의 기본 위치는 ~/.codex/sessions이고, 작업당 보관되는 거부 기록은 최대 10건입니다. 감사나 사고 분석에 필요한 만큼 기록을 모으는 절차를 마련해야 합니다.

넷째, 보안 설계는 그대로 엄격하게 유지합니다. OpenAI 스스로 결정론적인 보장이 아니라고 밝힌 만큼, 샌드박스 범위와 권한 설계를 느슨하게 할 이유가 없습니다. 민감한 작업에는 사람의 검토를 남겨 두는 편이 안전합니다.

다섯째, 교육을 함께 준비합니다. 개발자가 승인 정책과 검토자 설정의 차이를 이해하지 못하면, 검토가 켜져 있다고 믿으면서 실제로는 승인 요청을 건너뛰는 설정으로 일할 수 있습니다. 설정 하나로 검토 전체가 빠질 수 있다는 점을 팀 교육에 포함하시기를 권합니다.

자주 묻는 질문

Auto-review를 켜면 Codex가 더 많은 작업을 할 수 있게 되나요?
아닙니다. Auto-review는 이미 승인이 필요한 동작을 누가 검토하는지만 바꾸며, 권한을 새로 주지 않습니다.
어떤 설정에서 Auto-review가 동작하나요?
on-request 승인 정책처럼 승인이 대화형으로 이루어지는 설정에서만 동작합니다. approval_policy를 never로 두거나 danger-full-access, --yolo로 실행하면 승인 요청이 생기지 않아 검토를 거치지 않을 수 있습니다.
검토 에이전트가 계속 거부하면 어떻게 되나요?
한 턴에서 거부가 3번 연속되거나 최근 50번의 검토 가운데 10번이 거부되면 Codex가 그 턴을 중단합니다. 거부된 동작은 TUI에서 /approve 명령으로 사람이 승인할 수 있습니다.
검토 기록은 어디에 남나요?
Auto-review 세션 기록은 기본적으로 ~/.codex/sessions 아래에 저장됩니다. Codex는 작업마다 최근 거부 기록을 최대 10건까지 보관합니다.
Auto-review만으로 보안을 보장할 수 있나요?
아닙니다. OpenAI는 Auto-review가 결정론적인 보안 보장이 아니라고 밝혔으므로, 샌드박스와 권한 설계를 함께 관리해야 합니다.

다른 글

AI 도입 성과를 높이는 1분

참여자의 역할, 규모에 맞추어 과정을 구성합니다.
신청 후에는 담당자가 1영업일 내로 연락드릴게요.

1분 내로 문의하기