​
Mục tiêu học tập

Sau bài này, bạn sẽ có thể:
  • ✅ Cài Claude Code thành công trên hệ điều hành của mình (macOS, Linux, WSL, hoặc Windows)
  • ✅ Chọn surface phù hợp với workflow của bạn (terminal, IDE, desktop, hoặc web)
  • ✅ Hiểu pricing và các authentication options (Pro, Max, API key, Enterprise)
  • ✅ Biết cách update Claude Code đúng cách và tránh bị kẹt ở version cũ

​
Mở đầu: 30 giây vs 30 phút

Nhớ lại lần đầu bạn cài một IDE plugin “AI assistant” nào đó. Bạn vào trang docs, thấy một danh sách bước dài 14 bước. Bước 1: cài extension. Bước 2: tạo account trên platform của vendor. Bước 3: generate API key. Bước 4: vào settings, tìm tab “Integrations”, nhập endpoint URL. Bước 5: cấu hình JWT expiry. Bước 6: đặt port. Bước 7: restart IDE. Bước 8: nếu IDE không nhận, clear cache và thử lại… 30 phút sau, bạn vẫn đang đọc StackOverflow, không rõ tại sao plugin báo “Connection refused”. Claude Code khác hoàn toàn. Toàn bộ quá trình cài đặt trên macOS hoặc Linux là một dòng lệnh: 
curl -fsSL https://claude.ai/install.sh | sh
Chạy xong, gõ claude, và Claude Code tự walk-through phần còn lại — chọn theme, đăng nhập, xong. Tổng cộng khoảng 30 giây nếu bạn đã có tài khoản Anthropic. Điều đáng nói hơn là sự đơn giản này không phải là do Claude Code thiếu tính năng. Ngược lại — đây là tool mà toàn bộ team engineering tại Anthropic dùng mỗi ngày. Như một kỹ sư trong team chia sẻ: “This is the same tool everyone at Anthropic uses every day. We debated: is this secret sauce? Are we sure we want to give it to people?” Câu trả lời là có. Và bạn đang cầm nó trong tay. Bài này sẽ hướng dẫn bạn cài đặt theo từng platform, chọn surface phù hợp với cách làm việc của mình, và tránh những lỗi cài đặt phổ biến mà người mới hay gặp.

​
5 cách cài đặt Claude Code

Claude Code không bị gắn vào một môi trường duy nhất. Tùy theo cách bạn làm việc, có 5 surface để chọn: Terminal là nơi Claude Code ra đời và là nơi features mới xuất hiện sớm nhất. Nếu bạn muốn luôn ở cutting edge, đây là lựa chọn mặc định.

​
macOS và Linux (hoặc WSL trên Windows)

Cách 1 — curl (có auto-update): 
curl -fsSL https://claude.ai/install.sh | sh
Đây là cách được khuyến nghị. Script sẽ tự detect OS, cài đặt Claude Code, và thiết lập auto-update. Cách 2 — npm (nếu bạn đã có Node.js): 
npm install -g @anthropic-ai/claude-code
Cách 3 — Homebrew (macOS): 
brew install claude-code
⚠️ Lưu ý quan trọng: Homebrew không hỗ trợ auto-update. Bạn sẽ phải chạy brew upgrade claude-code thủ công mỗi khi có version mới. Nếu quên, bạn sẽ bỏ lỡ nhiều tính năng mới.

​
Windows (không dùng WSL)

Cách 1 — PowerShell (có auto-update): 
Invoke-RestMethod https://claude.ai/install.ps1 | Invoke-Expression
Cách 2 — CMD (curl): 
curl -fsSL https://claude.ai/install.bat -o install.bat && install.bat
Cách 3 — winget: 
winget install Anthropic.ClaudeCode
⚠️ Lưu ý: winget, giống Homebrew, không tự update. Phải chạy winget upgrade Anthropic.ClaudeCode thủ công. Sau khi cài xong, nếu lệnh claude không nhận ra, hãy restart terminal (hoặc mở terminal mới) để PATH được reload.

​
Surface 2: VS Code Extension

