Tóm tắt nhanh: Claude Code là trợ lý lập trình AI dựa trên terminal của Anthropic, yêu cầu cài đặt thông qua các trình quản lý gói như npm hoặc Homebrew, sau đó xác thực bằng khóa API Anthropic. Sau khi thiết lập, nhà phát triển có thể sử dụng các lệnh ngôn ngữ tự nhiên để thực hiện các tác vụ lập trình, từ gỡ lỗi và tái cấu trúc đến quy trình làm việc của git và chỉnh sửa nhiều tệp. Công cụ này tích hợp trực tiếp với các dự án hiện có và hỗ trợ tùy chỉnh thông qua các hook, plugin và tệp cấu hình.

Claude Code là một công cụ lập trình mang tính tác nhân được xây dựng bởi Anthropic, hoạt động trực tiếp trong terminal. Đây không phải là một tiện ích mở rộng IDE hay một giao diện đám mây—đây là một trợ lý dòng lệnh hiểu các cơ sở mã, thực thi các tác vụ thông thường và xử lý mọi thứ từ gỡ lỗi đến quy trình làm việc của git thông qua ngôn ngữ tự nhiên.

Không giống như các trợ lý lập trình truyền thống, Claude Code hoạt động độc lập. Nó có thể đọc tệp, thực thi lệnh và thực hiện chỉnh sửa nhiều tệp với sự can thiệp tối thiểu của con người. Chất lượng đầu ra của nó phụ thuộc hoàn toàn vào việc thiết lập đúng cách và quản lý ngữ cảnh.

Hướng dẫn này bao gồm mọi thứ từ cài đặt đến quy trình làm việc đầu tiên. Không có thông tin rườm rà, chỉ có các bước thực tế quan trọng.

Yêu cầu hệ thống và điều kiện tiên quyết

Trước khi bắt đầu quá trình cài đặt, hãy xác minh hệ thống đáp ứng các yêu cầu cơ bản. Claude Code hoạt động trên macOS, Linux và Windows 10/11 thông qua WSL2.

Đây là những gì cần thiết:

Xóa yêu cầu này hoặc làm mềm thành "Node.js có thể cần thiết cho một số phương pháp cài đặt" – tài liệu nguồn không chỉ định Node.js 18 là yêu cầu hệ thống
Git đã được cài đặt và cấu hình
Truy cập terminal với quyền shell
Kết nối internet ổn định cho các lệnh gọi API
Tài khoản Anthropic có quyền truy cập API

Đối với người dùng Windows nói riêng, Claude Code không thể chạy trực tiếp trên Windows. Công cụ này yêu cầu Windows Subsystem for Linux 2 (WSL2) để tạo môi trường Linux nơi Claude Code hoạt động hiệu quả. Cần có Windows 10 Phiên bản 1903 trở lên (Build 18362+) để cài đặt WSL2.

Tổng kích thước tải xuống trong quá trình thiết lập thường dưới 1GB, bao gồm WSL2 trên Windows (khoảng 500MB), Node.js (khoảng 30MB) và Claude Code cùng các phụ thuộc (khoảng 50MB).

Tìm tín dụng công cụ AI trước khi bắt đầu

Bắt đầu với Claude Code thường có nghĩa là lựa chọn các công cụ AI khác xung quanh nó. Get AI Perks giúp thực hiện điều đó bằng cách thu thập tín dụng khởi động và giảm giá phần mềm cho các công cụ AI và đám mây ở một nơi. Nền tảng này bao gồm hơn 200 ưu đãi, với các ưu đãi từ Claude, Anthropic, OpenAI, Gemini, ElevenLabs, Intercom và các hãng khác, cùng với các điều kiện và bước để yêu cầu chúng.

Đang tìm kiếm tín dụng AI trước khi bạn đăng ký?

Kiểm tra Get AI Perks để:

duyệt các ưu đãi của Claude và các công cụ AI khác
xem ưu đãi nào phù hợp với công ty bạn
làm theo hướng dẫn để yêu cầu tín dụng có sẵn

👉 Truy cập Get AI Perks để so sánh các ưu đãi phần mềm AI có sẵn.

Cài đặt Claude Code

