Halaman ini diterjemahkan oleh Cloud Translation API.

Penggunaan Gemini CLI secara langsung

1. Pengantar

Dalam codelab ini, Anda akan mempelajari Gemini CLI, agen AI open source yang menghadirkan kecanggihan Gemini langsung ke terminal Anda.

Project Gemini CLI bersifat open source dan Anda dapat melihat roadmap publik di sini.

Melalui codelab ini, Anda akan menggunakan pendekatan langkah demi langkah di seluruh aktivitas seperti:

Menginstal Gemini CLI
Konfigurasi dasar
Menjelajahi alat dan perintah bawaan di Gemini CLI
Menyesuaikan Gemini CLI melalui file GEMINI.md
Menjelajahi beberapa kasus penggunaan dengan Gemini CLI

Yang Anda butuhkan

Browser web Chrome
Akun Gmail
Komputer lokal dengan Node 20+ yang diinstal di komputer Anda.

Codelab ini dirancang untuk pengguna dan developer dari semua level (termasuk pemula).

2. Penginstalan

Sebelum menjalankan penyiapan dan menjalankan Gemini CLI, mari kita buat folder yang akan kita gunakan sebagai folder beranda untuk semua project yang mungkin kita buat di dalamnya. Ini adalah titik awal bagi Gemini CLI untuk bekerja, meskipun juga akan mereferensikan beberapa folder lain di sistem Anda dan yang akan kita bahas nanti, sesuai kebutuhan.

Lanjutkan dan buat folder contoh (gemini-cli-projects) lalu buka folder tersebut melalui perintah yang ditunjukkan di bawah. Jika Anda lebih suka menggunakan nama folder lain, silakan lakukan.

mkdir gemini-cli-projects

Mari kita buka folder tersebut:

cd gemini-cli-projects

Untuk menjalankan Gemini CLI, Anda dapat menggunakan salah satu metode berikut:

Jalankan dengan perintah berikut:

npx https://github.com/google-gemini/gemini-cli

Anda dapat menginstal Gemini CLI secara global di sistem Anda terlebih dahulu. Pastikan Anda memiliki hak Administrator untuk melakukannya.

npm install -g @google/gemini-cli

lalu jalankan dengan perintah berikut:

gemini

Dengan asumsi Anda telah meluncurkan Gemini CLI melalui salah satu metode di atas, Anda akan melihat layar berikut yang menanyakan tentang pemilihan tema. Lanjutkan dan pilih salah satu yang Anda suka:

Setelah Anda memilihnya, Anda akan diminta untuk memilih Metode autentikasi. Sebaiknya gunakan Akun Google pribadi Anda, bukan akun non-Google atau akun terkait Google Workspace dalam lab ini. Lisensi gratis tersebut memberi Anda akses ke Gemini 2.5 Pro dan jendela konteks 1 juta tokennya. Paket gratis memungkinkan 60 permintaan model per menit dan 1.000 permintaan per hari tanpa biaya.

Jika Anda mencapai batas kuota gratis saat ini yang diberikan ke Akun Google, Anda dapat memilih untuk menggunakan Kunci API Gemini atau bahkan Google Cloud Vertex AI, yang mengharuskan Anda memiliki Project ID dan nama lokasi untuk project tersebut. Lihat bagian Autentikasi dalam dokumentasi, jika Anda berencana menggunakan metode autentikasi lainnya.

Lanjutkan dan klik Enter. Tindakan ini akan membuka halaman Autentikasi Google di browser. Lanjutkan autentikasi dengan Akun Google Anda, setujui persyaratan, dan setelah Anda berhasil diautentikasi, Anda akan melihat bahwa Gemini CLI sudah siap dan menunggu perintah Anda. Contoh screenshot diberikan di bawah:

Ketik /help (garis miring) dan Anda akan melihat berbagai perintah dan pintasan keyboard seperti yang ditunjukkan di bawah:

Interaksi pertama kita dengan Gemini CLI

Ketik pesan pertama Anda di dalam kotak. Kita akan memberikan kueri seperti:

