Đưa Kimi K3.1 Pro vào Kimi Code CLI: Cài đặt, Đăng nhập và Cái bẫy Windows

Kimi Code CLI là tác nhân lập trình trên terminal của Moonshot, và đây là client duy nhất mà ở đó Kimi K3.1 Pro không phải là tích hợp của bên thứ ba mà là mặc định. Việc thiết lập ngắn gọn hơn so với các tuyến Claude Code hoặc Codex — một script cài đặt, một /login, một lựa chọn nền tảng — vì client và mô hình đến từ cùng một công ty. Điều đáng lưu ý là đặc thù theo nền tảng: trên Windows, CLI chạy bên trong Git Bash mà nó đi kèm, và nếu shell đó không nằm ở nơi trình cài đặt mong đợi, công cụ sẽ khởi động rồi sau đó thất bại theo những cách trông giống như lỗi mô hình.

Đây là trình tự hiệu quả, đã được đối chiếu với tài liệu của Moonshot vào ngày 24 tháng 10 năm 2026, đồng thời chỉ rõ các kiểu lỗi ngay tại nơi chúng thực sự xảy ra.

Cài đặt

macOS và Linux chỉ cần một dòng: curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash. Windows PowerShell cũng chỉ cần một dòng: irm https://code.kimi.com/kimi-code/install.ps1 | iex. Tập lệnh tải bản phát hành mới nhất, xác minh checksum của bản phát hành và đặt tệp thực thi kimi vào PATH của bạn. Không cần runtime Node.js hay Python.

Windows có một điều kiện tiên quyết dễ bị bỏ qua: hãy cài Git for Windows trước. Kimi Code CLI sử dụng Git Bash đi kèm làm môi trường shell của nó. Nếu Git Bash nằm ở một vị trí không chuẩn, hãy đặt KIMI_SHELL_PATH — biến môi trường này — thành đường dẫn tuyệt đối của bash.exe trước khi khởi chạy — nếu không, tác nhân sẽ khởi động nhưng mọi lệnh shell mà nó cố gắng chạy đều thất bại.

Đăng nhập bằng khóa API

Khởi động CLI bên trong thư mục dự án mà bạn muốn làm việc:

• Chạy kimi để mở giao diện tương tác.

• Nhập /login. Kimi Code CLI mở bộ chọn nền tảng.

• Chọn Kimi Platform (khóa API · platform.kimi.ai). Đây là tùy chọn dành cho khóa được tạo trên nền tảng mở; các tùy chọn còn lại tương ứng với các bề mặt tài khoản khác nhau.

• Dán khóa. Tạo một khóa tại platform.kimi.ai trong mục API Keys nếu bạn chưa có. CLI lưu khóa cục bộ, vì vậy hãy coi thư mục cấu hình như một kho lưu trữ thông tin xác thực.

Đó là toàn bộ kết nối. Bộ chọn mô hình trong CLI liệt kê các mô hình Kimi hiện tại, và Kimi K3.1 Pro cùng biến thể tốc độ cao của nó là hai mô hình quan trọng cho công việc agentic.

Chuyển đổi một thiết lập hiện có và thay thế một khóa

Hai kiểu chuyển đổi là phổ biến và cả hai đều đi qua cùng một màn hình. Nếu Kimi Code CLI đã đăng nhập bằng gói đăng ký thay vì khóa API, việc chạy /login lần nữa và chọn nền tảng khóa API sẽ chuyển đổi mà không cần cài lại. Nếu bạn đang xoay vòng khóa — vì khóa bị lộ, hoặc vì một dự án cần thanh toán riêng — cùng luồng đó sẽ thay thế thông tin xác thực đã lưu.

Điều duy nhất không nên làm là chỉnh sửa thủ công tệp cấu hình đã lưu khi CLI đang chạy; tiến trình đọc thông tin xác thực lúc khởi động và mọi chỉnh sửa giữa phiên sẽ bị ghi đè khi thoát.

Điều mà agent thực sự làm

Kimi Code CLI không phải là cửa sổ chat trong terminal. Nó đọc và chỉnh sửa mã, tìm kiếm trong kho mã nguồn, chạy lệnh và đọc kết quả, đồng thời có thể lấy nội dung web hoặc tìm kiếm khi một tác vụ cần thứ gì đó nằm ngoài dự án. Moonshot mô tả nó là một agent lập trình chạy trên máy của chính bạn với mô hình đảm nhận việc lập kế hoạch — cùng hình thái với Claude Code hay Codex, với cùng những hàm ý về quyền: một agent có thể chạy lệnh shell nên được khởi chạy trong thư mục mà bạn sẵn sàng để nó sửa đổi, và được xem xét trước khi bất cứ thứ gì được đẩy lên.

