Cline là gì? Agent viết code mã nguồn mở cho VS Code, JetBrains và terminal: cài đặt, Plan và Act, ClinePass

Cline là gì?

Cline là agent viết code mã nguồn mở, chạy trong trình soạn thảo và trong terminal. Bạn giao việc bằng lời, Cline đọc cấu trúc dự án, sửa nhiều file cùng lúc, chạy lệnh trong terminal và theo dõi kết quả, mở trình duyệt để kiểm giao diện, và gọi thêm công cụ qua MCP. Mỗi lần sửa file hay chạy lệnh đều chờ bạn duyệt, trừ khi bạn bật tự duyệt.

Trong VS Code và JetBrains, mỗi thay đổi hiện thành diff để bạn xem, sửa hay hoàn tác, và Cline lưu checkpoint sau từng bước để quay lại khi cần. Cline cũng đếm token và chi phí của cả task lẫn từng request, nên bạn biết mình đã tiêu bao nhiêu.

Cline chạy ở đâu?

Theo tài liệu của Cline, cùng một lõi agent có nhiều bản:

• Extension cho VS Code, Cursor, Windsurf (nay là Devin Desktop), VSCodium và Antigravity; Windsurf và VSCodium cài từ Open VSX.
• Plugin cho các IDE JetBrains như IntelliJ IDEA, PyCharm, WebStorm, GoLand.
• Cline CLI trong terminal, chạy tương tác hoặc không giao diện cho CI/CD: cài bằng npm i -g cline, đăng nhập bằng cline auth.
• Cline Desktop cho macOS và Windows (Windows đang thử nghiệm): chạy nhiều phiên song song, lên lịch việc lặp lại, nhập phiên từ Claude Code, Codex để làm tiếp bằng model mở.
• Cline SDK để tự dựng agent trên cùng lõi, và Kanban (bản xem trước) để chạy nhiều agent theo bảng công việc, mỗi thẻ một worktree riêng.

Cài Cline trong VS Code

Các bước theo tài liệu cài đặt của Cline:

1. Mở Extensions bằng Ctrl+Shift+X (macOS: Cmd+Shift+X), tìm “Cline”, bấm Install. Extension có mã saoudrizwan.claude-dev trên VS Marketplace.
2. Mở Cline ở thanh bên, bấm biểu tượng bánh răng để vào cài đặt.
3. Chọn nhà cung cấp ở mục API Provider: đăng nhập tài khoản Cline, chọn ClinePass, hoặc dán API key của nhà cung cấp bạn dùng.
4. Chọn model ở mục Model rồi giao task đầu tiên, nên là một việc nhỏ để kiểm kết nối.

Chế độ Plan và Act

Ở chế độ Plan, Cline đọc code, hỏi lại chỗ chưa rõ và đưa ra kế hoạch, chưa sửa gì. Khi bạn đồng ý, chuyển sang Act để Cline làm theo kế hoạch, vẫn giữ toàn bộ ngữ cảnh lúc lập kế hoạch. Việc lớn nên bắt đầu bằng Plan, hoặc dùng lệnh /deep-planning để Cline tìm hiểu kỹ codebase trước khi tạo task làm.

Mục Auto Approve cho chọn từng loại việc được tự duyệt: đọc file trong dự án, sửa file, chạy lệnh mà model đánh dấu là an toàn, dùng trình duyệt, dùng MCP. Cline khuyên lúc đầu chỉ bật đọc file. Chế độ YOLO tự duyệt mọi thứ, kể cả lệnh xoá file, nên chỉ dùng trong dự án thử nghiệm có git để khôi phục.

Cline có miễn phí không?

Bản thân Cline miễn phí và mã nguồn mở; bạn trả tiền cho token của model mà Cline gọi. Có ba cách lấy model:

• Nhà cung cấp Cline: đăng nhập bằng Google, GitHub hoặc email, nạp credit để dùng nhiều model từ một tài khoản; có vài model miễn phí, danh sách đổi theo thời gian.
• ClinePass: gói trả theo tháng cho một nhóm model mở đã được Cline thử cho việc viết code, như GLM-5.3, Kimi K3, DeepSeek V4 Pro, Qwen3.8 Max, MiniMax M3. Theo Cline, gói này cho dùng gấp 2 tới 5 lần so với trả theo giá API thường; mức dùng tính theo ba giới hạn: 5 giờ cuốn chiếu, theo tuần và theo tháng.
• API key riêng (BYOK): Anthropic, OpenAI, Google Gemini, OpenRouter, AWS Bedrock, DeepSeek, model chạy trên máy qua Ollama hay LM Studio, và mọi API tương thích OpenAI.

