# 一行配置，立即享受本地代理 export ANTHROPIC_BASE_URL="http://localhost:8080/v1" export ANTHROPIC_API_KEY="your-kiro-token" # Claude Code 无感切换，所有功能完美支持 claude-code --model claude-sonnet-4 "帮我重构这段代码"

# Social 认证 KIRO_AUTH_TOKEN='[{"auth":"Social","refreshToken":"your-social-token"}]' # IdC 认证 KIRO_AUTH_TOKEN='[{  "auth":"IdC",  "refreshToken":"enterprise-token",  "clientId":"enterprise-client-id",  "clientSecret":"enterprise-secret" }]' # 混合认证 - 最佳实践 KIRO_AUTH_TOKEN='[  {"auth":"IdC","refreshToken":"primary-enterprise"},  {"auth":"Social","refreshToken":"backup-personal"} ]'

# Claude Code 中直接使用图片 claude-code "分析这张图片的内容" --image screenshot.png # 支持的图片格式 ✅ data URL 的 PNG/JPEG 等常见格式 ⚠️ 目前仅支持 `data:` URL，不支持远程 HTTP 图片地址

# 克隆并编译 git clone <repository-url> cd kiro2api go build -o kiro2api main.go # 配置环境变量 cp .env.example .env # 编辑 .env 文件，设置 KIRO_AUTH_TOKEN # 启动服务器 ./kiro2api # 测试API curl -X POST http://localhost:8080/v1/messages \ -H "Content-Type: application/json" \ -H "Authorization: Bearer 123456" \ -d '{"model": "claude-sonnet-4-20250514", "max_tokens": 100, "messages": [{"role": "user", "content": "你好"}]}'

# 方式一：使用 docker-compose（推荐） docker-compose up -d # 方式二：预构建镜像 docker run -d \ --name kiro2api \ -p 8080:8080 \ -e KIRO_AUTH_TOKEN='[{"auth":"Social","refreshToken":"your_token"}]' \ -e KIRO_CLIENT_TOKEN="123456" \ ghcr.io/caidaoli/kiro2api:latest # 方式三：本地构建 docker build -t kiro2api . docker run -d \ --name kiro2api \ -p 8080:8080 \ --env-file .env \ kiro2api

# .env.docker # 多账号池配置 KIRO_AUTH_TOKEN='[  {  "auth": "Social",  "refreshToken": "arn:aws:sso:us-east-1:999999999999:token/refresh/xxx"  },  {  "auth": "IdC",  "refreshToken": "arn:aws:identitycenter::us-east-1:999999999999:account/instance/xxx",  "clientId": "https://oidc.us-east-1.amazonaws.com/clients/xxx",  "clientSecret": "xxx-secret-key-xxx"  } ]' # 服务配置 KIRO_CLIENT_TOKEN=your-secure-token PORT=8080 GIN_MODE=release # 生产级日志 LOG_LEVEL=info LOG_FORMAT=json LOG_CONSOLE=true 

# 若使用 Docker Secrets，请将 `KIRO_AUTH_TOKEN` 设置为 secrets 文件路径： # 例如：/run/secrets/kiro_auth_token # # 说明：代码支持将 `KIRO_AUTH_TOKEN` 当作"文件路径"读取； # 但不支持 `*_FILE` 环境变量约定，也不读取 `KIRO_CLIENT_TOKEN_FILE`。

# 健康检查 docker exec kiro2api wget -qO- http://localhost:8080/v1/models # 查看日志 docker logs -f kiro2api # 监控资源使用 docker stats kiro2api # 进入容器调试 docker exec -it kiro2api sh

# 使用 Authorization Bearer 认证 Authorization: Bearer your-auth-token # 或使用 x-api-key 认证 x-api-key: your-auth-token

