OpenAI Codex: Apa Itu, Cara Menginstalnya, dan Ketentuan Akses Regional pada 2026

Kata “Codex” dalam hasil pencarian merujuk pada tiga hal berbeda, dan orang yang baru pertama kali mengetikkannya biasanya tidak memahami apa yang mereka temukan. Dulu ada model Codex—model itu dihentikan pada 2023; sekarang, nama tersebut digunakan untuk program agen, dan ada belasan produk lain dengan nama yang sama.

Saya hanya membahas satu Codex: agen pemrograman OpenAI. Apa fungsinya, di mana ia berjalan, berapa biayanya, cara menginstalnya dalam lima menit, dan apa yang dikatakan OpenAI tentang negara-negara. Semuanya berdasarkan dokumentasi resmi, dengan tautan untuk setiap angka di bagian akhir.

Materi tambahan tentang menyiapkan alat tersedia di dokumentasi Ailoot.

Apa itu OpenAI Codex?#

Bandingkan dengan obrolan biasa. Dalam obrolan, Anda menyalin potongan kode, menempelkannya, mendapatkan jawaban, lalu menyalinnya kembali. Cara kerja agen berbeda: Anda menjelaskan tugas dengan bahasa sehari-hari, lalu agen membuka berkas yang relevan di folder proyek Anda, membuat perubahan, menjalankan pemeriksaan, dan menunjukkan hasilnya.

OpenAI menjelaskannya dalam satu baris di repositorinya:

Secara lokal berarti program diunduh ke perangkat Anda, tempat program itu dapat melihat berkas dan menjalankan perintah di folder Anda. Hanya permintaan ke model yang dikirim ke cloud.

Kode sumber terbuka tersedia di GitHub dengan lisensi Apache-2.0. Per 1 Agustus 2026, repositori tersebut memiliki 103.000 bintang, dan versi terbaru, 0.146.0, dirilis pada 29 Juli. Pembaruan dirilis hampir setiap hari, jadi kemungkinan besar versi Anda sudah berbeda.

Apa perbedaan Codex pada 2026 dengan Codex lama yang dihentikan?#

Orang sering mencampuradukkan keduanya karena kedua produk itu resmi dan sama-sama berasal dari OpenAI. Tanggalnya membedakan keduanya.

Yang pertama adalah sekumpulan model: code-davinci-001, code-davinci-002, code-cushman-001, code-cushman-002. Model-model itu melakukan satu hal—melengkapi kode untuk Anda—dan menjadi penggerak GitHub Copilot pertama. Dalam daftar model yang dihentikan oleh OpenAI, keempatnya tercantum dalam satu baris: diumumkan pada 20 Maret 2023, dihentikan pada 23 Maret, dengan gpt-4o sebagai pengganti yang direkomendasikan.

Yang kedua adalah program yang diinstal di komputer Anda. Paket @openai/codex muncul di registri npm pada 16 April 2025. Model di dalamnya diganti dengan model yang lebih baru seiring waktu, sementara programnya sendiri tetap sama.

Instruksi apa pun tentang Codex yang berasal dari sebelum April 2025 menjelaskan produk yang sudah dihentikan. Jika Anda menemukan materi yang menyebut Codex sebagai model dan menyarankan untuk memanggilnya melalui code-davinci-002, abaikan saja.

Di mana Codex bekerja: terminal, editor, browser, atau aplikasi?#

Anda tidak perlu memilih salah satunya. Cara masuk dan akunnya sama. Perbedaannya hanya soal tempat yang paling nyaman bagi Anda untuk bekerja.

Ekstensi bekerja secara berbeda untuk Xcode dan JetBrains dibandingkan editor lainnya:

Cloud bekerja secara berbeda dibandingkan empat cara lainnya. Tugas dikirim ke kontainer OpenAI, tempat salinan repositori di-checkout dari GitHub. Agen bekerja tanpa menggunakan komputer Anda, lalu Anda meninjau hasilnya dan memutuskan apakah akan membawa perubahan tersebut ke salinan Anda sendiri. Penyiapannya terdiri dari tiga langkah: hubungkan GitHub, buat lingkungan dengan dependensi yang diperlukan, lalu tetapkan tugas.

Jika Anda masuk dengan kunci API, terminal, editor, dan aplikasi bisa digunakan. Cloud tidak tersedia dengan kunci, begitu pula fitur yang terkait dengannya, seperti tinjauan kode otomatis dan peluncuran tugas dari Slack. Untuk menggunakan fitur-fitur itu, Anda harus masuk dengan akun ChatGPT.

Model apa yang berjalan di dalam Codex?#

OpenAI merangkumnya dalam satu baris:

