OpenAI CLI: Instal dan Panggil OpenAI API dari Terminal Anda

OpenAI CLI adalah alat command-line resmi OpenAI untuk OpenAI REST API. Anda menginstal satu biner openai, mengatur OPENAI_API_KEY, dan memanggil API dari terminal atau skrip shell Anda: openai responses create, openai files upload, openai batches create, openai images generate. Ini bukan Codex CLI. Codex adalah agen coding; openai mengirim satu permintaan API per perintah.

Panduan ini mencakup instalasi, autentikasi, perintah pertama yang layak dijalankan, dan bagaimana ia dibandingkan dengan Codex CLI serta perintah openai lama yang ditempatkan Python SDK di PATH Anda. Setiap perintah dan keluaran di bawah ini berasal dari versi 1.44.1, yang diinstal dan dijalankan pada 28 Oktober 2026.

Apa itu OpenAI CLI?

OpenAI CLI adalah biner Go sumber terbuka, yang diterbitkan oleh OpenAI di github.com/openai/openai-cli di bawah lisensi Apache 2.0. Perintah-perintahnya mencerminkan sumber daya API (responses, files, batches, images, audio, vector-stores, admin), sehingga apa pun yang akan Anda kirim dengan curl atau SDK menjadi satu perintah terminal dengan flag.

Ini bukan barang baru. Versi 1.0.0 dirilis pada 5 Mei 2026, dan proyek ini telah merilis 99 rilis sejak itu; 1.44.1 hadir pada 27 Oktober 2026. Jadi anggap saja ini sebagai alat yang matang yang mungkin Anda lewatkan, bukan peluncuran baru.

Berikut yang Anda dapatkan pada penggunaan pertama:

Bantuan mengelompokkan perintah berdasarkan tugas: menghasilkan konten (responses, chat, images, audio, videos), data dan pengambilan (files, uploads, vector-stores, embeddings), model dan tugas, administrasi, serta sekumpulan alat lokal yang tidak pernah menyentuh jaringan. Bantuan itu sendiri tidak memerlukan kunci API dan koneksi, yang menjadikan openai <command> --help sebagai cara tercepat untuk mempelajari flag.

Alat ini cocok untuk pengembang yang menguji prompt tanpa menulis skrip, orang ops yang ingin unggahan file dan batch dalam cron job, serta agen coding yang membutuhkan antarmuka terdokumentasi alih-alih curl buatan sendiri.

Cara menginstal OpenAI CLI

Ada tiga jalur instalasi, semuanya tercantum di README proyek:

1. Biner siap pakai. Unduh arsip untuk OS dan arsitektur Anda dari GitHub Releases (build macOS, Linux, dan Windows tersedia), ekstrak dan letakkan openai di PATH Anda.
2. Homebrew.

brew install openai/tools/openai

3. Go. Memerlukan Go 1.26 atau yang lebih baru.

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

Instalasi rilis yang dikelola sendiri dapat memperbarui dirinya sendiri selama proses interaktif. Jika Anda mematok versi di CI, atur OPENAI_CLI_NO_AUTO_UPDATE=1 untuk menghentikan instalasi otomatis, atau OPENAI_CLI_NO_UPDATE_CHECK=1 untuk mematikan pemeriksaan pembaruan sepenuhnya. Instalasi Homebrew dan Go tetap menampilkan pemberitahuan pembaruan tetapi menyerahkan peningkatan kepada manajer paket.

Bagaimana autentikasi OpenAI CLI bekerja

CLI membaca kunci API standar dari OPENAI_API_KEY (atau flag --api-key, yang sebaiknya dihindari karena akan tercatat di riwayat shell). Jika Anda belum memilikinya, panduan kami tentang cara mendapatkan kunci OpenAI API membahasnya secara lengkap.

Pengaturan tercepat adalah panduan bawaan:

openai help setup

Ini mengarahkan Anda ke halaman kunci API dan memberi Anda baris read -rs OPENAI_API_KEY untuk Bash atau zsh, sehingga kunci diketik secara tersembunyi dan tidak pernah ditampilkan.

Lupakan kunci dan Anda akan mendapatkan kegagalan yang jelas dan dapat diskripkan. Ini adalah keluaran nyata tanpa kunci yang diatur:

Ini keluar dengan status 1 dan memberi tahu Anda dengan tepat dari mana kunci bisa berasal. Tambahkan --format-error json ketika skrip membutuhkan isi kesalahan mentah.

Pengaturan autentikasi lainnya:

Perintah OpenAI CLI pertama yang perlu dijalankan

Bentuk perintah mengikuti API: openai <resource> [subresource...] <command> [flags...]. Berikut adalah perintah-perintah yang layak masuk ke kotak perkakas Anda.

Lakukan panggilan Responses API

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

Prompt panjang tidak perlu di-escape. Flag input JSON membaca dari file dengan @path:

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

Jika Anda menyalurkan JSON atau YAML dari sumber yang tidak Anda percayai, atur OPENAI_UNTRUSTED_STDIN=1 agar input tersebut tidak dapat memicu pembacaan file lokal.

Unggah dan ambil file

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

Jalankan batch

Letakkan satu permintaan per baris di requests.jsonl, masing-masing dengan custom_id yang unik, lalu:

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 melakukan polling hingga batch selesai dan menyimpan file hasil, yang menghilangkan loop polling yang jika tidak akan Anda tulis sendiri. Panduan batch proyek ini mencantumkan batas saat ini sebagai 50.000 permintaan dan 200 MB per file input, dengan jendela penyelesaian 24h. Harga batch berbeda dari panggilan sinkron; lihat ulasan harga OpenAI API kami sebelum Anda mengantrekan tugas besar.

Hitung token secara lokal, tanpa kunci

