API Proxy Bridge 使用指南
v1.10.36 下载插件
API Proxy Bridge 图标

API Proxy Bridge 使用指南API Proxy Bridge — User Guide

一个 API Key，Cursor / Devin/Windsurf / Kiro 三端 IDE 通用，一键同步 Codex / Claude Code / WorkBuddy/ZCode 等主流 Agent 工具One Key, Three IDEs — Cursor, Devin/Windsurf, Kiro; sync to mainstream Agent tools such as Codex / Claude Code Desktop / WorkBuddy/ZCode.

开始配置Get started 下载 v1.10.36Download v1.10.36
独立开发工具Independent tool

本插件与 Kiro IDE、Devin、Windsurf、Cursor、AWS、Anthropic 无任何关联，仅提供 API 代理配置功能。请确保 API 使用符合服务商条款及当地法律法规。

This extension is an independent tool, not affiliated with Kiro IDE, Devin, Windsurf, Cursor, AWS or Anthropic. You are responsible for ensuring your API usage complies with vendor terms and local law.

Full step-by-step guide is in Chinese

This page's detailed sections (installation, configuration, troubleshooting) are written in Chinese. This banner and the overview/FAQ above are bilingual. For an English feature summary, see the README bundled with the VSIX package, or use your browser's translate feature for the rest of this page.

发布版本1.10.36
运行环境Cursor / Devin/Windsurf / Kiro
桌面同步Codex（ChatGPT 桌面版）/ Claude Code 桌面版 / WorkBuddy / ZCode 等主流 Agent 工具
API 基线VS Code 1.84+
NEW

What's new in v1.10.36

版本更新

v1.10.36 主要更新（2026-11-01）
  • Claude 桌面端 4.42 适配：新版桌面端把 3P 启动标志移到独立数据目录，插件同步现在同时写入新旧两个配置位置，桌面端升级后模型同步不再失效
  • 供应商配置自愈重建：桌面端升级清掉 3P provider 配置目录时，插件同步自动重建（指向本地网关 19804），模型列表不再「同步了却不显示」
  • 模型档位声明修复：同步到桌面端的模型自动标注官方档位（opus / sonnet 等），修复 Cowork / 任务中选择 Claude Sonnet 5.5 实际由 Opus 5.5 应答的问题
  • 桌面端升级指引：升级 Claude 桌面端后需开一次梯子让内置 Claude Code 组件（约 300MB）下载完成，下载完即可关闭；否则 Cowork / 任务报 binary not available，普通对话不受影响
  • 同步健壮性：Claude 桌面端同步新增专项自动化测试覆盖，全量 308 项测试通过

查看完整版本历史 →

Q&A

Common questions / 常见问题

Cursor / Windsurf / Kiro 自定义模型速答

Cursor 怎么用 DeepSeek 或自定义模型？ / How do I use DeepSeek in Cursor?

中文：安装 API Proxy Bridge 插件，在面板中填写 DeepSeek 的 Base URL 和 API Key，获取并添加模型，然后在 Cursor 的模型选择器中选择 API Proxy Bridge。免费版无需使用码即可使用。

English: Install API Proxy Bridge, enter your DeepSeek Base URL and API Key in the panel, fetch and add a model, then pick API Proxy Bridge in Cursor's model picker. The Free tier works without any activation code.

Windsurf（Devin）怎么接入自定义 API Key？ / How do I use a custom API key in Windsurf (Devin)?

中文：运行 install-start-devin-acp.ps1 注册 API Proxy Bridge Agent，然后在 Cascade 的 Agent Picker 中选择 API Proxy Bridge，并在该 Agent 的模型配置中选择你的模型。

English: Run install-start-devin-acp.ps1 to register the API Proxy Bridge Agent, then pick API Proxy Bridge in Cascade's Agent Picker and select your model in that agent's model settings.

