Cách thiết lập một dự án Claude Code mới

Thiết lập một dự án code mới trong Claude không khó. Dưới đây là hướng dẫn chi tiết cách thiết lập dự án trong Claude Code.

Hầu hết hướng dẫn cài đặt Claude Code vẫn khuyên người dùng chạy lệnh `npm install`. Tuy nhiên, phương pháp đó đã lỗi thời. Trình cài đặt gốc không yêu cầu Node.js, và công việc thiết lập thực sự bắt đầu sau khi cài đặt. Cấu hình CLAUDE.md, các kỹ năng và máy chủ MCP sẽ biến một trợ lý AI thông thường thành "tri kỷ" hiểu rõ mã nguồn của bạn.

Sự khác biệt giữa thiết lập mặc định và thiết lập được cấu hình đúng cách trong Claude là rất lớn. Với một tệp CLAUDE.md tốt và một vài máy chủ MCP, Claude sẽ ngừng đoán về dự án và bắt đầu đưa ra các câu trả lời phù hợp với mã nguồn của bạn. Quá trình thiết lập đó chỉ mất 15-20 phút. Hướng dẫn Claude Code này sẽ bao gồm từ cài đặt đến phiên làm việc hiệu quả đầu tiên.

Cách cài đặt Claude Code

Cài đặt Claude Code bằng trình cài đặt gốc. Chạy curl -fsSL <https://claude.ai/install.sh> | bash trên macOS hoặc Linux, hoặc irm <https://claude.ai/install.ps1> | iex trên Windows PowerShell. Phương pháp npm không còn được khuyến khích sử dụng. Không còn cần Node.js. Sau khi cài đặt, chạy claude --version để xác minh, sau đó mở claude trong thư mục dự án bất kỳ để xác nhận cài đặt.

Quá trình cài đặt mất khoảng hai phút trên mọi nền tảng:

1. Chạy trình cài đặt gốc cho hệ điều hành của bạn:
2. Xác minh cài đặt:
3. Xác thực khi khởi chạy lần đầu bằng cách chạy lệnh Claude trong bất kỳ thư mục nào. Một cửa sổ trình duyệt sẽ mở ra để đăng nhập OAuth với gói đăng ký Claude Pro, Max, Team hoặc Enterprise của bạn.

Lưu ý dành cho người dùng Windows: cả WSL và PowerShell gốc đều hoạt động với Claude Code. Nếu bạn đang sử dụng các bộ công cụ dựa trên Linux, WSL là lựa chọn tốt hơn vì nó hỗ trợ đầy đủ tính năng cách ly công cụ Bash. Windows gốc cần Git Bash.

Cách dùng Claude Code cho người mới bắt đầu

Hãy bắt đầu phiên làm việc Claude Code đầu tiên bằng cách điều hướng đến thư mục dự án và chạy lệnh `claude`. Sử dụng lệnh `/init` để tạo tệp CLAUDE.md ban đầu, sau đó khám phá mã nguồn của bạn trước khi viết bất kỳ mã nào. Hãy làm theo quy trình Khám phá, Lập kế hoạch, Thực hiện, Cam kết. Luôn yêu cầu Claude mô tả cách tiếp cận của nó và chờ sự chấp thuận của bạn trước khi nó bắt đầu thực hiện các thay đổi.

Một phiên làm việc hiệu quả sẽ tuân theo mô hình này:

1. Điều hướng đến dự án của bạn và bắt đầu một phiên làm việc:
2. **Run **/init để tạo tệp CLAUDE.md. Claude sẽ quét cấu trúc dự án của bạn, xác định loại tệp và tạo cấu hình ban đầu.
3. Khám phá trước khi viết mã. Yêu cầu Claude giải thích mã nguồn, tóm tắt kiến ​​trúc hoặc xác định các mẫu. Điều này giúp nó hiểu rõ hơn về dự án của bạn.
4. Sử dụng chế độ lập kế hoạch (Shift+Tab) để xem trước các thay đổi được đề xuất trước khi Claude thực hiện chúng. Đây là "lưới an toàn" của bạn để xem xét những gì Claude dự định làm.
5. Tài liệu về các phương pháp tốt nhất của Anthropic khuyến nghị quy trình Khám phá, Lập kế hoạch, Thực hiện, Cam kết. Hãy tránh việc nhảy thẳng đến bước "build me a feature" - xây dựng tính năng. Hãy để Claude hiểu rõ dự án của bạn trước, đề xuất kế hoạch, sau đó mới bắt đầu thực hiện.

Các lệnh cần biết ngay từ đầu:

• /help -- hiển thị tất cả các lệnh có sẵn
• /clear -- bắt đầu lại cuộc hội thoại mà không làm mất ngữ cảnh CLAUDE.md
• /compact -- nén cuộc hội thoại để giải phóng không gian cửa sổ ngữ cảnh
• /config -- mở cài đặt của bạn

File CLAUDE.md nên bao gồm những gì?

File CLAUDE.md nên bao gồm tóm tắt dự án (một đoạn văn), các công nghệ bạn sử dụng, các lệnhbuild/test/lint, và các quy ước lập trình quan trọng, tất cả trong vòng 60 đến 80 dòng. Sử dụng khung WHY/WHAT/HOW: giải thích lý do dự án tồn tại, chức năng của nó và cách làm việc với nó. Hoàn toàn không đưa các quy tắc về kiểu mã vào CLAUDE.md và thay vào đó hãy dựa vào công cụ kiểm tra cú pháp và định dạng mã.

