CC-Switch with gpt88.cc

Route configuration, OpenAI/Claude protocol differences, OAuth switching, and troubleshooting for using gpt88.cc with CC-Switch.

When to use it

You use multiple development tools and want to switch routes centrally.
You want OpenAI-compatible and Claude-compatible configurations managed separately.
You need to move between API key model access and OAuth-based plugin usage.

Preparation

checklisttext

1. Install CC-Switch
2. Install the target tools, such as Codex CLI, Claude Code, or Cursor
3. Prepare a gpt88.cc API key
4. Decide whether you need OpenAI-compatible or Claude-compatible routing
5. Remember: plugin capability needs OAuth; model relay uses API key mode

How to fill the routes

Split routes by protocol first. Do not put /v1 into every protocol blindly.

routestext

OpenAI-compatible route
Name: gpt88-openai
Base URL: https://api.gpt88.cc
API Key: sk-your-gpt88-api-key
Default Model: gpt-5-2-chat-latest

Claude-compatible route
Name: gpt88-claude
Base URL: https://api.gpt88.cc
API Key: sk-your-gpt88-api-key
Default Model: claude-sonnet-4-6

Step-by-step setup

flowtext

1. Open CC-Switch
2. Go to Routes / Providers / API route settings
3. Create the gpt88-openai route
4. Set Base URL to https://api.gpt88.cc
5. Paste the API key
6. Fill in one default chat model
7. Save the route
8. Enable the route
9. Restart the target tool and verify

OAuth scenarios

If you are configuring for Codex plugins, ChatGPT account features, or similar OAuth behavior, the key question is the login mode, not just the model Base URL.

oauth-flowtext

1. If the target is Codex or ChatGPT plugin capability, sign out of API key mode first
2. Clear OPENAI_API_KEY, OPENAI_BASE_URL, and related variables
3. Sign in again with OAuth inside the tool
4. Confirm the CC-Switch route is enabled
5. Start a clean session and verify that plugins are visible

Verify the route

Bypass the tool layer first. Verify that gpt88.cc itself works, then come back to CC-Switch.

smoke-test.shbash

curl https://api.gpt88.cc/v1/chat/completions \
  -H "Authorization: Bearer $GPT88_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5-2-chat-latest",
    "messages": [{"role": "user", "content": "Test the CC-Switch route"}]
  }'

Troubleshooting

troubleshootingtext

1. The tool still uses the old route
   - Confirm the CC-Switch route is enabled
   - Restart the terminal and the target tool

2. 404 response
   - OpenAI-compatible routes must include /v1
   - Claude-compatible routes also use https://api.gpt88.cc

3. Plugins are unavailable
   - Do not keep debugging inside API key mode
   - Sign out of API key mode and switch to OAuth

4. Route looks enabled but requests still fail
   - Test gpt88.cc directly with curl first
   - Then debug the CC-Switch forwarding layer

Optional analytics