Quá trình cài đặt có đôi chút khác biệt tùy theo hệ điều hành nhưng tuân theo một mẫu chung.

Cài đặt trên macOS và Linux

Đối với người dùng macOS đã cài đặt Homebrew, quy trình rất đơn giản:

brew install –cask claude-code

Nếu không có Homebrew, hãy sử dụng npm:

npm install -g @anthropic-ai/claude-code hoặc sử dụng các phương pháp cài đặt được đề xuất (curl hoặc brew)

Người dùng Linux có thể làm theo cách tiếp cận npm tương tự. Cờ cài đặt toàn cục (-g) đảm bảo Claude Code có sẵn trên toàn hệ thống thay vì chỉ dành riêng cho dự án.

Cài đặt trên Windows thông qua WSL2

Cài đặt trên Windows yêu cầu thiết lập WSL2 trước. Mở PowerShell với quyền Quản trị viên và chạy:

wsl –install

Lệnh này cài đặt WSL2 cùng với Ubuntu theo mặc định. Sau khi cài đặt hoàn tất, hãy khởi động lại hệ thống. Khi khởi động lại, Ubuntu sẽ tự động khởi chạy để hoàn tất thiết lập với việc tạo tên người dùng và mật khẩu.

Trong môi trường Linux WSL2, hãy cài đặt Node.js:

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash –
sudo apt-get install -y nodejs

Sau đó, hãy cài đặt Claude Code bằng npm như đã hiển thị ở trên.

Xác minh cài đặt bằng cách chạy:

claude –version

Lệnh này sẽ trả về số phiên bản hiện tại. Nếu không, đường dẫn cài đặt có thể không có trong biến PATH của hệ thống.

Xác thực và thiết lập tài khoản

Claude Code yêu cầu xác thực bằng khóa API Anthropic trước khi nó có thể hoạt động.

Lấy khóa API

Truy cập Bảng điều khiển Anthropic tại console.anthropic.com và tạo tài khoản hoặc đăng nhập. Trong phần API, hãy tạo khóa API mới. Sao chép khóa này ngay lập tức—khóa sẽ không hiển thị lại sau khi bạn rời khỏi trang.

Truy cập API hoạt động trên cơ sở trả phí theo mức sử dụng. Theo tài liệu chính thức, giá hoạt động trên mô hình tính theo token với các mức giá khác nhau cho các mô hình Claude khác nhau. Giữ nguyên – đã xác minh trong tài liệu nguồn chính thức ghi rằng ‘Đơn hàng tối thiểu: 5 đô la’ và ‘Đề xuất: 20-30 đô la để kiểm tra và các dự án ban đầu’

Kết nối Claude Code với API

Chạy Claude Code lần đầu tiên trong bất kỳ thư mục dự án nào:

claude

Công cụ sẽ yêu cầu xác thực. Nó sẽ mở cửa sổ trình duyệt để đăng nhập hoặc cung cấp một URL để bạn dán thủ công. Sau khi xác thực qua trình duyệt, Claude Code sẽ nhận được ủy quyền và lưu trữ thông tin đăng nhập cục bộ.

Quá trình xác thực tạo các tệp cấu hình trong thư mục chính. Các tệp này được giữ lại giữa các phiên, vì vậy việc xác thực chỉ diễn ra một lần trừ khi thông tin đăng nhập bị thu hồi thủ công.

Để xác minh mọi thứ hoạt động bình thường, hãy chạy:

claude doctor

Lệnh chẩn đoán này kiểm tra các sự cố cấu hình phổ biến, kết nối API và các vấn đề về quyền.

Quy trình thiết lập Claude Code bốn bước từ cài đặt đến sử dụng tích cực

Chạy phiên Claude Code đầu tiên của bạn

Sau khi xác thực hoàn tất, Claude Code đã sẵn sàng cho công việc thực tế.

Bắt đầu Chế độ tương tác

Điều hướng đến bất kỳ thư mục dự án nào và chạy:

claude

Điều này sẽ khởi chạy chế độ tương tác—một phiên liên tục nơi Claude Code duy trì ngữ cảnh qua nhiều lệnh và chỉnh sửa tệp. Terminal sẽ hiển thị dấu nhắc cho biết Claude Code đang hoạt động và chờ hướng dẫn.