Kiro 怎么接入便宜的 API Key？ / Can Kiro use a cheap OpenAI-compatible API key?

中文：API Proxy Bridge 可以让 Kiro IDE 使用任意 OpenAI-compatible 的 baseUrl 和 apiKey，例如 DeepSeek 或硅基流动，免费版即可使用，无需工具费。

English: Yes. API Proxy Bridge lets Kiro IDE use any OpenAI-compatible baseUrl and apiKey, such as DeepSeek or SiliconFlow, at no tool cost on the Free tier.

一个 API Key 能同时用在 Kiro、Windsurf、Cursor 和 Codex / Claude Code 上吗？ / Does one API key work across Kiro, Windsurf, Cursor and Codex / Claude Code at the same time?

中文：可以，这是插件的核心能力：一个 Key，三端 IDE 通用 + 桌面同步。在 API Proxy Bridge 中配置一次，即可在 Cursor、Devin/Windsurf、Kiro 三端 IDE 中直接使用同一套中转站和模型，并可一键同步 API Key 和配置到 Codex（ChatGPT 桌面版）、Claude Code 桌面版、WorkBuddy/ZCode 等主流 Agent 工具（注意：桌面工具是同步配置，不是安装插件）。

English: Yes — this is the core feature: One Key, Three IDEs + desktop sync. Configure once in API Proxy Bridge and use the same providers and models directly in Cursor, Devin/Windsurf and Kiro (with extension installed), and sync your API Key and configuration to mainstream Agent tools such as Codex (ChatGPT Desktop), Claude Code Desktop and WorkBuddy/ZCode with one click (note: desktop tools receive synced configurations, not extension installations).

DeepSeek 这类纯文本模型能识图吗？ / Do text-only models like DeepSeek support image input?

中文：可以。API Proxy Bridge 会自动借调有视觉能力的模型来识别图片并做兼容处理，让 DeepSeek 等纯文本模型在 IDE 中也能处理图片输入。

English: Yes. API Proxy Bridge automatically borrows a vision-capable model to read images and keeps compatibility, so text-only models such as DeepSeek can still handle image inputs in your IDE.

必须先买 CDK 使用码才能用吗？ / Do I need to buy a CDK code before I can use it?

中文：不需要。免费版无需任何使用码即可立即使用：Cursor / Devin/Windsurf / Kiro 三端桥接（固定首个中转站与首个令牌），四种端点协议全部可用，CLI 同步（Kiro / Devin 端）、验真模型、免费算力池、审批权限也已开放给免费版。CDK 使用码只用于解锁多中转站、故障切换、智能路由、Codex / Claude Code / WorkBuddy/ZCode 等主流 Agent 工具桌面同步等 Pro 功能，固定 ¥19.9/月 工具费，API 用量在你自己的 Key 上按量计费。

English: No. The Free tier works immediately without any code — Cursor, Devin/Windsurf and Kiro all bridged (first provider and first key), all four wire protocols, plus CLI sync (Kiro / Devin), model verification, free compute pool and approval permissions. A CDK code only unlocks Pro features such as unlimited providers, failover, smart routing and Codex / Claude Code / WorkBuddy/ZCode sync, for a fixed ¥19.9/month bridge fee; API usage is billed separately on your own key.

01

5 分钟完成

快速开始

  1. 1
    安装插件

    下载 VSIX；Devin/Windsurf 与 Cursor 还需运行对应安装脚本。

  2. 2
    启用使用码

    打开左侧 API Proxy Bridge 面板，输入 CDK 使用码。

  3. 3
    配置服务

    填写 Base URL、API Key，获取并选择模型。

  4. 4
    测试保存

    测试连接成功后保存配置并打开代理开关。

  5. 5
    开始使用

    Kiro 选择模型；Devin/Windsurf 选择 Agent；Cursor 在 Agent 模型选择器中选择 API Proxy Bridge。

首次配置建议