# Anthropic API 格式 curl -X POST http://localhost:8080/v1/messages \ -H "Content-Type: application/json" \ -H "Authorization: Bearer 123456" \ -d '{  "model": "claude-sonnet-4-20250514",  "max_tokens": 1000,  "messages": [  {"role": "user", "content": "你好，请介绍一下你自己"}  ]  }' # OpenAI API 格式 curl -X POST http://localhost:8080/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer 123456" \ -d '{  "model": "claude-sonnet-4-20250514",  "messages": [  {"role": "user", "content": "解释一下机器学习的基本概念"}  ]  }' # 流式请求（添加 "stream": true） curl -N -X POST http://localhost:8080/v1/messages \ -H "Content-Type: application/json" \ -H "Authorization: Bearer 123456" \ -d '{  "model": "claude-sonnet-4-20250514",  "max_tokens": 200,  "stream": true,  "messages": [{"role": "user", "content": "讲个故事"}]  }'

# 完整的生产级配置 export KIRO_AUTH_TOKEN='[  {  "auth": "Social",  "refreshToken": "arn:aws:sso:us-east-1:999999999999:token/refresh/social-token-1",  "description": "开发团队主账号"  },  {  "auth": "Social",  "refreshToken": "arn:aws:sso:us-east-1:999999999999:token/refresh/social-token-2",  "description": "开发团队备用账号"  },  {  "auth": "IdC",  "refreshToken": "arn:aws:identitycenter::us-east-1:999999999999:account/instance/idc-token",  "clientId": "https://oidc.us-east-1.amazonaws.com/clients/enterprise-client",  "clientSecret": "enterprise-secret-key",  "description": "生产级账号"  } ]'

# === 核心配置 === KIRO_CLIENT_TOKEN=your-secure-api-key # API 认证密钥（建议使用强密码） PORT=8080 # 服务端口 GIN_MODE=release # 运行模式：debug/release/test 

# === 日志系统 === LOG_LEVEL=info # 日志级别：debug/info/warn/error LOG_FORMAT=json # 日志格式：text/json LOG_CONSOLE=true # 控制台输出开关 LOG_FILE=/var/log/kiro2api.log # 日志文件路径（可选） # === 结构化日志字段 === # 自动包含以下字段： # - timestamp: 时间戳 # - level: 日志级别 # - service: 服务名称 # - request_id: 请求唯一标识 # - user_id: 用户标识（如果可用） # - token_usage: Token 使用情况 # - response_time: 响应时间

# === 工具限制 === MAX_TOOL_DESCRIPTION_LENGTH=10000 # 工具描述的最大长度（字符数，默认：10000） # 用于限制 tool description 字段的长度 # 防止超长内容导致上游 API 错误

# 检查配置 echo $KIRO_AUTH_TOKEN # 启用调试日志 LOG_LEVEL=debug ./kiro2api

# 测试 API 连通性 curl -v -H "Authorization: Bearer 123456" \ http://localhost:8080/v1/models # 测试流式响应 curl -N --max-time 60 -X POST \ http://localhost:8080/v1/messages \ -H "Content-Type: application/json" \ -H "Authorization: Bearer 123456" \ -d '{"model": "claude-sonnet-4-20250514", "stream": true, "messages": [{"role": "user", "content": "测试"}]}'

# Docker 故障排除命令 # 查看容器状态 docker ps -a # 查看容器日志 docker logs kiro2api --tail 100 -f # 检查容器内部 docker exec -it kiro2api sh ps aux netstat -tlnp env | grep KIRO # 检查服务连通性（本地） docker exec kiro2api wget -qO- http://localhost:8080/v1/models || echo "服务不可用" # 重新构建和启动 docker-compose down -v docker-compose build --no-cache docker-compose up -d # 检查资源使用 docker stats kiro2api

# Claude Code 集成调试 # 测试基础连接 curl -H "Authorization: Bearer $KIRO_CLIENT_TOKEN" \ http://localhost:8080/v1/models # 测试流式响应 curl -N -H "Authorization: Bearer $KIRO_CLIENT_TOKEN" \ -H "Content-Type: application/json" \ -d '{"model":"claude-sonnet-4-20250514","stream":true,"messages":[{"role":"user","content":"test"}]}' \ http://localhost:8080/v1/messages