WindsurfAPI接入：兼容OpenAI/Anthropic的配置要点与协议说明

WindsurfAPI接入概述

WindsurfAPI 是一个开源项目，它将 Windsurf（原 Codeium）编辑器内置的 AI 模型能力，封装成标准的 OpenAI 与 Anthropic 兼容 API 接口。部署后，你可以用 Claude Code、Cline、Cursor 等任何支持自定义端点的 AI 工具，通过统一的协议调用 59 个（另一份资料提到 107 个）大模型。配置的关键在于部署代理服务、获取 API Key（支持多账号池轮转）、以及客户端端点与认证的设置。

部署方式与基本配置

WindsurfAPI 提供了两种部署路径：Docker 一键部署和Node.js 直接运行。如果使用 Docker，拉取镜像后设置环境变量即可启动，零 npm 依赖。Node.js 版本要求 ≥20，项目基于 MIT 协议开源。部署后服务默认 localhost:3003。你需要在服务端配置 Windsurf 的账号令牌（Token），支持多账号池轮转，以应对不同模型的调用量。

协议兼容要点

同一实例同时支持两套协议：

• OpenAI 兼容：端点 POST /v1/ch@t/completions，认证方式为 Bearer Token，与标准 OpenAI API 一致。
• Anthropic 兼容：端点 POST /v1/messages，同样使用 Bearer 认证。客户端只要修改 base URL 和 API Key 即可无缝切换。

这种双协议设计让 Claude Code 可以直接用 Anthropic 协议连接，而 Cursor、OpenCode 等工具则用 OpenAI 协议。无需额外转换层。

客户端接入步骤

以下以最常见的 OpenAI 兼容模式为例：

1. 在 WindsurfAPI 部署完成后，获取服务地址（如 http://localhost:3003）。
2. 在目标 AI 工具中（如 Cursor、Aider），将自定义 OpenAI 端点设置为 http://localhost:3003/v1。
3. API Key 填写你在 WindsurfAPI 配置中设定的 Token（通常是“sk-”开头的字符串）。
4. 选择模型：可用模型包括 Claude 系列、GPT 系列、Gemini、DeepSeek、Qwen、Grok、Llama 等。具体列表可在项目文档或健康检查端点中查看。

对于 Anthropic 协议客户端（如 Claude Code），只需将端点改为 http://localhost:3003，并使用相同的 Bearer Token 即可，路径 /v1/messages 会自动路由。

高级配置与注意事项

WindsurfAPI 内置了账号管理与负载均衡。使用多账号池时，需要将多个 Windsurf 账号的令牌放入配置中，系统会自动轮换，避免单账号速率限制。项目目前为 v1.5.0 版本，修复了工具调用（Tool Calls）的兼容性问题。如果遇到函数调用格式错误，优先检查客户端是否使用了最新的工具调用规范。另外，Docker 部署时可通过环境变量自定义端口和日志级别。

WindsurfAPI 适合需要统一管理多个 AI 模型调用、或者在本地搭建私有代理的开发者。它不依赖 npm 生态，体积小，适合集成到 CI/CD 或内网环境。与直接调用官方 API 相比，它提供了一个中间层，可以更方便地切换模型供应商，同时复用现有 OpenAI/Anthropic SDK。

配置完成后，建议先用 curl 测试一下 /v1/ch@t/completions 端点，确认返回正常后再集成到主流工具中。