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

一个 API Key，Kiro / Devin/Windsurf / Cursor 三端通用，一键同步 Codex / Claude CodeOne Key, Three IDEs — Kiro, Devin/Windsurf, Cursor; sync to Codex / Claude Code Desktop.

开始配置Get started 下载 v1.7.97Download v1.7.97

独立开发工具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.7.97

运行环境Kiro / Devin/Windsurf / Cursor

桌面同步Codex（ChatGPT 桌面版）/ Claude Code 桌面版

API 基线VS Code 1.84+

NEW

What's new in v1.7.97

版本更新

v1.7.97 主要更新（2026-09-07）

ACP 会话恢复（NEW）：Windsurf/Devin 会话中断后可续接上下文继续对话，无需重开会话
ACP 空响应兜底与内容隔离：模型空响应自动兜底重试，可疑工具输出隔离防止污染上下文
ACP Claude 思维链支持：Windsurf/Devin 端透传 Claude thinking，含 Bedrock beta 标志重试
Cursor 权限门（permission gate）：权限等级面板可点击调整，工具执行前按层级确认
模型验真、四端桥接 + 四种协议、智能路由（AUTO）三档全量保留

查看完整版本历史 →

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 中配置一次，即可在 Kiro、Devin/Windsurf、Cursor 三端 IDE 中直接使用同一套中转站和模型，并可一键同步 API Key 和配置到 Codex（ChatGPT 桌面版）和 Claude Code 桌面版（注意：Codex 和 Claude Code 是同步配置，不是安装插件）。

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 Kiro, Devin/Windsurf and Cursor (with extension installed), and sync your API Key and configuration to Codex (ChatGPT Desktop) and Claude Code Desktop with one click (note: Codex and Claude Code 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?

中文：不需要。免费版无需任何使用码即可立即使用：Kiro / Devin/Windsurf / Cursor 三端桥接（固定首个中转站与首个令牌），四种端点协议全部可用。CDK 使用码只用于解锁多中转站、故障切换、智能路由、Codex 同步等 Pro 功能，固定 ¥19.9/月 工具费，API 用量在你自己的 Key 上按量计费。

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

01

5 分钟完成

快速开始

1
安装插件
下载 VSIX；Devin/Windsurf 与 Cursor 还需运行对应安装脚本。
2
启用使用码
打开左侧 API Proxy Bridge 面板，输入 CDK 使用码。
3
配置服务
填写 Base URL、API Key，获取并选择模型。
4
测试保存
测试连接成功后保存配置并打开代理开关。
5
开始使用
Kiro 选择模型；Devin/Windsurf 选择 Agent；Cursor 在 Agent 模型选择器中选择 API Proxy Bridge。

首次配置建议

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

1.7.97 提示

注销使用码或 Pro 到期切回免费版后，Kiro 会将模型目录收缩为首个中转站、首个令牌的相关模型，并自动完整重启以清除对话框旧列表。在线授权短暂超时仍会静默重试。需要复现测试结果时，可在账号级配置固定采样参数（如 temperature: 0）。

02

准备清单

使用前准备

已安装并可正常启动的 Kiro IDE、Devin/Windsurf 或 Cursor IDE
api-proxy-bridge-1.7.97.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.0.89`	Windows x64 1.0.89 官方版本页	精确版本官方直链已验证可用。
Devin Desktop（原 Windsurf）	官网发行版 `3.4.27` 内部版本 `1.110.1`	Windows x64 3.4.27 官方历史版本页	“关于”页与安装目录可能显示不同版本号，以官网发行版为准。
Cursor	`3.18.9`	Windows x64 3.18 入口官方版本页	官方入口会下载 3.18 系列最新补丁版，不保证仍为 3.18.9；官方暂未提供 3.18.9 的公开精确版本直链。

版本校验不能绕过

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

从 VSIX 安装

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

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 的模型配置中选择插件模型。

Cursor：运行安装脚本

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

.\install-start-cursor.ps1

不要手动修改 Cursor 文件

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

确认安装成功

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

API Proxy Bridge: Open Settings

04

授权管理

启用使用码

点击左侧活动栏的 API Proxy Bridge 图标。
在“使用码管理”区域输入 CDK 使用码。
点击启用，等待页面显示使用状态和有效期。

CPROXY-XXXX-XXXX-XXXX-XXXX

操作	用途
启用	首次绑定当前设备
续费 / 换码	延长授权或更换 CDK
刷新状态	重新获取服务端授权状态
注销使用码	释放当前设备名额

更换设备

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

05

连接服务商

配置中转站

在“当前使用”区域点击 新增中转站。
填写中转站名称，例如 Primary API。
填写服务商提供的 Base URL。
保持中转站为启用状态，点击 测试连接。

当前使用代理已启用

中转站名称 Base URL

连接成功

结果	常见原因
`401 / 403`	API Key 无效、权限不足或鉴权方式错误
`404`	Base URL 或端点位置不正确
`429`	额度不足或服务商限流
`5xx`	中转站或上游模型服务异常
连接超时	网络、代理、DNS 或服务响应异常

06

选择协议与模型

配置 API Key 与模型

添加令牌

点击 新增令牌，填写令牌名称。
粘贴服务商提供的 API Key。
选择与服务商匹配的端点位置。
点击页面底部保存。

密钥安全存储

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

端点位置

协议	适用服务
`responses`	OpenAI Responses API 兼容服务
`chat_completions`	OpenAI Chat Completions 兼容服务
`claude_messages`	Anthropic Messages API 兼容服务
`gemini`	Gemini API 兼容服务

获取并添加模型

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

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

07

验证连接

启用代理并开始使用

Kiro IDE

完成配置后点击保存。
打开页面顶部的代理开关，确认没有授权或端口错误。
返回 Kiro Agent，选择 API Proxy Bridge 提供的模型。
发送测试消息验证响应。

请只回复：连接成功

模型目录刷新

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

Devin / Windsurf

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

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

Cursor

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

08

可用性策略

多中转站与故障切换

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

自动切换备用 Provider

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

429,500,502,503,504

数据流向变化

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

09

用量观察

Token 监控

Token 监控用于查看当前模型的输入、输出、缓存和上下文占用。

在插件设置页打开“Token 监控”开关。
使用 Kiro Agent、Devin/Windsurf Agent 或 Cursor Agent 发起请求。
返回设置页查看累计统计。

输入24.6K

输出3.2K

缓存18.1K

上下文38%

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

10

问题处理

常见问题

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

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

获取不到模型列表

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

模型已添加，但 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。

11

版本维护

升级与卸载

升级插件

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

卸载插件

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

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

12

安全建议

安全说明

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

校验安装包

Get-FileHash .\api-proxy-bridge-1.7.97.vsix -Algorithm SHA256

预期 SHA-256 6e541c0a2ee81333891184774106ea1a298d255f5417e6bc3e52380b34eac02a

校验不一致时不要安装

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