Cara Menggunakan Google Gemini 2.5 Pro dengan Open Codex CLI (Open Codex CLI)

Open Codex CLI adalah alat sumber terbuka yang membawa kekuatan model bahasa besar (LLM) langsung ke dalam alur kerja terminal Anda. Panduan ini secara khusus berfokus pada memanfaatkan salah satu model paling canggih yang tersedia saat ini – Google's Gemini 2.5 Pro – dalam lingkungan Open Codex CLI.

Open Codex CLI adalah fork dari OpenAI Codex CLI yang asli, mempertahankan fungsionalitas inti tetapi secara signifikan memperluas kemampuannya dengan menambahkan dukungan untuk beberapa penyedia AI, termasuk Google Gemini. Ini memungkinkan pengembang untuk memilih model terbaik untuk tugas mereka sambil tetap berada dalam antarmuka terminal yang mereka kenal. Bayangkan menanyakan pertanyaan pengkodean yang kompleks, menghasilkan kode boilerplate, merombak fungsi yang ada, menjelaskan skrip yang rumit, atau bahkan mengatur perintah build, semuanya didorong oleh kecerdasan Gemini tanpa meninggalkan baris perintah Anda.

Artikel ini memberikan panduan komprehensif, langkah-demi-langkah tentang cara menginstal, mengonfigurasi, dan menggunakan Open Codex CLI secara khusus dengan Google Gemini 2.5 Pro (merujuk pada versi model gemini-2.5-pro-preview-03-25 yang tersedia pada saat penulisan, seperti yang ditentukan dalam konfigurasi Open Codex CLI) dan model-model saudaranya seperti gemini-2.0-flash. Apakah Anda seorang pengembang berpengalaman yang ingin mengoptimalkan alur kerja Anda atau baru mengenal asisten pengkodean AI, Anda akan belajar cara memanfaatkan kombinasi yang kuat ini.

Mengapa Open Codex CLI dengan Gemini?

Ini gila. Dalam beberapa jam, teman saya fork Open AI Codex untuk bekerja dengan Gemini 2.5 Pro 🤯 pic.twitter.com/gENT01q82P

— Sawyer Hood (@sawyerhood) April 17, 2025

Menggabungkan Open Codex CLI dengan Gemini 2.5 Pro menawarkan serangkaian manfaat yang menarik:

• Alur Kerja Native Terminal: Bagi pengembang yang lebih suka baris perintah, Open Codex CLI memberikan integrasi yang mulus. Tidak perlu beralih konteks antara editor, terminal, dan jendela browser terpisah untuk bantuan AI. Ini mengarah pada iterasi yang lebih cepat dan gangguan yang lebih sedikit.
• Sumber Terbuka dan Fleksibel: Menjadi sumber terbuka (open-codex di npm), alat ini menawarkan transparansi dan potensi kontribusi dari komunitas. Dukungan multi-penyedia (Gemini, OpenAI, OpenRouter, Ollama) memberikan Anda fleksibilitas untuk beralih model atau penyedia sesuai kebutuhan tanpa mengubah alat inti Anda.
• Kemampuan AI yang Kuat: Gemini 2.5 Pro membawa kemampuan penalaran, pembuatan kode, dan pemahaman mutakhir. Ini memungkinkan tugas yang lebih kompleks, saran kualitas kode yang lebih baik, dan analisis yang lebih mendalam langsung di dalam CLI.
• Berorientasi Tindakan: Berbeda dengan chatbot sederhana, Open Codex CLI dirancang untuk tindakan. Ia dapat membaca file lokal Anda untuk konteks, mengusulkan modifikasi file (patch), dan menjalankan perintah shell dalam sandbox yang aman, memungkinkan pengembangan yang benar-benar didorong oleh percakapan.
• Fokus pada Keamanan: CLI menggabungkan mekanisme sandboxing (Apple Seatbelt di macOS, Docker direkomendasikan di Linux) untuk menjalankan operasi yang berpotensi berisiko seperti perintah shell dengan aman, terutama saat menggunakan mode persetujuan otomatis. Ia menjalankan perintah dalam keadaan non-jaringan dan terkurung di direktori secara default dalam mode otonomi yang lebih tinggi.
• Integrasi Kontrol Versi: Alat ini dirancang untuk bekerja bersama Git. Secara default, ia memerlukan persetujuan sebelum memodifikasi file, memungkinkan Anda untuk meninjau perubahan sebelum memengaruhi direktori kerja Anda, memastikan Anda selalu memiliki jaring pengaman.

Prasyarat

