Kiro-RS-Tool

一个面向 Claude Code 工具调用兼容的 Kiro / Anthropic API 代理工具，将 Anthropic API 请求转换为 Kiro API 请求。

本增强版说明

这是面向 Claude Code 与新版 Kiro 的增强兼容分支，目标是在自托管环境中作为稳定的 Anthropic API 兼容代理使用。

重点：Claude Code 工具调用兼容

本分支的核心目标是让 Claude Code 能稳定走 Kiro 上游完成真实开发任务，重点修复了 Claude Code 工具调用在 Kiro 协议下最容易出问题的几类场景：

• 工具 schema 与参数双向适配：把 Claude Code 的 Read、Write、Edit、Bash、Glob、Grep、LS、WebSearch 等工具映射到 Kiro 内置工具，并在上游返回时恢复为 Claude Code 期望的工具名和参数结构。
• Write / Edit / Read 参数兼容：处理 file_path、content、old_string、new_string、offset、limit 等字段与 Kiro path、text、oldStr、newStr、start_line、end_line 的差异，避免客户端收到 Invalid tool parameters。
• 流式半截 JSON 防护：对上游分片 toolUse.input 做完整 JSON 累积，只有参数完整且可解析后才向 Claude Code 输出 tool_use，防止半截 input_json_delta 触发工具执行失败。
• 工具调用 XML 泄漏过滤：过滤上游可能混入正文的 tool_use XML 片段，避免 Claude Code 把泄漏内容当作普通文本处理。
• 大文件写入/编辑场景加固：针对 Claude Code 常见的大 Write / Edit 参数和长输出场景做兼容处理，减少会话卡死、工具参数错配和客户端中断。

其他能力

• Kiro CLI / Kiro IDE 端点兼容：保留 ide 与 cli 两套 endpoint transform，分别处理 origin、headers、profileArn、content type、CLI wrapping 与 IDE agent mode。
• Opus thinking / effort 兼容：Opus 4.8 / 4.7 / 4.6 支持 thinking 模型和 effort 参数，包含 Opus 4.8 high / xhigh 等强度映射。
• Sonnet thinking 兼容：Sonnet 4.6 保留 thinking 兼容；流式 thinking 块会转换为 Anthropic 兼容内容块。
• profileArn 完整修复：Enterprise / IdC 账号会自动通过 ListAvailableProfiles 获取真实 profileArn 并写回；Builder ID/free 流式请求保留官方占位 profileArn，避免新版上游返回 profileArn is required。
• Admin 面板增强：支持客户端 Key 分发、用量统计、请求链路追踪、全局设置、默认 endpoint 切换、凭据级 endpoint 覆盖、代理池、在线更新与 KAM 导入。
• 缓存 token 计量：按 cache read / cache creation / input / output 记录用量，并在请求链路追踪中展示 token 明细。

引用与合并来源

本仓库不是从零开始的独立实现，而是在多个公开社区项目和本地补丁基础上整理、合并、实测后的增强分支。主要参考与合并来源如下：

• hank9999/kiro.rs：原始 Rust 版 Kiro/Anthropic API 兼容代理基础实现，以及多凭据、Admin、Docker 部署等核心思路。
• ZyphrZero/kiro.rs：当前主要基线；参考并合入 Enterprise profileArn、cache metering、trace token 字段、Admin UI 组件统一、Builder ID/free profileArn 等修复。
• Foxfishc/kiro.rs：参考并吸收 CLI endpoint、thinking、压缩、诊断与 Claude Code 兼容相关实现思路。
• M-JYuan/kiro.rs：参考并合入管理面板设置入口、默认 endpoint / 凭据级 endpoint 设置等交互与后端 API 思路，并适配当前代码结构。
• chaogei/Kiro-account-manager：参考最新版 Kiro 账号、thinking/effort、Enterprise profileArn、工具调用与账号导入导出相关行为。
• 本地 429修复 补丁目录：合入普通 429 冷却、账号级风控故障转移、重试策略与相关管理面板展示逻辑。

