Claude Code 支持多种模型配置方式，从简单别名到特定版本号，从个人设置到企业统一管理。本文详细介绍模型别名体系、切换方法、opusplan 混合模式以及企业模型限制配置。
模型别名体系
Claude Code 提供便捷的模型别名，无需记忆具体版本号：
| 别名 | 行为 |
|---|---|
default | 根据账户类型选择推荐模型 |
sonnet | 最新 Sonnet 模型（当前 Sonnet 4.6），适合日常编码 |
opus | 最新 Opus 模型（当前 Opus 4.6），适合复杂推理 |
haiku | 快速高效的 Haiku 模型，适合简单任务 |
sonnet[1m] | 带 100 万 Token 上下文窗口的 Sonnet，适合超长会话 |
opusplan | 特殊模式：Plan 阶段用 Opus，执行阶段切换到 Sonnet |
重要提示：别名始终指向最新版本。若需锁定特定版本，使用完整模型名称（如 claude-opus-4-6）或设置对应环境变量（如 ANTHROPIC_DEFAULT_OPUS_MODEL）。
default 别名的不同行为
default 根据你的订阅类型有不同的默认模型：
| 订阅类型 | Default 对应模型 |
|---|---|
| Max / Team Premium | Opus 4.6 |
| Pro / Team Standard | Sonnet 4.6 |
| Enterprise | Opus 4.6 可用，但不是默认 |
当 Opus 使用量达到阈值时，Claude Code 可能自动降级到 Sonnet。
4 种模型切换方式
按优先级从高到低：
1. 会话中切换（最高优先级）
/model sonnet
/model opus
/model haiku
/model claude-sonnet-4-6 # 使用具体版本号2. 启动时指定
claude --model opus
claude --model sonnet
claude --model haiku3. 环境变量
export ANTHROPIC_MODEL=opus
export ANTHROPIC_MODEL=sonnet
export ANTHROPIC_MODEL=claude-sonnet-4-64. settings.json 永久配置（最低优先级）
{
"model": "opus"
}opusplan：最聪明的混合模式
opusplan 是 Claude Code 最具创意的模型别名：
- Plan 阶段：使用 Opus 进行复杂推理和架构决策
- 执行阶段：自动切换到 Sonnet 进行代码生成
这个设计兼顾了质量和成本：
- Opus 的卓越推理能力用于最需要它的地方（规划）
- Sonnet 的高效率用于代码生成
- 整体成本远低于全程使用 Opus
使用方式：
claude --model opusplan或在 settings.json 中设置：
{
"model": "opusplan"
}适用场景：
- 架构重构（需要 Opus 的系统思维）
- 新功能规划（需要理解全局影响）
- 复杂 Bug 的根因分析
努力级别（Effort Level）
Opus 4.6 支持调整推理深度，平衡速度和质量：
| 级别 | 适用场景 |
|---|---|
low | 简单直接的任务，速度最快 |
medium | 中等复杂度任务 |
high（默认） | 复杂问题，最深推理 |
设置方式：
# 环境变量
export CLAUDE_CODE_EFFORT_LEVEL=low # 或 medium 或 high
# settings.json
{
"effortLevel": "low"
}
# 会话中通过 /model 命令的方向键调整当前仅 Opus 4.6 支持努力级别调整。
100 万 Token 上下文窗口
sonnet[1m] 别名激活 Sonnet 的 100 万 Token 上下文窗口：
适用场景：
- 超大代码库分析
- 超长对话会话
- 需要同时理解大量文件的任务
注意：100 万 Token 上下文会带来更高的 Token 消耗，按需使用。
企业模型限制配置
管理员可通过 availableModels 限制用户可选的模型：
{
"availableModels": ["sonnet", "haiku"]
}设置后，用户无法通过 /model、--model、Config 工具或 ANTHROPIC_MODEL 环境变量选择列表外的模型。
注意：default 选项不受 availableModels 影响，始终可用。即使 availableModels: []，用户仍可使用其订阅级别的默认模型。
完全控制用户模型体验
结合 availableModels 和 model 实现完整控制：
{
"model": "sonnet",
"availableModels": ["sonnet", "haiku"]
}这个配置确保：
- 所有用户默认使用 Sonnet 4.6
- 用户只能在 Sonnet 和 Haiku 之间切换
- 无法使用 Opus（避免高成本意外消费）
availableModels 合并规则
当多个层级都设置了 availableModels 时，数组会合并去重。要强制执行严格白名单，在 Managed 或 Policy 设置中配置（优先级最高）。
第三方平台模型配置
Amazon Bedrock
# 使用推理配置文件 ARN
export ANTHROPIC_MODEL=us.anthropic.claude-sonnet-4-5-20251101-v1:0Google Vertex AI
# 使用版本名称
export ANTHROPIC_MODEL=claude-sonnet@20241022Microsoft Azure Foundry
# 使用部署名称
export ANTHROPIC_MODEL=your-deployment-name模型选择决策树
任务是什么？
├── 代码搜索/文件浏览/简单问答 → Haiku
├── 日常编码/代码审查/重构 → Sonnet
├── 复杂架构/安全审计/深度分析 → Opus
└── 需要规划+实现 → opusplan
上下文需求？
├── 普通项目 → 默认窗口
└── 超大代码库或超长会话 → sonnet[1m]
团队管理？
├── 控制成本 → availableModels 限制
└── 统一体验 → model + availableModels 组合
总结
Claude Code 的模型配置系统提供了从个人偏好到企业管理的完整解决方案。opusplan 混合模式是提升质量与控制成本的最佳平衡点，适合大多数复杂开发任务。企业用户通过 availableModels 可以精确控制团队的模型使用，避免意外的高成本消费。
来源：Claude Code 官方文档 - Model Configuration 原文作者：Anthropic Team