Skip to content
CC Switch WikiUnofficial Community Wiki

invalid type: sequence, expected struct HooksToml - Codex

Quick fix

Back up and delete the old config.toml so Codex regenerates a default config, fixing the incompatible hooks format.

Symptom

Section titled “Symptom”
Error output
invalid type: sequence, expected struct HooksToml

Cause

Section titled “Cause”

The Codex user config file format is incompatible with the current version. Older configs have `hooks` as an array (`hooks = [...]`) while the newer program requires a struct (`[hooks]`). A TOML parse failure interrupts application initialisation, which on Windows surfaces as a misleading permissions or incomplete-install error. Note: this issue cluster was aggregated wrongly because every member contains a GitHub image upload failure comment (`Failed to upload`), so it also mixes in model context limit problems during hot switching and abnormal GLM model output. This page covers only the config.toml parse failure.

Fix

Section titled “Fix”

  1. Back up your existing config file so nothing is lost.

  2. Change the `hooks` format to a struct, or simply delete the old config file.

    $env:USERPROFILE\.codex\config.toml
    hooks = [
        ...
    ]
    [hooks]
    ...

  3. Quit ChatGPT/Codex completely and restart. If you deleted the config, the app generates a new default one automatically.

Affected Versions

Section titled “Affected Versions”
ToolCodex
VersionUnknown
PlatformsWindows

Source Issues

Section titled “Source Issues”

This page is distilled from 4 real issues

FAQ

Section titled “FAQ”
Why does this page reference other issues such as model context limits or abnormal output?
All of those issues contained the GitHub-generated `<!-- Failed to upload "xxx.png" -->` comment, so the clustering algorithm grouped them as one problem. This page only resolves the `config.toml` parse failure.
Can I fix it by hand rather than resetting the config?
Yes. Open `config.toml` and change the old array format `hooks = [...]` into the struct format `[hooks]` the new version requires.
Section titled “Related problems”
401 Unauthorized: Incorrect API key providedAfter switching to OpenAI Official or turning the proxy off, clear the leftover third-party OPENAI_API_KEY from ~/.codex/auth.json and restart Codex.2 issues mergedCC Switch local proxy failed while handlingUpgrade CC Switch to the latest version and start a new Codex conversation; invalid schema or image blocks left in old session history will keep triggering 400.43 issues mergedCodex desktop not showing third-party modelsLog in with an official ChatGPT account in Codex desktop and enable "preserve official login" in cc-switch to restore display.6 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.