Kimi Code CLI: Hướng dẫn cài đặt và chạy tác nhân lập trình tự động của Moonshot

Moonshot AI đã ra mắt Kimi Code cùng với mô hình Kimi K2.7 Code: một tác nhân lập trình chạy trên terminal, có khả năng đọc kho lưu trữ của bạn, viết và chỉnh sửa tệp, chạy các lệnh shell và tạo ra các tác nhân phụ để làm việc song song. Nếu bạn đã quen thuộc với Claude Code hoặc Codex, bạn sẽ thấy cấu trúc này quen thuộc. Sự khác biệt nằm ở công cụ bên dưới và mức giá. Kimi Code chạy trên một mô hình mã nguồn mở và tính phí theo gói đăng ký cố định thay vì tính theo từng token.

Hướng dẫn này sẽ giúp bạn từ một máy sạch đến tác vụ tác nhân đầu tiên của mình, sau đó trình bày các lệnh và cấu hình bạn thực sự sẽ sử dụng.

nút

Kimi Code là gì

Kimi Code là khung tác nhân của Moonshot, được xây dựng để tận dụng các điểm mạnh của mô hình K2.7 Code: duy trì suy nghĩ qua nhiều lượt, suy luận xen kẽ và gọi công cụ đa bước. Ngay từ đầu, nó có thể:

• Viết, gỡ lỗi và tái cấu trúc mã trên nhiều tệp
• Khám phá và giải thích các cơ sở mã lớn
• Chạy lệnh shell và xử lý tệp
• Tìm kiếm tài liệu và thông tin hiện tại trên web
• Tạo ra các tác nhân phụ để chạy các tác vụ song song

Nó chạy trong terminal của bạn, trong VS Code thông qua một tiện ích mở rộng, và trong JetBrains hoặc Zed thông qua giao thức ACP. Mô hình đằng sau nó là mã nguồn mở, vì vậy bạn có thể tự lưu trữ cùng một trí tuệ nếu cần; xem giải thích về Kimi K2.7 Code của chúng tôi để biết chi tiết mô hình.

Cài đặt Kimi Code

Trình cài đặt trước tiên sẽ tải uv (một trình quản lý gói Python), sau đó cài đặt CLI thông qua nó. Chỉ một dòng lệnh là đủ.

macOS và Linux:

curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

Windows (PowerShell):

irm https://code.kimi.com/kimi-code/install.ps1 | iex

Khi hoàn tất, hãy khởi động tác nhân từ bất kỳ thư mục dự án nào:

kimi

Lần chạy đầu tiên sẽ đưa bạn vào một phiên tương tác trong thư mục hiện tại của bạn. Kimi Code coi thư mục đó là thư mục gốc của dự án, vì vậy hãy cd vào kho lưu trữ bạn muốn làm việc trước khi khởi chạy nó.

Đăng nhập

Xác thực từ bên trong phiên bằng một lệnh:

/login

Điều đó sẽ khởi động quy trình OAuth với tài khoản Kimi của bạn và kết nối CLI với nền tảng Kimi Code. Nếu bạn muốn sử dụng khóa API, ví dụ để điều khiển một công cụ của bên thứ ba, hãy tạo một khóa trong bảng điều khiển Kimi Code. Mỗi tài khoản cho phép tối đa 5 khóa.

Một lưu ý nhanh về hạn mức: Kimi Code chạy theo các gói đăng ký và giới hạn được làm mới theo chu kỳ 7 ngày thay vì hàng tháng. Giới hạn tốc độ khoảng từ 300 đến 1200 yêu cầu mỗi 5 giờ với tối đa 30 yêu cầu đồng thời, tùy thuộc vào gói của bạn. Kiểm tra /usage giữa phiên để xem bạn còn lại bao nhiêu.

Nhiệm vụ đầu tiên của bạn

Khi tác nhân đã đăng nhập, bạn chỉ cần mô tả những gì bạn muốn bằng ngôn ngữ đơn giản. Một lần chạy đầu tiên tốt là để nó tìm hiểu dự án:

/init

