Claude Code image generation for an AI persona: one skill

Claude Code image generation works through an image model, not through Claude. You connect a model host such as WaveSpeed as an MCP server, then write one skill for your persona. The skill holds her fixed features, her reference images, the model settings, a price check and your rules. The agent follows it every time.

What you need before you start

You do not write any code for this setup. You type a few commands and copy two text files. You need:

Ready to generate persona images from Claude Code?

• Claude Code installed, or the Codex CLI.You open it in one project folder. The skill and the finished images live there.
• Node.js installed.The WaveSpeed MCP server and the WaveSpeed CLI both run with it (npx and npm).
• A WaveSpeed account with a small prepaid balance.A 20-image batch with five references costs about $1.14 at 1k. Leave automatic top-up off.
• Five reference images of your persona.Your own generated images: front, both three-quarter views, profile, full body. Never a real person.
• A short text with her fixed features.Face shape, eyes, hair, skin. You paste it into character.md below.

Can Claude Code generate images?

No, not on its own. Claude reads images but does not make them, so Claude Code needs a tool that calls an image model.

“Can Claude generate or edit images? No, Claude is an image understanding model only. It can interpret and analyze images, but it cannot generate, produce, edit, manipulate, or create images.”

Claude Docs — Vision (opens in a new tab)checked 5 Oct 2026

Codex is different. It has an image skill built in:

In Codex CLI, “include $imagegen to invoke the image generation skill explicitly.” “Built-in image generation uses gpt-image-2 and counts toward your general Codex usage limits. Image generations use included limits 3–5x faster on average than similar turns without image generation”. “For larger batches, set OPENAI_API_KEY in your environment and ask ChatGPT to generate images through the API so API pricing applies.”

ChatGPT Learn — Image generation (Codex) (opens in a new tab)checked 5 Oct 2026

So with Codex you can start without any setup, on OpenAI’s model. With Claude Code you choose the model, which also means you can use one that keeps your persona’s face best. ChatGPT AI influencer photos covers OpenAI’s image model with reference images in detail.

Claude Code can also write code that draws a graphic, such as an SVG quote card or an HTML carousel slide. That works for text posts and simple designs. It cannot make a photo of your persona, so for her you need an image model.

Three ways to connect an image model to Claude Code

The quickest way is an MCP server, a small program that gives the agent new tools. WaveSpeed publishes one, plus a skill and a plugin. This guide uses WaveSpeed. WaveSpeed vs fal vs Replicate compares it with the other two big hosts.

Published 19 August 2026. Skill: wavespeed skill install, which “writes .claude/skills/wavespeed/SKILL.md”. Plugin: /plugin marketplace add WaveSpeedAI/claude-plugins and /plugin install wavespeed@wavespeed. MCP: claude mcp add wavespeed -- npx -y @wavespeed/mcp. “wavespeed login stores the key on your machine”.

WaveSpeedAI Blog — Use WaveSpeed in Claude Code (opens in a new tab)checked 5 Oct 2026

Tools: list_models, get_model_schema, run_model, get_price, get_balance, upload_file, get_prediction. get_price gives a “Cost estimate with unpriced_inputs / at_base_price disclosure”. “Auth resolves from WAVESPEED_API_KEY, or from the CLI’s stored login (wavespeed login) — one login covers both tools.”

WaveSpeedAI on GitHub — mcp-server (opens in a new tab)checked 5 Oct 2026

Way	Set it up with	Good for	Watch out for
WaveSpeed MCP server	claude mcp add wavespeed -- npx -y @wavespeed/mcp	Asking for images in plain words, with a price tool built in	The agent can run any model in the catalogue unless your skill limits it
WaveSpeed skill or plugin	wavespeed skill install or the plugin marketplace	Agents that run shell commands, no MCP needed	Needs the CLI installed and logged in
Your own script	A short Python file plus a skill	Fixed batches with a hard spending cap	You maintain the code

For a persona, use the MCP server and add your own skill on top. The MCP server gives the agent the tools. Your skill tells it which model, which references and which rules. Before you connect any server, Anthropic’s advice applies:

“Verify you trust each server before connecting it. Servers that fetch external content can expose you to prompt injection risk.”

Claude Code Docs — Connect Claude Code to tools via MCP (opens in a new tab)checked 5 Oct 2026

The setup in your terminal, in this order:

