Orkas Orkas
Home Blog Claude Code + Nano Banana
Product

How to Generate Images in Claude Code with Nano Banana

Claude Code can't draw on its own, but it can call an image model. Here's how to connect Google's Nano Banana with an MCP server or a skill, what each image costs, and how to get images in Orkas without a Gemini key.

Claude Code writes code and text, and it can look at images, but it can't draw them. To get pictures out of it, you connect an image model. Nano Banana, Google's Gemini image model, is the one most people choose: Claude Code reaches it through an MCP server or a skill that sends your prompt to the Gemini API with your own key. This guide covers both setups, what each image costs, a model problem that breaks many of these tools today, and a route that needs no key at all.

The short answer: if you want finished images without setting up API keys, use ImageStudio in Orkas. It is an image agent with a built-in image model, and new accounts get 500 free credits. If you specifically want Nano Banana, add your Gemini key to Orkas and ImageStudio uses Nano Banana 2.1. To call Nano Banana from inside Claude Code, add a Nano Banana MCP server, but set the model yourself: as of November 8, 2026, the popular servers default to model IDs that Google has shut down.

Can Claude Code generate images?

Not by itself. Anthropic's help center says Claude doesn't generate photos or illustrations the way image-generation tools do. It can write SVG, HTML and chart code, which is enough for icons, diagrams, simple banners and charts. Photos, illustrations, product shots and painted styles need an image model. OpenAI's Codex has image generation built in, with gpt-image-2; Claude Code has nothing similar.

What Claude Code can do is read image files. After an image model saves a picture to your project, Claude can open it, compare it with what you asked for and rewrite the prompt. That loop is why people pair the two: Claude plans and checks, and the image model draws.

There is no official Nano Banana plugin in Anthropic's plugin marketplace. People connect it in one of three ways, and all of them call Google's Gemini API with a key you create in Google AI Studio:

  • An MCP server gives Claude Code a new tool that it can call whenever a task needs a picture.
  • A skill is a folder with instructions and sometimes a script. Claude Code loads it when your request is about images, or when you call it by name.
  • Google's nanobanana extension for Gemini CLI adds image commands to Gemini CLI. A Claude Code skill can run it for you.

No setup: ImageStudio in Orkas

We recommend starting with ImageStudio, the image agent built into Orkas. Give it your brief, photos, logo and the exact text, and describe the result you want. It makes social graphics, product images, covers, posters, infographics, charts and illustrations. Headlines, prices and labels are set as real type, so the text comes out exactly as you wrote it. To edit a photo, tell it what to change, such as the background or the lighting, and it changes only that part. When a picture needs new pixels, it uses the built-in Seedream 5.5 model, at 13–23 credits / output image + 5 / input image. Layout work such as resizing, cropping and placing text doesn't call an image model.

If you prefer Nano Banana, add your Gemini key in Orkas: open Settings, choose Models, then Image and Add image service, pick Google · Nano Banana 2.1 and paste the key. The new key goes to the top of the list, so ImageStudio generates with Nano Banana 2.1, the current model. Google bills those images, and Orkas doesn't charge credits for them. If a Google request fails, ImageStudio can fall back to the built-in model, which uses credits.

  1. Install Orkas and sign in. New accounts get 500 free credits for the built-in models, so you can start without an API key.
  2. Choose ImageStudio and add your photos and logo.
  3. Describe the result: the size or platform, the exact text, what must stay unchanged and the file type you want.
  4. Review the image and ask for focused changes, such as a larger headline or a different background. By default it generates one new image per request, and it makes another only when you ask.

You get PNG, JPG, WEBP, AVIF or TIFF files saved on your computer. ImageStudio doesn't make layered PSD or vector files.

Make it with ImageStudio Get finished images without setting up an MCP server. Orkas is free on macOS and Windows. New accounts get 500 credits for the built-in models, or you can add your own Gemini key.
Download Orkas — free

A request to try

Add your product photo and logo, replace the brackets and send this to ImageStudio:

