✍️ Cline CLI là gì? Dùng để làm gì trong khóa học?

Cline CLI là phiên bản chạy trong Terminal (PowerShell, CMD, bash) của agent AI Cline — cùng “bộ não” với extension trên VS Code / Cursor, nhưng phù hợp khi bạn muốn:

• Chạy agent không mở IDE (VPS, server, máy cấu hình thấp)
• Tự động hóa tác vụ lặp: sửa script deploy, test webhook, refactor Python
• Quản lý nhiều agent song song qua Kanban board (cline --kanban)
• Gắn vào CI/CD hoặc cron (cline schedule, headless mode)

Trong khóa IB Bot Auto Trading, Cline CLI hỗ trợ các việc kỹ thuật như: chỉnh file workflow n8n, script deploy_pr_*, EA MT5, form HTML — không thay thế quy trình IB (Myfxbook, Telegram signal, check ID), mà là công cụ dev giúp triển khai nhanh hơn.

📋 Yêu cầu hệ thống

Theo trang Cline CLI:

Gói npm tự tải binary native đúng nền tảng (arm64/x64) — không cần cài thêm runtime Zig/Bun.

🔧 Bước 1 — Cài Node.js 22 trên Windows

Cách 1: Installer chính thức (khuyến nghị học viên mới)

1. Vào https://nodejs.org/ → tải bản LTS 22.x (Windows Installer .msi)
2. Chạy installer → tick “Add to PATH”
3. Mở PowerShell mới (quan trọng — PATH chỉ cập nhật sau khi mở cửa sổ mới)

Kiểm tra:

node --version
npm --version

Kết quả mong đợi: v22.x.x và 10.x.x (npm đi kèm Node).

Cách 2: nvm-windows (nếu cần nhiều phiên bản Node)

nvm install 22
nvm use 22
node --version

📦 Bước 2 — Cài Cline CLI globally

Mở PowerShell (Run as Administrator nếu npm báo lỗi quyền ghi global):

npm install -g cline

Hoặc rút gọn (cùng lệnh trên trang chính thức):

npm i -g cline

Bản nightly (thử tính năng mới — không khuyến nghị production):

npm install -g cline@nightly

Kiểm tra cài đặt:

cline --version

Nếu lệnh cline không nhận: đóng/mở lại terminal, hoặc thêm %AppData%npm vào PATH.

🔐 Bước 3 — Xác thực provider (cline auth)

Cline cần model AI để chạy agent. Cấu hình một lần:

cline auth

Menu tương tác sẽ hiện các lựa chọn (theo npm package cline):

Cấu hình nhanh bằng API key (không cần menu)

Ví dụ Anthropic:

cline auth --provider anthropic --apikey sk-ant-... --modelid claude-sonnet-4-6

Ví dụ OpenAI-compatible endpoint:

cline auth --provider openai-native --apikey sk-... --modelid gpt-5 --baseurl https://api.example.com/v1

Biến môi trường (tùy chọn, thay cho lưu keychain):

$env:ANTHROPIC_API_KEY = "sk-ant-..."
# hoặc OPENAI_API_KEY, tùy provider

Key được lưu an toàn trong system keychain khi dùng cline auth (theo FAQ trên cline.bot/cli).

▶️ Bước 4 — Chạy Cline lần đầu

Chế độ chat tương tác

cline

Gõ yêu cầu bằng tiếng Việt hoặc Anh, ví dụ:

Đọc file test_form_webhook.py và thêm case test ID rỗng.

One-shot — một lệnh, một task

cline "Liệt kê các file .py trong thư mục ib-bot-tools"

Plan mode — lập kế hoạch trước khi sửa code

cline --plan "Thiết kế cách thêm slug vào payload deploy_pr_bai6_5sites.py"

Zen mode — chạy nền, trả terminal

cline -z "Refactor hàm publish trong fix_pr_slugs_fast.py"

📊 Bước 5 (tùy chọn) — Kanban: nhiều agent song song

Cline có bảng Kanban để orchestrate nhiều agent — mỗi thẻ một git worktree riêng, tránh conflict:

cline --kanban

Trình duyệt mở tại: http://localhost:3484

Tính năng chính (cline.bot/cli):

• Git worktree riêng mỗi task
• Dependency chains — thẻ B tự chạy khi thẻ A xong
• Review diff như PR — comment inline, agent sửa tiếp
• Tích hợp Linear MCP (nếu team dùng Linear)

Phù hợp khi bạn chia backlog BL-09b / BL-10b thành nhiều thẻ nhỏ chạy song song.

🛠️ Lệnh hữu ích sau khi cài

Theo CLI Overview:

Cập nhật phiên bản:

npm update -g cline

⚠️ Xử lý lỗi thường gặp (Windows)

1. cline không phải lệnh nội bộ

• Cài lại Node → tick Add to PATH
• Hoặc thêm %AppData%npm vào Environment Variables → Path
• Mở terminal mới

2. Lỗi quyền khi npm install -g

Chạy PowerShell Administrator, hoặc đổi prefix npm:

npm config set prefix "$env:USERPROFILE.npm-global"

Thêm %USERPROFILE%.npm-global vào PATH.

3. Lỗi database / better-sqlite3

Một số máy báo lỗi native module sau cài global:

npm rebuild -g better-sqlite3

Chạy lại cline doctor.

4. Session / OAuth hết hạn

cline auth

Đăng nhập lại provider.

5. Agent không có quyền ghi file

Chạy terminal trong đúng thư mục project (ví dụ folder khóa học hoặc D:Website Docusaurus...), không chạy từ C:WindowsSystem32.

🔗 So sánh nhanh: Cline CLI vs Cursor IDE

Khóa học khuyến nghị: Cursor cho biên soạn học liệu; Cline CLI cho deploy script, test webhook trên VPS, hoặc Kanban khi làm nhiều task Phase 5.

✅ Checklist hoàn tất cài đặt

• [ ] node --version ≥ v22
• [ ] npm i -g cline thành công
• [ ] cline --version in ra số phiên bản
• [ ] cline auth — đã chọn provider / API key
• [ ] cline "echo hello" hoặc cline — agent phản hồi được
• [ ] (Tùy chọn) cline --kanban — board mở tại localhost:3484
• [ ] (Tùy chọn) cline doctor — không báo lỗi nghiêm trọng

📥 Hỗ trợ học viên

• Landing khóa học: https://huongnghiepdulieu.com/xay-dung-ib-bang-bot-auto-trading/
• Zalo tư vấn kỹ thuật: 039.791.9841
• Tài liệu Cline chính thức: cline.bot/cli · docs.cline.bot

Lưu ý bảo mật: Không commit API key vào Git. Không chia sẻ key trong nhóm chat công khai — dùng cline auth hoặc biến môi trường cục bộ.