Tài liệu tra cứu nhanh này tập hợp các lệnh Kimi Code, 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. Hãy mở nó cạnh terminal, đồng thời 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 của bạn hỗ trợ.
Để xem chi tiết từ nguồn chính thức, tham khảo tài liệu về lệnh kimi, slash commands, công cụ tích hợp và phím tắt.
Bắt đầu tại đây
Khi vào một dự án lần đầu, hãy dùng vòng lặp tối thiểu này:
Chỉ dùng --yolo, /yolo và /auto trong những workspace bạn tin tưởng. Chúng giảm bớt bước phê duyệt, nhưng cũng cho phép Kimi Code tự chủ hơn khi hành động.
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, mở một terminal mới và kiểm tra binary:
Khởi chạy & tự động hóa
Tùy chọn CLI cốt lõi
| Lệnh / Cờ | Tác dụng |
|---|---|
kimi | Bắt đầu 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 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 | Phát ra sự kiện JSONL để viết 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ệnh gọi công cụ thông thường; chỉ dùng trong thư mục đáng 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 đượ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 bằng mã thiết bị OAuth của Kimi Code mà không vào TUI |
kimi acp | Chạy Kimi Code như một server 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 | Kiểm tra tính hợp lệ của config.toml và tui.toml |
kimi export [sessionId] | Đóng gói một phiên thành tệp 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 đối sánh. Nếu nội dung bắt đầu bằng / không khớp với lệnh tích hợp hoặc lệnh Skill nào, nó 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 | — | Chuyển 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, bỏ qua ngữ cảnh hiện tại |
/sessions | /resume | Duyệt các phiên trước đây và chuyển sang một phiên |
/tasks | /task | Duyệt danh sách tác vụ nền |
/fork | — | Tạo nhánh phiên mới từ cuộc trò chuyện hiện tại |
/title [...] | /rename | Hiển thị hoặc đặt tiêu đề cho phiên hiện tại |
/compact [...] | — | Thu gọn ngữ cảnh cuộc trò chuyện; văn bản tùy chọn gợi ý những gì 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ài đặt config.toml cùng 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 tệp ZIP gỡ lỗi |
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 sẽ 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; phê duyệt được xử lý tự động và các câu hỏi sẽ bị bỏ qua |
/plan [on|off] | — | Bật/tắt Plan Mode; chỉ bật/tắt không tạo tệp kế hoạch trố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ụ làm prompt, rồi tắt chế độ swarm sau một lượt bình thường |
/goal [...] | — | Bắt đầu hoặc quản lý một mục tiêu tự động |
Plan Mode dành cho các 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 đề xuất rồi phê duyệt trước khi thực hiện thay đổi.Các lệnh con của chế độ mục tiêu 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 và các lệnh có sẵn |
/btw [question] | — | Mở một cuộc trò chuyện bên trong 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, model, thư mục làm việc, chế độ quyền và nhiều 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 về 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 theme 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à cài đặt 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 Skill bên ngoài khi không có lệnh hệ thống nào trùng tên |
/parent.child [extra text] | Gọi một sub-skill bên ngoài được cung cấp qua 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; các 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 có thể |
FetchURL | Tự động cho phép | Lấy nội dung của URL được 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ị được |
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 ở chế độ swarm; trường hợp khác có thể cần phê duyệt | Khởi chạy các subagent theo từng mục hoặc tiếp tục các subagent 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 inline đã đă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 một 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
Nhập /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 để có danh sách upstream đầy đủ.
Nhập liệu chung
| Phím tắt | Hành động |
|---|---|
Enter | Gửi nội dung nhập hiện tại |
Shift-Enter / Ctrl-J | Chèn dòng mới |
↑ / ↓ | Duyệt lịch sử nhập liệu |
Esc | Đóng popup, hủy hoàn thành hoặc ngắt streaming / nén ngữ cảnh |
Ctrl-C | Ngắt đầu ra streaming hoặc xóa ô nhập liệu |
Ctrl-D | Thoát khi ô nhập liệu đang trống |
Chuyển chế độ và chỉnh sửa
| Phím tắt | Hành động |
|---|---|
Shift-Tab | Bật/tắt Plan Mode |
Ctrl-G | Chỉnh sửa nội dung nhập hiện tại 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 nội dung nhập |
Khi streaming và xuất đầu ra công cụ
| Phím tắt | Hành động |
|---|---|
Ctrl-S | Điều hướng: chèn nội dung nhập hiện tại 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 | Hành động |
|---|---|
↑ / ↓ | 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 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 nền, hoặc để Kimi Code thông báo 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 trong TUI.
Xuất hoặc gỡ lỗi phiên
Kết luận
Kimi Code CLI phát huy 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 với /init, dùng /plan cho các thay đổi lớn hoặc còn chưa chắc chắn, theo dõi những tác vụ chạy lâu bằng /tasks, luôn nhớ dùng /compact trong các 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 cho 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 sản xuất, hãy giữ bật phê duyệt./skill:name, /mcp và /mcp-config để khám phá và cấu hình chúng.