Ada kontrol kedua di samping model: tingkat penalaran. Tersedia empat pengaturan: Low (disebut Light di aplikasi dan editor), Medium, High, dan Extra High. OpenAI menyarankan untuk menggunakan tingkat terendah yang menghasilkan hasil yang Anda butuhkan dan menaikkannya jika tugas memerlukan perencanaan.

Ada dua mode lain di atasnya. Max memberi model lebih banyak waktu untuk mengerjakan tugas. Ultra membagi pekerjaan menjadi beberapa bagian dan menugaskannya kepada subagen secara paralel. Dokumentasi menyatakan secara langsung bahwa sebagian besar tugas tidak memerlukan keduanya.

Ada juga pilihan terpisah, gpt-5.3-codex-spark—versi riset untuk iterasi cepat, yang hanya tersedia pada paket Pro.

Berapa biaya Codex, dan apa saja yang termasuk dalam paket?#

Saya memeriksa harga pada halaman harga resmi pada 1 Agustus 2026.

Business berharga $25 per kursi dengan tagihan bulanan, bukan $20.

Sekarang, soal batas penggunaan. OpenAI tidak menetapkan satu angka pasti:

Sebagai ganti satu angka, OpenAI menerbitkan rentang: jumlah pesan yang tersedia selama lima jam saat bekerja di komputer sendiri. Angkanya sama untuk Plus dan Business:

Pada paket Pro seharga $100, semua angka dikalikan lima; pada paket Pro seharga $200, dikalikan dua puluh. OpenAI juga menyebut batas mingguan selain jendela lima jam, tetapi tidak menerbitkan angka khusus untuk batas tersebut.

Rentang sepuluh kali lipat dalam satu model memiliki penjelasan sederhana. Satu pesan dapat menggunakan satu persen atau sepuluh persen dari jatah harian Anda, karena yang diperhitungkan adalah jumlah pekerjaan yang dilakukan, sedangkan jumlah permintaan tidak terlalu berpengaruh. Saya menjelaskan secara terperinci cara penggunaan token dalam praktik dengan Claude sebagai contoh di Batas Claude Pro dan Max—mekanismenya persis sama.

Saat jatah habis, ada tiga pilihan: membeli kredit tambahan tanpa mengubah paket, beralih ke model yang lebih ringan, atau memulai sesi dengan kunci API dan membayar token sesuai pemakaian.

Pembatasan regional apa yang berlaku untuk Codex?#

OpenAI menerbitkan daftar resmi negara dan wilayah yang didukung secara terbuka. Belarus tidak ada dalam daftar. Kazakhstan, Armenia, Georgia, Turki, Serbia, dan Ukraina ada di dalamnya.

Isi halaman yang sama:

Menginstal dan menjalankan program adalah satu hal; mengakses model adalah hal lain. Pemeriksaan negara dilakukan saat masuk: baik masuk melalui ChatGPT maupun dengan kunci API akan mengarah ke akun OpenAI.

Laporan di GitHub menunjukkan seperti apa penolakan terkait negara. Pada Januari 2026, seorang pengembang dari Venezuela menulis bahwa ia menggunakan Codex 0.88.0 di PowerShell dan mendapatkan pesan yang sama setiap kali mencoba:

{
  "error": {
    "code": "unsupported_country_region_territory",
    "message": "Country, region, or territory not supported",
    "type": "request_forbidden"
  }
}

Kode unsupported_country_region_territory dan status 403 menunjukkan penolakan terkait negara. Jika Anda melihatnya, berarti tidak ada yang rusak saat instalasi, dan Node tidak ada hubungannya dengan masalah itu.

Ada hambatan kedua yang sama sekali tidak dijelaskan dalam dokumentasi, tetapi lebih sering muncul dalam praktik. Hambatan itu adalah verifikasi nomor telepon. Laporan “Verifikasi nomor telepon tidak berfungsi” memiliki 206 komentar; laporan kedua, tentang nomor lama yang sudah tidak dapat diakses dan tidak bisa diganti, telah terbuka sejak Juni 2026 dan memiliki 71 komentar. Cerita yang sama terus muncul: ChatGPT berfungsi di browser dengan akun yang sama, tetapi Codex meminta verifikasi telepon dan tidak ada cara untuk melewatinya. OpenAI tidak menerbitkan daftar negara yang nomor teleponnya diterima, jadi Anda tidak dapat memeriksa nomor Anda sebelumnya.

Saya tidak membahas cara mengakali pembatasan; artikel ini membahas cara kerja alat tersebut.

Anthropic juga menerbitkan daftar negara yang didukung, dan cara kerjanya sama. Materi yang menggambarkan satu alat sebagai “diizinkan” dan alat lainnya sebagai “diblokir” hanya menyesatkan pembaca—secara resmi, keduanya berada dalam posisi yang sama. Kedua daftar dapat berubah, jadi periksa versi terkininya.

