한 줄 요약
OpenCode에서 Kiro CLI의 AWS Bedrock 기반 Claude 모델을 사용하려는 시도. 공식 지원은 PR 대기 중이고, 당장은 로컬 프록시 우회로 가능.
현재 상황 (2026년 3월)
| 방식 | 상태 | 난이도 |
|---|
| 공식 연동 | PR #9164 대기 중 (메인테이너 승인 대기) | ⭐ (병합 후) |
| 로컬 프록시 (kiro-gateway) | 당장 사용 가능 | ⭐⭐⭐ |
1. 공식 지원 현황
- OpenCode GitHub에 Issue #9165 + PR #9164 등록
- Kiro CLI의 로컬 인증 데이터(SQLite DB에 저장된 OAuth 토큰)를 읽어와서 OpenCode의 새 Provider로 추가
- 병합되면
provider: kiro 선택만으로 AWS Bedrock 기반 Claude 모델 사용 가능
- 추가 과금 없음 — Kiro 계정의 크레딧 사용
- 현재: 메인테이너 승인 대기 중
2. 당장 사용하는 방법: kiro-gateway (로컬 프록시 게이트웨이)
지원하는 API
| 엔드포인트 | 방식 | 설명 |
|---|
/v1/chat/completions | POST | OpenAI 호환 Chat Completions |
/v1/messages | POST | Anthropic 호환 Messages API |
/v1/models | GET | 사용 가능 모델 목록 |
작동 원리
Kiro CLI (OAuth 토큰)
↓ 토큰 자동 추출
kiro-gateway (로컬 프록시)
↓ OpenAI 호환 API 제공
http://localhost:8000
↓
OpenCode (Custom Provider로 연결)
설정 방법
# 1. 클론 및 설정
git clone https://github.com/Jwadow/kiro-gateway.git
cd kiro-gateway
cp .env.example .env
# .env에서 PROXY_API_KEY, REFRESH_TOKEN 등 설정
# 2. 실행
python main.py
# 또는 Docker
docker run -d -p 8000:8000 \
-e PROXY_API_KEY="my-super-secret-password-123" \
-e REFRESH_TOKEN="your_refresh_token" \
--name kiro-gateway \
ghcr.io/jwadow/kiro-gateway:latest
- OpenCode 환경 설정 파일(
opencode.json 또는 /connect 명령어)에서 Custom Provider 추가
- API 엔드포인트를
http://localhost:8000으로 설정
- 결과: OpenCode가 Kiro를 일반 API로 인식
사용 가능 모델
- Claude Sonnet 4.5 등 Kiro가 제공하는 AWS Bedrock 기반 모델
- 모델 이름 자동 정규화 (
claude-sonnet-4-5, claude-sonnet-4.5, claude-sonnet-4-5-20250929 모두 지원)
- Kiro 계정의 크레딧으로 과금
3. 인증 체계 차이
| 도구 | 인증 방식 |
|---|
| Kiro CLI | AWS 인증 (OAuth → SQLite DB에 토큰 저장) |
| OpenCode | 자체 생태계 + API Key 기반 |
→ 플러그 앤 플레이 방식의 연동은 불가능. 우회 필요.
권장 사항
| 상황 | 추천 |
|---|
| 당장 사용이 급함 | kiro-gateway 프록시 활용 (설정 번거로움 감수) |
| 설정이 번거로운 게 싫음 | PR #9164 공식 병합까지 대기 |
연결된 노트