Windsurf Custom Configuration

This page explains how to connect Windsurf to this service through a custom OpenAI-compatible configuration.

Windsurf's BYOK and custom model options are not identical across versions, so this guide separates the support check from the actual connection fields.

1. Confirm that your version supports a custom Base URL

In Windsurf settings, model settings, or subscription settings, look for items like:

• Models
• BYOK
• OpenAI
• Custom
• Base URL

If your version only accepts an official API key and does not expose an editable Base URL, it is usually limited to Windsurf's official BYOK flow and cannot be pointed to this gateway directly.

2. Enter custom connection details

If your version exposes a custom OpenAI-compatible configuration, enter:

• Base URL: https://okapi.pockgo.com/v1
• API key: your codex_... key
• Model ID: use a model returned by GET /v1/models; for a quick connectivity test, try gpt-5.4 first

3. Verify

Save the settings, then start a new Cascade chat or coding task and confirm the response returns normally.

Notes

• The Base URL should be https://okapi.pockgo.com/v1
• Do not use the full /v1/chat/completions or /v1/responses endpoint path
• If your current version only exposes Windsurf's official BYOK flow and not a custom Base URL, it cannot connect to this gateway directly
• Windsurf model docs: https://docs.windsurf.com/windsurf/models