先添加一个中转站、一个 API Key 和一个模型。确认对话正常后，再配置多账号和故障切换。

1.10.36 提示

使用 Claude 桌面端（3P 模式）时，桌面端每次升级后请开一次梯子让内置 Claude Code 组件（约 300MB）下载完成，下载完即可关闭；否则 Cowork / 任务会报 binary not available（普通对话不受影响）。长会话继续支持上下文自动压缩与 413 自动恢复。CLI 同步（Kiro / Devin 端，免费版可用）、验真模型、免费算力池、审批权限保持开放；Token 优化（Pro）仅在激活状态下可用。超大粘贴（>200KB）会自动折叠为文件引用。

02

准备清单

使用前准备

  • 已安装并可正常启动的 Kiro IDE、Devin/Windsurf 或 Cursor IDE
  • api-proxy-bridge-1.10.36.vsix 安装包
  • 有效的 CDK 使用码
  • API 服务商提供的 Base URL 和 API Key
  • 服务商支持的模型名称及端点协议

Base URL 示例

https://api.example.com
https://api.example.com/v1
https://api.example.com/v1/responses

请填写服务商实际提供的地址，不要直接使用示例域名。

03

安装插件

下载与安装

已验证 IDE 版本与官方下载

以下版本已完成插件安装和接入测试。IDE 自动更新后如果插件异常，请优先回退到已验证版本，并重新运行对应安装脚本。

IDE已验证版本官方下载说明
Kiro IDE 1.4.62 Windows x64 1.4.62
macOS Apple Silicon 1.4.62
macOS Intel 1.4.62
官方版本页		 精确版本官方直链已验证可用，覆盖 Windows 与 macOS。
Devin Desktop（原 Windsurf） 官网发行版 3.10.48 Windows x64 3.10.48
macOS Apple Silicon 3.10.48
macOS Intel 3.10.48
官方历史版本页		 “关于”页与安装目录可能显示不同版本号，以官网发行版为准。精确版本官方直链已验证可用，覆盖 Windows 与 macOS。
Cursor 3.27.22 Windows x64 3.27 入口
macOS Apple Silicon 3.27 入口
macOS Intel 3.27 入口
官方版本页		 安装脚本支持 3.27.22（Windows，含 3.18.9 / 3.21.16 旧版本兼容）；macOS 官方入口直链已验证可用。官方入口会下载 3.27 系列的最新补丁版，不保证是精确版本；升级到更高补丁版时请等待安装脚本适配。
版本校验不能绕过

Devin/Windsurf 和 Cursor 的安装脚本会校验指定 IDE 版本或文件哈希。下载到更高补丁版本时，不要手动修改 IDE 文件，应等待插件安装脚本适配。

从 VSIX 安装

  1. 打开 Kiro IDE，进入左侧 Extensions / 扩展 页面。
  2. 点击扩展页面右上角的更多操作按钮。
  3. 选择 Install from VSIX... / 从 VSIX 安装...。
  4. 选择下载的 api-proxy-bridge-1.10.36.vsix。
  5. 等待安装完成，按提示重新加载窗口。
1扩展页面打开 Extensions
2更多操作选择 VSIX 安装
3重新加载完成插件安装

Devin / Windsurf：运行安装脚本

下载 install-start-devin-acp.ps1 到项目目录后，在该目录的 PowerShell 中运行：

.\install-start-devin-acp.ps1

脚本会安装主插件并完成所需配置，然后启动 IDE。随后在 Cascade 的 Agent Picker 中选择 API Proxy Bridge，再在该 Agent 的模型配置中选择插件模型。

也可以像 Kiro 一样免脚本安装：在 IDE 的扩展市场搜索「API Proxy Bridge」直接安装，或从本文档站下载 VSIX 安装包后拖拽到扩展面板（或 Install from VSIX）安装。市场版为核心功能版，不包含 CLI 端同步等宿主级增强；需要完整功能时使用安装脚本。

