[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"package:cask:cc-switch:en":3,"releases:stats:cask:cc-switch:en":450,"related:cask:cc-switch:en":451,"markdown:3:3648:1jurhxi":506},{"accentColor":4,"artifacts":5,"autoUpdates":32,"categories":33,"conflictsWith":40,"dependsOn":43,"deprecated":36,"description":54,"descriptionEn":55,"developer":56,"disabled":36,"displayName":57,"downloadSha256":58,"downloadSize":59,"downloadUrl":60,"editorChoice":36,"formulaeUrl":61,"homepage":62,"iconUrl":63,"installCommand":64,"installs":65,"installs30d":66,"isFont":36,"isLibrary":36,"kegOnly":36,"kind":69,"latestRelease":70,"machineTranslated":36,"minMacos":53,"name":57,"names":91,"platforms":93,"primaryCategory":423,"rank30d":424,"releaseCount":425,"releaseStats":426,"repoUrl":62,"screenshots":432,"sourceLocale":85,"sourceUrl":440,"summary":441,"summaryTranslation":442,"supports":443,"tags":445,"tap":449,"token":92,"version":90,"versionChangedAt":74},"#E68C53",{"apps":6,"binaries":8,"entries":9,"pkgs":31},[7],"CC Switch.app",[],[10,17],{"declaration":11,"phase":14,"sources":15,"target":13,"type":16},{"app":12,"target":13},[7],"\u002FApplications\u002FCC Switch.app","install",[7],"app",{"declaration":18,"phase":28,"sources":29,"type":30},{"zap":19},[20],{"trash":21},[22,23,24,25,26,27],"~\u002F.cc-switch","~\u002FLibrary\u002FApplication Support\u002Fcom.ccswitch.desktop","~\u002FLibrary\u002FCaches\u002Fcom.ccswitch.desktop","~\u002FLibrary\u002FPreferences\u002Fcom.ccswitch.desktop.plist","~\u002FLibrary\u002FSaved Application State\u002Fcom.ccswitch.desktop.savedState","~\u002FLibrary\u002FWebKit\u002Fcom.ccswitch.desktop","cleanup",[],"zap",[],true,[34],{"icon":35,"machineTranslated":36,"name":37,"slug":38,"sourceLocale":39},"lucide:code-xml",false,"Developer Tools","developer-tools","zh-CN",{"casks":41,"formulae":42},[],[],{"arch":44,"casks":47,"formulae":48,"macos":49,"requirements":50},[45,46],"arm64","x86_64",[],[],">= 12",{"macos":51},{">=":52},[53],"12","CC Switch is an open-source desktop configuration manager for AI coding tools. It helps developers maintain provider endpoints, credentials, models, MCP servers, skills, prompts, sessions and usage from one interface. It does not itself supply an AI model subscription or replace the coding clients it manages.\n\n## Features\n- Switch provider connection fields while preserving unrelated client configuration.\n- Choose Direct connections, local Routing with conversion\u002Ffailover, or model-based Aggregation for supported clients. Aggregation does not provide failover.\n- Manage Claude Code, Claude Desktop, Codex, Gemini CLI, Grok Build, OpenCode, OpenClaw, Hermes, Pi and MiniMax Code; individual integrations differ.\n- Synchronize supported MCP and skill configurations and edit tool-specific prompts.\n- Read session steps, tool results and changes, search\u002Fexport conversations and resume supported sessions.\n- Inspect request usage, estimated costs, provider quotas and account information where integrations support them.\n\n## Installation and requirements\nInstall the recorded Mac cask with `brew install --cask cc-switch`, or download the official DMG, open it and copy CC Switch to Applications. The official Mac build is universal for Apple Silicon and Intel, requires macOS12 or later, and is signed\u002Fnotarized according to the maintainer. The cask lists no extra formula dependencies or explicit conflicts. Configure a provider or import supported existing configuration, then select the intended mode. The managed coding tools have their own installation, runtime, permissions and account requirements.\n\nThe maintainer also supplies Windows10+ packages (including ARM builds) and Linux x86_64\u002FARM64 builds. Linux requires glibc2.35+ and WebKitGTK4.1, for example Ubuntu22.04+ or Debian12+; RHEL\u002FRocky\u002FAlma8–9 are not supported by the stated release requirements. No supported mobile edition was confirmed. RAM and installed disk minimums were not published in the cited guide. The verified4.0.4 Mac DMG is33,926,314bytes; that is download size, not installation footprint.\n\n## Compatibility and upgrades\nRouting and Aggregation depend on the local gateway and upstream protocol support. Claude Code Aggregation needs Claude Code2.1.243 or newer. Restart Codex, Gemini CLI and Grok Build when prompted after switching; Claude Code aggregation changes apply without a restart. WSL networking has separate localhost requirements.\n\nVersion4.0 changes how settings are preserved and removes common configuration snippets. It migrates the database to schema20 and automatically creates a database backup in `~\u002F.cc-switch\u002Fbackups\u002F`; a3.x client cannot open the new database. Review the official upgrade notes before downgrading or changing existing setups. Existing provider presets are not silently replaced with new defaults.\n\n## Accounts, cost and license\nCC Switch is released under MIT (copyright Jason Young) and can be used without buying a CC Switch subscription. Each AI provider has separate authentication, subscription\u002FAPI charges and service conditions. API keys and account credentials are needed for the relevant provider operations; request-cost estimates are not invoices. Configuration and session data are stored locally by default under `~\u002F.cc-switch`. Cloud\u002FWebDAV synchronization and relay endpoints introduce their own account and data-handling choices.\n\nSources: [Official project and requirements](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch), [4.0.4 English release notes](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-notes\u002Fv4.0.4-en.md), [License](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002FLICENSE).","Configuration manager for AI coding agents","Jason Young (farion1231) and contributors","CC Switch","1e4d02e19864336b7fdc7e47d791c0a66f652c9591d8bf3c59be48a4cc940fd3",33926314,"https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Freleases\u002Fdownload\u002Fv4.0.4\u002FCC-Switch-v4.0.4-macOS.dmg","https:\u002F\u002Fformulae.brew.sh\u002Fcask\u002Fcc-switch","https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch","https:\u002F\u002Fcdn.opennavo.com\u002Ficons\u002Fuploads\u002Fefbe73b4642d\u002F50e788e99f3b-256.png","brew install --cask cc-switch",{"d30":66,"d365":67,"d90":68},2774,111604,24954,"cask",{"bodyMarkdown":71,"brewCommittedAt":72,"hasNotes":32,"id":73,"isLatest":32,"isPrerelease":36,"machineTranslated":36,"publishedAt":74,"sections":75,"source":84,"sourceLocale":85,"summary":86,"title":87,"translation":88,"version":90},"# CC Switch v4.0\n\n### Stable release (4.0.4): a new interface, the new Aggregation mode, and safer config switching\n\nThis is the first stable release of v4.0, and the app will update to it automatically. It includes everything in the 4.0 preview, plus the fixes and additions made during the preview, from 4.0.1 to 4.0.4.\n\nThis is the biggest CC Switch release yet. With it, we've rethought the core of the CC Switch experience: how you connect to models, how you switch providers, and how you manage a growing set of AI coding tools.\n\nThe interface has been redesigned from the sidebar to the tray, giving apps, config, usage and sessions each a clear place. The new Aggregation mode puts models from several providers into one Claude Code or Codex model picker, so you can switch between them right inside the client. The Usage page has been redesigned too: every request is logged with its token usage, cost and output speed, and choosing the \"All\" time range shows the past year of daily usage as a heatmap. Session management has been rewritten from scratch: what the AI did in each turn, what it changed and which step failed are all visible at a glance. And the config-writing core has been rebuilt: switching providers now replaces only the key fields instead of rewriting the whole file, which removes a great deal of complexity and puts an end to a whole class of lost-settings problems. MCP servers can now be synced to Pi too, so one MCP config can serve 8 AI coding tools at once.\n\n> **Upgrading from 3.x?** How provider switching works, the database version and a few settings have changed. We suggest reading \"Before You Upgrade\" below first.\n\n---\n\n## A Redesigned Interface\n\nThe new interface uses a sidebar layout and an orange theme. Switching apps, plus global features like MCP, Skills, Prompts, Sessions, Accounts and Usage, are all one click away in the sidebar.\n\n\u003Cp align=\"center\">\u003Cimg src=\"https:\u002F\u002Fraw.githubusercontent.com\u002Ffarion1231\u002Fcc-switch\u002Fmain\u002Fassets\u002Frelease-notes\u002Fv4.0.0\u002Fmain-en.png\" alt=\"The new interface: sidebar, mode tabs and provider cards\" width=\"720\">\u003C\u002Fp>\n\n- **Modes at a glance**: Every app page has three tabs at the top: Direct \u002F Routing \u002F Aggregation. Clicking a tab only changes what you're looking at and never touches your config. The button that actually switches modes tells you what will happen, and going back to Direct takes one step and can be undone\n- **A home for your tools**: The new Apps page shows each AI coding tool's version, install location and source, with install, upgrade and batch upgrade\n- **A cleaner Add Provider panel**: Search, pick a preset, fill in the form. Search matches Chinese names and domains, and one vendor's plans and regions are merged into one row, so Claude's presets now take noticeably fewer rows. Preset providers are no longer highlighted as recommendations\n- **Quota shows what's left**: Cards read \"5-hour 94% left\" or \"Balance 8.99 CNY\", and each tier is followed by its reset countdown, like \"⏱ 2h30m\". Quota stays a quiet gray: a percentage turns bold when it drops below 10%, and a balance turns red only once it runs out. Click it to re-check and see the result. Codex subscriptions also show how many saved resets are left and when they expire, and ChatGPT subscriptions show their Codex Credits balance, converted to US dollars at API prices\n- **Tray organized by app**: Each row reads \"name · mode · provider · quota\", and submenus list only the providers you can switch to right now. The tray icon shows a dot only when something really needs your attention\n- **Settings grouped by purpose**: General, App config, Local routing, Network, Data, About. Local routing's service status, listen address and failover settings now live in one place\n- **Editing is no longer a dialog**: Providers, MCP servers and prompts open as a full page in the content area, and the sidebar keeps working. With unsaved changes, clicking the sidebar, pressing ⌘, or switching away from the tray asks first\n\n\u003Cp align=\"center\">\u003Cimg src=\"https:\u002F\u002Fraw.githubusercontent.com\u002Ffarion1231\u002Fcc-switch\u002Fmain\u002Fassets\u002Frelease-notes\u002Fv4.0.0\u002Fapps-en.png\" alt=\"The Apps page: versions, installs and upgrades for every AI coding tool in one place\" width=\"720\">\u003C\u002Fp>\n\nUpgrading users see a short note on first launch explaining where things have moved. After each update, the first launch also shows a summary of what changed. To see it again, click \"Recent updates\" in Settings → About.\n\n---\n\n## Aggregation: Many Providers, One Model Picker\n\nUntil now, using another provider's model meant going back to CC Switch, switching providers, and returning to your client.\n\nTurn on **Aggregation**, add a few providers, and their models all show up together in the Claude Code or Codex model picker. Whichever model you pick, the request goes straight to that provider, without ever leaving the client.\n\n\u003Cp align=\"center\">\u003Cimg src=\"https:\u002F\u002Fraw.githubusercontent.com\u002Ffarion1231\u002Fcc-switch\u002Fmain\u002Fassets\u002Frelease-notes\u002Fv4.0.0\u002Fagg-codex-en.png\" alt=\"Models from several providers listed together in Codex's model picker\" width=\"560\">\u003C\u002Fp>\n\n- **Add and remove anytime**: Click \"Add\" or \"Remove\" on a provider card, then choose one provider as the default to handle requests that don't name an aggregated model\n- **Know every model at a glance**: Each model name carries its provider, like \"Kimi K3 (Kimi For Coding)\", and its description shows the real upstream model ID and context window, like `kimi-k3 · 256K`\n- **A streamlined form**: When you add or edit a provider on the \"Aggregation\" tab, connection details and the model list sit on one page, and that's all you fill in. The \"Direct\" and \"Routing\" tabs use the full form\n- **Mix providers in Codex without errors**: Set your official account as the default, and official and third-party models are listed side by side. Switch back and forth between providers' models and context compaction and reasoning state carry over\n- **Switch models mid-session**: You can change to another model partway through a session. Note that after each switch, the new model has to build its prompt cache again, so the first turn after switching costs noticeably more\n- **Restart reminders**: When Codex's model list changes you're prompted to restart, and Codex CLI users can restart the background service from the banner in one click. Changes to Claude Code's aggregated models take effect right away, with no restart\n\n\u003Cp align=\"center\">\u003Cimg src=\"https:\u002F\u002Fraw.githubusercontent.com\u002Ffarion1231\u002Fcc-switch\u002Fmain\u002Fassets\u002Frelease-notes\u002Fv4.0.0\u002Fagg-en.png\" alt=\"Aggregation: one default provider plus six added providers\" width=\"720\">\u003C\u002Fp>\n\nAggregation is opt-in and currently supports Claude Code and Codex. Claude Code's aggregated model list needs Claude Code 2.1.243 or later. Aggregation routes each request by the model you pick, and does not offer failover.\n\n| Mode | How requests travel | Best for |\n|------|---------------------|----------|\n| **Direct** | The client talks to the provider directly | Everyday use |\n| **Routing** | Through local routing to one provider, with protocol conversion and failover | Incompatible protocols, or when you need failover |\n| **Aggregation** | Through local routing, dispatched by model to several providers | Mixing models from several providers in one session |\n\n> **A Tribute to opencodex**\n>\n> Aggregation learned a great deal from [opencodex](https:\u002F\u002Fgithub.com\u002Flidge-jun\u002Fopencodex) and builds directly on its ideas: prefixing model IDs with the provider so models from many providers can share the Claude Code and Codex pickers; letting Codex compact context on third-party models; and detecting when a background service is still using an old model list, then prompting a restart. All of these came out of opencodex's exploration. Our thanks to its author ([@lidge-jun](https:\u002F\u002Fgithub.com\u002Flidge-jun)) and contributors for open-sourcing this work, and our deepest respect for their open-source spirit!\n>\n> If you want a tool dedicated to bringing any model into Codex and Claude Code, we highly recommend giving opencodex a try!\n\n---\n\n## Usage\n\n**The Usage page** has redesigned metrics, a trend chart, a request log, and four paginated tables for providers, models and pricing. A new \"All\" time range shows your daily usage as a 53-week heatmap, and wide-range queries no longer freeze the window.\n\n\u003Cp align=\"center\">\u003Cimg src=\"https:\u002F\u002Fraw.githubusercontent.com\u002Ffarion1231\u002Fcc-switch\u002Fmain\u002Fassets\u002Frelease-notes\u002Fv4.0.0\u002Fusage-en.png\" alt=\"Usage: the 53-week heatmap and request log\" width=\"720\">\u003C\u002Fp>\n\n- **Output speed** is now measured over generation time only, without the wait for the first token. Even without routing, requests imported from Claude Code and Codex session logs get an estimated speed, marked with \"≈\"\n- **The model table gains Success Rate and Speed columns**. The \"Average Cost\" column is gone; hover over the cost to see it\n- **The provider and model tables count cache tokens**, so the rows add up to the total token count at the top\n- Usage imported from session logs without routing shows a provider name like \"Claude Code · Session logs\", and hovering explains why the specific provider cannot be told apart\n- Usage records are written on a separate thread, so a slow disk no longer slows down the routing service\n\n---\n\n## Switch Providers, Keep Your Config Intact\n\nThis is the most important under-the-hood change in this release. It applies to Claude Code, Codex, Gemini CLI, Grok Build and Claude Desktop.\n\nCC Switch launched in August 2025, when the API ecosystem was far less mature than it is today. API formats often differed widely between official and third-party providers, so the original design rewrote the whole config file on every switch. That choice brought a series of problems and a lot of complexity. Now that the ecosystem has matured, it's time to rebuild.\n\n**Before**: Switching providers rewrote the entire config file from that provider's saved snapshot. Hooks, plugins and permissions you added to `settings.json`, or MCP servers you added to `config.toml`, were either lost on switch or absorbed into one provider's snapshot, disappearing as soon as you switched to another.\n\n**Now**: Switching replaces only the endpoint, credential, model and protocol, plus the provider's own switches. Everything else stays exactly where it was:\n\n- In TOML and `.env` files, untouched lines, comments and order included, stay byte for byte the same\n- In JSON files, every other key keeps its value and order\n- Shared settings simply stay in your config file, so the \"common config snippet\" feature is no longer needed\n\n**The editor previews what your config file will look like after switching**. Global settings you edit there are written to the config file, and before saving CC Switch checks whether another program has changed the file in the meantime.\n\nThe new write engine also adds several layers of protection:\n\n- If a config file can't be parsed, writing stops and the original file is left untouched\n- External changes are checked before writing, so a file another program just saved is never overwritten\n- When several files change together, the intent is recorded first. If the app quits unexpectedly midway, the next launch finishes the job automatically instead of leaving things half-written\n- Each file is backed up as-is before the new version writes to it for the first time\n- Config files that hold keys are readable and writable only by you\n\nTurning routing on or off no longer relies on backing up and restoring your whole config. When Codex switches to a third-party provider, the ChatGPT login it overwrites is stashed locally and restored automatically when you switch back to your official account.\n\n---\n\n## Session Management: See Every AI Coding Session Clearly\n\nAI coding tools keep a complete record of every session on your machine, but the raw logs are thousands of lines of JSON and nearly impossible to read. This release rewrites session management from scratch to make those records as readable as possible, and adds token usage and cost for each session.\n\n\u003Cp align=\"center\">\u003Cimg src=\"https:\u002F\u002Fraw.githubusercontent.com\u002Ffarion1231\u002Fcc-switch\u002Fmain\u002Fassets\u002Frelease-notes\u002Fv4.0.0\u002Fsession-en.png\" alt=\"The session reader: step summaries, tool call details and the conversation outline\" width=\"720\">\u003C\u002Fp>\n\n- **Nine clients, one way to read them**: Sessions from Claude Code, Codex, Gemini CLI, Grok Build, OpenCode, OpenClaw, Hermes, Pi and MiniMax Code are parsed into structured content, with text, thinking, tool calls, tool results and images each shown in their own form\n- **One turn, one summary line**: A long run of AI actions folds into a single line, such as \"Steps · 44 · 27 commands · 2 files changed · 1 failed · 27m45s\". Failed commands are marked in red, and expanding one shows its parameters, output and exit code. Runs of file reads and searches merge into \"Read N files, searched N times\"\n- **Conversation outline**: The right-hand panel lists each of your prompts along with how many steps the turn took and what it concluded. Turns with failed steps get a red dot; click to jump there\n- **Three views**: \"All\" shows the full process, \"Chat\" shows only what you and the AI said, and \"Changes\" shows only which files were changed\n- **The whole session at a glance**: The header shows the project directory, start and end time, number of prompts and tool calls, model, total tokens and the cost at API prices\n- **Find in session**: Matches hidden inside folded tool output are expanded and scrolled into view automatically, and typing stays smooth even in long sessions\n- **From reading back to working**: Resume a session in your favorite terminal (Ghostty, for example) in one click, or copy the resume command. You can also export to Markdown and copy a single turn or the whole conversation\n- **An easier-to-search list**: Group by project or time, search titles, directories, first and last messages or session IDs, and delete in bulk\n- OpenCode 2.x sessions and Gemini CLI's new JSONL session format are now supported, and Hermes sessions open correctly again\n\nThe session reader redesign was led by [@Owlbay](https:\u002F\u002Fgithub.com\u002FOwlbay). Many thanks to Owlbay for the enormous effort.\n\n---\n\n## MCP Sync to Pi\n\nPi 1.0 has built-in MCP with the same config format as Claude Code. Turn on sync for Pi on the MCP page, and your existing MCP servers work in Pi right away. Together with Claude Code, Codex, Gemini CLI, Grok Build, OpenCode, Hermes and MiniMax Code, one MCP config can now manage 8 AI coding tools.\n\n- **Only connection fields are written**: Pi's own settings, such as timeouts, tool exposure and OAuth, are left as they are\n- **Turning sync off does not delete entries**: They are only marked disabled in Pi, and those settings are still there when you turn sync back on\n- **Unsupported configs are flagged right away**: Servers that use the SSE transport, which Pi does not support, or have special characters in their names are not written to the file\n\nMCP sync for Pi was built by [@Owlbay](https:\u002F\u002Fgithub.com\u002FOwlbay) and [@LystranG](https:\u002F\u002Fgithub.com\u002FLystranG).\n\n---\n\n## More Improvements\n\n- **Claude Code quick toggles**: New \"Disable Auto Mode Server Checks\". Starting with Claude Code 2.1.281, every session going through a third-party gateway or local routing first stopped once with a \"not eligible\" notice. With this checked, the check runs locally and the notice goes away. It is checked by default for new third-party providers; do not check it for official endpoints. Every quick toggle now has a \"?\" after it, explaining what it does and whether it is a global setting or follows the provider\n- **MCP**: Paste several server configs at once in JSON, TOML, Codex or OpenCode format. If writing to one app fails you can retry just that app, and one bad server no longer stops the others from syncing\n- **Skills**: \"Installed\" and \"Discover\" are merged into one page with one-click \"Update all\", and you can choose the sync method: automatic, symlink only or copy only. The installed list has a select-all checkbox in its header\n- **Prompts**: Manage prompts for eight apps on one page, copy them to other apps, import existing files, and undo a delete\n- **Accounts**: Accounts, re-login actions and remaining quota at a glance\n- **Backups at a glance**: \"Backup & Restore\" now has an expandable \"Other Backups\" section listing the path, size and item count of each kind of backup under `~\u002F.cc-switch`. You can open where they are stored or delete a whole category, and before deleting it tells you what you would lose\n- **Model metadata autofill**: When you pick a fetched model, its context window, output limit, reasoning levels and input types are filled in from presets and models.dev, without overwriting anything you've already entered\n- **Claude Desktop**: With model mapping, the local routing service starts on its own and stops when no longer needed\n- **OpenCode**: OpenCode 2.0's new provider config is supported. Both the old and new formats can be read and written, and format errors point to the exact field. You can pick thinking variants: models known to support reasoning are marked automatically, and OpenCode generates the variants itself. Comments and formatting in `opencode.jsonc` survive sync, and OpenCode 2.x usage is tracked\n- **MiniMax Code**: Install and upgrade it from the Apps page, and choose your own provider key when creating a provider\n- **Presets and pricing**: New Command Code, OpenCode Zen (Claude Code and Codex; shares one row with OpenCode Go) and MoArk (Claude Code, Codex, Pi, OpenCode, OpenClaw) presets; updated pricing for Claude Opus 5.5, GPT-6 Sol \u002F Luna, MiMo V2.6 and more; all existing presets now have proper icons\n- **Easier troubleshooting from logs**: Switching providers and entering or leaving Routing or Aggregation now logs where it switched from and to and how it went\n- **Project switcher hidden by default**: Most users don't need projects, so new installs no longer show the project switcher on the main page or in the tray. Turn it on in Settings when you need it. If you already use it, nothing changes\n\n---\n\n## Before You Upgrade\n\n**Where settings live has changed.** Shared settings now stay in the client's own config file, and the \"common config snippet\" feature has been removed. A model or reasoning effort you pick temporarily in the client goes back to the provider's value when you switch away and back. To keep it, save it in the provider editor.\n\n**Some fixes take effect after one switch.** The Codex model catalog and session history fixes apply the next time CC Switch writes the Codex config, so just switch providers once after upgrading. Re-sync your existing MCP config once to clear the old `type` field.\n\n**Restart when prompted after switching.** Codex, Gemini CLI and Grok Build need a restart after switching models, and Codex also needs a restart after its Aggregation list changes. Changes to Claude Code's aggregated models need no restart.\n\n**The database schema is now at 20.** The database is backed up automatically before the upgrade, under `~\u002F.cc-switch\u002Fbackups\u002F` (files starting with `db_backup_`). Going back to 3.x afterwards shows \"Database version is too new\".\n\n**Existing cards stay as they are.** Preset updates only apply to newly created providers. For example, existing Claude providers do not get \"Disable Auto Mode Server Checks\" checked automatically; check it in the editor if you need it. New pricing only backfills requests previously recorded at $0; other historical costs are not recalculated.\n\n**Claude Code's Aggregation mode needs 2.1.243 or later.** Claude Code added a `modelPicker` setting in that version, and aggregated models are listed in `\u002Fmodel` through it. Earlier versions ignore it, so `\u002Fmodel` shows none of the aggregated models. Run `claude --version` to check your version and `claude update` to upgrade.\n\n**A few settings have been removed.** Per-provider cost multipliers (relay prices already include their multiplier, so applying another one only skews the numbers); the connectivity-check advanced settings (built-in defaults are used now); and Claude's \"Teammates Mode\" and \"Max Effort Thinking\" quick toggles (every Claude Code session now has team features built in, and max effort locked every session to the most expensive level; use `\u002Feffort max` in a session when you need it). Variables already written in your config are not removed.\n\n---\n\n## Fixes\n\n- **Claude Code conversations on a ChatGPT account broke with a 400 error.** The official Codex backend added a field to its reasoning records, and the next request was then rejected. Conversations that already failed now recover on their own\n- **With Claude Code mapped to GPT or Grok, turning thinking off still left it reasoning at full effort.** Turning thinking off now lowers the reasoning effort to low, levels the target model does not support are adjusted automatically, and `\u002Feffort low` on GPT-5.x pro no longer fails with a 400\n- After quitting with `⌘Q`, the Dock's \"Quit\" or logging out on macOS, clients stayed pointed at the stopped local routing service\n- Replies on the Codex official route appeared only after a long delay, with usage recorded as 0\n- GPT models in the Codex model catalog lost their official prompts, tool capabilities and reasoning levels\n- Since Codex 0.158, the `type` field in MCP config caused errors and could even stop Codex from starting\n- MiniMax tool calls failed to parse their arguments, and some models' thinking showed up mixed into the reply text\n- Some upstreams mix LF and CRLF line breaks in streaming responses, which made tool calls go missing\n- An upstream rejection was reported as \"output limit reached\"; it is now reported as the upstream error it is, with the reason\n- Claude Desktop with OpenCode Go failed with `400 MissingSessionID`; local routing now adds the session ID automatically\n- Other apps checked when importing a Skill never actually got it, and syncing Skills deleted same-named folders inside OpenClaw's directory\n- Adding or importing a prompt could empty a prompt file you wrote by hand\n- Codex under WSL slowed down startup and session scans\n- The time MCP preset exited right after it started; it now runs `uvx mcp-server-time` (for servers you already added, change the command to `uvx` and the argument to `mcp-server-time` by hand)\n- Upgrading some CLIs installed an extra npm copy\n- The database file didn't shrink after old logs were pruned\n- \"Save and restart service\" in settings didn't actually restart the service\n- On macOS, after an in-app update or a config directory change, the restarted window opened behind other apps (the restart for this upgrade is still run by the old version, so the fix takes effect from the next update)\n- Grok Build's \"Get API Key\" opened the plain homepage, and the Xiaomi MiMo presets for Hermes and OpenClaw defaulted to a model without image support\n\n---\n\n## Changes Since the 4.0.0 Preview\n\nIf you already installed a preview from 4.0.0 to 4.0.3, this section lists what changed during the preview. The notes above already include all of it.\n\n**New**: Claude Code's \"Disable Auto Mode Server Checks\" quick toggle and an explanation for every toggle; MCP sync to Pi 1.0; full-page editing for MCP servers and prompts, with a reminder to save before leaving; the \"Other Backups\" overview; Codex Credits balance; OpenCode 2.0's new provider config and thinking variants; Success Rate and Speed columns in the Usage model table; OpenCode Zen and MoArk presets; select-all for installed Skills; switch logging; an update summary after each update.\n\n**Fixes**: ChatGPT account conversations failing with a 400; reasoning at full effort with thinking off; four rows of the same model at the top of `\u002Fmodel` in Claude Code's Aggregation mode; apps checked when importing a Skill not getting it; model mapping and aggregated models not working after another tool changed Codex's model catalog setting; Gemini CLI sessions not showing up; Codex under WSL slowing down scans; upstream errors reported as an output limit; Claude Desktop with OpenCode Go failing with a 400; tool calls lost in streaming; usage tables leaving out cache tokens; usage writes slowing down routing; the time MCP preset exiting at startup; Codex usage sync possibly hanging; plus UI details such as the sidebar animation, the divider, rows stretched by picking many reasoning levels, the time range picker border and icons filling their box.\n\n**Polish**: Changing Claude Code's aggregated models no longer needs a restart; the provider form follows the tab you are on, and models fetched in the full Codex form can be picked straight into the model mapping table; Claude's \"Teammates Mode\" and \"Max Effort Thinking\" quick toggles are removed.\n\n**New in 4.0.4**:\n- On macOS, after an in-app update or a config directory change, the restarted window comes to the front\n- New installs hide the project switcher by default\n- In a narrow Usage window, the request log's Speed column no longer gets pushed out into the horizontal scroll area\n- The Star prompt on the About page is now a strip of its own that you can dismiss\n\n---\n\n## Thanks\n\nThanks to everyone who contributed to this release:\n\n[@Owlbay](https:\u002F\u002Fgithub.com\u002FOwlbay) (session reader redesign, usage heatmap and performance, full-page editing and the unsaved-changes reminder, MCP sync for Pi, the time MCP preset, the MiMo presets), [@qyinter](https:\u002F\u002Fgithub.com\u002Fqyinter) (extensive UI\u002FUX polish), [@allenxu09](https:\u002F\u002Fgithub.com\u002Fallenxu09), [@parkavenue9639](https:\u002F\u002Fgithub.com\u002Fparkavenue9639), [@ggbdpq](https:\u002F\u002Fgithub.com\u002Fggbdpq), [@SailingLoong](https:\u002F\u002Fgithub.com\u002FSailingLoong), [@DEAN-Cherry](https:\u002F\u002Fgithub.com\u002FDEAN-Cherry), [@LystranG](https:\u002F\u002Fgithub.com\u002FLystranG), [@lcgash](https:\u002F\u002Fgithub.com\u002Flcgash), [@Chris-Xie369](https:\u002F\u002Fgithub.com\u002FChris-Xie369), [@fisHarly0](https:\u002F\u002Fgithub.com\u002FfisHarly0), [@minc-nice-100](https:\u002F\u002Fgithub.com\u002Fminc-nice-100), [@funkpopo](https:\u002F\u002Fgithub.com\u002Ffunkpopo), [@ISuuuu](https:\u002F\u002Fgithub.com\u002FISuuuu), [@tingfeng347](https:\u002F\u002Fgithub.com\u002Ftingfeng347), [@Hexc01](https:\u002F\u002Fgithub.com\u002FHexc01), [@zhengkaics](https:\u002F\u002Fgithub.com\u002Fzhengkaics), [@7ten7](https:\u002F\u002Fgithub.com\u002F7ten7), [@2doright](https:\u002F\u002Fgithub.com\u002F2doright), [@RemindZ](https:\u002F\u002Fgithub.com\u002FRemindZ), [@M3chD09](https:\u002F\u002Fgithub.com\u002FM3chD09), [@Richard-Zhang1019](https:\u002F\u002Fgithub.com\u002FRichard-Zhang1019), [@YuxuZhou-CN](https:\u002F\u002Fgithub.com\u002FYuxuZhou-CN), [@Eureka0w0v0](https:\u002F\u002Fgithub.com\u002FEureka0w0v0), [@Ne1ther](https:\u002F\u002Fgithub.com\u002FNe1ther), [@h6rime](https:\u002F\u002Fgithub.com\u002Fh6rime), [@bigben446](https:\u002F\u002Fgithub.com\u002Fbigben446), [@szupzj18](https:\u002F\u002Fgithub.com\u002Fszupzj18), [@AnxForever](https:\u002F\u002Fgithub.com\u002FAnxForever)\n\nThanks also to [@PnutCN](https:\u002F\u002Fgithub.com\u002FPnutCN), [@Aaron-WealthTech](https:\u002F\u002Fgithub.com\u002FAaron-WealthTech), [@RuriLothlorien](https:\u002F\u002Fgithub.com\u002FRuriLothlorien), [@Ming-Sir-69](https:\u002F\u002Fgithub.com\u002FMing-Sir-69), [@juntaosun](https:\u002F\u002Fgithub.com\u002Fjuntaosun), [@killServer0](https:\u002F\u002Fgithub.com\u002FkillServer0), [@shangchaovo](https:\u002F\u002Fgithub.com\u002Fshangchaovo), [@gsmchen](https:\u002F\u002Fgithub.com\u002Fgsmchen), [@winter-maple](https:\u002F\u002Fgithub.com\u002Fwinter-maple), [@guangzh3n](https:\u002F\u002Fgithub.com\u002Fguangzh3n), [@AltCtrlFn](https:\u002F\u002Fgithub.com\u002FAltCtrlFn), [@R-Tsubasa](https:\u002F\u002Fgithub.com\u002FR-Tsubasa), [@Lingbou](https:\u002F\u002Fgithub.com\u002FLingbou), [@Enough1122](https:\u002F\u002Fgithub.com\u002FEnough1122), [@IAld010](https:\u002F\u002Fgithub.com\u002FIAld010) for detailed bug reports, investigation and suggestions that helped us pin down the problems.\n\nSpecial thanks to the [opencodex](https:\u002F\u002Fgithub.com\u002Flidge-jun\u002Fopencodex) project; much of Aggregation's design benefits from its open-source exploration.\n\nAnd thanks to everyone who filed an issue or helped reproduce a bug. For the full technical details, see the [CHANGELOG](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002FCHANGELOG.md).\n\n\n[Official version release](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Freleases\u002Ftag\u002Fv4.0.4).","2026-10-07T12:59:54Z",625,"2026-10-07T14:00:21.503962Z",[76],{"area":77,"items":78},"Highlights",[79,80,81,82,83],"Redesign sidebar, provider cards, app management and tray.","Aggregate Claude Code and Codex models from multiple providers.","Preserve unrelated configuration fields and detect external edits.","Rebuild session and usage views; synchronize MCP to Pi.","Database moves to schema20; review3.x migration and restart notes.","editorial","en-US","First stable4.0 release: redesigned interface, multi-provider model aggregation, safer config writes and rebuilt session\u002Fusage views.","CC Switch 4.0.4",{"locale":85,"machineTranslated":36,"sourceLocale":85,"status":89},"source","4.0.4",[57,92],"cc-switch",[94,122,149,177,204,232,259,287,314,342,369,396],{"arch":46,"artifacts":95,"conflictsWith":110,"dependsOn":113,"downloadSha256":58,"downloadUrl":60,"macos":120,"minMacos":53,"requiresRosetta":36,"tag":121,"version":90},{"apps":96,"binaries":97,"entries":98,"pkgs":109},[7],[],[99,103],{"declaration":100,"phase":14,"sources":102,"target":13,"type":16},{"app":101,"target":13},[7],[7],{"declaration":104,"phase":28,"sources":108,"type":30},{"zap":105},[106],{"trash":107},[22,23,24,25,26,27],[],[],{"casks":111,"formulae":112},[],[],{"arch":114,"casks":115,"formulae":116,"macos":49,"requirements":117},[46],[],[],{"macos":118},{">=":119},[53],"27","golden_gate",{"arch":45,"artifacts":123,"conflictsWith":138,"dependsOn":141,"downloadSha256":58,"downloadUrl":60,"macos":120,"minMacos":53,"requiresRosetta":36,"tag":148,"version":90},{"apps":124,"binaries":125,"entries":126,"pkgs":137},[7],[],[127,131],{"declaration":128,"phase":14,"sources":130,"target":13,"type":16},{"app":129,"target":13},[7],[7],{"declaration":132,"phase":28,"sources":136,"type":30},{"zap":133},[134],{"trash":135},[22,23,24,25,26,27],[],[],{"casks":139,"formulae":140},[],[],{"arch":142,"casks":143,"formulae":144,"macos":49,"requirements":145},[45],[],[],{"macos":146},{">=":147},[53],"arm64_golden_gate",{"arch":46,"artifacts":150,"conflictsWith":165,"dependsOn":168,"downloadSha256":58,"downloadUrl":60,"macos":175,"minMacos":53,"requiresRosetta":36,"tag":176,"version":90},{"apps":151,"binaries":152,"entries":153,"pkgs":164},[7],[],[154,158],{"declaration":155,"phase":14,"sources":157,"target":13,"type":16},{"app":156,"target":13},[7],[7],{"declaration":159,"phase":28,"sources":163,"type":30},{"zap":160},[161],{"trash":162},[22,23,24,25,26,27],[],[],{"casks":166,"formulae":167},[],[],{"arch":169,"casks":170,"formulae":171,"macos":49,"requirements":172},[46],[],[],{"macos":173},{">=":174},[53],"26","tahoe",{"arch":45,"artifacts":178,"conflictsWith":193,"dependsOn":196,"downloadSha256":58,"downloadUrl":60,"macos":175,"minMacos":53,"requiresRosetta":36,"tag":203,"version":90},{"apps":179,"binaries":180,"entries":181,"pkgs":192},[7],[],[182,186],{"declaration":183,"phase":14,"sources":185,"target":13,"type":16},{"app":184,"target":13},[7],[7],{"declaration":187,"phase":28,"sources":191,"type":30},{"zap":188},[189],{"trash":190},[22,23,24,25,26,27],[],[],{"casks":194,"formulae":195},[],[],{"arch":197,"casks":198,"formulae":199,"macos":49,"requirements":200},[45],[],[],{"macos":201},{">=":202},[53],"arm64_tahoe",{"arch":46,"artifacts":205,"conflictsWith":220,"dependsOn":223,"downloadSha256":58,"downloadUrl":60,"macos":230,"minMacos":53,"requiresRosetta":36,"tag":231,"version":90},{"apps":206,"binaries":207,"entries":208,"pkgs":219},[7],[],[209,213],{"declaration":210,"phase":14,"sources":212,"target":13,"type":16},{"app":211,"target":13},[7],[7],{"declaration":214,"phase":28,"sources":218,"type":30},{"zap":215},[216],{"trash":217},[22,23,24,25,26,27],[],[],{"casks":221,"formulae":222},[],[],{"arch":224,"casks":225,"formulae":226,"macos":49,"requirements":227},[46],[],[],{"macos":228},{">=":229},[53],"15","sequoia",{"arch":45,"artifacts":233,"conflictsWith":248,"dependsOn":251,"downloadSha256":58,"downloadUrl":60,"macos":230,"minMacos":53,"requiresRosetta":36,"tag":258,"version":90},{"apps":234,"binaries":235,"entries":236,"pkgs":247},[7],[],[237,241],{"declaration":238,"phase":14,"sources":240,"target":13,"type":16},{"app":239,"target":13},[7],[7],{"declaration":242,"phase":28,"sources":246,"type":30},{"zap":243},[244],{"trash":245},[22,23,24,25,26,27],[],[],{"casks":249,"formulae":250},[],[],{"arch":252,"casks":253,"formulae":254,"macos":49,"requirements":255},[45],[],[],{"macos":256},{">=":257},[53],"arm64_sequoia",{"arch":46,"artifacts":260,"conflictsWith":275,"dependsOn":278,"downloadSha256":58,"downloadUrl":60,"macos":285,"minMacos":53,"requiresRosetta":36,"tag":286,"version":90},{"apps":261,"binaries":262,"entries":263,"pkgs":274},[7],[],[264,268],{"declaration":265,"phase":14,"sources":267,"target":13,"type":16},{"app":266,"target":13},[7],[7],{"declaration":269,"phase":28,"sources":273,"type":30},{"zap":270},[271],{"trash":272},[22,23,24,25,26,27],[],[],{"casks":276,"formulae":277},[],[],{"arch":279,"casks":280,"formulae":281,"macos":49,"requirements":282},[46],[],[],{"macos":283},{">=":284},[53],"14","sonoma",{"arch":45,"artifacts":288,"conflictsWith":303,"dependsOn":306,"downloadSha256":58,"downloadUrl":60,"macos":285,"minMacos":53,"requiresRosetta":36,"tag":313,"version":90},{"apps":289,"binaries":290,"entries":291,"pkgs":302},[7],[],[292,296],{"declaration":293,"phase":14,"sources":295,"target":13,"type":16},{"app":294,"target":13},[7],[7],{"declaration":297,"phase":28,"sources":301,"type":30},{"zap":298},[299],{"trash":300},[22,23,24,25,26,27],[],[],{"casks":304,"formulae":305},[],[],{"arch":307,"casks":308,"formulae":309,"macos":49,"requirements":310},[45],[],[],{"macos":311},{">=":312},[53],"arm64_sonoma",{"arch":46,"artifacts":315,"conflictsWith":330,"dependsOn":333,"downloadSha256":58,"downloadUrl":60,"macos":340,"minMacos":53,"requiresRosetta":36,"tag":341,"version":90},{"apps":316,"binaries":317,"entries":318,"pkgs":329},[7],[],[319,323],{"declaration":320,"phase":14,"sources":322,"target":13,"type":16},{"app":321,"target":13},[7],[7],{"declaration":324,"phase":28,"sources":328,"type":30},{"zap":325},[326],{"trash":327},[22,23,24,25,26,27],[],[],{"casks":331,"formulae":332},[],[],{"arch":334,"casks":335,"formulae":336,"macos":49,"requirements":337},[46],[],[],{"macos":338},{">=":339},[53],"13","ventura",{"arch":45,"artifacts":343,"conflictsWith":358,"dependsOn":361,"downloadSha256":58,"downloadUrl":60,"macos":340,"minMacos":53,"requiresRosetta":36,"tag":368,"version":90},{"apps":344,"binaries":345,"entries":346,"pkgs":357},[7],[],[347,351],{"declaration":348,"phase":14,"sources":350,"target":13,"type":16},{"app":349,"target":13},[7],[7],{"declaration":352,"phase":28,"sources":356,"type":30},{"zap":353},[354],{"trash":355},[22,23,24,25,26,27],[],[],{"casks":359,"formulae":360},[],[],{"arch":362,"casks":363,"formulae":364,"macos":49,"requirements":365},[45],[],[],{"macos":366},{">=":367},[53],"arm64_ventura",{"arch":46,"artifacts":370,"conflictsWith":385,"dependsOn":388,"downloadSha256":58,"downloadUrl":60,"macos":53,"minMacos":53,"requiresRosetta":36,"tag":395,"version":90},{"apps":371,"binaries":372,"entries":373,"pkgs":384},[7],[],[374,378],{"declaration":375,"phase":14,"sources":377,"target":13,"type":16},{"app":376,"target":13},[7],[7],{"declaration":379,"phase":28,"sources":383,"type":30},{"zap":380},[381],{"trash":382},[22,23,24,25,26,27],[],[],{"casks":386,"formulae":387},[],[],{"arch":389,"casks":390,"formulae":391,"macos":49,"requirements":392},[46],[],[],{"macos":393},{">=":394},[53],"monterey",{"arch":45,"artifacts":397,"conflictsWith":412,"dependsOn":415,"downloadSha256":58,"downloadUrl":60,"macos":53,"minMacos":53,"requiresRosetta":36,"tag":422,"version":90},{"apps":398,"binaries":399,"entries":400,"pkgs":411},[7],[],[401,405],{"declaration":402,"phase":14,"sources":404,"target":13,"type":16},{"app":403,"target":13},[7],[7],{"declaration":406,"phase":28,"sources":410,"type":30},{"zap":407},[408],{"trash":409},[22,23,24,25,26,27],[],[],{"casks":413,"formulae":414},[],[],{"arch":416,"casks":417,"formulae":418,"macos":49,"requirements":419},[45],[],[],{"macos":420},{">=":421},[53],"arm64_monterey",{"icon":35,"machineTranslated":36,"name":37,"slug":38,"sourceLocale":39},70,20,{"brewLag":427,"cadence":431,"count30d":429},{"compared":428,"earlierCount":429,"medianMinutes":430},3,2,-60,"weekly",[433],{"caption":434,"height":435,"machineTranslated":36,"sourceLocale":85,"theme":436,"thumbUrl":437,"url":438,"width":439},"Official4.0 interface example: provider cards, Direct\u002FRouting\u002FAggregation modes and sidebar tools on macOS.",849,"light","https:\u002F\u002Fcdn.opennavo.com\u002Fscreenshots\u002Fuploads\u002Fscreenshot\u002F58d0a56b0693\u002Fe72030ed8aa4-640.png","https:\u002F\u002Fcdn.opennavo.com\u002Fscreenshots\u002Fuploads\u002Fscreenshot\u002F58d0a56b0693\u002Fe72030ed8aa4-1280.png",1280,"https:\u002F\u002Fgithub.com\u002Fhomebrew\u002Fhomebrew-cask\u002Fblob\u002FHEAD\u002FCasks\u002Fc\u002Fcc-switch.rb","Desktop manager for AI coding-tool providers, local routing, model aggregation, MCP, skills, prompts, sessions and usage.",{"locale":85,"machineTranslated":36,"sourceLocale":85,"status":89},{"arm64":32,"requiresRosetta":36,"status":444,"x86_64":32},"known",[57,446,447,448],"MCP","Tauri","MIT","homebrew\u002Fcask",null,[452,463,474,485,496],{"accentColor":453,"autoUpdates":36,"deprecated":36,"disabled":36,"displayName":454,"editorChoice":36,"iconUrl":455,"installs30d":456,"isFont":36,"isLibrary":36,"kind":69,"machineTranslated":36,"name":454,"primaryCategory":457,"rank30d":458,"sourceLocale":85,"summary":459,"token":460,"version":461,"versionChangedAt":462},"#478CC0","Godot Engine","https:\u002F\u002Fcdn.opennavo.com\u002Ficons\u002Fuploads\u002Fcc881332ee52\u002F5ed650bf42ef-256.png",4196,{"icon":35,"machineTranslated":36,"name":37,"slug":38,"sourceLocale":39},49,"Free open-source2D and3D game engine with a scene-based editor, GDScript, animation, physics and exports for supported desktop, mobile and web targets.","godot","4.7.2","2026-10-07T09:38:36.653349Z",{"accentColor":464,"autoUpdates":32,"deprecated":36,"disabled":36,"displayName":465,"editorChoice":36,"iconUrl":466,"installs30d":467,"isFont":36,"isLibrary":36,"kind":69,"machineTranslated":36,"name":465,"primaryCategory":468,"rank30d":469,"sourceLocale":85,"summary":470,"token":471,"version":472,"versionChangedAt":473},"#3A8CF3","Google Antigravity CLI","https:\u002F\u002Fcdn.opennavo.com\u002Ficons\u002Fuploads\u002F44e2199f65e2\u002F70b10d3ffca5-256.png",3959,{"icon":35,"machineTranslated":36,"name":37,"slug":38,"sourceLocale":39},51,"Google’s terminal coding agent for code exploration, multi-file changes, custom agents and connected tools, with interactive and remote workflows.","antigravity-cli","1.3.1,4582356770750464","2026-10-07T09:38:25.801627Z",{"accentColor":475,"autoUpdates":32,"deprecated":36,"disabled":36,"displayName":476,"editorChoice":36,"iconUrl":477,"installs30d":478,"isFont":36,"isLibrary":36,"kind":69,"machineTranslated":36,"name":476,"primaryCategory":479,"rank30d":480,"sourceLocale":85,"summary":481,"token":482,"version":483,"versionChangedAt":484},"#FE981F","Sublime Text","https:\u002F\u002Fcdn.opennavo.com\u002Ficons\u002Fuploads\u002Fe0a5324f805b\u002F6d58dec42623-256.png",3052,{"icon":35,"machineTranslated":36,"name":37,"slug":38,"sourceLocale":39},67,"Fast desktop text and source-code editor with multiple selections, project navigation, syntax highlighting, build-system integration and Python-based extensions.","sublime-text","4215","2026-10-07T09:38:42.722922Z",{"accentColor":486,"autoUpdates":32,"deprecated":36,"disabled":36,"displayName":487,"editorChoice":36,"iconUrl":488,"installs30d":489,"isFont":36,"isLibrary":36,"kind":69,"machineTranslated":36,"name":487,"primaryCategory":490,"rank30d":491,"sourceLocale":85,"summary":492,"token":493,"version":494,"versionChangedAt":495},"#F2A642","Bruno","https:\u002F\u002Fcdn.opennavo.com\u002Ficons\u002Fuploads\u002Fce3abc10a723\u002F6ae4effc8ebf-256.png",2626,{"icon":35,"machineTranslated":36,"name":37,"slug":38,"sourceLocale":39},76,"Local-first desktop API client for REST, GraphQL and gRPC testing, with file-based collections that fit Git workflows.","bruno","4.2.1","2026-10-07T09:38:27.243348Z",{"accentColor":497,"autoUpdates":32,"deprecated":36,"disabled":36,"displayName":498,"editorChoice":36,"iconUrl":499,"installs30d":500,"isFont":36,"isLibrary":36,"kind":69,"machineTranslated":36,"name":498,"primaryCategory":501,"rank30d":502,"sourceLocale":85,"summary":503,"token":504,"version":505,"versionChangedAt":495},"#1D1C15","Cursor","https:\u002F\u002Fcdn.opennavo.com\u002Ficons\u002Fuploads\u002F267649be4d2a\u002F32bba5039af7-256.png",3391,{"icon":35,"machineTranslated":36,"name":37,"slug":38,"sourceLocale":39},59,"AI coding environment combining an editor with agents that search a codebase, plan changes, edit files and run project tools.","cursor","3.23.23,2dac2428994fe34f12658d9ecad1541b98db2c04","\u003Cp>CC Switch is an open-source desktop configuration manager for AI coding tools. It helps developers maintain provider endpoints, credentials, models, MCP servers, skills, prompts, sessions and usage from one interface. It does not itself supply an AI model subscription or replace the coding clients it manages.\u003C\u002Fp>\n\u003Ch3 class=\"on-md-heading-1\">Features\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Switch provider connection fields while preserving unrelated client configuration.\u003C\u002Fli>\n\u003Cli>Choose Direct connections, local Routing with conversion\u002Ffailover, or model-based Aggregation for supported clients. Aggregation does not provide failover.\u003C\u002Fli>\n\u003Cli>Manage Claude Code, Claude Desktop, Codex, Gemini CLI, Grok Build, OpenCode, OpenClaw, Hermes, Pi and MiniMax Code; individual integrations differ.\u003C\u002Fli>\n\u003Cli>Synchronize supported MCP and skill configurations and edit tool-specific prompts.\u003C\u002Fli>\n\u003Cli>Read session steps, tool results and changes, search\u002Fexport conversations and resume supported sessions.\u003C\u002Fli>\n\u003Cli>Inspect request usage, estimated costs, provider quotas and account information where integrations support them.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3 class=\"on-md-heading-1\">Installation and requirements\u003C\u002Fh3>\n\u003Cp>Install the recorded Mac cask with \u003Ccode>brew install --cask cc-switch\u003C\u002Fcode>, or download the official DMG, open it and copy CC Switch to Applications. The official Mac build is universal for Apple Silicon and Intel, requires macOS12 or later, and is signed\u002Fnotarized according to the maintainer. The cask lists no extra formula dependencies or explicit conflicts. Configure a provider or import supported existing configuration, then select the intended mode. The managed coding tools have their own installation, runtime, permissions and account requirements.\u003C\u002Fp>\n\u003Cp>The maintainer also supplies Windows10+ packages (including ARM builds) and Linux x86_64\u002FARM64 builds. Linux requires glibc2.35+ and WebKitGTK4.1, for example Ubuntu22.04+ or Debian12+; RHEL\u002FRocky\u002FAlma8–9 are not supported by the stated release requirements. No supported mobile edition was confirmed. RAM and installed disk minimums were not published in the cited guide. The verified4.0.4 Mac DMG is33,926,314bytes; that is download size, not installation footprint.\u003C\u002Fp>\n\u003Ch3 class=\"on-md-heading-1\">Compatibility and upgrades\u003C\u002Fh3>\n\u003Cp>Routing and Aggregation depend on the local gateway and upstream protocol support. Claude Code Aggregation needs Claude Code2.1.243 or newer. Restart Codex, Gemini CLI and Grok Build when prompted after switching; Claude Code aggregation changes apply without a restart. WSL networking has separate localhost requirements.\u003C\u002Fp>\n\u003Cp>Version4.0 changes how settings are preserved and removes common configuration snippets. It migrates the database to schema20 and automatically creates a database backup in \u003Ccode>~\u002F.cc-switch\u002Fbackups\u002F\u003C\u002Fcode>; a3.x client cannot open the new database. Review the official upgrade notes before downgrading or changing existing setups. Existing provider presets are not silently replaced with new defaults.\u003C\u002Fp>\n\u003Ch3 class=\"on-md-heading-1\">Accounts, cost and license\u003C\u002Fh3>\n\u003Cp>CC Switch is released under MIT (copyright Jason Young) and can be used without buying a CC Switch subscription. Each AI provider has separate authentication, subscription\u002FAPI charges and service conditions. API keys and account credentials are needed for the relevant provider operations; request-cost estimates are not invoices. Configuration and session data are stored locally by default under \u003Ccode>~\u002F.cc-switch\u003C\u002Fcode>. Cloud\u002FWebDAV synchronization and relay endpoints introduce their own account and data-handling choices.\u003C\u002Fp>\n\u003Cp>Sources: \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\" target=\"_blank\" rel=\"noopener noreferrer\">Official project and requirements\u003C\u002Fa>, \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002Fdocs\u002Frelease-notes\u002Fv4.0.4-en.md\" target=\"_blank\" rel=\"noopener noreferrer\">4.0.4 English release notes\u003C\u002Fa>, \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch\u002Fblob\u002Fmain\u002FLICENSE\" target=\"_blank\" rel=\"noopener noreferrer\">License\u003C\u002Fa>.\u003C\u002Fp>\n"]