Cách chạy Qwen Code trong terminal và thiết lập chế độ chỉnh sửa

Câu hỏi thường là thế này: làm sao để Qwen hoạt động đúng trong console và tự viết mã? Đằng sau câu hỏi thường là sự thất vọng: có người cài Qwen Code, đặt câu hỏi, nhận được câu trả lời gồm văn bản và một đoạn mã mà họ phải tự sao chép, dù đã được hứa rằng sẽ có một agent vào dự án và tự làm mọi việc.

Đó chính là Qwen Code: một agent hoàn chỉnh. Nó có thể tự mở tệp, chỉnh sửa tệp và chạy lệnh. Hành vi tùy chế độ duyệt đang hoạt động: Ask Permissions yêu cầu xác nhận; Auto-Edit và Auto cho phép làm độc lập hơn. Xem dòng trạng thái, không mặc định chế độ mang tên Default là lựa chọn mới cài. Dưới đây là các bước theo thứ tự: cài đặt, khởi chạy trong dự án, kết nối mô hình sau những thay đổi hồi tháng Tư và chuyển sang chế độ để agent chỉnh sửa mã mà không hỏi những câu không cần thiết. Mọi thông tin đã được đối chiếu với tài liệu chính thức của Qwen tính đến ngày 30 tháng 8 năm 2026.

Tài nguyên thực tế về mô hình và agent: tài liệu Ailoot.

“Qwen Code tự viết mã” có nghĩa là gì?#

Sự khác biệt rất đơn giản. Chat trong trình duyệt trả lời câu hỏi bằng văn bản. Bạn đọc câu trả lời, sao chép mã, dán vào tệp, tự chạy mã, tự tìm lỗi rồi gửi lại lỗi đó cho chat. Bạn là người chuyển tiếp giữa chat và dự án.

Agent hoạt động theo cách khác. Bạn giao việc bằng ngôn ngữ thông thường: “thêm biểu mẫu phản hồi”, “sửa lỗi này”. Sau đó, nó kiểm tra cấu trúc dự án, tìm các tệp liên quan, chỉnh sửa và chạy kiểm tra. Tài liệu nói rõ: agent lập kế hoạch, viết mã và xác minh rằng mã hoạt động.

Đó là lý do câu hỏi này dễ gây nhầm lẫn. “Qwen không tự viết mã” hầu như luôn có nghĩa là một trong hai điều: người dùng đang mở chat trong trình duyệt thay vì agent trong terminal, hoặc agent đang chạy nhưng được đặt ở chế độ yêu cầu quyền cho mọi lần chỉnh sửa. Trường hợp đầu được giải quyết bằng cách cài Qwen Code; trường hợp thứ hai bằng cách chuyển chế độ. Cả hai cách đều được trình bày dưới đây.

Cài Qwen Code trong terminal như thế nào?#

Cách nhanh nhất là dùng trình cài đặt chính thức, trình này tự chọn phiên bản phù hợp với hệ thống của bạn.

Trên macOS và Linux, mở terminal rồi dán một dòng lệnh:

curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash

Trên Windows, làm tương tự với lệnh PowerShell sau:

irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex

Lựa chọn thứ hai là npm, nếu bạn đã cài sẵn. Cách này yêu cầu Node.js phiên bản 22 trở lên:

npm install -g @qwen-code/qwen-code@latest

Sau khi cài đặt, hãy khởi động lại terminal. Trình cài đặt thêm lệnh qwen vào các đường dẫn hệ thống, và terminal sẽ không nhận diện lệnh này cho đến khi bạn khởi động lại. Đây là lý do phổ biến nhất dẫn đến tình huống “đã cài rồi mà không tìm thấy lệnh”. Để kiểm tra mọi thứ đã được cài đặt, hãy chạy:

qwen --version

Nếu bạn thấy số phiên bản, agent đã được cài đặt và sẵn sàng khởi chạy trong dự án.

Khởi chạy Qwen Code trong dự án như thế nào?#

Trước tiên, hãy vào thư mục chứa mã nguồn. Việc này quan trọng: agent làm việc trong thư mục mà nó được khởi chạy và chỉ nhìn thấy nội dung trong thư mục đó.

cd path-to-your-project
qwen

Giao diện của agent sẽ mở ngay trong terminal. Lần đầu, agent sẽ đề nghị kết nối mô hình; phần đó được trình bày trong mục tiếp theo. Sau khi kết nối mô hình, bạn có thể giao một việc bằng ngôn ngữ thông thường để xem agent truy cập được những gì:

