gatekit을 빨리 써보고 싶었다. 그런데 나는 Codex를 쓴다
2026.10.01

소개
시도하고자 했던 것과 그 이유를 알려주세요.
스터디장님이 준비해 주신 gatekit이 매력적이었습니다. AI와 프로젝트를 진행할 때 무작정 코드를 만들기보다, 먼저 생각을 정리하고 완료 기준을 세운 뒤 만들고 검증하는 흐름이 마음에 들었습니다. 설명을 들으며 “이건 빨리 내 프로젝트에도 적용해 보고 싶다”는 생각이 들었습니다.
그런데 한 가지 문제가 있었습니다. 저는 Claude가 아니라 Codex 앱(CLI 아님)을 주로 쓰고 있었어요. 스터디장님이 주신 매뉴얼에도 Codex에 관한 언급은 있었지만, Claude Code용 스킬과 플러그인을 제 작업 환경에서 어떻게 사용해야 하는지 선뜻 이해되지 않았습니다.
그때 진여진님이 채팅창에 프롬프트를 공유해 주셨습니다. 제가 원하는 사용 방식과 확인해야 할 순서를 Codex에 구체적으로 전달할 수 있는 스크립트였어요. 수업이 끝나고 나서 그 프롬프트를 실행해 보기로 했습니다.
진행 방법
어떤 도구를 사용했고, 어떻게 활용하셨나요?
Tip: 사용한 프롬프트 전문을 꼭 포함하고, 내용을 짧게 소개해 주세요.
Tip: 활용 이미지나 캡처 화면을 꼭 남겨주세요.
Tip: 코드 전문은 코드블록에 감싸서 작성해주세요. ( / 을 눌러 '코드 블록'을 선택)
수업이 끝난 뒤, 프롬프트부터 넣었습니다
처음에는 프롬프트를 넣으면 금방 해결될 거라고 생각했습니다. 하지만 대화를 시작하니 제가 모르는 말이 많았습니다. 플러그인, 스킬, 자동 검사, 프로젝트 설정 파일…. 설명을 읽어도 “그래서 내가 새 프로젝트를 시작할 때 정확히 뭘 하면 되지?”라는 질문이 계속 남았습니다.
Codex와 이야기를 주고받으며 원하는 방향을 조금씩 분명히 했습니다. 플러그인을 설치하는 대신, gatekit에 필요한 파일을 하나의 시작 폴더에 모으자. 새 프로젝트를 시작할 때 그 폴더 전체를 복사하고 이름을 바꿔 쓰자. Mac과 Codex 앱에 맞춰 작업하자.
솔직히 이 설명을 듣고도 바로 이해한 건 아닙니다. 그래도 Codex가 먼저 저장소를 살펴보고 바꿀 것과 지울 것을 알려준 다음, 작업을 나눠 진행하는 것을 지켜봤습니다. 제가 한 일은 중간중간 “이 방식이면 새 프로젝트에서는 어떻게 시작하나요?”처럼 이해되지 않는 부분을 계속 물어보는 것이었습니다.
실제로 입력한 프롬프트
아래는 진여진님이 공유해 주신 프롬프트를 처음 전달한 내용입니다. 이후 대화에서 구현 담당을 Sol 6으로 바꾸고, Windows는 이번 작업 범위에서 제외했습니다.
https://github.com/LovelyPaul/gatekit
저는 터미널(검은 명령어 창)을 쓰지 않고, Claude 데스크톱 앱이나 VS Code 같은 편집기에서 Claude Code 혹은 codex cli & codex app 을 사용하고 있어요
이 저장소는 "플러그인"으로 만들어져 있어서, 설치하려면 명령어를 직접 입력해야 해요.
저 같은 사람은 권한 문제 등으로 이 설치 과정이 어렵습니다.
■ 원하는 결과
- 플러그인을 설치하지 않아도 됩니다.
- 이 폴더를 Claude 앱에서 열기만 하면 gatekit 기능(자동 검사, 명령 목록, 안내 문서)이 바로 동작해야 해요.
- 다른 프로젝트에서도 쓸 수 있도록, 필요한 파일이 한 폴더에 모여 있어서 그 폴더만 복사하면 되면 좋겠어요.
- Windows와 Mac 둘 다에서 문제없이 동작해야 해요.
- Claude Code 전용으로 쓸 거라서, 다른 AI 코딩 도구(예: Codex)를 위한 설정과 파일은 정리해 주세요.
■ 진행 순서 (이 순서대로 해 주세요)
1. 먼저 살펴보기만 하세요
- 파일은 아직 바꾸지 마세요.
- 저장소 구조, 플러그인 설정 파일(plugin.json, marketplace.json), 자동 검사 설정(hooks), 필요한 프로그램(예: Python)을 확인해 주세요.
2. 계획을 쉬운 말로 보여 주세요
- 무엇을 옮기고, 무엇을 고치고, 무엇을 지우는지 목록으로 보여 주세요.
- 제가 확인한 다음에 시작해 주세요.
3. 플러그인 방식에서 "폴더를 열면 바로 쓰는 방식"으로 옮겨 주세요
- 플러그인에서만 통하던 경로 표기와 명령 이름이 새 방식에서도 제대로 동작하는지 확인해 주세요.
4. 운영체제 차이를 처리해 주세요
- Windows와 Mac은 Python을 부르는 이름이 다를 수 있어요(python3, python, py).
- 어느 컴퓨터에서든 자동 검사가 조용히 꺼지지 않게 해 주세요.
5. 다른 AI 코딩 도구용 설정과 파일을 정리해 주세요
- 지우기 전에 목록을 먼저 보여 주세요.
6. 제대로 되는지 직접 확인해 주세요
- 저장소에 들어 있는 테스트를 실행해 주세요.
- 실제로 앱에서 명령과 자동 검사가 동작하는지 확인해 주세요.
- 실패한 게 있으면 숨기지 말고 그대로 알려 주세요.
7. 마지막으로 사용 안내를 써 주세요
- 명령어를 모르는 사람도 따라 할 수 있는 짧은 설명서로 부탁해요.
- 넣을 내용: 폴더 여는 법, 처음 할 일, 쓸 수 있는 명령 목록, 문제가 생겼을 때 확인할 것
■ 지켜 주세요
- 이 저장소의 규칙 문서(CLAUDE.md, docs/ARCHITECTURE.md)를 먼저 읽고 따라 주세요.
- 새 프로그램이나 추가 설치가 필요한 방식은 쓰지 말아 주세요.
- 파일을 지우거나 크게 바꾸기 전에는 꼭 먼저 알려 주세요.
- 작업은 의미 있는 단위로 나눠서 저장(커밋)하고, 원격 저장소에 올리는 건 제가 말할 때만 해 주세요.
- 설명은 한국어로, 전문 용어는 최대한 쉽게 풀어서 해 주세요.
- 작업은 sonnet 5 & terra 5.6 에이전트에게 위임해주세요
- 프로젝트 자체에서 작업할 예정이니 상황에 맞게 셋팅해주세요
- 제가 사용하는 코딩 에이전트를 파악하고 적절한 AI 도구 전용의 셋팅과 코드도 사용하지 정리해주세요
- 자동 검사 (hooks) 는 프로젝트 폴더에서만 (.claude/settings.json) 적용할 수 있도록 해주세요
- ${CLAUDE_PLUGIN_ROOT} 경로는 프로젝트에 맞게 수정해주세요
- Python 이나 다른 패키지도 파악해주고 깔끔하게 업데이트 해주세요폴더를 복사해 첫 프로젝트를 열었습니다
작업 후에는 gatekit-starter라는 시작 폴더가 생겼습니다. 이 폴더 전체를 복사해 프로젝트 이름으로 바꾸고, Codex에서 그 폴더를 열어 사용하는 방식입니다. 평소 사용할 때 플러그인 설치 명령을 칠 필요가 없다는 점이 저에게는 가장 큰 변화였습니다.
여기서 또 한 번 헷갈렸습니다. 폴더를 열어보니 Markdown 파일 세 개만 보여서 “파일이 빠진 건가?” 싶었거든요. 알고 보니 실제 기능에 필요한 파일은 이름이 점으로 시작하는 숨김 폴더 안에 있었습니다. Finder에서 ⌘⇧.을 누르니 보였습니다. 안에 보이는 파일만 골라 복사하면 안 되고, 시작 폴더 자체를 통째로 복사해야 한다는 것도 이때 배웠습니다.
숨김을 풀어야 비로소 보이던 파일들
결과와 배운 점
일단 성공했습니다. 새 프로젝트의 주제는 실험실 관리 페이지입니다. 지금은 discover를 사용해 질문을 주고받으며 어떤 문제를 풀어야 할지 찾아가는 중입니다.
해보니 제가 생각보다 명확하게 정하지 못한 부분이 많았습니다. 처음에는 “실험실 관리 페이지를 만들고 싶다” 정도였는데, 질문을 받으면서 제가 실제로 필요한 것이 무엇인지 다시 생각하게 됐어요. 저도 제 생각을 더 잘 이해하고, Codex도 제가 원하는 방향을 조금씩 더 잘 이해하는 느낌입니다. 바로 화면이나 코드를 만들기 시작했으면 지나쳤을 부분입니다.
모호한 한 줄의 니즈로 시작해서,