Make a [1080×1350] post for [Instagram] for [our spring sale].
Use [my product photo] as the main image and keep the product exactly as it is.
Put it on a [soft beige studio] background with natural light.
Set this headline exactly: "[Spring sale — 20% off]".
Place [my logo] in the bottom right corner.
Deliver a PNG.

When the image is ready, ask for specific changes, for example: "Make the headline larger and move the logo to the top right." ImageStudio changes that part and keeps the rest.

Nano Banana models and what they cost

Nano Banana is the name Google uses for Gemini's image generation. These are the models in the Gemini API, with Google's list prices per image on the paid tier:

ModelModel IDPrice per imageNotes
Nano Banana 2.1gemini-nano-banana-2.1$0.0336 at 1K, $0.0504 at 2K, $0.113 at 4KThe newest model, generally available since October 6, 2026. Start here.
Nano Banana 2 Litegemini-3.1-flash-lite-image$0.0336, 1K onlyThe fastest and cheapest. Not made for several reference images or step-by-step edits.
Nano Banana Progemini-3-pro-image$0.134 at 1K or 2K, $0.24 at 4KFor complex scenes; it reasons before it draws.
Nano Banana 2gemini-3.1-flash-image$0.067 at 1K, $0.101 at 2K, $0.151 at 4KDeprecated; Google recommends 2.1 for new projects.
Nano Bananagemini-2.5-flash-image$0.039The original model. Google shuts it down on March 15, 2027.

Three things catch people out:

  • There is no free tier for images. To create images with an API key, you link a billing account and prepay at least $5. Google's $300 Cloud free trial doesn't cover the Gemini API.
  • The preview model IDs no longer work. Google shut down gemini-2.5-flash-image-preview on January 15, 2026, and gemini-3.1-flash-image-preview and gemini-3-pro-image-preview on June 25, 2026. A tool that still calls one of them fails.
  • Every image carries an invisible SynthID watermark. This applies to all the models above.

Prices and IDs are from Google's pricing page and image generation guide, as of November 8, 2026.

Nano Banana MCP servers and skills compared

These are the projects that come up most for Claude Code. All are free and open source; you pay Google for the images. Check the model before you install:

ProjectWhat it isDefault modelWhat to change
nanobanana-mcp-serverMCP server, runs with uvA Nano Banana 2 preview ID that has been shut downSet NANOBANANA_MODEL to flash, which uses the original Nano Banana
nanobanana extensionGoogle's extension for Gemini CLIA Nano Banana 2 preview ID that has been shut downSet NANOBANANA_MODEL to gemini-nano-banana-2.1
cc-nano-bananaClaude Code skill that runs the extension aboveThe extension's defaultThe same setting as the extension
Nano-Banana-MCPMCP server, runs with npxA Nano Banana preview ID, written into the codeNo setting for it; skip it until the project is updated

We checked each project's code on November 8, 2026. Read the README before you install a project: it runs code on your computer and sends your prompts and images to Google.

How to add Nano Banana to Claude Code with an MCP server

  1. Create a Gemini API key in Google AI Studio, then link billing and add prepaid credit.
  2. Install uv, which downloads and runs the server for you.
  3. Add the server in your terminal: claude mcp add --env GEMINI_API_KEY=your-key --env NANOBANANA_MODEL=flash --transport stdio nanobanana -- uvx nanobanana-mcp-server@latest. Keep --transport stdio right before the name; otherwise Claude Code reads the name as another variable.
  4. Check that it connected: start Claude Code and type /mcp.
  5. Ask for an image as part of the task, for example: "Make a 16:9 hero image for this landing page, save it in public/images, then open it and tell me what to fix."

The server saves images in a nanobanana-images folder in your home folder unless you set IMAGE_OUTPUT_DIR. By default, the command above adds the server only for you, in the current project. Add --scope user to use it in every project. Don't add it with the project scope: that writes the key into a .mcp.json file that you might commit.

