Files

129 lines
5.3 KiB
Markdown
Raw Permalink Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
source: https://code.claude.com/docs/en/model-config
title: Model configuration
---
## [​](#available-models) Available models
For the `model` setting in Claude Code, you can configure either:
- A **model alias**
- A **model name**
- Anthropic API: A full **[model name](https://docs.claude.com/en/docs/about-claude/models/overview#model-names)**
- Bedrock: an inference profile ARN
- Foundry: a deployment name
- Vertex: a version name
### [​](#model-aliases) Model aliases
Model aliases provide a convenient way to select model settings without
remembering exact version numbers:
| Model alias | Behavior |
| --- | --- |
| **`default`** | Recommended model setting, depending on your account type |
| **`sonnet`** | Uses the latest Sonnet model (currently Sonnet 4.5) for daily coding tasks |
| **`opus`** | Uses Opus model (currently Opus 4.5) for specialized complex reasoning tasks |
| **`haiku`** | Uses the fast and efficient Haiku model for simple tasks |
| **`sonnet[1m]`** | Uses Sonnet with a [1 million token context window](https://docs.claude.com/en/docs/build-with-claude/context-windows#1m-token-context-window) window for long sessions |
| **`opusplan`** | Special mode that uses `opus` during plan mode, then switches to `sonnet` for execution |
### [​](#setting-your-model) Setting your model
You can configure your model in several ways, listed in order of priority:
1. **During session** - Use `/model <alias|name>` to switch models mid-session
2. **At startup** - Launch with `claude --model <alias|name>`
3. **Environment variable** - Set `ANTHROPIC_MODEL=<alias|name>`
4. **Settings** - Configure permanently in your settings file using the `model`
field.
Example usage:
```bash
# Start with Opus
claude --model opus
# Switch to Sonnet during session
/model sonnet
```
Example settings file:
```bash
{
"permissions": {
...
},
"model": "opus"
}
```
## [​](#special-model-behavior) Special model behavior
### [​](#default-model-setting) `default` model setting
The behavior of `default` depends on your account type.
For certain Max users, Claude Code will automatically fall back to Sonnet if you
hit a usage threshold with Opus.
### [​](#opusplan-model-setting) `opusplan` model setting
The `opusplan` model alias provides an automated hybrid approach:
- **In plan mode** - Uses `opus` for complex reasoning and architecture
decisions
- **In execution mode** - Automatically switches to `sonnet` for code generation
and implementation
This gives you the best of both worlds: Opus’s superior reasoning for planning,
and Sonnet’s efficiency for execution.
### [​](#extended-context-with-[1m]) Extended context with [1m]
For Console/API users, the `[1m]` suffix can be added to full model names to
enable a
[1 million token context window](https://docs.claude.com/en/docs/build-with-claude/context-windows#1m-token-context-window).
```bash
# Example of using a full model name with the [1m] suffix
/model anthropic.claude-sonnet-4-5-20250929-v1:0[1m]
```
Note: Extended context models have
[different pricing](https://docs.claude.com/en/docs/about-claude/pricing#long-context-pricing).
## [​](#checking-your-current-model) Checking your current model
You can see which model you’re currently using in several ways:
1. In [status line](/docs/en/statusline) (if configured)
2. In `/status`, which also displays your account information.
## [​](#environment-variables) Environment variables
You can use the following environment variables, which must be full **model
names** (or equivalent for your API provider), to control the model names that the aliases map to.
| Environment variable | Description |
| --- | --- |
| `ANTHROPIC_DEFAULT_OPUS_MODEL` | The model to use for `opus`, or for `opusplan` when Plan Mode is active. |
| `ANTHROPIC_DEFAULT_SONNET_MODEL` | The model to use for `sonnet`, or for `opusplan` when Plan Mode is not active. |
| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | The model to use for `haiku`, or [background functionality](/docs/en/costs#background-token-usage) |
| `CLAUDE_CODE_SUBAGENT_MODEL` | The model to use for [subagents](/docs/en/sub-agents) |
Note: `ANTHROPIC_SMALL_FAST_MODEL` is deprecated in favor of
`ANTHROPIC_DEFAULT_HAIKU_MODEL`.
### [​](#prompt-caching-configuration) Prompt caching configuration
Claude Code automatically uses [prompt caching](https://docs.claude.com/en/docs/build-with-claude/prompt-caching) to optimize performance and reduce costs. You can disable prompt caching globally or for specific model tiers:
| Environment variable | Description |
| --- | --- |
| `DISABLE_PROMPT_CACHING` | Set to `1` to disable prompt caching for all models (takes precedence over per-model settings) |
| `DISABLE_PROMPT_CACHING_HAIKU` | Set to `1` to disable prompt caching for Haiku models only |
| `DISABLE_PROMPT_CACHING_SONNET` | Set to `1` to disable prompt caching for Sonnet models only |
| `DISABLE_PROMPT_CACHING_OPUS` | Set to `1` to disable prompt caching for Opus models only |
These environment variables give you fine-grained control over prompt caching behavior. The global `DISABLE_PROMPT_CACHING` setting takes precedence over the model-specific settings, allowing you to quickly disable all caching when needed. The per-model settings are useful for selective control, such as when debugging specific models or working with cloud providers that may have different caching implementations.