Skip to content
CC Switch WikiUnofficial Community Wiki

Provider Auth cannot be restored when auth.json does not exist - Codex

Quick fix

Upgrading to v3.13.0 resolves Provider Auth failing to restore during multi-device sync when auth.json is missing.

Symptom

Section titled “Symptom”
Error output
因为缺少 auth.json，已有的 provider auth 没有被用来恢复 live auth
English translation

Because auth.json is missing, the existing provider auth was not used to restore the live auth

Cause

Section titled “Cause”

In a multi-device or WebDAV sync scenario, the local ~/.codex/auth.json on a new device often has not been generated yet. Older logic detecting that missing file concluded the auth information was lost and aborted the provider switch or live configuration sync, even though the Provider configuration already held a valid settings_config.auth. Issue #561 also notes that the SQLite and WebDAV caching means the auth.json content in the exported config file is often empty, further worsening the state inconsistency across devices. This was resolved by reworking the provider credential lifecycle and the live sync logic underneath.

Fix

Section titled “Fix”

  1. Upgrade cc-switch to v3.13.0 or newer. The new version reads the existing auth from the Provider configuration and restores the local state automatically.

Affected Versions

Section titled “Affected Versions”
ToolCodex
Versionv3.13.0 之前（v3.13.0 已修复）
PlatformsUnknown

Source Issues

Section titled “Source Issues”

This page is distilled from 2 real issues

FAQ

Section titled “FAQ”
Why is auth.json often empty after syncing through WebDAV?
That is mainly the SQLite caching not flushing the data in time on export, not a WebDAV transfer problem. v3.13.0 improved the sync and cache handling.
Do I still have to create or edit auth.json by hand after upgrading?
No. The fixed flow detects the missing local file and falls back to the settings_config.auth already in the Provider configuration to complete the restore.
Section titled “Related problems”
Atomic replace failed os error 50Change the Claude Code configuration directory from a WSL path back to a Windows local path, or roll back to v3.19.0.1 issues mergedsettings.json overwritten by proxy takeover causing plugin config loss - Claude CodePlace custom fields such as hooks and statusLine into the "General Configuration" panel, or upgrade to v3.12.2+ to fix the legacy backup restore logic.15 issues mergedGeneral config has no effect and gets overwritten by earlier config - Codex CC SwitchUpgrade to CC Switch v3.17.0+ to fix Codex general-config merging. If an old snapshot still overwrites it, switch to another provider and back to self-heal.21 issues merged

This is an unofficial community wiki with no affiliation to the cc-switch authors or the project itself. Its content is compiled from the project's public GitHub issues. This site distributes no software.