cc-switch overview
cc-switch is an open-source provider switcher for AI coding tools. This site collects the troubleshooting knowledge from its public issues.
Where to start
Section titled “Where to start”- Error index — find a page by error code or keyword
- Provider setup — find a page by provider
- Install and launch — won’t install, won’t open, broken after an update
- More solved problems — problems that do not recur often enough for a page of their own, grouped by topic as links to the original threads
- Or use the search at the top right and paste your error text in
How every page is structured
Section titled “How every page is structured”- TL;DR — the fix in one sentence
- Symptom — the raw error output
- Cause — why it happens
- Fix — numbered steps, with config changes shown as diffs
- Affected Versions — tool / version / platform
- Source Issues — a link back to every original issue
- FAQ — real follow-up questions from the issues
- Related problems — cards linking to neighbouring pages
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.