Sebelum Anda mulai, pastikan Anda memiliki hal-hal berikut:

1. Sistem Operasi: macOS 12 atau lebih baru, distribusi Linux modern (seperti Ubuntu 20.04+, Debian 10+), atau Windows 10/11 menggunakan Windows Subsystem for Linux (WSL2). Dukungan langsung untuk Windows tidak tersedia.
2. Node.js: Versi 22 atau lebih baru diperlukan. Versi LTS (Long-Term Support) umumnya direkomendasikan. Anda dapat memeriksa versi Anda dengan menjalankan node -v di terminal Anda. Unduh Node.js dari nodejs.org.
3. Akun Google Cloud & Kunci API Gemini: Anda akan memerlukan kunci API untuk mengautentikasi permintaan ke model Gemini. Anda dapat memperoleh satu melalui Google AI Studio atau Google Cloud Console. Simpan kunci ini dengan aman, karena terkait dengan akun Anda.
4. Kemampuan Terminal: Pengetahuan dasar tentang penggunaan antarmuka baris perintah sistem Anda (Terminal, iTerm, Bash, Zsh, dll.) diasumsikan.

Langkah 1: Menginstal Open Codex CLI

Cara yang direkomendasikan untuk menginstal Open Codex CLI adalah secara global melalui npm (Node Package Manager), yang disertakan dengan Node.js. Buka terminal Anda dan jalankan:

npm install -g open-codex

Atau, jika Anda menggunakan Yarn sebagai pengelola paket Anda, Anda dapat menjalankan:

yarn global add open-codex

Perintah ini mengunduh paket open-codex dan membuat perintah open-codex dapat diakses dari mana saja di terminal Anda. Hindari menggunakan sudo untuk instalasi npm global; jika Anda mengalami masalah izin, lebih baik untuk memperbaiki izin npm.

Anda dapat memverifikasi instalasi dengan menjalankan open-codex --version atau open-codex --help.

Langkah 2: Mengonfigurasi Akses Gemini

Untuk menggunakan model Gemini, Open Codex CLI memerlukan kunci API Anda dan perlu tahu bahwa Anda ingin menggunakan penyedia gemini. Ada dua cara utama untuk mengonfigurasi ini:

Metode 1: Variabel Lingkungan (Direkomendasikan untuk Memulai Cepat/Pengujian)

Cara termudah untuk menyediakan kunci API Anda adalah melalui variabel lingkungan. Open Codex CLI secara khusus mencari GOOGLE_GENERATIVE_AI_API_KEY ketika penyedia gemini dipilih.

Di terminal Anda, jalankan perintah berikut, mengganti "YOUR_API_KEY_HERE" dengan kunci API Gemini Anda yang sebenarnya:

export GOOGLE_GENERATIVE_AI_API_KEY="YOUR_API_KEY_HERE"

Penting: Perintah ini mengatur variabel lingkungan hanya untuk sesi terminal saat ini. Jika Anda menutup terminal atau membuka yang baru, Anda perlu menjalankan perintah ini lagi.

Untuk membuat kunci API tersedia secara permanen, Anda perlu menambahkan baris export ke file konfigurasi shell Anda. File yang umum meliputi:

• ~/.zshrc (untuk Zsh, default di macOS terbaru)
• ~/.bashrc atau ~/.bash_profile (untuk Bash)

Tambahkan baris export GOOGLE_GENERATIVE_AI_API_KEY="YOUR_API_KEY_HERE" ke file yang sesuai, simpan, dan kemudian baik restart terminal Anda atau jalankan source ~/.zshrc (atau jalur file yang relevan) untuk menerapkan perubahan.

Anda kemudian dapat menentukan Gemini sebagai penyedia pada setiap pemanggilan menggunakan flag --provider:

open-codex --provider gemini "Apa ibukota Prancis?"

Metode 2: File Konfigurasi (Direkomendasikan untuk Pengaturan Permanen)

Untuk pengaturan yang lebih permanen, terutama jika Anda berencana untuk menggunakan Gemini secara konsisten, Anda dapat menggunakan file konfigurasi Open Codex CLI. CLI mencari file konfigurasi di ~/.codex/config.json.

Buat direktori jika belum ada: mkdir -p ~/.codex

Buat dan buka file konfigurasi: nano ~/.codex/config.json (atau gunakan editor teks pilihan Anda).

Tambahkan konten JSON berikut untuk menentukan Gemini sebagai penyedia default:

{
  "provider": "gemini"
}