Anda akan melihat bahwa kueri kami menghasilkan alat GoogleSearch (alat bawaan di Gemini CLI) yang dipanggil. Ini adalah cara menarik yang telah kita lakukan dengan salah satu alat bawaan CLI Gemini yang canggih, yaitu GoogleSearch, yang mendasarkan responsnya pada informasi yang didapat dari web. Kita akan melihat lebih banyak tentang Alat di bagian berikutnya.

Keluar dari Gemini CLI untuk saat ini. Anda dapat melakukannya melalui perintah /quit atau Anda dapat menjalankan Ctrl-C dua kali dalam sesi terminal Gemini CLI interaktif.

File Penyesuaian Gemini CLI : settings.json

Jika Anda ingat saat kita memulai Gemini CLI untuk pertama kalinya, kita diminta untuk memilih tema, lalu metode autentikasi. Pada eksekusi Gemini CLI berikutnya, Anda tidak akan diminta untuk memilih tema dan metode autentikasi lagi. Artinya, file tersebut disimpan di suatu tempat dan file yang digunakannya disebut settings.json dan merupakan cara untuk menyesuaikan Gemini CLI.

Setelan diterapkan dengan urutan prioritas berikut:

Workspace: .gemini/settings.json (menggantikan setelan pengguna dan sistem).
Pengguna: ~/.gemini/settings.json (menggantikan setelan sistem).
Sistem: /etc/gemini-cli/settings.json (berlaku untuk semua pengguna).

Jika Anda ingat, saat memilih tema, kami meminta agar setelan disimpan di Setelan Pengguna. Jadi, buka ~/.gemini folder dan Anda akan melihat file settings.json.

File settings.json saya ditampilkan di bawah. Jika Anda telah memilih tema lain, Anda akan melihat namanya di sana.

{
  "theme": "Default",
  "selectedAuthType": "oauth-personal"
}

3. Parameter Perintah Gemini CLI

Ada beberapa parameter command line yang dapat diberikan saat Anda memulai Gemini CLI. Untuk mendapatkan daftar lengkap opsi, Anda dapat menggunakan --help seperti yang ditunjukkan di bawah.

gemini --help

Tindakan ini akan menampilkan berbagai opsi yang tersedia. Sebaiknya Anda membaca dokumentasi di sini.

Mari kita lihat beberapa di antaranya. Yang pertama adalah mengonfigurasi Gemini CLI untuk menggunakan model Pro atau Flash. Saat ini, pada saat lab ini ditulis, hanya dua model tersebut yang didukung. Secara default, model Gemini 2.5 Pro digunakan, tetapi jika ingin menggunakan Model Flash, Anda dapat melakukannya saat memulai Gemini CLI melalui parameter -m seperti yang ditunjukkan di bawah:

gemini -m "gemini-2.5-flash"

Anda akan melihat bahwa jika Anda memulai dengan cara di atas, Anda dapat memeriksa model di kanan bawah terminal Gemini CLI seperti yang ditunjukkan di bawah:

Mode noninteraktif

Opsi menarik adalah menjalankan Gemini CLI dalam mode non-interaktif. Artinya, Anda langsung memberikan perintah dan Gemini akan langsung meresponsnya, tanpa membuka terminal interaktif Gemini CLI. Hal ini sangat berguna jika Anda berencana menggunakan Gemini CLI secara otomatis sebagai bagian dari skrip atau proses otomatisasi lainnya. Anda menggunakan parameter -p untuk memberikan perintah ke Gemini CLI seperti yang ditunjukkan di bawah:

gemini -p "What is the gcloud command to deploy to Cloud Run"

Perlu diingat bahwa tidak ada ruang lingkup untuk melanjutkan percakapan dengan pertanyaan lanjutan.

4. Gemini CLI - Alat Bawaan

Gemini CLI dilengkapi dengan serangkaian alat bawaan dan dokumentasi alat menyatakan bahwa "Model Gemini menggunakan alat ini untuk berinteraksi dengan lingkungan lokal Anda, mengakses informasi, dan melakukan tindakan. Alat ini meningkatkan kemampuan CLI, sehingga dapat melakukan lebih dari sekadar menghasilkan teks dan membantu berbagai tugas."

