SupaStore

返回博客列表

Claude Code 怎么切换模型?/model 命令、ANTHROPIC_MODEL 与 opusplan 用法详解(2026)

Claude Code 怎么切换模型?本文讲清 Claude Code 切换模型的 4 种方法与优先级(/model、--model、ANTHROPIC_MODEL、settings.json),解释 opus、sonnet、haiku、opusplan 等模型别名,演示中转站下用 ANTHROPIC_DEFAULT_*_MODEL 指定模型 ID,并附子代理模型、effort 与 fast 模式设置。

SupaStore 开发者体验组 ·

Claude Code 怎么切换模型?/model 命令、ANTHROPIC_MODEL 与 opusplan 用法详解(2026)

Claude Code 切换模型最快的方法,是在会话里输入 /model:选择器会列出可用的模型,选中后立即生效。此外还可以用启动参数、环境变量和配置文件指定模型,它们的优先级不同,弄清楚之后就不会遇到"明明切换了,重开又变回去"的问题。

本文讲清 Claude Code 切换模型的 4 种方法与优先级、模型别名和 opusplan 的用法、子代理与 effort 的设置,以及通过中转站使用 Claude Code 时怎样把别名指向正确的模型 ID。Claude Code 的安装和基础用法见《Claude Code 教程:2026 Claude Code 安装与使用指南》。


Claude Code 切换模型的 4 种方法

按优先级从高到低:

方法 写法 作用范围
会话中切换 /model sonnet 当前会话立即生效
启动参数 claude --model opus 本次启动的会话
环境变量 ANTHROPIC_MODEL=claude-sonnet-5-5 所有读到该变量的会话
配置文件 settings.json 中的 "model" 该配置文件覆盖的所有会话

另外,新版 Claude Code(v2.1.236 及以上)还支持 ANTHROPIC_DEFAULT_MODEL:只在其他方式都没有指定模型时,作为新会话的起始模型。

需要注意的细节:ANTHROPIC_MODEL 会覆盖配置文件里的 model。如果你设置了这个环境变量,在 /model 选择器里保存的默认模型,下次启动时会被它盖掉。

方法一:/model 命令

在 Claude Code 会话中:

  • 输入 /model 打开模型选择器,当前使用的模型会被标出;
  • 选中后按 Enter:切换模型,并保存为默认模型(写入用户配置文件);
  • 选中后按 s:只在当前会话切换,不改默认值;
  • 也可以直接输入 /model opus、/model claude-sonnet-5-5 这样的别名或完整模型 ID。

方法二:启动时指定 --model

claude --model opus
claude --model claude-sonnet-5-5

适合临时用另一个模型处理某个任务,不影响默认设置。

方法三:ANTHROPIC_MODEL 环境变量

写在 ~/.claude/settings.json 的 env 中,对所有新会话生效:

{
  "env": {
    "ANTHROPIC_MODEL": "claude-sonnet-5-5"
  }
}

也可以在 Shell 配置文件里 export ANTHROPIC_MODEL=...,效果相同。

方法四:配置文件中的 model

{
  "model": "sonnet"
}

写在 ~/.claude/settings.json 对你的所有项目生效;写在项目的 .claude/settings.json 只对该项目生效,适合团队统一模型。


Claude Code 模型别名

别名会自动指向该系列的推荐版本,并随新模型发布更新:

别名 含义
default 清除自定义设置,恢复账号的默认模型
opus 最新的 Opus,适合复杂推理和架构设计
sonnet 最新的 Sonnet,适合日常编程
haiku 快速、便宜的 Haiku,适合简单任务
fable Fable 系列,适合最难、耗时最长的任务
best 等同于 opus(v2.1.321 及以上)
opusplan 规划阶段用 Opus,执行阶段用 Sonnet
sonnet[1m] / opus[1m] 使用 1M 上下文窗口的版本

在 Anthropic 官方 API 上,目前 opus 指向 Claude Opus 5.5,sonnet 指向 Claude Sonnet 5.5,haiku 指向 Claude Haiku 5.5。Sonnet 5.5 和 Opus 4.7 之后的 Opus 本身就支持 1M 上下文,对它们加 [1m] 没有额外效果。

别名会随时间变化。想固定在某个版本,就用完整的模型 ID,例如 claude-opus-5-5。Opus 和 Sonnet 的区别与选型建议,见《Claude Opus 和 Sonnet 有什么区别?》。


opusplan:规划用 Opus,执行用 Sonnet

opusplan 是一个混合模式:

  • 在 Plan Mode(规划模式)下使用 Opus,负责分析需求、设计方案;
  • 退出规划模式开始写代码后,自动切换到 Sonnet 执行。
/model opusplan

切换后,按 Shift + Tab 进入规划模式,让 Claude 先出方案,确认后再执行。这样把最贵的模型只用在"想清楚"的阶段,写代码时用更便宜的 Sonnet,在质量和成本之间取得平衡。

需要两个阶段都用 1M 上下文时,可以选择 opusplan[1m]。


