Skip to content
CC Switch WikiUnofficial Community Wiki

This software does not run on macOS versions other than Monterey - CC Switch

Quick fix

Run brew update and retry the install, or download the DMG from GitHub Releases and install it by hand.

Symptom

Section titled “Symptom”
Error output
Error: This software does not run on macOS versions other than Monterey.

Cause

Section titled “Cause”

The error is not a problem in the application code but a metadata mistake in the Homebrew Cask. The Cask definition uses `depends_on macos: :monterey`, which the Homebrew DSL reads as strictly equal to macOS 12 (Monterey), blocking the install for anyone on macOS 13 (Ventura) or newer (macOS 14 Sonoma, macOS 15 Sequoia).

cc-switch actually supports a much wider range of macOS versions. The restriction exists only in the older definitions in the Homebrew Tap (`farion1231/homebrew-ccswitch`) and the official Cask repository. As new versions ship, the Cask metadata should be updated to `>= :monterey` so later versions can install.

Fix

Section titled “Fix”

  1. First update the local Homebrew cache so you get the latest Cask definition, then try the install again.

    终端命令
    brew update
    brew install --cask cc-switch

  2. If it still errors after the update, bypass Homebrew and download the installer directly. Download the .dmg for your version from GitHub Releases and drag it into the Applications folder.

    终端命令：移除隔离属性以便运行
    xattr -rd com.apple.quarantine "/Applications/CC Switch.app"

Affected Versions

Section titled “Affected Versions”
ToolClaude Code
Version3.15.0 - 3.16.2
PlatformsmacOS

Source Issues

Section titled “Source Issues”

This page is distilled from 2 real issues

FAQ

Section titled “FAQ”
Why can my macOS 14 system not install it through brew?
Because the Cask config file wrongly locks the dependency to macOS 12 only. That is a Homebrew metadata problem — the application itself supports macOS 14. Try `brew update`, or install by hand.
After installing by hand it asks for permission or will not open. What now?
macOS marks applications downloaded from the network. Run `xattr -rd com.apple.quarantine "/Applications/CC Switch.app"` in a terminal to clear the quarantine attribute, and it starts normally.
Section titled “Related problems”
Symlink target not found: .DirIcon broken symlink causes - CC SwitchAppImage install fails due to broken .DirIcon symlink. Fix by converting it to a relative path.2 issues mergedversion `GLIBC_2.35' not foundThe official AppImage needs a newer GLIBC. On RHEL/Rocky Linux, use the community Flatpak build or one built on an older base image.2 issues mergedError 2503 - cc-switch MSI install permission deniedRun msiexec from an administrator command prompt, or download the Portable build, to work around the Windows 11 MSI permission restriction.3 issues merged

This is an unofficial community wiki with no affiliation to the cc-switch authors or the project itself. Its content is compiled from the project's public GitHub issues. This site distributes no software.