模型配置

​

可用模型

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

​

模型别名

​

使用 Fable 5

• 描述结果，而不是步骤：给它您想要的结果，让它规划路径。要让它继续工作直到该结果成立，设置一个目标。
• 交给它模糊的问题：根本原因调查、故障排除和架构决策是额外调查和验证发挥作用的地方。
• 跳过验证提醒：它以更少的提示验证自己的工作，所以测试或检查的提醒通常是不必要的。
• 规划更大的任务：给它您通常会分成几部分的工作。它能够维持长会话而不失去思路。

​

设置您的模型

1. 在会话期间 - 使用 /model <alias|name> 立即切换，或运行不带参数的 /model 打开选择器。当对话有先前的输出时，选择器会要求确认，因为下一个响应会重新读取完整历史记录而不使用缓存的上下文
2. 启动时 - 使用 claude --model <alias|name> 启动
3. 环境变量 - 设置 ANTHROPIC_MODEL=<alias|name>
4. 设置 - 在设置文件中使用 model 字段永久配置。

• Enter：切换模型并保存为您的默认值
• s：仅为此会话切换模型

# 使用 Opus 启动
claude --model opus

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

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

​

限制模型选择

• 主会话模型：/model、--model 标志、ANTHROPIC_MODEL 环境变量、model 设置，以及恢复会话时恢复的模型
• 别名解析：ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL 和 ANTHROPIC_DEFAULT_FABLE_MODEL 环境变量无法将允许的别名重定向到列表外的模型
• 快速模式：/fast 在隐式切换到列表外的 Opus 模型时拒绝切换，显示消息”不在您的组织允许的模型中”
• 子代理模型：子代理 frontmatter 中的 model 字段、Agent 工具的 model 参数、/agents 中的模型选择器和 CLAUDE_CODE_SUBAGENT_MODEL
• 技能和命令模型：技能和命令中的 model frontmatter
• 顾问模型：配置的 advisorModel 设置和 --advisor 标志
• 后台代理模型：分派选择器中选择的模型

{
  "availableModels": ["sonnet", "haiku"]
}

​

表面覆盖

• 云会话在网络上的 Claude Code 或桌面应用中运行在 Anthropic 管理的虚拟机上：部署到您的设备的设置无法到达它们，因此通过服务器管理的设置交付允许列表。云会话中的中途模型切换在请求的模型被允许列表排除时被拒绝。服务器端拒绝在会话创建时适用于组织模型限制，而不是 availableModels 设置键。
• Cowork 是 Claude 桌面应用中的代理工作选项卡，不是 Claude Code 表面，按设计不接收服务器管理的设置。托管设置文件在会话运行的地方存在时适用于 Cowork 会话；远程 Cowork 会话运行在 Anthropic 管理的虚拟机上，其中不存在设备部署的文件。
• 第三方提供商上的会话，如 Bedrock、Vertex AI、Foundry 和 AWS 上的 Claude Platform，不接收服务器管理的设置，因此在那里通过 MDM 或托管设置文件交付允许列表。
• 服务器管理的交付还需要会话使用组织登录或直接配置的 API 密钥进行身份验证。仅通过 apiKeyHelper 脚本生成密钥的队列应通过 MDM 或托管设置文件交付允许列表。
• 桌面代码选项卡还托管 SSH 会话，它们从运行的远程主机读取托管设置文件。请参阅桌面托管设置。
• claude.ai 和桌面应用中的模型选择器隐藏或灰显您的组织允许列表排除的模型。选择器状态是用户的便利；强制执行发生在会话中。

​

默认模型行为

​

对默认模型强制执行允许列表

{
  "availableModels": ["sonnet", "haiku"],
  "enforceAvailableModels": true
}

​

控制用户运行的模型

• availableModels：限制用户可以切换到的命名模型
• enforceAvailableModels：将 availableModels 允许列表扩展到”默认”选项，因此”默认”无法解析为列表外的模型
• model：设置会话启动时的初始模型选择
• ANTHROPIC_DEFAULT_SONNET_MODEL / ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_HAIKU_MODEL / ANTHROPIC_DEFAULT_FABLE_MODEL：控制”默认”选项和 sonnet、opus、haiku 和 fable 别名解析为什么

{
  "model": "claude-sonnet-4-5",
  "availableModels": ["claude-sonnet-4-5", "haiku"],
  "enforceAvailableModels": true,
  "env": {
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5"
  }
}

​

合并行为