what does this project do?

Agent sẽ đọc các tệp, hiểu cấu trúc và đưa ra câu trả lời hữu ích. Sau đó, bạn có thể yêu cầu agent viết và chỉnh sửa mã: “thêm nút đăng xuất”, “tách tệp này thành hai tệp”, “tìm hiểu vì sao bài kiểm tra không chạy”. Agent sẽ tìm đúng vị trí và tự thực hiện thay đổi.

Ngoài ra còn có cách khởi chạy thứ hai — bằng một lệnh duy nhất, không cần giao diện. Cách này hữu ích cho các tập lệnh và tác vụ tự động:

qwen -p "reread README and update the list of commands"

Lệnh này chạy tác vụ rồi thoát mà không có cuộc trò chuyện. Bạn chưa cần dùng cách này ở các bước đầu, nhưng nên biết để dùng về sau.

Vì sao agent đang chạy nhưng không tự làm gì?#

Trở ngại đầu tiên là quyền truy cập mô hình. Trước đây Qwen Code cung cấp quyền truy cập miễn phí: bạn đăng nhập bằng tài khoản qwen.ai và agent hoạt động mà không cần thẻ. Quyền truy cập đó có tên Qwen OAuth và đã bị ngừng. Tài liệu xác thực nói rõ: gói Qwen OAuth miễn phí đã bị ngừng vào ngày 15 tháng 4 năm 2026; các phiên đăng nhập đã lưu trước đó có thể tiếp tục hoạt động trong thời gian ngắn, nhưng máy chủ từ chối yêu cầu mới. Tùy chọn “đăng nhập bằng qwen.ai” cũng đã bị gỡ khỏi menu.

Vì vậy, để agent bắt đầu suy nghĩ về một tác vụ, bạn cần kết nối mô hình. Mục tiếp theo trình bày các lựa chọn kết nối, gồm cả dịch vụ trả phí và mô hình cục bộ miễn phí.

Lý do thứ hai kín đáo hơn và gây bực bội hơn. Mô hình đã kết nối, agent trả lời, nhưng không chỉnh sửa tệp nào — nó chỉ cho biết dự định làm gì rồi chờ. Đó là hành vi dự kiến ở Ask Permissions, hỏi trước sửa và chạy lệnh; không phải bằng chứng về mặc định khởi động của mọi bản cài. Muốn agent tự làm, bạn cần chuyển chế độ. Phần này được trình bày ở hai mục sau, nơi bạn sẽ tìm thấy câu trả lời cho câu hỏi ban đầu.

Kết nối mô hình thế nào khi quyền truy cập miễn phí đã đóng?#

Trong agent, nhập lệnh:

/auth

Một menu với ba lựa chọn chính sẽ mở ra. Sau đây là chức năng của từng lựa chọn.

Alibaba ModelStudio là lựa chọn chính thức của nhà sáng tạo Qwen. Dịch vụ này có Coding Plan với giá cố định và hạn mức hằng tuần dành cho nhà phát triển cá nhân, Token Plan tính phí theo mức sử dụng dành cho nhóm và tùy chọn kết nối khóa ModelStudio hiện có. Đây là quyền truy cập trả phí vào mô hình “gốc” của Qwen.

Nhà cung cấp bên thứ ba cho phép bạn chọn nhà cung cấp tích hợp sẵn và kết nối bằng khóa. Danh sách chính thức có DeepSeek, Grok, MiniMax, Z.AI, Kimi, ModelScope và các dịch vụ khác. Lấy khóa từ nhà cung cấp, nhập khóa và agent sẽ dùng mô hình của nhà cung cấp đó.

Custom Provider kết nối máy chủ, proxy hoặc công cụ chạy mô hình cục bộ của riêng bạn. Đây là nơi bạn kết nối mô hình chạy trên máy tính qua Ollama. Lựa chọn này hỗ trợ các định dạng OpenAI, Anthropic và Gemini, nên tương thích với hầu hết các phương thức truy cập.

Bạn cũng có thể nhập khóa và cài đặt thủ công trong tệp ~/.qwen/settings.json. Tệp này có trường modelProviders (các mô hình khả dụng), env (các khóa), security.auth.selectedType (giao thức sẽ bật khi khởi động) và model.name (mô hình mặc định). Sau đó qwen sẽ khởi chạy với các cài đặt này mà không hỏi gì. Lần đầu tiên, dùng /auth sẽ dễ hơn; bạn có thể quay lại tệp khi muốn lưu toàn bộ cài đặt.

