Skip to content
CC Switch WikiUnofficial Community Wiki

No API key configured for provider: custom: Codex takeover

Quick fix

Upgrade Codex CLI and CC Switch to the latest versions; CC Switch supports reading the Codex CLI version from config.toml.

Symptom

Section titled “Symptom”
Error output
No API key configured for provider: custom

Cause

Section titled “Cause”

This issue occurred with the JS version of Codex installed through Homebrew: it reads config.json, config.yaml, or config.yml, but not config.toml written by CC Switch. It was also incompatible with the placeholder key in auth.json and the provider field format written by the Rust version at the time. The maintainers explained that CC Switch targets Codex CLI versions that read ~/.codex/config.toml; the early JS version was outside the supported scope.

The maintainers said CC Switch 4.0 rewrote Codex configuration writing. It no longer writes placeholder credentials to auth.json, and third-party keys are written only to the [model_providers.custom] table in config.toml. Upgrade Codex and CC Switch and try again; if the issue still occurs, provide the output of codex --version and the CC Switch version number.

Fix

Section titled “Fix”

  1. Upgrade Codex CLI to the current version and CC Switch to the latest version, then try taking over again.

  2. If the issue still occurs on the latest version, include the output of codex --version and the CC Switch version number in the issue.

Affected Versions

Section titled “Affected Versions”
ToolCodex
Version3.12.3（CC Switch；问题报告版本）
PlatformsmacOS

Source Issues

Section titled “Source Issues”

This page is distilled from 1 real issues

FAQ

Section titled “FAQ”
What information should I provide if the issue still occurs after upgrading?
The maintainers request the output of codex --version and the CC Switch version number.
Section titled “Related problems”
Provider API Key Overwritten: After Codex Restart or SwitchUpgrade to cc-switch v4.0.0 or later to prevent provider keys from overwriting each other and restore the official login state.6 issues merged<thinking> tags output as body text in Claude CodeChanging the provider's apiFormat from openai_chat to anthropic, if supported upstream, can bypass inline <thinking> leakage.1 issues mergedSelect Model Menu Still Shows Pre-Switch Model List - CodexClose existing Codex sessions, run `codex app-server daemon restart`, and upgrade CC Switch to v4.0.7 or later for detection and restart prompts.3 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.