Hướng dẫn này tập trung hoàn toàn vào Claude Code: từ cài đặt, chạy lần đầu, liên kết API Key, chuyển đổi tài khoản, đến xử lý lỗi thường gặp. Làm theo từng bước để bạn có thể chạy Claude Code ngay trên terminal cục bộ. Các lệnh trong bài áp dụng cho Windows/macOS/Linux, ưu tiên cảnh báo các lỗi phổ biến ngay từ đầu để bạn tránh mất thời gian.
1) Cài đặt Claude Code: Chuẩn bị môi trường và chạy lần đầu
Claude Code phụ thuộc vào Node.js. Bạn nên cài đặt Node.js phiên bản 18 trở lên trước, và xác nhận terminal có thể sử dụng npm. Sau đó thực hiện cài đặt toàn cục: npm install -g @anthropic-ai/claude-code
Sau khi cài đặt, dùng lệnh claude --version để kiểm tra xem có xuất hiện số phiên bản hay không.
Lần đầu chạy Claude Code, thông thường sẽ nhắc bạn cấu hình Anthropic API Key. Bạn cũng có thể đặt sẵn biến môi trường hệ thống ANTHROPIC_API_KEY, sau đó khởi động Claude Code để tránh phải nhập lại nhiều lần.
2) Liên kết và chuyển đổi tài khoản: Quản lý bằng API Key là thuận tiện nhất
Việc "đăng nhập" vào Claude Code chủ yếu là liên kết API Key: Một Key tương ứng với một nguồn tính phí và quyền truy cập. Để chuyển đổi tài khoản, phương pháp an toàn nhất là thay đổi ANTHROPIC_API_KEY (hoặc thay thế Key trong file cấu hình được tạo ra khi chạy Claude Code lần đầu, đường dẫn cụ thể sẽ được nhắc trong quá trình khởi tạo).
Nếu bạn chuyển đổi giữa tài khoản công ty và cá nhân, nên đặt biến môi trường riêng cho các phiên terminal khác nhau, tránh ghi Key cố định vào cấu hình toàn cục để giảm nguy cơ sử dụng nhầm và rò rỉ.
3) Sự khác biệt gói dịch vụ và cách tiết kiệm chi phí: Chọn theo nhu cầu sử dụng
Các gói đăng ký phổ biến liên quan đến Claude thường có Pro và Max (giá và quyền lợi có thể thay đổi theo điều chỉnh chính thức), phù hợp hơn cho hội thoại tần suất cao trên giao diện web; trong khi chi phí phổ biến hơn với Claude Code đến từ lượng gọi API. Đối với nhà phát triển, tập trung hoàn thành các tác vụ lớn trong một hai ngày và chỉ thực hiện các thay đổi nhỏ trong thời gian còn lại thường tiết kiệm hơn so với việc "mở liên tục với tần suất cao".
Nếu người dùng ở một số khu vực gặp hạn chế về thanh toán hoặc mạng, nên ưu tiên lựa chọn kênh thanh toán API tuân thủ quy định hoặc phương thức thanh toán thống nhất của doanh nghiệp/nhóm; không khuyến nghị sử dụng Key có nguồn gốc không rõ ràng, dễ kích hoạt kiểm soát rủi ro dẫn đến việc Claude Code bị gián đoạn giữa chừng.
4) Các vấn đề và xử lý lỗi thường gặp: Đăng ký thất bại, lỗi yêu cầu, tài khoản bị khóa
Đăng ký thất bại thường xảy ra do phương thức thanh toán, khu vực hoặc thông tin hóa đơn không khớp. Trước tiên kiểm tra xác thực 3DS của thẻ, địa chỉ hóa đơn và loại tiền tệ được hỗ trợ; nếu chỉ sử dụng Claude Code, hãy xác nhận xem bản thân có thực sự cần đăng ký gói hay chỉ cần API Key có thể sử dụng cùng hạn mức.
Lỗi yêu cầu (như timeout/gián đoạn) thường do mạng không ổn định, số lượng yêu cầu đồng thời quá cao hoặc ngữ cảnh quá dài. Thứ tự xử lý khuyến nghị: đổi sang mạng ổn định hơn → giảm phạm vi đầu vào và thay đổi một lần → chia nhỏ các bước để Claude Code thực thi (phân tích trước, sau đó sửa đổi, rồi kiểm tra).
Khi tài khoản bị khóa hoặc Key không còn hiệu lực, trước tiên kiểm tra trên bảng điều khiển xem Key có bị thu hồi, hạn mức đã dùng hết hay không, và có kích hoạt các cuộc gọi bất thường không. Thay thế API Key mới và khởi động lại Claude Code thường có thể khôi phục; nếu lỗi vẫn tiếp diễn, hãy kiểm tra proxy/chứng chỉ cục bộ và thời gian hệ thống có chính xác không.