조금 명확해지고 있습니다 (아직은 컨셉 UI뿐입니다.)

이번 과정에서 배운 저만의 팁은 두 가지입니다.
모르는 용어는 그냥 넘기지 않기. 저는 “폴더를 복사해 쓴다”는 말도 처음에는 이해하지 못했습니다. 새 프로젝트에서 제가 실제로 할 행동을 다시 물어보니 그제야 감이 왔습니다.
unverified를 성공으로 읽지 않기. 복사한 폴더에서 명령과 검사 스크립트가 동작하는 것은 확인했지만, 실제 Codex 앱의 모든 자동 검사가 발화하는지는 별도로 확인해야 합니다.
코드 검사도 모두 통과했다고 말할 수는 없습니다. 전체 테스트에서 작업 중지와 관련된 실패가 한 건 있었고, 변경 전에도 재현된 문제라고 보고받았습니다. 그래서 이번 결과는 **“새 폴더 방식으로 시작하고 discover를 써보기까지 성공했다”**고 적는 것이 정확할 것 같습니다.
앞으로는 discover에서 나온 이야기를 바탕으로 실험실 관리 페이지에 필요한 사람, 상황, 기능을 더 구체화하려고 합니다. 아직 질문이 많습니다. 그래도 처음의 막막함은 조금 줄었습니다. 밤은 기니 계속해 봐야겠습니다.
스터디에서 쓸 gatekit을 준비해 주신 스터디장님, Codex에서 시작할 수 있도록 프롬프트를 나눠주신 진여진님께 감사드립니다.
도움 받은 글 (옵션)
스터디장님이 제공해 주신 gatekit 매뉴얼
진여진님이 공유해 주신 프롬프트
로그인하고 댓글을 남겨 주세요




뽀도리님, 글 잘 읽었어요. "Claude Code용 플러그인을 Codex 앱에서 어떻게 쓰지?"라는 막막함에서 출발해, 플러그인 설치 대신 시작 폴더를 통째로 복사해 쓰는 방식으로 정리하신 흐름이 인상적이에요.
특히 unverified를 성공으로 읽지 않기라는 팁과, 전체 테스트의 실패 1건이 변경 전에도 재현된 문제라고 그대로 적어주신 부분이 좋았어요. "새 폴더 방식으로 시작하고 discover를 써보기까지 성공"이라고 범위를 정확히 잡으신 덕분에, 이 글을 보고 따라 하는 분들이 어디까지 확인된 건지 바로 알 수 있어요. 숨김 폴더가 ⌘⇧.으로 보인다는 기록도 같은 길에서 막힐 분들께 큰 도움이 될 것 같아요.
"실험실 관리 페이지"가 discover 질문을 거치며 어떻게 구체화되는지 후속 이야기도 기다릴게요. 꼬리 탁! 치고 응원하고 갈게요 🐈⬛