Khắc phục sự cố Composer

Các hiện tượng dưới đây áp dụng cho route Codex — agent hiện đang được Composer hỗ trợ. Chúng tôi đang tích hợp thêm nhiều agent khác và mỗi agent sẽ có mục hướng dẫn riêng tại đây.

Đây là những vấn đề bạn dễ gặp khi dùng Nexus Composer và chỗ nên kiểm tra trước — phần lớn bắt nguồn từ ba nguyên nhân: tài khoản Nexus chưa được kết nối, đã đổi route nhưng chưa khởi động lại client, hoặc ứng dụng Composer chưa chạy.

Tải về và cài đặt

Hiện tượng	Nguyên nhân thường gặp	Các bước kiểm tra tiếp theo
Nút tải về vẫn bị vô hiệu hóa (disabled)	Release feed hoặc bộ cài đặt hiện tại chưa vượt qua bước kiểm định	Tải lại trang chính thức sau một lúc; đừng dùng nguồn mirror không chính thức. Hãy liên hệ đầu mối onboarding nếu tình trạng này vẫn tiếp diễn.
macOS chặn file cài đặt	Trạng thái ký số (code signing) của bản pilot cần được xác nhận	Đảm bảo file được tải về từ trang chính thức, sau đó trao đổi với đầu mối onboarding trước khi bỏ qua cảnh báo bảo mật.
Bộ cài đặt không chạy được trên máy	Hệ điều hành hoặc kiến trúc CPU chưa được hỗ trợ	Yêu cầu macOS 14+ (chạy chip Intel hoặc Apple silicon), hoặc Windows (x64 hay ARM64) — trên Windows, hãy kiểm tra xem bạn đã tải đúng bộ cài cho kiến trúc chip của máy hay chưa (Settings → System → About → System type). Linux (Ubuntu 24.04+) sắp có.

Model và routing

Hiện tượng	Nguyên nhân thường gặp	Các bước kiểm tra tiếp theo
Không thấy model OneNexus trong model picker	Chưa kết nối tài khoản Nexus, chưa chọn route, hoặc chưa khởi động lại client	Đảm bảo trạng thái hiển thị Connected, card OneNexus ở trạng thái Active, sau đó thoát và mở lại client.
Chỉ hiển thị model từ OpenAI Official	Route mới chưa có hiệu lực	Kiểm tra card OneNexus và đảm bảo local proxy đang ở trạng thái Running.
Chỉ hiển thị model OneNexus	Đang bật chế độ không đăng nhập (signed-out mode)	Kiểm tra tùy chọn Use OneNexus without ChatGPT sign-in trên card OneNexus.
Chọn OneNexus thì nhận được thông báo yêu cầu đăng nhập	Codex chưa có session ChatGPT	Đăng nhập ChatGPT trong Codex, hoặc bật chế độ không đăng nhập trên Composer.
Model mới bổ sung không xuất hiện	Catalog model đã cũ (chưa được đồng bộ)	Xác thực lại (revalidate) tài khoản Nexus, sau đó khởi động lại Codex Desktop.
Request báo lỗi ngay lập tức	Local proxy không chạy	Kiểm tra xem Composer còn đang chạy không, và trong Settings → Routing, mục Local Routing có đang ở trạng thái Running không.
OpenAI Official bị lỗi sau khi thoát Composer	Route vẫn đang trỏ về OneNexus	Mở lại Composer, chọn OpenAI Official, sau đó khởi động lại Codex.
Xuất hiện cảnh báo xung đột profile	Đang có một profile Codex tùy biến không do Composer quản lý	Hãy khôi phục lại profile OpenAI Official chuẩn trước — tránh để Composer vô tình ghi đè lên cấu hình riêng của bạn.
Trong VS Code, Composer cảnh báo có group OneNexus mà nó không quản lý	Đã tồn tại sẵn một model group trùng tên mà không phải do Composer tạo ra	Đổi tên model group riêng của bạn trước khi kích hoạt route — đừng để Composer ghi đè lên group mà nó không quản lý.
Composer báo chưa cài đặt Codex	Máy chưa cài Codex, hoặc có nhiều bản cài đặt xung đột nhau	Vào Settings → About, sau đó chọn Diagnose installs.

Thông tin xác thực

Hiện tượng	Nguyên nhân thường gặp	Các bước kiểm tra tiếp theo
API key bị từ chối	Sai phạm vi của key, sai tenant, key đã bị thu hồi hoặc mất kết nối mạng	Trong Suy luận (Inference) → Khóa API (API Keys), xác nhận Loại (Type) là Nền tảng (Platform), Trạng thái (Status) là Đang hoạt động (Active), kiểm tra tenant và kết nối mạng, rồi tạo key thay thế nếu key đã bị thu hồi.
Không đọc được thông tin xác thực đã lưu	Credential store của hệ điều hành đang bị khóa	Mở khóa credential store, sau đó chọn Check again.

Phiên làm việc (Session)

Session dùng chung theo cả hai chiều: đổi provider hay model không xóa session, cũng không khiến session bị kẹt lại ở provider cũ; cuộc hội thoại bắt đầu trên provider này thường vẫn tiếp tục được trên provider kia.

Khi đổi, Composer chỉ thay đổi upstream cho các request tiếp theo — không bao giờ gửi lại (replay) request cũ, cũng không gửi một request tới cả hai provider.

Ngoại lệ là các cuộc hội thoại có chứa encrypted reasoning item — chỉ backend đã tạo ra các item này mới đọc được chúng, nên cuộc hội thoại đó có thể không resume được sau khi đổi provider. Khi gặp tình huống này, hãy đổi lại về provider đã khởi tạo session hoặc bắt đầu một cuộc hội thoại mới. Đừng vội xóa lịch sử Codex hay file xác thực: làm vậy sẽ mất dữ liệu của bạn mà hiếm khi giải quyết được vấn đề.

Usage Statistics không có dữ liệu

Composer chỉ ghi nhận các AI request đã hoàn tất. Hãy thử gửi một synthetic request qua Composer, đợi giao diện tự cập nhật và mở rộng bộ lọc thời gian, provider cùng model — chỉ mở Composer thôi thì không tạo ra bản ghi nào.

Giao diện trống khi đã mở rộng khoảng thời gian chỉ đơn giản là chưa có request nào hoàn tất qua Composer — không phải tính năng ghi nhận số liệu bị lỗi.

Khi cần hỗ trợ

Hãy chuẩn bị các thông tin sau để gửi cho đầu mối onboarding của bạn, hoặc gửi tới data-center@onemount.com nếu bạn không còn đầu mối nào:

• Phiên bản Composer, hệ điều hành và kiến trúc CPU của máy.
• Phiên bản Codex đang sử dụng.
• Route đang được chọn — OpenAI Official hay OneNexus — cùng với model ID tương ứng.
• Thời điểm gần đúng khi request bị lỗi, và lúc đó proxy có đang Running hay không.
• Thông báo lỗi hiển thị trên màn hình và log đã được sanitize (lọc sạch thông tin nhạy cảm).

Tuyệt đối không gửi các thông tin sau

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