Claude Code - VibeCodeCheap

Claude Code là công cụ coding agent chạy trong terminal, hiểu codebase của bạn và giúp bạn code nhanh hơn thông qua các lệnh ngôn ngữ tự nhiên - thực thi các tác vụ routine, giải thích code phức tạp và xử lý git workflows. Claude Code còn mạnh mẽ hơn với Coding Plan — gói Pro nhiều hơn Claude Pro (20 USD/tháng), gói Max nhiều hơn Claude Max (200 USD/tháng). Code nhanh hơn, debug thông minh hơn và quản lý workflows liền mạch với nhiều tokens hơn và độ tin cậy cao.

Bước 1: Cài đặt Claude Code

Recommended Installation
Cursor Guided Installation

Yêu cầu: Node.js 18 hoặc mới hơn

# Cài đặt Claude Code
npm install -g @anthropic-ai/claude-code

Nếu bạn chưa quen với npm nhưng có Cursor, bạn có thể nhập lệnh trong Cursor để được hướng dẫn cài đặt:

https://docs.anthropic.com/en/docs/claude-code/overview
Giúp tôi cài đặt Claude Code

Nếu gặp lỗi permission trong quá trình cài đặt, thử sử dụng sudo (MacOS/Linux) hoặc chạy command prompt với quyền administrator (Windows).

Bước 2: Cấu hình Coding Plan

Lấy API Key

Truy cập VibeCodeCheap Open Platform, Đăng ký hoặc Đăng nhập.
Tạo API Key trong trang API Keys.
Sao chép API Key để sử dụng.

Cấu hình Environment Variables

Có 2 cách cấu hình: qua file settings.json (khuyến nghị) hoặc qua export biến môi trường.

Cách 1: File settings.json (Khuyến nghị)
Cách 2: Export biến môi trường
Cách 3: Sử dụng --settings flag

Bước 1: Xác định đúng đường dẫn file settings.json

File cấu hình nằm ở các vị trí khác nhau tùy hệ điều hành:

Windows
macOS
Linux

Đường dẫn: %USERPROFILE%\.claude\settings.jsonVí dụ: C:\Users\YourName\.claude\settings.json

Đường dẫn: ~/.claude/settings.jsonVí dụ: /Users/YourName/.claude/settings.json

Đường dẫn: ~/.claude/settings.jsonVí dụ: /home/YourName/.claude/settings.json

Bước 2: Mở file settings.json để chỉnh sửa

Chọn một trong các cách sau để mở file:

Sử dụng lệnh claude
VS Code
Cursor
Notepad++ / Sublime / Vim
Mở thủ công

# Trên Windows (Git Bash hoặc WSL)
claude --settings "$USERPROFILE\.claude\settings.json"

# Trên macOS/Linux
claude --settings ~/.claude/settings.json

Lệnh này sẽ mở file trong editor mặc định của hệ thống. Nếu không mở được, sử dụng cách khác bên dưới.

# Trên Windows
code "%USERPROFILE%\.claude\settings.json"

# Trên macOS/Linux
code ~/.claude/settings.json

# Trên Windows
cursor "%USERPROFILE%\.claude\settings.json"

# Trên macOS/Linux
cursor ~/.claude/settings.json

# Notepad++ (Windows)
notepad++ "%USERPROFILE%\.claude\settings.json"

# Sublime Text
subl ~/.claude/settings.json

# Vim
vim ~/.claude/settings.json

# Nano
nano ~/.claude/settings.json

Windows:

Mở File Explorer
Gõ %USERPROFILE%\.claude vào thanh địa chỉ
Tìm file settings.json và mở bằng Notepad hoặc editor bất kỳ

macOS/Linux:

Mở Finder/File Manager
Nhấn Cmd+Shift+G (macOS) hoặc Ctrl+H để hiện hidden files
Đi đến ~/.claude/
Mở file settings.json

Bước 3: Thêm cấu hình vào file

