Tutorial de construção de um ponto de transferência Claude Code com um clique: IP residencial + implantação super simples com Docker Compose

Utilize VoyraCloud Residential IP VPS (rede residencial real, sem bloqueio de conta, estável e de alta velocidade), para implantar com um clique através do Docker Compose o serviço de retransmissão open-source mais maduro e estável atualmente — Claude Relay Service (abreviado como CRS, projeto no GitHub Wei-Shaw/claude-relay-service).

Esta solução suporta:

Proxy completo da API Claude
Balanceamento de carga para múltiplas contas (prevenção de limitação)
Compartilhamento de carona (gerar subchave)
Estatísticas de uso
Painel de gerenciamento Web

Perfeitamente compatível com a ferramenta oficial Claude Code CLI, permitindo que você desfrute de uma experiência de codificação Claude rápida e estável localmente.

Por que escolher IP residencial? As vantagens principais são evidentes

A gestão de risco da Anthropic (Claude) é principalmente direcionada a IPs de data center; usar IP residencial pode reduzir significativamente o risco de bloqueio de conta. O CRS é atualmente o projeto open-source de retransmissão Claude mais popular e estável reconhecido pela comunidade (alta taxa de download da imagem oficial no Docker Hub, inúmeros casos de sucesso). O método de implantação via Docker Compose já inclui o Redis, sem necessidade de instalação manual de dependências, sendo uma solução recomendada tanto pela comunidade quanto oficialmente.

Passo 1: Comprar e fazer login no servidor VoyraCloud Residential IP

Acesse a página de compra do VoyraCloud Residential IP VPS, recomenda-se escolher o nó Los Angeles ou Washington.
- Pessoal/equipes pequenas: a partir de 2 núcleos
- Compartilhamento de carona: recomenda-se 4 núcleos ou mais
Escolha o sistema Ubuntu 24.04 (o mais compatível).
Após a compra, obtenha o IP, nome de usuário (ubuntu) e senha.
Faça login via SSH:
- Windows: recomenda-se PuTTY ou Windows Terminal
- Mac/Linux: execute no terminal ssh ubuntu@seu_IP_VPS

Passo 2: Instalar Docker

Após fazer login no VPS, execute com um clique:

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

Verifique se foi bem-sucedido:

docker --version

Se você ver o número da versão, a instalação foi concluída.

Passo 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

Verifique:

docker compose version

Se mostrar v5.0.1 (ou superior), foi bem-sucedido.

Passo 4: Corrigir permissões do Docker

sudo usermod -aG docker ubuntu && newgrp docker

Passo 5: Criar diretório de implantação

mkdir ~/crs && cd ~/crs

Passo 6: Criar arquivo de configuração docker-compose.yml

nano docker-compose.yml

Cole o seguinte conteúdo (certifique-se de modificar as duas chaves):

services:
  claude-relay:
    image: weishaw/claude-relay-service:latest
    container_name: claude-relay-service
    restart: unless-stopped
    ports:
      - "8080:3000"   # A porta do host pode ser modificada conforme necessário
    environment:
      - PORT=3000
      - REDIS_HOST=redis
      - REDIS_PORT=6379
      - JWT_SECRET=Sua chave aleatória super longa 1      # Pelo menos 60 caracteres, uma mistura de símbolos alfanuméricos
      - ENCRYPTION_KEY=Sua chave aleatória super longa 2  # 
Mesma que acima, deve 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 salvar, Ctrl+X para sair.

Verifique o arquivo:

cat docker-compose.yml

Passo 7: Iniciar o serviço

docker compose up -d

Aguarde de 2 a 15 minutos para baixar a imagem.

Verifique o status:

docker compose ps

Se ambos os contêineres mostrarem Up, foi bem-sucedido.

Verifique os logs para confirmar que está normal:

docker compose logs -f claude-relay

Se você ver o log de health-check completed repetidamente, isso indica que o serviço está saudável (Ctrl+C para sair).

Passo 8: Acessar o painel de gerenciamento Web e configurar a conta

Abra o navegador: http://VPS_IP:8080/web

Na primeira visita, uma conta de administrador será gerada automaticamente, veja como:

cat data/init.json

Após fazer login, as operações:

Clique em "Adicionar conta" → Selecione "Anthropic API" ou "Claude Console"
Insira a senha da sua conta Claude Pro/Max ou a chave API oficial
Suporta adicionar várias contas para implementar balanceamento de carga automático
Pode gerar subchaves API para compartilhar com amigos, reduzindo custos

Passo 9: Configurar Claude Code localmente para usar o servidor de retransmissão

Instale o Claude Code globalmente:

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

Configure as variáveis de ambiente (recomenda-se usar a subchave gerada pelo painel):

Mac/Linux:

export ANTHROPIC_BASE_URL="http://VPS_IP:8080/v1"
export ANTHROPIC_API_KEY="A subchave (ou qualquer string) gerada pelo painel"

Windows PowerShell:

$env:ANTHROPIC_BASE_URL="http://VPS_IP:8080/v1"
$env:ANTHROPIC_API_KEY="A subchave (ou qualquer string) gerada pelo painel."

Teste:

claude --version
claude "hello, world"

Se a resposta for normal, você conseguiu!

Agora você tem umIP residencial puro, rápido e estável, exclusivo para o servidor de retransmissão Claude Code, e pode facilmente compartilhar os custos.

Comandos de manutenção comuns

Atualizar serviço: cd ~/crs && docker compose pull && docker compose up -d
Reiniciar serviço: docker compose restart
Reset completo (cuidado): docker compose down -v && rm -rf logs data

Solução de problemas comuns

Não consegue acessar o painel Web? Verifique o firewall: sudo ufw allow 8080 && sudo ufw reload
Falha ao iniciar o serviço? Verifique os logs: docker compose logs -f, as causas comuns são chaves não modificadas ou problemas de rede, reinicie: docker compose restart
Atualizar serviçodocker compose pull
docker compose up -d

Comece agora → Recomende o VoyraCloud Residential IP

Clique para comprar o VoyraCloud Residential IP VPS

O IP residencial é atualmente a solução mais estável e segura para usar o Claude, altamente recomendado!