VoyraCloud Logo

Tutorial de construcción de un puente Claude Code con un solo clic: implementación súper sencilla con IP residencial + Docker Compose

Usa VoyraCloud Residential IP VPS para implementar el Servicio de Relay de Claude con un solo clic a través de Docker Compose, estableciendo rápidamente una estación de transferencia de Claude Code estable y resistente a bloqueos. Soporta balanceo de carga para múltiples cuentas, uso compartido de viajes, panel de gestión web, tutoriales detallados con imágenes, incluso principiantes pueden empezar.

VoyraCloud
January 22, 2026
5 min Reading Time
Share:
Tutorial de proxy de Claude API
Estación de transferencia Claude Code
Servicio de Relay Claude
Servicio de transferencia Claude
Despliegue de Claude con Docker Compose
Construcción de intermediación de Claude Code con un solo clic
Agente de IP residencial Claude
Tutorial de construcción de un puente Claude Code con un solo clic: implementación súper sencilla con IP residencial + Docker Compose

Utiliza VoyraCloud Residencial IP VPS (redes residenciales reales, anti-baneo, estable y de alta velocidad), a través de Docker Compose despliega con un clic el servicio de retransmisión de código abierto más maduro y estable actualmente — Claude Relay Service (abreviado CRS, proyecto de GitHub Wei-Shaw/claude-relay-service).

Este plan soporta:

  • Proxy completo de Claude API
  • Balanceo de carga de múltiples cuentas (anti-limitación)
  • Compartición de coche (generar sub clave)
  • Estadísticas de uso
  • Panel de administración web

Perfectamente adaptado a la herramienta oficial Claude Code CLI, para que disfrutes de una experiencia de codificación de Claude rápida y estable en local.

¿Por qué elegir IP residencial? Las ventajas clave son evidentes

El control de riesgos de Anthropic (Claude) se centra principalmente en IP de centros de datos, usar IP residencial puede reducir significativamente el riesgo de baneo. CRS es actualmente el proyecto de retransmisión de Claude de código abierto más popular y estable reconocido por la comunidad (la cantidad de descargas de la imagen oficial en Docker Hub es alta, con innumerables casos de éxito). El método de despliegue de Docker Compose incluye Redis, sin necesidad de instalar dependencias manualmente, es una solución de nivel de producción recomendada por la comunidad y oficial.

Paso 1: Comprar e iniciar sesión en el servidor VoyraCloud Residencial IP

  1. Visita la página de compra de VoyraCloud Residencial IP VPS, se recomienda elegir el nodo Los Ángeles o Washington.
    • Individual/equipo pequeño: se puede comenzar con 2 núcleos
    • Compartición de coche: se sugiere 4 núcleos o más
  2. Selecciona el sistema Ubuntu 24.04 (el más compatible).
  3. Después de la compra, obtén la IP, nombre de usuario (ubuntu) y contraseña.
  4. Inicia sesión a través de SSH:
    • Windows: se recomienda PuTTY o Windows Terminal
    • Mac/Linux: ejecuta en la terminal ssh ubuntu@tu_VPS_IP

Paso 2: Instalar Docker

Después de iniciar sesión en el VPS, ejecuta 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

Verifica si fue exitoso:

docker --version

Si ves el número de versión, significa que la instalación se completó.

Paso 3: Instalar 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

Verifica:

docker compose version

Si muestra v5.0.1 (o superior), es exitoso.

Paso 4: Arreglar permisos de Docker

sudo usermod -aG docker ubuntu && newgrp docker

Paso 5: Crear directorio de despliegue

mkdir ~/crs && cd ~/crs

Paso 6: Crear archivo de configuración docker-compose.yml

nano docker-compose.yml

Pega el siguiente contenido (asegúrate de modificar las dos claves):

services:
  claude-relay:
    image: weishaw/claude-relay-service:latest
    container_name: claude-relay-service
    restart: unless-stopped
    ports:
      - "8080:3000"   # El puerto del host puede ser modificado según sea necesario
    environment:
      - PORT=3000
      - REDIS_HOST=redis
      - REDIS_PORT=6379
      - JWT_SECRET=Tu clave aleatoria super larga 1      # Al menos 60 caracteres, una mezcla de símbolos alfanuméricos
      - ENCRYPTION_KEY=Tu clave aleatoria super larga 2  # 
Igual que arriba, debe ser diferente
    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 para guardar, Ctrl+X para salir.

Verifica el archivo:

cat docker-compose.yml

Paso 7: Iniciar servicio

docker compose up -d

Espera de 2 a 15 minutos para descargar la imagen.

Verifica el estado:

docker compose ps

Si ambos contenedores muestran "Up", es exitoso.

Verifica los registros para confirmar que está normal:

docker compose logs -f claude-relay

Si ves el registro "health-check completed" repetidamente, indica que el servicio está saludable (Ctrl+C para salir).

Paso 8: Acceder al panel de administración web y configurar la cuenta

Abre en el navegador: http://VPS_IP:8080/web

La primera vez que accedas, se generará automáticamente una cuenta de administrador, forma de ver:

cat data/init.json

Después de iniciar sesión:

  • Haz clic en "Agregar cuenta" → Selecciona "Anthropic API" o "Claude Console"
  • Ingresa tu contraseña de cuenta Claude Pro/Max o la clave API oficial
  • Soporta agregar múltiples cuentas para lograr un balanceo de carga automático
  • Se puede generar una sub clave API para compartir con amigos y reducir costos

Paso 9: Configurar Claude Code localmente usando el proxy

Instala Claude Code globalmente:

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

Configura las variables de entorno (se recomienda usar la sub clave generada por el panel):

Mac/Linux:

export ANTHROPIC_BASE_URL="http://VPS_IP:8080/v1"
export ANTHROPIC_API_KEY="La subclave (o cualquier cadena) generada por el panel"

Windows PowerShell:

$env:ANTHROPIC_BASE_URL="http://VPS_IP:8080/v1"
$env:ANTHROPIC_API_KEY="La subclave (o cualquier cadena) generada por el panel."

Prueba:

claude --version
claude "hola, mundo"

Si respondes normalmente, ¡misión cumplida!

Ahora tienes unproxy de Claude Code de IP residencial, rápido, estable y privado, y puedes compartir costos fácilmente.

Comandos de mantenimiento comunes

  • Actualizar servicio: cd ~/crs && docker compose pull && docker compose up -d
  • Reiniciar servicio: docker compose restart
  • Restablecimiento completo (con precaución): docker compose down -v && rm -rf logs data

Resolución de problemas comunes

  • ¿No se puede acceder al panel web? Verifica el firewall: sudo ufw allow 8080 && sudo ufw reload
  • ¿Fallo al iniciar el servicio? Verifica los registros: docker compose logs -f, las causas comunes son claves no modificadas o problemas de red, reinicia: docker compose restart
  • Actualizar serviciodocker compose pull
    docker compose up -d

Comienza ahora → Recomiendo VoyraCloud Residencial IP

Haz clic para comprar VoyraCloud Residencial IP VPS

La IP residencial es actualmente la solución más estable y segura para usar Claude, ¡altamente recomendada!

Share:

Related Articles