Untuk mendapatkan daftar Alat Bawaan saat ini, kita cukup memanggil perintah /tools seperti yang ditunjukkan di bawah:

Salah satu hal yang harus segera Anda tanyakan adalah apakah Gemini CLI dapat memanggil alat ini begitu saja, kapan pun ia mau? Jawaban defaultnya adalah tidak, jika menyangkut operasi sensitif yang mungkin melibatkan penulisan ke sistem lokal, pembacaan dari sistem eksternal, membuka jaringan eksternal, dan sebagainya.

Meskipun ada --yolomode yang tersedia saat Anda memulai CLI, yang tidak akan kita gunakan, Anda akan melihat bahwa Gemini CLI akan meminta izin untuk menjalankan alat yang telah dipilihnya. Anda dapat menolak izin, atau membiarkannya berjalan satu kali atau memberikan izin menyeluruh agar selalu berjalan. Anda adalah dan harus memiliki kontrol penuh atas semuanya.

Mari kita berikan perintah yang akan membuat Gemini CLI memilih salah satu alat bawaan untuk dieksekusi dan yang akan memberi kita pemahaman yang baik tentang cara kerjanya.

Kita ingin mendapatkan informasi tentang berita keuangan terbaru di seluruh dunia dan menyimpannya ke dalam file di direktori kerja lokal tempat kita meluncurkan Gemini CLI. Kami memberikan perintah berikut:

Search for the latest headlines today in the world of finance and save them in a file named finance-news-today.txt

Bayangkan sejenak apa yang harus dilakukan. Idealnya, ia harus keluar untuk melakukan GoogleSearch guna mendapatkan berita dari beberapa sumber informasi yang relevan yang dapat memberinya berita keuangan. Kemudian, aplikasi perlu membuat file bernama finance-news-today.txt (operasi penulisan di sistem lokal Anda yang akan memerlukan izin Anda) dengan kontennya.

Mari kita lihat apa yang terjadi (Anda harus melakukan hal yang sama di komputer Anda).

Hal pertama yang dilakukan adalah memanggil alat GoogleSearch untuk menelusuri web.

Setelah penelusuran selesai, data akan diambil seperti yang ditunjukkan di bawah:

Setelah selesai, aplikasi siap menulisnya ke file dan akan menggunakan alat WriteFile, tetapi karena ini adalah operasi sensitif (tulis), aplikasi akan meminta izin Anda. Anda dapat memutuskan jenis izin, yaitu izinkan sekali, izinkan selalu, dll. Untuk saat ini, kita pilih izinkan sekali.

Kemudian, informasi akan ditulis ke file dan pesan berhasil akan ditampilkan di bawah:

Bagaimana cara memeriksa apakah file ditulis atau tidak? Kita dapat menggunakan @file untuk memintanya membacakan konten. Kita memberikan perintah seperti yang ditunjukkan di bawah ini. Saat kita mengetik @, daftar file di folder saat ini akan ditampilkan dan file yang baru saja dibuat akan ditampilkan. Pilih opsi tersebut dan kirimkan perintahnya. Perintah saya ditampilkan di bawah:

read the contents of @finance-news-today.txt

Hal ini akan menyebabkan alat yang diperlukan (ReadManyFiles, ReadFile) dipanggil dan konten ditampilkan seperti yang ditunjukkan di bawah:

Ini juga saat yang tepat untuk mempelajari cara bekerja langsung dengan Shell dari dalam Gemini CLI. Anda dapat masuk ke mode shell dengan menekan ! di kotak pesan. Tindakan ini akan beralih ke mode Shell. Anda dapat kembali dengan menekan ! lagi atau dengan menekan tombol ESC.

Saat dalam mode shell, Anda akan melihat ! di awal perintah seperti yang ditunjukkan di bawah:

Saya dapat memeriksa secara langsung menggunakan perintah standar seperti pwd dan ls seperti yang ditunjukkan di bawah:

Kita dapat mencetak konten file melalui perintah cat hari ini.

