Claude Code サンドボックス
CC サンドボックスへの依存：あり
ワークスペースへのバインド：必須
Claude Code サンドボックス（CC サンドボックス）はワークスペースのコア実行エンジンです。
CC サンドボックスがなければ、AI はチャットすることしかできません。CC サンドボックスがあれば、AI は コード記述、スクリプト実行、ファイル処理、ブラウザ操作、外部サービス接続 が可能です。ワークスペースが AI のオフィスだとすれば、CC サンドボックスはデスクの上のパソコンです。
各ワークスペースは独立した CC サンドボックスインスタンスを持ち、隔離された Docker コンテナ内で実行されます。タスクはバックグラウンドで非同期に実行され、完了後に自動的に結果が会話にプッシュされます。
独立モデル設定
CC サンドボックスは独立した CC モデルグループ を使用し、メイン対話モデルを継承しません。メイン Agent が正常にチャットできる場合でも、CC サンドボックスは別途モデルを設定する必要があります。詳細は CCモデルグループ を参照してください。これは最もよくある問題の原因です。
サンドボックスでできること
プログラミングとコード実行
サンドボックスには完全な開発環境がプリインストールされています：
| ツール | バージョン | 用途 |
|---|---|---|
| Python | 3.13 | データ分析、スクリプト、自動化 |
| Node.js | 20 | Web 開発、ツールチェーン |
| git | — | バージョン管理 |
| gh | — | GitHub CLI、PR 作成、Issue 管理 |
| uv | — | Python パッケージ管理（pip の推奨代替） |
| npm | — | Node.js パッケージ管理 |
| curl / wget | — | HTTP リクエスト |
| jq | — | JSON 処理 |
| ssh | — | リモート接続 |
これらのツールはサンドボックス起動時にすでに準備完了しているため、ご自身でインストールする必要はありません。
ブラウザ自動化
サンドボックスには agent-browser（Playwright + Chromium ベース）が組み込まれており、Web ページの直接操作、スクリーンショット撮影、情報抽出が可能です。AI はこれを使って以下ができます：
- Web ページの閲覧とコンテンツ抽出
- Web ページのスクリーンショット撮影
- フォームの自動入力
ファイル処理
AI はサンドボックス内で直接ファイルを処理できます：
- ファイルの読み取り、作成、編集
- 会話で送信された画像やファイルをサンドボックスにアップロード
- サンドボックスで作成されたファイルは共有ディレクトリを通じて自動的に返送
- グラフ、レポート、パッチ、圧縮ファイルなど各種フォーマットの生成に対応
外部ツール連携
MCP サービス を通じて、サンドボックスは外部ツールやデータソースに接続し、機能をさらに拡張できます。
代表的な使用シーン
| シーン | 具体例 |
|---|---|
| データ分析 | 「この CSV データを分析して、トレンドグラフを生成して」 |
| コード開発 | 「FastAPI エンドポイントを書いて。ユーザー登録ロジックを処理するもの」 |
| ファイル変換 | 「これらの Markdown ファイルを HTML に変換して」 |
| 情報収集 | 「この Web ページを開いて、すべての製品価格情報を抽出して」 |
| レポート生成 | 「このデータから週次レポートを生成して」 |
| GitHub 操作 | 「このリポジトリに PR を作成して。ログインページのスタイル問題を修正するもの」 |
| プロジェクト足場 | 「React + TypeScript プロジェクトを初期化して」 |
| バッチ処理 | 「これらのファイルをリネームして日付別に分類して」 |
はじめ方
- ワークスペースを作成し、チャンネルをバインド
- CC モデルグループ を設定（「システム設定」→「モデル管理」で追加）
- ワークスペースで CC モデルグループを選択
- CC サンドボックスを起動
- チャンネルで AI にタスクを送信
タスクの実行方法
CC サンドボックスは非同期委任モードを採用しています：
- チャンネルでタスクを記述
- メイン Agent がタスクを理解し、完全なタスク説明を CC サンドボックスに委任
- CC サンドボックスがバックグラウンドで独立実行（チャットを続けることができます）
- 実行完了後、結果が自動的に会話にプッシュ
各チャンネルでは同時に1つの CC タスクのみ実行できます。現在のタスクをキャンセルする必要がある場合は、新しいタスクを開始するか、キャンセルコマンドを使用してください。
ファイル交換
メイン対話と CC サンドボックスの間では、共有ディレクトリを通じてファイルを交換します：
- サンドボックスへのアップロード：会話で送信された画像やファイルは自動的にサンドボックスに転送
- サンドボックスからの取得：CC サンドボックスで作成されたファイルは
/workspace/default/shared/ディレクトリに置かれ、システムが自動的に送信
サンドボックスのメンテナンス
再起動
以下の状況では、まず再起動を試みてください：
- サンドボックスの状態が異常
- 応答に異常が発生
- 実行がフリーズ
- MCP サービス更新後に再読み込みが必要
リビルド
再起動で問題が解決しない場合（長期的な環境異常など）は、リビルドを使用してください。リビルドではコンテナが再作成されますが、ワークスペースデータは保持されます。
セッションリセット
AI のコンテキストが古いタスクに引きずられている場合は、セッションリセットを使用してください。会話コンテキストのみがクリアされ、サンドボックス環境には影響しません。
関連ドキュメント
- ワークスペース概要
- クイックスタート
- MCP サービス管理 — サンドボックスのツール機能を拡張
- メモリシステム — CC タスクの結論が自動的に長期メモリとして蓄積