macOS cc-switch检测版本错误/卡死 - CC Switch Fix

Quick fix

修改.zshrc中fastfetch调用，添加[[ -t 1 ]]限制非交互式输出。

Symptom

报错原文复制

mac 版本在检查到新版本后，点击按钮更新之后每次都会卡死。

Cause

在 macOS 上，cc-switch 通过执行 `zsh -lic` 来检测工具（如 Codex/Claude Code）的版本。如果用户的 shell 配置文件（如 ~/.zshrc）中包含无条件执行的命令（例如 `fastfetch`），这些命令会在非交互式子 shell 启动时向 stdout 输出额外信息（如系统版本号或 ASCII 艺术图）。

cc-switch 使用正则表达式 `.find()` 获取输出的第一个版本号片段。当 `fastfetch` 等工具先于实际 CLI 工具输出版本号（例如将 macOS 系统版本 `15.7.9` 误判为工具版本）时，前端会认为当前版本高于远程最新版本，导致界面显示“已就绪”且升级按钮计算异常。此外，部分用户反馈在此过程中客户端会出现卡死现象。

Fix

1. 1

   打开终端，编辑你的 zsh 配置文件。

   ~/.zshrc

2. 2

   找到调用 fastfetch（或其他可能输出文本的命令）的行，在其前添加条件判断 `[[ -t 1 ]] &&`，确保它仅在真实终端交互时才执行。

   ~/.zshrc

Affected Versions

ToolClaude Code / Codex / Gemini CLI

Version3.16.2 - 3.18.0

PlatformsmacOS

Source Issues

本页汇总自 2 个真实 issue

• #3937mac版本检查错误问题
• #4791MacOS brew upgarde cc-switch reduced version

FAQ

为什么其他平台没有这个问题？

该问题主要源于 macOS 默认的 zsh shell 行为以及特定插件（如 fastfetch）在非交互式环境下的输出干扰。Windows (PowerShell/CMD) 和 Linux 的 shell 环境通常不会以相同方式注入此类元数据到版本检测管道中。

除了 fastfetch，还有其他原因会导致版本检测错误吗？

是的。任何在 ~/.zshrc、~/.bash_profile 或 ~/.profile 中无条件执行并输出包含数字版本号字符串的命令都可能导致此问题。请检查是否有类似 `neofetch`, `screenfetch` 或自定义脚本在启动时输出大量文本。

相关问题

bash: 无法设定终端进程组 cc-switch这是 3.18.0 在 Linux 下检查本地代理环境的已知 Bug，降级到 3.18.0 之前的版本，并直接在终端手动配置代理。5 issues mergedcodex cli 失败：CC Switch将 cc-switch 升级至 v3.16.3 或更高版本即可修复本地环境检测与升级链路的阻塞问题。2 issues mergedCC Switch 开启代理后 Claude Code 报错或模型映射失败先升级到 v3.15.0 以上，再在 cc-switch 中显式配置全局出站代理，避免系统代理被旧进程缓存。21 issues merged