WindsurfAPI 是什么?

WindsurfAPI 是一个把 Windsurf(原 Codeium)的 AI 模型变成标准 API 的代理:用纯 Node.js(零 npm 依赖)起一个 HTTP 服务,同时暴露 OpenAI 兼容的 /v1/chat/completions 和 Anthropic 兼容的 /v1/messages 两套接口,背后通过本地 Windsurf Language Server 二进制以 gRPC 把请求转发到 Windsurf 云端,从而以 OpenAI/Claude 协议调用其 100+ 模型(Claude 4.x/Opus 4.7、GPT-5 全系、Gemini、Grok、Qwen、Kimi、GLM 等)。它维护账号池做轮询/限流/故障转移,并在返回前剥掉上游 Windsurf 身份。代码 MIT 开源,但本质是绕过官方计费、复用 Windsurf 额度的灰色项目,作者自陈个人态度严禁商用/转售/代部署。

⭐ 2,767 Stars 🍴 586 Forks JavaScript 作者: dwgx 商业引流:低
来源:README 声明/它到底在干嘛;GitHub desc,license MIT 查看 GitHub 仓库 →

为什么值得关注

约一个半月即超过 2.5k 星,热度同样来自『白嫖』诉求:把 Windsurf 订阅/账号能用的一众前沿模型,通过逆向其本地 Language Server + 云端 gRPC,包成 OpenAI/Anthropic 标准接口接进 Claude Code、Cline、Cursor 等工具。零依赖纯 Node、账号池、双协议兼容让它易部署、易接入。但这种热度建立在违反 Windsurf 服务条款之上,可持续性与合规性都很脆弱。

来源:GitHub 2,559 stars / 548 forks,created 2026-04-09;README 调用示例

核心功能

OpenAI + Anthropic 双协议兼容

一个服务(默认端口 3003)同时暴露 /v1/chat/completions(OpenAI 兼容,任意 OpenAI SDK 可用)和 /v1/messages(Anthropic 兼容,Claude Code/Cline/Cursor 可直连),并支持 SSE 流式。

来源:README 它到底在干嘛/调用示例
经 Language Server 逆向接入 Windsurf 云

把请求翻译成 Windsurf 内部 gRPC 协议,通过本地 Windsurf Language Server 二进制发到 Windsurf 云(server.self-serve.windsurf.com),换上桌面端的 LS binary 还能让 /v1/models 云端自动发现到最新模型(如 Opus 4.7)。

来源:README 它到底在干嘛/手动安装(LS binary 说明)
账号池轮询与故障转移

维护多账号池,自动轮询、按账号做速率限制隔离、遇问题故障转移,以维持对外的可用额度与并发。

来源:README 它到底在干嘛/加账号;src/account、conversation-pool.js
100+ 模型与身份剥离

对外提供 Claude 4.5/4.6/Opus 4.7、GPT-5 全系、Gemini 2.5/3.x、Grok、Qwen、Kimi K2.x、GLM、MiniMax、SWE、Arena 等 100+ 模型;返回前剥掉上游 Windsurf 身份,使模型自称对应厂商模型。

来源:README 它到底在干嘛(模型列表/身份剥离)
多种部署方式

提供一键部署脚本、Docker / docker-compose 部署、一键更新,以及手动安装(install-ls.sh 自动检测 Linux/macOS 下载 Language Server binary 并 chmod,或指定本地 binary/URL);可配 https-proxy 与 nginx。

来源:README 快速开始/手动安装;tree(Dockerfile、install-ls.sh、nginx.conf)

技术架构

纯 Node.js、零 npm 依赖的单服务(src/index.js 入口)。核心链路:HTTP 入口(handlers/)接收 OpenAI 或 Anthropic 格式请求 → 经 proto.js/grpc.js/connect.js 翻译成 Windsurf 内部 gRPC → 由 langserver.js 调起本地 Windsurf Language Server 二进制 → 转发到 Windsurf 云端。账号与会话由 src/account、conversation-pool.js、caller-key.js、auth.js 管理(账号池轮询/限流/故障转移),models.js 维护模型目录,cache.js 缓存,net-safety.js 做网络安全,image.js/pdf.js 处理多模态输入,cascade-native-bridge.js 桥接 Windsurf 的 Cascade 能力,dashboard/ 提供管理界面,fs-atomic.js 做原子写。整体是『双协议网关 → 协议翻译 → 本地 LS → 云端』的逆向代理结构,能力根基是对 Windsurf LS/gRPC 协议的逆向,随官方变更或封禁随时可能失效。

