🤖 可用模型

⚠️ 重要提示： 模型的可用性取决于您的 Kiro 套餐级别（免费/付费）。网关会根据您的订阅情况，提供您在 IDE 或 CLI 中可用的任何模型。以下列表显示的是通常在 免费套餐 中可用的模型。

🔒 Claude Opus 4.5 已于 2026 年 1 月 17 日从免费套餐中移除。它可能在付费套餐中可用——请检查您的 IDE/CLI 模型列表。

🚀 Claude Sonnet 4.5 — 性能均衡。非常适合编码、写作和通用任务。

⚡ Claude Haiku 4.5 — 极速响应。非常适合快速回复、简单任务和聊天。

📦 Claude Sonnet 4 — 上一代模型。对于大多数用例仍然强大且可靠。

📦 Claude 3.7 Sonnet — 旧版模型。可用于向后兼容。

🐋 DeepSeek-V3.2 — 开源 MoE 模型（685B 参数，37B 激活）。在编码、推理和通用任务方面表现均衡。

🧩 MiniMax M2.1 — 开源 MoE 模型（230B 参数，10B 激活）。非常适合复杂任务、规划和多步骤工作流。

🤖 Qwen3-Coder-Next — 开源 MoE 模型（80B 参数，3B 激活）。专注于编码。非常适合开发和大型项目。

💡 智能模型解析： 您可以使用任何模型名称格式——claude-sonnet-4-5、claude-sonnet-4.5，甚至带有版本号的名称，如 claude-sonnet-4-5-20250929。网关会自动将其标准化。

✨ 功能

🚀 快速入门

选择您的部署方式：

• 🐍 原生 Python - 完全控制，易于调试
• 🐳 Docker - 隔离环境，易于部署 → 跳转到 Docker 部署

先决条件

• Python 3.10+
• 满足以下条件之一：
  • 已登录账户的 Kiro IDE，或
  • 使用 AWS SSO（AWS IAM Identity Center，OIDC）的 Kiro CLI——免费的 Builder ID 或企业账户

安装

# 克隆仓库（需要 Git）
git clone https://github.com/Jwadow/kiro-gateway.git
cd kiro-gateway

# 或下载 ZIP：代码 → 下载 ZIP → 解压 → 打开 kiro-gateway 文件夹

# 安装依赖
pip install -r requirements.txt

# 配置（参见“配置”部分）
cp .env.example .env
# 复制并编辑 .env 文件以填写您的凭据

# 启动服务器
python main.py

# 或者使用自定义端口（如果 8000 端口已被占用）
python main.py --port 9000

服务器将在 http://localhost:8000 上可用。

⚙️ 配置

选项 1：JSON 凭证文件（Kiro IDE / 企业）

指定凭证文件的路径：

适用于：

• Kiro IDE（标准）——用于个人账户
• 企业——用于具有 SSO 的企业账户

KIRO_CREDS_FILE="~/.aws/sso/cache/kiro-auth-token.json"

# 用于保护您的代理服务器的密码（任意安全字符串）
# 您将在连接到网关时将其用作 api_key
PROXY_API_KEY="my-super-secret-password-123"

{
  "accessToken": "eyJ...",
  "refreshToken": "eyJ...",
  "expiresAt": "2025-01-12T23:00:00.000Z",
  "profileArn": "arn:aws:codewhisperer:us-east-1:...",
  "region": "us-east-1",
  "clientIdHash": "abc123..."  // 可选：用于企业 SSO 设置
}

选项 2：环境变量（.env 文件）

在项目根目录下创建一个 .env 文件：

# 必需
REFRESH_TOKEN="your_kiro_refresh_token"

# 用于保护您的代理服务器的密码（任意安全字符串）
PROXY_API_KEY="my-super-secret-password-123"

# 可选
PROFILE_ARN="arn:aws:codewhisperer:us-east-1:..."
KIRO_REGION="us-east-1"

选项 3：AWS SSO 凭证（kiro-cli / 企业）

如果您使用 kiro-cli 或带有 AWS SSO（AWS IAM Identity Center）的 Kiro IDE，网关会自动检测并使用相应的身份验证信息。

适用于免费的 Builder ID 账户和企业账户。

KIRO_CREDS_FILE="~/.aws/sso/cache/your-sso-cache-file.json"

# 用于保护您的代理服务器的密码
PROXY_API_KEY="my-super-secret-password-123"

# 注意：对于 AWS SSO（Builder ID 和企业账户），无需提供 PROFILE_ARN

# 网关在没有它的情况下也能正常工作

