# Clavue v2 模型支持现状深度评估 (2026-05-07)

> 检查 Clavue 对 Anthropic Claude / OpenAI GPT-5.x / Codex 三大模型族的支持深度
> 对比基线：Claude Code 当前公开能力（仅引用已确认事实，不臆造）

---

## 一、Claude 模型支持现状

### 1.1 已配置的 Claude 模型 (configs.ts)

| 模型族 | 起点是否支持 | 当前状态 | 1M context | 备注 |
|--------|-------------|---------|-----------|------|
| Claude 3.5 Haiku | ✅ | ✅ `claude-3-5-haiku-20241022` | ❌ | 历史模型 |
| Claude 3.5 Sonnet v2 | ✅ | ✅ `claude-3-5-sonnet-20241022` | ❌ | 历史模型 |
| Claude 3.7 Sonnet | ✅ | ✅ `claude-3-7-sonnet-20250219` | ❌ | 历史模型 |
| Claude Sonnet 4.0 | ✅ | ✅ `claude-sonnet-4-20250514` | ✅ (`modelSupports1M`) | |
| **Claude Sonnet 4.5** | ✅ | ✅ `claude-sonnet-4-5-20250929` | ✅ | |
| **Claude Sonnet 4.6** | ✅ | ✅ `claude-sonnet-4-6` | ✅ + 实验性自动扩展 | 默认 |
| Claude Haiku 4.5 | ✅ | ✅ `claude-haiku-4-5-20251001` | ❌ | |
| Claude Opus 4.0 | ✅ | ✅ `claude-opus-4-20250514` | ❌ | |
| Claude Opus 4.1 | ✅ | ✅ `claude-opus-4-1-20250805` | ❌ | |
| Claude Opus 4.5 | ✅ | ✅ `claude-opus-4-5-20251101` | ❌ | |
| **Claude Opus 4.6** | ✅ | ✅ `claude-opus-4-6` | ✅ (`opus-4-6` matches) | 默认 |

**模型 ID 配置：4 个 provider 维度**：firstParty / bedrock / vertex / foundry

### 1.2 Claude 模型路由别名

```typescript
MODEL_ALIASES = ['sonnet', 'opus', 'haiku', 'best', 'sonnet[1m]', 'opus[1m]', 'opusplan']
```

- `sonnet` / `opus` / `haiku`：解析到对应族最新版本
- `[1m]` 后缀：显式启用 1M context window
- `opusplan`：plan mode 用 Opus 但其他用 Sonnet
- `best`：解析到当前最强模型（Opus 4.6）
- 通配符 allowlist：`opus` 在白名单代表"任何 opus"，具体 ID 代表精确版本

### 1.3 Claude 高级特性支持

| 特性 | Clavue 支持 | 说明 |
|------|------------|------|
| 1M context (Sonnet) | ✅ | 通过 `[1m]` 后缀显式启用，或自动检测 sonnet-4-6 实验组 |
| 1M context (Opus) | ✅ | `modelSupports1M(opus-4-6)` |
| `getContextWindowForModel` | ✅ | 多重决策：env > suffix > capability > beta > experiment > default |
| Extended Thinking | ✅ | 通过 SDK 原生支持，passes through to API |
| Server-side Context Management | ✅ | Phase 1 修复，全用户默认启用 `context_management.edits` |
| `clear_tool_uses_20250919` | ✅ | TOOLS_CLEARABLE_RESULTS / TOOLS_CLEARABLE_USES |
| `clear_thinking_20251015` | ✅ | hasThinking 守卫 + redact-thinking 抑制 |
| Prompt caching `cache_control` | ✅ | 通过 `cache_edits` / `cache_reference` 维护 |
| Batch API (`messages.batches`) | ❌ **缺失** | 完全未实现 |
| Citations | ✅ Anthropic 直连 / ❌ 适配器 | 直连支持，适配器丢失 |
| Files API | ✅ | 已使用 |
| Multi-modal (image input) | ✅ | base64 + url 双路径 |