Nếu bạn dùng VS Code làm editor chính và muốn Claude Code tích hợp trực tiếp vào editor với inline diffs và sidebar panel: Bước 1: Mở Extensions panel (Ctrl/Cmd + Shift + X) Bước 2: Tìm kiếm “Claude Code” Bước 3: Tìm extension có tên “Claude Code” với author Anthropic — phải có dấu tích xanh (blue verification check). Đừng cài extension từ bất kỳ author nào khác. Bước 4: Bấm Install. Restart VS Code nếu được nhắc. Bước 5: Sau khi restart, mở command palette (Ctrl/Cmd + Shift + P) và tìm “Claude Code: Open in New Tab”. Hoặc click vào biểu tượng Claude (hình cái cào) nếu thấy trong sidebar khi một file đang mở. Tip: Nếu bạn thích terminal experience hơn UI, vào VS Code settings và tắt UI — Claude Code sẽ chạy ngay trong terminal tích hợp của VS Code. Extension beta được ra mắt tháng 10/2025 với inline diffs panel, cho phép bạn review từng thay đổi ngay trong editor mà không cần chuyển tab.

​
Surface 3: JetBrains Plugin

Cho người dùng IntelliJ IDEA, Android Studio, GoLand, PyCharm, WebStorm, và các IDE khác trong hệ sinh thái JetBrains: Bước 1: Mở Settings / Preferences → Plugins → Marketplace Bước 2: Tìm kiếm “Claude Code” Bước 3: Cài plugin của Anthropic. Restart IDE. Bước 4: Sau khi restart, bạn sẽ thấy biểu tượng Claude trong sidebar. Click để mở pane — đây là terminal experience của Claude Code chạy ngay bên trong IDE của bạn, cùng với editor. Plugin này đặc biệt hữu ích cho mobile developer dùng Android Studio, hoặc backend developer dùng IntelliJ với Kotlin/Java.

​
Surface 4: Claude Desktop

Nếu bạn không quen với terminal hoặc muốn Claude Code chạy như một app desktop độc lập (visual hơn, không cần gõ lệnh để khởi động): Bước 1: Tải Claude Desktop từ claude.ai và cài đặt (macOS hoặc Windows) Bước 2: Đăng nhập vào account Anthropic của bạn Bước 3: Ở góc trên cùng của cửa sổ, bạn sẽ thấy một toggle hoặc tab có tên “Code” — bấm vào đó để vào chế độ Claude Code Desktop app cho phép bạn:
  • Chọn một folder cụ thể để làm việc
  • Thay đổi permissions theo từng session
  • Để Claude chạy task trong background trong khi bạn làm việc khác trên máy
Đây là lựa chọn tốt nhất cho người không-kỹ-thuật hoặc designer muốn ship code mà không cần học terminal commands.

​
Surface 5: Web (claude.ai/code)

Truy cập claude.ai/code hoặc click vào label “Code” trong sidebar của claude.ai (chat app). Web version có trải nghiệm tương tự Desktop, nhưng có một hạn chế quan trọng: bạn chỉ có thể làm việc với GitHub repositories — không thể mở local folder từ máy tính. Để bắt đầu, bạn cần connect GitHub account và chọn repo muốn làm việc. Ưu điểm lớn nhất của Web: chạy trên Anthropic infrastructure, không tốn tài nguyên máy bạn, và có thể chạy multiple parallel sessions — mỗi repo một session, cùng lúc, từ browser. Slack integration (ra mắt tháng 12/2025) cũng build trên nền tảng tương tự — cho phép bạn delegate tasks cho Claude Code ngay từ Slack channel mà không cần mở terminal.

​
So sánh 5 surfaces

Tiêu chíTerminalVS CodeJetBrainsDesktopWeb
Setup time~30 giây~3 phút~3 phút~5 phút0 (browser)
Feature ship speed⭐⭐⭐ Nhanh nhất⭐⭐ Nhanh⭐⭐ Nhanh⭐ Chậm hơn⭐ Chậm hơn
Auto-update✅ (curl/npm)✅ Extension✅ Plugin✅ App store✅ Luôn mới nhất
Background tasks⬜ Cần tmux/tab⬜ Cần tab mới⬜ Cần tab mới✅ Native✅ Native
Multi-session✅ Nhiều terminal⬜ Cần worktree⬜ Cần worktree✅ Nhiều cửa sổ✅ Parallel
Local files✅ Bất kỳ folder✅ Bất kỳ folder✅ Bất kỳ folder✅ Bất kỳ folder❌ GitHub only
GitHub-only❌ Không bắt buộc❌ Không bắt buộc❌ Không bắt buộc❌ Không bắt buộc✅ Bắt buộc
Ideal choDev mọi cấp độDev dùng VS CodeIntelliJ/AndroidNon-technical, designDistributed team, mobile work
Tóm gọn:
  • Muốn features mới nhất → Terminal
  • Thích Claude tích hợp vào editor → VS Code hoặc JetBrains
  • Không quen terminal, muốn GUI → Desktop
  • Muốn làm từ xa, nhiều task song song trên cloud → Web