The flash setting uses the original Nano Banana, the only model in this server's list that Google still serves, and Google shuts it down on March 15, 2027. Nano Banana 2.1 is in a pull request that hasn't been released. To use 2.1 today, use the extension route below, or ImageStudio with your Gemini key.

Use a skill instead

A skill keeps your image rules in one place, such as the sizes you use and the prompt structure you like. The best-known one, cc-nano-banana, works through Google's Gemini CLI extension:

  1. Install Gemini CLI and the extension: npm install -g @google/gemini-cli, then gemini extensions install https://github.com/gemini-cli-extensions/nanobanana.
  2. Set two variables in your shell profile: NANOBANANA_API_KEY with your Gemini key, and NANOBANANA_MODEL=gemini-nano-banana-2.1.
  3. Add the skill: git clone https://github.com/kkoppenhaver/cc-nano-banana ~/.claude/skills/nano-banana
  4. Ask Claude Code for an image, or call the skill by name with /nano-banana.

Read its SKILL.md first. It tells Claude to run Gemini CLI with the --yolo flag, which approves every Gemini CLI action without asking. Some users also report that the extension doesn't receive the key from the shell. If you write your own skill, put the model ID in it and keep the key in an environment variable, not in the skill file.

Run Claude Code from Orkas

You don't have to choose between Orkas and the setup you already have.

  • Your MCP servers and skills keep working. In the sidebar, choose Connect agents and pick Claude Code. Orkas runs the copy installed on your computer with your sign-in. It adds its own tools next to your MCP servers instead of replacing them, so the Nano Banana server and skills you set up still load.
  • Let each agent do its part. Ask Claude Code to build the page or the app, and ask ImageStudio for the images it needs. ImageStudio saves the files on your computer, so Claude Code can put them into your project.

Which route should you choose?

Your goalStart withWhat you get
Social posts, product images or posters with exact text, without setupImageStudio in OrkasPNG, JPG, WEBP, AVIF or TIFF files; built-in model, 500 free credits to start
Nano Banana 2.1 without scripts or config filesImageStudio with your Gemini keyNano Banana images; Google bills you, no Orkas credits
Images while you code, without leaving Claude CodeA Nano Banana MCP server, with the model setImages saved on your computer; Google bills each image
A repeatable image workflow with your own rulesA Nano Banana skillA skill you install, read and update yourself
Icons, diagrams and chartsClaude Code on its ownSVG or chart code; no image model needed

Questions

Can Claude Code generate images by itself?

No. Anthropic says Claude doesn't generate photos or illustrations the way image-generation tools do. Claude Code can write SVG, HTML and chart code, and it can open image files to check them, so it works well with an image model such as Nano Banana.

Is Nano Banana free to use in Claude Code?

No. The Gemini API has no free tier for its image models: you link billing and prepay at least $5, and Google's $300 Cloud free trial doesn't cover it. Nano Banana 2.1 costs $0.0336 per 1K image. ImageStudio in Orkas has a built-in model, and new accounts get 500 free credits.

Which Nano Banana model should I use?

Start with Nano Banana 2.1 (gemini-nano-banana-2.1), the newest model. Use Nano Banana 2 Lite for the cheapest 1K images, and Nano Banana Pro for complex scenes. Avoid any model ID that ends in -preview; Google has shut those down.

Why does my Nano Banana MCP server return a 404 error?

It is most likely calling a model that Google has shut down. Google turned off gemini-2.5-flash-image-preview on January 15, 2026, and gemini-3.1-flash-image-preview and gemini-3-pro-image-preview on June 25, 2026. Set the server to a current model if it has a setting for it, or switch to a tool that lets you choose the model.

Do I need a Gemini API key to make images in Orkas?

No. ImageStudio uses the built-in Seedream 5.5 model, and new accounts get 500 free credits. If you add your own Gemini key, ImageStudio uses Nano Banana 2.1 instead, and Google bills those images.

To keep working on the image in Photoshop, see How to Use Claude with Photoshop. For more ideas, see what you can make with ImageStudio. To try it with your own photos, download Orkas and start with ImageStudio.