Khắc phục sự cố Claude Code
Trọng tâm của việc khắc phục sự cố Claude Code là xác nhận xem công cụ đã nhận cấu hình Claude / Anthropic hay chưa. Không trộn lẫn địa chỉ tương thích OpenAI, tên mô hình Codex hoặc Key Gemini vào Claude Code.
Cần xác nhận điều gì trước tiên?
| Mục kiểm tra | Cách kiểm tra | Lý do |
|---|---|---|
| Công cụ mục tiêu | Đảm bảo bạn đang xử lý sự cố cho Claude Code, không phải Codex hay Gemini CLI | Tệp cấu hình, giao thức và tên mô hình của các công cụ khác nhau là khác nhau. |
| Giao thức của provider | Claude, Anthropic và Claude Code được đề cập rõ ràng trong trang quản trị hoặc hướng dẫn | Các provider chỉ cung cấp giao diện tương thích OpenAI có thể không hỗ trợ Claude Code |
| Loại Key | Sử dụng Key tương ứng cho Claude / Anthropic | Nếu loại key không đúng, sẽ trực tiếp dẫn đến lỗi 401 hoặc xác thực thất bại |
| Trạng thái terminal | Sau khi chuyển đổi cấu hình, hãy mở lại terminal và kiểm tra lại | Terminal cũ có thể vẫn đang dùng các biến môi trường hoặc cấu hình từ trước khi chuyển đổi |
Các lỗi thường gặp
| Hiện tượng | Ưu tiên kiểm tra | Giải pháp |
|---|---|---|
| Lệnh có thể khởi chạy nhưng yêu cầu thất bại | Claude Code đã nhận cấu hình mới hay chưa | Đóng cửa sổ terminal hiện tại và mở lại, sau đó gửi câu hỏi kiểm tra ngắn nhất. Sau khi chuyển đổi qua CC-Switch, không chỉnh sửa thủ công cùng một cấu hình tại thời điểm đó. |
| 401 / Unauthorized | Loại Key và tính toàn vẹn | Xác nhận rằng bạn đang dùng Key tương ứng cho Claude / Anthropic, không điền Key tương thích OpenAI vào Claude Code; kiểm tra khoảng trắng ở đầu và cuối khi sao chép lại. |
| 404 / model not found | Tên mô hình Claude | Điền chính xác như danh sách mô hình Claude trong trang quản trị của provider, không thay đổi chữ hoa/thường, dấu gạch nối hoặc số phiên bản. |
| Hết thời gian kết nối hoặc không phản hồi | Claude Base URL | Kiểm tra địa chỉ API Claude / Anthropic trong trang quản trị; các provider chỉ cung cấp địa chỉ tương thích OpenAI có thể không hỗ trợ Claude Code. |
| Vẫn dùng provider cũ sau khi chuyển đổi | Phiên terminal và nguồn cấu hình | Mở lại terminal và kiểm tra lại; nếu vẫn chưa có hiệu lực, hãy xác nhận xem Provider hiện tại trong CC-Switch đã được áp dụng cho Claude Code chưa. |
Kiểm tra tối giản
Khi kiểm tra, trước tiên hãy gửi một câu hỏi ngắn cố định, xác nhận có thể phản hồi rồi mới chuyển sang dự án thực tế.
Kiểm tra tối giản Claude Code
claude "Please reply only: Claude Code configuration test successful"Mẫu phản hồi lỗi
Khi gửi phản hồi cho provider, hãy viết như sau
Tool: Claude Code 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