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

> Codex dari OpenAI: aplikasi agen, metode instalasi, antarmuka, model, paket, izin, dan ketentuan akses regional.

Source: https://ailoot.ai/blog/id/openai-codex-install/
Canonical: https://ailoot.ai/blog/id/openai-codex-install/
Language: id
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-080
Revision: sha256-2b1832feb7af02d2dc25946b47e447c964ef41bc536b9df9faf164fedc460b60


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](https://ailoot.ai/docs/).

<div class="aside" data-semantic="ailoot-cta" role="note" aria-label="Panduan Ailoot">

[Panduan Ailoot](https://ailoot.ai/docs/)

</div>

<div class="aside" data-semantic="callout" role="note" aria-label="Perhatian">

Perhatian

Materi ini hanya untuk referensi. Saya bukan pengacara dan tidak memberikan nasihat hukum.

</div>

## Apa itu OpenAI Codex?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Poin utama">

Poin utama

Codex adalah agen pemrograman OpenAI. Agen ini membaca proyek, mengedit berkas, dan menjalankan perintah sesuai izin serta kebijakan persetujuan aktif; sebagian tindakan yang diizinkan berjalan tanpa permintaan persetujuan terpisah. Codex bekerja di terminal, editor, aplikasi ChatGPT, browser, dan cloud. Codex termasuk dalam semua paket ChatGPT, termasuk paket gratis.

</div>

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:

<figure>
<blockquote>
<p>Codex CLI adalah agen pemrograman OpenAI yang berjalan secara lokal di komputer Anda.</p>
</blockquote>
<figcaption>— OpenAI, https://github.com/openai/codex</figcaption>
</figure>

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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Poin utama">

Poin utama

Keduanya adalah dua produk berbeda dengan nama yang sama. Codex lama adalah rangkaian model `code-davinci` dan `code-cushman` yang berjalan di dalam GitHub Copilot dan dihentikan pada 23 Maret 2023. Codex baru muncul pada April 2025 dan menjadi agen, bukan model. Kesamaan mereka hanya namanya.

</div>

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.

| Fitur | Versi sebelum 2023 | Versi saat ini |
|----|----|----|
| Apa itu | sekumpulan model API | program agen di komputer Anda |
| Cara penggunaannya | pelengkapan kode di editor | jelaskan tugas, lalu agen mengerjakannya |
| Tempat berjalannya | di dalam GitHub Copilot dan API | terminal, editor, aplikasi, browser, cloud |
| Status | dihentikan pada 23 Maret 2023 | diperbarui hampir setiap hari |

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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Poin utama">

Poin utama

Codex bekerja di lima tempat, dan agen yang sama berada di balik antarmuka yang berbeda. CLI berjalan di terminal, ekstensi terintegrasi dengan editor, mode terpisah tersedia di aplikasi ChatGPT untuk macOS dan Windows, ChatGPT di browser menjawab pertanyaan singkat, dan Codex cloud menjalankan tugas di kontainer OpenAI yang terisolasi.

</div>

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

| Tempat bekerja | Tempat berjalan | Kegunaan |
|----|----|----|
| CLI | terminal di komputer Anda | mengedit proyek, menjalankan perintah, bekerja dengan skrip |
| Ekstensi editor | VS Code, Cursor, Windsurf, Xcode, JetBrains | mengedit di samping berkas yang terbuka, melihat perubahan langsung di tempatnya |
| Aplikasi ChatGPT | macOS dan Windows | tugas panjang, bekerja dengan berkas di luar terminal |
| ChatGPT di browser | komputer apa pun, tanpa instalasi | pertanyaan pemrograman singkat saat Anda tidak punya akses ke terminal |
| Cloud | kontainer OpenAI, masuk di chatgpt.com/codex | tugas paralel, meluncurkan tugas dari GitHub, Linear, Slack |

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

<figure>
<blockquote>
<p>Pilih editor Anda. VS Code dan editor yang kompatibel menggunakan ekstensi Codex; Xcode dan JetBrains memiliki integrasi sendiri.</p>
</blockquote>
<figcaption>— Dokumentasi Codex, https://learn.chatgpt.com/docs/codex/ide</figcaption>
</figure>

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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Poin utama">

Poin utama

Keluarga GPT-5.6 memiliki tiga model: Sol untuk tugas rumit, Terra untuk pekerjaan sehari-hari, dan Luna untuk tugas cepat dan berulang. Ganti model dengan `/model`; tingkat penalaran juga dapat disesuaikan. GPT-5.4 dan GPT-5.4 mini akan dihapus dari Codex pada 31 Agustus 2026, masing-masing digantikan oleh Terra dan Luna.

</div>

OpenAI merangkumnya dalam satu baris:

<figure>
<blockquote>
<p>Codex menawarkan tiga model GPT-5.6: Sol untuk eksplorasi yang lebih mendalam dan terperinci, Terra sebagai andalan untuk pekerjaan sehari-hari, dan Luna untuk pekerjaan sederhana dan berulang. Jika Anda ragu, mulailah dengan Sol.</p>
</blockquote>
<figcaption>— Dokumentasi Codex, https://learn.chatgpt.com/docs/models</figcaption>
</figure>

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.



<div class="aside" data-semantic="ailoot-cta" role="note" aria-label="Panduan Ailoot">

[Panduan Ailoot](https://ailoot.ai/docs/)

</div>

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Poin utama">

Poin utama

Codex termasuk dalam semua paket ChatGPT, termasuk paket gratis. Free berharga 0 dolar, Go 8, Plus 20, Pro mulai dari 100, dan Business seharga 20 per kursi dengan tagihan tahunan. Tidak ada langganan Codex terpisah: Anda membayar ChatGPT, dan Codex sudah termasuk. Anda juga dapat masuk dengan kunci API dan membayar token sesuai pemakaian.

</div>

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

| Paket | Harga bulanan | Yang termasuk |
|----|----|----|
| Free | \$0 | Codex untuk tugas singkat |
| Go | \$8 | Codex untuk tugas ringan |
| Plus | \$20 | Codex di terminal, editor, web, dan iOS, dengan keluarga GPT-5.6 |
| Pro | mulai dari \$100 | batas 5 kali Plus; paket \$200 menyediakan batas 20 kali lipat |
| Business | \$20 per kursi dengan tagihan tahunan | minimal 2 kursi, ruang kerja bersama, akses tunggal |
| Enterprise dan Edu | berdasarkan permintaan | pemrosesan prioritas, log audit, kontrol retensi data |
| Kunci API | per token | terminal, editor, dan SDK, tanpa fitur cloud |

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

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

<figure>
<blockquote>
<p>Jumlah pesan yang dapat Anda kirim bergantung pada model yang dipilih, ukuran dan kerumitan tugas, serta apakah Anda menjalankannya secara lokal atau di cloud.</p>
</blockquote>
<figcaption>— Dokumentasi Codex, https://learn.chatgpt.com/docs/pricing</figcaption>
</figure>

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:

| Model | Pesan per 5 jam |
|---------------|----------------------|
| GPT-5.6 Sol | 10-100 |
| GPT-5.6 Terra | 25-200 |
| GPT-5.6 Luna | 250-2 000 |
| GPT-5.5 | 15-80 |
| GPT-5.4 | 20-100 |
| GPT-5.4 mini | 60-350 |

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](https://ailoot.ai/blog/id/claude-pro-max-usage-limits/)—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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Poin utama">

Poin utama

Programnya dapat diunduh dan dijalankan di mana saja, tetapi tidak berguna tanpa akun OpenAI, dan pembatasan berlaku pada akun itu sendiri. Pemeriksaan negara dilakukan saat masuk dan menghasilkan kode 403. Tidak ada cara resmi untuk melewatinya, dan saya tidak akan menunjukkan caranya.

</div>

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:

<figure>
<blockquote>
<p>Mengakses layanan kami, atau memberikan akses ke layanan tersebut, dari luar negara dan wilayah yang tercantum di bawah ini dapat mengakibatkan penangguhan atau penghentian akun.</p>
</blockquote>
<figcaption>— OpenAI, https://developers.openai.com/api/docs/supported-countries</figcaption>
</figure>

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:

```json
{
  "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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Poin utama">

Poin utama

Instalasi membutuhkan waktu lima menit. Di macOS dan Linux, instal dengan satu perintah melalui installer resmi; di Windows, gunakan PowerShell. npm dan Homebrew juga tersedia. Lalu jalankan `codex` di folder proyek, masuk melalui browser, dan Anda bisa memberikan tugas pertama. Di Linux dan WSL2, instal bubblewrap terlebih dahulu.

</div>

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:

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

Di Windows, gunakan installer yang sama melalui PowerShell:

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

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

```bash
npm install -g @openai/codex
```

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

```bash
brew install --cask codex
```

<div class="aside" data-semantic="callout" role="note" aria-label="Perhatian">

Perhatian

Periksa nama paket sebelum menginstalnya melalui npm. Saya memeriksa registri: sejak 1 Oktober 2011, paket milik pihak lain terdaftar dengan nama `codex` tanpa awalan. Paket itu adalah generator situs statis, dan versi terbarunya adalah 0.2.3. Paket tersebut terinstal tanpa pesan apa pun dan tidak akan berfungsi. Nama yang benar adalah `@openai/codex`: tanda at, nama perusahaan, dan garis miring.

</div>

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

```bash
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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Poin utama">

Poin utama

Perintah singkat dengan garis miring dapat digunakan di dalam sesi. Mulailah dengan `/status`, yang menampilkan model, kebijakan persetujuan, dan folder kerja. Lalu coba `/permissions` untuk melihat hal yang boleh dilakukan agen. `/model` mengganti model, `/init` membuat berkas yang menjelaskan proyek, dan `/review` meninjau perubahan tanpa mengedit berkas.

</div>

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:

```bash
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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Poin utama">

Poin utama

AGENTS.md adalah berkas teks di root proyek tempat Anda menulis aturan dengan kata-kata sendiri: cara menjalankan pengujian, package manager yang digunakan, dan hal yang tidak boleh disentuh. Agen membacanya sebelum mulai bekerja. Ada berkas global di folder home dan berkas tingkat proyek; aturan dari keduanya berlaku bersama. Ukuran totalnya dibatasi hingga 32 kilobyte.

</div>

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

<figure>
<blockquote>
<p>Codex membaca berkas AGENTS.md sebelum memulai pekerjaan apa pun.</p>
</blockquote>
<figcaption>— Dokumentasi Codex, https://learn.chatgpt.com/docs/agent-configuration/agents-md</figcaption>
</figure>

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:

```markdown
# 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](https://ailoot.ai/blog/id/agents-md-claude-md-one-instruction-file/).

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Poin utama">

Poin utama

Ada dua pengaturan terpisah. Sandbox menentukan tempat agen dapat menulis dan apakah agen dapat mengakses jaringan. Kebijakan persetujuan menentukan kapan agen berhenti dan meminta persetujuan. Secara default, di folder git agen mengedit berkas di folder kerja sendiri, dan hanya memerlukan persetujuan untuk mengakses bagian di luarnya atau jaringan.

</div>

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

<figure>
<blockquote>
<p>Mengubah siapa yang meninjau permintaan tidak memperluas sandbox.</p>
</blockquote>
<figcaption>— Dokumentasi Codex, https://learn.chatgpt.com/docs/permission-modes</figcaption>
</figure>

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.

| Situasi | Saran program | Artinya |
|----|----|----|
| Folder berada di bawah kendali git | `Auto` | mengedit berkas di folder kerja sendiri; persetujuan diperlukan untuk mengakses bagian di luarnya atau jaringan |
| Folder tanpa git | `read-only` | membaca dan merespons, tetapi tidak membuat perubahan |
| Codex cloud | kontainer OpenAI | dependensi dipasang saat penyiapan; pekerjaan kemudian berlanjut tanpa akses jaringan |

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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Poin utama">

Poin utama

Kedua alat dibuat dengan cara yang sama: agen di terminal, ekstensi editor, aplikasi, dan cloud. Keduanya berbeda dalam model, harga awal, dan detail seperti nama berkas aturan proyek. Codex menawarkan pilihan termurah mulai dari nol; Claude Code mulai dari 17 dolar.

</div>

| Fitur | Codex | Claude Code |
|----|----|----|
| Penyedia | OpenAI | Anthropic |
| Model | GPT-5.6: Sol, Terra, Luna | Opus, Sonnet, Haiku |
| Berkas aturan proyek | `AGENTS.md` | `CLAUDE.md` |
| Masuk | akun ChatGPT atau kunci API | langganan Claude atau tagihan Console |
| Pilihan termurah | Free seharga \$0, Go seharga \$8 | Pro seharga \$17 dengan tagihan tahunan |
| Tempat bekerja | terminal, editor, aplikasi, web, cloud | terminal, editor, aplikasi, web |
| Sandbox | jaringan nonaktif secara default, menulis ke folder kerja | mode izin, dapat dikonfigurasi |
| Daftar negara yang didukung | diterbitkan oleh OpenAI | diterbitkan oleh Anthropic |

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](https://ailoot.ai/blog/id/codex-vs-claude-code-choice/), dan jika Anda ingin memindahkan pengaturan kerja dari satu alat ke alat lainnya, ada [panduan migrasi](https://ailoot.ai/blog/id/migrate-claude-code-to-codex/).

## Apa yang paling sering bermasalah saat pertama kali dijalankan?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Poin utama">

Poin utama

Lima masalah umum: paket npm yang salah terinstal, bubblewrap belum terinstal di Linux, akses ditolak berdasarkan negara saat masuk, verifikasi nomor telepon diperlukan, atau batas penggunaan habis tanpa diduga.

</div>

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Poin utama">

Poin utama

Instal program dan buka proyek, lalu periksa `/status` dan `/permissions` sebelum memberikan tugas. Pilih dan verifikasi akses hanya-baca jika tugas pertama hanya menjelaskan file. Mode Auto dapat mengedit folder kerja tanpa meminta izin untuk setiap perubahan; jangan menyimpulkan perlindungan hanya-baca dari prompt yang terdengar aman atau ketiadaan Git. Selanjutnya, tambahkan AGENTS.md berisi tiga aturan dan bandingkan responsnya.

</div>

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.

<div class="section" role="doc-bibliography" aria-label="Sumber">

### Sumber

- [Codex CLI: instalasi dan penggunaan pertama](https://learn.chatgpt.com/docs/codex/cli) - dokumentasi resmi OpenAI
- [Ekstensi editor Codex](https://learn.chatgpt.com/docs/codex/ide) - daftar editor yang didukung
- [Codex cloud](https://learn.chatgpt.com/docs/cloud) - tugas dalam lingkungan terisolasi
- [Model Codex](https://learn.chatgpt.com/docs/models) - GPT-5.6 Sol, Terra, Luna, dan tanggal penghentian model lama
- [Paket dan batas Codex](https://learn.chatgpt.com/docs/pricing) - harga paket dan jumlah pesan yang tersedia setiap lima jam
- [Metode masuk](https://learn.chatgpt.com/docs/auth) - akun ChatGPT dan kunci API
- [Sandbox dan persetujuan](https://learn.chatgpt.com/docs/sandboxing) - mode akses, bubblewrap di Linux
- [Izin agen dan keamanan](https://learn.chatgpt.com/docs/agent-approvals-security) - jalur yang dilindungi, flag berbahaya, saran default
- [Mode izin](https://learn.chatgpt.com/docs/permission-modes) - Ask for approval, Approve for me, Full access
- [AGENTS.md](https://learn.chatgpt.com/docs/agent-configuration/agents-md) - cara agen membaca aturan proyek
- [Negara dan wilayah yang didukung](https://developers.openai.com/api/docs/supported-countries) - daftar resmi OpenAI
- [Model OpenAI yang dihentikan](https://developers.openai.com/api/docs/deprecations) - tanggal Codex lama dihentikan
- [Repositori openai/codex](https://github.com/openai/codex) - kode sumber terbuka, laporan pengguna, rilis
- [Paket @openai/codex di registri npm](https://registry.npmjs.org/@openai/codex) - versi dan tanggal publikasi
- [Rilis Codex di GitHub](https://github.com/openai/codex/releases) - nomor versi dan tanggal rilis


</div>

Temukan materi tambahan tentang penggunaan alat di [dokumentasi Ailoot](https://ailoot.ai/docs/).



<div class="aside" data-semantic="ailoot-cta" role="note" aria-label="Panduan Ailoot">

[Panduan Ailoot](https://ailoot.ai/docs/)

</div>

<div class="aside" data-semantic="ailoot-cta" role="note" aria-label="Kunjungi Ailoot">

[Kunjungi Ailoot](https://ailoot.ai/)

</div>

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

### Apakah Codex meminta izin sebelum setiap perubahan file?

Tidak. Dalam alur Auto yang dijelaskan di sini, edit yang diizinkan dalam folder kerja dapat berjalan tanpa persetujuan individual. Periksa /status dan /permissions sebelum tugas pertama, dan pilih akses hanya-baca secara eksplisit ketika hanya menginginkan penjelasan.

### Mengapa instalasi berhasil tetapi masuk akun gagal dengan kesalahan wilayah?

Instalasi CLI dan memperoleh akses model adalah langkah terpisah. Kesalahan 403 dengan unsupported_country_region_territory menyangkut akses akun, bukan Node atau installer; bandingkan wilayah akun dengan informasi negara yang didukung OpenAI.


## Ailoot · Perusahaan dan portofolio proyeknya

Ailoot bertumpu pada pengalaman operasional yang teruji, basis pelanggan yang besar, layanan yang stabil, dan pemantauan KPI berkelanjutan.

Perusahaan dan portofolio proyeknya: jutaan pelanggan; penjualan miliaran setiap bulan.

Ailoot memanfaatkan pengalaman operasional ini untuk akses API ke fitur AI dalam produk pelanggan, agen, aplikasi, dan otomatisasi.
