「一鍵搭建 Claude Code 中轉站教程:住宅 IP + Docker Compose 超簡單部署」

VoyraCloud の住宅 IP VPS を使用して、Docker Compose で Claude Relay Service をワンクリックデプロイし、安定した封鎖防止の Claude Code 中継所を迅速に構築します。複数アカウントの負荷分散、相乗り共有、Web 管理パネルをサポートしており、詳細な図解チュートリアルがあるため、初心者でも簡単に始められます。

VoyraCloud
January 22, 2026
2 min Reading Time
Share:
Claude API プロキシチュートリアル
クロードコード中継所
クロード中継サービス
クロード中継サービス
Docker ComposeによるClaudeのデプロイメント
ワンクリックでClaude Codeの中継を構築
住宅IPクロード代理
「一鍵搭建 Claude Code 中轉站教程:住宅 IP + Docker Compose 超簡單部署」

利用 VoyraCloud 住宅 IP VPS(リアル住宅ネットワーク、防封号、安定した高速)、Docker Composeを使用して現在最も成熟し安定したオープンソースのClaude中継サービス—— Claude Relay Service(略称CRS、GitHubプロジェクト Wei-Shaw/claude-relay-service)をワンクリックでデプロイします。

本方案支持:

  • Claude API 完全プロキシ
  • 複数アカウントの負荷分散(制限回避)
  • 相乗り共有(サブキー生成)
  • 使用量統計
  • Web管理パネル

公式Claude Code CLIツールに完璧に適合し、ローカルで高速かつ安定したClaudeコーディング体験を楽しめます。

なぜ住宅IPを選ぶのか?核心的な利点は一目瞭然

Anthropic(Claude)のリスク管理は主にデータセンターIPを対象としており、住宅IPを使用することでアカウント停止のリスクを大幅に低減できます。CRSは現在コミュニティで認められている最も人気があり、最も安定したClaude中継オープンソースプロジェクトです(Docker Hubの公式イメージのダウンロード数が多く、成功事例が多数あります)。Docker Composeのデプロイ方法はRedisが付属しており、手動で依存関係をインストールする必要はなく、公式およびコミュニティが推奨するプロダクションレベルのソリューションです。

第一歩:VoyraCloud 住宅 IP サーバーを購入してログイン

  1. VoyraCloud 住宅 IP VPS 購入ページにアクセスし、ロサンゼルスまたはワシントンノードを選択することをお勧めします。
    • 個人/小チーム:2コアから始められます
    • 相乗り共有:4コア以上を推奨します
  2. システム選択 Ubuntu 24.04(最も互換性があります)。
  3. 購入完了後、IP、ユーザー名(ubuntu)、パスワードを取得します。
  4. SSHでログイン:
    • Windows:PuTTYまたはWindows Terminalを推奨します
    • Mac/Linux:ターミナルで ssh ubuntu@あなたのVPS_IP を実行します

ステップ 1:Dockerをインストール

VPSにログイン後、ワンクリックで実行:

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

成功したか確認:

docker --version

バージョン番号が表示されれば、インストール完了です。

ステップ 2: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

確認:

docker compose version

v5.0.1(またはそれ以上)が表示されれば成功です。

ステップ 3:Dockerの権限を修正

sudo usermod -aG docker ubuntu && newgrp docker

ステップ 4:デプロイディレクトリを作成

mkdir ~/crs && cd ~/crs

ステップ 5:docker-compose.yml設定ファイルを作成

nano docker-compose.yml

以下の内容を貼り付けます(必ず2箇所のキーを変更してください):

services:
  claude-relay:
    image: weishaw/claude-relay-service:latest
    container_name: claude-relay-service
    restart: unless-stopped
    ports:
      - "8080:3000"   # ホストポートは必要に応じて変更できます
    environment:
      - PORT=3000
      - REDIS_HOST=redis
      - REDIS_PORT=6379
      - JWT_SECRET=あなたの非常に長いランダムキー1      # 少なくとも60文字、英数字の混合
      - ENCRYPTION_KEY=あなたの非常に長いランダムキー2  # 
上記と同じ、異なる必要があります
    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で保存、Ctrl+Xで終了します。

ファイルを検証:

cat docker-compose.yml

ステップ 6:サービスを起動

docker compose up -d

イメージのダウンロードに2-15分待ちます。

状態を確認:

docker compose ps

2つのコンテナが「Up」と表示されれば成功です。

ログを確認して正常を確認:

docker compose logs -f claude-relay

繰り返し表示される「health-check completed」ログがサービスの健康を示します(Ctrl+Cで終了)。

ステップ 7:Web管理パネルにアクセスし、アカウントを設定

ブラウザで:http://VPS_IP:8080/web

初回アクセス時に自動的に管理者アカウントが生成されます。確認方法:

cat data/init.json

ログイン後の操作:

  • 「アカウントを追加」をクリック → 「Anthropic API」または「Claude Console」を選択
  • あなたのClaude Pro/Maxアカウントのパスワードまたは公式APIキーを入力
  • 複数のアカウントを追加して自動的に負荷分散を実現
  • 友人と相乗り共有するためのサブAPIキーを生成し、コストを削減

ステップ 8:ローカルでClaude Codeを中継所として設定

Claude Codeをグローバルにインストール:

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

環境変数を設定(パネル生成のサブキーを使用することを推奨):

Mac/Linux

export ANTHROPIC_BASE_URL="http://VPS_IP:8080/v1"
export ANTHROPIC_API_KEY="パネルで生成されたサブキー(または任意の文字列)"

Windows PowerShell

$env:ANTHROPIC_BASE_URL="http://VPS_IP:8080/v1"
$env:ANTHROPIC_API_KEY="パネルで生成されたサブキー(または任意の文字列)."

テスト:

claude --version
claude "hello, world"

正常に応答すれば大成功です!

あなたは今、純住宅IP、高速安定、プライベート専用のClaude Code中継所を持っており、簡単に相乗りで費用を分担できます。

よく使うメンテナンスコマンド

  • サービスを更新:cd ~/crs && docker compose pull && docker compose up -d
  • サービスを再起動:docker compose restart
  • 完全リセット(注意):docker compose down -v && rm -rf logs data

よくある質問の解決

  • Webパネルにアクセスできない? ファイアウォールを確認:sudo ufw allow 8080 && sudo ufw reload
  • サービスの起動に失敗? ログを確認:docker compose logs -f、一般的な原因はキーが変更されていないかネットワークの問題です。再起動すれば解決します:docker compose restart
  • サービスを更新docker compose pull
    docker compose up -d

今すぐ始める → VoyraCloud 住宅 IP を推奨

VoyraCloud 住宅 IP VPSを購入するにはこちらをクリック

住宅IPは現在Claudeを使用する上で最も安定して安全なソリューションであり、強く推奨します!

Share:

Related Articles