模型与渠道选择

ccodezh 的教程中提到：除“官方渠道模型”外，还可能存在带 -n 后缀的“特殊渠道模型”。这类模型通常更便宜，但质量/稳定性可能与官方不完全一致。

先看哪里最准确？

模型列表与价格以官网为准：https://ccodezh.com/models

0. 为什么 Claude Code 会使用 Haiku 模型？

在使用 Claude Code 时，你可能会发现即使主要使用的是 Sonnet 或 Opus 模型，系统也会在某些场景下自动调用 Haiku 模型。这是 Claude Code 的多模型协作架构 的核心设计。

📊 Haiku 的使用场景

Claude Code 会在以下场景自动使用 Haiku：

1. 子代理 (Sub-agents) - 当主模型（如 Sonnet）需要并行执行多个任务时，会派生 Haiku 驱动的子代理来处理具体实现
2. 后台功能 - 一些后台操作和工具路由使用 Haiku 以提高效率
3. 代码库探索 - 内置的 "Explore" 代理使用 Haiku 来搜索和分析代码结构
4. 执行模式 - 在 opusplan 模式下，Opus 负责规划，而实际代码生成可能切换到更轻量的模型

💡 为什么这样设计？

Anthropic 官方解释：

"Sonnet 4.5 can break down a complex problem into multi-step plans, then orchestrate a team of multiple Haiku 4.5s to complete subtasks in parallel."

这是一个 成本-性能权衡 的精妙设计：

• 性能优秀 - Haiku 4.5 在 SWE-bench 上达到 73.3%，对于明确定义的任务（组件实现、bug 修复、测试生成）表现接近前沿水平
• 速度更快 - 响应速度是 Sonnet 的 2 倍以上
• 成本更低 - 使用成本仅为 Sonnet 的 1/3

通过 Sonnet/Opus 负责高层规划和复杂推理，Haiku 负责具体执行，实现了 最优的成本效益比。

🔧 自定义子代理模型

如果你想控制子代理使用的模型，可以通过环境变量配置：

{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-xxxxxx-n",
    "CLAUDE_CODE_SUBAGENT_MODEL": "你想使用的模型名"
  }
}

📚 参考资料

• Anthropic 官方公告
• Claude Code 官方文档

---

0.1 省钱神器：opusplan 双模型协作模式

Claude Code 内置了一个"隐藏命令"，一行指令就能开启智能降本模式：

/model opusplan

🧠 工作原理

开启后，Claude Code 自动切换为双模型分工：

• 规划阶段（分析需求、读代码、设计方案）→ 使用 Opus，发挥最强推理能力
• 执行阶段（写代码、改文件、跑测试）→ 自动切回 Sonnet，快速且便宜

简单来说：用最聪明的大脑想方案，用最快的手去干活。

💰 为什么推荐？

• Opus 负责"想清楚"，减少反复试错带来的返工开销
• Sonnet 负责"写代码"，速度快、成本低
• 社区实测节省约 40% 的 token 开销
• 这是 Anthropic 官方内置功能，官方工程团队自己也在用

🎯 适合哪些场景？

• 多文件重构、新功能开发、不熟悉的代码库
• 架构设计、复杂逻辑梳理
• 任何"先想清楚再动手"比"边写边改"更高效的任务

---

1. 不配置时会用哪个模型？

一般情况下：

• 你不显式指定模型时，Claude Code 会按其默认策略选择（通常是 Sonnet 系列的默认模型）
• ccodezh 也可能在服务端做默认路由与调度

如果你希望“固定使用某个模型”，就需要显式配置。

2. 最常用：只指定一个模型

在 ~/.claude/settings.json 的 env 中加入（或修改）：

{
  "env": {
    "ANTHROPIC_MODEL": "把这里替换为你要使用的模型名"
  }
}

模型名请从 https://ccodezh.com/models 复制，避免拼写错误。

3.（可选）分别指定 Opus / Sonnet / Haiku 的默认模型

如果你希望在不同场景（或不同指令/入口）下分别默认使用某个系列模型，可按 ccodezh 教程配置：

{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-xxxxxx-n",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-5-xxxxxx-n",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5-xxxxxx-n",
    "ANTHROPIC_MODEL": "claude-sonnet-4-5-xxxxxx-n"
  }
}

注意

上面的模型名仅为“结构示例”。实际可用模型、后缀（是否 -n）与日期版本都以官网为准。

4. 渠道选择的建议

• 追求稳定：优先用“官方渠道模型”（通常无 -n 后缀）
• 追求性价比：再考虑“特殊渠道模型”（通常带 -n 后缀）
• 任何时候遇到成本/质量差异：以 https://ccodezh.com/models 的实时定价说明为准