​
Ví dụ step-by-step: Cài Claude Code lần đầu trên macOS

Dưới đây là walkthrough đầy đủ từ lúc bạn chưa có gì đến lúc gõ được prompt đầu tiên.

​
Bước 1: Cài Claude Code bằng curl

Mở Terminal (macOS Terminal, iTerm2, hoặc bất kỳ terminal nào bạn dùng) và chạy: 
curl -fsSL https://claude.ai/install.sh | sh
Script sẽ chạy trong khoảng 15-30 giây. Khi xong, bạn sẽ thấy thông báo thành công và hướng dẫn restart terminal nếu cần. Verify cài đặt: 
claude --version
# Output: claude 1.x.x (hoặc version hiện tại)

​
Bước 2: Mở project và khởi động Claude Code

Điều quan trọng: luôn cd vào project trước khi gõ claude. Claude Code sẽ có access vào thư mục bạn chạy lệnh và tất cả subfolders bên trong. 
cd ~/projects/my-app # hoặc bất kỳ project folder nào bạn có
claude

​
Bước 3: Chọn theme và đăng nhập

Lần đầu chạy, Claude Code sẽ hỏi:
  • Theme: Chọn màu sắc bạn thích (dark/light/một số theme khác)
  • Login method: Bạn sẽ thấy 4 lựa chọn:
How would you like to authenticate?

1. Sign in with Claude Pro / Max subscription
2. Use Anthropic API key
3. Use with third-party OAuth (e.g. Google Workspace)
4. Use Enterprise account (SSO)
Chọn lựa chọn nào?
  • Claude Pro ($20/tháng): Phù hợp cho cá nhân, indie hacker, người mới học. Có giới hạn usage nhưng đủ cho phần lớn nhu cầu học tập.
  • Claude Max (~100/thaˊngtrởle^n):Unlimitedusage—phuˋhợpkhibạnduˋngnặng(heavyengineeringwork,nhie^ˋugiờmo^~ingaˋy).Ướctıˊnhthựcte^ˊ:heavyuserto^ˊn 100/tháng trở lên): Unlimited usage — phù hợp khi bạn dùng nặng (heavy engineering work, nhiều giờ mỗi ngày). Ước tính thực tế: heavy user tốn ~50/tháng với API key, Max subscription thường rẻ hơn mức đó nếu dùng nhiều.
  • API key: Dành cho developer muốn control billing chi tiết, hoặc tích hợp Claude Code vào pipeline tự động.
  • Enterprise: Nếu công ty bạn có Claude Enterprise account — bắt buộc phải chọn option này, không dùng Pro/Max cá nhân (sai billing, sai audit trail).
Nếu đang học và chưa quyết định, Pro subscription là điểm khởi đầu tốt nhất.

​
Bước 4: Prompt đầu tiên để test

Sau khi đăng nhập, bạn sẽ thấy prompt của Claude Code: 
>
Thử gõ: 
describe this codebase in 5 sentences
Claude Code sẽ explore project folder của bạn (đọc file structure, README, các file chính) và trả về mô tả ngắn gọn. Nếu bạn thấy Claude đọc được file và mô tả đúng project — cài đặt thành công. ⚠️ Cảnh báo về file access: Bất kỳ thư mục nào bạn cd vào trước khi gõ claude, Claude Code sẽ có access đầy đủ vào thư mục đó và tất cả subfolders bên trong. Nếu bạn chạy claude từ HOME( ),Claudese~coˊthểđọcmọifiletronghomedirectorycủabạn—baogo^ˋm.ssh/,.aws/credentials,vaˋcaˊcfilenhạycảmkhaˊc.Luo^nchạyClaudeCodetừprojectfoldercụthể,kho^ngphảitừHOME (~), Claude sẽ có thể đọc mọi file trong home directory của bạn — bao gồm .ssh/, .aws/credentials, và các file nhạy cảm khác. Luôn chạy Claude Code từ project folder cụ thể, không phải từ HOME.

