OpenAI Codex CLI - agen coding ringan yang berjalan di terminal

• OpenAI Codex adalah agen coding ringan yang berjalan di terminal, memungkinkan developer memanfaatkan penalaran setingkat ChatGPT beserta eksekusi kode, manipulasi file, dan fitur kontrol versi di lingkungan terminal
• Codex tidak memerlukan konfigurasi, dan berjalan dengan aman melalui jaringan yang dinonaktifkan serta sandbox direktori
• Mendukung kemampuan multimodal, sehingga fitur dapat diimplementasikan melalui screenshot atau diagram
• Codex bersifat sepenuhnya open source, memberi keuntungan karena developer dapat berkontribusi langsung dan mengembangkannya
• Dapat dijalankan di berbagai sistem operasi, serta mendukung macOS, Linux, dan Windows WSL2

---

Pengenalan OpenAI Codex

• OpenAI Codex adalah agen coding ringan yang berjalan di terminal
• Developer dapat memanfaatkan penalaran setingkat ChatGPT serta eksekusi kode, manipulasi file, dan fitur kontrol versi di lingkungan terminal
• Tidak memerlukan konfigurasi, dan berjalan dengan aman melalui jaringan yang dinonaktifkan serta sandbox direktori
• Mendukung kemampuan multimodal, sehingga fitur dapat diimplementasikan melalui screenshot atau diagram
• Sepenuhnya open source, sehingga developer dapat berkontribusi langsung dan mengembangkannya

Model keamanan dan izin Codex

• Codex menyediakan flag --approval-mode untuk menentukan tingkat otonomi agen
• Dalam mode Suggest, hanya pembacaan file yang dimungkinkan, sedangkan semua penulisan/patch file dan perintah shell memerlukan persetujuan
• Dalam mode Auto Edit, pembacaan file dan penulisan patch dimungkinkan, tetapi perintah shell memerlukan persetujuan
• Dalam mode Full Auto, pembacaan/penulisan file dan eksekusi perintah shell dimungkinkan, dengan jaringan dinonaktifkan dan dibatasi pada direktori kerja saat ini

Detail sandboxing platform

• Di macOS 12+, perintah dibungkus menggunakan Apple Seatbelt
• Di Linux, Docker digunakan untuk menjalankan Codex di dalam image container minimal
• Kedua pendekatan ini bekerja secara transparan untuk penggunaan sehari-hari

Persyaratan sistem

• Sistem operasi: macOS 12+, Ubuntu 20.04+/Debian 10+, Windows 11 (WSL2)
• Node.js: 22 atau lebih baru (disarankan LTS)
• Git: 2.23+ (disarankan untuk fitur pembantu PR)
• RAM: minimal 4GB (disarankan 8GB)

Referensi CLI

• codex: menjalankan REPL interaktif
• codex "…": prompt awal untuk REPL interaktif
• codex -q "…": mode non-interaktif "senyap"
• Flag utama: --model/-m, --approval-mode/-a, --quiet/-q

Memori dan dokumentasi proyek

• Codex menggabungkan instruksi Markdown dalam urutan berikut: ~/.codex/instructions.md, codex.md (root repositori), codex.md (direktori kerja saat ini)
• Dapat dinonaktifkan dengan --no-project-doc atau CODEX_DISABLE_PROJECT_DOC=1

Mode non-interaktif / CI

• Codex dapat dijalankan secara headless di pipeline
• Kebisingan UI interaktif dapat dihilangkan dengan CODEX_QUIET_MODE=1

Resep

• codex "Refactor the Dashboard component to React Hooks": merombak class component dan menjalankan pengujian
• codex "Generate SQL migrations for adding a users table": menalar ORM, lalu membuat dan menjalankan file migrasi
• codex "Write unit tests for utils/date.ts": membuat dan menjalankan pengujian
• codex "Bulk‑rename *.jpeg → *.jpg with git mv": mengganti nama file dengan aman dan memperbarui penggunaannya
• codex "Explain what this regex does: ^(?=.*[A-Z]).{8,}$": menjelaskan regular expression
• codex "Carefully review this repo, and propose 3 high impact well-scoped PRs": mengusulkan PR yang berdampak tinggi
• codex "Look for vulnerabilities and create a security review report": menemukan dan menjelaskan bug keamanan

