SovranAMR/claude-code-via-antigravity

Google의 Antigravity (Cloud Code Assist) 구독을 통해 Claude Code CLI를 무료로 사용하세요.

Claude Code CLI ↔ Google Cloud Code Assist API를 연결하는 경량 로컬 프록시 (Local Proxy)로, Anthropic API 키 없이도 다음과 같은 모델에 접근할 수 있게 해줍니다.

Claude Opus 4.6 및 Claude Sonnet 4.5

┌──────────────┐ ┌─────────────────┐ ┌──────────────────────────┐
│ Claude Code │────▶│ Local Proxy │────▶│ Google Cloud Code Assist│
│ CLI │◀────│ (localhost:51200)│◀────│ (Antigravity API) │
...

이 프록시는 Claude Code CLI의 요청을 가로채서 Anthropic의 형식을 Google의 Cloud Code Assist API 형식으로 변환하고, Claude Code가 기대하는 형식으로 응답을 반환합니다. 이는 Google의 Antigravity/Code Assist 구독에 Claude 모델에 대한 접근 권한이 포함되어 있기 때문에 가능합니다.

Node.js 18+— Claude Code CLI 다운로드—npm install -g @anthropic-ai/claude-code

Antigravity IDE Ultra 또는 Google One AI Premium 구독이 포함된 Google 계정

git clone https://github.com/SovranAMR/claude-code-via-antigravity.git
cd claude-code-via-antigravity

node setup.mjs login

Google OAuth를 위해 브라우저가 열립니다. Antigravity/AI Premium 구독이 있는 계정으로 로그인하세요.

Linux / macOS:

./start.sh

Windows (PowerShell):

.\start.ps1

Windows (더블 클릭):
start.bat을 더블 클릭하기만 하면 됩니다.

끝입니다! Claude Code CLI가 Claude 모델에 대한 모든 권한을 가진 채로 실행됩니다. 🚀

모델	설명
claude-opus-4-6-thinking	가장 강력하며, 확장된 사고 (Thinking) 기능 포함
claude-sonnet-4-5	빠르고 유능함
claude-sonnet-4-5-thinking	사고 (Thinking) 기능이 포함된 Sonnet

모든 Claude Code 모델 요청은 사용 가능한 최적의 모델로 자동 매핑됩니다.

완벽하게 지원됩니다. 데스크톱 바로가기가 포함되어 있습니다:

# 데스크톱 바로가기 복사
cp claude-free.desktop ~/.local/share/applications/
# Exec 라인을 사용자의 start.sh 경로를 가리키도록 수정하세요:
...

start.sh를 통해 완벽하게 지원됩니다.

Dock 접근을 위한 Automator 앱을 만들 수도 있습니다.

PowerShell (start.ps1)을 통해 완벽하게 지원됩니다.

) 또는 배치 파일 (start.bat).

요구 사항 (Requirements):

• Windows용 Node.js
• Claude Code CLI (npm install -g @anthropic-ai/claude-code)
• Windows Terminal 권장

변수 (Variable)	기본값 (Default)	설명 (Description)
PROXY_PORT	51200	로컬 프록시 (local proxy)를 위한 포트
ANTHROPIC_BASE_URL	http://localhost:51200	런처에 의해 자동으로 설정됨
ANTHROPIC_API_KEY	claude-code-via-antigravity	자동으로 설정됨 (어떤 값이든 작동함)

프록시는 Claude Code의 UI를 깔끔하게 유지하기 위해 터미널 대신 파일에 로그를 기록합니다:

Linux/macOS: ~/.claude-code-via-antigravity-proxy.log

Windows: %USERPROFILE%\.claude-code-via-antigravity-proxy.log

실시간으로 로그 확인:

tail -f ~/.claude-code-via-antigravity-proxy.log

토큰은 프록시에 의해 자동으로 갱신됩니다. 인증 오류가 발생하는 경우:

node setup.mjs refresh

claude-code-via-antigravity/
├── proxy.mjs # 로컬 프록시 서버 (Anthropic ↔ Google 변환)
├── setup.mjs # OAuth 인증 및 자격 증명 설정
...

메시지 변환 (Message Conversion): Anthropic의 Messages API 형식을 Google의 streamGenerateContent 형식으로 변환합니다.

도구 스키마 정제 (Tool Schema Sanitization): 지원되지 않는 JSON Schema 필드 (anyOf, oneOf, $schema)를 제거하고, 복잡한 타입을 평탄화(flatten)하며, 모든 스키마에 type 필드가 있도록 보장합니다.

스트리밍 (Streaming): Google의 SSE 스트림을 Anthropic의 SSE 스트림 형식으로 실시간 변환합니다.

역할 교대 (Role Alternation): 연속된 동일 역할의 메시지를 병합하여 Google의 user→model→user→model 턴 구조를 강제합니다.

사고 블록 (Thinking Blocks): API를 혼란스럽게 할 수 있는 내부 사고 블록을 제거합니다.

동적 사고 예산 (Dynamic Thinking Budget): 요청 크기에 따라 사고 예산을 조정합니다 (max_tokens의 25%, 1024–10240 사이로 제한).

병렬 엔드포인트 (Parallel Endpoints): 낮은 지연 시간(latency)을 위해 프로덕션(production)과 샌드박스(sandbox) 엔드포인트를 동시에 실행하여 경쟁시킵니다.

자동 토큰 갱신 (Auto Token Refresh): OAuth 토큰이 만료되면 자동으로 갱신합니다.

이슈 (Issue)	해결 방법 (Solution)
Cannot read credentials	먼저 node setup.mjs login을 실행하세요
429 Rate Limited	몇 초간 기다린 후 다시 시도하세요
503 Service Unavailable	Google API가 일시적으로 중단되었습니다. 다시 시도하세요
tools.*.input_schema.type: Field required	최신 버전으로 업데이트하세요
프록시 로그가 Claude 출력과 섞임	최신 버전으로 업데이트하세요 (이제 로그는 파일로 저장됩니다)
EADDRINUSE	기존 프록시를 종료하세요: kill -9 $(lsof -t -i :51200)

Pull request를 환영합니다! 개선이 필요한 몇 가지 영역은 다음과 같습니다:

• macOS Automator 앱 템플릿
• 프롬프트 캐싱 (Prompt caching) 지원 (Google API에서 지원할 경우)
• Claude Code로 Thinking block (사고 블록) 스트리밍
• 자동 업데이트 메커니즘

이 프로젝트는 Anthropic 또는 Google과 관련이 없습니다. 공개적으로 사용 가능한 API를 사용합니다. 책임감 있게, 그리고 Google 및 Anthropic의 서비스 약관에 따라 사용하십시오.

개인 및 비상업적 용도로만 사용 가능 — LICENSE를 참조하세요