コンテンツにスキップ

Claude Code 完全ガイド

Claude Code Docker完全ガイド - コンテナ化で実現する安全で効率的な開発環境

この記事のポイント

  • セキュアな隔離環境

    ホストシステムから完全に分離されたClaude Code実行環境

  • Windows環境対応

    Docker Desktop経由でWindows環境でも利用可能（WSL2またはHyper-V必須）

  • 権限管理の簡略化

    --dangerously-skip-permissionsフラグを用いた権限確認の簡略化（注意して使用）

  • CI/CD統合

    ヘッドレスモードでの自動化とパイプライン統合

📖 Claude Code Docker化の背景

2025年現在、Anthropic公式がDevContainer機能を正式サポートしており、Docker化されたClaude Code環境が標準的な開発手法として確立されています。公式リポジトリ anthropics/devcontainer-features でメンテナンスされています。

なぜDocker化が重要なのか

Claude Codeは強力なAI開発支援ツールですが、以下の課題がありました：

  • 権限管理の複雑さ: 毎回の操作で権限確認が必要
  • 環境の一貫性: チーム間で異なる開発環境
  • セキュリティリスク: ホストシステムへの直接アクセス
  • Windows互換性: Docker Desktop環境での制約

Dockerコンテナ化により、これらの課題を解決できます。

🏗️ 利用可能なDocker実装オプション

1. 公式DevContainer（推奨）

Anthropic公式メンテナンスのDevContainer実装です。

// .devcontainer/devcontainer.json
{
  "name": "Claude Code DevContainer",
  "image": "mcr.microsoft.com/devcontainers/base:ubuntu",
  "features": {
    "ghcr.io/anthropics/devcontainer-features/claude-code:1": {}
  },
  "customizations": {
    "vscode": {
      "extensions": [
        "ms-vscode.vscode-typescript-next"
      ]
    }
  },
  "postCreateCommand": "bash .devcontainer/init-firewall.sh"
}

主な特徴: - 多層セキュリティアプローチ - ファイアウォール設定の自動化 - VS Code統合 - チーム開発対応

2. コミュニティ実装（選択肢）

ClaudeBox by RchGrav

# 完全な開発環境を提供
docker pull ghcr.io/RchGrav/claudebox:latest
docker run -it -v $(pwd):/workspace ghcr.io/RchGrav/claudebox:latest

Zeeno-atl版（軽量）

# 最新Claude Code CLIを自動インストール
docker pull ghcr.io/Zeeno-atl/claude-code:latest
docker run -it -v $(pwd):/app ghcr.io/Zeeno-atl/claude-code:latest

その他のコミュニティ実装

コミュニティによる他の実装も存在しますが、メンテナンス状況や公開状況を事前に確認することを推奨します。

🔒 セキュリティ機能と隔離

ネットワーク制限

Docker化により、Claude Codeのネットワークアクセスを制限できます：

# ファイアウォール設定例
FROM ubuntu:22.04

# 必要なパッケージのインストール
RUN apt-get update && apt-get install -y \
    iptables \
    curl \
    npm \
    git

# ファイアウォールルールの設定
COPY init-firewall.sh /usr/local/bin/
RUN chmod +x /usr/local/bin/init-firewall.sh

# 許可するドメインのみアクセス可能
# - npm registry
# - GitHub
# - Anthropic API
# その他は全てブロック

権限の隔離

# 権限確認をスキップしたモード（注意して使用）
docker run --rm -it \
  -v $(pwd):/workspace:ro \
  --network restricted \
  claude-code:latest \
  claude --dangerously-skip-permissions "プロジェクトを分析して"

⚠️ 重要な注意点: --dangerously-skip-permissionsフラグは権限確認をバイパスしますが、コンテナ内でもマウントされたプロジェクトファイルは変更可能です。安全な運用のため： - 重要なファイルは読み取り専用（:ro）でマウント - APIキーは最小権限で発行 - CI用サービスアカウントを分離

💡 実践的な使用方法

1. 基本的なプロジェクト作業

# プロジェクトディレクトリをマウントして実行
docker run -it --rm \
  -v $(pwd):/workspace \
  -w /workspace \
  ghcr.io/Zeeno-atl/claude-code:latest \
  claude "Reactアプリの基本構造を作成"

2. CI/CDパイプライン統合

# GitHub Actions例
name: Claude Code Review
on: [pull_request]

jobs:
  code-review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3

      - name: Run Claude Code Analysis
        run: |
          docker run --rm \
            -v ${{ github.workspace }}:/workspace \
            -e ANTHROPIC_API_KEY=${{ secrets.ANTHROPIC_API_KEY }} \
            ghcr.io/Zeeno-atl/claude-code:latest \
            claude -p "コードレビューを実行し、改善点を報告"

3. チーム開発での環境統一

# docker-compose.yml
version: '3.8'
services:
  claude-dev:
    image: ghcr.io/RchGrav/claudebox:latest
    volumes:
      - .:/workspace
      - claude-config:/home/claude/.config
    environment:
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
    networks:
      - claude-network

volumes:
  claude-config:

networks:
  claude-network:
    driver: bridge

4. Windows環境での重要な注意点

⚠️ 重要: Claude CodeはWindows 11でネイティブ実行できません。WSL2が必須です。

Windows 11 + WSL2 + Docker Desktop構成

