Cài đặt Claude Code

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:

Surface 1: Terminal (Recommended)

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):

Đâ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):

┌─────────────────────────────────────────────────────────────────────┐
│              5 SURFACES CỦA CLAUDE CODE                             │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│   1. TERMINAL ──────── curl / brew / npm / winget                   │
│      (Recommended)     macOS · Linux · WSL · Windows                │
│      ↑ Features ship here FIRST                                     │
│                                                                     │
│   2. VS CODE ─────────── Extension Marketplace                      │
│      (IDE-integrated)  Anthropic verified · blue check              │
│                                                                     │
│   3. JETBRAINS ──────── Plugin Marketplace                          │
│      (IDE-integrated)  IntelliJ · Android Studio · GoLand...        │
│                                                                     │
│   4. DESKTOP ─────────── claude.ai → download                       │
│      (Visual/GUI)      Mac · Windows · background tasks             │
│                                                                     │
│   5. WEB ─────────────── claude.ai/code                             │
│      (Cloud/GitHub)    GitHub repos only · parallel sessions        │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

curl -fsSL https://claude.ai/install.sh | sh

Surface 1: Terminal (Recommended)

Cách 3 — Homebrew (macOS):

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

5 cách cài đặt Claude Code (tiếp)

Windows (không dùng WSL)

Cách 1 — PowerShell (có auto-update):

brew install claude-code

5 cách cài đặt Claude Code (tiếp)

Cách 2 — CMD (curl):

Invoke-RestMethod https://claude.ai/install.ps1 | Invoke-Expression

5 cách cài đặt Claude Code (tiếp)

Cách 3 — winget:

curl -fsSL https://claude.ai/install.bat -o install.bat && install.bat

5 cách cài đặt Claude Code (tiếp)

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ở.

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:

Đâ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.

• 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

winget install Anthropic.ClaudeCode

So sánh 5 surfaces

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:

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:

curl -fsSL https://claude.ai/install.sh | sh

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

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.

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

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:

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

Chọn lựa chọn nào?

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:

• 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/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).

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)

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

Thử gõ:

> 

Ví dụ step-by-step: Cài Claude Code lần đầu trên macOS (tiếp)

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.

describe this codebase in 5 sentences

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:

Workflow hàng ngày:

Chi phí thực tế: ~$20/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:

Tại sao không dùng Pro cá nhân:

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:

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:

Workflow:

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:

Ưu điểm so với terminal:

• 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
• 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)
• 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
• 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
• 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ổ
• 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
• 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
• 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

cd ~/projects/my-saas
claude
> implement the user profile edit page according to the design in docs/design/profile.md

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:

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:

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ệ:

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ể:

Cách đúng: Trong VS Code marketplace, bắt buộc phải thấy:

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á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.

• Ư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
• 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
• 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
• 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
• 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

# ĐÚNG
cd ~/projects/my-app && claude

# SAI
cd ~ && claude    # hoặc chỉ gõ claude từ $HOME

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

# 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:

Bước 4: Chạy claude, hoàn thành login setup.

Bước 5: Gõ prompt đầu tiên:

git clone https://github.com/anthropics/anthropic-quickstarts
cd anthropic-quickstarts

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

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:

describe this codebase in 5 sentences

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

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?

Áp dụng ngay (tiếp)

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.

what files are in this project?

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.