Use with Codex++

[!WARNING] Codex++ (CodexPlusPlus) is a third-party enhancement tool for the Codex desktop app — it is not official OpenAI Codex. If you're configuring the official Codex CLI (command line, editing ~/.codex/config.toml by hand), see Use with Codex instead. The names are similar but the tools are different — don't mix them up.

Codex++ launches the Codex desktop client through an external launcher and injects enhancements, without modifying Codex's installed files. Connecting to yylx.io goes through its provider-configuration feature: you add yylx.io as a provider in the manager's GUI, it writes the configuration into Codex for you, and from then on you start Codex via the Codex++ entry.

Before you start

First, open the "API Keys" page in the yylx.io console, create or pick a Key dedicated to Codex, and copy it. Don't paste the full Key into public chats or issues.

Download and install Codex++

Codex++ is open source, hosted on GitHub: BigPizzaV3/CodexPlusPlus.

1. Open the Releases page.
2. In the latest release's asset list, pick the installer for your OS:
   • Windows: CodexPlusPlus-*-windows-x64-setup.exe
   • macOS Intel: CodexPlusPlus-*-macos-x64.dmg
   • macOS Apple Silicon: CodexPlusPlus-*-macos-arm64.dmg
3. Install it the usual way. Two entries appear after installation: Codex++ (silent launcher that starts Codex with enhancements injected) and Codex++ Manager (control panel).
4. Open Codex++ Manager at least once so you can configure it.

Add yylx.io as a provider

Open Codex++ Manager and click "Provider Configuration" (供应商配置) in the sidebar.

[!NOTE] Make sure "Enable provider switching" (启用供应商配置切换) at the top is checked — it's on by default. When it's off, the "Use" button below is disabled: configurations are saved but never written into Codex.

1. Add a provider

Click "Add Provider" (添加供应商).

2. Create from a template and fill in the form

Click "Create from preset template" (从预设模板创建), choose the official "OpenAI Official" template, then fill in the form:

[!INFO] The "Codex goals / enable goals" switch in the form is Codex's built-in long-term goals mode (features.goals) — it has nothing to do with connecting to yylx.io. Leave it at the default.

Once the form is filled in, click "Fetch from upstream" (从上游获取) next to the model list to pull the models yylx.io provides, then click "Save" (保存) in the top-left corner.

Test and enable

1. Back in the provider list, find the YYLX entry you just added and click its "Test" (测试) button — it sends a hi test. An HTTP 200 in the popup means the configuration works.

   

2. Click the "Use" (使用) button on the left to switch Codex to the YYLX configuration — Codex++ writes it into ~/.codex/config.toml accordingly.

3. Launch via Codex++ (not the plain Codex entry). On first use, start with a lightweight request to confirm everything works.

[!INFO] After enabling, Codex++ automatically writes a model_provider entry into ~/.codex/config.toml (managed by Codex++; depending on the version it may be custom or another internal identifier). That name is just an internal identifier in the config file — you don't need to (and shouldn't) rename it to yylx. What routes requests to yylx.io is the Base URL and API Key, not this name, and a manual rename gets overwritten on the next switch. If you want a recognizable name, put YYLX in the "Name" field from the previous step.

Verify requests reach yylx.io

Check both sides:

If nothing shows up in the yylx.io usage log, Codex usually isn't switched to the YYLX provider, or you didn't launch via the Codex++ entry.

Troubleshooting

Related resources

• Use with Codex (official Codex CLI)
• Create an API Key
• CodexPlusPlus project