explaingit

jujishou/codex-switch

Analysis updated 2026-05-18

30PythonAudience · developerComplexity · 2/5Setup · easy

TLDR

A Windows desktop app that lets the OpenAI Codex App talk to other AI providers like DeepSeek or Kimi through a local proxy.

Mindmap

mindmap
  root((codex switch))
    What it does
      Redirects Codex App
      Local proxy
      Provider switching
    Tech stack
      Python
      Windows exe
    Use cases
      Use cheaper providers
      Use Chinese hosted models
      Add custom providers
    Audience
      Codex users
      Developers
    Notes
      Localhost only
      Backs up config

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Keep using the Codex interface while paying lower rates on providers like DeepSeek or Kimi.

USE CASE 2

Switch Codex to a Chinese-hosted AI provider that does not need a proxy connection.

USE CASE 3

Add a custom or template-based provider by pasting an API key into a preset.

USE CASE 4

Restore your original OpenAI Codex configuration with a single click when done.

What is it built with?

PythonWindows

How does it compare?

jujishou/codex-switchchandar-lab/semantic-wmdjlougen/hive
Stars303030
LanguagePythonPythonPython
Setup difficultyeasyhardeasy
Complexity2/55/53/5
Audiencedeveloperresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Ships as a single .exe with no Python install needed, only one upstream provider can be active at a time.

In plain English

codex-switch is a small Windows desktop app that lets you redirect the OpenAI Codex App to use other AI models instead of OpenAI's own. By default, Codex only works with official OpenAI models. This tool intercepts those requests locally and forwards them to whichever provider you choose, such as DeepSeek, Kimi, Zhipu, or Tongyi. The practical effect is that you can keep using the Codex interface you already know while paying much lower API rates, or using Chinese-hosted services that do not require a proxy connection. The app works by running a small local proxy on your machine that translates the Codex request format into the standard OpenAI Chat Completions format that most alternative providers support. When you switch to a non-OpenAI model, the proxy starts automatically and Codex routes its traffic through it. When you want to go back to the original OpenAI setup, one click stops the proxy and restores the original configuration. The switch is clean: it merges only the specific fields it needs to change in the Codex config file, leaving your projects, plugins, and marketplace settings untouched. Several providers are bundled out of the box, including two DeepSeek variants and four Kimi variants. If you want to add another service, the app includes nine preset templates covering common platforms such as Zhipu, Tongyi, Doubao, Groq, Mistral, and OpenRouter. You pick a template, the base URL fills in automatically, and you only need to paste your API key. Fully custom entries are also supported if your provider is not on any template. Each provider's key is stored separately, so switching between them does not overwrite anything. The app ships as a single .exe file that requires no Python installation. It has a modern light and dark UI that follows your system theme. On first run it backs up your existing Codex config file before making any changes, so you have a fallback. The proxy only listens on localhost and is not reachable from outside your machine. At the moment only one upstream provider can be active at a time, which is a limitation of how Codex itself works, not of this tool.

Copy-paste prompts

Prompt 1
Walk me through switching my Codex App from OpenAI to DeepSeek using codex-switch.
Prompt 2
Explain how codex-switch's local proxy translates Codex requests to the OpenAI Chat Completions format.
Prompt 3
How do I add a custom AI provider to codex-switch that isn't in the built-in templates?
Prompt 4
What does codex-switch back up before changing my Codex config, and how do I revert it?

Frequently asked questions

What is codex-switch?

A Windows desktop app that lets the OpenAI Codex App talk to other AI providers like DeepSeek or Kimi through a local proxy.

What language is codex-switch written in?

Mainly Python. The stack also includes Python, Windows.

How hard is codex-switch to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is codex-switch for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.