Cách Thiết Lập Claude Code: Hướng Dẫn Hoàn Chỉnh 2026

Tóm tắt nhanh: Claude Code là một trợ lý lập trình AI dựa trên terminal chạy gốc trên macOS và Linux, hoặc trên Windows thông qua WSL2. Thiết lập yêu cầu tạo khóa API Anthropic, chạy trình cài đặt dành riêng cho nền tảng, xác thực bằng khóa và xác minh cài đặt bằng lệnh kiểm tra. 

Claude Code đại diện cho trợ lý lập trình chính thức của Anthropic dựa trên terminal. Nó hoạt động trực tiếp trong dòng lệnh và xử lý mọi thứ từ tạo mã đến sửa lỗi thông qua các lệnh ngôn ngữ tự nhiên.

Tuy nhiên, quá trình thiết lập không phải lúc nào cũng đơn giản. Người dùng Windows cần WSL2. Xác thực API có thể làm khó người mới. Xung đột phiên bản xảy ra.

Hướng dẫn này sẽ đi qua quy trình thiết lập hoàn chỉnh cho tất cả các nền tảng, từ yêu cầu hệ thống đến buổi lập trình đầu tiên của bạn.

Claude Code Thực sự là gì

Claude Code là một ứng dụng terminal agentic tích hợp với môi trường phát triển. Nó hiểu các cơ sở mã, thực hiện các tác vụ thông thường và quản lý quy trình làm việc git thông qua các lệnh đàm thoại.

Không giống như các công cụ dựa trên trình duyệt, Claude Code chạy cục bộ trong terminal. Nó truy cập trực tiếp vào các tệp dự án, duy trì ngữ cảnh giữa các phiên và tích hợp với quy trình làm việc phát triển hiện có. Theo tài liệu chính thức của Claude Code, công cụ này kết nối với API của Anthropic và hỗ trợ tích hợp với Amazon Bedrock, Google Cloud Vertex AI và Azure AI.

Công cụ hoạt động khác với các trợ lý lập trình truyền thống. Nói thẳng ra: nó giống như có một lập trình viên cặp trong terminal của bạn hơn là một công cụ hoàn thành mã.

Yêu cầu hệ thống cho Claude Code

Trước khi cài đặt, hệ thống cần đáp ứng các yêu cầu cụ thể. Đây là những gì mỗi nền tảng cần:

Tất cả các nền tảng đều cần kết nối internet ổn định cho các lệnh gọi API. Claude Code tải xuống thường yêu cầu khoảng 50MB, với WSL2 trên Windows bổ sung khoảng 500MB cho hệ thống con Linux.

Về dung lượng lưu trữ, dự kiến ​​ít nhất 4GB dung lượng trống. Bản thân ứng dụng nhỏ, nhưng không gian cho các phụ thuộc và tệp dự án là quan trọng.

Yêu cầu dành riêng cho Windows

Claude Code có thể chạy trên Windows qua PowerShell hoặc Command Prompt nếu Node.js được cài đặt. Công cụ yêu cầu Windows Subsystem for Linux 2 để tạo môi trường Linux.

Theo các hướng dẫn cài đặt từ claude.ai, hệ thống Windows 10 cần Phiên bản 1903 trở lên với Build 19041 trở lên. Người dùng Windows 11 đã tích hợp sẵn hỗ trợ WSL2. Cần có quyền quản trị viên để thiết lập WSL2 ban đầu.

Quá trình này bao gồm việc bật ảo hóa trong BIOS, kích hoạt các tính năng của Windows và cài đặt bản phân phối Linux. Ubuntu 22.04 LTS là bản phân phối được khuyến nghị để đảm bảo khả năng tương thích.

Cài đặt Claude Code: Quy trình từng bước

Quy trình cài đặt khác nhau tùy theo nền tảng. Đây là cách để chạy Claude Code trên mỗi hệ điều hành.

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

Việc cài đặt macOS và Linux tuân theo cùng một quy trình. Cả hai nền tảng đều hỗ trợ cài đặt gốc mà không cần thiết lập bổ sung.

Quá trình bắt đầu bằng việc tải xuống trình cài đặt. Mở một terminal và chạy:

curl -fsSL claude.ai/install.sh | sh