### 1.4 Claude Code 对比

| 维度 | Claude Code (官方) | Clavue | 差距 |
|------|-------------------|--------|------|
| 模型族覆盖 | Anthropic 全家族 | Anthropic 全家族 | **持平** |
| 1M context | 自动 + 手动 | 自动 + 手动 + 实验组 | **持平/略优** |
| Extended Thinking | 原生 | 通过 SDK 原生 | **持平** |
| Context Management | 自动启用 | Phase 1 后默认启用 + 8 测试 | **持平** |
| Prompt Caching | 服务端自动 | 服务端 + 客户端 cache_edits 维护 | **客户端复杂度高** |
| Batch API | 可用 | ❌ 未实现 | **差距** |
| Citations 跨适配器 | N/A（无适配器） | 适配器中丢失 | **3P provider 不支持** |
| 模型发现 | bootstrap API 动态获取 | 硬编码 `configs.ts` + capability 缓存 | **更新滞后风险** |

---

## 二、GPT-5.x 模型支持现状

### 2.1 已知 GPT-5.x SKU 覆盖

```typescript
// providerModes.ts + providerProfiles.ts
'gpt-5.1', 'gpt-5.3-codex', 'gpt-5.3-codex-spark', 'gpt-5.4', 'gpt-5.5'
```

**Routing Presets**（providerProfiles.ts）：
- `gpt_5_5_max` — 全部 slot 跑 5.5，small-fast 用 5.3-codex
- `gpt_5_4_codex` — primary 5.4 + 子代理 5.3-codex
- `gpt_5_1_stable` — 全部 slot 跑 5.1
- `gpt_5_3_codex` — 全部 slot 跑 5.3-codex
- `claude_code_heritage` — 维持 Claude 行为

**Provider Mode Presets**（providerModes.ts）：
- OpenRouter / GLM / Minimax / Kimi / 自定义 gateway 各有不同的默认 + recommended 列表

### 2.2 GPT-5.x 模型识别（adapter）

```typescript
// openaiResponsesConfig.ts
const OPENAI_RESPONSES_MODEL_PATTERNS = [
  /^gpt-\d+(?:[.-]\d+)*(?:$|[-_.])/,    // gpt-5.4, gpt-5.5, gpt-4o, ...
  /^gpt-image-\d+(?:[.-]\d+)*(?:$|[-_.])/, // gpt-image-1
  /codex/,                                 // codex / gpt-5.3-codex
]
```

通用正则匹配，不需要为新 GPT-5.x 版本单独加配置。

### 2.3 GPT-5.x 高级特性支持

| 特性 | Clavue 支持 | 说明 |
|------|------------|------|
| `/v1/responses` 协议 | ✅ | streamTranslator (753 行) 完整状态机 |
| `/v1/chat/completions` 协议 | ✅ | gpt-image-* 模型走 chat completions |
| reasoning effort | ✅ | low/medium/high/xhigh 映射 |
| reasoning effort = max → xhigh | ✅ | mapAnthropicEffortToResponsesEffort |
| function calling (tool_use) | ✅ | tool schema 双向翻译，原始 schema 保留 |
| structured outputs (json_schema) | ✅ | translateTextConfig 处理 |
| verbosity (low/medium/high) | ✅ | normalizeGptVerbosity |
| streaming function call deltas | ✅ | input_json_delta 流式 |
| image input | ✅ | 双向：input_image (responses) ↔ image_url (chat) |
| Codex CLI 集成 | ✅ | MAO supervisor 通过 spawn `@openai/codex` |
| spark alias | ✅ | `spark` → `gpt-5.3-codex-spark` |
| capability snapshot | ✅ | responsesReasoningMedium/XHigh 等 7 个字段验证 |

### 2.4 GPT-5.x 不支持/有损的特性

