Claude Code 支持灵活的模型配置，从模型别名快速切换，到企业级的模型白名单管控，再到 Bedrock/Vertex/Foundry 第三方部署的版本固定。本文覆盖全部配置选项。
可用模型别名
| 别名 | 说明 | 当前版本 |
|---|---|---|
default | 根据账号类型自动选择推荐模型 | 见下文 |
sonnet | 日常编码任务，最新 Sonnet | Sonnet 4.6 |
opus | 复杂推理任务，最新 Opus | Opus 4.6 |
haiku | 简单快速任务 | 最新 Haiku |
sonnet[1m] | Sonnet + 100 万 Token 上下文窗口 | Sonnet 4.6 |
opusplan | 规划阶段用 Opus，执行阶段自动切 Sonnet | 混合 |
别名始终指向最新版本。需要锁定版本时，使用完整模型名称（如 claude-opus-4-6）或环境变量。
四种设置模型的方式
# 1. 会话中切换（最高优先级）
/model opus
/model sonnet[1m]
# 2. 启动时指定
claude --model opus
# 3. 环境变量
export ANTHROPIC_MODEL=sonnet
# 4. settings.json 永久配置（最低优先级）// settings.json
{
"model": "opus"
}default 别名的行为
| 账号类型 | 默认模型 |
|---|---|
| Max / Team Premium | Opus 4.6 |
| Pro / Team Standard | Sonnet 4.6 |
| Enterprise | Opus 4.6 可用但非默认 |
Opus 用量达到上限时，Claude Code 自动回退到 Sonnet。
opusplan：规划/执行混合模式
opusplan 是最具性价比的配置：
- Plan 模式：使用 Opus 进行复杂推理和架构决策
- 执行模式：自动切换到 Sonnet 进行代码生成和实现
/model opusplan结合 Plan 模式工作流：先在 Plan 模式用 Opus 分析、规划，批准计划后执行阶段自动用 Sonnet——享受 Opus 的推理能力，同时控制成本。
Effort 级别（自适应推理）
Effort 级别控制模型分配给推理的计算量，支持 Opus 4.6 和 Sonnet 4.6：
| 级别 | 适用场景 | 速度/成本 |
|---|---|---|
low | 简单任务（格式化、简单修复） | 最快、最省 |
medium | 常规开发任务（默认） | 平衡 |
high | 复杂推理（架构设计、困难 Bug） | 最深入 |
设置方式：
# 在 /model 中用左右键滑动调整
/model
# 环境变量
export CLAUDE_CODE_EFFORT_LEVEL=high
# settings.json{ "effortLevel": "medium" }当前 effort 级别显示在 Logo 和 Spinner 旁（如「with low effort」）。
禁用自适应推理，恢复固定思考预算：
export CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=11M Token 扩展上下文窗口
Opus 4.6 和 Sonnet 4.6 支持 100 万 Token 上下文（Beta）：
# 使用别名
/model sonnet[1m]
# 使用完整模型名称
/model claude-sonnet-4-6[1m]可用性：
- API 和按量付费用户：完整访问
- Pro/Max/Teams/Enterprise 订阅用户：需启用 extra usage
计费规则：
- 选择 1M 模型不立即改变计费
- 会话超过 200K Token 后，按长上下文定价计费
- 订阅用户超出 200K 的部分以 extra usage 计费（不含在订阅额度内）
禁用 1M 上下文（从模型选择器中移除）：
export CLAUDE_CODE_DISABLE_1M_CONTEXT=1企业模型管控
限制用户可选模型
// managed-settings.json
{
"availableModels": ["sonnet", "haiku"]
}设置后，用户无法通过 /model、--model、Config 界面或 ANTHROPIC_MODEL 切换到列表外的模型。default 始终保留不受限制。
统一用户模型
{
"model": "sonnet",
"availableModels": ["sonnet", "haiku"]
}所有用户运行 Sonnet 4.6，只能在 Sonnet 和 Haiku 之间切换。
多层合并行为
availableModels 在多级 settings 中设置时，数组合并去重。如需严格白名单，在 Managed 或 Policy settings 中设置（最高优先级）。
查看当前模型
/status # 显示当前模型、账号信息
/model # 打开模型选择器若配置了状态栏（statusline），当前模型也会显示在状态栏。
模型别名环境变量
| 变量 | 说明 |
|---|---|
ANTHROPIC_DEFAULT_OPUS_MODEL | opus 别名和 opusplan Plan 模式对应的完整模型名 |
ANTHROPIC_DEFAULT_SONNET_MODEL | sonnet 别名和 opusplan 执行模式对应的完整模型名 |
ANTHROPIC_DEFAULT_HAIKU_MODEL | haiku 别名及后台功能使用的模型名 |
CLAUDE_CODE_SUBAGENT_MODEL | Subagent 使用的模型 |
ANTHROPIC_SMALL_FAST_MODEL已弃用，改用ANTHROPIC_DEFAULT_HAIKU_MODEL
第三方部署固定模型版本（重要）
通过 Bedrock、Vertex AI 或 Foundry 部署 Claude Code 时，必须在上线前固定模型版本。
不固定的风险：Claude Code 使用 sonnet/opus/haiku 别名指向最新版本，Anthropic 发布新模型时，未启用新版本的账号会静默失败。
固定示例：
# Bedrock
export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-6-v1'
export ANTHROPIC_DEFAULT_SONNET_MODEL='us.anthropic.claude-sonnet-4-6-v1'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='us.anthropic.claude-haiku-3-5-v2'
# Vertex AI
export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-6'
export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-4-6'
# Foundry
export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-6'升级模型版本时，更新这些环境变量后重新部署即可。
注意：availableModels 按模型别名（opus/sonnet/haiku）过滤，不按提供商特定的模型 ID。
原文：Model configuration - Claude Code Docs | 来源：Anthropic 官方文档