Script sẽ phát hiện hệ điều hành, tải xuống tệp nhị phân phù hợp và cài đặt Claude Code vào thư mục bin cục bộ. Quá trình cài đặt thường hoàn tất trong vòng chưa đầy hai phút với kết nối ổn định.

Đối với các hệ thống không có curl, wget hoạt động như một giải pháp thay thế. Trình cài đặt sẽ tự động thêm Claude Code vào PATH của hệ thống.

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

Cài đặt trên Windows yêu cầu thiết lập WSL2 trước. Đây là quy trình đầy đủ:

Mở PowerShell với quyền Quản trị viên và bật WSL:

wsl –install

Lệnh này sẽ kích hoạt các tính năng cần thiết của Windows, tải xuống kernel WSL2 và cài đặt Ubuntu theo mặc định. Hệ thống sẽ yêu cầu khởi động lại. Sau khi khởi động lại, Ubuntu sẽ tự động khởi chạy để hoàn tất thiết lập người dùng.

Tạo tên người dùng và mật khẩu khi được nhắc. Các thông tin đăng nhập này dành cho môi trường Linux, tách biệt với thông tin đăng nhập Windows.

Khi WSL2 đang chạy, quy trình cài đặt Linux sẽ được áp dụng. Trong terminal Ubuntu, chạy lệnh curl từ phần macOS/Linux ở trên.

Trình cài đặt sẽ xử lý phần còn lại. Claude Code được cài đặt trong môi trường WSL2 và chạy thông qua terminal Ubuntu.

Lấy khóa API Anthropic

Claude Code yêu cầu khóa API Anthropic để xác thực. Khóa này kết nối cài đặt cục bộ với các máy chủ của Anthropic.

Truy cập Bảng điều khiển Anthropic tại console.anthropic.com. Tạo tài khoản hoặc đăng nhập bằng thông tin đăng nhập hiện có. Điều hướng đến Khóa API trong cài đặt tài khoản.

Nhấp vào "Tạo Khóa" để tạo khóa API mới. Khóa chỉ xuất hiện một lần—sao chép nó ngay lập tức. Anthropic sẽ không hiển thị lại khóa đầy đủ sau khi bạn rời khỏi trang.

Lưu trữ khóa một cách an toàn. Nó cung cấp quyền truy cập đầy đủ vào API Anthropic và mọi khoản phí liên quan.

Hiểu chi phí API

Claude Code hoạt động theo mô hình trả phí theo lượt sử dụng thông qua API Anthropic. Dựa trên dữ liệu từ các hướng dẫn cài đặt của claude.ai, chi phí khác nhau tùy theo mô hình:

Mức mua tối thiểu để kích hoạt thanh toán là 5 đô la, mặc dù các cuộc thảo luận trong cộng đồng gợi ý rằng 20-30 đô la cung cấp khoảng trống tốt hơn để thử nghiệm. Các tùy chọn đăng ký thay thế bao gồm Claude Pro với 20 đô la mỗi tháng hoặc Claude Max với 100 đô la mỗi tháng cho việc sử dụng nhiều.

Hành vi mặc định sử dụng Opus cho đến khi đạt 50% giới hạn sử dụng, sau đó chuyển sang Sonnet để tiết kiệm chi phí.

Xác thực và Khởi chạy lần đầu

Sau khi cài đặt, Claude Code cần xác thực trước khi sử dụng lần đầu. Khởi chạy Claude Code bằng cách chạy:

claude

Lần khởi chạy đầu tiên sẽ nhắc nhập khóa API. Dán khóa từ Bảng điều khiển Anthropic và nhấn Enter. Claude Code sẽ xác thực khóa và lưu trữ nó một cách an toàn trong các tệp cấu hình cục bộ.

Việc xác thực sẽ duy trì giữa các phiên. Khóa API không cần nhập lại trừ khi nó bị xóa rõ ràng hoặc khi chuyển đổi tài khoản.

Để xác minh việc xác thực đã hoạt động, Claude Code sẽ hiển thị một thông báo chào mừng và lời nhắc lệnh. Giao diện hiển thị các lệnh có sẵn và xác nhận kết nối với API của Anthropic.

Cấu hình tùy chọn Mô hình

Claude Code mặc định chọn mô hình tự động, nhưng có thể cấu hình thủ công. Theo tài liệu chính thức, người dùng có thể điều chỉnh lựa chọn mô hình thông qua lệnh /model hoặc bằng cách đặt biến môi trường CLAUDE_CODE_EFFORT_LEVEL.

