Cách Khởi động Mã Claude trong Terminal (Hướng dẫn 2026)

Tóm tắt nhanh: Bắt đầu Claude Code trong terminal rất đơn giản: cài đặt bằng một dòng lệnh duy nhất từ trang web chính thức, xác thực bằng tài khoản Anthropic của bạn và nhập 'claude' để khởi chạy phiên tương tác. Công cụ CLI hoạt động trên macOS, Linux và Windows, cho phép các nhà phát triển xây dựng tính năng, sửa lỗi và tự động hóa tác vụ thông qua các lệnh ngôn ngữ tự nhiên trực tiếp trong môi trường terminal của họ.

Claude Code đại diện cho một sự thay đổi trong cách các nhà phát triển tương tác với sự hỗ trợ của AI. Thay vì sao chép mã giữa các tab trình duyệt và trình soạn thảo văn bản, công cụ dựa trên terminal này nằm trong quy trình làm việc phát triển, hiểu toàn bộ cơ sở mã và thực hiện các tác vụ phức tạp thông qua các lệnh hội thoại.

Quá trình thiết lập chỉ mất chưa đầy năm phút đối với hầu hết các nhà phát triển. Nhưng để bắt đầu Claude Code hiệu quả còn nhiều điều hơn là chỉ cài đặt.

Hướng dẫn này bao gồm mọi thứ từ cài đặt ban đầu đến khởi chạy các phiên làm việc hiệu quả, với các ví dụ thực tế hoạt động trên các dự án thực tế.

Claude Code Thực Sự Làm Gì

Theo tài liệu chính thức, Claude Code là một công cụ mã hóa theo tác nhân (agentic) đọc cơ sở mã, chỉnh sửa tệp, chạy lệnh và tích hợp với các công cụ phát triển. Giao diện terminal đóng vai trò là điểm tương tác chính cho hầu hết các nhà phát triển.

Công cụ này xử lý các tác vụ phát triển thông thường: xây dựng tính năng, sửa lỗi, tự động hóa quy trình làm việc và giải thích các phần mã phức tạp. Nó hoạt động với ngữ cảnh đầy đủ của các tệp dự án, lịch sử git và các tiến trình đang chạy.

Không giống như các trợ lý AI dựa trên trình duyệt, Claude Code thực thi lệnh trực tiếp trong môi trường shell. Khi được yêu cầu sửa lỗi build, nó không chỉ gợi ý giải pháp—nó có thể thực hiện sửa lỗi, kiểm tra kết quả và commit các thay đổi.

Terminal so với các Nền tảng khác

Claude Code hoạt động trên nhiều nền tảng: CLI terminal, ứng dụng desktop, giao diện web, tiện ích mở rộng IDE cho VS Code và JetBrains, và tiện ích mở rộng Chrome để gỡ lỗi các ứng dụng trực tiếp. Phiên bản terminal cung cấp quyền kiểm soát trực tiếp nhất.

Các phiên làm việc terminal cung cấp các phím tắt, thực thi tác vụ nền và tích hợp với các cấu hình shell hiện có. Các nhà phát triển quen thuộc với dòng lệnh sẽ thấy đây là giao diện nhanh nhất.

Yêu cầu cài đặt

Trước khi cài đặt Claude Code, hãy xác minh hệ thống đáp ứng các yêu cầu cơ bản. Công cụ này chạy trên macOS, Linux và Windows (bao gồm WSL2).

Cần có một tài khoản Anthropic đang hoạt động. Nếu bạn chưa có, hãy tạo tài khoản tại trang web chính thức của Anthropic trước khi tiến hành cài đặt.

Terminal cần có kết nối internet và quyền tải xuống và thực thi script. Một số mạng công ty hạn chế việc thực thi script—hãy kiểm tra với bộ phận IT nếu cài đặt thất bại.

Hệ điều hành được hỗ trợ

Xóa tuyên bố này — không có trong tài liệu nguồn chính thức. Việc cài đặt hoạt động thông qua Terminal hoặc bất kỳ trình giả lập terminal nào như iTerm2.

Các bản phân phối Linux yêu cầu một shell hiện đại (bash hoặc zsh). Hầu hết các cài đặt Ubuntu, Debian, Fedora và Arch gần đây đều hoạt động mà không cần sửa đổi.

Người dùng Windows nên cài đặt Windows Subsystem for Linux (WSL2) trước. Hỗ trợ Windows gốc tồn tại nhưng WSL2 cung cấp khả năng tương thích tốt hơn với các công cụ phát triển.

