GATEWAY: OPERATIONAL PORT: 8080 DEPS: 0 NPM SPEC: ANTHROPIC_V1
SYSTEMS INTEROP // RFC-080

CODEWEAVER // ANTHROPIC <-> GEMINI OAUTH PROXY

A zero-dependency local translation layer enabling Anthropic Claude Code to run directly on top of Google Gemini CLI OAuth sessions. Zero API token billing. Zero external npm dependencies. Real-time token streaming with automatic Vertex AI schema transformation.

Instant Launch Command (Node.js 18+) 1-CLICK EXECUTION
$ git clone https://github.com/whysooraj/CodeWeaver.git && cd CodeWeaver && node proxy.js
SYSTEM TOPOLOGY

Clean ASCII Architecture Flow

PROTOCOL: HTTP/1.1 SSE PIPELINE ENDPOINTS: /v1/messages → :streamGenerateContent
+------------------+       HTTP POST /v1/messages         +-------------------------------+
|  Claude Code CLI | -----------------------------------> | localhost:8080 (CodeWeaver)   |
|  (Anthropic API) | <----------------------------------- | (Zero-dep Node.js reverse px) |
+------------------+     Stream back Anthropic SSE        +---------------+---------------+
                                                                          |
                                           Translate Schema & Add Bearer  | Vertex / OAuth Protocol
                                                                          v
                                                          +---------------+---------------+
                                                          | Google OAuth / Vertex Gemini  |
                                                          | Gemini 1.5 / 2.0 / 2.5 API    |
                                                          +-------------------------------+
        
DETAILED REQUEST / RESPONSE SUBSYSTEM SEQUENCE PIPELINE OVERVIEW
[ CLAUDE CODE ]                [ CODEWEAVER PROXY (8080) ]                 [ GEMINI OAUTH API ]
      │                                     │                                      │
      │── 1. POST /v1/messages ────────────>│                                      │
      │   (Anthropic JSON format)           │                                      │
      │                                     │── 2. Intercept & Token Check ────────│
      │                                     │   Resolve OAuth in ~/.pi/agent       │
      │                                     │                                      │
      │                                     │── 3. Schema Transform ───────────────│
      │                                     │   Convert tools & uppercase types   │
      │                                     │   Strip bloated safety tokens        │
      │                                     │                                      │
      │                                     │── 4. POST streamGenerateContent ────>│
      │                                     │   Authorization: Bearer <OAuth>      │
      │                                     │                                      │
      │                                     │<─ 5. Gemini JSON chunk stream ───────│
      │                                     │                                      │
      │<─ 6. SSE content_block_delta ───────│                                      │
      │   (Zero-latency SSE framing)        │   (On 429: Auto failover to Flash)   │
      │                                     │                                      │
      │<─ 7. SSE message_stop ──────────────│                                      │
        
ENGINEERING SPECIFICATIONS

Feature Matrix & Architectural Comparison

CAPABILITY / METRIC CODEWEAVER OFFICIAL ANTHROPIC LITELLM / PROXIES
Runtime Dependencies ✓ 0 external npm packages (pure Node stdlib) × Proprietary CLI × 40+ Python/Node packages
Auth Provider ✓ Google OAuth 2.0 (Gemini CLI session) Anthropic API Key ($$$) API Keys (Per provider)
Vertex Schema Conversion ✓ Automatic uppercase (OBJECT, STRING, etc.) × N/A Partial / manual configuration
Token Limiter Safety ✓ Built-in (Strips opus classifier tools) × Strict 429 quota block × Passthrough raw headers
Failover Resilience ✓ Auto failover (Gemini Pro → Flash on 429) × Session aborted Configurable retry loop
Latency Overhead ✓ < 12ms (Zero intermediate buffer) Baseline native 40ms - 120ms proxy layer
Platform Portability ✓ Linux, macOS, WSL, Windows Supported platforms Docker / Python env required
INTERACTIVE INSPECTOR

Live Pipeline Simulator

SIMULATOR // REVERSE PROXY EMULATOR
01. INBOUND ANTHROPIC PAYLOAD claude-3-5-sonnet-20241022
{
  "model": "claude-3-5-sonnet-20241022",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Implement quicksort in pure C."
    }
  ],
  "stream": true
}
02. CODEWEAVER STREAMING SSE OUTPUT HTTP 200 OK // SSE
event: message_start
data: {"type":"message_start","message":{"id":"msg_cw_8819","type":"message","role":"assistant"}}

event: content_block_start
data: {"type":"content_block_start","index":0,"content_block":{"type":"text","text":""}}

event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"void quicksort(int arr[], int low, int high) {\n"}}

event: message_stop
data: {"type":"message_stop"}
READY // CLICK TO EMULATE PIPELINE STREAM
CONFIGURATION MANUAL

Quickstart Setup (4 Exact Steps)

STEP 01

Clone & Prepare Repo

Clone the CodeWeaver codebase from GitHub. No npm install is required because it uses pure standard library modules.

git clone https://github.com/whysooraj/CodeWeaver.git && cd CodeWeaver
STEP 02

Authenticate Google Account

Spins up a lightweight local OAuth callback receiver on port 8085 to save your credentials to ~/.pi/agent/auth.json.

node proxy.js --login
STEP 03

Start The Proxy Server

Launches the reverse proxy listening on localhost:8080 (or 8099). Ready to intercept Claude Code traffic.

PORT=8080 node proxy.js
STEP 04

Route Claude Code CLI

Configure Claude Code environment variables in your active shell or inside ~/.claude/settings.json.

export ANTHROPIC_BASE_URL="http://localhost:8080" && export ANTHROPIC_AUTH_TOKEN="sk-local" && claude
STEP 01

Clone & Navigate

Clone the repository via PowerShell. Node.js 18+ is required.

git clone https://github.com/whysooraj/CodeWeaver.git; cd CodeWeaver
STEP 02

Run OAuth Login

Launches the browser authentication handshake and saves user token.

node proxy.js --login
STEP 03

Launch Proxy Service

Start proxy server on port 8080.

$env:PORT="8080"; node proxy.js
STEP 04

Direct Claude Code

Export variables and launch Claude.

$env:ANTHROPIC_BASE_URL="http://localhost:8080"; $env:ANTHROPIC_AUTH_TOKEN="sk-local"; claude
Permanent Configuration: ~/.claude/settings.json PERSISTENT ROUTING
{
  "env": {
    "ANTHROPIC_BASE_URL": "http://localhost:8080",
    "ANTHROPIC_AUTH_TOKEN": "sk-local-proxy-token"
  }
}
MODEL RESOLUTION

Claude Code <-> Gemini Model Mappings

Claude Code enforces a client-side whitelist in its interactive model selector. CodeWeaver automatically translates these requests into corresponding Google Gemini enterprise engines:

CLAUDE SELECTION: SONNET
→ Gemini 2.5 Pro
Default coding powerhouse. Deep multi-file reasoning and complex architectural refactors.
CLAUDE SELECTION: HAIKU
→ Gemini 2.5 Flash
High throughput, ultra-fast responses. Automatic failover target when Pro quota hits 429.
CLAUDE SELECTION: OPUS
→ Gemini 3.1 Pro Preview
Flagship reasoning engine for extreme context algorithms and high-depth logic.
CLAUDE SELECTION: FABLE
→ Gemini 3.1 Flash Lite
Sub-second lightweight execution for trivial linting and unit test completions.
✓ COPIED TO CLIPBOARD