Mức độ nỗ lực kiểm soát độ sâu suy nghĩ cho các mô hình Opus 4.6 và Sonnet 4.6: thấp, trung bình hoặc cao. Mức độ nỗ lực cao hơn làm tăng độ sâu suy luận nhưng cũng làm tăng chi phí và thời gian phản hồi.

Đối với các dự án yêu cầu phân tích sâu, bao gồm "ultrathink" trong các lời nhắc tạm thời đặt mức độ nỗ lực thành cao cho lượt đó.

Xác minh Cài đặt thành công

Sau khi xác thực, hãy xác minh Claude Code hoạt động chính xác. Chạy các bài kiểm tra cơ bản sau:

claude –help
claude –version

Lệnh help sẽ hiển thị các tùy chọn và lệnh có sẵn. Kết quả phiên bản xác nhận bản phát hành nào đã được cài đặt. Cả hai lệnh đều nên thực thi mà không có lỗi.

Tiếp theo, hãy thử nghiệm Claude Code trong một thư mục dự án. Tạo một thư mục thử nghiệm:

mkdir test-project
cd test-project
echo “# Test Project” > README.md
claude

Bên trong phiên Claude Code, hãy thử các tương tác cơ bản:

• Nhập "help" để xem các lệnh có sẵn
• Hỏi "explain what you can do" (giải thích bạn có thể làm gì)
• Yêu cầu "summarize this project" (tóm tắt dự án này)
• Kiểm tra lệnh /help

Các tương tác này xác nhận Claude Code có thể đọc tệp dự án và phản hồi các lời nhắc. Các phản hồi thành công có nghĩa là cài đặt đang hoạt động.

Cấu hình Claude Code cho Dự án

Claude Code lưu trữ cài đặt riêng cho từng dự án trong các tệp cấu hình. Các tệp này tùy chỉnh hành vi, xác định bộ nhớ và thiết lập quy trình làm việc.

Tệp cấu hình chính là CLAUDE.md trong thư mục gốc của dự án. Tệp này chứa các hướng dẫn, ngữ cảnh và các nguyên tắc dành riêng cho dự án mà Claude Code tham khảo trong các phiên làm việc.

Tạo tệp CLAUDE.md cơ bản:

# Ngữ cảnh dự án

Đây là một [loại dự án] được xây dựng với [công nghệ].

## Nguyên tắc chính
– [Quy tắc quan trọng 1]
– [Quy tắc quan trọng 2]

## Cấu trúc dự án
[Giải thích ngắn gọn về cách sắp xếp thư mục]

Tệp chấp nhận định dạng Markdown. Claude Code đọc ngữ cảnh này khi bắt đầu phiên làm việc và duy trì nó trong suốt cuộc trò chuyện.

Tùy chọn Cấu hình Nâng cao

Ngoài ngữ cảnh cơ bản, Claude Code còn hỗ trợ cấu hình nâng cao thông qua thư mục .claude. Thư mục này có thể chứa:

