Claude Code 2.1: Hướng dẫn với các ví dụ thực tiễn

Claude Code là một công cụ lập trình tác tử do Anthropic phát triển, chạy trực tiếp trong terminal của bạn và cũng có thể hoạt động thông qua giao diện web được kết nối. Thay vì làm việc với các lời nhắc rời rạc, Claude Code hiểu toàn bộ kho mã, có thể suy luận xuyên suốt các tệp, chỉnh sửa mã và chạy công cụ. 

So với các phiên bản trước chủ yếu tập trung vào hỗ trợ mã tương tác, Claude Code 2.1 bổ sung hỗ trợ cho tác tử, hooks và kỹ năng dùng lại, có thể chủ động định hình cách thức và thời điểm diễn ra thay đổi mã.

Claude Code được thiết kế cho các nhà phát triển muốn có trợ lý AI nhúng trực tiếp vào quy trình làm việc thực tế, thay vì phải chuyển qua lại giữa trình soạn thảo và giao diện chat. Mặc dù vẫn đang ở giai đoạn xem trước nghiên cứu, công cụ này đã cho thấy tính hữu dụng cao trong các quy trình phát triển thực tế. 

Nếu bạn muốn tìm hiểu thêm về các mô hình Claude, tôi khuyến nghị khóa học Giới thiệu về các mô hình Claude. Bạn cũng có thể xem hướng dẫn Claude Cowork của chúng tôi.  

Có gì mới trong Claude Code 2.1?

Claude Code 2.1 xây dựng dựa trên trải nghiệm terminal cốt lõi bằng cách giới thiệu một loạt nâng cấp giúp quy trình do tác tử điều khiển linh hoạt hơn. Những thay đổi này mở rộng cách Claude Code suy luận về một codebase và cách các nhà phát triển tương tác với nó trong các tác vụ phát triển thực tế.

Một số bổ sung đáng chú ý nhất trong Claude Code 2.1 bao gồm:

• Hook cho tác tử và kỹ năng trong frontmatter, cho phép nhà phát triển áp dụng các kiểm tra và ràng buộc trước khi bất kỳ chỉnh sửa mã nào được áp dụng.
• Mở rộng hỗ trợ kỹ năng với ngữ cảnh forked, tải nóng và định nghĩa kỹ năng tùy chỉnh, giúp quy trình dùng lại linh hoạt và mạnh hơn.
• Gọi kỹ năng bằng dấu gạch chéo (/) cho phép truy cập nhanh vào các hành động thường dùng trong phiên tương tác.
• Các tác tử trong Claude Code 2.1 không còn dừng suy luận khi một lần gọi công cụ bị từ chối, cho phép quy trình tiếp tục không bị gián đoạn.
• Công cụ hỗ trợ phản hồi được kiểm soát theo ngôn ngữ, đặc biệt hữu ích cho tài liệu đa ngôn ngữ, đánh giá và cộng tác nhóm.
• Quyền công cụ theo wildcard, như Bash(*-h*), cung cấp điều khiển tự động hóa chi tiết hơn.
• CLI hiện hỗ trợ Shift+Enter để nhập nhiều dòng, cải thiện trải nghiệm soạn thảo tương tác mà không cần thiết lập bổ sung.

Trong hướng dẫn này, chúng tôi tập trung vào một loạt thử nghiệm thực tiễn minh họa cách các khả năng mới này được áp dụng trong các dự án thực tế.

Thiết lập trải nghiệm web dựa trên đám mây của Claude Code

Claude Code 2.1 có sẵn dưới dạng trải nghiệm web chạy hoàn toàn trên đám mây. Chế độ này đặc biệt hữu ích cho quy trình cộng tác, đánh giá pull request và tự động hóa ở cấp độ kho mã mà không cần thiết lập cục bộ.

Bước 1: Đăng nhập và truy cập Claude Code

Để bắt đầu, truy cập https://claude.ai/code, bạn sẽ vào giao diện Claude Code (Bản xem trước nghiên cứu). 

Bước 2: Kết nối Claude Code với GitHub