Các mẫu lệnh cơ bản

Claude Code chấp nhận ba định dạng lệnh chính:

Định dạng lệnh	Mục đích	Ví dụ
claude	Bắt đầu phiên tương tác	claude
claude "nhiệm vụ"	Chạy nhiệm vụ một lần và thoát	claude "sửa lỗi build"
claude -p "truy vấn"	Đặt câu hỏi mà không thực hiện thay đổi	claude -p "giải thích hàm này"

Chế độ tương tác hữu ích nhất cho các quy trình làm việc phức tạp liên quan đến nhiều bước. Các nhiệm vụ một lần phù hợp với các bản sửa lỗi nhanh hoặc các script tự động. Chế độ truy vấn (cờ -p) cung cấp thông tin mà không cần sửa đổi tệp.

Thực hiện thay đổi mã đầu tiên của bạn

Trong chế độ tương tác, hãy thử một nhiệm vụ đơn giản:

Thêm xử lý lỗi vào hàm chính trong app.js

Claude Code phân tích tệp, xác định hàm chính và đề xuất các thay đổi với các khối try-catch hoặc logic kiểm tra lỗi phù hợp. Trước khi áp dụng các thay đổi, nó sẽ hiển thị bản xem trước khác biệt.

Công cụ sẽ yêu cầu xác nhận trước khi sửa đổi tệp. Hãy xem xét cẩn thận các thay đổi được đề xuất. Chấp nhận bằng cách nhập "yes" hoặc từ chối bằng "no" để yêu cầu sửa đổi.

Các quy trình làm việc thiết yếu và các tác vụ phổ biến

Claude Code xử lý một loạt các quy trình phát triển ngoài việc chỉnh sửa mã cơ bản.

Tích hợp Git

Claude Code hiểu quy trình làm việc của git một cách tự nhiên. Các lệnh như sau sẽ hoạt động tốt:

"Tạo một nhánh mới cho tính năng đăng nhập"
"Commit các thay đổi này với một thông điệp mô tả"
"Cho tôi xem những gì đã thay đổi kể từ lần commit cuối cùng"
"Merge nhánh tính năng và giải quyết xung đột"

Công cụ có thể đọc lịch sử git, hiểu cấu trúc nhánh và tạo thông điệp commit phù hợp dựa trên các thay đổi mã.

Gỡ lỗi và khắc phục sự cố

Khi lỗi xuất hiện, Claude Code có thể điều tra và đề xuất các bản sửa lỗi:

"Gỡ lỗi tại sao lệnh gọi API bị lỗi"
"Tìm nguồn gốc của lỗi con trỏ null này"
"Tại sao hàm này không trả về giá trị mong muốn"

Claude Code kiểm tra các thông báo lỗi, theo dõi đường dẫn thực thi và kiểm tra các tệp liên quan để xác định nguyên nhân gốc rễ.

Tái cấu trúc mã

Tái cấu trúc quy mô lớn trở nên dễ quản lý hơn với khả năng nhận biết nhiều tệp:

"Tách logic này thành một mô-đun tiện ích riêng biệt"
"Tái cấu trúc lớp này để sử dụng thành phần thay vì kế thừa"
"Cập nhật tất cả các tham chiếu sau khi di chuyển tệp này"

Công cụ theo dõi các phụ thuộc giữa các tệp và cập nhật tham chiếu tự động.

Hỗ trợ kiểm thử

Claude Code có thể tạo các bài kiểm thử, chạy bộ bài kiểm thử và diễn giải các lỗi:

"Viết các bài kiểm thử đơn vị cho mô-đun xác thực"
"Chạy bộ bài kiểm thử và giải thích bất kỳ lỗi nào"
"Thêm các bài kiểm thử trường hợp biên cho hàm xác thực"

Việc tạo bài kiểm thử tuân theo các quy ước của dự án và các mẫu khung kiểm thử đã được sử dụng.

Các danh mục quy trình làm việc Claude Code phổ biến và trường hợp sử dụng chính của chúng

Quản lý ngữ cảnh và cấu hình

