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

Claude Code · LLMReleased 2025-07-22

How to Use UI-TARS 1.5 7B in Claude Code

UI-TARS 1.5 7B turns screenshots and task instructions into mouse and keyboard actions for computer workflows. Unlike the higher-performing UI-TARS 1.5 research model, it focuses on general computer use and is not optimized for games.

Prompts to try with UI-TARS 1.5 7B in Claude Code

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

Use UI-TARS 1.5 7B to test this project's search page. Read the expected behavior in the repository, then use browser screenshots to search for headphones and select the in-stock filter, requesting one action at a time.

UI-TARS 1.5 7BClaude Code
Try asking
  • Use UI-TARS 1.5 7B on the failing checkout screenshot in this project. Locate the Continue button and return only the click action; mark the predicted point on the screenshot for review.

  • Use UI-TARS 1.5 7B to exercise this project's profile editor with the test data in the repository. Fill the visible fields, stop before saving, and capture the resulting screen.

  • Use UI-TARS 1.5 7B to reproduce the navigation bug described in this project's issue notes. Supply the current screenshot and action history at each step, and record where the visible result first differs from the expected behavior.

  • Use UI-TARS 1.5 7B to check this project's settings flow. Start with temperature 0 and a 400-token output budget, request Thought and Action sections, and navigate to notification preferences one action at a time.

How to set up UI-TARS 1.5 7B 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 UI-TARS 1.5 7B

    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": "bytedance/ui-tars-1.5-7b",
        "input": {
          "messages": [
            {
              "role": "system"
            }
          ]
        }
      }'

Then paste one of the prompts above: Claude Code finds UI-TARS 1.5 7B on Spiral, shows the price and runs it.

UI-TARS 1.5 7B providers and prices

Spiral runs UI-TARS 1.5 7B through OpenRouter. Open a card for today's price, with every fee included.

OpenRouterLLM
ByteDance: UI-TARS 7B
bytedance/ui-tars-1.5-7b

Settings you can ask for

Ask Claude Code for any of these in your prompt.

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

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 ByteDance: UI-TARS 7B is on its tool page: open its card above.

What can you do with UI-TARS 1.5 7B in Claude Code?

UI-TARS 1.5 7B can help test a project's interface through screenshots and mouse or keyboard actions. Give it a concrete workflow and inspect the visible result after each step.

Find a control in a screenshot

Ask UI-TARS 1.5 7B to locate a named button or menu item and return only the next click action.

Test a browser workflow

Use screenshots and action history to work through a search, filter, or form flow. Check the screen after each action against the expected result.

Navigate desktop settings

Give UI-TARS 1.5 7B a specific destination, such as a display settings panel, and request the next mouse or keyboard action.

Prepare a form draft

Supply the visible form and exact text to enter. Request actions to fill the fields and stop before submission.

Work through an office interface

Use visible menus, clicks, typing, and keyboard shortcuts to guide a bounded task in a spreadsheet or document editor.

Navigate a file manager

Provide a screenshot and a target folder name. Request the next action to reach that folder, with a new screenshot after navigation.

Questions about UI-TARS 1.5 7B in Claude Code

Can Claude Code use UI-TARS 1.5 7B?

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run UI-TARS 1.5 7B like any built-in tool.

How much does UI-TARS 1.5 7B cost in Claude Code?

Up to $0.000539 per run at the default inputs. $0.13 per 1M input tokens, $0.26 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 UI-TARS 1.5 7B in Claude Code?

No. Spiral runs UI-TARS 1.5 7B on its own OpenRouter account. You sign in to Spiral once and never paste a key.

How long does it take to set up UI-TARS 1.5 7B in Claude Code?

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

Does Claude Code wait while UI-TARS 1.5 7B runs?

UI-TARS 1.5 7B runs in the background. Claude Code starts the run, checks on it and gives you the text, json when it's ready.

What is UI-TARS 1.5 7B useful for?

It is designed for computer tasks that involve reading a screen and choosing mouse or keyboard actions. Practical uses include navigating forms, finding controls, and working through desktop interfaces.

What does UI-TARS 1.5 7B return?

The documented computer-use format has Thought and Action sections. For locating a target on screen, the grounding prompt requests an action alone.

What should I include in a UI-TARS 1.5 7B prompt?

Supply the task, a current screenshot, and the preceding action history. Ask for the next action toward a concrete result, such as opening a particular settings panel.

Is UI-TARS 1.5 7B optimized for games?

ByteDance says the released 7B model focuses on general computer use and is not specifically optimized for games. The stronger game results described for UI-TARS 1.5 should not be attributed to the 7B model.

Which generation settings are a useful starting point?

ByteDance's example uses temperature 0 and a 400-token output budget. Treat those as starting values for short action responses, rather than a statement of the model's maximum output length.

Get started

Start using UI-TARS 1.5 7B 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