[Integrations](https://spiral.ai/integrations) › [Windsurf](https://spiral.ai/integrations/windsurf) › [Claude Opus 5.5](https://spiral.ai/integrations/windsurf/claude-opus-5-5)

# How to Use Claude Opus 5.5 in Windsurf

Claude Opus 5.5 is built for long coding tasks, large refactors, and detailed knowledge work. Compared with Claude Opus 5, it generates output more than 30% faster in Anthropic’s tests.

|  |  |
| --- | --- |
| Model | Claude Opus 5.5 |
| Available through | Anthropic |
| Category | LLM |
| Price | Up to $0.10686 per run at the default inputs. $5.20 per 1M input tokens, $0.26 per 1M cached input tokens, $6.50 per 1M cache write tokens, $10.40 per 1M 1-hour cache write tokens, $26.00 per 1M output tokens; for a prompt above 200,000 tokens, $10.40 per 1M input tokens, $0.52 per 1M cached input tokens, $13.00 per 1M cache write tokens, $20.80 per 1M 1-hour cache write tokens, $39.00 per 1M output tokens. |
| Returns | text, json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Claude Opus 5.5 in Windsurf

- Use Claude Opus 5.5 to inspect this repository and migrate deprecated date utilities to the current library. Preserve time zone behavior, update affected tests, and finish with a checklist of completed changes and blockers.
- Use Claude Opus 5.5 to trace the duplicate validation logic across this project. Propose a shared implementation, make the refactor, and run the checks that cover the affected behavior.
- Use Claude Opus 5.5 to review the current diff against the surrounding code. Report only defects you can support with a concrete execution path, and suggest a regression test for each.
- Use Claude Opus 5.5 to investigate why this project's report endpoint is slow. Measure a baseline, identify the bottleneck, implement a targeted fix, and compare behavior and timing afterward.
- Use Claude Opus 5.5 to implement the acceptance criteria in this project's issue description. Keep a completion checklist, run the relevant tests, and report any criteria that remain blocked.

## How to set up Claude Opus 5.5 in Windsurf

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: `~/.config/devin/mcp_config.json` on macOS and Linux, `%APPDATA%\devin\mcp_config.json` on Windows. Add this:

```json
{
  "mcpServers": {
    "spiral": {
      "url": "https://api.spiral.ai/mcp"
    }
  }
}
```

2. **Sign in**: Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

```bash
devin mcp login spiral
```

3. **Check it**: Spiral is listed under This computer in Customize › MCPs. From the terminal:

```bash
devin mcp list
```

### Use the Spiral skill

1. **Send Windsurf 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 Claude Opus 5.5**: 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": "anthropic",
    "model": "anthropic/claude-opus-5.5",
    "input": {
      "messages": [
        {
          "role": "system"
        }
      ]
    }
  }'
