VividKit Crystal clear AI coding
EN
Chọn Thiết Lập Bắt Đầu với AgentKit Tiếp Tục với ClaudeKit Chuyển từ ClaudeKit sang AgentKit Gỡ hẳn ClaudeKit AgentKit Là Gì? AgentKit Hoạt Động Như Thế Nào? Kit, Skill, Agent & Hook AgentKit Hỗ Trợ Runtime AgentKit Ứng Dụng AgentKit Desktop Cấu Hình AgentKit Tra Cứu CLI ak Cheatsheet skill AgentKit Workflows AgentKit Statusline AgentKit Cập Nhật CLI ak & Kits AgentKit Helper Cài lại clean AgentKit Xử Lý Sự Cố AgentKit Giới Thiệu ClaudeKit Hướng Dẫn ClaudeKit CLI Tìm Lệnh Phù Hợp Bảng Lệnh Nhanh Quy Trình Mẫu Tham Chiếu CLI Claude Mechanics Permission Modes ClaudeKit Hooks Coexistence ClaudeKit x Codex CK → Tool coding khác Cách ClaudeKit Hoạt Động Inside ClaudeKit Tìm Unknowns Của Bạn Khôi Phục Session Sửa Lỗi Từ Log Thiết Kế UI/UX Chuyển Đổi Tài Khoản Cấu Hình IDE Remote Control Codex App Sơ đồ hệ thống UI Review Gate Khuyến Mãi Ủng Hộ VividKit
AgentKit · Onboarding Khuyến nghị

Cài Đặt AgentKit

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

Tổng quan

Năm bước

  1. 1

    Cài CLI ak

    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

    Cấu hình lần đầu

    ak setup ghi preference (adapter, kit mặc định, telemetry). Không đăng nhập, không cài Kit.

  4. 4

    Đăng nhập & cài Kit

    ak login (API key khuyến nghị; hoặc email + OTP), rồi cài Kit cho runtime.

  5. 5

    Gọi Skill trong runtime

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

Trên CLI ak, ak onboard chỉ chạy bước còn thiếu (setup, login, cài Kit). --yes chỉ đồng ý prompt — không ghi đè file hay takeover.

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
› Kênh beta

Cài CLI ak bản beta (opt-in).

beta 
curl -fsSL https://agentkit.best/install.sh | AK_CHANNEL=beta 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.

› Fallback nếu host chính lỗi
releases host 
irm https://releases.agentkit.best/install.ps1 | iex
› Ghim phiên bản hoặc thư mục cài

Để trống trừ khi cần kiểm soát. Thay x.y.z bằng phiên bản semantic. AK_INSTALL_DIR đổi thư mục đích. Giá trị phải trong dấu nháy — đừng dùng < > (shell hiểu là chuyển hướng).

shell 
curl -fsSL https://agentkit.best/install.sh | AK_VERSION='x.y.z' sh
# Đổi thư mục cài (tùy chọn)
# curl -fsSL https://agentkit.best/install.sh | AK_INSTALL_DIR="$HOME/bin" sh

02

Xác nhận

shell 
ak --version
ak doctor --json

Chạy ak --version để xem CLI trên máy. Stable và beta là hai kênh riêng — trang này không gắn số phiên bản.

Nâng CLI đã cài

shell 
ak self-update --channel stable --yes
ak self-update --beta --yes

Đang dùng ClaudeKit? Xem trước chuyển sang AgentKit: ak migrate --from=ck .

03

Cấu hình lần đầu (ak setup)

Ghi preference AgentKit. Không đăng nhập registry và không cài nội dung Kit.

shell 
ak setup

Wizard phát hiện runtime đã login, cho chọn adapter, rồi cập nhật ~/.agentkit/config.yaml (kit mặc định, telemetry). Chạy lại được — không copy credential runtime.

04

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

Trước khi cài Kit remote có license, đăng nhập registry. Khuyến nghị: API key (dùng thường ngày và CI). Email + OTP khi bạn đang ở terminal tương tác.

API key (khuyến nghị)

Khuyến nghị

Tạo user API key trên Account Dashboard, rồi chạy local với key thật. Phù hợp dùng thường ngày và môi trường không tương tác. AgentKit lưu key và session CLI trong file hạn quyền dưới ~/.agentkit/auth.

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

Email + OTP

Gửi mã một lần tới email. CLI hỏi Enter OTP code. OTP không lưu trên đĩa; session CLI giữ credential refresh.

shell 
ak login --email you@example.com
ak whoami

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).

05

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%.

Mua Desktop (giảm 30%) → Hướng dẫn Desktop App

Tiếp theo