CC Switch v3.12.2

CC Switch v3.12.2

Common Config Protection During Proxy Takeover, Snippet Lifecycle Stability, Section-Aware Codex TOML Editing

中文版 → | 日本語版 →

---

Overview

CC Switch v3.12.2 is a reliability-focused patch release that addresses Common Config loss during proxy takeover and improves Codex TOML editing accuracy. Proxy takeover hot-switches and provider sync now update the restore backup instead of overwriting live config files; the startup sequence has been reordered so snippets are extracted from clean live files before takeover state is restored; and Codex base_url editing has been refactored into a section-aware model that no longer appends to the end of the file.

Release Date: 2026-03-12

Update Scale: 5 commits | 22 files changed | +1,716 / -288 lines

---

Highlights

• Empty state guidance: Provider list empty state now shows detailed import instructions with a conditional Common Config snippet hint for Claude/Codex/Gemini

• Proxy takeover restore flow rework: Hot-switches and provider sync now refresh the restore backup instead of overwriting live config files, preserving the full user configuration on rollback

• Snippet lifecycle stability: Introduced a cleared flag to prevent auto-extraction from resurrecting cleared snippets, and reordered startup to extract from clean state

• Section-aware Codex TOML editing: base_url and model field reads/writes now target the correct [model_providers.<name>] section

• Codex MCP config protection: Existing mcp_servers blocks in restore snapshots survive provider hot-switches via per-server-id merge instead of wholesale replacement, with provider/common-config definitions winning on conflict

---

New Features

Empty State Guidance

Improved the first-run experience with helpful guidance when the provider list is empty.

• Empty state page shows step-by-step import instructions
• Conditionally displays a Common Config snippet hint for Claude/Codex/Gemini providers (not shown for OpenCode/OpenClaw)

---

Changes

Proxy Takeover Restore Flow

The proxy takeover hot-switch and provider sync logic has been reworked to protect Common Config throughout the takeover lifecycle.

• Provider sync now updates the restore backup instead of writing directly to live config files when takeover is active
• Effective provider settings are rebuilt with Common Config applied before saving restore snapshots, so rollback restores the real user configuration
• Legacy providers with inferred common config usage are automatically marked with commonConfigEnabled=true

Codex TOML Editing Engine

Codex config.toml update logic has been refactored onto shared section-aware TOML helpers.

• New Rust module codex_config.rs with update_codex_toml_field and remove_codex_toml_base_url_if
• New frontend utilities getTomlSectionRange / getCodexProviderSectionName for section-aware operations
• Inline TOML editing logic scattered across proxy.rs now delegates to the new module

Common Config Initialization Lifecycle

The startup sequence has been reordered for more robust snippet extraction and migration.

• Startup now auto-extracts Common Config snippets from clean live files before restoring proxy takeover state
• Introduced a snippet cleared flag to track whether a user intentionally cleared a snippet
• Persisted a one-time legacy migration flag to avoid repeated commonConfigEnabled backfills

---

Bug Fixes

Common Config Loss

• Fixed multiple scenarios where Common Config could be dropped during proxy takeover: sync overwriting live files, hot-switches producing incomplete restore snapshots, and provider switches losing config changes

Codex Restore Snapshot Preservation

• Fixed Codex takeover restore backups discarding existing mcp_servers blocks during provider hot-switches; changed MCP backup preservation from wholesale table replacement to per-server-id merge so provider/common-config MCP updates win on conflict while backup-only servers are retained

Cleared Snippet Resurrection

• Fixed startup auto-extraction recreating Common Config snippets that users had intentionally cleared

Codex base_url Misplacement

• Fixed Codex base_url extraction and editing not targeting the correct [model_providers.<name>] section, causing it to append to the file tail or confuse mcp_servers.*.base_url entries for provider endpoints

---

Download & Installation

Visit Releases to download the appropriate version.

System Requirements

System	Minimum Version	Architecture
Windows	Windows 10 or later	x64
macOS	macOS 10.15 (Catalina) or later	Intel (x64) / Apple Silicon (arm64)
Linux	See table below	x64

Windows

File	Description
CC-Switch-v3.12.2-Windows.msi	Recommended - MSI installer with auto-update
CC-Switch-v3.12.2-Windows-Portable.zip	Portable version, extract and run, no registry write

macOS

File	Description
CC-Switch-v3.12.2-macOS.zip	Recommended - Extract and drag to Applications, Universal Binary
CC-Switch-v3.12.2-macOS.tar.gz	For Homebrew installation and auto-update

Note: Since the author doesn't have an Apple Developer account, you may see an "unidentified developer" warning on first launch. Please close it, then go to "System Settings" -> "Privacy & Security" -> click "Open Anyway", and it will open normally afterwards.

Homebrew (macOS)

brew tap farion1231/ccswitch
brew install --cask cc-switch

Update:

brew upgrade --cask cc-switch

Linux

Distribution	Recommended Format	Installation Method
Ubuntu / Debian / Linux Mint / Pop!_OS	.deb	sudo dpkg -i CC-Switch-*.deb or sudo apt install ./CC-Switch-*.deb
Fedora / RHEL / CentOS / Rocky Linux	.rpm	sudo rpm -i CC-Switch-*.rpm or sudo dnf install ./CC-Switch-*.rpm
openSUSE	.rpm	sudo zypper install ./CC-Switch-*.rpm
Arch Linux / Manjaro	.AppImage	Add execute permission and run directly, or use AUR
Other distributions / Unsure	.AppImage	chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage

CC Switch v3.12.1

CC Switch v3.12.1

Stability Fixes, StepFun Presets, OpenClaw authHeader, and New Sponsor Partners

中文版 → | 日本語版 →

---

Overview

CC Switch v3.12.1 is a patch release focused on stability improvements and bug fixes. It resolves a Common Config modal infinite reopen loop, a WebDAV sync foreign key constraint failure, and several i18n interpolation issues. It also adds StepFun provider presets, OpenClaw input type selection and authHeader support, upgrades the default Gemini model to 3.1-pro, and welcomes four new sponsor partners.

Release Date: 2026-03-12

Update Scale: 19 commits | 56 files changed | +1,429 / -396 lines

---

Highlights

• Common Config modal fix: Resolved an infinite reopen loop in the Common Config modal and added draft editing support
• WebDAV sync reliability: Fixed a foreign key constraint failure when restoring provider_health during WebDAV sync
• StepFun presets: Added StepFun (阶跃星辰) provider presets including the step-3.5-flash model
• OpenClaw enhancements: Added input type selection for model Advanced Options and authHeader field for vendor-specific auth header support
• Gemini model upgrade: Upgraded default Gemini model to 3.1-pro in provider presets
• New sponsors: Welcomed Micu API, XCodeAPI, SiliconFlow, and CTok as sponsor partners

---

New Features

StepFun Provider Presets

Added provider presets for StepFun (阶跃星辰), a leading Chinese AI model provider.

