> ## Documentation Index
> Fetch the complete documentation index at: https://huongdan.luklak.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code cho người không code

> Khóa học 8 bài — từ prompt đầu tiên đến điều phối đội agent. Dành cho lãnh đạo và người vận hành, không cần biết lập trình.

**Từ prompt đầu tiên đến agent team — trong một buổi chiều.**

<Info>
  Khóa học này dành cho bạn nếu: **chưa từng dùng VS Code, chưa từng viết một dòng code, nhưng muốn hiểu cách AI thực sự vận hành và làm được gì.**

  Kết thúc khóa học, bạn sẽ hiểu rõ Claude Code là gì, tại sao nó khác ChatGPT, cách điều phối một đội agent song song, và viết được prompt đầu tiên cho dự án thật của mình.
</Info>

## Bạn sẽ học được gì

<CardGroup cols={2}>
  <Card title="Nguyên lý LLM hoạt động" icon="brain" iconType="duotone">
    Hiểu chuyện gì thực sự xảy ra khi bạn gửi một prompt cho AI. Token là gì, cửa sổ ngữ cảnh (context window) là gì, vì sao AI "ảo giác" (hallucinate).
  </Card>

  <Card title="Vòng lặp Agent" icon="arrows-spin" iconType="duotone">
    Claude Code không phải chatbot. Đó là một vòng lặp tác vụ (agent loop): đọc → lập kế hoạch → dùng công cụ → kiểm chứng → lặp lại.
  </Card>

  <Card title="Đội hình Agent" icon="users-gear" iconType="duotone">
    Cách một agent chính điều phối nhiều đại lý con (sub-agent) chạy song song — ví dụ thực: 7 agent dịch 7 bản thiết kế LAIKA cùng lúc trong 5 phút.
  </Card>

  <Card title="Xây hệ thống của riêng bạn" icon="hammer" iconType="duotone">
    Claude Code không ép bạn theo cấu trúc nào. Bạn tự tay may đo agent phù hợp với bộ não của mình — Claude đọc ý định, không đọc quy ước.
  </Card>
</CardGroup>

## Kiến trúc tổng thể

```mermaid theme={null}
flowchart TD
    U[👤 Bạn<br/>User] --> CC[🎛️ Claude Code<br/>Harness điều phối]

    CC --> M[🧠 Model Claude<br/>Trí thông minh]

    CC --> T[🛠️ Tools<br/>Công cụ thao tác]
    T --> T1[Read / Write / Edit]
    T --> T2[Bash / Grep / Glob]
    T --> T3[WebFetch / Agent]

    CC --> EXT[⚙️ Extensions<br/>Mở rộng năng lực]
    EXT --> E1[Skills<br/>Quy trình tái sử dụng]
    EXT --> E2[Sub-agents<br/>Chuyên gia con]
    EXT --> E3[Hooks<br/>Tự động tại sự kiện]
    EXT --> E4[MCP<br/>Kết nối hệ thống ngoài]
    EXT --> E5[Memory<br/>Bộ nhớ bền vững]
    EXT --> E6[Schedule<br/>Chạy theo lịch]

    T1 --> FS[(📁 Hệ thống file<br/>dự án của bạn)]
    T2 --> FS
    T3 --> WEB[🌐 Web]
    E4 --> EXT_SYS[🔌 Slack / Jira /<br/>Google Docs / ...]

    CC -.đọc ngầm.-> CFG[📋 CLAUDE.md<br/>quy tắc dự án]

    style U fill:#c8e6c9
    style CC fill:#e3f2fd
    style M fill:#fff9c4
    style T fill:#f8bbd0
    style EXT fill:#d1c4e9
    style FS fill:#fff3e0
    style WEB fill:#fff3e0
    style EXT_SYS fill:#fff3e0
    style CFG fill:#b3e5fc
```

Hình trên là **bản đồ toàn hệ sinh thái**. Bạn gửi prompt → Claude Code harness điều phối → model suy luận → tools thực thi → extensions mở rộng. Mọi thứ xoay quanh một vòng lặp thống nhất. Từng thành phần sẽ được đi sâu ở các bài sau.

## Lộ trình 8 bài

```mermaid theme={null}
flowchart TD
    A[Bài 1<br/>Nguyên lý LLM] --> B[Bài 2<br/>Claude Code là gì]
    B --> C[Bài 3<br/>Công cụ & Vòng lặp]
    C --> D[Bài 4<br/>Sub-agent & Đội hình]
    D --> E[Bài 5<br/>Ví dụ thực tế: Lulu]
    E --> F[Bài 6<br/>Best practices]
    F --> G[Bài 7<br/>Nâng cao]
    G --> H[Bài 8<br/>Thực hành]
    style A fill:#e3f2fd
    style H fill:#c8e6c9
```

