Khắc phục sự cố Composer

Các triệu chứng dưới đây dành cho Codex route, agent mà Composer hỗ trợ hiện nay. Chúng tôi đang bổ sung thêm agent, và mỗi agent sẽ có mục riêng ở đây.

Những symptom thường gặp với Nexus Composer và chỗ cần kiểm tra trước — phần lớn đến từ ba nguyên nhân: Nexus account chưa kết nối, đã đổi route nhưng chưa restart client, hoặc Composer không chạy.

Download và install

Symptom	Nguyên nhân thường gặp	Kiểm tra tiếp
Download button vẫn disabled	Release feed hoặc installer hiện có không qua validation	Reload trang chính thức sau; không dùng mirror không chính thức. Liên hệ onboarding nếu lỗi vẫn tiếp diễn.
macOS chặn installer	Signing status của pilot build cần được xác nhận	Xác nhận file đến từ trang chính thức, rồi hỏi onboarding trước khi bỏ qua warning.
Installer không chạy được trên máy	Hệ điều hành hoặc CPU không được hỗ trợ	Dùng macOS 14+ trên Apple Silicon. Windows x64 và Linux (Ubuntu 24.04+) sắp có. Hiện chưa hỗ trợ Mac Intel và Windows on ARM.

Model và routing

Hiện tượng	Nguyên nhân thường gặp	Kiểm tra tiếp
Không thấy OneNexus model trong picker	Thiếu Nexus account, route, hoặc chưa restart	Status Connected, card OneNexus hiển thị Active, rồi thoát và mở lại client
Chỉ thấy model từ OpenAI Official	Route chưa có hiệu lực	Card OneNexus, và proxy đang Running
Chỉ thấy OneNexus model	Signed-out mode đang bật	Use OneNexus without ChatGPT sign-in trên card OneNexus
Chọn OneNexus thì báo cần login	Codex chưa có ChatGPT session	Login ChatGPT trong Codex, hoặc bật signed-out mode
Model mới thêm không xuất hiện	Catalog đã cũ	Validate lại Nexus account, rồi restart Codex Desktop
Request lỗi ngay lập tức	Không có proxy	Composer còn chạy không, và Settings → Routing có Running không
OpenAI Official lỗi sau khi thoát Composer	Route vẫn đang để ở OneNexus	Mở lại Composer, chọn OpenAI Official, restart Codex
Hiện cảnh báo xung đột profile	Một profile Codex tùy biến không do Composer quản lý	Khôi phục profile OpenAI Official bình thường trước — đừng để nó bị ghi đè bừa
Composer báo group OneNexus không do nó quản lý trong VS Code	Đã tồn tại model group trùng tên mà Composer không tạo ra	Đổi tên group của bạn trước khi bật route — đừng để Composer ghi đè group không do nó quản lý
Composer báo chưa cài Codex	Thiếu Codex, hoặc nhiều installation xung đột	Settings → About, rồi Diagnose installs

Thông tin xác thực

Hiện tượng	Nguyên nhân thường gặp	Kiểm tra tiếp
API key bị từ chối	Sai key scope, sai tenant, đã revoke hoặc mất network	Trong Khóa API (API Keys), xác nhận Loại (Type) là Platform, Trạng thái (Status) là Đang hoạt động (Active), kiểm tra tenant/network, và tạo key thay thế nếu đã revoke.
Không đọc được thông tin xác thực đã lưu	Kho credential của hệ điều hành đang khóa	Mở khóa kho đó, rồi chọn Check again

Session

Session được chia sẻ theo cả hai chiều: đổi provider hay model không xóa và cũng không làm mất session; conversation bắt đầu trên provider này thường có thể tiếp tục trên provider kia.

Việc chuyển provider chỉ đổi upstream cho các request tiếp theo — Composer không replay request cũ và cũng không gửi request mới tới cả hai provider.

Ngoại lệ là conversation có encrypted reasoning item — chỉ backend tạo ra state đó mới đọc được, nên conversation có thể lỗi khi resume sau khi đổi provider. Khi gặp, hãy quay về provider đã tạo session hoặc mở conversation mới. Xóa Codex history hay authentication file không phải bước đầu tiên: làm vậy mất dữ liệu mà hiếm khi sửa được lỗi.

Usage Statistics không có record

Chỉ AI request đã hoàn tất mới được ghi. Hãy gửi synthetic request trong getting-started guide, đợi view refresh và mở rộng filter theo thời gian, provider và model — chỉ mở Composer không tạo usage record.

View trống với khoảng thời gian đã mở rộng nghĩa là chưa có request nào hoàn tất qua Composer — không phải việc ghi nhận bị hỏng.

Khi cần hỗ trợ

Gửi các thông tin sau cho đầu mối onboarding, hoặc tới data-center@onemount.com nếu bạn không còn đầu mối:

• Composer version, hệ điều hành và CPU architecture.
• Codex version.
• Route đang chọn — OpenAI Official hay OneNexus — và model ID.
• Thời điểm gần đúng của request lỗi và lúc đó proxy có Running không.
• Error message nhìn thấy được và log đã sanitize.

Tuyệt đối không gửi

Nexus API key. ChatGPT access token. auth.json. Toàn bộ config.toml. Nội dung prompt hoặc response. File session chứa dữ liệu riêng tư. Nếu bạn đã lỡ gửi một khóa đi đâu đó, hãy thu hồi nó trong console và kết nối khóa thay thế.