OpenAI CLI: Kurulumu ve Terminalden OpenAI API Çağrısı

OpenAI CLI, OpenAI'nin OpenAI REST API'si için resmi komut satırı aracıdır. Tek bir openai ikili dosyası kurar, OPENAI_API_KEY değerini ayarlar ve API'yi terminalinizden veya bir shell betiğinden çağırırsınız:

• openai responses create
• openai files upload
• openai batches create
• openai images generate

Bu, Codex CLI değildir. Codex bir kodlama ajanıdır; openai ise komut başına bir API isteği gönderir.

Bu kılavuz kurulumu, kimlik doğrulamayı, çalıştırmaya değer ilk komutları ve bunun Codex CLI ile Python SDK'nın PATH'inize koyduğu eski openai komutuyla nasıl karşılaştırıldığını ele alır.

Aşağıdaki her komut ve çıktı, 28 Ekim 2026'da kurulup çalıştırılan 1.44.1 sürümünden gelmektedir.

OpenAI CLI nedir?

OpenAI CLI, OpenAI tarafından github.com/openai/openai-cli adresinde Apache 2.0 lisansı altında yayımlanan açık kaynaklı bir Go ikili dosyasıdır. Komutları API'nin kaynaklarını (responses, files, batches, images, audio, vector-stores, admin) yansıtır; böylece curl veya bir SDK ile göndereceğiniz her şey, bayraklarla birlikte tek bir terminal komutuna dönüşür.

Yepyeni değil. 1.0.0 sürümü 5 Mayıs 2026'da yayımlandı ve proje o zamandan beri 99 sürüm çıkardı; 1.44.1 ise 27 Ekim 2026'da geldi. Yani bunu bir lansman olarak değil, gözden kaçırmış olabileceğiniz olgun bir araç olarak değerlendirin.

İlk çalıştırmada elde ettikleriniz şunlar:

Yardım, komutları işlerine göre gruplar: içerik üretme (responses, chat, images, audio, videos), veri ve getirme (files, uploads, vector-stores, embeddings), modeller ve işler, yönetim ve ağa hiç dokunmayan bir dizi yerel araç.

Yardımın kendisi API anahtarı ve bağlantı gerektirmez; bu da openai <command> --help komutunu bayrakları öğrenmenin en hızlı yolu yapar.

Bir betik yazmadan bir prompt'u test eden geliştiriciler, bir cron işinde dosya yüklemeleri ve batch'ler isteyen operasyon ekipleri ve elle yazılmış curl yerine belgelenmiş bir arayüze ihtiyaç duyan kodlama ajanları için uygundur.

OpenAI CLI nasıl kurulur

Proje README'sinde listelenen üç kurulum yolu vardır:

• Hazır ikili dosya. İşletim sisteminiz ve mimariniz için arşivi GitHub Releases adresinden indirin (macOS, Linux ve Windows derlemeleri yayımlanmaktadır), çıkarın ve openai dosyasını PATH'inize koyun.
• Homebrew.

brew install openai/tools/openai

• Go. Go 1.26 veya üstünü gerektirir.

go install 'github.com/openai/openai-cli/cmd/openai@latest'
export PATH="$PATH:$(go env GOPATH)/bin"

Kendi yönettiğiniz sürüm kurulumları, etkileşimli çalıştırmalar sırasında kendilerini güncelleyebilir. CI'da sürümleri sabitliyorsanız, otomatik kurulumları durdurmak için OPENAI_CLI_NO_AUTO_UPDATE=1 veya güncelleme kontrollerini tamamen kapatmak için OPENAI_CLI_NO_UPDATE_CHECK=1 ayarlayın.

Homebrew ve Go kurulumları güncelleme bildirimlerini korur ancak yükseltmeleri paket yöneticisine bırakır.

OpenAI CLI kimlik doğrulaması nasıl çalışır

