OpenAI에서 직접 알려주는 Codex 사용법

안녕하세요. 채널팀 Machine Learning Engineer 바벨입니다.

채널팀에서는 매주 금요일 지식과 인사이트를 나누는 데브 세션(Dev session)을 운영하고 있습니다. 주로 사내 엔지니어 분들이 발표해주시고, 때로는 외부 엔지니어를 초빙해 더 넓은 시각의 이야기를 듣기도 합니다.

지난 8월 14일 채널 사내 Dev Session에서 OpenAI의 정재원님(AI Deployment Manager)과 이재원님(Applied AI Engineer)을 모시고 OpenAI 엔지니어의 Codex 활용법 세션을 진행했습니다. Codex를 만든 회사에게, 그리고 동시에 Codex를 직접 제일 잘 활용하고 있는 회사로부터 Codex의 실제 워크플로와 유용한 사례를 위주로 들을 수 있었습니다. 실제 업무에서 참고할 수 있는 인사이트를 공유합니다.

1. Codex 앱이 에이전틱 프로그래밍에 최적인 이유

개발자들의 AI 코딩 경험은 코드 자동 완성에서 페어 프로그래밍을 거쳐 에이전틱 프로그래밍으로 진화하고 있습니다. 세 단계를 거치며 사람이 개입하는 지점은 점차 고수준으로 올라왔습니다. 자동 완성은 코드 텍스트를 타이핑하는 매 순간, 페어 프로그래밍은 함수 등 모듈의 구현 레벨에서 사람이 개입했습니다. 에이전틱 프로그래밍에서는 개입 시점이 작업 단위까지 올라왔습니다. 그래서 에이전틱 프로그래밍에서는 작업을 위임, 관찰, 개입하며, 최종적으로 검토 후 반영합니다.

• 위임: 오래 걸리는 여러 작업을 백그라운드에서 동시에 실행

• 관찰: Worktree · 실행 명령 · diff·브라우저 · 작업 결과를 한곳에서 확인

• 개입: 작업 도중 조건을 추가하거나 다음 작업을 예약하고 방향을 조정

• 검토: 코드 변경 사항 · 테스트 결과 · 실제 화면을 확인 후 승인

단일 위임 단위의 작업에서는 CLI와 IDE가 효율적이지만, 그 이상의 단계를 통합한 작업에서는 점점 병목이 됩니다. Codex 앱에서는 고수준의 작업 환경이 구조화되어 있고, 프로젝트마다 재설계할 필요 없이 반복 가능합니다. CLI는 개발자들에게 친숙하고 널리 쓰이는 UI이고, IDE는 즉시 실행 테스트 기반 개발 작업 및 대화형 개발 작업에서 여전히 적합한 도구입니다. 이러한 CLI, IDE의 장점들을 유지한 채로, Codex 앱에서는 skills, worktree, 예약 작업 등 더 확장된 워크플로를 지원합니다.

2. 효과적인 작업을 위한 Codex 워크플로

Codex 활용의 시작은 명확한 작업 위임이며, 잘 구성된 프롬프트를 통해 수행합니다. 에이전트에게 주어진 지시에 공백이 있으면 에이전트가 사용자의 작업 의도를 스스로 예상해서 채우게 되어 사용자의 기대치와 약간 다를 수 있습니다. 효과적인 작업 위임을 위한 네 가지 기준은 아래와 같습니다.

1. 목표: 원하는 결과, 변경 대상, 중요한 이유

2. 참고할 코드와 자료: Codex가 확인할 관련 파일, 오류, 예시, 기존 패턴, 리포지토리 영역

3. 제약조건: 해야 할 일과 금지 사항, 팀 규칙, 코드 스타일

4. 완료 기준: 통과해야 할 테스트 및 검사, 실행할 명령, 확인할 동작

위 네 가지 기준을 정의해서 지시하면 Codex 에이전트가 작업 범위와 검토할 대상을 분명히 정해서 작업을 진행할 수 있습니다. 이를 통해 재시도 및 되돌리기가 줄어들 수 있습니다. 반복해서 사용하는 위임 내용들은 컨텍스트로써 프로젝트 규칙으로 설정할 수 있습니다.

3. Codex의 작업 정확도를 높이는 방법들

Codex의 여러 기능 및 실행 환경을 작성하면 에이전트에게 컨텍스트를 제공할 수 있습니다. 컨텍스트가 제공된 에이전트는 보다 정확하게 주어진 작업을 수행할 수 있습니다. AGENTS.md는 Codex의 에이전트가 작업을 시작하기 전 확인하는 파일로, 리포지토리 규칙과 검증 방법 등을 작성하여 행동 규칙을 안내할 수 있습니다. AGENTS.md를 팀 규칙 및 개발 워크플로를 정리하여 팀 내에서 반복적으로 수행되는 작업을 구성원들끼리 공유하여 일관적으로 진행할 수 있습니다. 대규모의 프로젝트로 리포지토리의 규칙을 직접 설정하기 번거롭다면 /init 명령을 사용해보세요. Codex가 리포지토리를 탐색하여 AGENTS.md를 직접 작성합니다. 작성된 초안에 팀이 암묵적으로 지키는 규칙과 검증 방법을 반영하여 작업 정확도를 높일 수 있습니다.

