Claude Code & OpenClaw & Codex & WorkBuddy 中文教程

第8.5部分：模型配置（安装后的进阶配置）

💡 本节重点：装好 Claude Code 后，最重要的进阶配置之一就是选择合适的模型。这一节把模型配置讲透，让你从"会用"升级到"用对"。
⏱️ 预计时间：30分钟
前置条件：Claude Code 安装成功（完成第五部分）

8.5.0 先说结论

Claude Code 现在的模型配置，不只是"选 Sonnet 还是 Opus"。

它已经变成一整套策略层：

会话级选择：/model、--model
默认策略：settings.json 里的 model
能力限制：availableModels
别名映射：ANTHROPIC_DEFAULT_*_MODEL
第三方部署重写：modelOverrides
推理强度控制：/effort、effortLevel
长上下文控制：sonnet[1m]、opus[1m]

如果你只记一句话：

model 决定"默认选谁"，availableModels 决定"能不能选"，opusplan 决定"规划和执行是否分模型"。

8.5.1 当前可用的模型别名

官方文档当前明确给出的别名如下：

别名	含义	适合场景
`default`	回到系统默认模型，不是具体模型名	不想手动管版本时
`best`	当前最强可用模型，现阶段等价于 `opus`	直接追求最强效果
`sonnet`	最新 Sonnet，用于日常编码	默认主力
`opus`	最新 Opus，用于复杂推理	架构、疑难问题
`haiku`	更快更轻量	简单任务、快速处理
`sonnet[1m]`	Sonnet + 1M 上下文	大项目、长会话
`opus[1m]`	Opus + 1M 上下文	超长上下文 + 深度推理
`opusplan`	规划时用 Opus，执行时切回 Sonnet	复杂任务又要控成本

`opusplan` 是什么

这是当前最值得单独掌握的别名之一。

它的行为是：

进入 plan mode 时：用 opus
进入执行阶段时：自动切到 sonnet

也就是说，它不是单纯"更贵的模型"，而是一种规划强、执行稳、成本更合理的混合策略。

适合：

复杂重构
架构设计
需要先规划再执行的任务
团队里想把 Opus 用在刀刃上

8.5.2 模型配置优先级

当前官方口径的优先级，从高到低是：

会话中即时切换：/model <alias|name>
启动参数：claude --model <alias|name>
环境变量：ANTHROPIC_MODEL=<alias|name>
设置文件：settings.json 中的 model

常见用法

bash

# 启动时直接用 Opus
claude --model opus

# 会话里切回 Sonnet
/model sonnet

json

{
  "model": "opusplan"
}

8.5.3 effort：思考深度

/effort 控制的是推理强度，不是换模型。

可用值（v2.1.105-113 起新增 xhigh）：

low
medium
high
xhigh（推荐 Opus 4.8 默认）
max
auto

级别	含义	适合场景
`low`	更快、更省	简单问答、格式转换
`medium`	平衡	日常编码
`high`	更深推理	复杂调试、架构分析
`xhigh`	深度推理（推荐 Opus 4.8 默认）	深度重构、关键决策
`max`	最深推理	极复杂问题，成本最高
`auto`	回到模型默认	不想手动管时

官方建议：

Opus 4.8 用户推荐默认 xhigh
low/medium 适合 Sonnet/Haiku 模型日常使用
max 只在确实需要时开
如果只是偶发一次深推理，不一定非要改全局设置，可以在 prompt 中写 ultrathink

配置方式：

/effort low|medium|high|xhigh|max|auto
/effort 不带参数弹出交互式滑块
/model 面板里调节
claude --effort xhigh
CLAUDE_CODE_EFFORT_LEVEL=xhigh
settings.json 中的 effortLevel
skill / subagent frontmatter 里的 effort

8.5.4 1M 上下文怎么用

现在 Opus 4.8 和 Sonnet 5 都支持 1M 上下文，但是否可见、是否默认可用，取决于计划和部署方式。

最简单的用法

bash

/model opus[1m]
/model sonnet[1m]

或者：

bash

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

什么情况下该开 1M

适合：

monorepo
很长的多轮会话
一次性理解大型代码库
需要大规模跨文件关联分析

不适合：

小项目
只改 1-2 个文件
你更在乎速度和成本

关闭 1M

如果团队不希望出现 1M 选项，可以设置：

bash

CLAUDE_CODE_DISABLE_1M_CONTEXT=1

8.5.5 团队治理：`availableModels`、默认模型、别名映射

`availableModels`

如果你是团队管理员，想限制"用户能选什么"，用的是 availableModels。

json

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

它的作用是：

限制 /model
限制 --model
限制 ANTHROPIC_MODEL
限制 Config 工具中的模型切换

注意：`model` 不是强制锁定

model 只是会话启动时默认选哪个，并不代表用户不能换。

如果你要真正治理模型体验，通常要组合这三类配置：

model
availableModels
ANTHROPIC_DEFAULT_SONNET_MODEL / OPUS / HAIKU

8.5.6 第三方部署与 `modelOverrides`

如果你跑的是：

