Windsurf Integration Tutorial: Customizing Cascade Agent Endpoints

发布时间2026年8月30日 09:08
语言en

Codeium Windsurf AI IDE integration tutorial: How to configure custom model endpoints and API keys in settings to access Claude, GPT, and Gemini.

1. What is Windsurf?

Windsurf is an AI-first IDE with an integrated Cascade agent that supports custom model endpoints. By pointing it to our gateway, you can access Claude, GPT, and Gemini using a unified API key.

2. Preparation

Log in to the Azztimes console and create an sk-xxxxxx API Key (it will only be displayed once, so please save it).
Identify the model slug you wish to use (e.g., claude-sonnet-5, gpt-5.4, gemini-3.7-flash).
Confirm the gateway address: https://www.relay-api.com.

3. Configuring in Windsurf

Open Settings → Models / API Providers → Add Provider, select the provider type, and enter the following details:

Base URL : https://www.relay-api.com        # Claude / Anthropic
API Key  : sk-your-key
Model    : claude-sonnet-5
(For GPT models, set Base URL to https://www.relay-api.com/v1)
(For Gemini models, set Base URL to https://www.relay-api.com/v1beta)

After saving, select the model within Cascade and press Ctrl+L (or Cmd+L on macOS) to start a conversation.

4. API Endpoint Reference

Model Group	Base URL	Protocol
Claude / Anthropic	`https://www.relay-api.com`	Anthropic Messages
GPT / OpenAI	`https://www.relay-api.com/v1`	OpenAI Chat Completions
Gemini	`https://www.relay-api.com/v1beta`	Google generateContent

Use the corresponding entry from the table above for the Base URL.

5. Troubleshooting

Issue	Resolution
401 / 403	Invalid key, disabled account, or insufficient balance; verify the `sk-` key and add credit.
404 / Model Unavailable	The model name does not match the platform slug, or the model is not enabled; double-check the model ID.

Security Tip: Never hardcode your API key into public repositories. Create separate keys for different purposes to facilitate usage tracking and quota management.