Để làm việc với các kho thực, Claude Code cần truy cập GitHub. Nhấp vào Connect to GitHub để cài đặt Ứng dụng Claude GitHub. 

Trong quá trình ủy quyền, GitHub sẽ yêu cầu quyền kết nối tới các kho bằng cách:

• Xác minh danh tính GitHub của bạn
• Xem những kho nào Claude có thể truy cập
• Thao tác thay mặt bạn (ví dụ, tạo nhánh hoặc commit)

Bạn có thể lựa chọn giữa:

• Tất cả kho, hoặc
• Chỉ các kho được chọn (khuyến nghị để kiểm soát chặt chẽ hơn)

Các quyền điển hình bao gồm:

• Quyền đọc metadata của kho và các kiểm tra
• Quyền đọc và ghi đối với mã, issues, pull requests và workflows

Nhấp Install & Authorize, và bạn có thể sửa đổi hoặc thu hồi quyền truy cập sau này trực tiếp từ cài đặt ứng dụng của GitHub. Bước này là bắt buộc để Claude Code có thể đọc kho, mở pull request và đẩy commit khi làm việc trong môi trường web.

Bước 3: Tạo môi trường đám mây

Trước khi bắt đầu phiên đầu tiên, Claude Code sẽ nhắc bạn tạo một môi trường đám mây. Môi trường này kiểm soát quyền truy cập mạng và ranh giới thực thi của Claude.

Các tùy chọn có sẵn gồm:

• None: Không có truy cập internet, chủ yếu hữu ích cho bảo mật tối đa.
• Trusted (khuyến nghị): Cung cấp quyền truy cập vào các nguồn gói đã được xác minh.
• Full: Cài đặt này cung cấp quyền truy cập internet không hạn chế.

Với hầu hết trường hợp sử dụng, tùy chọn Trusted mang lại cân bằng tốt nhất giữa bảo mật và linh hoạt.

Bước 4: Bắt đầu một phiên web

Sau khi thiết lập xong, bạn được đưa đến trình soạn thảo web của Claude Code như ảnh chụp màn hình bên dưới.

Tại đây, bạn có thể:

• Chọn một kho và một nhánh
• Chạy refactor và review
• Tạo nhánh và commit mới
• Tiếp tục các phiên trước (nếu có)
• Chuyển đổi giữa các kho mà không cần thay đổi môi trường

Thiết lập trải nghiệm CLI dựa trên terminal của Claude Code

CLI là cách trực tiếp nhất để làm việc với Claude Code 2.1. Nó lý tưởng cho phát triển cục bộ, refactor từng bước và các tình huống bạn muốn kiểm soát chi tiết những gì Claude thực hiện trong kho của bạn.

Bước 1: Cài đặt

Claude Code có thể được cài đặt trực tiếp từ terminal bằng trình cài đặt theo nền tảng.

macOS, Linux, WSL:

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

Windows PowerShell:

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

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Khi cài đặt hoàn tất, bạn sẽ thấy thông báo xác nhận hiển thị phiên bản Claude Code kèm đường dẫn cài đặt. Để biết thêm tùy chọn thiết lập, bạn có thể tham khảo hướng dẫn thiết lập chính thức.

Bước 2: Bắt đầu

Sau khi cài đặt, điều hướng đến thư mục gốc của dự án và khởi động Claude Code:

cd your-project-directory
Claude Code

Khi Claude Code khởi động, nó sẽ lập tức quét kho và xây dựng hiểu biết ban đầu về codebase. 

Ngữ cảnh ban đầu này cho phép Claude Code suy luận hiệu quả hơn ở các bước sau.

Thử nghiệm với Claude Code 2.1

Trong bản demo này, tôi đã dùng một dự án từ GPT 5.2 của tôi. Dưới đây là tổng quan nhanh về dự án.

Khi Claude Code đã có quyền truy cập vào mọi tệp và thư mục trong thư mục, chúng ta có thể bắt đầu thử nghiệm.

Refactor bằng kỹ năng với ngữ cảnh forked 

