---
name: opencurrent-codex-exec-ci
description: "codex exec로 Codex를 비대화(non-interactive) 실행하면 CI나 스크립트 안에서 리뷰·릴리스 노트·수정 같은 일을 사람 없이 맡기고 결과를 파일로 받을 수 있습니다. 이럴 때 사용: codex exec에 요청을 주고 최종 답을 파일로 받습니다. 샌드박스로 할 수 있는 일을 정하고, GitHub에서는 openai/codex-action으로 PR마다 돌립니다. 명령과 설정 이름은 2026년 11월 21일에 공식 문서로 확인했습니다. 도구: Codex CLI, GitHub Actions."
metadata:
  source: "https://opencurrent.ai/w/codex-exec-ci"
  opencurrent-id: "codex-exec-ci"
  verification: "pending"
  exported-at: "2026-11-21T11:06:10.307Z"
---

# CI에서 codex exec 돌리기

codex exec로 Codex를 비대화(non-interactive) 실행하면 CI나 스크립트 안에서 리뷰·릴리스 노트·수정 같은 일을 사람 없이 맡기고 결과를 파일로 받을 수 있습니다.

> OpenCurrent에서 사람들이 다듬는 워크플로. 원문: https://opencurrent.ai/w/codex-exec-ci
> 검증 상태: 검수 대기 (사람 확인 전). 내려받은 뒤에 바뀌었을 수 있으니, 가능하면 원문이나 MCP의 get_workflow("codex-exec-ci")로 최신 상태를 확인할 것.
> 주의: 검수 대기 상태. 사용자에게 이 사실을 알리고, 결과를 함께 확인하면서 진행할 것.

## 따라 하는 방법

1. 준비물이 갖춰졌는지 먼저 확인할 것.
2. 단계를 순서대로 진행할 것. kind가 "ai"면 프롬프트를 실행하고, "command"면 사용자의 허락을 받고 명령을 실행하고, "human"이면 사용자에게 할 일을 안내하고 끝났는지 물을 것. tool이 있으면 그 도구·모델로 할 것.
3. 단계에 output(결과 이름)이 있으면 그 단계 결과를 뒤 단계 프롬프트의 {{output}} 자리에 넣을 것.
4. 단계마다 expected(기대 결과)와 check(확인 방법)로 제대로 됐는지 확인하고, 다르면 다음 단계로 넘어가지 말고 사용자에게 알릴 것. 끝나면 example.output(있으면)과 비교할 것.
5. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.

## 언제 쓰나

codex exec에 요청을 주고 최종 답을 파일로 받습니다. 샌드박스로 할 수 있는 일을 정하고, GitHub에서는 openai/codex-action으로 PR마다 돌립니다. 명령과 설정 이름은 2026년 11월 21일에 공식 문서로 확인했습니다.

## 준비물

- Codex CLI 설치와 로그인

## 단계

### 1. 한 번 실행 (명령 실행 · Codex CLI)

진행 상황은 표준 오류로, 최종 답은 표준 출력으로 나옵니다. 파이프로 바로 파일에 남깁니다.

프롬프트:

```text
codex exec "최근 커밋 10개로 릴리스 노트를 써 줘" | tee release-notes.md
```

기대 결과: release-notes.md

확인 방법: 파일에 릴리스 노트가 들어 있는지 확인

### 2. 할 수 있는 일 정하기 (명령 실행 · Codex CLI)

고치게 할 때는 작업 폴더 쓰기를 열어 줍니다. 읽기만 하는 일은 read-only로 둡니다.

프롬프트:

```text
codex exec --sandbox workspace-write "실패하는 테스트를 고쳐 줘"
```

기대 결과: 고친 변경

확인 방법: git diff로 고친 내용 확인

### 3. 결과를 파일과 JSON으로 (명령 실행 · Codex CLI)

-o는 최종 답을 파일에 씁니다. --json은 진행 이벤트를 JSON Lines로 내보내 다른 도구가 읽게 합니다.

프롬프트:

```text
codex exec -o review.md --json "이 변경을 보안 위주로 리뷰해 줘" > events.jsonl
```

기대 결과: review.md와 events.jsonl

확인 방법: review.md에 리뷰가 들어 있는지 확인

### 4. 이어서 실행 (명령 실행 · Codex CLI)

앞 세션을 이어 갈 수 있습니다.

프롬프트:

```text
codex exec resume --last "이번엔 성능 문제만 봐 줘"
```

기대 결과: 앞 대화를 이은 결과

확인 방법: 답이 앞 리뷰를 이어받는지 확인

### 5. GitHub Actions에서 돌리기 (사람이 · Codex CLI)

openai/codex-action@v1에 API 키 비밀값과 프롬프트 파일을 줍니다. 최종 답은 output-file로 받습니다.

프롬프트:

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

## 출처

- [Codex 문서: 비대화 실행](https://learn.chatgpt.com/codex/non-interactive-mode)
- [Codex 문서: Codex GitHub Action](https://learn.chatgpt.com/codex/github-action)

## 끝나면

결과가 좋았거나 단계가 낡았으면 https://opencurrent.ai/w/codex-exec-ci 에서 알릴 것. 다음 사람이 더 정확한 방법을 쓸 수 있도록.
