Codex와 Claude Code에 Grok 모델을 연결하는 다중 계정 게이트웨이
기존에 쓰던 AI 코딩 도구의 설정을 건드리지 않고 Grok의 대화, 이미지, 영상 기능을 호출할 수 있습니다. 여러 Grok 계정의 인증과 할당량을 한 곳에서 관리하며, OpenAI와 Anthropic 규격의 API로 변환해 주는 Go 기반 게이트웨이입니다. 덕분에 별도 클라이언트를 만들지 않고도 현재 작업 중인 도구에서 Grok 모델을 바로 사용할 수 있습니다.
서로 다른 세 서비스의 계정 격리 관리
Grok Build, Grok Web, Grok Console은 인증 방식과 지원 모델이 다르지만, 이 도구는 각 계정을 독립적인 풀로 관리합니다. Build는 OAuth를 통해 계정마다 다른 모델을 발견하고, Web과 Console은 SSO 인증과 내장된 모델 카탈로그를 사용합니다. 각 계정의 쿼터, 건강 상태, 동시 연결 수를 개별적으로 추적하여 한 계정의 장애가 다른 계정에 영향을 주지 않도록 합니다. 요청은 해당 계정의 상태와 할당량에 따라 라우팅되며, 사용량과 청구 내역은 요청 완료 후 기록됩니다.
기존 AI 도구와의 호환성
OpenAI와 Anthropic의 API 규격을 모두 지원하여 Codex, Claude Code, 그리고 관련 SDK를 그대로 연결할 수 있습니다. 대화, 도구 호출, 추론 과정, 멀티턴 세션, 프롬프트 캐싱 등 복잡한 기능도 지원하며, 특히 Codex와 Claude Code가 요구하는 호환성을 유지하도록 요청을 변환합니다. 이미지 생성과 편집, 비동기 영상 작업, 음성 합성 및 인식까지 하나의 API 엔드포인트로 처리합니다. 클라이언트 키에는 모델 허용 목록과 분당 요청 수, 동시 연결 수, 지출 한도, 만료일을 설정할 수 있습니다.
출력 경로 제어와 Cloudflare 대응
각 계정의 요청이 어떤 경로를 통해 나가는지 세밀하게 제어할 수 있습니다. HTTP, SOCKS, Trojan, VLESS 등 다양한 프록시 프로토콜을 지원하며, 계정별로 다른 프록시 풀을 지정하거나 폴백 전략을 설정할 수 있습니다. Cloudflare 차단 회피를 위해 FlareSolverr 연동도 가능하며, 프록시 노드의 상태를 실시간으로 탐지하고 장애 시 자동으로 복구하는 메커니즘을 갖추고 있습니다. 이는 특히 여러 계정을 동시에 사용할 때 IP 차단 위험을 줄이는 데 중요합니다. Hysteria와 TUIC는 아직 지원하지 않으며, FlareSolverr은 HTTP/SOCKS 프록시 URL만 받아들입니다.
사용 전 반드시 확인해야 할 사항
이 프로젝트는 기술 연구와 학습 목적으로만 제공되며, Grok의 공식 이용약관과 현지 법률을 준수해야 합니다. 위반 시 모든 책임은 사용자에게 있습니다. Build 계정의 경우, 리프레시 토큰이 갱신될 때 다른 클라이언트와 공유하면 토큰이 소모될 수 있으므로 각 클라이언트를 독립적으로 인증하거나 이전 클라이언트가 완전히 종료된 후 자격 증명을 이전해야 합니다. 또한, 자격 증명 암호화 키는 저장된 자격 증명이 있는 경우 절대 변경해서는 안 되며, 초기 관리자 비밀번호는 첫 로그인 후 즉시 변경하고 설정 파일에서 부트스트랩 관리자를 제거해야 합니다.