```

Then paste one of the prompts above: Windsurf finds Claude Opus 5.5 on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/windsurf

## Claude Opus 5.5 tools and prices

- [Claude Opus 5.5](https://spiral.ai/tools/anthropic/anthropic/claude-opus-5.5) (Anthropic): Up to $0.10686 per run at the default inputs. $5.20 per 1M input tokens, $0.26 per 1M cached input tokens, $6.50 per 1M cache write tokens, $10.40 per 1M 1-hour cache write tokens, $26.00 per 1M output tokens; for a prompt above 200,000 tokens, $10.40 per 1M input tokens, $0.52 per 1M cached input tokens, $13.00 per 1M cache write tokens, $20.80 per 1M 1-hour cache write tokens, $39.00 per 1M output tokens.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| stop |  | — |  |
| tools |  | — |  |
| reasoning |  | — | Reasoning effort; reasoning tokens count toward max_tokens. |
| max_tokens | 1 to 128000 | — | The most output tokens to generate. On a reasoning model the reasoning tokens count toward it: a cap too low for the effort can end with no answer (finish_reason length). |
| tool_choice |  | — |  |
| response_format |  | — |  |

## What can you do with Claude Opus 5.5 in Windsurf?

Carry a repository change from investigation through implementation and verification with Claude Opus 5.5. Give it the affected files, behavior requirements, and completion checks for a migration, refactor, or review.

### Migrate a large codebase

Use Claude Opus 5.5 to move deprecated interfaces to their replacements, update affected tests, and report any remaining blockers against a migration checklist.

### Refactor across modules

Ask Claude Opus 5.5 to trace dependencies, simplify duplicated logic, and verify that the affected behavior still passes its tests.

### Review a complicated change

Have Claude Opus 5.5 examine a patch and its surrounding code, then report reproducible defects with evidence and a suggested test.

### Prepare a research brief

Give Claude Opus 5.5 the source material and a specific decision to support. Request a concise brief with quotations for key claims and a list of unresolved questions.

### Check a financial analysis

Ask Claude Opus 5.5 to inspect supplied calculations, identify inconsistent assumptions, and explain how each proposed correction changes the result.

### Reconcile planning records

Use Claude Opus 5.5 to compare lengthy planning material, flag conflicting commitments, and produce a decision log with evidence for each entry.

## Overview

- [Anthropic Claude](https://spiral.ai/providers/anthropic)
- [All Windsurf guides](https://spiral.ai/integrations/windsurf)

## Claude Opus 5.5 in other agents

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

## More Windsurf guides

- [Claude Opus 5](https://spiral.ai/integrations/windsurf/claude-opus-5)
- [Claude Opus Latest](https://spiral.ai/integrations/windsurf/claude-opus-latest)
- [Claude Opus 4.8](https://spiral.ai/integrations/windsurf/claude-opus-4-8)
- [Claude Sonnet 4.6](https://spiral.ai/integrations/windsurf/claude-sonnet-4-6)
- [Claude Opus 4.7](https://spiral.ai/integrations/windsurf/claude-opus-4-7)
- [Claude Sonnet 5](https://spiral.ai/integrations/windsurf/claude-sonnet-5)

## Questions about Claude Opus 5.5 in Windsurf

**Can Windsurf use Claude Opus 5.5?**

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Claude Opus 5.5 like any built-in tool.

**How much does Claude Opus 5.5 cost in Windsurf?**

Up to $0.10686 per run at the default inputs. $5.20 per 1M input tokens, $0.26 per 1M cached input tokens, $6.50 per 1M cache write tokens, $10.40 per 1M 1-hour cache write tokens, $26.00 per 1M output tokens; for a prompt above 200,000 tokens, $10.40 per 1M input tokens, $0.52 per 1M cached input tokens, $13.00 per 1M cache write tokens, $20.80 per 1M 1-hour cache write tokens, $39.00 per 1M output tokens. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Windsurf plan is separate.

**Do I need an Anthropic account to use Claude Opus 5.5 in Windsurf?**

No. Spiral runs Claude Opus 5.5 on its own Anthropic account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Claude Opus 5.5 in Windsurf?**

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

**Does Windsurf wait while Claude Opus 5.5 runs?**

Claude Opus 5.5 runs in the background. Windsurf starts the run, checks on it and gives you the text, json when it's ready.

**What is Claude Opus 5.5 best suited for?**

Use it for work with several dependent steps, such as a large refactor, a code migration, or a detailed analysis. Give it a concrete deliverable and a clear completion checklist.

**How much text can Claude Opus 5.5 handle?**

It has a 1 million token context window and supports up to 128,000 output tokens in a standard response. Thinking also uses the output budget, so the full allowance is not available for the visible answer.

**Does higher effort always produce a better result?**

Test effort settings on your actual tasks before choosing one. For demanding work, leave enough output space for thinking and the answer, then compare correctness and completeness.

**How should I prompt Claude Opus 5.5?**

State the deliverable, constraints, and completion criteria explicitly. Include an example when the answer must follow a particular format or writing style.

**Can I trust every figure or citation it produces?**

Check important claims against their sources. Ask for supporting quotations, and tell it to mark missing evidence instead of filling gaps.

