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

Quick fix

执行 brew update 后重试安装，或手动从 GitHub Releases 下载 DMG 安装。

Symptom

报错原文复制

Error: This software does not run on macOS versions other than Monterey.

Cause

该报错并非应用本身代码问题，而是 Homebrew Cask 的元数据配置错误。Cask 定义文件中使用了 `depends_on macos: :monterey`，在 Homebrew DSL 中这被解析为严格等于 macOS 12 (Monterey)，导致 macOS 13 (Ventura) 及更高版本（如 macOS 14 Sonoma、macOS 15 Sequoia）的用户在安装时被拦截。

实际上 cc-switch 已支持更广泛的 macOS 版本。此限制仅存在于 Homebrew Tap (`farion1231/homebrew-ccswitch`) 和官方 Cask 仓库的旧版定义中。随着新版本发布，Cask 元数据应更新为 `>= :monterey` 以允许后续版本安装。

Fix

1. 1

   首先更新 Homebrew 本地缓存，确保获取最新的 Cask 定义文件，然后重新尝试安装。

   终端命令

   brew update
   brew install --cask cc-switch

2. 2

   如果更新后仍报错，可绕过 Homebrew 直接下载安装包。从 GitHub Releases 下载对应版本的 .dmg 文件并拖入 Applications 文件夹。

   终端命令：移除隔离属性以便运行

   xattr -rd com.apple.quarantine "/Applications/CC Switch.app"

Affected Versions

ToolClaude Code

Version3.15.0 - 3.16.2

PlatformsmacOS

Source Issues

本页汇总自 2 个真实 issue

• #3485安装3.16.0的时候提示版本锁定
• #3957Homebrew cask `depends_on macos: :monterey` blocks install on macOS 13+ (should be `>= :monterey`)

FAQ

为什么我的 macOS 14 系统无法通过 brew 安装？

因为 Cask 配置文件错误地将依赖锁定为仅 macOS 12。这是 Homebrew 元数据问题，应用本身支持 macOS 14。请尝试 `brew update` 或手动安装。

手动安装后提示需要权限或无法打开怎么办？

macOS 会标记从网络下载的应用。请在终端执行 `xattr -rd com.apple.quarantine "/Applications/CC Switch.app"` 清除隔离属性，然后即可正常启动。

相关问题

Symlink target not foundAppImage 安装失败，需手动修复 .DirIcon 符号链接为相对路径。2 issues mergedversion `GLIBC_2.35' not found官方 AppImage 依赖高版本 GLIBC，RHEL/Rocky Linux 用户可改用社区编译的 Flatpak 版本或旧基础镜像构建版。2 issues mergedError 2503 cc-switch MSI 安装权限被拒绝通过管理员权限的命令提示符运行 msiexec 命令，或直接下载 Portable 免安装版来绕过 Windows 11 的 MSI 权限限制。3 issues merged