TL;DR

kiro2claude는 kiro-cli의 자격증명을 재사용해 Anthropic Messages API와 OpenAI Chat/Responses API를 동시에 에뮬레이트하는 로컬 TypeScript 게이트웨이입니다. 클라이언트 요청을 kiro runtime 호출(Smithy awsJson1.0)으로 변환하고 AWS Event Stream 응답을 스트리밍으로 되돌려 실제 Claude Code와 Codex CLI 같은 클라이언트를 수정 없이 연결할 수 있게 설계되어 있습니다. 플러그인 시스템으로 계량·파생 필드 주입 같은 확장이 가능하고 Docker 이미지가 공개되어 빠른 배포가 가능합니다. 라이선스는 MIT이며 Node >= 22, pnpm workspace 환경에서 동작합니다.

핵심 포인트

• 이 프로젝트는 로컬에 실행되는 TypeScript 기반 게이트웨이로, /claude/v1(Anthropic Messages)과 /openai/v1(OpenAI Chat Completions/Responses)을 동시에 노출해 하나의 kiro-cli 자격증명으로 Anthropic·OpenAI 생태계 클라이언트를 구동할 수 있게 합니다. 클라이언트 요청은 내부에서 Smithy awsJson1.0 형식으로 runtime.<region>.kiro.dev로 전달되고 AWS Event Stream 응답을 다시 클라이언트 형식으로 스트리밍해 반환합니다. 이렇게 하면 Claude Code, Cursor, OpenAI SDK, Codex CLI 같은 실제 클라이언트를 변경 없이 연결할 수 있고 모델 카탈로그(models-catalog.ts)에 기재된 Claude 전 모델과 GPT-5.6 변형을 그대로 노출합니다.
• 실제 클라이언트 호환성과 도구 호출 흐름 안정성에 중점을 두어 Claude Code와 Codex CLI 엔드투엔드 동작을 검증했고 tools/에 테스트 하네스가 포함되어 있습니다. 도구 호출 관련 텍스트 복구, 빈 스트림 자동 재시도, 신원 덮어쓰기 등 kiro의 간헐적 문제를 게이트웨이 레이어에서 흡수하도록 설계되어 클라이언트는 오류 처리나 폴백 로직을 별도로 구현할 필요가 줄어듭니다. 또한 /api/* 경로로 표준 응답만 노출하거나 /claude/v1로 계량 필드를 포함하는 선택적 동작을 제공해 계량·로깅 요구에 맞춰 운영할 수 있습니다.
• 인증과 자격증명은 로컬에 설치된 kiro-cli의 SQLite 데이터베이스를 재사용하며 device code flow(AWS SSO OIDC)로 토큰을 발급하고 만료 시 자동으로 갱신합니다. 환경변수 기반 무설정(zero config) 운영을 목표로 하며 KIRO2CLAUDE_SQLITE_DB_PATH로 기존 kiro-cli 자격증명을 가리키면 즉시 작동합니다. 이 방식은 별도 API 키 관리나 추가 자격증명 저장소 구성 없이 기존 kiro-cli 사용자를 바로 연동할 수 있다는 점에서 운영 편의성이 큽니다.
• 플러그인 아키텍처로 핵심을 건드리지 않고 계량, 파생 필드 주입 같은 확장을 도입할 수 있으며 @kiro2claude/plugin-api 계약을 구현하면 node_modules 검색으로 자동 로드됩니다. 레포지토리에는 plugin-metering과 plugin-derived 두 가지 기본 플러그인이 포함되어 있고 examples/echo-plugin에서 구현 예를 확인할 수 있어 플러그인 개발 진입 장벽이 낮습니다. Docker 이미지를 ghcr.io에 공개해 컨테이너화 배포가 가능하고 pnpm 기반 개발·테스트 스크립트(pnpm dev/test/typecheck)가 제공되어 로컬 개발과 CI 통합이 수월합니다.