Thêm các trường env vào file settings.json:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your_api_key",
    "ANTHROPIC_BASE_URL": "https://api.vibecodecheap.com/v1/ai",
    "API_TIMEOUT_MS": "3000000"
  }
}

Thay your_api_key bằng API Key VibeCodeCheap của bạn và lưu file.

Xử lý sự cố thường gặp

Lệnh mở file không hoạt động hoặc mở sai file

Nguyên nhân: Lệnh code, cursor có thể chưa được thêm vào PATH, hoặc mở file ở vị trí sai.Giải pháp:

Kiểm tra file đúng vị trí:

# Windows (PowerShell)
ls $env:USERPROFILE\.claude\settings.json

# macOS/Linux
ls -la ~/.claude/settings.json

Nếu file không tồn tại, tạo thư mục và file:

# Windows (PowerShell)
mkdir -Force $env:USERPROFILE\.claude
echo '{"env":{}}' > $env:USERPROFILE\.claude\settings.json

# macOS/Linux
mkdir -p ~/.claude
echo '{"env":{}}' > ~/.claude/settings.json

Mở file bằng đường dẫn tuyệt đối:

# Windows
code "C:\Users\YourName\.claude\settings.json"

# macOS
code "/Users/YourName/.claude/settings.json"

Cấu hình không có hiệu lực sau khi lưu

Kiểm tra định dạng JSON: Dùng JSONLint để validate
Đóng tất cả terminal đang chạy Claude Code
Mở terminal mới và chạy lại claude
Chạy /status trong Claude Code để kiểm tra cấu hình

Không tìm thấy thư mục .claude

Nguyên nhân: Thư mục .claude chưa được tạo do chưa chạy Claude Code lần đầu.Giải pháp:

Chạy claude một lần (có thể exit ngay)

Hoặc tạo thủ công:

# Windows
mkdir %USERPROFILE%\.claude

# macOS/Linux
mkdir -p ~/.claude

File settings.json bị ghi đè hoặc mất cấu hình

Nguyên nhân: Claude Code có thể tự động ghi đè file settings.json trong một số trường hợp.Giải pháp:

Backup file cấu hình:

cp ~/.claude/settings.json ~/.claude/settings.json.backup

Khóa file để tránh ghi đè (chỉ khi cần thiết):

# macOS/Linux
chmod 444 ~/.claude/settings.json

# Windows (PowerShell - chạy với quyền admin)
Set-ItemProperty -Path "$env:USERPROFILE\.claude\settings.json" -Name IsReadOnly -Value $true

Mở khóa khi cần sửa:

# macOS/Linux
chmod 644 ~/.claude/settings.json

# Windows (PowerShell)
Set-ItemProperty -Path "$env:USERPROFILE\.claude\settings.json" -Name IsReadOnly -Value $false

WSL: Lỗi 'node: not found' hoặc sử dụng sai phiên bản Node

Nguyên nhân: WSL đang sử dụng Node.js của Windows thay vì Linux.Kiểm tra:

which node
which npm
# Nếu kết quả là /mnt/c/... thì đang dùng Windows Node

Giải pháp:

Cài Node.js cho Linux:

# Dùng nvm (khuyến nghị)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install --lts

# Hoặc dùng package manager
sudo apt update
sudo apt install nodejs npm

Fix PATH priority - Thêm vào ~/.bashrc hoặc ~/.zshrc:

# Đảm bảo nvm được load
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

# Ưu tiên Linux paths
export PATH="$HOME/.local/bin:/usr/local/bin:/usr/bin:$PATH"

Apply changes:
```
source ~/.bashrc
```

macOS: Lỗi permission khi sửa file hoặc chạy lệnh

Nguyên nhân: macOS có hệ thống bảo mật gatekeeper và SIP (System Integrity Protection).Giải pháp:

Cho phép terminal truy cập file:
- Mở System Settings > Privacy & Security > Full Disk Access
- Thêm Terminal.app hoặc iTerm2

Fix quyền thư mục:

sudo chown -R $(whoami) ~/.claude
chmod -R u+w ~/.claude