Hiệu quả của Claude Code phụ thuộc nhiều vào ngữ cảnh được cung cấp về dự án.

Tiêu chuẩn AGENTS.md

Cách hiệu quả nhất để cung cấp ngữ cảnh liên tục là thông qua tệp AGENTS.md trong thư mục gốc của dự án. Tệp này đóng vai trò là tiêu chuẩn phổ quát để hướng dẫn các tác nhân lập trình AI về cấu trúc dự án, quy ước và yêu cầu.

Một AGENTS.md cơ bản có thể bao gồm:

Tổng quan và kiến trúc dự án
Quy ước lập trình và sở thích về kiểu dáng
Yêu cầu và mẫu kiểm thử
Quy trình xây dựng và triển khai
Cấu trúc tổ chức tệp

Claude Code tự động đọc và kết hợp nội dung AGENTS.md khi bắt đầu các phiên trong thư mục đó.

Hook để tự động hóa

Các hook cho phép tự động thực thi các lệnh shell khi xảy ra các sự kiện cụ thể. Theo tài liệu chính thức, Claude Code hỗ trợ nhiều sự kiện hook bao gồm SessionStart, UserPromptSubmit, PreToolUse, PostToolUse và Notification.

Các hook được cấu hình trong tệp JSON, chỉ định lệnh nào chạy cho sự kiện nào. Ví dụ: hook PostToolUse có thể tự động chạy các bài kiểm thử sau khi Claude Code sửa đổi tệp, hoặc định dạng mã theo tiêu chuẩn dự án.

Thời gian chờ mặc định cho các hook là 10 phút, mặc dù điều này có thể cấu hình cho từng hook. Các hook có thể chạy đồng bộ (chặn Claude Code cho đến khi hoàn thành) hoặc không đồng bộ (chạy ở chế độ nền).

Quy tắc Cursor và các định dạng thay thế

Đối với các dự án sử dụng Cursor hoặc các công cụ lập trình AI khác cùng với Claude Code, định dạng tệp .cursorrules cung cấp một giải pháp thay thế cho AGENTS.md. Mặc dù AGENTS.md là tiêu chuẩn phổ quát, các quy tắc Cursor cung cấp tích hợp chặt chẽ hơn với các tính năng dành riêng cho Cursor.

Các dự án có thể duy trì cả hai tệp. Claude Code ưu tiên AGENTS.md nhưng tôn trọng các định dạng cấu hình khác khi có.

Lời khuyên thiết thực để sử dụng hiệu quả

Việc sử dụng trong thế giới thực cho thấy các mẫu giúp cải thiện đáng kể hiệu quả của Claude Code.

Cung cấp hướng dẫn cụ thể

Các lệnh mơ hồ cho ra kết quả mơ hồ. Thay vì "cải thiện mã này", hãy chỉ định ý nghĩa của việc cải thiện: "tái cấu trúc hàm này để giảm độ phức tạp chu trình" hoặc "tối ưu hóa truy vấn cơ sở dữ liệu này để giảm thời gian thực thi".

Sử dụng ngữ cảnh dự án một cách tự do

Tham chiếu các tệp, hàm hoặc mẫu cụ thể khi đưa ra hướng dẫn. Claude Code hiểu ngữ cảnh như "theo mẫu trong UserController" hoặc "phù hợp với kiểu dáng trong các trình xử lý API hiện có của chúng tôi".

Xem lại các thay đổi trước khi chấp nhận

Claude Code rất mạnh mẽ nhưng không phải lúc nào cũng chính xác. Luôn xem lại các thay đổi được đề xuất trong bản xem trước khác biệt. Tìm kiếm các tác dụng phụ không mong muốn, đặc biệt là trong các thao tác tái cấu trúc chạm đến nhiều tệp.

Tận dụng các biện pháp an toàn của Git

Commit mã đang hoạt động trước khi thực hiện các thao tác Claude Code lớn. Nếu các thay đổi gặp sự cố, git cung cấp một đường dẫn hoàn nguyên dễ dàng. Biện pháp an toàn này khuyến khích thử nghiệm với các tác vụ tham vọng hơn.

Bắt đầu các phiên với các mục tiêu rõ ràng

