模型配置

​

可用模型

对于 Claude Code 中的 model 设置，您可以配置：

• 一个模型别名
• 一个完整的**模型名称**
• 对于 Bedrock，一个 ARN

​

模型别名

模型别名提供了一种便捷的方式来选择模型设置，无需记住确切的版本号：

​

设置您的模型

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

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

使用示例：

# 使用 Opus 启动
claude --model opus

# 在会话期间切换到 Sonnet
/model sonnet

设置文件示例：

{
    "permissions": {
        ...
    },
    "model": "opus"
}

​

特殊模型行为

​

default 模型设置

default 的行为取决于您的账户类型。

对于某些 Max 用户，如果您达到 Opus 的使用阈值，Claude Code 将自动回退到 Sonnet。

​

opusplan 模型设置

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

• 在计划模式下 - 使用 opus 进行复杂推理和架构决策
• 在执行模式下 - 自动切换到 sonnet 进行代码生成和实现

这为您提供了两全其美的效果：Opus 在规划方面的卓越推理能力，以及 Sonnet 在执行方面的效率。

​

使用 [1m] 扩展上下文

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

# 使用带有 [1m] 后缀的完整模型名称的示例
/model anthropic.claude-sonnet-4-20250514-v1:0[1m]

注意：扩展上下文模型有不同的定价。

​

检查您当前的模型

您可以通过几种方式查看您当前使用的模型：

1. 在状态行中（如果已配置）
2. 在 /status 中，它还会显示您的账户信息。

​

环境变量

您可以使用以下环境变量来控制别名映射到的模型名称，这些变量必须是完整的模型名称。

注意：ANTHROPIC_SMALL_FAST_MODEL 已弃用，建议使用 ANTHROPIC_DEFAULT_HAIKU_MODEL。