Claude Code サンドボックス

このガイドでは、サンドボックス環境でClaude Codeを実行するための認証、設定ファイル、および一般的なオプションについて説明します。

公式ドキュメント（英語）: Claude Code 

クイックスタート

プロジェクトディレクトリに対してサンドボックスを作成し、Claude Codeを実行するには：

$ docker sandbox run claude ~/my-project

ワークスペースのパラメータは任意です。省略した場合は現在のディレクトリがデフォルトになります：

$ cd ~/my-project
$ docker sandbox run claude

プロンプトを直接渡す

特定のプロンプトを指定してClaudeを起動します：

$ docker sandbox run <sandbox-name> -- "ログイン関数にエラーハンドリングを追加して"

または：

$ docker sandbox run <sandbox-name> -- "$(cat prompt.txt)"

これにより、Claudeが起動し、即座にプロンプトの処理を開始します。

認証

Claude CodeにはAnthropicのAPIキーが必要です。環境変数を使用する方法（推奨）、または対話型ログインによる認証が可能です。

環境変数（推奨）

推奨される方法は、シェルの設定ファイルに ANTHROPIC_API_KEY 環境変数を設定することです。

Docker Sandboxesは、現在のシェルセッションから環境変数を継承しないデーモンプロセスを使用します。サンドボックスでAPIキーを利用可能にするには、シェルの設定ファイルでグローバルに設定する必要があります。

シェルの設定ファイルにAPIキーを追加します：

export ANTHROPIC_API_KEY=sk-ant-api03-xxxxx

変更を適用する：

1. シェル設定を読み込む： source ~/.bashrc （または ~/.zshrc）

2. Docker Desktopを再起動して、デーモンに新しい環境変数を認識させる

3. サンドボックスを作成して実行する：

$ docker sandbox create claude ~/project/
$ docker sandbox run <sandbox-name>

サンドボックスは環境変数を検出し、自動的に使用します。

対話型認証

資格情報が見つからない場合、Claude Codeの起動時に対話形式で認証を求められます。また、Claude Code内で /login コマンドを使用して手動でログインフローを開始することもできます。

対話型認証を使用する場合：

• ワークスペース／サンドボックスごとに個別に認証する必要があります。

• サンドボックスを削除または破棄した場合、再作成時に再度認証が必要になります。

• 認証セッションはサンドボックスの外には保持されません。

繰り返しの認証を避けるには、前述の ANTHROPIC_API_KEY 環境変数を使用する方法を推奨します。

設定

Claude CodeはCLIオプションを通じて設定できます。サンドボックス名と -- セパレーターの後に渡す引数は、すべてClaude Codeに直接渡されます。

サンドボックス名の後にオプションを記述します：

$ docker sandbox run <sandbox-name> -- [claude-options]

例：

$ docker sandbox run <sandbox-name> -- --continue

利用可能なオプションについては、Claude Code CLIリファレンス（英語） を参照してください。

ベースイメージ

テンプレート: docker/sandbox-templates:claude-code

サンドボックス内の Claude は、デフォルトで --dangerously-skip-permissions が付与された状態で起動します。

独自のイメージを構築したい場合は、カスタムテンプレートを参照してください。