Claude Code 提供灵活的模型配置系统：从便捷的模型别名，到用 Opus 规划 + Sonnet 执行的混合模式，再到企业级的模型锁定，覆盖各种使用场景。
模型别名
别名让你无需记忆具体版本号，始终指向最新版本：
| 别名 | 对应行为 |
|---|---|
default | 根据账号类型自动选择推荐模型 |
sonnet | 最新 Sonnet 模型（当前 Sonnet 4.6），日常编码任务 |
opus | 最新 Opus 模型（当前 Opus 4.6），复杂推理任务 |
haiku | 快速轻量模型，简单任务 |
sonnet[1m] | Sonnet + 100 万 Token 超长上下文 |
opusplan | 特殊混合模式：Plan 阶段用 Opus，执行阶段用 Sonnet |
如需固定到具体版本，使用完整模型名（如
claude-opus-4-6）或设置对应环境变量（如ANTHROPIC_DEFAULT_OPUS_MODEL）。
设置模型的四种方式（按优先级排序）
- 会话中切换（最高优先级）：
/model sonnet - 启动时指定：
claude --model opus - 环境变量：
ANTHROPIC_MODEL=sonnet - 配置文件（持久生效）：
{
"model": "opus"
}opusplan：规划用 Opus，执行用 Sonnet
opusplan 是一个实用的混合模式：
- Plan Mode 阶段：使用 Opus（更强推理，制定精准计划）
- 执行阶段：切换到 Sonnet（速度更快，成本更低）
claude --model opusplan适合需要精准规划但执行步骤较多的任务：AI 自主用 Opus 想清楚怎么做，再用 Sonnet 高效执行。
努力级别（Effort Level）
对于支持扩展思考（Extended Thinking）的模型，可以调整推理深度：
claude --model opus --effort high # 深度推理
claude --model sonnet --effort low # 快速响应或在配置文件中：
{
"model": "opus",
"modelEffort": "high"
}可选值：low、medium（默认）、high
超长上下文（1M Token）
claude --model sonnet[1m]100 万 Token 上下文，适合：
- 分析超大代码库（一次性加载完整项目）
- 处理长篇文档
- 长会话不截断历史
注意：1M 上下文模型调用成本更高，按需使用。
查看当前模型
/status # 会话状态中显示当前模型
/model # 查看并切换模型环境变量参考
| 变量名 | 说明 |
|---|---|
ANTHROPIC_MODEL | 覆盖默认模型 |
ANTHROPIC_DEFAULT_OPUS_MODEL | 固定 opus 别名对应的具体版本 |
ANTHROPIC_DEFAULT_SONNET_MODEL | 固定 sonnet 别名对应的具体版本 |
ANTHROPIC_DEFAULT_HAIKU_MODEL | 固定 haiku 别名对应的具体版本 |
企业：限制可用模型
管理员通过 Managed 设置限制用户能选择的模型：
{
"availableModels": ["sonnet", "haiku"]
}设置后，用户无法通过 /model、--model 参数、Config 界面或 ANTHROPIC_MODEL 环境变量切换到列表之外的模型。
强制所有用户使用 Sonnet（且只能选 Sonnet 或 Haiku）：
{
"model": "sonnet",
"availableModels": ["sonnet", "haiku"]
}
availableModels不影响default选项——default始终可用，代表该用户订阅层级的默认模型。即使availableModels: []，用户仍可以用 Default 模型正常使用 Claude Code。
第三方部署（Bedrock / Vertex / Foundry）
{
"model": "anthropic.claude-sonnet-4-6-v1:0"
}- Bedrock：Inference Profile ARN
- Vertex：版本名称（如
claude-sonnet-4-6@20260217） - Foundry：部署名称
第三方部署时，别名（sonnet、opus 等）可能不可用，建议使用完整模型标识符。
Prompt 缓存配置
{
"promptCaching": {
"enabled": true
}
}Prompt 缓存可以显著降低长会话的 Token 成本，特别是反复读取相同文件的场景。默认已启用。
原文：Model configuration - Claude Code Docs | 来源：Anthropic 官方文档