Khắc phục sự cố Gemini
Giao diện tương thích OpenAI và Gemini không phải là một. Bạn chỉ nên cấu hình theo Gemini nếu nhà cung cấp chỉ định 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 ghi rõ có hỗ trợ Gemini CLI.
Cần xác nhận những gì trước tiên?
| Hạng mục kiểm tra | Cách kiểm tra | Lý do |
|---|---|---|
| Công cụ đích | Xác nhận bạn đang khắc phục sự cố cho Gemini CLI | Phương thức xác thực của Gemini CLI khác với Codex và Claude Code |
| Nhà cung cấp có hỗ trợ Gemini | Có các mục liên quan đến Gemini / Google / Vertex trong trang quản trị 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 | Sử dụng Key tương ứng cho Gemini hoặc Vertex | Nếu loại Key không đúng, bạn có thể gặp lỗi 401, 403 hoặc liên tục bị yêu cầu đăng nhập |
| Tên mô hình | Điền theo danh sách mô hình Gemini | Không nhập tên mô hình OpenAI hoặc Claude vào Gemini |
Các lỗi thường gặp
| Hiện tượng | Ưu tiên kiểm tra | Giải pháp |
|---|---|---|
| Vẫn yêu cầu đăng nhập Google | Xác thực riêng của Gemini CLI | Trước tiên hãy hoàn tất xác thực theo lời nhắc của Gemini CLI; cấu hình của nhà cung cấp không thể thay thế quy trình đăng nhập mà bản thân công cụ đích yêu cầu. |
| 401 / 403 | Gemini Key hoặc quyền truy cập | Xác nhận rằng Key thuộc nhóm Gemini / Google / Vertex, và dự án hoặc tài khoản hiện tại có quyền truy cập vào mô hình tương ứng. |
| 404 / model not found | Tên mô hình Gemini | Điền theo danh sách mô hình Gemini trong trang quản trị của nhà cung cấp; không nhập tên mô hình OpenAI hoặc Claude. |
| Kết nối thất bại | Gemini Base URL | Không nhập Base URL tương thích OpenAI thông thường vào Gemini; chỉ cấu hình khi trang quản trị ghi rõ hỗ trợ Gemini. |
| Không có thay đổi sau khi chuyển đổi CC-Switch | Công cụ đích và trạng thái terminal | Xác nhận mục tiêu áp dụng là Gemini CLI, lưu lại, sau đó mở lại terminal và kiểm tra lại. |
Kiểm tra tối thiểu
Trước tiên hãy xác nhận rằng Gemini CLI có thể trả về một câu ngắn cố định, sau đó mới tiếp tục khắc phục sự cố cho các tác vụ phức tạp hơn.
Kiểm tra tối thiểu Gemini
gemini "Please reply only: Gemini configuration test successful"Mẫu gửi phản hồi
Khi phản hồi cho nhà cung cấp, hãy viết như thế này
Tool: Gemini System version: Provider dashboard Base URL: Model ID / model name: Exact error: I have checked: no spaces in the Key / balance is sufficient / model name copied exactly / Base URL copied from the dashboard / terminal reopened