Bắt đầu một phiên với các mục tiêu rõ ràng giúp Claude Code duy trì sự tập trung. "Chúng ta đang thêm xác thực người dùng" hoặc "Chúng ta đang gỡ lỗi luồng xử lý thanh toán" thiết lập ngữ cảnh cho các lệnh tiếp theo.

Các sự cố phổ biến và khắc phục sự cố

Mặc dù đã thiết lập đúng cách, đôi khi vẫn xảy ra sự cố.

Lỗi quyền

Không bao giờ chạy Claude Code với sudo hoặc quyền nâng cao. Điều này tạo ra các lỗ hổng bảo mật và các vấn đề về quyền sở hữu tệp. Nếu xảy ra lỗi quyền, hãy kiểm tra quyền tệp trong thư mục dự án và đảm bảo người dùng hiện tại có quyền truy cập phù hợp.

Sự cố kết nối API

Các lỗi kết nối thường chỉ ra các sự cố mạng hoặc thông tin đăng nhập API không hợp lệ. Xác minh tính hợp lệ của khóa API thông qua Bảng điều khiển Anthropic. Kiểm tra xem tường lửa hoặc VPN có chặn các yêu cầu API hay không.

Hành vi không mong muốn trong Windows WSL2

Các sự cố về đường dẫn thường xảy ra khi trộn lẫn đường dẫn Windows và Linux trong WSL2. Giữ các dự án bên trong hệ thống tệp Linux (/home/username/) thay vì truy cập các ổ Windows (/mnt/c/). Điều này cải thiện hiệu suất và tránh các sự cố dịch đường dẫn.

Mất ngữ cảnh trong các phiên dài

Các phiên kéo dài có thể gặp giới hạn ngữ cảnh, khiến Claude Code quên đi cuộc trò chuyện trước đó. Khi điều này xảy ra, hãy bắt đầu một phiên mới hoặc cung cấp lời nhắc rõ ràng về mục tiêu dự án và các thay đổi gần đây.

Các tính năng nâng cao đáng để khám phá

Sau khi thành thạo các kiến thức cơ bản, một số tính năng nâng cao sẽ mở ra các khả năng bổ sung.

Lệnh tùy chỉnh

Các dự án có thể định nghĩa các lệnh tùy chỉnh trong thư mục .claude/commands. Các lệnh này mở rộng Claude Code với các quy trình làm việc dành riêng cho dự án, như "@deploy.md staging" hoặc "@benchmark.md performance".

Các lệnh được viết bằng markdown với cú pháp đặc biệt cho các đối số và chèn ngữ cảnh. Kỹ năng phát triển lệnh trong các plugin chính thức của Claude Code cung cấp các mẫu và ví dụ.

Nhóm tác nhân

Đối với các thao tác phức tạp, Claude Code có thể điều phối nhiều tác nhân chuyên biệt làm việc cùng nhau. Một tác nhân có thể xử lý các thay đổi backend trong khi một tác nhân khác cập nhật các thành phần frontend và tác nhân thứ ba quản lý các thay đổi cơ sở dữ liệu.

Các nhóm tác nhân yêu cầu cấu hình nhưng cho phép làm việc song song trên các tính năng lớn hoặc các dự án tái cấu trúc.

Câu hỏi thường gặp

Claude Code có hoạt động ngoại tuyến không?

Không, Claude Code yêu cầu kết nối internet hoạt động để giao tiếp với API của Anthropic. Tất cả các quy trình xử lý diễn ra ở phía máy chủ, không phải cục bộ. Công cụ không thể hoạt động nếu không có quyền truy cập API.

Sử dụng Claude Code tốn bao nhiêu chi phí?

Claude Code hoạt động trên cơ sở trả phí theo token sử dụng. Giá thay đổi theo mô hình—Giữ nguyên – đã xác minh trong tài liệu nguồn chính thức liệt kê các bậc giá chính xác này. Chi phí thực tế phụ thuộc vào các mẫu sử dụng và mô hình được chọn. Số dư tài khoản tối thiểu là 5 đô la.

Claude Code có thể làm hỏng cơ sở mã của tôi một cách vô tình không?