Latihan: Berikut latihan singkat yang dapat dicoba. Pilih feed RSS yang Anda inginkan. Berikan perintah ke Gemini CLI untuk mengambil konten feed RSS dan memformat hasilnya untuk Anda dengan cara tertentu. Ini adalah cara yang baik untuk mengotomatiskan sesuatu di awal hari.

Petunjuk: Anda harus membuat Gemini CLI menggunakan alat WebFetch.

5. Mengonfigurasi Server Model Context Protocol (MCP)

Server MCP adalah aplikasi yang mengekspos alat dan resource ke Gemini CLI melalui Model Context Protocol, sehingga memungkinkan Gemini CLI berinteraksi dengan sistem dan sumber data eksternal. Server MCP berfungsi sebagai jembatan antara model Gemini dan lingkungan lokal Anda atau layanan lain seperti API.

Server MCP memungkinkan Gemini CLI menemukan dan mengeksekusi alat sehingga memperluas kemampuan Gemini CLI untuk melakukan tindakan di luar fitur bawaannya, seperti berinteraksi dengan database, API, skrip kustom, atau alur kerja khusus.

Gemini CLI mendukung konfigurasi Server MCP untuk menemukan dan menggunakan alat kustom. Jika Gemini CLI sudah diluncurkan, Anda dapat memeriksa server MCP yang dikonfigurasi melalui perintah /mcp seperti yang ditunjukkan di bawah:

Jika Anda belum mengonfigurasi server MCP, perintah ini akan meluncurkan dokumentasi Server MCP Gemini CLI.

Anda dapat mengonfigurasi server MCP di tingkat global dalam file ~/.gemini/settings.json atau di direktori root project Anda. Buat atau buka file .gemini/settings.json. Dalam file, Anda harus menambahkan blok konfigurasi mcpServers, seperti yang ditunjukkan di bawah:

"mcpServers": {
    "server_name_1": {},
    "server_name_2": {},
    "server_name_n": {}
 }

Setiap konfigurasi server mendukung properti berikut ( Dokumentasi referensi):

Wajib (salah satu dari berikut ini)

command (string): Jalur ke file yang dapat dieksekusi untuk transportasi Stdio
url (string): URL endpoint SSE (misalnya, "http://localhost:8080/sse")
httpUrl (string): URL endpoint streaming HTTP

Opsional

args (string[]): Argumen command line untuk transportasi Stdio
header (objek): Header HTTP kustom saat menggunakan url atau httpUrl
env (objek): Variabel lingkungan untuk proses server. Nilai dapat mereferensikan variabel lingkungan menggunakan sintaksis $VAR_NAME atau ${VAR_NAME}
cwd (string): Direktori kerja untuk transportasi Stdio
timeout (number): Waktu tunggu permintaan dalam milidetik (default: 600.000 md = 10 menit)
trust (boolean): Jika benar (true), melewati semua konfirmasi panggilan alat untuk server ini (default: salah (false))
includeTools (string[]): Daftar nama alat yang akan disertakan dari server MCP ini. Jika ditentukan, hanya alat yang tercantum di sini yang akan tersedia dari server ini (perilaku daftar yang diizinkan). Jika tidak ditentukan, semua alat dari server akan diaktifkan secara default.
excludeTools (string[]): Daftar nama alat yang akan dikecualikan dari server MCP ini. Alat yang tercantum di sini tidak akan tersedia untuk model, meskipun alat tersebut diekspos oleh server. Catatan: excludeTools lebih diprioritaskan daripada includeTools - jika alat ada di kedua daftar, alat tersebut akan dikecualikan.

Mari kita lanjutkan dan mengonfigurasi salah satu server MCP utama yang mungkin Anda perlukan jika Anda bekerja dengan GitHub. Namun, Anda harus memperhatikan bahwa Gemini CLI akan memanggil alat git yang ada di sistem Anda dan Anda juga dapat menginstruksikan Gemini CLI untuk menggunakannya. Jadi, pahami bahwa alat ini akan membantu Anda dengan perintah dan mengeksekusinya untuk Anda, tetapi Anda harus menyiapkan alat tersebut di sistem Anda.