Cara menginstal Codex: langkah demi langkah#

Bagian teknis dimulai di sini, bagi Anda yang sudah memiliki akun OpenAI aktif.

1. Instal program

   Pilih metode untuk sistem Anda. Gunakan metode yang sama nanti untuk memperbarui program ke versi terbaru.

2. Buka folder proyek

   Agen bekerja di folder tempat Anda meluncurkannya. Buka folder itu sebelum menjalankan perintah pertama.

3. Masuk ke akun Anda

   Saat pertama kali menjalankan codex, program akan menawarkan untuk membantu Anda masuk. Browser akan terbuka, dan setelah Anda masuk, kendali akan kembali ke terminal.

4. Berikan tugas pertama

   Jelaskan kebutuhan Anda dengan bahasa sehari-hari. Mulailah dengan sesuatu yang tidak berisiko, misalnya memintanya menjelaskan proyek.

Perintah instalasi untuk macOS dan Linux:

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

Di Windows, gunakan installer yang sama melalui PowerShell:

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

Jika Anda sudah memiliki Node, Anda dapat menginstalnya melalui npm:

npm install -g @openai/codex

Homebrew berfungsi di macOS. Pastikan menggunakan --cask; jika tidak, Anda akan menginstal program yang salah:

brew install --cask codex

Di Linux dan WSL2, sandbox menggunakan bubblewrap, yang perlu Anda instal sebelumnya:

sudo apt install bubblewrap

Di Fedora dan sistem terkait, gunakan sudo dnf install bubblewrap. Selain itu, WSL versi 1 didukung hingga versi 0.114; mulai versi 0.115, sandbox beralih ke bubblewrap dan WSL1 tidak lagi berfungsi. Namun, di Windows semuanya juga berfungsi tanpa WSL, menggunakan sandbox bawaannya sendiri.

Apa yang sebaiknya dilakukan saat pertama kali dijalankan?#

Untuk memulai, buka folder proyek dan ketik codex; sesi akan terbuka. Lalu jelaskan tugas dengan bahasa sehari-hari, tanpa sintaks khusus.

Lima perintah untuk beberapa menit pertama:

1. /status - model, kebijakan persetujuan, dan folder yang dianggap agen sebagai ruang kerjanya.
2. /permissions - mode akses saat ini dan cara beralih antar-mode.
3. /model - mengganti model dan tingkat penalaran.
4. /init - membuat berkas AGENTS.md yang menjelaskan proyek; selengkapnya di bagian berikutnya.
5. /review - tinjauan terpisah atas perubahan Anda, tanpa mengedit berkas.

Selain codex biasa, ada tiga perintah terminal yang berguna:

codex resume                    # return to the previous conversation in this folder
codex exec "fix the tests"      # one-off run without a dialogue, for scripts
codex --image screenshot.png    # attach an image to the task

Di halaman dokumentasi terminal dan ekstensi, OpenAI mengulangi saran yang sama: lakukan commit sebelum dan sesudah tugas. Agen mengedit berkas sendiri, dan Anda akan ingin dapat membatalkan perubahan dengan satu perintah sejak hari pertama.

Bagaimana menjelaskan proyek Anda kepada Codex dengan AGENTS.md?#

Urutannya ketat, dan dokumentasi menyatakannya pada baris pertama bagian tersebut:

Pertama, Codex membaca berkas global ~/.codex/AGENTS.md, tempat Anda menuliskan kebiasaan yang berlaku untuk semua proyek. Lalu Codex membaca berkas di dalam proyek itu sendiri: satu berkas per folder, dari root repositori hingga folder saat ini. Semuanya digabungkan dari atas ke bawah, dan berkas yang lebih dekat mengesampingkan aturan yang lebih jauh. Artinya, aturan di services/payments lebih diutamakan daripada aturan umum di root.

Contoh berkas sederhana:

# AGENTS.md

## How to work with this project

- Run tests with `npm test`; don't run them one file at a time.
- Install packages with pnpm.
- Ask me before adding a new production dependency.
- Do not touch the `legacy/` folder at all.

Batas gabungannya adalah 32 kilobyte. Setelah itu, berkas berikutnya tidak akan ditambahkan, tanpa pemberitahuan. AGENTS.md yang terlalu besar juga menghabiskan batas setiap kali dijalankan karena seluruh berkas dimasukkan ke konteks.

Jika Anda mengenal CLAUDE.md, mekanismenya akan terasa familiar: teknik yang sama dengan nama berbeda. Berkas aturan proyek menjadi fondasi Second Brain: agen mempelajari pekerjaan Anda sebelum Anda sempat menjelaskannya. Saya membahas cara menggunakan kedua berkas dalam satu proyek di Menggunakan AGENTS.md dan CLAUDE.md bersama-sama.

