Guida alla creazione di un ponte Claude Code con un clic: IP residenziale + Docker Compose super semplice da implementare

Utilizza VoyraCloud Residential IP VPS (rete residenziale reale, senza rischio di blocco, stabile e veloce), per distribuire con un clic tramite Docker Compose il servizio di intermediazione open source più maturo e stabile attualmente disponibile —— Claude Relay Service (abbreviato CRS, progetto GitHub Wei-Shaw/claude-relay-service).

Questa soluzione supporta:

Proxy completo per l'API di Claude
Bilanciamento del carico multi-account (per evitare limitazioni)
Condivisione in carpool (generazione di chiavi secondarie)
Statistiche di utilizzo
Pannello di gestione Web

Perfettamente compatibile con lo strumento ufficiale Claude Code CLI, per un'esperienza di codifica Claude veloce e stabile in locale.

Perché scegliere IP residenziali? I vantaggi chiave sono evidenti

La gestione del rischio di Anthropic (Claude) è principalmente rivolta agli IP dei data center; utilizzare IP residenziali può ridurre significativamente il rischio di blocco. CRS è attualmente il progetto open source di intermediazione Claude più popolare e stabile riconosciuto dalla comunità (l'immagine ufficiale di Docker Hub ha un alto numero di download, con innumerevoli casi di successo). Il metodo di distribuzione tramite Docker Compose include Redis, senza necessità di installare manualmente le dipendenze, ed è una soluzione di livello produttivo raccomandata ufficialmente e dalla comunità.

Primo passo: acquisto e accesso al server IP residenziale di VoyraCloud

Visita la pagina di acquisto di VoyraCloud Residential IP VPS, si consiglia di scegliere i nodi Los Angeles o Washington.
- Individuali/piccole squadre: è sufficiente partire da 2 core
- Condivisione in carpool: si consiglia 4 core o più
Scegli il sistema Ubuntu 24.04 (il più compatibile).
Dopo l'acquisto, ottieni l'IP, il nome utente (ubuntu) e la password.
Accedi tramite SSH:
- Windows: si consiglia PuTTY o Windows Terminal
- Mac/Linux: esegui nel terminale ssh ubuntu@tuoVPS_IP

Passo 1: installa Docker

Dopo aver effettuato l'accesso al VPS, esegui con un clic:

sudo mkdir -p /etc/apt/sources.list.d && curl -fsSL https://get.docker.com -o get-docker.sh && sudo sh get-docker.sh && sudo systemctl restart docker && sudo systemctl enable docker

Controlla se l'installazione è avvenuta con successo:

docker --version

Se vedi il numero di versione, l'installazione è completata.

Passo 2: installa Docker Compose

DOCKER_CONFIG=${DOCKER_CONFIG:-$HOME/.docker} && mkdir -p $DOCKER_CONFIG/cli-plugins && curl -SL https://github.com/docker/compose/releases/download/v5.0.1/docker-compose-linux-x86_64 -o $DOCKER_CONFIG/cli-plugins/docker-compose && chmod +x $DOCKER_CONFIG/cli-plugins/docker-compose

Controlla:

docker compose version

Se visualizzi v5.0.1 (o superiore), l'installazione è riuscita.

Passo 3: ripara i permessi di Docker

sudo usermod -aG docker ubuntu && newgrp docker

Passo 4: crea la directory di distribuzione

mkdir ~/crs && cd ~/crs

Passo 5: crea il file di configurazione docker-compose.yml

nano docker-compose.yml

Incolla il seguente contenuto (assicurati di modificare le due chiavi):

services:
  claude-relay:
    image: weishaw/claude-relay-service:latest
    container_name: claude-relay-service
    restart: unless-stopped
    ports:
      - "8080:3000"   # La porta host può essere modificata secondo necessità
    environment:
      - PORT=3000
      - REDIS_HOST=redis
      - REDIS_PORT=6379
      - JWT_SECRET=La tua chiave casuale super lunga 1      # Almeno 60 caratteri, una combinazione di simboli alfanumerici
      - ENCRYPTION_KEY=La tua chiave casuale super lunga 2  # 
Stessa di sopra, deve essere diversa
    depends_on:
      redis:
        condition: service_healthy
    volumes:
      - ./logs:/app/logs
      - ./data:/app/data

  redis:
    image: redis:7-alpine
    container_name: claude-relay-redis
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 3s
      timeout: 2s
      retries: 30
    volumes:
      - redis_data:/data

volumes:
  redis_data:

Ctrl+O per salvare, Ctrl+X per uscire.

Verifica il file:

cat docker-compose.yml

Passo 6: avvia il servizio

docker compose up -d

Attendi 2-15 minuti per il download delle immagini.

Controlla lo stato:

docker compose ps

Se entrambi i contenitori mostrano Up, l'operazione è riuscita.

Controlla i log per confermare che tutto funzioni correttamente:

docker compose logs -f claude-relay

Se vedi il log "health-check completed" che appare ripetutamente, significa che il servizio è sano (Ctrl+C per uscire).

Passo 7: accedi al pannello di gestione Web e configura l'account

Apri il browser: http://VPS_IP:8080/web

La prima volta che accedi, verrà generato automaticamente un account amministratore, per visualizzarlo:

cat data/init.json

Dopo aver effettuato l'accesso, esegui le seguenti operazioni:

Clicca su “Aggiungi account” → seleziona “Anthropic API” o “Claude Console”
Inserisci la tua password dell'account Claude Pro/Max o la chiave API ufficiale
Supporta l'aggiunta di più account per implementare il bilanciamento automatico del carico
Puoi generare chiavi API secondarie per condividere con amici in carpool, riducendo i costi

Passo 8: configura Claude Code per utilizzare il relay locale

Installa globalmente Claude Code:

npm install -g @anthropic-ai/claude-code

Configura le variabili d'ambiente (si consiglia di utilizzare la chiave secondaria generata dal pannello):

Mac/Linux:

export ANTHROPIC_BASE_URL="http://VPS_IP:8080/v1"
export ANTHROPIC_API_KEY="La chiave secondaria (o qualsiasi stringa) generata dal pannello"

Windows PowerShell:

$env:ANTHROPIC_BASE_URL="http://VPS_IP:8080/v1"
$env:ANTHROPIC_API_KEY="La chiave secondaria (o qualsiasi stringa) generata dal pannello."

Test:

claude --version
claude "hello, world"

Se ricevi una risposta normale, hai completato con successo!

Ora hai unIP residenziale puro, veloce e stabile, esclusivo per il tuo relay di Claude Code, e puoi facilmente condividere i costi in carpool.

Comandi di manutenzione comuni

Aggiorna il servizio: cd ~/crs && docker compose pull && docker compose up -d
Riavvia il servizio: docker compose restart
Ripristino completo (con cautela): docker compose down -v && rm -rf logs data

Risoluzione dei problemi comuni

Impossibile accedere al pannello Web? Controlla il firewall: sudo ufw allow 8080 && sudo ufw reload
Il servizio non si avvia? Controlla i log: docker compose logs -f, le cause comuni sono chiavi non modificate o problemi di rete, riavvia: docker compose restart
Aggiorna il serviziodocker compose pull
docker compose up -d

Inizia subito → Consiglia VoyraCloud Residential IP

Clicca per acquistare VoyraCloud Residential IP VPS

Gli IP residenziali sono attualmente la soluzione più stabile e sicura per utilizzare Claude, altamente raccomandati!