| 特性 | 状态 | 影响 |
|------|------|------|
| Anthropic `cache_control` | ❌ 适配器中丢失 | 跨 GPT-5.x 路径无法复用 prompt cache |
| Anthropic `citations` | ❌ 适配器中丢失 | GPT-5.x 用户无法用 citations 工具 |
| Anthropic `thinking` blocks (signature) | ⚠️ 跳过 | requestBuilders 中 thinking/redacted_thinking 被 break；reasoning effort 通过 translateReasoning 单独处理 |
| Server-side context_management | ❌ 不适用 | Anthropic-only 特性，gateway 走 OpenAI Responses 路径不受益 |
| Batch API (OpenAI) | ❌ | 未实现 |

---

## 三、Codex 模型支持现状

| 维度 | 现状 | 说明 |
|------|------|------|
| `@openai/codex` 依赖 | ✅ 锁定 0.118.0 | 通过 `bundleDependencies` 方式分发 |
| Codex runtime modes | ✅ exec / app-server / auto | `CLAVUE_MAO_CODEX_RUNTIME` |
| Codex 通过 MAO supervisor 调用 | ✅ | `commandBuilders.ts` 构造 CLI 命令 |
| Codex provider override | ✅ | `buildCodexProviderOverrides` 注入 model_providers |
| Bearer token 模式 | ✅ | `experimental_bearer_token=true` for auth_token profiles |
| Codex 模型 family detect | ✅ | `isGptCodexFamilyModel` 匹配 `gpt|codex` |

**Codex 集成深度比 Claude Code 深得多** — Claude Code 不使用 Codex CLI。

---

## 四、与 Claude Code 当前版本对比

### 4.1 Clavue 的优势（相对 Claude Code）

| 优势 | Clavue 独有 | Claude Code 状态 |
|------|------------|----------------|
| **多 provider 路由** | ✅ OpenRouter/GLM/Minimax/Kimi/Anthropic 等多 gateway | 仅 Anthropic（含 Bedrock/Vertex/Foundry 三个底座） |
| **OpenAI Responses 适配器** | ✅ 14 子模块 / 2240 行模块化 | 不需要（无适配器层） |
| **OpenAI Chat Completions 适配器** | ✅ gpt-image-* 路径 | 无 |
| **GPT-5.x 系列原生支持** | ✅ 5.1/5.3-codex/5.4/5.5 全覆盖 | 无 |
| **Codex CLI 集成 + MAO supervisor** | ✅ multi-agent 文件锁 + advisory locking | 无（Claude Code 用原生 Agent + Team） |
| **Provider profile 系统** | ✅ 6 个 preset + 自定义 routing | 无（单 provider） |
| **Capability snapshot** | ✅ 7 字段验证（anthropicToolUse, responsesReasoningMedium 等） | 不需要 |
| **Companion 角色系统** | ✅ girl/boy/bigdaddy（opt-in） | 无 |
| **Discipline 用户偏好层** | ✅ Phase 7 解耦 | 无（不需要） |
| **Workflow continuity 检测** | ✅ "继续开发"等 keyword | 无 |
| **Auto Mode** | ✅ | 无 |

### 4.2 Clavue 的差距（相对 Claude Code）

| 差距 | Clavue 现状 | Claude Code | 修复建议 |
|------|-----------|------------|----------|
| **Batch API** | ❌ 未实现 | 可用 | 实现 `messages.batches` 接入（中 ROI） |
| **动态模型发现** | ❌ 硬编码 configs.ts | bootstrap API 动态获取 + capability 缓存（部分） | 扩展 capability 缓存覆盖外部用户 |
| **Citations 跨 3P provider** | ❌ adapter 丢失 | N/A（仅 Anthropic） | 在 responsesAdapter 中加 citations 透传（GPT-5 不支持时降级） |
| **Prompt caching 跨 3P provider** | ❌ adapter 丢失 cache_control | N/A | 类似 citations 处理 |
| **Thinking blocks signature 透传** | ⚠️ adapter 中跳过 | 原生支持 | 适配器保留 thinking signature（即使 OpenAI 端不消费，也保留 round-trip） |
| **模型新 SKU 跟进速度** | 当前 Opus 4.6 / Sonnet 4.6 | bootstrap 动态 | 模型发现机制 + 不依赖代码更新 |
| **Bedrock/Vertex/Foundry 测试覆盖** | 配置在 configs.ts 但缺新 SKU 测试 | 内部测试 | 添加 3P 模型映射回归测试 |