Bedrock
Vertex AI
Foundry

就不要只写别名，还要考虑模型版本绑定。

为什么需要 `modelOverrides`

因为第三方平台上，Claude Code 看到的是 Anthropic 的模型 ID，但真正发给平台的，可能要换成：

ARN
deployment name
provider-specific model ID

典型配置

json

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

用在：

企业按版本精确路由
不同区域 / 不同成本中心分流
防止别名自动飘到新版本

8.5.7 自定义模型入口

如果你有内部网关或特殊部署，可用：

ANTHROPIC_CUSTOM_MODEL_OPTION
ANTHROPIC_CUSTOM_MODEL_OPTION_NAME
ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION

这样可以在 /model 里额外加一个选项，而不是替换原有别名。

适合：

自研 LLM gateway
A/B 测试特殊路由
内部灰度模型

8.5.8 推荐配置场景

个人开发者

json

{
  "model": "sonnet",
  "effortLevel": "medium"
}

建议：

日常用 sonnet
架构问题临时切 opus 或 opusplan
遇到超大仓库时再用 [1m]

高强度架构 / 重构

json

{
  "model": "opusplan",
  "effortLevel": "medium"
}

建议：

默认用 opusplan
真正卡住时再把 effort 提到 high

团队成本控制

json

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

建议：

限掉随手切 opus
只给必要团队开更强模型

8.5.9 常见误区

误区	真相
`model` 就是强制锁模型	不是。它只是初始值。
`opusplan` = 永远更贵	不完全对。它是"规划用 Opus，执行回 Sonnet"，很多复杂任务反而更划算。
1M 一定更好	不一定。上下文更大不等于响应更快，也不等于更省钱。
effort 越高越好	也不对。高 effort 在简单任务上很容易"过度思考"。

8.5.10 实用速查

bash

# 当前会话直接切模型
/model opus

# 开 1M 上下文
/model sonnet[1m]

# 切高 effort
/effort high

# 启动就用 opusplan
claude --model opusplan

8.5.11 下一步建议

想把模型配置纳入团队治理和企业实战：继续看企业实战完整指南
想跨设备继续本地会话：继续看 Remote Control完整指南
想理解 Channels 与计划任务：继续看 Channels与计划任务完整指南

🤖 Part 1：Claude Code — Anthropic 官方编程 CLI

🦞 Part 2：OpenClaw — 开源 AI 助手

🤖 Part 3：Codex — OpenAI 编程 Agent 平台

🐧 Part 4：WorkBuddy — 腾讯 AI 办公助手

第8.5部分：模型配置（安装后的进阶配置）

8.5.0 先说结论

8.5.1 当前可用的模型别名

`opusplan` 是什么

8.5.2 模型配置优先级

常见用法

8.5.3 effort：思考深度

8.5.4 1M 上下文怎么用

最简单的用法

什么情况下该开 1M

关闭 1M

8.5.5 团队治理：`availableModels`、默认模型、别名映射

`availableModels`

注意：`model` 不是强制锁定

8.5.6 第三方部署与 `modelOverrides`

为什么需要 `modelOverrides`

典型配置

8.5.7 自定义模型入口

8.5.8 推荐配置场景

个人开发者

高强度架构 / 重构

团队成本控制

8.5.9 常见误区

8.5.10 实用速查

8.5.11 下一步建议

第8.5部分：模型配置（安装后的进阶配置） ​

8.5.0 先说结论 ​

8.5.1 当前可用的模型别名 ​

opusplan 是什么 ​

8.5.2 模型配置优先级 ​

常见用法 ​

8.5.3 effort：思考深度 ​

8.5.4 1M 上下文怎么用 ​

最简单的用法 ​

什么情况下该开 1M ​

关闭 1M ​

8.5.5 团队治理：availableModels、默认模型、别名映射 ​

availableModels ​

注意：model 不是强制锁定 ​

8.5.6 第三方部署与 modelOverrides ​

为什么需要 modelOverrides ​

典型配置 ​

8.5.7 自定义模型入口 ​

8.5.8 推荐配置场景 ​

个人开发者 ​

高强度架构 / 重构 ​

团队成本控制 ​

8.5.9 常见误区 ​

8.5.10 实用速查 ​

8.5.11 下一步建议 ​

第8.5部分：模型配置（安装后的进阶配置）

8.5.0 先说结论

8.5.1 当前可用的模型别名

`opusplan` 是什么

8.5.2 模型配置优先级

常见用法

8.5.3 effort：思考深度

8.5.4 1M 上下文怎么用

最简单的用法

什么情况下该开 1M

关闭 1M

8.5.5 团队治理：`availableModels`、默认模型、别名映射

`availableModels`

注意：`model` 不是强制锁定

8.5.6 第三方部署与 `modelOverrides`

为什么需要 `modelOverrides`

典型配置

8.5.7 自定义模型入口

8.5.8 推荐配置场景

个人开发者

高强度架构 / 重构

团队成本控制

8.5.9 常见误区

8.5.10 实用速查

8.5.11 下一步建议