OpenAI'ın Codex'i, bir projenin nasıl çalıştığını öğrenmek için AGENTS.md dosyasını okur. Ona kısa bir "Deploying" bölümü verin; siteyi tek komutla yayına alabilir, sonra size adresi ve siteyi korumanızı sağlayan bir bağlantıyı verir. Önce çözülmesi gereken tek şey sanal alandır (sandbox), çünkü deploy ağa ihtiyaç duyar.
Nasıl çalışır
- Aşağıdaki bölümü AGENTS.md dosyasına ekleyin, böylece Codex komutu ve sonrasında size ne söyleyeceğini bilir.
- Komutun ağa erişmesine izin verin. Codex komutları bir sanal alanda çalıştırır ve deploy'un lobsite.com ile konuşması gerekir (bkz. Ağ erişimi).
- Codex'ten deploy etmesini isteyin. Derler,
npx -y lobsite --yesçalıştırır ve URL'yi ve sahiplenme bağlantısını iletir. Bağlantıyı açıp giriş yapmazsanız site 6 saat yaşar.
AGENTS.md bölümü
Bunu projenin AGENTS.md dosyasına yapıştırın. Dosyayı okuyan diğer ajanlar (Cursor, Gemini CLI, Copilot ve diğerleri) da onu kullanır:
## 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 altında çalıştığını CODEX_SANDBOX değişkeninden anlar: soru sormaz ve düz satırlar yazdırır.
Ağ erişimi
Codex'in sanal alanı komutların ağ erişimini engelleyebilir; o zaman deploy, bir Lobsite hatası yerine bir bağlantı hatasıyla başarısız olur. Codex CLI için çalışma alanındaki komutlara ~/.codex/config.toml içinde ağ izni verin:
[sandbox_workspace_write]
network_access = true
Ya da Codex komutu sanal alanın dışında çalıştırmak için izin istediğinde onaylayın. Codex bulut görevlerinde ajanın internet erişimi ortamın bir ayarıdır; lobsite.com ve upload.lobsite.app adreslerine (ve npx için npm kayıt defterine) izin verin.
MCP sunucusu ya da curl
Codex CLI, Lobsite'ın MCP sunucusunu da başlatabilir; bu ona deploy, list_sites, list_deploys, rollback, promote ve whoami araçlarını verir. Onu ~/.codex/config.toml dosyasına ekleyin:
[mcp_servers.lobsite]
command = "npx"
args = ["-y", "lobsite@latest", "mcp"]
Node kurulu olmayan yerlerde tek bir sayfa (veya birkaç dosya) curl ile deploy edilir; curl URL'yi ve sahiplenme bağlantısını döndürür:
curl --data-binary @index.html https://lobsite.com/api/v1/drop
Bir ajan altında soru sorulmaz; URL ve sahiplenme bağlantısını içeren bir Tell the user: satırı verilir.
Node yok mu? curl --data-binary @index.html lobsite.com/api/v1/drop URL ile yanıt verir.
Kodlama ajanları için npx lobsite mcp, sohbet asistanları için lobsite.com/api/mcp.
Dosyalar hash'lerine göre saklanır. Değişmemiş bir siteyi yeniden deploy etmek 0 bayt yükler.
Yayına almadan önce önizleyin. Yönlendirmeler dahil tek tıkla geri alın.
Her sınır yayımlanmıştır ve her hata sonra ne yapmanız gerektiğini söyler.
Komut, MCP sunucusu ya da curl
npx -y lobsite --yes |
MCP sunucusu | curl | |
|---|---|---|---|
| Gerektirir | Node ve ağ | Node ve ağ | Yalnızca ağ |
| Ne yükler | Derlenmiş klasörü, yalnızca değişen dosyaları | Derlenmiş klasörü, yalnızca değişen dosyaları | Belirttiğiniz dosyaları, 25 MB'a kadar |
| Aynı siteyi günceller | Evet, lobsite.toml onu hatırlar |
Evet | Evet, ?site= ve sahiplenme token'ı ile |
| Geri alma, deploy'ları listeleme | Başka komutlarla | Araç olarak | Hayır |
| Kurulum | AGENTS.md bölümü | config.toml girişi |
Yok |
Komutla başlayın; Codex'in deploy'ları yönetmesini istiyorsanız MCP sunucusunu ekleyin, curl'ü de Node olmayan sanal alanlar için saklayın.
Sık sorulan sorular
Deploy neden bir ağ hatasıyla başarısız oluyor?
Sanal alan, komutun lobsite.com'a ulaşmasını engelledi. Çalışma alanı için ağ erişimini açın, komutu sanal alanın dışında onaylayın ya da Codex bulut ortamınızda alan adlarına izin verin.
Codex'in Lobsite hesabıma ihtiyacı var mı?
Hayır. Hesap olmadan site 6 saat yaşar ve Codex size sahiplenme bağlantısını verir. Hesabınıza deploy etmek için npx lobsite login komutunu bir kez kendiniz çalıştırın; giriş bir tarayıcıda yapılır.
Codex önce bir önizleme deploy edebilir mi?
Evet. npx -y lobsite --yes --preview deploy'a kendi URL'sini verir ve yayındaki siteyi olduğu gibi bırakır. npx lobsite promote <id> onu yayına alır.
Projemde bir .env dosyası varsa ne olur?
Gizli dosyalar asla yüklenmez. Deploy'u, onları nasıl dışarıda bırakacağınızı (.lobsiteignore) söyleyen bir hatayla durdururlar; Codex asla --include-secrets geçirmemelidir.
Bu, IDE'deki Codex için de çalışır mı?
Evet. Eklenti aynı ajanı çalıştırır; yani aynı AGENTS.md dosyasını okur ve komut aynı şekilde davranır.