模型配置

可用模型

模型别名

模型别名	行为
default	推荐的模型设置，取决于您的账户类型
sonnet	使用最新的 Sonnet 模型用于日常编码任务
opus	使用 Opus 模型用于专门的复杂推理任务
haiku	使用快速高效的 Haiku 模型用于简单任务
sonnet[1m]	使用 Sonnet 与 100 万令牌上下文窗口
opusplan	在计划模式期间使用 opus，然后在执行期间切换到 sonnet

设置您的模型

您可以通过多种方式配置模型，按优先级顺序：

1. 在会话期间 - 使用 /model <alias|name> 在会话中间切换模型
2. 在启动时 - 使用 claude --model <alias|name> 启动
3. 环境变量 - 设置 ANTHROPIC_MODEL=<alias|name>
4. 设置 - 使用 model 字段在您的设置文件中永久配置

使用示例：

claude --model sonnet
claude --model opus
claude --model claude-sonnet-4-5-20250929

设置文件示例：

{
  "model": "sonnet"
}

特殊模型行为

default 模型设置

default 的行为取决于您的账户类型。对于某些 Max 用户，如果您在使用 Opus 时达到使用阈值，Claude Code 将自动回退到 Sonnet。

opusplan 模型设置

opusplan 模型别名提供了一种自动化的混合方法：

• 在计划模式期间使用 Opus 进行研究和规划
• 在执行期间切换到 Sonnet 进行实现

使用 [1m] 扩展上下文

对于 Console/API 用户，可以将 [1m] 后缀添加到完整模型名称以启用 100 万令牌上下文窗口。

检查您当前的模型

• 在状态行中（如果已配置）
• 在 /status 中

环境变量

环境变量	描述
ANTHROPIC_DEFAULT_OPUS_MODEL	用于 opus 的模型
ANTHROPIC_DEFAULT_SONNET_MODEL	用于 sonnet 的模型
ANTHROPIC_DEFAULT_HAIKU_MODEL	用于 haiku 的模型
CLAUDE_CODE_SUBAGENT_MODEL	用于子代理的模型

提示缓存配置

Claude Code 自动使用提示缓存来优化性能。您可以禁用提示缓存：

环境变量	描述
DISABLE_PROMPT_CACHING	禁用所有模型的提示缓存
DISABLE_PROMPT_CACHING_HAIKU	仅禁用 Haiku 模型的提示缓存
DISABLE_PROMPT_CACHING_SONNET	仅禁用 Sonnet 模型的提示缓存
DISABLE_PROMPT_CACHING_OPUS	仅禁用 Opus 模型的提示缓存