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

Claude Code · LLMReleased 2026-02-23

How to Use Gemini 3.1 Pro Custom Tools in Claude Code

Gemini 3.1 Pro Custom Tools suits coding and investigations that combine Bash with custom search and inspection tools. Compared with Gemini 3.1 Pro Preview, it prioritizes custom tools more strongly, though Google warns of quality fluctuations on tasks that do not benefit from tools.

Prompts to try with Gemini 3.1 Pro Custom Tools in Claude Code

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

Use Gemini 3.1 Pro Custom Tools to investigate the failing tests in this repository. Search and inspect the relevant code, reproduce one failure, make the smallest justified fix, and report the test results.

Gemini 3.1 Pro Custom ToolsClaude Code
Try asking
  • Use Gemini 3.1 Pro Custom Tools with high reasoning to audit the retry logic in this project. Trace callers and error handling, identify a reproducible duplicate-processing path, and add a focused regression test.

  • Use Gemini 3.1 Pro Custom Tools to refactor the duplicated validation code in this repository. Find all callers before editing, preserve current behavior, and run the relevant checks after each meaningful change.

  • Use Gemini 3.1 Pro Custom Tools to compare this branch with the main branch. Inspect changed behavior and related tests, then return the three most consequential findings with file references and evidence.

  • Use Gemini 3.1 Pro Custom Tools to trace this project's request lifecycle from route to database call. Use search and inspection tools, then produce a concise map of the actual code paths and unresolved assumptions.

How to set up Gemini 3.1 Pro Custom Tools 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 Gemini 3.1 Pro Custom Tools

    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": "vertex",
        "model": "google/gemini-3.1-pro-preview-customtools",
        "input": {
          "messages": [
            {
              "role": "system"
            }
          ]
        }
      }'

Then paste one of the prompts above: Claude Code finds Gemini 3.1 Pro Custom Tools on Spiral, shows the price and runs it.

Gemini 3.1 Pro Custom Tools providers and prices

Spiral runs Gemini 3.1 Pro Custom Tools through Vertex AI. Open a card for today's price, with every fee included.

Vertex AILLM
Gemini 3.1 Pro Preview Custom Tools
google/gemini-3.1-pro-preview-customtools

Settings you can ask for

Ask Claude Code for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Seeda whole number
Top p0 to 1
Max tokens1 to 65536

The most output tokens to generate.

Temperature0 to 2
Presence penaltya number from -2
Reasoning effortlow, medium, or highhigh

How much the model reasons.

Frequency penaltya number from -2

Every API field of Gemini 3.1 Pro Preview Custom Tools is on its tool page: open its card above.

What can you do with Gemini 3.1 Pro Custom Tools in Claude Code?

Trace a failure from code search to a tested fix with Gemini 3.1 Pro Custom Tools. Its emphasis on custom tools suits work that combines repository inspection with Bash commands.

Trace a bug across a repository

Use code search and inspection tools to follow a failing request through the relevant modules. Ask for a minimal patch and a test that reproduces the failure.

Plan and verify a refactor

Find callers, inspect assumptions, and change one interface at a time. Request a report of affected behavior and the checks used to verify it.

Investigate recurring test failures

Combine test output, code inspection, and targeted test runs to examine intermittent failures. Separate reproduced causes from hypotheses that still need evidence.

Prepare a support investigation

Retrieve account history, order records, and relevant policy through custom tools. Build a timeline and draft a response that distinguishes confirmed facts from missing information.

Triage operational incidents

Query monitoring data and deployment history, then compare the timing of errors and changes. Produce an evidence-based incident brief with the next checks to run.

Investigate business data discrepancies

Retrieve related records from business systems and use calculation tools to compare totals. Return discrepancies with record references and leave unresolved matches explicit.

Turn retrieved evidence into a structured report

Search a knowledge base for material relevant to a question, compare conflicting statements, and return a concise report or schema-constrained JSON for downstream validation.

Questions about Gemini 3.1 Pro Custom Tools in Claude Code

Can Claude Code use Gemini 3.1 Pro Custom Tools?

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Gemini 3.1 Pro Custom Tools like any built-in tool.

How much does Gemini 3.1 Pro Custom Tools cost in Claude Code?

Up to $0.063989 per run at the default inputs. $2.60 per 1M input tokens, $0.26 per 1M cached input tokens, $0.4875 per 1M cache write tokens, $15.60 per 1M output tokens; for a prompt above 200,000 tokens, $5.20 per 1M input tokens, $0.52 per 1M cached input tokens, $0.975 per 1M cache write tokens, $23.40 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 a Vertex AI account to use Gemini 3.1 Pro Custom Tools in Claude Code?

No. Spiral runs Gemini 3.1 Pro Custom Tools on its own Vertex AI account. You sign in to Spiral once and never paste a key.

How long does it take to set up Gemini 3.1 Pro Custom Tools in Claude Code?

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

Does Claude Code wait while Gemini 3.1 Pro Custom Tools runs?

Gemini 3.1 Pro Custom Tools runs in the background. Claude Code starts the run, checks on it and gives you the text, json when it's ready.

How does Gemini 3.1 Pro Custom Tools differ from Gemini 3.1 Pro Preview?

It prioritizes custom tools more strongly in workflows that also use Bash. Choose it for tasks that benefit from searching, inspecting evidence, and acting on tool results.

Is Gemini 3.1 Pro Custom Tools better for every task?

Google warns of quality fluctuations on tasks that do not benefit from tools. Test it on your actual work before choosing it for standalone writing or simple questions.

How much context and output can Gemini 3.1 Pro Custom Tools handle?

Google lists a maximum of 1,048,576 input tokens and 65,536 output tokens for Gemini 3.1 Pro. These are token limits, so request a specific answer length rather than treating them as page counts.

Can Gemini 3.1 Pro Custom Tools return reliable JSON?

Structured output can constrain the response to a supplied JSON Schema. Validate the returned values against the evidence because valid JSON can still contain incorrect information.

Which setting should I test first for difficult investigations?

Start with the default high reasoning level for a difficult investigation. Compare lower reasoning levels on routine tasks and keep the lowest level that passes your quality checks.

Get started

Start using Gemini 3.1 Pro Custom Tools 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