❓ 常见问题解答

Q:如何更新？

可使用命令更新claude cli：****claude update

可使用命令更新codex cli：codex update

Q.提示 401 / Unauthorized？

• API Key 是否复制完整、账户是否已充值。

• 地址是否与工具类型一致（见第五节地址表）。

• Key 前后是否有多余空格。

Q.Codex 登录失败？

• CC Switch 是否已 应用 SudoBug 配置。

• 是否选了 API Key 登录（不是 ChatGPT 账号密码）。

• Key 是否为 SudoBug 令牌（sk- 开头）。

Q.CC Switch 导入失败？

• 浏览器是否已登录 SudoBug。

• 是否允许浏览器唤起 CC Switch。

• Windows 是否下载了 CC-Switch-v3.15.0-Windows.msi。

Q.Claude Code 连不上？

见 第二节：CC Switch 已应用、编辑器/终端已重启；仍无界面时用命令面板输入 claude。手动配置见第七节：ANTHROPIC_BASE_URL 为 https://us.oarel.com（无 /v1）。

Q.Windows setx / macOS 配置不生效？

关闭终端重新打开，或执行 source ~/.zshrc。

Q.Codex 切换 Provider 后历史会话不见了？

用 CC Switch 或手动改 config.toml 里的 model_provider 后，旧对话在 Codex 桌面版或 /resume 里可能突然看不到。会话文件通常还在，是 rollout、SQLite 线程表、项目路径缓存里的 provider / 可见性元数据不一致。

可用开源工具 codex-provider-sync 同步这些元数据（操作前会自动备份到 ~/.codex/backups_state/provider-sync/）：

• macOS / Linux（CLI）：需 Node.js 24+，然后执行 npm install -g git+https://github.com/Dailin521/codex-provider-sync.git，再运行 codex-provider sync（只同步到当前 provider）或 codex-provider switch <provider-id>（改配置并同步）。可先 codex-provider status 看诊断。

• Windows：在仓库 Releases 下载 CodexProviderSync.exe，打开后 Refresh → 选目标 Provider → Execute。

• 执行前请关闭 Codex / Codex App，避免 state_5.sqlite 被占用；若仍失败，用备份目录执行 codex-provider restore <backup-dir> 恢复。

说明：该工具只恢复列表可见性，不改动对话内容；含 encrypted_content 的会话跨 provider / 账号后，可能仍无法继续对话或 compact。Codex Desktop 项目侧首屏仅显示全局最近 50 条，更早的会话在 CLI /resume 可见、桌面首屏仍可能不显示，属上游限制。