CLAUDE.md là bộ nhớ liên tục. Claude đọc nó khi bắt đầu mỗi phiên làm việc, vì vậy mọi thứ trong tập tin này định hình cách Claude tương tác với mã của bạn. Việc thiết lập đúng tập tin này quan trọng hơn bất kỳ phần nào khác trong thiết lập Claude Code.

Khung WHY/WHAT/HOW cung cấp cho bạn một cấu trúc rõ ràng:

WHY: Dự án làm gì và giải quyết vấn đề gì
WHAT: Công nghệ sử dụng, các phụ thuộc, cấu trúc dự án
HOW: Các lệnh xây dựng, kiểm thử, kiểm tra mã và các bước xác minh

Một mẫu bao gồm các yếu tố thiết yếu:

# Project: MyApp

Một API quản lý nhiệm vụ được xây dựng bằng Node.js và Express.

## Tech stack
- Node.js 20, Express 4, TypeScript
- PostgreSQL with Prisma ORM
- Jest for testing

## Commands
- `npm run dev` - Start dev server (port 3000)
- `npm test` - Run all tests
- `npm run test:watch` - Watch mode
- `npm run lint` - ESLint check
- `npm run build` - Production build

## Conventions
- Use async/await over raw promises
- Named exports preferred over defaults
- Error responses follow RFC 7807 format

Đối với các dự án lớn hơn, hãy sử dụng `@imports` để tham chiếu các tài liệu bên ngoài. Một dòng trong CLAUDE.md như `@docs/api-conventions.md` cho Claude biết cần tải tệp đó khi nào. Các lệnh nhập có thể được nối chuỗi đến 5 cấp độ, vì vậy bạn sẽ có được thông tin hiển thị dần dần mà không làm quá tải tệp gốc của mình.

Thư mục `.claude/rules/` cho phép bạn tạo các quy tắc theo chủ đề, có tính mô-đun. Mỗi tệp `.md` trong thư mục này được tải dưới dạng bộ nhớ dự án. Bạn có thể giới hạn phạm vi các quy tắc cho các đường dẫn tệp cụ thể bằng cách sử dụng phần đầu YAML:

---
paths:
  - "src/api/**/*.ts"
---

# Quy tắc API 
- Tất cả endpoints phải bao gồm xác thực đầu vào
- Dùng định dạng phản hồi lỗi tiêu chuẩn

Tệp CLAUDE.local.md dùng để lưu trữ các thiết lập ghi đè cá nhân cho dự án. Nó được tự động thêm vào tệp .gitignore, vì vậy nhóm của bạn sẽ sử dụng chung một tệp CLAUDE.md trong khi mỗi nhà phát triển vẫn giữ các tùy chọn riêng của họ (URL sandbox, dữ liệu kiểm thử ưa thích, phím tắt cá nhân) trong tệp CLAUDE.local.md.

Claude cũng tự động quản lý bộ nhớ tại ~/.claude/projects/<project>/memory/, lưu lại các mẫu dự án, thông tin gỡ lỗi và các tùy chọn của bạn giữa các phiên làm việc. Bạn không cần phải cấu hình điều này. Nó diễn ra ngầm trong nền hệ thống.

Cách cấu hình lệnh skill và slash

Tạo các kỹ năng tùy chỉnh bằng cách thêm các tệp SKILL.md vào thư mục .claude/skills/ trong dự án của bạn. Mỗi tệp sử dụng YAML frontmatter để khai báo mô tả, các công cụ được cho phép và hành vi thực thi. Hệ thống kỹ năng thay thế phương pháp .claude/commands/ cũ hơn, mặc dù cả hai vẫn hoạt động. Ngoài các kỹ năng tùy chỉnh, hệ sinh thái plugin của Claude Code cung cấp hơn 1.300 kỹ năng do cộng đồng xây dựng mà bạn có thể sử dụng

Skill là cách bạn dạy Claude Code các quy trình làm việc có thể lặp lại. Một kỹ năng là một thư mục chứa tệp SKILL.md với YAML frontmatter và các hướng dẫn markdown.

Một kỹ năng sửa lỗi kiểm thử trông như thế này:

---
name: fix-tests
description: Phân tích và khắc phục các thử nghiệm lỗi trong dự án
allowed-tools: Read, Grep, Bash(npm test *)
---

Khi sửa lỗi các thử nghiệm:
1. Chạy bộ thử nghiệm để nhận diện lỗi
2. Đọc các tệp kiểm thử bị lỗi và mã mà chúng kiểm thử
3. Xác định xem lỗi nằm ở bài kiểm thử hay cách triển khai
4. Thực hiện các thay đổi tối thiểu để khắc phục sự cố
5. Chạy lại các bài kiểm thử để xác minh việc khắc phục

Tập trung vào: $ARGUMENTS

Hãy gọi lệnh /fix-tests src/features/auth/ và Claude sẽ chạy toàn bộ quy trình.

Claude tải các kỹ năng một cách tuần tự. Nó chỉ đọc tên và mô tả khi bắt đầu phiên, sau đó tải toàn bộ nội dung kỹ năng khi bạn gọi nó hoặc khi Claude xác định nó có liên quan. Điều này giúp cửa sổ ngữ cảnh của bạn gọn nhẹ.

Hệ sinh thái plugin hiện đã có hơn 1.300 kỹ năng do cộng đồng xây dựng trên các kho lưu trữ như Claude Code Plugins và Claude Plugins Directory. Bạn sẽ tìm thấy các plugin để tra cứu tài liệu, tự động hóa trình duyệt, phân tích mã và kiểm tra cú pháp. Hãy xem xét những gì có sẵn và cài đặt plugin phù hợp với hệ thống của bạn.