CLI, OPENAI_API_KEY değerinden (veya shell geçmişine düştüğü için kaçınmanız gereken --api-key bayrağından) standart bir API anahtarı okur. Henüz bir anahtarınız yoksa, OpenAI API anahtarı alma kılavuzumuz bu süreci adım adım anlatır.

En hızlı kurulum, yerleşik kılavuzdur:

openai help setup

Sizi API anahtarları sayfasına yönlendirir ve Bash veya zsh için bir read -rs OPENAI_API_KEY satırı verir; böylece anahtar gizli şekilde yazılır ve asla ekrana yansıtılmaz.

Anahtarı unutursanız net ve betiklenebilir bir hata alırsınız. Bu, anahtar ayarlanmadan alınan gerçek çıktıdır: 1 durum koduyla çıkar ve bir anahtarın tam olarak nereden gelebileceğini söyler. Bir betiğin ham hata gövdesine ihtiyacı olduğunda --format-error json ekleyin.

Diğer kimlik doğrulama ayarları:

• API anahtarı - Bayrak: --api-key - Ortam değişkeni: OPENAI_API_KEY - Her normal API çağrısı
• Yönetici anahtarı - Bayrak: --admin-api-key - Ortam değişkeni: OPENAI_ADMIN_KEY - openai admin ... (kullanım, projeler); bir proje anahtarı bunun yerini alamaz
• Temel URL - Bayrak: --base-url - Ortam değişkeni: OPENAI_BASE_URL - CLI'ı başka bir ana bilgisayara veya bir ağ geçidine yönlendirmek
• mTLS sertifikası ve anahtarı - Bayrak: --mtls-client-cert-file, --mtls-client-key-file - Ortam değişkeni: OPENAI_MTLS_CLIENT_CERT_FILE, OPENAI_MTLS_CLIENT_KEY_FILE - Açık bir HTTPS temel URL'si gerektiren karşılıklı TLS

Çalıştırılacak ilk OpenAI CLI komutları

Komut şekli API'yi izler: openai <resource> [subresource...] <command> [flags...]. Bunlar bir araç kutusunda yerini hak eden komutlardır.

Bir Responses API çağrısı yapın:

openai responses create \
  --model gpt-5.5 \
  --input "Say this is a test"

Uzun prompt'ların kaçış karakteri kullanmasına gerek yoktur. JSON girdi bayrakları @path ile bir dosyadan okur:

openai responses create --model gpt-5.5 --input @prompt.txt

Güvenmediğiniz bir kaynaktan JSON veya YAML aktarıyorsanız, OPENAI_UNTRUSTED_STDIN=1 ayarlayın; böylece bu girdi yerel dosya okumalarını tetikleyemez.

Dosya yükleyin ve alın:

openai files upload report.txt --purpose user_data
openai files get file-example
openai files download file-example --output downloaded-report.txt

Bir batch çalıştırın:

requests.jsonl dosyasına her satıra bir istek koyun, her biri benzersiz bir custom_id içersin, ardından:

openai files upload requests.jsonl --purpose batch
openai batches create --input-file-id file-example \
  --endpoint /v1/responses --completion-window 24h
openai batches wait batch_example --output-dir ./results

batches wait batch bitene kadar yoklar ve sonuç dosyalarını kaydeder; bu da aksi halde yazacağınız yoklama döngüsünü ortadan kaldırır.

Projenin batch kılavuzu mevcut sınırları girdi dosyası başına 50.000 istek ve 200 MB, tamamlanma penceresi 24h olarak listeler. Batch fiyatlandırması senkron çağrılardan farklıdır; büyük bir işi kuyruğa almadan önce OpenAI API fiyatlandırması incelememize bakın.

Anahtar olmadan yerel olarak token sayın:

tokenizer komutu tamamen çevrimdışı çalışır: kimlik bilgisi yok, ağ yok, kaydedilen girdi yok. Varsayılan kodlama o200k_base şeklindedir ve openai tokenizer encodings diğerlerini listeler (cl100k_base ve iki eski kodlama daha).

