How to Use Aion 3.0 Mini in Claude Code
Aion 3.0 Mini is built for roleplay, character dialogue, and stories with tension and conflict. It uses DeepSeek models, while Aion 3.0 uses GLM models.
Prompts to try with Aion 3.0 Mini in Claude Code
Copy an example into Claude Code, or ask in your own words.
Use Aion 3.0 Mini to draft a 12-turn conversation from this project's character notes. Give the merchant and player conflicting goals, preserve established lore, and save the draft beside the existing dialogue.
Use Aion 3.0 Mini to propose three branches for the tavern encounter in this project: cooperation, refusal, and deception. Follow the existing dialogue format and keep each branch under 250 words.
Use Aion 3.0 Mini to rewrite the opening scene in this project's narrative files. Preserve its events, introduce the protagonist's immediate obstacle earlier, and show me the proposed changes.
Use Aion 3.0 Mini with reasoning enabled to draft five short NPC exchanges from the project's faction notes. Make each dispute turn on a different competing interest and keep each exchange under 200 words.
Use Aion 3.0 Mini to create a 600-word quest dialogue draft from this project's quest brief. Include a bargain, a refusal, and a consequence, then place it in a new draft file.
How to set up Aion 3.0 Mini 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 Aion 3.0 Mini
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": "openrouter", "model": "aion-labs/aion-3.0-mini", "input": { "messages": [ { "role": "system" } ] } }'
Then paste one of the prompts above: Claude Code finds Aion 3.0 Mini on Spiral, shows the price and runs it.
Aion 3.0 Mini providers and prices
Spiral runs Aion 3.0 Mini through OpenRouter. Open a card for today's price, with every fee included.
Up to $0.007487 per run at the default inputs. $0.91 per 1M input tokens, $1.82 per 1M output tokens.
Settings you can ask for
Ask Claude Code for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Top p | 0 to 1 | ||
| Max tokens | 1 to 32768 | The most output tokens to generate. | |
| Temperature | 0 to 2 |
Every API field of AionLabs: Aion-3.0-Mini is on its tool page: open its card above.
What can you do with Aion 3.0 Mini in Claude Code?
Turn game briefs and character notes into playable dialogue drafts with Aion 3.0 Mini. Use your coding agent to place reviewed scenes into the project's existing narrative format.
Interactive character conversations
Write exchanges in which a character pursues a specific goal. Define what the character knows and leave the user's actions for the user to decide.
Branching game dialogue
Draft conversations with distinct responses to cooperation, suspicion, and refusal. Give each branch a consequence for the next scene.
Tabletop encounters
Prepare an encounter around conflicting motives, a secret, and an approaching deadline. Include peaceful and confrontational ways forward.
Fiction scene drafts
Turn a scene brief into prose with a defined viewpoint, an immediate obstacle, and a consequential ending.
Conflict rewrites
Rework a flat exchange so the characters want incompatible outcomes. Request subtext and concrete stakes while preserving established events.
Serialized story installments
Draft the next short installment from a canon summary and the previous ending. Set a word target and identify the unresolved question it should advance.
Audio drama scripts
Write a dialogue-led scene with speaker labels and brief sound cues. Build the conflict through what the characters say and withhold.
Alternative plot outlines
Explore several consequences of one difficult choice. Ask for a different escalation and ending in each outline.
More on Aion 3.0 Mini and Claude Code
Overview
Aion 3.0 Mini in other agents
More Claude Code guides
Questions about Aion 3.0 Mini in Claude Code
Can Claude Code use Aion 3.0 Mini?
Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Aion 3.0 Mini like any built-in tool.
How much does Aion 3.0 Mini cost in Claude Code?
Up to $0.007487 per run at the default inputs. $0.91 per 1M input tokens, $1.82 per 1M output tokens. 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 an OpenRouter account to use Aion 3.0 Mini in Claude Code?
No. Spiral runs Aion 3.0 Mini on its own OpenRouter account. You sign in to Spiral once and never paste a key.
How long does it take to set up Aion 3.0 Mini in Claude Code?
About two minutes: add the hosted server, then sign in.
Does Claude Code wait while Aion 3.0 Mini runs?
Aion 3.0 Mini runs in the background. Claude Code starts the run, checks on it and gives you the text, json when it's ready.
What is Aion 3.0 Mini good at?
Roleplay and storytelling are its stated focus. Consider it for character exchanges, scene drafts, and plots built around competing goals.
How does Aion 3.0 Mini differ from Aion 3.0?
Aion 3.0 Mini uses DeepSeek models, while Aion 3.0 uses GLM models. Aion Labs describes both as targeting narrative structure, tension, and conflict.
How much context can Aion 3.0 Mini handle?
Its context window is 131,072 tokens. For ongoing fiction, supply a concise canon summary alongside the current scene rather than treating that limit as a reason to include every draft.
How long can an Aion 3.0 Mini response be?
It supports up to 32,768 completion tokens. Internal reasoning also consumes the generation budget, so allow room for both planning and the visible answer.
Should I disable reasoning for creative writing?
Keep reasoning enabled as a starting point. Aion Labs says these models are tuned for reasoning and warns that disabling it can degrade output.
Start using Aion 3.0 Mini 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


