ChatGPT만 쓰면 손해입니다. Codex 쓰세요! (초보자 튜토리얼)
📺 원본 영상: ChatGPT만 쓰면 손해입니다. Codex 쓰세요! (초보자 튜토리얼) 🎙️ 채널: 시민개발자 구씨 📅 정리 일자: 2026-05-09 ⚠️ Note: 본 리포트는 영상의 음성을 텍스트로 변환(STT)하여 정리한 것입니다. 화면에 표시된 자료(차트, 코드, 슬라이드 등)는 포함되지 않을 수 있습니다.
개요
OpenAI의 Codex는 Claude Code에 대응하는 OpenAI 버전의 에이전틱(Agentic) AI 도구다. 단순한 챗봇 인터페이스를 벗어나 로컬 프로젝트 폴더를 직접 관리하면서 리서치, 문서 작성, PPT 제작, 검수까지 복잡한 업무를 자율적으로 수행한다. 이 영상은 기존 ChatGPT 구독 안에서 추가 비용 없이 Codex를 시작하는 방법부터, AI 자동화 컨설팅 제안서 PPT를 원샷으로 완성하는 전 과정을 단계별로 실연한다.
Codex란 무엇이며 ChatGPT와 무엇이 다른가
ChatGPT나 Gemini를 사용할 때 대부분의 작업 방식은 프롬프트 한 번으로 결과물을 받아 복사·붙여넣기하거나, 커넥터(Connector) 기능으로 문서를 생성하는 수준에 머문다. 그러나 실제 사무 업무는 단일 결과물이 아니라 여러 관련 문서를 참조하면서 특정 결과물을 반복적으로 생성하고 관리해야 하는 프로젝트의 성격을 띤다. 강연자에 따르면 바로 이 프로젝트 관리 측면에서 Codex는 ChatGPT보다 훨씬 적합한 도구다.
Codex는 사용자가 지정한 로컬 폴더를 작업 공간으로 삼아 PPT 파일, 이미지, 검수 리포트 등 업무 관련 모든 산출물을 해당 폴더 안에서 일원 관리한다. 채팅창에서 요청하면 결과가 사라지는 것이 아니라 폴더에 파일로 축적되고, Git으로 버전 관리되며, GitHub에 자동으로 동기화된다는 점이 핵심 차별점이다. 강연자는 “긴 프롬프트 하나보다 이런 구조를 만들고 이 문서들을 고도화해 나가는 게 더 중요하다”고 거듭 강조한다. 이미 ChatGPT를 구독하고 있다면 동일 계정으로 Codex에 접근할 수 있어 추가 비용이 발생하지 않는다는 점도 주목할 부분이다.
설치 및 초기 환경 설정
앱 다운로드와 로그인
💡 [영상 참조] 강연자는 이 시점에서 ChatGPT 좌측 사이드바의 Codex 섹션과 설치 옵션 화면을 보여주며 설명합니다. 📺 원본 영상에서 확인하세요.
ChatGPT에 접속하면 왼쪽 패널에 Codex 섹션이 표시되며, 클릭하면 웹 버전, CLI(Command Line Interface), 데스크탑 앱 세 가지 설치 방식을 확인할 수 있다. 강연자는 앱 다운로드 방식을 개인적으로 추천한다. Claude Code의 경우 CLI 중심으로 활용하고 있지만, Codex는 앱 쪽이 사용성이 더 잘 구현되어 있다는 것이 그 이유다. Codex 앱은 macOS와 Windows 양쪽을 지원하지만, Computer Use(컴퓨터 직접 제어) 기능은 현재 macOS 버전에서만 제공된다는 점을 유의해야 한다. 설치 후 ChatGPT 계정으로 로그인하면 전체적으로 ChatGPT와 유사한 화면이 나타나지만, 프로젝트 폴더를 선택하는 인터페이스가 중심에 배치된다는 것이 가장 큰 차이다.
UI 구성 요소 상세 이해
06:00 - Codex UI 상세 설명 - 플러그인, 모드 설정(Auto Review/Full Access), 슬래시 커맨드, PET 기능 소개
Codex UI는 여러 층위의 기능을 제공하므로 각 요소를 이해하고 시작하는 것이 효율을 높인다. 채팅창 하단의 플러스(+) 버튼으로 사진이나 파일을 첨부할 수 있고, Plan Mode를 활성화하면 실제 작업 실행 전에 Codex가 계획을 먼저 수립해 제시한다. 플러그인 섹션에서는 외부 스킬을 로드하여 기능을 확장할 수 있는데, 이에 대해서는 뒤에서 상세히 다룬다.
모드(Mode) 설정은 처음 사용자에게 특히 중요하다. 강연자는 Auto Review 모드로 시작하기를 권한다. Auto Review는 대부분의 작업을 자율적으로 진행하되 민감한 작업에 한해서만 사용자 확인(컨펌)을 요청하는 방식이다. 이 방식에 충분히 익숙해지고 기준 문서가 잘 갖춰졌다고 판단될 때 Full Access 모드로 전환하면 된다. Work Locally 옵션으로 로컬 폴더에서 작업하도록 설정하고, 브랜치는 main으로 지정한다. 모델 선택에서는 영상 기준 당시 최신 모델인 GPT-5.5를 선택하고 Intelligence 수준을 Extra High로 설정하는 것을 권장한다.
우측 상단에는 주요 버튼들이 있다. Setup Run Action은 환경 설정 초기값을 지정하는 기능으로 일반적인 작업에서는 대부분 건드릴 필요가 없다. 그 옆의 버튼은 결과물 미리보기 패널로 생성된 파일을 우측에서 바로 확인할 수 있어 매우 유용하다. Toggle Terminal을 누르면 화면 하단에 터미널이 활성화되고, 파일 탐색기 아이콘으로는 폴더 내 파일을 모니터링하다가 VS Code 같은 에디터로 직접 연결하여 세부 편집을 진행할 수 있다.
채팅창에서 슬래시(/)를 입력하면 모델 선택, 퍼스널리티 설정, 사용 가능한 스킬 목록 등 다양한 옵션이 나타난다. 퍼스널리티는 업무 용도라면 Pragmatic을, 개인적인 논의에는 Friendly를 선택하는 것이 적절하다. 흥미로운 기능 중 하나가 Pet인데, 슬래시 메뉴에서 활성화하면 작은 캐릭터가 화면에 상시 표시되면서 Codex가 진행 중인 작업 내용을 실시간으로 알려준다. Codex 창을 보지 않는 상황에서도 현재 작업 상황을 한눈에 파악할 수 있다는 것이 이 기능의 장점이다.
프로젝트 폴더 구조 설계
기본 디렉터리 구성
03:00 - 프로젝트 폴더 구조 설명 - codex-pptdemo 디렉터리 구성(agents, md, brand, context, assets, output) 및 사전 준비 문서 목록
Codex에서의 작업은 폴더를 중심으로 돌아가기 때문에 작업 공간(Workspace)을 먼저 세팅하는 것이 중요하다. 강연자가 실습에서 설계한 폴더 구조는 최상위 디렉터리 codex-pptdemo 아래에 agents, md, brand, context, assets, output 폴더를 두는 형태다. 여기에 작업 지침 문서인 agents.md, design.md, business_context.md, deck_brief.md를 사전에 생성해 두는 것이 전체 워크플로우의 기반이 된다. Codex 좌측의 프로젝트 패널에서 “새 프로젝트 추가”를 클릭하고 “Use an existing folder”를 선택하면 로컬 디렉터리에서 새 폴더를 생성하거나 기존 폴더를 지정하여 프로젝트로 연결할 수 있다.
Git과 GitHub로 버전 관리
에이전틱 AI에게 업무를 위임할 때는 AI가 생성한 결과물이 예상과 다를 경우를 대비해 이전 버전으로 되돌릴 수 있는 버전 관리 시스템이 필수다. Git은 폴더 안에서 일어나는 파일 변경사항을 추적하고 과거 상태로 복원할 수 있게 해주는 버전 관리 시스템이며, 여기에 GitHub를 더하면 동일 내용을 클라우드에 동기화하여 다른 컴퓨터에서 작업을 이어가거나 로컬 파일에 문제가 생겼을 때도 안전하게 복구할 수 있다.
설정 방법은 간단하다. 채팅창에 “해당 프로젝트를 Git으로 초기화해줘. 그리고 GitHub에도 remote public repository를 생성해줘”라고 요청하면 Codex가 알아서 처리한다. GitHub 계정이 연동되어 있지 않다면 연동 안내가 표시되는데, Codex가 연동 방법까지 상세히 설명해 주므로 그 안내를 따라가면 된다. 강연자는 실습에서 ‘codex-ppt-demo’라는 public 저장소가 생성되고 연동되는 것을 확인했다고 밝혔다.
작업 지침 문서 고도화: 결과물 품질의 핵심
왜 문서 설정이 프롬프트보다 중요한가
이 영상에서 가장 핵심적으로 강조되는 내용이다. ChatGPT나 Gemini를 사용할 때는 프롬프트 하나를 정교하게 작성하여 원하는 결과물을 얻는 방식에 집중했다면, Codex는 접근 방식이 근본적으로 다르다. 강연자는 “Codex가 참조해서 작업할 때 참조하는 그 문서 구조를 잘 작성해주는 게 내가 요청하는 프롬프트보다 훨씬 중요하다”고 거듭 강조한다. 즉, 요청 프롬프트가 아무리 길어도 agents.md, design.md, business_context.md, deck_brief.md 네 가지 지침 문서가 부실하면 원하는 수준의 결과물을 얻기 어렵다.
강연자는 또한 OpenAI가 공개한 최신 모델용 프롬프트 가이드를 인용한다. 그 핵심은 과정을 하나하나 상세히 지시하기보다, 좋은 결과물이 어떤 모습인지에 대한 기준(목표, 성공 기준, 제약, 출력, 종료 조건)을 명확히 제시하고, 그 기준에 도달하는 방법론은 모델이 자유롭게 선택하도록 구조를 짜는 것이다. 이 철학은 Codex의 문서 기반 접근 방식과 정확히 일치한다.
11:31 - 초기 문서 생성 완료 화면 - agents.md, design.md, business_context.md, deck_brief.md 생성 결과 및 우측 미리보기 패널
design.md — 브랜드 디자인 가이드
design.md에는 컬러, 폰트, 슬라이드 구성 기준 등 디자인 가이드를 담는다. 초안에는 구체적인 디자인 기준이 비어 있는 경우가 많으므로, 담당 브랜드가 있다면 해당 브랜드 가이드라인을, 없다면 새로 작성해야 한다. 강연자가 소개한 유용한 방법은 getdesign.md[?]라는 사이트(원본 영상 참조)를 활용하는 것이다. 이 사이트에는 유명 브랜드들의 design.md 예시 문서가 정리되어 있으며, 실습에서는 스타벅스 예시를 복사하여 Codex에 붙여넣고 “영문 예시를 한글 제안서에 맞게 수정하되, 스타벅스 로고 및 스타벅스 관련 예시는 제거해 달라”고 요청했다. 결과적으로 색상 사용 기준, 색상 조합 예시, 글자 기준, 슬라이드 구성 기준, 자주 쓰는 슬라이드 유형 등이 세세하게 정리된 design.md가 완성되었다. 처음부터 완벽하게 작성할 필요는 없으며, 벤치마킹할 예시를 하나 붙여넣고 커스터마이징 요청만 하면 된다는 것이 이 과정의 핵심이다.
business_context.md — 사업 배경과 고객 정보
business_context.md에는 어떤 사업을 하고, 누구를 대상으로 하며, 어떤 문제를 해결하는지에 대한 배경 정보를 담는다. 강연자는 실습에서 대상 고객(내부 개발팀이 없는 10~50명 규모의 중소기업 대표), 고객의 페인포인트, 제안 서비스 내용, 사용 솔루션 툴(Codex, Claude Code, n8n 등), 업무 자동화 솔루션 설명을 추가 인풋으로 제공했다. 이때 기존 초안을 덮어쓰지 않고 “기존 business_context.md를 참고해서 아래 내용을 보완해 달라”는 방식으로 요청하면, Codex가 기존 내용과 새 정보를 통합하여 고도화된 문서를 만들어 준다.
agents.md — 작업 지침의 핵심 문서
강연자는 네 가지 문서 중 agents.md가 가장 중요하다고 강조한다. Codex는 기본적으로 이 문서를 보고 작업 지침을 수행하기 때문에, 목표와 작업 원칙을 구체적으로 기술하는 것은 물론이고 관련 문서들을 단계별로 참조할 수 있도록 링크를 명시해 두는 것이 핵심이다. 예를 들어 “브랜드 디자인 관련 작업 시 design.md를 참조하고, 고객 문제 파악 시 business_context.md를, 슬라이드 흐름 확인 시 deck_brief.md를 참조하라”는 방식으로 명시해 두면 Codex가 작업 단계별로 적절한 문서를 자동으로 불러와 반영한다. 제작 규칙, 안전 규칙 등 결과물의 기준을 서술하는 방식으로 작성하는 것이 좋다.
deck_brief.md — 슬라이드 덱 구성 계획
deck_brief.md에는 슬라이드 덱의 각 장에 어떤 내용을 담고, 어떤 메시지를 전달하며, 어떤 자료가 필요한지 구체적인 구조를 설명한다. 강연자는 여기에 이미지 생성 지침도 추가했다. Codex 안에서 ChatGPT의 이미지 생성 모델을 직접 활용할 수 있으므로, “이미지가 필요한 영역에는 이미지 생성(Image Gen)을 이용해 삽입하고, 전체 덱에서 최소 3개 이상의 이미지를 활용하도록 권장하라”는 내용을 deck_brief.md와 agents.md 양쪽에 반영했다.
실전: AI 자동화 컨설팅 제안서 PPT 원샷 제작
플러그인 활성화
PPT 제작에 앞서 Codex 좌측 상단의 플러그인 메뉴에서 Presentation 플러그인을 활성화한다. OpenAI가 기본 제공하는 플러그인 목록에는 스프레드시트, 프레젠테이션, Slack, Notion, Gmail, Google Drive 등 실무 도구들이 포함되어 있다. Presentation 플러그인을 켜면 PPT 제작 시 Codex가 프레젠테이션 생성에 특화된 방식으로 작업을 처리하게 된다. 컴퓨터 직접 제어가 필요하다면 Computer Use를, 웹 브라우저를 통한 작업이 필요하다면 Browser Use를 추가로 활성화하면 된다.
Plan Mode로 사전 계획 수립
무거운 작업일수록 먼저 계획을 세우는 것이 토큰과 시간을 모두 아끼는 방법이다. 채팅창 하단의 Plan Mode를 켠 상태에서 “여성용 가방을 판매하는 온라인 쇼핑몰을 대상으로 10장짜리 AI 자동화 컨설팅 제안서 PPT를 만들고 싶다”는 요청과 함께 성공 기준, 해당 업계 페인포인트 리서치 요청 등을 함께 전달하면, Codex는 PPT를 실제로 만들지 않고 어떻게 접근할지 계획만 먼저 수립하여 제시한다.
계획 수립 중에 Codex는 리서치 기준 시장(한국 중심으로 설정), 최종 목적(파일럿 미팅), 고객사 표기 방식(실명 반영) 등 확인이 필요한 사항을 역으로 질문한다. 이처럼 Plan Mode를 활용하면 수십 분에 걸친 PPT 생성 작업을 시작하기 전에 방향을 먼저 조율하고, 불필요한 재작업과 토큰 낭비를 예방할 수 있다. 계획서에서 수정이 필요한 부분이 있으면 이 단계에서 먼저 조정한 뒤 승인하는 것이 효율적이다. 계획이 확정되면 고객사 명칭(실습에서는 “Green Tote Bag”이라는 가상 업체명 사용)을 입력하고 작업을 승인하면 Codex가 본격적으로 리서치부터 시작한다.
20:33 - Plan Mode에서 수립된 PPT 제작 계획 화면 - 목표 요약, 슬라이드 구성 계획, 근거·시각화 항목
생성 과정과 결과물
21:52 - 완성된 PPT 슬라이드 확인 화면 - 스타벅스 컬러 스킴 반영 디자인과 Green Tote Bag 이미지 삽입 결과
강연자에 따르면 전체 작업 완료까지 약 20분이 소요되었다. Codex는 온라인 쇼핑몰 업계 외부 리서치, AI 자동화 솔루션 매핑, 슬라이드별 계획 수립, 이미지 생성(1번·3번·6번 슬라이드에 각 1개씩), PPT 제작, 자체 검수 및 검수 결과 요약까지 순서대로 처리했다. 리서치 문서도 별도로 생성되어 폴더 내에 쌓였다.
완성된 PPT에는 앞서 design.md에 반영한 스타벅스 스타일 컬러 스킴이 적용되었고, Green Tote Bag 업체에 맞는 이미지도 자동 생성되어 삽입되었다. 슬라이드 구성은 고객사 특화 문제 분석, 업무 자동화 솔루션 3가지 선택, Codex를 자동화 설계 허브로 활용하는 구체적 방안, 4주 로드맵, 기대 효과 수치화, 운영 리스크 관리, 다음 미팅 의제 제안으로 짜여졌다. 강연자는 이렇게 한 번에 원하는 수준이 나오기 위해서는 반드시 기준 문서를 충실히 세팅하고 계획을 최적화한 뒤 작업을 진행해야 하며, 어설픈 문서와 계획 없이 PPT 작업을 요청하면 수십 분의 작업 후에도 의미 없는 결과물이 나올 수 있다고 경고한다.
검수 및 최종 확인
Presentation 플러그인 활용 검수
PPT 생성 후 채팅창에서 @Presentation을 호출하고 “방금 만든 PPT를 레이아웃과 내용 측면에서 검수해 달라”고 요청하면 Codex가 슬라이드를 다시 검토하고 개선 포인트를 제안한다. 강연자는 한눈에 전체 덱 흐름을 파악할 수 있도록 리뷰 몽타주 PNG 파일도 생성하도록 권장한다. 실습에서는 내용 측면의 팩트 체크가 필요한 부분이 몇 가지 식별되었고, “소스 문서를 참조하여 슬라이드 2번과 6번의 수치를 팩트 체크하고 필요 시 수정해 달라”는 요청으로 최신 통계 기반의 수정이 이루어졌다.
Computer Use로 파워포인트 직접 검증
26:27 - Computer Use 기능으로 파워포인트 직접 실행 및 슬라이드 쇼 검수 장면 - AI 마우스 포인터가 슬라이드를 직접 넘기는 모습
생성된 환경에서는 정상적으로 보이던 슬라이드가 실제 파워포인트에서 열었을 때 폰트가 깨지거나 줄바꿈이 어색하게 표현되는 경우가 종종 발생한다. Codex의 Computer Use 기능은 바로 이 문제를 해결해 준다. @컴퓨터 명령으로 Computer Use를 활성화하고 “파워포인트를 실행해서 최종 PPT를 열고 확인해 달라”고 요청하면, Codex가 직접 마우스를 조작하여 파워포인트를 실행하고 슬라이드를 한 장씩 넘기며 검토한다. 편집 화면과 슬라이드 쇼 모드 두 가지 방식으로 모두 점검하며, 이상 여부를 최종 리포트로 정리해 준다. 강연자는 “리서치, 이미지 생성, PPT 제작, 검수, 파워포인트 실행 확인까지 End-to-End로 모든 것을 Codex가 해줄 수 있다”고 설명하며, 이것이 Codex를 단순한 챗봇과 구분하는 핵심 경쟁력임을 강조한다.
고급 활용 팁
메모리(Memory) 기능
슬래시 메뉴에서 /memories를 입력하면 메모리 사용 여부와 자동 메모리 생성(Generate Memory) 활성화 여부를 설정할 수 있다. 이를 켜두면 Codex가 이전 작업 내역을 기억하고 이후 요청에 반영하여, 같은 맥락을 매번 반복 설명하지 않아도 일관된 작업 환경이 유지된다.
스킬(Skill) 생성과 재사용
반복적인 작업 패턴이 있다면 이를 스킬로 만들어 활용하는 것이 효율적이다. @스킬 크리에이터(Skill Creator)를 사용하면 사용자가 설명한 워크플로우를 기반으로 커스텀 스킬을 생성해 준다. 외부에서 만들어진 스킬, 예를 들어 GitHub에 공개된 스킬을 설치할 때는 @스킬 인스털러(Skill Installer)에 해당 GitHub URL을 입력하면 Codex가 알아서 설치 절차를 처리한다. OpenAI가 기본 제공하는 Presentation, Computer Use, Browser Use 같은 플러그인들도 동일한 스킬 구조 위에서 동작한다.
Hook을 통한 필수 검증 자동화
agents.md에 작업 지침을 잘 작성해 두면 GPT-5.5 수준의 최신 모델이 대부분의 작업을 정확하게 수행하지만, 작업이 복잡해질수록 특정 단계를 놓치는 경우가 발생할 수 있다. 이런 경우를 위해 Codex는 Hook 기능을 제공한다. Hook은 결과물이 생성될 때 특정 체크리스트를 코드 수준에서 반드시 실행하도록 강제하는 자동화 장치다. 예를 들어 “PPT 생성 후 반드시 팩트 체크 검수를 실행하라”는 검증 단계를 Hook으로 등록하면, agents.md를 통한 지시만으로 놓칠 수 있는 단계도 빠짐없이 실행된다. 강연자는 초반에는 agents.md 최적화만으로 충분하지만, 그래도 누락이 반복되는 단계가 생긴다면 Hook을 적극 활용하라고 권장한다.
마무리 / 핵심 정리
강연자는 이 영상의 핵심을 세 가지 원칙으로 정리한다.
30:20 - 핵심 세 가지 정리 화면 - 프로젝트 폴더+Git, 지침 문서 고도화, 계획·생성·검수 사이클 요약
첫 번째는 Codex 앱은 채팅방이 아니라 프로젝트 폴더를 맡기는 앱이라는 점이다. 따라서 프로젝트 폴더를 먼저 생성하고 Git 세팅을 완료하는 것이 모든 작업의 출발점이 된다. 버전 관리 없이 에이전틱 AI에게 업무를 위임하는 것은 복구 수단 없이 작업하는 것과 같으므로, GitHub 연동까지 초기 설정 단계에서 반드시 마쳐야 한다.
두 번째는 좋은 결과물은 긴 프롬프트가 아니라 좋은 작업 환경에서 나온다는 것이다. agents.md, design.md, business_context.md, deck_brief.md와 같은 지침 문서를 충실하게 세팅하고 작업마다 업데이트해 나가는 과정이 결과물 품질을 결정하는 핵심 변수다. 이 문서들이 잘 갖춰져 있다면 요청 프롬프트는 짧아도 충분하다.
세 번째는 AI 결과물은 생성보다 계획 수립과 검수가 중요하다는 원칙이다. 무거운 작업 전에는 Plan Mode를 통해 방향을 먼저 조율하고, 생성 후에는 Presentation 플러그인과 Computer Use를 활용하여 내용과 형식 두 측면 모두에서 검수를 진행해야 한다. 반복 작업으로 전환될 시점에는 Memory, Skill, Hook을 적극 활용하여 효율을 극대화하는 것이 마지막 단계다.
📚 출처 및 참고
| 구분 | 내용 |
|---|---|
| 원본 영상 | ChatGPT만 쓰면 손해입니다. Codex 쓰세요! (초보자 튜토리얼) |
| 채널 | 시민개발자 구씨 |
| 리포트 작성 | 2026-05-09 |
| 작성 방식 | YouTube 영상 STT 변환 후 에디팅 |
💬 본 리포트는 영상 내용을 바탕으로 재구성되었습니다. 정확한 내용은 원본 영상을 참조해 주세요.