Giảm Chi phí Công cụ AI với Get AI Perks khi bạn Bắt đầu

Bắt đầu với Claude Code thường có nghĩa là thử các công cụ AI khác. Get AI Perks giúp các nhà sáng lập tìm kiếm các khoản tín dụng khởi nghiệp và giảm giá phần mềm trên các sản phẩm AI và đám mây. Nền tảng này tập hợp hơn 200 ưu đãi, bao gồm các ưu đãi cho Claude, Anthropic, OpenAI, Gemini, ElevenLabs, và nhiều hơn nữa, cùng với các điều kiện cho từng ưu đãi.

Muốn Xem Các Ưu đãi Công cụ AI Có Sẵn?

Truy cập Get AI Perks để:

• duyệt các ưu đãi cho 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 các khoản 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.

Quy trình cài đặt từng bước

Phương pháp cài đặt chính thức sử dụng một lệnh duy nhất để phát hiện hệ điều hành và cài đặt phiên bản phù hợp.

Dành cho macOS và Linux

Mở cửa sổ terminal và chạy lệnh này:

Script cài đặt tải xuống tệp nhị phân Claude Code, đặt nó vào một vị trí trong đường dẫn hệ thống và cấu hình tích hợp shell. Quá trình này thường hoàn thành trong vòng chưa đầy 30 giây.

Nếu cài đặt thành công, terminal sẽ hiển thị thông báo xác nhận. Kiểm tra cài đặt bằng cách nhập:

Lệnh này sẽ trả về số phiên bản hiện tại. Nếu thay vào đó hiển thị lỗi "command not found" (lệnh không tìm thấy), thì cấu hình PATH cần được điều chỉnh.

Dành cho Windows với WSL2

Trước tiên, hãy đảm bảo WSL2 đã được cài đặt và cấu hình. Mở terminal WSL2 (khuyên dùng Ubuntu) và chạy cùng một lệnh cài đặt như Linux:

Các sự cố mạng dành riêng cho Windows đôi khi xảy ra với WSL2. Theo tài liệu khắc phục sự cố, các quy tắc tường lửa có thể cần được điều chỉnh để cho phép giao tiếp giữa WSL2 và các tiến trình Windows.

Khắc phục sự cố cài đặt

Sự cố cài đặt phổ biến nhất là cấu hình PATH. Khi terminal hiển thị "command not found" sau khi cài đặt, tệp nhị phân Claude không nằm trong đường dẫn thực thi của shell.

Kiểm tra vị trí cài đặt bằng cách:

Nếu lệnh này không trả về gì, hãy thêm thư mục cài đặt vào PATH theo cách thủ công. Đối với bash, hãy thêm dòng này vào ~/.bashrc:

Đối với người dùng zsh, hãy thêm cùng một dòng vào ~/.zshrc thay thế. Khởi động lại terminal hoặc chạy source ~/.bashrc để áp dụng các thay đổi ngay lập tức.

Các lỗi cài đặt liên quan đến mạng thường hiển thị dưới dạng "TLS connect error" hoặc bị gián đoạn tải xuống. Điều này cho thấy các hạn chế của tường lửa hoặc chứng chỉ đã lỗi thời. Cập nhật chứng chỉ hệ thống hoặc liên hệ với quản trị viên mạng nếu bạn đang làm việc trên mạng công ty.

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

Sau khi cài đặt thành công, xác thực sẽ kết nối CLI cục bộ với tài khoản Anthropic. Bắt đầu quá trình xác thực bằng cách chạy:

Lần khởi chạy đầu tiên sẽ tự động kích hoạt quá trình xác thực. Một cửa sổ trình duyệt sẽ mở ra hiển thị trang đăng nhập. Đăng nhập bằng thông tin xác thực tài khoản Anthropic của bạn.

Sau khi quá trình xác thực trên trình duyệt hoàn tất, phiên terminal sẽ được kích hoạt. Một thông báo chào mừng xác nhận kết nối và hiển thị hướng dẫn sử dụng cơ bản.

Quản lý Phiên làm việc

Mỗi khi claude chạy trong terminal, nó sẽ bắt đầu một phiên mới. Các phiên làm việc tồn tại cho đến khi kết thúc rõ ràng bằng Ctrl+D hoặc bằng cách nhập exit.

Mã thông báo xác thực được lưu cục bộ, vì vậy các lần khởi chạy sau đó không yêu cầu đăng nhập trình duyệt. Mã thông báo vẫn hợp lệ cho đến khi bị thu hồi thủ công thông qua cài đặt tài khoản trên trang web của Anthropic.

