【免费下载链接】banana-claude
AI image generation skill for Claude Code - Creative Director powered by Gemini
banana-claude 是一款面向 Claude Code 的AI 图像生成技能,让 Claude 化身"创意总监(Creative Director)",调用 Google Gemini Nano Banana 模型完成文生图、图片编辑与多轮创作。本文带你完整掌握 banana-claude 的 9 大核心命令:/banana generate、/banana edit、/banana chat等,从环境配置到成本控制,一篇全部讲清楚。
9 大命令速查表
banana-claude 的所有能力都通过/banana前缀命令触发,一张表先看全貌:
| 命令 | 作用 | 适用场景 |
|---|---|---|
/banana | 交互式模式 | 不确定用什么,让 Claude 引导你 |
/banana generate <idea> | 文生图 | 从零创建一张图 |
/banana edit <path> <instructions> | 智能修图 | 改已有图片(去背景、加文字等) |
/banana chat | 多轮视觉会话 | 保持角色/风格一致性的迭代创作 |
/banana inspire [category] | 浏览提示词库 | 找灵感、看 2500+ 精选提示词 |
/banana batch <idea> [N] | 批量变体 | 一次生成 N 个方案(默认 3 个) |
/banana setup | 环境配置 | 安装 MCP 服务器、配置 API Key |
/banana preset [子命令] | 品牌预设管理 | 保存并复用品牌色、风格设定 |
/banana cost [子命令] | 成本追踪 | 查看花费、预估批量生成成本 |
完整命令定义位于 skills/banana/SKILL.md。
第一步:/banana setup —— 一键完成环境配置
新手装好 banana-claude 后,建议先运行:
/banana setup它会自动完成三件事:
- 安装并配置
@ycse/nanobanana-mcpMCP 服务器; - 写入你的 Google AI API Key(需在 Google AI Studio 免费申请);
- 设置默认模型
gemini-3.1-flash-image-preview。
底层由 skills/banana/scripts/setup_mcp.py 脚本执行,运行后可用python3 skills/banana/scripts/validate_setup.py验证安装是否成功。配置完成后,其他 8 个命令才能正常工作。
/banana generate —— 文生图核心命令
/banana generate "a hero image for a coffee shop website"这是 banana-claude 最核心的命令,走的是完整的"创意总监流水线":
分析意图 → 检查品牌预设 → 选择领域模式 → 构造 5 组件提示词 → 选择模型与比例 → 生成 → 后期处理
关键设计是:你的原始描述不会被直接丢给 API。Claude 会先追问用途(博客头图?App 图标?电商产品图?),然后按 Google 官方的 5 组件公式(Subject → Action → Location/Context → Composition → Style)重构出一条带相机型号、镜头参数、光线细节的专业提示词。提示词工程规则详见 skills/banana/references/prompt-engineering.md。
生成时还会自动匹配 14 种宽高比(1:1、16:9、9:16、21:9 等)和分辨率档位(512 / 1K / 2K / 4K),默认 2K。如果 MCP 不可用,会自动回退到直连 API 的 skills/banana/scripts/generate.py 脚本。
/banana edit —— 智能图片编辑
/banana edit ~/photo.png "remove the background"和普通的"抠图工具"不同,/banana edit也会先改写你的编辑指令。你说"去掉背景",Claude 实际发出的是"完全移除背景,替换为干净的透明或纯白底色,保留发丝边缘细节"这样的专业指令,效果自然得多。
常见的智能编辑场景:
- "remove background" → 边缘保留式去背景
- "make it warmer" → 指定色温偏移 + 细节保护说明
- "add text" → 附带字体风格、位置、对比度说明
- "extend it" → 风格一致的扩图(Outpainting)
同样支持 MCP 直连 API 回退(skills/banana/scripts/edit.py),生成透明 PNG 时还会走绿幕处理流水线。
/banana chat —— 多轮视觉创作会话
/banana chat这是 banana-claude 的一大特色:会话内角色与风格保持一致。适合:
- 角色设计图(同一角色的多张姿态图)
- 连续叙事插图(连环画分镜)
- 逐步精修(先生成概念图,再一轮轮微调)
Claude 内部调用gemini_chat工具维持上下文,你只需给出"具体、聚焦"的修改要求,而不必每轮重描一遍画面。
/banana inspire —— 2500+ 提示词灵感库
/banana inspire /banana inspire fashion-editorial不知道写什么提示词?/banana inspire可以浏览 2500+ 条精选提示词数据库,支持按 19 个分类(时尚、科幻、Logo 图标等)筛选、随机抽取灵感。注意:库中提示词多为 Midjourney/DALL-E 风格,banana-claude 会自动把参数式写法转译为 Gemini 偏好的自然语言段落,并补上相机、镜头等摄影规格。
/banana batch —— 批量生成 N 个变体
/banana batch "cyberpunk city poster" 3一次生成 N 个变体(默认 3 个),策略不是随机抽卡,而是每次轮换一个组件:变体 1 换光线(黄金时刻 → 蓝调时刻)、变体 2 换构图(特写 → 远景)、变体 3 换风格(写实 → 插画),最后附简短说明让你直观对比。
需要大规模生产时,可用 CSV 驱动的批量工作流,由 skills/banana/scripts/batch.py 解析并预估成本;走 Batch API 还能享 50% 成本折扣。
/banana preset —— 品牌预设管理
/bbanana preset list /banana preset show mybrand /banana preset create mybrand --colors "#FF6B35,#004E89" --style "minimal" /banana preset delete oldstyle做品牌内容最烦的是每次重复描述品牌色和风格。/banana preset把品牌色板、风格关键词保存为预设(存储于~/.banana/presets/),之后生成图片时 Claude 会自动加载作为默认值——你的临时指令优先级更高,随时可覆盖。底层由 skills/banana/scripts/presets.py 管理,模式说明见 skills/banana/references/presets.md。
/banana cost —— 成本追踪与预估
/banana cost summary # 查看总花费 /banana cost today # 查看今日花费 /banana cost estimate # 预估批量生成成本每成功生成一张图,banana-claude 都会自动记账(模型 + 分辨率 + 摘要),数据存在本地~/.banana/costs.json。价格档位一目了然:2K 约 $0.078/张,4K 约 $0.156/张(以 skills/banana/references/cost-tracking.md 为准)。批量生成前先跑estimate,心里有数再动手。
领域模式:命令背后的"专业技能视角"
上述每条生成类命令都会自动匹配 9 种领域模式,为提示词注入对应专业的细节:
| 模式 | 擅长领域 |
|---|---|
| Cinema | 戏剧感场景、叙事氛围 |
| Product | 电商产品图、包装图 |
| Portrait | 人物、角色头像 |
| Editorial | 时尚、杂志大片 |
| UI/Web | 图标、App 插图 |
| Logo | 品牌标识、视觉识别 |
| Landscape | 环境背景、壁纸 |
| Infographic | 数据图表、信息图 |
| Abstract | 生成艺术、纹理图案 |
提示词构造由子代理 agents/brief-constructor.md 专职执行,它只输出一条可直接发给 Gemini 的成品提示词,不碰生图环节。
常见问题速答
Q:命令报 MCP 未配置?运行/banana setup重新配置即可。
Q:提示词被安全审查拦截(IMAGE_SAFETY)?banana-claude 会给出 2~3 条改写建议,经你确认后重试,不会擅自自动重发。
Q:被限流(HTTP 429)?免费额度约 5~15 次/分钟,等待 60 秒后自动指数退避重试。
Q:想要 4K 高清图?指定 4K 分辨率,模型自动路由到gemini-3.1-flash-image-preview,参数见 skills/banana/references/gemini-models.md。
总结:新手的最短上手路径
- 装插件:通过 Claude Code 插件市场安装 banana-claude,或参考 install.sh 独立安装;
- 配环境:
/banana setup; - 出第一张图:
/banana generate "你的想法"; - 不满意就聊:
/banana chat多轮精修; - 规模化产出:
/banana batch+/banana preset+/banana cost三件套兜底。
掌握这 9 条命令,你就拥有了一个会在终端里给你"当艺术指导"的 AI 图像工作台 🎨
【免费下载链接】banana-claude
AI image generation skill for Claude Code - Creative Director powered by Gemini
相关推荐
Ender命令完整清单:add、build、compile、refresh等8大命令实战指南
Ender命令完整清单:add、build、compile、refresh等8大命令实战指南 Ender(ender)是面向浏览器的 JavaScript 包管
开发工具终极Trunk命令大全:掌握build、serve、watch等核心CLI操作的完整指南
终极Trunk命令大全:掌握build、serve、watch等核心CLI操作的完整指南 Trunk是一款强大的Rust WASM应用构建工具,能够帮助开发者轻
开发工具Safari AV1 兼容怎么做?LiveKit 三步自动回退 H.264 实践指南
Safari AV1 兼容怎么做?LiveKit 三步自动回退 H.264 实践指南 做实时音视频时,Chrome 端一切正常,Safari 用户却黑屏、卡顿或
后端音视频即时通讯AI Agent
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考