OpenAI Codex CLI 및 플러그인 실무 팁: 마크다운 체크리스트 집계와 3D 뷰어 기능 개선

OpenAI DevDay Side Quest 이벤트 참여의 일환으로 개발자 Globejam(@Globejamyo)이 공유한 공식 Codex CLI 및 플러그인 실무 활용 팁입니다. 공식 Codex CLI(v0.159.2) 환경 설정과 ChatGPT 로그인 연동을 기반으로 마크다운 체크리스트 집계 도구를 개선하고, Build Web Apps 플러그인으로 3D 뷰어의 특정 메시 검색 및 분리 보기 기능을 구현한 2가지 실전 워크플로우를 다룹니다.

이미지 출처: @Globejamyo on X

1. Codex CLI 설정 및 마크다운 체크리스트 집계 도구 개선

첫 번째 팁은 공식 Codex CLI 환경에서 마크다운 파싱 도구의 엣지 케이스를 해결하고 출력 포맷을 확장하는 작업 흐름입니다.

• 버전 및 인증 점검: 설치된 공식 Codex CLI 버전(v0.159.2)과 ChatGPT 계정 로그인 연동 상태를 확인합니다.
• 코드 블록 예외 처리: 문서 본문 내 실제 체크박스 항목과 달리, 코드 블록(```) 내부에 예시로 작성된 체크박스(- [ ], - [x])가 오탐되어 집계에 포함되던 문제를 제외하도록 로직을 개선했습니다.
• 출력 포맷 다변화: 사람이 읽기 편한 일반 텍스트 요약 출력과 더불어, 다른 도구나 파이프라인에서 즉시 파싱할 수 있는 구조화된 JSON 출력 기능을 추가했습니다.
• 테스트 검증: 7개의 테스트 케이스를 모두 통과했으며, 실제 샘플 문서 기준으로 미완료 3개, 완료 3개, 완료율 50%의 집계 결과를 정확하게 도출했습니다.

터미널에서 환경 설정을 확인하고 자연어로 개선을 요청한 뒤, 자동 생성된 테스트를 통과하고 최종 텍스트/JSON 결과를 확인하기까지의 전 과정을 간결하게 수행할 수 있습니다.

2. Build Web Apps 플러그인을 활용한 3D 뷰어 객체 검색 및 분리 보기

두 번째 팁은 Build Web Apps 플러그인을 사용해 웹 기반 3D 뷰어에 객체 검색과 시점 포커싱 기능을 추가하는 워크플로우입니다.

• 키워드 기반 객체 분리(Isolation View): 뷰어 상단 검색창에 Laptop을 검색한 뒤 목록에서 해당 항목을 선택하면, 전체 133개 메시 중에서 노트북에 속한 40개 메시만 화면에 분리하여 렌더링합니다.
• 카메라 자동 정렬: 선택된 대상 오브젝트의 위치와 크기에 맞추어 3D 카메라 앵글과 줌 레벨이 자동으로 조정됩니다.
• 초기 상태 복원(Restore all): 화면 상단의 Restore all 버튼을 클릭하면 분리되었던 나머지 부품을 포함한 전체 133개 메시가 다시 표시되며, 3D 카메라 역시 원래의 뷰포트 상태로 즉시 복귀합니다.

브라우저 상에서 검색부터 특정 객체 분리 보기, 그리고 원상태 복원까지 이어지는 상호작용 흐름을 플러그인 지원을 통해 신속하게 구축할 수 있습니다.

원문 출처

• Globejam X (@Globejamyo): OpenAI DevDay Side Quest - Codex CLI Setup & Plugins 데모
• 플러그인 저장소: Build Web Apps Plugins Repository