Hướng Dẫn Cài Đặt và Sử Dụng Claude Code - Thiết Lập Trợ Lý Lập Trình AI

Claude Code là một trợ lý lập trình AI mạnh mẽ cho phép bạn cộng tác với AI trực tiếp trong terminal. Hướng dẫn này sẽ đưa bạn qua quy trình cài đặt và cấu hình.

Yêu Cầu Hệ Thống#

Trước khi cài đặt Claude Code, hãy đảm bảo hệ thống của bạn đáp ứng các yêu cầu sau:

• Node.js: Phiên bản 18.0 trở lên
• Hệ điều hành: macOS, Linux, hoặc Windows (khuyến nghị dùng WSL)

Bắt Đầu Nhanh#

Bước 1: Cài đặt Node.js#

Nếu bạn đã cài đặt Node.js 18.0 trở lên, bạn có thể bỏ qua bước này.

Ubuntu / Debian#

# Install Node.js LTS version
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
sudo apt-get install -y nodejs

# Verify installation
node --version

macOS#

# Install Xcode command line tools
sudo xcode-select --install

# Install Homebrew (if not already installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Node.js via Homebrew
brew install node

# Verify installation
node --version

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

Cài đặt Claude Code toàn cục bằng npm:

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

# Verify installation
claude --version

Bước 3: Cấu hình Truy cập API#

Bạn cần hai mục cấu hình để sử dụng Claude Code với Crazyrouter API:

Thiết lập token khuyến nghị:

• Name: Bất kỳ tên mô tả nào
• Quota: Đặt không giới hạn cho môi trường phát triển
• Group: Chọn "Claude Code" hoặc "Official Claude 3+"
• Các tùy chọn khác: Giữ thiết lập mặc định

Bước 4: Khởi chạy Claude Code#

Linux / macOS#

# Navigate to your project directory
cd your-project-folder

# Set environment variables
export ANTHROPIC_AUTH_TOKEN=sk-your-token-here
export ANTHROPIC_BASE_URL=https://crazyrouter.com/
export API_TIMEOUT_MS=300000

# Launch Claude Code
claude

Windows PowerShell#

# Navigate to your project directory
cd your-project-folder

# Set environment variables
$env:ANTHROPIC_BASE_URL = "https://crazyrouter.com/"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-token-here"
$env:API_TIMEOUT_MS = "300000"

# Launch Claude Code
claude

Windows CMD#

# Navigate to your project directory
cd your-project-folder

# Set environment variables
set ANTHROPIC_BASE_URL=https://crazyrouter.com/
set ANTHROPIC_AUTH_TOKEN=sk-your-token-here
set API_TIMEOUT_MS=300000

# Launch Claude Code
claude

Bước 5: Cấu hình Lần Chạy Đầu Tiên#

Sau khi khởi chạy Claude Code lần đầu, bạn sẽ thấy các bước cấu hình sau:

1. Select Theme - Chọn chủ đề màu ưa thích và nhấn Enter
2. Safety Notice - Xem và xác nhận thông báo an toàn
3. Terminal Configuration - Dùng cấu hình mặc định hoặc tùy chỉnh
4. Working Directory Trust - Tin cậy thư mục hiện tại để cho phép truy cập file

Chúc mừng! Giờ bạn đã sẵn sàng bắt đầu lập trình với người bạn đồng hành lập trình AI của mình.

Cấu hình Vĩnh viễn (Tùy chọn)#

Để tránh phải thiết lập biến môi trường mỗi lần, hãy thêm chúng vào file cấu hình shell của bạn:

Bash (~/.bashrc hoặc ~/.bash_profile)#

export ANTHROPIC_AUTH_TOKEN=sk-your-token-here
export ANTHROPIC_BASE_URL=https://crazyrouter.com/
export API_TIMEOUT_MS=300000

Zsh (~/.zshrc)#

export ANTHROPIC_AUTH_TOKEN=sk-your-token-here
export ANTHROPIC_BASE_URL=https://crazyrouter.com/
export API_TIMEOUT_MS=300000

Sau khi thêm, hãy tải lại shell của bạn:

source ~/.bashrc  # or source ~/.zshrc

Câu Hỏi Thường Gặp#

Lỗi "Invalid API Key"#

Nếu bạn thấy "Invalid API Key - Please run /login", hãy kiểm tra:

• ANTHROPIC_AUTH_TOKEN được thiết lập đúng (bắt đầu với sk-)
• ANTHROPIC_BASE_URL được đặt thành https://crazyrouter.com/
• Khởi động lại terminal sau khi thiết lập biến môi trường

Trạng thái "Offline"#

Claude Code kiểm tra trạng thái mạng bằng cách kết nối tới Google. Hiển thị "offline" không ảnh hưởng đến việc sử dụng bình thường - nó chỉ cho biết không thể kết nối tới các máy chủ của Google.

Lỗi Web Fetch#

Claude Code thực hiện các kiểm tra bảo mật trước khi truy cập trang web. Hãy đảm bảo:

• Kết nối internet ổn định
• Sử dụng proxy toàn cục nếu cần thiết

Lỗi "Fetch Failed" Liên Tục#

Điều này có thể do sự cố mạng. Hãy thử:

1. Thoát Claude Code (Ctrl+C)
2. Chạy lại lệnh claude
3. Nếu vấn đề vẫn tiếp diễn, hãy thử lại sau

Lỗi API#

Nếu bạn gặp lỗi API:

• Thoát Claude Code (Ctrl+C)
• Chờ một lúc và khởi động lại
• Kiểm tra hạn mức token của bạn trên dashboard

Lưu Ý Quan Trọng#

• Crazyrouter cung cấp chuyển tiếp trực tiếp tới các dịch vụ Claude Code chính thức
• Giữ API token của bạn an toàn và không bao giờ chia sẻ công khai
• Theo dõi mức sử dụng của bạn trên dashboard để tránh chi phí ngoài ý muốn

Giá#

Claude Code sử dụng các model Claude với mức giá sau trên Crazyrouter:

Tất cả mức giá đã bao gồm chiết khấu 45% so với giá chính thức.

Tài Nguyên Liên Quan#

• Crazyrouter Pricing Page
• Claude Code Official Documentation
• Node.js Official Website

Cần hỗ trợ? Hãy liên hệ bộ phận hỗ trợ hoặc xem thêm tại Crazyrouter documentation để biết thêm thông tin.