Instalasi

• Instalasi via npm (disarankan): npm install -g @openai/codex
• Build dari source: clone repositori lalu pindah ke paket CLI untuk memasang dependensi dan melakukan build

Konfigurasi

• Codex mencari file konfigurasi di ~/.codex/
• Dapat mendefinisikan instruksi kustom: ~/.codex/instructions.md

FAQ

• OpenAI merilis model bernama Codex pada tahun 2021, yaitu sistem AI yang menghasilkan kode dari prompt bahasa alami
• Codex selalu berjalan di dalam sandbox, dan jika ada usulan perintah atau perubahan file yang mencurigakan, masukkan n agar tidak memengaruhi working tree
• Di Windows, Codex tidak berjalan secara langsung dan memerlukan Windows Subsystem for Linux (WSL2)
• Model yang didukung: semua model yang tersedia melalui Responses API

Kontribusi

• Proyek ini sedang dikembangkan secara aktif, sehingga kodenya bisa berubah cukup signifikan
• Kontribusi disambut, dengan penekanan pada keandalan dan pemeliharaan jangka panjang
• Menyediakan panduan untuk workflow pengembangan, menulis perubahan kode berkualitas tinggi, membuka PR, proses review, nilai-nilai komunitas, dan cara mendapatkan bantuan

Lisensi

• Repositori ini berlisensi Apache-2.0

[GN⁺]

Komentar Hacker News

• Mencoba mendokumentasikan codebase berukuran menengah dengan membandingkan Codex o4-mini dan Claude Code

  • Claude Code menghasilkan dokumentasi yang sangat baik
  • Codex mengarang hal-hal yang tidak ada di kode dan menjelaskan arsitektur yang keliru
  • Masalah Codex tampaknya adalah kesulitan memuat konteks yang benar dan menjaga perhatian
  • Harapan terhadap model o3 dan o4-mini cukup tinggi, dan semoga hasil yang lebih baik muncul di pengujian lain

• Menempelkan seluruh atau sebagian repositori ke gemini, lalu menggunakan skrip yang dibuat untuk menerapkan perubahan pada kode

  • Sudah mencoba aider, copilot, continue, dan lainnya, tetapi masing-masing punya kekurangan

• Claude Code sangat bagus, dan ada pengalaman sebelumnya merasa kecewa dengan agen coding lain

  • Mendapatkan hasil positif saat memakai Claude Code, dan biaya $15 bisa terasa layak
  • Semoga persaingan menghasilkan hal yang baik

• Ada demo dan video pengenalan terkait, dan ini merupakan tanggapan langsung tentang Claude Code

  • Bukan open source, dan ada penyebutan terkait DMCA
  • Wawancara Claude Code akan segera dirilis, membahas pentingnya CLI agen kode
  • Sedang mencari kasus penggunaan dari power user Claude Code dan OAI Codex

• Saat ini performanya masih di bawah Claude Code, tetapi karena open source semoga bisa cepat membaik

• Codex tidak berjalan langsung di Windows dan memerlukan WSL2

  • Ada kecenderungan ruang lingkup pengembangan native di Windows makin menyempit

• Pengalaman awal menggunakan Codex tidak bagus

  • Model bawaan tidak berfungsi dan harus mengganti model
  • Sempat crash di awal karena error NodeJS
  • Setelah masalah awal teratasi, sedang membandingkannya dengan Claude Code

• Ada cara untuk mengatur kunci API OpenAI sebagai environment variable

  • Ada kekhawatiran bahwa utilitas 3rd party lain bisa mengakses kunci API tersebut

• Mendapatkan hasil yang baik dari Amazon Q developer CLI, dan diyakini menggunakan claude-3.7-sonnet