Bỏ qua tới nội dung
Agent Skill Hub
EN
Track 01 · Hướng dẫn

Bắt đầu với Gemini CLI

Cài đặt, xác thực, cấu hình và dùng thử Gemini CLI ngay trong terminal.

Cơ bản@shine19046 phút đọc

Bài này giúp bạn cài đặt, cấu hình và bắt đầu dùng Gemini CLI để làm việc hiệu quả hơn ngay từ terminal.

Tổng quan

Gemini CLI đưa sức mạnh của các model ngôn ngữ tiên tiến vào thẳng giao diện dòng lệnh. Là một trợ lý dùng AI, Gemini CLI giúp bạn nhiều việc, từ hiểu và sinh code tới rà soát, chỉnh sửa tài liệu.

Cài đặt

Cách tiêu chuẩn để cài và chạy Gemini CLI là dùng npm:

bash
npm install -g @google/gemini-cli

Cài xong, chạy Gemini CLI từ dòng lệnh:

bash
gemini

Các cách cài khác có trong Gemini CLI Installation.

Xác thực

Để bắt đầu dùng Gemini CLI, bạn phải xác thực với một dịch vụ của Google. Trong đa số trường hợp, bạn đăng nhập bằng tài khoản Google sẵn có:

  1. Chạy Gemini CLI sau khi cài:

    bash
    gemini

  2. Khi được hỏi "How would you like to authenticate for this project?", chọn 1. Sign in with Google.

  3. Chọn tài khoản Google của bạn.

  4. Bấm Sign in.

Một số loại tài khoản có thể phải cấu hình một Google Cloud project. Thông tin thêm, kể cả các cách xác thực khác, có trong Gemini CLI Authentication Setup.

Cấu hình

Gemini CLI có nhiều cách cấu hình hành vi: biến môi trường, tham số dòng lệnh và file settings.

Các tuỳ chọn cấu hình có trong Gemini CLI Configuration.

Sử dụng

Sau khi cài và xác thực, bạn bắt đầu dùng Gemini CLI bằng cách gõ lệnh và prompt trong terminal. Hãy yêu cầu nó sinh code, giải thích file và nhiều việc khác.

Đổi tên ảnh theo nội dung

Bạn có thể dùng Gemini CLI để tự động hoá các việc quản lý file cần phân tích hình ảnh. Trong ví dụ này, Gemini CLI đổi tên ảnh theo đúng chủ thể trong ảnh.

Tình huống: bạn có một thư mục chứa các file sau:

bash
photos/photo1.png
photos/photo2.png
photos/photo3.png

Đưa cho Gemini prompt sau:

cli
Rename the photos in my "photos" directory based on their contents.

Kết quả: Gemini xin quyền đổi tên file của bạn.

Chọn Allow once và các file được đổi tên:

bash
photos/yellow_flowers.png
photos/antique_dresser.png
photos/green_android_robot.png

Giải thích một repository bằng cách đọc code

Gemini CLI khám phá codebase rất nhanh. Ví dụ sau cho thấy cách yêu cầu Gemini CLI tải về, phân tích và tóm tắt một dự án ở xa.

Tình huống: bạn muốn hiểu một tiện ích mã nguồn mở phổ biến hoạt động thế nào bằng cách xem code, không chỉ đọc README.

Đưa cho Gemini CLI prompt sau:

cli
Clone the 'chalk' repository from https://github.com/chalk/chalk, read its key source files, and explain how it works.

Kết quả: Gemini thực hiện một chuỗi hành động để trả lời yêu cầu của bạn.

  1. Đầu tiên, nó xin quyền chạy git clone để tải repository về.
  2. Tiếp theo, nó tìm các file mã nguồn quan trọng và xin quyền đọc chúng.
  3. Cuối cùng, sau khi phân tích code, nó đưa ra bản tóm tắt.

Gemini CLI trả về lời giải thích dựa trên chính mã nguồn:

markdown
The `chalk` library is a popular npm package for styling terminal output with
colors. After analyzing the source code, here's how it works:

- **Core functionality:** The main file sets up a chainable API. Each color or
  modifier (like `bold` or `italic`) is a getter that appends the corresponding
  ANSI escape code to an internal stack.

- **Chainable API:** When you call `chalk.red.bold('Hello')`, you are accessing
  getters. The `red` getter adds the red color code, and the `bold` getter adds
  the bold code.

- **Output generation:** When the chain is treated as a string (for example, in
  `console.log`), a final `toString()` method is called. This method joins all
  the stored ANSI codes, wraps them around the input string ('Hello'), and adds
  a reset code at the end. This produces the final, styled string that the
  terminal can render.

Gộp hai bảng tính thành một

Gemini CLI xử lý và biến đổi dữ liệu trên nhiều file. Bạn dùng khả năng này để gộp báo cáo hay định dạng lại tập dữ liệu mà không phải chép tay.

Tình huống: bạn có hai file .csv là Revenue - 2023.csv và Revenue - 2024.csv. Mỗi file chứa doanh thu theo tháng.

Đưa cho Gemini CLI prompt sau:

cli
Combine the two .csv files into a single .csv file, with each year a different column.

Kết quả: Gemini CLI đọc từng file rồi xin quyền ghi một file mới. Bạn cho phép và Gemini CLI trả về dữ liệu đã gộp:

csv
Month,2023,2024
January,0,1000
February,0,1200
March,0,2400
April,900,500
May,1000,800
June,1000,900
July,1200,1000
August,1800,400
September,2000,2000
October,2400,3400
November,3400,1800
December,2100,9000

Viết unit test

Gemini CLI sinh được code khung và test dựa trên phần code bạn đã viết. Ví dụ này cho thấy cách yêu cầu độ phủ code cho một component JavaScript.

Tình huống: bạn đã viết một trang đăng nhập đơn giản và muốn viết unit test để trang đăng nhập có độ phủ code.

Đưa cho Gemini CLI prompt sau:

cli
Write unit tests for Login.js.

Kết quả: Gemini CLI xin quyền ghi một file mới và tạo test cho trang đăng nhập của bạn.

Kiểm tra mức dùng và hạn mức

Bạn xem mức dùng token và hạn mức hiện tại bằng lệnh /stats model. Lệnh này cho biết lượng token đã dùng trong phiên hiện tại, cùng hạn mức và mức dùng tổng của các model được hỗ trợ.

Thông tin thêm về lệnh /stats và các lệnh con có trong Command Reference.

Bước tiếp theo

  • Làm theo hướng dẫn File management để bắt đầu làm việc với codebase.
  • Xem Shell commands để tìm hiểu cách tích hợp với terminal.

Nguồn

Viết thêm guide cho track này