AgentKit · Onboarding Khuyến nghị

Cài Đặt AgentKit

Từ zero đến Skill đầu tiên với AgentKit: cài CLI ak, verify, đăng nhập, cài Kit, gọi trong runtime.

Tổng quan

Bốn bước

  1. 1

    Cài ak CLI

    Installer đã ký — macOS/Linux hoặc Windows PowerShell.

  2. 2

    Xác nhận

    ak --version và ak doctor để chắc cài đặt sạch.

  3. 3

    Đăng nhập & cài Kit

    ak login (email + OTP, API key, hoặc license key), rồi cài Kit cho runtime.

  4. 4

    Gọi Skill trong runtime

    Cài Kit không chạy workflow — mở coding assistant.

01

Cài AgentKit CLI

Chọn platform của bạn, chạy một lệnh, rồi mở terminal mới.

Unix

macOS / Linux

install.sh
install.sh
curl -fsSL https://agentkit.best/install.sh | sh
Fallback nếu host chính lỗi

Dùng release host khi agentkit.best không truy cập được.

releases host
curl -fsSL https://releases.agentkit.best/install.sh | sh

Windows

PowerShell

install.ps1
install.ps1
irm https://agentkit.best/install.ps1 | iex

Chạy trong PowerShell (không phải CMD). Sau khi cài, mở cửa sổ terminal mới.

02

Xác nhận

shell
ak --version
ak doctor --json

03

Đăng nhập (ak login) rồi cài Kit

Trước khi cài Kit remote có license, đăng nhập registry bằng một trong các cách sau. Khuyến nghị cho hầu hết người dùng: email + OTP.

Email + OTP (khuyến nghị)

Phổ biến

Gửi mã một lần (OTP) tới email của bạn. CLI hỏi Enter OTP code — nhập mã từ hộp thư. Mã OTP không được lưu trên máy; session CLI lưu credential refresh (không phải mã OTP).

shell
ak login --email you@example.com
# Prompt: Enter OTP code:
ak whoami

API key (script / CI)

Key từ web profile. Phù hợp môi trường không tương tác. Key được lưu trong session private.

shell
ak login --api-key ak_live_... --no-interactive

License key (App / device)

Kích hoạt thiết bị cho App session (khác slot CLI email/API). Chủ yếu dùng cho Desktop — không tự cấp Kit Engineer / Marketing.

shell
ak login --license-key ak_license_... --no-interactive

Sau khi đăng nhập: cài Kit

Cài Kit cho runtime bạn dùng. Project scope là mặc định; thêm --global khi cần phạm vi user. Cài Kit không chạy workflow — restart coding assistant hoặc mở session mới, rồi gọi Skill (ví dụ /ak:plan hoặc $ak:plan).

04

Tuỳ chọn: Desktop App (mua thêm)

Desktop không bắt buộc để dùng Kits. Chỉ mua nếu muốn UI quản lý local — license App tách với Kit. Referral VividKit: giảm 30%.

Tiếp theo