Khởi chạy Chế độ Tương tác

Chế độ tương tác đại diện cho cách chính mà các nhà phát triển sử dụng Claude Code. Khởi chạy bằng cách nhập claude mà không có thêm đối số.

Terminal chuyển sang dấu nhắc tương tác nơi các lệnh ngôn ngữ tự nhiên hướng dẫn AI. Chế độ này duy trì ngữ cảnh hội thoại, ghi nhớ các yêu cầu trước đó và có thể thực hiện các quy trình làm việc nhiều bước.

Các lệnh tương tác thiết yếu

Một số lệnh tích hợp sẵn điều khiển hành vi của phiên. 

Nhập chúng tại dấu nhắc Claude Code:

• /model – Chuyển đổi giữa các mô hình Claude khác nhau (Opus, Sonnet)
• /status – Xem mô hình hiện tại, ID phiên và cấu hình
• /btw – Đặt câu hỏi phụ mà không thay đổi ngữ cảnh tác vụ
• ? – Hiển thị các phím tắt và thông tin trợ giúp

Các phím tắt tăng cường năng suất. Nhấn Ctrl+L để xóa màn hình terminal mà không kết thúc phiên. Sử dụng Ctrl+C để hủy bỏ một lần tạo đang chạy. Ctrl+F sẽ dừng tất cả các tác vụ nền (nhấn hai lần để xác nhận).

Dòng trạng thái ở dưới cùng hiển thị các tiến trình nền đang hoạt động, mô hình hiện tại và việc sử dụng mã thông báo. Thông tin này giúp theo dõi mức tiêu thụ tài nguyên trong các tác vụ phức tạp.

Thực thi tác vụ nền

Claude Code có thể chạy các hoạt động kéo dài ở chế độ nền trong khi vẫn phản hồi các lệnh mới. Các tác vụ nền hiển thị chỉ báo tiến độ và hoàn thành một cách không đồng bộ.

Khi nhiều hoạt động chạy đồng thời, danh sách tác vụ sẽ theo dõi từng hoạt động. Nhấn Ctrl+F để xem và quản lý các tiến trình nền.

Chạy các lệnh một lần

Không phải mọi tác vụ đều cần một phiên tương tác. Đối với các hoạt động nhanh, Claude Code chấp nhận lệnh trực tiếp dưới dạng đối số:

Lệnh này khởi chạy Claude Code, xử lý yêu cầu, hiển thị kết quả đầu ra và thoát ngay lập tức. Không có phiên tương tác nào bắt đầu.

Các lệnh một lần hoạt động tốt cho việc scripting và tự động hóa. Chúng có thể được tích hợp vào các git hook, pipeline CI/CD hoặc các script shell cần sự hỗ trợ của AI cho các tác vụ phụ cụ thể.

Chế độ chỉ truy vấn

Cờ -p chạy chế độ chỉ truy vấn, chế độ này trả lời câu hỏi mà không thực hiện thay đổi tệp:

Chế độ này đọc các tệp dự án nhưng sẽ không chỉnh sửa, tạo hoặc xóa bất kỳ thứ gì. Nó chỉ cung cấp thông tin, giúp khám phá an toàn mà không có rủi ro sửa đổi ngoài ý muốn.

Lựa chọn và Cấu hình Mô hình

Claude Code hỗ trợ nhiều mô hình AI với các khả năng và đặc điểm tốc độ khác nhau. Theo tài liệu chính thức, các mô hình được hỗ trợ bao gồm Sonnet 4.6, Opus 4.6, Opus 4.5, Haiku 4.5 và Sonnet 4.5.

Thay đổi mô hình đang hoạt động bằng lệnh /model trong phiên tương tác. Một menu tương tác liệt kê các tùy chọn có sẵn với mô tả ngắn gọn về điểm mạnh của từng mô hình.

Để ưu tiên mô hình vĩnh viễn, hãy đặt biến môi trường trước khi khởi chạy Claude Code:

Cấu hình này sẽ tồn tại qua các phiên làm việc cho đến khi biến được thay đổi hoặc hủy bỏ.

Cấu hình chế độ nhanh

Chế độ nhanh ưu tiên tốc độ phản hồi hơn là phân tích toàn diện. Nó hữu ích cho các lần lặp nhanh và các tác vụ đơn giản mà việc phân tích ngữ cảnh đầy đủ là không cần thiết.

Kích hoạt chế độ nhanh thông qua cấu hình cài đặt hoặc bằng cách sử dụng các biến thể mô hình được tối ưu hóa cho tốc độ. Kiểm tra tài liệu chính thức để biết các tùy chọn chế độ nhanh hiện tại vì chúng phát triển cùng với các bản phát hành mô hình mới.

