v3.20.4 v4.0.4
farion1231/cc-switchSep 22, 2026 → Oct 7, 202615 days between releases
What's New
Major v4.0 overhaul introduces new UI, aggregation mode, and configuration changes
Breaking Changes
- Database version upgraded to 20
- Generic Config Fragments feature removed; shared settings moved to client config
- Provider switching mechanism changed from full overwrite to keyword replacement
- Project switcher hidden by default for new installations
New Features
- Redesigned interface with sidebar layout and orange theme
- New aggregation mode for managing multiple AI providers
- Rewritten session management system
- Usage statistics with 53-week heatmap and detailed token tracking
- MCP sync to Pi
Improvements
- Backend stability improvements to protect user configurations during provider switching
- Config stability ensures hooks and MCPs are preserved when switching providers
Bug Fixes
- Backend stability improvements to protect user configurations during provider switching
Upgrade Notes
Manual backup required for database migration v19 to v20. 'Generic Config Fragments' feature is removed; shared settings must be moved to client config. Provider switching logic has changed.
The Two Releases
CC Switch v3.20.4
Sep 22, 2026· 30 days ago
CC Switch v3.20.4 is primarily a maintenance release introducing MiniMax Code as the tenth managed application. It includes critical fixes for Codex compatibility (version 0.154, image handling, and API key management), improves Claude Code functionality (auto mode and effort levels), and adds Linux support for Claude Desktop. A database migration from version 18 to 19 is included.
Full release notesCC Switch v4.0.4
Oct 7, 2026· 15 days ago
CC Switch v4.0.4 is the first official release of version 4.0, featuring a complete interface overhaul, a new aggregation mode for managing multiple AI providers, and a rewritten session management system. It also introduces significant backend stability improvements to protect user configurations during provider switching.
Full release notes