Windsurf接続チュートリアル：Cascadeエージェントのカスタムエンドポイント設定

发布时间2026年8月30日 01:08
语言ja

Codeium Windsurf AI IDEの接続ガイド：設定画面でカスタムモデルエンドポイントとAPIキーを設定し、Claude / GPT / Geminiの複数モデルを呼び出します。

1. Windsurfとは

Windsurfは、Cascadeエージェントを内蔵したAI優先のIDEであり、カスタムモデルエンドポイントの追加に対応しています。当サイトのゲートウェイを指定するだけで、統一されたAPIキーを使用してClaude / GPT / Geminiを呼び出すことができます。

2. 準備

極智（Jizhi）APIコンソールにログインし、sk-xxxxxx APIキーを作成します（一度しか表示されないため、必ず保存してください）。
使用するモデルのslug（claude-sonnet-5、gpt-5.5、gemini-3.7-flashなど）を確認します。
ゲートウェイアドレス：https://www.relay-api.com を確認します。

3. Windsurfでの設定

Settings → Models / API Providers → Add Providerを開き、プロバイダータイプを選択して以下を入力します：

Base URL : https://www.relay-api.com        # Claude / Anthropic
API Key  : sk-あなたのキー
Model    : claude-sonnet-5
(GPTモデルの場合、Base URLを https://www.relay-api.com/v1 に変更してください)
(Geminiモデルの場合、Base URLを https://www.relay-api.com/v1beta に変更してください)

保存後、Cascadeで該当モデルを選択し、Ctrl+L（macOSでは Cmd+L）でチャットを呼び出します。

4. インターフェースアドレス対照表

モデルグループ	当サイト入口（Base URL）	プロトコル
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

Base URLは上表の入口を使用してください。

5. トラブルシューティング

現象	対処法
401 / 403	キーが無効、未有効化、または残高不足です。`sk-`キーが正しいか確認し、チャージしてください。
404 / モデル利用不可	モデル名とプラットフォームのslugが一致していないか、そのモデルが無効化されています。モデルIDを確認してください。

セキュリティに関する推奨事項：APIキーを公開リポジトリに記述しないでください。用途ごとにキーを個別に作成することで、統計管理や制限設定が容易になります。

Base URLに関する補足：当サイトは /v1beta/models/... と /v1beta/v1beta/models/...（および /v1/... と /v1/v1/...）の両方を受け付けます。そのため、クライアント側が /v1 や /v1beta を自動補完するかどうかに関わらず、呼び出しに影響はありません。Base URLにはドメインルートを入力しても、/v1beta を含むアドレスを入力してもどちらでも利用可能です。モデルIDについては、コンソールの「トークン」ページ右上にある「モデルID」から確認・コピーしてください。