Claude Code, Codex, Gemini CLI 등 코딩 에이전트에서 모든 제공자와 구독의 모델을 쓰게 해주는 로컬 게이트웨이 및 메뉴 바 앱입니다.
jasonxu114514/opencode2api
Chat Completions, Responses, Anthropic Messages API로 OpenCode Zen 및 Zen Go 모델을 제공하는 Go 게이트웨이입니다.
- 스타
- 1,099
- 포크
- 192
- 열린 이슈
- 25
- 마지막 커밋
- 그저께
어떤 프로젝트인가요?
opencode2api는 OpenCode Zen 및 Zen Go를 위한 셀프 호스팅 게이트웨이입니다. Chat Completions, Responses 또는 Anthropic Messages 형식의 요청을 받아 각 업스트림의 네이티브 프로토콜로 변환하므로, 한 가지 API 형식용으로 만든 클라이언트에서도 다른 형식으로 제공되는 모델을 사용할 수 있습니다. WebUI를 포함한 단일 Go 바이너리로 배포되며 Node.js 런타임이나 데이터베이스가 필요하지 않습니다.
Zen 키와 Go 키는 별도의 풀로 관리하며, 티어 우선순위 설정, 재시도, 세션 고정, direct·HTTP·HTTPS·SOCKS5·SOCKS5H 프록시 라우팅을 지원합니다. 모델 목록은 OpenCode 카탈로그에서 새로고침하며, 별도의 관리 포트에서 설정 편집, Playground, 진단, 토큰 통계, 실시간 로그, Go 구독 할당량 대시보드를 제공합니다.
대상 프로토콜에서 표현할 수 있는 경우 텍스트, 이미지, 추론, 함수 도구 및 도구 결과를 지원합니다. 임베딩, 파일 업로드, 이미지 생성, 대화 저장 기능은 구현하지 않습니다.
핵심 기능
- 01Chat Completions, Responses, Anthropic Messages 프로토콜 간 변환을 지원하며 JSON 및 SSE로 출력합니다.
- 02티어 우선순위, 재시도, 세션 고정을 지원하는 별도의 Zen 및 Go 키 풀을 제공합니다.
- 03프록시 파일을 포함해 direct, HTTP, HTTPS, SOCKS5 또는 SOCKS5H 프록시를 통해 라우팅합니다.
- 04별도 포트에서 설정, Playground, 진단, 실시간 로그를 제공하는 WebUI를 실행합니다.
- 05설정을 핫 리로드하며, 변경 사항은 새 요청에 적용하기 전에 검증합니다.
- 06클라이언트용 로컬 API 키를 생성하고 관리합니다.
활용 사례
- OpenAI 또는 Anthropic 호환 코딩 도구를 OpenCode Zen 또는 Zen Go 모델에 연결하기.
- 여러 로컬 클라이언트에서 업스트림 키와 프록시 풀을 공유하기.
- 단일 대시보드에서 토큰 사용량과 Go 구독 할당량을 모니터링하기.
빠른 시작
- 1
저장소를 클론합니다
git clone https://github.com/jasonxu114514/opencode2api.git - 2
프로젝트 디렉터리로 이동해 예제 설정 파일을 복사합니다
cd opencode2api && cp config.example.json config.json - 3
바이너리를 빌드합니다(Go 1.24 이상 필요)
go build -o opencode2api ./cmd/opencode2api - 4
config.json에 로컬 API 키, 업스트림 키, WebUI 비밀번호를 설정한 다음 서비스를 시작합니다
./opencode2api -config config.json
사용 전 알아둘 점
- 모델에 액세스하려면 Zen 또는 업스트림 키가 필요하며, 익명 Zen 액세스도 사용할 수 있습니다.
- 설정하려면 config.json을 수정해야 합니다. 네트워크에 공개할 경우 WebUI를 HTTPS 뒤에 두어야 합니다.
- 임베딩, 파일 업로드, 이미지 생성, Responses 검색 및 취소를 지원하지 않습니다.
- 카피레프트 라이선스인 GPL-3.0으로 제공됩니다.
토픽
자주 묻는 질문
- opencode2api은(는) 무엇인가요?
- Chat Completions, Responses, Anthropic Messages API로 OpenCode Zen 및 Zen Go 모델을 제공하는 Go 게이트웨이입니다. opencode2api는 OpenCode Zen 및 Zen Go를 위한 셀프 호스팅 게이트웨이입니다. Chat Completions, Responses 또는 Anthropic Messages 형식의 요청을 받아 각 업스트림의 네이티브 프로토콜로 변환하므로, 한 가지 API 형식용으로 만든 클라이언트에서도 다른 형식으로 제공되는 모델을 사용할 수 있습니다. WebUI를 포함한 단일 Go 바이너리로 배포되며 Node.js 런타임이나 데이터베이스가 필요하지 않습니다.
- opencode2api은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- opencode2api은(는) GPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- opencode2api은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. opencode2api의 마지막 커밋은 2026년 10월 19일입니다.
- opencode2api은(는) 어디에 사용할 수 있나요?
- OpenAI 또는 Anthropic 호환 코딩 도구를 OpenCode Zen 또는 Zen Go 모델에 연결하기. 여러 로컬 클라이언트에서 업스트림 키와 프록시 풀을 공유하기. 단일 대시보드에서 토큰 사용량과 Go 구독 할당량을 모니터링하기.
- opencode2api는 어떻게 설치하나요?
- 저장소를 클론합니다: git clone https://github.com/jasonxu114514/opencode2api.git 프로젝트 디렉터리로 이동해 예제 설정 파일을 복사합니다: cd opencode2api && cp config.example.json config.json 바이너리를 빌드합니다(Go 1.24 이상 필요): go build -o opencode2api ./cmd/opencode2api config.json에 로컬 API 키, 업스트림 키, WebUI 비밀번호를 설정한 다음 서비스를 시작합니다: ./opencode2api -config config.json
- opencode2api은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/jasonxu114514/opencode2api
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
40개 이상의 제공업체를 하나의 엔드포인트로 연결하는 셀프 호스팅 OpenAI 호환 LLM 게이트웨이
수백 개 모델 제공업체를 하나의 OpenAI 호환 엔드포인트로 연결하는 자체 호스팅 MIT AI 게이트웨이
단일 OpenAI 형식 인터페이스로 100개 이상의 LLM 제공업체를 호출하는 오픈소스 AI Gateway 및 Python SDK입니다.
여러 업스트림 모델 제공업체를 대상으로 라우팅, 키, 할당량, 비용 추적을 제공하며 OpenAI, Claude, Gemini 호환 API를 노출하는 셀프 호스팅 AI 게이트웨이입니다.
Claude Code와 Codex 등 여러 코딩 에이전트가 하나의 엔드포인트를 공유하고 여러 모델 제공업체로 요청을 라우팅하는 로컬 게이트웨이입니다.