OpenAI Codex 바이브코딩 실습 후기: AI에게 멈춤을 가르치다

코드를 짜주는 AI 에이전트. 하지만 실전에서 가장 중요한 것은 전체 작업 흐름을 기획하고 명확한 멈춤 조건을 설정하는 사람의 통제력입니다.

최근 Builder Josh 유튜브 채널에 올라온 라이브 강좌 녹화본을 보며 OpenAI Codex 사용법을 직접 따라 해봤습니다.

OpenAI 협찬으로 소개된 강좌였지만, 제가 집중한 부분은 기능의 화려함이 아니었습니다. 중장년의 입장에서 직접 Codex를 설치하고 작은 앱을 만들어보며, AI 코딩 에이전트를 실전에서 어떻게 다뤄야 하는지 감각을 익히는 것이 목적이었습니다.

처음에는 단순히 "Codex로 코딩을 대신할 수 있을까?" 하는 호기심으로 시작했습니다. 하지만 실습을 마친 후 깨달은 점은 분명했습니다. Codex는 코드를 빠르게 짜주는 훌륭한 도구이지만, 그보다 훨씬 중요한 것은 사람이 AI의 작업 범위와 멈춤 조건을 명확히 설계해야 한다는 점이었습니다.

1. 낯설었던 플러그인과 스킬(Skills) 개념 이해하기

이번 실습에서는 Codex 앱 설치부터 Claude Code 작업 흐름 가져오기, bkit-codex 설치 등을 순서대로 진행했습니다.

처음에는 VS Code 터미널에서 실행하는 CLI 환경이나 플러그인, MCP 같은 용어들이 어떻게 맞물려 돌아가는지 헷갈렸습니다. 하지만 직접 부딪혀보니 조금씩 윤곽이 잡혔습니다.

• 플러그인(Plugin): AI가 외부 도구(예: Figma)와 직접 연결되어 일할 수 있게 돕는 다리 역할
• 스킬(Skills): AI가 특정 작업 방식을 더 잘 따르도록 만들어주는 실무 지침서

단순한 기능 추가가 아니라, AI가 내 의도대로 움직이게 만드는 핵심 부품이라는 것을 이해하게 되었습니다.

2. Figma MCP의 매력, 그리고 무료 환경의 한계

가장 신기했던 것은 /figma-use 명령어를 활용한 실습이었습니다.

MCP(Model Context Protocol)를 통해 Codex가 제 Figma 파일과 직접 연결되었고, 명령을 내리자 실제 캔버스에 랜딩페이지 형태의 디자인이 만들어졌습니다. AI가 코드를 넘어 시각 디자인 도구까지 다루는 모습은 꽤 인상적이었습니다.

하지만 바로 한계도 경험했습니다. Figma Starter(무료) 플랜을 사용하다 보니, 디자인을 생성하고 레이아웃을 조금 수정하는 과정에서 금세 호출 한도(Tool call limit)에 걸려버렸습니다. Figma MCP는 시각적 초안을 잡는 데는 강력하지만, 무료 환경에서 반복적인 수정을 지시하기에는 무리가 있다는 점을 배웠습니다.

3. 실전에서는 DESIGN.md 방식이 더 유리했다

반면, 텍스트 기반의 DESIGN.md 문서를 활용하는 방식은 훨씬 안정적이었습니다.

Airtable 스타일의 샘플 문서를 프로젝트에 넣고, Codex에게 이 기준대로 랜딩페이지를 개선하라고 지시했습니다. Figma처럼 외부 프로그램을 반복해서 부를 필요 없이, 문서에 적힌 디자인 기준(흰색 캔버스, 카드형 구조, 절제된 컬러 등)을 AI가 읽고 바로 HTML/CSS로 구현해 냈습니다.

• Figma MCP: 시각적인 디자인 초안을 눈으로 확인하며 만들 때 유리
• DESIGN.md: 코드 기반의 UI 개선과 안정적인 반복 작업에 유리

제 운영 환경에서는 외부 의존도가 낮고 통제가 쉬운 DESIGN.md 방식이 훨씬 실용적으로 느껴졌습니다.

4. AI의 폭주를 막아라: $pdca 실습의 교훈

