CC Switch 故障排查完全指南从启动失败到数据恢复12 个常见故障一次搞定【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switchCC Switch 是一款跨平台桌面管理助手让你在一个窗口里统一管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等 AI 编程工具的供应商配置。如果你正遇到应用打不开、切换不生效或代理异常这篇文章按排障场景的顺序带你逐一定位读完之后绝大多数常见故障你都能自己解决。 动手排障前的 30 秒自检很多问题在动手改配置之前就已经有答案了。先花 30 秒对照下面这张清单确认基础条件都在系统满足最低要求Windows 10 及以上、macOS 12 及以上或 Linux x64/ARM64应用是最新版本在「设置 → 关于」里可以核对已安装 Node.js 18 LTS 或更高版本CLI 工具运行需要目标工具Claude Code、Codex、Gemini CLI 等已装好并能在命令行正常运行网络能访问供应商的 API 端点可先用应用内速度测试验证Linux 用户AppImage 已添加执行权限只要有一项不满足先补上再谈排障——相当一部分玄学问题到这一步就消失了。️ 打不开 / 没反应 / 显示异常类问题点击 Windows 图标后没有任何反应症状识别双击桌面或开始菜单的图标既没有窗口也没有报错任务管理器里可能连进程都看不到。原因最常见的是缺少 WebView2 运行时其次是杀毒软件把安装器拦掉了。解决安装 Microsoft Edge WebView2 运行时微软官网可下载把 CC Switch 加入杀毒软件白名单如果装的是 MSI 版本且双击无反应右键文件 →「属性」→「常规」勾选「解除锁定」后再运行重新启动应用若仍未解决下一步换绿色免安装版Portable直接运行解压目录下的CC-Switch.exe绕开安装器环节。Linux 下 AppImage 无法启动症状识别在终端里执行./CC-Switch-*.AppImage提示权限被拒绝或者双击文件没有反应。原因从 Releases 下载的 AppImage 默认不带执行权限。解决给文件添加执行权限chmod x CC-Switch-*.AppImage重新运行如果报沙箱相关错误加参数启动./CC-Switch-*.AppImage --no-sandbox预防提示下载新版本后先确认扩展名没有被下载工具篡改再执行上述步骤。若仍未解决按下一节的显示异常症状继续排查。窗口能开但内容点不动缩放后黑屏症状识别主界面标题栏的最小化、关闭按钮能点但网页内容区完全无响应最大化再还原后窗口变黑。几乎都出现在 Wayland 会话加 NVIDIA 显卡的组合上。原因AppImage 的启动钩子默认强制走 XWayland 后端在较新的 Wayland NVIDIA 环境下网页内容会收不到鼠标事件。解决用环境变量切回原生 Wayland 启动CC_SWITCH_GDK_BACKENDwayland ./CC-Switch-*.AppImage如果习惯从桌面图标启动把该变量写进.desktop文件的Exec行例如env CC_SWITCH_GDK_BACKENDwayland /path/to/AppImage在 sway、Hyprland 这类 tiling 合成器上若反过来出现点不动则改设CC_SWITCH_GDK_BACKENDx11若仍未解决记录你的发行版、桌面环境和显卡型号按文末求助一节提交问题。系统托盘图标不显示症状识别主界面能正常打开但任务栏或菜单栏找不到 CC Switch 的小图标没法快速切换供应商。原因托盘图标受系统设置控制Linux 上还可能缺托盘支持库。解决macOS检查「系统设置 → 控制中心 → 菜单栏」确认图标未被隐藏Windows打开「任务栏设置 → 选择哪些图标显示在任务栏」把 CC Switch 设为显示图标和通知LinuxUbuntu/Debian安装托盘支持库sudo apt install libappindicator3-1若仍未解决下一步确认进程是否真的在运行——若进程已退出回到本节第一条重新安装运行时。⚙️ 配置成功却不生效类问题切换供应商的本质是 CC Switch 改写各 CLI 工具的配置文件。各工具读取配置的时机不同这是理解不生效的关键工具生效时机切换后你需要做Claude Code即时生效支持配置热重载无需操作Gemini CLI即时生效每次请求重读.env无需操作Codex启动时读取不热更新关闭并重新打开终端点了启用CLI 还在用旧供应商症状识别供应商卡片已经变成蓝色当前启用状态但终端里的请求明显还发往旧地址。原因多数情况是生效时机问题——尤其是 Codex 必须重启终端才会读新配置。解决确认目标卡片确实显示当前启用Codex 用户关闭当前终端窗口并重新打开Claude Code 和 Gemini CLI 则直接发一条测试消息用文本编辑器打开对应配置文件确认内容已被改写例如 Claude 是~/.claude/settings.json中的ANTHROPIC_API_KEY与ANTHROPIC_BASE_URL文件没变说明切换本身失败检查界面是否有报错提示若仍未解决下一步看界面顶部有没有黄色警告横幅按下一条处理。界面顶部出现黄色环境变量冲突横幅症状识别横幅提示检测到若干环境变量可能与 CC Switch 配置冲突展开能看到变量名、值和来源。原因系统环境变量的优先级通常高于配置文件。比如你手动导出过ANTHROPIC_API_KEY它会一直盖掉 CC Switch 写入的配置让你觉得怎么切都不对。解决点击横幅的「展开」逐个查看冲突变量及其来源勾选确实不需要的变量点击「删除选中」——应用会自动备份到~/.cc-switch/env-backups/再删除重新打开终端验证配置已按卡片状态生效重要提示不确定的变量先别删备份文件里保留了名称、值和来源随时可以找回。若误删下一步打开~/.cc-switch/env-backups/中的 JSON 文件手动恢复。切换失败提示配置文件被占用或权限不足症状识别点击「启用」后没有切换成功界面提示写入失败。原因其他程序正锁着配置文件或当前账户没有写入配置目录的权限。解决完全退出正在运行的对应 CLI 工具包括 IDE 里挂着的实例重新点击「启用」仍失败则检查配置目录权限必要时以有权限的账户运行若仍未解决下一步到「设置 → 高级」里核对自定义的配置目录是否指向了正确位置。想切回官方登录却还在走第三方端点症状识别选中了官方登录预设并点了启用CLI 仍按第三方供应商请求。原因官方登录需要走 CLI 自带的授权流程而旧会话还持有第三方配置。解决启用「官方登录」预设Gemini 对应「Google 官方」重启对应 CLI 工具按官方流程完成登录发一条测试请求确认第三方供应商配置会原样保留之后随时可以切回去不需要重新填写。若仍未解决下一步检查是否又命中了环境变量冲突横幅。️ 代理与故障转移不工作代理服务启动失败提示端口被占用症状识别打开主界面顶部的代理开关状态立刻闪回未运行或日志里出现Address already in use。原因默认监听端口15721已被别的程序占走。解决查出占用者lsof -i :15721Windows 上用netstat -ano | findstr :15721 2. 关闭该程序再打开代理开关 3. 或者在「设置 → 高级 → 代理服务」里换端口——注意修改前必须先停止代理 4. 重新启动代理确认开关保持绿色若仍未解决下一步检查本机防火墙是否拦截了 127.0.0.1 的本地端口。故障转移一次都没有触发症状识别主供应商明明连续报错CC Switch 却没有切换到队列里的备用供应商。原因故障转移有 4 个前提条件缺任何一条都不会触发。解决按顺序核对代理服务是否正在运行开关为绿色应用接管是否开启接管后各应用端点才会指向本地代理「自动故障转移」开关是否打开关闭时只记录失败、不切换队列里是否真的有备用供应商在「设置 → 高级 → 故障转移」中查看若仍未解决下一步打开「设置 → 用量」里的请求日志看失败到底发生在哪一段。供应商频繁切换或者全部变红症状识别卡片上的健康徽章反复在黄、红之间跳动或所有供应商都显示熔断。原因主供应商不稳定或熔断器阈值设得偏紧——默认失败阈值是连续失败 4 次触发熔断、60 秒后尝试恢复Claude 的默认值更宽松8 次 / 90 秒。解决查看请求日志确认失败是集中在单个供应商还是普遍网络问题在「故障转移」页面调高失败阈值、延长恢复等待时间若所有供应商都熔断了等待恢复时间到期自动探测或重启代理服务直接重置状态若仍未解决说明主供应商本身质量不佳建议把它移出队列首位、换更稳定的供应商当主。用量统计页面一片空白症状识别「设置 → 用量」里没有请求数、Token 和费用图表全空。原因数据没有来源——代理日志需要代理、应用接管、日志记录三者同时开启而 v3.13 起还可以直接扫描 CLI 会话日志不依赖代理。解决确认代理运行中、应用接管已开启、代理面板里「启用日志」为开通过代理发一条测试请求再看用量页是否出现记录不想开代理的话确认在 CC Switch 中启用了对应应用让应用定期扫描 CLI 会话日志导入用量若仍未解决下一步检查供应商卡片上的配额刷新与会话已过期提示必要时重新登录认证。关闭代理后CLI 端点没有恢复症状识别代理开关已关但 Claude 或 Codex 的端点还指向127.0.0.1:15721请求直接失败。原因代理异常退出时跳过正常的恢复应用配置流程。解决编辑当前供应商核对端点地址是否指向正确的真实地址保存让 CC Switch 重新写入配置文件重启对应 CLI 工具若仍未解决下一步彻底退出并重启 CC Switch再正常开启、关闭一次代理触发完整的恢复流程。 数据、配置与备份类问题供应商配置全部消失了症状识别启动后发现列表为空或~/.cc-switch/目录整个不见了。原因配置目录被误删或数据库文件损坏。解决确认~/.cc-switch/是否存在主数据库是其中的cc-switch.db设备级设置是settings.json查看~/.cc-switch/backups/目录——应用每次导入前会自动创建备份并保留最近 10 个文件名带时间戳在「设置 → 高级 → 数据管理」中选择最新的备份或导出文件进行恢复重启应用确认供应商列表回来了若仍未解决下一步携带日志文件按文末求助一节提交并说明配置目录的当前状态。导入配置文件报错症状识别选择了之前保存的文件导入却提示失败。原因文件不是 CC Switch 导出的标准备份或版本过旧、内容不完整。解决确认文件确实来自 CC Switch 的「导出」功能而不是手动复制的零散 JSON用文本编辑器打开检查内容是否完整、格式是否合法仍失败则退而求其次在新设备上手动重新添加供应商或用云同步方式拉取若仍未解决下一步回到源设备重新执行一次导出避免使用中途失败的旧文件。换新设备想带着全部配置迁移症状识别新机器上从零配供应商太麻烦希望一次搬完。原因配置集中在~/.cc-switch/下导出文件包含所有供应商、MCP 服务器、提示词预设和应用设置不含用量日志和设备级设置跨设备迁移走导出/导入即可。解决在源设备「设置 → 高级 → 数据管理」点「导出」把文件存到安全位置在目标设备导入该文件多台设备长期使用时开启 WebDAV 自动同步避免每次手动搬运预防提示养成定期导出的习惯重要供应商变更如更换 API Key后立刻导出一次。若同步出现冲突副本手动保留两者内容合并即可。 性能与体验优化开轻量模式从托盘菜单切换到轻量模式后主窗口和 Web 视图会被销毁只保留托盘功能内存占用明显下降适合常驻后台。定期清理删掉不再使用的供应商配置、精简请求日志列表渲染和启动都会更快。按需开日志不排查问题时可以先关闭代理日志记录减少磁盘写入和统计开销。 仍无法解决高效求助日志在哪里默认在~/.cc-switch/logs/下主日志是cc-switch.log按 20 MB 轮转、保留最近 4 个归档崩溃问题看crash.log及crash.log.1、crash.log.2。Windows 路径为C:\Users\用户名\.cc-switch\...。如果改过自定义配置目录以自定义目录为准。提交 Issue 时附上操作系统及版本、CC Switch 版本号问题描述与可复现步骤相关日志片段和错误截图——日志可能包含运行环境信息公开贴出前先扫一眼内容你已尝试过的排查步骤方便对方跳过已验证的方向去哪找答案仓库里的docs/user-manual/目录有完整的分语言用户手册其中 FAQ 章节覆盖了安装、供应商、代理、数据等全部类别CHANGELOG.md可以确认某个问题是否已在最新版本修复。提交前先搜索既有 Issue同样的问题往往已经有答案。 常见症状速查表症状最可能原因首选解决动作Windows 点图标没反应缺 WebView2 运行时或被杀毒拦截安装运行时并加入白名单AppImage 无法执行缺少执行权限chmod x后再运行Wayland NVIDIA 下点不动被强制走 XWayland 后端CC_SWITCH_GDK_BACKENDwayland启动托盘图标不显示系统托盘设置或依赖缺失检查任务栏设置 / 安装托盘库Codex 切换后不生效终端未重启关闭并重开终端顶部黄色冲突横幅系统环境变量覆盖了配置展开横幅删除冲突变量代理启动失败端口 15721 被占用查占用进程并关闭或换端口故障转移不触发4 个前提条件缺一项依次核对代理、接管、自动开关、队列用量统计为空日志数据源未开启开代理 接管 日志或启用会话日志扫描关闭代理后端点没恢复代理异常退出跳过恢复流程编辑当前供应商并保存重写配置配置全部丢失配置目录被删从~/.cc-switch/backups/恢复导入文件失败非标准备份文件确认来自 CC Switch 导出功能【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 CC Switch 故障排查完全指南：从启动失败到数据恢复，12 个常见故障一次搞定
CC Switch 故障排查完全指南从启动失败到数据恢复12 个常见故障一次搞定【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switchCC Switch 是一款跨平台桌面管理助手让你在一个窗口里统一管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等 AI 编程工具的供应商配置。如果你正遇到应用打不开、切换不生效或代理异常这篇文章按排障场景的顺序带你逐一定位读完之后绝大多数常见故障你都能自己解决。 动手排障前的 30 秒自检很多问题在动手改配置之前就已经有答案了。先花 30 秒对照下面这张清单确认基础条件都在系统满足最低要求Windows 10 及以上、macOS 12 及以上或 Linux x64/ARM64应用是最新版本在「设置 → 关于」里可以核对已安装 Node.js 18 LTS 或更高版本CLI 工具运行需要目标工具Claude Code、Codex、Gemini CLI 等已装好并能在命令行正常运行网络能访问供应商的 API 端点可先用应用内速度测试验证Linux 用户AppImage 已添加执行权限只要有一项不满足先补上再谈排障——相当一部分玄学问题到这一步就消失了。️ 打不开 / 没反应 / 显示异常类问题点击 Windows 图标后没有任何反应症状识别双击桌面或开始菜单的图标既没有窗口也没有报错任务管理器里可能连进程都看不到。原因最常见的是缺少 WebView2 运行时其次是杀毒软件把安装器拦掉了。解决安装 Microsoft Edge WebView2 运行时微软官网可下载把 CC Switch 加入杀毒软件白名单如果装的是 MSI 版本且双击无反应右键文件 →「属性」→「常规」勾选「解除锁定」后再运行重新启动应用若仍未解决下一步换绿色免安装版Portable直接运行解压目录下的CC-Switch.exe绕开安装器环节。Linux 下 AppImage 无法启动症状识别在终端里执行./CC-Switch-*.AppImage提示权限被拒绝或者双击文件没有反应。原因从 Releases 下载的 AppImage 默认不带执行权限。解决给文件添加执行权限chmod x CC-Switch-*.AppImage重新运行如果报沙箱相关错误加参数启动./CC-Switch-*.AppImage --no-sandbox预防提示下载新版本后先确认扩展名没有被下载工具篡改再执行上述步骤。若仍未解决按下一节的显示异常症状继续排查。窗口能开但内容点不动缩放后黑屏症状识别主界面标题栏的最小化、关闭按钮能点但网页内容区完全无响应最大化再还原后窗口变黑。几乎都出现在 Wayland 会话加 NVIDIA 显卡的组合上。原因AppImage 的启动钩子默认强制走 XWayland 后端在较新的 Wayland NVIDIA 环境下网页内容会收不到鼠标事件。解决用环境变量切回原生 Wayland 启动CC_SWITCH_GDK_BACKENDwayland ./CC-Switch-*.AppImage如果习惯从桌面图标启动把该变量写进.desktop文件的Exec行例如env CC_SWITCH_GDK_BACKENDwayland /path/to/AppImage在 sway、Hyprland 这类 tiling 合成器上若反过来出现点不动则改设CC_SWITCH_GDK_BACKENDx11若仍未解决记录你的发行版、桌面环境和显卡型号按文末求助一节提交问题。系统托盘图标不显示症状识别主界面能正常打开但任务栏或菜单栏找不到 CC Switch 的小图标没法快速切换供应商。原因托盘图标受系统设置控制Linux 上还可能缺托盘支持库。解决macOS检查「系统设置 → 控制中心 → 菜单栏」确认图标未被隐藏Windows打开「任务栏设置 → 选择哪些图标显示在任务栏」把 CC Switch 设为显示图标和通知LinuxUbuntu/Debian安装托盘支持库sudo apt install libappindicator3-1若仍未解决下一步确认进程是否真的在运行——若进程已退出回到本节第一条重新安装运行时。⚙️ 配置成功却不生效类问题切换供应商的本质是 CC Switch 改写各 CLI 工具的配置文件。各工具读取配置的时机不同这是理解不生效的关键工具生效时机切换后你需要做Claude Code即时生效支持配置热重载无需操作Gemini CLI即时生效每次请求重读.env无需操作Codex启动时读取不热更新关闭并重新打开终端点了启用CLI 还在用旧供应商症状识别供应商卡片已经变成蓝色当前启用状态但终端里的请求明显还发往旧地址。原因多数情况是生效时机问题——尤其是 Codex 必须重启终端才会读新配置。解决确认目标卡片确实显示当前启用Codex 用户关闭当前终端窗口并重新打开Claude Code 和 Gemini CLI 则直接发一条测试消息用文本编辑器打开对应配置文件确认内容已被改写例如 Claude 是~/.claude/settings.json中的ANTHROPIC_API_KEY与ANTHROPIC_BASE_URL文件没变说明切换本身失败检查界面是否有报错提示若仍未解决下一步看界面顶部有没有黄色警告横幅按下一条处理。界面顶部出现黄色环境变量冲突横幅症状识别横幅提示检测到若干环境变量可能与 CC Switch 配置冲突展开能看到变量名、值和来源。原因系统环境变量的优先级通常高于配置文件。比如你手动导出过ANTHROPIC_API_KEY它会一直盖掉 CC Switch 写入的配置让你觉得怎么切都不对。解决点击横幅的「展开」逐个查看冲突变量及其来源勾选确实不需要的变量点击「删除选中」——应用会自动备份到~/.cc-switch/env-backups/再删除重新打开终端验证配置已按卡片状态生效重要提示不确定的变量先别删备份文件里保留了名称、值和来源随时可以找回。若误删下一步打开~/.cc-switch/env-backups/中的 JSON 文件手动恢复。切换失败提示配置文件被占用或权限不足症状识别点击「启用」后没有切换成功界面提示写入失败。原因其他程序正锁着配置文件或当前账户没有写入配置目录的权限。解决完全退出正在运行的对应 CLI 工具包括 IDE 里挂着的实例重新点击「启用」仍失败则检查配置目录权限必要时以有权限的账户运行若仍未解决下一步到「设置 → 高级」里核对自定义的配置目录是否指向了正确位置。想切回官方登录却还在走第三方端点症状识别选中了官方登录预设并点了启用CLI 仍按第三方供应商请求。原因官方登录需要走 CLI 自带的授权流程而旧会话还持有第三方配置。解决启用「官方登录」预设Gemini 对应「Google 官方」重启对应 CLI 工具按官方流程完成登录发一条测试请求确认第三方供应商配置会原样保留之后随时可以切回去不需要重新填写。若仍未解决下一步检查是否又命中了环境变量冲突横幅。️ 代理与故障转移不工作代理服务启动失败提示端口被占用症状识别打开主界面顶部的代理开关状态立刻闪回未运行或日志里出现Address already in use。原因默认监听端口15721已被别的程序占走。解决查出占用者lsof -i :15721Windows 上用netstat -ano | findstr :15721 2. 关闭该程序再打开代理开关 3. 或者在「设置 → 高级 → 代理服务」里换端口——注意修改前必须先停止代理 4. 重新启动代理确认开关保持绿色若仍未解决下一步检查本机防火墙是否拦截了 127.0.0.1 的本地端口。故障转移一次都没有触发症状识别主供应商明明连续报错CC Switch 却没有切换到队列里的备用供应商。原因故障转移有 4 个前提条件缺任何一条都不会触发。解决按顺序核对代理服务是否正在运行开关为绿色应用接管是否开启接管后各应用端点才会指向本地代理「自动故障转移」开关是否打开关闭时只记录失败、不切换队列里是否真的有备用供应商在「设置 → 高级 → 故障转移」中查看若仍未解决下一步打开「设置 → 用量」里的请求日志看失败到底发生在哪一段。供应商频繁切换或者全部变红症状识别卡片上的健康徽章反复在黄、红之间跳动或所有供应商都显示熔断。原因主供应商不稳定或熔断器阈值设得偏紧——默认失败阈值是连续失败 4 次触发熔断、60 秒后尝试恢复Claude 的默认值更宽松8 次 / 90 秒。解决查看请求日志确认失败是集中在单个供应商还是普遍网络问题在「故障转移」页面调高失败阈值、延长恢复等待时间若所有供应商都熔断了等待恢复时间到期自动探测或重启代理服务直接重置状态若仍未解决说明主供应商本身质量不佳建议把它移出队列首位、换更稳定的供应商当主。用量统计页面一片空白症状识别「设置 → 用量」里没有请求数、Token 和费用图表全空。原因数据没有来源——代理日志需要代理、应用接管、日志记录三者同时开启而 v3.13 起还可以直接扫描 CLI 会话日志不依赖代理。解决确认代理运行中、应用接管已开启、代理面板里「启用日志」为开通过代理发一条测试请求再看用量页是否出现记录不想开代理的话确认在 CC Switch 中启用了对应应用让应用定期扫描 CLI 会话日志导入用量若仍未解决下一步检查供应商卡片上的配额刷新与会话已过期提示必要时重新登录认证。关闭代理后CLI 端点没有恢复症状识别代理开关已关但 Claude 或 Codex 的端点还指向127.0.0.1:15721请求直接失败。原因代理异常退出时跳过正常的恢复应用配置流程。解决编辑当前供应商核对端点地址是否指向正确的真实地址保存让 CC Switch 重新写入配置文件重启对应 CLI 工具若仍未解决下一步彻底退出并重启 CC Switch再正常开启、关闭一次代理触发完整的恢复流程。 数据、配置与备份类问题供应商配置全部消失了症状识别启动后发现列表为空或~/.cc-switch/目录整个不见了。原因配置目录被误删或数据库文件损坏。解决确认~/.cc-switch/是否存在主数据库是其中的cc-switch.db设备级设置是settings.json查看~/.cc-switch/backups/目录——应用每次导入前会自动创建备份并保留最近 10 个文件名带时间戳在「设置 → 高级 → 数据管理」中选择最新的备份或导出文件进行恢复重启应用确认供应商列表回来了若仍未解决下一步携带日志文件按文末求助一节提交并说明配置目录的当前状态。导入配置文件报错症状识别选择了之前保存的文件导入却提示失败。原因文件不是 CC Switch 导出的标准备份或版本过旧、内容不完整。解决确认文件确实来自 CC Switch 的「导出」功能而不是手动复制的零散 JSON用文本编辑器打开检查内容是否完整、格式是否合法仍失败则退而求其次在新设备上手动重新添加供应商或用云同步方式拉取若仍未解决下一步回到源设备重新执行一次导出避免使用中途失败的旧文件。换新设备想带着全部配置迁移症状识别新机器上从零配供应商太麻烦希望一次搬完。原因配置集中在~/.cc-switch/下导出文件包含所有供应商、MCP 服务器、提示词预设和应用设置不含用量日志和设备级设置跨设备迁移走导出/导入即可。解决在源设备「设置 → 高级 → 数据管理」点「导出」把文件存到安全位置在目标设备导入该文件多台设备长期使用时开启 WebDAV 自动同步避免每次手动搬运预防提示养成定期导出的习惯重要供应商变更如更换 API Key后立刻导出一次。若同步出现冲突副本手动保留两者内容合并即可。 性能与体验优化开轻量模式从托盘菜单切换到轻量模式后主窗口和 Web 视图会被销毁只保留托盘功能内存占用明显下降适合常驻后台。定期清理删掉不再使用的供应商配置、精简请求日志列表渲染和启动都会更快。按需开日志不排查问题时可以先关闭代理日志记录减少磁盘写入和统计开销。 仍无法解决高效求助日志在哪里默认在~/.cc-switch/logs/下主日志是cc-switch.log按 20 MB 轮转、保留最近 4 个归档崩溃问题看crash.log及crash.log.1、crash.log.2。Windows 路径为C:\Users\用户名\.cc-switch\...。如果改过自定义配置目录以自定义目录为准。提交 Issue 时附上操作系统及版本、CC Switch 版本号问题描述与可复现步骤相关日志片段和错误截图——日志可能包含运行环境信息公开贴出前先扫一眼内容你已尝试过的排查步骤方便对方跳过已验证的方向去哪找答案仓库里的docs/user-manual/目录有完整的分语言用户手册其中 FAQ 章节覆盖了安装、供应商、代理、数据等全部类别CHANGELOG.md可以确认某个问题是否已在最新版本修复。提交前先搜索既有 Issue同样的问题往往已经有答案。 常见症状速查表症状最可能原因首选解决动作Windows 点图标没反应缺 WebView2 运行时或被杀毒拦截安装运行时并加入白名单AppImage 无法执行缺少执行权限chmod x后再运行Wayland NVIDIA 下点不动被强制走 XWayland 后端CC_SWITCH_GDK_BACKENDwayland启动托盘图标不显示系统托盘设置或依赖缺失检查任务栏设置 / 安装托盘库Codex 切换后不生效终端未重启关闭并重开终端顶部黄色冲突横幅系统环境变量覆盖了配置展开横幅删除冲突变量代理启动失败端口 15721 被占用查占用进程并关闭或换端口故障转移不触发4 个前提条件缺一项依次核对代理、接管、自动开关、队列用量统计为空日志数据源未开启开代理 接管 日志或启用会话日志扫描关闭代理后端点没恢复代理异常退出跳过恢复流程编辑当前供应商并保存重写配置配置全部丢失配置目录被删从~/.cc-switch/backups/恢复导入文件失败非标准备份文件确认来自 CC Switch 导出功能【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考