> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aioagi.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Windsurf 配置

> 在 Windsurf 中配置 AIOAGI 自定义 OpenAI 兼容模型。

Windsurf 的自定义模型能力可连接 OpenAI 兼容接口。使用 AIOAGI 后，你可以在 Cascade 中调用多模型能力完成代码生成、重构和解释。

## 配置步骤

<Steps>
  <Step title="进入模型设置">
    打开 Windsurf 设置，找到模型 Provider 或自定义 API 配置。
  </Step>

  <Step title="选择 OpenAI 兼容接口">
    如果界面提供 OpenAI compatible、自定义 OpenAI 或 Custom Provider，选择该类型。
  </Step>

  <Step title="填写服务信息">
    ```text theme={null}
    Base URL: https://api.aiearth.dev/v1
    API Key: sk-your-api-key
    Model: 控制台中的模型名称
    ```
  </Step>

  <Step title="测试对话">
    发送一个简单代码问题，确认模型可正常回复。
  </Step>
</Steps>

## 排错

<AccordionGroup>
  <Accordion title="提示模型不可用" icon="circle-question">
    检查模型名称是否与控制台完全一致，并确认 API Key 有该模型权限。
  </Accordion>

  <Accordion title="提示认证失败" icon="key">
    检查 API Key 是否完整复制，并确认请求头使用 Bearer Token。
  </Accordion>
</AccordionGroup>