CC-Switch Gemini
Trang này hướng dẫn cách áp dụng các nhà cung cấp (provider) liên quan đến Gemini cho Gemini CLI thông qua CC Switch. Giao diện và phương thức xác thực của Gemini khác với các giao diện tương thích OpenAI, vì vậy bạn không thể chỉ điền Base URL thông thường của OpenAI rồi coi như dùng được cho Gemini.
Thông tin chính thức Tải xuống và tài liệu vui lòng tham khảo trang web chính thức.
Nội dung trang này giải thích
Bạn chỉ nên cấu hình Gemini trong CC Switch khi nhà cung cấp cung cấp rõ ràng các giao diện liên quan đến Gemini / Google / Vertex, hoặc tài liệu hướng dẫn nêu rõ việc hỗ trợ Gemini CLI.
Xác nhận trước khi bắt đầu
| Hạng mục cần xác nhận | Cách kiểm tra | Lý do |
|---|---|---|
| Gemini CLI hiện có thể khởi chạy | Trước tiên, hãy xác nhận rằng Gemini CLI có thể mở được trên máy này | CC Switch chỉ chịu trách nhiệm chuyển đổi cấu hình |
| Nhà cung cấp hỗ trợ Gemini | Có các mục liên quan đến Gemini / Google / Vertex trong trang quản lý hoặc hướng dẫn | Giao diện tương thích OpenAI không giống với giao diện Gemini |
| Loại Key chính xác | Xác nhận rằng Key tương ứng với Gemini hoặc Vertex | Loại Key không chính xác sẽ dẫn đến xác thực thất bại |
| Tên mô hình lấy từ danh sách Gemini | Sao chép tên mô hình Gemini từ trang quản lý của nhà cung cấp | Không sử dụng lẫn lộn tên mô hình Claude hoặc OpenAI |
Cách điền các trường
| Thiết lập | Cách điền | Người mới cần lưu ý |
|---|---|---|
| Tên nhà cung cấp (Provider Name) | Nêu rõ mục đích | Ví dụ: 'Gemini provider' hoặc 'Google Gemini' |
| Công cụ mục tiêu / Preset | Chọn các preset liên quan đến Gemini hoặc Google / Vertex | Không chọn các preset tương thích OpenAI |
| Base URL | Sao chép địa chỉ giao diện tương ứng với Gemini | Nếu trang quản lý chỉ cung cấp địa chỉ OpenAI, tạm thời đừng cố điền vào |
| API Key | Sao chép Key tương ứng với Gemini / Vertex | Loại Key phải tương ứng với Base URL |
| Tên mô hình (Model Name) | Sao chép danh sách mô hình Gemini | Tên mô hình thường khác với OpenAI và Claude |
Áp dụng cho Gemini
- Mở CC Switch và đi đến khu vực quản lý Provider.
- Thêm một Gemini Provider mới, hoặc chọn một Gemini Provider đã được cấu hình trước đó.
- Chọn preset liên quan đến Gemini CLI làm công cụ mục tiêu.
- Điền Base URL, API Key và tên mô hình tương ứng cho Gemini.
- Sau khi lưu, thực hiện Apply / Switch.
- Mở lại terminal, sau đó thực hiện kiểm tra tối thiểu bằng Gemini CLI.
Kiểm tra xem đã hoạt động chưa
Nguyên nhân phổ biến nhất khiến cấu hình Gemini thất bại là do điền địa chỉ tương thích OpenAI vào Gemini, hoặc loại Key không khớp với địa chỉ giao diện.
Kiểm tra tối thiểu Gemini
gemini "Please reply only: CC-Switch Gemini is active"Nếu Gemini CLI vẫn yêu cầu đăng nhập Google, trước tiên hãy làm theo các hướng dẫn của chính Gemini CLI; CC Switch chỉ có thể đồng bộ hóa cấu hình của các Provider mà nó hỗ trợ và không thể bỏ qua các yêu cầu đăng nhập của chính công cụ mục tiêu.