配置
模型配置
了解Claude Code模型配置,包括像opusplan
这样的模型别名
可用模型
对于Claude Code中的model
设置,您可以配置:
- 一个模型别名
- 一个完整的**模型名称**
- 对于Bedrock,一个ARN
模型别名
模型别名提供了一种便捷的方式来选择模型设置,无需记住确切的版本号:
模型别名 | 行为 |
---|---|
default | 推荐的模型设置,取决于您的账户类型 |
sonnet | 使用最新的Sonnet模型(目前是Sonnet 4)进行日常编码任务 |
opus | 使用最强大的Opus模型(目前是Opus 4.1)进行复杂推理 |
haiku | 使用快速高效的Haiku模型进行简单任务 |
sonnet[1m] | 使用具有100万令牌上下文窗口的Sonnet进行长会话 |
opusplan | 特殊模式,在计划模式下使用opus ,然后切换到sonnet 进行执行 |
设置您的模型
您可以通过几种方式配置您的模型,按优先级顺序列出:
- 会话期间 - 使用
/model <alias|name>
在会话中切换模型 - 启动时 - 使用
claude --model <alias|name>
启动 - 环境变量 - 设置
ANTHROPIC_MODEL=<alias|name>
- 设置 - 使用
model
字段在您的设置文件中永久配置。
使用示例:
设置文件示例:
特殊模型行为
default
模型设置
default
的行为取决于您的账户类型。
对于某些Max用户,如果您达到Opus的使用阈值,Claude Code将自动回退到Sonnet。
opusplan
模型设置
opusplan
模型别名提供了一种自动化的混合方法:
- 在计划模式下 - 使用
opus
进行复杂推理和架构决策 - 在执行模式下 - 自动切换到
sonnet
进行代码生成和实现
这为您提供了两全其美的效果:Opus在规划方面的卓越推理能力,以及Sonnet在执行方面的效率。
使用[1m]扩展上下文
对于Console/API用户,可以在完整模型名称后添加[1m]
后缀来启用100万令牌上下文窗口。
注意:扩展上下文模型有不同的定价。
检查您当前的模型
您可以通过几种方式查看您当前使用的模型:
- 在状态行中(如果已配置)
- 在
/status
中,它还会显示您的账户信息。
环境变量
您可以使用以下环境变量来控制别名映射到的模型名称,这些变量必须是完整的模型名称。
环境变量 | 描述 |
---|---|
ANTHROPIC_DEFAULT_OPUS_MODEL | 用于opus 的模型,或当计划模式激活时用于opusplan 的模型。 |
ANTHROPIC_DEFAULT_SONNET_MODEL | 用于sonnet 的模型,或当计划模式未激活时用于opusplan 的模型。 |
ANTHROPIC_DEFAULT_HAIKU_MODEL | 用于haiku 的模型,或后台功能的模型 |
CLAUDE_CODE_SUBAGENT_MODEL | 用于子代理的模型 |
注意:ANTHROPIC_SMALL_FAST_MODEL
已弃用,改为使用ANTHROPIC_DEFAULT_HAIKU_MODEL
。