Codex++ Integration Guide

Configure WOX models in Codex++

Configuring WOX Models in Codex++

1. Overview

This guide explains how to configure WOX models in Codex++.

Once configured, you can use WOX models directly in Codex++ for chat, code generation, and agent tasks without signing in to a GPT account.

2. Prerequisites

Recommended model:

API Base URL:

3. Download Codex++

Open the Codex++ download page:

You can also open the latest release page directly:

Download the version for your device:

If you are unsure whether your Mac uses an Intel processor or Apple silicon, click the Apple menu in the upper-left corner and select About This Mac.

4. Install Codex++

Install Codex++ after the download completes.

If you use macOS and see the following error:

"Codex++" is damaged and can't be opened.

Open Terminal and run the following commands:

sudo xattr -rd com.apple.quarantine "/Applications/Codex++.app"
sudo xattr -rd com.apple.quarantine "/Applications/Codex++ 管理工具.app"

After running the commands, reopen the Codex++ Management Tool.

5. Open the Codex++ Management Tool

After installation, open:

Codex++ Management Tool

In the left sidebar, click:

Provider Configuration

Then click:

Add Provider

Next, enter the WOX provider details shown below.

6. Add the WOX Provider

Enter the following values:

Example configuration:

Name:
WOX

Access Mode:
API Only

Test Model:
YOUR_MODEL_ID

Base URL:
https://api.wox.lol/v1

Key:
Enter your WOX API Key

Upstream Protocol:
Chat Completions

7. Configuration Notes

Check the following settings carefully:

1. Enter only the API key that starts with sk-. Do not include Bearer.
2. The Base URL must end with /v1. Do not enter /chat/completions.
3. The upstream protocol must be Chat Completions.
4. Set the model name to:

5. After completing the configuration, click:

Save

8. Enable the WOX Provider

After saving the configuration, return to the provider list and select:

WOX

If you see any of the following buttons, click it to enable the WOX provider:

Use

In Use

Switch to This Provider

Once enabled, WOX will become the active provider.

9. Start Codex++

Return to the left sidebar and click:

Overview

Then click:

Start Codex++

You can also click the button in the upper-right corner:

Restart Codex

After it starts, you can use Codex++ normally and requests will be routed through the WOX model.

10. Test the Configuration

Open Codex++ and create a new conversation.

Enter a simple test message, for example:

Hello, please introduce yourself.

If Codex++ responds normally, the WOX model has been configured successfully.

11. Troubleshooting

1. What should I do if Codex does not respond?

Check the following:

• Make sure you started Codex from Codex++ or the Codex++ Management Tool, rather than opening the original Codex application.
• Make sure the Base URL is:

• Make sure the Key contains only the API key starting with sk-.
• Make sure the upstream protocol is:

Chat Completions

• Make sure the model is:

• Make sure you enabled the WOX provider after saving the configuration.

2. How should I enter the API Key?

Enter only the WOX API Key itself, for example:

sk-xxxxxxxxxxxxxxxx

Do not enter:

Bearer sk-xxxxxxxxxxxxxxxx

3. How should I enter the Base URL?

Correct:

Incorrect:

4. Do I need to sign in to a GPT account?

No.

Once configured, you can use WOX models directly in Codex++.

12. Recommended Configuration Summary

13. Complete Setup Summary

1. Download and install Codex++.
2. Open the Codex++ Management Tool.
3. Go to Provider Configuration.
4. Add the WOX provider.
5. Enter the model, Base URL, API Key, and upstream protocol.
6. Save the configuration.
7. Enable the WOX provider.
8. Start or restart Codex++.
9. Create a new conversation to test whether Codex++ responds normally.
10. Once configured, you can use WOX models in Codex++.