Bỏ qua để đến nội dung

Nexus Composer

Nexus Composer là ứng dụng desktop cho phép các AI agent mà đội ngũ của bạn đang sử dụng gọi các model do OneNexus vận hành — không phải đổi công cụ quen thuộc, cũng không phải tự cấu hình proxy hay model ID.

Codex Desktop, Codex CLI, VS Code, Claude Desktop và Claude Code CLI là các agent Composer đang hỗ trợ, và chúng tôi đang bổ sung thêm. Các bước thiết lập giống nhau cho mọi agent cho tới phần Chọn client, nơi mỗi agent có hướng dẫn riêng.

Composer cho phép bạn đổi provider đang dùng cho từng client. Mỗi request vẫn chỉ đi tới đúng một provider — không bao giờ tới cả hai. Khi bạn chọn OneNexus, local proxy sẽ chuyển đổi giao thức (protocol conversion) của client rồi gửi tiếp request.

Video hướng dẫn nhanh (1:30): sáu bước từ tạo API key tới gửi thử. Các bước chi tiết nằm ngay bên dưới.

Bạn cần chuẩn bị gì

Mục “Bạn cần chuẩn bị gì”
Yêu cầuChi tiết
Quyền dùng thử (Pilot access)Tài khoản pilot OneNexus và tenant đã được phê duyệt — nếu chưa có, hãy đăng ký dùng thử.
Hệ điều hànhmacOS 14 trở lên trên vi xử lý Intel hoặc Apple silicon, hoặc Windows x64 / ARM64. Linux (Ubuntu 24.04+) sắp có.
Client hỗ trợCodex Desktop, Codex CLI, VS Code, Claude Desktop hoặc Claude Code CLI — các agent được hỗ trợ hiện nay. Chúng tôi đang tiếp tục bổ sung thêm.
Nexus API keyPlatform API key lấy từ Console. Truy cập Suy luận (Inference) → Khóa API (API Keys) → Tạo khóa API (Generate API key), đặt Loại (Type) thành Platform, sau đó sao chép secret khi Console hiển thị.
Đăng nhập ChatGPTChỉ cần thiết khi sử dụng các model OpenAI Official trong Codex.
Đăng nhập ClaudeChỉ cần thiết khi muốn giữ lại các model gốc của Claude trong Claude Code CLI (chế độ Claude + OneNexus).
Kết nối mạngCho phép kết nối outbound tới OneNexus, tới OpenAI khi dùng OpenAI Official, và tới Anthropic khi dùng model của Claude.

Lưu ý: Inference key chỉ cấp quyền cho Served Model Name của các self-hosted model đã chọn, không gọi được catalog model do OneNexus vận hành mà Composer sử dụng; key này cũng gọi được model thay thế (replacement) nào tiếp tục dùng một Served Model Name đã được cấp quyền. Platform key chính là loại credential Composer cần — key này gọi được mọi model đã phát hành trong catalog, kể cả model được thêm sau này, và không thể thu hẹp phạm vi. Nếu chưa chắc chắn, hãy kiểm tra cột Loại (Type) trong Suy luận (Inference) → Khóa API (API Keys): Platform key sẽ hiển thị Platform.

Composer tự kiểm tra phiên bản client có tương thích không — sau khi cài đặt, mở Settings → About để xem phiên bản tối thiểu hiện tại; con số này thay đổi theo các bản phát hành của client.

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

Mục “Tải về và cài đặt Composer”

Chỉ tải bộ cài đặt từ trang tải về Nexus Composer chính thức. Trang này kiểm tra release manifest và mọi bộ cài đang cung cấp trước khi cho phép tải về.

Nếu đường link tải tạm thời không khả dụng, hãy tải lại trang sau ít phút hoặc liên hệ đầu mối onboarding của bạn — đừng tải bộ cài đặt từ các nguồn mirror không chính thức.

macOS

Mục “macOS”

Một bộ cài đặt universal hỗ trợ cả hai kiến trúc Intel và Apple silicon — bạn chỉ cần tải một file .dmg duy nhất.

  1. Tải file .dmg cho macOS từ trang chính thức.
  2. Mở disk image và làm theo hướng dẫn cài đặt bên trong.
  3. Mở Nexus Composer từ thư mục Applications.

Ký số (signing) và notarization có thể thay đổi trong giai đoạn pilot. Nếu macOS chặn bộ cài đặt, hãy chắc chắn file được tải từ trang chính thức, rồi hỏi đầu mối onboarding trước khi bỏ qua cảnh báo.

Windows

Mục “Windows”

Có hai bộ cài đặt dành cho Windows tương ứng với từng kiến trúc CPU. Đa số máy tính hiện nay sử dụng kiến trúc x64; hãy chọn ARM64 nếu máy tính của bạn sử dụng chip Snapdragon (ARM). Để kiểm tra, mở Settings → System → About và xem dòng System type.

  1. Tải file .msi phù hợp với máy của bạn — x64 hoặc ARM64 — từ trang chính thức.
  2. Chạy file .msi và làm theo các bước của trình cài đặt.
  3. Mở Nexus Composer từ menu Start.

