Hướng dẫn thực hành
Cách kết nối CLI AI cục bộ với Pluely
Cho câu hỏi của Pluely chạy qua một CLI bạn vốn đang dùng (Claude Code, Gemini CLI, OpenAI Codex, Qwen Code hoặc Ollama) để câu trả lời đến từ một công cụ trên chính máy của bạn. Sau khi kết nối, CLI của bạn nằm ở đầu bộ chọn mô hình trên lớp phủ.
“CLI của bạn” trong Pluely là gì
Bộ chọn mô hình trên lớp phủ được chia thành các nhóm: CLI của bạn, Tìm kiếm trên web / Mô hình Pluely, và Nhà cung cấp của bạn. “CLI của bạn” là một công cụ dòng lệnh AI cục bộ cài trên máy, được Pluely kết nối trực tiếp. Khi một CLI đang được kết nối, nó là lựa chọn đang hoạt động: câu trả lời chạy cục bộ qua nó, không qua bất kỳ mô hình được lưu trữ nào.
Các CLI được hỗ trợ
- Claude Code: CLI của Anthropic; Sonnet / Opus / Haiku trên gói đăng ký Claude của bạn.
- Gemini CLI: CLI của Google, dùng gói Google AI hoặc khóa API Gemini của bạn.
- OpenAI Codex: các mô hình hạng GPT-6 trên gói ChatGPT của bạn.
- Qwen Code: các mô hình Qwen3-Coder qua Alibaba Cloud Coding Plan hoặc khóa API Model Studio.
- Ollama: mô hình mở chạy hoàn toàn ngoại tuyến trên phần cứng của bạn.
Từng bước: kết nối một CLI
- Xác nhận CLI đã được cài và chạy được từ terminal (đăng nhập ở đó trước nếu nó cần tài khoản).
- Mở bảng điều khiển (biểu tượng Trang chủ ở góc trên bên trái lớp phủ) → Dev Space → Kết nối CLI của bạn.
- Pluely tự động phát hiện các CLI đã cài và hiển thị phiên bản của từng CLI, không cần gõ đường dẫn. Vừa cài xong một CLI? Nhấp nút làm mới cạnh tiêu đề mục để quét lại.
- Nhấp Kết nối trên CLI bạn muốn.
- Bảng Mô hình xuất hiện dưới dòng đã kết nối: chọn một mô hình phổ biến, gõ một ID mô hình tùy chỉnh, hoặc để Mặc định (do CLI quyết định). Ollama là ngoại lệ: bắt buộc phải chọn một trong các mô hình bạn đã tải về máy.
- Mở bộ chọn mô hình trên lớp phủ: CLI của bạn là mục đầu tiên, hiển thị kèm mô hình (ví dụ Claude Code · opus).
Ảnh chụp màn hình và mô hình suy luận
- Bảng Mô hình cho bạn biết thiết lập hiện tại có xem được hình ảnh hay không: Claude Code, Gemini CLI, OpenAI Codex và Qwen Code đều có khả năng thị giác; với Ollama thì tùy mô hình đã tải (llava, gemma3, qwen-vl và các dòng đa phương thức khác).
- Mô hình suy luận hoạt động trên mọi CLI: chuỗi suy nghĩ được tự động lược bỏ nên bạn chỉ thấy câu trả lời cuối cùng.
Vì sao ưu tiên cục bộ lại quan trọng
CLI đã kết nối chạy trên chính máy của bạn, nên yêu cầu không bao giờ phải rời thiết bị để đến hạ tầng được quản lý của Pluely. Nếu bạn đã trả phí hoặc đang duy trì một gói đăng ký CLI, Pluely trở thành một lớp phủ tiện lợi trên công cụ bạn vốn đã tin dùng, không có thêm mô hình được quản lý nào xen vào.
Chuyển lại về mô hình được quản lý
Mở bộ chọn mô hình và chọn bất kỳ mục nào trong “Mô hình Pluely” hoặc “Nhà cung cấp của bạn”: thao tác đó tạm tắt chế độ CLI, và kết nối lại chỉ cần một cú nhấp trong Dev Space. Để gỡ hẳn kết nối, dùng Ngắt kết nối trên dòng của CLI.
Khắc phục khi CLI không trả lời
- Chạy CLI trong terminal, bên ngoài Pluely: nếu nó lỗi ở đó (phiên đăng nhập hết hạn, thiếu gói đăng ký), hãy sửa ở đó trước; Pluely sẽ hoạt động theo.
- Pluely hiển thị chính thông báo lỗi của CLI khi có sự cố, nên cách sửa thường được nêu ngay trên lớp phủ.
- Vừa cài hoặc cập nhật một CLI? Nhấp nút làm mới cạnh “Kết nối CLI của bạn” để phát hiện lại.
- Đã chọn một ID mô hình tùy chỉnh bị lỗi? Chuyển lại về Mặc định (do CLI quyết định): lựa chọn này luôn hoạt động.
- Yêu cầu “trusted directory” của Gemini CLI và bước kiểm tra kho git của Codex đều được Pluely tự động xử lý, không cần cờ nào.
Mẹo
- Claude Code, Gemini CLI, OpenAI Codex và Qwen Code cần tài khoản riêng: Pluely không quản lý phần thanh toán đó, mà chỉ kết nối với những gì đã được cài.
- Ollama là lựa chọn tốt cho suy luận cục bộ hoàn toàn ngoại tuyến, không tốn phí.
- Tự cập nhật CLI của bạn một cách độc lập; Pluely gọi bất kỳ phiên bản nào đang có trên máy.
- Nếu bạn thường chuyển qua lại giữa CLI và mô hình được quản lý, bộ chọn mô hình ở đầu lớp phủ giúp việc đó chỉ còn một cú nhấp.
Liên quan
Cập nhật lần cuối 10 tháng 7, 2026 · pluely.com