Giới thiệu

Claude Code là công cụ lập trình dòng lệnh (CLI) do Anthropic phát triển, cho phép bạn tương tác trực tiếp với Claude ngay trong terminal. Thay vì mở trình duyệt, bạn chat với AI, rồi tự copy code về — Claude Code để Claude làm việc trực tiếp trong thư mục dự án của bạn: đọc file, viết code, chạy lệnh, giải thích lỗi, tất cả trong một luồng liên tục.

Bài này tập trung vào 3 việc cụ thể: cài Claude Code, gắn API key, và gõ lệnh đầu tiên để xác nhận mọi thứ hoạt động đúng.

Yêu cầu trước khi cài

Claude Code chạy trên Node.js, nên máy bạn cần có Node.js phiên bản 18 trở lên. Kiểm tra bằng lệnh:

node --version

Nếu chưa có hoặc phiên bản thấp hơn 18, tải Node.js tại nodejs.org (chọn bản LTS). Ngoài ra bạn cần một tài khoản Anthropic và API key — đăng ký tại console.anthropic.com nếu chưa có. API key có dạng bắt đầu bằng sk-ant-..., giữ key này bí mật và không commit vào git.

Cài đặt Claude Code

Claude Code được phân phối qua npm. Chạy lệnh sau để cài toàn cục:

npm install -g @anthropic-ai/claude-code

Sau khi cài xong, kiểm tra bằng:

claude --version

Terminal sẽ in ra số phiên bản hiện tại, ví dụ 1.x.x. Nếu hệ thống báo lỗi permission khi cài global trên macOS/Linux, hãy dùng nvm để quản lý Node thay vì cài Node trực tiếp — cách này tránh được hầu hết lỗi quyền truy cập.

Cấu hình API key

Claude Code cần API key để xác thực với Anthropic. Cách đơn giản nhất là set biến môi trường ANTHROPIC_API_KEY trước khi chạy:

export ANTHROPIC_API_KEY="sk-ant-your-key-here"

Đây là cách tạm thời — mỗi lần mở terminal mới bạn phải set lại. Để lưu vĩnh viễn, thêm dòng trên vào file cấu hình shell của bạn:

echo 'export ANTHROPIC_API_KEY="sk-ant-your-key-here"' >> ~/.zshrc
source ~/.zshrc

Nếu dùng bash thay zsh thì đổi ~/.zshrc thành ~/.bashrc. Trên Windows với PowerShell, dùng lệnh:

$env:ANTHROPIC_API_KEY = "sk-ant-your-key-here"

Ngoài ra, Claude Code cũng hỗ trợ file .env.local trong thư mục dự án — tiện khi bạn muốn dùng key khác nhau cho từng dự án.

Chạy lệnh đầu tiên

Vào thư mục dự án bất kỳ (hoặc tạo thư mục mới), rồi khởi động Claude Code:

mkdir my-first-project && cd my-first-project
claude

Lần đầu chạy, Claude Code sẽ yêu cầu bạn xác nhận một số điều khoản sử dụng. Sau đó bạn sẽ thấy dấu nhắc lệnh của Claude. Thử gõ câu đầu tiên:

Tạo file hello.py in ra dòng chữ Hello, Claude Code!

Claude sẽ tạo file hello.py với nội dung phù hợp ngay trong thư mục hiện tại, sau đó bạn có thể chạy thử:

python hello.py

Nếu thấy dòng chữ Hello, Claude Code! xuất hiện, mọi thứ đã hoạt động đúng.

Lỗi thường gặp

Lỗi phổ biến nhất khi mới bắt đầu là authentication error hoặc invalid API key. Nguyên nhân thường là key bị copy thừa/thiếu ký tự, hoặc biến môi trường chưa được load. Chạy lệnh sau để kiểm tra key đã được nhận chưa:

echo $ANTHROPIC_API_KEY

Nếu terminal in ra trống, nghĩa là biến chưa được set trong phiên làm việc hiện tại — chạy lại lệnh export hoặc source file cấu hình shell.

Lỗi thứ hai hay gặp là command not found: claude sau khi cài npm. Nguyên nhân là thư mục bin của npm global chưa nằm trong PATH. Kiểm tra bằng:

npm bin -g

Copy đường dẫn in ra và thêm vào PATH trong file cấu hình shell của bạn.

Tổng kết

Sau bài này bạn đã có Claude Code chạy được trên máy với API key được cấu hình đúng. Quy trình gồm 3 bước cốt lõi: cài qua npm, set biến môi trường ANTHROPIC_API_KEY, rồi chạy claude trong thư mục dự án. Từ đây các bài tiếp theo sẽ khai thác sâu hơn các tính năng thực chiến của Claude Code trong dự án thực tế.