Claude Code 模型选择

Claude Code 模型选择指南：按任务复杂度选 Claude 型号，GPT 型号请用 Codex；附可调用 ID、切换方法与场景建议（2026）。

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

最后核实：2026-10-20 · 📄 依据 qcode.cc（模型与单价见 qcode.cc/models，计费说明见 docs.qcode.cc）

先按任务复杂度与能力选档：日常编码用 Sonnet，架构设计与大规模重构用 Opus，最难的疑难问题用 Fable，格式化和简单问答用 Haiku；再以 qcode.cc/models 的实时可用性和单价为准。截至 2026-10-27，下列 Claude、GPT 及其它系列 ID 在 QCode 可调。

Claude Code 支持多种 AI 模型，不同档位在能力与速度上各有侧重。按任务复杂度选档，通常就能兼顾结果和响应速度。

💰 计费按 token，各模型单价见 qcode.cc/models。

Claude 模型家族概览¶

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

截至 2026-10-20，以下 Claude ID 在 QCode 可调：claude-fable-5、claude-fable-5-1、claude-opus-5-5、claude-opus-5、claude-opus-4-8、claude-sonnet-5、claude-sonnet-5-5、claude-sonnet-4-6、claude-haiku-5-5。claude-haiku-4-5-20251001 与 claude-sonnet-4-5-20250929 在 /models 标为 Retired（2026-10-20 核对），截至 2026-10-27 已不在 qcode.cc/models 列出，仍可调用。此后新增的型号，是否可用以 /models 为准。

Claude Fable 5 — 顶配旗舰¶

Fable 5 是当前能力最强的档位：

• 最强推理：面向最难的问题——跨系统架构、并发/分布式疑难 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 系列最新版本，已上架，在 QCode 可调；用 /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：成熟稳定，1M 上下文（可选开关），日常编码完全够用
• 能力均衡：日常编码与代码审查的质量稳定
• 速度较快：比 Opus 快，适合频繁交互

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

Claude Haiku 4.5 — 轻量快速¶

Haiku 是最小巧快速的档位：

• 速度最快：适合频繁、短小的请求
• 基础能力：简单任务完全胜任，复杂推理能力有限
• 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 协议，见工具兼容总览。

各模型详细对比¶

计费按 token，各模型单价见 qcode.cc/models。

场景化选择指南¶

日常编码 → 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-5-5

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

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

截至 2026-10-27，以下 GPT ID 在 QCode 可调：gpt-6.1-sol、gpt-6.1-terra、gpt-6-sol、gpt-6-astra、gpt-5.6-terra、gpt-5.6-sol。

可用模型¶

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

实时可用性以 qcode.cc/models 页为准。

同一账号还可调用以下 ID（截至 2026-10-20）：deepseek-v4.1-flash、deepseek-v4-flash、deepseek-v4-pro、glm-5.3、glm-5.3-flash、glm-5.2、qwen3.8-flash、qwen3.8-max、qwen3.7-plus、kimi-k3。这些型号的可用性以 /models 为准。

GPT 系列特点¶

• gpt-6.1-sol 是当前默认推荐（GPT-6 Sol 更新版），1.05M 上下文；gpt-6-sol 也可继续使用
• gpt-6.1-terra 是 GPT-6.1 中档型号，单价约为 gpt-6.1-sol 的一半，适合日常编码与批量任务（单价见 qcode.cc/models）
• gpt-6-astra 是最强档
• gpt-5.6-terra 是 GPT-5.6 旗舰，Codex CLI 编程场景仍可选用
• gpt-5.6-sol 是同级旗舰变体，能力相当

何时考虑非 Claude 模型¶

大部分情况下，Claude 模型是 Claude Code 的最佳选择（原生适配）。GPT 系要在 Codex CLI 里用（Claude Code 里选 GPT 会被拒绝）。以下情况可以试试 GPT 系：

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

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

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

按任务复杂度分配模型¶

混合使用策略¶

常见的分工方式是按任务复杂度分层：

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

这样日常任务留在平衡档，关键时刻再切到更高档位。

什么时候该升档¶

任务满足以下任意条件时，可以切到 Opus 甚至 Fable：

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

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

实用小贴士¶

对话中途切换模型¶

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

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

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

用 /cost 查看任务消耗¶

做完一个任务后，用 /cost 看看这次的 token 消耗。下次做类似任务时换个模型试试，对照结果和消耗，几次之后就会对每种任务该用哪一档形成直觉。

模型能力在持续进化¶

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

企业团队版 →