{
  "accessToken": "eyJ...",
  "refreshToken": "eyJ...",
  "expiresAt": "2025-01-12T23:00:00.000Z",
  "region": "us-east-1",
  "clientId": "...",
  "clientSecret": "..."
}

选项 4：kiro-cli SQLite 数据库

如果您使用 kiro-cli 并希望直接使用其 SQLite 数据库：

KIRO_CLI_DB_FILE="~/.local/share/kiro-cli/data.sqlite3"

# 用于保护您代理服务器的密码
PROXY_API_KEY="my-super-secret-password-123"

# 注意：对于 AWS SSO（Builder ID 和企业账户），PROFILE_ARN 并非必需
# 网关在没有它的情况下也能正常工作

获取凭证

对于 Kiro IDE 用户：

• 登录 Kiro IDE，并使用上述选项 1（JSON 凭证文件）
• 登录后会自动创建凭证文件

对于 Kiro CLI 用户：

• 使用 kiro-cli login 登录，并使用上述选项 3 或选项 4
• 无需手动提取令牌！

🐳 Docker 部署

基于 Docker 的部署。 如果您更喜欢原生 Python，请参阅上方的【快速入门】部分。

快速入门

# 1. 克隆并配置
git clone https://github.com/Jwadow/kiro-gateway.git
cd kiro-gateway
cp .env.example .env
# 根据您的凭证编辑 .env 文件

# 2. 使用 docker-compose 运行
docker-compose up -d

# 3. 检查状态
docker-compose logs -f
curl http://localhost:8000/health

不使用 Compose 的 Docker 运行

docker run -d \
  -p 8000:8000 \
  -e PROXY_API_KEY="my-super-secret-password-123" \
  -e REFRESH_TOKEN="your_refresh_token" \
  --name kiro-gateway \
  ghcr.io/jwadow/kiro-gateway:latest

docker run -d \
  -p 8000:8000 \
  -v ~/.aws/sso/cache:/home/kiro/.aws/sso/cache:ro \
  -e KIRO_CREDS_FILE=/home/kiro/.aws/sso/cache/kiro-auth-token.json \
  -e PROXY_API_KEY="my-super-secret-password-123" \
  --name kiro-gateway \
  ghcr.io/jwadow/kiro-gateway:latest

docker run -d `
  -p 8000:8000 `
  -v ${HOME}/.aws/sso/cache:/home/kiro/.aws/sso/cache:ro `
  -e KIRO_CREDS_FILE=/home/kiro/.aws/sso/cache/kiro-auth-token.json `
  -e PROXY_API_KEY="my-super-secret-password-123" `
  --name kiro-gateway `
  ghcr.io/jwadow/kiro-gateway:latest

docker run -d -p 8000:8000 --env-file .env --name kiro-gateway ghcr.io/jwadow/kiro-gateway:latest

Docker Compose 配置

编辑 docker-compose.yml 文件，取消注释适用于您操作系统的卷挂载：

volumes:
  # Kiro IDE 凭证（选择您的操作系统）
  - ~/.aws/sso/cache:/home/kiro/.aws/sso/cache:ro              # Linux/macOS
  # - ${USERPROFILE}/.aws/sso/cache:/home/kiro/.aws/sso/cache:ro  # Windows
  
  # kiro-cli 数据库（选择您的操作系统）
  - ~/.local/share/kiro-cli:/home/kiro/.local/share/kiro-cli:ro  # Linux/macOS
  # - ${USERPROFILE}/.local/share/kiro-cli:/home/kiro/.local/share/kiro-cli:ro  # Windows
  
  # 调试日志（可选）
  - ./debug_logs:/app/debug_logs

管理命令

docker-compose logs -f      # 查看日志
docker-compose restart      # 重启
docker-compose down         # 停止
docker-compose pull && docker-compose up -d  # 更新

docker build -t kiro-gateway .
docker run -d -p 8000:8000 --env-file .env kiro-gateway

🌐 VPN/代理支持

适用于中国、企业网络或与 AWS 服务连接存在问题的地区的用户。

网关支持将所有 Kiro API 请求通过 VPN 或代理服务器路由。如果您遇到与 AWS 端点的连接问题，或者需要使用企业代理，此功能至关重要。

配置

在 .env 文件中添加以下内容：

# HTTP 代理
VPN_PROXY_URL=http://127.0.0.1:7890

# SOCKS5 代理
VPN_PROXY_URL=socks5://127.0.0.1:1080

# 带身份验证（企业代理）
VPN_PROXY_URL=http://username:password@proxy.company.com:8080

# 不指定协议（默认为 http://）
VPN_PROXY_URL=192.168.1.100:8080

支持的协议