Trong quá trình đánh giá Claude Code 2.1, tôi đã thực hiện một refactor trên toàn kho để nâng cấp pipeline. Thử nghiệm này làm nổi bật các kỹ năng với ngữ cảnh forked, nơi Claude có thể suy luận trên nhiều tệp thay vì thực hiện các chỉnh sửa đơn lẻ theo tệp.

Prompt:

Refactor the CSV parsing and slide generation logic across the repository.
Improve readability, split responsibilities, and avoid duplicated logic.

Đầu tiên Claude tạo một kế hoạch refactor chi tiết, bao gồm cấu trúc module đề xuất, các điểm trùng lặp và trình tự triển khai, sau đó xin phê duyệt trước khi thay đổi bất cứ điều gì. 

Khi bạn phê duyệt, Claude áp dụng refactor theo từng bước, hiển thị diff và tiến độ trong quá trình thực hiện.

Sử dụng Claude Code, tôi đạt được các cải tiến sau:

• Phân tách trách nhiệm theo module: Claude tách việc tải CSV, biến đổi, tạo Excel, tạo PowerPoint và lập kế hoạch LLM (về cơ bản là tất cả các module) thành các thành phần riêng.
• Giảm trùng lặp logic: Tập trung các tiện ích lặp lại (như phát hiện cột và định dạng) và di chuyển các hằng số dùng chung vào một lớp cấu hình chung.
• Cải thiện khả năng bảo trì: Claude cũng giảm kích thước của app.py trong khi vẫn giữ nguyên hành vi bên ngoài của ứng dụng.

Dưới đây là so sánh cấu trúc dự án và kết quả refactor trước và sau thay đổi.

Trước:

Sau:

Cuối cùng, tôi thử refactor tương tự trong Claude Code Web. Khác biệt chính là quy trình làm việc:

• CLI tiến hành từng bước với các phê duyệt rõ ràng.
• Web có thể đẩy thay đổi refactor trực tiếp lên một nhánh mới, thuận tiện cho cộng tác và quy trình dựa trên PR.

Cuối cùng, Claude đã refactor và đẩy mã lên một nhánh.

Hook xác thực trước khi chỉnh sửa

Các pipeline dữ liệu thường thất bại vì một lý do đơn giản: lược đồ CSV đầu vào không khớp với những gì mã mong đợi. Trong Claude Code 2.1, bạn có thể giảm loại lỗi này bằng cách sử dụng pre-edit hooks. Khả năng mới này cho phép một tác tử chạy các kiểm tra xác thực trước khi Claude được phép sửa mã.

Trong ví dụ này, tôi yêu cầu Claude Code tạo một tác tử xác thực cấu trúc CSV trước khi áp dụng bất kỳ chỉnh sửa nào.

Prompt:

Create a Claude Code agent that validates the CSV schema before modifying any code. The agent should reject edits if the CSV schema is unclear.

Claude Code trước tiên tạo một tác tử xác thực lược đồ CSV và tích hợp nó vào quy trình để nó có thể đóng vai trò "gác cổng". Đầu ra CLI cho thấy Claude không chỉ tạo một script đơn lẻ, mà lắp ghép một hệ thống xác thực nhỏ bao gồm:

• Module xác thực lược đồ cốt lõi kiểm tra các cột bắt buộc, giá trị thiếu và tính nhất quán cơ bản.
• Hook "gác cổng" trước khi chỉnh sửa chạy xác thực tự động trước khi các chỉnh sửa tiếp tục.
• Cuối cùng là bộ kiểm thử và một số ví dụ sử dụng để xác minh bộ xác thực trên các trường hợp CSV hợp lệ/không hợp lệ.

Trong thực tế, quy trình trở nên đơn giản:

• Claude tự động chạy kiểm tra lược đồ trước khi thực hiện bất kỳ thay đổi mã nào, áp đặt một điều kiện tiên quyết.
• Nếu lược đồ không rõ ràng hoặc không hợp lệ, tác tử sẽ chặn cứng việc chỉnh sửa và trả về thông báo lỗi có thể hành động để hướng dẫn cách khắc phục.
• Khi xác thực vượt qua, Claude tiếp tục sửa đổi, giữ cho thay đổi có hàng rào bảo vệ và dễ dự đoán.