Làm việc với các dự án

Claude Code hiểu cấu trúc dự án bằng cách phân tích các tệp trong thư mục hiện tại và các thư mục con. Điều hướng đến một thư mục dự án trước khi bắt đầu:

Công cụ tự động đọc các tệp dự án, hiểu cấu trúc cơ sở mã và nhận dạng các mẫu phổ biến như trình quản lý gói, cấu hình framework và công cụ build.

Loại trừ các tệp nhạy cảm

Một số tệp không nên được AI phân tích hoặc sửa đổi—thông tin xác thực, khóa API, tệp nhị phân lớn hoặc nội dung được tạo. Tạo tệp .claudeignore trong thư mục gốc dự án để loại trừ các đường dẫn cụ thể:

Điều này hoạt động tương tự như cú pháp .gitignore. Các tệp bị loại trừ sẽ không hiển thị với Claude Code trong cả quá trình phân tích và thực thi.

Mẹo cấu hình Terminal

Claude Code hoạt động tốt hơn với một số cấu hình terminal nhất định. Hầu hết các sự cố đều bắt nguồn từ cài đặt shell không tương thích hoặc thiếu tính năng.

Tích hợp Shell

Làm mềm: Một số terminal hiện đại hỗ trợ các tính năng tích hợp shell tùy chọn như phát hiện dấu nhắc qua các chuỗi OSC 133, mặc dù những tính năng này không bắt buộc

Để có khả năng tương thích tối ưu, hãy sử dụng các phiên bản gần đây của các trình giả lập terminal phổ biến: iTerm2 trên macOS, Alacritty, Kitty hoặc WezTerm trên Linux. Windows Terminal hoạt động tốt với WSL2.

Tùy chỉnh phím tắt

Các phím tắt mặc định có thể xung đột với các ràng buộc terminal hoặc shell hiện có. Tùy chỉnh chúng thông qua tệp cấu hình cài đặt nằm tại ~/.claude/settings.json.

Tệp cài đặt sử dụng định dạng JSON và hỗ trợ ánh xạ lại bất kỳ lệnh tích hợp nào với các tổ hợp phím khác nhau. Sau khi chỉnh sửa, hãy khởi động lại Claude Code để các thay đổi có hiệu lực.

Quy trình làm việc Phiên đầu tiên phổ biến

Nói thật: phiên Claude Code đầu tiên thường liên quan đến việc thử nghiệm. Dưới đây là các điểm khởi đầu thực tế minh họa các khả năng cốt lõi.

Khám phá cơ sở mã

Bắt đầu bằng cách yêu cầu Claude Code giải thích cấu trúc dự án:

“Cung cấp cho tôi tổng quan về cơ sở mã này. Các thành phần chính là gì và chúng tương tác với nhau như thế nào?”

Yêu cầu này không sửa đổi bất cứ điều gì—nó chỉ phân tích và giải thích. Phản hồi giúp xác minh Claude Code hiểu đúng tổ chức dự án.

Thực hiện một thay đổi đơn giản

Thử một sửa đổi rủi ro thấp để xem khả năng chỉnh sửa tệp hoạt động như thế nào:

“Thêm một bình luận ở đầu README.md giải thích dự án này làm gì”

Claude Code đọc tệp, tạo nội dung phù hợp và thực hiện chỉnh sửa. Kiểm tra thay đổi bằng git diff để xem chính xác những gì đã xảy ra.

Sửa một vấn đề hiện có

Nếu dự án có các lỗi đã biết hoặc các mục TODO, hãy yêu cầu Claude Code giải quyết chúng:

“Sửa lỗi xác thực đăng nhập được mô tả trong vấn đề #42”

Công cụ đọc các tệp nguồn có liên quan, xác định sự cố, triển khai giải pháp sửa lỗi và thậm chí có thể chạy các bài kiểm tra để xác minh giải pháp hoạt động.

Quyền và An toàn

Claude Code yêu cầu quyền trước khi thực hiện các hoạt động có khả năng rủi ro. Hệ thống quyền phân loại các lệnh theo mức độ tác động.

Việc đọc tệp diễn ra mà không có lời nhắc xin phép—đọc mã luôn an toàn. Ghi, xóa tệp và thực thi lệnh shell yêu cầu phê duyệt rõ ràng trong lần đầu tiên.

Các lựa chọn quyền có thể được lưu cho phiên làm việc hoặc vĩnh viễn. Quyền vĩnh viễn được lưu trong các tệp cấu hình và áp dụng cho tất cả các phiên làm việc trong tương lai.