Nếu Windows SmartScreen hiển thị cảnh báo, hãy đảm bảo bạn đã tải file từ trang chính thức rồi hỏi đầu mối onboarding trước khi chọn vẫn chạy.

Khởi chạy Composer lần đầu

Mục “Khởi chạy Composer lần đầu”

  1. Mở Nexus Composer và đọc thông báo hiện ra ở lần chạy đầu tiên (first-run notice) rồi đóng lại.

  2. Khi chưa kết nối tài khoản OneNexus, Composer sẽ hiển thị banner thông báo OneNexus is not connected ở đầu trang của từng client. Nhấn Manage API key trên banner để mở card Nexus Account.

    Trang VS Code của Composer với banner ở trên cùng: OneNexus is not connected. Official OpenAI and other app features remain available. Nút Manage API key nằm ở đầu bên phải banner.

    Ảnh chụp banner phía trên trang VS Code; trang Codex cũng có banner tương tự. Manage API key là cách nhanh nhất để mở card Nexus Account — bấm biểu tượng bánh răng rồi chọn General cũng dẫn tới cùng vị trí này.

Bạn hoàn toàn có thể quản lý route OpenAI Official mà không cần tài khoản OneNexus — banner cũng nêu rõ điều này. Các model do OneNexus vận hành sẽ cần Platform key ở phần tiếp theo.

Kết nối tài khoản Nexus

Mục “Kết nối tài khoản Nexus”

Tại mục Settings → General → Nexus Account:

  1. Dán Platform key vào ô Nexus API Key, sau đó nhấn Connect.

    Tab General trong Settings của Composer. Card Nexus Account hiển thị Not connected, ô Nexus API Key còn trống, dòng báo Enter a Nexus API Key to continue và nút Connect đang mờ.

    Trước khi kết nối, card hiển thị Not connected và nút Connect bị mờ.

  2. Chờ Composer xác thực và hiển thị trạng thái Connected.

  3. Kiểm tra xem username và tenant hiển thị có chính xác là của bạn hay không. Nếu có sai sót, hãy dừng lại và liên hệ đầu mối onboarding.

Sau khi kết nối thành công, Composer sẽ xác thực key, lưu an toàn vào credential store của hệ điều hành, tải về catalog được quản lý sẵn và chỉ cập nhật những profile client thuộc phạm vi quản lý của Composer — các thiết lập Codex khác, cấu hình MCP, skill và session đều giữ nguyên.

Sử dụng nút Replace API Key để kết nối key mới, hoặc Forget key để xóa bỏ credential đã lưu trên máy.

Tab General trong Settings của Composer. Card Nexus Account hiển thị Connected kèm username và tenant ID đang đăng nhập, bên dưới là Replace API Key và Forget key.

Trạng thái Connected đi kèm username và tenant chính xác của bạn. Nếu sai một trong hai thông tin này, hãy dừng lại ngay tại đây.

Kiểm tra môi trường cài đặt của client

Mục “Kiểm tra môi trường cài đặt của client”

Mở mục Settings → About. Composer sẽ tự động nhận diện từng client được hỗ trợ, đối chiếu phiên bản hiện có với phiên bản tối thiểu yêu cầu, đồng thời cảnh báo nếu phát hiện nhiều bản cài đặt xung đột nhau.

Nếu chưa có Codex CLI, hãy nhấn Install. Nếu Composer phát hiện nhiều bản cài đặt Codex khác nhau, chọn Diagnose installs và xác nhận shell của bạn thực sự chạy executable nào trước khi thay đổi.

Composer không tự động cài đặt hay nâng cấp Claude Desktop hoặc Claude Code CLI. Nếu card của client nào hiển thị Update recommended, hãy tự cập nhật client đó.

Tab About trong Settings của Composer. Phần local environment check liệt kê Codex, ChatGPT và VS Code cạnh nhau kèm version hiện tại, mới nhất và tối thiểu; VS Code bị đánh dấu Update required.

Mỗi client được đối chiếu với phiên bản mà Composer yêu cầu. Nút Diagnose installs được dùng khi Composer phát hiện nhiều bản cài đặt Codex.

Trước khi gửi request đầu tiên

Mục “Trước khi gửi request đầu tiên”

Chọn client

Mục “Chọn client”

Composer đổi route cho từng client một. Riêng Claude Desktop và Claude Code CLI dùng chung trang Claude, và chọn card ở đó sẽ đổi cả hai. Chọn client của bạn.

Trang Codex của Composer với hai card provider: Official OpenAI đang là Effective route và Active, và OneNexus kèm nút Select. Bên dưới là Add provider.

Card mang nhãn Effective route mới là nơi request thực sự đi tới.