Cursor：运行安装脚本

下载 install-start-cursor.ps1 到项目目录后，在该目录运行：

.\install-start-cursor.ps1
不要手动修改 Cursor 文件

脚本会验证支持的 Cursor 版本和 workbench 文件哈希；因版本不匹配而停止时，请等待对应版本的脚本更新。

同样支持免脚本安装：在扩展市场搜索 API Proxy Bridge 直接安装，或从本文档站下载 VSIX 安装包后拖拽到扩展面板安装（与 Kiro 相同方式）。脚本安装会额外校验版本并完成 workbench 配置（模型选择器增强），需要完整体验时建议使用脚本。

确认安装成功

重新加载后，左侧活动栏应出现 API Proxy Bridge 图标。也可以打开命令面板并搜索：

API Proxy Bridge: Open Settings
04

授权管理

启用使用码

  1. 点击左侧活动栏的 API Proxy Bridge 图标。
  2. 在“使用码管理”区域输入 CDK 使用码。
  3. 点击 启用，等待页面显示使用状态和有效期。
CPROXY-XXXX-XXXX-XXXX-XXXX
操作用途
启用首次绑定当前设备
续费 / 换码延长授权或更换 CDK
刷新状态重新获取服务端授权状态
注销使用码释放当前设备名额
更换设备

建议先在旧设备点击“注销使用码”，确认名额释放后再在新设备启用。

05

连接服务商

配置中转站

  1. 在“当前使用”区域点击 新增中转站。
  2. 填写中转站名称，例如 Primary API。
  3. 填写服务商提供的 Base URL。
  4. 保持中转站为启用状态，点击 测试连接。
当前使用代理已启用
连接成功
结果常见原因
401 / 403API Key 无效、权限不足或鉴权方式错误
404Base URL 或端点位置不正确
429额度不足或服务商限流
5xx中转站或上游模型服务异常
连接超时网络、代理、DNS 或服务响应异常
06

选择协议与模型

配置 API Key 与模型

添加令牌

  1. 点击 新增令牌，填写令牌名称。
  2. 粘贴服务商提供的 API Key。
  3. 选择与服务商匹配的端点位置。
  4. 点击页面底部 保存。
密钥安全存储

API Key 使用编辑器 SecretStorage 保存，不会写入普通设置文件。再次打开面板时输入框留空是正常现象。

端点位置

协议适用服务
responsesOpenAI Responses API 兼容服务
chat_completionsOpenAI Chat Completions 兼容服务
claude_messagesAnthropic Messages API 兼容服务
geminiGemini API 兼容服务

获取并添加模型

  1. 点击 获取模型。
  2. 勾选需要使用的模型，可点击 检测选中 检查可用性。
  3. 点击 添加选中，设置推理强度后保存。

日常任务建议先使用 medium 或 high。推理强度越高，通常会消耗更多 Token，并增加首字等待时间。

07

验证连接

启用代理并开始使用

Kiro IDE

  1. 完成配置后点击 保存。
  2. 打开页面顶部的代理开关，确认没有授权或端口错误。
  3. 返回 Kiro Agent，选择 API Proxy Bridge 提供的模型。
  4. 发送测试消息验证响应。
请只回复：连接成功
模型目录刷新

新增、删除或修改模型并保存后，Kiro 会在模型缓存更新完成后自动完整重启。重新打开模型选择器即可看到最新目录。

Devin / Windsurf

  1. 保存配置并打开代理开关。
  2. 执行 API Proxy Bridge: Reload Devin/Windsurf Agent。
  3. 在 Cascade 的 Agent Picker 中选择 API Proxy Bridge。
  4. Agent 未出现时，在“诊断修复”中点击重新连接按钮。

插件模型不会出现在 Cascade 原生模型列表中，请在 API Proxy Bridge Agent 的模型配置中选择。

