Skip to content
Learn Kiro.

Recipes · Chapter 51 of 63

Change the Default Model

Change Kiro's model in the IDE chat input or the CLI, understand what Auto does, and set effort defaults in chat.modelDefaults.

Beginner friendly 2 min read last reviewed 2026-09-04

◎ Learning objective

Switch the model Kiro uses for a conversation and decide whether Auto or a fixed model suits your work.

Kiro lets you pick which model answers, and the default is Auto. Changing it takes one click in the IDE, and the main decision is whether you have a reason to leave Auto at all.

When to use this

Change the model when a task has a shape Auto is not built for: an extremely long context, or bulk mechanical work where a cheap model is enough. Leave it on Auto the rest of the time. Auto carries a 1.0x credit multiplier, which is the baseline every other multiplier is measured against.

Steps

  1. Open the chat input in the Kiro IDE and click the model name. The panel that opens is where you pick the model and the reasoning effort.
  2. Choose a model, or leave Auto selected. Auto routes to frontier models with automatic fallback, uses intent detection and caching, and never routes to experimental models. On the Free plan it routes to Sonnet-class models or better, and on paid plans to Opus-class or better.
  3. Check what the choice costs. Each model has a credit multiplier relative to Auto’s 1.0x, and a context window. Choosing a Model has the current table.
  4. In the CLI, set your preference in a session. Kiro CLI has kept persistent model preferences since v2.6.0, so the choice carries into later sessions rather than resetting each time.
  5. Set the reasoning effort separately. Effort is not the model, and lowering it is often the cheaper change. Use /effort in the CLI, or the same IDE panel. See Set the reasoning effort.
  6. Store effort defaults under chat.modelDefaults in ~/.kiro/settings/cli.json for yourself, or .kiro/settings/cli.json for a project. Session settings beat workspace, workspace beats user, and user beats Kiro’s built-in default.

Check it worked

Send a short prompt and look at the model name shown in the chat input. It should match what you picked. Then start a brand new session and check again: if it reverted, you changed the model for one conversation rather than setting a preference. Watch your credit usage for a day after switching to a higher multiplier, because the difference is easy to miss until the bill arrives.

Common problems

  • The model is not in the list. Model availability changes and some models are marked experimental. The current lineup lives at kiro.dev/docs.
  • Credits drain faster than before. You moved from Auto’s 1.0x to a higher multiplier. Opus-class models sit at 2.2x and GPT-5.6 Sol at 2.4x.
  • The answer got worse on a cheap model. Cheap models suit mechanical work. Move back to Auto for anything that needs judgement.
  • The choice resets. You set it for one session rather than as a preference.
  • You wanted faster answers, not a different model. Lower the reasoning effort instead. It is usually the better lever.

Frequently asked questions

How do I change the model in Kiro?

In the Kiro IDE, click the model name in the chat input. That opens the panel where you choose the model and the reasoning effort. Kiro CLI keeps persistent model preferences, added in v2.6.0, so your choice carries between sessions.

What is Kiro's default model?

Kiro's default is Auto, a router rather than a single model. It combines frontier models with specialised ones plus intent detection and caching, with a 1.0x credit multiplier by definition. On the Free plan it routes to Sonnet-class models or better; on paid plans, Opus-class or better.

Should a beginner change the model?

No. Start on Auto. It has the lowest credit multiplier, a 1M context window, and it never routes to experimental models. Pick a specific model only when you have a reason, such as needing a very large context window or a cheaper model for mechanical work.

☰ Chapter summary

  • In the IDE, click the model name in the chat input to open the model and effort panel.
  • Auto is a router, not a model: it picks a frontier model automatically and never routes to experimental ones.
  • Auto uses Sonnet-class or better on Free, and Opus-class or better on paid plans.
  • Kiro CLI keeps persistent model preferences, added in v2.6.0.
  • chat.modelDefaults in ~/.kiro/settings/cli.json or .kiro/settings/cli.json sets effort defaults per scope.

All chapter summaries are collected on the revision page.

Was this chapter helpful?