トラブルシューティング

このガイドでは、AIコーディングエージェントでDocker Sandboxesを使用する際に発生する一般的な問題の解決方法を説明します。

‘sandbox’ is not a docker command

docker sandbox を実行した際に、コマンドが存在しないというエラーが表示される場合。

これは CLI プラグインがインストールされていないか、正しい場所に配置されていないことを意味します。修正するには：

プラグインが存在するか確認します：
```
$ ls -la ~/.docker/cli-plugins/docker-sandbox
```
ファイルが存在し、実行権限がある必要があります。
Docker Desktopを使用している場合は、再起動してプラグインを検出させます。

サンドボックスを使用しようとした際に、ベータ機能が無効化されているというエラーが表示される場合。

これは、Docker Desktopの設定が管理者によってロックされている場合に発生します。組織で設定管理（Settings Management）を使用している場合は、管理者にベータ機能の許可を依頼してください：


{
  "configurationFileVersion": 2,
  "allowBetaFeatures": {
    "locked": false,
    "value": true
  }
}

Claudeが認証できない、またはAPIキーのエラーが表示される場合。

APIキーが無効であるか、期限切れ、あるいは正しく設定されていない可能性があります。

サンドボックスの起動時に、認証情報の競合に関する警告が表示される場合。

これは、ワークスペース内に primaryApiKey フィールドを含む .claude.json ファイルが存在する場合に発生します。以下のいずれかの方法を選択してください：

.claude.json から primaryApiKey フィールドを削除する：


{
"apiKeyHelper": "/path/to/script",
"env": {
    "ANTHROPIC_BASE_URL": "[https://api.anthropic.com](https://api.anthropic.com)"
}
}

ファイルアクセス時に Claude やコマンドが “Permission denied” エラーで失敗する場合。

通常、これはワークスペースのパスが Docker からアクセスできないか、ファイル権限が厳しすぎることを意味します。

Docker Desktopを使用している場合：

Docker Desktopの Settings → Resources → File Sharing でファイル共有設定を確認します。
ワークスペースのパス（またはその親ディレクトリ）が「Virtual file shares」の一覧に含まれていることを確認してください。
含まれていない場合は、「+」をクリックしてワークスペースを含むディレクトリを追加します。
Docker Desktopを再起動します。

すべてのプラットフォーム共通の確認事項として、ファイル権限を確認してください：


$ ls -la <workspace>

ファイルが読み取り可能であることを確認します。必要に応じて以下を実行してください：


$ chmod -R u+r <workspace>

また、ワークスペースのパスが実際に存在することも確認してください：


$cd <workspace>$ pwd

Windowsでは、多数のサンドボックスを同時に起動するとクラッシュが発生することがあります。

これが発生した場合は、OpenVMM プロセスを終了させることで回復できます：

この問題を回避するには、複数のサンドボックスを同時に作成するのではなく、一つずつ順番に起動するようにしてください。

サンドボックスが予期しない動作をしたり、起動に失敗したりし続ける場合は、すべてのサンドボックスの状態をリセットしてください：


$ docker sandbox reset

これにより、実行中のすべての VM が停止し、すべてのサンドボックスデータが削除されます。デーモン自体は実行を継続します。リセット後、必要に応じて新しいサンドボックスを作成してください。

トラブルが解決しない場合や、すべてのサンドボックスを一括削除してディスク容量を確保したい場合にこのコマンドを使用してください。