删除 ~/.codex/cc-switch.db 后仍然报错启动失败怎么办？

请确保同时检查并清理 Windows 宿主机下的配置目录（如 C:\Users\ \.cc-switch\cc-switch.db），并彻底关闭所有 cc-switch 进程后再执行删除操作。

为什么在 UI 界面上看不到这条导致报错的残留记录？

因为前端状态在执行删除操作时已将其移除，但底层数据库未正确同步清理，导致 UI 与数据库实际状态不一致。

Quick fix

关闭程序，手动清理 cc-switch.db 中 base_url 为空的残留记录，或直接删除该数据库文件后重启。

报错原文

报.codex下的cc-switch.db出错，然后启动cc-switch失败。

在编辑或删除 Provider 配置时，由于状态同步异常，数据库 cc-switch.db 中可能会残留 base_url 等关键字段为空的无效 Provider 记录。代理启动时读取到该异常记录会覆盖正确配置并直接抛出配置错误。由于前端 UI 已移除该记录，用户无法通过界面直接修复。

完全关闭 CC Switch 应用程序及其后台进程。
找到数据库文件 ~/.cc-switch/cc-switch.db（Windows 下为 C:\Users\<用户名>\.cc-switch\cc-switch.db，部分环境可能在 ~/.codex/cc-switch.db）。
使用 SQLite 工具打开并删除 base_url 为空的异常记录，或者直接删除整个 cc-switch.db 文件。
重新打开 CC Switch，重新配置 Provider。

Toolcc-switch

Version未知

PlatformsWindowsmacOSLinux

本页汇总自 1 个真实 issue

删除 ~/.codex/cc-switch.db 后仍然报错启动失败怎么办？: 请确保同时检查并清理 Windows 宿主机下的配置目录（如 C:\Users\<用户名>\.cc-switch\cc-switch.db），并彻底关闭所有 cc-switch 进程后再执行删除操作。
为什么在 UI 界面上看不到这条导致报错的残留记录？: 因为前端状态在执行删除操作时已将其移除，但底层数据库未正确同步清理，导致 UI 与数据库实际状态不一致。