用中转站时怎么切换模型

通过 API中转站使用 Claude Code 时(配置方法见《Claude API 中转怎么用?国内 Claude Code 中转站配置教程》),有一个容易踩的坑:别名会被解析成官方的模型 ID。如果中转站没有提供这个 ID,切换后请求就会报"模型不存在"。

解决办法是用环境变量把每个别名指向中转站实际提供的模型 ID:

{
  "env": {
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}
环境变量 作用
ANTHROPIC_DEFAULT_OPUS_MODEL opus 指向的模型,opusplan 的规划阶段也用它
ANTHROPIC_DEFAULT_SONNET_MODEL sonnet 指向的模型,opusplan 的执行阶段也用它
ANTHROPIC_DEFAULT_HAIKU_MODEL haiku 指向的模型,Claude Code 的后台功能也用它
CLAUDE_CODE_SUBAGENT_MODEL 子代理的默认模型

上面的模型 ID 只是示例,请填写模型广场中实际提供的 ID。ANTHROPIC_DEFAULT_HAIKU_MODEL 还承担后台功能的请求,指向一个便宜的模型可以省下不少费用。旧版本使用的 ANTHROPIC_SMALL_FAST_MODEL 已被它取代。

想确认实际用的是哪个模型,最可靠的办法是看 SupaStore 控制台的使用日志:每一条请求都记录了真实的模型 ID 和 Token 数。


子代理用什么模型

子代理可以单独指定模型。在子代理定义文件的 frontmatter 里写 model 字段:

---
name: code-reviewer
description: 审查代码改动
model: haiku
---

model 可以填 sonnet、opus、haiku、fable、完整的模型 ID,或 inherit(沿用主会话的模型)。子代理模型的决定顺序是:调用时指定的模型 → 定义文件里的 model → CLAUDE_CODE_SUBAGENT_MODEL → 主会话的模型。

把搜索、阅读代码这类子代理交给 Haiku,是控制成本的常用做法。子代理的完整用法见《Claude Code 子代理怎么用?》。


effort 与 fast 模式

切换模型之外,还有两个开关会影响速度和成本:

  • effort(思考力度):输入 /effort 打开滑块,或直接 /effort low、/effort high。可选 low、medium、high、xhigh、max(取决于模型),/effort auto 恢复默认。Opus 5.5、Sonnet 5.5、Haiku 5.5 默认是 medium。也可以用 --effort 启动参数、settings.json 的 effortLevel 或 CLAUDE_CODE_EFFORT_LEVEL 环境变量设置。effort 的原理见《Claude 思考模式怎么用?》。
  • fast 模式:输入 /fast 开关,同一个模型输出速度最高提升到约 2.5 倍,但单价更高(Opus 5.5 为 $8 / $40 每百万 Token,是标准价的 2 倍)。fast 模式只在部分模型和平台上可用,通过中转站使用时是否支持以服务商为准。

按任务选模型的建议

任务 推荐
日常写代码、改 bug sonnet
大型重构、架构设计、疑难 bug opus 或 opusplan
格式调整、写注释、简单脚本 haiku
读代码、搜索类子代理 子代理 model: haiku

模型越强,单价越高。更多控制 Token 消耗的方法见《Claude Code Token 消耗太快?10 个省 Token 技巧》。


Claude Code 切换模型常见问题排查

现象 常见原因 处理方法
切换后报模型不存在 别名解析出的 ID 中转站没有提供 用完整模型 ID,或设置 ANTHROPIC_DEFAULT_*_MODEL
重启后又变回原来的模型 ANTHROPIC_MODEL 覆盖了保存的默认值,或切换时按的是 s 删除或修改该环境变量,切换时按 Enter
选择器里没有想要的模型 组织的托管配置用 availableModels 限制了可选模型 联系管理员,或直接输入完整模型 ID
子代理用的模型不对 定义文件里的 model 优先级更高 检查子代理的 frontmatter

常见问题 (FAQ)

Q: Claude Code 默认用的是什么模型?

答: 根据官方文档,Pro、Max、Team、Enterprise 和 Anthropic API 账号默认使用 Claude Opus 5.5,组织管理员可以另外设置默认模型。运行 /model 可以看到当前选中的模型。

Q: /model 切换模型会丢失对话上下文吗?

答: 不会,对话历史会保留。但不同模型的 Prompt 缓存不共享,切换后的第一轮请求需要重新写入缓存,费用会比平时高一些,频繁来回切换并不划算。

Q: 用中转站时能用 opusplan 吗?

答: 可以,前提是中转站同时提供 Opus 和 Sonnet 模型。把 ANTHROPIC_DEFAULT_OPUS_MODEL 和 ANTHROPIC_DEFAULT_SONNET_MODEL 分别指向中转站的模型 ID 即可。

Q: 怎么让整个团队用同一个模型?

答: 在项目的 .claude/settings.json 里写上 "model" 并提交到代码仓库,团队成员在这个项目里启动 Claude Code 时都会使用它。