​
Case studies theo role

​
Indie hacker — laptop cá nhân, solo project

Profile: Full-stack developer tự xây SaaS cá nhân, làm một mình, cần đơn giản và rẻ. Setup:
  • Cài Claude Code qua curl trên macOS laptop cá nhân
  • Login với Claude Pro ($20/tháng) — đủ cho ~2-3 giờ coding mỗi ngày
  • Dùng terminal vì đã quen, không cần thêm layer nào
Workflow hàng ngày: 
cd ~/projects/my-saas
claude
> implement the user profile edit page according to the design in docs/design/profile.md
Chi phí thực tế: ~20/thaˊng(Pro)hoặc20/tháng (Pro) hoặc 50/tháng (nếu dùng API key, heavy use). Với Max unlimited, tối ưu hơn khi làm full-time trên project.

​
Engineering lead — team 8 người, startup fintech

Profile: Lead một team, cần đảm bảo audit trail, billing đúng entity, và không có thành viên nào dùng account cá nhân cho code công ty. Setup:
  • Công ty có Claude Enterprise account — tất cả thành viên login với Enterprise option
  • Cài terminal version trên máy mỗi người
  • Mỗi người cd vào project folder cụ thể (không chạy từ $HOME)
  • CLAUDE.md ở project root để Claude tự biết coding standards (sẽ học chi tiết ở Bài 2.7)
Tại sao không dùng Pro cá nhân:
  • Enterprise account có audit log — biết ai dùng Claude làm gì, khi nào
  • Billing theo organization, không theo cá nhân
  • Compliance requirement của fintech: phải biết data đi đâu

​
Designer (non-technical) — ship code lần đầu

Profile: Product designer với 5 năm kinh nghiệm Figma, muốn tự ship 2% polish design (margin, spacing, animation) sau khi engineer handoff feature — không phải học terminal từ đầu. Setup:
  • Download Claude Desktop app — visual hơn, không cần gõ lệnh để khởi động
  • Login với Pro account
  • Click vào folder project (đã clone Git repo trước đó)
  • Dùng Claude để điều chỉnh CSS, spacing, màu sắc
Quote thực tế từ team Anthropic: “I can push code to production. Make changes I want in live codebase” — Megan, designer tại Anthropic. Claude Code mở ra một “skill tree” mới cho non-technical folks.

​
Mobile developer — Android Studio, IntelliJ

Profile: Android developer, dùng Android Studio fulltime, không muốn chuyển ra terminal để dùng Claude. Setup:
  • Cài Claude Code plugin từ JetBrains Marketplace trong Android Studio
  • Restart IDE
  • Claude Code chạy ngay trong pane bên cạnh editor — vừa code Kotlin, vừa chat với Claude trong cùng một cửa sổ
Workflow:
  • Highlight một block code phức tạp, hỏi Claude giải thích
  • Prompt Claude implement một ViewModel theo pattern đã có trong codebase
  • Không cần rời khỏi Android Studio

​
Remote / distributed team — làm việc trên nhiều máy, nhiều timezone

Profile: Team 5 người, mỗi người ở múi giờ khác nhau, cần làm việc async trên cùng GitHub repo mà không cần máy local mạnh. Setup:
  • Dùng Web version (claude.ai/code)
  • Connect GitHub account và chọn repo
  • Mỗi người mở session riêng — có thể chạy parallel sessions: dev A làm feature branch, dev B fix bug trên branch khác, cùng lúc
Ưu điểm so với terminal:
  • Không cần setup local environment
  • Chạy trên Anthropic infrastructure — máy yếu vẫn dùng được
  • Slack integration (tháng 12/2025): delegate task cho Claude ngay từ Slack, không cần mở browser

​
Anti-patterns

​
Anti-pattern 1: Cài Homebrew/winget mà không biết không có auto-update

