OpenCode サンドボックス

このガイドでは、サンドボックス環境での OpenCode の認証、設定、および使用方法について説明します。

公式ドキュメント（英語）: OpenCode CLI 

クイックスタート

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

$ docker sandbox run opencode ~/my-project

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

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

OpenCode は TUI（テキストユーザーインターフェース）を起動します。そこで好みの LLM プロバイダーを選択し、エージェントと対話することができます。

認証

OpenCode は、サポートされているすべてのプロバイダーに対してプロキシ管理の認証を使用します。Docker Sandboxes が API リクエストをインターセプトし、認証情報を透過的に注入（インジェクション）します。ユーザーはホスト側の環境変数を通じて API キーを提供し、サンドボックス側でその認証情報を管理する仕組みです。

サポートされているプロバイダー

環境変数を設定することで、1つ以上のプロバイダーを構成できます：

export OPENAI_API_KEY=sk-xxxxx
export ANTHROPIC_API_KEY=sk-ant-xxxxx
export GOOGLE_API_KEY=AIzaSyxxxxx
export XAI_API_KEY=xai-xxxxx
export GROQ_API_KEY=gsk_xxxxx
export AWS_ACCESS_KEY_ID=AKIA_xxxxx
export AWS_SECRET_ACCESS_KEY=xxxxx
export AWS_REGION=us-west-2

使用したいプロバイダーのみを設定すれば問題ありません。OpenCode は利用可能な認証情報を検出し、TUI 上でそれらのプロバイダーを選択肢として提示します。

環境変数のセットアップ

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

変更を適用する：

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

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

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

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

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

設定

OpenCode は TUI インターフェースを使用するため、大規模な設定ファイルは必要ありません。起動時にプロバイダーを選択するよう求められ、セッション中にプロバイダーを切り替えることも可能です。

TUI モード

OpenCode はデフォルトで TUI モードで起動します。インターフェースには以下の情報が表示されます：

• LLM プロバイダー（設定済みの認証情報に基づく）

• 現在の会話履歴

• ファイル操作とツールの使用状況

• エージェントからのリアルタイムなレスポンス

キーボードショートカットを使用してインターフェースを操作し、エージェントと対話してください。

ベースイメージ

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

OpenCode は、サンドボックスプロキシを通じた自動的な認証情報注入により、複数の LLM プロバイダーをサポートしています。

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