感谢以上项目作者和贡献者。本分支的主要工作是把这些实现按当前 Kiro CLI / IDE 实测行为重新梳理、合并冲突、补兼容层、补测试，并完成本地构建与兼容性验证。

LINUX DO 讨论帖

免责声明

本项目仅供研究使用, Use at your own risk, 使用本项目所导致的任何后果由使用人承担, 与本项目无关。 本项目与 AWS/KIRO/Anthropic/Claude 等官方无关, 本项目不代表官方立场。

注意！

因 TLS 默认从 native-tls 切换至 rustls，你可能需要专门安装证书后才能配置 HTTP 代理。可通过 config.json 的 tlsBackend 切回 native-tls。 如果遇到请求报错, 尤其是无法刷新 token, 或者是直接返回 error request, 请尝试切换 tls 后端为 native-tls, 一般即可解决。

Write Failed/会话卡死: 如果遇到持续的 Write File / Write Failed 并导致会话不可用，参考 Issue #22 和 #49 的说明与临时解决方案（通常与输出过长被截断有关，可尝试调低输出相关 token 上限）

功能特性

• Anthropic API 兼容: 完整支持 Anthropic Claude API 格式
• 流式响应: 支持 SSE (Server-Sent Events) 流式输出
• Token 自动刷新: 自动管理和刷新 OAuth Token
• 多凭据支持: 支持配置多个凭据，按优先级自动故障转移
• 负载均衡: 支持 priority（按优先级）和 balanced（均衡分配）两种模式
• 智能重试: 单凭据最多重试 3 次，单请求最多重试 9 次
• 凭据回写: 多凭据格式下自动回写刷新后的 Token
• Thinking 模式: 支持 Claude 的 extended thinking 功能
• 工具调用: 完整支持 function calling / tool use
• WebSearch: 内置 WebSearch 工具转换逻辑
• Opus 1M 上下文: Opus 4.8 / 4.7 / 4.6 按 1M 上下文处理
• Sonnet 1M 上下文: Sonnet 4.6 按 1M 上下文处理，其他 Sonnet 默认 200K
• 多模型支持: 支持 Opus / Sonnet / Haiku 常用模型，其他默认 200K
• Admin 管理: 可选的 Web 管理界面和 API，支持凭据管理、余额查询等
• 客户端 Key 分发（v0.4.0+）：在 Admin 面板生成多把 csk_* 客户端 Key 分发给下游用户/项目，每把 Key 独立启用/禁用与计数，泄露不影响其他用户
• 用量统计与仪表盘（v0.4.0+）：按请求记录 token 消耗（按日滚动 JSONL），仪表盘展示时间趋势、模型分布、上游凭据贡献
• 多级 Region 配置: 支持全局和凭据级别的 Auth Region / API Region 配置
• 凭据级代理: 支持为每个凭据单独配置 HTTP/SOCKS5 代理，优先级：凭据代理 > 全局代理 > 无代理

• 开始
• 1. 编译
• 2. 最小配置
• 3. 启动
• 4. 验证
• Docker
  • 一、最小部署
  • 二、首次启动获取密钥
  • 三、访问管理面板
  • 四、定制配置
  • 五、升级与回退
  • 六、备份
  • 七、常见问题
• 配置详解
• config.json
• credentials.json
• Region 配置
• 代理配置
• 认证方式
• 环境变量
• API 端点
• 标准端点 (/v1)
• Claude Code 兼容端点 (/cc/v1)
• Thinking 模式
• 工具调用
• 模型映射
• Admin（可选）
• 手动发布
• 注意事项
• 项目结构
• 技术栈
• License
• 致谢

开始

1. 编译

PS: 如果不想编辑可以直接前往 Release 下载二进制文件

前置步骤：编译前需要先构建前端 Admin UI（用于嵌入到二进制中）： bash cd admin-ui && bun install && bun run build

cargo build --release

