VoyraCloud Logo

Guide de création d'un relais Claude Code en un clic : Déploiement super simple avec IP résidentielle + Docker Compose

Utilisez VoyraCloud pour déployer en un clic le service de relais Claude via Docker Compose, et construisez rapidement une station de transit Claude Code stable et résistante aux blocages. Prend en charge l'équilibrage de charge multi-comptes, le covoiturage, un panneau de gestion Web, avec un tutoriel détaillé en images, même les débutants peuvent s'y mettre.

VoyraCloud
January 22, 2026
5 min Reading Time
Share:
Tutoriel de proxy Claude API
Station de transit Claude Code
Service de relais Claude
Service de transit Claude
Déploiement de Claude avec Docker Compose
Construction de l'intermédiaire Claude Code en un clic
Agent IP résidentiel Claude
Guide de création d'un relais Claude Code en un clic : Déploiement super simple avec IP résidentielle + Docker Compose

Utilisez VoyraCloud Résidentiel IP VPS (réseau résidentiel réel, anti-bannissement, stable et rapide), déployez en un clic via Docker Compose le service de relais open source Claude le plus mature et stable — Claude Relay Service (abrégé CRS, projet GitHub Wei-Shaw/claude-relay-service).

Cette solution prend en charge :

  • Proxy complet de l'API Claude
  • Équilibrage de charge multi-comptes (anti-limitation)
  • Partage de voiture (génération de sous-clé)
  • Statistiques d'utilisation
  • Panneau de gestion Web

Parfaitement adapté à l'outil officiel Claude Code CLI, vous permettant de profiter d'une expérience de codage Claude rapide et stable en local.

Pourquoi choisir une IP résidentielle ? Les avantages clés sont évidents

Le contrôle des risques d'Anthropic (Claude) cible principalement les IP de centre de données, l'utilisation d'IP résidentielle peut considérablement réduire le risque de bannissement. CRS est actuellement reconnu par la communauté comme le projet open source de relais Claude le plus populaire et le plus stable (le volume de téléchargement des images officielles sur Docker Hub est élevé, avec d'innombrables cas de succès). La méthode de déploiement Docker Compose inclut Redis, sans besoin d'installer manuellement les dépendances, solution de niveau production recommandée par les officiels et la communauté.

Étape 1 : Acheter et se connecter au serveur VoyraCloud IP résidentiel

  1. Visitez la page d'achat de VoyraCloud Résidentiel IP VPS, il est recommandé de choisir le nœud Los Angeles ou Washington.
    • Personnel/ petite équipe : 2 cœurs au minimum
    • Partage de voiture : recommandé 4 cœurs ou plus
  2. Sélectionnez le système Ubuntu 24.04 (le plus compatible).
  3. Après l'achat, obtenez l'IP, le nom d'utilisateur (ubuntu) et le mot de passe.
  4. Connectez-vous via SSH :
    • Windows : recommandé PuTTY ou Windows Terminal
    • Mac/Linux : exécutez dans le terminal ssh ubuntu@votre_VPS_IP

Étape 2 : Installer Docker

Après vous être connecté au VPS, exécutez en 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

Vérifiez si cela a réussi :

docker --version

Si vous voyez le numéro de version, cela signifie que l'installation est terminée.

Étape 3 : Installer 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

Vérifiez :

docker compose version

Affichez v5.0.1 (ou plus) pour réussir.

Étape 4 : Réparer les permissions Docker

sudo usermod -aG docker ubuntu && newgrp docker

Étape 5 : Créer le répertoire de déploiement

mkdir ~/crs && cd ~/crs

Étape 6 : Créer le fichier de configuration docker-compose.yml

nano docker-compose.yml

Collez le contenu suivant (assurez-vous de modifier les deux clés) :

services:
  claude-relay:
    image: weishaw/claude-relay-service:latest
    container_name: claude-relay-service
    restart: unless-stopped
    ports:
      - "8080:3000"   # Le port hôte peut être modifié selon les besoins
    environment:
      - PORT=3000
      - REDIS_HOST=redis
      - REDIS_PORT=6379
      - JWT_SECRET=Votre clé aléatoire super longue 1      # Au moins 60 caractères, un mélange de symboles alphanumériques
      - ENCRYPTION_KEY=Votre clé aléatoire super longue 2  # 
Identique à la précédente, doit être différente
    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 pour enregistrer, Ctrl+X pour quitter.

Vérifiez le fichier :

cat docker-compose.yml

Étape 7 : Démarrer le service

docker compose up -d

Attendez 2 à 15 minutes pour télécharger l'image.

Vérifiez l'état :

docker compose ps

Si les deux conteneurs affichent "Up", c'est réussi.

Vérifiez les journaux pour confirmer le bon fonctionnement :

docker compose logs -f claude-relay

Si vous voyez le journal "health-check completed" apparaître à plusieurs reprises, cela signifie que le service est sain (Ctrl+C pour quitter).

Étape 8 : Accéder au panneau de gestion Web et configurer le compte

Ouvrez le navigateur : http://VPS_IP:8080/web

Lors de la première visite, un compte administrateur sera généré automatiquement, méthode de vérification :

cat data/init.json

Après vous être connecté, procédez comme suit :

  • Cliquez sur "Ajouter un compte" → Sélectionnez "Anthropic API" ou "Claude Console"
  • Entrez votre mot de passe de compte Claude Pro/Max ou la clé API officielle
  • Prend en charge l'ajout de plusieurs comptes pour réaliser un équilibrage de charge automatique
  • Peut générer une sous-clé API pour partager avec des amis, réduisant ainsi les coûts

Étape 9 : Configurer Claude Code localement pour utiliser le relais

Installez Claude Code globalement :

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

Configurez les variables d'environnement (il est recommandé d'utiliser la sous-clé générée par le panneau) :

Mac/Linux :

export ANTHROPIC_BASE_URL="http://VPS_IP:8080/v1"
export ANTHROPIC_API_KEY="La sous-clé (ou toute chaîne) générée par le panneau"

Windows PowerShell :

$env:ANTHROPIC_BASE_URL="http://VPS_IP:8080/v1"
$env:ANTHROPIC_API_KEY="La sous-clé (ou toute chaîne) générée par le panneau."

Testez :

claude --version
claude "hello, world"

Une réponse normale signifie que c'est réussi !

Vous disposez maintenant d'un relais Claude Code privé, rapide et stable avec une IP résidentielle, et vous pouvez facilement partager les coûts.

Commandes de maintenance courantes

  • Mettre à jour le service : cd ~/crs && docker compose pull && docker compose up -d
  • Redémarrer le service : docker compose restart
  • Réinitialisation complète (avec précaution) : docker compose down -v && rm -rf logs data

Résolution des problèmes fréquents

  • Impossible d'accéder au panneau Web ? Vérifiez le pare-feu : sudo ufw allow 8080 && sudo ufw reload
  • Échec du démarrage du service ? Vérifiez les journaux : docker compose logs -f, les raisons courantes sont que les clés n'ont pas été modifiées ou des problèmes de réseau, redémarrez simplement : docker compose restart
  • Mettre à jour le service docker compose pull
    docker compose up -d

Commencez maintenant → Recommandé VoyraCloud Résidentiel IP

Cliquez pour acheter VoyraCloud Résidentiel IP VPS

Les IP résidentielles sont actuellement la solution la plus stable et la plus sécurisée pour utiliser Claude, fortement recommandée !

Share:

Related Articles