Tài liệuTích hợpGemini CLI

Gemini CLI

Agent terminal chính thức của Google. Hai biến môi trường sẽ định tuyến nó qua endpoint tương thích Gemini của trang.

Điều kiện trước
Đã đăng nhập và nạp tiền · đã tạo key đúng nhóm (tạo key) · ID mô hình lấy từ bảng mô hình hoặc /v1/models

Tải và cài đặt

Cần Node.js 20+: npm install -g @google/gemini-cli, sau đó chạy gemini.

Các bước cấu hình

  1. 1
    Tạo key trong nhóm có chứa mô hình Gemini (xem Tạo key).
  2. 2
    Đặt GEMINI_API_KEY=sk-xxxx và GOOGLE_GEMINI_BASE_URL=https://api.daoxe.com (gốc site, không có /v1 hay /v1beta).
  3. 3
    Mở terminal mới, chạy gemini, chọn cách xác thực «Use Gemini API key»; chỉ định mô hình Gemini của trang bằng -m <model-id>.
bash
# ~/.zshrc / ~/.bashrc
export GEMINI_API_KEY="sk-xxxx"
export GOOGLE_GEMINI_BASE_URL="https://api.daoxe.com"

gemini -m 你的Gemini模型ID
bash
# 先用 curl 验证 Gemini 兼容端点 / smoke-test the Gemini endpoint first
curl "https://api.daoxe.com/v1beta/models/你的Gemini模型ID:generateContent?key=sk-xxxx" \
-H "Content-Type: application/json" \
-d '{"contents":[{"parts":[{"text":"ping"}]}]}'

Chọn mô hình

Chỉ các mô hình họ Gemini dùng endpoint /v1beta; sao chép ID (dòng gemini-*) từ bảng mô hình.

Lỗi thường gặp

  • Base phải là gốc site https://api.daoxe.com: CLI tự thêm /v1beta/..., nên thừa /v1 sẽ bị 404.
  • Biến môi trường chỉ áp dụng cho shell mới — mở lại terminal trước khi chạy gemini.
  • Mô hình Gemini cũng dùng được trong công cụ giao thức OpenAI (Base https://api.daoxe.com/v1) — xem danh sách giao thức.

Giao diện tham khảo

Gemini CLI · chọn cách xác thực · Bấm ảnh để phóng to

Liên quan