Hai mô hình tính phí cùng tồn tại trong client này. Ứng dụng Kimi Code được bán dưới dạng thuê bao với các gói dịch vụ, và CLI có thể dùng thuê bao đó hoặc khóa API từ nền tảng mở. Cách dùng khóa API là cách mang lại cho bạn cách tính chi phí theo token — $2.00 và $10.00 mỗi triệu token đối với K3.1 Pro, $4.00 và $20.00 đối với biến thể tốc độ cao — trong khi thuê bao là mức phí cố định kèm hạn mức. Đối với một nhóm đã trả tiền cho việc sử dụng API ở nơi khác, cách dùng khóa API giúp giữ chi phí ở một nơi; đối với một cá nhân lập trình cả ngày, thuê bao thường rẻ hơn và dù chọn cách nào thì CLI vẫn là cùng một bản tải xuống.

Chọn mô hình và mức độ nỗ lực

Kimi K3.1 Pro luôn suy luận, và effort được đặt bằng một trường cấp cao nhất chấp nhận low, high và max, mặc định là max. Kimi Code CLI cung cấp mô hình này; mặc định effort là mức đắt đỏ, nên một phiên có cảm giác chậm thường là phiên đang chạy ở mức max chứ không phải kết nối bị hỏng. Biến thể tốc độ cao đánh đổi độ trễ để lấy mức giá cao hơn — $4.00 và $20.00 mỗi triệu token thay vì $2.00 và $10.00 — và là mặc định hợp lý cho công việc tương tác, nơi mô hình dù sao cũng đang chờ con người.

Hai ràng buộc đi kèm mô hình vào mọi ứng dụng khách: các tham số lấy mẫu là cố định (temperature 1.0, top-p 0.95, n bằng 1), và việc thay đổi mức nỗ lực giữa cuộc trò chuyện sẽ làm vô hiệu hóa các lần trúng bộ nhớ đệm tiền tố. Hãy quyết định mức này ngay từ đầu phiên.

Tuyến này so với Claude Code và Codex như thế nào?

Ba ứng dụng khách sử dụng ba giao thức khác nhau để truy cập cùng một mô hình, và việc lựa chọn chủ yếu phụ thuộc vào giao diện mà đội ngũ của bạn đã quen dùng. Kimi Code CLI có ít cấu hình nhất: không có khối biến môi trường, không có tệp TOML, và nhà cung cấp duy trì cả hai đầu. Claude Code cần điểm cuối tương thích Anthropic và bốn biến bậc mô hình được đặt đúng, còn Codex cần một khối nhà cung cấp với wire_api = "responses", nhưng sau đó cả hai đều hoạt động với bất kỳ nhà cung cấp nào hỗ trợ các giao thức đó — kể cả một cổng cũng phục vụ mô hình của các nhà cung cấp khác.

Cách phân chia thực tế: dùng Kimi Code CLI khi Kimi là mô hình duy nhất bạn cần và bạn muốn con đường ngắn nhất; dùng Claude Code hoặc Codex khi cùng một phiên làm việc phải chuyển đổi giữa các nhà cung cấp, hoặc khi công cụ, quyền hạn và kỹ năng của nhóm bạn vốn đã nằm trong những client đó.

Một trình tự xử lý sự cố giúp tiết kiệm thời gian

• CLI khởi động nhưng không có lệnh shell nào chạy — hãy kiểm tra Git Bash và KIMI_SHELL_PATH trước, trước khi đổ lỗi cho mô hình.

• Lỗi xác thực sau khi thiết lập đã hoạt động — hãy chạy lại /login và xác nhận tùy chọn nền tảng khớp với nơi tạo khóa; khóa từ các giao diện khác nhau không thể hoán đổi cho nhau.

• Các phiên làm việc có cảm giác chậm — hãy kiểm tra mức effort mặc định trước khi đổi mô hình; max tốn kém cả về độ trễ lẫn token.

• Không tìm thấy mô hình sau khi cập nhật — CLI liệt kê những gì nền tảng cung cấp; nếu thiếu K3.1 Pro, điều đó có nghĩa là ứng dụng khách đang trỏ tới một bề mặt chưa được cập nhật.

Kimi K3.1 Pro trên nền tảng có giá 2,00 USD cho mỗi triệu token đầu vào và 10,00 USD cho mỗi triệu token đầu ra, với ngữ cảnh 1 triệu token và tối đa 943.718 token đầu ra. Nếu bạn muốn truy cập mô hình này qua API mà các công cụ khác của bạn đang dùng, OrcaRouter cung cấp cùng mô hình dưới tên kimi/kimi-k3.1-pro theo giá niêm yết của nhà cung cấp, không cộng thêm phí — cấu hình cho tuyến này được trình bày trong hướng dẫn Claude Code và Codex.