它到底是什么

/model 是 Claude Code 的内置 slash 命令，用于在当前会话中即时切换 AI 模型，无需重启终端或重建上下文。既可以接受模型别名（如 opus、sonnet），也可以接受完整 model ID（如 claude-opus-4-8）。

怎么触发 / 怎么使用

1. 无参数 — 打开交互式选择器

/model

触发一个可视化选择菜单，列出当前账户可用的所有模型选项。

2. 直接指定别名或模型名

/model opus
/model sonnet
/model fable
/model claude-opus-4-8
/model opus[1m]

立即切换，等效于在选择器中按 Enter 确认（同时保存为新会话默认值，见下方版本行为说明）。

3. 启动时指定（--model flag）

claude --model opus
claude --model claude-sonnet-4-6

仅影响本次启动的会话，不写入持久设置。

可用模型别名

以下别名来自官方文档，会随时间更新，无需记忆具体版本号：

别名在不同 provider 上解析到的具体版本不同：

监控 / 控制 / 键位

交互式选择器（无参数调用 /model 时）支持以下键位：

版本差异：此行为（Enter 保存默认 / s 仅本会话）自 v2.1.153 起生效。v2.1.144–v2.1.152 中 /model 仅应用于当前会话，需按 d 才能保存默认。

查看当前模型

/status

显示当前使用的模型及账户信息。也可在 status line 中实时查看（如已配置）。

保存 / 配置 / 集成

优先级顺序（从高到低）

1. 会话内 /model <别名|名称> — 立即生效，并保存为用户默认（v2.1.153+）
2. 启动标志 claude --model <别名|名称> — 仅本次会话
3. 环境变量 ANTHROPIC_MODEL=<别名|名称> — 仅本次启动会话
4. 设置文件 model 字段 — 持久默认

设置文件配置

{
  "model": "opus"
}

写入 ~/.claude/settings.json（用户级）或项目 .claude/settings.json（项目级）。Project 和 managed 设置优先级高于用户设置，且每次重启会重新生效。

环境变量

固定版本（避免别名随时间漂移）

如需钉死到具体版本，使用完整 model ID：

/model claude-opus-4-8

或在环境变量中设置：

export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-8"

运行约束 / 限制

各账户类型的 default 模型

Fable 5 不是任何账户类型的默认模型，必须显式选择。

跟同类原语对比

subagent frontmatter model: 与会话 /model 的成本路由

/model 改的是主会话用哪个模型;而 subagent 文件 frontmatter 里的 model: 字段改的是那个 subagent 用哪个模型,两者独立、可错位组合,这正是控制成本的关键手段:

• 主会话跑 opus(复杂推理),但把高频、低难度的侧任务(代码评审、格式检查、日志摘要)的 subagent 写成 model: haiku,这些侧任务就用便宜模型跑,不占用 Opus 的 token 预算。
• subagent 的 model: 省略时默认 inherit,即跟随主会话——这时它会跟着 opus 一起变贵;显式写 model: haiku 才能强制降档。
• 官方解析顺序(优先级从高到低):CLAUDE_CODE_SUBAGENT_MODEL 环境变量 → 本次调用传入的 model 参数 → subagent frontmatter 的 model: → 主会话模型。所以 frontmatter 是"该 agent 的默认",但会被环境变量或单次调用参数覆盖。

---
name: code-reviewer
description: Use PROACTIVELY after code changes.
tools: Read, Glob, Grep
model: haiku   # 主会话哪怕在 opus,这个评审 agent 也只用 haiku
---

来源:官方 sub-agents 的 model frontmatter 字段及模型解析顺序说明。会话级 /model 与 subagent 级 model: 是两个独立维度,组合使用即"主任务高能力、侧任务低成本"的路由。

经典使用场景

• 任务升级：正在用 Sonnet 开发，遇到复杂架构问题时临时切换到 opus 或 fable，解决后用 s 键临时切回 Sonnet（不改默认）。
• 长上下文场景：大型代码库 review 时切到 opus[1m] 以获得 1M token 上下文窗口。
• 计划 + 执行分离：使用 opusplan 别名，让 Plan 阶段自动享用 Opus 推理能力，执行阶段自动切回 Sonnet 节省 token。
• 企业多项目统一：在项目 .claude/settings.json 中设置 "model": "sonnet" + availableModels，确保团队成员都在受控模型上运行。
• 固定版本防漂移：Bedrock/Vertex 部署时设置 ANTHROPIC_DEFAULT_OPUS_MODEL 为具体版本 ID，避免别名升级导致非预期行为。

常见坑

1. v2.1.153 前后行为不一致：v2.1.153 之前，直接输入 /model opus 只影响当前会话；升级后变为同时写入用户默认。如果你习惯了旧行为，升级后需要改用选择器的 s 键来保持"仅本会话"语义。

2. Resume 会话无视当前 model 设置：恢复旧会话时，即使你已用 /model 换了默认，恢复出来的会话仍使用原来保存时的模型。需要在恢复后手动再次运行 /model 切换。

3. Fable 5 的自动 fallback：切换到 fable 后，安全分类器一旦标记请求（常见于网络安全、生物学相关内容），会自动回退到 Opus，且本次会话从此留在 Opus。需要再次运行 /model fable 才能恢复。

4. 别名会随时间漂移：opus 今天指向 Opus 4.8，未来可能指向更新版本。需要钉死具体版本时，用完整 model ID（如 claude-opus-4-8）或通过 ANTHROPIC_DEFAULT_OPUS_MODEL 环境变量固定。

5. Enterprise availableModels 被 managed settings 整体替换：当 managed 或 policy settings 中设置了 availableModels，它会完全覆盖（而非合并）用户和项目级别的同名设置，用户无法在自己的 settings 中添加额外可用模型。

来源

• Model configuration — Claude Code Docs
• Claude Code model configuration — Claude Help Center