# CLAUDE_CODE_SUBAGENT_MODEL_FORCE

> Set to 1, it puts one model on each helper.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1

## Think of it like

It is like a rule that all the players wear one shirt. No one gets to pick.

## Definition

CLAUDE_CODE_SUBAGENT_MODEL_FORCE set to 1 puts the subagent model on each helper agent. It wins over a model Claude names. It also wins over the model in an agent's own file. That covers the Explore and Plan agents that come built in. It needs Claude Code 2.1.257 or later.

## Example

Emma's company caps cost by running all helpers on Haiku. With FORCE set, an agent file can ask for Opus and still get Haiku.

## Example code

```bash
export CLAUDE_CODE_SUBAGENT_MODEL=haiku
export CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1
claude
```

Run each helper on Haiku, no matter what.

## Why it matters

A team can be sure no helper runs on a costly model by mistake.

## Common mistake

Setting FORCE alone. It forces the model the other variable names, so that one has to be set too.

## Three principles

- **Needs the model var.** FORCE alone does nothing.
- **Beats everything.** Calls and agent files.
- **Explore and Plan too.** Built-ins included.

## Related terms

- [CLAUDE_CODE_SUBAGENT_MODEL](https://learn.benibix.com/term/ai/claude-code-subagent-model-variable)
- [Subagent](https://learn.benibix.com/term/ai/subagent)
- [Built-in Subagents](https://learn.benibix.com/term/ai/built-in-subagents)

## Told apart from

- [CLAUDE_CODE_SUBAGENT_MODEL vs CLAUDE_CODE_SUBAGENT_MODEL_FORCE](https://learn.benibix.com/compare/claude-code-subagent-model-variable-vs-claude-code-subagent-model-force-variable): People think CLAUDE_CODE_SUBAGENT_MODEL sets the model for every helper. It does not. A model in the helper's own file wins over it, and so does a model Claude names when it starts the helper. The FORCE switch, set to 1, flips that order. Then your pick wins over both, and every helper runs on it.

![A subagent takes the first model set in this order. FORCE puts the variable on top.](https://learn.benibix.com/diagrams/env-subagent-model.svg)

---

Source: https://learn.benibix.com/term/ai/claude-code-subagent-model-force-variable
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-16
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
