Codex 샌드박스와 승인 모드 이해하기: 자동 실행을 어디까지 허용할까

왜 실행 권한부터 정해야 할까

Codex 같은 터미널형 코딩 에이전트는 단순히 코드를 제안하는 도구가 아니라, 파일을 읽고 명령을 실행하고 때로는 코드를 직접 고칩니다. 그래서 시작할 때 중요한 질문은 “무엇을 시킬까”보다 “어디까지 허용할까”입니다.

1인 개발자는 리뷰어도, 운영자도, 장애 대응 담당자도 결국 자기 자신입니다. 자동화 속도를 높이면 반복 작업은 줄어들지만, 잘못된 명령이 .env, 마이그레이션, 배포 설정, 생성 파일을 건드릴 위험도 같이 커집니다. 권한 모드는 생산성 버튼이 아니라 작업의 위험도를 조절하는 안전장치로 보는 편이 좋습니다.

세 가지 권한 감각: 읽기, 쓰기, 실행

실무에서는 모드 이름을 외우기보다 권한의 성격을 나눠 생각하면 판단이 쉬워집니다.

읽기 전용은 느려 보이지만, 낯선 저장소를 처음 파악할 때는 오히려 효율적입니다. 변경 없이 구조를 이해하고, 어떤 파일이 핵심인지 좁힌 뒤 쓰기 권한을 여는 방식이 사고를 줄입니다.

모드 선택은 작업 단위로 바꾼다

한 프로젝트에 하나의 권한 정책을 고정할 필요는 없습니다. 작업 단위로 바꾸는 것이 현실적입니다.

버그 원인만 찾을 때는 읽기 전용이면 충분한 경우가 많습니다. “왜 로그인 후 리다이렉트가 깨지는지 봐줘” 같은 요청은 파일 읽기와 검색만으로도 상당 부분 좁힐 수 있습니다.

반대로 “이 폼 검증을 추가하고 테스트까지 돌려줘”라면 작업공간 쓰기가 맞습니다. 이때도 범위는 저장소 내부로 제한하고, 패키지 설치나 DB 마이그레이션처럼 외부 상태를 바꾸는 명령은 별도 승인 흐름으로 두는 편이 안전합니다.

전체 자동 실행에 가까운 설정은 반복적이고 되돌리기 쉬운 작업에만 제한적으로 쓰는 것이 좋습니다. 예를 들어 포맷팅, 타입 체크, 테스트처럼 결과가 명확하고 Git diff로 검증 가능한 작업입니다. 반면 프로덕션 배포, 데이터 삭제, 결제 설정 변경처럼 되돌리기 어려운 작업은 자동 승인 대상에서 빼야 합니다.

1인 개발자를 위한 승인 기준

승인이 필요한지 헷갈릴 때는 아래 네 가지 질문을 통과시키면 됩니다.

• 이 명령이 프로젝트 밖 파일을 건드릴 수 있는가?
• 실패했을 때 Git으로 쉽게 되돌릴 수 있는가?
• 실제 사용자 데이터나 결제, 인증, 배포 상태에 영향을 주는가?
• 내가 결과를 확인하기 전에 다음 단계가 자동으로 이어져도 괜찮은가?

하나라도 불안하면 승인 모드를 보수적으로 두는 편이 낫습니다. 속도가 조금 느려져도 맥락을 잃지 않고, 중요한 결정 지점에서 손을 떼지 않을 수 있습니다.

안전하게 자동화를 키우는 순서

처음부터 넓은 권한을 주기보다 작은 루틴부터 자동화하는 것이 좋습니다.

1. 먼저 읽기 전용으로 코드 구조와 변경 후보를 설명하게 합니다.
2. 수정 범위를 파일 몇 개로 좁힌 뒤 작업공간 쓰기를 허용합니다.
3. 테스트, 린트, 타입 체크처럼 검증 명령을 자동 실행하게 합니다.
4. 패키지 설치, 마이그레이션, 배포는 별도 승인으로 남깁니다.

이 흐름을 반복하면 Codex가 할 일과 사람이 판단할 일을 분리할 수 있습니다. 에이전트는 탐색, 수정, 검증을 빠르게 처리하고, 개발자는 제품 방향, 데이터 영향, 배포 타이밍 같은 결정을 잡습니다.

실수 비용이 큰 파일은 특별 취급한다

다음 파일들은 자동 수정 대상에서 한 번 더 확인하는 습관을 들이면 좋습니다.

• .env, .env.production 같은 비밀값 파일
• schema, migration, seed 관련 파일
• vercel.json, docker-compose.yml, CI 설정
• 인증, 결제, 권한 체크 코드
• 대량 삭제나 이름 변경이 포함된 스크립트

이 파일들은 작은 변경도 운영에 영향을 줄 수 있습니다. Codex에게 “수정 전 diff 계획을 먼저 보여줘”, “마이그레이션은 생성까지만 하고 실행은 대기해”처럼 지시하면 자동화의 이점은 유지하면서 사고 가능성을 낮출 수 있습니다.

결론: 빠른 모드보다 맞는 모드

좋은 권한 설정은 가장 강한 자동화가 아니라, 지금 작업의 실패 비용에 맞는 자동화입니다. 읽기 전용으로 파악하고, 작업공간 쓰기로 구현하고, 위험한 실행은 승인 지점으로 남겨두면 혼자서도 꽤 넓은 범위의 개발을 안정적으로 밀어갈 수 있습니다.

Codex를 믿는다는 것은 모든 권한을 넘긴다는 뜻이 아닙니다. 반복 가능한 일은 맡기고, 되돌리기 어려운 결정은 직접 잡는 것. 그 균형이 1인 개발자에게 가장 실용적인 자동 실행 전략입니다.