Kết quả trên web cho thấy tương tự, nhưng có khác biệt quan trọng. Claude Code Web có thể đẩy thay đổi trực tiếp lên một nhánh mới, bao gồm module xác thực, tích hợp hook, tài liệu và kiểm thử. 

Tổng thể, Claude Code 2.1 áp dụng hàng rào bảo vệ trước khi chỉnh sửa bằng cách nhúng hook trực tiếp vào tác tử và kỹ năng. Điều này khiến các hook đặc biệt giá trị trong các dự án nặng dữ liệu, nơi tính đúng đắn của đầu vào thường là nguồn gốc lỗi lớn hơn cả bản thân mã.

Kỹ năng dạng slash-command cho tác vụ lặp lại

Claude Code 2.1 giới thiệu các kỹ năng dạng slash-command có thể tái sử dụng, là những quy trình tự chứa có thể được gọi tương tác trong một phiên Claude hoặc chạy trực tiếp từ dòng lệnh. 

Trong ví dụ này, chúng tôi tạo một kỹ năng dùng lại /generate-slides chuyển đổi một tệp CSV thành bản trình chiếu PowerPoint chuyên nghiệp.

Prompt:

Create a reusable skill called /generate-slides that converts a CSV into a PPT.

Mẹo: Sử dụng /statusline để cấu hình một dòng trạng thái tùy chỉnh hiển thị bên dưới lời nhắc nhập (hữu ích để hiển thị repo, nhánh hoặc chế độ).

Claude Code tạo một định nghĩa kỹ năng hoàn chỉnh trong .claude/skills/, bao gồm tài liệu, logic xác thực và một entry point Python có thể chạy.

• Tạo kỹ năng: Claude viết một kỹ năng generate-slides đầy đủ tài liệu, mô tả mục đích, đầu vào, bước xác thực và luồng thực thi.
• Xác thực lược đồ: Kỹ năng xác thực lược đồ CSV trước khi xử lý, đảm bảo chất lượng dữ liệu và thông báo lỗi rõ ràng.
• Thực thi: Kỹ năng có thể chạy trực tiếp từ terminal, hoạt động như một công cụ dòng lệnh độc lập.
• Xử lý lỗi: Thiếu tệp, lược đồ không hợp lệ hoặc thiếu khóa API sẽ dẫn đến lỗi rõ ràng, có thể hành động.
• Tự động hóa: Một lệnh duy nhất tạo ra artefact Excel, biểu đồ và một bộ slide PowerPoint.

Bạn có thể kiểm thử kỹ năng cục bộ bằng:

python .claude/skills/generate-slides.py --csv-file kpis.csv

Lưu ý: Hãy chắc chắn rằng bạn đã thêm khóa API trước khi chạy. 

Các kỹ năng dạng slash-command biến Claude Code thành một động cơ quy trình, không chỉ là một trợ lý. Thay vì lặp lại lời nhắc cho cùng một tác vụ, bạn định nghĩa một lần và dùng lại trên nhiều dự án, phiên và môi trường. Bạn có thể quan sát cấu trúc kho đã cập nhật bên dưới, phản ánh việc bổ sung kỹ năng mới.

Ví dụ này cho thấy cách:

• Kỹ năng có thể được gọi tương tác từ CLI.
• Các kỹ năng do Claude tạo tích hợp gọn gàng với codebase hiện có.

Các tác tử con bất đồng bộ và chạy nền

Một trong những điểm gây khó chịu lớn nhất ở các công cụ lập trình AI là "thời gian chờ"; nhìn con trỏ nhấp nháy trong khi AI suy nghĩ hoặc chạy một bộ kiểm thử dài. Claude Code 2.1 giải quyết điều này với Các tác tử con bất đồng bộ.

Giờ đây bạn có thể đẩy các tác vụ chạy lâu—như một refactor phức tạp, một lần chạy kiểm thử, hoặc một lượt quét tài liệu—vào nền bằng Ctrl+B. Điều này giải phóng terminal của bạn ngay lập tức, cho phép bạn:

• Tiếp tục truy vấn codebase.
• Xếp hàng một tác vụ song song thứ hai.
• Xem xét tệp thủ công trong khi Claude làm việc.

Ví dụ, trong khi Claude đang refactor module app.py (có thể mất vài phút để lập kế hoạch và thực thi), bạn có thể nhấn Ctrl+B và ngay lập tức hỏi: "Trong khi tiến trình đó chạy, hãy giải thích logic xác thực trong auth.py."

Khi tác vụ nền hoàn tất, Claude sẽ thông báo cho bạn, và bạn có thể hợp nhất ngữ cảnh trở lại luồng chính. Điều này biến Claude Code từ một giao diện chat đơn luồng thành một đối tác phát triển đa luồng, phản chiếu cách các kỹ sư cấp cao thực sự làm việc.

Đầu ra kiểm soát theo ngôn ngữ 

Claude Code 2.1 có thể được cấu hình để phản hồi bằng một ngôn ngữ cụ thể, hữu ích cho các nhóm đa ngôn ngữ, tài liệu bản địa hóa và các phần hướng dẫn mã không dùng tiếng Anh. Trong ví dụ này, chúng tôi yêu cầu Claude giải thích pipeline tạo slide của kho hoàn toàn bằng tiếng Nhật.

Prompt:

Explain the slide generation logic in Japanese.

Claude phản hồi bằng tiếng Nhật và tạo ra một phần giải thích có cấu trúc về luồng từ đầu đến cuối. Như thể hiện trong đầu ra, công cụ không chỉ dịch một bản tóm tắt mà còn ánh xạ pipeline thành các giai đoạn rõ ràng và tham chiếu các module liên quan trong mỗi bước. Đầu ra CLI cho thấy:

• Tiếng Nhật xuyên suốt: Phản hồi duy trì bằng tiếng Nhật từ đầu đến cuối, bao gồm tiêu đề và gạch đầu dòng.
• Luồng từng bước: Claude chia pipeline thành các giai đoạn riêng biệt (xác thực CSV, xử lý dữ liệu, sổ làm việc Excel, lập kế hoạch LLM và tạo slide).
• Tham chiếu theo codebase: Công cụ chỉ ra các tệp và thư mục liên quan trong khi giải thích từng thành phần làm gì.
• Định dạng phong cách tài liệu: Đầu ra đọc như tài liệu nội bộ, dễ tái sử dụng trong README hoặc tài liệu onboarding.

Lưu ý: Tôi chỉ kiểm thử hành vi này trong CLI cho ví dụ này, nhưng khả năng kiểm soát ngôn ngữ tương tự là một phần của Claude Code 2.1 nói chung.

Đây là một tính năng nhỏ trên giấy tờ, nhưng trên thực tế, là một bước nhảy năng suất lớn khi tài liệu và đánh giá cần diễn ra bằng ngôn ngữ khác tiếng Anh.

Các lệnh Claude Code 2.1

Dưới đây là một vài lệnh để bạn thử với Claude Code.

Kết luận

Trong hướng dẫn này, chúng tôi đã khám phá Claude Code 2.1 bằng cách chạy các thử nghiệm thực hành trên cả quy trình CLI và web. Chúng tôi dùng Claude Code để refactor một kho hiện có bằng kỹ năng ngữ cảnh forked, áp dụng đảm bảo dữ liệu với hook xác thực trước khi chỉnh sửa, tạo kỹ năng slash-command dùng lại và tạo các phần giải thích được kiểm soát ngôn ngữ trực tiếp từ codebase.

Những ví dụ này cho thấy Claude Code 2.1 vượt ra ngoài việc chỉnh sửa với AI đơn thuần để hướng tới quy trình phát triển do tác tử điều khiển. Dù vẫn đang ở giai đoạn xem trước nghiên cứu, Claude Code 2.1 đã thể hiện giá trị thực tiễn mạnh mẽ trong các dự án thực.