Claude Code 模型配置完全指南

了解 Claude Code 模型配置，包括模型别名如 opusplan

可用模型

对于 Claude Code 中的 model 设置，你可以配置以下任一项：

• 一个模型别名
• 一个模型名称
  • Anthropic API：完整的模型名称
  • Bedrock：推理配置文件 ARN
  • Foundry：部署名称
  • Vertex：版本名称

模型别名

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

别名始终指向最新版本。要固定到特定版本，请使用完整模型名称（例如 claude-opus-4-5-20251101）或设置相应的环境变量，如 ANTHROPIC_DEFAULT_OPUS_MODEL。

设置你的模型

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

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 和 Teams：默认为 Opus 4.6
• Pro：在 Claude Code 中默认为 Opus 4.6
• Enterprise：Opus 4.6 可用但不是默认值

如果你在使用 Opus 时达到使用阈值，Claude Code 可能会自动回退到 Sonnet。

opusplan 模型设置

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

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

这给你两全其美：Opus 的优越推理能力用于规划，Sonnet 的效率用于执行。

调整努力级别

努力级别控制 Opus 4.6 的自适应推理，它根据任务复杂性动态分配思考。较低的努力级别对于直接任务更快更便宜，而较高的努力级别为复杂问题提供更深入的推理。

有三个级别可用：低、中 和 高（默认）。

设置努力级别：

• 在 /model 中：选择模型时使用左右箭头键调整努力级别滑块
• 环境变量：设置 CLAUDE_CODE_EFFORT_LEVEL=low|medium|high
• 设置：在设置文件中设置 effortLevel

努力级别目前在 Opus 4.6 上受支持。当选择受支持的模型时，努力级别滑块会出现在 /model 中。

使用 [1m] 扩展上下文

[1m] 后缀为长会话启用 100 万 token 上下文窗口。

你可以将 [1m] 后缀与模型别名或完整模型名称一起使用：

# 使用 sonnet[1m] 别名
/model sonnet[1m]

# 或将 [1m] 附加到完整模型名称
/model claude-sonnet-4-5-20250929[1m]

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

检查你当前的模型

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

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

环境变量

你可以使用以下环境变量，这些变量必须是完整的模型名称（或你的 API 提供商的等效项），以控制别名映射到的模型名称。

Prompt caching 配置

Claude Code 自动使用 prompt caching 来优化性能并降低成本。你可以全局禁用 prompt caching 或针对特定模型层禁用：

这些环境变量为你提供了对 prompt caching 行为的细粒度控制。全局 DISABLE_PROMPT_CACHING 设置优先于特定模型设置，允许你在需要时快速禁用所有缓存。