banana-claude是一款为 Claude Code 打造的 AI 绘图技能（Skill），让 Claude 扮演"创意总监"，调用 Google Gemini 图像模型帮你生成专业级图片。你只需说"给我的咖啡店网站做一张主视觉图"，它就会自动理解意图、选择领域模式、构造专业提示词并生成成图。本文带你 5 分钟完成安装，并生成第一张专业图片。

一、为什么选 banana-claude？

它不是简单的 API 封装，而是一套完整的 AI 绘图工作流：

• 意图分析：先弄清你真正要什么——博客头图？产品图？Logo？
• 领域模式：自动选择 Cinema、Product、Portrait、Logo 等 9 种专业视角
• 5 组件提示词公式：主体 + 动作 + 场景 + 构图 + 风格（含灯光）
• 批量变体：一次生成 N 个版本，方便挑选
• 成本追踪：自动记录每次生成的花费

核心编排逻辑见 skills/banana/SKILL.md，想深入了解可直接阅读源码。

二、安装前快速检查

• ✅ Claude Code（Anthropic 官方命令行工具）
• ✅ Node.js 18+
• ✅ 一个免费的 Google AI API Key（在 Google AI Studio 申请）
• ⭕ ImageMagick（可选，用于裁剪/去背景等后期处理）

三、5分钟安装 banana-claude

方法一：插件方式（推荐）

在 Claude Code 中执行两条命令即可：

/plugin marketplace add AgriciDaniel/banana-claude /plugin install banana-claude@banana-claude-marketplace

方法二：独立安装（standalone）

git clone --depth 1 https://gitcode.com/gh_mirrors/ba/banana-claude bash banana-claude/install.sh --with-mcp YOUR_API_KEY

安装脚本 install.sh 会自动完成三件事：

1. 把技能复制到~/.claude/skills/banana/
2. 用你的 API Key 配置 MCP 图像服务
3. 运行 validate_setup.py 验证环境

四、生成你的第一张专业图片

重启 Claude Code 后，输入：

/banana generate "a hero image for a coffee shop website"

Claude 会先问你几个问题（品牌、风格偏好、用途），然后自动完成：选领域模式 → 写详细提示词 → 设宽高比 → 生成图片。整个过程如下动图所示：

想编辑已有图片也很简单：

/bbanana edit ~/photo.png "remove the background"

💡 忘了上面写错了，正确写法是/banana edit ~/photo.png "remove the background"。

五、"创意总监"工作流：一张图看懂

banana-claude 的核心理念：永远不把你的原话直接丢给图像模型。它走一条完整的流水线——

从 Request（请求）到 Analysis（意图分析）、Domain（领域模式）、Brief（推理简报）、Ratio（宽高比）、Generate（生成）、Post-Process（后期），每一步都经过专业加工，这就是成图质量稳定的关键。

六、9 大领域模式：为不同场景换"专业镜头"

七、5 组件提示词公式：专业感的秘密

以"太空中的猫"为例，banana-claude 不会直接发送这 4 个词，而是构造出包含相机型号、镜头焦段、灯光描述、《国家地理》风格的完整描述。公式来自 prompt-engineering.md：

Subject（主体）→ Action（动作）→ Context（场景）→ Composition（构图）→ Style（风格+灯光）

八、常用命令速查表 🎯

九、费用与免费额度 💰

• 免费额度：每项目约 5–15 次请求/分钟
• 单张成本参考：1K 约 $0.039，4K 约 $0.156（详见 cost-tracking.md）
• 默认模型为gemini-3.1-flash-image-preview，支持 14 种宽高比、最高 4096×4096 输出（规格见 gemini-models.md）
• 用/banana cost estimate可以在批量生成前先估算花费

写在最后

从 clone 到生成第一张图，全程不超过 5 分钟。banana-claude 把"提示词工程"这件专业事交给了 Claude，你只负责描述想法。现在打开 Claude Code，试试/banana generate吧！🍌

📌 相关资源：技能入口 skills/banana/SKILL.md ｜ 提示词规范 skills/banana/references/prompt-engineering.md ｜ 成本追踪 skills/banana/scripts/cost_tracker.py ｜ 更新日志 CHANGELOG.md