Bắt đầu phiên làm việc đầu tiên với Claude Code: Từ API key đến Hello World

Định nghĩa

Phiên làm việc đầu tiên với Claude Code là lần tương tác khởi đầu sau khi cài đặt, nơi bạn xác thực API key, làm quen với giao diện dòng lệnh REPL, và thực thi câu lệnh tự nhiên đầu tiên để kiểm chứng môi trường hoạt động. Đây là "khoảnh khắc thức thần" để bạn cảm nhận sự khác biệt giữa một AI chat thông thường và một agent có khả năng tự động thao tác file trên máy của bạn.

Giải thích chi tiết

Khởi động và xác thực lần đầu

Khi chạy lệnh claude trong terminal lần đầu tiên, hệ thống sẽ kiểm tra API key. Nếu chưa cấu hình, Claude sẽ hướng dẫn bạn lấy key từ console.anthropic.com và lưu vào biến môi trường ANTHROPIC_API_KEY.

Trên Windows WSL2, nếu gặp lỗi claude: command not found, thường là do thư mục cài đặt chưa được thêm vào PATH. Kiểm tra bằng lệnh:

which claude

Nếu không trả về đường dẫn, thêm vào ~/.bashrc hoặc ~/.zshrc:

export PATH="$HOME/.local/bin:$PATH"

Sau đó chạy source ~/.bashrc và thử lại.

Giao diện REPL và vòng lặp tương tác

Claude Code chạy ở chế độ REPL (Read-Eval-Print Loop). Mỗi lượt giao tiếp gồm ba giai đoạn:

• Input: Bạn nhập yêu cầu bằng tiếng Việt hoặc tiếng Anh
• Agent Loop: Claude phân tích ngữ cảnh → chọn tool phù hợp (Read, Write, Bash...) → thực thi → quan sát kết quả
• Output: Phản hồi tự nhiên kèm theo mô tả các hành động đã thực hiện trên filesystem

Dấu nhắc > cho biết Claude đang chờ input. Khi Claude đang suy nghĩ hoặc chạy lệnh, bạn sẽ thấy spinner và danh sách tool đang được gọi. Đừng lo nếu thấy Claude "im lặng" vài giây — nó đang đọc file hoặc phân tích cấu trúc thư mục trong đầu.

Cấu trúc câu lệnh tự nhiên

Khác với terminal truyền thống, bạn không cần nhớ cú pháp chính xác. Thay vì gõ mkdir project && cd project && touch README.md, bạn chỉ cần nói:

"Tạo một thư mục project mới, vào trong đó, và tạo file README giới thiệu về ứng dụng todo list"

Claude sẽ tự động chuỗi các tool Bash và Write để thực hiện chuỗi thao tác này trong một lượt. Bạn sẽ thấy quá trình thực thi hiển thị trên màn hình, từ việc tạo thư mục đến ghi nội dung file.

Checkpoint và quản lý phiên

Mỗi phiên làm việc được định danh bằng session ID có thể khôi phục. Các lệnh cơ bản cần biết trong phiên đầu:

• /clear: Xóa lịch sử hội thoại trong context window khi hội thoại quá dài, nhưng giữ nguyên file đã tạo
• /session: Liệt kê các phiên đang mở để chuyển đổi
• exit hoặc Ctrl+D: Thoát phiên hiện tại
• claude --resume hoặc claude -r: Khôi phục phiên gần nhất với toàn bộ ngữ cảnh và lịch sử file đã đọc

Ví dụ thực tế

Kiểm tra cài đặt bằng "Hello World"

Sau khi chạy claude, thử câu lệnh đơn giản để xác minh mọi thứ hoạt động:

"Tạo file hello.py in ra chữ 'Xin chào từ Claude' và chạy thử"

Claude sẽ:

1. Dùng tool Write tạo file với nội dung print("Xin chào từ Claude")
2. Dùng tool Bash chạy python hello.py
3. Hiển thị kết quả stdout cho bạn

Nếu trên macOS bạn thấy cảnh báo "Operation not permitted", đây là do SIP (System Integrity Protection) hạn chế quyền truy cập một số thư mục hệ thống. Chạy Claude trong thư mục user (như ~/Documents) hoặc dùng --permission-mode acceptEdits để phê duyệt từng thay đổi nếu làm việc ở vị trí nhạy cảm.