Anda juga dapat secara opsional mengatur model Gemini default. Open Codex CLI mendefinisikan gemini-2.5-pro-preview-03-25 sebagai model "agentic" default dan gemini-2.0-flash sebagai model "konteks penuh" default untuk Gemini. Untuk secara eksplisit mengatur model 2.5 Pro yang kuat sebagai default untuk sebagian besar interaksi, gunakan:

{
  "provider": "gemini",
  "model": "gemini-2.5-pro-preview-03-25"
}

Simpan file dan keluar dari editor.

Penting, bahkan saat menggunakan file konfigurasi untuk mengatur penyedia dan model, Anda masih perlu mengatur variabel lingkungan GOOGLE_GENERATIVE_AI_API_KEY seperti yang dijelaskan dalam Metode 1. File konfigurasi memberi tahu CLI penyedia mana yang akan digunakan, sementara variabel lingkungan menyediakan kredensial untuk penyedia tersebut.

Dengan file konfigurasi yang diatur, Anda sekarang dapat cukup menjalankan open-codex dan itu akan default menggunakan penyedia Gemini yang ditentukan:

open-codex "Apa ibukota Prancis?"

Langkah 3: Penggunaan Dasar dengan Gemini

Sekarang Open Codex CLI terinstal dan dikonfigurasi untuk Gemini, mari kita jelajahi bagaimana cara berinteraksi dengannya.

Mode Interaktif (REPL)

Untuk pengalaman seperti obrolan, jalankan CLI tanpa prompt tertentu:

open-codex
# Atau jika Anda belum mengatur penyedia default di config.json:
# open-codex --provider gemini

Ini memulai Read-Eval-Print Loop (REPL) di mana Anda dapat mengetik prompt, mendapatkan respons, dan memiliki percakapan yang berkelanjutan dengan Gemini.

❯ open-codex --provider gemini
Selamat datang di Open Codex CLI! Ketik permintaan Anda, lalu tekan Enter dua kali untuk mengirim.
> Ceritakan tentang model Gemini 2.5 Pro.

Tekan Enter dua kali untuk mengirim prompt. Gemini akan merespons di dalam terminal. Anda dapat melanjutkan percakapan dengan mengetik pertanyaan lanjutan.

Prompt Langsung

Untuk permintaan sekali jalan, Anda dapat melewatkan prompt langsung sebagai argumen. Jika Anda belum mengatur default di config.json, Anda akan memerlukan flag penyedia. Anda juga dapat menentukan model yang tepat menggunakan flag --model atau -m:

• Menggunakan model Gemini default (jika diatur di config):

open-codex "Jelaskan konsep closures di Python."

• Menentukan penyedia dan model secara eksplisit:

open-codex --provider gemini --model gemini-2.5-pro-preview-03-25 "Tulis skrip bash untuk menemukan semua file yang lebih besar dari 10MB di direktori saat ini dan subdirektorinya."

• Menggunakan model Gemini yang berbeda (misalnya, Flash untuk tugas yang lebih cepat/lebih murah):

open-codex --provider gemini --model gemini-2.0-flash "Ringkas poin-poin utama dari dokumentasi React tentang hooks."

CLI akan memproses permintaan dengan Gemini dan mencetak respons langsung ke output standar.

Langkah 4: Memanfaatkan Fitur Open Codex dengan Gemini

Kekuatan sejati Open Codex CLI terletak pada kemampuannya untuk berinteraksi dengan lingkungan pengembangan lokal Anda, dipandu oleh Gemini.

Interaksi Sistem Berkas

Gemini, melalui Open Codex CLI, dapat membaca file dalam proyek Anda saat ini untuk mendapatkan konteks untuk permintaan Anda. Ia juga dapat mengusulkan perubahan (tulisan atau patch) pada file Anda.

• Reading Files: Ketika Anda menyebutkan nama file dalam prompt Anda, CLI sering kali secara otomatis membacanya untuk memberikan konteks kepada Gemini.

# Asumsikan Anda memiliki file bernama 'calculate.js'
open-codex --provider gemini "Baca 'calculate.js' dan usulkan perbaikan untuk keterbacaan."

• Menulis/Mempatch File: Jika Anda meminta Gemini untuk memodifikasi sebuah file, CLI akan menghasilkan diff (ringkasan perubahan yang diusulkan) dan meminta persetujuan Anda sebelum menerapkan apa pun.

open-codex --provider gemini "Tambahkan fungsi baru bernama 'subtract' ke 'calculate.js' yang mengambil dua argumen dan mengembalikan selisihnya."

CLI akan mengeluarkan perubahan yang diusulkan dan meminta: Apply patch? [y/N]. Tekan y untuk menerima atau n untuk menolak.