Apa yang dilakukan Codex sendiri, dan apa yang memerlukan persetujuan?#

Kedua pengaturan ini sering tertukar, jadi OpenAI menjelaskan perbedaannya dalam satu baris:

Mengalihkan peninjauan ke otomatis tidak mengubah batas folder kerja. Otomatisasi hanya menghilangkan klik; izin agen tetap sama.

Aplikasi dan editor memiliki tiga mode akses. Ask for approval selalu tersedia dan merupakan pilihan awal yang disarankan. Approve for me dan Full access harus diaktifkan terlebih dahulu di pengaturan.

Terminal memiliki logikanya sendiri: program memeriksa folder dan menyarankan kumpulan izin yang sesuai.

Akses jaringan secara default dinonaktifkan dalam mode lokal. Agen menjalankan perintah yang dirancangnya sendiri, dan tidak ada yang akan mengizinkan perintah tersebut mengakses internet secara default.

Bahkan di dalam folder kerja, dalam setiap mode agen hanya dapat membaca lokasi tertentu: .git, .agents, dan .codex. Gunakan /status untuk melihat folder yang saat ini dianggap agen sebagai ruang kerjanya.

Ada juga mode akses penuh—flag --dangerously-bypass-approvals-and-sandbox. Dokumentasi menandainya sebagai berisiko lebih tinggi dan memberi label “tidak disarankan.” Nama flag itu sudah menjelaskan semuanya; tidak ada lagi yang perlu saya tambahkan.

Codex atau Claude Code: mana yang sebaiknya dipilih?#

Perbedaan kedua alat ini lebih kecil daripada yang mungkin Anda simpulkan dari perdebatan daring. Keduanya membaca proyek Anda dan mengedit berkas sendiri, dan keduanya meminta persetujuan sebelum keluar dari folder.

Saat memulai, paling mudah untuk melihat layanan yang sudah Anda bayar. Jika Anda berlangganan ChatGPT, Codex sudah termasuk; Anda tidak perlu membayar secara terpisah. Saya membuat perbandingan terperinci dengan pengukuran dalam tulisan terpisah tentang Codex vs. Claude Code, dan jika Anda ingin memindahkan pengaturan kerja dari satu alat ke alat lainnya, ada panduan migrasi.

Apa yang paling sering bermasalah saat pertama kali dijalankan?#

Daftar ini berdasarkan laporan di repositori proyek. Tidak ada dugaan di sini; setiap poin berasal dari seseorang yang mengalaminya.

1. Paket yang salah terinstal. npm install -g codex tanpa awalan akan menginstal generator situs statis dari 2011. Paket yang benar adalah @openai/codex.
2. bubblewrap belum terinstal. Tanpanya di Linux dan WSL2, sandbox tidak berjalan. Codex beralih ke fallback bawaannya dan menampilkan keluhan saat mulai. Instal dengan satu perintah.
3. Akses ditolak berdasarkan negara. Kode unsupported_country_region_territory dan status 403 muncul saat masuk. Instalasi tidak ada hubungannya dengan masalah itu.
4. Verifikasi telepon diperlukan. Ini tidak terjadi pada semua orang dan tidak dijelaskan dalam dokumentasi. Tidak ada cara resmi untuk mengganti nomor yang tidak dapat diakses; laporan tentang masalah ini telah terbuka sejak Juni 2026.
5. Batas penggunaan habis lebih cepat daripada perkiraan. Laporan “Token cepat sekali habis” adalah laporan yang paling banyak dibahas di seluruh repositori, dengan 627 komentar. Beralih ke model yang lebih ringan dan menurunkan tingkat penalaran dapat membantu.

Bahasa antarmuka tidak memengaruhi pekerjaan agen: bahasa tugas tidak harus sama dengan bahasa antarmuka.

Apa yang perlu dilakukan selanjutnya#

Jam pertama menggunakan agen selalu digunakan untuk hal yang sama: mencari tahu sejauh mana agen dapat bekerja sendiri. Anda hanya bisa mempelajarinya dengan proyek Anda sendiri; contoh dalam dokumentasi tidak akan memberi tahu Anda.

Berikut urutan yang saya sarankan untuk memulai:

1. Instal program dan masuk ke akun OpenAI yang aktif.
2. Buka folder proyek sungguhan dan jalankan codex.
3. Periksa /status dan /permissions, pilih akses hanya-baca secara eksplisit untuk tugas inspeksi saja, dan verifikasi mode aktif sebelum bertanya tentang susunan proyek.
4. Buat commit dan berikan tugas penyuntingan pertamanya.
5. Tulis AGENTS.md tiga baris dan bandingkan respons agen sebelum dan sesudahnya.

Temukan materi tambahan tentang penggunaan alat di dokumentasi Ailoot.