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:选择器会列出可用的模型,选中后立即生效。此外还可以用启动参数、环境变量和配置文件指定模型,它们的优先级不同,弄清楚之后就不会遇到"明明切换了,重开又变回去"的问题。
本文讲清 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 时都会使用它。