Skip to main content
You can use a third-party API or custom model without losing your official Codex login. Turn on two Codex App Enhancements in CC Switch to keep official plugins, Remote Control, and a unified session history.

​
Before you begin

  1. Use CC Switch v3.16.1 or later.
  2. Sign in to Codex once with your official ChatGPT / Codex account.
  3. Follow the Codex CLI steps in the CC Switch setup guide to add and enable your third-party API provider or custom model in CC Switch.
Do not share API Keys, login tokens, or other authentication data in screenshots, chats, issues, or logs.

​
Enable both Codex App Enhancements

In CC Switch, open Settings → General → Codex App Enhancements and turn on both switches:
  1. Keep official login when switching third-party providers
  2. Unified Codex session history
CC Switch Codex App Enhancements with Keep official login and Unified Codex session history enabled.

​
Keep the official login, plugins, and Remote Control

Keep official login when switching third-party providers keeps the official Codex login when you switch to a third-party API provider or custom model. Model requests still use the provider currently selected in CC Switch, while Codex App can continue to use features that require the official login, including official plugins and Remote Control. For detailed steps, see the CC Switch guide: Keep Codex Remote Control and official plugins while using a third-party API.

​
View official and third-party sessions together

Unified Codex session history shows sessions created with the official subscription and third-party providers in one history list. When you enable it, you can choose whether to move existing official sessions into that list. CC Switch automatically backs up the original sessions before migration. For detailed steps, see the CC Switch guide: Unified Codex session history.

​
Restart Codex

After turning on both switches, fully quit and restart Codex. Codex reloads the current CC Switch configuration and the unified session history after restarting.

​
Confirm that the setup works

After restarting, confirm the following:
  1. Codex still shows your official account login.
  2. Official plugins or Remote Control work normally.
  3. CC Switch has your third-party API provider or custom model selected.
  4. A test message returns normally.
A unified history lets you view sessions in one place, but it does not guarantee that an existing session can continue across providers. Resume a session with the provider that created it whenever possible. For another provider, start a new session.

​
Manual setup

Manual setup is for advanced users who are comfortable editing local Codex files. Most users should use CC Switch first.
1

Keep the official Codex login

Sign in to your official ChatGPT / Codex account in Codex App or Codex CLI first, then confirm that Remote Control or plugins work.Keep the content generated by your official login in ~/.codex/auth.json. Do not copy, sync, or share its tokens.
2

Edit config.toml

Open ~/.codex/config.toml, then add or merge this provider configuration:
model_provider = "custom"
model = "gpt-5.5"
review_model = "gpt-5.4"
model_reasoning_effort = "high"
model_context_window = 1000000
model_auto_compact_token_limit = 900000
windows_wsl_setup_acknowledged = true

[model_providers]
[model_providers.custom]
name = "LLM Easy"
base_url = "https://www.llmeasy.ru/v1"
wire_api = "responses"
requires_openai_auth = true
experimental_bearer_token = "YOUR_API_KEY"
request_max_retries = 4
stream_max_retries = 8
stream_idle_timeout_ms = 300000
supports_websockets = false
Replace YOUR_API_KEY with your LLMEasy API Key. requires_openai_auth = true keeps the official login, while experimental_bearer_token sends third-party API requests.
3

Restart and verify

Fully quit and restart Codex. Confirm that the official login remains, Remote Control or plugins open, and a test message returns normally.If the model is unavailable, confirm that model is from the Codex group in the model plaza.