Chuyển tới nội dung chính

Gemini CLI

Nguồn Gemini CLI không xác nhận Base URL bên thứ ba. Chỉ đường qua CC Switch được ghi nhận là lối tương thích đã triển khai.

Trước khi cấu hình​

  • Trang này chỉ dùng placeholder. Key thật lấy từ trang PopGo API keys, mô hình lấy từ models and pricing.
  • Cấu hình một click dành cho phần mềm đã cài và đã đăng ký protocol handler. Khi trình duyệt hỏi mở ứng dụng ngoài, hãy cho phép.
  • Khi cấu hình thủ công, lưu một Provider tối thiểu trước. Chỉ bật streaming, tools hoặc định tuyến nhiều mô hình sau khi yêu cầu đầu tiên thành công.

Nguồn chính thức và xác minh​

Gemini CLI 0.50.0 đã được đối chiếu với nguồn chính thức vào 2026-07-13. Nguồn chính thức. Khả năng tương thích là partial; biến trực tiếp chưa xác nhận không được mô tả như tính năng chính thức.

Cấu hình một lần chạm​

Đăng nhập trang khóa PopGo API rồi mở menu thao tác tại hàng Key cần dùng. Tài liệu công khai không tạo hoặc hiển thị liên kết chứa Key. Chọn CC Switch, sau đó chọn Gemini. Chọn CC Switch trên hàng Key rồi chọn Gemini. Không tìm biến trực tiếp không được nêu trong hướng dẫn.

Cấu hình thủ công​

Không có cách thủ công với Base URL bên thứ ba được xác nhận chính thức. Trang này không bịa biến môi trường.

  • Trước tiên xác nhận gemini --version chạy được. Trang này chỉ ghi nhận đường CC Switch và không công bố biến Base URL chưa xác minh.
  • Sau khi import, khởi động Gemini CLI từ terminal mới và xác nhận phiên hiện tại dùng cấu hình đã import.

Bổ sung cài đặt và kiểm tra​

  1. Kiểm tra node --version và npm --version, sau đó cài Gemini CLI theo cách chính thức.
  2. Chạy gemini --version để xác nhận lệnh nằm trong PATH. Nếu không tìm thấy, mở terminal mới.
  3. Tài liệu này chỉ ghi nhận mục CC Switch đã được kiểm tra; không công bố biến môi trường hoặc cấu hình mô hình chưa xác minh.
  4. Sau khi import, khởi động Gemini CLI từ terminal mới và gửi yêu cầu ngắn với YOUR_MODEL.

Kiểm tra thành công​

Sau khi CC Switch nhập cấu hình, chạy Gemini CLI từ terminal mới. Yêu cầu với YOUR_MODEL phải hoàn tất mới được coi là thành công.

Lỗi thường gặp và cách khôi phục​

  • Nếu CC Switch nhập thất bại, làm theo hướng dẫn khôi phục của nó thay vì thử tên biến chưa xác minh.
  • Với 401, dán lại YOUR_API_KEY và bỏ khoảng trắng ở hai đầu.
  • Với 404, kiểm tra cấp Base URL và bảo đảm ứng dụng không nối /v1 hai lần.