# 00bx-kiro-gateway 中文文档

规范地址：https://npmcn.com/package/00bx-kiro-gateway/

版本：1\.0\.9
npm 元数据更新时间：2026-02-09T13:05:33.513Z
中文译文更新时间：2026-10-31T10:23:56.406Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/00bx-kiro-gateway
原文对照：https://npmcn.com/package/00bx-kiro-gateway/?lang=original
项目主页：https://github.com/00bx/00bx-kiro-gateway#readme
源码仓库：https://github.com/00bx/00bx-kiro-gateway

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：199 kB，8 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-02-09T11:24:23.145Z
- 最新版本发布：2026-02-09T13:05:33.391Z
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

AI SDK提供商，允许OpenCode通过Kiro CLI的免费信用使用Claude模型

## 安装

```sh
npm install 00bx-kiro-gateway
```

也可以使用：`pnpm add 00bx-kiro-gateway`、`yarn add 00bx-kiro-gateway`、`bun add 00bx-kiro-gateway`

## README

# 00 bx-kiro-gateway

[AI SDK](https://sdk.vercel.ai/) 提供程序允许 [OpenCode](https://opencode.ai/) 使用克劳德模型 [Kiro CLI](https://kiro.dev/)该公司的免费信用额度。

## 它是如何工作的

[Kiro](https://kiro.dev/) 是亚马逊的AI IDE。它提供了克劳德模型的免费学分。当您登录到Kiro时，它会在本地存储授权令牌。这个包读取这些令牌并通过相同的后端路由OpenCode请求-所以你可以直接在OpenCode中使用你的Kiro免费信用。

## 模型

| 模型 | 配置ID | 状态 |
| --- | --- | --- |
| 克劳德十四行诗 | `claude-sonnet-4` | 工作 |
| 克劳德十四行诗4.5 | `claude-sonnet-4-5` | 工作 |
| 克劳德俳句4.5 | `claude-haiku-4-5` | 工作 |
| 克劳德作品4.5 | `claude-opus-4-5` | 当前被Kiro禁用（容量限制） |

> **Opus 4.5注：** 由于容量限制，Kiro的服务器已经禁用了Opus 4.5。配置包含在内，所以当Kiro重新启用它时，它会自动工作-不需要在您这边更新。

所有工作模型都支持流、工具使用和多回合对话。

## 设置

### 1\. 安装并登录到Kiro

```bash
brew install --cask kiro
```

或从 [kiro.dev](https://kiro.dev/).

打开基罗，用你的 **AWS构建器ID** （创建一个） [profile.aws](https://profile.aws.amazon.com/) （如果需要），然后可以关闭它。凭证保留在您的机器上。

### 2\. 安装OpenCode

```bash
curl -fsSL https://opencode.ai/install | bash
```

### 3\. 添加提供程序配置

编辑 `~/.config/opencode/opencode.json`：

```json
{
  "provider": {
    "kiro": {
      "npm": "00bx-kiro-gateway",
      "name": "Kiro Gateway",
      "models": {
        "claude-sonnet-4": {
          "name": "Claude Sonnet 4",
          "limit": { "context": 200000, "output": 8192 }
        },
        "claude-sonnet-4-5": {
          "name": "Claude Sonnet 4.5",
          "limit": { "context": 200000, "output": 8192 }
        },
        "claude-haiku-4-5": {
          "name": "Claude Haiku 4.5",
          "limit": { "context": 200000, "output": 8192 }
        },
        "claude-opus-4-5": {
          "name": "Claude Opus 4.5",
          "limit": { "context": 200000, "output": 8192 }
        }
      }
    }
  }
}
```

如果您已经配置了其他提供程序，请添加 `"kiro"` 在你现有的 `"provider"` 对象。

### 4\. 运行

```bash
# Interactive
opencode -m kiro/claude-sonnet-4

# Single command
opencode run -m kiro/claude-sonnet-4 "explain this codebase"
```

## 多个帐户

如果您有多个AWS Builder ID，您可以随时在Kiro IDE中进行切换。网关在下一次请求时自动检测帐户更改——它在每次API调用之前重新读取Kiro的本地数据库。当它看到不同的刷新令牌时，它会丢弃旧会话并开始使用新帐户的凭据。

这意味着您可以在帐户之间轮换使用每个帐户的免费层积分，而无需重新启动OpenCode。

## 故障排除

| 问题 | 修复 |
| --- | --- |
| `Kiro refresh token not found` | 打开Kiro IDE并登录。 |
| 空或无响应 | 你可能已经达到了利率上限。试一试 `claude-haiku-4-5` -它有最高的极限。 |
| 令牌/身份验证错误 | 重新打开Kiro IDE以刷新会话。 |
| Opus 4.5没有响应 | 由于容量问题，基罗暂时关闭了它。用十四行诗4或4.5代替。 |
| OpenCode不显示Kiro模型 | 检查你的 `opencode.json` 以获取有效的JSON（没有逗号）。 |

## 技术细节

1.  从其本地SQLite数据库读取Kiro CLI的刷新令牌(`bun:sqlite` → `better-sqlite3` → `sqlite3` CLI回退)
2.  通过Kiro的认证端点将其交换为一个短暂的访问令牌
3.  向AWS CodeWhisperer流API发送提示
4.  将AWS二进制事件流协议解析为AI SDK V2流格式
5.  处理令牌刷新、403重试、429/5xx回退、空闲流超时和工具调用积累

零运行时依赖项。与Bun和Node.js一起工作。

## 许可证

麻省理工学院- [00 bx](https://github.com/00bx)

## 常见问题

### 00bx-kiro-gateway 是什么？

AI SDK提供商，允许OpenCode通过Kiro CLI的免费信用使用Claude模型

### 如何安装 00bx-kiro-gateway？

在项目目录运行 npm install 00bx-kiro-gateway，或使用 pnpm add / yarn add / bun add。

### 00bx-kiro-gateway 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### 00bx-kiro-gateway 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### 00bx-kiro-gateway 可以商用吗？

00bx-kiro-gateway 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### 00bx-kiro-gateway 还在维护吗？

最新版本 1\.0\.9 发布于 2026/02/09（8 个月前）；至今共发布 10 个版本，其中过去 12 个月发布了 10 个；首次发布于 2026/02/09。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。