Cấu hình Sandboxing

Theo tài liệu cài đặt chính thức, sandboxing hạn chế nơi Claude Code có thể thực hiện các thay đổi. Cấu hình các tiền tố đường dẫn sandbox để giới hạn quyền truy cập hệ thống tệp vào các thư mục cụ thể.

Lớp bảo mật này ngăn chặn việc sửa đổi nhầm các tệp hệ thống hoặc thư mục bên ngoài phạm vi dự án. Các nhóm làm việc trên các cơ sở mã nhạy cảm nên cấu hình sandboxing trước khi triển khai.

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

Các bước tiếp theo sau khi cài đặt

Sau khi Claude Code chạy thành công, hãy khám phá các khả năng mở rộng của nó. Tài liệu chính thức bao gồm các chủ đề nâng cao như tác nhân tùy chỉnh, phát triển plugin và tự động hóa tác vụ theo lịch trình.

Skills (Kỹ năng) cung cấp một cách để mở rộng Claude Code với các lệnh và quy trình làm việc dành riêng cho dự án. Tạo kỹ năng trong thư mục .claude/skills/ sẽ bổ sung các khả năng tùy chỉnh phù hợp với nhu cầu phát triển cụ thể.

Tích hợp Model Context Protocol (MCP) cho phép Claude Code tương tác với các công cụ và dịch vụ bên ngoài. Điều này mở ra các khả năng truy vấn cơ sở dữ liệu, kiểm thử API và quản lý cơ sở hạ tầng thông qua cùng một giao diện hội thoại.

Các tính năng Điều khiển từ xa cho phép tiếp tục các phiên làm việc trên các thiết bị khác nhau. Bắt đầu công việc trên máy tính để bàn, sau đó tiếp tục phiên làm việc tương tự trên máy tính xách tay hoặc thiết bị di động. Kiểm tra tài liệu tích hợp nền tảng để biết hướng dẫn thiết lập.

Nhận trợ giúp khi gặp khó khăn

Tài liệu khắc phục sự cố chính thức giải quyết hầu hết các sự cố phổ biến. Khi xảy ra sự cố, hãy kiểm tra tài liệu đó trước khi đào sâu vào cấu hình hệ thống.

Các cuộc thảo luận cộng đồng trên các nền tảng như Reddit cung cấp các giải pháp thực tế từ các nhà phát triển khác. Nhiều người dùng chia sẻ các tùy chỉnh cấu hình và tối ưu hóa quy trình làm việc của họ trên các diễn đàn này.

Đối với các sự cố cài đặt hoặc xác thực, hãy xác minh trạng thái tài khoản trên trang web của Anthropic. Các gói đăng ký hết hạn hoặc hạn chế tài khoản sẽ ngăn kết nối thành công ngay cả khi cài đặt cục bộ chính xác.

Các sự cố dành riêng cho terminal thường liên quan đến cấu hình shell hoặc khả năng tương thích. Kiểm tra với cấu hình terminal mặc định (không có tùy chỉnh shell tùy chỉnh) sẽ giúp xác định xem sự cố có bắt nguồn từ các sửa đổi cục bộ hay không.

Kết luận

Bắt đầu Claude Code trong terminal chỉ mất vài phút sau khi cài đặt hoàn tất. Sự kết hợp giữa các lệnh ngôn ngữ tự nhiên và tích hợp trực tiếp cơ sở mã tạo ra một quy trình làm việc phát triển xử lý cả các truy vấn đơn giản và tái cấu trúc đa tệp phức tạp.

Giao diện terminal giúp các nhà phát triển ở trong môi trường ưa thích của họ mà không cần chuyển đổi ngữ cảnh sang các tab trình duyệt hoặc ứng dụng riêng biệt. Việc thực thi tác vụ nền có nghĩa là các hoạt động kéo dài không làm gián đoạn công việc khác.

Giống như bất kỳ công cụ phát triển nào, trình độ chuyên môn đến từ việc thực hành. Bắt đầu với các truy vấn chỉ đọc đơn giản để hiểu cách Claude Code diễn giải cấu trúc dự án. Nâng cao lên việc chỉnh sửa tệp và quy trình làm việc tự động khi sự tự tin được xây dựng. Hệ thống quyền ngăn ngừa các lỗi không thể phục hồi trong giai đoạn học tập.

Sẵn sàng để biến đổi quy trình làm việc mã hóa 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ợ bởi AI trực tiếp trong terminal của bạn.