Cài đặt Workflow GitHub Models Tips Telegram
MacBook Pro M1 · macOS Tahoe · Tháng 3/2026

Setup Claude Code +
Antigravity + Gemini CLI

Hướng dẫn đầy đủ từ thực tế triển khai — tối ưu hóa quy trình coding cho developer Việt Nam trên nền tảng Apple Silicon.

2.1.81 Claude Code Version
0.34.0 Gemini CLI Version
1,000 req/ngày Free Tier Quota
zsh — 80x24

Bộ công cụ AI 2026

Sự kết hợp hoàn hảo giữa 3 "ông lớn" trong một quy trình duy nhất.

GOOGLE / IDE

Antigravity

IDE agent-first thế hệ mới. Chuyên dùng để lên kế hoạch kiến trúc, review code và quản lý file trực quan.

Gemini 3.1 Pro · Miễn phí
ANTHROPIC / CLI

Claude Code

Mạnh mẽ nhất trong việc thực thi. Claude trực tiếp viết code, sửa bug và chạy test ngay trong terminal.

Sonnet 4.6 · Pro $20/tháng
OSS / BACKUP

Gemini CLI

Lớp bảo mật và dự phòng. Sử dụng khi hết quota Claude hoặc cần xử lý batch nhiều repo cùng lúc miễn phí.

1,000 req/ngày · Free

Hướng dẫn cài đặt

Thực hiện theo trình tự để đảm bảo mọi công cụ hoạt động trơn tru.

1
Cài đặt Antigravity IDE

Antigravity là IDE chính chủ từ Google, hỗ trợ sâu cho Gemini và MCP. Khuyên dùng Homebrew để dễ dàng cập nhật.

brew install --cask antigravity
2
Cài đặt Claude Code CLI

Native installer của Anthropic giúp cài đặt mà không cần quản lý version Node.js thủ công.

curl -fsSL https://claude.ai/install.sh | bash
3
Cài đặt Gemini CLI (Fix NPM)

Đảm bảo NPM của bạn có quyền ghi vào global folder để cài Gemini CLI mà không cần dùng sudo.

mkdir -p ~/.npm-global && npm config set prefix '~/.npm-global' && npm install -g @google/gemini-cli
4
Cấu hình Alias cho Zsh

Thêm các shortcut để chuyển đổi nhanh model và công cụ trong quá trình làm việc.

echo "alias cc='claude'\nalias gm='gemini'\nalias cco='claude --model opus'" >> ~/.zshrc && source ~/.zshrc

Quy trình làm việc tối ưu 5 bước

Sự kết hợp hoàn hảo giữa các AI Agents để hoàn thành dự án nhanh nhất.

🔍
1. Antigravity
Sử dụng Gemini 3 Pro để phân tích yêu cầu và lên kế hoạch (plan) kiến trúc.
🎨
2. Nano Banana 2
Tạo ảnh & Mockup
Sinh placeholder, icon, và mockup giao diện trực tiếp trong Antigravity.
3. Claude Code
Yêu cầu Claude thực thi HTML/CSS/JS theo plan và mockup đã có.
📦
4. Git Commit
Sử dụng AI để viết commit message và tạo checkpoint an toàn.
🌐
5. Gemini CLI
Dùng lệnh @web để verify thông tin, search docs và kiểm tra lỗi.

Quản lý GitHub & Deploy

Quy trình đẩy code từ máy local lên repository và xử lý lỗi phát sinh.

💡

Bắt đầu từ tab “Lần đầu — setup” nếu chưa kết nối repo. Bắt đầu từ tab “Dùng UI Antigravity” nếu muốn cách đơn giản nhất.

Fix nhanh khi terminal Antigravity chưa nhận brew/gh

Có 3 lỗi thường đi cùng nhau: Chưa đăng nhập GitHub, Homebrew chưa có trong PATH, và chưa set upstream branch.

Bước 1 — Fix PATH cho Homebrew
eval "$(/opt/homebrew/bin/brew shellenv)"

Note fallback (vĩnh viễn): echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc && source ~/.zshrc

Bước 2 — Cài đặt & Đăng nhập GitHub CLI
brew install gh && gh auth login
Bước 3 — Set Upstream và Push
git push --set-upstream origin main
Lần đầu — setup
Push hàng ngày
Dùng UI Antigravity
Nhờ Claude Code push
Fix lỗi thường gặp
Deploy dự án

Dành cho người chưa kết nối repo GitHub. Thực hiện tuần tự các bước để khởi tạo.

1
Khởi tạo Git Local
git init && git add . && git commit -m "feat: initial commit"
2
Kết nối GitHub (Auth & Create)

Dùng GitHub CLI để tạo repo nhanh hoặc add remote thủ công.

gh auth login && gh repo create
git remote add origin https://github.com/USER/REPO.git
3
Push & Set Upstream lần đầu
git branch -M main && git push -u origin main

