# CLAUDE_CODE_EFFORT_LEVEL

> It sets the effort level, from low to max.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** CLAUDE_EFFORT

## Think of it like

It is like you tell a helper to work fast or take great care.

## Definition

CLAUDE_CODE_EFFORT_LEVEL sets how much effort the model puts into each answer. The values are low, medium, high, xhigh and max, and which ones work depends on the model. It wins over the --effort flag, the /effort command and the settings. A max cap set by an admin still holds. Set it to auto to let the API pick.

## Example

Lucy wants her nightly job to think hard. She sets this to high in the job, and her daytime chats keep their own level.

## Example code

```bash
export CLAUDE_CODE_EFFORT_LEVEL=high
claude
```

Run every session at high effort.

## Why it matters

More effort means better answers on hard work, but it costs more and takes longer.

## Common mistake

Setting it and then asking why /effort does nothing. This one wins over the command.

## Three principles

- **Five levels.** low to max.
- **Wins over flag and command.** And settings.
- **Cap still holds.** maxEffortLevel.

## Related terms

- [Claude Code Effort Level](https://learn.benibix.com/term/ai/claude-code-effort-level)
- [MAX_THINKING_TOKENS](https://learn.benibix.com/term/ai/max-thinking-tokens-variable)
- [CLAUDE_CODE_ALWAYS_ENABLE_EFFORT](https://learn.benibix.com/term/ai/claude-code-always-enable-effort-variable)

![CLAUDE_CODE_EFFORT_LEVEL beats the flag, the command and the settings. The max cap still holds.](https://learn.benibix.com/diagrams/env-effort-order.svg)

---

Source: https://learn.benibix.com/term/ai/claude-code-effort-level-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-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
