Claude Code Cheatsheet: Hướng Dẫn Lập Trình Cho Người Mới Bắt Đầu

Nếu bạn đang tìm hiểu về Claude Code, trợ lý viết code mạnh mẽ được hỗ trợ bởi AI của Anthropic, thì việc có một tài liệu tham khảo rõ ràng là rất cần thiết. Bảng gian lận Claude Code này dành cho các nhà phát triển muốn có một hướng dẫn thực tế, thân thiện với người mới bắt đầu, bao gồm thiết lập, quy trình làm việc, cấu hình và các mẹo nâng cao. Đến cuối cùng, bạn sẽ cảm thấy tự tin hơn khi sử dụng Claude Code trong môi trường cục bộ của mình hoặc như một phần của quy trình CI/CD.

Claude Code là gì?

Claude Code là một công cụ viết code AI dựa trên CLI của Anthropic. Nó cho phép các nhà phát triển tạo, tái cấu trúc, kiểm thử và tài liệu hóa code bằng cách sử dụng các mô hình tiên tiến của Claude. Thay vì một giao diện trò chuyện đơn giản, Claude Code hoạt động như một IDE AI: nó hiểu cấu trúc kho lưu trữ của bạn, áp dụng các quy tắc bảo vệ được định nghĩa trong tệp cấu hình, có thể chạy các lệnh bash và tích hợp với quy trình làm việc của Git.

Cài đặt Claude Code:

# MacOS/Linux:
curl -fsSL https://claude.ai/install.sh | bash

# Windows:
irm https://claude.ai/install.ps1 | iex

# NPM:
npm install -g @anthropic-ai/claude-code

# Homebrew:
brew install --cask claude-code

Bắt đầu sử dụng Claude Code:

cd your-project
claude

Các Thành phần Chính của Claude Code — Bảng Gian lận của Bạn

Dưới đây là các khối xây dựng và tính năng thiết yếu mà bạn sẽ muốn biết khi bắt đầu với Claude Code:

1. CLAUDE.md — Bản khai báo tác nhân

• Tệp CLAUDE.md là “hiến pháp” cho tác nhân của bạn: nó định nghĩa cách Claude hoạt động trong kho lưu trữ của bạn.
• Sử dụng nó để ghi lại các công cụ được phê duyệt, quy trình làm việc chung và các ràng buộc.
• Thực hành tốt nhất: Giữ nó ngắn gọn, tập trung vào các quy tắc bảo vệ chính và tránh nhúng các tài liệu quá lớn.

# MyProject CLAUDE.md

## Project Overview  
This is a Node.js + Express REST API for a task management application.  

## Technology Stack  
- Backend: Node.js (ES6), Express  
- Database: PostgreSQL  
- Testing: Jest  
- Linting & Style: ESLint, Prettier

## Development Commands  
- `npm install` — Install dependencies  
- `npm run dev` — Start development server  
- `npm run test` — Run all tests  
- `npm run lint` — Run linter  

## Coding Standards  
- Use 2-space indentation.  
- Always use `async / await` instead of `.then()` chains.  
- Functions must have JSDoc comments.  
- Prefer composition over inheritance.

## Git Workflow  
- Feature branches must follow this pattern: `feature/FOO`  
- Use `git rebase` instead of `merge` for updating branches.  
- When committing: write descriptive commit messages that follow the Conventional Commits format.

## File Structure Guidance  
- `src/` — Your main application code  
- `tests/` — Test files  
- `scripts/` — Utility or setup scripts  
- `migrations/` — Database migrations  

## Known Issues / Workarounds  
- `db.connect()` sometimes times out; in that case, retry twice.  
- For large JSON payloads, use streaming to avoid memory issues.

## Memory / Style Preferences  
- Always ask for clarification if the request is ambiguous.  
- Do not generate new `.md` files unless explicitly instructed.  
- Include a `co-authored-by Claude` line in generated commits.

2. Quản lý ngữ cảnh

a. Sử dụng **/context** để kiểm tra mức sử dụng token của phiên Claude hiện tại của bạn.

b. Các lệnh để khởi động lại hoặc thu nhỏ ngữ cảnh:

• /clear + /catchup: Xóa tất cả cuộc hội thoại và sau đó tải lại các tệp từ một commit hoặc nhánh.
• Quy trình “Tài liệu hóa & Xóa”: yêu cầu Claude xuất kế hoạch của nó ra một tệp Markdown, xóa bộ nhớ, sau đó tải lại từ tệp đó.

3. Lệnh Slash (/)

• Các lệnh slash là các phím tắt cho các lời nhắc được định nghĩa trước.
• Ví dụ:

• Giữ các lệnh slash tối thiểu và tập trung; đừng phụ thuộc vào chúng cho mọi tác vụ.

4. Chế độ Lập kế hoạch

• Sử dụng chế độ lập kế hoạch khi bắt đầu các tác vụ phức tạp. Claude sẽ phác thảo một kế hoạch trước khi viết code.
• Sau đó, bạn có thể xem xét, chỉnh sửa hoặc phê duyệt kế hoạch đó trước khi yêu cầu Claude thực hiện.
• Lý tưởng cho các công việc tính năng lớn, tái cấu trúc hoặc thay đổi kiến trúc.