### 4.3 双方都没有的（共同短板）

| 短板 | 影响 |
|------|------|
| 模型自动 fallback 链 | 主模型失败时无优雅降级 |
| 跨 provider cost 估算 | 用户难以预估使用成本 |
| 模型 A/B 测试框架 | 无法系统比较不同模型在同任务上的表现 |

---

## 五、当前模型支持评分

| 模型族 | 支持完整度 | 评分 | 主要短板 |
|--------|----------|------|---------|
| Claude (Opus 4.0/4.1/4.5/4.6) | 接近完美 | **9.5/10** | Batch API 缺失 |
| Claude (Sonnet 4.0/4.5/4.6) | 接近完美 | **9.5/10** | Batch API 缺失，1M context 跨 3P provider 配置缺失 |
| Claude (Haiku 3.5/4.5) | 完整 | **9/10** | 1M context 不可用（产品决策，不是缺陷） |
| Claude (3.5/3.7 Sonnet) | 完整 | **9/10** | 历史模型 |
| GPT-5.5 | 较完整 | **8/10** | citations/cache_control 跨适配器丢失 |
| GPT-5.4 | 较完整 | **8/10** | 同上 |
| GPT-5.3 Codex (含 spark) | 较完整 | **8.5/10** | MAO supervisor 集成深 |
| GPT-5.1 stable | 较完整 | **7.5/10** | reasoning effort 验证可能缺 |
| Codex CLI | 完整 | **9/10** | 版本锁定风险 |

---

## 六、提升空间（按 ROI 排序）

### 高 ROI（短期可做）

#### 1. **Batch API 接入** (Claude + GPT 双向)
- Claude: 用 `@anthropic-ai/sdk` 的 `messages.batches.create`
- GPT-5.x: OpenAI Batch API（不同协议）
- 价值：批量提示降本（50%+）、不阻塞主交互
- 实现：新增 `services/api/batch.ts`，与现有 client.ts 并行

#### 2. **动态模型发现** (替代硬编码 configs.ts)
- 现状：每次新模型发布需要代码更新
- 方案：扩展 `modelCapabilities.ts` 的 cache 系统，对外部用户也启用
- 价值：解锁未来 Opus 4.7 / Sonnet 4.7 自动支持
- 风险：缓存失效时的降级路径

#### 3. **Adapter 透传无损翻译标记**
- 现状：cache_control / citations / thinking signature 在 adapter 中静默丢失
- 方案：保留 round-trip（OpenAI 端不消费但保留 metadata，Anthropic round-trip 时还原）
- 价值：Sonnet ↔ GPT-5.x 切换时不丢失上下文

#### 4. **3P provider 1M context 配置**
- 现状：1M context 仅 firstParty 配置
- 方案：在 modelOptions 中给 Bedrock/Vertex 也加 1M 选项（如果 provider 支持）
- 价值：企业用户解锁长上下文

### 中 ROI（中期）

#### 5. **GPT-5.x reasoning effort 自动调优**
- 现状：用户手动指定 effort
- 方案：基于任务复杂度自动选择（简单查询 low / 复杂 plan high / 重构 xhigh）
- 价值：降本 + 体验提升

#### 6. **模型自动 fallback 链**
- 现状：主模型 API 错误时直接报错
- 方案：定义 fallback 优先级（如 Opus 4.6 失败 → Sonnet 4.6 → Haiku 4.5）
- 风险：fallback 决策需要明确呈现给用户，避免静默降级误导