Server MCP GitHub

Server MCP resmi GitHub menyediakan dokumentasi yang memadai tentang alat yang dieksposnya beserta cara mengonfigurasinya. Anda dapat memilih untuk menjalankannya secara lokal atau jarak jauh, karena Gemini CLI juga mendukung Server MCP jarak jauh.

Dalam tutorial ini, kita telah memilih untuk menggunakan opsi Server MCP Jarak Jauh di GitHub. Untuk melakukannya, Anda harus memiliki Token Akses Pribadi (PAT) dari GitHub terlebih dahulu.

Setelah itu, Anda perlu menambahkan objek Server MCP di file settings.json. File settings.json lengkap di sistem saya ditampilkan di bawah. Anda mungkin memiliki setelan tambahan, tetapi objek mcpServers harus seperti yang diberikan di bawah:

{
  "theme": "Default",
  "selectedAuthType": "oauth-personal",
  "mcpServers": {
       "github": {
            "httpUrl": "https://api.githubcopilot.com/mcp/",
            "headers": {
                "Authorization": "GITHUB_PAT"
            },
            "timeout": 5000
       }
  }
}

Anda dapat memulai Gemini CLI lagi atau menjalankan perintah /mcp refresh, setelah Anda memperbarui settings.json dengan konfigurasi Server MCP GitHub. Screenshot di bawah menandai Server MCP Github yang dikonfigurasi di komputer saya dan berbagai alat yang kini tersedia untuk Gemini CLI agar dapat bekerja dengan MCP.

Mari kita mulai dengan perintah yang akan memanggil salah satu alat dari Server MCP Github. Berikan perintah berikut:

Perhatikan bahwa alat ini akan memilih alat yang benar dari Server MCP Github, tetapi seperti Alat bawaan lainnya, Anda juga harus memberikan izin eksplisit untuk memanggil alat ini. Lanjutkan dan lihat output yang Anda dapatkan.

Sekarang Anda harus bekerja dengan salah satu project Github Anda. Berikan kueri Anda dalam bahasa alami seperti:

Jelaskan <repo-name> kepada saya?
Buat clone <repo-name> di komputer lokal saya.
Jelaskan @<file-name> atau @<directory-name>/
Apa saja komponen yang ada di repositori ini?
Saya telah melakukan perubahan yang diperlukan. Dapatkah Anda mengirim perubahan ke GitHub dan menggunakan alat Server MCP GitHub untuk melakukannya?

Kita akan membahas latihan penggunaan Server MCP Github secara mendetail di lab selanjutnya.

Server MCP Context7

Context7 menyediakan dokumentasi terbaru untuk LLM dan editor kode AI . Jika Anda ingin memberikan konteks ke LLM dengan dokumentasi terbaru untuk framework pilihan Anda, server MCP Context7 adalah pilihan yang tepat untuk dikonfigurasi.

Pastikan Anda mencantumkan perpustakaan di halaman beranda Context7.

Berikut adalah Server MCP yang perlu Anda tambahkan dalam file settings.json.

"context7": {
      "httpUrl": "https://mcp.context7.com/mcp"
    }

Setelah Server MCP dikonfigurasi dan Gemini CLI berhasil dimuat, Anda akan dapat melihat alat Context7 seperti yang ditunjukkan di bawah:

Sekarang Anda dapat lebih spesifik dalam perintah dan meminta Gemini CLI menggunakan Context7 untuk dokumentasi terbaru, saat membuat aplikasi atau cuplikan kode, menggunakan framework XYZ tertentu.

Berikut contoh perintah, di mana saya ingin menulis Agen menggunakan Agent Development Kit (ADK) dari Google. Saya menentukan dalam perintah saya untuk mencari dokumentasi yang sama melalui Server MCP Context7.

I am working on coding an Agent using the Agent Development Kit (ADK) from Google. I would like to know how to create the LLMAgent in Python. Use Context7 for the latest documentation on ADK and specifically use /google/adk-python, /google/adk-docs and adk.wiki

Berikut output yang diterima:

Server MCP Google Slide