Dùng Cline với API key riêng

Chọn nhà cung cấp OpenAI Compatible, điền Base URL, API key và mã model của nhà cung cấp; với model Claude có thể chọn nhà cung cấp Anthropic với base URL tuỳ chỉnh. Mở Model Configuration để đặt cửa sổ ngữ cảnh và số token đầu ra tối đa khớp với model, vì Cline dựa vào đó để biết khi nào phải nén lịch sử. Hướng dẫn từng ô, cách kiểm kết nối và cách dùng một key cho cả Cursor, Cline, Claude Code có ở bài cấu hình Cursor, Cline dùng API key riêng.

Với API key riêng, request đi thẳng từ máy bạn tới nhà cung cấp model. Khi dùng credit của Cline, code và câu lệnh đi qua hạ tầng của Cline để tới model, và theo FAQ của Cline thì không bị dùng để huấn luyện model.

Rules và các lệnh nên biết

Rules là file markdown chứa chỉ dẫn dùng lâu dài, đặt trong thư mục .clinerules hoặc .cline/rules ở gốc dự án; Cline cũng đọc .cursorrules, .windsurfrules và AGENTS.md. Mỗi rule bật tắt riêng được trong bảng Rules, và rule có điều kiện chỉ nạp khi bạn làm với file khớp mẫu, đỡ tốn token. Các lệnh gõ trong khung chat:

• /newtask: mở task mới, mang theo kế hoạch, việc đã xong và các file liên quan, bỏ lại phần nhiễu, hợp khi ngữ cảnh đã đầy.
• /smol (hoặc /compact): nén lịch sử trò chuyện ngay trong task đang làm.
• /newrule: để Cline hỏi và tạo file rule theo thói quen của bạn.
• /deep-planning: tìm hiểu codebase, lập kế hoạch kỹ rồi tạo task thực hiện.

Lỗi “Cline hit repeated tool call failures”

Thông báo đầy đủ là “Cline hit repeated tool call failures. Try guiding it with a new prompt.” Đây không phải mã lỗi của API: Cline tự dừng sau nhiều bước thất bại liên tiếp. Theo các báo cáo trên GitHub của Cline, các nguyên nhân hay gặp và cách xử lý:

• Lỗi kết nối: key sai, hết số dư hay base URL sai làm mọi request hỏng. Gọi thử API bằng curl ngoài Cline để xem mã lỗi; bảng mã lỗi có ở bài lỗi API thường gặp.
• Model trả lời bằng chữ thay vì gọi công cụ, hoặc gọi sai định dạng, thường kèm thông báo Invalid API Response. Đổi sang model khác rồi chạy lại đúng task đó; nếu hết lỗi thì do model, không do câu lệnh.
• Ngữ cảnh đầy: đặt đúng cửa sổ ngữ cảnh trong Model Configuration, dùng /smol hoặc /newtask, và chỉ đính kèm file cần thiết thay vì cả thư mục.
• Rule mâu thuẫn, ví dụ cấm chạy lệnh hay bắt trả lời bằng chữ: tắt hết rule trong bảng Rules rồi thử lại, sau đó bật lại từng cái.
• Lỗi của bản cài: một số người báo hết lỗi sau khi cập nhật VS Code, đổi phiên bản Cline, hoặc chạy cùng task bằng Cline CLI. Cuối cùng, chia việc nhỏ hơn và nói rõ file, kết quả mong muốn ở câu lệnh mới.

Cline, Roo Code và Kilo Code

Roo Code là một extension từng phổ biến, phát triển từ Cline, đã ngừng phát triển từ 15/05/2026; người dùng cũ thường chuyển sang Cline hoặc Kilo Code với cùng cách khai báo nhà cung cấp. Nếu bạn muốn trợ lý gắn với GitHub và gói trả theo tháng, xem bài GitHub Copilot là gì; nếu muốn agent chạy trong terminal của Anthropic, xem Claude Code là gì.

Câu hỏi thường gặp