Windsurf 接入中转教程:Cascade 智能体自定义端点配置

Codeium Windsurf AI IDE 接入教程:在设置中配置自定义模型端点与 API Key,调用 Claude / GPT / Gemini 多模型。

一、Windsurf 是什么

Windsurf 是 AI 优先的 IDE,内置 Cascade 智能体,支持添加自定义模型端点。把它指向本站网关,即可用统一密钥调用 Claude / GPT / Gemini。

二、准备工作

  1. 登录极智时代控制台,创建 sk-xxxxxx API Key(只显示一次,请保存)。
  2. 确认要用的模型 slug(如 claude-sonnet-5gpt-5.4gemini-3.7-flash)。
  3. 确认网关地址:https://www.azztimes.com

三、在 Windsurf 里配置

打开 Settings → Models / API Providers → Add Provider,选择供应商类型后填入:

Base URL : https://www.azztimes.com        # Claude / Anthropic
API Key  : sk-你的密钥
Model    : claude-sonnet-5
(GPT 模型把 Base URL 换成 https://www.azztimes.com/v1)
(Gemini 模型把 Base URL 换成 https://www.azztimes.com/v1beta)

保存后在 Cascade 里选中该模型,用 Ctrl+L(macOS Cmd+L)唤起对话即可。

四、接口地址对照

模型分组本站入口(Base URL)协议
Claude / Anthropichttps://www.azztimes.comAnthropic Messages
GPT / OpenAIhttps://www.azztimes.com/v1OpenAI Chat Completions
Geminihttps://www.azztimes.com/v1betaGoogle generateContent

Base URL 用上表入口。

五、常见问题排查

现象处理
401 / 403密钥无效、未启用或余额不足;确认 sk- 正确并充值。
404 / 模型不可用模型名与平台 slug 不一致,或该模型未启用;核对模型 ID。

安全建议:密钥别写法进公开仓库;给不同用途单独建 Key,便于统计与限额。