Yardım, sınırlar konusunda dürüsttür: düz metin sayımı istek yapısını ve çok modlu girdileri hariç tutar, yani bu bir faturalandırma rakamı değildir. Sunucu tarafında bir sayım için openai responses input-tokens count kullanın.

Bir betiğin ayrıştırabileceği çıktı alın:

Varsayılan çıktı, boru hattından geçirildiğinde bile okunabilir metindir. Veriyi açıkça isteyin:

openai models list --format jsonl | jq '.id'
openai files list --format json > files.json
openai files get file-example --transform filename --raw-output

--format şunları kabul eder: auto, text, json, jsonl, yaml, explore (etkileşimli bir JSON görüntüleyici) ve pretty. --transform, alanları GJSON sözdizimi ile çeker ve jq daha karmaşık olan her şeyi halleder.

Yönlendirilmiş bir dosyaya güvenmeden önce her zaman çıkış durumunu kontrol edin: başarısız bir istek arkasında kısmi bir dosya bırakabilir.

Bir çağrı yanlış davrandığında, --debug deneme başına HTTP zamanlaması ekler; bunları paylaşmadan önce günlüklerini temizleyin. 429'lar alıyorsanız, OpenAI hız sınırları kılavuzumuz katmanları açıklar.

OpenAI CLI, Codex CLI ve eski openai komutu

Üç araç bir satıcıyı paylaşır ve ikisi bir adı paylaşır. Kısa versiyon şudur:

• OpenAI CLI - Komut: openai - Ne olduğu: REST API için bir istemci - Kurulum: İkili dosya, Homebrew veya Go - Kimlik doğrulama: OPENAI_API_KEY - Ne zaman kullanılır: Belirli bir API çağrısı veya bir betikteki API adımlarını istediğinizde
• Codex CLI - Komut: codex - Ne olduğu: Projenizdeki kodu okuyan, düzenleyen ve çalıştıran bir kodlama ajanı - Kurulum: npm install -g @openai/codex veya brew install --cask codex - Kimlik doğrulama: Kendi oturum açma işlemini yönetir - Ne zaman kullanılır: Bir ajanın bir değişikliği uygulamasını veya hata ayıklamasını istediğinizde
• Eski Python openai - Komut: openai - Ne olduğu: openai Python paketiyle birlikte gelen bir CLI - Kurulum: pip install openai - Kimlik doğrulama: API anahtarı - Ne zaman kullanılır: Üzerine inşa edilmiş eski betikleri sürdürdüğünüzde

openai codex komutunu çalıştırın; OpenAI CLI, Codex kurulum komutlarını kendisi yazdırır ve bunun kendi oturum açma işlemine sahip ayrı bir araç olduğunu belirtir. Codex CLI kılavuzumuz ajan tarafını ele alır ve kaynak kodu github.com/openai/codex adresinde bulunur.

PATH çakışmasına dikkat edin:

openai Python paketi de openai adında bir ikili dosya kurar. Eğer daha önce pip install openai çalıştırdıysanız, iki tane olabilir: Bu Mac'te Python olanı openai 2.30.0 bildirir ve api, tools, migrate ve grit alt komutlarını sunar; Go olanı ise openai version 1.44.1 bildirir. PATH'inizde hangi dizin önce gelirse o kazanır.

Kurulumdan sonra which -a openai ve openai --version komutlarını çalıştırın. Çıktı openai version 1.44.1 (veya daha yeni) diyorsa doğru olana sahipsiniz. openai 2.30.0 gibi çıplak bir sürüm numarası yazdırıyorsa, PATH'inizi yeniden sıralayın veya yeni ikili dosyayı tam yoluyla çağırın.

Apidog CLI, OpenAI CLI'nin yanında nereye oturur