Triệu chứng: Cài brew install claude-code vì quen dùng Homebrew, 3 tháng sau không nhận ra mình đang dùng version cũ 15 releases. Tại sao tệ: Claude Code ra features mới liên tục. Dùng version cũ nghĩa là bạn thiếu tính năng quan trọng (Plan Mode improvements, hook system, MCP updates…) mà người khác đã có. Cách đúng:
  • Ưu tiên curl hoặc npm để có auto-update
  • Nếu nhất định dùng Homebrew: set reminder hàng tuần chạy brew upgrade claude-code
  • Check version hiện tại bất cứ lúc nào: claude —version

​
Anti-pattern 2: Chạy claude từ home directory ($HOME)

Triệu chứng: Mở terminal, không cd vào đâu, gõ thẳng claude. Hoặc cd ~ rồi claude. Tại sao tệ: Claude Code có access vào toàn bộ home directory của bạn — bao gồm .ssh/id_rsa, .aws/credentials, .env files có API keys, database passwords, và bất kỳ file nhạy cảm nào trong ~/Documents, ~/Downloads. Claude Code sẽ không tự ý đọc những file đó khi không cần thiết — nhưng nếu bạn prompt sai, hoặc có lỗi trong workflow, nguy cơ exposure là thật. Cách đúng: 
# ĐÚNG
cd ~/projects/my-app && claude

# SAI
cd ~ && claude # hoặc chỉ gõ claude từ $HOME
Luôn scope Claude Code vào project folder cụ thể.

​
Anti-pattern 3: Login bằng Pro account khi org có Enterprise

Triệu chứng: Công ty có Enterprise account nhưng bạn dùng luôn Pro cá nhân vì “tiện hơn, không cần hỏi IT”. Tại sao tệ:
  • Code công ty đi qua account cá nhân của bạn — sai compliance
  • Billing không thuộc về organization — sai accounting
  • Không có audit trail — IT và security team không biết gì
  • Nếu bạn nghỉ việc, không có cách revoke access
Cách đúng: Liên hệ IT hoặc Engineering Manager, lấy thông tin Enterprise login. Chọn “Enterprise account (SSO)” khi setup Claude Code.

​
Anti-pattern 4: Cài VS Code extension từ author không phải Anthropic

Triệu chứng: Tìm “Claude Code” trong VS Code marketplace, thấy vài extension tương tự, cài cái nào có rating cao mà không check author. Tại sao tệ: Có nhiều extension giả mạo hoặc không chính thức tên tương tự. Những extension này có thể:
  • Không có tính năng thật của Claude Code
  • Send prompts của bạn đến server không rõ nguồn gốc
  • Có security vulnerabilities
Cách đúng: Trong VS Code marketplace, bắt buộc phải thấy:
  • Author: Anthropic (không phải “anthropic-community”, “claude-fan”, hay bất kỳ tên nào khác)
  • Blue verification check (verified publisher)
  • Link về anthropic.com
Nếu không thấy dấu tích xanh từ Anthropic — đừng cài.

​
Anti-pattern 5: Mix terminal + IDE đồng thời cùng một project

Triệu chứng: Mở Claude Code trong VS Code extension, đồng thời mở terminal và chạy claude trên cùng project folder. Hai instance Claude Code đang “nhìn” cùng một set file. Tại sao tệ: Hai instance có thể:
  • Cùng mở file để sửa → conflict
  • File watcher của cả hai trigger lẫn nhau → infinite loop events
  • Một instance không biết instance kia đã sửa gì → stale context
Cách đúng: Chọn một surface và stick với nó trong một session. Nếu muốn chạy parallel trên cùng project, dùng git worktrees — mỗi worktree là một checkout riêng biệt, không conflict. 
# Setup worktree cho parallel work đúng cách
git worktree add ../my-app-feature-b feature-b
# Sau đó mở terminal mới, cd vào ../my-app-feature-b, chạy claude

​
Áp dụng ngay

​
Bài tập 1 (10 phút): Cài Claude Code và prompt đầu tiên

