CI에서 codex exec 돌리기
codex exec로 Codex를 비대화(non-interactive) 실행하면 CI나 스크립트 안에서 리뷰·릴리스 노트·수정 같은 일을 사람 없이 맡기고 결과를 파일로 받을 수 있습니다.
codex exec에 요청을 주고 최종 답을 파일로 받습니다. 샌드박스로 할 수 있는 일을 정하고, GitHub에서는 openai/codex-action으로 PR마다 돌립니다. 명령과 설정 이름은 2026년 11월 21일에 공식 문서로 확인했습니다.
준비
- Codex CLI 설치와 로그인
1. 한 번 실행
진행 상황은 표준 오류로, 최종 답은 표준 출력으로 나옵니다. 파이프로 바로 파일에 남깁니다.
codex exec "최근 커밋 10개로 릴리스 노트를 써 줘" | tee release-notes.md결과: release-notes.md
확인: 파일에 릴리스 노트가 들어 있는지 확인
2. 할 수 있는 일 정하기
고치게 할 때는 작업 폴더 쓰기를 열어 줍니다. 읽기만 하는 일은 read-only로 둡니다.
codex exec --sandbox workspace-write "실패하는 테스트를 고쳐 줘"결과: 고친 변경
확인: git diff로 고친 내용 확인
3. 결과를 파일과 JSON으로
-o는 최종 답을 파일에 씁니다. --json은 진행 이벤트를 JSON Lines로 내보내 다른 도구가 읽게 합니다.
codex exec -o review.md --json "이 변경을 보안 위주로 리뷰해 줘" > events.jsonl결과: review.md와 events.jsonl
확인: review.md에 리뷰가 들어 있는지 확인
4. 이어서 실행
앞 세션을 이어 갈 수 있습니다.
codex exec resume --last "이번엔 성능 문제만 봐 줘"결과: 앞 대화를 이은 결과
확인: 답이 앞 리뷰를 이어받는지 확인
5. GitHub Actions에서 돌리기
openai/codex-action@v1에 API 키 비밀값과 프롬프트 파일을 줍니다. 최종 답은 output-file로 받습니다.
- uses: openai/codex-action@v1
with:
openai-api-key: ${{ secrets.OPENAI_API_KEY }}
prompt-file: .github/codex/prompts/review.md
output-file: codex-output.md
sandbox: read-only결과: 워크플로의 Codex 단계
확인: Actions 실행 결과에 codex-output.md가 생겼는지 확인
주의
- --full-auto는 더 이상 지원하지 않음. --sandbox workspace-write로 바꾸기
- CI에서 API 키로 돌리면 실행마다 요금 발생
- --ephemeral을 주면 세션 기록이 남지 않아 resume할 수 없음
참고 자료
- 1Codex 문서: Codex GitHub Actionlearn.chatgpt.com
댓글