WindsurfAPI · DevinAPI

JavaScript · MIT · ★3,107

docs · releases · issues

把 Windsurf / Devin 的 100+ AI 模型（Claude、GPT、Gemini、DeepSeek、Kimi、GLM、SWE…）变成 OpenAI Chat / Responses / Anthropic / Gemini 四套标准 API。零 npm 运行时依赖。

历史账本 · 把 1387 次提交、196 个版本、82 个 PR、180 个 issue（账本自己的口径，数字跟到 v3.9.34 / 2026-09-15）摊开给你看：时间线主账 + 贡献者分析 + Git 树三形态（竖/横/环）+ 自伤与返工全记录 —— 打开可视化账本（纯原生渲染，零依赖）

声明

没点 Star 和 Follow 的：严禁商业使用、转售、代部署、挂后台对外提供服务、包装成中转服务出售。 点了 Star 和 Follow 的：随便用，我睁一只眼闭一只眼。

代码本体按 MIT License 开源（见 LICENSE），上面这段是作者个人态度。

把 Windsurf（原 Codeium，现 Devin Desktop）的 AI 模型变成四套标准 API 同时兼容：

• POST /v1/chat/completions — OpenAI 兼容 任何 OpenAI SDK 直接用
• POST /v1/completions — OpenAI 旧 Completions（非流式；prompt 包成一条 user turn，流式请走 chat）
• POST /v1/responses — OpenAI Responses 兼容（另有 GET / DELETE /v1/responses/{id} 读取与删除已存响应，需带身份 header，见下）
• POST /v1/messages — Anthropic 兼容 Claude Code / Cline / Cursor 直接连
• POST /v1beta/models/* — Gemini 兼容 直接对接 Gemini SDK

100+ 模型：Claude 4.5/4.6/Opus 4.7/5 · GPT-5/5.1/5.2/5.4/5.5/5.6-Luna 全系 · Gemini 2.5/3.0/3.1 · Grok · Qwen · Kimi K2.x · GLM 4.7/5/5.1/5.2 · MiniMax · SWE 1.5/1.6/1.7/2 · Arena 等。零 npm 依赖 纯 Node.js。

关键词：Windsurf 逆向 · Devin 代理 · Claude Code 中转 · Cursor 镜像 · AI 中转 API · OpenAI 兼容接口 · 免费 Claude/GPT/Gemini · 大模型反代 · Codeium 逆向

项目定位与使用边界

WindsurfAPI 是一个独立的、开源的、自托管协议兼容网关，用于将部署者自己拥有或获授权使用的 Windsurf / Devin 账号能力接入 OpenAI、Anthropic 和 Gemini 兼容客户端。

使用模型

• Bring Your Own Account（BYO-account）：部署者自行提供并控制自己的上游账号与凭据。
• 项目本身不提供、出售、出租、共享或打包任何 Windsurf / Devin 账号、订阅或凭据。
• 多账号能力用于同一部署者拥有或获授权管理的账号集合，例如故障切换、健康检查和限流隔离；它不是公共共享账号池。
• 本项目的目标是协议互操作、自托管客户端兼容和工程研究，不以订阅转售、跨用户账号共享、绕过上游配额或规避访问控制为目的。
• 部署者应自行确认其账号、订阅以及具体使用方式符合对应上游服务条款和适用法律。

独立项目声明

WindsurfAPI 是独立开源项目，与 Cognition、Windsurf、Devin、OpenAI、Anthropic、Google 或其他模型提供商不存在隶属、授权或背书关系，除非另有明确说明。

项目代码依据 MIT License 开源。MIT License 授予的是本项目代码的使用权，并不授予任何第三方服务、模型、账号或订阅的访问权。

本节只界定边界；下面说明它具体能做什么。

它到底在干嘛

flowchart LR
    subgraph clients["你的客户端"]
        A["OpenAI SDK<br/>curl / 前端"]
        B["Claude Code<br/>Cline · Cursor"]
        C["Gemini SDK"]
    end

    subgraph gw["WindsurfAPI（本服务 · 端口 3003）"]
        direction TB
        R["协议翻译层<br/>OpenAI ↔ Anthropic ↔ Gemini"]
        P["账号池<br/>轮询 · 限流隔离 · 故障转移 · 熔断"]
        N["身份中和<br/>剥掉上游 Windsurf 身份"]
        R --- P
        R --- N
    end

    LS["Language Server<br/>（Windsurf 二进制）"]
    UP["Windsurf 云端<br/>server.self-serve.windsurf.com"]
    DC["Devin 云端<br/>（DEVIN_CONNECT 路径）"]

    A -- "/v1/chat/completions" --> R
    B -- "/v1/messages" --> R
    C -- "/v1beta/models/*" --> R
    R -- "gRPC" --> LS
    LS -- "HTTPS" --> UP
    R -. "HTTPS（可选直连）" .-> DC

    classDef gwStyle fill:#1f6feb22,stroke:#1f6feb,stroke-width:2px
    classDef upStyle fill:#8957e522,stroke:#8957e5
    class gw gwStyle
    class UP,DC upStyle

     ┌─────────────┐   /v1/chat/completions   ┌────────────┐
     │ OpenAI SDK  │ ──────────────────────→  │            │
     │ curl / 前端 │ ←──────────────────────  │            │
     └─────────────┘   OpenAI JSON + SSE      │ WindsurfAPI│
                                              │ Node.js    │      ┌──────────────┐       ┌─────────────────┐
     ┌─────────────┐   /v1/messages           │ (本服务)   │ gRPC │ Language     │ HTTPS │ Windsurf 云端   │
     │ Claude Code │ ──────────────────────→  │            │ ───→ │ Server (LS)  │ ────→ │ server.self-    │
     │ Cline       │ ←──────────────────────  │            │ ←─── │ (Windsurf    │ ←─── │ serve.windsurf  │
     │ Cursor      │   Anthropic SSE          │            │      │  binary)     │       │ .com            │
     └─────────────┘                          └────────────┘      └──────────────┘       └─────────────────┘
                                                    ↑
                                                账号池轮询
                                                速率限制隔离
                                                故障转移

它做了什么：

1. 一个 HTTP 服务（端口 3003）同时暴露 OpenAI 和 Anthropic 两套 API
2. 把请求翻译成 Windsurf 内部 gRPC 协议，通过本地 Language Server 发给 Windsurf 云
3. 维护账号池，自动轮询 + 速率限制 + 故障转移
4. 返回前把上游 Windsurf 身份剥掉，模型自称"我是 Claude Opus 4.6 由 Anthropic 开发"

Claude Code / Cline / Cursor 怎么用

模型本身不会操作文件 — 文件操作是 IDE Agent 客户端（Claude Code / Cline 等）在本地执行的：

 你 "帮我改 bug"                Claude Code                    WindsurfAPI               Windsurf Cloud
   │                                │                               │                          │
   │────────────────────────────→  │                               │                          │
   │                                │  POST /v1/messages            │                          │
   │                                │  messages + tools + system    │                          │
   │                                │ ─────────────────────────────→│ 打包成 Cascade 请求      │
   │                                │                               │ ──────────────────────→  │
   │                                │                               │                          │
   │                                │                               │               模型思考 → 返回
   │                                │                               │               tool_use(edit_file)
   │                                │                               │ ←──────────────────────  │
   │                                │ ←── Anthropic SSE ────────────│                          │
   │                                │   content_block=tool_use      │                          │
   │                                │                               │                          │
   │                                │ 本地执行 edit_file()          │                          │
   │                                │ (读写本地文件)                │                          │
   │                                │                               │                          │
   │                                │ 带 tool_result 再发一轮       │                          │
   │                                │ ─────────────────────────────→│ ──────────────────────→  │
   │                                │                                             ... (循环) ...
   │                                │                               │                          │
   │  ← 最终答案                    │                               │                          │

重点：WindsurfAPI 只负责传递 tool_use / tool_result，真正改文件的是客户端 CLI。

快速开始

运行时要求：Node.js 22.13+（24.x 为发布门禁版本）。Node 20 已于 2026-04-30 EOL，不再支持； 本地 Windsurf 账号导入需要 22.13+ 免 flag 的 node:sqlite，更早的 22.x 会返回 sqlite_unavailable。

一键部署

git clone https://github.com/dwgx/WindsurfAPI.git
cd WindsurfAPI
bash setup.sh          # 建目录 · 配权限 · 生成 .env
node src/index.js

Dashboard：http://你的IP:3003/dashboard

Docker 部署

cp .env.example .env
# 空 API_KEY / DASHBOARD_PASSWORD 是 fail-closed（compose 默认 0.0.0.0，起来也是 401）。
# compose 默认 DEVIN_CONNECT=1，不跑 Language Server，不会自动下载 LS。
# 只有关掉 DEVIN_CONNECT、走 Cascade 时才会在缺二进制时尝试安装 LS。

docker compose up -d --build
docker compose logs -f

默认挂载：

• ./.docker-data/data：持久化 accounts.json、proxy.json、stats.json、runtime-config.json、model-access.json、logs/
• ./.docker-data/opt/windsurf：Language Server 二进制与数据目录
• ./.docker-data/tmp/windsurf-workspace：临时工作区

如果想改持久化目录，可在 .env 里设置 DATA_DIR。Docker 默认已设为 /data。

Docker 一键更新

Docker 部署用 deploy/update.sh：拉新镜像 → 只重建 windsurf-api → 等 /health → 失败自动回滚到上一个镜像；数据卷全程不动，不需要挂 docker.sock，也不需要 Watchtower。

bas