npm install -g @wavespeed/cli                      # the WaveSpeed command line tool
wavespeed login                                    # opens the browser, stores your key on this computer
claude mcp add wavespeed -- npx -y @wavespeed/mcp  # gives Claude Code the WaveSpeed tools
claude mcp get wavespeed                           # should say the server is connected

The MCP server uses the key that wavespeed login stored, so the key never appears in the chat or in a file the agent edits. Everything after -- is the command that starts the server, which Claude Code passes on unchanged.

For video batches, the third way fits better. Seedance with Claude Code or Codex shows a script that quotes every clip and stops at a spending cap.

How to build an AI persona skill for Claude Code

A persona skill is a folder that holds everything the agent must not guess. Claude Code loads it from .claude/skills/.

Project skills live in .claude/skills/<skill-name>/SKILL.md. “Skills can include multiple files in their directory.” description: “What the skill does and when to use it. Claude uses this to decide when to apply the skill.”

Claude Code Docs — Extend Claude with skills (opens in a new tab)checked 5 Oct 2026

The folder:

.claude/skills/persona-mara/
  SKILL.md          the steps and the rules
  character.md      her fixed features, pasted in front of every prompt
  references/
    01-front.jpg
    02-three-quarter-left.jpg
    03-three-quarter-right.jpg
    04-profile.jpg
    05-full-body.jpg

The references are your own generated images of your persona, never photos of a real person. The character consistency guide explains how to build a reference set that holds a face.

character.md is short and never changes:

Images 1 to 5 show the same woman, Mara, in her late twenties. She is fictional.
Use them only for her identity.
Keep exactly: oval face, green-grey eyes, light freckles across the nose,
shoulder-length dark brown hair with a middle parting, natural skin texture.
Do not beautify, slim, smooth or age her. Do not change her proportions.

And SKILL.md:

---
name: persona-mara
description: Generates new photos of Mara, our fictional AI persona, from her fixed reference set through the WaveSpeed MCP server. Use when the user asks for new Mara images, outfits or scenes. Never use for anyone else.
---

# Mara: new images

## Model
- Model: bytedance/seedream-v5.0-pro/edit, resolution 1k.
- Check the inputs with get_model_schema before the first run of a session.

