Viết theo CLI bản 0.3.4, ảnh chụp trên Windows PowerShell bản 0.3.3, dữ liệu thật đã được che. Xem đủ cờ lệnh tại developers.nextfarm.vn/docs/cli.
📌 Vị trí: Windows PowerShell → nextfarm config.
1. Đặt cấu hình
nextfarm config list
nextfarm config set lang vi
nextfarm config set mode propose
| Khoá | Giá trị | Tác dụng |
|---|
lang | Ngôn ngữ CLI. | Đặt một lần, khỏi thêm --lang mỗi lệnh. |
mode | read, propose, auto. | Chế độ quyền khi mở chat. |
updateChannel | latest hoặc next. | Kênh của nextfarm 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 PowerShell. |
defaultProfile | Tên hồ sơ. | Hồ sơ đăng nhập mở sẵn. |
nextfarm init tạo file NEXTFARM.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 vào file này.
2. Biến môi trường trên PowerShell
Đặt cho cửa sổ hiện tại bằng $env:TÊN = "giá trị".
| Biến | Tác dụng | Dùng khi |
|---|
NEXTFARM_API_KEY | API key, chỉ đọc với script. | CI không chat AI. |
NEXTFARM_TOKEN | Access token có sẵn. | Máy đã có token hợp lệ. |
NEXTFARM_PROFILE | Chọn hồ sơ đăng nhập. | Một máy, nhiều tài khoản. |
NEXTFARM_ENV | prod hoặc sandbox. | Thử trên sandbox trước khi ghi prod. |
NEXTFARM_WORKSPACE | Workspace của lệnh này. | Không muốn đổi hồ sơ vĩnh viễn. |
NEXTFARM_LANG | Ngôn ngữ một lần chạy. | |
NEXTFARM_DEBUG | In request-id và thời gian. | Báo lỗi cho hỗ trợ. Không in token. |
NEXTFARM_NO_UPDATE_CHECK | Tắt nhắc bản mới. | Máy chủ không cần nhắc. |
NEXTFARM_NO_KEYCHAIN | Lưu token bằng tệp quyền 0600. | Máy không dùng Keychain. |
NEXTFARM_ID_TOKEN | Token OIDC của GitLab CI. | Đi cùng nextfarm login --ci. |
NEXTFARM_VERSION | Ghim bản khi chạy script cài. | Ví dụ 0.3.3. |
NEXTFARM_INSTALL_DIR | Thư mục cài. | Đặt trước lệnh irm hoặc curl. |
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 nextfarm doctor. |
| 2 | Sai cú pháp. | nextfarm <lệnh> --help. |
| 3 | Chưa đăng nhập hoặc phiên hết hạn. | nextfarm login. |
| 4 | Thiếu quyền, scope hoặc gói. | Nhờ quản trị workspace cấp quyền. |
| 5 | Hết lượt AI hoặc gọi quá nhanh. | Xem nextfarm 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 nextfarm ai apply. Trong CI, đây cũng là lúc chưa có chính sách ghi. |
| 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ờ đầy đủ của từng lệnh: developers.nextfarm.vn/docs/cli và kho nextx-organization/nextfarm-cli.