​

Mantle 模型 ID

​

组织模型限制

​

特殊模型行为

​

default 模型设置

• Max、Team Premium、Enterprise 按使用量付费和 Anthropic API：默认为 Opus 4.8
• AWS 上的 Claude Platform：默认为 Opus 4.7
• Pro、Team Standard 和 Enterprise 订阅席位：默认为 Sonnet 4.6
• Bedrock、Vertex 和 Foundry：默认为 Sonnet 4.5

​

opusplan 模型设置

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

​

回退模型链

claude --fallback-model sonnet,haiku

{
  "fallbackModel": ["claude-sonnet-4-6", "claude-haiku-4-5"]
}

• 不可用的模型：无法访问的模型，例如在设置中固定的已停用模型，会被跳过，Claude Code 继续到下一个元素。
• 超出允许列表：不被 availableModels 允许的元素在读取链时被删除，永远不会被尝试。

​

自动模型回退

​

检查触发回退的原因

​

切换前询问

• 如果两个模型都标记相同的请求，您可以编辑提示并重试，或启动新会话。
• 在移动 Claude Code on the web 会话上，不支持编辑和重试。切换模型，或从桌面浏览器或桌面应用继续会话。
• 在 non-interactive mode 和无法显示提示的 SDK 集成中，标记的请求以拒绝结束轮次。
• 当回退目标被 availableModels 阻止时，不会显示提示。标记的请求以拒绝结束，与目标被阻止时的自动回退相同。

​

在 Bedrock、Vertex AI 和 Foundry 上启用回退

• Claude Code 必须将当前模型识别为 Fable 5：模型 ID 包含 claude-fable-5，匹配 ANTHROPIC_DEFAULT_FABLE_MODEL 的值，或使用 modelOverrides 映射。
• 回退目标必须解析为 Opus 模型：ANTHROPIC_DEFAULT_OPUS_MODEL 的值（如果设置），否则提供商模型列表中的 Opus 4.8 条目。

​

安全研究和生物学工作负载

​

调整工作量级别

​

选择工作量级别

​

使用 ultrathink 进行一次性深入推理

​

设置工作量级别

• /effort：运行不带参数的 /effort 打开交互式滑块，运行 /effort 后跟级别名称直接设置，或运行 /effort auto 重置为模型默认值
• 在 /model 中：选择模型时使用左右箭头键调整工作量滑块
• --effort 标志：在启动 Claude Code 时传递级别名称为单个会话设置
• 环境变量：设置 CLAUDE_CODE_EFFORT_LEVEL 为级别名称或 auto
• 设置：在设置文件中将 effortLevel 设置为 low、medium、high 或 xhigh。max 和 ultracode 是仅限会话的，此处不接受
• Skill 和 subagent frontmatter：在 skill 或 subagent markdown 文件中设置 effort 以在该 skill 或 subagent 运行时覆盖工作量级别

​

自适应推理和固定思考预算

​

扩展思考

​

扩展上下文

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

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

​

检查您当前的模型

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

​

添加自定义模型选项

export ANTHROPIC_CUSTOM_MODEL_OPTION="my-gateway/claude-opus-4-7"
export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Opus via Gateway"
export ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION="Custom deployment routed through the internal LLM gateway"

​

环境变量

​

为第三方部署固定模型

export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8[1m]'

• Claude Code 在将模型 ID 发送到您的提供商之前会删除该后缀。
• 仅当底层模型支持 1M 上下文时才附加 [1m]。
• 该后缀按变量读取，而不是按模型读取。在 Bedrock、Vertex 和 Foundry 上，一个变量中没有 [1m] 的模型 ID 使用 200K 上下文，即使另一个变量使用相同的模型和后缀。

​

自定义固定模型显示和功能

export ANTHROPIC_DEFAULT_OPUS_MODEL='arn:aws:bedrock:us-east-1:123456789012:custom-model/abc'
export ANTHROPIC_DEFAULT_OPUS_MODEL_NAME='Opus via Bedrock'
export ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION='Opus 4.7 routed through a Bedrock custom endpoint'
export ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES='effort,xhigh_effort,max_effort,thinking,adaptive_thinking,interleaved_thinking'

​

按版本覆盖模型 ID

{
  "modelOverrides": {
    "claude-opus-4-7": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-prod",
    "claude-opus-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-46-prod",
    "claude-sonnet-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/sonnet-prod"
  }
}

​

Prompt caching 配置