Tạo project mini đầu tiên: Quản lý chi tiêu

Thử nghiệm với tình huống thực tế tại Việt Nam — tạo app theo dõi chi tiêu cá nhân với đơn vị tiền tệ VND:

"Tạo một ứng dụng Python đơn giản để thêm chi tiêu hàng ngày, lưu vào CSV, và hiển thị tổng chi tiêu tháng này. Dùng tiếng Việt cho giao diện terminal và format tiền tệ dạng 45.000đ"

Claude sẽ tạo cấu trúc:

• expense_tracker.py: Logic chính với argparse hoặc input(), xử lý định dạng tiền Việt Nam
• expenses.csv: File dữ liệu tự động tạo nếu chưa tồn tại
• Xử lý encoding UTF-8 để hiển thị tiếng Việt không bị lỗi font trên terminal Windows

Bạn có thể ngay lập tức chạy thử bằng cách yêu cầu: "Chạy app và thêm một khoản chi tiêu 'Cà phê Highlands 45000đ'". Claude sẽ thực thi lệnh và hiển thị bảng tổng kết với định dạng tiền tệ quen thuộc.

Xử lý lỗi API Key hết hạn

Nếu trong phiên đầu bạn thấy lỗi 401 Unauthorized hoặc thông báo API key invalid:

# Kiểm tra key hiện tại
echo $ANTHROPIC_API_KEY

# Thiết lập lại trong terminal hiện tại
export ANTHROPIC_API_KEY="sk-ant-xxxxx"

# Hoặc thêm vào ~/.bashrc để lưu vĩnh viễn
echo 'export ANTHROPIC_API_KEY="sk-ant-xxxxx"' >> ~/.bashrc
source ~/.bashrc

Lưu ý: Key bắt đầu bằng sk-ant- và cần giữ bí mật. Không bao giờ commit file chứa API key vào git — nếu accidentally push lên GitHub, key sẽ bị Anthropic vô hiệu hóa ngay lập tức vì lý do bảo mật.

Ứng dụng

Sinh viên học lập trình

Sinh viên dùng phiên đầu tiên để tạo môi trường sandbox: yêu cầu Claude tạo các bài tập Python cơ bản kèm test case tự động, kiểm tra kết quả ngay trong terminal mà không cần cài IDE nặng như PyCharm. Ví dụ: "Tạo 5 bài tập về list comprehension kèm unittest và chạy kiểm tra giúp tôi".

Developer Junior

Lập trình viên mới vào nghề dùng phiên đầu để làm quen với codebase công ty: nhập lệnh "Đọc file README và giải thích cấu trúc thư mục này", Claude sẽ dùng tool Read phân tích và tóm tắt kiến trúc project, giúp nắm bắt nhanh hơn đọc thủ công từng file config.

Người không biết code (Vibe Coding)

Với người không có nền tảng kỹ thuật, phiên đầu là lúc thử "vibe coding": mô tả ý tưởng ứng dụng bằng tiếng Việt (ví dụ: "Tạo trang web giới thiệu quán cà phê có ảnh và bản đồ Google Maps nhúng vào") và để Claude tự động sinh HTML/CSS, mở trình duyệt để preview ngay trong terminal bằng lệnh python -m http.server.

So sánh

Kết luận: Phiên Claude Code đầu tiên kết hợp tính tự nhiên của chat AI với khả năng thao tác trực tiếp hệ thống file, tạo ra "trải nghiệm onboarding" nhanh hơn cả học cú pháp terminal lẫn copy-paste qua lại với web chat.

Bài viết liên quan

Cùng cụm

• Hướng dẫn cài đặt Claude Code từ đầu — Các bước cài đặt chi tiết trước khi bắt đầu phiên làm việc
• Cài đặt trên macOS — Hướng dẫn cụ thể cho máy Mac và xử lý quyền truy cập
• Cài đặt trên Windows WSL — Thiết lập môi trường WSL2 phổ biến tại Việt Nam
• Cài đặt trên Linux — Ubuntu và các distro khác

Đọc tiếp

• Agent Loop và Tools: Claude hoạt động như thế nào — Hiểu sâu cơ chế bên trong sau phiên đầu tiên
• Workflow hàng ngày với Slash Commands — Các lệnh /commit, /plan để tăng tốc công việc thường ngày