模型选择指南

了解不同 AI 模型的特点和适用场景，做出最佳选择

需要 API Key？ 前往注册 →·端点与 Base URL →

模型选择指南¶

Claude Code 支持多种 AI 模型，每种模型都有不同的能力、速度和价格。选对模型，既能获得最佳效果，又能控制成本。这篇指南帮你在不同场景下做出最优选择。

💰 本页只谈「怎么选」；各模型的实时单价以 qcode.cc/models 为准，下文成本均用相对比例表示。

Claude 模型家族概览¶

目前通过 QCode.cc 可用的 Claude 模型构成一个能力阶梯：

Claude Fable 5 — 顶配旗舰¶

Fable 5 是当前能力最强的档位，也是价格最高的（输入单价约为 Haiku 的 10 倍）：

• 最强推理：面向最难的问题——跨系统架构、并发/分布式疑难 bug、一次性关键决策
• 1M 上下文 / 128K 输出：大型代码库全局理解
• 用在刀刃上：日常任务用它属于「杀鸡用牛刀」，费用也不划算

适用场景：关键技术决策、久攻不下的疑难杂症、对产出质量要求极高的一次性任务。

Claude Opus 5.5 / 5 / 4.8 — 主力旗舰¶

Opus 是久经考验的主力旗舰：

• 深度推理：长链条逻辑推理，适合复杂架构设计
• 代码质量：生成的代码考虑更全面，边界情况处理更完善
• 1M 上下文：理解大型代码库的能力强
• 同价同窗口：Opus 5 与 Opus 4.8 单价一致、上下文/输出上限一致，可随时互换
• Opus 5.5（claude-opus-5-5）：Opus 系列最新版本，已上架；用 /model claude-opus-5-5 或 ANTHROPIC_MODEL=claude-opus-5-5 指定，单价见 qcode.cc/models

适用场景：架构设计、大规模重构、技术方案评估、复杂 bug 排查。

Claude Sonnet 5 / Sonnet 4.6 — 最佳平衡¶

Sonnet 是大多数开发者的日常首选，能力与成本平衡最好：

• Sonnet 5：新一代平衡档，1M 上下文 / 128K 输出，比 Sonnet 4.6 更便宜（$2/$10 对 $3/$15），输出上限也翻倍（128K 对 64K）——新项目建议直接用它
• Sonnet 4.6：成熟稳定，1M 上下文（可选开关），日常编码完全够用
• 性价比高：输入单价约为 Opus 的 60%，输出质量接近
• 速度较快：比 Opus 快，适合频繁交互

适用场景：日常编码、Bug 修复、代码审查、文档撰写、测试编写。

Claude Haiku 4.5 — 轻量快速¶

Haiku 是最小巧快速的档位，价格也最低：

• 速度最快、价格最低（输入单价约为 Sonnet 的 1/3）
• 基础能力：简单任务完全胜任，复杂推理能力有限
• 200K 上下文

适用场景：简单问答、代码格式化、生成样板代码、快速翻译。

Claude Haiku 5.5 — 子代理与轻量任务档位¶

Haiku 5.5（claude-haiku-5-5）在 QCode 上可调。在 Claude Code 里，Anthropic API 上 haiku 别名解析到的就是这一档。下面每条都是复述 Claude Code 官方文档（模型配置页与子代理页）。