Perintah tokenizer berjalan sepenuhnya offline: tanpa kredensial, tanpa jaringan, tanpa input yang disimpan.

Encoding default adalah o200k_base, dan openai tokenizer encodings mencantumkan yang lainnya (cl100k_base, plus dua yang legacy). Bantuan tersebut jujur tentang batasannya: hitungan teks biasa tidak menyertakan struktur permintaan dan input multimodal, jadi ini bukan angka penagihan. Untuk hitungan sisi server, gunakan openai responses input-tokens count.

Dapatkan keluaran yang dapat diurai skrip

Keluaran default adalah teks yang mudah dibaca, bahkan saat disalurkan. Mintalah data secara eksplisit:

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

--format menerima auto, text, json, jsonl, yaml, explore (penampil JSON interaktif) dan pretty. --transform menarik field dengan sintaks GJSON, dan jq menangani apa pun yang lebih rumit. Selalu periksa status keluar sebelum mempercayai file hasil pengalihan: permintaan yang gagal dapat meninggalkan file yang tidak lengkap.

Ketika sebuah panggilan berperilaku tidak semestinya, --debug menambahkan waktu HTTP per percobaan; bersihkan lognya sebelum dibagikan. Jika Anda terkena 429, panduan batas laju OpenAI kami menjelaskan tingkatannya.

OpenAI CLI vs Codex CLI vs perintah openai lama

Tiga alat berbagi vendor dan dua berbagi nama. Ini versi singkatnya:

Jalankan openai codex dan OpenAI CLI akan mencetak perintah instalasi Codex sendiri, dan mencatat bahwa itu adalah alat terpisah dengan proses masuknya sendiri. Panduan Codex CLI kami membahas sisi agennya, dan sumbernya ada di github.com/openai/codex.

Waspadai benturan PATH

Paket Python openai juga menginstal biner bernama openai. Jika Anda pernah menjalankan pip install openai, Anda mungkin memiliki dua:

Di Mac ini, yang Python melaporkan openai 2.30.0 dan menawarkan subperintah api, tools, migrate dan grit; yang Go melaporkan openai version 1.44.1. Direktori mana pun yang muncul lebih dulu di PATH Anda yang menang. Jalankan which -a openai dan openai --version setelah Anda menginstal. Jika keluarannya menyebut openai version 1.44.1 (atau lebih baru), Anda memiliki yang benar. Jika hanya mencetak nomor versi seperti openai 2.30.0, urutkan ulang PATH Anda atau panggil biner baru dengan path lengkapnya.

Di mana Apidog CLI cocok bersanding dengan OpenAI CLI

OpenAI CLI melakukan panggilan ke OpenAI. Ia tidak tahu tentang API Anda sendiri: endpoint yang diekspos aplikasi Anda di atas OpenAI, lingkungan tempat Anda men-deploy, atau assertion yang membuktikan suatu rilis tidak merusak apa pun. Itu pekerjaan yang berbeda, dan di sinilah Apidog CLI berperan. Anda tidak memilih salah satu daripada yang lain; sebagian besar tim yang merilis fitur AI menginginkan keduanya.

Lebih baik lagi, biarkan agen coding Anda menjalankan keduanya. Siapkan Apidog CLI sekali:

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

Lalu berikan agen Anda satu prompt:

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.

Agen memeriksa kunci dengan openai, lalu bekerja melalui Apidog CLI. Ia membaca skema sebelum menulis payload apa pun, memvalidasi file, dan baru setelah itu membuat serta menjalankan test case:

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

Dua detail dari apidog test-case create --help menghemat satu putaran: test case memerlukan categoryId yang valid (daftarkan dengan apidog test-case category --project <id>), dan payload harus berasal dari cli-schema, bukan dari ingatan. Baris apidog run yang sama dengan -r junit dapat langsung dipakai di CI, seperti yang ditunjukkan panduan CI/CD Apidog CLI kami. Jika Codex adalah agen Anda, mulailah dengan Apidog CLI di Codex.

Paket Free Apidog mencakup hingga 4 pengguna, sehingga tim kecil dapat mencobanya tanpa keputusan pembelian.

FAQ

Apakah OpenAI CLI gratis? Alat ini gratis dan sumber terbuka di bawah Apache 2.0. Panggilan API yang dilakukannya ditagih ke akun OpenAI Anda dengan tarif API normal. Perintah lokal seperti openai tokenizer dan setiap halaman --help tidak memakan biaya dan tidak memerlukan kunci.

Apakah OpenAI CLI sama dengan Codex CLI? Tidak. openai mengirim permintaan API langsung, satu per perintah. codex adalah agen coding yang membaca dan mengedit proyek Anda serta menjalankan perintah. Keduanya diinstal secara terpisah dan diautentikasi secara terpisah.

Bagaimana cara menginstal OpenAI CLI di Mac? Jalankan brew install openai/tools/openai, atau unduh zip macos_arm64 (Apple Silicon) atau macos_amd64 (Intel) dari GitHub Releases dan letakkan binernya di PATH Anda. Lalu jalankan openai --version untuk memastikan Anda tidak mengenai perintah openai Python yang lebih lama.

Apakah OpenAI CLI berfungsi di skrip shell dan CI? Ya, itu tujuan desain utamanya. Gunakan --format json atau jsonl untuk keluaran yang dapat diurai, periksa status keluar, simpan kunci di OPENAI_API_KEY dari manajer rahasia Anda, dan atur OPENAI_CLI_NO_AUTO_UPDATE=1 untuk menjaga versi tetap dipatok.

Kapan OpenAI CLI dirilis? Versi 1.0.0 diterbitkan di GitHub pada 5 Mei 2026. Per 28 Oktober 2026, rilis terbaru adalah 1.44.1, dari 27 Oktober.