Cấu hình Gemini CLI
Gemini CLI là công cụ AI dòng lệnh của Google. Phù hợp để sử dụng Gemini trong terminal cho mục đích hỏi đáp, đọc hiểu mã nguồn và hỗ trợ dự án.
Thông tin chính thức Việc tải xuống và tài liệu hướng dẫn vui lòng tham khảo trang web chính thức.
Công cụ này là gì và dùng để làm gì
Google GeminiCông cụ dòng lệnhĐăng nhập GoogleGemini API Key
Chọn phương thức xác thực trước
| Phương thức | Đối tượng phù hợp | Mô tả |
|---|---|---|
| Đăng nhập Google | Người dùng cá nhân và người mới bắt đầu | Chạy Gemini và đăng nhập theo lời nhắc |
| Gemini API Key | Người dùng đã có Google AI Studio Key | Đặt Key vào GEMINI_API_KEY |
| Vertex AI | Người dùng doanh nghiệp hoặc dự án đám mây | Cấu hình theo dự án và quyền trên Google Cloud |
Cách kiểm tra API Key
Kiểm tra tạm thời trong PowerShell
$env:GEMINI_API_KEY = "YOUR_GEMINI_API_KEY" geminiKiểm tra tạm thời trong Terminal
GEMINI_API_KEY="YOUR_GEMINI_API_KEY" geminiĐăng nhập tương tác
geminiCác bước tiếp theo sau khi kiểm tra thành công
- Trước tiên, hãy chạy Gemini CLI trong một thư mục trống; không mở trực tiếp các dự án quan trọng.
- Chỉ hỏi một câu hỏi ngắn cố định để xác nhận mô hình có thể phản hồi bình thường.
- Sau đó yêu cầu nó đọc một tệp thử nghiệm và ghi rõ yêu cầu không sửa đổi tệp.
- Nếu muốn sử dụng API Key lâu dài, hãy lưu phương thức xác thực vào biến môi trường cục bộ hoặc cấu hình theo tài liệu chính thức của Gemini CLI.
- Nếu bạn đã chuyển đổi nhà cung cấp AI hoặc CC-Switch, hãy kiểm tra lại sau khi mở lại terminal.
| Hiện tượng | Kiểm tra ưu tiên | Cách xử lý |
|---|---|---|
| Vẫn yêu cầu đăng nhập Google | Phương thức xác thực hiện tại có phải là quy trình đăng nhập Google không? | Trước tiên hãy hoàn tất xác thực theo lời nhắc của chính Gemini CLI; không kết hợp xử lý sự cố giữa API Key và quy trình đăng nhập |
| Key không hợp lệ | GEMINI_API_KEY có đúng là từ Google AI Studio / Gemini không? | Không nhập Key của OpenAI hoặc Claude vào Gemini |
| Mô hình không khả dụng | Tên mô hình có nằm trong danh sách của Gemini không? | Không nhập tên mô hình của OpenAI / Claude vào Gemini CLI |
Những điều cần lưu ý khi cấu hình nhà cung cấp AI
Gemini CLI và nhà cung cấp tương thích với OpenAI không phải là một. Bạn chỉ nên làm theo hướng dẫn khi nhà cung cấp nêu rõ phương thức cấu hình cho Gemini CLI, Google Gemini hoặc Vertex AI.
Không nhập Base URL thông thường của OpenAI vào Gemini CLI. OpenAI, Claude và Gemini là ba giao thức khác nhau. Nếu nhà cung cấp cung cấp các địa chỉ riêng biệt trong trang quản trị, bạn phải nhập đúng địa chỉ tương ứng với công cụ.
Tài liệu chính thức của Gemini CLI Xem các điểm truy cập cài đặt, lệnh và cấu hình.
Tài liệu xác thực Gemini CLI Xem hướng dẫn về đăng nhập Google, Gemini API Key và Vertex AI.