가장 뼈저린 학습은 $pdca 실습에서 나왔습니다. PDCA는 계획(Plan) - 실행(Do) - 점검(Check) - 개선(Act)의 단계를 뜻합니다.

제가 단순히 "앱 만들자"라는 식으로 넓게 지시를 내리자, Codex가 혼자서 계획부터 결과 보고까지 한 번에 진행해 버렸습니다. 결과적으로 실시간 회의록 앱 MVP가 만들어지긴 했지만, 학습 관점에서는 올바른 과정이 아니었습니다.

중간에 제가 계획을 검토하고, 디자인 방향을 확인한 뒤 승인해야 했는데, AI가 선의로 너무 많은 일을 스스로 끝내버린 것입니다.

앞으로는 AI에게 반드시 멈춤 조건을 주어야 합니다.

• "이번 단계만 수행하고 멈춰라."
• "Plan 문서만 만들고 대기하라."
• "코드 구현(Do)은 내 승인 후에 진행하라."

이런 통제 지시가 없으면 AI는 사용자의 의도와 다르게 엉뚱한 방향으로 질주할 수 있습니다.

5. 내 본진을 지키는 Codex 운영 원칙

이번 실습으로 Codex의 강력함은 충분히 확인했습니다. 하지만 그만큼 권한 통제에도 신중해야 합니다. 제 브랜드 본진이나, API 키가 포함된 실제 프로젝트에 처음부터 전체 권한(Full access)을 주는 것은 위험합니다.

안전한 바이브코딩을 위해 나만의 원칙을 세웠습니다.

1. 새로운 실습은 반드시 격리된 별도 폴더에서 시작한다.
2. 실제 운영 프로젝트는 코드 변경 없는 '읽기 전용' 분석부터 시킨다.
3. 작업의 기준이 되는 DESIGN.md와 AGENTS.md를 먼저 꼼꼼히 작성한다.
4. 코드를 실제로 수정하는 단계는 무조건 승인 후 진행한다.

마무리: 중요한 건 코드가 아니라 작업 흐름이다

이번 실습을 통해 가장 크게 배운 점은, 바이브코딩이 AI에게 모든 것을 알아서 하라고 던져두는 것이 아니라는 사실입니다.

AI가 일할 수 있는 명확한 단계와 흐름을 사람이 먼저 설계해야 합니다. 프롬프트 몇 줄을 화려하게 쓰는 것보다, 권한을 제한하고 어디서 멈출지 정해주는 통제력이 훨씬 중요합니다. 오늘 익힌 감각을 바탕으로 다음 단계의 AI 도구 실험을 이어가 보겠습니다.

---

[자주 묻는 질문 (FAQ)]

Q1. 코딩 지식이 전혀 없어도 바이브코딩 실습이 가능한가요?
A1. 네, 전문적인 코딩 지식이 없어도 시작할 수 있습니다. 다만 코드 자체보다 AI에게 작업의 순서(계획-실행-점검)를 논리적으로 지시하고, 결과를 확인하는 기획력이 더 필요합니다.

Q2. Figma MCP는 유료 플랜을 써야만 하나요?
A2. 무료(Starter) 플랜에서도 연결하여 테스트해 볼 수는 있습니다. 하지만 AI가 수정을 위해 반복적으로 접근하면 금방 API 호출 한도에 도달하므로, 본격적인 작업에는 유료 플랜이 유리할 수 있습니다.

Q3. AI가 한 번에 끝까지 작업해버리는 것을 막으려면 어떻게 해야 하나요?
A3. 프롬프트를 작성할 때 "다음 단계로 넘어가지 마라", "Plan 단계의 문서만 작성하고 내 승인을 대기하라"처럼 명확한 멈춤 조건(게이트)을 반드시 포함해야 합니다.

---

[다음 행동 제안]

새로운 AI 도구를 기존 프로젝트에 바로 적용하기 전에, 빈 폴더를 하나 만들고 AI에게 간단한 '계획서(Plan)'만 작성하게 한 뒤 멈추게 하는 연습부터 시작해 보세요. 권한을 통제하는 감각을 기르는 것이 최우선입니다.