Cursor

  1. 确认已通过 install-start-cursor.ps1 安装并启动 Cursor。
  2. 保存中转站、API Key 和模型目录后，打开代理开关。
  3. 在 Agent 对话框的模型选择器中选择 API Proxy Bridge。
  4. 发送测试消息；新增模型后请完全重启 Cursor 再检查。
08

可用性策略

多中转站与故障切换

  • 将常用服务设置为较高优先级。
  • 为同一服务商的不同 API Key 添加清晰名称。
  • 修改后使用 测试全部 检查每个配置。
  • 暂时不用的中转站可以关闭，无需立即删除。

自动切换备用 Provider

开启后，当前服务遇到指定 HTTP 状态码时，可尝试其他可用服务。默认重试状态码：

429,500,502,503,504
数据流向变化

自动切换会把同一请求发送到备用服务商。请确认数据处理要求和费用策略允许后再启用。

09

用量观察

Token 监控

Token 监控用于查看当前模型的输入、输出、缓存和上下文占用。Token 优化（Pro）会自动启用 prompt caching，编码任务还可按 Lite / Full / Ultra 注入精简提示词。

  1. 在插件设置页打开“Token 监控”开关。
  2. Pro 用户可同时打开“Token 优化”，选择 Lite / Full / Ultra。
  3. 使用 Kiro Agent、Devin/Windsurf Agent 或 Cursor Agent 发起请求。
  4. 返回设置页查看累计统计与优化估算。
输入24.6K
输出3.2K
缓存18.1K
上下文38%

示意数据仅用于说明界面结构，不代表实际调用记录。

10

问题处理

常见问题

插件显示“未启用”怎么办？

检查 CDK 是否完整，点击“刷新状态”，并确认网络能够访问使用码服务。设备名额被占用时，先在原设备注销使用码。

获取不到模型列表

检查 Base URL 是否需要包含 /v1，确认 API Key 有查询模型权限。部分服务不提供标准 /models，需要配置自定义路径或手动确认模型名称。

粘贴超大文本后 Kiro 卡住或 Token 暴涨怎么办？

1.8.19 起，超过 200KB 的用户文本会自动折叠为临时文件引用，模型通过 read_file 读取全文。仍建议优先用文件引用而不是直接粘贴整份日志或源码。这是代理层缓解，Kiro 客户端本身的长上下文渲染卡死仍属上游缺陷。

macOS 上 Kiro / Devin / WORKBUDDY 容易断连怎么办？

请升级到最新版本。1.9.74 起本地代理只监听 127.0.0.1，并增加 ::1 伴随监听（含 Codex / 免费池 / Kiro CLI / ZCode），避免 macOS 防火墙拦截。升级后仍偶发断连时，检查「系统设置 → 网络 → 防火墙」是否拦截了 Kiro / node，或重启一次 IDE。

模型已添加，但 Kiro 中看不到

确认模型已勾选、添加并保存，等待 Kiro 自动完整重启后重新打开模型选择器。仍不显示时，在“诊断修复”中刷新诊断。

请求返回 401 或 403

API Key 可能无效、已过期或无模型权限；也可能是鉴权头或 Prefix 不匹配。更新密钥后重新测试连接。

请求返回 404

检查 Base URL 和端点位置，确认服务使用的是 responses、chat_completions、claude_messages 还是 gemini 协议。

请求返回 429

检查余额和调用额度，降低并发或稍后重试。也可以配置备用中转站并按需开启自动切换。

首次响应很慢或超时

将推理强度调低后测试，检查中转站网络质量和 Provider 超时设置。Claude 长上下文或思考模式通常需要更长等待时间。

端口启动失败

默认端口 19800 或 19801 可能被其他程序占用。关闭占用程序或修改插件端口后重新启用代理。

关闭插件后 Kiro 仍请求本地端口

打开命令面板执行以下命令。它会恢复 Kiro 官方服务设置，不会删除 API Key、模型列表或插件配置。

