[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [fal Grain](https://spiral.ai/integrations/claude-code/fal-grain)

# How to Use fal Grain in Claude Code

fal Grain adds film grain to an existing image for photographic finishing. Use it to compare texture treatments while adjusting intensity and scale.

|  |  |
| --- | --- |
| Model | fal Grain |
| Available through | fal |
| Category | Image |
| Price | $0.0013 per image. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with fal Grain in Claude Code

- Use fal Grain on the homepage photo in this project with modern style and intensity 0.2; show it beside the original.
- Use fal Grain on our editorial cover image with analog style at three intensities, keeping scale fixed for comparison.
- Use fal Grain to compare kodak and fuji styles on the portfolio portrait, holding intensity and scale constant.
- Use fal Grain on the music page artwork with cinematic style; keep the page title as separate HTML text.
- Use fal Grain on the project’s poster image with newspaper style, then preview it in the existing poster layout.

## How to set up fal Grain 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 fal Grain**: 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/post-processing/grain",
    "input": {
      "image_url": "https://storage.googleapis.com/falserverless/web-examples/post-process/postpro-input.jpg"
    }
  }'
```

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

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

## fal Grain tools and prices

- [Post Processing Grain](https://spiral.ai/tools/fal/fal-ai/post-processing/grain) (fal): $0.0013 per image.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| grain_intensity | 0 to 1 | 0.4 | Film grain intensity |
| grain_scale | 1 to 100 | 10 | Film grain scale |
| grain_style | modern, analog, kodak, fuji, cinematic, newspaper | modern | Style of film grain to apply |

## What can you do with fal Grain in Claude Code?

Create grain-treated photography for a website or app using fal Grain. Have the coding agent compare treatments in the project's layout before choosing an asset.

### Portrait finishing

Try a restrained grain treatment on a finished portrait, then compare the face and background with the original.

### Travel photo essays

Apply a chosen grain treatment across selected travel photos, reviewing each image before assembling the essay.

### Music cover artwork

Test pronounced grain on existing cover artwork. Add the title separately after selecting the image treatment.

### Fashion editorial selects

Compare grain styles on a representative fashion photograph before treating the remaining selects.

### Website photography

Prepare grain-treated alternatives for existing website photos and compare them in the actual page layout.

### Film poster concepts

Apply grain to an existing poster image, then review it with the typography placed above the treated artwork.

## Overview

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

## fal Grain in other agents

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

## More Claude Code guides

- [fal Expression Change](https://spiral.ai/integrations/claude-code/fal-expression-change)
- [fal Hair Change](https://spiral.ai/integrations/claude-code/fal-hair-change)
- [fal Desaturate](https://spiral.ai/integrations/claude-code/fal-desaturate)
- [fal Object Removal](https://spiral.ai/integrations/claude-code/fal-object-removal)
- [fal Blur](https://spiral.ai/integrations/claude-code/fal-blur)
- [fal Retouch](https://spiral.ai/integrations/claude-code/fal-retouch)

## Questions about fal Grain in Claude Code

**Can Claude Code use fal Grain?**

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

**How much does fal Grain cost in Claude Code?**

$0.0013 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 fal Grain in Claude Code?**

No. Spiral runs fal Grain on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up fal Grain in Claude Code?**

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

**Does Claude Code wait while fal Grain runs?**

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

**What is fal Grain useful for?**

It adds film grain to existing images. Try it when a portrait, editorial photo, or cover image needs a deliberate texture treatment.

**How should I describe the result I want?**

Give the agent a concrete editing brief: identify the image, request a light or pronounced treatment, and ask for comparisons. For example, request three intensity levels with style and scale held constant.

**How should I tune the grain?**

Compare styles first while keeping intensity and scale fixed. Then adjust one setting at a time so you can judge what changed.

**How can I check whether the grain looks right?**

Review the result at several zoom levels, including its intended display size. Keep the original beside it and inspect faces, smooth backgrounds, and fine details.

**When should I keep a clean version?**

Keep a clean comparison when small lettering, product labels, or fine detail matters. Choose the grain treatment only after checking those areas at the intended viewing size.

