跳转到内容
CC Switch WikiUnofficial Community Wiki

检测到系统环境变量冲突，CC Switch 界面被遮挡

Quick fix

升级到 4.0 或更新版本，环境变量冲突提示会改为页面横幅，并提供关闭和查看冲突变量的操作。

Symptom

Section titled “Symptom”
报错原文
打开软件就会这样，卡在设置里面

Cause

Section titled “Cause”

系统环境变量（例如 `OPENAI_API_KEY`）会覆盖 CC Switch 的配置，因此软件会显示冲突提示。3.x 中提示以窗口顶部浮层显示，可能挡住页面内容；维护者说明 4.0 重做界面后改为页面内横幅，并提供关闭按钮及展开查看、删除冲突变量的操作。

Fix

Section titled “Fix”

  1. 从 CC Switch Releases 页面获取最新版并升级；维护者建议在最新版确认问题是否仍然存在。

  2. 升级后若仍无法关闭提示或操作，请在 issue 中提供 CC Switch 版本号、系统信息，最好附上截图。

Affected Versions

Section titled “Affected Versions”
ToolCodex、其他应用（具体工具未说明）
Version3.15.0（受影响）；维护者称 4.0 已调整提示交互
PlatformsWindows

Source Issues

Section titled “Source Issues”

本页汇总自 1 个真实 issue

FAQ

Section titled “FAQ”

（暂无 FAQ）

相关问题

Section titled “相关问题”
供应商 API Key 被覆盖：Codex 重启或切换后升级到 cc-switch v4.0.0 或更高版本；该版本重写了切换逻辑，避免供应商密钥互相覆盖并恢复官方登录态。6 issues merged提示INVALID_API_KEY，Codex 切换供应商后认证不匹配升级至 v3.20.1 或更高版本；维护者称第三方切换不再写入 auth.json，避免供应商密钥与认证配置错配。5 issues merged输出ANTHROPIC_BASE_URL的值为什么是空的？ Claude Code这是正常现象：CC Switch 不会向 shell 注入变量，请直接查看 `~/.claude/settings.json` 中的当前配置。1 issues merged

这是一个非官方社区 wiki，与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。