Instal Codex CLI: pengaturan, login, dan tugas pertama Anda

Instal Codex CLI, verifikasi executable, masuk, lalu mulai dengan tugas kecil di direktori proyek Anda. Penginstal resmi kini mencakup macOS, Linux, dan Windows; npm dan Homebrew tetap menjadi alternatif. Pilih salah satu rute di bawah. Instalasi yang berfungsi adalah langkah pertama; akses akun dan penagihan API merupakan pilihan terpisah.

1. Pilih satu metode instalasi

Perintah ini berasal dari panduan instalasi Codex CLI resmi. Gunakan penginstal untuk lingkungan tempat Anda akan menjalankan agen. Menginstal executable Windows tidak menginstal salinan Linux terpisah di dalam WSL, dan menginstal di laptop tidak menginstal apa pun di server jarak jauh yang nanti Anda sambungkan.

curl -fsSL https://chatgpt.com/codex/install.sh | sh

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Jika Anda sudah mengelola alat pengembangan dengan pengelola paket, gunakan alternatifnya alih-alih menjalankan kedua penginstal:

Rute npm memerlukan instalasi npm yang berfungsi; periksa npm --version terlebih dahulu. Rute mandiri berguna jika Anda tidak memerlukan alat Node. Pada mesin yang dikelola, gunakan metode instalasi yang didukung administrator Anda agar pembaruan berikutnya tetap dapat diprediksi.

2. Verifikasi executable yang dijalankan

Buka terminal baru setelah instalasi jika perintah tidak ditemukan. Di macOS atau Linux, command -v codex menampilkan executable yang dipilih shell Anda. Di PowerShell, gunakan Get-Command codex. Bandingkan jalur tersebut dengan metode instalasi yang Anda pilih sebelum menginstal ulang. Dua salinan yang terinstal dapat membuat Anda memperbarui satu salinan sambil terus menjalankan salinan lainnya.

codex --version
codex --help

# Open your own project directory before starting
cd /path/to/your/project
codex login
codex login status
codex --sandbox read-only "Explain this project's structure and how its tests run. Do not modify files."

Ganti jalur proyek contoh dengan milik Anda. Perintah terakhir menggunakan sandbox hanya-baca untuk penjelasan awal. Ini pemeriksaan pertama yang berguna karena Anda dapat memastikan repositori dan akses model yang benar sebelum meminta agen melakukan perubahan. Jika ingin melihat flag yang tersedia, gunakan bantuan CLI yang terinstal atau referensi perintah.

3. Pilih jalur akun yang tepat

codex login memulai alur masuk akun. Periksa akun browser dan workspace sebelum menyelesaikannya. Untuk penagihan OpenAI API langsung, alternatif yang didokumentasikan menerima kunci Platform melalui input standar:

# After supplying OPENAI_API_KEY through your credential setup:
printenv OPENAI_API_KEY | codex login --with-api-key

Perintah API ini ditujukan untuk kunci OpenAI Platform. Ini bukan penyiapan lengkap untuk gateway pihak ketiga. Penyedia kustom memerlukan konfigurasi, endpoint, sumber kredensial, dan model yang didukung sendiri. Dokumentasi autentikasi menjelaskan rutenya, sedangkan panduan kunci API Codex kami membahas penyiapan penyedia secara lebih mendalam.

4. Jadikan respons pertama sebagai tugas pertama yang berguna

1. Tanyakan di mana sumber dan pengujian yang relevan berada, lalu cocokkan jawabannya dengan repositori.
2. Pilih satu perubahan kecil dan nyatakan perilaku yang diharapkan.
3. Gunakan branch bersih atau checkpoint, lalu pilih izin yang sesuai untuk perubahan tersebut.
4. Minta Codex menjalankan pemeriksaan yang relevan, lalu tinjau diff dan penjelasannya.

Misalnya, mulai dengan satu pengujian yang gagal atau perbaikan dokumentasi kecil. Hindari menjadikan tugas pertama sebagai penulisan ulang seluruh aplikasi: instalasi, kredensial, dependensi lokal, dan kualitas tugas akan lebih sulit dinilai sekaligus. Setelah siklus singkat ini berhasil, tambahkan instruksi proyek dan perluas cakupannya.

Jika penyiapan berhenti, perbaiki lapisan yang sesuai

“Command not found” mengarah ke instalasi atau PATH. 401 mengarah ke autentikasi. Kesalahan model mengarah ke penyedia dan model yang dipilih. Peringatan batas mengarah ke penggunaan atau penagihan. Pertahankan lapisan yang sudah berfungsi dan ikuti daftar periksa 401 atau panduan batas penggunaan sesuai kebutuhan; menginstal ulang executable tidak akan mengisi ulang akun.

Untuk mengevaluasi Kunavo untuk pekerjaan Codex lokal, buat akun dan ikuti integrasi Codex. Ini menggunakan konfigurasi penyedia yang kompatibel dengan Responses. Verifikasi satu tugas kecil sebelum mengandalkan rute penagihan baru untuk proyek yang lebih besar.

Pertanyaan umum

Dokumentasi instalasi resmi dan bantuan CLI lokal diperiksa pada 17 September 2026.