#### 7. **跨 provider cost 估算**
- 现状：无
- 方案：基于 model + token 估算 + 实时显示
- 数据：Anthropic / OpenRouter 等定价 API

### 低 ROI（长期）

#### 8. **模型 A/B 测试框架**
- 同任务 split 给两个模型，统计差异
- 适合 evaluator 工作流，普通用户无感

#### 9. **Codex backend 可插拔**
- 现状：硬绑定 `@openai/codex 0.118.0`
- 方案：抽象 `CodexBackend` 接口，未来可替换
- 触发条件：上游 breaking change 时再做

---

## 七、对 Clavue 模型 SKU 列表的具体建议

### 立即可加（已有路由 preset 但未在 configs.ts 上）

无 — `configs.ts` 只覆盖 Anthropic 系列（这是正确的，因为 GPT-5.x 走 provider profile 路径，不需要 configs.ts 注册）

### 建议补充的 SKU

| 模型 | 优先级 | 原因 |
|------|-------|------|
| Claude Haiku 4.6 (如果发布) | 高 | configs.ts 当前最新 Haiku 是 4.5 |
| Claude Opus 4.7 / Sonnet 4.7 | 高（发布后） | 当前 ant 主线已支持 |
| GPT-5.6 / GPT-5.7 | 中 | 需要更新 routing presets |
| Codex 新版本 | 中 | bundle 依赖更新 |

### 推荐改进项

1. **添加模型 deprecation 检测**：当用户使用已废弃 SKU 时给出迁移提示
2. **添加模型 cost 信息表**：`modelCost.ts` 已有 `getOpus46CostTier`，扩展到全模型
3. **加 GPT-5.x reasoning_effort 测试**：验证 max → xhigh 映射在每个 SKU 上一致

---

## 八、结论

### 总体评估

**Clavue 对 Claude 和 GPT-5.x 的支持已经比 Claude Code 更全面，差距集中在三块**：

1. **Batch API**（双方差距，但 Clavue 是真缺）— 应实现
2. **动态模型发现**（Clavue 落后）— 减少硬编码维护成本
3. **Adapter 翻译完整性**（Clavue 独有问题）— cache_control / citations / thinking signature 透传

### 与 Claude Code 的整体对比

| 维度 | 评估 |
|------|------|
| **Claude 模型覆盖** | 持平 |
| **Claude 高级特性** | 接近持平（仅 Batch API 缺失） |
| **GPT-5.x 支持** | Clavue **领先**（Claude Code 不支持） |
| **Codex 集成** | Clavue **独有** |
| **多 provider 路由** | Clavue **独有** |
| **架构清晰度** | Clavue 经过 v2 升级后已模块化（14 个 adapter 子模块） |
| **测试覆盖** | Clavue 665 测试 vs Claude Code 内部 |
| **新模型跟进速度** | Claude Code 略快（动态发现） |

**总结**：Clavue 在"模型多样性 + 架构灵活性"上明显胜出；在"Anthropic 特性深度"上接近持平；建议未来 6 个月聚焦 Batch API、动态模型发现、Adapter 翻译完整性三项。

---

## 九、行动清单（按优先级）

```
[P1 立即]
- Batch API 接入（Anthropic + OpenAI 双向）
- Adapter 透传 cache_control / citations / thinking signature（即使丢失也带 warn）

[P2 v8.9]
- 动态模型发现：扩展 modelCapabilities 缓存到外部用户
- 3P provider 1M context 配置补全
- 模型 deprecation 检测

[P3 v9.x]
- GPT-5.x reasoning effort 自动调优
- 模型自动 fallback 链
- 跨 provider cost 估算

[P4 长期]
- 模型 A/B 测试框架
- Codex backend 可插拔抽象
```

— 模型支持评估完。
