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

Codex App + CLI

Codex App và CLI dùng chung cấu hình Provider cục bộ và kết nối PopGo API qua Responses wire API.

Trước khi cấu hình​

  • Trang này chỉ dùng placeholder. Key thật lấy từ trang PopGo API keys, mô hình lấy từ models and pricing.
  • Cấu hình một click dành cho phần mềm đã cài và đã đăng ký protocol handler. Khi trình duyệt hỏi mở ứng dụng ngoài, hãy cho phép.
  • Khi cấu hình thủ công, lưu một Provider tối thiểu trước. Chỉ bật streaming, tools hoặc định tuyến nhiều mô hình sau khi yêu cầu đầu tiên thành công.

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

Codex App + CLI 0.144.4 đã được đối chiếu với nguồn chính thức vào 2026-07-14. Nguồn chính thức. Đã xác minh cấu trúc Provider chính thức và cấu hình cục bộ dùng chung cho App và CLI.

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 nhập, kiểm tra Base URL kết thúc bằng /v1; App và CLI đọc cùng một cấu hình cục bộ.

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 Codex; không cần cấu hình App và CLI riêng.

export POPGO_API_KEY="YOUR_API_KEY"
$env: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"
  • Tệp cấu hình thường nằm trong .codex/config.toml dưới thư mục người dùng: Windows là %USERPROFILE%\.codex\config.toml, macOS/Linux là ~/.codex/config.toml.
  • Key được đọc từ POPGO_API_KEY. Không ghi Key thật vào config.toml hoặc ảnh chụp công khai.

Bổ sung cài đặt và cấu hình đa nền tảng​

  1. Kiểm tra node --version và npm --version, sau đó cài CLI theo cách chính thức của Codex.
  2. Tệp cấu hình thường ở %USERPROFILE%\.codex\config.toml trên Windows hoặc ~/.codex/config.toml trên macOS/Linux.
  3. Đặt POPGO_API_KEY trong đúng terminal khởi động Codex. Không ghi Key thật vào tệp:
$env:POPGO_API_KEY = "YOUR_API_KEY"

Dùng ID mô hình hiện tại cho model. model_provider phải trùng tên khối Provider, env_key phải là POPGO_API_KEY, còn wire_api là responses. Sửa xong hãy khởi động lại App hoặc CLI.

Kiểm tra thành công​

Khởi động CLI từ terminal đã cấu hình hoặc mở lại App, rồi gửi yêu cầu bằng YOUR_MODEL.

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, sau đó khởi động lại CLI hoặc mở lại App.
  • 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.