Claude Code 能写代码、写文字,也能看图,但它不会画图。想让它出图,就得给它接一个图片模型。大多数人选的是 Nano Banana,也就是 Google 的 Gemini 图片模型:Claude Code 通过 MCP 服务器或 skill 调用它,由它们用你自己的 Key 把提示词发给 Gemini API。本文介绍这两种配置方法、每张图的费用、一个让很多此类工具目前直接用不了的模型问题,以及一条完全不需要 Key 的路线。
简单来说:如果你想直接拿到成品图,又不想折腾 API Key,就用 Orkas 里的 ImageStudio。它是一个内置图片模型的图片智能体,新账号可获得 500 免费积分。如果你就是想用 Nano Banana,把你的 Gemini Key 添加到 Orkas,ImageStudio 就会用 Nano Banana 2.1 出图。如果想在 Claude Code 里直接调用 Nano Banana,就添加一个 Nano Banana MCP 服务器,但模型要自己指定:截至 2026 年 11 月 8 日,几个热门服务器默认使用的模型 ID 都已被 Google 停用。
Claude Code 能生成图片吗?
单靠它自己不能。Anthropic 帮助中心写明,Claude 不会像图片生成工具那样生成照片或插画。它能写 SVG、HTML 和图表代码,做图标、示意图、简单的横幅和图表已经够用。照片、插画、产品图和绘画风格的图片,则需要图片模型。OpenAI 的 Codex 内置了图片生成,用的是 gpt-image-2;Claude Code 没有类似的功能。
Claude Code 能做的是读取图片文件。图片模型把图存进你的项目后,Claude 可以打开它,对照你的要求检查,再改写提示词。正因为有这个循环,大家才会把两者搭配着用:Claude 负责规划和检查,图片模型负责画。
Anthropic 的插件市场里没有官方的 Nano Banana 插件。大家一般用下面三种方式之一来接入,它们都要用你在 Google AI Studio 创建的 Key 调用 Google 的 Gemini API:
- MCP 服务器:给 Claude Code 增加一个新工具,任务需要图片时它就能调用。
- skill:一个装有说明、有时还带脚本的文件夹。当你的请求和图片有关,或者你点名调用它时,Claude Code 会加载它。
- Google 为 Gemini CLI 推出的 nanobanana 扩展:给 Gemini CLI 增加图片相关的命令。Claude Code 的 skill 可以替你运行它。
免配置:Orkas 里的 ImageStudio
我们建议从 ImageStudio 开始,它是 Orkas 内置的图片智能体。把需求说明、照片、logo 和要用的原文交给它,再描述你想要的效果。它能做社交媒体配图、商品图、封面、海报、信息图、图表和插画。标题、价格和标签都用真实字体排版,所以文字和你写的一字不差。要修改照片,就告诉它改哪里,比如背景或光线,它只改那一部分。需要生成新像素时,它会调用内置的 Seedream 5.5 模型,输出 13–23 积分/张;输入 5 积分/张。调整尺寸、裁剪、放置文字这类排版工作不会调用图片模型。
如果你更想用 Nano Banana,就在 Orkas 里添加 Gemini Key:打开设置,选择模型,再依次选择图片和添加图片服务,选中 Google · Nano Banana 2.1 并粘贴 Key。新添加的 Key 会排在列表最前面,所以 ImageStudio 会用现行模型 Nano Banana 2.1 来生成。这些图片由 Google 计费,Orkas 不会为此扣积分。如果 Google 的请求失败,ImageStudio 可以回退到内置模型,这部分会消耗积分。
- 安装 Orkas 并登录。新账号可获得 500 免费积分,用于内置模型,所以没有 API Key 也能开始。
- 选择 ImageStudio,添加你的照片和 logo。
- 描述你要的效果:尺寸或发布平台、要用的原文、哪些地方必须保持不变,以及想要的文件格式。
- 检查图片,提出有针对性的修改,比如把标题放大或换个背景。默认每次请求只生成一张新图,只有你提出要求,它才会再做一张。
你拿到的是保存在自己电脑上的 PNG、JPG、WEBP、AVIF 或 TIFF 文件。ImageStudio 不能生成带图层的 PSD 文件或矢量文件。
试试这条需求
添加你的产品照片和 logo,替换方括号里的内容,然后把下面这段发给 ImageStudio:
为[我们的春季促销]做一张 [1080×1350] 的 [Instagram] 帖子图。
用[我的产品照片]做主图,产品必须和原图完全一致。
背景用[柔和的米色影棚],自然光。
标题原样使用:“[春季促销——8 折]”。
把[我的 logo]放在右下角。
交付 PNG 文件。图片出来后,可以提具体的修改,例如:“把标题放大,把 logo 移到右上角。”ImageStudio 只改这一部分,其余保持不变。
Nano Banana 各模型及价格
Nano Banana 是 Google 对 Gemini 图片生成能力的叫法。下面是 Gemini API 里的各个模型,以及 Google 公布的付费层级单张标价:
| 模型 | 模型 ID | 单张价格 | 说明 |
|---|---|---|---|
| Nano Banana 2.1 | gemini-nano-banana-2.1 | 1K $0.0336,2K $0.0504,4K $0.113 | 最新模型,2026 年 10 月 6 日起正式可用。建议从它开始。 |
| Nano Banana 2 Lite | gemini-3.1-flash-lite-image | $0.0336,仅支持 1K | 最快、最便宜。不适合多张参考图或分步编辑。 |
| Nano Banana Pro | gemini-3-pro-image | 1K 或 2K $0.134,4K $0.24 | 适合复杂场景;会先推理再作画。 |
| Nano Banana 2 | gemini-3.1-flash-image | 1K $0.067,2K $0.101,4K $0.151 | 已弃用;Google 建议新项目改用 2.1。 |
| Nano Banana | gemini-2.5-flash-image | $0.039 | 初代模型。Google 将于 2027 年 3 月 15 日停用。 |
有三点很容易踩坑:
- 图片生成没有免费层级。要用 API Key 生成图片,必须绑定结算账号,并预充值至少 $5。Google Cloud 的 $300 免费试用额度不包含 Gemini API。
- 预览版(preview)模型 ID 已经失效。Google 已于 2026 年 1 月 15 日停用 gemini-2.5-flash-image-preview,并于 2026 年 6 月 25 日停用 gemini-3.1-flash-image-preview 和 gemini-3-pro-image-preview。还在调用其中任何一个的工具,都会调用失败。
- 每张图都带有不可见的 SynthID 水印。上表所有模型都是如此。
价格和 ID 来自 Google 的定价页面和图片生成指南,截至 2026 年 11 月 8 日。
Nano Banana MCP 服务器与 skill 对比
下面是搭配 Claude Code 时最常见的几个项目。它们都免费开源,图片费用付给 Google。安装前先确认模型:
| 项目 | 类型 | 默认模型 | 需要改什么 |
|---|---|---|---|
| nanobanana-mcp-server | MCP 服务器,用 uv 运行 | 已停用的 Nano Banana 2 preview ID | 把 NANOBANANA_MODEL 设为 flash,即使用初代 Nano Banana |
| nanobanana 扩展 | Google 为 Gemini CLI 推出的扩展 | 已停用的 Nano Banana 2 preview ID | 把 NANOBANANA_MODEL 设为 gemini-nano-banana-2.1 |
| cc-nano-banana | 运行上面那个扩展的 Claude Code skill | 沿用扩展的默认值 | 和扩展一样的设置 |
| Nano-Banana-MCP | MCP 服务器,用 npx 运行 | 写死在代码里的 Nano Banana preview ID | 没有可改的设置;项目更新之前先别用 |
以上是我们在 2026 年 11 月 8 日查看各项目代码的结果。安装任何项目前,请先读它的 README:它会在你的电脑上运行代码,并把你的提示词和图片发送给 Google。
如何通过 MCP 服务器把 Nano Banana 接入 Claude Code
- 创建 Gemini API Key:在 Google AI Studio 中创建,然后绑定结算账号并预充值。
- 安装 uv,它会替你下载并运行这个服务器。
- 添加服务器,在终端中运行:
claude mcp add --env GEMINI_API_KEY=your-key --env NANOBANANA_MODEL=flash --transport stdio nanobanana -- uvx nanobanana-mcp-server@latest。--transport stdio要紧挨在名称前面,否则 Claude Code 会把名称当成另一个变量。 - 确认已连接:启动 Claude Code,输入
/mcp。 - 把出图写进任务里,例如:“给这个落地页做一张 16:9 的首屏主图,保存到 public/images,然后打开看看,告诉我哪里需要改。”
如果没有设置 IMAGE_OUTPUT_DIR,服务器会把图片存到你主目录下的 nanobanana-images 文件夹。上面的命令默认只为你自己、在当前项目中添加这个服务器。加上 --scope user 就能在所有项目中使用。不要用 project 作用域添加:那样会把 Key 写进 .mcp.json 文件,而这个文件你可能会提交到仓库。
flash 设置对应的是初代 Nano Banana,它是这个服务器模型列表里唯一一个 Google 仍在提供的模型,而 Google 将于 2027 年 3 月 15 日停用它。Nano Banana 2.1 的支持目前还在一个尚未发布的 pull request 里。现在就想用 2.1,可以走下面的扩展路线,或者在 ImageStudio 里使用你的 Gemini Key。
改用 skill
skill 能把你的出图规则集中放在一处,比如常用的尺寸和你偏好的提示词结构。最有名的 cc-nano-banana 是借助 Google 的 Gemini CLI 扩展来工作的:
- 安装 Gemini CLI 和扩展:先运行
npm install -g @google/gemini-cli,再运行gemini extensions install https://github.com/gemini-cli-extensions/nanobanana。 - 设置两个变量,写进你的 shell 配置文件:
NANOBANANA_API_KEY填你的 Gemini Key,再加上NANOBANANA_MODEL=gemini-nano-banana-2.1。 - 添加 skill:
git clone https://github.com/kkoppenhaver/cc-nano-banana ~/.claude/skills/nano-banana - 直接让 Claude Code 出图,或者用
/nano-banana点名调用这个 skill。
先读一下它的 SKILL.md。它会让 Claude 带着 --yolo 参数运行 Gemini CLI,这个参数会不经询问地批准 Gemini CLI 的每一个操作。另外,有用户反映扩展拿不到 shell 里设置的 Key。如果你自己写 skill,就把模型 ID 写进去,Key 放在环境变量里,不要写进 skill 文件。
在 Orkas 中运行 Claude Code
Orkas 和你现有的配置并不是二选一。
- 你的 MCP 服务器和 skill 照常可用。在侧边栏选择接入智能体,再选 Claude Code。Orkas 会运行你电脑上安装的那份 Claude Code,用的是你自己的登录。它把自己的工具加在你的 MCP 服务器旁边,而不是替换它们,所以你配置好的 Nano Banana 服务器和 skill 依然会加载。
- 让每个智能体各司其职。让 Claude Code 搭页面或应用,让 ImageStudio 做它需要的图片。ImageStudio 会把文件保存在你的电脑上,Claude Code 就能把它们放进你的项目。
该选哪条路线?
| 你的目标 | 从这里开始 | 你会得到什么 |
|---|---|---|
| 免配置做出文字准确的社交媒体帖子图、商品图或海报 | Orkas 里的 ImageStudio | PNG、JPG、WEBP、AVIF 或 TIFF 文件;内置模型,起步送 500 免费积分 |
| 不写脚本、不碰配置文件就用上 Nano Banana 2.1 | 在 ImageStudio 中使用你的 Gemini Key | Nano Banana 生成的图片;由 Google 计费,不扣 Orkas 积分 |
| 写代码时顺手出图,不用离开 Claude Code | Nano Banana MCP 服务器,并指定好模型 | 图片保存在你的电脑上;Google 按张计费 |
| 按你自己的规则、可重复使用的出图流程 | Nano Banana skill | 一个由你自己安装、阅读和更新的 skill |
| 图标、示意图和图表 | 单用 Claude Code | SVG 或图表代码;不需要图片模型 |
常见问题
Claude Code 自己能生成图片吗?
不能。Anthropic 表示,Claude 不会像图片生成工具那样生成照片或插画。Claude Code 能写 SVG、HTML 和图表代码,也能打开图片文件进行检查,所以很适合和 Nano Banana 这类图片模型搭配使用。
在 Claude Code 里用 Nano Banana 免费吗?
不免费。Gemini API 的图片模型没有免费层级:你需要绑定结算账号并预充值至少 $5,而 Google Cloud 的 $300 免费试用也不包含它。Nano Banana 2.1 每张 1K 图片 $0.0336。Orkas 里的 ImageStudio 有内置模型,新账号可获得 500 免费积分。
该用哪个 Nano Banana 模型?
先用最新的 Nano Banana 2.1(gemini-nano-banana-2.1)。想要最便宜的 1K 图片就用 Nano Banana 2 Lite,复杂场景用 Nano Banana Pro。避开所有以 -preview 结尾的模型 ID,Google 已经把它们停用了。
为什么我的 Nano Banana MCP 服务器返回 404 错误?
最可能的原因是它在调用一个已被 Google 停用的模型。Google 已于 2026 年 1 月 15 日关闭 gemini-2.5-flash-image-preview,并于 2026 年 6 月 25 日关闭 gemini-3.1-flash-image-preview 和 gemini-3-pro-image-preview。如果服务器有模型设置,就改成现行模型;如果没有,就换一个可以自选模型的工具。
在 Orkas 里出图需要 Gemini API Key 吗?
不需要。ImageStudio 使用内置的 Seedream 5.5 模型,新账号可获得 500 免费积分。如果你添加了自己的 Gemini Key,ImageStudio 会改用 Nano Banana 2.1,这些图片由 Google 计费。
想在 Photoshop 里继续加工图片,请参阅如何在 Photoshop 中使用 Claude。想找更多灵感,可以看看用 ImageStudio 能做些什么。想用自己的照片试试,下载 Orkas,从 ImageStudio 开始。