Khắc phục sự cố Codex
Trọng tâm khi khắc phục sự cố Codex là giao diện tương thích OpenAI. Thông thường, hãy khắc phục sự cố theo thứ tự sau: Base URL, Key, tên model, liệu Provider hiện tại có đang hiệu lực hay không.
Cần xác nhận điều gì trước tiên?
| Mục kiểm tra | Cách xem | Lý do |
|---|---|---|
| Provider hỗ trợ giao diện tương thích OpenAI | Trang quản trị hiển thị địa chỉ API, Base URL, độ tương thích OpenAI và các hướng dẫn khác | Codex cần có khả năng gửi yêu cầu tới giao diện tương thích |
| Base URL | Sao chép liên kết API do provider cung cấp | Có cần /v1 hay không hãy làm theo ví dụ ở trang quản trị, không tự đoán |
| Trạng thái Key | Key không bị vô hiệu hóa, chưa hết hạn và số dư tài khoản bình thường | Lỗi 401 hầu hết bắt đầu từ việc kiểm tra Key |
| Tên model | Sao chép theo danh sách model trong trang quản trị | Tên model, chữ hoa/thường, dấu gạch nối hoặc số phiên bản nếu viết sai đều sẽ gây lỗi |
Các lỗi thường gặp
| Hiện tượng | Ưu tiên kiểm tra | Giải pháp |
|---|---|---|
| 401 / Unauthorized | API Key | Tạo lại hoặc sao chép Key, đồng thời xác nhận rằng Key không bị vô hiệu hóa, chưa hết hạn và số dư tài khoản bình thường. |
| 404 / model not found | Tên model | Không viết tên model theo trí nhớ; hãy sao chép theo danh sách model trong trang quản trị của provider. Nếu hỗ trợ lấy danh sách model, hãy tải danh sách trước; nếu thất bại, hãy thêm thủ công. |
| Lỗi liên quan đến Base URL | Liên kết API có đầy đủ không | Base URL là liên kết API do provider cung cấp. Có cần /v1 hay không hãy làm theo ví dụ ở trang quản trị, đừng tự đoán. |
| Yêu cầu không gửi được nhưng Key bình thường | Giao thức có khớp không | Xác nhận rằng provider hiện tại cung cấp giao diện tương thích OpenAI, không phải Claude, Gemini hoặc giao diện chỉ hỗ trợ web chat. |
| Không có hiệu lực sau khi dùng CC-Switch | Lựa chọn công cụ đích | Đảm bảo Provider được áp dụng cho Codex chứ không phải Claude Code; khởi động lại terminal hoặc client trước khi thử lại. |
Kiểm tra tối giản
Hãy thử nghiệm với câu hỏi ngắn nhất trước để xác nhận yêu cầu gửi thành công trước khi xử lý dự án thực tế.
Kiểm tra tối giản Codex
codex "Please reply only: Codex configuration test successful"Mẫu gửi phản hồi
Khi gửi phản hồi cho provider, hãy viết như sau
Tool: Codex 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