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 と plain text で記述。
2. 計画 – プラグインが「ビジュアル概要」を構築し、Gemini モデルを選定し、コスト見積もりを準備します。
3. レビュー – 完全なプロンプト、参照画像、プライバシー設定、見積もり金額を確認できます。
4. 承認 – 1回限りの承認トークンで、Gemini API への1回のリクエストが許可されます。
5. 生成 – 画像が生成され、メタデータのサイドカー（プライバシー配慮型）が併せて保存されます。
6. 確認 – 結果を確認し、必要に応じて編集・再生成・出荷できます。

主な機能

• 生成 – キャンペーン用グラフィック、製品シーン、図解、SNS用画像など、あらゆるビジュアル資産を生成可能。
• 編集 – 生成された画像に対して1回の変更でアイデンティティ、幾何学的構造、ブランド詳細を保持したまま編集可能。
• 継続 – 保存された「Flash」または「Pro」セッションを使って作業を継続、または最後の画像を新規リファレンスとして再利用可能。
• 比較 – 1つの制限付きポートフォリオ内で、最大3つのプロンプトを3つのモデル経路で比較可能。
• レビュー – 承認前に、コピー、トリミング、構図、アーティファクト、著作権、出典を確認可能。
• タイプセット – 精確なテキスト配置が必要な場合、ローカルで追加したコピー、フォント、ロゴをタイプセット可能。

安全と制御を内蔵

• 画像生成には費用がかかるため、プラグインは初期状態で 無効 になっています。
• API キーはコマンド、URL、CI ログに表示されません。Claude のプライベート設定に保持されます。
• すべての有料呼び出しは、完全な計画を提示し、ユーザーの明示的承認が必要です。
• 1回の承認 = 1回のプロバイダー試行。計画を変更すると、新たな承認が必要です。
• コスト記録はプライベートであり、デフォルトでは元のプロンプトは非表示です。
• 生成された画像は自動的に本番用としてマークされません。ユーザーが確認する必要があります。

インストール（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 キー付き）。

一般的な利用シーン

• ランディングページやSNS投稿用の迅速なヒーロー画像が必要なマーケティングチーム。
• AI 生成の最初のドラフトを編集・反復可能にしたいデザイナー。
• バジェットを投入する前に、異なるビジュアルコンセプトを並べて比較したいコンテンツクリエイター。
• コントロールされ、コストが可視化された方法でカスタムグラフィックを生成したい中小企業。

制限事項 / 注意点

• 基盤となる Gemini モデルは確率的であるため、スペル、幾何学、ポリシー準拠性において結果が異なる可能性があります。
• 著作権のクリアランスや最終請求書の正確性について保証はできません。これらはユーザーの責任です。
• 有料の Google Gemini API キーが必要です。プラグイン自体は無料クレジットを提供しません。
• プラグインは Claude Code 内でのみ動作します。スタンドアロン CLI や Web アプリではありません。

ドキュメントとサポート

• ユーザーガイド、プロンプト作成のコツ、MCP ツールリファレンス、セキュリティノート、変更履歴、アップグレードガイドはすべてリポジトリ内（docs/, skills/banana/）にあります。
• コントリビューションは通常のプルリクエストプロセスで歓迎します。問題報告は、キーまたはプライベートメディアを露出せずに実行してください。

ライセンス – MIT（LICENSE を参照）。

---

開発者：Agrici Daniel、AIワークフロー・アーキテクト – 詳細は彼のブログ、AI Marketing Hub、YouTubeチャンネルをご覧ください。