Chuyển đến nội dung chính

Tổng quan

Google Gemini CLI là một công cụ dòng lệnh để tương tác với các mô hình Gemini. LemonData cung cấp một endpoint tương thích cho phép bạn sử dụng Gemini CLI với quyền truy cập vào hơn 300 mô hình.

Yêu cầu hệ thống

  • Node.js: Phiên bản 20.0+
  • Hệ điều hành: Windows 10/11, macOS 10.15+, Ubuntu 20.04+, hoặc Debian 10+

Cài đặt

npm install -g @google/gemini-cli
Xác minh cài đặt:
gemini --version

Cấu hình

Bước 1: Lấy API Key của bạn

  1. Đăng nhập vào LemonData Dashboard
  2. Đi tới API Keys
  3. Tạo và sao chép API key của bạn (định dạng: sk-...)

Bước 2: Thiết lập biến môi trường

Tạm thời (phiên hiện tại):
export GEMINI_API_KEY="sk-your-lemondata-key"
export GOOGLE_GEMINI_BASE_URL="https://api.lemondata.cc"
Cấu hình vĩnh viễn: Thêm vào tệp cấu hình shell của bạn:
echo 'export GEMINI_API_KEY="sk-your-lemondata-key"' >> ~/.bashrc
echo 'export GOOGLE_GEMINI_BASE_URL="https://api.lemondata.cc"' >> ~/.bashrc
source ~/.bashrc
Khởi động lại terminal của bạn sau khi cấu hình để các thay đổi có hiệu lực.
Hạn chế đã biết: Trong một số trường hợp, Gemini CLI có thể không tuân thủ GOOGLE_GEMINI_BASE_URL nếu có một phiên Google được lưu trong bộ nhớ cache. Nếu bạn gặp vấn đề về kết nối, hãy thử xóa bộ nhớ cache của CLI hoặc bắt đầu một phiên terminal mới.

Cách sử dụng cơ bản

Khởi động Gemini CLI từ thư mục dự án của bạn:
cd your-project
gemini
Trong lần chạy đầu tiên, bạn sẽ:
  1. Chọn một chủ đề (theme)
  2. Xác nhận thông báo an toàn
  3. Tin cậy thư mục làm việc

Các mô hình hiện có

Mô hìnhMô tả
gemini-2.5-proMô hình Gemini mạnh mẽ nhất
gemini-2.5-flashNhanh, hiệu quả cho hầu hết các tác vụ
gemini-2.0-flashThế hệ trước, ổn định

Các lệnh phổ biến

Đặt câu hỏi:
> What is the best way to structure a React app?
Phân tích mã nguồn:
> Explain the code in src/main.ts
Tạo mã nguồn:
> Create a Python function to parse JSON files
Xem lại các thay đổi:
> Review the recent git changes and suggest improvements

Xác minh cấu hình

# Kiểm tra các biến môi trường
echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL

# Kiểm tra kết nối
gemini

Xử lý sự cố

  • Xác minh GOOGLE_GEMINI_BASE_URL đã được đặt thành https://api.lemondata.cc
  • Lưu ý: Không có hậu tố /v1 cho Gemini endpoint
  • Kiểm tra kết nối mạng
  • Xác minh biến môi trường GEMINI_API_KEY đã được thiết lập
  • Kiểm tra xem key có bắt đầu bằng sk- không
  • Đảm bảo key đang hoạt động trong LemonData dashboard
  • Kiểm tra tính khả dụng của các mô hình Gemini tại lemondata.cc/en/models
  • Thử một biến thể mô hình Gemini khác

Thực hành tốt nhất

Luôn chạy Gemini CLI từ thư mục gốc của dự án để hiểu ngữ cảnh tốt hơn.
Chỉ tin cậy các thư mục bạn sở hữu. Gemini CLI có thể đọc và sửa đổi các tệp.
Luôn xem lại mã do AI tạo trước khi commit vào dự án của bạn.