OpenAI Codex: Panduan Langkah demi Langkah dengan 3 Contoh Praktis

Ringkasnya

• OpenAI Codex adalah agen rekayasa perangkat lunak berbasis cloud yang tersedia di dalam ChatGPT (paket Plus, Pro, Team, dan Enterprise)

• Hubungkan Codex ke repo GitHub, lalu tugaskan pekerjaan: memperbaiki bug, menerapkan patch, menghasilkan pengujian, atau menjelaskan kode

• Setiap tugas berjalan di sandbox terisolasi; Codex membuka pull request untuk Anda tinjau sebelum digabungkan

• Gunakan file AGENTS.md untuk mendefinisikan konvensi pengodean yang akan diikuti Codex pada setiap tugas

• Codex juga dapat dijalankan di terminal melalui Codex CLI dan sebagai ekstensi VS Code

Apa itu Codex dari OpenAI?

OpenAI Codex adalah agen rekayasa perangkat lunak berbasis cloud yang dapat menulis dan mengedit kode, menjalankan pengujian, memperbaiki bug, dan bahkan mengajukan pull request. Setiap tugas dieksekusi dalam lingkungan ter-sandbox tersendiri.

Codex didukung oleh model frontier terbaru dari OpenAI, dan dibangun dengan memperhatikan aspek keselamatan, keterujian, dan produktivitas pengembang. Anda dapat membimbing Codex menggunakan file AGENTS.md atau berinteraksi langsung di sidebar ChatGPT.

Dengan Codex CLI, Anda juga dapat membawa kapabilitas ini langsung ke terminal Anda.

Pilihan akses Codex sekilas:

Menyiapkan Codex dari OpenAI

Menyiapkan Codex hanya memerlukan beberapa menit. Berikut panduan langkah demi langkah untuk memulai.

Langkah 1: Menemukan alat Codex

Mulailah dengan masuk ke ChatGPT. Di bilah alat sebelah kiri, cari Codex. Saat peluncuran, Codex diluncurkan untuk pengguna ChatGPT Pro, Business, dan Enterprise. Sekarang sudah termasuk di semua paket (meski akses Free dan Go sangat terbatas).

Langkah 2: Memulai dengan Codex

Klik Codex, dan Anda akan diarahkan ke tab lain untuk penyiapan awal. Klik “Get Started” dan ikuti prosedur autentikasi seperti pada langkah berikutnya.

Langkah 3: Autentikasi multi-faktor

Klik “Set up MFA to continue” dan pindai kode QR menggunakan aplikasi autentikasi favorit Anda (seperti Google Authenticator atau Authy). Masukkan kodenya untuk verifikasi dan selesai!

Langkah 4: Sambungkan ke GitHub

Setelah autentikasi multi-faktor selesai, kita menyambungkan Codex ke GitHub.

Langkah 4.1: Otorisasi konektor GitHub

“Connect to GitHub” akan menampilkan pop-up untuk mengotorisasi konektor GitHub. Baca pop-up tersebut dan lakukan Authorize.

Langkah 4.2: Menambahkan akun GitHub Anda

Setelah GitHub tersambung, kita perlu menambahkan akun kita. Di tab organisasi GitHub, pilih “Add a GitHub account.” 

Ini akan membuka pop-up lain “Install and Authorize.” Klik untuk mengotorisasi, dan semua repositori Anda akan muncul di antarmuka ChatGPT. Anda juga bisa mengotorisasi hanya repositori tertentu.

Langkah 4.3: Membuat environment

Pilih repositori yang ingin Anda kerjakan dan klik “Create environment.”

Anda akan diarahkan ke “Data Controls.” Codex masih dalam pengembangan aktif, dan Anda mungkin melihat prompt opsional untuk mengizinkan data Anda digunakan untuk peningkatan model. Anda dapat mematikannya dan lanjutkan.

Sekarang environment Anda siap dieksplorasi. Codex memungkinkan pengguna untuk memulai tugas secara paralel dengan tugas yang sudah dipilih.

Cukup klik “Start tasks” atau pilih tugas sesuai kebutuhan Anda. Ini akan membawa Anda ke antarmuka tempat Anda dapat mengajukan pertanyaan atau meminta agen untuk membuatkan fitur.

Setelah semua tugas siap, pilih tugas yang ingin Anda kerjakan, atau kerjakan beberapa tugas secara paralel.

Langkah 5: file AGENTS.md (opsional)

File AGENTS.md adalah file konfigurasi khusus yang diperkenalkan oleh OpenAI untuk digunakan dengan platform Codex, yang dirancang untuk membantu membimbing agen AI saat bekerja di dalam codebase Anda. Anda dapat menganggapnya sebagai manual pengembang untuk rekan AI, mirip dengan README.md, tetapi berfokus pada instruksi untuk agen otonom. Berikut contoh file AGENTS.md:

# AGENTS.md

## Code Style
- Use Black for Python formatting.
- Avoid abbreviations in variable names.

## Testing
- Run pytest tests/ before finalizing a PR.
- All commits must pass lint checks via flake8.

## PR Instructions
- Title format: [Fix] Short description
- Include a one-line summary and a "Testing Done" section

Saat Codex menjalankan sebuah tugas pada codebase Anda, ia akan:

• Mencari file AGENTS.md yang cakupannya meliputi file yang sedang diubah.
• Menerapkan instruksi dalam file tersebut untuk memformat, menguji, dan mendokumentasikan perubahannya.
• Memprioritaskan instruksi yang lebih dalam tingkatannya saat beberapa file berlaku (seperti konfigurasi bertingkat).

Untuk gambaran lebih luas tentang membangun sistem yang dapat bertindak lintas alat dan API, lihat tutorial OpenAI Agents SDK kami.