2. 最小配置

创建 config.json：

{
   "host": "127.0.0.1",
   "port": 8990,
   "apiKey": "sk-kiro-rs-qazWSXedcRFV123456",
   "region": "us-east-1"
}

PS: 如果你需要 Web 管理面板, 请注意配置 adminApiKey

创建 credentials.json（从 Kiro IDE 等中获取凭证信息）：

PS: 可以前往 Web 管理面板配置跳过本步骤 如果你对凭据地域有疑惑, 请查看 Region 配置

Social 认证：

{
   "refreshToken": "你的刷新token",
   "expiresAt": "2025-12-31T02:32:45.144Z",
   "authMethod": "social"
}

IdC 认证：

{
   "refreshToken": "你的刷新token",
   "expiresAt": "2025-12-31T02:32:45.144Z",
   "authMethod": "idc",
   "clientId": "你的clientId",
   "clientSecret": "你的clientSecret"
}

3. 启动

./target/release/kiro-rs

或指定配置文件路径：

./target/release/kiro-rs -c /path/to/config.json --credentials /path/to/credentials.json

4. 验证

curl http://127.0.0.1:8990/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk-kiro-rs-qazWSXedcRFV123456" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "stream": true,
    "messages": [
      {"role": "user", "content": "Hello, Claude!"}
    ]
  }'

Docker

推荐生产部署方式。镜像已预编译多架构二进制（linux/amd64、linux/arm64），开箱即用，无需安装 Rust 工具链。

一、最小部署

只需要 docker-compose.yml + 一个空的数据目录：

mkdir -p /opt/kiro-rs/data && cd /opt/kiro-rs
curl -O https://raw.githubusercontent.com/ZyphrZero/kiro.rs/master/docker-compose.yml
docker compose up -d

目录结构（首次启动后由容器自动生成 config.json / credentials.json）：

/opt/kiro-rs/
├── docker-compose.yml
└── data/                          # 持久化目录，挂载为容器内 /app/config
    ├── config.json                # 自动生成，含随机 apiKey / adminApiKey
    ├── credentials.json           # 自动生成的空数组 []，通过 Admin UI 添加
    ├── client_api_keys.json       # 客户端 Key 分发（v0.4.0+，含明文 csk）
    ├── usage_log.YYYY-MM-DD.jsonl # 按日滚动的请求用量日志（最多保留 31 天）
    ├── kiro_balance_cache.json    # 上游凭据余额缓存
    └── proxy_pool.json            # 代理池（如启用）

docker-compose.yml 默认包含 kiro-rs 服务：

• kiro-rs：监听 8990，挂载 ./data/:/app/config/，restart: unless-stopped

二、首次启动获取密钥

容器首次启动会在日志里打印一次随机生成的密钥：

docker compose logs kiro-rs | grep -E "apiKey|adminApiKey"

输出形如：

apiKey      = sk-kiro-rs-3f8a9b2cQz...
adminApiKey = sk-admin-x9KpRtVw...

• apiKey — 客户端调用 /v1/messages 时携带（x-api-key 或 Authorization: Bearer）
• adminApiKey — 登录 http://<host>:8990/admin 管理界面用

记下来后即可关闭日志窗口。也可以直接打开 data/config.json 查看或修改。

三、访问管理面板

浏览器打开 http://<服务器 IP>:8990/admin，用 adminApiKey 登录。三个 Tab：

• 概览 — Token 消耗趋势、按模型/凭据分布
• 凭据管理 — 添加上游 Kiro 凭据（Social / IdC / API Key）
• 客户端 Key — 分发面向下游的 csk_* Key

四、定制配置

修改端口：编辑 docker-compose.yml 把 "8990:8990" 改成 "<host port>:8990"，容器内端口保持 8990 不变。

自定义镜像 tag：通过环境变量覆盖（默认 zyphrzero/kiro-rs:latest）：

KIRO_RS_IMAGE=zyphrzero/kiro-rs:0.4.0 docker compose up -d