Quy trình đẩy code hàng ngày (4 bước chuẩn) và kiểm tra trạng thái.

git status && git add . && git commit -m "docs: update content" && git push

*Sau khi đã set upstream (-u), các lần sau bạn chỉ cần gõ git push.

Nhóm lệnh kiểm tra Remote & Branch

git remote -v && git branch && git branch -vv

Mẹo: Dùng Alias tiết kiệm thời gian

alias gpush='git add . && git commit -m "update" && git push'

Cách dễ nhất cho người không quen terminal, thao tác 100% bằng chuột trong Antigravity.

1
Mở Source Control

Click vào icon Source Control (hình nhánh cây) ở sidebar bên trái của Antigravity IDE.

2
Stage file

Ấn dấu (+) cạnh các file thay đổi để đưa vào trạng thái Stage (sẵn sàng commit).

3
Nhập Message & Push

Nhập nội dung thay đổi vào ô "Message", sau đó chọn “Commit & Push”.

Claude Code có thể tự thực hiện toàn bộ flow Git và hỏi xác nhận trước khi push. Cách nhanh nhất khi đang chat.

💬

Thêm câu: "commit và push lên GitHub" vào cuối bất kỳ prompt nào. Claude sẽ tự động viết message mô tả đúng những gì nó vừa sửa.

Ví dụ Prompt hoàn chỉnh:

"Sửa lại màu sắc nút CTA sang màu cam, sau đó commit và push lên GitHub giúp mình."

Claude sẽ thực hiện: `git status` → `git add` → `git commit` → `git push` một cách tự động.

Các lỗi hay gặp nhất khi làm việc với GitHub và lệnh fix nhanh.

1. Lỗi: remote origin already exists

Xảy ra khi dự án đã kết nối với một repo cũ. Hãy xóa đi để kết nối repo mới.

git remote remove origin && git remote add origin
2. Lỗi: rejected (fetch first)

Xảy ra khi code trên GitHub mới hơn máy local. Hãy pull và rebase về trước.

git pull origin main --rebase && git push
3. Lỗi: src refspec main does not match any

Thường do chưa có commit nào hoặc sai tên branch. Hãy commit trước khi push.

git add . && git commit -m "feat: initial commit" && git branch -M main && git push -u origin main
4. Lỗi: no upstream branch

Chưa thiết lập branch mặc định trên remote để push. Dùng --set-upstream.

git push --set-upstream origin main

Các lựa chọn đưa dự án của bạn lên internet hoàn toàn miễn phí.

Vercel / Netlify

Phù hợp nhất cho React, HTML tĩnh. Chỉ cần kết nối GitHub, mỗi khi bạn git push, web sẽ tự động cập nhật.

Setup Vercel ↗

GitHub Pages

Dành cho các trang HTML tĩnh đơn giản. Bật trong phần Settings > Pages của repository.

Nếu terminal báo: Everything up-to-date

Nghĩa là: Repo đã kết nối đúng, branch đã track đúng và hiện tại không có thay đổi nào mới để push.

Bảng tra cứu Alias

Các lệnh tắt khuyên dùng để tiết kiệm thời gian gõ phím.

Alias Cấu hình / Model Mục đích sử dụng Chi phí
cc Claude 3.5 Sonnet Code hàng ngày, nhanh, thông minh $20/tháng
cco Claude 3 Opus Giải quyết bài toán cực khó, refactor lớn $20/tháng
cch Claude 3 Haiku Giải thích code, viết test đơn giản $20/tháng
cck --keep-context Giữ session dài khi fix bug phức tạp Cao hơn
gm Gemini 3 Pro Batch processing, backup khi Claude hết limit Miễn phí

Tạo ảnh với Nano Banana 2

Nano Banana 2 là Gemini 3.1 Flash Image, model sinh ảnh AI của Google tích hợp sẵn trong Antigravity.

Nano Banana

Model: Gemini 2.5 Flash. Tốc độ cực nhanh cho các icon đơn giản.

Legacy

Nano Banana Pro

Model: Gemini 3 Pro. Chi tiết cao, phù hợp cho photorealistic mockup.

Stable

Nano Banana 2

Model: Gemini 3.1 Flash. Cân bằng hoàn hảo giữa tốc độ và chất lượng.

Recommended

Prompt mẫu cho Developer

1. Hero image cho landing page developer
Dark tech background, minimal design. MacBook Pro M1 floating in center with terminal window open showing code. Orange glow accent #E8673A. Background: deep dark #0D0D0D with subtle grid pattern. No text. Cinematic lighting, 16:9 ratio.
2. 3 tool icons: Antigravity / Claude Code / Gemini CLI
Set of 3 isometric app icons. 1: Blue futuristic spaceship (Antigravity). 2: Orange terminal cursor (Claude Code). 3: Green star sparkle (Gemini CLI). Clean glassmorphism style, matte finish, dark background, 3D render, high resolution.
3. Thumbnail YouTube tiếng Việt
YouTube thumbnail background. High contrast, neon colors. A Vietnamese developer working on a Mac M1, looking amazed at the screen. Floating glowing text placeholders. Depth of field, bokeh background of a modern workspace. 1280x720.

