Spiral gives your agent every tool with one account. Browse the tools →

Claude Code · LLMReleased 2026-04-02

How to Use Gemma 4 31B in Claude Code

Gemma 4 31B suits code fixes, complex questions, and analysis of long documents. Google positions its dense architecture for answer quality, while Gemma 4 26B A4B prioritizes speed.

Prompts to try with Gemma 4 31B in Claude Code

Copy an example into Claude Code, or ask in your own words.

Use Gemma 4 31B with thinking enabled to trace the failing test through the relevant project files. Propose the smallest fix, apply it, and run the affected tests.

Gemma 4 31BClaude Code
Try asking
  • Use Gemma 4 31B to compare the API implementation with the project's documentation. List mismatches with file locations and propose corrections.

  • Use Gemma 4 31B to review the current diff for incorrect assumptions and missing edge cases. Return findings with file locations, evidence, and suggested regression checks.

  • Use Gemma 4 31B to explain the request path through this repository. Identify entry points, validation, state changes, and error handling, citing the relevant files.

  • Use Gemma 4 31B to draft a migration plan from the project's current implementation to the behavior described in its issue. Check dependencies and return ordered steps with verification criteria.

How to set up Gemma 4 31B 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.

    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.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run Gemma 4 31B

    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": "google/gemma-4-31b-it",
        "input": {
          "messages": [
            {
              "role": "system"
            }
          ]
        }
      }'

Then paste one of the prompts above: Claude Code finds Gemma 4 31B on Spiral, shows the price and runs it.

Gemma 4 31B providers and prices

Spiral runs Gemma 4 31B through OpenRouter. Open a card for today's price, with every fee included.

OpenRouterLLM
Google: Gemma 4 31B
google/gemma-4-31b-it

Settings you can ask for

Ask Claude Code for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Seeda whole number
Min p0 to 1
Top ka whole number from 0
Top p0 to 1
Logprobson or off
Max tokens1 to 16384

The most output tokens to generate.

Temperature0 to 2
Top logprobs0 to 20
Presence penalty-2 to 2
Frequency penalty-2 to 2
Repetition penalty0 to 2

Every API field of Google: Gemma 4 31B is on its tool page: open its card above.

What can you do with Gemma 4 31B in Claude Code?

Turn project code and documentation into proposed fixes, explanations, and review findings with Gemma 4 31B. Have the coding agent inspect relevant files and verify proposed changes with the project's checks.

Diagnose a code defect

Ask Gemma 4 31B to trace a failing path, propose a small correction, and suggest a regression check.

Compare long documents

Use Gemma 4 31B to compare requirements, identify contradictions, and attach supporting passages to each finding.

Extract structured records

Ask Gemma 4 31B to turn supplied text into JSON records, using null when information is absent.

Draft multilingual responses

Use Gemma 4 31B to draft replies in a requested language while preserving names and approved terminology.

Summarize research

Ask Gemma 4 31B to condense supplied research into findings, disagreements, and unanswered questions.

Check a plan against constraints

Give Gemma 4 31B a proposed plan and explicit constraints, then request conflicts and a revised sequence.

Answer questions from reference text

Use Gemma 4 31B to draft answers grounded in supplied reference material, with evidence for each conclusion.

Questions about Gemma 4 31B in Claude Code

Can Claude Code use Gemma 4 31B?

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Gemma 4 31B like any built-in tool.

How much does Gemma 4 31B cost in Claude Code?

Up to $0.00214 per run at the default inputs. $0.26 per 1M input tokens, $0.52 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 Gemma 4 31B in Claude Code?

No. Spiral runs Gemma 4 31B on its own OpenRouter account. You sign in to Spiral once and never paste a key.

How long does it take to set up Gemma 4 31B in Claude Code?

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

Does Claude Code wait while Gemma 4 31B runs?

Gemma 4 31B runs in the background. Claude Code starts the run, checks on it and gives you the text, json when it's ready.

What is Gemma 4 31B useful for?

Use it for code fixes, questions that require reasoning, summaries of long documents, and extracting information into JSON. Google positions the dense 31B model for answer quality.

How much context can Gemma 4 31B handle?

Google specifies a model context window of up to 256K tokens. That describes context capacity, not the length of a single answer.

Can Gemma 4 31B work in languages other than English?

Yes. Google describes Gemma 4 as supporting 140 languages; name the target language and explain which terms, names, or quotations should stay unchanged.

Does Gemma 4 31B have a thinking mode?

Yes. Thinking mode produces reasoning before the final answer; try it for code diagnosis, constraint checking, or questions with several dependent steps.

Which generation settings should I start with?

Google recommends temperature 1.0, nucleus sampling at 0.95, and a top-k value of 64 across use cases. Use those as a baseline before comparing changes on examples from your task.

Get started

Start using Gemma 4 31B 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 Claude Code

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options