Cách này hữu ích khi file settings.json không hoạt động hoặc bạn muốn test nhanh.

Temporary (Chỉ trong terminal session hiện tại)

# macOS/Linux
export ANTHROPIC_AUTH_TOKEN="your_api_key"
export ANTHROPIC_BASE_URL="https://api.vibecodecheap.com/v1/ai"
export API_TIMEOUT_MS="3000000"
claude

# Windows (PowerShell)
$env:ANTHROPIC_AUTH_TOKEN="your_api_key"
$env:ANTHROPIC_BASE_URL="https://api.vibecodecheap.com/v1/ai"
$env:API_TIMEOUT_MS="3000000"
claude

Biến môi trường này chỉ tồn tại trong terminal hiện tại. Khi đóng terminal, bạn phải export lại.

Permanent (Tự động load mỗi khi mở terminal)

macOS/Linux (Bash)
macOS (Zsh - mặc định)
Windows (PowerShell)

Thêm vào file ~/.bashrc hoặc ~/.bash_profile:

# Mở file
nano ~/.bashrc
# hoặc
nano ~/.bash_profile

# Thêm vào cuối file
export ANTHROPIC_AUTH_TOKEN="your_api_key"
export ANTHROPIC_BASE_URL="https://api.vibecodecheap.com/v1/ai"
export API_TIMEOUT_MS="3000000"

# Lưu file (Ctrl+O, Enter, Ctrl+X)

# Apply changes
source ~/.bashrc
# hoặc
source ~/.bash_profile

Thêm vào file ~/.zshrc:

# Mở file
nano ~/.zshrc

# Thêm vào cuối file
export ANTHROPIC_AUTH_TOKEN="your_api_key"
export ANTHROPIC_BASE_URL="https://api.vibecodecheap.com/v1/ai"
export API_TIMEOUT_MS="3000000"

# Lưu file (Ctrl+O, Enter, Ctrl+X)

# Apply changes
source ~/.zshrc

Thêm vào PowerShell Profile:

# Kiểm tra file profile
notepad $PROFILE

# Nếu không tồn tại, tạo mới
New-Item -Path $PROFILE -Type File -Force

# Thêm vào file
$env:ANTHROPIC_AUTH_TOKEN="your_api_key"
$env:ANTHROPIC_BASE_URL="https://api.vibecodecheap.com/v1/ai"
$env:API_TIMEOUT_MS="3000000"

# Lưu và reload
. $PROFILE

Kiểm tra biến môi trường đã set

# macOS/Linux
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL

# Windows (PowerShell)
echo $env:ANTHROPIC_AUTH_TOKEN
echo $env:ANTHROPIC_BASE_URL

Nếu file settings.json ở vị trí khác hoặc bạn muốn chỉ định file cụ thể.

# Tạo file settings.json ở vị trí bất kỳ
nano ~/my-claude-config.json

# Thêm nội dung
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your_api_key",
    "ANTHROPIC_BASE_URL": "https://api.vibecodecheap.com/v1/ai",
    "API_TIMEOUT_MS": "3000000"
  }
}

# Chạy claude với --settings flag
claude --settings ~/my-claude-config.json

# Hoặc tạo alias để dùng mãi
# Thêm vào ~/.bashrc hoặc ~/.zshrc
alias claude-vcc='claude --settings ~/my-claude-config.json'

# Sau đó chỉ cần gõ
claude-vcc

Bước 3: Bắt đầu với Claude Code

Sau khi cấu hình xong, bạn có thể bắt đầu sử dụng Claude Code trong terminal:

cd your-project-directory
claude

Nếu bạn dùng Windown, bạn cần chạy lệnh claude bằng Git Bash hoặc Ubuntu (WSL) cho lần đầu tiên.

Khi chạy Claude Code lần đầu, bạn có thể thấy hộp thoại yêu cầu xác nhận quyền truy cập thư mục:

Do you trust the files in this folder?

 Claude Code may read, write, or execute files contained in this directory. 
 This can pose security risks, so only use files from trusted sources.

 ❯ 1. Yes, proceed
   2. No, exit