• ✅ HTTP — 标准代理协议
• ✅ HTTPS — 安全代理连接
• ✅ SOCKS5 — 高级代理协议（常见于 VPN 软件）
• ✅ 身份验证 — 用户名/密码嵌入在 URL 中

适用场景

常用支持代理的 VPN 软件

大多数 VPN 客户端都会提供本地代理服务器供您使用：

• Sing-box — 现代化 VPN 客户端，支持 HTTP/SOCKS5 代理
• Clash — 通常运行在 http://127.0.0.1:7890
• V2Ray — 可配置 SOCKS5/HTTP 代理
• Shadowsocks — 支持 SOCKS5 代理
• 企业 VPN — 请咨询 IT 部门获取代理设置

如果您不需要代理支持，请将 VPN_PROXY_URL 留空（默认值）。

📡 API 参考

终端节点

💡 使用示例

OpenAI API

curl http://localhost:8000/v1/chat/completions \
  -H "Authorization: Bearer my-super-secret-password-123" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": true
  }'

curl http://localhost:8000/v1/chat/completions \
  -H "Authorization: Bearer my-super-secret-password-123" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "What is 2+2?"}
    ],
    "stream": true
  }'

curl http://localhost:8000/v1/chat/completions \
  -H "Authorization: Bearer my-super-secret-password-123" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "messages": [{"role": "user", "content": "What is the weather in London?"}],
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Get weather for a location",
        "parameters": {
          "type": "object",
          "properties": {
            "location": {"type": "string", "description": "City name"}
          },
          "required": ["location"]
        }
      }
    }]
  }'

from openai import OpenAI

client = OpenAI(
    base_url="http://localhost:8000/v1",
    api_key="my-super-secret-password-123"  # Your PROXY_API_KEY from .env
)

response = client.chat.completions.create(
    model="claude-sonnet-4-5",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello!"}
    ],
    stream=True
)

for chunk in response:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    base_url="http://localhost:8000/v1",
    api_key="my-super-secret-password-123",  # Your PROXY_API_KEY from .env
    model="claude-sonnet-4-5"
)

response = llm.invoke("Hello, how are you?")
print(response.content)

Anthropic API

curl http://localhost:8000/v1/messages \
  -H "x-api-key: my-super-secret-password-123" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

curl http://localhost:8000/v1/messages \
  -H "x-api-key: my-super-secret-password-123" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "system": "You are a helpful assistant.",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

curl http://localhost:8000/v1/messages \
  -H "x-api-key: my-super-secret-password-123" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "stream": true,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

import anthropic

client = anthropic.Anthropic(
    api_key="my-super-secret-password-123",  # Your PROXY_API_KEY from .env
    base_url="http://localhost:8000"
)

# 非流式
response = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)
print(response.content[0].text)

