Chuyển tới nội dung chính

Codex CLI

Codex CLI dùng model_provider tùy chỉnh với Responses wire API.

Nguồn chính thức và xác minh​

Codex CLI 0.144.3 đã được đối chiếu với nguồn chính thức vào 2026-07-13. Nguồn chính thức. Đã xác minh cấu trúc Provider tùy chỉnh trong tài liệu cấu hình chính thức.

Cấu hình một lần chạm​

Đăng nhập trang khóa PopGo API rồi mở menu thao tác tại hàng Key cần dùng. Tài liệu công khai không tạo hoặc hiển thị liên kết chứa Key. Chọn CC Switch, sau đó chọn Codex. Sau khi chọn Codex, kiểm tra Base URL đã nhập kết thúc ở cấp /v1.

Cấu hình thủ công​

Đặt POPGO_API_KEY trong terminal rồi thêm khối Provider bên dưới vào tệp cấu hình Codex.

export POPGO_API_KEY="YOUR_API_KEY"
model = "YOUR_MODEL"
model_provider = "popgo"

[model_providers.popgo]
name = "PopGo"
base_url = "https://api.popgo.site/v1"
env_key = "POPGO_API_KEY"
wire_api = "responses"

Kiểm tra thành công​

Mở phiên mới từ terminal có biến môi trường và gửi yêu cầu bằng YOUR_MODEL. Gửi một yêu cầu thử mới với YOUR_MODEL. Phản hồi bình thường, không có lỗi xác thực hoặc địa chỉ, xác nhận kết nối thành công.

Lỗi thường gặp và cách khôi phục​

  • Nếu báo thiếu Key, kiểm tra đúng tên POPGO_API_KEY và khởi động lại từ terminal hiện tại.
  • Với 401, dán lại YOUR_API_KEY và bỏ khoảng trắng ở hai đầu.
  • Với 404, kiểm tra cấp Base URL và bảo đảm ứng dụng không nối /v1 hai lần.