본문으로 건너뛰기

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할 수 없음

참고 자료

  1. 1Codex 문서: Codex GitHub Actionlearn.chatgpt.com

업무 분야 · 필요한 기능

이 기능을 가진 도구