<CardGroup cols={2}>
  <Card title="Bài 1 — Nguyên lý LLM" icon="1" href="/06-academy/claude-code/nguyen-ly-llm">
    Chuyện gì xảy ra bên trong một LLM khi bạn gửi prompt? Nắm nguyên lý nền tảng — mọi thứ còn lại chỉ là kỹ thuật.
  </Card>

  <Card title="Bài 2 — Claude Code là gì" icon="2" href="/06-academy/claude-code/claude-code-la-gi">
    So sánh với ChatGPT, hiểu vòng lặp tác vụ, thấy được vì sao Claude Code không phải chatbot.
  </Card>

  <Card title="Bài 3 — Công cụ & Vòng lặp" icon="3" href="/06-academy/claude-code/cong-cu-va-vong-lap">
    Demo từng bước: Claude đọc file, chỉnh sửa, chạy lệnh, kiểm chứng. Phép màu nằm ở chỗ AI có quyền truy cập hệ thống file.
  </Card>

  <Card title="Bài 4 — Sub-agent & Đội hình" icon="4" href="/06-academy/claude-code/sub-agent-va-doi-hinh">
    Cách "thuê chuyên gia" làm việc song song trong phòng riêng. Cửa sổ ngữ cảnh cách ly, kết quả gom về.
  </Card>

  <Card title="Bài 5 — Ví dụ thực tế: Lulu" icon="5" href="/06-academy/claude-code/vi-du-thuc-te-lulu">
    Nghiên cứu thực tế: agent Lulu DocOps của Luklak. Hệ thống file tự thiết kế, không theo chuẩn Claude Code — và vẫn chạy tốt.
  </Card>

  <Card title="Bài 6 — Best practices" icon="6" href="/06-academy/claude-code/best-practices">
    8 nguyên tắc tách biệt người dùng hiệu quả với người dùng thất vọng. Prompt tốt là prompt có thể kiểm chứng.
  </Card>

  <Card title="Bài 7 — Nâng cao" icon="7" href="/06-academy/claude-code/nang-cao">
    Skills, hooks, MCP, agent theo lịch, hệ thống bộ nhớ, Agent SDK. Biết để mở rộng trí tưởng tượng.
  </Card>

  <Card title="Bài 8 — Thực hành" icon="8" href="/06-academy/claude-code/bai-tap-thuc-hanh">
    Năm bài tập thực tế bạn có thể làm trong tuần này. Học bằng cách làm — không bằng cách đọc.
  </Card>
</CardGroup>

## Khóa học này dành cho ai?

<AccordionGroup>
  <Accordion title="Lãnh đạo muốn hiểu AI làm được gì cho doanh nghiệp" icon="user-tie">
    Bạn nghe về "AI agent", "agent team", "automation" nhưng chưa nắm bản chất. Khóa học này cho bạn nền tảng kỹ thuật đủ để ra quyết định — không đòi hỏi bạn phải code.
  </Accordion>

  <Accordion title="Người vận hành (ops, docs, content) muốn tự động hóa công việc" icon="screwdriver-wrench">
    Công việc của bạn nhiều thao tác lặp đi lặp lại: dịch thuật, viết tài liệu, xử lý dữ liệu. Claude Code có thể giải phóng 70% thời gian đó — nếu bạn biết cách thiết kế.
  </Accordion>

  <Accordion title="Tư vấn giải pháp muốn demo cho khách hàng" icon="handshake">
    Bạn cần giải thích AI agent cho CEO của khách hàng. Khóa học này cho bạn khung tư duy + ví dụ thực tế để trình bày rõ ràng và thuyết phục.
  </Accordion>
</AccordionGroup>

## Điều kiện cần

* Một máy tính (Windows, Mac, Linux đều được)
* VS Code + Claude Code đã cài đặt
* Một dự án thực tế bạn muốn thử nghiệm (hoặc clone repo `mintlify-tailieuvn` để làm theo khóa học)

<Tip>
  **Không cần biết code.** Thực sự không cần. Khóa học này dùng metaphor (ẩn dụ) và ví dụ thực tế, không dùng cú pháp lập trình.
</Tip>

## Một góc nhìn về tư duy làm việc với LLM

<Info>
  Trước khi vào bài, đây là triết lý làm việc đã đúc kết được trong dự án này. Không phải đúng tuyệt đối — là một lăng kính để bạn tự xây quan điểm của riêng mình.
</Info>

