サンドボックスを通じた編集は、公開と同じではありません。編集はすぐにアプリのコードの一部となり、アプリエディタとそのライブプレビューに表示されますが、アプリの公開サイトに反映するには、アプリエディタでの変更と同じ公開ステップが必要です。
2 通りの接続方法
サンドボックスは、同じ実装に支えられた 2 つのサーフェスを通じて、同じ操作セットを公開します。ご自身のセットアップに合うほうを使用してください。- CLI: ローカルのコーディングエージェントや独自スクリプトなど、ご自身のマシンで実行するものに適しています。
base44 loginで一度認証し、--app-idまたはBASE44_APP_ID環境変数でアプリを対象にします。ローカルプロジェクトは不要です。 - MCP server: MCP で接続する AI アシスタント (CLI をまったく実行できない Web ベースのアシスタントを含む) に適しています。一度接続して OAuth で承認します。
コネクタはサンドボックスのファイルシステムを経由しないため、上の表には含まれません。この方法で作業しているアプリにコネクタをセットアップするには、代わりに
connectors initiate を使用します。これは、サンドボックスやローカルプロジェクトなしに同じアプリ ID を直接対象にします。
変更は自動保存されます
sandbox write または sandbox edit の呼び出しは、コマンドが戻る前に同じリクエスト内で変更をコミットするので、別途の保存、デプロイ、プッシュのステップはありません。sandbox run を通じて行われる rm や mv などのファイル変更は、代わりに数秒後、短いデバウンスウィンドウが閉じるとコミットされます。以前のデバウンスされたコミットが完了する前に再度書き込みまたは編集を行うと、新しい呼び出しはそれを待機し、コミットが時間内に完了したことを確認できない場合は COMMIT_FLUSH_PENDING で失敗します。コミットが完了すると:
- 変更は Base44 アプリエディタで表示されます。
- サンドボックスのコンピュート環境がアイドル後にリサイクルされても安全です。新しい環境は常に古いスナップショットではなく最新のコミットから起動するためです。
- 次回アプリを公開するときに含まれます。
entities push や functions deploy を実行するのとは異なり、サンドボックスで base44/functions/send-email/entry.ts を作成するだけで、その関数が追加されます。
チェックポイント
チェックポイントは、特定のコミットにアンカーされたアプリのバージョン履歴上の復元ポイントです。sandbox checkpoint で作成して既知の良好な状態をマークし、後で変更がうまくいかない場合はアプリエディタから復元します。チェックポイントを取得する前に保留中の変更がコミットされるため、常に最新のコードをキャプチャします。
アプリエディタと並行して作業する
コーディングエージェントと Base44 アプリエディタは、同じアプリで同時に作業できます。取得するロックはなく、解放するセッションもありません。どちらの側の変更も同じ場所に反映されるので、同じプロジェクトを編集する同僚と同じように扱ってください。パーミッション
サンドボックスへのアクセスを制御する 2 つの別々のチェックがあります: このアプリにアクセスできるかどうか、そして現在のセッションに書き込みアクセスが付与されているかどうかです。アプリアクセス
アプリ自体への管理者アクセスが必要です。ワークスペース管理者か、この特定のアプリの共同編集者のいずれかです。アクセスは呼び出しごとにチェックされるので、ワークスペースのロールを変更するとすぐに反映されます。 単なるワークスペースビューアはサンドボックスにまったくアクセスできません。唯一の例外は、ワークスペースがロールベースアクセスに移行する前からの旧アプリごとの編集者ロールも持つビューアです。その組み合わせであれば、サンドボックスから読み取ることはできますが、何も変更はできません。スーパーエージェントはサンドボックスコマンドをサポートしていません。セッションスコープ
アプリアクセスに加えて、サンドボックスの読み取りと変更にはセッション上で異なるパーミッションが必要です:
セッションのパーミッションは作成時に固定され、後から拡張できません。CLI は
base44 login 中に sandbox:write を要求し、MCP では OAuth 同意ステップで付与します。既存セッションの更新では追加されません。
そのため、読み取りコマンドは動作するが変更コマンドが NOT_AUTHORIZED で失敗する場合、sandbox:write が付与されていないセッションを使用しています。それを持つセッションを開始するには、base44 login を再度実行するか、MCP サーバーを再接続してサンドボックスアクセスを承認してください。
制限とガードレール
ファイルコマンドはアプリのルートに限定されます。絶対パスとルートを超えて上に登るパスはPATH_OUTSIDE_SANDBOX で拒否されます。.agents と .git ディレクトリはファイルコマンドから到達できず、PROTECTED_PATH で失敗します。これらはアプリのシークレットとリポジトリ資格情報を保持しているためです。唯一の例外は .agents/skills で、エージェントがアプリにインストールされた skills と連携できるように読み書きできます。
機能全体で、アプリごとに 1 分あたり 120 の読み取りリクエスト、60 の変更リクエスト、30 の run コマンドに制限されます。いずれかを超えると RATE_LIMITED で失敗します。各コマンドの参照ページでは、sandbox read が受け入れるパス数や sandbox write が許可するファイルサイズなど、独自のサイズとカウント制限が説明されています。
関連情報
- Base44 MCP server: AI アシスタントを Base44 アカウントに接続する
- CLI Overview: Base44 CLI のインストールと使用
- Project structure: Base44 プロジェクトファイルの構成
- Local development: 代わりに Base44 プロジェクトを自分のマシンで実行
- Skills: AI コーディングエージェントに Base44 との連携方法を教える
connectors initiate: サンドボックスやローカルプロジェクトなしでアプリにコネクタをセットアップ
このページは AI によって翻訳されました。最も正確で最新の情報については、英語版 を参照してください。