Windsurf API中継接続ガイド：Cascade エージェントのカスタムエンドポイント設定

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

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

一、Windsurf とは

Windsurf は AI ファーストの IDE であり、Cascade エージェントが組み込まれており、カスタムモデルエンドポイントの追加をサポートしています。本サイトのゲートウェイを指定することで、統一された API キーを使用して Claude / GPT / Gemini を呼び出すことができます。

二、準備

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

三、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）でチャットを呼び出せば完了です。

四、API アドレス対応表

モデルグループ	本サイトの入口（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 には上の表の入口を使用してください。

五、トラブルシューティング

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

セキュリティに関するアドバイス：キーを公開リポジトリに記述しないでください。用途ごとに個別のキーを作成することで、統計管理や利用制限が容易になります。