• 怎么指定：官方给出的 Haiku 5.5 模型 ID 是 claude-haiku-5-5——在会话里运行 /model claude-haiku-5-5，或者用 claude --model claude-haiku-5-5 启动 Claude Code。
• haiku 别名：haiku 与 opus、sonnet、fable 同属模型家族别名，官方的描述是用于简单任务的快速、经济的 Haiku 模型。从 Claude Code v2.1.293 起，haiku 在 Anthropic API 上解析到 Haiku 5.5。
• ANTHROPIC_DEFAULT_HAIKU_MODEL：按官方说明，这个变量的值是给 haiku 使用的模型，也就是供后台功能使用的模型。同级的 ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_FABLE_MODEL 决定这四个别名各自解析到什么。每个值都必须是一个完整模型名，或者你的 API 服务商对应的标识符。较早的 ANTHROPIC_SMALL_FAST_MODEL 已废弃，由 ANTHROPIC_DEFAULT_HAIKU_MODEL 取代。
• 子代理用哪个模型怎么定：官方给的解析顺序是——先看单次调用传入的 model 参数，再看子代理定义里的 model frontmatter（写 inherit 就是取主对话的模型），然后看 CLAUDE_CODE_SUBAGENT_MODEL 环境变量（你把它设成别名或模型 ID 时），最后才回到主对话的模型。子代理的 model 字段可以写 sonnet、opus、haiku、fable，也可以写 claude-opus-5-5 这样的完整模型 ID，或者 inherit；完整模型 ID 的取值与 --model 参数一致——所以 model: claude-haiku-5-5 是官方文档里成立的写法。
• 把所有子代理钉在同一个模型上：CLAUDE_CODE_SUBAGENT_MODEL 只是默认值，子代理自己的定义或 Claude 传入的模型仍然优先。要让所有子代理都用同一个模型，官方还要你把 CLAUDE_CODE_SUBAGENT_MODEL_FORCE 设成 1，这需要 Claude Code v2.1.257 或更高版本。
• 官方没写的部分：官方文档没有记载「自动把子代理路由到更小模型」这回事。没有指定模型的子代理会继承主对话的模型；只设 CLAUDE_CODE_SUBAGENT_MODEL 并不会改变内置 Explore、Plan 两个子代理所用的模型。官方把探索类任务挪到这一档的做法，是自建一个名为 Explore 的用户级或项目级子代理——它保留自己的 model 字段——然后用 model: haiku 定义。
• 上下文窗口：在 Anthropic API 上，Haiku 5.5 在所有套餐里都用 1M 上下文窗口，不需要加 [1m] 后缀。而在通过 ANTHROPIC_BASE_URL 配置的网关后面，Claude Code 会给它认识的每个模型套用该模型在 Anthropic API 上的上下文窗口，并且检测不到网关或其背后服务所设的更低上限。

官方「让每个子代理都跑在 Haiku 上」的示例，是把两个变量一起写进设置文件的 env 块：

{
  "env": {
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
    "CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1"
  }
}

在 QCode 上，claude-haiku-5-5 由 Anthropic 协议端点提供，所以把 Claude Code 指向 https://api.qcode.cc/api（见接入点与 API 路径）。这个变量改变的是请求发到哪里，不是由哪个模型作答：

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-5-5"
export CLAUDE_CODE_SUBAGENT_MODEL="claude-haiku-5-5"

按 token 计费，各模型单价见 qcode.cc/models。哪些客户端能说 Anthropic 协议，见工具兼容总览。

各模型详细对比¶

相对成本以 Haiku 4.5 输入单价为 1×；具体单价与缓存价格见 qcode.cc/models。

同一任务的相对费用¶

假设完成一个中等复杂的编码任务（输入 15K tokens，输出 5K tokens），以 Haiku 的费用为基准：

能力差异同样显著——复杂任务用便宜的模型可能反复重试，最终花费反而更多。

场景化选择指南¶

日常编码 → Sonnet 5 / Sonnet 4.6¶

日常编写函数、组件、接口等，Sonnet 完全够用：

/model claude-sonnet-5

> "在 @src/services/user-service.ts 中添加 deleteUser 方法"
> "创建一个 Pagination 组件，支持上一页/下一页/页码跳转"
> "给 @src/app/api/orders/route.ts 添加分页参数支持"

架构设计 / 大规模重构 → Opus 5¶

涉及系统设计和全局决策时，Opus 的深度推理能力物有所值：

/model opus

> "分析 @src/ 目录下的整体架构，我计划将单体应用拆分为微服务。
请评估哪些模块适合独立，并给出拆分方案。"

关键决策 / 疑难杂症 → Fable 5¶

排查很久没头绪的 bug、影响深远的一次性技术决策，值得上顶配：

/model claude-fable-5

> "这个偶发的数据不一致问题已经排查三天：现象、日志、复现步骤如下……
请系统性分析所有可能的根因并给出验证方案。"

代码格式化 / 简单问答 → Haiku 4.5¶

不需要深度思考的机械性工作，用 Haiku 最划算：

/model haiku

> "把 @src/types/index.ts 中的所有 interface 加上 JSDoc 注释"
> "ESLint 报了这个错误是什么意思：no-unused-vars"

大型 PR Review → Opus 5¶

审查涉及多个文件的大型改动时，Opus 能发现更深层的问题。

Bug 修复 → Sonnet 5 / 4.6¶

大部分 bug 修复 Sonnet 就能处理好；特别复杂的、涉及并发或分布式系统的 bug，再切换到 Opus 或 Fable。

场景选择速查表¶

如何切换模型¶

方法 1：/model 命令（推荐）¶

在 Claude Code 中随时切换，立即生效：

