> For the index of every page in Orbital's docs, read https://docs.beta.runorbital.dev/llms.txt.

# Use different models

> Run different steps on different harnesses, models and efforts

Run cheap steps on a small model and expensive steps on a large one by giving each step its own Model settings. Name the settings on the workflow, then pick one per step:

```dot title="ship.dot"
digraph ship {
  graph [
    version="1",
    entry="implement",
    model_settings="Balanced { effort: medium; } Codex review { harness: codex; model: gpt-6-sol; effort: high; }"
  ]
  implement [model_settings="Balanced", prompt="Implement this goal: {{ inputs.goal }}"]
  review [model_settings="Codex review", prompt="Review the change. Report what you find. Do not change files."]
  done [shape="Msquare"]
  implement -> review
  review -> done
}
```

A step can also get its Model settings through a Role, which brings a Persona and Tool access too. [Roles and tool access](/roles/) defines these, and [Give steps a role](/roles/configure-steps/) shows how to pick them in the editor.

Orbital works out the harness, model, effort, connection and provider separately for every step. So a step that changes only its effort keeps the model it would have had.

## Before you start

- Sign in to each harness you want to use. Follow [Install Orbital](/get-started/install/#2-install-and-sign-in-to-a-harness) before you try a model.

## Name models in Model settings

The library holds named Model settings in **Settings > Model settings**. Each can set a harness, a model and an effort. Give a step one of them, directly or through its Role.

![Settings, Model settings page lists Balanced and Deep thinking, each with its harness and effort.](/screenshots/settings-model-settings.webp?v=01d7f10060)

*Each entry sets a harness, model or effort under one name.*

The harness names are claude, codex and opencode. Effort accepts minimal, low, medium, high, xhigh, max and ultra, but each harness accepts only some of them. Orbital refuses a harness and effort that do not go together before any turn starts, so a run does not fail halfway through.

## Pick a model for the run

The harness and model picker in the new-run composer starts at **Default harness**, which follows the workflow and your settings. Pick a harness's default model, such as "Codex default model", to make that the run's harness. Or pick a model by name. [Which harness a step uses](/harnesses/#which-harness-a-step-uses) explains which steps follow the run's harness.

Choosing a model sets the workflow's default for that harness. A step's own model, its Model settings and its Role still come first. Changing the harness clears the model you chose.

The picker shows each model's reference price in USD per million input and output tokens, when Orbital knows it. A model in the picker is a suggestion: your sign-in decides whether you can use it. [Models and prices](/reference/models/) lists every suggested model and its price, and explains how Orbital estimates a run's cost.

## Resolution order

Orbital decides each setting on its own, and the most specific choice wins:

1. what a step sets itself
2. the Model settings it names
3. its Role
4. what an import placeholder chooses for it
5. the model stylesheet
6. the workflow's choices
7. the run's choice and the harness default

A setting for one harness, such as `codex_model`, beats a plain one, such as `model`. [Attributes](/reference/attributes/#resolution-order) gives the exact order.

Harness-specific attributes such as `claude_model`, `codex_effort` and `opencode_provider` work on workflows, agent steps, Model settings blocks and stylesheet rules. Orbital checks their names and values even when the step runs on another harness. So a typo shows up when you validate the workflow, not on the turn that needs it. [Attributes](/reference/attributes/#harness-specific-attributes) lists them all.

The settings inside an imported workflow apply when you run that workflow on its own. They never become defaults for the workflow that imports it. Put shared settings in the parent workflow, or choose them on the placeholder. See [Reuse a workflow](/workflows/reuse-a-workflow/).

:::note
Permissions default to auto-accept. Each harness treats `permissions` differently. Tool access, not permissions or the prompt, limits what a step can do. [Permissions](/roles/#permissions) explains both.
:::

## See which model a run used

The run page names the harness and the model the latest turn reported. They appear in the footer under the composer, beside the workflow, the branch and the pull request. Where the composer is not on screen, such as on an ended run, the header names them instead.

Before a turn reports a model, the page shows the model the turn asked for, marked "(configured)", or "Model not known yet". A run that used several models shows the latest with a count of the others. The transcript records the settings each turn ran with. It is the fastest way to check that your settings did what you meant.

The **Tokens by model** table on the run's **Cost** tab lists each model the run used.

![A run's Cost tab shows tokens and cost for each step and a Tokens by model table.](/screenshots/run-billing.webp?v=01a803de81)

*Tokens by model lists every model the run used.*

## Change harness during a run

You can move a stopped run to another harness and retry its step there. [Switch a run's harness](/harnesses/switch-harness/) describes how, what carries over, and what the quota fallback does.

## Advanced: profiles and the model stylesheet

Workflows written before roles existed may use profiles and a model stylesheet. Both still work. In the editor they sit under **More** and **Advanced**, where you edit them as text. For new workflows, prefer Model settings and Roles, which the editor offers as pickers. [Attributes](/reference/attributes/#advanced-profiles-and-model-stylesheet) gives the syntax.

## Related

- [Give steps a role](/roles/configure-steps/): pick Model settings and Roles in the editor
- [Roles and tool access](/roles/): the building blocks and what ships
- [Harnesses and models](/harnesses/): which harness a step uses
- [Switch a run's harness](/harnesses/switch-harness/): move a stopped run to another harness
- [Models and prices](/reference/models/): suggested models and how cost is estimated
- [Attributes](/reference/attributes/#resolution-order): the exact resolution order