Eksekusi Perintah

Open Codex CLI juga dapat mengeksekusi perintah shell yang diusulkan oleh Gemini. Ini kuat tetapi memerlukan kehati-hatian.

• Mode Persetujuan: Flag --approval-mode (atau -a) mengontrol tingkat otonomi:
• suggest (default): Memerlukan persetujuan eksplisit untuk semua perubahan file dan semua perintah shell. Direkomendasikan untuk memulai.
• auto-edit: Secara otomatis menerapkan perubahan file tetapi masih meminta persetujuan untuk perintah shell.
• full-auto: Secara otomatis menerapkan perubahan file DAN mengeksekusi perintah shell (dalam sandbox). Gunakan dengan sangat hati-hati, terutama di repositori yang tidak tepercaya.
• Sandboxing: Dalam mode auto-edit dan full-auto, perintah dijalankan dalam keadaan non-jaringan dan dibatasi ke direktori kerja saat ini dan file sementara untuk keamanan.
• Contoh (dengan mode 'suggest' default):

open-codex --provider gemini "Instal pustaka 'requests' menggunakan pip."

Gemini mungkin mengusulkan perintah pip install requests. CLI akan menunjukkan perintah dan bertanya: Jalankan perintah? [y/N].

Konteks Proyek (codex.md)

Anda dapat memberikan instruksi atau konteks yang persisten tentang proyek Anda kepada Gemini dengan membuat file codex.md. CLI membaca file-file ini dalam urutan:

1. ~/.codex/instructions.md (Instruksi pribadi global)
2. codex.md di akar repositori Anda (Catatan proyek secara keseluruhan)
3. codex.md di direktori kerja saat ini (Catatan spesifik subdirektori)

Ini memungkinkan Anda untuk membimbing perilaku Gemini atau memberikan informasi tentang standar proyek, pustaka yang digunakan, dll., tanpa mengulanginya di setiap prompt.

Pemecahan Masalah & Tips

• Kesalahan Kunci API: Pastikan GOOGLE_GENERATIVE_AI_API_KEY diatur dengan benar, diekspor, dan dapat diakses dalam sesi terminal Anda saat ini. Periksa kembali kesalahan ketik.
• Model Tidak Ditemukan: Verifikasi nama model (gemini-2.5-pro-preview-03-25, gemini-2.0-flash, dll.) cocok dengan yang didukung atau dikonfigurasi. Periksa ~/.codex/config.json atau gunakan flag --model dengan benar.
• Kesalahan Penyedia: Pastikan penyedia diatur ke gemini baik melalui config.json atau flag --provider gemini.
• Logging Verbose: Untuk debugging, jalankan perintah dengan variabel lingkungan DEBUG=true diawali: DEBUG=true open-codex --provider gemini "Prompt saya". Ini akan mencetak informasi permintaan/respons yang terperinci.
• Mulai Sederhana: Mulailah dengan prompt sederhana dan secara bertahap tingkatkan kompleksitas saat Anda merasa nyaman dengan cara Gemini dan CLI berinteraksi.
• Tinjau Persetujuan dengan Cermat: Terutama saat berurusan dengan modifikasi file atau eksekusi perintah, selalu tinjau perubahan atau perintah yang diusulkan sebelum menyetujuinya (menjawab y).

Kesimpulan

Open Codex CLI, yang ditingkatkan oleh Gemini 2.5 Pro dari Google, mengubah terminal Anda menjadi asisten pengkodean yang cerdas. Dengan mengikuti langkah-langkah yang dijelaskan dalam panduan ini, Anda dapat mengintegrasikan kemampuan AI canggih ke dalam alur kerja pengembangan sehari-hari Anda, langsung dari baris perintah.

Dari cuplikan kode cepat dan penjelasan hingga perombakan kompleks dan eksekusi skrip, kombinasi ini menawarkan potensi signifikan untuk meningkatkan produktivitas dan menyederhanakan tugas. Fokus alat ini pada keamanan melalui sandboxing dan persetujuan pengguna, dikombinasikan dengan fleksibilitas dukungan multi-penyedia dan sifatnya yang sumber terbuka, menjadikan Open Codex CLI pilihan yang menarik bagi pengembang yang ingin memanfaatkan AI di dalam terminal mereka.

Cobalah berbagai prompt, jelajahi berbagai mode persetujuan (dengan hati-hati!), dan temukan bagaimana Gemini dan Open Codex CLI dapat meningkatkan pengalaman pengkodean Anda.