[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [GPT-6.1 Terra](https://spiral.ai/integrations/claude-code/gpt-6-1-terra)

# How to Use GPT-6.1 Terra in Claude Code

GPT-6.1 Terra fits screenshot analysis, concise summaries, and narrowly scoped bug fixes. Choose it for everyday work; Terra Pro uses the same underlying model with additional reasoning for harder tasks.

|  |  |
| --- | --- |
| Model | GPT-6.1 Terra |
| Available through | OpenAI |
| Category | LLM |
| Price | Up to $0.026682 per run at the default inputs. $1.30 per 1M input tokens, $0.065 per 1M cached input tokens, $1.625 per 1M cache write tokens, $6.50 per 1M output tokens. |
| Returns | text, json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with GPT-6.1 Terra in Claude Code

- Use GPT-6.1 Terra with medium reasoning to reproduce the failing test in this project, find its cause, and make the smallest fix. Run the relevant regression test and summarize the result.
- Use GPT-6.1 Terra to compare the current page screenshot with the reference image in this project. Fix the three clearest layout discrepancies and verify them in a fresh screenshot.
- Use GPT-6.1 Terra to turn this project's recent commit notes into a release summary under 180 words. Include user-visible fixes and preserve any stated limitations.
- Use GPT-6.1 Terra with medium reasoning to inspect the settings screen and its component code. Fix the label mismatch, verify the displayed result, and report which files changed.
- Ask GPT-6.1 Terra through Spiral to review the diff on this branch and list the three riskiest changes. Save the result in ./assets.

## How to set up GPT-6.1 Terra 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 GPT-6.1 Terra**: 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": "openai",
    "model": "openai/gpt-6.1-terra",
    "input": {
      "messages": [
        {
          "role": "system"
        }
      ]
    }
  }'
```

Then paste one of the prompts above: Claude Code finds GPT-6.1 Terra on Spiral, shows the price and runs it.

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

## GPT-6.1 Terra tools and prices

- [GPT-6.1 Terra](https://spiral.ai/tools/openai/openai/gpt-6.1-terra) (OpenAI): Up to $0.026682 per run at the default inputs. $1.30 per 1M input tokens, $0.065 per 1M cached input tokens, $1.625 per 1M cache write tokens, $6.50 per 1M output tokens.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| seed |  | — |  |
| tools |  | — |  |
| top_p | … to 1 | — | Taken only with reasoning effort "none". |
| logprobs |  | — | Taken only with reasoning effort "none". |
| reasoning |  | — | Reasoning effort; reasoning tokens count toward max_tokens. |
| max_tokens | 16 to 128000 | — | The most output tokens to generate. |

## What can you do with GPT-6.1 Terra in Claude Code?

Turn a reproducible bug or a screenshot discrepancy into a focused code fix. Give the agent the relevant project files, the expected behavior, and a check that proves the change works.

### Screenshot review

Ask Terra to explain a settings screen, identify visible discrepancies, or summarize a dashboard. Supply enlarged text where labels or numbers are hard to read.

### Focused bug fixes

Give Terra a reproducible failure and a clear expected result. Ask for a limited patch and a regression check that demonstrates the fix.

### Concise summaries

Turn supplied notes into a short decision brief, handoff, or customer explanation. Specify the audience, length, and details the summary must preserve.

### Review of a difficult decision

Try Terra Pro on a bounded problem with conflicting evidence or several competing explanations. Request a recommendation tied to the supplied evidence and an explicit list of unresolved questions.

### Desktop record checks

Use Terra to inspect visible records against stated criteria. Define the expected final state and ask the agent to verify it before reporting completion.

### Comparison of proposed fixes

Ask Terra Pro to compare two fixes against the same reproduction case, constraints, and regression requirements. Request the smallest change that satisfies those requirements.

## Overview

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

## GPT-6.1 Terra in other agents

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

## More Claude Code guides

- [GPT-6.1 Sol Pro](https://spiral.ai/integrations/claude-code/gpt-6-1-sol-pro)
- [GPT-6.1 Terra Pro](https://spiral.ai/integrations/claude-code/gpt-6-1-terra-pro)
- [GPT-6.1 Sol](https://spiral.ai/integrations/claude-code/gpt-6-1-sol)
- [GPT-6.2 Astra](https://spiral.ai/integrations/claude-code/gpt-6-2-astra)
- [GPT-6 Sol Pro](https://spiral.ai/integrations/claude-code/gpt-6-sol-pro)
- [GPT-6.2 Astra Pro](https://spiral.ai/integrations/claude-code/gpt-6-2-astra-pro)

## Questions about GPT-6.1 Terra in Claude Code

**Can Claude Code use GPT-6.1 Terra?**

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

**How much does GPT-6.1 Terra cost in Claude Code?**

Up to $0.026682 per run at the default inputs. $1.30 per 1M input tokens, $0.065 per 1M cached input tokens, $1.625 per 1M cache write tokens, $6.50 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 OpenAI account to use GPT-6.1 Terra in Claude Code?**

No. Spiral runs GPT-6.1 Terra on its own OpenAI account. You sign in to Spiral once and never paste a key.

**How long does it take to set up GPT-6.1 Terra in Claude Code?**

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

**Does Claude Code wait while GPT-6.1 Terra runs?**

GPT-6.1 Terra runs in the background. Claude Code starts the run, checks on it and gives you the text, json when it's ready.

**What is GPT-6.1 Terra good at?**

Use it to interpret screenshots, navigate desktop apps, write concise summaries, and fix narrowly scoped bugs. These are the tasks OpenAI specifically recommends for Terra.

**How does Terra Pro differ from Terra?**

Terra Pro uses the same underlying model with pro reasoning enabled. Its additional reasoning is intended for complex tasks where answer quality needs extra attention.

**How much material can Terra handle, and how long can its answers be?**

OpenAI lists a 1,050,000-token context window and a maximum output of 128,000 tokens. Internal reasoning shares the generated-token budget, so that maximum is not a promise of 128,000 tokens of visible text.

**Can Terra create images, audio, or video directly?**

Terra directly produces text and accepts text and images. Its model specification does not list direct audio or video support.

**What should I do when a screenshot contains tiny text?**

Enlarge the relevant text before asking Terra to read it. Ask it to identify anything unreadable so your task does not depend on a guessed label or number.

