How to Use Recraft V4.1 in Claude Code
Recraft V4.1 suits editorial photos, illustrations, and visual concept exploration from short briefs. Choose it for exploring light and composition; Recraft V4.1 Pro adds higher-resolution output for larger deliverables.
Prompts to try with Recraft V4.1 in Claude Code
Copy an example into Claude Code, or ask in your own words.
Read the homepage copy and layout in this project. Use Recraft V4.1 to create a landscape editorial photo of a ceramic workshop, with the workbench on the left and clear space on the right for the existing headline.
Read the article about task overload in this project. Use Recraft V4.1 to create an editorial illustration of a small paper boat navigating stacks of paperwork, using the site's existing colors.
Use Recraft V4.1 to generate a 2048×2048 campaign image for the coffee product described in this project's brief: an unbranded matte bag beside a ceramic cup, directional morning light, visible paper texture, no lettering.
Use Recraft V4.1 to explore three separate hero concepts for this project's gardening app: a sunlit potting bench, a close-up seedling, and an illustrated rooftop garden. Keep open space for HTML text.
Inspect the onboarding copy and color tokens in this project. Use Recraft V4.1 to create a square illustration of a person organizing a cluttered desk, with simple shapes and a plain background.
How to set up Recraft V4.1 in Claude Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
This adds Spiral to the current project. Add --scope user to use it in every project.
claude mcp add --transport http spiral https://api.spiral.ai/mcp
- 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
- Send Claude Code this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Recraft V4.1
One request; the result comes back by polling or a webhook.
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/recraft/v4.1/text-to-image", "input": { "prompt": "Tilt-shift miniature effect on a real Portuguese fishing village at golden hour, colorful boats in the harbor appearing toy-like, selective focus band across…" } }'
Then paste one of the prompts above: Claude Code finds Recraft V4.1 on Spiral, shows the price and runs it.
Recraft V4.1 providers and prices
Spiral runs Recraft V4.1 through fal. Open a card for today's price, with every fee included.
What can you do with Recraft V4.1 in Claude Code?
Create artwork that fits the page or app you are building. A coding agent can turn project copy and layout requirements into briefs for editorial images, illustrations, and campaign concepts.
Website hero artwork
Create a photographic or illustrated scene with the subject on one side and open space for a headline added in the page layout.
Editorial illustrations
Turn an article's central idea into a visual metaphor, such as a paper boat navigating a crowded desk for a story about managing workload.
Campaign concept exploration
Explore several lighting, material, and composition directions for the same campaign brief before choosing an approach.
Product photography concepts
Visualize a fictional ceramic cup, watch, or skincare bottle in a described setting to plan a shoot or presentation.
Portrait art direction
Explore wardrobe, framing, background, and lighting for an editorial portrait using a fictional adult subject.
Environment concept art
Describe a bookstore, workshop, or imagined landscape and explore its atmosphere, spatial arrangement, and materials.
Mixed-media social artwork
Combine a photographic subject with cut-paper shapes or illustrated elements, leaving captions for the final layout.
More on Recraft V4.1 and Claude Code
Overview
Recraft V4.1 in other agents
Questions about Recraft V4.1 in Claude Code
Can Claude Code use Recraft V4.1?
Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Recraft V4.1 like any built-in tool.
How much does Recraft V4.1 cost in Claude Code?
$0.0455 per image. 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 Recraft V4.1 in Claude Code?
No. Spiral runs Recraft V4.1 on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up Recraft V4.1 in Claude Code?
About two minutes: add the hosted server, then sign in.
Does Claude Code wait while Recraft V4.1 runs?
Recraft V4.1 runs in the background. Claude Code starts the run, checks on it and gives you the image when it's ready.
What is Recraft V4.1 useful for?
Use it for editorial imagery, campaign concepts, illustrations, and art-directed photography. Give the prompt a subject, a visual treatment, and a clear composition.
Should I write a short prompt or a detailed brief?
Start short when exploring a visual direction. For a specific deliverable, describe the framing, materials, lighting, background, and space needed for surrounding copy.
How should I prompt words inside an image?
Put the exact wording in quotation marks and describe its size and placement. Check the rendered letters before using the image, especially with the original Recraft V4.1 Flash.
Will these text-to-image models return an editable SVG?
These Recraft V4.1 text-to-image models produce raster artwork. For a logo concept, treat the result as an image rather than editable vector paths.
Why does the model add an unexpected camera angle or lighting treatment?
Recraft V4.1 makes creative choices about light, mood, and composition. If a particular arrangement matters, specify the camera position, subject placement, and lighting direction instead of leaving them open.
Start using Recraft V4.1 in Claude Code
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Claude Code:
set up https://spiral.ai/SKILL.md


