AgriciDaniel/banana-claude

Banana Claude – Google Gemini 이미지 생성을 위한 Claude 측 플러그인

무엇인가요 – 자연어 요청을 입력하면 시스템이 계획, 검토, 그리고 명시적인 승인 후 Google의 Gemini 이미지 모델(Nano Banana 2 Lite / 2 / Pro)을 호출하여 이미지를 생성하는 Claude Code 플러그인입니다. 유료 요청을 전송하기 전에 완전한 프롬프트, 모델 선택, 데이터 설정, 비용 추정을 모두 확인할 수 있습니다.

작동 방식

1. 요청 – 예: /banana-claude:banana generate an urban 16:9 GitHub hero with clean left‑side copy space 와 같이 일반 텍스트로 설명합니다.
2. 계획 – 플러그인은 "비주얼 브리프"를 생성하고, Gemini 모델을 선택하며, 비용 추정을 준비합니다.
3. 검토 – 정확한 프롬프트, 참조 이미지, 개인정보 보호 플래그, 예상 비용을 확인합니다.
4. 승인 – 한 번만 승인하는 토큰으로 Gemini API에 대한 단일 요청이 허가됩니다.
5. 생성 – 이미지가 생성되며, 개인정보를 고려한 메타데이터 사이드카가 함께 저장됩니다.
6. 확인 – 결과를 검토하고, 필요 시 편집, 재생성, 배포할 수 있습니다.

주요 기능

• 생성 – 캠페인 그래픽, 제품 장면, 다이어그램, 소셜 미디어 이미지 등 모든 비주얼 자산 생성 가능.
• 편집 – 생성된 이미지에 단일 변경만으로도 정체성, 기하학적 구조, 브랜드 세부 정보를 유지한 채 편집 가능.
• 계속 작업 – 저장된 "Flash" 또는 "Pro" 세션을 사용하거나, 마지막 이미지를 새 참조로 재사용 가능.
• 비교 – 단일 제한된 포트폴리오 내에서 최대 3개의 프롬프트를 3개의 모델 경로로 비교 가능.
• 검토 – 승인 전에 콘텐츠, 자르기, 구성, 아티팩트, 저작권, 출처를 검토 가능.
• 타이포그래피 – 정확한 텍스트 배치가 필요한 경우, 로컬로 추가한 텍스트, 폰트, 로고를 타이포그래피 처리 가능.

안전성 및 제어 내장

• 이미지 생성에는 비용이 들기 때문에 플러그인은 초기 상태에서 비활성 상태로 설치됩니다.
• API 키는 명령어, URL, CI 로그에 노출되지 않으며, Claude의 개인 설정에 보관됩니다.
• 모든 유료 호출은 완전한 계획을 표시하고 사용자 명시적 승인이 필요합니다.
• 한 번의 승인 = 한 번의 제공자 시도; 계획을 변경하면 새로운 승인이 필요합니다.
• 비용 기록은 개인 정보이며, 기본적으로 원본 프롬프트는 제외됩니다.
• 생성된 이미지는 자동으로 본격적 사용 대상으로 표시되지 않으며, 사용자가 검토해야 합니다.

설치 (Claude Code)

/plugin marketplace add AgriciDaniel/banana-claude
/plugin install banana-claude@banana-claude-marketplace
/plugin enable banana-claude@banana-claude-marketplace
/reload-plugins

사전 조건: Claude Code 2.1.199+, Python 3.11+, 비용이 부과되는 Google AI 프로젝트 및 Gemini API 키가 필요.

일반적인 사용 사례

• 랜딩 페이지나 소셜 게시물용 빠른 히어로 이미지가 필요한 마케팅 팀.
• AI로 생성된 초안을 편집하고 반복 작업할 수 있는 디자이너.
• 예산을 투자하기 전에 다양한 시각적 개념을 비교하고 싶은 콘텐츠 크리에이터.
• 제어되고 비용이 투명한 방식으로 맞춤형 그래픽을 제작하고 싶은 소규모 기업.

제한 사항 / 주의사항

• 기반 모델인 Gemini는 확률적 특성을 가지므로, 철자, 기하학, 정책 준수 여부에서 결과가 달라질 수 있습니다.
• 저작권 정리 또는 최종 청구서 정확성에 대한 보장은 없습니다. 이는 사용자의 책임입니다.
• 유료 Google Gemini API 키가 필요하며, 플러그인 자체는 무료 크레딧을 제공하지 않습니다.
• 플러그인은 Claude Code 내에서만 작동하며, 독립형 CLI나 웹 앱이 아닙니다.

문서 및 지원

• 사용자 가이드, 프롬프트 작성 팁, MCP 도구 참조, 보안 노트, 변경 내역, 업그레이드 가이드는 모두 리포지토리(docs/, skills/banana/)에 있습니다.
• 기여는 일반적인 풀 리퀘스트 프로세스로 환영합니다. 이슈는 키나 개인 미디어를 노출하지 않고 제출하세요.

라이선스 – MIT (see LICENSE).

---

개발자: Agrici Daniel, AI 워크플로우 아키텍트 – 더 많은 정보는 블로그, AI Marketing Hub, YouTube 채널을 참고하세요.