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.

 

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