Moonshot AI đã xây dựng Kimi K3 cho các công việc lập trình mà không thể hoàn thành chỉ với một lời nhắc duy nhất. Mục tiêu là kỹ thuật dài hạn: hướng một mô hình đến một kho lưu trữ lớn, cho phép nó đọc tệp, chạy công cụ, thực thi các bài kiểm tra, đọc nhật ký và ảnh chụp màn hình nhận được, và lặp lại cho đến khi hoàn thành nhiệm vụ. Đây là một công việc khác với tự động hoàn thành và nó cần một tác nhân lập trình được tích hợp xung quanh mô hình. Moonshot cung cấp một tác nhân như vậy có tên là Kimi Code. Hướng dẫn này sẽ trình bày cách chạy K3 bên trong Kimi Code, một vòng lặp tác nhân thực tế trông như thế nào, vị trí của nó so với Claude Code và Cursor, và những hạn chế thực tế của nó.
TL;DR: chạy Kimi K3 để lập trình
Kimi K3 là mẫu flagship của Moonshot AI, ra mắt vào ngày 16 tháng 7 năm 2026, với cửa sổ ngữ cảnh 1 triệu token và kiến trúc được điều chỉnh cho các công việc quy mô kho lưu trữ. Bạn lập trình với nó thông qua Kimi Code, tác nhân lập trình terminal và IDE của Moonshot: chọn mô hình bằng lệnh /model và giao cho nó một nhiệm vụ. K3 mạnh mẽ trong việc điều hướng các cơ sở mã lớn, sử dụng công cụ, gỡ lỗi và lặp lại dựa trên hình ảnh, nhật ký, kiểm thử và phản hồi thời gian chạy. Nó rẻ cho các vòng lặp nặng bộ nhớ đệm nhờ tỷ lệ truy cập bộ nhớ đệm được báo cáo là hơn 90%, nhưng nó không phải là nhanh nhất với khoảng 62 token mỗi giây, và chính Moonshot cũng thừa nhận rằng nó vẫn còn kém Claude Fable 5 và GPT-5.6 Sol về khả năng thô. Khi K3 xây dựng một API cho bạn, Apidog là cách nhanh nhất để truy cập các điểm cuối mà nó tạo ra và xác nhận chúng hoạt động đúng. Để biết thông tin nền về mô hình, hãy bắt đầu với Kimi K3 là gì.
Kimi Code là gì
Kimi Code là tác nhân lập trình của Moonshot. Nó chạy trong terminal của bạn (và tích hợp với IDE của bạn), đọc và ghi tệp, thực thi các lệnh shell, và điều hành một phiên kỹ thuật hoàn chỉnh thay mặt bạn thay vì chỉ trả lời một câu hỏi. Mở nó bên trong một thư mục dự án, mô tả những gì bạn muốn, và nó sẽ lập kế hoạch, chỉnh sửa, chạy và kiểm tra công việc của chính nó trong một vòng lặp. Bản thân mô hình là một công cụ xử lý văn bản và công cụ; Kimi Code là phần khung cung cấp cho nó một hệ thống tệp, một shell, đầu ra kiểm thử và ảnh chụp màn hình để làm việc. Phần khung đó biến “một mô hình giỏi về mã” thành “một tác nhân có thể đóng một phiếu công việc.”
Kimi Code không phải là mới với K3; dòng Kimi K2 trước đây cũng chạy trong cùng một tác nhân. Hướng dẫn CLI của Kimi Code của chúng tôi bao gồm hướng dẫn cài đặt từ đầu, và cách sử dụng Kimi CLI là tài liệu tham khảo dòng lệnh rộng hơn. Bài viết này giả định CLI đã được cài đặt và tập trung vào việc điều khiển K3.
Chạy Kimi K3 trong Kimi Code
Lệnh cài đặt và các cờ chính xác thay đổi khi Moonshot cập nhật công cụ, vì vậy hãy coi các bước dưới đây như một khuôn mẫu của quy trình làm việc và xác nhận cú pháp chính xác trong tài liệu chính thức của Kimi hoặc hướng dẫn CLI của Kimi Code của chúng tôi. Các lệnh chỉ mang tính minh họa, không chính xác.
1. Cài đặt tác nhân và xác thực. Cài đặt công cụ dòng lệnh một lần, sau đó đăng nhập để nó có thể truy cập Kimi API. Bạn sẽ cần một tài khoản Kimi và khóa API từ nền tảng nhà phát triển Kimi. Lưu khóa dưới dạng biến môi trường thay vì dán nó vào một tệp cấu hình mà bạn có thể vô tình commit.
# Chỉ mang tính minh họa, không chính xác. Kiểm tra tài liệu chính thức để biết cú pháp hiện tại.
export KIMI_API_KEY="your-key-here"
kimi-code # khởi chạy tác nhân trong thư mục hiện tại
2. Mở nó bên trong dự án của bạn. Chuyển đến kho lưu trữ và khởi động tác nhân ở đó. Kimi Code coi thư mục hiện tại là thư mục gốc làm việc của nó và đọc cấu trúc dự án để xây dựng ngữ cảnh, vì vậy nơi bạn khởi chạy nó rất quan trọng.
3. Chọn K3 làm mô hình. Trong phiên làm việc, chuyển đổi mô hình đang hoạt động bằng lệnh /model và chọn kimi-k3. Đây là cơ chế tương tự mà bạn sẽ sử dụng để chuyển đổi giữa K3 và các mô hình cũ hơn như Kimi K2.7 Code tập trung vào lập trình cho cùng một tác vụ.
/model kimi-k3
4. Thiết lập mức độ nỗ lực suy luận. K3 cung cấp khả năng cấu hình mức độ nỗ lực suy luận, bao gồm cài đặt “tối đa”. Đối với việc gỡ lỗi khó hoặc tái cấu trúc lớn, việc suy nghĩ nhiều hơn sẽ hữu ích; đối với các chỉnh sửa nhanh, hãy giảm mức độ xuống để bạn không phải trả tiền cho độ sâu mà bạn không cần.
Sau khi mô hình được chọn và tác nhân trỏ đến kho lưu trữ của bạn, bạn đã sẵn sàng giao việc cho nó. Để dùng thử K3 mà không cần cài đặt Kimi Code, hoặc miễn phí, cách sử dụng Kimi K3 miễn phí sẽ hướng dẫn các cách không tốn phí.
Một quy trình làm việc lập trình tác nhân thực tế
Mô hình này giống nhau cho dù bạn đang sửa lỗi hay triển khai một tính năng: giao cho K3 một nhiệm vụ cụ thể, để nó thu thập ngữ cảnh và bắt nó phải chứng minh kết quả dựa trên một điều gì đó khách quan.
Hướng nó đến kho lưu trữ và giao một nhiệm vụ rõ ràng
Các hướng dẫn mơ hồ sẽ tạo ra công việc mơ hồ. Thay vì “cải thiện mô-đun xác thực,” hãy giao cho tác nhân một nhiệm vụ mà nó có thể xác minh: “Điểm cuối /login trả về lỗi 500 khi trường mật khẩu trống. Tái tạo lỗi, tìm nguyên nhân, sửa chữa và thêm một bài kiểm tra bao gồm trường hợp mật khẩu trống.” Một mục tiêu cụ thể, có thể kiểm thử là đòn bẩy lớn nhất đối với chất lượng đầu ra: nó cung cấp cho tác nhân một vạch đích để tự kiểm tra.
Ngữ cảnh 1M token của K3 là điều khiến việc “hướng nó đến toàn bộ kho lưu trữ” trở nên thực tế: tác nhân giữ một phần lớn cơ sở mã của bạn cùng một lúc, theo dõi một cuộc gọi từ trình xử lý tuyến đường qua lớp dịch vụ mà không cần bạn phải cung cấp từng tệp đúng. Moonshot coi việc điều hướng kho lưu trữ lớn là một điểm mạnh cốt lõi của K3.
Cho phép nó sử dụng công cụ và đọc phản hồi
Đây là lúc một tác nhân chứng tỏ giá trị của nó. K3 hỗ trợ các lệnh gọi công cụ, vì vậy bên trong Kimi Code, nó có thể chạy bộ kiểm thử của bạn, grep cơ sở mã, thực thi một bản dựng hoặc truy cập một dịch vụ đang chạy, sau đó đọc kết quả trả về:
- Tác nhân đọc các tệp liên quan và hình thành một giả thuyết.
- Nó thực hiện một chỉnh sửa.
- Nó chạy các bài kiểm thử hoặc ứng dụng.
- Nó đọc đầu ra lỗi, dấu vết ngăn xếp hoặc dòng nhật ký.
- Nó xem xét lại và lặp lại cho đến khi các kiểm tra thành công.
Moonshot gọi K3 là “đặc biệt mạnh mẽ trong việc điều hướng các kho lưu trữ lớn, sử dụng công cụ, gỡ lỗi và lặp lại dựa trên hình ảnh, nhật ký, kiểm thử và phản hồi thời gian chạy.” Vòng lặp đó là cốt lõi của quy trình làm việc: bạn không yêu cầu mô hình phải đúng ngay từ lần đoán đầu tiên, mà là chạy, quan sát và sửa chữa như một kỹ sư con người.
Lặp lại dựa trên hình ảnh và đầu ra thời gian chạy
Phản hồi không chỉ giới hạn ở văn bản. Moonshot nhấn mạnh khả năng suy luận hình ảnh là một phần trong phạm vi của K3: tác nhân có thể đọc ảnh chụp màn hình để xác nhận một thay đổi giao diện người dùng được hiển thị chính xác, hoặc sử dụng hình ảnh đã chụp để hướng dẫn phát triển trò chơi và công việc CAD. Vì vậy, một vòng lặp giao diện người dùng là: thay đổi CSS, hiển thị, chụp ảnh màn hình, điều chỉnh. Đối với công việc backend, phản hồi là báo cáo kiểm thử, luồng nhật ký hoặc phản hồi HTTP, và vòng lặp là như nhau.
Duy trì sự trung thực của vòng lặp bằng các bài kiểm thử
Các bài kiểm thử giúp một vòng lặp tự động không bị lệch hướng. Với một bộ kiểm thử thành công để hướng tới, tác nhân có một tín hiệu rõ ràng về “hoàn thành” và “hỏng”; nếu không có, một quá trình chạy dài có thể đi lạc và âm thầm làm hỏng thứ gì đó cách đó ba tệp. Hãy viết kiểm thử trước, sau đó để K3 lặp lại cho đến khi nó xanh.
Kimi K3 so với Claude Code và Cursor để lập trình
K3 trong Kimi Code không phải là thiết lập lập trình tác nhân duy nhất. Dưới đây là so sánh thẳng thắn ba cách phổ biến nhất để chạy một tác nhân trên cơ sở mã của bạn vào giữa năm 2026.
| Tiêu chí | Kimi Code (Kimi K3) | Claude Code (Fable 5) | Cursor |
|---|---|---|---|
| Yếu tố hình thức | Tác nhân lập trình Terminal và IDE | Tác nhân lập trình Terminal | Trình chỉnh sửa mã hoàn toàn AI-native |
| Mô hình mặc định | Kimi K3, có thể thay đổi qua /model |
Claude Fable 5, cùng các mô hình Claude khác | Tự mang theo hoặc các mô hình tiên tiến tích hợp |
| Cửa sổ ngữ cảnh | 1M token | Lớn, tùy thuộc vào mô hình | Tùy thuộc vào mô hình được chọn |
| Điều hướng kho lưu trữ | Mạnh; được xây dựng cho công việc quy mô lớn, dài hạn | Mạnh; truy cập tệp và shell theo tác nhân | Lập chỉ mục và truy xuất mạnh mẽ trong trình chỉnh sửa |
| Sử dụng công cụ | Gọi công cụ, shell, kiểm thử, ảnh chụp màn hình | Gọi công cụ, shell, MCP | Công cụ trong trình chỉnh sửa, terminal, MCP |
| Đòn bẩy chi phí | Rẻ cho các vòng lặp nặng bộ nhớ đệm (tỷ lệ truy cập bộ nhớ đệm 90%+) | Tính phí theo token Claude | Đăng ký cộng với mức sử dụng mô hình |
| Trọng số mở | Dự kiến khoảng 27 tháng 7 năm 2026 | Đóng | Trình chỉnh sửa là độc quyền; mô hình đa dạng |
| Tốt nhất cho | Các tác vụ tác nhân chạy dài, quy mô kho lưu trữ với ngân sách hợp lý | Suy luận và độ tin cậy hàng đầu | Các nhà phát triển muốn tác nhân bên trong trình chỉnh sửa của họ |
Một vài điểm cần lưu ý. Để có độ tin cậy thô cao nhất trong một nhiệm vụ khó, Fable 5 trong Claude Code là mô hình mà chính Moonshot cũng thừa nhận vượt trội hơn K3. Nếu bạn muốn tác nhân bên trong một trình chỉnh sửa hoàn thiện, các công cụ kiểu Cursor và Cline sẽ phù hợp hơn, và bạn có thể chạy các mô hình mở khác thông qua chúng, như hướng dẫn GLM-5.2 trong Claude Code, Cline và Cursor của chúng tôi đã chỉ ra. Lợi thế của K3 là ngữ cảnh rất lớn, khả năng điều hướng kho lưu trữ mạnh mẽ và mức giá được xây dựng cho các vòng lặp dài, lặp đi lặp lại mà thường tốn kém trên các mô hình tiên tiến tính phí theo token. Khi các trọng số được phát hành, nó là một trong ba mô hình duy nhất bạn có thể tự lưu trữ.
Điểm mạnh và hạn chế thực tế
K3 giỏi về điều gì
Ngữ cảnh quy mô kho lưu trữ. Cửa sổ 1M token cho phép tác nhân giữ một cơ sở mã lớn trong tầm nhìn cùng một lúc, giảm thiểu vấn đề “tôi nên cung cấp tệp nào cho nó” gây khó khăn cho các mô hình ngữ cảnh nhỏ hơn trong công việc monorepo.
Sử dụng công cụ và tự chủ dài hạn. K3 được điều chỉnh để duy trì các phiên kỹ thuật kéo dài với sự can thiệp tối thiểu, điều phối các công cụ terminal và tự sửa lỗi dựa trên đầu ra thực tế. Đó là điều phân biệt việc đóng một phiếu công việc với việc chỉ đề xuất một đoạn mã.
Chi phí cho các vòng lặp nặng bộ nhớ đệm. Lập trình tác nhân gửi lại cùng một ngữ cảnh (cấu trúc tệp, lời nhắc hệ thống, hướng dẫn) ở mỗi bước. Giá đầu vào truy cập bộ nhớ đệm của K3 là 0,30 đô la cho mỗi triệu token so với 3,00 đô la khi bỏ lỡ, một khoảng cách 10 lần, và Moonshot’s Mooncake inference được báo cáo đạt tỷ lệ truy cập bộ nhớ đệm trên 90% trong các tác vụ lập trình. Vì vậy, mô hình làm cho các vòng lặp tác nhân trở nên đắt đỏ ở nơi khác thì K3 lại giữ chi phí thấp. Số liệu đầy đủ có trong phân tích giá Kimi K3.
Những hạn chế của K3
Nó không phải là tiên phong, và Moonshot cũng thừa nhận. Bài đăng ra mắt nêu rõ rằng K3 “vẫn còn kém các mô hình độc quyền mạnh nhất, Claude Fable 5 và GPT-5.6 Sol.” Trên các điểm chuẩn lập trình mà Moonshot công bố, kết quả gần nhau nhưng nhất quán: trên Terminal Bench 2.1, K3 đạt 88.3 so với 88.8 của GPT-5.6 Sol, và trên DeepSWE nó đạt 67.5 so với 70.0 của Fable 5 và 73.0 của GPT-5.6 Sol. Cạnh tranh, nhưng không phải số một. Xem phân tích điểm chuẩn Kimi K3 để có cái nhìn đầy đủ.
Nó không nhanh. Trên danh sách Artificial Analysis, K3 xuất ra khoảng 62 token mỗi giây, dưới mức trung bình cho phân khúc giá của nó, và cài đặt mặc định của nó nghiêng về nỗ lực suy nghĩ tối đa. Trong một vòng lặp tương tác nơi bạn xem luồng đầu ra, điều đó rất dễ nhận thấy. Nếu tốc độ quan trọng hơn vài điểm chất lượng cuối cùng, hãy thử nghiệm một mô hình nhanh hơn trước.
“Mở” là một sự kiện theo lịch trình. Trọng số đầy đủ dự kiến vào khoảng ngày 27 tháng 7 năm 2026, không phải vào ngày ra mắt. Nếu kế hoạch của bạn phụ thuộc vào việc tự lưu trữ, đó là một ngày cần theo dõi hơn là một công tắc bạn có thể bật ngay bây giờ.
Để so sánh trực tiếp, hãy xem Kimi K3 so với Claude Opus 4.8, Kimi K3 so với GPT-5.6 Sol, và Kimi K3 so với Kimi K2.7 Code, trong đó đề cập đến sự nâng cấp từ nhà vô địch lập trình trước đó trong dòng sản phẩm.
Các trường hợp sử dụng thực tế
K3 tỏa sáng trong các công việc mà quy trình làm việc trên được xây dựng để phục vụ: tái cấu trúc lớn trên một monorepo, nơi ngữ cảnh 1M hiển thị toàn bộ phạm vi ảnh hưởng cùng một lúc để nó có thể xử lý các chỉnh sửa cho đến khi bản dựng thành công; các phiên gỡ lỗi kéo dài, nơi nó tái tạo lỗi, đọc dấu vết ngăn xếp, vá lỗi và chạy lại mà không cần bạn giám sát; và xây dựng một API, nơi nó tạo ra khung cho handler, route, và thường là các bài kiểm thử, sau đó chuyển giao cho một công cụ API chuyên dụng để xác minh.
Xác minh các API mà K3 xây dựng
Khi K3 xây dựng hoặc sửa đổi một API bên trong Kimi Code, các bài kiểm thử của nó sẽ cho bạn biết mã có chạy hay không. Tuy nhiên, chúng không cho bạn biết liệu điểm cuối có hoạt động đúng như một client thực mong đợi: mã trạng thái chính xác, cấu trúc phản hồi đúng, xử lý lỗi hợp lý, xác thực từ chối token không hợp lệ. Đó là công việc kiểm thử API.
Đây là lúc Apidog phát huy tác dụng. Gửi các yêu cầu thực tế đến điểm cuối đã tạo, kiểm tra phần thân và tiêu đề phản hồi, và thêm các xác nhận về mã trạng thái và cấu trúc JSON. Nếu tác nhân tạo ra một spec OpenAPI, hãy nhập nó và Apidog sẽ xây dựng bộ sưu tập yêu cầu cho bạn, để bạn xác thực theo hợp đồng thay vì đoán. Giữ các khóa của bạn trong các biến môi trường của Apidog để chúng không bao giờ bị rò rỉ vào một bộ sưu tập được chia sẻ.
Vì Apidog cung cấp giao diện MCP, bạn cũng có thể kết nối công cụ API của mình trực tiếp vào ngữ cảnh của tác nhân; hướng dẫn của chúng tôi về gỡ lỗi trực quan bằng client MCP của Apidog cho thấy cách thực hiện, và Apidog trong VS Code giữ vòng lặp kiểm thử bên cạnh mã mà K3 viết. Tải Apidog để xác minh đầu ra của mô hình ngay khi nó được tạo ra, thay vì chỉ tin tưởng vào một lần chạy kiểm thử thành công.
Bạn sẽ nhận được gì
Kimi K3 là một tác nhân lập trình thực sự có khả năng trong Kimi Code khi bạn tập trung vào những gì nó được xây dựng để làm: các kho lưu trữ lớn, các vòng lặp tự động dài và lặp lại liên tục dựa trên các bài kiểm thử, nhật ký và ảnh chụp màn hình. Ngữ cảnh 1M và giá cả dựa trên lượt truy cập bộ nhớ đệm giúp nó trở nên thực tế cho chính xác các công việc khó nhằn, nhiều bước mà ở nơi khác sẽ nhanh chóng trở nên đắt đỏ. Nó không phải là công cụ lập trình tốt nhất hiện có, và Moonshot xứng đáng được ghi nhận vì đã thừa nhận điều đó, nhưng đối với nhiều công việc thực tế, khoảng cách là nhỏ và lợi thế về chi phí và tính mở là có thật. Bắt đầu với một nhiệm vụ cụ thể, có thể kiểm thử, để K3 lặp lại, và xác minh các API mà nó tạo ra bằng Apidog trước khi bạn triển khai. Để biết thông tin nền về mô hình, phần Kimi K3 là gì và hướng dẫn API Kimi K3 sẽ tiếp tục từ đó.
Các câu hỏi thường gặp
Làm cách nào để sử dụng Kimi K3 để lập trình? Chạy nó bên trong Kimi Code, tác nhân lập trình terminal và IDE của Moonshot. Cài đặt tác nhân, mở nó trong thư mục dự án của bạn, chọn mô hình bằng /model kimi-k3, sau đó giao cho nó một nhiệm vụ cụ thể, có thể kiểm thử và để nó đọc tệp, chạy công cụ và lặp lại. Hướng dẫn cài đặt đầy đủ có trong hướng dẫn CLI của Kimi Code của chúng tôi.
Kimi K3 có tốt cho lập trình tác nhân không? Có. Nó được điều chỉnh chính xác cho những gì lập trình tác nhân cần: điều hướng các kho lưu trữ lớn, sử dụng công cụ, gỡ lỗi và lặp lại dựa trên các bài kiểm thử, nhật ký và phản hồi thời gian chạy trên ngữ cảnh 1M token. Nó cạnh tranh trên các điểm chuẩn lập trình, mặc dù có hơi kém Fable 5 và GPT-5.6 Sol một chút.
Kimi K3 có hỗ trợ gọi công cụ cho các quy trình làm việc tác nhân không? Có. K3 API hỗ trợ gọi công cụ, các ràng buộc lựa chọn công cụ, chế độ JSON, đầu ra có cấu trúc, tìm kiếm internet, tải công cụ động và nỗ lực suy luận có thể cấu hình, đây là những gì cho phép nó chạy các bài kiểm thử, thực thi các lệnh shell và điều phối một vòng lặp tác nhân hoàn chỉnh bên trong Kimi Code. Hướng dẫn API Kimi K3 bao gồm các chi tiết dành cho nhà phát triển.
Tôi có thể kiểm thử các API mà Kimi K3 viết không? Có, và bạn nên làm như vậy. Các bài kiểm thử của chính tác nhân xác nhận mã có chạy, nhưng không xác nhận rằng điểm cuối trả về mã trạng thái, cấu trúc phản hồi và hành vi xác thực đúng như một client thực mong đợi. Gửi các yêu cầu thực tế đến các điểm cuối đã tạo trong Apidog, thêm các xác nhận và nhập bất kỳ spec OpenAPI nào mà tác nhân tạo ra để xác thực theo hợp đồng.