<AccordionGroup>
  <Accordion title="1. Hình dung sinh động là nguyên liệu đầu vào" icon="eye">
    Bạn càng vẽ rõ trong đầu kết quả cuối cùng — ai đọc, cảm nhận thế nào, giá trị gì — LLM càng ít phải đoán. Prompt mơ hồ cho ra đầu ra tầm thường; prompt có hình dung rõ cho ra đầu ra gần với ý định.

    Cơ chế thực sự không phải "manifest" theo nghĩa huyền bí — LLM không đọc được mong muốn. Nó chỉ thu hẹp không gian khả năng dựa trên ngữ cảnh bạn cung cấp. **Càng chi tiết, càng ít không gian để chệch.**
  </Accordion>

  <Accordion title="2. Cảnh báo ngầm — LLM trả về cái giống, không phải cái thực sự đúng" icon="triangle-exclamation">
    LLM trả về cái *giống* kết quả bạn muốn thống kê trong dữ liệu huấn luyện, không phải cái *thực sự* bạn cần.

    Một "kế hoạch marketing thành công" AI viết ra **nhìn như** kế hoạch thành công — không chắc **là** kế hoạch sẽ thành công. Khoảng cách đó chính là nơi gu thẩm mỹ (taste) và khả năng phán xét của bạn xen vào.
  </Accordion>

  <Accordion title="3. Vai trò đã thay đổi — bạn là orchestrator + editor" icon="user-gear">
    Bạn không còn là người làm — bạn là **người điều phối và biên tập** (orchestrator + editor).

    * **Điều phối** là giao task, chạy song song, gom kết quả.
    * **Biên tập** là từ chối: *"Không, không phải thế, làm lại"*, *"80% đã đúng nhưng 20% còn lại chính là linh hồn của nó"*.

    Điều phối thiếu biên tập tạo ra **sản phẩm trung bình được đánh bóng ở quy mô lớn** — cái bẫy phần lớn người dùng AI đang rơi vào năm nay.
  </Accordion>

  <Accordion title="4. Gu thẩm mỹ là lợi thế cạnh tranh còn lại" icon="palette">
    AI làm phẳng mọi thứ về trung bình của dữ liệu huấn luyện. Giữ được nét riêng là lợi thế.

    Gu đến từ nguyên liệu đầu vào: những gì bạn đọc, nghe, quan sát, trải nghiệm. Nếu LinkedIn là nguồn duy nhất, tư duy sẽ hình thành theo khuôn LinkedIn. **Sách cũ, nghệ thuật, trò chuyện với người lạ, tự tay làm một cái gì đó vật lý** — tất cả đều nuôi gu theo cách AI không thay thế được.
  </Accordion>

  <Accordion title="5. Nút thắt cổ chai mới là khả năng đánh giá" icon="stopwatch">
    Ra prompt thì rẻ. Đánh giá kết quả mới đắt.

    Kỹ năng quan trọng không phải viết prompt nhanh hơn — mà là **đánh giá nhanh hơn**. Đó là lý do plan mode, checklist trước publish, và vòng lặp xác minh quan trọng đến vậy.
  </Accordion>

  <Accordion title="6. Hai lối tiếp cận không ngang nhau" icon="route">
    Có thể hiểu cặn kẽ trước khi thử, hoặc để kết quả dẫn bạn ngược về.

    Cách thứ hai chỉ hoạt động khi bạn đã có gu trong lĩnh vực đó — bạn phát hiện sai sớm. Trong lĩnh vực mới, cứ thấy "nhìn ổn" là tin → **trả giá ngầm**. Trong lĩnh vực mới, hiểu-trước thắng.
  </Accordion>

  <Accordion title="7. Cách thứ ba — chạy thí nghiệm rẻ song song" icon="flask">
    Không chỉ có "hiểu trước" vs "kết quả dẫn lối" — còn cách thứ ba: chạy thí nghiệm rẻ song song để **xây gu nhanh hơn** so với việc đọc lý thuyết.

    Parallelism làm cái này rẻ gần như miễn phí — 5 prompt cùng lúc, 5 kết quả, bạn so sánh và học được nhiều hơn 1 tiếng đọc sách.
  </Accordion>

  <Accordion title="8. Con người là nút thắt — và đó là tin tốt" icon="user-check">
    AI không thay thế bạn. Tốc độ AI tăng → càng cần con người có gu, có phán xét, có tò mò, có can đảm thử cái mới, có khả năng nói *"không, cái này chưa đủ tốt"*.

    Hãy để AI gánh việc lặp lại. **Giữ cho mình không gian tinh thần đủ rộng để nghĩ lớn hơn.**
  </Accordion>
</AccordionGroup>

<Tip>
  **Gợi ý đọc khóa học**: đừng đọc passive. Sau mỗi bài, dừng 2 phút hỏi: *"Điều này có khớp với kinh nghiệm của tôi không? Có chỗ nào tôi không đồng ý? Tôi sẽ điều chỉnh lăng kính của mình thế nào?"* Triết lý của bạn sẽ trưởng thành nhanh hơn lý thuyết.
</Tip>

## Tiếp theo?

* [Bài 1 — Nguyên lý LLM: Chuyện gì xảy ra khi bạn gửi prompt?](/06-academy/claude-code/nguyen-ly-llm)