So sánh các công cụ

Chi tiết thông số và khả năng hỗ trợ của từng AI Agent.

Tính năng Antigravity Claude Code Gemini CLI Nano Banana 2 Kimi K2
Miễn phí - ✓ (Limited)
Code ✓✓ -
Sinh ảnh - - - ✓✓ -
Search Web - ✓ (@web) -
Context 1M 200k 1M - 128k

Câu hỏi thường gặp (FAQ)

Giải đáp thắc mắc phổ biến khi triển khai quy trình AI Agent.

?
Tôi có cần mua Claude Pro không?

Nếu bạn là developer chuyên nghiệp, Claude Pro ($20) rất xứng đáng vì Claude Code (Sonnet 3.5) hiện là công cụ implement tốt nhất. Tuy nhiên, bạn vẫn có thể dùng Gemini CLI và Antigravity hoàn toàn miễn phí cho hầu hết các tác vụ khác.

?
Nano Banana 2 thay thế Midjourney được không?

Với các task của developer như tạo mockup, icon, hero image đơn giản thì Nano Banana 2 làm rất tốt và nhanh. Với các tác phẩm nghệ thuật phức tạp hoặc cần retouch sâu, Midjourney vẫn nhỉnh hơn về độ chi tiết.

?
Gemini CLI vs Claude Code — dùng cái nào?

Dùng Claude Code khi bạn cần AI trực tiếp viết code và sửa file trong repo. Dùng Gemini CLI khi bạn cần search thông tin nhanh (@web), tóm tắt tài liệu lớn (nhờ context 1M) hoặc khi Claude hết quota.

?
Khi nào nên dùng /compact?

Trong Claude Code, hãy dùng /compact khi session chat đã quá dài (khoảng 30-40 lượt chat). Lệnh này giúp tóm tắt context, giải phóng token và giúp AI tập trung vào các yêu cầu mới chính xác hơn.

?
Làm sao biết còn bao nhiêu quota?

Với Claude, bạn có thể check trong settings của claude.ai. Với Gemini CLI, lệnh gm stats sẽ hiển thị số lượng request đã dùng trong ngày. Antigravity thường không giới hạn quota cho các model miễn phí.

?
Kimi K2 và OpenRouter khác nhau chỗ nào?

Kimi K2 là model riêng biệt nổi tiếng với context window lớn và khả năng xử lý file excel/pdf tốt. OpenRouter là một bridge API giúp bạn truy cập hàng trăm model khác nhau (bao gồm cả Kimi, Claude, GPT) thông qua một cổng thanh toán duy nhất.

Tips từ thực tế

Những mẹo nhỏ giúp bạn làm chủ bộ công cụ này nhanh hơn.

/compact thường xuyên

Dùng lệnh /compact trong Claude Code sau mỗi 30-40 turns để tóm tắt context, giúp tiết kiệm token và giảm lag.

File CLAUDE.md

Luôn giữ file CLAUDE.md ở root project. Đây là "bản đồ" để Claude hiểu architecture mà không cần đọc lại toàn bộ file.

Git thường xuyên

Hãy commit mỗi khi một tính năng nhỏ hoạt động. Điều này giúp bạn dễ dàng rollback nếu AI "đi quá xa" so với ý muốn.

Kết nối Telegram + Claude Code

Điều khiển Claude Code từ xa qua Telegram — quy trình đầy đủ từng bước.

📱

Hiểu đúng trước khi cài: Trong Antigravity có 2 nơi nhập lệnh khác nhau. Terminal dùng cho lệnh hệ thống như bun, claude, cd. Khung chat Claude Code dùng cho slash command như /plugin install, /telegram:configure. Slash command gõ trong Terminal sẽ báo lỗi zsh: no such file or directory.

1
Chuẩn bị môi trường — Cài Bun

Cần có: Telegram account, Claude Code đang chạy được, và Bun đã cài.

Cài Bun
curl -fsSL https://bun.sh/install | bash
Reload shell và kiểm tra
exec /bin/zsh && source ~/.zshrc && bun --help

Nếu bun --help hiển thị help text là Bun đã sẵn sàng.

2
Tạo bot Telegram bằng BotFather

Trong Telegram, tìm @BotFather và gửi lệnh tạo bot mới.

Lệnh tạo bot
/newbot

BotFather sẽ yêu cầu đặt Name (tên hiển thị) và Username (phải kết thúc bằng bot, phải là duy nhất). Ví dụ: tvt_claude_code_remote_bot.