Chọn “Yes, proceed” và nhấn Enter để cho phép Claude Code truy cập và làm việc với các file trong thư mục dự án của bạn.

FAQ

Cách Chuyển Đổi Model Đang Sử Dụng

Mapping giữa các environment variables model nội bộ của Claude Code và models:

Model	Multiplier	Context
`claude-sonnet-4-5`	1x	200K tokens
`claude-sonnet-4-5-20250929`	1x	200K tokens
`claude-opus-4-5-20251101`	2x	200K tokens
`gpt-5-mini`	0x (Miễn phí sử dụng)	128K tokens
`glm-4.6`	0x (Miễn phí sử dụng)	200K tokens
`glm-4.7`	0x (Miễn phí sử dụng)	200K tokens

gpt-5-mini, glm-4.6 và glm-4.7 là các model miễn phí sử dụng không giới hạn khi đăng ký gói Coding Plan tại VibeCodeCheap.

Nếu cần điều chỉnh, bạn có thể trực tiếp sửa file cấu hình ~/.claude/settings.json:

Claude Models
GPT-5 Mini
GLM 4.6
GLM 4.7

{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5-20250929",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-5-20251101"
  }
}

{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-5-mini",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5-mini",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-5-mini"
  }
}

{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.6",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.6"
  }
}

{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.7"
  }
}

Cách Kiểm Tra Trạng Thái Model Hiện Tại

Mở terminal mới và chạy claude, nhập /status để kiểm tra trạng thái model hiện tại.

Hoặc nhập /models để xem danh sách tất cả các model có sẵn.
Hoặc nhập /help để xem tất cả các lệnh có sẵn.

Cấu Hình Thủ Công Không Hoạt Động

Nếu bạn đã sửa file ~/.claude/settings.json nhưng thay đổi không có hiệu lực:

Đóng tất cả cửa sổ Claude Code, mở terminal mới và chạy lại claude.
Nếu vẫn không được, thử xóa file ~/.claude/settings.json và cấu hình lại.
Xác nhận format JSON chính xác, kiểm tra tên biến và đảm bảo không thiếu hoặc thừa dấu phẩy.

Phiên Bản Claude Code Khuyến Nghị

Chúng tôi khuyến nghị sử dụng phiên bản mới nhất của Claude Code:

# Kiểm tra phiên bản hiện tại
claude --version

# Nâng cấp lên phiên bản mới nhất
claude update

​Bước 1: Cài đặt Claude Code

​Bước 2: Cấu hình Coding Plan

​Bước 1: Xác định đúng đường dẫn file settings.json

​Bước 2: Mở file settings.json để chỉnh sửa

​Bước 3: Thêm cấu hình vào file

​Xử lý sự cố thường gặp

​Temporary (Chỉ trong terminal session hiện tại)

​Permanent (Tự động load mỗi khi mở terminal)

​Kiểm tra biến môi trường đã set

​Bước 3: Bắt đầu với Claude Code

​FAQ

​Cách Chuyển Đổi Model Đang Sử Dụng

​Cách Kiểm Tra Trạng Thái Model Hiện Tại

​Cấu Hình Thủ Công Không Hoạt Động

​Phiên Bản Claude Code Khuyến Nghị

Bước 1: Cài đặt Claude Code

Bước 2: Cấu hình Coding Plan

Bước 1: Xác định đúng đường dẫn file settings.json

Bước 2: Mở file settings.json để chỉnh sửa

Bước 3: Thêm cấu hình vào file

Xử lý sự cố thường gặp

Temporary (Chỉ trong terminal session hiện tại)

Permanent (Tự động load mỗi khi mở terminal)

Kiểm tra biến môi trường đã set

Bước 3: Bắt đầu với Claude Code

FAQ

Cách Chuyển Đổi Model Đang Sử Dụng

Cách Kiểm Tra Trạng Thái Model Hiện Tại

Cấu Hình Thủ Công Không Hoạt Động

Phiên Bản Claude Code Khuyến Nghị