OpenAI 공식 문서 — Codex Integrations 빌더

16. Integrations — GitHub · Slack · Linear

Codex가 외부 제품 안에서 호출되는 네 가지 공식 통합 — GitHub Code Review · Codex GitHub Action · Slack · Linear. 자동 PR 리뷰 흐름, GitHub Action YAML 예시와 secret 주입 패턴, Slack/Linear에서 작업 위임 방법, Enterprise 데이터 제어까지 한 페이지로 정리합니다.

이 페이지에서 배우는 것

• 1네 가지 공식 통합 (GitHub Code Review · GitHub Action · Slack · Linear) 비교
• 2GitHub Code Review — 자동 PR 리뷰와 @codex 멘션 흐름
• 3Codex GitHub Action — 완전한 YAML 예시와 secret 패턴
• 4Slack 통합 — @Codex 멘션으로 Cloud task 위임
• 5Linear 통합 — 이슈 assign · triage rule · Local MCP
• 6Enterprise 환경에서의 데이터 제어 요약

네 가지 공식 통합 한눈에

① GitHub Code Review — PR 자동 리뷰

저장소를 Codex에 연결하면 PR이 열리거나 업데이트될 때 자동으로 Codex가 리뷰 코멘트를 답니다. 추가로 PR 안에서 @codex review · @codex fix 같은 멘션으로 온디맨드 작업도 가능합니다.

• ✓연결 — Codex 앱 또는 GitHub에서 OpenAI Codex 앱 설치 → 리뷰 대상 저장소 선택
• ✓가이드라인 — 저장소 루트의 AGENTS.md가 리뷰 기준으로 사용됩니다. 팀 규칙·금지 패턴·우선순위를 적어두면 그대로 반영
• ✓온디맨드 명령 — PR 코멘트로 @codex review(전체 재리뷰), @codex fix <설명>(자동 수정 PR 생성), @codex explain <질문>
• ✓Enterprise data control — Workspace 관리자가 외부에 코드 데이터를 전송할지 토글로 제어 가능

② Codex GitHub Action — CI 안에서 명시적 호출

uses: openai/codex-action으로 임의의 워크플로 단계에서 Codex를 호출합니다. PR 자동 리뷰보다 더 정밀한 제어가 필요할 때 — 예: 특정 디렉터리만 리뷰, 특정 이슈/라벨에 응답, secret 환경에서 실행.

최소 YAML 예제

name: Codex Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: openai/codex-action@v1
        with:
          prompt: |
            Review the PR diff against AGENTS.md guidelines.
            Post inline comments on lines that need changes.
          model: gpt-5-codex
          sandbox: read-only
          safety-strategy: drop-sudo
        env:
          CODEX_ACCESS_TOKEN: ${{ secrets.CODEX_ACCESS_TOKEN }}

자주 쓰이는 inputs

• ✓prompt / prompt-file — Codex에게 줄 지시문(인라인 또는 파일 참조)
• ✓model — gpt-5-codex 등 모델 선택
• ✓sandbox — read-only / workspace-write / danger-full-access (CI에서는 read-only 권장)
• ✓safety-strategy — drop-sudo(sudo 제거) · unprivileged-user(권한 낮은 사용자로 실행) 같은 강화 옵션
• ✓final-message output — 다음 단계에서 ${{ steps.codex.outputs.final-message }}로 받아 PR 코멘트 게시

Secret 주입 패턴

CODEX_ACCESS_TOKEN은 워크스페이스 관리자가 발급한 Enterprise access token입니다(자세히는 18. Enterprise). 일반 API key보다 회전·취소가 쉽고 감사 로그에 추적 가능합니다.

# GitHub Secrets에 등록 후 env로 주입
env:
  CODEX_ACCESS_TOKEN: ${{ secrets.CODEX_ACCESS_TOKEN }}
  # 또는 ChatGPT 인증을 위한 OAuth refresh token

# 추가 도구에 필요한 secret도 같은 방식
  GH_TOKEN: ${{ secrets.GH_TOKEN }}
  SLACK_TOKEN: ${{ secrets.SLACK_TOKEN }}

③ Slack 통합

Slack 워크스페이스에 OpenAI Codex 앱을 추가하면 채널·DM에서 @Codex 멘션으로 작업을 위임할 수 있습니다. 실행은 Cloud에서 이루어지고 결과는 같은 스레드로 회신됩니다.

④ Linear 통합

Linear 워크스페이스에 OpenAI Codex 앱을 연결하면 이슈를 Codex에게 assign해 작업을 위임할 수 있습니다. Triage rule로 특정 라벨이 붙은 이슈를 자동으로 Codex에 라우팅하는 패턴이 일반적입니다.

• ✓이슈 assign — Linear 이슈 우측 패널에서 Assignee를 "Codex"로 설정 → 자동으로 Cloud 작업 시작
• ✓Triage rule — Linear의 자동화 규칙에서 Delegate > Codex를 액션으로 추가해 새 이슈를 자동 위임
• ✓Local MCP for CLI — Linear MCP 서버를 로컬에서 띄워(codex mcp add linear ...) Codex CLI/IDE에서 이슈 데이터를 도구로 사용
• ✓결과 반영 — Codex가 만든 PR이 Linear 이슈에 자동 링크되어 진행 상태가 동기화됩니다.

Enterprise 데이터 제어 요약

네 가지 통합 모두 Workspace 관리자가 외부에 데이터를 전송할지를 설정으로 제어합니다. 자세히는 18. Enterprise의 Managed Configuration 섹션 참조.

한계점