Công cụ lập trình AI (Coding Tools)
Claude Code CLI
Đọc ~5 phút
Tại sao nên dùng Claude Code qua Kandes?
Claude Code là trợ lý lập trình terminal chính thức của Anthropic. Khi sử dụng qua Kandes Gateway, bạn được dùng đầy đủ các model mạnh nhất (Claude 3.7 Sonnet với Extended Thinking), trả theo token thực tế rẻ hơn nhiều so với việc duy trì tài khoản Claude Team/Enterprise.
1
Cài đặt Node.js và Claude Code CLI
Môi trườngYêu cầu máy tính có cài sẵn Node.js phiên bản 18 trở lên.
Mở Terminal (hoặc PowerShell trên Windows) và chạy lệnh cài đặt toàn cục:
npm install -g @anthropic-ai/claude-code2
Cấu hình Biến Môi Trường (Environment Variables)
Bước quan trọng nhấtKhai báo Base URL của Kandes và API Key để Claude Code trỏ về Gateway thay vì máy chủ Anthropic.
Bắt buộc dùng ANTHROPIC_AUTH_TOKEN
Khi dùng bên thứ ba, bạn PHẢI đặt biến
ANTHROPIC_AUTH_TOKEN (không phải ANTHROPIC_API_KEY) để Claude Code bỏ qua bước mở trình duyệt yêu cầu đăng nhập tài khoản Anthropic.# 1. Thiết lập vĩnh viễn cho tài khoản Windows của bạn:
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://apistudio.kandes.shop', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'ks-your-api-key', 'User')
# 2. Hoặc chỉ gán cho phiên PowerShell hiện tại:
$env:ANTHROPIC_BASE_URL = "https://apistudio.kandes.shop"
$env:ANTHROPIC_AUTH_TOKEN = "ks-your-api-key"
# 3. Khởi chạy:
claude3
Khởi động & Chạy thử nhiệm vụ đầu tiên
Trải nghiệmKiểm tra kết nối và chuyển đổi mô hình linh hoạt.
- Di chuyển vào thư mục dự án của bạn:
cd my-project. - Gõ lệnh
claudevà nhấn Enter. - Gửi câu hỏi thử nghiệm:
Hãy tóm tắt cấu trúc thư mục hiện tại. - Cách đổi mô hình: Trong cửa sổ chat của Claude Code, bạn có thể gõ lệnh
/modelđể đổi sangclaude-3-7-sonnethoặcclaude-3-5-sonnet.
4
Xử lý sự cố thường gặp (Troubleshooting)
Giải đápCác lỗi phổ biến khi cài đặt Claude Code và cách khắc phục ngay.
Lỗi 401: Unauthorized hoặc Khóa không hợp lệ
Nguyên nhân: Khóa API bị sai, bị thừa dấu cách hoặc chưa đặt biến ANTHROPIC_AUTH_TOKEN.
Cách xử lý:
Kiểm tra lại xem bạn đã gán đúng
ANTHROPIC_AUTH_TOKEN=ks-... chưa. Đảm bảo không đặt nhầm thành ANTHROPIC_API_KEY.Claude Code liên tục mở trình duyệt đòi đăng nhập Anthropic
Nguyên nhân: Biến ANTHROPIC_AUTH_TOKEN chưa được nhận diện trong phiên terminal hiện tại.
Cách xử lý:
Tắt cửa sổ Terminal đi mở lại (đặc biệt trên Windows sau khi dùng
setx). Kiểm tra bằng lệnh: echo $env:ANTHROPIC_AUTH_TOKEN (PowerShell) hoặc echo $ANTHROPIC_AUTH_TOKEN (Mac/Linux).