Codex Record & Replay : 워크플로우를 시연해 재사용 스킬로 만들기
목차
개요
Record & Replay는 OpenAI Codex에서 제공하는 기능으로, 워크플로우를 한 번 시연하면 이를 재사용 가능한 스킬로 변환해 준다. 설명하기보다 직접 보여주는 편이 쉬운 작업을 Codex가 관찰하고 학습하도록 만드는 방식이다. 현재 macOS에서 사용할 수 있으며 Computer Use가 활성화되어 있어야 한다. 지원 지역에서는 유럽경제지역(EEA), 영국, 스위스가 현재 제외되어 있다.
이 기능은 반복적인 작업, 개인의 선호도가 반영되는 프로세스, 그리고 말로 설명하기보다 시연이 더 쉬운 워크플로우에 특히 적합하다. 대표적인 예시로는 비용 청구 파일링, 주차 예약, 올바르게 설정된 이슈 생성, 비디오 발행, 정기 보고서 다운로드 등이 있다.
배경
Record & Replay를 시작하기 전에는 이미 수행 방법을 알고 있는 워크플로우를 선택하는 것이 중요하다. 이 기능은 단계가 안정적이고 성공 기준이 명확할 때 가장 잘 작동한다. 즉, 매번 결과가 달라지거나 판단이 모호한 작업보다는, 정해진 절차를 반복적으로 수행하는 작업에 적합하다.
녹화는 사용자가 Mac에서 워크플로우를 직접 수행하는 동안 Codex가 이를 관찰하는 형태로 진행된다. 녹화 중 Codex는 워크플로우를 학습하는 데 필요한 액션과 윈도우 콘텐츠를 관찰하며, 사용자가 중지할 때까지 관찰을 계속한다. 따라서 녹화는 작업에 집중된 상태로 유지하는 것이 좋다.
핵심 내용
녹화 시작하기
녹화는 Codex 앱에서 시작한다. 아래 순서대로 진행하면 워크플로우를 캡처할 수 있다.
| 단계 | 동작 |
|---|---|
| 1 | Codex 앱에서 Plugins 열기 |
| 2 | ”+” 메뉴 열기 |
| 3 | “Record a skill” 선택 |
| 4 | 제안된 프롬프트 검토 후 Codex에 도움이 되는 컨텍스트를 제공하고 제출 |
| 5 | 녹화 허가 요청이 표시되면 준비되었을 때 승인 |
| 6 | Mac에서 워크플로우 수행 |
| 7 | 완료 시 메뉴바, 오버레이, 또는 음성으로 녹화 중지 |
녹화를 시작하기 전 제안된 프롬프트를 검토하고, Codex가 워크플로우를 더 잘 이해하도록 컨텍스트를 함께 제공하는 단계가 포함된다. 녹화 허가 요청이 표시되면 준비가 되었을 때 승인하고, 이후 실제로 Mac에서 워크플로우를 수행한다. 작업이 끝나면 메뉴바나 오버레이, 또는 음성을 통해 녹화를 중지할 수 있다.
스킬 생성과 재생
녹화가 끝나면 Codex가 캡처된 워크플로우를 검사하고 스킬 초안을 작성한다. 이렇게 만들어진 스킬에는 해당 스킬을 언제 사용해야 하는지, 어떤 입력값이 필요한지, 어떤 단계를 따라야 하는지, 그리고 결과를 어떻게 검증하는지가 포함된다. 초안이 완성된 후에는 추가적인 정제를 요청할 수도 있다.
스킬을 실제로 활용하는 단계가 재생(Replay)이다. 새 스레드를 시작한 뒤 생성된 스킬을 사용하도록 요청하며, 이때는 처음 녹화와는 다른 값을 제공한다. 예를 들어 업로드할 파일, 생성할 이슈, 보고서의 날짜 범위 등 상황에 맞는 입력값을 새로 전달한다. Codex는 이 스킬을 재사용 가능한 컨텍스트로 활용해, 현재 환경에서 사용할 수 있는 도구로 워크플로우를 완료한다. 여기서 사용되는 도구에는 Computer Use, 브라우저 액션, 그리고 설치된 플러그인이 포함된다.
| 단계 | 내용 |
|---|---|
| 녹화 | 사용자가 Mac에서 워크플로우를 시연하고 Codex가 액션과 윈도우 콘텐츠를 관찰 |
| 스킬 생성 | Codex가 캡처된 워크플로우를 검사해 사용 시기, 입력값, 단계, 검증 방법이 담긴 스킬 초안 작성 |
| 재생 | 새 스레드에서 다른 입력값을 제공하면 Codex가 스킬을 컨텍스트로 활용해 워크플로우 완료 |
더 나은 녹화를 위한 팁
녹화 품질을 높이려면 시연을 짧고 완전하게 유지하는 것이 좋다. 녹화 전에는 목표와 함께, 스킬마다 달라질 수 있는 특정 입력값을 Codex에 미리 알려 주는 것이 도움이 된다. 실제 입력값을 사용하되, 비밀이나 민감한 데이터는 회피해야 한다.
녹화가 끝난 후에는 숨겨진 선호도를 명시하는 것이 좋다. 여기에는 네이밍 컨벤션, 필드의 기본값, 의사결정 포인트 등이 포함된다. 또한 워크플로우가 완료되면 바로 녹화를 중지하고, 관련 없는 정리 작업으로 이어가지 않는 것이 중요하다.
| 팁 | 설명 |
|---|---|
| 짧고 완전하게 | 시연을 간결하면서도 워크플로우 전체를 담도록 유지 |
| 목표와 입력값 사전 공유 | 녹화 전에 목표와 스킬마다 달라질 입력값을 Codex에 알림 |
| 민감 데이터 회피 | 실제 입력값을 쓰되 비밀이나 민감한 데이터는 사용하지 않음 |
| 숨겨진 선호도 명시 | 네이밍 컨벤션, 필드 기본값, 의사결정 포인트를 녹화 후 보충 설명 |
| 깔끔한 종료 | 워크플로우 완료 시 중지하고 무관한 정리 작업으로 이어가지 않음 |
플러그인과의 차이와 트러블슈팅
Record & Replay는 시연한 워크플로우로부터 스킬을 빠르게 만들어 내는 방법이다. 반면 팀 배포용으로 안정적인 패키지를 배포하거나, 여러 스킬을 하나로 번들링하거나, 앱과 통합하거나, MCP 서버를 추가하거나, 설치 메타데이터를 관리해야 한다면 별도의 플러그인으로 패키징하는 편이 적합하다. 이러한 패키징 작업은 Build plugins 문서를 참고할 수 있다.
Record & Replay가 화면에 보이지 않는 경우도 있다. 조직이 requirements.toml로 Codex를 관리하는 경우, features 섹션의 computer_use 요구사항이 Record & Replay 사용 여부도 함께 제어한다. computer_use 값을 false로 설정하면 Computer Use와 Record & Replay 두 기능이 모두 비활성화된다.
의미와 시사점
Record & Replay는 자동화 스킬을 만드는 진입 장벽을 낮춘다. 스크립트를 작성하거나 단계를 일일이 글로 설명하는 대신, 사용자가 실제로 작업을 한 번 수행하기만 하면 Codex가 이를 스킬로 정리해 준다. 설명보다 시연이 쉬운 작업, 또는 개인의 선호도가 반영되어 말로 표현하기 어려운 작업에서 특히 유용하다.
또한 재생 단계에서 입력값만 바꿔 같은 워크플로우를 다른 상황에 적용할 수 있다는 점이 핵심이다. 이는 한 번의 시연이 일회성으로 끝나지 않고, 재사용 가능한 컨텍스트로 누적된다는 것을 의미한다. 다만 팀 단위 배포나 통합이 필요한 경우에는 플러그인 패키징이라는 별도의 경로가 마련되어 있어, 용도에 따라 두 방식을 구분해 사용할 수 있다.
결론
Record & Replay는 macOS에서 Computer Use가 활성화된 환경에서, 워크플로우를 한 번 시연해 재사용 가능한 스킬로 변환하는 기능이다. 반복적이고 절차가 안정적인 작업, 그리고 설명보다 시연이 쉬운 작업에 적합하다. 녹화, 스킬 생성, 재생이라는 세 단계를 거치며, 짧고 완전한 시연과 사전 컨텍스트 공유가 녹화 품질을 좌우한다. 팀 배포나 통합이 필요할 때는 플러그인 패키징을, 빠른 개인 자동화에는 Record & Replay를 선택하면 된다.