소개
코덱스(Codex)를 처음 접하는 분들을 위한 입문용 강의 슬라이드 제작 과정을 공유합니다.
이번 작업은 VS Code 환경 대신 코덱스 데스크톱 앱을 메인으로 사용하여 진행했습니다. 주요 목적은 코덱스의 4대 기본기(/plan, /goal, /side, 메모리)와 확장 기능(Skill, Plugin, MCP)의 실제 작동 방식을 확인하고, 강의 자료 제작 업무에 적용해 보는 것이었습니다.
진행 방법
작업은 지피터스 23기 코덱스 입문 2주차 강의에서 다룬 기능을 참고하여 코덱스 데스크톱 앱 내에서 진행했습니다.
1. 도구의 이해와 세팅 (Plugin vs MCP)
작업에 앞서 플러그인과 MCP의 차이점을 먼저 정리하고 환경을 설정했습니다.
플러그인 (Plugin = SaaS): 구글 크롬, 깃허브 등 기존 완성된 외부 서비스를 연결하는 기능
MCP: 공식 플러그인이 없는 사내 DB나 특정 로컬 도구(예: 블렌더)에 연결하기 위해 사용하는 통신 규격
코덱스 데스크톱 앱 좌측의 플러그인 메뉴를 통해 필요한 도구들의 접근 권한과 상태를 직관적으로 관리할 수 있었습니다.
2. /plan 모드와 Grill-me 스킬을 활용한 기획
초기 기획 단계에서 "Garbage In, Garbage Out(조지 퓨첼)"을 방지하기 위해 계획 모드(/plan)와 인터뷰 스킬(Grill-me)을 조합하여 사용했습니다.
💡 사용한 프롬프트:
/plan(계획 모드 실행) "코덱스에 대해서 더 알아보고 싶어. 그리고 그걸 슬라이드로 제작하고 싶어."
이 프롬프트를 입력하자, 코덱스는 Grill-me 스킬을 통해 "강의를 들은 사람이 끝나고 반드시 혼자 해낼 수 있어야 하는 한 가지는 무엇인가요?", "누가 이 슬라이드를 보게 되나요?" 등의 역질문을 제시했습니다. 이를 통해 초기 요구사항의 모호한 부분을 구체화할 수 있었습니다.
3. /goal 모드로 연속적인 작업 지시
기획이 정리된 후, 전체 슬라이드 구성 및 대본 작성이라는 긴 호흡의 작업을 지시하기 위해 목표(/goal) 모드를 사용했습니다.
💡 사용한 프롬프트:
/goal 코덱스에 대한 초보자 대상 강의안을 제작해 줘. 적절한 목표를 네가 직접 설정하고 작업에 착수해
해당 명령을 통해 코덱스가 스스로 목차부터 대본까지 단계를 나누어 작업을 수행했습니다. 작업이 진행되는 동안 발생하는 부가적인 질문이나 확인 사항은 메인 컨텍스트를 유지하기 위해 /side 명령어를 활용하여 별도로 처리했습니다.
4. MCP를 활용한 시각 자료(3D) 생성
텍스트 외에 시각 자료를 추가하기 위해, 로컬에 실행해 둔 블렌더(Blender)를 코덱스와 MCP로 연결하여 3D 모델링을 지시했습니다.
# 터미널에서 코덱스에 블렌더 MCP를 연결하기 위한 명령어
claude mcp add blender-mcp uvx --from blender-mcp-server
💡 사용한 프롬프트: "지금 헤드리스 말고 내가 볼 수 있게 띄워둔 블렌더 이용해서 그리스 로마 신전 예쁘게 하나 모델링해 줘. 신전 앞에 정원이랑 분수도 모델링해 줘. 예쁘고 고퀄리티로."
코덱스가 MCP 규격을 통해 로컬의 블렌더 프로그램을 제어하여 신전과 정원 모델링을 완료했습니다. 이를 통해 공식 플러그인이 없는 도구라도 MCP 규격을 맞추면 직접 연동하여 제어할 수 있음을 확인했습니다.
결과와 배운 점
배운 점: 코덱스 데스크톱 앱은 단순한 코드 작성을 넘어 프로젝트 전체의 맥락을 파악하고 작업을 주도하는 데 유용했습니다. 또한 8K 컨텍스트 윈도우의 한계를 고려하여, 대화가 길어질 경우
/compact를 활용해 컨텍스트를 관리하는 요령이 필요함을 배웠습니다.시행착오 및 이해: 초기에는 기존 소프트웨어들의 API와 인공지능용 MCP의 개념이 혼재되어 헷갈렸으나, MCP가 기존 시스템을 수정하는 것이 아니라 인공지능과 소통하기 위한 중간 '통역사(규격)' 역할을 한다는 점을 명확히 이해하게 되었습니다.
향후 계획: 이번에는 외부에서 제공하는
Grill-me스킬을 활용했지만, 추후에는 반복적인 업무 절차(예: 특정 양식 검토 등)를/skill creator를 통해 직접 커스텀 스킬로 등록하여 효율을 높일 계획입니다.
도움 받은 글 (옵션)
지피터스 23기 코덱스입문 2주차 강의 자료: LLM 컨텍스트 쌓이는 원리 및 스킬/플러그인/MCP의 차이점 (https://gpters23.vercel.app/api/lectures/week2.html)
유용한 인터뷰 스킬
grill-me: https://www.skills.sh/mattpocock/skills/grill-me