AGENTS.md 뿐만 아니라 Codex의 Skills, Plugins, MCP를 통해서도 작업의 정확도를 높일 수 있습니다. Skills를 통해 반복적으로 사용하는 작업 절차를 재사용할 수 있습니다. 예를 들어, PR 작성, 이슈 분석, 테스트 실행 등의 절차를 Skill로 구성하여 작업 중에 사용할 수 있습니다. AGENTS.md와 마찬가지로 skill을 구성한 후 팀과 공유하면 프로젝트의 작업 방식이 일관적으로 적용됩니다. 팀에 공유되는 skill은 검증이 끝나고 반복해서 발생하는 절차만 만드는 편이 안전합니다. Plugin과 MCP를 통해서 외부 시스템과 연결하여 필요한 정보를 조회하고 지원되는 도구를 사용할 수 있습니다. Jira나 Linear의 이슈 트래커나 문서 도구를 연결해 작업 맥락을 가져오고 화면 조작 절차를 기록해 재사용하는 것까지 코드 외부의 워크플로를 활용할 수 있습니다.

4. 말로 지시하기 어려운 문제를 지시하는 법

Codex에게 지시가 어렵다면 어떨까요? 세부 절차가 복잡한 경우처럼 내가 하는 작업을 프롬프트로 풀어내기 어려운 경우가 있습니다. 그렇다면 Codex에게 record and replay로 작업 과정을 알려주세요. Codex는 녹화를 보고 이해하여 녹화된 작업 과정을 Codex가 다시 수행할 수 있도록 skill을 작성합니다. skill을 사용하면 녹화에서 작업한 내용을 Codex에게 지시할 수 있습니다. 다른 skill과 마찬가지로 팀에 공유하면 다른 구성원도 같은 작업을 수행할 수 있습니다.

위와 같이 놓치기 쉽고 세부 절차가 복잡한 유튜브 영상 업로드를 자동화할 수 있습니다. 다른 사례로는 세일즈포스 CRM 데이터 작업이나 이슈 티켓/문서 관리 작업을 record and replay로 지시할 수 있습니다. 프롬프트를 작성하기 어렵거나, API/MCP로 풀기 어려운 고수준의 워크플로를 작업할 때 유용하게 활용할 수 있습니다. 적합한 작업의 조건은 두 가지입니다. 절차가 고정되어있고, 결과를 검증할 수 있어야 합니다. 화면 구조가 바뀌면 기록된 절차와 어긋날 수 있으므로 실행 결과는 사람이 점검하는 것이 안전합니다.

5. “하지만 난 이미…“라고 생각하신다면

지금까지 Codex를 사용해서 에이전틱 프로그래밍을 효과적으로 구성하기 위한 요소들과 사례를 설명했습니다. 분명 효과적이지만 아마 많은 분들께서 이렇게 생각하실 것입니다.

“나는 이미 클로드 코드를 쓰고 있는데… 새로 세팅해야돼?”

지금도 쌓여가는 이슈들을 처리하기에도 바쁘신 것을 알고 있습니다. 그 와중에 시간 내서 마이그레이션까지 하기엔 부담될 수 있습니다. 그래서 두 가지가 준비되어 있습니다. 기존 에이전틱 시스템의 설정을 가져오는 방법, 그리고 클로드 코드를 떠나지 않고 plugin으로 Codex를 호출하는 방법입니다.

그래서 Codex는 프로젝트 내에 .claude와 같이 클로드 코드나 커서의 환경설정 폴더가 있으면 import해서 Codex의 설정으로 마이그레이션합니다. 데스크톱 앱에서는 설정의 Import 메뉴에서, Codex CLI에서는 /import 명령으로 실행할 수 있습니다.

클로드 코드에 Codex plugin으로도 Codex를 사용할 수 있습니다. 클로드 코드 안에서 플러그인 설치로 코덱스에 작업을 넘길 수 있습니다. 익숙한 UI를 유지한 채로 결과를 비교해보실 수 있습니다.

/plugin marketplace add openai/codex-plugin-cc

plugin install codex@openai-codex

/reload-plugins

/codex:setup

의 순서로 진행할 수 있습니다. 작은 실제 과제로 두 시스템에서 결과물 및 검증 과정을 비교, 평가하여 마이그레이션 여부를 결정할 수 있습니다.

6. 엔지니어로서 이번 세션을 들은 소감

저는 원래 Codex에 대해서 알고 있었지만, OpenAI에서 직접 소개해주신 덕분에 좀 더 해상도 높게 Codex에 대해 이해할 수 있었습니다. 특히 개발 워크플로우를 잘 이해한 제품이라는 인상을 받았고, 개인적으로 Record and replay 기능이 특히 기억에 남습니다. API, MCP로 잘 정의된 도구들을 활용하는 것을 넘어서 비정형화된 패턴의 업무도 워크플로우로 정의할 수 있다는 점이 특히 인상적이었습니다. Codex에 대해 친절하고 깊이있게 알려주기 위해 방문해주신 정재원님과 이재원님께 다시 한 번 감사드립니다!