Restore Kiro Official Service
配置异常或提示存在冲突插件

先在“诊断修复”点击“刷新诊断”和“修复自身 / 端点”。确认冲突插件不再需要后，再执行删除操作。

Devin / Windsurf 中没有 API Proxy Bridge Agent

执行 API Proxy Bridge: Reload Devin/Windsurf Agent，然后重新打开 Agent Picker；仍未出现时，请重新运行对应安装脚本并重启 IDE。

Cursor 中没有 API Proxy Bridge 模型

确认通过 install-start-cursor.ps1 安装，而不是只手动安装 VSIX；保存至少一个已启用模型后，完全退出并重新启动 Cursor。

Claude 桌面端 Cowork / 任务报 “binary not available” 或 workspace 启动超时

桌面端每次升级后，内置 Claude Code 组件（约 300MB）需要按新版本重新从 Anthropic 服务器下载，该下载不走插件本地网关。开一次梯子（系统代理）并重启 Claude 桌面端，等待下载完成即可，下载完成后可以关闭梯子——插件中转的对话与模型请求始终走本地网关，不需要梯子。普通对话不受此影响，仅 Cowork / 任务（agent）需要该组件。企业内网完全无法开梯子时，可向管理员索取离线组件包，解压放置到 %LOCALAPPDATA%\Claude-3p\ 下的 claude-code 与 claude-code-vm（需与桌面端版本匹配）。

Claude 桌面端升级后模型列表消失或显示官方模型

升级到 1.10.36 或更高版本插件后，在 APB 面板重新执行一次同步：插件会同时写入新版桌面端读取的 3P 启动标志位置，并自动重建缺失的供应商配置（configLibrary），然后完全退出并重新启动 Claude 桌面端即可恢复模型列表。

11

版本维护

升级与卸载

升级插件

  1. 下载新版本 VSIX。
  2. 在扩展页面选择“从 VSIX 安装”，确认覆盖安装。
  3. Kiro 重新加载窗口；Devin/Windsurf 和 Cursor 运行对应安装脚本或重载窗口后，检查授权和配置。
  4. 测试连接并发送测试消息。

卸载插件

  1. 先执行 Restore Kiro Official Service。
  2. 如需释放设备名额，点击“注销使用码”。
  3. 在扩展页面卸载 API Proxy Bridge。
  4. 重新加载 Kiro IDE。

Cursor 卸载前，请在项目根目录运行 .\install-start-cursor.ps1 -Restore 恢复脚本所做的配置，再卸载扩展并重启 Cursor。

12

安全建议

安全说明

  • 不要在聊天、截图或公开文档中展示完整 API Key、CDK 或 Cookie。
  • 只从正式渠道下载安装包，并在安装前核对 SHA-256。
  • 调试日志不应包含消息正文、工具输出、凭据或响应正文。
  • 开启备用 Provider 前，确认各服务商的数据处理规则。

校验安装包

Get-FileHash .\api-proxy-bridge-1.10.36.vsix -Algorithm SHA256
预期 SHA-256 eaa02c6863f6bb9ec02dc717cd80f6cb38483490b0d636f7c815feb3993132c4
校验不一致时不要安装

重新从正式渠道下载，并再次核对文件版本与哈希值。

API Proxy Bridge

适用于 Cursor、Devin/Windsurf 与 Kiro 的 OpenAI-compatible API 代理插件，可一键同步到 Codex / Claude Code / WorkBuddy/ZCode 等主流 Agent 工具。

OpenAI-compatible API bridge for Cursor, Devin/Windsurf and Kiro, with one-click sync to mainstream Agent tools such as Codex, Claude Code Desktop and WorkBuddy/ZCode.

文档版本 1.10.36 Docs version 1.10.36 更新日期 2026-10-22 Updated 2026-10-22 Copyright © 2026 API Proxy Bridge. All rights reserved.