Files
cc-switch/docs/user-manual
T
Jason 94cc3d103a Align Claude Desktop model mapping with Claude Code three-role tiers
Claude Desktop's 3P validation only accepts claude-{sonnet,opus,haiku}-*
role IDs, so providers must map every tier. Bring the Desktop mapping flow
in line with Claude Code and fix the fallout that broke sub-agent Haiku calls.

- Proxy form: replace the dynamic route list with fixed Sonnet/Opus/Haiku
  tiers; blank tiers backfill from the first filled tier (Sonnet first) on
  submit and inherit its supports1m flag
- Backend: add a role-keyword fallback in map_proxy_request_model so dated
  official names (e.g. claude-haiku-4-5-20251001) resolve to the right tier,
  guarded by is_claude_safe_model_id so [1m]-suffixed IDs stay rejected
- Tighten is_claude_safe_model_id / isClaudeSafeRoute to reject degenerate
  role IDs like "claude-sonnet-"
- Fix the seed-effect race where normalizing empty routes to three blank
  tiers blocked the default-route backfill
- Sync switch hints, placeholders, and the zh/en/ja/zh-TW locales to the
  three-role-ID rule
- Update zh/en/ja user manual (2.1, 2.6), calling out legacy Claude IDs
  (claude-3-5-sonnet-...) as a rejected example

Tests: 282 frontend + 34 backend claude_desktop; typecheck, clippy, fmt clean.
94cc3d103a · 2026-05-29 22:52:25 +08:00
History
..
2026-05-16 20:18:49 +08:00
2026-05-16 20:18:49 +08:00

CC Switch User Manual / 用户手册 / ユーザーマニュアル

Claude Code / Codex / Gemini CLI / OpenCode / OpenClaw

Language / 语言 / 言語

Language Link
中文 简体中文用户手册
English English User Manual
日本語 日本語ユーザーマニュアル

Version / 版本 / バージョン

  • Documentation version: v3.15.0
  • Last updated: 2026-05-16
  • Compatible with CC Switch v3.15.0+