Cài tác tử AI dòng lệnh an toàn gồm bốn phần: cài đúng môi trường chạy mà công cụ yêu cầu, xác thực mà không để khoá lọt vào kho mã, chạy lần đầu trong một kho git sạch trên nhánh riêng, và giữ chế độ hỏi quyền trước mọi thao tác sửa hay chạy lệnh. Phần cài đặt thường chỉ mất vài phút; phần chuẩn bị quanh nó mới quyết định bạn có yên tâm để công cụ chạy trên máy mình hay không.
Tác tử dòng lệnh khác tiện ích trong trình soạn thảo ở chỗ nó tự đọc tệp, tự sửa và tự chạy lệnh trong thư mục bạn mở. Quyền rộng như vậy thì cách cài cũng cần cẩn thận hơn. Bài này đi qua từng phần theo nguyên lý chung cho các tác tử phổ biến; lệnh cài và tên tuỳ chọn cụ thể bạn tra trong tài liệu chính thức của công cụ, vì chúng thay đổi theo phiên bản. Cách giao việc và làm việc nhóm với tác tử có danh mục riêng trên trang.
Chuẩn bị môi trường chạy
Phần lớn tác tử dòng lệnh được phát hành dưới dạng gói của Node.js hoặc Python, một số có bản cài sẵn chạy độc lập. Đọc mục yêu cầu hệ thống của công cụ trước, rồi chuẩn bị theo thứ tự:
- Kiểm phiên bản Node.js hoặc Python hiện có bằng lệnh node --version hoặc python3 --version, so với phiên bản tối thiểu công cụ yêu cầu.
- Nếu dùng Node.js, nên cài qua trình quản lý phiên bản như nvm để gói cài toàn cục nằm trong thư mục người dùng, không phải chạy lệnh cài bằng quyền quản trị.
- Nếu công cụ phát hành dạng gói Python, nên cài bằng pipx để mỗi công cụ có môi trường riêng, không đụng tới thư viện của dự án.
- Trên Windows, đọc kỹ tài liệu xem công cụ chạy trực tiếp hay khuyên dùng qua môi trường Linux tích hợp; nhiều tác tử hoạt động ổn định hơn trong môi trường đó.
- Cài công cụ theo đúng lệnh trong tài liệu chính thức, ví dụ dạng npm install -g kèm tên gói, rồi chạy lệnh xem phiên bản để chắc cài xong.
Chép lệnh cài từ trang chính thức, không từ bài đăng trên mạng xã hội hay video. Kẻ xấu từng đăng gói có tên gần giống công cụ nổi tiếng để lừa người cài; một ký tự sai trong tên gói là đủ để chạy mã của người khác trên máy bạn.
Xác thực và cất khoá đúng chỗ
Hai kiểu xác thực phổ biến. Một là đăng nhập bằng tài khoản qua trình duyệt, công cụ lưu mã đăng nhập trong thư mục cấu hình của người dùng. Hai là dùng khoá API của hãng, khai qua biến môi trường. Kiểu thứ nhất thường gắn với gói thuê bao, kiểu thứ hai thường tính tiền theo mức dùng.
Khoá API không bao giờ nằm trong kho mã. Không ghi khoá vào tệp cấu hình của dự án, không ghi vào tệp hướng dẫn cho AI, không dán vào lệnh rồi để nó nằm trong lịch sử dòng lệnh dùng chung. Đặt trong tệp cấu hình của trình dòng lệnh thuộc thư mục người dùng, hoặc tốt hơn là trong trình quản lý mật khẩu hay kho bí mật của hệ điều hành.
Đặt hạn mức chi tiêu trước khi chạy. Nếu dùng khoá API, vào trang quản lý của hãng đặt hạn mức theo tháng và bật cảnh báo. Tác tử chạy vòng lặp dài có thể dùng nhiều hơn bạn tưởng, nhất là khi gặp lỗi và thử đi thử lại.
Khoá riêng cho tác tử. Tạo một khoá dành riêng cho tác tử thay vì dùng chung với ứng dụng khác. Khi cần thu hồi hay xem mức dùng, bạn biết ngay khoá nào thuộc việc nào.
Chạy lần đầu trong một kho git sạch
Lần chạy đầu tiên nên làm trên một dự án bạn hiểu rõ, không phải dự án quan trọng nhất của công ty. Trước khi mở tác tử, chạy git status để chắc thư mục không còn thay đổi dở dang. Nếu còn, commit hoặc cất tạm bằng git stash. Lý do đơn giản: khi mọi thứ đang sạch, bất cứ thay đổi nào sau phiên làm việc đều là của tác tử, và bạn xem được toàn bộ bằng git diff.
Tiếp theo, tạo nhánh riêng bằng git switch -c kèm tên nhánh, ví dụ thu-tac-tu. Lệnh này có từ git bản 2.23; bản cũ hơn dùng git checkout -b với cùng ý nghĩa. Làm trên nhánh riêng thì nếu kết quả không dùng được, bạn chỉ cần quay về nhánh chính và xoá nhánh thử, không phải gỡ từng thay đổi bằng tay.
Giao cho tác tử một việc nhỏ, có tiêu chí xong rõ ràng: thêm kiểm thử cho một hàm tiện ích, sửa một cảnh báo của công cụ kiểm định dạng, hay viết lại thông báo lỗi cho dễ hiểu. Xem nó đọc những tệp nào, đề xuất gì, xin phép chạy lệnh gì. Mục tiêu của phiên đầu không phải là năng suất, mà là hiểu cách công cụ hành xử trên máy bạn.
Chế độ quyền: nên để thế nào lúc mới dùng
Phần lớn tác tử có vài mức quyền, từ hỏi trước mọi thao tác tới tự làm hết. Tên gọi khác nhau theo công cụ, nhưng cách nghĩ thì giống nhau:
| Loại thao tác | Mức nên để khi mới dùng | Lý do |
|---|---|---|
| Đọc tệp trong thư mục dự án | Cho phép | Cần để tác tử hiểu mã, rủi ro thấp nếu thư mục không chứa bí mật |
| Sửa tệp | Hỏi trước, xem bản so sánh | Bạn học được cách tác tử sửa, phát hiện sớm khi nó lạc hướng |
| Chạy lệnh chỉ đọc như liệt kê tệp, chạy kiểm thử | Cho phép sẵn từng lệnh cụ thể | Giảm số lần hỏi mà không mở rộng quyền nguy hiểm |
| Cài gói, xoá tệp, đổi cấu hình hệ thống | Luôn hỏi | Có thể làm hỏng môi trường hoặc kéo mã lạ vào máy |
| Đẩy mã lên kho chung, gọi dịch vụ bên ngoài | Luôn hỏi hoặc chặn | Hậu quả vượt ra ngoài máy của bạn |
Các tuỳ chọn kiểu bỏ qua mọi câu hỏi tồn tại để dùng trong môi trường đã cô lập, không phải để dùng trên máy làm việc hằng ngày. Nếu muốn tác tử tự chạy dài, hãy đưa nó vào môi trường cô lập như phần dưới.
Cô lập tác tử khi cần cho nó tự chạy dài
Khi đã quen và muốn giao việc dài, chẳng hạn nâng phiên bản thư viện cho cả dự án, bạn sẽ muốn tác tử tự chạy mà không hỏi từng bước. Lúc đó nên chạy nó trong một môi trường tách khỏi máy chính: vùng chứa phát triển, máy ảo hoặc một máy chủ thử nghiệm riêng. Trong môi trường đó, tác tử chỉ thấy mã dự án, không thấy thư mục cá nhân, khoá SSH, phiên đăng nhập trình duyệt hay tệp cấu hình đám mây của bạn.
Vùng chứa phát triển là lựa chọn nhẹ nhất cho nhiều nhóm: một tệp mô tả môi trường đặt trong kho mã, trình soạn thảo mở dự án bên trong vùng chứa, tác tử chạy trong đó. Khi cấu hình, đừng gắn cả thư mục người dùng vào vùng chứa, chỉ gắn thư mục dự án. Không đưa vào biến môi trường những khoá truy cập hệ thống thật như cơ sở dữ liệu sản xuất hay tài khoản đám mây có quyền ghi.
Nếu tác tử cần mạng để cài gói, cân nhắc giới hạn mạng chỉ tới kho gói chính thức. Cách làm cụ thể tuỳ công cụ và hạ tầng, nhưng nguyên tắc là càng ít thứ tác tử chạm tới được, thì một sai lầm của nó càng ít gây hại.
Đọc lại những gì tác tử đã làm sau phiên đầu
Kết thúc phiên đầu tiên, dành mười lăm phút kiểm lại toàn bộ dấu vết tác tử để lại. Thói quen này nên giữ cho mọi phiên về sau, chỉ là càng quen thì càng nhanh:
- Chạy git status để thấy tệp nào bị sửa và có tệp mới nào chưa được theo dõi. Tác tử đôi khi tạo tệp tạm, tệp ghi chú hay kịch bản thử rồi để lại.
- Chạy git diff và đọc từng thay đổi như đang rà mã của đồng nghiệp mới. Để ý những chỗ sửa ngoài phạm vi việc đã giao.
- Nếu dự án có tệp khoá phụ thuộc, như tệp lock của trình quản lý gói, xem nó có đổi không. Đổi tức là tác tử đã cài hoặc nâng gói; kiểm tên gói và lý do.
- Kéo lại lịch sử lệnh tác tử đã chạy trong phiên, xem có lệnh nào bạn không nhớ đã cho phép hay không hiểu tác dụng.
- Chạy bộ kiểm thử và công cụ kiểm định dạng bằng tay, không dựa vào lời tác tử báo là đã chạy qua.
- Nếu mọi thứ ổn, tự viết lời mô tả commit; nếu không, quay về nhánh chính và xoá nhánh thử.
Lần đầu làm đủ các bước có thể mất lâu hơn chính phiên làm việc. Điều đó bình thường. Mục đích là để bạn biết công cụ hay sai ở đâu, từ đó những phiên sau biết cần nhìn kỹ chỗ nào.
Những thứ cần biết sau khi cài
Vài điều người mới hay bỏ sót, đến khi gặp chuyện mới để ý:
- Tác tử thường lưu lịch sử phiên làm việc trên máy, trong đó có nội dung tệp đã đọc. Biết thư mục đó nằm đâu, và đừng sao lưu nó lên nơi công cộng.
- Tệp cấu hình của tác tử có hai tầng: cho người dùng và cho từng dự án. Tầng dự án có thể đưa vào git để cả nhóm dùng chung, nhưng không được chứa khoá.
- Tác tử đọc tệp hướng dẫn dự án nếu có. Viết tệp này sớm giúp phiên đầu tiên đã đúng quy ước.
- Khi thấy tác tử chạy vòng vòng, sửa rồi lại hỏng, dừng phiên, đọc lại thay đổi và giao lại việc với mô tả rõ hơn, thay vì để nó tiếp tục tiêu thời gian và hạn mức.
- Gỡ cài đặt cũng bằng trình quản lý gói đã dùng để cài, sau đó xoá thư mục cấu hình và thu hồi khoá nếu không dùng nữa.
Cuối cùng, mọi thay đổi do tác tử làm vẫn là thay đổi bạn chịu trách nhiệm. Đọc bản so sánh, chạy kiểm thử, rồi mới commit với lời mô tả do chính bạn viết.
Câu hỏi thường gặp
Có cần quyền quản trị để cài tác tử AI dòng lệnh không?
Thường không cần nếu cài đúng cách. Dùng trình quản lý phiên bản cho Node.js hoặc pipx cho Python để công cụ nằm trong thư mục người dùng. Tránh chạy lệnh cài toàn cục bằng quyền quản trị vì vừa không cần thiết vừa mở rộng quyền của gói được cài.
Khoá API của tác tử nên cất ở đâu?
Trong tệp cấu hình trình dòng lệnh thuộc thư mục người dùng, hoặc tốt hơn là trong trình quản lý mật khẩu hay kho bí mật của hệ điều hành. Không ghi vào kho mã, tệp hướng dẫn dự án hay tệp cấu hình dùng chung của nhóm.
Vì sao nên chạy tác tử trên nhánh git riêng?
Để mọi thay đổi của tác tử được gom trên một nhánh, xem được bằng git diff và bỏ đi dễ dàng nếu không dùng được. Làm thẳng trên nhánh chính thì phải gỡ từng thay đổi bằng tay, dễ sót.
Có nên bật chế độ cho tác tử tự làm mà không hỏi không?
Không nên trên máy làm việc hằng ngày. Chế độ đó dành cho môi trường đã cô lập như vùng chứa phát triển hay máy ảo, nơi tác tử không thấy khoá, thư mục cá nhân hay hệ thống thật. Trên máy chính, giữ chế độ hỏi cho thao tác sửa, xoá, cài gói và đẩy mã.
Dùng tác tử trên Windows có khác gì không?
Một số tác tử chạy trực tiếp trên Windows, một số khuyên dùng qua môi trường Linux tích hợp để ổn định hơn. Đọc mục yêu cầu hệ thống của công cụ trước khi cài, và chú ý đường dẫn tệp, ký tự xuống dòng có thể khác giữa hai môi trường.
Làm sao biết tác tử đã tiêu bao nhiêu hạn mức?
Với khoá API, xem trang quản lý của hãng, nơi ghi mức dùng theo ngày và theo khoá; nên đặt hạn mức tháng và bật cảnh báo. Với gói thuê bao, trang tài khoản thường ghi mức đã dùng trong kỳ. Một số tác tử cũng có lệnh xem mức dùng ngay trong phiên.