ccs/docs/vi/installation.vi.md

Hướng Dẫn Cài Đặt CCS

Cài Đặt npm Package (Được khuyến nghị)

Cài Đặt Đa Nền Tảng

macOS / Linux / Windows

npm install -g @kaitranntt/ccs

Tương thích với tất cả các trình quản lý package:

• npm install -g @kaitranntt/ccs
• yarn global add @kaitranntt/ccs
• pnpm add -g @kaitranntt/ccs
• bun add -g @kaitranntt/ccs

Lợi ích của việc cài đặt npm:

• ✅ Tương thích đa nền tảng
• ✅ Cấu hình PATH tự động
• ✅ Tự động tạo file cấu hình qua script postinstall
• ✅ Cập nhật dễ dàng: npm update -g @kaitranntt/ccs
• ✅ Gỡ cài đặt sạch: npm uninstall -g @kaitranntt/ccs
• ✅ Hỗ trợ version pinning
• ✅ Quản lý dependencies

Những Gì Xảy Ra Trong Quá Trình Cài Đặt:

1. npm tải xuống và cài đặt package
2. Script postinstall tự động tạo ~/.ccs/config.json và ~/.ccs/glm.settings.json
3. npm tạo lệnh ccs trong PATH của bạn

Lưu ý: Nếu bạn dùng npm install --ignore-scripts, file cấu hình sẽ không được tạo. Chạy lại mà không có flag đó:

npm install -g @kaitranntt/ccs --force

Cài Đặt Một Dòng Lệnh (Truyền thống)

macOS / Linux

# URL ngắn (qua CloudFlare)
curl -fsSL ccs.kaitran.ca/install | bash

# Hoặc trực tiếp từ GitHub
curl -fsSL https://raw.githubusercontent.com/kaitranntt/ccs/main/installers/install.sh | bash

Vị Trí Cài Đặt:

• Tất Cả Hệ Thống Unix: ~/.local/bin/ccs (tự động cấu hình PATH cho bash, zsh, fish)

Windows PowerShell

# URL ngắn (qua CloudFlare)
irm ccs.kaitran.ca/install.ps1 | iex

# Hoặc trực tiếp từ GitHub
irm https://raw.githubusercontent.com/kaitranntt/ccs/main/installers/install.ps1 | iex

Cấu Hình PATH Tự Động:

• Installer tự động phát hiện shell của bạn (bash, zsh, fish)
• Thêm ~/.local/bin vào PATH trong shell profile nếu cần
• Idempotent: an toàn khi chạy nhiều lần
• Hiển thị hướng dẫn reload sau khi cài đặt

Lưu ý:

• Installer Unix hỗ trợ cả chạy trực tiếp (./install.sh) và cài đặt qua pipe (curl | bash)
• Installer Windows yêu cầu PowerShell 5.1+ (đã cài sẵn trên Windows 10+)
• Không cần sudo trên bất kỳ nền tảng nào

Cài Đặt qua Git Clone

macOS / Linux

git clone https://github.com/kaitranntt/ccs.git
cd ccs
./installers/install.sh

Windows PowerShell

git clone https://github.com/kaitranntt/ccs.git
cd ccs
.\installers\install.ps1

Lưu ý: Hoạt động với git worktrees và submodules - installer phát hiện cả thư mục .git và file .git.

Cài Đặt Thủ Công

macOS / Linux

# Tạo thư mục
mkdir -p ~/.local/bin

# Tải script
curl -fsSL https://raw.githubusercontent.com/kaitranntt/ccs/main/ccs -o ~/.local/bin/ccs
chmod +x ~/.local/bin/ccs

# Thêm vào PATH (chọn shell của bạn)
# Cho bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# Cho zsh
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Cho fish
echo 'set -gx PATH $HOME/.local/bin $PATH' >> ~/.config/fish/config.fish

Windows PowerShell

# Tạo thư mục
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.ccs"

# Tải script
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/kaitranntt/ccs/main/ccs.ps1" -OutFile "$env:USERPROFILE\.ccs\ccs.ps1"

# Thêm vào PATH (khởi động lại terminal sau)
$Path = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$Path;$env:USERPROFILE\.ccs", "User")

Những Gì Được Cài Đặt

Vị Trí Tệp Thực Thi:

• macOS / Linux: ~/.local/bin/ccs (symlink đến ~/.ccs/ccs)
• Windows: %USERPROFILE%\.ccs\ccs.ps1

Thư Mục Cấu Hình (~/.ccs/):

~/.ccs/
├── ccs                     # Tệp thực thi chính (symlink target)
├── config.json             # Cấu hình profile
├── config.json.backup      # Bản backup duy nhất (ghi đè mỗi lần cài)
├── glm.settings.json       # Profile GLM
├── VERSION                 # File version
├── uninstall.sh            # Trình gỡ cài đặt
└── .claude/                # Tích hợp Claude Code
    ├── commands/ccs.md     # meta-command /ccs
    └── skills/             # Kỹ năng delegation

Nâng Cấp CCS

macOS / Linux

# Từ git clone
cd ccs && git pull && ./install.sh

# Từ cài đặt curl
curl -fsSL ccs.kaitran.ca/install | bash

Windows PowerShell

# Từ git clone
cd ccs
git pull
.\install.ps1

# Từ cài đặt irm
irm ccs.kaitran.ca/install.ps1 | iex

Cấu Hình PATH Tự Động

Installer tự động cấu hình PATH của shell:

Shell Được Hỗ Trợ:

• bash (.bashrc hoặc .bash_profile)
• zsh (.zshrc)
• fish (.config/fish/config.fish)

Cách Hoạt Động:

1. Phát hiện shell hiện tại từ biến môi trường $SHELL
2. Kiểm tra nếu ~/.local/bin đã có trong PATH
3. Nếu chưa, thêm export phù hợp vào shell profile
4. Hiển thị hướng dẫn reload

Idempotent:

• An toàn khi chạy nhiều lần
• Kiểm tra entry PATH của CCS trước khi thêm
• Không tạo entry trùng lặp

Thiết Lập PATH Thủ Công (nếu auto-config thất bại):

Bash/Zsh:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc  # hoặc ~/.zshrc
source ~/.bashrc  # hoặc source ~/.zshrc

Fish:

echo 'set -gx PATH $HOME/.local/bin $PATH' >> ~/.config/fish/config.fish

Yêu Cầu

macOS / Linux

• bash 3.2+
• jq (trình xử lý JSON, tùy chọn cho tính năng nâng cao)
• Claude CLI

Windows

• PowerShell 5.1+ (đã cài sẵn trên Windows 10+)
• Claude CLI

Cài đặt jq (macOS / Linux, tùy chọn)

# macOS
brew install jq

# Ubuntu/Debian
sudo apt install jq

# Fedora
sudo dnf install jq

# Arch
sudo pacman -S jq

Lưu ý:

• jq nâng cao quá trình tạo profile GLM nhưng không bắt buộc
• Windows dùng JSON support có sẵn của PowerShell - không cần jq
• Installer tạo template cơ bản mà không cần jq