5. Tác nhân phụ & Ủy quyền tác vụ

• Claude Code hỗ trợ các tác nhân phụ, cho phép bạn ủy quyền một phần công việc cho các “bản sao” của tác nhân chính.
• Shrivu ưa thích kiến trúc “Chủ-Bản sao”: tác nhân chính tạo ra các bản sao thông qua Task(...), thay vì sử dụng các tác nhân phụ chuyên biệt cứng nhắc.
• Điều này giữ được sự linh hoạt đồng thời tránh sự phân mảnh ngữ cảnh.
• Tru cập các tác nhân phụ của Claude Code bằng lệnh slash: /agents.

6. Claude Skills so với MCP — Khác biệt là gì?

a. Claude Skills là các “mô-đun” được xây dựng sẵn dạy Claude cách thực hiện các tác vụ cụ thể. Chúng được viết bằng Markdown hoặc code, và chúng chỉ tải khi cần thiết. Bạn có thể sử dụng Skills để định nghĩa các quy trình làm việc như định dạng báo cáo, tóm tắt dữ liệu hoặc thực thi phong cách của nhóm bạn.

b. Mặt khác, Giao thức Ngữ cảnh Mô hình (MCP) là một giao thức để kết nối Claude với dữ liệu và công cụ bên ngoài — chẳng hạn như cơ sở dữ liệu, codebase của bạn hoặc các hệ thống kinh doanh. Nó giống như một “bộ điều hợp phổ quát” cho phép Claude truy cập và hành động trên các tài nguyên bên ngoài mà không cần tích hợp tùy chỉnh cho từng công cụ.

c. Những khác biệt chính:

1. Mục đích:

• Skills mã hóa kiến thức quy trình.
• MCP xử lý kết nối công cụ và dữ liệu.

2. Hiệu quả Token:

• Skills chỉ tải khi cần, sử dụng tương đối ít token.
• Các định nghĩa công cụ MCP có thể chiếm không gian token đáng kể nếu nhiều công cụ được bật.

d. Trường hợp sử dụng:

• Sử dụng Skills để dạy Claude các quy trình làm việc cụ thể theo miền (ví dụ: “khi viết báo cáo trạng thái, luôn bao gồm X, Y, Z”).
• Sử dụng MCP khi Claude cần đọc/ghi dữ liệu, gọi API hoặc truy cập các hệ thống bên ngoài như Git hoặc cơ sở dữ liệu.

Trong thực tế, hai yếu tố này hoạt động tốt nhất cùng nhau: MCP cung cấp cho Claude quyền truy cập vào dữ liệu của bạn, và Skills dạy Claude cách sử dụng dữ liệu đó theo một cách có cấu trúc, có thể lặp lại.

6. Hooks

a. Hooks là cách của bạn để tự động thực thi các quy tắc.

b. Hai loại phổ biến:

• Block-at-submit: Ví dụ, một hook PreToolUse có thể chặn git commit trừ khi các bài kiểm thử đã qua.
• Hint hooks: Không chặn; chúng cung cấp hướng dẫn hoặc gợi ý mà không dừng việc thực thi.

c. Tránh các hook “block-at-write” — để Claude hoàn thành kế hoạch của nó và sau đó xác thực sẽ ổn định hơn.

# Ví dụ Hook trong .claude/settings.toml

[[hooks]]
# Sự kiện kích hoạt hook.
event = "PostToolUse" 

# (Tùy chọn) Các điều kiện để hook chạy.
[hooks.matcher]
tool_name = "edit_file"
file_paths = ["*.py", "api/**/*.py"]

# Lệnh shell để thực thi.
command = "ruff check --fix $CLAUDE_FILE_PATHS && black $CLAUDE_FILE_PATHS"

# (Tùy chọn) Có chạy lệnh trong nền hay không.
run_in_background = false 

7. CLI SDK

• Claude Code SDK cho phép bạn viết script tương tác với Claude: hữu ích cho việc xử lý hàng loạt, xây dựng các công cụ nội bộ hoặc tạo mẫu tác nhân.
• Sử dụng nó để chạy các tái cấu trúc song song, tạo code từ các template hoặc làm một tác nhân nhẹ trong các quy trình CI/CD.

Cài đặt:

# Typescript:
npm install @anthropic-ai/claude-agent-sdk

# Python:
pip install claude-agent-sdk

8. Claude Code GitHub Actions (GHA)

• Bạn có thể tích hợp Claude Code trực tiếp vào GitHub Actions.
• Sử dụng nó để tự động tạo pull request, thực thi các tiêu chuẩn code hoặc chạy các kiểm tra dựa trên CLAUDE.md như một phần của pipeline CI của bạn.
• Vì nhật ký được lưu trữ, bạn có thể kiểm tra hành vi của tác nhân và cải thiện tệp CLAUDE.md của mình theo thời gian.

9. Cài đặt & Cấu hình

a. Trong settings.json, bạn có thể cấu hình:

