
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:
| Configuration | Description | How to Obtain |
|---|---|---|
| ANTHROPIC_AUTH_TOKEN | API authentication token | Create a token on the API Tokens page (starts with sk-) |
| ANTHROPIC_BASE_URL | API service address | Use https://crazyrouter.com/ |
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:
- Select Theme - Chọn chủ đề màu ưa thích và nhấn Enter
- Safety Notice - Xem và xác nhận thông báo an toàn
- Terminal Configuration - Dùng cấu hình mặc định hoặc tùy chỉnh
- 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ớisk-)ANTHROPIC_BASE_URLđược đặt thànhhttps://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ử:
- Thoát Claude Code (Ctrl+C)
- Chạy lại lệnh
claude - 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:
| Model | Input Price | Output Price |
|---|---|---|
| claude-opus-4-5 | $2.50/1M tokens | $12.50/1M tokens |
| claude-sonnet-4-5 | $1.50/1M tokens | $7.50/1M tokens |
| claude-haiku-4-5 | $0.40/1M tokens | $2.00/1M tokens |
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#
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.


