Skip to main content

Tích hợp với Gemini CLI

Gemini CLI là coding agent mã nguồn mở của Google, chạy trong terminal. CLI gọi gateway qua Gemini API, nên chỉ dùng được model Gemini. Hướng dẫn này được kiểm tra với Gemini CLI 0.62.0.

1. Cài đặt​

npm install -g @google/gemini-cli

2. Chọn đăng nhập bằng API key và model mặc định​

Tạo (hoặc sửa) file ~/.gemini/settings.json (Windows: %USERPROFILE%\.gemini\settings.json):

~/.gemini/settings.json
{
"security": {
  "auth": { "selectedType": "gemini-api-key" }
},
"model": { "name": "gemini-3.5-flash" }
}

Nếu không có file này, lần đầu CLI sẽ hỏi cách đăng nhập. Chọn Use Gemini API Key, đừng chọn đăng nhập bằng tài khoản Google.

3. Trỏ CLI vào gateway​

# macOS / Linux: thêm vào ~/.zshrc hoặc ~/.bashrc
export GEMINI_API_KEY="<your_api_key>"
export GOOGLE_GEMINI_BASE_URL="https://api.thucchien.ai"
# Windows PowerShell (mở lại terminal sau khi chạy)
setx GEMINI_API_KEY "<your_api_key>"
setx GOOGLE_GEMINI_BASE_URL "https://api.thucchien.ai"

Base URL không có /v1 hay /v1beta. CLI tự thêm /v1beta/models/....

4. Chạy thử​

cd du-an-cua-ban
gemini

Lần đầu mở một thư mục, CLI hỏi có tin tưởng thư mục đó không. Chọn tin tưởng để agent được đọc và sửa file.

Gemini CLI khởi động với Gemini API key và model gemini-3.5-flash
Thanh dưới cùng hiện gemini-api-key và model gemini-3.5-flash, nghĩa là CLI đang đi qua gateway.

Agent tự đọc thư mục và file. Trước khi chạy lệnh shell hay sửa file, CLI hỏi quyền.

Gemini CLI đọc file và xin quyền chạy lệnh shell
Agent dùng ReadFolder, ReadFile rồi xin quyền chạy ruff check.
  • Đổi model trong phiên: gõ /model. Chỉ chọn model Gemini có trên gateway (ví dụ gemini-3.5-flash), hoặc khởi động bằng gemini -m gemini-3.5-flash.
  • Chạy một lệnh không cần giao diện: gemini --skip-trust -p "Tóm tắt README". Cờ --skip-trust bỏ qua câu hỏi tin tưởng thư mục, cần khi chạy trong script.

Xử lý lỗi thường gặp​

  • CLI vẫn đòi đăng nhập Google: settings.json thiếu "selectedType": "gemini-api-key", hoặc chưa đặt GEMINI_API_KEY.
  • 401 / API key not valid: sai key, hoặc chưa mở lại terminal. Kiểm tra GOOGLE_GEMINI_BASE_URL đã được đặt; thiếu biến này CLI sẽ gọi thẳng Google.
  • 404 / model không tồn tại: model đó không có trên gateway. Model OpenAI và DeepSeek không dùng được qua Gemini CLI.
  • 429 Budget has been exceeded: đội đã dùng hết budget. Xem Kiểm tra chi tiêu.