Ilustrasi laptop dengan terminal dan panel tugas asisten AI
Ilustrasi konsep penggunaan AI agent melalui terminal, bukan screenshot aplikasi.

Istilah AI agent digunakan untuk berbagai alat. Ada yang berjalan sebagai aplikasi desktop, ada yang dipasang sebagai ekstensi editor, dan ada yang digunakan melalui terminal. Karena itu, cara install AI agent selalu bergantung pada produk yang dipilih.

Dalam panduan ini, contoh yang digunakan adalah Gemini CLI, sebuah asisten AI berbasis terminal yang dapat membantu pekerjaan pengembangan. Langkahnya cocok sebagai latihan awal di PC atau laptop. Ini bukan panduan memasang model AI sepenuhnya offline; penggunaan layanan membutuhkan koneksi dan autentikasi.

1. Periksa kebutuhan sebelum memasang

Periksa persyaratan terbaru pada dokumentasi instalasi Gemini CLI. Dokumentasi yang diperiksa untuk artikel ini menyebut Node.js 20 atau lebih baru, dengan Bash, Zsh, atau PowerShell sebagai pilihan shell.

Siapkan koneksi internet dan folder latihan yang terpisah dari proyek penting. Untuk tahap pertama, jangan menggunakan folder yang berisi data pribadi, kredensial, atau dokumen klien.

2. Siapkan Node.js dan npm

Jika belum terpasang, unduh Node.js melalui situs resmi Node.js dan pilih versi LTS yang masih didukung serta memenuhi persyaratan alat. Ikuti installer sesuai sistem operasi, kemudian buka ulang terminal.

Di macOS gunakan Terminal; di Windows gunakan PowerShell. Periksa apakah dua perintah berikut menampilkan nomor versi:

node --version
npm --version

Jika perintah belum dikenali, pastikan instalasi selesai dan sesi terminal sudah dibuka ulang. Jangan langsung mengubah banyak pengaturan sistem. Periksa lebih dahulu apakah executable Node.js dapat ditemukan oleh shell.

3. Pasang Gemini CLI

Jalankan perintah instalasi berikut:

npm install -g @google/gemini-cli

Tunggu proses selesai. Opsi -g memasang tool agar perintahnya dapat digunakan dari terminal. Jika muncul masalah izin, gunakan panduan instalasi untuk konfigurasi Node.js Anda; jangan menambahkan izin administrator tanpa memahami penyebabnya.

4. Mulai dari folder latihan dan login

Buat folder baru, masuk ke dalamnya, kemudian jalankan Gemini CLI:

mkdir latihan-ai-agent
cd latihan-ai-agent
gemini

Pilih metode masuk yang sesuai. Untuk banyak pengguna individual, opsi Sign in with Google merupakan cara awal yang paling sederhana. Ikuti proses autentikasi di browser. Akun organisasi dapat memerlukan konfigurasi tambahan; rujuk dokumentasi autentikasi bila diminta proyek Google Cloud.

Perhatikan akun yang digunakan, batas pemakaian, serta ketentuan layanan. Memasang tool tidak berarti seluruh pemakaian model bebas batas atau selalu tanpa biaya. Jangan membagikan API key atau menyimpannya di kode yang dipublikasikan.

5. Coba tugas kecil yang mudah diperiksa

Mulai dengan permintaan yang terbatas, misalnya:

Buat satu file index.html untuk halaman latihan berisi judul, satu paragraf, dan tombol. Jangan mengakses folder lain atau menjalankan perintah tambahan sebelum menjelaskan kebutuhannya.

Baca rencana dan permintaan izin yang muncul. Setelah file dibuat, buka dan periksa isinya sebelum menjalankan atau mengunggahnya. Latihan ini membantu Anda memahami hubungan antara instruksi, tindakan alat, dan hasil yang dihasilkan.

Jika hasil belum sesuai, sebutkan perubahan yang spesifik: teks mana yang harus diganti, tombol harus melakukan apa, atau bagian mana yang terlalu lebar. Instruksi yang dapat diperiksa biasanya lebih berguna daripada permintaan umum seperti “buat lebih bagus”.

6. Biasakan alur kerja yang dapat ditinjau

Sebelum memakai agent pada proyek utama, siapkan cadangan atau version control. Batasi folder kerja, tinjau perubahan, dan baca perintah yang akan dijalankan. Hasil AI tetap perlu diperiksa, terutama ketika berkaitan dengan penghapusan file, publikasi, konfigurasi server, atau data pengguna.

Mulai dari tugas membaca dan menjelaskan kode. Setelah nyaman dengan alurnya, lanjutkan ke perubahan kecil. Dengan pendekatan ini, Anda dapat menilai manfaat alat tanpa menyerahkan seluruh proyek dalam satu langkah.

Masalah yang sering muncul

  • Perintah gemini tidak ditemukan: buka terminal baru dan periksa kembali hasil instalasi npm serta PATH.
  • Login gagal: pastikan jaringan tersedia dan akun memenuhi ketentuan layanan.
  • Versi runtime tidak sesuai: cocokkan Node.js dengan persyaratan dokumentasi terbaru.
  • Hasil tidak sesuai: perkecil tugas, sertakan konteks, lalu minta penjelasan perubahan sebelum menerapkannya.

Setelah instalasi berhasil, tujuan berikutnya adalah membangun kebiasaan kerja yang jelas. Agent akan lebih membantu ketika instruksi, batas akses, dan kriteria hasil sudah Anda tentukan.

Referensi resmi

Diperiksa pada 17 Oktober 2026. Persyaratan, antarmuka, dan ketentuan layanan dapat berubah.