Sổ tay xử lý lỗi

Khi Codex không chạy đúng, đừng tăng quyền hoặc đổi mọi thứ cùng lúc. Hãy thu hẹp nguyên nhân theo lớp: tài khoản, workspace, quyền, dependency, lệnh, mạng và provider.

Codex không hiểu dự án

Triệu chứng:

• Trả lời chung chung.
• Sửa nhầm file.
• Không biết lệnh test/build.

Cách xử lý:

Chỉ đọc repo hiện tại. Hãy lập bản đồ thư mục, tìm package manager,
lệnh test/build và file cấu hình quan trọng. Không sửa file.

Sau đó thêm AGENTS.md với lệnh và ranh giới dự án.

Codex sửa quá rộng

Nguyên nhân thường là prompt mơ hồ hoặc không có phạm vi. Hãy yêu cầu:

Hãy dừng lại. Tóm tắt file đã sửa và vì sao.
Chỉ giữ lại thay đổi trong [file/module], không refactor ngoài phạm vi.

Luôn kiểm tra git diff trước khi tiếp tục.

Test không chạy được

Kiểm tra:

• Dependency đã cài chưa.
• Lệnh chạy đúng package manager chưa.
• Cần env var hoặc service nền không.
• Test fail do code mới hay do môi trường.

Yêu cầu Codex phân loại:

Hãy đọc log test và phân loại: lỗi do môi trường, dependency,
test flaky hay regression từ thay đổi hiện tại. Chưa sửa file.

Output không chính xác

Cho Codex thêm nguồn kiểm chứng:

• File liên quan.
• Log đầy đủ.
• Screenshot.
• Kết quả lệnh.
• Link tài liệu chính thức.

Đừng yêu cầu nó đoán trên mô tả thiếu dữ liệu.

Lỗi đăng nhập hoặc quyền

Kiểm tra:

• Đúng tài khoản ChatGPT / OpenAI chưa.
• Gói tài khoản có hỗ trợ Codex không.
• Khu vực hoặc proxy có chặn không.
• Workspace đã được cấp quyền chưa.
• Organization policy có hạn chế không.

Sau khi đổi provider không thấy phiên cũ

Một số lịch sử hoặc session có thể gắn với provider, profile hoặc bề mặt sử dụng. Hãy kiểm tra lại config, profile đang active và tài khoản đang đăng nhập. Không xóa cấu hình cũ nếu chưa backup.

Checklist khôi phục nhanh

1. Lưu trạng thái hiện tại bằng git status.
2. Không chạy lệnh xóa/ghi đè khi chưa hiểu lỗi.
3. Chạy lại tác vụ ở chế độ chỉ đọc.
4. Thu hẹp phạm vi còn một file hoặc một command.
5. Sau khi sửa, chạy test nhỏ nhất liên quan.
6. Ghi lại nguyên nhân và cách kiểm chứng vào tài liệu đội nhóm.

Tiếp theo nên đọc: Phương pháp thực hành