来源:tree(src/*:index/handlers/grpc/proto/langserver/account/conversation-pool/models/dashboard);README 架构图

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Windsurf Language Server 二进制(逆向接入)Windsurf Langu… gRPC (Windsurf 内部协议)gRPC 账号池/限流/故障转移账号池/限流/故障… Docker / docker-composeDocker / docke… nginx / https-proxy(可选)nginx / https-… OpenAI + Anthropic 双协议兼容OpenAI + Anthropic… 经 Language Server 逆向接入 Windsurf 云经 Language Server… 账号池轮询与故障转移 100+ 模型与身份剥离 多种部署方式 WindsurfAPI 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言JavaScript (纯 Node.js,零 npm 依赖)框架自研双协议网关(OpenAI + Anthropic)
Windsurf Language Server 二进制(逆向接入)gRPC (Windsurf 内部协议)账号池/限流/故障转移Docker / docker-composenginx / https-proxy(可选)
自托管(默认端口 3003);需本地 Windsurf Language Server binary + Windsurf 账号池;依赖 Windsurf 云端 server.self-serve.windsurf.com
来源:README 它到底在干嘛/手动安装;tree

快速上手

提供一键部署脚本(setup.sh)、Docker/docker-compose(首次启动可自动下载 language_server)和一键更新(update.sh)。手动:用 install-ls.sh 自动检测平台下载 Language Server binary 并 chmod(也可传本地 binary 路径或 --url);想要 Opus 4.7 等最新模型,需从 Windsurf 桌面端本体里把 LS binary 拷过来(公开 release 停在 v2.12.5 不含 4.7),换上后 /v1/models 即云端自动发现。配好账号池后,把 Claude Code/Cline/Cursor 的 base URL 指向本服务即可。务必注意这违反 Windsurf 服务条款、有账号封禁风险。
来源:README 快速开始/手动安装/加账号/调用示例

使用场景

技术上它被用来:把 Windsurf 账号可用的 100+ 模型通过逆向代理聚合成 OpenAI/Anthropic 标准接口、接进各类编码工具白嫖使用。但必须强调:这绕过 Windsurf 官方计费、违反其服务条款,作者本人也声明严禁商业使用、转售、代部署、挂后台对外提供服务。不适合任何生产、商业或规模化用途,也不适合不愿承担账号封禁与法律风险的人。若只是技术研究,可了解其协议逆向与双协议网关实现,但请勿用于实际服务。

来源:README 声明/它到底在干嘛

优势与局限

优势

  • 工程取巧到位:纯 Node 零依赖、双协议(OpenAI+Anthropic)兼容,部署和接入门槛低
  • 账号池 + 轮询/限流/故障转移做得较完整,可维持一定可用性
  • 经本地 LS 换 binary 即可云端自动发现最新模型,跟得上 Windsurf 模型更新
  • 支持多模态输入(图片/PDF)、Docker/一键部署/管理面板,使用体验较顺
  • 代码结构清晰(协议翻译/账号/会话分层),作者迭代活跃

局限

  • 合规性是根本问题:逆向 Windsurf LS/gRPC、账号池聚合额度,违反 Windsurf 服务条款,存在账号封禁风险
  • 作者自陈严禁商用/转售/代部署/对外服务,超出个人研究用途即涉嫌违规
  • 可持续性极差:能力完全依赖逆向协议与 LS binary,官方一调整即可能失效,最新模型还需手动拷桌面端 binary
  • 安全与凭证风险:处理多账号凭证、公网部署需自行做访问控制,身份剥离也可能掩盖来源问题
  • 本质不创造价值而是绕过付费墙,与正规付费 API 相比无任何稳定性与合规保障
来源:README 声明/手动安装;逆向与账号池的固有风险

最新版本

采用语义化版本、发布频繁,最新为 v2.0.97(2026-05-22,与最近 push 同日),此前 v2.0.96(2026-05-13),仓库还附带 2.0.91/2.0.92 的 release notes,处于持续高频迭代,主要随 Windsurf 协议与模型变化跟进。

来源:GitHub Releases v2.0.97/v2.0.96;pushed_at 2026-05-22;RELEASE_NOTES_*.md

总结评价

WindsurfAPI 在工程上把『逆向 Windsurf 的 Language Server/gRPC + 账号池 + OpenAI/Anthropic 双协议网关』做得相当顺手,纯 Node 零依赖、易部署易接入,这也是它涨星的原因。但它的价值前提是绕过 Windsurf 付费墙、复用账号额度去当通用 API 用——这明确违反 Windsurf 服务条款,连作者都声明严禁商用/转售/对外服务,并伴随账号封禁风险。它不创造新能力,只是把规则边缘的白嫖做得更顺,且能力随官方变更随时归零。从协议逆向和双协议网关实现角度可作技术样本了解,但不建议用于任何实际、商业或规模化用途;要稳定可靠地用这些模型,请走各厂商官方付费 API。

来源:综合 README 定位/声明、tree 工程结构、合规与发布状态的事实判断

常见问题

WindsurfAPI 是什么?

WindsurfAPI 是一个把 Windsurf(原 Codeium)的 AI 模型变成标准 API 的代理:用纯 Node.js(零 npm 依赖)起一个 HTTP 服务,同时暴露 OpenAI 兼容的 /v1/chat/completions 和 Anthropic 兼容的 /v1/messages 两套接口,背后通过本地 Windsurf Language Server 二进制以 gRPC 把请求转发到 Windsurf…

WindsurfAPI 有哪些核心功能?

WindsurfAPI 的核心功能包括:OpenAI + Anthropic 双协议兼容、经 Language Server 逆向接入 Windsurf 云、账号池轮询与故障转移、100+ 模型与身份剥离、多种部署方式。

WindsurfAPI 为什么最近很受关注?

约一个半月即超过 2.5k 星,热度同样来自『白嫖』诉求:把 Windsurf 订阅/账号能用的一众前沿模型,通过逆向其本地 Language Server + 云端 gRPC,包成 OpenAI/Anthropic 标准接口接进 Claude Code、Cline、Cursor 等工具。零依赖纯 Node、账号池、双协议兼容让它易部署、易接入。但这种热度建立在违反 Windsurf 服务条款之上,可持续性与合规性都很脆弱。

WindsurfAPI 适合哪些使用场景?

技术上它被用来:把 Windsurf 账号可用的 100+ 模型通过逆向代理聚合成 OpenAI/Anthropic 标准接口、接进各类编码工具白嫖使用。但必须强调:这绕过 Windsurf 官方计费、违反其服务条款,作者本人也声明严禁商业使用、转售、代部署、挂后台对外提供服务。不适合任何生产、商业或规模化用途,也不适合不愿承担账号封禁与法律风险的人。若只是技术研究,可了解其协议逆向与双协议网关实现,但请勿用于实际服务。

透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-22 20:36. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件