## Steps
1. Upload the five files in references/ (in this skill's folder) with upload_file.
   Reuse the URLs for the whole session.
2. For each image the user wants, write the prompt as: the text of character.md,
   then one scene. One scene per image.
3. Call get_price with the full input of one image, including all five reference
   URLs. If the answer lists unpriced_inputs, say so.
4. Tell the user: number of images x price = total. Wait for an explicit "yes".
   Never more than 20 images per request.
5. Run each image with run_model. If it returns only a prediction id, check it
   with get_prediction until the status is completed.
6. Download every output URL at once with curl into outputs/YYYY-MM-DD/.
   Do not convert, resize or compress the file. Next to it, write a .json file
   with the prompt, the model and the prediction id.
7. Show the user the images. Do not choose, caption, post or delete any of them.

## Hard rules
- Mara is an adult and fictional. Strictly safe for work: no nudity, no lingerie,
  no suggestive poses.
- Use only the files in references/. Never add a photo of a real person,
  a celebrity look-alike or "in the style of" a real person.
- Never print or paste an API key.
- If a request breaks a rule, stop and name the rule.

You start it with /persona-mara, or you ask for “three new photos of Mara in a café” and Claude picks the skill from its description. One skill per persona keeps two personas from mixing.

This is what happens when you ask for images, and who does each step:

1. 1YouAsk for scenesFor example: three photos of Mara in a café
2. 2AgentLoad the skill and upload the five referencesupload_file, once per session
3. 3AgentQuote one complete image and multiplyget_price with all five reference URLs
4. 4YouCheckpointApprove the totalNo image is made without your yes
5. 5WaveSpeedGenerate each imagerun_model, then get_prediction until completed
6. 6AgentDownload every file unchangedoutputs/date/, with a JSON file of prompt, model and ID
7. 7YouCheckpointCheck the face, the age impression and pickCompare each image with reference 1
8. 8YouLabel as AI and postThe way each platform asks

Schematicthe shape, not measured data

What an image costs, and why the first quote can be too low

On WaveSpeed, Seedream v5.0 Pro Edit costs a few cents per image, and every extra reference image adds to that. Ask for the price with all references, or the quote is incomplete.

“Pricing includes the selected output resolution plus reference image input cost. The first input image is included; each additional input image costs $0.003.” Base price: 1k $0.045, 1.5k $0.045, 2k $0.090. images: “Supports up to 10 images.” The price box on the same page shows $0.0405 per run.

WaveSpeedAI — Seedream v5.0 Pro Edit (opens in a new tab)checked 5 Oct 2026

“ask for a price without them and the formula collapses to the model’s base price, which is the floor of its range, not a typical run.” The command “names the inputs it was blind to (unpriced_inputs / at_base_price in —json)”. “Whatever it says, the amount actually charged for a run is authoritative.”

WaveSpeedAI on GitHub — wavespeed-cli (opens in a new tab)checked 5 Oct 2026

What a persona image costs from that price table, before any discount:

Reference images	1k	2k
1	$0.045	$0.090
5 (the set above)	$0.057	$0.102
10 (the maximum)	$0.072	$0.117
A batch of 20 images with 5 references	$1.14	$2.04

The page shows two figures: $0.045 in the price table and $0.0405 in the price box. The page does not explain the difference, so plan with the higher one. GPT Image 2.5 Edit charges much more per extra reference, as ChatGPT AI influencer photos shows. The model price list has the other image models with their dates.

Two rules for the skill follow from this. The agent must quote one complete image, references included, and multiply. And it must wait for your yes, because WaveSpeed has no setting that stops spending at a limit you choose.

The same persona skill in Codex

Copy or link the folder to .agents/skills/persona-mara/, connect the same MCP server, and start it with $persona-mara.

“For repositories, Codex scans .agents/skills in every directory from your current working directory up to the repository root.” The SKILL.md “must include name and description”. “In Codex CLI or the IDE extension, run /skills or type $ to mention a skill.” “Codex supports symlinked skill folders”.

ChatGPT Learn — Build skills (Codex) (opens in a new tab)checked 5 Oct 2026

Add a server with codex mcp add <server-name> --env VAR1=VALUE1 -- <stdio server-command>. For more control, edit ~/.codex/config.toml or a project .codex/config.toml, with one [mcp_servers.<server-name>] table per server. env_vars lists “Environment variables to allow and forward.”

ChatGPT Learn — MCP (Codex) (opens in a new tab)checked 5 Oct 2026

So in Codex you run codex mcp add wavespeed -- npx -y @wavespeed/mcp. Leave out --env with the key: the server can use your wavespeed login, and a key typed on the command line also lands in your shell history. The skill text works unchanged, because it names the MCP tools and not a Claude feature.

Which one to use for persona images:

	Claude Code with your skill	Codex with $imagegen
Image model	Your choice on WaveSpeed	gpt-image-2
Paid by	WaveSpeed credit, per image	Codex usage limits, or the API with OPENAI_API_KEY
Reference images	Up to the model’s limit, 10 for Seedream v5.0 Pro Edit	Attached with -i or --image
Price check before a batch	get_price in the skill	No price per image: it uses up your Codex limits

You can also give Codex the persona skill and still use $imagegen for quick drafts. Keep the final images on one model, so the face stays the same across the feed.

What the agent must never decide for you

The agent generates and saves. You decide what is real enough, adult enough and good enough to post. Neither Claude nor the image host checks your references for you.

Three checks stay with you, every time:

1. The references. Only images you generated of your persona go into references/. Never a scraped photo, a model from Instagram or a friend.
2. The age impression. Every image must look clearly adult. The AI influencer workflow guide explains why this check is never automated.
3. The selection. Pick the images that look like her next to reference 1. The workflow guide tells what happened when a script did the picking: automating the selection step.

Where the images go: download, keep the metadata, label

Save every image as soon as it is done, unchanged. WaveSpeed keeps neither your uploads nor your results for long.

“Uploaded files are stored for 7 days and then automatically deleted. The service is only for WaveSpeedAI inference inputs, not general-purpose storage”.

WaveSpeedAI docs — How to Upload Files (opens in a new tab)checked 5 Oct 2026

“Generated media files are temporary and generally expire within 7 days.”

WaveSpeedAI docs — Data Retention Policy (opens in a new tab)checked 5 Oct 2026

That is why step 6 of the skill saves each file at once and writes the prompt next to it. Your own folder is the archive, not WaveSpeed. Do not let the agent “optimise” the files: converting can remove the AI metadata platforms read. Do not strip your watermarks shows a one-command check. When you post, label the images as AI the way each platform asks, as shown in the AI label matrix.

Start with three images. Write character.md, put your five references in the folder, connect the MCP server, and ask for three scenes. If the face matches reference 1 in all three, raise the batch size. If it does not, fix the references first, not the prompt.