Hướng dẫn cài đặt và bắt đầu với Claude Code

Hướng dẫn chi tiết cài đặt Claude Code trên macOS, Linux, Windows và bắt đầu phiên làm việc đầu tiên với AI coding agent trong terminal.

Claude Code là một agentic coding tool chạy trong terminal, đọc hiểu codebase và giúp bạn code nhanh hơn thông qua lệnh ngôn ngữ tự nhiên. Hướng dẫn này cover từ cài đặt đến phiên làm việc đầu tiên.

Yêu cầu hệ thống

Trước khi cài đặt, kiểm tra máy bạn đáp ứng các yêu cầu tối thiểu:

Hệ điều hành: macOS 13.0+, Windows 10 1809+, Ubuntu 20.04+, Debian 10+, Alpine 3.19+
Phần cứng: 4 GB+ RAM, vi xử lý x64 hoặc ARM64
Mạng: kết nối internet bắt buộc
Shell: Bash, Zsh, PowerShell, hoặc CMD
Vị trí: các quốc gia được Anthropic hỗ trợ

Trên Windows, cài đặt Git for Windows để Claude Code sử dụng Bash tool. Nếu không cài, Claude sẽ dùng PowerShell thay thế.

Cài đặt Claude Code

macOS / Linux / WSL (Recommended)

Terminal

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

Windows PowerShell

PowerShell

irm https://claude.ai/install.ps1 | iex

Windows CMD

CMD

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

Nếu gặp lỗi The token '&&' is not a valid statement separator, bạn đang ở PowerShell chứ không phải CMD. Nếu thấy 'irm' is not recognized, bạn đang ở CMD. Prompt PS C:\ là PowerShell, C:\ là CMD.

Các phương pháp khác

Terminal

brew install --cask claude-code

Homebrew có 2 cask:

claude-code — bản stable (chậm hơn ~1 tuần, skip major regressions)
claude-code@latest — bản mới nhất ngay khi release

Homebrew không auto-update. Chạy brew upgrade claude-code để cập nhật thủ công.

PowerShell

winget install Anthropic.ClaudeCode

WinGet không auto-update. Chạy winget upgrade Anthropic.ClaudeCode để cập nhật.

Terminal

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

npm install hiện đã deprecated. Ưu tiên dùng Native Install hoặc Homebrew/WinGet.

Cài đặt trên Linux với package manager

Claude Code hỗ trợ apt (Debian/Ubuntu), dnf (Fedora/RHEL), và apk (Alpine):

Terminal

sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \
  -o /etc/apt/keyrings/claude-code.asc
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \
  | sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-code

Terminal

sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'
[claude-code]
name=Claude Code
baseurl=https://downloads.claude.ai/claude-code/rpm/stable
enabled=1
gpgcheck=1
gpgkey=https://downloads.claude.ai/keys/claude-code.asc
EOF
sudo dnf install claude-code

Terminal

wget -O /etc/apk/keys/claude-code.rsa.pub \
  https://downloads.claude.ai/keys/claude-code.rsa.pub
echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories
apk add claude-code

Xác minh cài đặt

Sau khi cài đặt, kiểm tra bằng lệnh:

Terminal

claude --version

Kết quả mong đợi: in ra phiên bản如 2.1.211 (Claude Code).

Để kiểm tra chi tiết hơn:

Terminal

claude doctor

claude doctor kiểm tra:

Node.js version — runtime đúng chưa
CLI installation — binary hoạt động chưa
Git config — user.name, user.email
MCP servers — kết nối
Permissions — sandbox, file permissions
Disk space — đủ cho context cache

Đăng nhập tài khoản

Claude Code yêu cầu tài khoản Claude (Pro, Max, Team, Enterprise) hoặc Console account. Chạy claude lần đầu sẽ được hướng dẫn đăng nhập:

Terminal

cd /path/to/your/project
claude

Trình duyệt sẽ mở ra để hoàn tất xác thực. Để chuyển tài khoản sau này, gõ /login bên trong session.

Tài khoản Claude Pro, Max, Team, hoặc Enterprise — recommended.

API access với credits prepaid. Khi login lần đầu, Console tự tạo workspace "Claude Code" để track chi phí.

Amazon Bedrock, Google Cloud Agent Platform, hoặc Microsoft Foundry — cho enterprise.

Cấu hình Release Channel

Claude Code kiểm tra update khi khởi động và chạy periodic. Cấu hình channel bằng autoUpdatesChannel trong settings:

Nhận feature mới ngay khi release.

Bản ~1 tuần tuổi, skip releases có major regressions. Phù hợp cho production.

settings.json

{
  "autoUpdatesChannel": "stable"
}

Tắt auto-update

settings.json

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

DISABLE_AUTOUPDATER chỉ dừng background check. claude update vẫn hoạt động. Để block tất cả, dùng DISABLE_UPDATES.

Cập nhật thủ công

Terminal

claude update

Gỡ cài đặt

Terminal

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

PowerShell

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Terminal

brew uninstall --cask claude-code

Để xóa toàn bộ settings và cached data:

Lệnh này xóa tất cả settings, allowed tools, MCP servers, và session history.

macOS / Linux

rm -rf ~/.claude
rm ~/.claude.json
rm -rf .claude
rm -f .mcp.json

Tài liệu tham khảo

TrướcClaude Code trên các nền tảng Tiếp theoClaude Code cho người mới bắt đầu

Cập nhật lần cuối 22 ngày trước