Lỗi 401 Codex CLI: khắc phục đúng tuyến xác thực

Lỗi 401 của Codex CLI có nghĩa là máy chủ xử lý yêu cầu đã từ chối xác thực. Kiểm tra hữu ích nhanh nhất là kết hợp giữa máy chủ đích, nhà cung cấp đã chọn và nguồn thông tin xác thực. Biến môi trường trống là một khả năng; đó không phải lời giải thích cho mọi lỗi 401. Hãy làm theo nhánh phù hợp với thiết lập của bạn.

Trước tiên xác định kết nối nào đã thất bại

Hãy lưu trạng thái, nội dung lỗi, dấu thời gian và request ID nếu có. Xóa header ủy quyền, khóa và token trước khi chia sẻ chi tiết. Đừng dán auth.json vào phiếu hỗ trợ: nó có thể chứa thông tin xác thực. Lỗi từ một tích hợp không chứng minh rằng kết nối mô hình bị hỏng.

1. Kiểm tra CLI và phương thức đăng nhập

codex --version
codex login status

# POSIX shell: report presence only, without printing the secret
if [ -n "${KUNAVO_API_KEY:-}" ]; then
  printf 'KUNAVO_API_KEY is set\n'
else
  printf 'KUNAVO_API_KEY is missing or empty\n'
fi

Chạy các bước kiểm tra trong cùng terminal dùng để khởi chạy Codex. Thay tên biến trong bước kiểm tra sự hiện diện nếu nhà cung cấp của bạn sử dụng một env_key khác. “Đã đặt” chỉ xác nhận rằng một giá trị tồn tại; không thể chứng minh giá trị đó hiện tại hoặc được đích đến chấp nhận.

Nếu đăng nhập ChatGPT cá nhân đã ngừng làm mới, hãy dùng codex logout rồi đến codex login, sau đó hoàn tất quy trình trên trình duyệt cho tài khoản dự định. Thao tác này thay đổi trạng thái đăng nhập đã lưu; đây không phải bước bắt buộc cho mọi lỗi nhà cung cấp tùy chỉnh. Trong tự động hóa được quản lý, hãy tuân theo phương thức xác thực của quản trị viên. Xem hướng dẫn xác thực chính thức.

2. Ghép khóa API với bên phát hành và đích đến

Khóa OpenAI Platform thuộc tuyến OpenAI API. Khóa Kunavo thuộc tuyến Kunavo. Đăng nhập ChatGPT thành công trên trình duyệt không xác thực khóa gateway, và số dư gateway không phải số dư OpenAI Platform. Hãy kiểm tra host thực tế trong lỗi trước khi thay thế bất cứ thứ gì.

Trong dashboard của bên phát hành, xác nhận rằng khóa vẫn tồn tại và đang hoạt động. Kiểm tra project liên kết và mọi hạn chế truy cập. Tài liệu tham khảo lỗi OpenAI API liệt kê thông tin xác thực không hợp lệ, tư cách thành viên tổ chức và lỗi danh sách IP cho phép trong nhóm lỗi xác thực. Dùng thông báo đi kèm để chọn cách sửa; liên tục tạo khóa mới không sửa được tài khoản hoặc chính sách mạng.

3. Kiểm tra cấu hình nhà cung cấp mà Codex sử dụng

# Compare these non-secret fields with your intended provider.
model = "gpt-5-6-sol"
model_provider = "kunavo"

[model_providers.kunavo]
name = "Kunavo"
base_url = "https://api.kunavo.com/v1"
env_key = "KUNAVO_API_KEY"
wire_api = "responses"

model_provider đã chọn phải khớp với block nhà cung cấp. Trường env_key chỉ định tên biến; nó không chứa bí mật. Xác minh cấu hình đang hoạt động và mọi override từ profile hoặc dòng lệnh, sau đó khởi động lại Codex sau khi sửa. Tránh sao chép một block nhà cung cấp không liên quan đè lên cấu hình đang hoạt động.

Tài liệu tham khảo cấu hình của OpenAI mô tả giao thức Responses. Base URL kết thúc bằng /v1 khác với URL yêu cầu /v1/responses đầy đủ. Sai đường dẫn thường cần chẩn đoán endpoint ngay cả sau khi xác thực thành công. Đồng thời kiểm tra requires_openai_auth: khi bật, xác thực OpenAI được ưu tiên hơn env_key, như mô tả trong hướng dẫn xác thực.

4. Thay đổi một thứ và thử lại một tác vụ nhỏ

1. Giữ lại chi tiết lỗi và xác định tuyến đã chọn.
2. Sửa thông tin đăng nhập, thông tin xác thực hoặc trường nhà cung cấp mà bằng chứng chỉ ra.
3. Khởi động lại tiến trình CLI hoặc trình chỉnh sửa bị ảnh hưởng để tiến trình nhận cài đặt mới.
4. Chạy một yêu cầu nhỏ trước khi khởi động lại tác vụ lập trình dài.
5. Nếu lỗi vẫn tiếp diễn, gửi cho nhà cung cấp lỗi đã ẩn thông tin nhạy cảm và request ID, không gửi thông tin xác thực.

Lỗi 429 xuất hiện sau đó, cảnh báo số dư hoặc lỗi thiếu mô hình là một nhánh chẩn đoán mới. Giữ nguyên cách sửa xác thực và xử lý vấn đề tiếp theo thay vì hoàn tác mọi cài đặt. Hướng dẫn giới hạn Codex phân biệt các trường hợp đó. Với thiết lập Kunavo, hãy dùng đầy đủ tích hợp Codex và quản lý khóa trong dashboard của bạn.

Câu hỏi thường gặp

Đã kiểm tra tài liệu chính thức và trợ giúp CLI cục bộ vào ngày 17 tháng 9 năm 2026. Không cần chia sẻ thông tin xác thực để thực hiện các bước kiểm tra này.