Mục tiêu: Cài xong, đăng nhập, và nhận được output từ Claude Code trong một project thật. Bước 1: Chọn surface phù hợp với bạn từ bảng so sánh ở trên. Nếu không chắc, chọn Terminal. Bước 2: Cài theo hướng dẫn trong bài — dùng curl (macOS/Linux) hoặc PowerShell (Windows). Bước 3: cd vào một project nhỏ bạn đang có (một repo bất kỳ — side project, homework, thứ gì đó bạn quen). Nếu chưa có project nào, clone một repo mẫu: 
git clone https://github.com/anthropics/anthropic-quickstarts
cd anthropic-quickstarts
Bước 4: Chạy claude, hoàn thành login setup. Bước 5: Gõ prompt đầu tiên: 
describe this codebase in 5 sentences
Ghi chú: Claude đọc được bao nhiêu file? Mô tả có đúng với codebase không? Bao lâu thì có response?

​
Bài tập 2 (5 phút): Khám phá các mode với Shift+Tab

Mục tiêu: Quan sát sự khác biệt giữa các mode — sẽ học chi tiết ở Bài 2.3. Bước 1: Trong session Claude Code vừa mở (Bài tập 1), gõ một prompt đơn giản: 
what files are in this project?
Quan sát output. Ghi nhớ cách Claude trả lời. Bước 2: Bấm Shift+Tab một lần. Bạn sẽ thấy mode thay đổi (có thể thấy label ở góc màn hình). Bước 3: Gõ lại cùng prompt: 
what files are in this project?
Bước 4: So sánh output của hai mode. Bạn thấy gì khác nhau? Đây là preview của Bài 2.3 — nơi bạn sẽ học về 3 permission modes (Normal, Auto-accept, Plan Mode) và khi nào dùng mỗi mode.

​
Tóm tắt

🎯 Claude Code cài trong 30 giây — một dòng curl trên macOS/Linux, một lệnh PowerShell trên Windows. Không config endpoint, không cài dependency phức tạp. 🎯 5 surfaces cho 5 workflow khác nhau: Terminal (cutting edge, recommended), VS Code (IDE integration), JetBrains (mobile/backend dev), Desktop (GUI, non-technical), Web (cloud, GitHub-only, parallel sessions). 🎯 Chọn authentication đúng với hoàn cảnh: Pro cho cá nhân, Max cho heavy user, API key cho control chi tiết, Enterprise nếu org có — không được mix. Chi phí thực tế: ~$50/tháng với heavy API use, Max subscription thường rẻ hơn mức đó. 🎯 Luôn cd vào project folder trước khi chạy claude — không bao giờ chạy từ $HOME. Claude có access vào toàn bộ thư mục và subfolders. 🎯 Cài bằng curl hoặc npm để có auto-update. Homebrew và winget không tự update — dùng chỉ khi bạn sẵn sàng update thủ công.

​
Bài tiếp theo

Bạn đã cài xong Claude Code và gõ được prompt đầu tiên. Nhưng chỉ biết gõ là chưa đủ — quan trọng hơn là biết gõ đúng cách và hiểu Claude đang phản ứng như thế nào với từng kiểu prompt. Bài 2.3 sẽ đi sâu vào ba permission modes (Normal Mode, Auto Accept Mode, Plan Mode), khi nào dùng Shift+Tab, và cách viết prompt hiệu quả từ ngày đầu tiên — bao gồm 5 prompt templates cho các tình huống phổ biến nhất. Nếu bạn tò mò về cách tối ưu file CLAUDE.md sau khi cài đặt — để Claude tự biết coding standards và project conventions của bạn ngay từ đầu mỗi session — xem trước Bài 2.7: File CLAUDE.md. ➡️ Bài tiếp theo: Bài 2.3 — Prompt đầu tiên và các permission modes

​
Tài liệu tham khảo

  • Installing Claude Code — Official installation guide
  • Claude Code in VS Code — VS Code Marketplace (verified Anthropic publisher)
  • Claude Code in JetBrains — JetBrains Marketplace
  • claude.ai/code — Web version
  • Claude pricing — Pro, Max, API key, Enterprise
  • Transcript: “A Conversation on Claude Code” — Boris Cherny, Anthropic (install command, IDE preference, cost reality)
  • Transcript: “Designing Claude Code” — Megan, Designer at Anthropic (non-technical use case)
Khoá học “Claude Code 101” — bản tiếng Việt v1.0 Bản quyền 2026 Anthropic. Mọi quyền được bảo lưu.