← Back to essays

Codex app ile remote SSH kullanmak

Codex app ile remote SSH kullanmak

bir süre boyunca "Codex app'i SSH ile remote makineye bağlayabiliyor muyuz?" sorusunun pratik cevabı "henüz değil" gibiydi. bu durum 16 Nisan 2026 tarihinde değişti: OpenAI, remote devbox'lara SSH üzerinden alpha desteğini duyurdu ve dokümantasyonda artık düzgün bir kurulum sayfası var.

şu anki temiz yol şu:

  1. ~/.ssh/config içine gerçek bir host alias'ı ekle
  2. Codex'i çalıştırdığın makineden ssh host-aliasin komutunun gerçekten çalıştığını doğrula
  3. remote host üzerinde codex kurup girişini yap
  4. uygulamada Settings > Connections bölümünü açıp remote proje klasörünü seç

dokümandaki önemli ayrıntı şu: uygulama remote tarafı kullanıcının login shell'i üzerinden ayağa kaldırıyor. yani codex o shell içinde PATH üzerinde değilse ya da shell init tarafında garip bir şey varsa, normal SSH çalışsa bile bağlantı yine düşebiliyor.

Connections bölümü hala yoksa

burada issue thread'i hala değerli. resmi doküman, SSH remote connections özelliğinin alpha aşamasında olduğunu ve kademeli rollout edildiğini söylüyor. stable build'lerde farklı durumlar görülmesinin sebebi büyük ihtimalle bu.

son yorumlarda öne çıkan iki workaround var:

  • ~/.codex/config.toml içine şunu ekleyip uygulamayı yeniden başlat:
toml[features]
remote_connections = true
  • bu da yetmezse beta appcast build'ini bir kez kullan. paylaşılan feed https://persistent.oaistatic.com/codex-app-beta/appcast.xml. 16 Nisan 2026 itibarıyla burada gelen sürüm 26.415.20818 idi. birkaç kişi SSH connection'ı beta içinde ekleyip sonra stable ile devam edebildiğini yazmış.

gerçek görünen iki pürüz

birincisi: remote makinedeki codex CLI güncel olsun. son yorumlardan biri özellikle remote tarafta 0.121.0 sürümünün bağlantıyı toparlayabilmek için önemli olduğunu söylüyor.

ikincisi: shell init dosyalarına bak. bir kullanıcı ECONNRESET ve websocket 1006 hatalarının sebebini ~/.bashrc içindeki koşulsuz exec zsh -l satırına kadar indirmiş. Codex remote tarafı login interactive shell ile başlattığı için bu ekstra devir bootstrap akışını bozabiliyor. BASH_EXECUTION_STRING kontrolü eklenince sorun çözülmüş:

bashif [ -x "$(command -v zsh)" ] && [ -z "${BASH_EXECUTION_STRING:-}" ]; then
  exec zsh -l
fi

şu anki tablo bu

yani evet, Codex app içinde remote SSH artık gerçekten var. resmi yol artık mevcut ama issue yorumlarını yine de okumaya değer, çünkü canlı alpha rollout'un dağınık tarafını gösteriyor: gizli flag'ler, beta build'ler ve shell-init köşe vakaları.

bir de ağ tarafında dokümana sadık kal. SSH port forwarding ya da VPN / Tailscale kullan; remote app server'ı doğrudan internete açma.