/init phân tích cơ sở mã và ghi một tệp AGENTS.md ghi lại cấu trúc, quy ước và các điểm truy cập chính. Tác nhân đọc tệp đó trong các lần chạy sau, vì vậy nó bắt đầu mỗi phiên với ngữ cảnh thay vì phải khám phá lại kho lưu trữ của bạn mỗi lần. Nếu bạn đã sử dụng DESIGN.md cho các tác nhân lập trình, thì đây là ý tưởng tương tự được áp dụng tự động.

Sau đó, giao cho nó công việc thực sự:

Add input validation to the POST /users endpoint and write a test for the empty-email case.

Kimi Code lập kế hoạch thay đổi, chỉnh sửa tệp, chạy thử nghiệm và báo cáo lại. Theo mặc định, nó sẽ hỏi trước khi thực hiện các hành động phá hoại. Nếu bạn tin tưởng nó với một tác vụ và muốn nó ngừng hỏi, hãy bật chế độ tự động chấp thuận:

/yolo

Hãy sử dụng lệnh đó một cách cẩn thận. Nó rất tốt cho công việc phát triển từ đầu, nhưng rủi ro với một kho lưu trữ quan trọng đối với bạn.

Các lệnh gạch chéo đáng biết

Bạn điều khiển một phiên bằng các lệnh gạch chéo. Đây là những lệnh bạn sẽ sử dụng hàng ngày.

/compact là lệnh bị đánh giá thấp. Các lần chạy tác nhân dài sẽ lấp đầy cửa sổ ngữ cảnh bằng đầu ra công cụ; việc nén giúp tóm tắt lịch sử để bạn có thể tiếp tục mà không cần bắt đầu lại hoặc vượt quá giới hạn cửa sổ.

Kết nối nó với trình soạn thảo hoặc tác nhân hiện có của bạn

Bạn không cần phải từ bỏ thiết lập hiện tại của mình để sử dụng mô hình K2.7 Code.

VS Code. Cài đặt tiện ích mở rộng “Kimi Code” từ marketplace và đăng nhập bằng cùng một tài khoản.

JetBrains và Zed. Kết nối thông qua giao thức ACP của CLI, để tác nhân chạy bên trong trình soạn thảo bạn đã sử dụng.

Claude Code, Cline và RooCode. Mô hình được cung cấp thông qua API tương thích với OpenAI. Trỏ URL cơ sở của công cụ tới https://api.moonshot.ai/v1, đặt mô hình thành kimi-k2.7-code, và thêm khóa API. Quy trình này giống với quy trình chúng tôi đã tài liệu hóa để chạy Kimi bên trong Claude Code và Cursor; chỉ có ID mô hình thay đổi.

Tùy chỉnh với MCP và các tác nhân phụ

Hai tính năng khiến Kimi Code đáng để cấu hình hơn là chỉ chạy.

Giao thức Ngữ cảnh Mô hình (MCP). Kimi Code là một máy khách MCP, vì vậy bạn có thể cắm các máy chủ công cụ bên ngoài: trình đọc cơ sở dữ liệu, trình duyệt, API nội bộ, trình theo dõi sự cố của bạn. Tác nhân sau đó gọi các công cụ đó như một phần của tác vụ. Nếu bạn đang xây dựng hoặc thử nghiệm máy chủ MCP, hướng dẫn thử nghiệm máy chủ MCP của chúng tôi trình bày cách xác thực hợp đồng công cụ trước khi bạn giao nó cho một tác nhân.

Tác nhân phụ. Đối với công việc có thể chia nhỏ rõ ràng, Kimi Code có thể tạo ra các tác nhân phụ chạy song song và báo cáo lại cho phiên chính. Hãy nghĩ đến các tác vụ như “quét mọi dịch vụ để tìm lệnh gọi đã bị loại bỏ” hoặc “soạn thảo thử nghiệm cho sáu mô-đun này cùng một lúc.” Bạn định nghĩa các tác nhân tùy chỉnh trong cấu hình, giống như các tác nhân phụ của Claude Code.

Kiểm tra API đằng sau nó trước khi bạn xây dựng

Nếu bạn đang tích hợp kimi-for-coding vào công cụ của riêng mình thông qua API, hãy kiểm tra điểm cuối thô trước để bạn biết chính xác những gì nó trả về. Apidog cung cấp cho bạn một không gian làm việc trực quan cho việc đó.