Để xem những gì vẫn miễn phí sau tháng Tư, đọc bài viết về Qwen Code miễn phí.

Nên bật chế độ nào để agent tự chỉnh sửa mã?#

Ý chính là chế độ truy cập quyết định mức độ độc lập của agent, và có năm chế độ từ thận trọng nhất đến thoải mái nhất.

Nếu agent chỉ hiển thị các chỉnh sửa rồi chờ, có thể nó đang ở chế độ Ask Permissions (các phiên bản cũ gọi là Default). Khi đó bạn phải tự xác nhận mọi chỉnh sửa và lệnh, khiến bạn có cảm giác agent chẳng tự làm gì.

Để agent chỉnh sửa tệp mà không hỏi, chuyển sang Auto-Edit. Các thay đổi sẽ được thực hiện tự động, nhưng agent vẫn hỏi trước khi chạy lệnh — đây là biện pháp bảo vệ hợp lý để tránh vô tình chạy rm nhầm chỗ.

Auto dùng bộ đánh giá nội bộ cho hành động cần xét. Chọn chủ động sau khi xem phiên bản cài và trạng thái; từ default còn trong cấu hình Ask Permissions là tên tương thích, không chứng minh chế độ khởi động.

YOLO là chế độ thoải mái nhất. Agent tự chỉnh sửa tệp và chạy lệnh mà không hỏi gì. Tài liệu cho biết chỉ nên dùng chế độ này với các dự án cá nhân đáng tin cậy và quy trình tự động. Trong dự án công việc, bạn có thể dễ dàng nhận được kết quả không mong muốn, vì vậy chỉ bật chế độ này khi đã cân nhắc kỹ và tốt nhất là trên một bản sao.

Chuyển chế độ trong khi đang dùng như thế nào?#

Bạn có thể chuyển chế độ trong lúc làm việc, kể cả giữa chừng một tác vụ. Nhấn Shift+Tab để chuyển sang chế độ tiếp theo. Trên Windows, phím Tab thông thường cũng làm việc tương tự. Chu trình là: Plan, rồi xác nhận, rồi chỉnh sửa tự động, rồi Auto, rồi YOLO, rồi quay lại Plan.

Chế độ hiện tại luôn hiển thị trên thanh trạng thái ở cuối giao diện. Hãy tạo thói quen kiểm tra chế độ trước khi giao việc lớn cho agent, để bạn không bật YOLO khi chỉ định xem kế hoạch.

Quy trình ba bước thân thiện với người mới:

1. Khởi chạy agent ở chế độ Plan và yêu cầu nó phân tích tác vụ, đề xuất kế hoạch. Agent sẽ không đụng vào gì cả; nó chỉ đọc mã và mô tả dự định thực hiện.
2. Đọc kế hoạch và nếu đồng ý, nhấn Shift+Tab để chuyển sang Auto-Edit hoặc Auto.
3. Bảo agent tiếp tục. Lúc này, agent sẽ tự chỉnh sửa tệp trong khi bạn theo dõi kết quả.

Cách này xua tan nỗi lo lớn nhất của người mới — agent sẽ làm hỏng mọi thứ ngay lập tức. Trước tiên, bạn xem xét kế hoạch trong chế độ an toàn, rồi mới cho agent tiếp tục.

Cách tiếp cận đầy đủ để vibe coding dựa trên phương pháp; công cụ chỉ là thứ yếu. Qwen, Claude hay bất kỳ công cụ nào khác — mô hình chạy bên dưới có thể thay đổi. Ba nền tảng giúp bạn duy trì kết quả khi chuyển mô hình là bản sao AI, Bộ não thứ hai và kỹ thuật ngữ cảnh. Kết hợp lại, chúng tạo ra kết quả có thể dự đoán; điều đó không phụ thuộc vào may mắn nhất thời.

Dùng mô hình cục bộ mà không cần thẻ#

Cài đặt một mô hình mở trên máy tính qua Ollama hoặc vLLM, sau đó kết nối mô hình dưới dạng Custom Provider từ menu /auth. Từ đó, agent dùng mô hình chạy trên máy tính của bạn thay cho đám mây của Alibaba. Không cần thẻ hay khóa và cũng không có giới hạn số yêu cầu. Để xem các mô hình mở nào có thể xử lý việc lập trình, đọc bài đánh giá các mô hình lập trình miễn phí này.

