Rust 编写的 Anthropic Claude API 代理服务。将 Anthropic Messages API 请求转换为 Kiro API 请求，支持多凭据管理、自动故障转移、流式响应和可选的 Web 管理界面。

• Anthropic Messages API 兼容（/v1/messages、/v1/messages/count_tokens、/v1/models）
• SSE 流式响应
• OAuth Token 自动刷新与多凭据故障转移
• Thinking 模式（extended thinking）与工具调用（tool use）
• 内置 WebSearch 工具转换
• 多模型支持：Claude + 非 Claude 系列，模型列表可通过 config 配置
• 凭据等级路由：自动将 Premium 模型请求路由到 Pro 以上凭据，无匹配时提前拒绝（403）
• 本地 Claude tokenizer 计数（用于 /v1/messages/count_tokens 与 usage 统计）
• 多级 Region 配置与凭据级代理
• 凭据冷却、速率限制、粘性路由
• 请求体自动压缩（白空格压缩、thinking 截断、工具定义压缩、自适应压缩）
• 本地 Prompt Cache 模拟记账
• 可选 Web 管理界面（凭据管理、余额查询、配置热更新）

从 Releases 下载预编译二进制文件，或自行编译：

# 前端 Admin UI 需要先构建（嵌入到二进制中）
cd admin-ui && pnpm install && pnpm build && cd ..

# 编译后端
cargo build --release

创建 config.json：

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

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

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"
}

API Key 认证：

{
  "kiroApiKey": "ksk_your_api_key_here",
  "authMethod": "api_key"
}

./target/release/kiro-rs

指定配置文件路径：

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

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

docker-compose up

将 config.json 和 credentials.json 放入 ./config/ 目录，容器会自动挂载。

{
  "compression": {
    "enabled": true,
    "whitespaceCompression": true,
    "thinkingStrategy": "discard",
    "toolDescriptionMaxChars": 4000,
    "toolDefinitionCompression": true,
    "toolDefinitionMinDescriptionChars": 50,
    "toolNameMaxChars": 63,
    "maxRequestBodyBytes": 4718592,
    "adaptiveCompression": true,
    "adaptiveCompressionMaxIters": 32
  }
}

{
  "rewriter": {
    "enabled": false,
    "keywords": ["Kiro"],
    "rewritePrompt": "...",
    "maxRewriteTokens": 16384
  }
}

默认关闭。启用后，当响应文本包含指定关键词时，会触发二次改写。

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

IdC / Builder-ID / IAM 统一使用 authMethod: "idc"。旧值 builder-id / iam 仍可识别。

[
  {
    "refreshToken": "第一个凭据",
    "authMethod": "social",
    "priority": 0,
    "tier": "pro+"
  },
  {
    "refreshToken": "第二个凭据",
    "authMethod": "idc",
    "clientId": "xxx",
    "clientSecret": "xxx",
    "region": "us-east-2",
    "priority": 1,
    "tier": "free",
    "proxyUrl": "socks5://proxy.example.com:1080"
  }
]

• 按 priority 排序，数字越小优先级越高
• 单凭据最多重试 2 次，单请求跨凭据最多重试 3 次
• 多凭据格式下 Token 刷新后自动回写到文件
• 配置 tier 后，Premium 模型（Opus / Sonnet 4.6 / Haiku）仅路由到匹配等级的凭据，Free 凭据不会被选中

分别控制 Token 刷新和 API 请求使用的区域。

Auth Region 优先级：凭据.authRegion > 凭据.region > config.authRegion > config.region

API Region 优先级：凭据.apiRegion > config.apiRegion > config.region

优先级：凭据.proxyUrl > config.proxyUrl > 无代理

请求本服务时支持两种方式：

x-api-key: sk-your-api-key

Authorization: Bearer sk-your-api-key

本服务优先使用内置 Claude BPE tokenizer 在本地计算输入 token，用于：

• /v1/messages/count_tokens
• /v1/messages 响应中的 usage.input_tokens
• 本地 Prompt Cache 模拟记账

Kiro 上游的 contextUsageEvent 只提供上下文窗口百分比，且会包含 Kiro 注入的内部上下文，因此不会直接作为下游 input_tokens。只有本地计数不可用时，才会把该百分比按模型上下文窗口转换为 fallback，并扣除观测到的 Kiro 内部上下文开销。

promptCacheMode 控制 Prompt Cache usage 字段：

通过请求体控制，与模型名无关：

{
  "model": "claude-opus-4-7",
  "thinking": {"type": "adaptive"},
  "output_config": {"effort": "high"},
  "max_tokens": 16000,
  "messages": [...]
}

• thinking.type：adaptive（启用）/ enabled（旧版兼容）/ disabled（关闭）
• output_config.effort：low / medium / high（默认）/ xhigh / max
  • xhigh 和 max 仅 Opus 系列支持

完整支持 Anthropic tool use：

{
  "model": "claude-sonnet-4-20250514",
  "max_tokens": 1024,
  "tools": [
    {
      "name": "get_weather",
      "description": "获取城市天气",
      "input_schema": {
        "type": "object",
        "properties": {"city": {"type": "string"}},
        "required": ["city"]
      }
    }
  ],
  "messages": [...]
}

模型列表通过 config.json 的 models 字段配置，支持自定义 Anthropic ID → Kiro ID 映射及等级限制。不配置则使用内置默认列表（含所有 Claude + 非 Claude 模型）。

每个模型条目包含：

GET /v1/models 仅返回 tiers 与 supportedTiers 有交集的模型。

等级路由：请求到达时，按模型的 tiers 过滤凭据。若凭据设置了 tier 字段但不在模型的 tiers 列表中，该凭据会被跳过。未设置 tier 的凭据可匹配任意模型（向后兼容）。若无可用凭据匹配所需等级，返回 403。

配置 adminApiKey 后启用。访问 /admin 打开 Web 管理界面。

与 Anthropic 官方 API 的已知差异：

• 不支持的 API：Batches、Files、Managed Agents 等
• System prompt：转换为 user/assistant 消息对传递给上游
• Assistant prefill：不支持
• tool_choice：被忽略，响应头返回 x-anthropic-compat-warning 提示
• Prompt cache：本地模拟实现，非原生 prompt caching
• 图片 URL：不支持 image.source.type: "url" 形式
• Token 计数：文本计数使用内置 Claude tokenizer；图片、PDF、上游内部上下文与真实 Claude 服务端计数仍可能存在差异

每个请求生成唯一 request ID，出现在响应体 request_id 字段和 x-request-id 响应头中。

• 后端：Rust 2024 edition — Axum 0.8 + Tokio + Reqwest + Serde + Clap + tracing
• 前端：React 19 + TypeScript + Tailwind CSS 4 + Vite 8 + TanStack Query + Radix UI

本项目参考了以下项目的实现：

• kiro2api
• proxycast
• kiro.rs