• Kỹ năng: Các khả năng chuyên biệt được định nghĩa trong .claude/skills/SKILL.md
• Lệnh: Các lệnh dạng gạch chéo tùy chỉnh trong .claude/commands/*.md
• Hook: Các quy trình làm việc tự động được kích hoạt bởi các sự kiện
• Plugin: Chức năng mở rộng thông qua tích hợp lập trình

Theo tài liệu chính thức của Agent SDK, các tính năng này cho phép tùy chỉnh tinh vi. Kỹ năng xác định các khả năng có thể tái sử dụng. Lệnh tạo các lối tắt cho các tác vụ phổ biến. Hook tự động hóa phản ứng với các thay đổi tệp hoặc sử dụng công cụ.

Sử dụng Claude Code: Quy trình làm việc cơ bản

Sau khi hoàn tất cài đặt, Claude Code sẽ xử lý các tác vụ phát triển thông thường thông qua ngôn ngữ tự nhiên.

Bắt đầu một phiên làm việc bằng cách điều hướng đến một thư mục dự án và chạy:

claude

Lời nhắc chấp nhận các yêu cầu bằng ngôn ngữ thuần túy. Một số quy trình làm việc phổ biến:

• Tạo mã: "Tạo một hàm Python để xác thực địa chỉ email với xử lý lỗi thích hợp."
• Sửa lỗi: "Hàm này đang ném ra lỗi null pointer. Bạn có thể xác định và sửa lỗi này không?"
• Tái cấu trúc: "Tái cấu trúc thành phần này để sử dụng dependency injection thay vì khởi tạo trực tiếp."
• Hoạt động Git: "Tạo một nhánh mới, cam kết các thay đổi này với một thông điệp mô tả và đẩy lên origin."

Claude Code duy trì ngữ cảnh trong suốt phiên làm việc. Nó ghi nhớ các tương tác trước đó, theo dõi các thay đổi tệp và hiểu cấu trúc dự án rộng lớn hơn.

Hiểu Chế độ Kế hoạch

Đối với các thay đổi phức tạp, Claude Code cung cấp Chế độ Kế hoạch. Chế độ này tạo ra một kế hoạch thực thi chi tiết trước khi thực hiện các thay đổi.

Kích hoạt Chế độ Kế hoạch bằng cách thêm tiền tố "plan:" vào các yêu cầu hoặc sử dụng lệnh /plan. Sau đó, Claude Code sẽ phác thảo các thay đổi được đề xuất, giải thích lý do và chờ phê duyệt trước khi thực thi.

Chế độ Kế hoạch đặc biệt hữu ích cho việc tái cấu trúc, thay đổi kiến trúc hoặc các sửa đổi ảnh hưởng đến nhiều tệp. Nó cung cấp khả năng hiển thị về những gì Claude Code dự định làm trước khi cam kết các thay đổi.

Tích hợp với VS Code và IDE

Mặc dù Claude Code chạy trong terminal, việc tích hợp với các trình chỉnh sửa mã sẽ nâng cao quy trình làm việc. Tiện ích mở rộng VS Code chính thức mang các khả năng của Claude Code trực tiếp vào trình chỉnh sửa.

Cài đặt tiện ích mở rộng từ marketplace của VS Code. Tìm kiếm "Claude Code" và nhấp vào Cài đặt. Tiện ích mở rộng sẽ thêm một bảng Claude Code vào thanh bên.

Theo tài liệu chính thức của VS Code, tiện ích mở rộng hỗ trợ:

Tiện ích mở rộng duy trì sự tương đương về tính năng với phiên bản terminal, đồng thời bổ sung các tiện ích dành riêng cho IDE như diff nội tuyến và tham chiếu tệp @-mention.

Cập nhật và Quản lý Claude Code

Claude Code tự động cập nhật theo mặc định. Ứng dụng kiểm tra các phiên bản mới định kỳ và cài đặt các bản cập nhật ở chế độ nền.

Để cập nhật thủ công, hãy chạy:

claude –update

Lệnh này buộc kiểm tra và cài đặt phiên bản mới nhất ngay lập tức. Quá trình cập nhật sẽ bảo toàn các tệp cấu hình và thông tin xác thực.

Đối với các tổ chức yêu cầu kiểm soát phiên bản, có thể tắt tính năng tự động cập nhật. Đặt biến môi trường CLAUDE_CODE_AUTO_UPDATE thành false hoặc cấu hình thông qua cài đặt do máy chủ quản lý.

Để cài đặt một phiên bản cụ thể, hãy sử dụng:

curl -fsSL claude.ai/install.sh | sh -s — –version=X.Y.Z

Thay thế X.Y.Z bằng số phiên bản đích.

Các sự cố thiết lập phổ biến và giải pháp

Nhiều sự cố thường xảy ra trong quá trình thiết lập. Đây là cách khắc phục chúng:

• Từ chối khóa API: Nếu Claude Code từ chối khóa API, hãy xác minh rằng không có khoảng trắng hoặc ký tự thừa nào. Sao chép lại khóa từ Bảng điều khiển Anthropic. Kiểm tra xem thanh toán đã được kích hoạt chưa—khóa sẽ không hoạt động nếu không có phương thức thanh toán nào trong hồ sơ.
• Lỗi cài đặt WSL2: Hệ thống Windows đôi khi gặp lỗi cài đặt WSL2 do cài đặt ảo hóa. Vào BIOS và bật ảo hóa (Intel VT-x hoặc AMD-V). Đảm bảo phiên bản Windows đáp ứng các yêu cầu tối thiểu.
• Lệnh không tìm thấy: Nếu terminal không nhận dạng lệnh claude, PATH có thể chưa được cập nhật chính xác. Đóng và mở lại terminal. Đối với các sự cố dai dẳng, hãy thêm thủ công thư mục cài đặt vào PATH.
• Hết thời gian kết nối: Các hạn chế về mạng hoặc tường lửa có thể chặn các lệnh gọi API. Claude Code yêu cầu quyền truy cập HTTPS vào api.anthropic.com. Mạng doanh nghiệp có thể cần cấu hình proxy.
• Lỗi quyền: Các cài đặt trên Linux và macOS đôi khi gặp sự cố về quyền. Chạy trình cài đặt với quyền thích hợp hoặc cài đặt vào thư mục người dùng thay vì các vị trí hệ thống chung.

Kiểm tra Tín dụng AI có sẵn Trước khi Thiết lập Claude Code

Việc thiết lập Claude Code thường bao gồm việc thử nghiệm—chạy các lời nhắc, kiểm tra các tích hợp và xây dựng các nguyên mẫu nhỏ trước khi có bất kỳ thứ gì được đưa vào sản xuất. Giai đoạn đầu đó thường dẫn đến việc sử dụng API rất nhiều. Thay vì trả tiền cho mỗi yêu cầu ngay lập tức, nhiều nhà phát triển trước tiên tìm kiếm các khoản tín dụng hoặc chương trình khởi nghiệp có sẵn giúp giảm bớt các chi phí ban đầu đó.

Get AI Perks thu thập các cơ hội này ở một nơi. Nền tảng này liệt kê các khoản tín dụng AI, chiết khấu và các chương trình đối tác trên các nhà cung cấp AI, nền tảng đám mây và công cụ dành cho nhà phát triển, với các hướng dẫn từng bước giải thích cách yêu cầu chúng. Tổng cộng, cơ sở dữ liệu bao gồm các ưu đãi từ hơn 200 công cụ và hàng triệu đô la tín dụng có sẵn mà các startup và nhà xây dựng có thể đăng ký.

Trước khi bạn hoàn tất thiết lập Claude Code, hãy kiểm tra Get AI Perks và yêu cầu các khoản tín dụng AI có thể chi trả cho các thử nghiệm đầu tiên của bạn.

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

Tiến xa hơn với Claude Code

Claude Code biến đổi việc phát triển dựa trên terminal bằng cách tích hợp hỗ trợ AI trực tiếp vào dòng lệnh. Việc thiết lập yêu cầu cài đặt dành riêng cho nền tảng, xác thực API và cấu hình cơ bản, nhưng quy trình này rất đơn giản khi tuân theo các bước thích hợp.

Công cụ này xuất sắc trong các tác vụ phát triển thông thường, tạo mã và quản lý quy trình làm việc git. Chế độ Kế hoạch cung cấp sự an toàn cho các hoạt động phức tạp. Tích hợp IDE mở rộng khả năng vượt ra ngoài terminal.

Bắt đầu với các tác vụ đơn giản để hiểu Claude Code diễn giải các yêu cầu như thế nào. Nâng cấp dần lên các quy trình làm việc phức tạp hơn khi bạn quen thuộc. Sử dụng lệnh /clear giữa các tác vụ riêng biệt để duy trì ngữ cảnh rõ ràng. Cấu hình tệp CLAUDE.md để có hướng dẫn dành riêng cho dự án.

Các nhóm có thể khám phá các cài đặt do máy chủ quản lý và các marketplace plugin. Các nhà phát triển cá nhân có thể hưởng lợi từ các kỹ năng và lệnh tùy chỉnh được điều chỉnh theo các mẫu phổ biến.

Kho lưu trữ GitHub tại anthropics/claude-code chứa các ví dụ bổ sung, plugin cộng đồng và tài nguyên khắc phục sự cố. Tài liệu chính thức tại docs.anthropic.com cung cấp các tài liệu tham khảo kỹ thuật toàn diện.

Bây giờ là lúc để bắt đầu lập trình. Điều hướng đến một dự án, khởi chạy Claude Code và xem việc phát triển có sự hỗ trợ của AI thay đổi quy trình làm việc của bạn như thế nào.