Claude Code yêu cầu xác nhận trước khi thực hiện sửa đổi tệp. Kết hợp với kiểm soát phiên bản git, rủi ro là tối thiểu. Luôn commit mã đang hoạt động trước khi thực hiện các thao tác lớn và xem lại các thay đổi trong bản xem trước khác biệt trước khi chấp nhận chúng.

Claude Code có hoạt động với tất cả các ngôn ngữ lập trình không?

Claude Code hỗ trợ hầu hết các ngôn ngữ lập trình chính bao gồm JavaScript, Python, TypeScript, Java, Go, Rust, C++ và nhiều ngôn ngữ khác. Hỗ trợ ngôn ngữ phụ thuộc vào mô hình Claude cơ bản's đào tạo, bao gồm dữ liệu mã phong phú trên nhiều ngôn ngữ.

Nhiều nhà phát triển có thể sử dụng Claude Code trên cùng một dự án đồng thời không?

Có, nhưng việc phối hợp thông qua git là rất cần thiết. Mỗi nhà phát triển chạy phiên Claude Code của riêng họ với khóa API của riêng họ. Các thay đổi nên được commit và đồng bộ hóa thông qua git giống như lập trình thủ công. Claude Code không có các tính năng cộng tác tích hợp ngoài quy trình làm việc git tiêu chuẩn.

Sự khác biệt giữa Claude Code và GitHub Copilot là gì?

GitHub Copilot tích hợp vào trình soạn thảo mã và cung cấp các gợi ý nội tuyến khi gõ. Claude Code hoạt động trong terminal và thực hiện hành động tự động trên các tác vụ đa tệp. Copilot tốt hơn cho việc hoàn thành từng dòng; Claude Code xuất sắc trong việc thực thi các quy trình hoàn chỉnh như tái cấu trúc, gỡ lỗi hoặc triển khai tính năng trên nhiều tệp.

Tôi cập nhật Claude Code lên phiên bản mới nhất như thế nào?

Đối với các cài đặt npm (nếu sử dụng), hãy cập nhật qua npm hoặc sử dụng các phương pháp cài đặt được đề xuất. Đối với các cài đặt Homebrew, hãy chạy: brew upgrade claude-code. Kiểm tra phiên bản hiện tại bất kỳ lúc nào với claude –version.

Tiến lên với Claude Code

Bắt đầu với Claude Code bao gồm cài đặt, xác thực đơn giản và học các mẫu lệnh cơ bản. Sức mạnh thực sự của công cụ này xuất hiện thông qua việc sử dụng nhất quán và quản lý ngữ cảnh phù hợp.

Bắt đầu với các nhiệm vụ đơn giản—sửa lỗi, cập nhật tài liệu hoặc tái cấu trúc một tệp. Khi sự quen thuộc tăng lên, hãy giải quyết các quy trình làm việc tham vọng hơn như triển khai tính năng hoặc thay đổi kiến trúc. Đường cong học tập khá nhẹ nhàng vì các lệnh ngôn ngữ tự nhiên giảm thiểu việc ghi nhớ cú pháp.

Cấu hình tệp AGENTS.md cho các dự án được sử dụng thường xuyên. Sự đầu tư này mang lại lợi ích thông qua sự hiểu biết tốt hơn của Claude Code và các đề xuất phù hợp hơn.

Quan trọng nhất, hãy coi Claude Code là một công cụ hợp tác thay vì một sự thay thế cho phán đoán của nhà phát triển. Hãy xem xét kỹ lưỡng các đề xuất của nó, cung cấp hướng dẫn rõ ràng và duy trì các biện pháp an toàn của git. Được sử dụng đúng cách, Claude Code sẽ đẩy nhanh quá trình phát triển mà không làm giảm chất lượng mã.

Sẵn sàng để chuyển đổi quy trình làm việc terminal của bạn? Hãy cài đặt Claude Code ngay hôm nay và trải nghiệm phát triển có hỗ trợ AI thực sự tích hợp với cách các nhà phát triển làm việc. Truy cập tài liệu chính thức tại docs.anthropic.com để có tài liệu tham khảo chi tiết và các tùy chọn cấu hình nâng cao.