Kimi Code CLI là AI coding agent chạy trong terminal, mã nguồn mở của Moonshot AI — có thể đọc và chỉnh sửa mã, chạy lệnh shell và lên kế hoạch bước tiếp theo dựa trên phản hồi của bạn. Tài liệu tra cứu nhanh này tập hợp các commands, slash commands, phím tắt, công cụ tích hợp và quy trình hằng ngày mà lập trình viên dùng nhiều nhất với Kimi Code. Hãy mở nó cạnh terminal của bạn, và dùng /help trong Kimi Code hoặc kimi --help trong shell để kiểm tra những gì phiên bản hiện tại hỗ trợ.
Để biết chi tiết từ nguồn chính thức, xem tài liệu tham khảo về lệnh kimi, slash commands, công cụ tích hợp và phím tắt.
Cài đặt Kimi Code CLI
Với hầu hết lập trình viên, script cài đặt chính thức là cách nhanh nhất: nó cài một binary Kimi Code duy nhất và không yêu cầu Node.js. Homebrew, npm và pnpm cũng có sẵn nếu phù hợp hơn với toolchain cục bộ của bạn.
| Nền tảng / trình quản lý | Lệnh |
|---|---|
| script macOS / Linux | curl -fsSL https://code.kimi.com/kimi-code/install.sh \| bash |
| Homebrew | brew install kimi-code |
| Windows PowerShell | irm https://code.kimi.com/kimi-code/install.ps1 \| iex |
| npm | npm install -g @moonshot-ai/kimi-code |
| pnpm | pnpm add -g @moonshot-ai/kimi-code |
Trên Windows, hãy cài Git for Windows trước lần khởi chạy đầu tiên vì Kimi Code CLI dùng Git Bash đi kèm làm môi trường shell. Sau khi cài đặt, mở một terminal mới và kiểm tra binary:
Bắt đầu tại đây
Dùng vòng lặp tối thiểu này khi bạn vào một dự án lần đầu:
Chỉ dùng --yolo, /yolo và /auto trong những workspace bạn tin cậy. Chúng giảm bớt bước phê duyệt, nhưng cũng cho phép Kimi Code hành động tự chủ hơn.
Các lệnh dùng nhiều nhất
Nếu chỉ ghi nhớ vài lệnh, hãy nhớ những lệnh này — chúng bao phủ hầu hết các phiên làm việc hằng ngày.
| Lệnh | Tác dụng |
|---|---|
kimi | Khởi động một phiên tương tác trong thư mục hiện tại |
kimi -C | Tiếp tục phiên gần nhất tại đây |
kimi -p "..." | Chạy một prompt duy nhất mà không mở TUI |
/login | Đăng nhập trong lần khởi chạy đầu tiên |
/init | Tạo hoặc làm mới AGENTS.md |
/plan on | Vào Plan Mode cho các thay đổi rộng hoặc rủi ro |
/model | Đổi mô hình cho phiên này |
/compact | Giải phóng context khi cuộc trò chuyện trở nên dài |
/sessions | Duyệt và tiếp tục các phiên trước |
/help | Liệt kê tất cả commands và phím tắt |
Shift-Tab | Bật/tắt Plan Mode |
Khởi chạy & tự động hóa
Tùy chọn CLI cốt lõi
| Lệnh / Flag | Tác dụng |
|---|---|
kimi | Khởi động một phiên tương tác trong thư mục hiện tại |
kimi --continue, kimi -C | Tiếp tục phiên gần nhất trong thư mục này |
kimi --session [id], kimi -S [id] | Tiếp tục một phiên theo ID, hoặc mở bộ chọn phiên nếu không có ID |
kimi -p "...", kimi --prompt "..." | Chạy một prompt không tương tác duy nhất mà không mở TUI |
--output-format stream-json | Xuất các sự kiện JSONL để dùng trong script; chỉ hoạt động với --prompt |
kimi --model <model>, kimi -m <model> | Khởi động với một bí danh mô hình cụ thể |
kimi --plan | Bắt đầu phiên mới trong Plan Mode |
kimi --yolo, kimi -y | Tự động phê duyệt các lần gọi công cụ thông thường; chỉ dùng trong thư mục tin cậy |
kimi --auto | Khởi động ở chế độ quyền tự động; các phê duyệt được xử lý tự động và Agent sẽ không đặt câu hỏi |
--skills-dir <dir> | Tải Skills từ thư mục đã chỉ định, thay thế các thư mục skill của người dùng và dự án được tự động phát hiện cho lần khởi chạy này |
Ví dụ không tương tác
Lệnh con CLI
| Lệnh con | Mục đích |
|---|---|
kimi login | Bắt đầu đăng nhập Kimi Code OAuth bằng mã thiết bị mà không vào TUI |
kimi acp | Chạy Kimi Code làm máy chủ Agent Client Protocol để tích hợp IDE |
kimi server | Chạy, cài đặt và quản lý dịch vụ REST/WebSocket/web cục bộ |
kimi web | Mở giao diện trình duyệt của Kimi; tương đương kimi server run --open |
kimi doctor | Xác thực config.toml và tui.toml |
kimi export [sessionId] | Đóng gói một phiên thành kho lưu trữ ZIP |
kimi migrate | Di chuyển dữ liệu cục bộ từ bản cài kimi-cli cũ |
kimi upgrade | Kiểm tra phiên bản mới nhất và hiển thị các tùy chọn cập nhật |
kimi vis [sessionId] | Mở trình trực quan hóa phiên trong trình duyệt |
kimi provider | Quản lý provider từ terminal |
Các lệnh server hữu ích:
Slash commands
Slash commands là các điều khiển TUI tích hợp sẵn. Nhập / trong ô nhập để mở gợi ý hoàn tất lệnh; alias cũng được khớp. Nếu dữ liệu nhập bắt đầu bằng / không khớp với lệnh tích hợp hay lệnh Skill nào, nội dung đó sẽ được gửi tới Agent như một tin nhắn thông thường.
Tài khoản & cấu hình
| Lệnh | Alias | Mục đích |
|---|---|---|
/login | — | Chọn tài khoản hoặc nền tảng rồi đăng nhập |
/logout | — | Xóa thông tin xác thực của tài khoản hiện tại |
/provider | — | Mở trình quản lý provider để xem, thêm và xóa các provider đã cấu hình |
/model | — | Chuyển mô hình LLM dùng trong phiên hiện tại |
/settings | /config | Mở bảng cài đặt trong TUI |
/experiments | /experimental | Mở bảng tính năng thử nghiệm |
/permission | — | Chọn chế độ quyền |
/editor | — | Cấu hình trình soạn thảo bên ngoài được mở bằng Ctrl-G |
/theme | — | Đổi chủ đề màu của giao diện terminal |
Quản lý phiên
| Lệnh | Alias | Mục đích |
|---|---|---|
/new | /clear | Bắt đầu phiên mới, loại bỏ ngữ cảnh hiện tại |
/sessions | /resume | Duyệt các phiên trước và chuyển sang một phiên |
/tasks | /task | Duyệt danh sách tác vụ nền |
/fork | — | Tách một phiên mới từ cuộc trò chuyện hiện tại |
/title [...] | /rename | Hiển thị hoặc đặt tiêu đề phiên hiện tại |
/compact [...] | — | Nén ngữ cảnh cuộc trò chuyện; văn bản tùy chọn gợi ý nội dung cần giữ lại |
/undo [n] | — | Hoàn tác các prompt gần đây khỏi ngữ cảnh đang hoạt động |
/reload | — | Tải lại phiên và áp dụng các cài đặt config.toml và tui.toml mới nhất |
/reload-tui | — | Chỉ tải lại tùy chọn giao diện trong tui.toml |
/init | — | Phân tích codebase và tạo AGENTS.md |
/export-md [...] | /export | Xuất phiên hiện tại dưới dạng Markdown |
/export-debug-zip | — | Xuất phiên hiện tại thành kho lưu trữ ZIP để debug |
Chế độ & điều khiển chạy
| Lệnh | Alias | Mục đích |
|---|---|---|
/yolo [on\|off] | /yes | Bật/tắt chế độ YOLO; khi bật, bỏ qua phê duyệt cho các lệnh gọi công cụ thông thường |
/auto [on\|off] | — | Bật/tắt chế độ quyền tự động; các phê duyệt được xử lý tự động và bỏ qua câu hỏi |
/plan [on\|off] | — | Bật/tắt Plan Mode; chỉ bật/tắt sẽ không tạo tệp kế hoạch rỗng |
/plan clear | — | Xóa kế hoạch hiện tại |
/swarm on\|off | — | Bật hoặc tắt chế độ swarm mà không gửi prompt |
/swarm <task> | — | Bật chế độ swarm, gửi tác vụ dưới dạng prompt, rồi tắt chế độ swarm sau một lượt thông thường |
/goal [...] | — | Bắt đầu hoặc quản lý một mục tiêu tự chủ |
Plan Mode dành cho công việc rộng, rủi ro hoặc chưa rõ ràng. Chế độ này ưu tiên khảo sát và lập kế hoạch trước khi thay đổi tệp.
/plan on, để Kimi Code kiểm tra dự án, xem lại kế hoạch được đề xuất rồi phê duyệt trước khi có thay đổi.Các lệnh con của chế độ Goal gồm /goal status, /goal pause, /goal resume, /goal cancel, /goal replace <objective>, /goal next <objective> và /goal next manage.
Thông tin & trạng thái
| Lệnh | Alias | Mục đích |
|---|---|---|
/help | /h, /? | Hiển thị phím tắt bàn phím và các lệnh có sẵn |
/btw [question] | — | Mở cuộc trò chuyện phụ trong một sub-Agent được tách nhánh |
/usage | — | Hiển thị mức sử dụng token, mức tiêu thụ ngữ cảnh và thông tin hạn mức |
/status | — | Hiển thị trạng thái runtime: phiên bản, mô hình, thư mục làm việc, chế độ quyền và các thông tin khác |
/mcp | — | Liệt kê máy chủ MCP và trạng thái kết nối |
/plugins | — | Mở trình quản lý plugin |
/version | — | Hiển thị phiên bản Kimi Code CLI |
/feedback | — | Gửi phản hồi sản phẩm |
/exit | /quit, /q | Thoát Kimi Code CLI |
Skills & tiện ích mở rộng
| Lệnh | Mục đích |
|---|---|
/mcp-config | Cấu hình máy chủ MCP và xử lý đăng nhập MCP OAuth |
/custom-theme [...] | Tạo hoặc chỉnh sửa chủ đề màu TUI tùy chỉnh |
/update-config | Kiểm tra hoặc chỉnh sửa config.toml và tui.toml |
/import-from-cc-codex | Nhập hướng dẫn, Skills và thiết lập MCP từ Claude Code và Codex |
/sub-skill | Khám phá và sắp xếp lại kho Skill cục bộ |
/skill:name [extra text] | Gọi một Skill bên ngoài đã cài đặt |
/name [extra text] | Lối tắt cho một Skill bên ngoài khi không có lệnh hệ thống trùng tên |
/parent.child [extra text] | Gọi một sub-skill bên ngoài được cung cấp bằng tên lệnh có dấu chấm |
Công cụ tích hợp
Các công cụ tích hợp do chính Kimi Code CLI cung cấp. Theo mặc định, các công cụ chỉ đọc như Read, Grep và Glob được tự động cho phép; những công cụ ghi tệp, thực thi lệnh, dừng tác vụ hoặc tạo lịch thường cần được phê duyệt, trừ khi chế độ quyền của bạn cho phép.
Tệp, shell và web
| Công cụ | Phê duyệt mặc định | Mục đích |
|---|---|---|
Read | Tự động cho phép | Đọc tệp văn bản |
Write | Cần phê duyệt | Tạo hoặc ghi đè tệp |
Edit | Cần phê duyệt | Thay thế chính xác nội dung tệp |
Grep | Tự động cho phép | Tìm kiếm nội dung tệp bằng ripgrep |
Glob | Tự động cho phép | Tìm tệp theo mẫu glob |
ReadMediaFile | Tự động cho phép | Đọc tệp hình ảnh hoặc video |
Bash | Cần phê duyệt | Thực thi lệnh shell |
WebSearch | Tự động cho phép | Tìm kiếm trên web khi khả dụng |
FetchURL | Tự động cho phép | Lấy nội dung của một URL chỉ định |
Lập kế hoạch, trạng thái và cộng tác
| Công cụ | Phê duyệt mặc định | Mục đích |
|---|---|---|
EnterPlanMode | Tự động cho phép | Vào Plan Mode |
ExitPlanMode | Tự động cho phép; người dùng xác nhận kế hoạch | Thoát Plan Mode và gửi kế hoạch |
TodoList | Tự động cho phép | Quản lý danh sách việc cần làm hiển thị |
Agent | Tự động cho phép | Tạo sub-Agent cho một tác vụ con tập trung |
AgentSwarm | Tự động cho phép trong chế độ swarm; nếu không có thể cần phê duyệt | Khởi chạy subagents theo từng mục hoặc tiếp tục subagents hiện có |
AskUserQuestion | Tự động cho phép | Đặt câu hỏi trắc nghiệm có cấu trúc |
Skill | Tự động cho phép | Gọi một Skill nội tuyến đã đăng ký |
Tác vụ nền và tác vụ đã lên lịch
| Công cụ | Phê duyệt mặc định | Mục đích |
|---|---|---|
TaskList | Tự động cho phép | Liệt kê tác vụ nền |
TaskOutput | Tự động cho phép | Xem đầu ra của tác vụ nền |
TaskStop | Cần phê duyệt | Dừng tác vụ nền đang chạy |
CronCreate | Cần phê duyệt | Lên lịch để một prompt chạy trong tương lai |
CronList | Tự động cho phép | Liệt kê tác vụ đã lên lịch |
CronDelete | Cần phê duyệt | Hủy một tác vụ đã lên lịch |
Phím tắt
Gõ /help trong TUI để xem danh sách phím tắt có trong phiên bản hiện tại của bạn. Xem tài liệu chính thức Keyboard Shortcuts reference để biết danh sách đầy đủ từ upstream.
Nhập liệu chung
| Phím tắt | Thao tác |
|---|---|
Enter | Gửi nội dung đang nhập |
Shift-Enter / Ctrl-J | Chèn dòng mới |
↑ / ↓ | Duyệt lịch sử nhập liệu |
Esc | Đóng popup, hủy tự hoàn thành hoặc ngắt streaming / compaction |
Ctrl-C | Ngắt đầu ra streaming hoặc xóa ô nhập liệu |
Ctrl-D | Thoát khi ô nhập liệu trống |
Chuyển chế độ và chỉnh sửa
| Phím tắt | Thao tác |
|---|---|
Shift-Tab | Bật/tắt Plan Mode |
Ctrl-G | Chỉnh sửa nội dung đang nhập trong trình soạn thảo bên ngoài |
Ctrl-V | Dán hình ảnh hoặc video từ clipboard trên Unix / macOS |
Alt-V | Dán hình ảnh hoặc video từ clipboard trên Windows |
Ctrl-- | Hoàn tác chỉnh sửa nhập liệu |
Trong khi streaming và xuất kết quả công cụ
| Phím tắt | Thao tác |
|---|---|
Ctrl-S | Điều hướng: chèn nội dung đang nhập vào lượt đang chạy |
Esc | Ngắt đầu ra streaming hiện tại |
Ctrl-C | Ngắt đầu ra streaming hiện tại |
Ctrl-O | Mở rộng hoặc thu gọn đầu ra công cụ |
Bảng phê duyệt và popup
| Phím tắt | Thao tác |
|---|---|
↑ / ↓ | Di chuyển giữa các tùy chọn phê duyệt hoặc cuộn popup |
Enter | Xác nhận tùy chọn phê duyệt đã chọn; đồng thời đóng các popup trợ giúp |
1 – 9 | Chọn tùy chọn phê duyệt bằng số |
Esc / Ctrl-C / Ctrl-D | Từ chối yêu cầu phê duyệt hiện tại |
Ctrl-E | Mở rộng hoặc thu gọn toàn bộ diff hoặc nội dung xem trước tệp trong bảng phê duyệt |
PageUp / PageDown | Cuộn popup mỗi lần 10 dòng |
q / Q | Đóng popup |
Quy trình thường dùng
Khởi tạo repo mới
Lập kế hoạch refactor trước khi chỉnh sửa
Chạy tác vụ nền
Sau đó mở /tasks để theo dõi công việc chạy nền, hoặc để Kimi Code thông báo cho bạn khi tác vụ hoàn tất.
Tiếp tục công việc hôm qua
Nếu cần một phiên cụ thể, hãy chạy kimi --session hoặc dùng /sessions bên trong TUI.
Xuất hoặc gỡ lỗi một phiên
Kết luận
Kimi Code CLI hiệu quả nhất khi bạn xem nó như một đồng đội trong terminal và cung cấp rõ ngữ cảnh dự án. Hãy bắt đầu bằng /init, dùng /plan cho các thay đổi lớn hoặc chưa chắc chắn, theo dõi tác vụ chạy lâu bằng /tasks, luôn chuẩn bị /compact cho những phiên dài và chọn chế độ quyền phù hợp với mức độ tin cậy của repository.
Câu hỏi thường gặp
kimi --continue trong cùng thư mục dự án để tiếp tục phiên gần nhất. Dùng kimi --session [id] trong shell hoặc /sessions bên trong TUI để chọn một phiên cụ thể.--yolo bỏ qua bước phê duyệt đối với các lệnh gọi công cụ thông thường. Chỉ dùng trong workspace đáng tin cậy và có quản lý phiên bản. Với repository lạ hoặc dữ liệu production, hãy giữ bật phê duyệt./skill:name, /mcp và /mcp-config để khám phá và cấu hình chúng.