Phần I · Nền Tảng · Chương 3
Bản Đồ Toàn Cảnh
Nguyên lý hoạt động · Phân loại đa chiều
và chiến lược chọn tool cho đồ án
PLAYBOOK SDD ADD & CODEX
Chương 3 — Giới Thiệu
Chương 3 — Mục Lục
Phần 3.1
Toàn bộ hệ sinh thái AI coding chỉ có 3 triết lý thiết kế cơ bản.
Mọi tool là một biến thể của 1 trong 3 triết lý này.
Hiểu được điều này, bạn sẽ không bao giờ bị "lạc" khi tool mới xuất hiện.
3.1.1 — Trục 1: Triết Lý Tích Hợp
"AI sống trong editor của bạn" — AI có quyền truy cập tự nhiên vào mọi thứ: file đang mở, project structure, terminal output, git history, và cursor position.
3.1.1 — Trục 1: Triết Lý Tích Hợp
"AI là phần mở rộng của editor bạn" — Không tạo IDE mới, thêm AI vào IDE đã dùng. Bạn giữ nguyên môi trường làm việc hiện tại.
3.1.1 — Trục 1: Triết Lý Tích Hợp
"AI là đồng nghiệp làm việc qua terminal" — AI không chỉ gợi ý code mà TỰ LÀM: đọc codebase → lên plan → edit files → chạy tests → fix errors → commit.
3.1.1 — Bảng So Sánh
| Tiêu chí | IDE-Native | Plugin/Extension | Terminal-Native |
|---|---|---|---|
| Phép ẩn dụ | Kiến trúc sư tích hợp | Cố vấn bên cạnh | Đồng nghiệp tự chủ |
| Context depth | Cao (file + project + terminal) | Trung bình (file + partial project) | Rất cao (toàn bộ filesystem) |
| Autonomy | Trung bình (Agent mode) | Thấp (Chat + autocomplete) | Rất cao (full shell access) |
| Learning curve | Thấp (VS Code familiar) | Rất thấp (cài extension) | Trung bình (terminal skills) |
| Workflow change | Vừa (editor mới) | Không (đồ cũ) | Lớn (terminal-first) |
| Multi-file editing | Tốt | Hạn chế | Xuất sắc |
| Phù hợp cho | Daily coding, vừa + nhỏ | Mọi IDE, team lớn | Complex tasks, refactors |
| Ví dụ tool | Cursor, Windsurf, Kiro | Copilot, Cline | Claude Code, Codex CLI |
Trục 2
Trục phân loại thứ hai cực kỳ quan trọng mà nhiều người bỏ qua.
Ảnh hưởng trực tiếp đến 3 yếu tố: chi phí · bảo mật · linh hoạt tương lai
3.1.2 — Model Openness
Chỉ dùng model của nhà cung cấp. Không thể chọn model khác, không chạy local.
Đổi model như đổi ống kính. Claude cho task phức tạp, GPT-4o cho task nhanh, Llama local cho code nhạy cảm.
3.1.2 — Tối Ưu Chi Phí
Nhóm 5 SV · 20 tuần · 8h/ngày × 5 ngày/tuần
3.1.2 — Bảng So Sánh
Triết lý tích hợp × Model openness
| Model-Locked (Đóng) | Model-Agnostic (Mở) | |
|---|---|---|
| IDE-Native | Kiro (Amazon models) Windsurf (hỗn hợp) |
Cursor (GPT/Claude/Gemini/local) Zed AI (multi-provider) |
| Plugin/Extension | Copilot (chủ yếu OpenAI) | Cline (mọi provider + Ollama) Continue.dev (mọi provider + local) |
| Terminal-Native | Claude Code (Anthropic) | Aider (30+ models + Ollama) Codex CLI (OpenAI, open-source) |
Trục 3
Context là tài nguyên hữu hạn. Các tools xử lý giới hạn này bằng 2 chiến lược khác nhau.
Hiểu sự khác biệt giúp bạn dùng tool hiệu quả hơn.
3.1.3 — Context Strategies
Index codebase → Vector DB → Query tìm chunks liên quan → Gửi ít tokens cho LLM. Giống như Google: không đọc toàn bộ internet, chỉ trả kết quả relevant.
Gửi nhiều files trực tiếp vào context window. AI "thấy" tất cả cùng lúc. Giống trải hết giấy tờ lên bàn lớn để nhìn toàn cảnh.
Phần 3.2
6 tools chính được đánh giá theo cùng một bộ tiêu chí để so sánh công bằng.
Mỗi tool có bảng Snapshot thống nhất, sau đó là phân tích sâu về nguyên lý và use case.
3.2.1 — Snapshot
| Triết lý | Terminal-Native Agentic |
| Model | Model-Locked: Claude Opus 4.6, Sonnet 4.6 |
| Context Handling | Hybrid: Agent tự chọn files (search) + load vào 200K context window |
| Execution Power | Rất cao: đọc/ghi files, chạy terminal, git, install packages, sub-agents |
| Agentic Capability | Plan → Execute → Observe → Adjust. Extended Thinking. Multi-agent spawning. |
| Chi phí | Pro $20/mo (hạn chế) · Max $100/mo (5x) · Max $200/mo (20x) · API: pay-per-use |
| Free tier | Không (cần subscription hoặc API key) |
| IDE Integration | CLI + VS Code extension + Desktop app + Browser |
| MCP Support | Có — kết nối Google Drive, Jira, Slack, custom tools |
| Data Privacy | Code gửi lên Anthropic servers. ZDR (Zero Data Retention) cho API. |
| Config files | CLAUDE.md (project memory) · slash commands · hooks |
| Open-source | Không (proprietary) |
| Điểm mạnh nhất | Deep reasoning · multi-file refactoring · "hiểu" cả codebase |
| Điểm yếu nhất | Chi phí cao · model-locked · learning curve terminal |
3.2.1 — Claude Code
Agent không chỉ code mà còn install dependencies, áp dụng cho nhiều files, viết tests, và chạy tests — tất cả trong 1 task. Đây là sự khác biệt cốt lõi so với chat-based tools.
3.2.2 — Snapshot
| Triết lý | IDE-Native (VS Code fork) |
| Model | Model-Agnostic: GPT-4o, Claude Sonnet/Opus, Gemini, custom via API key |
| Context Handling | Hybrid: Codebase indexing (RAG) + @file/@folder cho manual selection |
| Execution Power | Trung bình-cao: Agent mode chạy terminal, nhưng trong IDE sandbox |
| Agentic Capability | Agent Mode (plan + multi-file edit + terminal). Background agents (beta). |
| Chi phí | Free (hạn chế) · Pro $20/mo · Business $40/mo |
| Free tier | Có (giới hạn số requests/tháng) |
| IDE Integration | Là IDE (VS Code fork). Cũng có ở Cursor.com web. |
| MCP Support | Có (từ 2025) |
| Data Privacy | Privacy Mode: code không được lưu trữ. SOC 2 certified. |
| Config files | .cursorrules (rules) · .cursorignore (exclude files) |
| Điểm mạnh nhất | Flow state · autocomplete nhanh · familiar UX (VS Code) |
| Điểm yếu nhất | Large refactors không bằng Claude Code · giá thay đổi thường xuyên |
3.2.2 — Cursor
Hướng dẫn Cursor về conventions, patterns, constraints của dự án — tương tự AGENTS.md.
3.2.3 — Snapshot
| Triết lý | Plugin/Extension + đang chuyển dần sang Agentic |
| Model | Hỗn hợp: chủ yếu GPT-4o, đang mở cho Claude và Gemini |
| Context Handling | RAG (embeddings của repo) + @workspace cho broad context |
| Execution Power | Trung bình: Agent mode (mới), Copilot Workspace cho GitHub-centric |
| Agentic Capability | Agent Mode · Copilot Workspace · Agent HQ (multi-agent, beta 02/2026) |
| Chi phí | Free (hạn chế) · Individual $10/mo · Business $19/mo · Enterprise $39/mo |
| Free tier | Có — Free cho verified students và open-source maintainers |
| IDE Integration | VS Code · JetBrains · Vim/Neovim · Xcode · Visual Studio |
| MCP Support | Đang phát triển (Agent HQ) |
| Data Privacy | Business/Enterprise: code KHÔNG dùng training. Individual: có thể được dùng. |
| Config files | .github/copilot-instructions.md |
| Điểm mạnh nhất | Ecosystem GitHub · giá rẻ · miễn phí cho SV · enterprise features |
| Điểm yếu nhất | Agentic capability đang chuyển tiếp · chưa mạnh bằng Claude Code/Cursor |
3.2.4 — Snapshot
| Triết lý | Terminal-Native Agentic · Open-Source |
| Model | Chủ yếu OpenAI (o3, o4-mini, GPT-4.1). Hỗ trợ providers khác qua config. |
| Context Handling | File reading + AGENTS.md layered system |
| Execution Power | Cao: sandboxed execution, network-disabled by default (an toàn) |
| Agentic Capability | Plan + execute trong sandbox. 3 modes: suggest · auto-edit · full-auto. |
| Chi phí | Tool miễn phí (open-source). Trả API usage cho OpenAI. |
| Free tier | Tool free, cần OpenAI API key ($) |
| Data Privacy | Sandbox mặc định: network disabled, chỉ truy cập project folder |
| Config files | AGENTS.md (layered: global → project → directory) |
| Open-source | Có — Apache 2.0 license |
| Điểm mạnh nhất | Open-source · sandbox an toàn · AGENTS.md native · tùy chỉnh cao |
| Điểm yếu nhất | Mới · ít mature hơn Claude Code · cộng đồng nhỏ hơn |
Codex CLI là birthplace của AGENTS.md — format giờ đã được 60K+ projects sử dụng và donate cho Linux Foundation.
3.2.5 — Snapshot
| Triết lý | IDE-Native với SDD built-in |
| Model | Model-Locked: Amazon Bedrock (Claude + Amazon models) |
| Context Handling | Long context (Gemini 1M tokens qua Bedrock) |
| Execution Power | Trung bình: IDE-based execution, DevOps automation |
| Agentic Capability | SDD workflow: requirements.md → design.md → tasks.md → implement |
| Chi phí | Free (beta) tại thời điểm viết, giá chưa công bố chính thức |
| IDE Integration | Là IDE (Code OSS fork, giống VS Code) |
| Data Privacy | AWS compliance (SOC 2, HIPAA eligible với Bedrock) |
| Config files | requirements.md · design.md · tasks.md (định dạng EARS) |
| Open-source | Không (Amazon proprietary) |
| Điểm mạnh nhất | SDD tích hợp sẵn trong IDE · EARS notation · spec-first workflow |
| Điểm yếu nhất | Mới (07/2025) · performance chưa ổn định · Amazon ecosystem lock-in |
Kiro là tool duy nhất tích hợp SDD workflow trực tiếp vào IDE — "training wheels" tốt nhất cho người mới học SDD. Đáng theo dõi nhưng chưa nên dựa hoàn toàn vào.
3.2.6 — Model-Agnostic Tools Nổi Bật
3 tools chia sẻ triết lý chung: dùng bất kỳ model nào, kể cả local models
| Tiêu chí | Cline | Continue.dev | Aider |
|---|---|---|---|
| Triết lý | Plugin, Agnostic, Agentic | Plugin (VS Code + JetBrains) | Terminal-Native, Agnostic |
| Models | Anthropic, OpenAI, Google, Ollama, OpenRouter | Mọi providers + Ollama + LM Studio + custom | 30+ models: GPT, Claude, Gemini, Llama, DeepSeek, Qwen... |
| Chi phí | Miễn phí (open-source) | Miễn phí (Apache 2.0) | Miễn phí (open-source) |
| Agentic | Có: đọc/ghi files, terminal, browser automation | Hạn chế: chat + autocomplete (đang phát triển) | Có: edit files, chạy tests, git integration |
| Đặc biệt | Structured modes (plan/code/review), token tracking chi tiết | JetBrains support, local-first design | Leaderboard benchmark models để chọn tối ưu |
| Local LLM | Có — Ollama, LM Studio | Có — thiết kế đặc biệt cho local-first | Có — Ollama native, LM Studio |
3.2.6 — Setup Thực Hành
Dùng AI coding 100% local — code không bao giờ rời máy bạn.
3.2.7 — So Sánh Thực Tế
Task: "Thêm full-text search tiếng Việt cho dự án thư viện sách"
$ claude → mô tả task đơn giảnHỏi → nhận code snippet → tự copy vào file → tự tạo migration → tự chạy tests → tự fix errors. Kiểm soát từng dòng nhưng chậm 2-3x.
3.2.7 — Bảng So Sánh
| Tiêu chí | Cursor | Claude Code | Copilot |
|---|---|---|---|
| Thời gian | ~15 phút | ~10 phút | ~30 phút |
| Files tự xử lý | Phải chỉ định @files | Tự tìm | Từng file manually |
| Chạy tests | Thủ công | Tự động | Thủ công |
| Fix errors | Chat lại | Tự động fix + re-run | Thủ công |
| DB migration | Agent mode có thể tạo file | Tự tạo + chạy | Bạn tự làm |
| Trực quan | Diff view inline ★ | Git diff (terminal) | Xem code trực tiếp |
| Kiểm soát | Từng file | Từng task | Từng dòng |
| Phù hợp cho task này? | Tốt | Rất tốt | Được nhưng chậm |
3.2.8 — Cùng 1 Bug · 3 Cách Debug
Nguyên nhân: unaccent extension chưa được cài trong PostgreSQL
SELECT unaccent('nguyễn')"psql -c "SELECT unaccent('nguyễn')"ERROR: function unaccent does not existHỏi → giải thích cần unaccent extension → bạn tự kiểm tra psql → tự tạo migration → tự chạy → tự test. Chỉ giải thích, bạn làm hết.
Claude Code giải quyết bug end-to-end (tìm nguyên nhân + fix + verify) chỉ với 1 prompt. Mức độ autonomy khác nhau rõ ràng giữa 3 triết lý.
3.2.9 — Hệ Sinh Thái Config Files
| File | Tool đọc | Mục đích | Scope |
|---|---|---|---|
| AGENTS.md | Codex CLI, Cursor, Cline, mọi agent | Hướng dẫn chung cho MỌI AI tool | Universal |
| CLAUDE.md | Claude Code | Memory + context cho Claude | Claude only |
| .cursorrules | Cursor | Rules cho Cursor AI | Cursor only |
| .github/copilot-instructions.md | GitHub Copilot | Hướng dẫn cho Copilot | Copilot only |
| .continuerc.json | Continue.dev | Config cho Continue | Continue only |
| .aider.conf.yml | Aider | Config cho Aider | Aider only |
CLAUDE.md = AGENTS.md + Claude-specific ·
.cursorrules = AGENTS.md reformatted cho Cursor ·
Dùng pre-commit hook để luôn sync
Phần 3.3
Không có tool nào tốt nhất cho mọi tình huống —
chỉ có tool phù hợp nhất cho bối cảnh của bạn.
Decision Matrix 6 chiều · Data Privacy 3 mức · Phân tích TCO
3.3.1 — Decision Matrix
| Quy mô | Mô tả | Tool khuyên nghị |
|---|---|---|
| Nhỏ (<5K LOC) | Prototype, hackathon, side project | Cursor hoặc Copilot — nhanh, đơn giản |
| Vừa (5-50K LOC) | Đồ án SE, startup MVP | Cursor + Claude Code (combo) |
| Lớn (>50K LOC) | Enterprise, legacy system | Claude Code (agentic) + Copilot (team) |
| Ngân sách | Lựa chọn tối ưu |
|---|---|
| $0 (miễn phí) | Copilot (GitHub Education) + Cline (open-source) + Ollama (local) |
| $10-20/người/tháng | Cursor Pro ($20) hoặc Copilot Individual ($10) |
| $20-50/người/tháng | Cursor Pro + Claude Code API (pay-per-use) |
| >$100/người/tháng | Claude Code Max ($100-200) cho full power |
3.3.1 — Decision Matrix
| Kỹ năng | Tool khuyên nghị | Lý do |
|---|---|---|
| Mới học lập trình | Cursor + Copilot | UI quen thuộc, learning curve thấp nhất |
| Biết cơ bản, chưa pro | Cursor (Agent Mode) | Agent hỗ trợ nhưng vẫn trong IDE quen |
| Thoải mái với terminal | Claude Code hoặc Aider | Tận dụng full agentic power |
| Hỗn hợp (nhóm 5 người) | Cursor (chung) + Claude Code (lead) | Mọi người dùng Cursor, lead dùng CC cho tasks khó |
| Loại dự án | Tool khuyên nghị | Lý do |
|---|---|---|
| Greenfield (từ đầu) | Claude Code + Spec Kit | Scaffold nhanh từ spec |
| Brownfield (mở rộng) | Cursor + Claude Code | Cần hiểu codebase hiện tại |
| Data pipeline | Claude Code (terminal-first) | Cần chạy scripts, process data |
| Mobile app | Cursor (preview UI) | Cần thấy UI trực quan |
| Microservices | Claude Code (multi-repo) | Cần làm việc across services |
3.3.2 — Data Privacy & Compliance
Câu hỏi cốt lõi: code của bạn đi đâu khi bạn dùng AI tool?
Code gửi lên cloud servers để LLM xử lý. Hầu hết tools mặc định ở mức này. Cần hỏi vendor: code có được lưu trữ? dùng cho training? servers ở đâu?
Code gửi lên, xử lý, trả kết quả, xóa ngay. Không lưu, không log, không training. Anthropic API với ZDR và Cursor với Privacy Mode ở mức này. Đủ cho hầu hết dự án.
Code không bao giờ rời máy. LLM chạy local qua Ollama. Cần thiết cho: dự án quân sự/chính phủ, dữ liệu y tế (HIPAA), tài chính (PCI DSS), hoặc công ty cấm gửi code ra ngoài.
3.3.2 — Data Privacy
| Tool | Code dùng training? | Lưu trữ? | Data Region | Certifications |
|---|---|---|---|---|
| Claude Code (Sub) | Không | 30 ngày (trust & safety) | US | SOC 2 Type II |
| Claude Code (API) | Không | Không (ZDR) | US, EU | SOC 2, HIPAA eligible |
| Cursor (Pro+) | Không (Privacy Mode) | Không | US | SOC 2 |
| Copilot (Individual) | Có thể (đọc ToS kỹ) | Có thể | US | SOC 2 |
| Copilot (Business+) | Không | Không | US, EU | SOC 2, ISO 27001 |
| Codex CLI (API) | Không | 30 ngày | US | SOC 2 |
3.3.2 — Khi Nào Cần Local LLM
| Tình huống | Mức privacy cần | Giải pháp |
|---|---|---|
| Đồ án sinh viên thông thường | Mức 1-2 (đủ) | Cursor/Copilot/Claude Code bình thường |
| Đồ án dùng dữ liệu thực người dùng | Mức 2 (ZDR) | API với ZDR, không paste dữ liệu thực vào prompt |
| Startup với IP quan trọng | Mức 2-3 | ZDR API + local cho core algorithms |
| Dự án bảo mật cao (quân sự, y tế) | Mức 3 (bắt buộc) | Continue.dev + Ollama + Llama 3 |
| Công ty cấm gửi code ra ngoài | Mức 3 (bắt buộc) | Cline + Ollama hoặc Aider + local model |
3.3.3 — Phân Tích Chi Phí
TCO = Subscription + API + Learning + Risk
3.3.3 — Case Study Chi Phí
| Hạng mục | PA-A: Bootstrap ($0) | PA-B: Standard | PA-C: Hybrid ★ Khuyên Nghị |
|---|---|---|---|
| Subscription/tháng | $0 | 5×$20 = $100 | ~$100 |
| API/tháng | ~$5-10 | $0 (đủ trong sub) | ~$20 (shared key) |
| Tổng 5 tháng | ~$50 | ~$500 | ~$600 |
| Tools | Copilot Free + Cline | Cursor Pro only | Cursor + Claude Code |
| Chất lượng AI | Trung bình | Tốt | Rất tốt |
| Learning time | 6-8h (Cline phức tạp) | 2-4h | 4-6h |
| Risk khi down | Thấp (multi-provider) | Trung bình | Thấp (có backup) |
| Đánh giá | ★★★ (tiết kiệm) | ★★★★ (đơn giản) | ★★★★★ (tối ưu) |
Phần 3.4
Developer giỏi không chỉ dùng 1 tool mà kết hợp nhiều tools cho các mục đích khác nhau.
Giống như thợ mộc không chỉ có 1 cái búa — họ có cả hộp công cụ và biết khi nào dùng cái nào.
Xu hướng rõ ràng trong 2026
3.4.1 — Combo Phổ Biến Nhất
Pattern được nhiều developer sử dụng nhất: daily coding với Cursor + complex tasks với Claude Code
3.4.2 — Combo Tiết Kiệm
Cho nhóm sinh viên ngân sách $0
3.4.3 — Khuyến Nghị Cụ Thể
| Phương án | Thành viên | Tool chính | Tool phụ | Chi phí |
|---|---|---|---|---|
| PA-A Bootstrap |
Tất cả 5 | Copilot (Free Education) | Cline + Ollama | $0 |
| Lead (1) | + Anthropic API key | Claude Code khi cần | ~$10/tháng | |
| Tổng: ~$50 cả 20 tuần | ||||
| PA-B Standard |
Tất cả 5 | Cursor Pro ($20/tháng) | — | $100/tháng |
| Lead (1) | + Claude Code Max | — | +$100/tháng | |
| Tổng: ~$1,000 cả 5 tháng | ||||
| PA-C Hybrid ★ |
4 người | Cursor Pro ($20/tháng) | Copilot Free (backup) | $80/tháng |
| Lead (1) | Claude Code Pro ($20) | Cursor Pro | $40/tháng | |
| Cả nhóm | Anthropic API (shared) | Cho tasks phức tạp | ~$20/tháng | |
| Tổng: ~$700 cả 5 tháng — TỐI ƯU CHI PHÍ vs HIỆU QUẢ | ||||
Tóm Tắt — Chương 3
3 triết lý tích hợp (IDE-native, Plugin, Terminal-native) + 2 trục phụ (Model-Locked vs Agnostic, RAG vs Long Context). Mọi tool là biến thể của 3 triết lý này.
Claude Code mạnh nhất về reasoning. Cursor mượt nhất về flow. Copilot rộng nhất về ecosystem. Config files: dùng AGENTS.md làm nguồn sự thật duy nhất.
Decision Matrix 6 chiều (quy mô, ngân sách, kỹ năng, loại dự án). Data Privacy 3 mức: Cloud → ZDR → Local. Local LLM với Ollama + Cline cho bảo mật cao.
Multi-tool là xu hướng 2026. Combo tốt nhất: Cursor + Claude Code. Combo $0: Copilot + Cline + Ollama. Khuyên nghị nhóm 5 SV: PA-C Hybrid ~$700/5 tháng.
Bài Tập — Chương 3
| # | Bài tập | Thời gian | Deliverable |
|---|---|---|---|
| HW-7 | Mỗi người cài và thử 1 tool chưa dùng (30 phút). Viết nhận xét 5 dòng. | 30p | Tool review (5 dòng) |
| HW-8 | Nhóm chọn tool stack cho đồ án. Viết Decision Record. | 20p | DECISIONS.md: D-00X |
| HW-9 | Setup AGENTS.md + .cursorrules (hoặc tương đương) cho dự án. | 30p | Config files committed |
| HW-10 | (Nếu có máy mạnh) Thử Cline + Ollama local. So sánh với cloud. | 40p | Báo cáo local vs cloud |
Kết Thúc Chương 3
Các Tiêu Chuẩn Mở: AGENTS.md · CLAUDE.md · MCP · A2A
PLAYBOOK SDD ADD & CODEX