Điểm đánh đổi là phần cứng. Một mô hình viết mã khá tốt cần rất nhiều bộ nhớ video. Mô hình có thể chạy trên máy tính chơi game với card đồ họa mạnh, nhưng trên laptop thông thường, mô hình có thể không vừa hoặc mất quá nhiều thời gian để suy nghĩ cho từng câu trả lời, đến mức tìm lựa chọn khác sẽ dễ hơn.

Một lợi ích khác của việc chạy cục bộ là quyền riêng tư dữ liệu. Toàn bộ mã của bạn nằm trên máy tính; không có gì được gửi đến máy chủ của người khác. Với dự án nhạy cảm, điều đó quan trọng hơn việc tiết kiệm phí đăng ký.

Làm gì để tránh việc agent làm hỏng dự án?#

Agent tự hoạt động rất tiện miễn là nó làm đúng điều bạn muốn. Để một bước đi sai không khiến bạn phải trả giá, hãy duy trì ba thói quen.

Thứ nhất, dùng git. Nếu dự án được quản lý bằng hệ thống kiểm soát phiên bản, bạn có thể xem mọi chỉnh sửa của agent và hoàn tác bất kỳ chỉnh sửa nào. Agent độc lập thực sự có rủi ro nếu không có git: nó thay đổi thứ gì đó và bạn không còn cách khôi phục phiên bản trước. Với git, bạn chỉ cần một lệnh ngắn để hoàn tác.

Thứ hai, bắt đầu ở chế độ Plan. Trước khi giao cho agent một tác vụ lớn, hãy yêu cầu nó lập kế hoạch ở chế độ không đụng vào bất cứ thứ gì. Đọc và hiểu dự định của agent, rồi mới chuyển sang chỉnh sửa.

Thứ ba, cẩn thận với YOLO. Trong chế độ này, agent tự chạy lệnh, kể cả lệnh xóa tệp. Điều đó quá rủi ro với dự án công việc. Chỉ dùng YOLO với các bản sao chưa hoàn thiện và những tác vụ nhỏ mà nếu có sự cố thì cũng không sao.

Ba thói quen này giúp giải quyết nỗi lo chính — “tôi đã vibe-code rồi làm hỏng mọi thứ”. Để tìm hiểu thêm về cách hoàn tác thay đổi trong vibe coding, xem bài đánh giá riêng này. Bài viết nói về Claude Code, nhưng nguyên tắc dùng git hoàn toàn giống nhau.

Nên bắt đầu tác vụ của bạn từ đâu?#

Sau đây là toàn bộ quy trình dưới dạng danh sách ngắn. Làm theo từ trên xuống dưới:

1. Cài Qwen Code bằng một lệnh rồi khởi động lại terminal.
2. Vào thư mục dự án bằng cd rồi chạy qwen.
3. Kết nối mô hình qua /auth: chọn gói trả phí hoặc mô hình cục bộ qua Ollama nếu không thể thanh toán bằng thẻ.
4. Giao việc cho agent ở chế độ Plan và đọc kế hoạch.
5. Nhấn Shift+Tab để chuyển sang Auto-Edit hoặc Auto rồi để agent làm việc.
6. Quản lý dự án bằng git để bạn có thể hoàn tác mọi chỉnh sửa.

Tóm lại, “Qwen không tự viết mã” hầu như luôn có nghĩa là chưa kết nối mô hình hoặc agent đang ở chế độ yêu cầu xác nhận. Khắc phục trường hợp đầu trong menu /auth, còn trường hợp thứ hai bằng cách nhấn Shift+Tab cho đến khi đến Auto-Edit. Sau đó, agent thực sự tự làm việc trong terminal.

Nếu muốn so sánh Qwen với các agent khác cho tác vụ của mình, hãy xem bài đánh giá các lựa chọn thay thế Claude Code. Qwen xuất hiện cùng các công cụ khác để bạn thấy công cụ nào phù hợp với từng việc.

Cách tiếp cận đầy đủ để vibe coding dựa trên phương pháp, còn agent cụ thể chỉ là thứ yếu: bản sao AI cộng với Bộ não thứ hai và kỹ thuật ngữ cảnh. Bạn có thể thay đổi công cụ chạy bên dưới; phương pháp vẫn giữ nguyên. Tài nguyên thực tế: tài liệu Ailoot.

Tài nguyên và công cụ khác: Ailoot.