OpenAI CLI, OpenAI'ye çağrılar yapar. Kendi API'niz hakkında hiçbir şey bilmez: uygulamanızın OpenAI üzerine sunduğu uç noktalar, dağıtım yaptığınız ortamlar veya bir sürümün hiçbir şeyi bozmadığını kanıtlayan doğrulamalar. Bu farklı bir iştir ve Apidog CLI'nın devreye girdiği yer burasıdır.

Birini diğerine tercih etmezsiniz; bir AI özelliği sunan çoğu ekip ikisini de ister. Daha da iyisi, kodlama ajanınızın ikisini de çalıştırmasına izin verin.

Apidog CLI'ı bir kez kurun:

npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com # pick your agent when prompted

Ardından ajanınıza tek bir prompt verin: Use the openai CLI to confirm my key works with one responses create call on gpt-5.5. Then import ./openapi.yaml into Apidog project <id>, create a test case for POST /v1/summarize that asserts a 200 and a non-empty "summary" field, run it against the staging environment and summarize any failures.

Ajan, anahtarı openai ile kontrol eder, ardından Apidog CLI üzerinden çalışır. Herhangi bir yük yazmadan önce şemayı okur, dosyayı doğrular ve ancak ondan sonra test durumunu oluşturup çalıştırır:

apidog import --project <id> --format openapi --file ./openapi.yaml
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <id> --file case.json
apidog run --test-case <caseId> --project <id> -e <envId> -r cli,json

apidog test-case create --help çıktısındaki iki ayrıntı bir gidiş-dönüşü kurtarır: test durumu geçerli bir categoryId gerektirir (bunları apidog test-case category --project <id> ile listeleyin) ve yükler asla hafızadan değil, cli-schema'dan gelmelidir. Aynı apidog run satırı -r junit ile CI'a dahil olur; bunu Apidog CLI CI/CD kılavuzumuz gösterir.

Ajanınız Codex ise, Codex'te Apidog CLI ile başlayın. Apidog'un Ücretsiz planı 4 kullanıcıya kadar kapsar, böylece küçük bir ekip bunu bir satın alma kararı vermeden deneyebilir.

SSS

OpenAI CLI ücretsiz mi?

Araç, Apache 2.0 altında ücretsiz ve açık kaynaktır. Yaptığı API çağrıları, normal API ücretleriyle OpenAI hesabınıza faturalandırılır. openai tokenizer gibi yerel komutlar ve her --help sayfası hiçbir ücrete tabi değildir ve anahtar gerektirmez.

OpenAI CLI, Codex CLI ile aynı mı?

Hayır. openai doğrudan API istekleri gönderir, komut başına bir tane. codex ise projenizi okuyup düzenleyen ve komutları çalıştıran bir kodlama ajanıdır. Ayrı ayrı kurulurlar ve ayrı ayrı kimlik doğrulama yaparlar.

OpenAI CLI'ı Mac'e nasıl kurarım?

brew install openai/tools/openai komutunu çalıştırın veya GitHub Releases'ten macos_arm64 (Apple Silicon) ya da macos_amd64 (Intel) zip dosyasını indirip ikili dosyayı PATH'inize koyun. Ardından eski Python openai komutuna çarpmadığınızı doğrulamak için openai --version komutunu çalıştırın.

OpenAI CLI, shell betiklerinde ve CI'da çalışır mı?

Evet, ana tasarım amacı budur. Ayrıştırılabilir çıktı için --format json veya jsonl kullanın, çıkış durumunu kontrol edin, anahtarı gizli yöneticinizden OPENAI_API_KEY içinde tutun ve sürümü sabit tutmak için OPENAI_CLI_NO_AUTO_UPDATE=1 ayarlayın.

OpenAI CLI ne zaman yayımlandı?

1.0.0 sürümü 5 Mayıs 2026'da GitHub'da yayımlandı. 28 Ekim 2026 itibarıyla en son sürüm, 27 Ekim tarihli 1.44.1'dir.