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를 참조하세요