JetBrains AI Assistant를 Gemini와 연동하기: v0.0.2 출시

jetbrains-ai-gemini-local-proxy의 v0.0.2 버전을 방금 출시했습니다.

이것은 사용자가 자신의 API 키를 직접 가져오는 (BYOK, Bring Your Own Key) 방식일 때, JetBrains AI Assistant가 Google Gemini와 함께 작동할 수 있도록 도와주는 로컬 프록시 (local proxy)입니다.

배경 정보

얼마 전 첫 번째 버전을 공유했습니다. 당시 버전은 IDE가 모델 이름에 OpenAIAPI/ 접두사를 추가하여 Gemini가 요청을 거부하면서 발생하던 "Something went wrong" 에러를 해결했습니다. 저는 매일 이것을 계속 사용해 왔고, 수정해야 할 몇 가지 사항을 더 발견했습니다.

v0.0.2의 새로운 기능

새로운 버그 수정. 최신 IDE 빌드에서는 AI Assistant의 HTTP 클라이언트 (ktor)가 모든 요청에서 연결을 HTTP/2로 업그레이드(Upgrade: h2c)하려고 시도합니다. 이 과정에서 일부 서버는 요청 본문 (request body)을 누락시키며, 이로 인해 프록시가 빈 요청을 받게 되어 400 에러를 반환했습니다. IDE에서는 이것이 다시 동일한 "Something went wrong" 에러로 나타났습니다. 서버를 h11 파서 (parser)로 전환하여 이를 해결했습니다.

더 나은 로깅 (logging). 이제 모든 요청, 소요 시간, 응답 상태, 그리고 스트리밍되는 청크 (streamed chunks)를 확인할 수 있습니다. 따라서 무언가 고장 났을 때 왜 그런 일이 발생했는지 이해하기가 훨씬 쉬워졌습니다.

더 깔끔한 설정. 단순한 uvicorn 설정으로 돌아갔으며, 필요하지 않은 의존성 (dependency)을 제거했습니다.

사용 방법

여전히 두 단계만 필요합니다:

docker compose up -d

그 다음 GEMINI_API_KEY를 추가하고, IDE의 BYOK 엔드포인트 (endpoint)를 http://localhost:5003으로 지정하세요.

IntelliJ IDEA 2026.1.3에서 테스트되었습니다.

동일한 문제를 겪고 있다면, 자유롭게 사용해 보세요: https://github.com/agitrubard/jetbrains-ai-gemini-local-proxy