[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [Nano Banana 2.1](https://spiral.ai/integrations/claude-code/nano-banana-2-1)

# How to Use Nano Banana 2.1 in Claude Code

Nano Banana 2.1 creates product scenes, illustrated explainers, and posters you can refine through follow-up edits. Compared with Nano Banana 2, Google reports better visual design, subject consistency, and more natural-looking images.

|  |  |
| --- | --- |
| Model | Nano Banana 2.1 |
| Available through | Gemini, Vertex AI |
| Category | Image |
| Price | $0.0437 per 1K image ($0.0655 at 2K, $0.147 at 4K). Prompt: $1.95 per 1M tokens. Reasoning: $9.75 per 1M tokens. Google Search: $0.0182 per query. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Nano Banana 2.1 in Claude Code

- Read the homepage copy and design tokens, then use Nano Banana 2.1 to create a 2K landscape illustration for our gardening app. Show a balcony herb garden in a cut-paper style, using the project's palette and leaving the left third open for the page headline.
- Use Nano Banana 2.1 with the ceramic mug photo in our assets directory. Create a 2K square product scene on a wooden breakfast table; preserve the handle, glaze, and proportions, and add no text.
- Read the three onboarding steps in the project and use Nano Banana 2.1 to create one 2K illustrated overview. Use only the exact labels "Choose a plant", "Set a reminder", and "Watch it grow", with a clear reading order.
- Use Nano Banana 2.1 to revise our existing garden illustration. Change the background from midday to early evening while preserving the plants, containers, framing, and illustration style; return a 2K image.
- Use Nano Banana 2.1 with our mascot reference to create a 1K square illustration of the mascot watering a seedling. Call the mascot Robin, retain its red scarf and round glasses, and leave the background plain for the empty-state screen.

## How to set up Nano Banana 2.1 in Claude Code

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the hosted server**: This adds Spiral to the current project. Add `--scope user` to use it in every project.

```bash
claude mcp add --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `claude`, type `/mcp`, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

### Use the Spiral skill

1. **Send Claude Code this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Nano Banana 2.1**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "gemini",
    "model": "gemini-nano-banana-2.1",
    "input": {
      "contents": [
        {}
      ]
    }
  }'
```

Then paste one of the prompts above: Claude Code finds Nano Banana 2.1 on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/claude-code

## Nano Banana 2.1 tools and prices

- [Nano Banana 2.1](https://spiral.ai/tools/gemini/gemini-nano-banana-2.1) (Gemini): $0.0437 per 1K image ($0.0655 at 2K, $0.147 at 4K). Prompt: $1.95 per 1M tokens. Reasoning: $9.75 per 1M tokens. Google Search: $0.0182 per query.
- [Nano Banana 2.1](https://spiral.ai/tools/vertex/gemini-nano-banana-2.1) (Vertex AI): $0.0437 per 1K image ($0.0655 at 2K, $0.147 at 4K). Prompt: $1.95 per 1M tokens ($0.195 cached). Reasoning: $9.75 per 1M tokens. Google Search: $0.0182 per query.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| tools |  | — | Grounding with Google Search, the only tool this model takes (web and image search). Set generationConfig.responseModalities to ["TEXT", "IMAGE"]. Every search query the model runs is billed. |
| generationConfig |  | — | Configuration options for model generation and outputs. |
| systemInstruction |  | — | Developer set [system instruction(s)](https://ai.google.dev/gemini-api/docs/system-instructions). |

## What can you do with Nano Banana 2.1 in Claude Code?

Create website illustrations and product imagery from the project's design brief with Nano Banana 2.1. Use follow-up edits to refine the selected image before placing it in the interface.

### Product photos in new settings

Give Nano Banana 2.1 a product reference and request a kitchen counter, workshop, or outdoor setting. Specify which packaging details, colors, and proportions must stay the same.

### Posters with short headlines

Create event or campaign artwork with Nano Banana 2.1 using an exact quoted headline. Keep supporting copy brief and inspect the lettering before publishing.

### Illustrated explainers

Turn an approved explanation into a labeled diagram with Nano Banana 2.1. Supply the labels and relationships, then check that the picture matches them.

### Recurring characters

Use named character references with Nano Banana 2.1 to illustrate a sequence of scenes. Request one scene at a time and review clothing, facial features, and accessories between images.

### Localized campaign artwork

Ask Nano Banana 2.1 to revise an existing design with approved Spanish, French, Japanese, or other supported wording. Specify the text placement and visual details to preserve.

### Targeted image revisions

Refine an existing image with Nano Banana 2.1 through specific follow-up requests. Change the background, lighting, or a subject detail, and state what should remain intact.

### Website illustrations

Create editorial and product illustrations with Nano Banana 2.1 for landing pages or articles. Describe the placement, composition, and space needed for surrounding page text.

### Coordinated campaign images

Use the same reference artwork and visual brief with Nano Banana 2.1 across a product launch. Request each image separately while retaining the palette, subject, and illustration style.

## Overview

- [Google Gemini](https://spiral.ai/providers/gemini)
- [All Claude Code guides](https://spiral.ai/integrations/claude-code)

## Nano Banana 2.1 in other agents

- [Amp](https://spiral.ai/integrations/amp/nano-banana-2-1)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/nano-banana-2-1)
- [Claude](https://spiral.ai/integrations/claude-desktop/nano-banana-2-1)
- [Cline](https://spiral.ai/integrations/cline/nano-banana-2-1)
- [Codex](https://spiral.ai/integrations/codex/nano-banana-2-1)
- [Cursor](https://spiral.ai/integrations/cursor/nano-banana-2-1)
- [Devin](https://spiral.ai/integrations/devin/nano-banana-2-1)
- [dots](https://spiral.ai/integrations/dots/nano-banana-2-1)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/nano-banana-2-1)
- [Gemini](https://spiral.ai/integrations/gemini/nano-banana-2-1)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/nano-banana-2-1)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/nano-banana-2-1)
- [goose](https://spiral.ai/integrations/goose/nano-banana-2-1)
- [Grok](https://spiral.ai/integrations/grok/nano-banana-2-1)
- [Grok Build](https://spiral.ai/integrations/grok-build/nano-banana-2-1)
- [Hermes](https://spiral.ai/integrations/hermes/nano-banana-2-1)
- [Instinct](https://spiral.ai/integrations/instinct/nano-banana-2-1)
- [Manus](https://spiral.ai/integrations/manus/nano-banana-2-1)
- [Muse](https://spiral.ai/integrations/muse/nano-banana-2-1)
- [Muse Code](https://spiral.ai/integrations/muse-code/nano-banana-2-1)
- [n8n](https://spiral.ai/integrations/n8n/nano-banana-2-1)
- [Notion](https://spiral.ai/integrations/notion/nano-banana-2-1)
- [OpenClaw](https://spiral.ai/integrations/openclaw/nano-banana-2-1)
- [opencode](https://spiral.ai/integrations/opencode/nano-banana-2-1)
- [Perplexity](https://spiral.ai/integrations/perplexity/nano-banana-2-1)
- [Raycast](https://spiral.ai/integrations/raycast/nano-banana-2-1)
- [VS Code](https://spiral.ai/integrations/vscode/nano-banana-2-1)
- [Windsurf](https://spiral.ai/integrations/windsurf/nano-banana-2-1)
- [Zapier](https://spiral.ai/integrations/zapier/nano-banana-2-1)

## More Claude Code guides

- [Nano Banana 2 Text to Image fal](https://spiral.ai/integrations/claude-code/nano-banana-2-text-to-image-fal)
- [Nano Banana 2.1 Edit](https://spiral.ai/integrations/claude-code/nano-banana-2-1-edit)
- [Nano Banana 2 Text to Image](https://spiral.ai/integrations/claude-code/nano-banana-2-text-to-image)
- [Nano Banana 2.1 Text to Image](https://spiral.ai/integrations/claude-code/nano-banana-2-1-text-to-image)
- [Nano Banana 2 Lite](https://spiral.ai/integrations/claude-code/nano-banana-2-lite)
- [Nano Banana Edit](https://spiral.ai/integrations/claude-code/nano-banana-edit)

## Questions about Nano Banana 2.1 in Claude Code

**Can Claude Code use Nano Banana 2.1?**

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Nano Banana 2.1 like any built-in tool.

**How much does Nano Banana 2.1 cost in Claude Code?**

$0.0437 per 1K image ($0.0655 at 2K, $0.147 at 4K). Prompt: $1.95 per 1M tokens. Reasoning: $9.75 per 1M tokens. Google Search: $0.0182 per query. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.

**Do I need a Gemini account to use Nano Banana 2.1 in Claude Code?**

No. Spiral runs Nano Banana 2.1 on its own Gemini account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Nano Banana 2.1 in Claude Code?**

About two minutes: add the hosted server, then sign in.

**Which provider runs Nano Banana 2.1?**

Spiral offers Nano Banana 2.1 through Gemini and Vertex AI. Name one in your prompt, or let Claude Code pick.

**Does Claude Code wait while Nano Banana 2.1 runs?**

Nano Banana 2.1 runs in the background. Claude Code starts the run, checks on it and gives you the image when it's ready.

**What is Nano Banana 2.1 good at?**

Use it for product scenes, posters with short headlines, illustrated diagrams, and images you want to refine through follow-up edits. Google reports improvements in visual design and subject consistency over previous Nano Banana models.

**What resolutions can Nano Banana 2.1 generate?**

Nano Banana 2.1 supports 1K, 2K, and 4K output. Start with 1K to judge the composition, then try 2K or 4K for the selected design.

**Can Nano Banana 2.1 combine reference images?**

Yes, it supports up to 14 reference images. Give each important character or object a distinct name and specify what to preserve from each reference.

**How should I prompt Nano Banana 2.1 for text in an image?**

Put the exact wording in quotation marks and describe where it should appear. Favor short headlines and labels, since Google identifies small text and long paragraphs as weaknesses.

**Can Nano Banana 2.1 create images in different languages?**

Yes. Google's recommended languages include English, Spanish, French, German, Hindi, Japanese, Korean, and Simplified Chinese; for localized artwork, supply the approved wording and check the rendered text.