# 流式
with client.messages.stream(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

🔧 调试

调试日志默认是禁用的。要启用，请在你的 .env 文件中添加：

# 调试日志模式：
# - off: 禁用（默认）
# - errors: 只保存失败请求的日志（4xx、5xx）——推荐用于故障排除
# - all: 保存每次请求的日志（每次请求都会覆盖）
DEBUG_MODE=errors

调试模式

调试文件

启用后，请求会被记录到 debug_logs/ 文件夹中：

📜 许可证

本项目采用 GNU Affero General Public License v3.0 (AGPL-3.0) 许可证。

这意味着：

• ✅ 你可以使用、修改和分发此软件
• ✅ 你可以将其用于商业目的
• ⚠️ 当你分发软件时，必须公开源代码
• ⚠️ 网络使用即为分发 —— 如果你在服务器上运行修改后的版本，并允许他人与其交互，你必须向他们提供源代码
• ⚠️ 修改后的版本必须以相同的许可证发布

完整的许可证文本请参阅 LICENSE 文件。

为什么选择 AGPL-3.0？

AGPL-3.0 确保对本软件的改进能够惠及整个社区。如果你修改了这个网关并将其部署为一项服务，你必须与用户分享你的改进成果。

贡献者许可协议（CLA）

通过向本项目提交贡献，即表示您同意我们的贡献者许可协议（CLA）中的条款。这确保：

• 您有权提交该贡献
• 您授予维护者使用和重新授权您贡献的权利
• 项目在法律上得到保护

💖 支持本项目

如果这个项目为您节省了时间和金钱，请考虑支持它！

您的每一份贡献都有助于让该项目持续发展并保持活力。

🤑 捐赠

☕ 一次性捐赠  •  💎 每月支持

🪙 或发送加密货币

币种	网络	地址
USDT	TRC20	TSVtgRc9pkC1UgcbVeijBHjFmpkYHDRu26
BTC	比特币	12GZqxqpcBsqJ4Vf1YreLqwoMGvzBPgJq6
ETH	以太坊	0xc86eab3bba3bbaf4eb5b5fff8586f1460f1fd395
SOL	Solana	9amykF7KibZmdaw66a1oqYJyi75fRqgdsqnG66AK3jvh
TON	TON	UQBVh8T1H3GI7gd7b-_PPNnxHYYxptrcCVf3qQk5v41h3QTM

⚠️ 免责声明

本项目与亚马逊云服务（AWS）、Anthropic 或 Kiro IDE 无任何关联、背书或赞助关系。请自行承担使用风险，并遵守相关 API 的服务条款。

Kiro Gateway 快速上手指南

Kiro Gateway 是一个代理网关，旨在将 Amazon Q Developer (原 AWS CodeWhisperer/Kiro) 的 API 转换为 OpenAI 或 Anthropic 兼容格式。通过它，你可以在 Cursor、Cline、OpenCode 等工具中使用 Claude 系列模型及其他大模型。

环境准备

在开始之前，请确保满足以下系统要求和前置条件：

• 操作系统：Linux, macOS 或 Windows
• Python 版本：Python 3.10 或更高版本
• 账号要求（二选一）：
  • 已登录的 Kiro IDE 账号
  • 已登录的 Kiro CLI (支持 AWS Builder ID 免费账号或企业 SSO 账号)
• 网络环境：由于服务依赖 AWS 接口，中国大陆用户建议配置代理（见配置部分）。

安装步骤

1. 获取代码

使用 Git 克隆仓库或下载源码包：

git clone https://github.com/Jwadow/kiro-gateway.git
cd kiro-gateway

2. 安装依赖

推荐使用国内镜像源加速安装：

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

3. 配置文件

复制示例配置文件并编辑：

cp .env.example .env

使用文本编辑器打开 .env 文件，根据你的登录方式选择以下一种配置方案：

方案 A：使用 Kiro IDE 凭证（推荐个人用户）

如果你已安装并登录了 Kiro IDE，网关会自动读取缓存文件。

# 指向 Kiro IDE 的凭证文件路径 (通常无需修改)
KIRO_CREDS_FILE="~/.aws/sso/cache/kiro-auth-token.json"

# 设置访问网关的密码 (自定义一个安全字符串，后续在客户端作为 API Key 使用)
PROXY_API_KEY="my-super-secret-password-123"

方案 B：使用 Kiro CLI 凭证

如果你使用命令行工具，先执行 kiro-cli login 登录，然后配置：

# 指向 CLI 的凭证文件或数据库
KIRO_CREDS_FILE="~/.aws/sso/cache/your-sso-cache-file.json"
# 或者直接使用 SQLite 数据库:
# KIRO_CLI_DB_FILE="~/.local/share/kiro-cli/data.sqlite3"

PROXY_API_KEY="my-super-secret-password-123"

方案 C：手动填入 Token

如果无法自动读取，可手动填入刷新令牌：

REFRESH_TOKEN="your_kiro_refresh_token"
PROXY_API_KEY="my-super-secret-password-123"
PROFILE_ARN="arn:aws:codewhisperer:us-east-1:..." # 可选
KIRO_REGION="us-east-1"

注意：中国大陆用户若连接 AWS 服务受阻，需在 .env 中添加代理配置：

VPN_PROXY_URL=http://127.0.0.1:7890
# 或 SOCKS5 代理
# VPN_PROXY_URL=socks5://127.0.0.1:1080

基本使用

1. 启动服务

在终端运行以下命令启动网关：

python main.py

若默认端口 8000 被占用，可指定其他端口：

python main.py --port 9000

启动成功后，服务将运行在 http://localhost:8000。

2. 连接到 AI 客户端

以 Cursor 或 Cline 为例进行配置：

• API Provider: 选择 OpenAI Compatible 或 Anthropic Compatible (均支持)
• Base URL: http://localhost:8000/v1 (OpenAI 格式) 或 http://localhost:8000 (Anthropic 格式)
• API Key: 填写你在 .env 中设置的 PROXY_API_KEY (例如：my-super-secret-password-123)
• Model Name: 输入模型名称，网关会自动识别格式。
  • 推荐尝试：claude-sonnet-4-5, claude-haiku-4-5, deepseek-v3.2

3. 验证连接

你可以使用 curl 简单测试服务是否健康：

curl http://localhost:8000/health

如果返回正常响应，即可在支持的 IDE 插件中开始使用 Kiro 提供的模型进行编程辅助。