Kimi Code CLI là Tác tử AI lập trình trên terminal mã nguồn mở của Moonshot AI — có thể đọc và chỉnh sửa mã, chạy lệnh shell, đồng thời lên kế hoạch cho bước tiếp theo dựa trên phản hồi của bạn. Tài liệu tham khảo nhanh này tập hợp các lệnh Kimi Code, lệnh dấu gạch chéo, phím tắt, công cụ tích hợp và quy trình làm việc hằng ngày mà các nhà phát triển thường dùng nhất. Hãy mở tài liệu này bên cạnh terminal và dùng /help trong Kimi Code hoặc kimi --help trong shell để kiểm tra các tính năng mà phiên bản hiện tại của bạn hỗ trợ.
Để biết thông tin chi tiết từ nguồn chính thức, hãy xem tài liệu tham khảo về lệnh kimi, lệnh dấu gạch chéo, công cụ tích hợp và phím tắt.
Cài đặt Kimi Code CLI
Với hầu hết nhà phát triển, script cài đặt chính thức là cách nhanh nhất: script này cài một tệp nhị phân Kimi Code duy nhất và không yêu cầu Node.js. Bạn cũng có thể dùng Homebrew, npm và pnpm nếu phù hợp hơn với bộ công cụ cục bộ của mình.
| Nền tảng / trình quản lý | Lệnh |
|---|---|
| Tập lệnh 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, hãy mở terminal mới và xác minh tệp nhị phân:
Bắt đầu tại đây
Hãy dùng quy trình tối thiểu này khi lần đầu vào một dự án:
Chỉ dùng --yolo, /yolo và /auto trong các không gian làm việc mà bạn tin cậy. Chúng giảm bớt việc phải phê duyệt, nhưng cũng cho phép Kimi Code hoạt động tự chủ hơn.
Các lệnh thường dùng nhất
Nếu chỉ nhớ một vài lệnh, hãy nhớ những lệnh này — chúng đáp ứng phần lớn các phiên làm việc hằng ngày.
| Lệnh | Chức năng |
|---|---|
kimi | Bắt đầu 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 đây nhất tại đây |
kimi -p "..." | Chạy một câu lệnh nhắc duy nhất mà không mở TUI |
/login | Đăng nhập khi khởi chạy lần đầu |
/init | Tạo hoặc làm mới AGENTS.md |
/plan on | Vào Chế độ Lập kế hoạch cho các thay đổi quy mô lớn hoặc có rủi ro |
/model | Chuyển mô hình cho phiên này |
/compact | Giải phóng ngữ cảnh 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 đây |
/help | Liệt kê tất cả lệnh và phím tắt |
Shift-Tab | Bật/tắt Chế độ Lập kế hoạch |
Khởi chạy và tự động hóa
Tùy chọn CLI cốt lõi
| Lệnh / Cờ | Chức nă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 đây 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ở trình chọn phiên nếu không có ID |
kimi -p "...", kimi --prompt "..." | Chạy một câu lệnh nhắc 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 tập lệnh; 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 một phiên mới ở Chế độ Lập kế hoạch |
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 các thư mục đáng tin cậy |
kimi --auto | Khởi động ở chế độ cấp quyền tự động; các phê duyệt được xử lý tự động và Tác tử 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 kỹ năng 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 cần vào TUI |
kimi acp | Chạy Kimi Code dưới dạng máy chủ Agent Client Protocol để tích hợp với IDE |
kimi doctor | Kiểm tra config.toml và tui.toml |
kimi export [sessionId] | Đóng gói một phiên thành kho lưu trữ ZIP |
kimi rc | Mở Web UI qua Remote Control (bí danh kimi remote) |
kimi session list | Liệt kê các phiên cho script |
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 web | Chạy Web UI cục bộ và dịch vụ API REST/WebSocket |
Giao diện web và truy cập từ xa:
Lệnh dấu gạch chéo
Lệnh dấu gạch chéo là các thành phần điều khiển TUI tích hợp. Nhập / vào ô nhập để mở tính năng hoàn tất lệnh; bí danh cũng được nhận diện. Nếu dữ liệu nhập bắt đầu bằng / không khớp với lệnh tích hợp hoặc lệnh Skill, dữ liệu đó sẽ được gửi đến Tác tử như một tin nhắn thông thường.
Tài khoản và cấu hình
| Lệnh | Bí danh | Mục đích |
|---|---|---|
/login | — | Đăng nhập qua OAuth kimi.ai / kimi.com hoặc khóa API |
/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ý nhà cung cấp để xem, thêm và xóa các nhà cung cấp đã cấu hình |
/model | — | Chuyển mô hình LLM dùng trong phiên hiện tại |
/effort | — | Chuyển mức độ suy luận (tắt/thấp/cao/tối đa) |
/secondary-model | — | Cấu hình nhóm mô hình tác tử phụ |
/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 người dùng đầu cuối |
/remote-control | /rc | Truy cập từ xa vào một phiên web cục bộ |
Quản lý phiên
| Lệnh | Bí danh | Mục đích |
|---|---|---|
/new | /clear | Bắt đầu một phiên mới, bỏ 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ụ chạy nền |
/fork | — | Tạo bản sao phân nhánh của phiên hiện tại và vẫn ở trong phiên này |
/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 cho biết nội dung cần giữ lại |
/undo [n] | — | Hoàn tác các lời nhắc 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 thiết lập mới nhất trong config.toml và tui.toml |
/reload-tui | — | Chỉ tải lại tùy chọn giao diện trong tui.toml |
/init | — | Phân tích cơ sở mã 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 dưới dạng kho lưu trữ ZIP gỡ lỗi |
Chế độ và điều khiển chạy
| Lệnh | Bí danh | Mục đích |
|---|---|---|
/yolo | /yes | Chuyển sang chế độ Hỏi khi cần: các thao tác thông thường tự động chạy, thao tác rủi ro vẫn sẽ hỏi |
/auto | — | Chuyển sang chế độ Không bao giờ hỏi: mọi thứ tự động chạy |
/plan [on\|off] | — | Bật/tắt Chế độ Lập kế hoạch; chỉ bật/tắt sẽ không tạo tệp kế hoạch trống |
/plan clear | — | Xóa kế hoạch hiện tại |
/tower | — | Điều phối worktree đa tác tử (thử nghiệm; bật trong /experiments) |
/swarm on\|off | — | Bật hoặc tắt chế độ swarm mà không gửi lời nhắc |
/swarm <task> | — | Bật chế độ swarm, gửi tác vụ dưới dạng lời nhắc, 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ủ |
Chế độ Kế hoạch dành cho công việc quy mô lớn, rủi ro hoặc chưa rõ ràng. Chế độ này ưu tiên khám phá và lập kế hoạch trước khi thay đổi tệp.
/plan on, để Kimi Code kiểm tra dự án, xem xét kế hoạch được đề 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 và trạng thái
| Lệnh | Bí danh | Mục đích |
|---|---|---|
/help | /h, /? | Hiển thị phím tắt và các lệnh có sẵn |
/btw [question] | — | Mở cuộc trò chuyện phụ trong một tác tử phụ được phân 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 ngạch |
/status | — | Hiển thị trạng thái thời gian chạy: phiên bản, mô hình, thư mục làm việc, chế độ quyền và nhiều thông tin khác |
/mcp | — | Liệt kê các 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 và tiện ích mở rộng
Một lời nhắc có thể kích hoạt nhiều Skills.
| 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 giao diện 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, Skill và cài đặt MCP của Claude Code và Codex |
/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 nào trùng tên |
/parent.child [extra text] | Gọi một kỹ năng con 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 biểu thường cần được phê duyệt, trừ khi chế độ quyền của bạn cho phép chúng.
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 đượ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 Chế độ Lập kế hoạch |
ExitPlanMode | Tự động cho phép; người dùng xác nhận kế hoạch | Thoát Chế độ Lập kế hoạch 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 một Tác tử phụ cho tác vụ phụ 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 tác tử phụ dựa trên mục hoặc tiếp tục các tác tử phụ 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ụ theo lịch
| Công cụ | Phê duyệt mặc định | Mục đích |
|---|---|---|
TaskList | Tự động cho phép | Liệt kê các tác vụ chạy nền |
TaskOutput | Tự động cho phép | Xem đầu ra của một tác vụ chạy nền |
WaitFor | Tự động cho phép | Chờ các tác vụ chạy nền trong lượt hiện tại |
TaskStop | Cần phê duyệt | Dừng một tác vụ chạy nền đang chạy |
CronCreate | Cần phê duyệt | Lên lịch để một lời nhắc được kích hoạt trong tương lai |
CronList | Tự động cho phép | Liệt kê các 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. Xem tài liệu tham khảo chính thức về Phím tắt để biết danh sách đầy đủ từ nguồn gốc.
Nhập liệu chung
| Phím tắt | Thao tác |
|---|---|
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 cửa sổ bật lên, hủy hoàn thành hoặc ngắt luồng / nén ngữ cảnh |
Ctrl-C | Ngắt đầu ra đang truyền hoặc xóa ô nhập |
Ctrl-D | Thoát khi ô nhập trống |
Chuyển chế độ và chỉnh sửa
| Phím tắt | Thao tác |
|---|---|
Shift-Tab | Bật/tắt Chế độ lập kế hoạch |
Ctrl-G | Chỉnh sửa nội dung nhập hiện tại bằng trình soạn thảo bên ngoài |
Ctrl-V | Dán hình ảnh hoặc video từ bảng tạm trên Unix / macOS |
Alt-V | Dán hình ảnh hoặc video từ bảng tạm trên Windows |
Ctrl-- | Hoàn tác chỉnh sửa nội dung nhập |
Trong khi truyền dữ liệu 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 nhập hiện tại vào lượt đang chạy |
Esc | Ngắt đầu ra đang truyền trực tuyến |
Ctrl-C | Ngắt đầu ra đang truyền trực tuyến |
Ctrl-O | Mở rộng hoặc thu gọn đầu ra của công cụ |
Ctrl-B | Chuyển lệnh shell đang chạy thành tác vụ chạy nền |
Bảng phê duyệt
| Phím tắt | Thao tác |
|---|---|
↑ / ↓ | Di chuyển giữa các tùy chọn phê duyệt |
Enter | Xác nhận tùy chọn phê duyệt đã chọn |
1 – 9 | Chọn tùy chọn phê duyệt theo 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 phần so sánh khác biệt hay bản xem trước tệp đang được duyệt |
Cửa sổ bật lên và trợ giúp
| Phím tắt | Thao tác |
|---|---|
PageUp / PageDown | Cuộn cửa sổ bật lên mỗi lần 10 dòng |
q / Q | Đóng cửa sổ bật lên |
Enter | Đóng cửa sổ trợ giúp |
Quy trình làm việc phổ biến
Bắt đầu một repo mới
Lập kế hoạch tái cấu trúc 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 một phiên
Kết luận
Kimi Code CLI hoạt động hiệu quả nhất khi được xem như một đồng đội làm việc trong terminal, với ngữ cảnh dự án rõ ràng. 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 công việc kéo dài bằng /tasks, dùng sẵn /compact cho các phiên dài và chọn chế độ quyền phù hợp với mức độ tin cậy của repo.
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 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ỉ sử dụng trong các không gian làm việc đáng tin cậy, có quản lý phiên bản. Với kho lưu trữ không quen thuộc hoặc dữ liệu sản xuất, hãy giữ chế độ phê duyệt./skill:name, /mcp và /mcp-config để khám phá và cấu hình chúng.