• New preset entries for StepFun across supported applications
• Includes the step-3.5-flash model (#1369, thanks @hengm3467)

OpenClaw Enhancements

Enhanced the OpenClaw configuration with more granular control and better vendor compatibility.

• Added input type selection dropdown for model Advanced Options (#1368, thanks @liuxxxu)
• Added optional authHeader boolean to OpenClawProviderConfig for vendor-specific auth header support (e.g. Longcat), and refactored form state to reuse the shared type

Sponsor Partners

• Micu API: Added Micu API as sponsor partner with affiliate links
• XCodeAPI: Added XCodeAPI as sponsor partner
• SiliconFlow: Added SiliconFlow (硅基流动) as sponsor partner with affiliate links
• CTok: Added CTok as sponsor partner

---

Changes

• UCloud → Compshare: Renamed UCloud provider to Compshare (优云智算) with full i18n support across all three locales (EN/ZH/JA)
• Compshare Links: Updated Compshare sponsor registration links to coding-plan page
• Gemini Model Upgrade: Upgraded default Gemini model from 2.5-pro to 3.1-pro in provider presets

---

Bug Fixes

Common Config & UI

• Fixed an infinite reopen loop in the Common Config modal and added draft editing support to prevent data loss during edits
• Fixed toolbar compact mode not triggering on Windows due to left-side overflow (#1375, thanks @zuoliangyu)
• Fixed session search index not syncing with query data, causing stale list display after session deletion

Sync & Data

• Fixed foreign key constraint failure when restoring provider_health table during WebDAV sync

Provider & Preset

• Added missing authHeader: true to Longcat provider preset (#1377, thanks @wavever)
• Aligned OpenClaw tool permission profiles with upstream schema (#1355, thanks @bigsongeth)
• Corrected X-Code API URL from www.x-code.cn to x-code.cc

i18n & Localization

• Fixed stream check toast i18n interpolation keys not matching translation placeholders
• Fixed proxy startup toast not interpolating address and port values (#1399, thanks @Mason-mengze)
• Renamed OpenCode API format label from "OpenAI" to "OpenAI Responses" for accuracy

---

Special Thanks

Thanks to all contributors for their contributions to this release!

@hengm3467 @liuxxxu @bigsongeth @zuoliangyu @wavever @Mason-mengze

---

Download & Installation

Visit Releases to download the appropriate version.

System Requirements

System	Minimum Version	Architecture
Windows	Windows 10 or later	x64
macOS	macOS 10.15 (Catalina) or later	Intel (x64) / Apple Silicon (arm64)
Linux	See table below	x64

Windows

File	Description
CC-Switch-v3.12.1-Windows.msi	Recommended - MSI installer with auto-update
CC-Switch-v3.12.1-Windows-Portable.zip	Portable version, extract and run, no registry write

macOS

File	Description
CC-Switch-v3.12.1-macOS.zip	Recommended - Extract and drag to Applications, Universal Binary
CC-Switch-v3.12.1-macOS.tar.gz	For Homebrew installation and auto-update

Note: Since the author doesn't have an Apple Developer account, you may see an "unidentified developer" warning on first launch. Please close it, then go to "System Settings" -> "Privacy & Security" -> click "Open Anyway", and it will open normally afterwards.

Homebrew (macOS)

brew tap farion1231/ccswitch
brew install --cask cc-switch

Update:

brew upgrade --cask cc-switch

Linux

Distribution	Recommended Format	Installation Method
Ubuntu / Debian / Linux Mint / Pop!_OS	.deb	sudo dpkg -i CC-Switch-*.deb or sudo apt install ./CC-Switch-*.deb
Fedora / RHEL / CentOS / Rocky Linux	.rpm	sudo rpm -i CC-Switch-*.rpm or sudo dnf install ./CC-Switch-*.rpm
openSUSE	.rpm	sudo zypper install ./CC-Switch-*.rpm
Arch Linux / Manjaro	.AppImage	Add execute permission and run directly, or use AUR
Other distributions / Unsure	.AppImage	chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage

CC Switch v3.12.0

CC Switch v3.12.0

Stream Check Returns, OpenAI Responses API Arrives, and OpenClaw / WebDAV Get a Major Upgrade

中文版 → | 日本語版 →

---

Overview

CC Switch v3.12.0 is a feature release focused on provider compatibility, OpenClaw editing, Common Config usability, and sync/data reliability. It restores the Model Health Check (Stream Check) UI with improved stability, adds OpenAI Responses API format conversion, expands provider presets for Ucloud, Micu, X-Code API, Novita, and Bailian For Coding, and upgrades WebDAV sync with dual-layer versioning.

Release Date: 2026-03-09

Update Scale: 56 commits | 221 files changed | +20,582 / -8,026 lines

---

Highlights

• Stream Check returns: Restored the model health check UI, added first-run confirmation, and fixed openai_chat provider support
• OpenAI Responses API: Added api_format = "openai_responses" with bidirectional conversion and shared conversion cleanup — simply select the Responses API format when adding a provider and enable proxy takeover, and you can use GPT-series models in Claude Code!
• OpenClaw overhaul: Introduced JSON5 round-trip config editing, a config health banner, better agent model selection, and a User-Agent toggle
• Preset expansion: Added Ucloud, Micu, X-Code API, Novita, and Bailian For Coding updates, plus SiliconFlow partner badge and model-role badges
• Sync and maintenance improvements: Added WebDAV protocol v2 + db-v6 versioning, daily rollups, incremental auto-vacuum, and sync-aware backup
• Common Config usability improvements: After updating a Common Config Snippet, it is now automatically applied when switching providers — no more manual checkbox needed

---

Main Features

Model Health Check (Stream Check)

Restored the Stream Check panel for live provider validation, improving the reliability of provider management.

• Restored Stream Check UI panel with single and batch provider availability testing
• Added first-run confirmation dialog to prevent unsupported providers from showing misleading errors
• Fixed detection compatibility for openai_chat API format providers

OpenAI Responses API

Added native support for providers using the OpenAI Responses API with a new openai_responses API format.

• New api_format = "openai_responses" provider format option
• Bidirectional Anthropic Messages <-> OpenAI Responses API format conversion
• Consolidated shared conversion logic to reduce code duplication

Bedrock Request Optimizer

Added a PRE-SEND phase request optimizer for AWS Bedrock providers to improve compatibility and performance.

• PRE-SEND thinking + cache injection optimizer (#1301, thanks @keithyt06)

OpenClaw Config Enhancements

Comprehensive upgrade to the OpenClaw configuration editing experience with richer management capabilities.

• JSON5 round-trip write-back: preserves comments and formatting when editing configs
• EnvPanel JSON editing mode and tools.profile selection support
• New config validation warnings and config health status checks
• Improved agent model dropdown with recommended model fill from provider presets
• User-Agent toggle: optionally append OpenClaw identifier to requests (defaults to off)
• Legacy timeout configuration auto-migration

Provider Presets

New and expanded provider presets covering more providers and use cases.

• Ucloud: Added endpointCandidates and OpenClaw defaults, refreshed templateValues / suggestedDefaults
• Micu: Added preset defaults and OpenClaw recommended models
• X-Code API: Added Claude presets and endpointCandidates
• Novita: New provider preset (#1192, thanks @Alex-wuhu)
• Bailian For Coding: New provider preset (#1263, thanks @suki135246)
• SiliconFlow: Added partner badge
• Model Role Badges: Provider presets now support model-role badge display

WebDAV Sync Enhancements

WebDAV sync introduces dual-layer versioning for improved sync reliability and data safety.

• New WebDAV protocol v2 + db-v6 dual-layer versioning
• Confirmation dialog when toggling WebDAV auto-sync on/off to prevent accidental changes
• Sync-aware backup: uses a sync-specific backup variant that skips local-only table data

Usage & Data

Enhanced usage statistics and data maintenance capabilities for finer-grained data management, significantly reducing database growth rate.

• Daily rollups: aggregate usage data by day to reduce storage overhead
• Auto-vacuum: incremental database cleanup to maintain database health
• UsageFooter extra statistics fields (#1137, thanks @bugparty)

Other New Features

• Session Deletion: Per-provider session cleanup with path safety validation
• Claude Auth Field Selector: Restored authentication field selector
• Failover Toggle on Main Page: Moved the failover toggle to display independently on the main page with a first-use confirmation dialog
• Common Config Auto-Extract: On first run, automatically extracts common config snippets from live config files
• New Provider Page Improvements: Improved new provider page experience (#1155, thanks @wugeer)

---

Architecture Improvements

Common Config Runtime Overlay

Common Config Snippets are now applied as a runtime overlay instead of being materialized into stored provider configs.

Before: Common Config content was merged directly into each provider's settings_config on save or switch. This caused shared configuration to be duplicated across every provider entry, requiring manual sync when changes were needed.

After: Common Config is only injected as a runtime overlay when switching providers and writing to the live file — provider entries themselves no longer contain shared configuration. This means modifying Common Config takes effect immediately without updating each provider individually.

Common Config Auto-Extract

On first run, if no Common Config Snippet exists in the database, one is automatically extracted from the current live config. This ensures users upgrading from older versions do not lose their existing shared configuration settings.

Periodic Maintenance Timer Consolidation

Consolidated daily rollups and auto-vacuum into a unified periodic maintenance timer, eliminating resource contention and complexity from multiple independent timers.

---

Bug Fixes

Proxy & Streaming

• Fixed OpenAI ChatCompletion -> Anthropic Messages streaming conversion
• Added Codex /responses/compact route support (#1194, thanks @Tsukumi233)
• Improved TOML config merge logic to prevent key-value loss
• Improved proxy forwarder failure logs with additional diagnostic information

Provider & Preset Fixes

• Renamed X-Code to X-Code API for consistent branding
• Fixed SSSAiCode /v1 path issue
• Removed incorrect www prefix from AICoding URLs
• Fixed new provider page line-break deletion issue (#1155, thanks @wugeer)

Platform Fixes

• Fixed cache hit token statistics not being reported (#1244, thanks @a1398394385)
• Fixed minimize-to-tray causing auto exit after some time (#1245, thanks @YewFence)

i18n Fixes

• Added 69 missing translation keys and removed remaining hardcoded Chinese strings
• Fixed model test panel i18n issues
• Normalized JSON5 slash escaping to prevent i18n string parsing errors

UI Fixes

• Fixed Skills count display (#1295, thanks @fzzv)
• Removed HTTP status code display from endpoint speed test to reduce visual noise
• Fixed outline button styling (#1222, thanks @Sube-py)

---

Performance

• Skip unnecessary OpenClaw config writes when config is unchanged, reducing disk I/O

---

Documentation

• Restructured the user manual for i18n and added complete EN/JA coverage
• Added OpenClaw usage documentation and completed settings documentation
• Added UCloud sponsor information
• Reorganized the docs directory and synced README feature sections across EN/ZH/JA

---

Notes & Considerations

• Common Config now uses runtime overlay: Common Config Snippets are no longer materialized into each provider's stored config. They are dynamically applied at switch time. Modifying Common Config takes effect immediately without updating each provider.
• Stream Check requires first-use confirmation: A confirmation dialog appears when using the model health check for the first time. Testing proceeds only after confirmation.
• OpenClaw User-Agent toggle defaults to off: The User-Agent identifier must be manually enabled in the OpenClaw configuration.

---

Special Thanks

Thanks to all contributors for their contributions to this release!

@keithyt06 @bugparty @Alex-wuhu @suki135246 @Tsukumi233 @wugeer @fzzv @Sube-py @a1398394385 @YewFence

---

Download & Installation

Visit Releases to download the appropriate version.

System Requirements

System	Minimum Version	Architecture
Windows	Windows 10 or later	x64
macOS	macOS 10.15 (Catalina) or later	Intel (x64) / Apple Silicon (arm64)
Linux	See table below	x64

Windows

File	Description
CC-Switch-v3.12.0-Windows.msi	**Recommende...

CC Switch v3.11.1

CC Switch v3.11.1

Revert Partial Key-Field Merging, Restore Common Config Snippet & Bug Fixes

中文版 → | 日本語版 →

---

Overview

CC Switch v3.11.1 is a hotfix release that reverts the Partial Key-Field Merging architecture introduced in v3.11.0, restoring the proven "full config overwrite + Common Config Snippet" mechanism. It also includes several UI and platform compatibility fixes.

Release Date: 2026-02-28

Update Scale: 8 commits | 52 files changed | +3,948 / -1,411 lines

---

Highlights

• Restore Full Config Overwrite + Common Config Snippet: Reverted partial key-field merging due to critical data loss issues; restores full config snapshot write and Common Config Snippet UI
• Proxy Panel Improvements: Proxy toggle moved into panel body for better discoverability of takeover options
• Theme & Compact Mode Fixes: "Follow System" theme now auto-updates; compact mode exit works correctly
• Windows Compatibility: Disabled env check and one-click install to prevent protocol handler side effects

---

Reverted

Restore Full Config Overwrite + Common Config Snippet

Reverted the partial key-field merging refactoring introduced in v3.11.0 (revert 992dda5).

Why reverted: The partial key-field merging approach had three critical issues:

1. Data loss on switch: Non-whitelisted custom fields were silently dropped during provider switching
2. Permanent backfill stripping: Backfill permanently removed non-key fields from the database, causing irreversible data loss
3. Maintenance burden: The whitelist of "key fields" required constant maintenance as new config keys were added

What's restored:

• Full config snapshot write on provider switch (predictable, complete overwrite)
• Common Config Snippet UI and backend commands
• 6 frontend components/hooks (3 components + 3 hooks)

Migration:

• If you upgraded to v3.11.0 and your providers lost custom fields, re-import your config or manually re-add the missing fields
• Common Config Snippet is available again — use it to define shared config that should persist across provider switches

---

Changed

• Proxy Panel Layout: Moved proxy on/off toggle from accordion header into panel content area, placed directly above app takeover options. This ensures users see takeover configuration immediately after enabling the proxy, avoiding the common mistake of enabling the proxy without configuring takeover
• Manual Import for OpenCode/OpenClaw: Removed auto-import on startup; empty state now shows an "Import Current Config" button, consistent with Claude/Codex/Gemini behavior

---

Fixed

• "Follow System" Theme Not Auto-Updating: Delegated to Tauri's native theme tracking (set_window_theme(None)) so the WebView's prefers-color-scheme media query stays in sync with OS theme changes
• Compact Mode Cannot Exit: Restored flex-1 on toolbarRef so useAutoCompact's exit condition triggers correctly based on available width instead of content width
• Proxy Takeover Toast Shows {{app}}: Added missing app interpolation parameter to i18next t() calls for proxy takeover enabled/disabled messages
• Windows Protocol Handler Side Effects: Disabled environment check and one-click install on Windows to prevent unintended protocol handler registration

---

Notes & Considerations

• Common Config Snippet is back: If you relied on this feature in v3.10.x and earlier, it works the same way again. Define shared config that should persist across all provider switches.
• v3.11.0 Partial Key-Field Merging users: If you noticed missing config fields after switching providers in v3.11.0, re-import your config to restore them.

---

Download & Installation

Visit Releases to download the appropriate version.

System Requirements

System	Minimum Version	Architecture
Windows	Windows 10 or later	x64
macOS	macOS 10.15 (Catalina) or later	Intel (x64) / Apple Silicon (arm64)
Linux	See table below	x64

Windows

File	Description
CC-Switch-v3.11.1-Windows.msi	Recommended - MSI installer with auto-update
CC-Switch-v3.11.1-Windows-Portable.zip	Portable version, extract and run, no registry write

macOS

File	Description
CC-Switch-v3.11.1-macOS.zip	Recommended - Extract and drag to Applications, Universal Binary
CC-Switch-v3.11.1-macOS.tar.gz	For Homebrew installation and auto-update

Note: Since the author doesn't have an Apple Developer account, you may see an "unidentified developer" warning on first launch. Please close it, then go to "System Settings" → "Privacy & Security" → click "Open Anyway", and it will open normally afterwards.

Homebrew (macOS)

brew tap farion1231/ccswitch
brew install --cask cc-switch

Update:

brew upgrade --cask cc-switch

Linux

Distribution	Recommended Format	Installation Method
Ubuntu / Debian / Linux Mint / Pop!_OS	.deb	sudo dpkg -i CC-Switch-*.deb or sudo apt install ./CC-Switch-*.deb
Fedora / RHEL / CentOS / Rocky Linux	.rpm	sudo rpm -i CC-Switch-*.rpm or sudo dnf install ./CC-Switch-*.rpm
openSUSE	.rpm	sudo zypper install ./CC-Switch-*.rpm
Arch Linux / Manjaro	.AppImage	Add execute permission and run directly, or use AUR
Other distributions / Unsure	.AppImage	chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage

CC Switch v3.11.0

CC Switch v3.11.0

OpenClaw Support, Session Manager, Backup Management & 50+ Improvements

中文版 → | 日本語版 →

---

Overview

CC Switch v3.11.0 is a major update that adds full management support for OpenClaw as the fifth application, introduces a new Session Manager and Backup Management feature. Additionally, Oh My OpenCode (OMO) integration, the partial key-field merging architecture upgrade for provider switching, settings page refactoring, and many other improvements make the overall experience more polished.

Release Date: 2026-02-26

Update Scale: 147 commits | 274 files changed | +32,179 / -5,467 lines

---

Highlights

• OpenClaw Support: Fifth managed application with 13 provider presets, Env/Tools/AgentsDefaults config editors, and Workspace file management
• Session Manager: Browse conversation history across all five apps with table-of-contents navigation and in-session search
• Backup Management: Independent backup panel with configurable policies, periodic backups, and pre-migration auto-backup
• Oh My OpenCode Integration: Full OMO config management with OMO Slim lightweight mode support
• Partial Key-Field Merging (⚠️ Breaking Change): Provider switching now only replaces provider-related fields, preserving all other settings; the "Common Config Snippet" feature has been removed
• Settings Page Refactoring: 5-tab layout with ~40% code reduction
• 6 New Provider Presets: AWS Bedrock, SSAI Code, CrazyRouter, AICoding, and more
• Thinking Budget Rectifier: Fine-grained thinking budget control
• Theme Switch Animation: Circular reveal transition animation
• WebDAV Auto Sync: Automatic sync with large file protection

---

Main Features

OpenClaw Support (New Fifth App)

Full management support for OpenClaw, the fifth managed application following Claude Code, Codex, Gemini CLI, and OpenCode.

• Provider Management: Add, edit, switch, and delete OpenClaw providers with 13 built-in presets
• Config Editors: Three dedicated panels for Env (environment variables), Tools, and AgentsDefaults
• Workspace Panel: HEARTBEAT/BOOTSTRAP/BOOT file management and daily memory
• Additive Overlay Mode: Support config overlay instead of overwrite
• Default Model Button: One-click to fill recommended models; auto-register suggested models to allowlist when adding providers
• Brand & Interaction: Dedicated brand icon, fade-in/fade-out transition animation when switching apps
• Deep Link Support: Import OpenClaw provider configurations via URL
• Full Internationalization: Complete Chinese/English/Japanese support

Session Manager

A brand-new session manager to browse and search conversation history.

• Browse conversation history across Claude Code, Codex, Gemini CLI, OpenCode, and OpenClaw (#867, thanks @TinsFox)
• Table-of-contents navigation and in-session search
• Auto-filter by current app when entering the session page
• Parallel directory scanning + head-tail JSONL reading for optimized loading performance

Backup Management

An independent backup management panel for better data safety.

• Configurable backup policy: maximum backup count and auto-cleanup rules
• Hourly automatic backup timer during runtime
• Auto-backup before database schema migrations with backfill warning
• Support backup rename and deletion (with confirmation dialog)
• Backup filenames use local time for better clarity

Oh My OpenCode (OMO) Integration

Full Oh My OpenCode config file management.

• Agent model selection, category configuration, and recommended model fill (#972, thanks @yovinchen)
• Improved agent model selection UX with lowercase key fix (#1004, thanks @yovinchen)
• OMO Slim lightweight mode support
• OMO ↔ OMO Slim mutual exclusion (enforced at database level)

Workspace

• Full-text search across daily memory files, sorted by date
• Clickable directory paths for quick file location access

Toolbar

• AppSwitcher auto-collapses to compact mode based on available width
• Smooth transition animation for compact mode toggle

Settings

• First-use confirmation dialogs for proxy and usage features to prevent accidental operations
• New enableLocalProxy switch to control proxy UI visibility on home page
• More granular local environment checks: CLI tool version detection (#870, thanks @kv-chiu), Volta path detection (#969, thanks @myjustify)

Provider Presets

• AWS Bedrock: Support for AKSK and API Key authentication modes (#1047, thanks @keithyt06)
• SSAI Code: Partner preset across all five apps
• CrazyRouter: Partner preset with dedicated icon
• AICoding: Partner preset with i18n promotion text
• Updated domestic model provider presets to latest versions
• Renamed Qwen Coder to Bailian (#965, thanks @zhu-jl18)

Other New Features

• Thinking Budget Rectifier: Fine-grained thinking budget allocation control (#1005, thanks @yovinchen)
• WebDAV Auto Sync: Automatic sync with large file protection (#923, thanks @clx20000410; #1043, thanks @SaladDay)
• Theme Switch Animation: Circular reveal transition for a smoother visual experience (#905, thanks @funnytime75)
• Claude Config Editor Quick Toggles: Quick toggle switches for common settings (#1012, thanks @JIA-ss)
• Dynamic Endpoint Hint: Context-aware hint text based on API format selection (#860, thanks @zhu-jl18)
• Usage Dashboard Enhancement: Auto-refresh control and robust formatting (#942, thanks @yovinchen)
• New Pricing Data: claude-opus-4-6 and gpt-5.3-codex (#943, thanks @yovinchen)
• Silent Startup Optimization: Silent startup option only shown when launch-on-startup is enabled

---

Architecture Improvements

Partial Key-Field Merging (⚠️ Breaking Change)

Provider switching now uses partial key-field merging instead of full config overwrite (#1098).

Before: Switching providers overwrote the entire settings_config to the live config file. This meant that any non-provider settings the user manually added to the live file (plugins, MCP config, permissions, etc.) would be lost on every switch. To work around this, previous versions offered a "Common Config Snippet" feature that let users define shared config to be merged on every switch.

After: Switching providers now only replaces provider-related key-values (API keys, endpoints, models, etc.), leaving all other settings intact. The "Common Config Snippet" feature is therefore no longer needed and has been removed.

Impact & Migration:

• If you didn't use Common Config Snippets, this change is fully transparent — switching just works better now
• If you used Common Config Snippets to preserve custom settings (MCP config, permissions, etc.), those settings are now automatically preserved during switches — no action needed
• If you used Common Config Snippets for other purposes (e.g., injecting extra config on every switch), please manually add those settings to your live config file after upgrading

This refactoring removed 6 frontend files (3 components + 3 hooks) and ~150 lines of backend dead code.

Manual Import Replaces Auto-Import

Startup no longer auto-imports external configurations. Users now click "Import Current Config" manually, preventing accidental data overwrites.

OmoVariant Parameterization

Eliminated ~250 lines of duplicated code in the OMO module via OmoVariant struct parameterization.

OMO Common Config Removal

Removed the two-layer merge system, reducing ~1,733 lines of code and simplifying the architecture.

ProviderForm Decomposition

Reduced ProviderForm component from 2,227 lines to 1,526 lines by extracting 5 independent modules (opencodeFormUtils, useOmoModelSource, useOpencodeFormState, useOmoDraftState, useOpenclawFormState), significantly improving maintainability.

Shared MCP/Skills Components

Extracted AppCountBar, AppToggleGroup, and ListItemRow shared components to reduce duplication across MCP and Skills panels (#897, thanks @PeanutSplash).

Settings Page Refactoring

Refactored settings page to a 5-tab layout (General | Proxy | Advanced | Usage | About), reducing SettingsPage code from ~716 to ~426 lines.

Other Improvements

• Unified terminal selection via global settings with WezTerm support added
• Updated Claude model references from 4.5 to 4.6

---

Bug Fixes

Critical Fixes

• Windows Home Dir Regression: Restored default home directory resolution to prevent providers/settings "disappearing" when HOME env var differs from the real user profile directory in Git/MSYS environments
• Linux White Screen: Disabled WebKitGTK hardware acceleration on AMD GPUs (Cezanne/Radeon Vega) to prevent blank screen on startup (#986, thanks @ThendCN)
• OpenAI Beta Parameter: Stopped appending ?beta=true to /v1/chat/completions endpoints, fixing request failures for Nvidia and other apiFormat="openai_chat" providers (#1052, thanks @jnorthrup)
• Health Check Auth: Health check now respects provider's auth_mode setting, preventing failures for proxy services that only support Bearer authentication (#824, thanks @Jassy930)

Provider Preset Fixes

• Fixed OpenClaw /v1 prefix causing double path (/v1/v1/messages)
• Corrected Opus pricing ($15/$75 → $5/$25) and upgraded to 4.6
• Unified AIGoCode URL to https://api.aigocode.com across all apps
• Removed outdated partner status from Zhipu GLM presets
• Restored API Key input visibility when creating new Claude providers
• Hide quick toggles for non-active providers, show context-aware JSON editor hints

OMO Fixes

• Added missing omo-slim category checks across add/form/mutation paths
• Fixed OMO Slim query cache invalidation after provider mutations
• Synced OMO agent/catego...

CC Switch v3.10.3

CC Switch v3.10.3

Feature Release

API Format Selector, Pricing Enhancements, Skills ZIP Install & Linux ARM64 Support

Added

• API Format Selector: Generic API format chooser for Claude providers, replacing the OpenRouter-specific toggle. Supports Anthropic Messages (native) and OpenAI Chat Completions format
• API Format Presets: Allow preset providers to specify API format (anthropic or openai_chat) for third-party proxy services
• Pricing Config Enhancement: Per-provider cost multiplier, pricing model source (request/response), request model logging, and enriched usage UI (#781, thanks @yovinchen)
• Skills ZIP Install: Install skills directly from local ZIP files with recursive scanning support
• Preferred Terminal: Choose preferred terminal app per platform (macOS: Terminal.app/iTerm2/Alacritty/Kitty/Ghostty; Windows: cmd/PowerShell/Windows Terminal; Linux: GNOME Terminal/Konsole/Xfce4/Alacritty/Kitty/Ghostty)
• Silent Startup: Option to prevent window popup on launch (#713, thanks @funnytime75)
• OpenCode API Key Link: API key link support for OpenCode provider form
• OpenCode Environment Check: Version detection with Go path scanning and one-click install from GitHub Releases
• OpenCode Directory Sync: Auto-sync all providers to live config on directory change with additive mode support
• AICodeMirror Partner Preset: Added AICodeMirror partner preset for all apps (Claude, Codex, Gemini, OpenCode)
• NVIDIA NIM Preset: New provider preset for Claude and OpenCode with nvidia.svg icon
• n1n.ai Preset: New provider preset (#667, thanks @n1n-api)
• Linux ARM64: CI build support for Linux ARM64 architecture

Changed

• API Format Migration: Migrate api_format from settings_config to ProviderMeta to prevent polluting ~/.claude/settings.json
• DeepSeek max_tokens: Remove max_tokens clamp from proxy transform layer
• Terminal Functions: Consolidate redundant terminal launch functions
• Home Dir Utility: Consolidate get_home_dir into single public function
• Kimi/Moonshot: Upgrade provider presets to k2.5 model
• Update Badge Icon: Replace update badge dot with ArrowUpCircle icon

Fixed

• Codex 404 & Timeout: Fix 404 errors and connection timeout with custom base_url; improve /v1 prefix handling and system proxy detection (#760, thanks @Darkbluelr)
• Proxy URL Building: Fix duplicate /v1/v1 in URL; extend ?beta=true to /v1/chat/completions endpoint
• OpenRouter Compat Mode: Improve backward compatibility supporting number and string types
• Gemini Visibility: Correct Gemini default visibility to true (#818, thanks @zhu-jl18)
• Footer Layout: Correct footer layout in advanced settings tab
• Claude Code Detection: Prioritize native install path for detection
• Tray Menu: Simplify title labels and optimize menu separators (#796, thanks @fchange)
• Duplicate Skills: Prevent duplicate skill installation from different repos (#778, thanks @yovinchen)
• Windows Tests: Stabilize test environment (#644, thanks @cxyfer)
• i18n: Update apiFormatOpenAIChat label to mention proxy requirement
• Error Display: Use extractErrorMessage for complete error display in mutations

---

CC Switch v3.10.2

Patch Release

This maintenance release adds skill sync options and includes important bug fixes.

Added

• Skills: Add skill sync method setting with symlink/copy options
• Partners: Add RightCode as official partner

Fixed

• Prompts: Clear prompt file when all prompts are disabled
• OpenCode: Preserve extra model fields during serialization
• Provider Form: Backfill model fields when editing Claude provider

---

CC Switch v3.10.1

Patch Release

This maintenance release includes important bug fixes for Windows platform, UI improvements, and code quality enhancements.

Added

• Provider Icons: Updated RightCode provider icon with improved visual design

Changed

• Proxy Rectifier: Changed rectifier default state to disabled for better stability
• Window Settings: Reordered window settings and updated default values for improved UX
• UI Layout: Increased app icon collapse threshold from 3 to 4 icons
• Code Quality: Simplified RectifierConfig implementation using #[derive(Default)]

Fixed

• Windows Platform:
  • Fixed terminal window closing immediately after execution on Windows
  • Corrected OpenCode config path resolution on Windows
• UI Improvements:
  • Fixed ProviderIcon color validation to prevent black icons from appearing
  • Unified layout padding across all panels for consistent spacing
  • Fixed panel content alignment with header constraints

---

CC Switch v3.10.0

OpenCode Support, Global Proxy, Claude Rectifier & Multi-App Experience Enhancements

中文版 → | 日本語版 →

---

Overview

CC Switch v3.10.0 introduces OpenCode support, becoming the fourth managed CLI application.
This release also brings global proxy settings, Claude Rectifier (thinking signature fixer), enhanced health checks, per-provider configuration, and many other important features, along with comprehensive improvements to multi-app workflows and terminal experience.

Release Date: 2026-01-21

---

Highlights

• OpenCode Support: Full management of providers, MCP servers, and Skills with auto-import on first launch
• Global Proxy: Configure a unified proxy for all outbound network requests
• Claude Rectifier: Thinking signature fixer for better compatibility with third-party APIs
• Enhanced Health Checks: Configurable prompts and CLI-compatible request format
• Per-Provider Config: Persistent provider-specific configuration support
• App Visibility Control: Freely show/hide apps with synchronized tray menu updates
• Terminal Improvements: Provider-specific terminal buttons, fnm path support, cross-platform safe launch
• WSL Tool Detection: Detect tool versions in WSL environment with security hardening

---

Main Features

OpenCode Support (New Fourth App)

• Complete OpenCode provider management: add, edit, switch, delete
• MCP server management: unified architecture with Claude/Codex/Gemini
• Skills support: OpenCode can also use Skills functionality
• Auto-import on first launch: automatically imports existing OpenCode configuration when detected
• Full internationalization: Chinese/English/Japanese support (#695)

Global Proxy

• Configure a unified proxy for all outbound network requests (#596, thanks @yovinchen)
• Supports HTTP/HTTPS proxy protocols
• Suitable for network environments requiring proxy access to external APIs

Claude Rectifier (Thinking Signature Fixer)

• Automatically fixes Claude API thinking signatures (#595, thanks @yovinchen)
• Resolves incompatible thinking block formats returned by some third-party API gateways
• Can be enabled/disabled in Advanced Settings

Enhanced Health Checks

• Configurable custom prompts for streaming health checks (#623, thanks @yovinchen)
• Supports CLI-compatible request format for better simulation of real usage scenarios
• Improves fault detection accuracy

Per-Provider Config

• Support for saving configuration separately for each provider (#663, thanks @yovinchen)
• Persistent configuration: provider-specific settings retained after restart
• Suitable for scenarios where different providers require different configurations

App Visibility Control

• Freely show/hide any app (Gemini hidden by default)
• Tray menu automatically syncs visibility settings
• Hidden apps won't appear in the main interface or tray menu

Takeover Compact Mode

• Automatically uses compact layout when 3 or more visible apps are displayed
• Optimizes space utilization in multi-app scenarios

Terminal Improvements

• Provider-specific terminal button: one-click to use current provider in terminal (#564, thanks @kkkman22)
• fnm path support: automatically recognizes Node.js paths managed by fnm
• Cross-platform safe launch: improved terminal launch logic for Windows/macOS/Linux

WSL Tool Detection

• Detect tool versions in WSL environment (#627, thanks @yovinchen)
• Added security hardening to prevent command injection risks

Skills Preset Enhancements

• Added baoyu-skills preset repository
• Automatically supplements missing default repositories for out-of-the-box experience

---

Experience Improvements

• Keyboard shortcuts: Press ESC to quickly return/close panels (#670, thanks @xxk8)
• Simplified proxy logs: cleaner and more readable output (#585, thanks @yovinchen)
• Pricing editor UX: unified FullScreenPanel style
• Advanced settings layout: Rectifier section moved below Failover for better logical flow
• OpenRouter compatibility mode: disabled by default, UI toggle hidden (reduces clutter)

---

Bug Fixes

Proxy & Failover

• Immediately switch to P1 when auto-failover is enabled (instead of waiting for next request)

Provider Management

• Fixed stale data when reopening provider edit dialog after save (#654, thanks @YangYongAn)
• Fixed baseUrl and apiKey state not resetting when switching presets
• Fixed endpoint auto-selection state not persisting (#611, thanks @yovinchen)
• Automatically apply default color when icon color is not set

Deep Links

• Support multi-endpoint import (#597, thanks @yovinchen)
• Prefer GOOGLE_GEMINI_BASE_URL over GEMINI_BASE_URL

MCP

• Skip cmd /c wrapper for WSL target paths (#592, thanks @cxyfer)

Usage Templates

• Added variable hints, fixed validation issues (#628, thanks @yang...

CC Switch v3.10.2

CC Switch v3.10.2

Patch Release

This maintenance release adds skill sync options and includes important bug fixes.

Added

• Skills: Add skill sync method setting with symlink/copy options
• Partners: Add RightCode as official partner

Fixed

• Prompts: Clear prompt file when all prompts are disabled
• OpenCode: Preserve extra model fields during serialization
• Provider Form: Backfill model fields when editing Claude provider

CC Switch v3.10.1

Patch Release

This maintenance release includes important bug fixes for Windows platform, UI improvements, and code quality enhancements.

Added

• Provider Icons: Updated RightCode provider icon with improved visual design

Changed

• Proxy Rectifier: Changed rectifier default state to disabled for better stability
• Window Settings: Reordered window settings and updated default values for improved UX
• UI Layout: Increased app icon collapse threshold from 3 to 4 icons
• Code Quality: Simplified RectifierConfig implementation using #[derive(Default)]

Fixed

• Windows Platform:
  • Fixed terminal window closing immediately after execution on Windows
  • Corrected OpenCode config path resolution on Windows
• UI Improvements:
  • Fixed ProviderIcon color validation to prevent black icons from appearing
  • Unified layout padding across all panels for consistent spacing
  • Fixed panel content alignment with header constraints

CC Switch v3.10.0

OpenCode Support, Global Proxy, Claude Rectifier & Multi-App Experience Enhancements

中文版 → | 日本語版 →

---

Overview

CC Switch v3.10.0 introduces OpenCode support, becoming the fourth managed CLI application.
This release also brings global proxy settings, Claude Rectifier (thinking signature fixer), enhanced health checks, per-provider configuration, and many other important features, along with comprehensive improvements to multi-app workflows and terminal experience.

Release Date: 2026-01-21

---

Highlights

• OpenCode Support: Full management of providers, MCP servers, and Skills with auto-import on first launch
• Global Proxy: Configure a unified proxy for all outbound network requests
• Claude Rectifier: Thinking signature fixer for better compatibility with third-party APIs
• Enhanced Health Checks: Configurable prompts and CLI-compatible request format
• Per-Provider Config: Persistent provider-specific configuration support
• App Visibility Control: Freely show/hide apps with synchronized tray menu updates
• Terminal Improvements: Provider-specific terminal buttons, fnm path support, cross-platform safe launch
• WSL Tool Detection: Detect tool versions in WSL environment with security hardening

---

Main Features

OpenCode Support (New Fourth App)

• Complete OpenCode provider management: add, edit, switch, delete
• MCP server management: unified architecture with Claude/Codex/Gemini
• Skills support: OpenCode can also use Skills functionality
• Auto-import on first launch: automatically imports existing OpenCode configuration when detected
• Full internationalization: Chinese/English/Japanese support (#695)

Global Proxy

• Configure a unified proxy for all outbound network requests (#596, thanks @yovinchen)
• Supports HTTP/HTTPS proxy protocols
• Suitable for network environments requiring proxy access to external APIs

Claude Rectifier (Thinking Signature Fixer)

• Automatically fixes Claude API thinking signatures (#595, thanks @yovinchen)
• Resolves incompatible thinking block formats returned by some third-party API gateways
• Can be enabled/disabled in Advanced Settings

Enhanced Health Checks

• Configurable custom prompts for streaming health checks (#623, thanks @yovinchen)
• Supports CLI-compatible request format for better simulation of real usage scenarios
• Improves fault detection accuracy

Per-Provider Config

• Support for saving configuration separately for each provider (#663, thanks @yovinchen)
• Persistent configuration: provider-specific settings retained after restart
• Suitable for scenarios where different providers require different configurations

App Visibility Control

• Freely show/hide any app (Gemini hidden by default)
• Tray menu automatically syncs visibility settings
• Hidden apps won't appear in the main interface or tray menu

Takeover Compact Mode

• Automatically uses compact layout when 3 or more visible apps are displayed
• Optimizes space utilization in multi-app scenarios

Terminal Improvements

• Provider-specific terminal button: one-click to use current provider in terminal (#564, thanks @kkkman22)
• fnm path support: automatically recognizes Node.js paths managed by fnm
• Cross-platform safe launch: improved terminal launch logic for Windows/macOS/Linux

WSL Tool Detection

• Detect tool versions in WSL environment (#627, thanks @yovinchen)
• Added security hardening to prevent command injection risks

Skills Preset Enhancements

• Added baoyu-skills preset repository
• Automatically supplements missing default repositories for out-of-the-box experience

---

Experience Improvements

• Keyboard shortcuts: Press ESC to quickly return/close panels (#670, thanks @xxk8)
• Simplified proxy logs: cleaner and more readable output (#585, thanks @yovinchen)
• Pricing editor UX: unified FullScreenPanel style
• Advanced settings layout: Rectifier section moved below Failover for better logical flow
• OpenRouter compatibility mode: disabled by default, UI toggle hidden (reduces clutter)

---

Bug Fixes

Proxy & Failover

• Immediately switch to P1 when auto-failover is enabled (instead of waiting for next request)

Provider Management

• Fixed stale data when reopening provider edit dialog after save (#654, thanks @YangYongAn)
• Fixed baseUrl and apiKey state not resetting when switching presets
• Fixed endpoint auto-selection state not persisting (#611, thanks @yovinchen)
• Automatically apply default color when icon color is not set

Deep Links

• Support multi-endpoint import (#597, thanks @yovinchen)
• Prefer GOOGLE_GEMINI_BASE_URL over GEMINI_BASE_URL

MCP

• Skip cmd /c wrapper for WSL target paths (#592, thanks @cxyfer)

Usage Templates

• Added variable hints, fixed validation issues (#628, thanks @YangYongAn)
• Prevent configuration leakage between providers
• Usage block offset automatically adapts to action button width (#613, thanks @yovinchen)

Gemini

• Convert timeout parameters to Gemini CLI format (#580, thanks @cxyfer)

UI

• Fixed Select dropdown rendering issues in FullScreenPanel

---

Notes & Considerations

• OpenCode is a newly supported app: OpenCode CLI must be installed first to use related features.
• Global proxy affects all outbound requests: including usage queries, health checks, and other network operations.
• Rectifier is experimental: can be disabled in Advanced Settings if issues occur.

---

Special Thanks

Thanks to @yovinchen @YangYongAn @cxyfer @xxk8 @kkkman22 @Shuimo03 for their contributions to this release!
Thanks to @libukai for designing the elegant failover-related UI!

---

Download & Installation

Visit Releases to download the appropriate version.

System Requirements

System	Minimum Version	Architecture
Windows	Windows 10 or later	x64
macOS	macOS 10.15 (Catalina) or later	Intel (x64) / Apple Silicon (arm64)
Linux	See table below	x64

Windows

File	Description
CC-Switch-v3.10.0-Windows.msi	Recommended - MSI installer with auto-update
CC-Switch-v3.10.0-Windows-Portable.zip	Portable version, extract and run, no registry write

macOS

File	Description
CC-Switch-v3.10.0-macOS.zip	Recommended - Extract and drag to Applications, Universal Binary
CC-Switch-v3.10.0-macOS.tar.gz	For Homebrew installation and auto-update

Note: Since the author doesn't have an Apple Developer account, you may see an "unidentified developer" warning on first launch. Please close it, then go to "System Settings" → "Privacy & Security" → click "Open Anyway", and it will open normally afterwards.

Homebrew (macOS)

brew tap farion1231/ccswitch
brew install --cask cc-switch

Update:

brew upgrade --cask cc-switch

Linux

Distribution	Recommended Format	Installation Method
Ubuntu / Debian / Linux Mint / Pop!_OS	.deb	sudo dpkg -i CC-Switch-*.deb or sudo apt install ./CC-Switch-*.deb
Fedora / RHEL / CentOS / Rocky Linux	.rpm	sudo rpm -i CC-Switch-*.rpm or `sudo dnf install ....

CC Switch v3.10.1

CC Switch v3.10.1

Patch Release

This maintenance release includes important bug fixes for Windows platform, UI improvements, and code quality enhancements.

Added

• Provider Icons: Updated RightCode provider icon with improved visual design

Changed

• Proxy Rectifier: Changed rectifier default state to disabled for better stability
• Window Settings: Reordered window settings and updated default values for improved UX
• UI Layout: Increased app icon collapse threshold from 3 to 4 icons
• Code Quality: Simplified RectifierConfig implementation using #[derive(Default)]

Fixed

• Windows Platform:
  • Fixed terminal window closing immediately after execution on Windows
  • Corrected OpenCode config path resolution on Windows
• UI Improvements:
  • Fixed ProviderIcon color validation to prevent black icons from appearing
  • Unified layout padding across all panels for consistent spacing
  • Fixed panel content alignment with header constraints

CC Switch v3.10.0

OpenCode Support, Global Proxy, Claude Rectifier & Multi-App Experience Enhancements

中文版 → | 日本語版 →

---

Overview

CC Switch v3.10.0 introduces OpenCode support, becoming the fourth managed CLI application.
This release also brings global proxy settings, Claude Rectifier (thinking signature fixer), enhanced health checks, per-provider configuration, and many other important features, along with comprehensive improvements to multi-app workflows and terminal experience.

Release Date: 2026-01-21

---

Highlights

• OpenCode Support: Full management of providers, MCP servers, and Skills with auto-import on first launch
• Global Proxy: Configure a unified proxy for all outbound network requests
• Claude Rectifier: Thinking signature fixer for better compatibility with third-party APIs
• Enhanced Health Checks: Configurable prompts and CLI-compatible request format
• Per-Provider Config: Persistent provider-specific configuration support
• App Visibility Control: Freely show/hide apps with synchronized tray menu updates
• Terminal Improvements: Provider-specific terminal buttons, fnm path support, cross-platform safe launch
• WSL Tool Detection: Detect tool versions in WSL environment with security hardening

---

Main Features

OpenCode Support (New Fourth App)

• Complete OpenCode provider management: add, edit, switch, delete
• MCP server management: unified architecture with Claude/Codex/Gemini
• Skills support: OpenCode can also use Skills functionality
• Auto-import on first launch: automatically imports existing OpenCode configuration when detected
• Full internationalization: Chinese/English/Japanese support (#695)

Global Proxy

• Configure a unified proxy for all outbound network requests (#596, thanks @yovinchen)
• Supports HTTP/HTTPS proxy protocols
• Suitable for network environments requiring proxy access to external APIs

Claude Rectifier (Thinking Signature Fixer)

• Automatically fixes Claude API thinking signatures (#595, thanks @yovinchen)
• Resolves incompatible thinking block formats returned by some third-party API gateways
• Can be enabled/disabled in Advanced Settings

Enhanced Health Checks

• Configurable custom prompts for streaming health checks (#623, thanks @yovinchen)
• Supports CLI-compatible request format for better simulation of real usage scenarios
• Improves fault detection accuracy

Per-Provider Config

• Support for saving configuration separately for each provider (#663, thanks @yovinchen)
• Persistent configuration: provider-specific settings retained after restart
• Suitable for scenarios where different providers require different configurations

App Visibility Control

• Freely show/hide any app (Gemini hidden by default)
• Tray menu automatically syncs visibility settings
• Hidden apps won't appear in the main interface or tray menu

Takeover Compact Mode

• Automatically uses compact layout when 3 or more visible apps are displayed
• Optimizes space utilization in multi-app scenarios

Terminal Improvements

• Provider-specific terminal button: one-click to use current provider in terminal (#564, thanks @kkkman22)
• fnm path support: automatically recognizes Node.js paths managed by fnm
• Cross-platform safe launch: improved terminal launch logic for Windows/macOS/Linux

WSL Tool Detection

• Detect tool versions in WSL environment (#627, thanks @yovinchen)
• Added security hardening to prevent command injection risks

Skills Preset Enhancements

• Added baoyu-skills preset repository
• Automatically supplements missing default repositories for out-of-the-box experience

---

Experience Improvements

• Keyboard shortcuts: Press ESC to quickly return/close panels (#670, thanks @xxk8)
• Simplified proxy logs: cleaner and more readable output (#585, thanks @yovinchen)
• Pricing editor UX: unified FullScreenPanel style
• Advanced settings layout: Rectifier section moved below Failover for better logical flow
• OpenRouter compatibility mode: disabled by default, UI toggle hidden (reduces clutter)

---

Bug Fixes

Proxy & Failover

• Immediately switch to P1 when auto-failover is enabled (instead of waiting for next request)

Provider Management

• Fixed stale data when reopening provider edit dialog after save (#654, thanks @YangYongAn)
• Fixed baseUrl and apiKey state not resetting when switching presets
• Fixed endpoint auto-selection state not persisting (#611, thanks @yovinchen)
• Automatically apply default color when icon color is not set

Deep Links

• Support multi-endpoint import (#597, thanks @yovinchen)
• Prefer GOOGLE_GEMINI_BASE_URL over GEMINI_BASE_URL

MCP

• Skip cmd /c wrapper for WSL target paths (#592, thanks @cxyfer)

Usage Templates

• Added variable hints, fixed validation issues (#628, thanks @YangYongAn)
• Prevent configuration leakage between providers
• Usage block offset automatically adapts to action button width (#613, thanks @yovinchen)

Gemini

• Convert timeout parameters to Gemini CLI format (#580, thanks @cxyfer)

UI

• Fixed Select dropdown rendering issues in FullScreenPanel

---

Notes & Considerations

• OpenCode is a newly supported app: OpenCode CLI must be installed first to use related features.
• Global proxy affects all outbound requests: including usage queries, health checks, and other network operations.
• Rectifier is experimental: can be disabled in Advanced Settings if issues occur.

---

Special Thanks

Thanks to @yovinchen @YangYongAn @cxyfer @xxk8 @kkkman22 @Shuimo03 for their contributions to this release!
Thanks to @libukai for designing the elegant failover-related UI!

---

Download & Installation

Visit Releases to download the appropriate version.

System Requirements

System	Minimum Version	Architecture
Windows	Windows 10 or later	x64
macOS	macOS 10.15 (Catalina) or later	Intel (x64) / Apple Silicon (arm64)
Linux	See table below	x64

Windows

File	Description
CC-Switch-v3.10.0-Windows.msi	Recommended - MSI installer with auto-update
CC-Switch-v3.10.0-Windows-Portable.zip	Portable version, extract and run, no registry write

macOS

File	Description
CC-Switch-v3.10.0-macOS.zip	Recommended - Extract and drag to Applications, Universal Binary
CC-Switch-v3.10.0-macOS.tar.gz	For Homebrew installation and auto-update

Note: Since the author doesn't have an Apple Developer account, you may see an "unidentified developer" warning on first launch. Please close it, then go to "System Settings" → "Privacy & Security" → click "Open Anyway", and it will open normally afterwards.

Homebrew (macOS)

brew tap farion1231/ccswitch
brew install --cask cc-switch

Update:

brew upgrade --cask cc-switch

Linux

Distribution	Recommended Format	Installation Method
Ubuntu / Debian / Linux Mint / Pop!_OS	.deb	sudo dpkg -i CC-Switch-*.deb or sudo apt install ./CC-Switch-*.deb
Fedora / RHEL / CentOS / Rocky Linux	.rpm	sudo rpm -i CC-Switch-*.rpm or sudo dnf install ./CC-Switch-*.rpm
openSUSE	.rpm	sudo zypper install ./CC-Switch-*.rpm
Arch Linux / Manjaro	.AppImage	Add execute permission and run directly, or use AUR
Other distributions / Unsure	.AppImage	chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage

CC Switch v3.10.0

CC Switch v3.10.0

OpenCode Support, Global Proxy, Claude Rectifier & Multi-App Experience Enhancements

中文版 → | 日本語版 →

---

Overview

CC Switch v3.10.0 introduces OpenCode support, becoming the fourth managed CLI application.
This release also brings global proxy settings, Claude Rectifier (thinking signature fixer), enhanced health checks, per-provider configuration, and many other important features, along with comprehensive improvements to multi-app workflows and terminal experience.

Release Date: 2026-01-21

---

Highlights

• OpenCode Support: Full management of providers, MCP servers, and Skills with auto-import on first launch
• Global Proxy: Configure a unified proxy for all outbound network requests
• Claude Rectifier: Thinking signature fixer for better compatibility with third-party APIs
• Enhanced Health Checks: Configurable prompts and CLI-compatible request format
• Per-Provider Config: Persistent provider-specific configuration support
• App Visibility Control: Freely show/hide apps with synchronized tray menu updates
• Terminal Improvements: Provider-specific terminal buttons, fnm path support, cross-platform safe launch
• WSL Tool Detection: Detect tool versions in WSL environment with security hardening

---

Main Features

OpenCode Support (New Fourth App)

• Complete OpenCode provider management: add, edit, switch, delete
• MCP server management: unified architecture with Claude/Codex/Gemini
• Skills support: OpenCode can also use Skills functionality
• Auto-import on first launch: automatically imports existing OpenCode configuration when detected
• Full internationalization: Chinese/English/Japanese support (#695)

Global Proxy

• Configure a unified proxy for all outbound network requests (#596, thanks @yovinchen)
• Supports HTTP/HTTPS proxy protocols
• Suitable for network environments requiring proxy access to external APIs

Claude Rectifier (Thinking Signature Fixer)

• Automatically fixes Claude API thinking signatures (#595, thanks @yovinchen)
• Resolves incompatible thinking block formats returned by some third-party API gateways
• Can be enabled/disabled in Advanced Settings

Enhanced Health Checks

• Configurable custom prompts for streaming health checks (#623, thanks @yovinchen)
• Supports CLI-compatible request format for better simulation of real usage scenarios
• Improves fault detection accuracy

Per-Provider Config

• Support for saving configuration separately for each provider (#663, thanks @yovinchen)
• Persistent configuration: provider-specific settings retained after restart
• Suitable for scenarios where different providers require different configurations

App Visibility Control

• Freely show/hide any app (Gemini hidden by default)
• Tray menu automatically syncs visibility settings
• Hidden apps won't appear in the main interface or tray menu

Takeover Compact Mode

• Automatically uses compact layout when 3 or more visible apps are displayed
• Optimizes space utilization in multi-app scenarios

Terminal Improvements

• Provider-specific terminal button: one-click to use current provider in terminal (#564, thanks @kkkman22)
• fnm path support: automatically recognizes Node.js paths managed by fnm
• Cross-platform safe launch: improved terminal launch logic for Windows/macOS/Linux

WSL Tool Detection

• Detect tool versions in WSL environment (#627, thanks @yovinchen)
• Added security hardening to prevent command injection risks

Skills Preset Enhancements

• Added baoyu-skills preset repository
• Automatically supplements missing default repositories for out-of-the-box experience

---

Experience Improvements

• Keyboard shortcuts: Press ESC to quickly return/close panels (#670, thanks @xxk8)
• Simplified proxy logs: cleaner and more readable output (#585, thanks @yovinchen)
• Pricing editor UX: unified FullScreenPanel style
• Advanced settings layout: Rectifier section moved below Failover for better logical flow
• OpenRouter compatibility mode: disabled by default, UI toggle hidden (reduces clutter)

---

Bug Fixes

Proxy & Failover

• Immediately switch to P1 when auto-failover is enabled (instead of waiting for next request)

Provider Management

• Fixed stale data when reopening provider edit dialog after save (#654, thanks @YangYongAn)
• Fixed baseUrl and apiKey state not resetting when switching presets
• Fixed endpoint auto-selection state not persisting (#611, thanks @yovinchen)
• Automatically apply default color when icon color is not set

Deep Links

• Support multi-endpoint import (#597, thanks @yovinchen)
• Prefer GOOGLE_GEMINI_BASE_URL over GEMINI_BASE_URL

MCP

• Skip cmd /c wrapper for WSL target paths (#592, thanks @cxyfer)

Usage Templates

• Added variable hints, fixed validation issues (#628, thanks @YangYongAn)
• Prevent configuration leakage between providers
• Usage block offset automatically adapts to action button width (#613, thanks @yovinchen)

Gemini

• Convert timeout parameters to Gemini CLI format (#580, thanks @cxyfer)

UI

• Fixed Select dropdown rendering issues in FullScreenPanel

---

Notes & Considerations

• OpenCode is a newly supported app: OpenCode CLI must be installed first to use related features.
• Global proxy affects all outbound requests: including usage queries, health checks, and other network operations.
• Rectifier is experimental: can be disabled in Advanced Settings if issues occur.

---

Special Thanks

Thanks to @yovinchen @YangYongAn @cxyfer @xxk8 @kkkman22 @Shuimo03 for their contributions to this release!
Thanks to @libukai for designing the elegant failover-related UI!

---

Download & Installation

Visit Releases to download the appropriate version.

System Requirements

System	Minimum Version	Architecture
Windows	Windows 10 or later	x64
macOS	macOS 10.15 (Catalina) or later	Intel (x64) / Apple Silicon (arm64)
Linux	See table below	x64

Windows

File	Description
CC-Switch-v3.10.0-Windows.msi	Recommended - MSI installer with auto-update
CC-Switch-v3.10.0-Windows-Portable.zip	Portable version, extract and run, no registry write

macOS

File	Description
CC-Switch-v3.10.0-macOS.zip	Recommended - Extract and drag to Applications, Universal Binary
CC-Switch-v3.10.0-macOS.tar.gz	For Homebrew installation and auto-update

Note: Since the author doesn't have an Apple Developer account, you may see an "unidentified developer" warning on first launch. Please close it, then go to "System Settings" → "Privacy & Security" → click "Open Anyway", and it will open normally afterwards.

Homebrew (macOS)

brew tap farion1231/ccswitch
brew install --cask cc-switch

Update:

brew upgrade --cask cc-switch

Linux

Distribution	Recommended Format	Installation Method
Ubuntu / Debian / Linux Mint / Pop!_OS	.deb	sudo dpkg -i CC-Switch-*.deb or sudo apt install ./CC-Switch-*.deb
Fedora / RHEL / CentOS / Rocky Linux	.rpm	sudo rpm -i CC-Switch-*.rpm or sudo dnf install ./CC-Switch-*.rpm
openSUSE	.rpm	sudo zypper install ./CC-Switch-*.rpm
Arch Linux / Manjaro	.AppImage	Add execute permission and run directly, or use AUR
Other distributions / Unsure	.AppImage	chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage

CC Switch v3.9.1

CC Switch v3.9.1

Bug Fixes

Panic/Crash Fixes (#560)

• Proxy port conflict: Changed default port from 5000 to 15721 (5000 conflicts with AirPlay Receiver on macOS 12+)
• UTF-8 boundary panics: Fixed multiple locations where byte slicing on multi-byte characters (Chinese, emoji) could cause panics:
  • API key preview
  • Request body log truncation
  • masked_key / masked_access_token functions
  • HTTP response truncation in usage_script
• Unwrap/expect replacements: Added graceful error handling for HTTP client init, response body builder, SystemTime edge cases, and JSON operations
• SOCKS proxy support: Added reqwest socks feature

Other Fixes

• fix(windows): Correct window title and remove extra titlebar spacing
• fix(presets): Rename AiGoCode to AIGoCode (capitalization)

New Features

• feat(logging): Add crash logging and improve log management (#562)
• feat(presets): Add AiGoCode icon and partner promotion

CI/Build

• fix(ci): Temporarily remove Flatpak build due to persistent libdbusmenu/libayatana dependency issues in GNOME SDK 46

CC Switch v3.9.0

Local API Proxy, Auto Failover, Universal Provider, and a more complete multi-app workflow

中文版 → | 日本語版 →

---

Overview

CC Switch v3.9.0 is the stable release of the v3.9 beta series (3.9.0-1, 3.9.0-2, 3.9.0-3).
It introduces a local API proxy with per-app takeover, automatic failover, universal providers, and many stability and UX improvements across Claude Code, Codex, and Gemini CLI.

Release Date: 2026-01-07

---

Highlights

• Local API Proxy for Claude Code / Codex / Gemini CLI
• Auto Failover with circuit breaker and per-app failover queues
• Universal Provider: one shared config synced across apps (ideal for API gateways like NewAPI)
• Skills improvements: multi-app support, unified management with SSOT + React Query
• Common config snippets: extract reusable snippets from the editor or the current provider
• MCP import: import MCP servers from installed apps
• Usage improvements: auto-refresh, cache hit/creation metrics, and timezone fixes
• Linux packaging: RPM and Flatpak artifacts

---

Major Features

Local API Proxy

• Runs a local high-performance HTTP proxy server (Axum-based)
• Supports Claude Code, Codex, and Gemini CLI with a unified proxy
• Per-app takeover: you can independently decide which app routes through the proxy
• Live config takeover: backs up and redirects the CLI live config to the local proxy when takeover is enabled
• Monitoring: request logging and usage statistics for easier debugging and cost tracking
• Error request logging: keep detailed logs for failed proxy requests to simplify debugging (#401, thanks @yovinchen)

Auto Failover (Circuit Breaker)

• Automatically detects provider failures and triggers protection (circuit breaker)
• Automatically switches to a backup provider when the current one is unhealthy
• Tracks provider health in real time, and keeps independent failover queues per app
• When failover is disabled, timeout/retry related settings no longer affect normal request flow

Skills Management

• Multi-app Skills support for Claude Code and Codex, with smoother migration from older skill layouts (#365, #378, thanks @yovinchen)
• Unified Skills management architecture (SSOT + React Query) for more consistent state and refresh behavior
• Better discovery UX and performance:
  • Skip hidden directories during discovery
  • Faster discovery with long-lived caching for discoverable skills
  • Clear loading indicators and more discoverable header actions (import/refresh)
  • Fix wrong skill repo branch (#505, thanks @kjasn)

Universal Provider

• Add a shared provider configuration that can sync to Claude/Codex/Gemini (#348, thanks @Calcium-Ion)
• Designed for API gateways that support multiple protocols (e.g., NewAPI)
• Allows per-app default model mapping under a single provider

Common Config Snippets (Claude/Codex/Gemini)

• Maintain a reusable "common config" snippet and merge/append it into providers that enable it
• New extraction workflow:
  • Extract from the editor content (what you are currently editing)
  • Or extract from the current active provider when the editor content is not provided
• Codex extraction is safer:
  • Removes provider-specific sections like model_provider, model, and the entire model_providers table
  • Preserves base_url under [mcp_servers.*] so MCP configs are not accidentally broken

MCP Management

• Import MCP servers from installed apps
• Improve robustness: skip sync when the target CLI app is not installed; handle invalid Codex config.toml gracefully (#461, thanks @majiayu000)
• Windows compatibility: wrap npx/npm commands with cmd /c for MCP export

Usage & Pricing

• Usage & pricing improvements: auto-refresh, cache hit/creation metrics, timezone handling fixes, and refreshed built-in pricing table (#508, thanks @yovinchen)
• DeepLink support: import usage query configuration via deeplink (#400, thanks @qyinter)
• Model extraction for usage statistics (#455, thanks @yovinchen)
• Usage query credentials can fall back to provider config (#360, thanks @Sirhexs)

---

UX Improvements

• Provider search filter: quickly find providers by name (#435, thanks @TinsFox)
• Provider icon colors: customize provider icon colors for quicker visual identification (#385, thanks @yovinchen)
• Keyboard shortcut: Cmd/Ctrl + , opens Settings (#436, thanks @TinsFox)
• Skip Claude Code first-run confirmation dialog (optional)
• Closable toasts: close buttons for switch toast and all success toasts (#350, thanks @ForteScarlet)
• Update badge navigation: clicking the update badge opens the About tab
• Settings page tab style improvements (#342, thanks @wenyuanw)
• Smoother transitions: fade transitions for app/view switching and exit animations for panels
• Proxy takeover active theme: apply an emerald theme while takeover is active
• Dark mode readability improvements for forms and labels
• Better window dragging area for full-screen panels (#525, thanks @zerob13)

---

Platform Notes

Windows

• Prevent terminal windows from appearing during version checks
• Improve window sizing defaults (minimum width/height)
• Fix black screen on startup by using the system titlebar
• Add a fallback for crypto.randomUUID() on older WebViews

macOS

• Use .app bundle path for autostart to avoid terminal window popups (#462, thanks @majiayu000)
• Improve tray/icon behavior and header alignment

---

Packaging

• Linux: RPM and Flatpak packaging targets are now available for building release artifacts

---

Notes

• Security improvements for the JavaScript executor and usage script execution (#151, thanks @luojiyin1987).
• SQL import is restricted to CC Switch exported backups to reduce the risk of importing unsafe or incompatible SQL dumps.
• Proxy takeover modifies CLI live configs; CC Switch will back up the live config before redirecting it to the local proxy. If you want to revert, disable takeover/stop the proxy and restore from the backup when needed.

Special Thanks

Special thanks to @Xunyu @deijing @su-fen for their support and contributions. This release wouldn't be possible without you!

Download & Installation

Visit Releases to download the appropriate version.

System Requirements

System	Minimum Version	Architecture
Windows	Windows 10 or later	x64
macOS	macOS 10.15 (Catalina) or later	Intel (x64) / Apple Silicon (arm64)
Linux	See table below	x64

Windows

File	Description
CC-Switch-v3.9.0-Windows.msi	Recommended - MSI installer with auto-update support
CC-Switch-v3.9.0-Windows-Portable.zip	Portable version, no installation required

macOS

File	Description
CC-Switch-v3.9.0-macOS.zip	Recommended - Extract and drag to Applications, Universal Binary
CC-Switch-v3.9.0-macOS.tar.gz	For Homebrew installation and auto-update

Note: Since the author does not have an Apple Developer account, you may see an "unidentified developer" warning on first launch. Close the app, then go to "System Settings" → "Privacy & Security" → click "Open Anyway", and it will open normally afterwards.

Homebrew (MacOS)

brew tap farion1231/ccswitch
brew install --cask cc-switch

Update:

brew upgrade --cask cc-switch

Linux

Distribution	Recommended Format	Installation
Ubuntu / Debian / Linux Mint / Pop!_OS	.deb	sudo dpkg -i CC-Switch-*.deb or sudo apt install ./CC-Switch-*.deb
Fedora / RHEL / CentOS / Rocky Linux	.rpm	...