• Proxy (HTTPS_PROXY) — hữu ích để gỡ lỗi lưu lượng CLI.
• Thời gian chờ (MCP_TOOL_TIMEOUT, BASH_MAX_TIMEOUT_MS) — tăng các giá trị này nếu bạn chạy các tác vụ dài.
• Khóa API (ANTHROPIC_API_KEY) — sử dụng khóa của bạn từ Anthropic hoặc một script trợ giúp.
• Quyền — kiểm soát các công cụ hệ thống mà Claude Code được phép thực thi.

{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test:*)",
      "Read(~/.zshrc)"
    ],
    "deny": [
      "Bash(curl:*)",
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ]
  },
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp"
  },
  "companyAnnouncements": [
    "Chào mừng đến với Acme Corp! Xem lại hướng dẫn về code của chúng tôi tại docs.acme.com",
    "Nhắc nhở: Yêu cầu xem xét code cho tất cả PR",
    "Chính sách bảo mật mới có hiệu lực"
  ]
}

Các Tính năng Nâng cao & Mẹo Năng suất

1. Chuyển đổi mô hình: Chọn Claude 4 Sonnet hoặc Opus tùy thuộc vào tác vụ của bạn. Sonnet nhanh và hiệu quả về chi phí; Opus có khả năng hơn cho các thay đổi phức tạp, đa tệp.
2. Chế độ suy nghĩ (Mẹo): Một số người dùng điều chỉnh chế độ suy luận của Claude thành think, think hard, think harder, hoặc ultrathink để điều chỉnh mức độ suy luận sâu sắc của nó.
3. Lệnh tùy chỉnh: Định nghĩa các lệnh slash có thể tái sử dụng trong .claude/commands với các trình giữ chỗ động ($argument). Tuyệt vời cho việc kiểm thử, xây dựng hoặc xem xét.
4. Lịch sử phiên: Sử dụng claude --resume hoặc claude --continue để tiếp tục các phiên cũ hơn. Claude lưu trữ tất cả lịch sử phiên cục bộ.
5. Vòng lặp phản hồi: Xem xét hành vi của tác nhân thông qua nhật ký GitHub Action hoặc dữ liệu phiên lịch sử và cập nhật CLAUDE.md của bạn để khắc phục những hiểu lầm hoặc thực thi các quy tắc bảo vệ tốt hơn.

Các Câu hỏi Thường Gặp (FAQ)

Q1. Mục đích của CLAUDE.md là gì?
Trả lời: CLAUDE.md hoạt động như tuyên ngôn của tác nhân. Nó định nghĩa các quy tắc, công cụ và quy ước để Claude Code tuân theo. Nó giúp chuẩn hóa hành vi trên toàn bộ kho lưu trữ của bạn.

Q2. Tôi nên sử dụng tác nhân phụ hay chỉ các tác vụ đơn giản?
Trả lời: Sử dụng tác nhân phụ nếu bạn muốn các quy trình làm việc mô-đun nghiêm ngặt. Nhưng nhiều người thấy mô hình Master-Clone (sử dụng Task(...)) linh hoạt hơn — bạn giữ ngữ cảnh trong khi ủy quyền các tác vụ phụ.

Q3. Làm cách nào để khởi động lại phiên Claude mà không mất mọi thứ?
Trả lời: Sử dụng /clear để đặt lại cuộc trò chuyện, và sau đó /catchup để tải các tệp từ nhánh Git của bạn để Claude có lại ngữ cảnh đầy đủ.

Q4. Hooks là gì, và tại sao tôi cần chúng?
Trả lời: Hooks thực thi các quy tắc hoặc kiểm tra khi Claude cam kết công việc. Ví dụ, một hook block-at-submit có thể đảm bảo các bài kiểm thử vượt qua trước khi Git commit được cho phép.

Q5. Làm thế nào tôi có thể tích hợp Claude Code vào CI/CD?
Trả lời: Sử dụng Claude Code GitHub Action để chạy các tác vụ, xác thực code, tạo pull request hoặc thực thi các quy tắc bảo vệ CLAUDE.md của bạn trong các pipeline tự động.

Kết luận

Bảng Gian lận Claude Code này cung cấp cho bạn một cái nhìn tổng quan thực tế, có cấu trúc về cách sử dụng Claude Code hiệu quả. Từ việc viết một tệp CLAUDE.md được soạn thảo tốt đến việc tận dụng các lệnh slash, tác nhân phụ, hooks và tích hợp CI — những mẫu này tạo thành một nền tảng vững chắc để sử dụng Claude Code như một đối tác phát triển đáng tin cậy được hỗ trợ bởi AI.

Bằng cách nắm vững các tính năng này, các nhà phát triển mới có thể nhanh chóng hòa nhập, và các kỹ sư giàu kinh nghiệm hơn có thể sắp xếp hợp lý quy trình làm việc, thực thi các quy tắc bảo vệ và tăng cường năng suất với sự hỗ trợ của Claude. Claude Code không chỉ là một công cụ tạo code — nó là một hệ thống tác nhân, có thể lập trình, thích ứng với nhu cầu của nhóm bạn.