Project GitHub di https://github.com/matteoantoci/google-slides-mcp menyediakan server MCP untuk berinteraksi dengan Google Slides API. API ini memungkinkan Anda membuat, membaca, dan mengubah presentasi Google Slide secara terprogram.

Langkah-langkah untuk mengonfigurasi server MCP diberikan dalam project. Anda harus memiliki lingkungan Node.js tempat Anda membangun server, mengonfigurasi Project Google Cloud dan token OAuth 2.0, lalu mengonfigurasi Server MCP dalam file settings.json.

Setelah penyiapan, Anda dapat menjalankan perintah seperti:

Ekstrak informasi terbaru dari "web_url", ringkas menjadi poin-poin penting, dan buat presentasi bernama "my_presentation".

Cobalah!

Server MCP Lainnya

Berikut daftar tambahan server MCP yang mungkin menarik bagi Anda:

Server MCP Firebase
Layanan Media AI Generatif Google (Imagen, Veo, Lyria)
MCP Toolbox for Databases (bekerja dengan Firestore, BigQuery, database Google Cloud)
Server MCP Google Workspace (bekerja dengan Dokumen, Spreadsheet, Kalender, Gmail)

Petunjuk untuk menyiapkan server MCP di atas dipublikasikan dalam postingan blog ini.

6. Kasus penggunaan yang dapat dicoba

Gemini CLI dapat diterapkan ke berbagai kasus penggunaan yang berlaku untuk developer dan non-developer. Berikut beberapa skenario dan bergantung pada area minat Anda, Anda dapat mencoba salah satu atau semua skenario tersebut.

Dalam setiap kasus ini, perintah disediakan. Anda dapat mencobanya dalam mode interaktif atau non-interaktif Gemini CLI melalui parameter -p pada saat meluncurkan Gemini CLI.

Mengatur File/Folder

Anda dapat menggunakan Gemini CLI untuk mengatur file berdasarkan jenisnya di berbagai folder sesuai kebutuhan. Buka folder di komputer Anda yang memiliki beberapa file .txt, .png, .jpg, .pdf, .mp4, dan lainnya. Folder ini kemungkinan adalah Desktop atau folder Download Anda.

Buka folder tersebut dan mulai Gemini CLI. Kita akan memintanya untuk membuat beberapa folder terlebih dahulu di sini: Gambar, Dokumen, Video, lalu kita akan memintanya untuk mengatur file dalam folder.

CLI Gemini akan sering meminta izin Anda sebelum menjalankan perintah, terutama perintah yang mengubah sistem file Anda (seperti menulis, memindahkan, atau menghapus file). Selalu tinjau perintah ini dengan cermat sebelum memberikan izin. Ini adalah jaring pengaman Anda.

Create the following folders "Images","Documents","Videos"

Kemudian, berikan perintah berikut:

Go through all the files in this folder and then organize them by moving all the files ending with .jpg, .jpeg, .gif into the "Images" folder. Move all ".txt" files into the "Documents" folder. Move all the ".mp4" files in the "Videos" folder.

Beberapa skenario pengorganisasian lainnya (petunjuk diberikan di samping setiap skenario):

Ringkasan: Untuk setiap dokumen dalam folder 'Documents', buat file txt dalam folder yang sama bernama 'summary_ORIGINAL_FILENAME.txt' yang berisi ringkasan 3 kalimat tentang poin-poin utama dokumen.
Mengategorikan menurut Jenis: Memindai semua file PDF dan DOCX dalam direktori ini. Pindahkan semua file yang memiliki "invoice" di nama atau kontennya ke folder 'Financial/Invoices'. Pindahkan file dengan "receipt" ke 'Financial/Receipts'. File .docx lainnya akan masuk ke 'Laporan'.
Mengekstrak Informasi Penting (dan "memberi tag"): Untuk setiap file PDF di folder 'Financial/Invoices', baca kontennya. Jika Anda menemukan tanggal, ganti nama file untuk menyertakan tanggal tersebut dalam format YYYY-MM-DD, misalnya, ‘invoice_2025-07-26_original_name.pdf'.