Kimi Code CLI Là Gì? Hướng Dẫn Cài Đặt Và Sử Dụng
Mục lục bài viết
- •Kimi Code CLI là gì?
- •Kimi Code CLI khác chatbot AI thông thường thế nào?
- •Phân biệt kimi-code và kimi-cli
- •Kimi Code CLI có những tính năng nào?
- •Yêu cầu trước khi cài đặt
- •Cách cài đặt Kimi Code CLI
- •Hướng dẫn sử dụng Kimi Code CLI lần đầu
- •Cách dùng Kimi Code CLI hiệu quả với dự án thật
- •Kimi Code CLI, MCP và việc truy cập web
- •Ưu điểm của Kimi Code CLI
- •Hạn chế và rủi ro
- •Checklist bảo mật khi dùng AI coding agent
- •Câu hỏi thường gặp
- •Kết luận
Kimi Code CLI là một AI coding agent chạy trực tiếp trong terminal. Công cụ có thể đọc cấu trúc dự án, tìm kiếm file, chỉnh sửa mã nguồn, chạy lệnh, kiểm tra kết quả và tiếp tục điều chỉnh kế hoạch dựa trên phản hồi nhận được. Thay vì sao chép từng đoạn code giữa trình duyệt và IDE, lập trình viên có thể giao nhiệm vụ cho agent ngay trong thư mục dự án.
Điểm dễ gây nhầm lẫn là Moonshot AI từng phát triển dự án kimi-cli bằng Python, trong khi sản phẩm hiện hành có tên kimi-code, được viết chủ yếu bằng TypeScript. Cả hai đều tạo lệnh kimi, nhưng cách cài đặt, giấy phép, cấu hình và một số câu lệnh không giống nhau.
Bài viết này giải thích Kimi Code CLI là gì, cách cài đặt trên Windows, macOS và Linux, cách bắt đầu một phiên làm việc, vai trò của MCP, ưu nhược điểm cùng những nguyên tắc bảo mật cần biết trước khi cho AI sửa mã nguồn.
Kimi Code CLI là gì?
Kimi Code CLI là agent hỗ trợ lập trình do Moonshot AI phát triển. Công cụ hoạt động trong giao diện dòng lệnh và có thể quan sát môi trường dự án thay vì chỉ trả lời dựa trên đoạn code người dùng dán vào khung chat.
Một phiên làm việc thường diễn ra theo vòng lặp:
-
Người dùng mô tả mục tiêu, chẳng hạn tìm nguyên nhân một bài test thất bại.
-
Agent đọc những file liên quan và tìm kiếm trong codebase.
-
Agent đề xuất hoặc thực hiện thay đổi sau khi có quyền phù hợp.
-
Công cụ chạy test, lint hoặc lệnh kiểm tra.
-
Agent đọc kết quả và tiếp tục điều chỉnh nếu cần.
Khả năng quan sát kết quả giúp Kimi Code CLI xử lý nhiệm vụ nhiều bước tốt hơn một công cụ chỉ sinh code một lần. Tuy nhiên, agent vẫn có thể hiểu sai yêu cầu, chọn nhầm file hoặc tạo thay đổi không phù hợp. Mọi kết quả cần được người dùng kiểm tra trước khi commit và triển khai.
Kimi Code CLI khác chatbot AI thông thường thế nào?
Chatbot hoạt động trong trình duyệt thường chỉ biết nội dung bạn gửi vào cuộc trò chuyện. Kimi Code CLI được chạy trong một thư mục làm việc nên có thể sử dụng công cụ để đọc file, tìm chuỗi, xem cấu trúc dự án và chạy lệnh.
| Tiêu chí | Chatbot AI thông thường | Kimi Code CLI |
|---|---|---|
| Ngữ cảnh | Nội dung được dán hoặc tải lên | File và cấu trúc trong thư mục được cho phép |
| Chỉnh sửa | Trả code để người dùng tự chép | Có thể đề xuất hoặc sửa nhiều file |
| Chạy lệnh | Thường không chạy lệnh trên máy người dùng | Có thể chạy build, test và công cụ phát triển |
| Vòng lặp | Người dùng gửi kết quả thủ công | Agent có thể đọc kết quả lệnh rồi xử lý tiếp |
| Giao diện | Web hoặc ứng dụng chat | Terminal, TUI và một số tích hợp IDE |
Sự khác biệt lớn nhất không nằm ở việc “AI viết code hay hơn”, mà ở khả năng kết nối mô hình với công cụ và ngữ cảnh của dự án. Chính quyền truy cập này cũng tạo ra rủi ro lớn hơn nếu người dùng phê duyệt lệnh mà không đọc kỹ.
Phân biệt kimi-code và kimi-cli
Khi tìm hướng dẫn trên mạng, bạn có thể gặp hai repository chính thức có tên gần giống nhau. Dự án nên ưu tiên cho cài đặt mới là Kimi Code CLI (kimi-code).
| Đặc điểm | kimi-code hiện hành |
kimi-cli cũ |
| Ngôn ngữ chính | TypeScript | Python |
| Giấy phép | MIT | Apache-2.0 |
| Cách phân phối | Script chính thức, binary hoặc npm | PyPI/uv và một số trình quản lý gói |
| Thư mục cấu hình chính | ~/.kimi-code/ |
Cấu trúc của dự án cũ |
| Hướng phát triển | Sản phẩm được Moonshot AI ưu tiên | Dự án tiền nhiệm |
Cả hai có thể sử dụng tên lệnh kimi. Vì thế, không nên chỉ chạy kimi --version rồi suy đoán từ con số phiên bản. Hãy xem nguồn cài đặt, đường dẫn executable và tài liệu tương ứng. Số phiên bản của hai dự án thuộc hai chuỗi phát hành riêng, nên phiên bản 0.x không có nghĩa sản phẩm mới hơn đang “thấp hơn” bản 1.x cũ.
Kimi Code CLI có những tính năng nào?
Đọc, tìm kiếm và chỉnh sửa code
Agent có thể khám phá thư mục, xác định file liên quan và chỉnh sửa nhiều file trong cùng nhiệm vụ. Khả năng này phù hợp khi cần hiểu một codebase lạ, sửa lỗi có phạm vi rõ ràng, thêm test hoặc thực hiện refactor nhỏ.
Chạy lệnh và kiểm tra kết quả
Kimi Code CLI có thể gọi các lệnh như test, lint, build hoặc công cụ tìm kiếm file. Đây là phần biến một câu trả lời AI thành quy trình có phản hồi. Dù vậy, lệnh shell có thể sửa hoặc xóa dữ liệu, nên cần kiểm tra mục tiêu, tham số và thư mục làm việc trước khi chấp thuận.
Subagent cho nhiệm vụ chuyên biệt
Repository hiện hành mô tả các subagent như coder, explore và plan. Chúng hoạt động trong ngữ cảnh tách biệt để nghiên cứu, lên kế hoạch hoặc triển khai phần việc cụ thể, giúp cuộc trò chuyện chính bớt nhiễu.
MCP và hệ sinh thái công cụ
Model Context Protocol (MCP) cho phép agent kết nối với nguồn dữ liệu hoặc công cụ bên ngoài. Trong Kimi Code CLI hiện hành, việc cấu hình có thể được thực hiện qua lệnh /mcp-config. Hướng dẫn dùng kimi mcp ... trên mạng có thể thuộc dự án kimi-cli cũ và không hoạt động trên kimi-code.
MCP mở rộng đáng kể quyền của agent. Chỉ nên cài máy chủ từ nguồn đã kiểm tra, đọc rõ quyền truy cập và không đưa khóa API vào file được commit lên Git.
Tích hợp editor qua ACP
Kimi Code CLI hỗ trợ Agent Client Protocol (ACP), cho phép một số editor tương thích điều khiển phiên agent. Điều này giúp lập trình viên dùng agent trong môi trường quen thuộc mà vẫn giữ workflow terminal ở phía sau.
Hooks và kiểm soát quy trình
Lifecycle hooks có thể dùng để ghi log, chạy kiểm tra hoặc chặn một số hành động theo quy tắc của dự án. Với nhóm phát triển, hooks hữu ích để buộc agent chạy lint, test hoặc kiểm tra bảo mật trước khi hoàn tất nhiệm vụ.
Yêu cầu trước khi cài đặt
Kimi Code CLI hỗ trợ macOS, Linux và Windows. Nếu cài bằng script chính thức, người dùng không cần chuẩn bị Node.js riêng. Nếu cài qua npm, tài liệu chính thức hiện yêu cầu Node.js 22.19.0 trở lên; yêu cầu này có thể thay đổi theo phiên bản.
Trên Windows, cần cài Git for Windows vì Kimi Code CLI sử dụng Git Bash làm môi trường shell. Nếu Git Bash nằm ở đường dẫn khác mặc định, có thể phải cấu hình biến KIMI_SHELL_PATH.
Bạn cũng cần một phương thức đăng nhập hợp lệ, gồm Kimi Code OAuth hoặc API key từ nền tảng được hỗ trợ. Chi phí sử dụng phụ thuộc gói thành viên, nhà cung cấp mô hình và lượng token; không nên xem CLI mã nguồn mở là đồng nghĩa với mô hình AI miễn phí không giới hạn.
Cách cài đặt Kimi Code CLI
Cài trên macOS hoặc Linux
Moonshot AI khuyến nghị script cài đặt chính thức:
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
Lệnh này tải script từ tên miền chính thức rồi chuyển cho Bash thực thi. Trước khi chạy một lệnh dạng curl | bash, hãy xác minh tên miền và có thể tải script về đọc trước nếu môi trường yêu cầu kiểm soát chặt chẽ.
Cài trên Windows PowerShell
irm https://code.kimi.com/kimi-code/install.ps1 | iex
Cài Git for Windows trước lần khởi chạy đầu tiên. Sau khi script hoàn tất, đóng và mở lại terminal để PATH được cập nhật.
Cài qua npm
Nếu máy đã có phiên bản Node.js đáp ứng yêu cầu của tài liệu hiện hành, có thể dùng npm:
npm install -g @moonshot-ai/kimi-code
Script chính thức phù hợp với người không muốn quản lý runtime Node.js. npm phù hợp khi nhóm phát triển đã chuẩn hóa công cụ bằng Node và muốn quản lý package theo quy trình nội bộ.
Kiểm tra cài đặt
kimi --version
Nếu terminal báo không tìm thấy lệnh, hãy mở một cửa sổ terminal mới. Trên macOS/Linux, có thể nạp lại file cấu hình shell phù hợp như .bashrc hoặc .zshrc.
Hướng dẫn sử dụng Kimi Code CLI lần đầu
Di chuyển vào thư mục dự án rồi khởi chạy giao diện:
cd duong-dan-den-du-an
kimi
Trong lần đầu, nhập:
/login
Chọn đăng nhập bằng Kimi Code OAuth hoặc API key phù hợp. Nếu dùng API key, chỉ nhập trong giao diện chính thức; không dán khóa vào prompt, ảnh chụp, file .env.example có giá trị thật hoặc commit Git.
Sau khi đăng nhập, nên bắt đầu bằng nhiệm vụ chỉ đọc:
Hãy đọc cấu trúc dự án, mô tả vai trò của các thư mục chính và chưa chỉnh sửa file.
Tiếp theo, giao một nhiệm vụ nhỏ, có điều kiện hoàn thành rõ ràng:
Kiểm tra vì sao bài test của module người dùng thất bại. Trước tiên hãy giải thích nguyên nhân, đề xuất thay đổi và chờ xác nhận trước khi sửa file.
Prompt tốt nên nêu mục tiêu, phạm vi file, tiêu chuẩn code, lệnh kiểm tra và giới hạn không được thay đổi. Ví dụ: “Không sửa schema database”, “Không cập nhật dependency”, hoặc “Chỉ sửa trong thư mục src/auth”.
Cách dùng Kimi Code CLI hiệu quả với dự án thật
Bắt đầu bằng chế độ quan sát
Trước khi cho agent chỉnh sửa, yêu cầu nó giải thích kiến trúc, luồng dữ liệu và những file liên quan. Bước này giúp phát hiện sớm việc agent đang hiểu nhầm codebase.
Chia nhiệm vụ thành phạm vi nhỏ
“Tối ưu toàn bộ dự án” là yêu cầu khó kiểm chứng. “Giảm truy vấn lặp trong hàm X, giữ nguyên API public và bổ sung test” có tiêu chí rõ ràng hơn. Nhiệm vụ nhỏ cũng giúp review diff nhanh hơn.
Yêu cầu xác minh bằng công cụ của dự án
Agent nên chạy test, lint, type-check hoặc build sau khi sửa. Nếu một bài test không thể chạy, cần ghi rõ lý do thay vì coi nhiệm vụ đã hoàn thành.
Xem diff trước khi commit
Không nên để AI tự động đưa thay đổi lên production. Hãy xem từng file, kiểm tra dependency mới, logic xác thực, xử lý lỗi và khả năng làm lộ dữ liệu. Git branch riêng giúp hoàn tác dễ hơn.
Ghi quy tắc dự án thành tài liệu
Quy ước thư mục, lệnh test, style code và vùng cấm chỉnh sửa nên nằm trong tài liệu mà agent có thể đọc. Điều này giảm việc lặp lại prompt và giúp kết quả nhất quán giữa các phiên.
Kimi Code CLI, MCP và việc truy cập web
Khả năng fetch URL của coding agent phù hợp với tài liệu công khai, nhưng không nên mặc định rằng công cụ có thể đọc chính xác mọi website. Trang cần JavaScript, yêu cầu đăng nhập, giới hạn địa lý hoặc áp dụng cơ chế bảo vệ có thể trả nội dung thiếu hay lỗi.
Proxy và Kimi Code CLI xử lý hai lớp khác nhau. CLI quản lý agent và công cụ; proxy chuyển tiếp kết nối mạng. Nếu chưa rõ nền tảng, có thể đọc proxy là gì và proxy dùng để làm gì. Không nên giả định FetchURL tự hỗ trợ mọi biến môi trường proxy hoặc tự xoay IP; cần đối chiếu tài liệu đúng phiên bản và kiểm thử trong môi trường được phép.
Khi agent đọc nội dung web cho pipeline dữ liệu hoặc AI, nhóm phát triển cũng nên hiểu LLM honeypotting: nội dung trên website có thể được thiết kế để đánh lạc hướng crawler hoặc mô hình. Dữ liệu bên ngoài phải được xem là đầu vào không đáng tin cậy, không phải chỉ dẫn được phép điều khiển shell.
Các kiến thức proxy, tự động hóa và kiểm thử khác được tổng hợp trên Proxify.
Ưu điểm của Kimi Code CLI
Kimi Code CLI đem agent đến gần codebase và công cụ phát triển. Giao diện terminal phù hợp với workflow Git, test và build; khả năng đọc kết quả lệnh giúp agent tự sửa sai trong một số tình huống. Dự án mã nguồn mở theo giấy phép MIT cũng cho phép đội kỹ thuật xem code, audit thay đổi và theo dõi issue.
Việc hỗ trợ MCP, subagent, hooks và ACP giúp công cụ có khả năng mở rộng. Người dùng có thể bắt đầu bằng terminal rồi kết nối thêm editor hoặc nguồn dữ liệu khi thật sự cần.
Hạn chế và rủi ro
Agent có thể tạo code hợp lệ về cú pháp nhưng sai logic nghiệp vụ. Khi codebase lớn, ngữ cảnh bị thiếu có thể dẫn đến sửa nhầm tầng, lặp lại tính năng hoặc phá vỡ tương thích. Mỗi lệnh shell được phê duyệt cũng có thể thay đổi nhiều file hơn dự kiến.
Chi phí mô hình là một yếu tố khác. Nhiệm vụ dài, đọc nhiều file và lặp lại test có thể tiêu thụ nhiều token. Hiệu quả cần được đo bằng thời gian review và chất lượng kết quả, không chỉ tốc độ sinh code.
Cuối cùng, hệ sinh thái thay đổi nhanh. Lệnh, yêu cầu Node.js, model và cấu trúc cấu hình có thể khác theo phiên bản. Hãy ưu tiên tài liệu chính thức và kiểm tra version trước khi áp dụng hướng dẫn cũ.
Checklist bảo mật khi dùng AI coding agent
-
Chạy agent trong repository có Git và tạo branch riêng.
-
Không để secret thật trong file mà agent không cần đọc.
-
Kiểm tra lệnh shell, đường dẫn và phạm vi trước khi phê duyệt.
-
Không cấp quyền quản trị hệ thống nếu nhiệm vụ không yêu cầu.
-
Review diff, dependency và file cấu hình sau mỗi thay đổi.
-
Chạy test, lint, type-check và kiểm tra bảo mật phù hợp.
-
Xem nội dung web và output từ MCP là dữ liệu không đáng tin cậy.
-
Thu hồi API key ngay khi nghi ngờ bị lộ và không đưa key vào Git.
Câu hỏi thường gặp
Kimi Code CLI có miễn phí không?
Mã nguồn CLI được phát hành theo giấy phép MIT, nhưng việc gọi mô hình có thể yêu cầu gói Kimi Code hoặc API key có tính phí. Chính sách giá thay đổi theo thời điểm, nên cần xem trang chính thức trước khi sử dụng.
Kimi Code CLI có cần Node.js không?
Không cần cài Node.js trước nếu dùng script chính thức để tải binary. Nếu cài qua npm, bạn cần phiên bản Node.js đáp ứng yêu cầu được ghi trong tài liệu hiện hành.
Kimi Code CLI dùng được trên Windows không?
Có. Công cụ có script PowerShell cho Windows và yêu cầu Git for Windows để cung cấp môi trường Git Bash.
Vì sao lệnh kimi mcp không hoạt động?
Lệnh này có thể thuộc dự án kimi-cli cũ. Kimi Code CLI hiện hành hướng dẫn cấu hình MCP qua /mcp-config hoặc file cấu hình tương ứng. Hãy xác định đúng build đang cài.
Kimi Code CLI có tự sửa code không?
Có thể, nếu được cấp quyền phù hợp. Người dùng vẫn cần giới hạn phạm vi, xem diff và chạy bộ kiểm tra trước khi chấp nhận thay đổi.
Có nên cho Kimi Code CLI truy cập toàn bộ máy tính không?
Không nên cấp quyền rộng hơn nhu cầu. Hãy khởi chạy trong thư mục dự án, bảo vệ secret và cân nhắc container hoặc môi trường thử nghiệm với repository không tin cậy.
Kết luận
Kimi Code CLI là AI coding agent hoạt động trong terminal, có thể đọc và chỉnh sửa code, chạy lệnh, quan sát kết quả và xử lý nhiệm vụ nhiều bước. Với cài đặt mới, cần phân biệt kimi-code hiện hành với kimi-cli cũ để tránh dùng sai lệnh và cấu hình.
Công cụ phù hợp nhất khi nhiệm vụ có phạm vi rõ, repository có Git và người dùng kiểm soát quyền truy cập. Kimi Code CLI có thể rút ngắn thời gian khám phá codebase, sửa lỗi và viết test, nhưng không thay thế code review, kiểm thử hay trách nhiệm của người triển khai.




