模型配置

​

可用模型

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

​

模型别名

​

使用 Fable 5

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

​

设置您的模型

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

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

• 一个模型别名
• 来自 /model 选择器的条目
• 任何以 claude- 开头的名称
• 您自己配置为自定义模型选项或在 modelOverrides 中的值

# 使用 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 参数、CLAUDE_CODE_SUBAGENT_MODEL，以及在 v2.1.197 及更早版本上，/agents 向导中的模型选择器
• 技能和命令模型：技能和命令中的 model frontmatter
• 顾问模型：配置的 advisorModel 设置和 --advisor 标志
• 后台代理模型：分派选择器中选择的模型

• /model：切换被拒绝并显示错误
• --model 标志、ANTHROPIC_MODEL 或 model 设置：该值在启动时被替换为警告，命名请求的和替换的模型，会话在默认模型上启动
• 子代理、技能或命令覆盖：覆盖回退到继承或默认模型，而不是导致请求失败
• advisorModel 设置：该会话的顾问被禁用
• --advisor 标志：Claude Code 在启动时以错误退出

• 回退模型链：允许列表外的元素被删除
• Plan Mode 升级：在 Anthropic API 和 AWS 上的 Claude Platform 上，升级（如 opusplan）到被排除的模型会使用升级系列的最新允许版本。在具有特定于提供商的模型 ID 的提供商上，以及当没有版本被允许时，升级被跳过，规划继续在会话的模型上进行
• 自动模型回退：目标被排除的回退不会运行，因此标记的请求以拒绝结束
• 快速模式：当会话之后运行的模型在允许列表外时，启用快速模式被拒绝

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

​

表面覆盖

• 云会话在网络上的 Claude Code 或桌面应用中运行在 Anthropic 管理的虚拟机上：部署到您的设备的设置无法到达它们，因此通过服务器管理的设置交付允许列表。云会话中的中途模型切换在请求的模型被允许列表排除时被拒绝。服务器端拒绝在会话创建时适用于组织模型限制，而不是 availableModels 设置键。
• Cowork 是 Claude 桌面应用中的代理工作选项卡，不是 Claude Code 表面，按设计不接收服务器管理的设置。托管设置文件在会话运行的地方存在时适用于 Cowork 会话；远程 Cowork 会话运行在 Anthropic 管理的虚拟机上，其中不存在设备部署的文件。
• 第三方提供商上的会话，如 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft 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

​

组织模型限制

• 在组织级别禁用模型会为每个成员删除它。
• 角色级别访问为不同的自定义角色授予不同的模型，持有多个角色的成员可以使用其任何角色授予的模型。
• Haiku 模型始终可用，无法禁用，因此每个成员至少保持一个可用模型。
• 访问更改在约一分钟内对新请求生效；/model 选择器在下次会话启动时反映它。

​

组织默认模型

• --model 标志和 ANTHROPIC_MODEL 环境变量
• 托管设置中的 model 值或通过 --settings 提供的值
• 您的用户、项目或本地设置中的 model 值，包括您使用 /model 保存的模型

• availableModels 单独从不限制”默认”选项，因此允许列表外的组织默认值仍然适用。当也设置了 enforceAvailableModels 时，允许列表外的组织默认值会重新映射到第一个允许列表条目，就像任何其他默认值一样
• 组织模型限制拒绝的组织默认值会被替换为其系列中最新的允许模型，或当该系列的每个版本都被限制时被替换为较低成本的系列
• 对您的账户完全不可用的组织默认值，例如零数据保留下的 Fable 5，会被跳过，“默认”选项解析为账户类型默认值

​

组织工作量限制

​

特殊模型行为

​

default 模型设置

• Max、Team Premium、Enterprise 按使用量付费和 Anthropic API：默认为 Opus 4.8
• AWS 上的 Claude Platform 和 Amazon Bedrock 以及 Google Cloud 的 Agent Platform：默认为 Opus 4.8
• Pro、Team Standard 和 Enterprise 订阅席位：默认为 Sonnet 5
• Microsoft Foundry：默认为 Sonnet 4.5

​

opusplan 模型设置

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

​

回退模型链

claude --fallback-model sonnet,haiku

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

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

​

自动模型回退

​

检查触发回退的原因

​

切换前询问

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

​

在 Bedrock、Agent Platform 和 Foundry 上启用回退

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

​

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

​

调整工作量级别

• /effort：运行 /effort ultracode，或从菜单中选择它
• --effort 标志：使用 claude --effort ultracode 启动，这会在 xhigh 工作量下启动会话并打开 ultracode
• --settings 或 Agent SDK 控制请求：传递 "ultracode": true。applyFlagSettings() 请求也接受 effortLevel: "ultracode"

​

选择工作量级别

​

使用 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]

​

Sonnet 5 上下文窗口

• LLM gateway：当 ANTHROPIC_BASE_URL 指向网关时，Claude Code 无法验证 1M 支持。要使用完整窗口，请在模型选择器中选择 Sonnet 5 (1M context)，它映射到 sonnet[1m]。
• CLAUDE_CODE_DISABLE_1M_CONTEXT=1：将 Sonnet 5 会话视为具有 200K 窗口，适用于需要限制上下文的部署。

​

检查您当前的模型

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

​

添加自定义模型选项

export ANTHROPIC_CUSTOM_MODEL_OPTION="my-gateway/claude-opus-4-8"
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]。
• 该后缀按变量读取，而不是按模型读取。在 Amazon Bedrock、Google Cloud’s Agent Platform 和 Microsoft Foundry 上，一个变量中没有 [1m] 的模型 ID 使用 200K 上下文，即使另一个变量使用相同的模型和后缀。Sonnet 5 在这些提供商上始终以 1M 窗口运行，从不需要该后缀。

​

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

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 配置