yuzhiqiang1993/agy-byok
구글 Antigravity IDE에 내 맘대로 다른 AI 모델 꽂아 쓰기
Antigravity는 원래 Gemini 계열과 일부 낮은 버전의 Claude 모델만 지원하고, 사용자가 직접 API 키를 넣어 다른 모델을 쓰는 BYOK 기능을 공식 지원하지 않는다. AGY BYOK는 로컬 컴퓨터에서만 동작하는 프록시(중계 서버)를 띄워 Antigravity IDE, App, CLI가 이 프록시를 official 서버 대신 바라보게 만들고, 그 뒤에서 OpenAI, Anthropic, Gemini, DeepSeek, Ollama 등 원하는 모델로 요청을 대신 전달해준다. Rust와 Tauri로 만들어진 macOS/Windows용 데스크톱 앱이며 현재 프로토타입 단계다.
무엇을 하는 레포인가
- Antigravity가 공식으로 지원하지 않는 BYOK(자기 API 키로 다른 모델 쓰기) 기능을 로컬 프록시로 우회 구현했다
- 기본 주소 http://127.0.0.1:12345 에서만 동작하는 로컬 서버가 IDE/App/CLI의 설정값(jetski.cloudCodeUrl, CLOUD_CODE_URL 환경변수 등)을 바꿔치기해 요청을 가로챈다
- OpenAI Chat Completions, OpenAI Responses, Anthropic Messages, Gemini generateContent 네 가지 프로토콜을 지원해 서로 다른 서비스 간 요청/응답 형식을 변환해준다
- 모델별로 언제 대화 내용을 요약해서 압축할지(컨텍스트 압축 임계값) 세밀하게 조정할 수 있어, Antigravity 기본 설정이 너무 자주 요약을 트리거해 생기는 지연과 정보 손실 문제를 완화한다
- 호출 로그는 요청 경로, 상태, 소요 시간만 메모리에 남기고 프롬프트나 API 키 등 민감 정보는 저장하지 않는다
왜 중요한가
Antigravity 사용자가 원하는 만큼 좋은 모델(예: 더 강력한 Claude나 GPT 계열)을 자기 구독이나 중계 서비스로 그대로 붙여 쓸 수 있게 해주는 실용적 도구다. 다만 Google이나 Antigravity와 무관한 비공식 도구이므로 설정 파일이나 환경변수를 건드리는 방식에 따르는 위험은 사용자가 감수해야 한다.
이 레포의 용어
- BYOK · Bring Your Own Key, 자신의 API 키를 직접 등록해서 원하는 AI 서비스를 연결하는 방식
- 로컬 프록시 · 내 컴퓨터 안에서만 동작하며 요청을 가로채 다른 곳으로 전달해주는 중계 서버
- 컨텍스트 압축 · 대화가 길어지면 이전 내용을 요약해서 줄이는 처리, 너무 자주 하면 지연과 정보 손실이 생긴다
- Tauri · 웹 기술로 UI를 만들고 Rust로 백엔드를 처리하는 데스크톱 앱 개발 프레임워크
레포 원문 소개 (영문)
Bring Your Own Key (BYOK) proxy for Google Antigravity (IDE, App, & CLI). Connect OpenAI, Anthropic, Gemini, DeepSeek, Ollama, and customize context compression.
GitHub에서 보기주목받는 레포
- vorssaint/vorssaint-utils메뉴바 아이콘 하나로 유료 맥 앱 열 개 값을 대신하는 오픈소스 도구
- Alishahryar1/free-claude-code코딩 AI 에이전트를 무료 모델 49곳에 자유롭게 연결해주는 로컬 프록시
- freestylefly/awesome-gpt-image-2GPT-Image2로 원하는 이미지를 정확히 뽑아내는 프롬프트 설계도 532개를 모아놓은 저장소
- block/buzz사람과 AI 에이전트가 같은 채팅방에서 함께 일하는 오픈소스 협업 플랫폼
- NousResearch/hermes-agentNous Research가 만든, 쓰면 쓸수록 스스로 똑똑해지는 AI 에이전트 Hermes
- virgiliojr94/book-to-skill기술서 PDF를 AI 에이전트가 언제든 펼쳐볼 수 있는 '스킬'로 바꿔주는 도구
- VoltAgent/awesome-agent-skillsAI 코딩 도구가 특정 작업을 '전문가처럼' 하도록 도와주는 매뉴얼 1000개 이상을 한곳에 모았다
- anthropics/claude-plugins-community누구나 만든 Claude 확장 기능을 한곳에 모아 설치하게 해주는 저장소