Viết theo CLI bản 0.3.7, ảnh chụp trên Windows PowerShell bản 0.3.5, dữ liệu thật đã được che. Xem đủ cờ lệnh tại developers.nextx.vn/docs/cli.
📌 Vị trí: Terminal → nextx config. File cấu hình: ~/.config/nextx/config.toml.
1. Đặt cấu hình
nextx config list
nextx config set lang vi
nextx config set mode propose
| Khoá | Giá trị | Tác dụng |
|---|
lang | vi hoặc en | Ngôn ngữ CLI. |
mode | read, propose, auto | Chế độ quyền mặc định. |
updateChannel | latest hoặc next | Kênh nextx update. |
updateCheck | bật hoặc tắt | Nhắc bản mới. |
telemetry | bật hoặc tắt | Gửi số liệu sử dụng. |
color | bật hoặc tắt | Màu trong terminal. |
defaultProfile | tên hồ sơ | Hồ sơ đăng nhập mở sẵn. |
2. Biến môi trường
| Biến | Tác dụng | Dùng khi |
|---|
NEXTX_API_KEY | API key, chỉ đọc với script. | CI không chat AI. |
NEXTX_TOKEN | Access token có sẵn. | Máy đã có token hợp lệ. |
NEXTX_PROFILE | Chọn hồ sơ đăng nhập. | Một máy, nhiều tài khoản. |
NEXTX_ENV | prod hoặc sandbox. | Thử trên sandbox trước khi ghi prod. |
NEXTX_WORKSPACE | Workspace của lệnh này. | Không muốn đổi hồ sơ vĩnh viễn. |
NEXTX_LANG | vi hoặc en. | Một lần chạy. |
NEXTX_DEBUG | In request-id và thời gian. | Báo lỗi cho hỗ trợ. Không in token. |
NEXTX_NO_UPDATE_CHECK | Tắt nhắc bản mới. | Máy chủ không cần nhắc. |
NEXTX_NO_KEYCHAIN | Lưu token bằng tệp quyền 0600. | Máy Linux không có Keychain. |
NEXTX_ID_TOKEN | Token OIDC của GitLab CI. | Đi cùng nextx login --ci. |
nextx init tạo NEXTX.md trong thư mục hiện tại. Mỗi câu hỏi gửi kèm file này. Viết quy ước riêng của thư mục vào đó, không viết token.
3. Mã thoát
| Mã | Ý nghĩa | Việc nên làm |
|---|
| 0 | Thành công. | Đọc kết quả in ra. |
| 1 | Lỗi chung hoặc máy chủ lỗi. | Chạy nextx doctor. |
| 2 | Sai cú pháp. | nextx <lệnh> --help. |
| 3 | Chưa đăng nhập hoặc phiên hết hạn. | nextx login. |
| 4 | Không đủ quyền hoặc không đúng gói. | Nhờ quản trị workspace cấp quyền. |
| 5 | Hết lượt AI hoặc gọi quá nhanh. | Xem nextx ai usage, chờ rồi chạy lại. |
| 6 | Lỗi mạng. | Kiểm tra mạng và đồng hồ máy. |
| 7 | Đề xuất ghi chưa được xác nhận. | Mở chat và xác nhận, hoặc nextx ai apply. |
| 8 | Không tìm thấy. | Kiểm tra id hội thoại, khoá hoặc endpoint. |
| 130 | Bạn nhấn Ctrl+C. | Chạy lại lệnh nếu vẫn cần. |
💡 Đủ cờ của từng lệnh nằm ở developers.nextx.vn/docs/cli và kho mã nextx-organization/nextx-cli. Trang đó sinh từ nextx help --json của bản đang phát hành.