Sau khi hoàn tất, BotFather sẽ trả về Bot Token — lưu lại token này để dùng ở bước 5.

3
Mở đúng project trong Antigravity

Mở đúng folder project mà muốn Claude Code xử lý. Telegram sẽ điều khiển đúng session Claude Code đang mở trong folder đó. Nếu mở nhầm folder thì bot vẫn chạy nhưng làm sai context.

4
Khởi động Claude Code session

Trong Terminal (không phải khung chat), chạy:

claude
5
Cài plugin Telegram (trong khung chat Claude Code)

Trong khung chat Claude Code (không phải Terminal), chạy slash command:

/plugin install telegram@claude-plugins-official
6
Cấu hình token bot (trong khung chat Claude Code)

Nhập token từ BotFather vào lệnh sau — chạy trong khung chat Claude Code:

/telegram:configure YOUR_BOT_TOKEN

Thay YOUR_BOT_TOKEN bằng token thật từ BotFather.

7
Reload plugin

Sau khi cấu hình xong, reload plugin trong khung chat Claude Code:

/reload-plugins
8
Khởi chạy session với Telegram channel

Thoát session cũ nếu cần, rồi trong Terminal chạy:

claude --channels plugin:telegram@claude-plugins-official

Nếu chạy đúng, terminal sẽ hiển thị: Listening for channel messages from: plugin:telegram@claude-plugins-official — session đã attach channel thành công.

9
Pair Telegram với session Claude Code

Mở bot trên Telegram và gửi:

hi

Bot sẽ trả về một pairing code. Quay lại đúng session Claude Code đang chạy, nhập vào khung chat:

/telegram:access pair <code>

Sau khi pair thành công, khóa bot ngay:

/telegram:access policy allowlist
10
Test thực tế

Trên Telegram, gửi thử:

Hãy liệt kê 5 file quan trọng trong folder hiện tại
🎉

Nếu bot phản hồi được là quy trình đã hoàn tất thành công!

Lỗi thường gặp

⚠️ Lỗi 1: zsh: no such file or directory: /plugin

Nguyên nhân: Đã gõ slash command trong Terminal thay vì khung chat Claude Code.

Cách xử lý — chuyển sang khung chat và chạy lại
/plugin install telegram@claude-plugins-official

⚠️ Lỗi 2: Unknown skill: telegram:configure

Nguyên nhân: Plugin chưa load đúng skill, session chưa reload, hoặc runtime plugin đang lỗi.

Bước 1 — Reload plugin
/reload-plugins
Bước 2 — Nếu vẫn lỗi, restart và chạy lại với channel
claude --channels plugin:telegram@claude-plugins-official

⚠️ Lỗi 3: Telegram bot không phản hồi pairing code

Kiểm tra theo thứ tự:

1 — Kiểm tra terminal có hiện thông báo Listening

Terminal phải hiển thị: Listening for channel messages from: plugin:telegram@claude-plugins-official

2 — Nếu chưa, khởi chạy lại đúng lệnh
claude --channels plugin:telegram@claude-plugins-official
3 — Sau khi đổi token phải reload plugins
/reload-plugins

Chỉ giữ 1 session Claude đang mở cùng lúc.

⚠️ Lỗi 4: Session Listening… nhưng Telegram vẫn im

Đây thường là lỗi inbound/runtime của plugin hoặc channel — không phải lỗi thao tác người dùng.

Thử lại theo thứ tự

1. Đóng hết session → 2. Mở lại 1 session duy nhất → 3. Chạy /reload-plugins → 4. Nhắn lại hi qua Telegram. Nếu vẫn không phản hồi, ghi chú đây là lỗi runtime/plugin.

⚠️ Lỗi 5: Session không nhận channel messages

Nếu đang dùng môi trường tổ chức/team, channels có thể bị chặn ở cấp admin hoặc setting hệ thống. Plugin có thể hiện nhưng message không đẩy vào session — cần liên hệ admin để mở quyền.

🔐 Lưu ý bảo mật — Bắt buộc

Không để lộ token

Không chụp màn hình chứa bot token. Không commit token hoặc file .env lên Git.

Khóa bot sau khi pair

Pair xong phải chạy ngay /telegram:access policy allowlist để chỉ whitelist user được phép nhắn.

Token bị lộ?

Ngay lập tức revoke token cũ qua BotFather (/revoke) và tạo token mới. Token cũ không thể thu hồi từng phần.

1 bot — 1 session

Không mở nhiều session dùng chung 1 bot khi chưa kiểm soát rõ context. Dễ gây conflict.

✅ Checklist sau cài đặt

Sẵn sàng bứt phá tốc độ code?

Bắt đầu cài đặt ngay hôm nay và trải nghiệm sức mạnh của AI Agent thực thụ.

Bắt đầu ngay