[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [FLUX.2 Max Edit](https://spiral.ai/integrations/claude-code/flux-2-max-edit)

# How to Use FLUX.2 Max Edit in Claude Code

FLUX.2 Max Edit changes backgrounds, materials, and text in supplied images. Choose it over FLUX.2 Max when you need an existing product or character to guide the result.

|  |  |
| --- | --- |
| Model | FLUX.2 Max Edit |
| Available through | fal |
| Category | Image |
| Price | $0.091 for the first megapixel, $0.039 for each further started one, counting the output and the input images, each sized to 1 to 4 megapixels. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with FLUX.2 Max Edit in Claude Code

- Use FLUX.2 Max Edit on the product photo in this project's assets. Place the product on a pale stone counter beside a window, with soft morning light; retain its shape, label, and proportions. Output 1536 × 1024.
- Use FLUX.2 Max Edit on the chair image in this project's assets. Change the upholstery to woven rust-colored fabric, preserving the chair's shape, camera angle, and lighting. Output 1024 × 1024.
- Remove the background from the photo I attach with FLUX.2 Max Edit and give me a transparent PNG. Save the result in ./assets.
- Use FLUX.2 Max Edit to clean up these product shots so they sit on pure white.
- Edit this image with FLUX.2 Max Edit: keep the subject, swap the background for a sunlit studio.

## How to set up FLUX.2 Max Edit 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 FLUX.2 Max Edit**: 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": "fal",
    "model": "fal-ai/flux-2-max/edit",
    "input": {
      "prompt": "A high-fashion magazine cover featuring an android in an avant-garde geometric cloth dress, with logo prints from @Image1. The backdrop is an eye-catching…",
      "image_urls": [
        "<image_urls>"
      ]
    }
  }'
```

Then paste one of the prompts above: Claude Code finds FLUX.2 Max Edit on Spiral, shows the price and runs it.

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

## FLUX.2 Max Edit tools and prices

- [FLUX.2 \[max\] · Image Editing](https://spiral.ai/tools/fal/fal-ai/flux-2-max/edit) (fal): $0.091 for the first megapixel, $0.039 for each further started one, counting the output and the input images, each sized to 1 to 4 megapixels.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| image_size |  | auto | The size of the generated image. If `auto`, the size will be determined by the model. |
| seed |  | — | The seed to use for the generation. |
| safety_tolerance | 1, 2, 3, 4, 5 | 2 | The safety tolerance level for the generated image. 1 being the most strict and 5 being the most permissive. |
| output_format | jpeg, png | jpeg | The format of the generated image. |

## What can you do with FLUX.2 Max Edit in Claude Code?

Produce product scenes, posters, and editorial images for your project with FLUX.2 Max. A coding agent can turn the project's copy and visual requirements into specific image instructions.

### Product background changes

Use FLUX.2 Max Edit to place a supplied product image in a different setting for seasonal campaigns or lifestyle photography.

### Material and surface studies

Use FLUX.2 Max Edit to explore different finishes on a supplied object while asking it to preserve shape, geometry, and lighting.

### Character continuity across scenes

Use FLUX.2 Max Edit with a character reference to change the environment while retaining facial features, proportions, and visual identity.

### Room furnishing composites

Use FLUX.2 Max Edit to combine furniture from supplied photos into one room, specifying which reference supplies each object.

## Overview

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

## FLUX.2 Max Edit in other agents

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

## More Claude Code guides

- [FLUX.2 Max](https://spiral.ai/integrations/claude-code/flux-2-max)
- [FLUX.2 Realism LoRA](https://spiral.ai/integrations/claude-code/flux-2-realism-lora)
- [FLUX.2 LoRA Edit](https://spiral.ai/integrations/claude-code/flux-2-lora-edit)
- [FLUX.2 Satellite View Style](https://spiral.ai/integrations/claude-code/flux-2-satellite-view-style)
- [FLUX.2 LoRA](https://spiral.ai/integrations/claude-code/flux-2-lora)
- [FLUX.2 Sepia Vintage](https://spiral.ai/integrations/claude-code/flux-2-sepia-vintage)

## Questions about FLUX.2 Max Edit in Claude Code

**Can Claude Code use FLUX.2 Max Edit?**

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run FLUX.2 Max Edit like any built-in tool.

**How much does FLUX.2 Max Edit cost in Claude Code?**

$0.091 for the first megapixel, $0.039 for each further started one, counting the output and the input images, each sized to 1 to 4 megapixels. 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 fal account to use FLUX.2 Max Edit in Claude Code?**

No. Spiral runs FLUX.2 Max Edit on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up FLUX.2 Max Edit in Claude Code?**

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

**Does Claude Code wait while FLUX.2 Max Edit runs?**

FLUX.2 Max Edit runs in the background. Claude Code starts the run, checks on it and gives you the image when it's ready.

**What is FLUX.2 Max good at?**

Product photography, editorial images, posters, and graphics with readable text are useful starting points. Describe the composition, lighting, materials, and wording you need.

**How large can FLUX.2 Max images be?**

Output can reach 4 megapixels, including 2048 × 2048. BFL recommends staying at or below 2 megapixels for quality and speed.

**How should I describe a photographic image?**

Specify the subject, lens, lighting, framing, and visible texture. A concrete description such as an 85mm portrait with side lighting gives clearer direction than asking for a professional photo.

**Does FLUX.2 Max support negative prompts?**

No. Describe the result positively: use "sharp focus" or "an empty street" to state what should appear.

**Can FLUX.2 Max put text inside an image?**

Yes, it supports readable typography for posters, ads, and magazine layouts. Give the exact wording and describe its position, size, and lettering style.