1. Tạo yêu cầu POST tới https://api.moonshot.ai/v1/chat/completions.
2. Thêm tiêu đề Authorization: Bearer <your-key> bằng cách sử dụng khóa từ bảng điều khiển nền tảng Kimi.
3. Gửi nội dung theo kiểu OpenAI với "model": "kimi-k2.7-code" và messages của bạn.
4. Đọc phản hồi đã định dạng và việc sử dụng token, sau đó lưu lệnh gọi dưới dạng một thử nghiệm có thể tái sử dụng.

Từ đó, bạn có thể xác nhận các mã trạng thái, xác thực cấu trúc lệnh gọi công cụ mà tác nhân phụ thuộc vào và chạy lại các kiểm tra bất cứ khi nào Moonshot cập nhật mô hình. Tải xuống Apidog để thiết lập.

Kimi Code có đáng để chuyển sang không?

Câu trả lời thật lòng phụ thuộc vào những gì bạn ưu tiên. Mô hình K2.7 Code tụt lại sau GPT-5.5 và Claude Opus vài điểm trên hầu hết các điểm chuẩn lập trình, vì vậy nếu bạn muốn chất lượng tốt nhất có thể trong một lần chạy, các mô hình đóng vẫn chiếm ưu thế. Nhưng Kimi Code kết hợp một tác nhân mạnh mẽ với một mô hình mã nguồn mở và giá cố định, điều này thay đổi cách tính toán cho bất kỳ ai chạy các phiên tác nhân dài cả ngày. Để so sánh trực tiếp về vị trí của các tác nhân hiện tại, hãy xem so sánh Claude Code và OpenAI Codex của chúng tôi.

Bước đi ít rủi ro: cài đặt nó, chạy /init trên một dự án phụ và giao cho nó một nhiệm vụ thực sự. Bạn sẽ biết ngay trong một buổi chiều xem liệu nó có xứng đáng có một vị trí bên cạnh tác nhân hiện tại của bạn hay không.

Câu hỏi thường gặp

Làm thế nào để cài đặt Kimi Code? Chạy trình cài đặt một dòng (curl ... | bash trên macOS/Linux, irm ... | iex trên Windows), sau đó khởi động nó bằng kimi.

Làm thế nào để đăng nhập? Chạy /login bên trong phiên để sử dụng OAuth, hoặc tạo khóa API trong bảng điều khiển Kimi Code cho các công cụ của bên thứ ba.

Nó chạy mô hình nào? Kimi K2.7 Code. Với gói đăng ký Kimi Code, ID mô hình là kimi-for-coding; trên API Moonshot tính phí theo token, nó là kimi-k2.7-code.

Nó có hoạt động trong VS Code không? Có, thông qua tiện ích mở rộng “Kimi Code”. JetBrains và Zed kết nối qua giao thức ACP.

Tôi có thể sử dụng nó với Claude Code hoặc Cline không? Có. API tương thích với OpenAI, vì vậy hãy trỏ URL cơ sở của công cụ đến điểm cuối Kimi và đặt ID mô hình.

Chi phí bao nhiêu? Nó chạy theo các gói đăng ký với hạn mức làm mới sau mỗi 7 ngày, không phải tính phí theo token. Kiểm tra /usage để xem hạn mức còn lại của bạn.

Nó có hỗ trợ MCP không? Có. Kimi Code là một máy khách MCP và hỗ trợ các tác nhân phụ tùy chỉnh.

Tóm tắt

Kimi Code là một tác nhân lập trình chạy trên terminal và IDE, được xây dựng trên mô hình mã nguồn mở K2.7 Code của Moonshot. Cài đặt nó bằng một lệnh, đăng nhập bằng /login, chạy /init để nó tìm hiểu kho lưu trữ của bạn, và bắt đầu giao cho nó các tác vụ. Nó hỗ trợ MCP, tạo ra các tác nhân phụ và tích hợp với VS Code, JetBrains, Zed, và các công cụ tương thích với OpenAI như Claude Code. Nó không phải là tác nhân có điểm số cao nhất trên lý thuyết, nhưng việc định giá cố định trên một mô hình mã nguồn mở khiến nó trở thành một lựa chọn nghiêm túc cho việc sử dụng hàng ngày cường độ cao. Đầu tiên hãy kiểm tra API trong Apidog, sau đó giao cho tác nhân một nhiệm vụ thực tế và đánh giá nó dựa trên mã của riêng bạn.

nút