KozeKoze
← Quay lại Blog
Hướng dẫn2026年3月23日·管理员

Hướng dẫn cấu hình Gemini CLI

Hướng dẫn cấu hình Gemini CLI

📋 Các bước chuẩn bị

Trước khi bắt đầu, vui lòng đảm bảo bạn đã:

  • Đăng ký tài khoản Koze và đăng nhập
  • Tạo khóa API trên trang Quản lý API
  • Cài đặt Gemini CLI (npm install -g @anthropic-ai/gemini-cli hoặc tham khảo Kho lưu trữ chính thức)

🚀 Phương pháp 1: Truy cập qua API Gemini (Khuyến nghị)

Thiết lập các biến môi trường sau trong terminal:

# Thiết lập xuất địa chỉ proxy Koze Gemini GOOGLE_GEMINI_BASE_URL='https://api.kozeai.com/gemini'

# Thiết lập Khóa API Koze của bạn
export GEMINI_API_KEY='khóa API của bạn'

# Chỉ định kiểu máy cần sử dụng
export GEMINI_MODEL='gemini-2.5-pro'

Phương thức xác thực:Chọn Sử dụng Khóa API Gemini khi khởi động.

Nếu được yêu cầu nhập Khóa API, chỉ cần nhấn Enter và để trống.

💡 Nếu bạn tự động được chuyển hướng đến trang đăng nhập Google khi khởi động, vui lòng xóa ~/.gemini/settings.json và khởi động lại.

🔧 Phương pháp thứ hai: Truy cập qua API Code Assist

Một phương pháp truy cập khác, phù hợp với một số trường hợp đặc biệt:

# Thiết lập điểm cuối Code Assist

export CODE_ASSIST_ENDPOINT='https://api.kozeai.com/gemini'

# Thiết lập Mã truy cập (sử dụng Khóa API Koze của bạn)

export GOOGLE_CLOUD_ACCESS_TOKEN='khóa API của bạn'

# Bật chế độ GCA

export GOOGLE_GENAI_USE_GCA='true'

# Chỉ định mô hình

xuất GEMINI_MODEL='gemini-2.5-pro'

Phương thức xác thực:Chọn Đăng nhập bằng khi khởi động Google.

⚠️ Lưu ý: Giao diện dòng lệnh Gemini có thể hiển thị "Không thể lấy thông tin người dùng: 401 Không được phép", điều này là bình thường và không ảnh hưởng đến việc sử dụng.

🎯 Bước 3: Khởi chạy giao diện dòng lệnh Gemini

Sau khi cấu hình, hãy khởi chạy nó trong terminal:

gemini

📌 Lưu trữ các biến môi trường

Nên ghi các biến môi trường vào tệp cấu hình shell (sử dụng phương pháp 1 làm ví dụ):

# Người dùng Zsh

cat >> ~/.zshrc << < EOF <

export GOOGLE_GEMINI_BASE_URL=

export GEMINI_API_KEY=

export GEMINI_MODEL=

EOF source ~/.zshrc

📌 Các mẫu có sẵn

tiết kiệm chi phí
Tên mẫu Mô tả
gemini-2.5-pro Gemini 2.5 Pro, thế hệ mới nhất của các mẫu hiệu năng cao
gemini-2.5-flash Gemini 2.5 Flash, nhanh hơn và mạnh mẽ hơn
gemini-2.0-flash Gemini 2.0 Flash

⚠️ Câu hỏi thường gặp (FAQ)
Vấn đề Giải pháp
Tự động chuyển hướng đến Đăng nhập Google sau khi khởi động Xóa tệp ~/.gemini/settings.json và thử lại
Thông báo lỗi 401 Không được phép Đây là thông báo bình thường và không ảnh hưởng đến việc sử dụng; Bỏ qua nó.
Mẫu không khả dụng Kiểm tra trong Sảnh chờ Người mẫu Koze xem gói hiện tại của bạn có bao gồm các mẫu Gemini hay không.

 

#geminiCLI#gemini
Hướng dẫn cấu hình Gemini CLI | Koze AI