OpenAI 공식 문서 — Codex Resources 참고

22. Resources — Migrate · Use Cases · Best Practices · OSS · Maturity

본격 기능 가이드는 아니지만 한국 개발자가 자주 도착하는 보조 자료 모음 — 다른 도구(Cursor/Claude Code/Cline 등)에서 Codex로 마이그레이션, 50+ 공식 Use Case 카탈로그, Best Practices 프롬프트 구성 4요소, Codex 오픈소스 저장소 5종, 프로덕션 도입 의사결정에 직결되는 Feature Maturity 4단계를 한 페이지로 정리합니다.

한 줄 요약

본격 기능 가이드는 아니지만 한국 개발자가 자주 도착하는 보조 자료들 — 다른 도구에서 마이그레이션, 50+ Use Cases 카탈로그, Best Practices, 오픈소스 저장소, Feature Maturity 분류를 한 페이지에 모았습니다.

이 페이지에서 배우는 것

  • Cursor / Claude Code / Cline 등에서 Codex로 마이그레이션하는 공식 흐름
  • 50+ 공식 Use Case 카탈로그 (엔지니어링 / 프론트엔드 / iOS / 게임 등)
  • Best Practices — 좋은 프롬프트와 작업 구성
  • Codex 오픈소스 저장소 5종과 기여 방법
  • Feature Maturity 4단계 분류 — 프로덕션 도입 의사결정 기준

다른 도구에서 Codex로 마이그레이션

Cursor · Claude Code · Cline · Aider · GitHub Copilot Workspaces 등에서 Codex로 전환할 때 기존 설정을 자동 이관할 수 있습니다.

  • Settings → Import other agent setup — Codex 앱 설정에서 다른 에이전트의 구성 파일을 자동 검출하고 변환합니다.
  • 이관 대상 — AGENTS.md / config.toml / skills / MCP 서버 / hooks / subagents 정의
  • follow-up Skill — $migrate-to-codex Skill을 호출하면 이관 후 누락된 항목·차이점 보고서를 자동 생성
  • 한 번에 안 되는 것 — IDE 별 사용자 정의 단축키, 일부 도구별 고유 기능. 수동 매핑 필요

한국 팀의 흔한 전환 경로

Cursor → Codex
.cursorrules를 AGENTS.md로 자동 이관. Cursor의 "Agent" 모드가 Codex의 Agent (Full Access)와 유사 (15. IDE Extension).
Claude Code → Codex
CLAUDE.md를 AGENTS.md로 변환, hooks 설정 이관. Slash 명령 차이는 별도 매핑.
Cline → Codex
MCP 서버 설정 자동 이관. 사용자 정의 모드는 Codex의 Personality + Settings로 분리.
GitHub Copilot Workspaces → Codex
스킬 개념이 다르므로 직접 매핑 적음. PR-only 워크플로는 16. Integrations의 GitHub Code Review로 대체.

Use Cases — 50+ 공식 카탈로그

공식 Codex Use Cases 페이지에는 50개 이상의 실전 시나리오가 카테고리별로 정리돼 있습니다. 한국 개발자가 자주 참조하는 카테고리:

2026년 6월 기준 대표 흐름으로는 Manage your inbox, Use your computer with Codex, Follow a goal이 전면에 배치되어 있습니다. 즉, 최신 Use Cases는 코드 수정뿐 아니라 메일 처리, 앱 조작, 장기 목표 추적 같은 업무형 워크플로까지 적극적으로 다룹니다.

  • Engineering — 리팩토링, 마이그레이션, API 클라이언트 작성, 테스트 자동화, 디버깅
  • Front-end — UI 컴포넌트 생성, 디자인 시스템 정합성 검토, 접근성 점검
  • iOS · macOS — Swift 코드 생성, Xcode 프로젝트 구성, 앱 스토어 메타데이터
  • Game — Unity/Unreal 보일러플레이트, 셰이더 작성, 게임 메커니즘 디자인
  • Data · ML — 데이터 파이프라인, 시각화, 모델 평가 스크립트
  • DevOps — Kubernetes 매니페스트, Terraform 모듈, CI 워크플로

전체 목록은 공식 Use Cases 페이지를 참고하세요. 각 사례마다 예시 프롬프트가 있어 그대로 복사해 시작할 수 있습니다.

Best Practices — 좋은 프롬프트와 작업 구성

공식 Best Practices가 권하는 4가지 prompt 구조 요소:

Goal
달성하려는 사용자 결과 1~2문장. "테스트 커버리지 80% 이상" 같이 측정 가능.
Context
관련 파일·API·제약 조건. @file·@symbol로 정확히 짚기.
Constraints
"공개 API 시그니처는 유지", "외부 라이브러리 추가 금지" 같은 한계.
Done-when
완료 조건. "테스트 전부 통과 + lint 0 warnings". 11. GPT-5.5 프롬프트의 outcome-first 패턴과 직결.

추가 권장 — 복잡한 작업은 /plan-mode로 시작해 계획을 먼저 점검, 그 다음 실행. 팀 컨벤션은 저장소 AGENTS.md에 적어 매번 다시 설명하지 않기.

Codex Open Source 저장소

Codex의 일부 구성요소는 오픈소스로 공개되어 있어 코드를 직접 보거나 기여할 수 있습니다.

저장소내용
openai/codexCodex 메인 저장소 — CLI, app-server, 설계 문서
codex-rs/app-serverJSON-RPC App Server Rust 구현 (위 저장소의 하위)
openai/skills큐레이션 Skill 카탈로그 — $skill-installer가 이 저장소를 사용
openai/codex-universalCodex Cloud의 universal 베이스 이미지 정의
codex/guardian/policy.mdAuto reviewer의 기본 정책 markdown — 자체 정책의 출발점으로 참조 가능

OSS Maintainer Program도 운영 중 — 검증된 기여자에게 별도 지원과 우선 응답을 제공합니다. 자세히는 공식 Open Source 페이지 참조.

Feature Maturity — 5단계 분류

Codex의 각 기능은 다음 5단계 중 하나의 성숙도로 표기됩니다. 공식 문서에 Deprecated 단계가 추가됐습니다. 프로덕션 도입 의사결정에 직접적인 기준이 됩니다.

Under development
아직 쓸 수 있는 상태가 아닙니다. 도입 검토 시기 아님.
Experimental
불안정하며 OpenAI가 바꾸거나 없앨 수 있습니다. 예: Rules. 프로덕션 사용은 권장 안 함.
Beta
넓게 시험해 볼 수 있는 단계. 대부분 완성됐지만 사용자 피드백에 따라 일부가 바뀔 수 있습니다. 비-크리티컬 프로덕션 사용 가능.
Stable
완전히 지원되고 문서화된 단계. 동작과 설정이 오래 일관되게 유지됩니다.
Deprecated
호환성을 위해 남아 있지만 더는 권장하지 않습니다. 이후 릴리스에서 없어질 수 있으니 대안으로 옮기세요.

특정 기능의 현재 단계가 궁금하면 공식 Feature Maturity 페이지를 확인하세요. 정기적으로 업데이트됩니다.

한국 개발자가 자주 도착하는 외부 자료

  • OpenAI 한국어 블로그 / 발표 — 분기마다 한국어 자료 일부 공개. openai.com/ko
  • 오늘코드 유튜브 — 본 가이드 운영자의 한국어 영상 (좌측 사이드바 푸터 링크)
  • 한국 Codex 사용자 커뮤니티 — 공식은 없지만 OpenAI Korea Slack/Discord 채널 또는 GitHub Discussions에서 사례 공유

공식 출처