/model                    # 查看当前模型和可选列表
/model sonnet             # 切换到 Sonnet
/model opus               # 切换到 Opus
/model haiku              # 切换到 Haiku
/model claude-sonnet-5    # 按完整模型名切换
/model claude-fable-5

方法 2：环境变量¶

在 shell 配置文件（如 ~/.bashrc 或 ~/.zshrc）中设置默认模型：

export ANTHROPIC_MODEL=claude-sonnet-5

# 或者在启动时临时指定
ANTHROPIC_MODEL=claude-opus-5-5 claude

方法 3：CLAUDE.md 中配置¶

在项目的 CLAUDE.md 中给 Claude 一些模型使用建议（注意这是建议，不是强制配置）：

## 模型使用建议

- 日常开发使用 Sonnet
- 架构变更前切换到 Opus 先做方案评估
- 批量添加注释时可以用 Haiku 节省成本

方法 4：启动参数¶

claude --model claude-fable-5
claude --model claude-sonnet-5
claude --model claude-haiku-4-5-20251001

GPT 和 Codex 模型（通过 QCode.cc）¶

通过 QCode.cc 的转发服务，同一把密钥还可以使用 GPT 系列模型。

可用模型¶

gpt-6-luna / gpt-5.6-luna 暂不提供支持，请使用其他 GPT 模型。

单价见 qcode.cc/models；实时可用清单可带密钥 GET https://api.qcode.cc/v1/models 查询。

GPT 系列特点¶

• gpt-6-sol 是当前主推旗舰，1.05M 上下文，默认推荐
• gpt-6-astra 最强档，单价也最高
• gpt-5.6-terra 是 GPT-5.6 旗舰，Codex CLI 编程场景仍可选用
• gpt-5.6-sol 是同级旗舰变体，能力相当

何时考虑非 Claude 模型¶

大部分情况下，Claude 模型是 Claude Code 的最佳选择（原生适配）。以下情况可以试试 GPT 系：

• 想做对比测试：同一个任务不同模型跑一遍，看哪个结果更好
• Codex 工作流：Codex CLI 用户天然使用 GPT 系
• 预算考量：轻量档 GPT 模型在简单任务上更省

# GPT 系不在 Anthropic 协议上：Claude Code 里 /model gpt-* 会被拒
# 要用 GPT 请走 Codex CLI（OpenAI Responses / Chat 协议）
codex --model gpt-6-sol "重构这个模块"

注意：非 Claude 模型在 Claude Code 中可能无法使用某些特性（如 Extended Thinking 的部分功能）。建议以 Claude 模型为主，其他模型作为补充。

成本收益分析¶

混合使用策略¶

最省钱且高效的策略是「Sonnet 为主，Opus 点睛，Fable 攻坚，Haiku 打杂」：

总任务量分配（参考）：
├── Sonnet 5 / 4.6（~70%）— 日常开发、Bug 修复、写测试、Review
├── Opus 5 / 4.8（~13%）— 架构决策、复杂问题、大型重构
├── Fable 5     （~2%） — 关键决策、久攻不下的疑难杂症
└── Haiku 4.5   （~15%）— 格式化、简单问答、批量操作

相比全程使用旗舰模型，混合策略的费用接近全 Sonnet，但在关键时刻有顶配推理能力兜底。

何时值得升档¶

任务满足以下任意条件时，切到 Opus 甚至 Fable 是值得的：

1. 影响范围大：改动涉及多个模块、系统或团队
2. 一次性决策：架构选型、技术栈迁移等不可轻易回头的决策
3. 调试成本高：这个 bug 已经排查了很久，需要更深入的分析
4. 代码质量关键：这段代码会被很多地方调用，需要足够健壮

反过来，写内部工具、改样式、加注释，Sonnet 甚至 Haiku 就完全够用。

实用小贴士¶

对话中途切换模型¶

可以在一个对话中途切换模型：先用 Opus/Fable 制定方案，确认后切到 Sonnet 执行——关键决策享受顶级推理，执行阶段控制成本。

/model opus
> "分析现有代码架构，制定权限系统的实施方案"

/model claude-sonnet-5
> "按照刚才的方案，开始实现第一步：创建权限模型"

用 /cost 对比不同模型的消耗¶

做完一个任务后，用 /cost 看看花了多少。下次做类似任务时换个模型试试，对比效果和成本。几次对比后，你就会对每种任务该用哪个模型形成直觉。

模型能力在持续进化¶

本页的能力描述反映当前版本的相对关系。新模型上线、旧模型退役都会更新在 qcode.cc/models，选型拿不准时以实测为准。

企业团队版 →