Bài 9/20 trong bộ onboarding AgentKit v3. Đọc khoảng 8 phút.
Nói trước cho rõ: tài liệu chính thức của AgentKit hiện chưa có trang riêng cho cloud/CI. Bài này là cách tui và team đang làm, ghép từ những cờ và hành vi có thật trong ak 3.0.0. Phần nào là công thức của tui, tui ghi rõ.
Tin vui: chính AgentKit đang được vận hành bằng một Claude Routine chạy mỗi giờ, nên mấy thứ dưới đây không phải lý thuyết.
1/ Cách đơn giản nhất: commit kit vào repo ✅
Nếu bạn cài kit ở scope project (xem bài 4), toàn bộ skill, agent, hook nằm trong repo (ví dụ ./.claude cho Claude Code). Commit chúng lên git:
ak kit init engineer --yes
git add .claude .agentkit
git commit -m "feat: add AgentKit engineer kit"Vậy là xong cho đa số trường hợp cloud. Claude Code trên web, Claude Routine hay bất kỳ môi trường nào clone repo về đều thấy skill ngay, không cần cài ak, không cần đăng nhập.
Đây là cách tui khuyên đầu tiên, vì: không có secret nào phải đưa lên cloud, và cả team cùng một phiên bản skill.
2/ Khi cần chạy ak trên máy cloud ✅
Trường hợp bạn cần ak thật trên cloud (cài kit lúc chạy, dùng ak secrets, chạy ak doctor...):
Cài
curl -fsSL https://agentkit.best/install.sh | shĐăng nhập không cần người
Dùng API key (tạo ở trang tài khoản /account/api-keys trên agentkit.best). Hai cách an toàn, cả hai đều giữ key ra khỏi danh sách tham số tiến trình:
printf '%s' "$AK_KEY" | ak login --api-key-stdinhoặc:
export AGENTKIT_API_KEY="..." # lấy từ secret của môi trường, đừng hardcode
ak loginCó cờ --api-key nhưng nó hiện key trong process list, ak sẽ in cảnh báo. Đừng dùng trên máy dùng chung.
Đừng nhầm: license key (ak_license_...) chỉ để kích hoạt app desktop, không đăng nhập CLI được.Cài kit không hỏi han
ak kit init engineer --target claude-code --yes --no-interactiveMọi lệnh ak đều có --no-interactive và --json. Có --json thì tự ngầm hiểu là không tương tác.
Auto-update tự tắt trong CI ✅
Khi có biến môi trường CI (GitHub Actions, GitLab CI... đều tự đặt), auto-update của ak không chạy. Muốn chắc chắn ở môi trường khác, đặt thêm:
export AK_NO_AUTO_UPDATE=1Ghim phiên bản kit để mỗi lần build giống nhau:
ak kit init engineer --version <phien-ban-kit> --yes --no-interactiveXem phiên bản kit đang dùng trên máy bạn bằng ak versions, rồi ghim đúng số đó.
3/ Ví dụ GitHub Actions (công thức của tui)
name: agentkit-check
on: [pull_request]
jobs:
doctor:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Cài ak
run: curl -fsSL https://agentkit.best/install.sh | sh
- name: Đăng nhập bằng API key
env:
AGENTKIT_API_KEY: ${{ secrets.AGENTKIT_API_KEY }}
run: ak login --no-interactive
- name: Kiểm tra môi trường
run: ak doctor --jsonGhi chú:
AGENTKIT_API_KEYđể trong GitHub Secrets, không bao giờ trong file workflow.Nếu bước cài đặt báo
akkhông có trên PATH, thêm thư mục cài (thường là~/.local/bin) vào$GITHUB_PATH.Dựa vào exit code thay vì đọc chữ: ví dụ
15là cần gia hạn,4là đang có thao tác khác giữ khoá.
4/ Claude Routine: agent chạy theo lịch trên cloud
Claude Routine là agent của Claude Code chạy theo lịch trong môi trường cloud của Anthropic. Ví dụ thật: repo AgentKit có một routine chạy mỗi giờ gom các pull request đã sẵn sàng, rebase, chạy tools/preflight.sh trên máy cloud, rồi đưa cả lô vào nhánh dev. Nó chạy trong môi trường cloud của Claude, không phải trong GitHub Actions.