Getting‐Started

快速开始

方式一：下载预编译版本

从 Releases 下载对应平台的安装包：

平台	文件
Windows	KiroProxy-x.x.x-Windows.zip
macOS	KiroProxy-x.x.x-macOS.zip
Linux	KiroProxy-x.x.x-Linux.tar.gz
Linux (deb)	kiroproxy_x.x.x_amd64.deb
Linux (rpm)	kiroproxy-x.x.x-1.x86_64.rpm

解压后直接运行即可。

方式二：从源码运行

# 克隆项目
git clone https://github.com/petehsu/KiroProxy.git
cd KiroProxy

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

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

# 运行
python run.py

# 指定端口
python run.py 8081
获取 Token
打开 Kiro IDE
点击登录，使用 Google / GitHub 账号
登录成功后 token 自动保存到 ~/.aws/sso/cache/
访问 http://localhost:8080
在 Web UI 点击「扫描 Token」添加账号
验证安装
curl http://localhost:8080/v1/models

---

**CLI-Configuration 页面：**

```markdown
# CLI 配置指南

## 模型对照表

| Kiro 模型 | 能力 | 推荐场景 |
|-----------|------|----------|
| `claude-sonnet-4` | ⭐⭐⭐ | 日常开发，性价比最高 |
| `claude-sonnet-4.5` | ⭐⭐⭐⭐ | 复杂任务 |
| `claude-haiku-4.5` | ⚡ 快速 | 简单问答、代码补全 |
| `claude-opus-4.5` | ⭐⭐⭐⭐⭐ | 最强推理能力 |

## Claude Code (VSCode 插件)

> ✅ 主要测试客户端，工具调用功能已验证

**配置步骤：**

1. 打开 Claude Code 设置
2. 选择 "Custom API Provider"
3. 填写：
   - **名称**: Kiro Proxy
   - **API Key**: `any` (任意值)
   - **Base URL**: `http://localhost:8080`
   - **模型**: `claude-sonnet-4`

## Codex CLI

**配置：**
名称: Kiro Proxy API Key: any Endpoint: http://localhost:8080/v1 模型: gpt-4o


**模型映射：**
| Codex 模型 | 实际调用 |
|------------|----------|
| `gpt-4o` | claude-sonnet-4 |
| `gpt-4o-mini` | claude-haiku-4.5 |
| `o1` | claude-opus-4.5 |

## Gemini CLI

**配置：**
名称: Kiro Proxy API Key: any Base URL: http://localhost:8080 模型: gemini-2.0-flash



**模型映射：**
| Gemini 模型 | 实际调用 |
|-------------|----------|
| `gemini-2.0-flash` | claude-sonnet-4 |
| `gemini-1.5-pro` | claude-sonnet-4.5 |
| `gemini-1.5-flash` | claude-haiku-4.5 |