aicentosGemini CLI
Dùng aicentos trong Gemini CLI —— cấu hình gateway tùy chỉnh qua biến môi trường
Cập nhật lần cuối:
Gemini CLI là công cụ dòng lệnh do Google chính thức phát hành, hỗ trợ cấu hình gateway tùy chỉnh qua biến môi trường để kết nối dịch vụ Codex Proxy, cho phép trò chuyện tương tác với các mô hình Gemini ngay trong terminal.
Chuẩn bị
Gemini CLI cài toàn cục qua npm, cần chuẩn bị sẵn môi trường Node.js 18+ và npm trước.
Cài Node.js
- Truy cập trang tải chính thức của Node.js: https://nodejs.org/en/download
- macOS/Windows: tải và cài bản LTS
- Linux: cài theo cách của bản phân phối được hướng dẫn trên trang
- macOS (người dùng Homebrew): chạy
brew install node
Kiểm tra cài đặt
node -v
npm -vCài đặt Gemini CLI
Cài toàn cục Gemini CLI bằng npm:
npm install -g @google/gemini-cliXác minh cài đặt:
gemini --versionCấu hình biến môi trường
Gemini CLI hỗ trợ kết nối gateway tùy chỉnh qua ba biến môi trường sau:
| Biến môi trường | Mô tả |
|---|---|
GOOGLE_GEMINI_BASE_URL | Địa chỉ gốc dịch vụ gateway, thay thế endpoint mặc định của Google |
GEMINI_API_KEY | API Key của bạn |
GEMINI_MODEL | Mô hình dùng mặc định |
Ví dụ cấu hình
export GOOGLE_GEMINI_BASE_URL="https://aicentos.com"
export GEMINI_API_KEY="your_api_key_here"
export GEMINI_MODEL="gemini-2.0-flash"Lưu ý
GOOGLE_GEMINI_BASE_URLđiền địa chỉ gốc dịch vụ, không cần kèm đường dẫn API cụ thể- Thử tạm thời: chạy trực tiếp các lệnh export trên trong phiên shell hiện tại
- Hiệu lực vĩnh viễn: thêm các câu export vào
~/.zshrchoặc~/.bashrc, rồi chạysource ~/.zshrcđể có hiệu lực
Khởi động Gemini CLI
Sau khi cấu hình xong, chạy trực tiếp lệnh sau để khởi động:
geminiSau khi khởi động là có thể trò chuyện tương tác với các mô hình Gemini ngay trong terminal.
Xác minh kết nối
Mở một hội thoại trong Gemini CLI, nếu nhận được phản hồi bình thường nghĩa là kết nối thành công.
Xử lý sự cố thường gặp
- Nếu gặp lỗi xác thực, hãy xác nhận
GEMINI_API_KEYcó đúng không - Kiểm tra
GOOGLE_GEMINI_BASE_URLcó trỏ đúng địa chỉ dịch vụ không
Lưu ý
- Dịch vụ hiện tại đã hỗ trợ giao diện tương thích Gemini, có thể dùng trực tiếp cho Gemini CLI
- Cấu hình biến môi trường nên thêm vào file cấu hình shell để có hiệu lực vĩnh viễn
- Gemini CLI tự nối đường dẫn API, không cần thêm đường dẫn API cụ thể vào BASE_URL
Liên kết liên quan
- Tài liệu chính thức: https://docs.aicentos.com/clients/gemini-cli.html