본문으로 건너뛰기

© 2026 Molayo

Zenn헤드라인2026. 06. 18. 21:27

Claude Code × Gemini로 구문 메이커를 양산하는 개발 플로우 (아저씨 말투 메이커 편)

요약

Claude Code와 Gemini를 활용하여 동일한 구조의 AI 도구를 빠르게 양산하는 개발 워크플로우를 소개합니다. 템플릿화된 구성과 Diff 기반의 코드 생성을 통해 개발 효율을 극대화하는 방법을 다룹니다.

핵심 포인트

  • 기존 코드를 기준으로 Claude Code에 Diff 기반 의뢰를 하여 개발 속도 향상
  • 도구별 API 키 관리 전략(전용 키 및 Fallback 구조) 설계의 중요성
  • 프롬프트의 형태를 정의하여 동일 프레임워크로 서비스 수평 전개 가능

서론

입력 문장을 이모티콘이 가득한 “아저씨 말투(おじさん構文)”로 변환하는 아저씨 말투 메이커를 만들었습니다.

다만, 이 기사에서 공유하고 싶은 것은 「아저씨 말투 메이커 단독 제작 방법」이 아닙니다. 코이즈미 구문 메이커 → 타고사쿠 구문 메이커 → 아저씨 말투 메이커로, 동일한 형태의 AI 도구를 Claude Code × Gemini로 어떻게 “양산”하고 있는가라는 개발 플로우입니다.

자기소개

호네구미(ホネグミ) 대표이자, 응용정보기술자 자격을 가진 엔지니어 × 마케터입니다. 회사 임원을 4년, 독립하여 4년째입니다. 프리랜서로서 소재 중심의 AI 도구를 양산하며, 사상 주도형 서비스 개발을 계속하고 있습니다. 「개인이 AI로 작은 도구를 양산하는」 입장에서의 기록으로 읽어주시면 감사하겠습니다.

양산을 뒷받침하는 「템플릿화된 구성」

3가지 구문 메이커는 모두 동일한 구성을 공유하고 있습니다.

WordPress 고정 페이지 (Custom HTML: 00_code.html)
↓ fetch()
/wp-admin/admin-ajax.php
...

새로운 구문 메이커를 추가할 때 바꾸는 것은 기본적으로 다음 3가지만입니다.

바꾸는 부분바꾸지 않는 부분
프롬프트 (구문의 형태)admin-ajax.php를 경유하는 API 프록시 구성
...

「매번 제로 베이스에서 만들지 않는 것」이 양산의 가장 큰 비결입니다.

Claude Code에 전달할 “차이점(Diff)”을 만드는 방법

실제 제작에서는 기존의 00_code.htmlfunction.php를 기준으로 삼아, Claude Code에게 「타고사쿠와 동일한 구성으로, 아저씨 말투 버전을 만들어줘」라고 차이점(diff) 기반으로 의뢰합니다.

이를 통해 Claude Code는 기존의 성공 패턴(명명 규칙, AJAX action 명, 카운터 등록)을 계승하면서, 프롬프트와 UI만 교체한 코드를 생성할 수 있습니다. 인간이 하는 일은 구문의 형태를 정의하고 최종 확인을 하는 것입니다.

도구별 「API 키 전략」을 설계에 포함시키기

양산 시 은근히 중요한 것이 API 키를 나누는 방식입니다. Gemini API의 무료 할당량은 GCP 프로젝트 단위이므로, 도구가 늘어날수록 할당량 충돌이 발생합니다.

그래서 액세스량 예상치에 따라 키 전략을 바꾸고 있습니다.

  • 이용이 적은 도구 (예: 타고사쿠) → 기존 키를 공유
  • 성장 가능성이 있는 도구 (예: 아저씨 말투) → 전용 GCP 프로젝트 + 전용 키 GEMINI_API_KEY_OJISAN

코드는 「전용 키 우선 · 없으면 공통 키로 폴백(Fallback)」 방식으로 작성해 두면, 어떤 전략에서도 동일한 구현으로 운영할 수 있습니다.

$api_key = defined('GEMINI_API_KEY_OJISAN') && GEMINI_API_KEY_OJISAN
? GEMINI_API_KEY_OJISAN
: (defined('GEMINI_API_KEY') ? GEMINI_API_KEY : '');

「양산한다」고 결정한 순간부터, 키 설계는 아키텍처의 일부가 됩니다.

프롬프트는 「의미를 유지하며 겉모습만 바꾸기」

아저씨 말투 메이커는 답변을 생성하는 것이 아니라, **입력 문장의 의미를 유지한 채 겉모습을 아저씨 말투로 만드는 “변환형”**으로 만들었습니다.

원래 문장의 의미는 유지하면서, 다음 특징을 추가:
- 이모티콘·카오모지(顔文字)를 여러 개
- 어미나 일부를 가타카나로 (〜네, 〜요)
...

Temperature(온도)는 0.9로 설정하여 매번 다른 출력이 나오게 하고, 출력 토큰은 LINE 메시지 한 통 분량으로 제한합니다. 구문의 「형태」를 언어화할 수 있다면, 다른 구문 메이커에도 동일한 프레임워크로 수평 전개가 가능합니다.

공개 후의 SEO/LLMO 정형 루틴

양산 시 놓치기 쉬운 것이 공개 후의 동선 정비입니다. 호네구미에서는 새로운 도구마다 반드시 「3종 세트」를 실행합니다.

  • 구문 메이커 종합 가이드 (허브 페이지)에 1개 블록을 추가하여 내부 링크 연결
  • 신규 도구 페이지에 FAQ 구조화 데이터 (FAQPage JSON-LD) 추가
  • llms.txt에 한 줄 추가하여 LLM으로부터의 참조 경로 확보

도구를 만들 때마다 이 3가지를 실행함으로써, 각 구문 메이커가 서로 링크되는 토픽 클러스터(Topic Cluster)가 성장합니다.

요약

아저씨 말투 메이커는 단독으로는 작은 소재용 도구입니다. 하지만 Claude Code × Gemini를 사용하면, 이러한 도구들은 「템플릿화된 구성 + 차이점 프롬프트 + 키 전략 + 공개 루틴」의 세트로 양산할 수 있습니다.

개인 개발에서 AI 도구를 지속적으로 늘리고 싶다면, 하나를 정성 들여 만들기보다 2번째 이후를 빠르게 만들 수 있는 "형태(型)"를 먼저 갖추는 것이 더 효과적입니다.

서비스는 이쪽

면책 사항

본 도구는 엔터테인먼트 및 패러디 목적의 도구입니다. 생성되는 내용은 허구이며, 실존 인물이나 단체에 대한 비방이나 괴롭힘(Harassment)을 목적으로 하지 않습니다.

Discussion

AI 자동 생성 콘텐츠

본 콘텐츠는 Zenn AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
0

댓글

0