Claude Code Dev Containers完全ガイド｜Docker隔離環境でAI開発を安全・再現可能にする方法

{
  "name": "Claude Code Dev Container",
  "build": {
    "dockerfile": "Dockerfile"
  },
  "runArgs": [
    "--cap-add=NET_ADMIN",
    "--cap-add=NET_RAW"
  ],
  "postStartCommand": "bash .devcontainer/init-firewall.sh",
  "customizations": {
    "vscode": {
      "extensions": [
        "anthropic.claude-code"
      ]
    }
  },
  "mounts": [
    "source=${localEnv:HOME}/.claude,target=/root/.claude,type=bind,consistency=cached",
    "source=${localEnv:HOME}/.gitconfig,target=/root/.gitconfig,type=bind,consistency=cached"
  ]
}

FROM mcr.microsoft.com/devcontainers/javascript-node:20

# 基本ツールのインストール
RUN apt-get update && apt-get install -y \
    iptables \
    ipset \
    fzf \
    zsh \
    git \
    && rm -rf /var/lib/apt/lists/*

# Claude Codeのインストール
RUN npm install -g @anthropic-ai/claude-code

# ZSHをデフォルトシェルに
SHELL ["/bin/zsh", "-c"]

#!/bin/bash
# 許可するドメイン（DNS解決後のIPをipsetに追加）
ALLOWED_DOMAINS=(
  "anthropic.com"        # Claude API
  "sentry.io"            # エラー収集
  "statsig.com"          # 機能フラグ
  "registry.npmjs.org"   # npmパッケージ
  "github.com"           # GitHub
  "raw.githubusercontent.com"
  "api.github.com"
)

# ipsetでAllowlistを作成
ipset create allowed-domains hash:ip

for domain in "${ALLOWED_DOMAINS[@]}"; do
  # DNS解決してIPをipsetに追加
  for ip in $(dig +short "$domain" A); do
    ipset add allowed-domains "$ip" 2>/dev/null || true
  done
done

# iptablesルール: Allowlist以外の外部通信を拒否
iptables -F OUTPUT
iptables -A OUTPUT -m set --match-set allowed-domains dst -j ACCEPT
iptables -A OUTPUT -d 127.0.0.0/8 -j ACCEPT  # localhost
iptables -A OUTPUT -d 10.0.0.0/8 -j ACCEPT   # 内部ネットワーク
iptables -A OUTPUT -p udp --dport 53 -j ACCEPT # DNS
iptables -A OUTPUT -p tcp --dport 22 -j ACCEPT # SSH
iptables -A OUTPUT -j REJECT  # それ以外は拒否

echo "Firewall initialized. Allowed domains: ${ALLOWED_DOMAINS[@]}"

# コンテナ内では --dangerously-skip-permissions が安全
claude --dangerously-skip-permissions -p "テストを実行して失敗しているものを修正してください"

# ヘッドレスモードとの組み合わせ（JSON出力）
claude --dangerously-skip-permissions \
  --output-format json \
  -p "コードレビューを行い、問題点をJSON形式で出力してください"

# 1. リポジトリをクローン
git clone https://github.com/your-org/your-project.git
cd your-project

# 2. VS Codeで開いて「Reopen in Container」
code .
# → VS Codeが自動でdevcontainerをビルド・起動

# 3. Claude Codeの認証（初回のみ）
claude /login

# 以上で開発開始可能

{
  "name": "Client-A Project",
  "mounts": [
    "source=${localEnv:HOME}/.claude/projects/client-a,target=/root/.claude/projects,type=bind"
  ],
  "remoteEnv": {
    "ANTHROPIC_API_KEY": "${localEnv:CLIENT_A_ANTHROPIC_KEY}"
  }
}

name: Claude Code Review

on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    container:
      image: mcr.microsoft.com/devcontainers/javascript-node:20
    steps:
      - uses: actions/checkout@v4
      - name: Install Claude Code
        run: npm install -g @anthropic-ai/claude-code
      - name: Run Claude Code review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          claude --dangerously-skip-permissions \
            --output-format json \
            -p "このPRの変更をレビューして問題点を指摘してください"