Codex dari OpenAI: Tiga Contoh Praktis

Mari kita jelajahi bagaimana Codex dapat membantu Anda dalam pengembangan dunia nyata melalui tiga contoh yang saya jalankan pada sebuah repositori.

Contoh 1: Perbaikan dasar dan typo

Codex terkadang memecah satu permintaan menjadi sub-tugas, seperti memperbaiki typo, meningkatkan README, atau menulis pengujian, semuanya dalam workspace yang sama.

Anda dapat memulai tugas baru di dalam tugas yang sudah ada berdasarkan tinjauan awal, meminta perubahan pada codebase yang ada, atau mengajukan pertanyaan melalui kotak teks. Untuk memperluas tugas atau memperbaiki hal baru, klik “Code” dan mulai sub-tugas baru secara langsung.

Setelah puas dengan perubahan, klik “Push,” yang akan membuat pull request baru. Setelah beberapa detik, Anda dapat klik “View Pull Request” untuk membuka pull request dan menggabungkannya ke main.

Contoh 2: Penjelasan codebase

Selanjutnya, saya menggunakan Codex untuk tugas non-editing: menjelajahi codebase dan menanyakan apa yang bisa saya lakukan berikutnya. Ini sangat berguna jika Anda baru pada sebuah proyek, ingin onboarding dengan cepat, atau sedang buntu memahami cara kerja suatu fungsi.

Codex menavigasi proyek dan memberikan uraian struktur codebase yang rapi dan ramah pemula. Alih-alih hanya membuat daftar file, Codex mengelompokkannya berdasarkan tujuan:

• Menyoroti bahwa qwen3_demo.py adalah skrip utama, meluncurkan dua antarmuka berbasis Gradio—satu untuk pengalihan mode penalaran dan satu lagi untuk penerjemahan multibahasa.
• Mengidentifikasi qwen3_demo.ipynb sebagai alternatif notebook interaktif.
• Menunjukkan test_qwen3_demo.py untuk pengujian unit dan README.md untuk dokumentasi dan video walkthrough.

Selain itu, Codex juga mencantumkan “Poin Penting yang Perlu Diketahui,” seperti dependensi (Ollama CLI), peran fungsi _run_ollama, dan kiat memperluas antarmuka. Ia bahkan menyarankan langkah berikutnya, seperti mengeksplorasi versi model, meningkatkan UI, dan menambahkan penanganan error.

Contoh 3: Menemukan dan memperbaiki bug

Codex dapat memindai seluruh codebase, mengidentifikasi bug, mengusulkan perbaikan, dan menampilkan pratinjau perubahan. Proses ini mirip dengan tinjauan perubahan kode di GitHub.

Anda dapat meninjau log untuk memahami proses latar belakang dari perubahan yang dibuat dengan mengeklik “Logs.”

Codex mengembalikan ringkasan perubahan yang dibuat, beserta file yang dibuat atau terpengaruh oleh perubahan tersebut. Anda juga dapat mengajukan pertanyaan tentang perubahan atau meminta Codex menulis kode baru untuk menyempurnakan implementasi saat ini.

Setelah puas dengan perbaikan kode, klik “Push” dan “Create New PR” untuk membuka pull request baru.

Setelah beberapa detik, Anda dapat klik “View Pull Request” untuk membuka pull request dan menggabungkannya ke main.

Codex memungkinkan Anda menggabungkan perubahan hanya dengan beberapa klik.

Perubahan muncul pada branch main dalam hitungan detik.

Mengapa Codex Penting?

Codex adalah agen kolaboratif, bukan generator kode pasif. Anda dapat memintanya untuk menulis, merapikan, menguji, men-debug, atau menjelaskan, dan ia akan menampilkan log terminal, sitasi, serta output untuk setiap langkah.

Berikut beberapa manfaat nyata yang saya amati:

• Tugas dapat ditelusuri dan diverifikasi.
• Codex bekerja secara paralel, sehingga Anda dapat mengantrikan banyak perubahan.
• Ia menghormati pengaturan pengembangan Anda, terutama jika Anda telah mengonfigurasi konvensi melalui file AGENTS.md.
• Sejalan dengan standar PR manusia dan dapat lulus pengujian CI.

Bagi saya, rasanya seperti OpenAI baru saja merilis seorang intern rekayasa perangkat lunak.

Penutup

Kita mempelajari bagaimana Codex dapat memperbaiki bug, menerapkan patch fitur, dan menjelaskan logika kode, sambil menghasilkan pull request, menjalankan pengujian, dan menyitir tindakannya melalui log terminal dan diff.

Panduan langsung ini menggambarkan bagaimana Codex dapat meningkatkan alur kerja pengembang harian Anda, baik saat men-debug kode legacy, onboarding ke repo baru, maupun memilah tugas pemeliharaan.

Seiring perkembangan Codex, saya memperkirakan integrasi yang lebih dalam dengan IDE, pipeline CI, dan perencana tugas, menjadikannya tambahan praktis untuk alur kerja rekayasa mana pun. Untuk mempelajari lebih lanjut tentang Codex, bacalah blog rilis resmi, dan Anda juga dapat menemukan contoh kasus penggunaan di channel YouTube OpenAI.

Untuk mendalami model dan alat OpenAI yang berfokus pada rekayasa, saya merekomendasikan blog berikut:

• Tutorial OpenAI Codex CLI
• Panduan GPT-5.1 Codex: Membangun Agen Penganalisis Isu GitHub
• Codex CLI untuk Otomasi Alur Kerja Data: Panduan Lengkap
• Tutorial Codex CLI MCP: Membangun Agen Dasbor Portofolio