OpenAI CLI: Resmi Komut Satırı Aracı Kurulum ve Kullanım Rehberi
Kaynak: Hacker News
İçindekiler 5 başlık
OpenAI CLI, OpenAI REST API ile doğrudan terminal üzerinden etkileşim kurmayı sağlayan resmi komut satırı aracıdır. Yazılım geliştirme süreçlerinde API uç noktalarını hızlıca test etmek ve iş akışlarını otomatikleştirmek için pratik bir temel sunar.
Kurulum#
Geliştirme ortamınıza bağlı olarak aracı iki farklı yöntemle kurabilirsiniz:
Homebrew ile Kurulum#
macOS veya Linux ortamlarında paket yöneticisi üzerinden hızlı kurulum yapmak için aşağıdaki komutu kullanabilirsiniz:
brew install openai/tools/openai
Go ile Kurulum#
Aracı yerel olarak test etmek veya kaynak koddan derleyerek kurmak için sisteminizde Go 1.26 veya daha yeni bir sürümün kurulu olması gerekir:
go install 'github.com/openai/openai-cli/cmd/openai@latest'
go install komutunu çalıştırdıktan sonra derlenen ikili dosya (binary) Go bin dizinine yerleştirilir:
- Varsayılan konum:
$HOME/go/bin(veyaGOPATHayarlanmışsa$GOPATH/bin) - Yolu kontrol etme: Ana dizini görmek için
go env GOPATHkomutunu çalıştırın
Kurulum sonrasında komutlar terminalde bulunamazsa, Go bin dizinini kabuk profilinize (.zshrc, .bashrc vb.) eklemeniz gerekir:
export PATH="$PATH:$(go env GOPATH)/bin"
İlk uygun etkileşimli openai çalıştırması, gelecekteki Bash, zsh ve fish oturumları için görsel seçici (image picker) Tab kısayollarını sessizce kaydeder; bunları kullanmak için yeni bir terminal açmanız yeterlidir. Gerekli şartlar ve devre dışı bırakma seçenekleri için kısayol kurulum/kaldırma belgelerine bakılabilir. PowerShell ise standart Tab tamamlama davranışını korur; görsel seçiciyi açmak için openai images generate komutundan sonra Enter tuşuna basabilirsiniz.
Güncelleme Bildirimleri#
Argümansız çalıştırılan openai komutu; stdin, stdout ve stderr birer terminale bağlı olduğunda daha yeni kararlı sürümleri kontrol eder ve en fazla yedi günde bir kez yardım metninin altına düz metin olarak bildirim ekler. Açık yardım çağrıları, alt komutlar, otomatik tamamlama, CI ortamları ve yönlendirilmiş akışlar (redirected streams) bu kontrolü tamamen atlar. Bu tasarım, üretim ve otomasyon betiklerinin beklenmedik çıktılarla bozulmasını önleyen önemli bir mühendislik pratiğidir.
Bildirim mekanizması kurulum yöntemini doğrulayabildiğinde ilgili güncelleme komutunu da içerir:
- Doğrulanmış Homebrew kurulumları
brew upgrade --cask openai/tools/openaikomutunu kullanır. - Go kurulumları doğrulanmış bir ikili dosya, erişilebilir bir Go komutu ve eşleşen açık bir
GOBINgerektirir. ÖzelGOOSveyaGOARCHayarları ve Go sürüm 2 veya üzeri ana sürüm yükseltmeleri doğrudan kurulum rehberine yönlendirir. - Bilinmeyen kurulumlar ise doğrudan kurulum rehberi bağlantısını alır.
CLI güncellemeleri hiçbir zaman otomatik olarak yüklemez. Kontroller API kimlik bilgisi gerektirmeden herkese açık GitHub sürüm meta verilerini kullanır ve günde en fazla bir kez yapılır. Küçük harfli biçimleri dahil olmak üzere HTTPS_PROXY ve NO_PROXY ortam değişkenlerine uyum sağlar. Güncelleme keşfi en fazla 200 milisaniye bekler ve başarısız kontroller sessiz kalır. Paket yöneticilerindeki erişilebilirlik yeni bir GitHub sürümünün gerisinde kalabilir. Kontrolleri ve bildirimleri tamamen kapatmak için OPENAI_CLI_NO_UPDATE_CHECK=1 ortam değişkenini ayarlayabilirsiniz.
Yerel Olarak Çalıştırma#
Projeye katkıda bulunmak veya kaynak kodu incelemek için git deposunu klonladıktan sonra, aracı yerel olarak çalıştırmak üzere proje içindeki scripts/run betiğini kullanabilirsiniz.
Kaynak ve atıf
Bu yazı, Hacker News üzerinde yayımlanan içerikten yararlanılarak Edumints tarafından yapay zekâ desteğiyle Türkçe hazırlandı. Ayrıntılar ve yazarların kendi anlatımı için orijinaline bakabilirsin:
- github.com/openai/openai-cli