# 1. WSL2内でClaude Codeを実行（推奨）
wsl -d Ubuntu-22.04
cd /mnt/c/your-project
claude "TypeScriptプロジェクトをセットアップ"

# 2. Docker Desktop経由（制限あり）
docker run -it --rm `
  -v ${PWD}:/workspace `
  -w /workspace `
  ghcr.io/anthropics/devcontainer-features/claude-code:latest `
  claude "プロジェクト分析"

Windows環境の要件（2025年版）

  • Windows 11 バージョン 21H2以降（22H2, 23H2推奨）
  • WSL2 必須（Hyper-V単体では不十分）
  • CPU要件: SLAT対応（Intel第1世代Core以降、AMD Opteron以降）
  • Docker Desktop WSL2統合有効化

既知の問題と対策

# MCP Gateway問題の回避
# WSL2でDocker Desktop統合時のネットワーク問題
docker run --network host --rm -it claude-code:latest

# クロスファイルシステム性能問題の回避
# Windows側ではなくWSL2内でプロジェクト作成推奨
mkdir ~/projects/my-app  # WSL2内
cd ~/projects/my-app

🚀 DevOps統合の利点

1. 自動化されたコード品質チェック

# pre-commitフックとの統合
docker run --rm \
  -v $(pwd):/workspace \
  claude-code:latest \
  claude "lintエラーを自動修正"

2. マルチプロジェクト管理

# プロジェクトごとの隔離された環境
docker run --name project-a \
  -v ./project-a:/workspace \
  claude-code:latest

docker run --name project-b \
  -v ./project-b:/workspace \
  claude-code:latest

3. MCP統合による外部サービス連携

# MCPサーバー統合例
services:
  claude-code:
    image: claude-code:latest
    environment:
      - MCP_SERVERS=github,slack,gdrive
    volumes:
      - ./mcp-config:/mcp

⚙️ 最適化とパフォーマンス

リソース制限の設定

# CPU・メモリ制限付きで実行
docker run --rm -it \
  --cpus="2.0" \
  --memory="4g" \
  -v $(pwd):/workspace \
  claude-code:latest

イメージの最適化

# 軽量イメージの作成
FROM node:18-alpine

# 必要最小限のパッケージのみインストール
RUN npm install -g @anthropic-ai/claude-code

# 非rootユーザーで実行
USER node
WORKDIR /workspace

🛠️ トラブルシューティング

一般的な問題と解決策

1. 権限エラー

# 権限問題の解決
docker run --rm -it \
  --user $(id -u):$(id -g) \
  -v $(pwd):/workspace \
  claude-code:latest

2. ネットワーク接続問題

# DNS設定の確認
docker run --rm -it \
  --dns 8.8.8.8 \
  claude-code:latest \
  nslookup api.anthropic.com

3. API認証エラー

# 環境変数の確認
docker run --rm -it \
  -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY \
  claude-code:latest \
  claude --version

4. Windows固有の問題（2025年版）

WSL2 Docker統合問題
# Docker Desktop WSL2統合確認
wsl --list --verbose
# STATUS should be "Running" for your Linux distribution

# Docker in WSL2 확인
wsl -d Ubuntu-22.04
docker --version
MCP Gateway接続エラー
# ネットワークホストモードで回避
docker run --network host --rm -it \
  -v .:/workspace \
  claude-code:latest
パフォーマンス問題
# WSL2内でプロジェクト作成（高速化）
# Windows側: C:\Users\username\project (遅い)
# WSL2側: ~/projects/my-app (高速)
mkdir ~/projects/my-app
cd ~/projects/my-app
claude "プロジェクト初期化"

📊 実装方式の比較

実装方式セキュリティ維持管理Windows対応特徴
公式DevContainer⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐WSL2必須公式サポート、多層セキュリティ
deepworks-net⭐⭐⭐⭐⭐⭐⭐⭐ネイティブWindows特化、WSL不要
claude-code-yolo⭐⭐⭐⭐⭐⭐⭐⭐WSL2推奨安全な自動実行特化
WSL2ネイティブ⭐⭐⭐⭐⭐WSL2必須最高速度、直接アクセス
Windowsネイティブ❌❌非対応2025年現在実行不可

注意: パフォーマンス数値は環境により大きく異なります。実際の数値はご自身の環境で計測することを推奨します。

🎯 推奨セットアップ

Windows個人開発者向け（2025年推奨）

# Windows環境での最適解
docker run -it --rm \
  -v .:/home/coder/project \
  -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY \
  deepworks/claude-code:latest

Linux/Mac個人開発者向け

# WSL2またはLinux/Mac環境
docker run -it --rm \
  -v $(pwd):/workspace \
  -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY \
  ghcr.io/thevibeworks/claude-code-yolo:latest

チーム開発向け（公式DevContainer）

// .devcontainer/devcontainer.json
{
  "name": "Team Claude Code",
  "image": "mcr.microsoft.com/devcontainers/base:ubuntu",
  "features": {
    "ghcr.io/anthropics/devcontainer-features/claude-code:1": {}
  },
  "postCreateCommand": "bash .devcontainer/init-firewall.sh"
}

エンタープライズ向け（最高セキュリティ）

# 読み取り専用・ネットワーク制限付き
docker run --rm -it \
  --security-opt no-new-privileges \
  --read-only \
  --tmpfs /tmp \
  --network restricted \
  -v $(pwd):/workspace:ro \
  ghcr.io/anthropics/devcontainer-features/claude-code:1

🔗 関連記事