[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [Qwen4 Max](https://spiral.ai/integrations/claude-code/qwen4-max)

# How to Use Qwen4 Max in Claude Code

Qwen4 Max is built for coding, office work, front-end design, and tasks that require several reasoning steps. Its one-million-token context supports analysis across long documents and large codebases.

|  |  |
| --- | --- |
| Model | Qwen4 Max |
| Available through | OpenRouter |
| Category | LLM |
| Price | Up to $0.02283 per run at the default inputs. $1.8525 per 1M input tokens, $5.5575 per 1M output tokens. |
| Returns | text, json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Qwen4 Max in Claude Code

- Use Qwen4 Max to trace the failing test through the relevant project files. Identify the cause, implement the smallest fix, and run a regression test that fails before the fix.
- Use Qwen4 Max to review the authentication code and its callers. Return up to five concrete defects with file references, a reproduction path, and a proposed correction.
- Use Qwen4 Max to implement the settings screen described in the project's requirements. Cover loading, empty, error, and saved states, and verify keyboard navigation.
- Use Qwen4 Max to compare the current data layer with the migration proposal. Map affected files and dependencies, then produce an ordered plan with a check for each stage.
- Use Qwen4 Max to examine the ticket parser and its tests. Propose a consistent JSON contract, then add coverage for missing values, malformed input, and unexpected extra text.

## How to set up Qwen4 Max 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 Qwen4 Max**: 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": "openrouter",
    "model": "qwen/qwen4-max",
    "input": {
      "messages": [
        {
          "role": "user",
          "content": "Hello!"
        }
      ]
    }
  }'
```

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

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

## Qwen4 Max tools and prices

- [Qwen: Qwen4 Max](https://spiral.ai/tools/openrouter/qwen/qwen4-max) (OpenRouter): Up to $0.02283 per run at the default inputs. $1.8525 per 1M input tokens, $5.5575 per 1M output tokens.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| seed |  | — |  |
| stop |  | — |  |
| tools |  | — |  |
| top_k | 0 to … | — |  |
| top_p | 0 to 1 | — |  |
| logprobs |  | — |  |

## What can you do with Qwen4 Max in Claude Code?

Turn changes spanning several modules into an implementation plan, patch, and focused checks with Qwen4 Max. Its long context and coding focus suit work that requires following relationships across project files.

### Trace a bug across modules

Ask Qwen4 Max to follow a failing request through related code, identify the cause, and propose a focused fix with a regression test.

### Plan a codebase migration

Have Qwen4 Max compare existing interfaces with the target design and produce an ordered migration plan with dependencies and acceptance checks.

### Build a front end from requirements

Give Qwen4 Max a written interface brief covering content, interactions, accessibility, and screen sizes, then request the implementation.

### Compare lengthy specifications

Use Qwen4 Max to compare supplied specifications, identify conflicting requirements, and cite the relevant sections in a decision table.

### Extract support ticket details

Ask Qwen4 Max to turn ticket text into JSON with a defined set of keys, using null for missing details and examples to establish the format.

### Prepare an operational brief

Have Qwen4 Max combine supplied updates into a concise brief covering decisions, owners, deadlines, and unresolved questions.

### Analyze a multi-step decision

Ask Qwen4 Max to compare options against supplied constraints, work through dependencies, and explain the evidence behind a recommendation.

## Overview

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

## Qwen4 Max in other agents

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

## More Claude Code guides

- [Qwen3.8 Omni Flash](https://spiral.ai/integrations/claude-code/qwen3-8-omni-flash)
- [ReMM SLERP 13B](https://spiral.ai/integrations/claude-code/remm-slerp-13b)
- [Qwen3.8 Max Prime](https://spiral.ai/integrations/claude-code/qwen3-8-max-prime)
- [Reka Edge](https://spiral.ai/integrations/claude-code/reka-edge)
- [Qwen3.8 Max (0902) (batch)](https://spiral.ai/integrations/claude-code/qwen3-8-max-0902-batch)
- [Reka Flash 3](https://spiral.ai/integrations/claude-code/reka-flash-3)

## Questions about Qwen4 Max in Claude Code

**Can Claude Code use Qwen4 Max?**

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

**How much does Qwen4 Max cost in Claude Code?**

Up to $0.02283 per run at the default inputs. $1.8525 per 1M input tokens, $5.5575 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 Qwen4 Max in Claude Code?**

No. Spiral runs Qwen4 Max on its own OpenRouter account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Qwen4 Max in Claude Code?**

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

**Does Claude Code wait while Qwen4 Max runs?**

Qwen4 Max runs in the background. Claude Code starts the run, checks on it and gives you the text, json when it's ready.

**What is Qwen4 Max good at?**

Qwen4 Max is designed for coding, office work, front-end design, and complex agent tasks. Useful requests include tracing a bug across several modules or turning detailed requirements into an implementation plan.

**How much context can Qwen4 Max handle?**

The maker documents a one-million-token context window. That makes long document comparisons and analysis across large codebases practical uses.

**How long can Qwen4 Max's answers be?**

The maker lists up to 131,072 output tokens without thinking. Its documented thinking-mode limit is 262,144 tokens shared between reasoning and the final answer, so that number does not describe answer length alone.

**When is deeper thinking useful?**

Use it for tasks that require choosing tools, interpreting results, and deciding what to do next. The maker cautions that the overhead may not be worthwhile for a simple task involving one tool.

**Does valid JSON guarantee consistent output?**

No. JSON Object mode can return valid JSON while changing key names or value types; the maker recommends JSON Schema mode when the structure must stay fixed.

