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.
- Install Orkas and sign in. New accounts get 500 free credits for the built-in models, so you can start without an API key.
- Choose ImageStudio and add your photos and logo.
- Describe the result: the size or platform, the exact text, what must stay unchanged and the file type you want.
- 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.
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:
| Model | Model ID | Price per image | Notes |
|---|---|---|---|
| Nano Banana 2.1 | gemini-nano-banana-2.1 | $0.0336 at 1K, $0.0504 at 2K, $0.113 at 4K | The newest model, generally available since October 6, 2026. Start here. |
| Nano Banana 2 Lite | gemini-3.1-flash-lite-image | $0.0336, 1K only | The fastest and cheapest. Not made for several reference images or step-by-step edits. |
| Nano Banana Pro | gemini-3-pro-image | $0.134 at 1K or 2K, $0.24 at 4K | For complex scenes; it reasons before it draws. |
| Nano Banana 2 | gemini-3.1-flash-image | $0.067 at 1K, $0.101 at 2K, $0.151 at 4K | Deprecated; Google recommends 2.1 for new projects. |
| Nano Banana | gemini-2.5-flash-image | $0.039 | The 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:
| Project | What it is | Default model | What to change |
|---|---|---|---|
| nanobanana-mcp-server | MCP server, runs with uv | A Nano Banana 2 preview ID that has been shut down | Set NANOBANANA_MODEL to flash, which uses the original Nano Banana |
| nanobanana extension | Google's extension for Gemini CLI | A Nano Banana 2 preview ID that has been shut down | Set NANOBANANA_MODEL to gemini-nano-banana-2.1 |
| cc-nano-banana | Claude Code skill that runs the extension above | The extension's default | The same setting as the extension |
| Nano-Banana-MCP | MCP server, runs with npx | A Nano Banana preview ID, written into the code | No 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
- Create a Gemini API key in Google AI Studio, then link billing and add prepaid credit.
- Install uv, which downloads and runs the server for you.
- 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 stdioright before the name; otherwise Claude Code reads the name as another variable. - Check that it connected: start Claude Code and type
/mcp. - 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:
- Install Gemini CLI and the extension:
npm install -g @google/gemini-cli, thengemini extensions install https://github.com/gemini-cli-extensions/nanobanana. - Set two variables in your shell profile:
NANOBANANA_API_KEYwith your Gemini key, andNANOBANANA_MODEL=gemini-nano-banana-2.1. - Add the skill:
git clone https://github.com/kkoppenhaver/cc-nano-banana ~/.claude/skills/nano-banana - 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 goal | Start with | What you get |
|---|---|---|
| Social posts, product images or posters with exact text, without setup | ImageStudio in Orkas | PNG, JPG, WEBP, AVIF or TIFF files; built-in model, 500 free credits to start |
| Nano Banana 2.1 without scripts or config files | ImageStudio with your Gemini key | Nano Banana images; Google bills you, no Orkas credits |
| Images while you code, without leaving Claude Code | A Nano Banana MCP server, with the model set | Images saved on your computer; Google bills each image |
| A repeatable image workflow with your own rules | A Nano Banana skill | A skill you install, read and update yourself |
| Icons, diagrams and charts | Claude Code on its own | SVG 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.