Codex작업 준비와 권한

Git 체크포인트와 깨끗한 작업 트리

Codex 작업 전후로 Git 체크포인트를 남기고 작업 트리를 깨끗하게 유지해야 하는 이유를 diff 검토, 롤백, 병렬 작업 관점에서 정리합니다.

마지막 수정 2026년 3월 20일

기본 패턴

bash
git status
git add <related-files>
git commit -m "checkpoint before codex task"

# Codex 작업 후
git diff
git status

설명

  • OpenAI의 Quickstart와 보안 가이드는 Codex 작업 전후에 Git 체크포인트를 남기라고 반복해서 권합니다.
  • 시작 시점이 분명해야 Codex가 만든 변경만 git diff로 바로 읽을 수 있고, 문제가 생기면 비교와 롤백도 쉬워집니다.
  • 작업 트리가 이미 어수선하면 Codex가 새로 만든 변경과 기존 수동 수정이 섞여 검토 비용이 크게 올라갑니다.
  • 현재 브랜치를 건드리고 싶지 않다면 Worktree를 써서 실험용 체크아웃을 분리하는 편이 안전합니다.
  • 버그 수정, 리팩터링, 문서 갱신처럼 작업이 길어질수록 "작업 전 커밋 -> Codex 실행 -> diff 검토 -> 테스트" 순서가 안정적입니다.

짧은 예제

text
권장 흐름
1. 현재 변경을 정리하거나 임시 커밋으로 체크포인트를 만든다.
2. Codex에게 수정 범위와 검증 조건을 준다.
3. 결과는 git diff와 최소 테스트로 확인한다.
4. 만족스럽지 않으면 체크포인트와 비교해 되돌리거나 다시 분기한다.

빠른 정리

습관얻는 이점
작업 전 체크포인트 커밋시작 기준점이 생깁니다.
깨끗한 작업 트리 유지Codex 변경과 기존 변경이 섞이지 않습니다.
결과를 git diff로 검토실제 수정 범위를 빠르게 읽을 수 있습니다.
필요 시 Worktree 사용본 작업과 실험 작업을 분리할 수 있습니다.
작업 후 다시 커밋다음 반복의 기준점이 또 생깁니다.

주의할 점

이미 중요한 미커밋 변경이 많이 있는 상태에서 Codex를 바로 돌리면, 결과를 읽고 되돌리는 비용이 커집니다. 정리할 시간이 없다면 현재 상태를 임시 커밋이나 Worktree로 먼저 분리해 두는 편이 낫습니다.

참고 링크

3 sources