自学教程

Claude Code 模型切换指南

Claude Code 教程

简介

Claude Code 支持在会话内临时切换、启动时指定、配置文件永久设置、环境变量全局指定模型。同时支持通过 LLM 网关对接 DeepSeek 等第三方模型。

配置优先级（由高到低）：会话内 /model 命令 > CLI启动参数 --model > 环境变量 ANTHROPIC_MODEL > 项目 .claude/config.json > 全局用户配置。

一、模型选型参考

模型模型ID适用场景特点
Claude Haikuclaude-haiku-5-5简单代码修改、脚本生成、快速重构速度快、低成本，轻量任务首选
Claude Sonnetclaude-sonnet-5-5常规开发、业务模块编写、调试、代码审查均衡速度/能力，日常开发默认推荐
Claude Opusclaude-opus-5-5大型项目重构、架构设计、复杂多文件改造、深度代码审计推理能力强，Token成本更高
Claude Fableclaude-fable-5-1极复杂工程难题、跨系统方案设计最强能力，价格最高

提示：账户需要开通对应模型权限，无权限会返回鉴权/模型不存在报错。

二、四种切换方式

1. 会话内临时切换（最常用，IDE/CLI会话中）

进入 Claude Code 会话，使用斜杠命令：

/model claude-haiku-5-5

不带参数打开模型选择器：

/model
  • 按 Enter：切换并保存为默认模型，后续新建会话生效
  • 按 s：仅当前会话临时切换，不修改全局默认

⚠️ 切换模型不会清空当前会话历史，上下文继续沿用；如果需要全新上下文，执行 /reset。

2. CLI 启动时指定（单次会话生效）

启动命令追加 --model 参数：

claude --model claude-opus-5-5

本次会话固定使用该模型，不修改配置文件。

3. 环境变量配置（全局生效）

在 .env 文件添加，所有新建会话默认使用：

ANTHROPIC_MODEL=claude-sonnet-5-5

修改环境变量后，必须重启IDE/终端才能生效。

4. 配置文件永久设置（项目团队共享）

编辑项目 .claude/config.json：

{
  "model": "claude-sonnet-5-5"
}

提交到Git仓库，团队成员打开项目默认使用该模型。全局用户配置 ~/.config/claude-code/config.json 写法一致，本机所有项目生效。

三、通过网关切换第三方模型（DeepSeek示例）

Claude Code 支持通过 LLM 网关转发请求，使用 DeepSeek 等第三方模型。

  1. 设置网关地址环境变量
ANTHROPIC_BASE_URL=[https://xxx.gateway.com/v1](https://xxx.gateway.com/v1)
ANTHROPIC_API_KEY=DeepSeek_API_KEY
ANTHROPIC_MODEL=deepseek-coder
  1. 在会话内切换
/model deepseek-coder

注意：第三方模型能力、工具调用格式和原生Claude存在差异，Skills、MCP功能可能出现兼容性问题，切换后需要完整回归测试。

四、切换模型验证步骤（切换完成必做）

  1. 执行 /config，查看当前 model 字段，确认模型已生效。
  2. 简单测试任务：读取文件、代码修改，验证工具调用正常。
  3. 复杂任务：测试多文件编辑、bash工具、MCP/Skills（如开启）。
  4. 核对Token消耗速率，确认是目标模型计费。

五、模型切换最佳实践

  1. 日常开发默认 Sonnet，兼顾速度与代码能力；简单脚本改用 Haiku，降低成本。
  2. 大型重构、架构方案时临时切换 Opus；任务完成切回 Sonnet。
  3. 项目配置锁定基础模型，个人环境变量可本地覆盖。
  4. 切换到第三方模型前，先关闭复杂 Skills、MCP，减少兼容性报错。
  5. 模型版本固定写完整ID，不要仅使用别名，防止官方别名自动升级带来行为变化。
  6. 多模型测试时，每次切换建议新建会话 /reset，避免旧上下文干扰模型输出。

六、常见问题排查

1. /model 切换提示模型不存在

  • 模型ID输入错误；检查账户是否开通该模型权限。
  • 使用网关时，网关侧没有添加该模型。

2. 切换模型不生效

  • 优先级问题：会话内 /model 优先级最高；环境变量/CLI参数会覆盖配置文件。
  • 修改 .env、配置文件后，未重启会话/IDE。排查：/config 查看当前生效值。

3. 切换第三方模型后，工具调用失效

第三方模型对工具调用、MCP支持弱于原生Claude。
解决：简化任务，关闭复杂技能；优先使用原生Claude模型做文件编辑。

4. 切换模型后，输出风格、代码习惯突变

模型能力、上下文策略不同。
解决：执行 /reset 清空历史；在 CLAUDE.md 统一编码规范，约束输出风格。

5. 模型切换后Token消耗暴涨

Opus / Fable 计费单价远高于 Sonnet/Haiku，复杂任务会消耗大量Token。
解决：任务完成及时切回轻量模型；设置最大工具轮次 maxToolTurns 限制调用次数。

小结

Claude Code模型切换有四种方式，优先级从上到下依次降低。开发常规任务推荐 Sonnet；简单任务用 Haiku；大型重构使用 Opus。借助LLM网关可以接入DeepSeek等第三方模型，但需要注意工具能力兼容性。切换模型后务必使用 /config 验证并做简单功能测试。

标签：

0 条笔记