1. Pengantar
Dalam codelab ini, Anda akan mempelajari Gemini CLI, agen AI open source yang menghadirkan kecanggihan Gemini langsung ke terminal Anda.
Yang akan Anda pelajari
- Menginstal dan mengonfigurasi Gemini CLI
- Mempelajari alat, perintah bawaan, dan mengonfigurasi Server MCP di Gemini CLI
- Menyesuaikan Gemini CLI melalui file
GEMINI.md - Mempelajari beberapa kasus penggunaan dengan Gemini CLI
Yang Anda butuhkan
Codelab ini dapat dijalankan sepenuhnya di dalam Google Cloud Shell, yang sudah terinstal sebelumnya dengan Gemini CLI.
Atau, jika Anda lebih suka bekerja di komputer Anda sendiri, ada bagian untuk menginstal Gemini CLI secara lokal.
Anda memerlukan hal berikut:
- Browser web Chrome
- Akun Gmail
Codelab ini dirancang untuk pengguna dan developer dari semua tingkat keahlian (termasuk pemula). Kasus penggunaan dalam codelab telah dikategorikan ke dalam tugas developer dan non-developer. Kasus penggunaan developer menunjukkan cara melakukan vibe coding dengan Gemini CLI dan bekerja dengan repositori GitHub untuk melakukan tugas pengembangan umum seperti penjelasan/pemahaman kode, pembuatan dokumentasi, perbaikan masalah, dan lainnya. Sebaiknya Anda menyelesaikan kasus penggunaan ini di codelab. Ada bagian opsional di akhir yang mencakup beberapa tugas sehari-hari yang tidak berfokus pada developer.
2. Sebelum memulai
Membuat project
- Di Konsol Google Cloud, di halaman pemilih project, pilih atau buat project Google Cloud.
- Pastikan penagihan diaktifkan untuk project Cloud Anda. Pelajari cara memeriksa apakah penagihan telah diaktifkan pada suatu project.
- Anda akan menggunakan Cloud Shell, lingkungan command line yang berjalan di Google Cloud yang telah dilengkapi dengan bq. Klik Activate Cloud Shell di bagian atas konsol Google Cloud.
- Setelah terhubung ke Cloud Shell, Anda dapat memeriksa bahwa Anda sudah diautentikasi dan project sudah ditetapkan ke project ID Anda menggunakan perintah berikut:
gcloud auth list
- Jalankan perintah berikut di Cloud Shell untuk mengonfirmasi bahwa perintah gcloud mengetahui project Anda.
gcloud config list project
- Jika project Anda belum ditetapkan, gunakan perintah berikut untuk menetapkannya:
gcloud config set project <YOUR_PROJECT_ID>
3. Penginstalan
Sebelum Anda melakukan penyiapan dan menjalankan Gemini CLI, mari kita buat folder yang akan kita gunakan sebagai folder utama untuk semua project yang kita buat di dalamnya. Ini adalah titik awal bagi Gemini CLI untuk mulai bekerja, meskipun juga akan merujuk ke beberapa folder lain di sistem Anda yang akan Anda pelajari nanti, sesuai kebutuhan.
Buat folder contoh (gemini-cli-projects) dan 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
Anda dapat meluncurkan Gemini CLI secara langsung melalui perintah gemini.
Langsung buka bagian berikutnya (Konfigurasi Gemini CLI melalui settings.json).
Jika Anda ingin menginstal Gemini CLI secara lokal, ikuti petunjuk di bawah. Perhatikan bahwa Gemini CLI sudah terinstal di Cloud Shell dan Cloud Workstations.
Langkah pertama adalah menginstal Node 20+ di komputer Anda. Setelah selesai, Anda dapat menginstal dan menjalankan Gemini CLI melalui salah satu metode berikut:
- Anda dapat menginstal Gemini CLI secara global di sistem Anda terlebih dahulu. Anda mungkin memerlukan akses Administrator untuk melakukan langkah ini.
# option 1: install Gemini CLI
npm install -g @google/gemini-cli
# .. and then run
gemini
- Jalankan dengan perintah berikut:
# option 2: run without installing Gemini CLI
npx https://github.com/google-gemini/gemini-cli
Anda dapat mengonfirmasi bahwa CLI telah diinstal dengan menjalankan:
gemini --version
Dengan asumsi Anda telah meluncurkan Gemini CLI melalui salah satu metode di atas, saat peluncuran pertama, Anda mungkin akan diminta untuk memilih tema. Jika ya, Anda dapat menggunakan tema default atau memilih tema yang Anda inginkan.
Hal penting berikutnya adalah Autentikasi. Anda akan diminta memilih Metode autentikasi. Sebaiknya Anda menggunakan Akun Google pribadi, bukan akun non-Google atau akun terkait Google Workspace dalam lab ini.
Jika Anda mencapai batas kuota gratis saat ini yang diberikan kepada 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 siap dan menunggu perintah Anda.
Contoh screenshot diberikan di bawah:
Dalam hal ini, kami telah memilih opsi Vertex AI, tetapi opsi tersebut dapat berupa akun pribadi dalam kasus Anda. Anda akan melihat bahwa kami telah memilih model Gemini 2.5 (terlihat di kanan bawah). Anda dapat memilih model tertentu kapan saja menggunakan perintah /model.
4. Konfigurasi Gemini CLI melalui settings.json
Jika Anda memilih Cloud Shell untuk menjalankan Gemini, tema default untuk Gemini CLI dan metode autentikasi sudah dipilih dan dikonfigurasi untuk Anda.
Jika Anda menginstal Gemini CLI di komputer dan meluncurkannya untuk pertama kalinya, Anda memilih tema, lalu metode autentikasi.
Sekarang, 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 prioritas berikut (Cloud Shell hanya menyediakan setelan Pengguna):
- Sistem:
/etc/gemini-cli/settings.json(berlaku untuk semua pengguna, menggantikan setelan pengguna dan ruang kerja). - Workspace:
.gemini/settings.json(menggantikan setelan pengguna). - Pengguna:
~/.gemini/settings.json.
Pengguna Windows: %USERPROFILE%.gemini\settings.json (yang biasanya diperluas menjadi C:\Users<YourUsername>.gemini\settings.json)
Sistem: %ProgramData%\gemini-cli\settings.json (yang biasanya diperluas menjadi C:\ProgramData\gemini-cli\settings.json)
Pengguna Mac: ~/.gemini/settings.json (yang diperluas menjadi /Users/<YourUsername>/.gemini/settings.json)
Sistem: /etc/gemini-cli/settings.json
Jika Anda ingat, saat memilih tema, Anda memilih 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.
{
"security": {
"auth": {
"selectedType": "oauth-personal" or "cloud-shell"
}
},
"ui": {
"theme": "Default"
}
}
5. Interaksi pertama kita dengan Gemini CLI
Mari mulai menggunakan Gemini CLI dan ketik kueri pertama Anda seperti yang ditunjukkan di bawah ini:
Give me a famous quote on Artificial Intelligence and who said that?
Respons yang diharapkan ditampilkan di bawah:
> Give me a famous quote on Artificial Intelligence and who said that?
✦ "The only way to do great work is to love what you do." - Steve Jobs (While not directly about AI, it's a famous quote related to technology and innovation, which underpins AI development.)
Alternatively:
"The development of full artificial intelligence could spell the end of the human race." - Stephen Hawking
Cara cepat untuk memahami Gemini CLI dan berbagai perintah yang didukungnya adalah dengan mengetik /help (garis miring) dan Anda akan melihat berbagai perintah dan pintasan keyboard.
Keluar dari Gemini CLI untuk saat ini. Anda dapat melakukannya melalui perintah /quit atau Anda dapat melakukan Ctrl-C dua kali dalam sesi terminal Gemini CLI interaktif. Saat Anda keluar dari Gemini CLI, statistik sesi akan ditampilkan untuk memberi Anda beberapa insight tentang sesi, penggunaan model, dan metrik lainnya.
6. Gemini CLI - Parameter Perintah
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. Cara pertama adalah mengonfigurasi Gemini CLI untuk menggunakan mode Gemini tertentu. Saat ini, pada saat memperbarui lab ini, berikut adalah daftar model yang didukung. Untuk menggunakan model tertentu, Anda dapat melakukannya saat memulai Gemini CLI melalui parameter -m seperti yang ditunjukkan di bawah ini:
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.
Setelah berada di aplikasi Gemini CLI, Anda dapat menggunakan perintah /model untuk membuka dialog yang memungkinkan Anda memilih model. Contoh eksekusi ditampilkan di bawah dan bergantung pada persyaratan dan panduan yang diberikan, Anda dapat terus mengganti model untuk memilih yang tepat untuk tugas tersebut, bergantung pada kompleksitas dan kebutuhan untuk mengontrol biaya.
Mode non-interaktif
Yang menarik, kita bisa 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 kesempatan untuk melanjutkan percakapan dengan pertanyaan lanjutan. Mode ini juga tidak memungkinkan Anda memberikan izin pada alat (termasuk WriteFile) atau menjalankan perintah shell.
Ingatlah bahwa jika Anda tidak menyertakan parameter -p dan hanya memberikan perintah berikut, Gemini CLI akan terbuka dengan perintah tersebut dan berlanjut di dalamnya.
gemini "What is the gcloud command to deploy to Cloud Run"
7. Gemini CLI - Alat bawaan
Gemini CLI dilengkapi dengan serangkaian alat bawaan dan dokumentasi alat yang 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 pembuatan teks dan membantu berbagai tugas."
Untuk mendapatkan daftar Alat Bawaan saat ini, panggil perintah /tools seperti yang ditunjukkan di bawah:
Available Gemini CLI tools:
- Activate Skill (activate_skill)
- Ask User (ask_user)
- Edit (replace)
- Enter Plan Mode (enter_plan_mode)
- FindFiles (glob)
- GoogleSearch (google_web_search)
- Invoke Subagent (invoke_agent)
- List Background Processes (list_background_processes)
- Read Background Output (read_background_output)
- ReadFile (read_file)
- ReadFolder (list_directory)
- SearchText (grep_search)
- Shell (run_shell_command)
- Update Topic Context (update_topic)
- WebFetch (web_fetch)
- WriteFile (write_file)
Salah satu hal yang harus segera Anda tanyakan adalah apakah Gemini CLI dapat memanggil alat ini dengan mudah, jika diinginkan? Jawaban defaultnya adalah tidak, untuk operasi sensitif yang mungkin melibatkan penulisan ke sistem lokal, pembacaan dari sistem eksternal, akses ke jaringan eksternal, dan sebagainya.
Meskipun ada --yolo yang tersedia saat Anda memulai CLI (biasanya tidak direkomendasikan), Anda akan mendapati bahwa Gemini CLI akan meminta izin Anda untuk menjalankan alat yang telah dipilihnya. Anda dapat menolak izin, atau mengizinkannya berjalan sekali atau memberikan izin menyeluruh untuk selalu berjalan. Anda harus memiliki kendali penuh atas segala hal.
Mari gunakan perintah yang akan membuat Gemini CLI memilih salah satu alat bawaan untuk dijalankan dan yang akan memberi Anda pemahaman yang baik tentang cara kerjanya.
Bayangkan skenario saat Anda ingin mendapatkan informasi tentang berita keuangan terbaru di seluruh dunia dan menyimpannya ke dalam file di direktori kerja lokal tempat Anda meluncurkan Gemini CLI. Gunakan 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, Gemini CLI 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 dilakukannya adalah memanggil alat GoogleSearch untuk menelusuri web dan mengambil hasilnya, seperti yang ditunjukkan di bawah:
Searching for Finance News:
I will first search for the latest finance headlines and then save them to a file.
✓ GoogleSearch Searching the web for: "latest finance headlines"
→ Search results for "latest finance headlines" returned.
Saving Finance News: I will now save the finance headlines to the file 'finance-news-today.txt'.
Setelah selesai, Gemini CLI siap menulis ke file dan akan menggunakan alat WriteFile, tetapi karena ini adalah operasi sensitif (write), Gemini CLI akan meminta izin Anda. Anda dapat menentukan jenis izin, yaitu izinkan sekali, izinkan selalu, dll. Lanjutkan dan pilih izinkan sekali untuk saat ini.
Kemudian, informasi tersebut akan ditulis ke file dan akan muncul pesan yang menunjukkan keberhasilan seperti di bawah:
✦ I have saved the latest finance news to finance-news-today.txt.
Finance News Saved: The task is complete.
Bagaimana cara memeriksa apakah file ditulisi atau tidak? Anda dapat menggunakan @file untuk memintanya membacakan konten. Saat Anda mengetik @, daftar file di folder saat ini akan ditampilkan dan file yang baru saja dibuat akan ditampilkan. Pilih opsi tersebut dan kirimkan perintah. 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:
✓ ReadManyFiles Attempting to read files from finance-news-today.txt → Read 1 file(s)
Topic: Summarizing the financial news headlines.
✦ The latest finance headlines as of May 15, 2026, include: