OpenAI の Codex は AGENTS.md を読んでプロジェクトの仕組みを学びます。短い「デプロイ」セクションを追加すると、コマンド 1 つでサイトを公開し、アドレスとサイトを残すリンクを渡してくれます。最初に解決すべきはサンドボックスです。デプロイにはネットワークが必要です。
仕組み
- 下のセクションを AGENTS.md に追加すると、Codex はコマンドと実行後に伝える内容を把握します。
- コマンドにネットワークアクセスを許可します。 Codex はサンドボックスでコマンドを実行し、デプロイは lobsite.com と通信する必要があります(ネットワークアクセス参照)。
- Codex にデプロイを依頼します。 ビルドして
npx -y lobsite --yesを実行し、URL と取得リンクを伝えます。リンクを開いてログインしない限り、サイトは 6 時間で削除されます。
AGENTS.md のセクション
次をプロジェクトの AGENTS.md に貼り付けてください。このファイルを読む他のエージェント(Cursor、Gemini CLI、Copilot など)も使います。
## Deploying
This site deploys with [Lobsite](https://lobsite.com). Build it, then from the project folder run:
```bash
npx -y lobsite --yes
```
- Tell the user the URL, and relay the "Tell the user:" line from the output word for word.
- Sites deployed without logging in are removed after 6 hours. The claim link in the output keeps the site; the user opens it and signs in.
- `lobsite.toml` remembers the site, so the same command updates it. Use `--preview` to deploy without changing the live site, and `--json` for machine-readable output.
- If a deploy fails, follow the fix in the error message. Never pass `--include-secrets`.
CLI は CODEX_SANDBOX 変数から Codex 配下であることを認識し、質問せずにプレーンな行を出力します。
ネットワークアクセス
Codex のサンドボックスはコマンドのネットワークアクセスをブロックすることがあり、その場合デプロイは Lobsite のエラーではなく接続エラーで失敗します。Codex CLI では、~/.codex/config.toml でワークスペース内のコマンドにネットワークを許可してください。
[sandbox_workspace_write]
network_access = true
または、Codex がサンドボックスの外でコマンドを実行するよう求めたときに承認してください。Codex クラウドタスクでは、エージェントのインターネットアクセスは環境の設定です。lobsite.com と upload.lobsite.app(npx のために npm レジストリも)を許可してください。
MCP サーバー、または curl
Codex CLI は Lobsite の MCP サーバーも起動でき、deploy、list_sites、list_deploys、rollback、promote、whoami をツールとして使えます。~/.codex/config.toml に追加してください。
[mcp_servers.lobsite]
command = "npx"
args = ["-y", "lobsite@latest", "mcp"]
Node がインストールされていない場合、1 ページ(または少数のファイル)は curl でデプロイでき、URL と取得リンクが返ります。
curl --data-binary @index.html https://lobsite.com/api/v1/drop
エージェント実行時は確認を求めず、URL と取得リンクを含む Tell the user: 行を出力します。
Node がない場合は、curl --data-binary @index.html lobsite.com/api/v1/drop で URL が返ります。
コーディングエージェントには npx lobsite mcp、チャットアシスタントには lobsite.com/api/mcp。
ファイルはハッシュで保存されます。変更のないサイトを再デプロイしてもアップロードは 0 バイトです。
公開前にプレビューできます。リダイレクトも含めてワンクリックでロールバックできます。
すべての制限は公開されており、すべてのエラーが次にすべきことを教えてくれます。
コマンド、MCP サーバー、curl
npx -y lobsite --yes |
MCP サーバー | curl | |
|---|---|---|---|
| 必要なもの | Node とネットワーク | Node とネットワーク | ネットワークのみ |
| アップロードするもの | ビルド済みフォルダ、変更されたファイルのみ | ビルド済みフォルダ、変更されたファイルのみ | 指定したファイル、25 MB まで |
| 同じサイトの更新 | はい、lobsite.toml が記憶 |
はい | はい、?site= と取得トークンで |
| ロールバック、デプロイの一覧 | 追加のコマンドで | ツールとして | いいえ |
| セットアップ | AGENTS.md のセクション | config.toml のエントリ |
なし |
まずコマンドから始め、Codex にデプロイを管理させたい場合は MCP サーバーを追加し、Node のないサンドボックスには curl を使ってください。
よくある質問
デプロイがネットワークエラーで失敗するのはなぜですか?
サンドボックスがコマンドの lobsite.com へのアクセスを止めました。ワークスペースのネットワークアクセスをオンにするか、サンドボックスの外でコマンドを承認するか、Codex クラウド環境でドメインを許可してください。
Codex に私の Lobsite アカウントは必要ですか?
いいえ。アカウントがなくてもサイトは 6 時間有効で、Codex が取得リンクを渡します。アカウントにデプロイするには、一度ご自身で npx lobsite login を実行してください。ログインはブラウザで行います。
Codex は先にプレビューをデプロイできますか?
はい。npx -y lobsite --yes --preview はデプロイに専用の URL を付け、公開中のサイトはそのままです。npx lobsite promote <id> で公開します。
プロジェクトに .env ファイルがある場合はどうなりますか?
シークレットファイルはアップロードされません。除外方法(.lobsiteignore)を示すエラーでデプロイが停止します。Codex は --include-secrets を決して渡してはいけません。
IDE の Codex でも動作しますか?
はい。拡張機能は同じエージェントを実行するため、同じ AGENTS.md を読み、コマンドも同じように動作します。