File size: 3,756 Bytes
d3cadd5 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 |
# 快速开始
## 安装运行
### 方式一：下载预编译版本
从 [Releases](https://github.com/yourname/kiro-proxy/releases) 下载对应平台的安装包：
- **Windows**: `kiro-proxy-windows.zip`
- **macOS**: `kiro-proxy-macos.zip`
- **Linux**: `kiro-proxy-linux.tar.gz`
解压后双击运行即可。
### 方式二：从源码运行
```bash
# 克隆项目
git clone https://github.com/yourname/kiro-proxy.git
cd kiro-proxy
# 创建虚拟环境
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
# 安装依赖
pip install -r requirements.txt
# 运行（默认端口 8080）
python run.py
# 指定端口
python run.py 8081
```
启动成功后，访问 http://localhost:8080 打开管理界面。
---
## 获取 Kiro 账号
Kiro Proxy 需要 Kiro 账号的 Token 才能工作。有两种方式获取：
### 方式一：在线登录（推荐）
1. 打开 Web UI，点击「账号」标签页
2. 点击「在线登录」按钮
3. 选择登录方式：
- **Google** - 使用 Google 账号
- **GitHub** - 使用 GitHub 账号
- **AWS** - 使用 AWS Builder ID
4. 在弹出的浏览器中完成授权
5. 授权成功后，账号自动添加到代理
### 方式二：扫描本地 Token
如果你已经在 Kiro IDE 中登录过：
1. 打开 Kiro IDE，确保已登录
2. 回到 Web UI，点击「扫描 Token」
3. 系统会扫描 `~/.aws/sso/cache/` 目录
4. 选择要添加的 Token 文件
---
## 配置 AI 客户端
### Claude Code (VSCode 插件)
这是最推荐的使用方式，工具调用功能已验证可用。
1. 安装 Claude Code 插件
2. 打开设置，添加自定义 Provider：
```
名称: Kiro Proxy
API Provider: Anthropic
API Key: any（随便填一个）
Base URL: http://localhost:8080
模型: claude-sonnet-4
```
3. 选择 Kiro Proxy 作为当前 Provider
### Codex CLI
OpenAI 官方命令行工具。
```bash
# 安装
npm install -g @openai/codex
# 配置 (~/.codex/config.toml)
model = "gpt-4o"
model_provider = "kiro"
[model_providers.kiro]
name = "Kiro Proxy"
base_url = "http://localhost:8080/v1"
```
### Gemini CLI
```bash
# 设置环境变量
export GEMINI_API_BASE=http://localhost:8080/v1
# 或在配置文件中设置
base_url = "http://localhost:8080/v1"
model = "gemini-pro"
```
### 其他兼容客户端
任何支持 OpenAI 或 Anthropic API 的客户端都可以使用：
- **Base URL**: `http://localhost:8080` 或 `http://localhost:8080/v1`
- **API Key**: 任意值（代理不验证）
- **模型**: 见下方模型对照表
---
## 模型对照表
Kiro 支持以下模型，你可以使用 Kiro 原生名称或映射名称：
| Kiro 模型 | 能力 | 可用名称（任选其一） |
|-----------|------|---------------------|
| `claude-sonnet-4` | ⭐⭐⭐ 推荐，性价比最高 | `gpt-4o`, `gpt-4`, `gpt-4-turbo`, `claude-3-5-sonnet-20241022`, `claude-3-5-sonnet-latest`, `sonnet` |
| `claude-sonnet-4.5` | ⭐⭐⭐⭐ 更强，适合复杂任务 | `gemini-1.5-pro`, `o1`, `o1-preview`, `claude-3-opus-20240229`, `claude-3-opus-latest`, `claude-4-opus`, `opus` |
| `claude-haiku-4.5` | ⚡ 快速，适合简单任务 | `gpt-4o-mini`, `gpt-3.5-turbo`, `claude-3-5-haiku-20241022`, `haiku` |
| `auto` | 🤖 自动选择 | `auto` |
### 各客户端推荐配置
| 客户端 | 推荐模型名 | 实际使用 |
|--------|-----------|---------|
| Claude Code | `claude-sonnet-4` 或 `claude-sonnet-4.5` | 直接使用 Kiro 模型名 |
| Codex CLI | `gpt-4o` | 映射到 claude-sonnet-4 |
| Gemini CLI | `gemini-1.5-pro` | 映射到 claude-sonnet-4.5 |
| 其他 OpenAI 客户端 | `gpt-4o` | 映射到 claude-sonnet-4 |
> 💡 **提示**：不确定用什么模型？直接用 `claude-sonnet-4` 或 `gpt-4o`，性价比最高。
|