Codex Desktop mặc định chạy trên OpenAI Official và giữ nguyên như vậy cho tới khi bạn đổi — Composer hiển thị card đó là Active. OneNexus nằm ngay cạnh kèm nút Select, và chưa có gì thay đổi cho tới khi bạn bấm nút đó.

  1. Bấm Select trên card OneNexus để định tuyến Codex qua OneNexus. Đợi tới khi card đó hiển thị Active và không còn cảnh báo nào.

    Trang Codex của Composer sau khi chọn OneNexus. Banner ghi Restart Codex Desktop to apply this routing change; card OneNexus mang nhãn Effective route và Active, còn Official OpenAI giờ hiện nút Select.

    Active và Effective route đã chuyển sang OneNexus. Banner nhắc bước tiếp theo: Composer không tự khởi động lại Codex Desktop giúp bạn.

  2. Thoát hẳn Codex Desktop (không chỉ đóng cửa sổ), rồi mở lại. Ứng dụng đang chạy vẫn giữ route từ lúc khởi động.

  3. Trong cuộc hội thoại mới, mở model picker. Các model OneNexus giờ nằm ngay cạnh model của OpenAI — chọn model bạn cần rồi bắt đầu chat.

    Model picker của Codex Desktop. Dưới các model GPT là hai mục có tiền tố OneNexus — dsv4 và glm53 — trong đó glm53 đang được chọn và hiển thị trên nút model của khung soạn thảo.

    Model OneNexus có tiền tố là tên provider, nên dễ phân biệt với model của OpenAI.

Muốn model từ OpenAI Official vẫn chọn được song song với model OneNexus thì hãy đăng nhập ChatGPT trong Codex Desktop. Composer tự quản lý OneNexus catalog — danh sách model bạn thấy tùy vào tenant, tình trạng sẵn sàng hiện tại, và Codex đã khởi động lại sau lần catalog thay đổi gần nhất hay chưa.

Thống kê mức dùng và local proxy

Mục “Thống kê mức dùng và local proxy”

Tin nhắn bạn vừa gửi sẽ xuất hiện trong mục Settings → Usage Statistics, đi kèm thông tin ứng dụng client, provider và model. Đó là bản ghi cục bộ của Composer về các AI request mà ứng dụng đã định tuyến — nếu chỉ mở Composer mà không gửi request thì sẽ không có bản ghi nào, và chi phí hiển thị ở đây là mức ước tính chứ không phải hóa đơn chính thức (invoice). Xem thêm tại Skill và prompt để hiểu rõ ý nghĩa các trường dữ liệu và giới hạn của màn hình này.

Với Claude Desktop và Claude Code CLI, hãy chọn bộ lọc Claude (via Nexus). Bộ lọc này sẽ tổng hợp chung số liệu của cả hai client Claude.

Tab Usage Statistics trong Settings của Composer, lọc theo Codex trong hôm nay. Card tổng hợp hiển thị token đã xử lý, tổng request và tổng cost; bên dưới là các ô Fresh Input, Output, Creation, Hit và Cache Hit Rate, rồi tới biểu đồ Usage Trends.

Khi chọn Codex và Today, Total Requests đếm những request Composer đã định tuyến. Dòng riêng của tin nhắn vừa gửi, kèm provider và model, nằm trong Request Logs bên dưới biểu đồ.

Để kiểm tra trạng thái hoạt động của local proxy, mở mục Settings → Routing, mở rộng card Local Routing và xác nhận dịch vụ đang ở trạng thái Running. Dịch vụ chỉ lắng nghe trên 127.0.0.1 (bind vào loopback interface) — nếu dịch vụ gặp sự cố, bấm Restart ngay trên màn hình đó.

Tab Routing trong Settings của Composer. Card Local Routing đang mở rộng và có badge Running, kèm mục Diagnostics cho service address, logging và runtime details.

Running trên card Local Routing là tín hiệu cần thấy. Không có nó thì client đang được định tuyến qua OneNexus không có gì để gọi.

Cập nhật phiên bản Composer

Mục “Cập nhật phiên bản Composer”

Composer có cơ chế tự động cập nhật — bạn không cần phải tải lại file .dmg hay .msi thủ công sau mỗi lần phát hành. Mở Settings → About: card Nexus Composer ở trên cùng hiển thị phiên bản hiện tại và nút cập nhật của chính Composer, tách biệt với các card client trong phần Local environment check.

  1. Trên card Nexus Composer, chọn Check for Updates.
  2. Khi có bản cập nhật mới, card sẽ hiển thị New version available và nút Check for Updates đổi thành Update to kèm phiên bản mới — hãy nhấn vào nút đó.
  3. Composer sẽ tự động tải và cài đặt bản cập nhật, sau đó tự khởi động lại.
Tab About trong Settings của Composer. Card Nexus Composer hiển thị Version v3.24.3 với nút Official Website và nút Update to v3.24.6, phía trên dòng New version available: 3.24.6. Bên dưới là các card Local environment check cho Codex, ChatGPT và VS Code.

Card Nexus Composer mang version của chính app. Khi đang mới nhất, nút hiện Check for Updates; khi có bản chờ cài, nút ghi rõ version cần cài — ở đây là Update to v3.24.6.

Bước tiếp theo

Mục “Bước tiếp theo”