或写到 .env 文件：

KIRO_RS_IMAGE=zyphrzero/kiro-rs:0.4.0

关闭 Redis：v0.4.0+ 已移除 prompt cache 与 Redis 依赖，无需额外配置。如果你之前在 data/config.json 里留有 redisUrl / cacheDebugLogging / cacheMaxReadRatio 字段，可以一并删除。

配置 HTTP 代理：在 data/config.json 加 proxyUrl，或在 Admin UI 的代理池里管理。

五、升级与回退

通过 Admin UI 在线更新（推荐）：右上角点云朵图标 → 「更新并重启」。下载 GitHub Releases 二进制，校验 SHA256，原子替换 <exe>，旧版本备份到 <exe>.backup，进程退出后由 restart: unless-stopped 接管重启。失败完全无副作用，断网也能用 <exe>.backup 一键回退。

也可以在 Admin UI 的「设置」里启用 无人值守自动更新（每天指定时间检查并应用新版本）。

手动升级（拉新镜像）：

docker compose pull && docker compose up -d

注意：手动 pull 升级与 Admin UI 在线更新使用的是不同的二进制路径——前者拉镜像里的二进制，后者下载 GitHub Releases 并写到容器卷。两种方式都安全，不会互相干扰，但建议固定使用其中一种以便追踪版本。

六、备份

data/ 目录是唯一的状态来源，定期备份即可：

tar -czf kiro-rs-backup-$(date +%F).tar.gz /opt/kiro-rs/data/

⚠️ 备份包含明文凭据（credentials.json）和明文客户端 Key（client_api_keys.json），请加密保存或限制访问权限。

恢复时把备份解压回 /opt/kiro-rs/data/ 后 docker compose restart 即可。

七、常见问题

• 首次启动看不到日志中的密钥 — 改用 docker compose logs --tail=200 kiro-rs，或直接看 data/config.json 里的 apiKey / adminApiKey 字段
• 想从 Docker Hub 之外的镜像源拉取 — 把 docker-compose.yml 里的 image: 改成你自己镜像源的地址（如 ghcr.io/...、阿里云镜像加速等）
• Admin UI 显示 "暂无数据" — 仪表盘需要至少一次请求才会有数据，先用 curl 调一次 /v1/messages 即可看到趋势开始填充

配置详解

config.json

完整配置示例：

{
   "host": "127.0.0.1",
   "port": 8990,
   "apiKey": "sk-kiro-rs-qazWSXedcRFV123456",
   "region": "us-east-1",
   "tlsBackend": "rustls",
   "kiroVersion": "2.6.0",
   "machineId": "64位十六进制机器码",
   "systemVersion": "darwin#24.6.0",
   "nodeVersion": "22.21.1",
   "authRegion": "us-east-1",
   "apiRegion": "us-east-1",
   "countTokensApiUrl": "https://api.example.com/v1/messages/count_tokens",
   "countTokensApiKey": "sk-your-count-tokens-api-key",
   "countTokensAuthType": "x-api-key",
   "proxyUrl": "http://127.0.0.1:7890",
   "proxyUsername": "user",
   "proxyPassword": "pass",
   "adminApiKey": "sk-admin-your-secret-key",
   "updateAutoApply": false,
   "updateAutoApplyTime": "03:00",
   "loadBalancingMode": "priority",
   "retryMode": "fast",
   "retryPolicy": null,
   "extractThinking": true,
   "defaultEndpoint": "ide",
   "toolCompatibilityMode": "claude-code"
}

自定义普通 429 重试策略示例：

{
   "retryMode": "custom",
   "retryPolicy": {
      "rateLimitCooldownMs": 800,
      "maxRequestRetries": 15,
      "baseBackoffMs": 80,
      "maxBackoffMs": 800,
      "credentialSwitchOn429": true,
      "respectRetryAfter": false
   }
}

credentials.json

支持单对象格式（向后兼容）或数组格式（多凭据）。

字段说明