Cách Sử Dụng DeepSeek-V3.1 trong Claude Code
Cách Sử Dụng DeepSeek-V3.1 trong Claude Code
Claude Code là một trợ lý lập trình nhẹ, thường kết nối với các mô hình Claude của Anthropic. Nhờ API tương thích với Anthropic của DeepSeek, bạn cũng có thể chạy Claude Code trên nền DeepSeek V3.1 chỉ với vài biến môi trường.
Hướng dẫn này sẽ dẫn bạn qua các bước cài đặt, cấu hình và sử dụng.
1. Cài đặt Claude Code
Claude Code có thể được cài đặt theo hai cách:
Lựa chọn A (cài đặt bằng curl):
curl -fsSL https://claude.ai/install.sh | bash
Lựa chọn B (npm):
npm install -g @anthropic-ai/claude-code
2. Cấu hình cho DeepSeek V3.1
Claude Code dựa vào các biến API của Anthropic. Để chuyển hướng sang endpoint tương thích với Anthropic của DeepSeek, hãy thiết lập các biến môi trường sau:
# Trỏ đến endpoint tương thích với Anthropic của DeepSeek
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
# Khóa API DeepSeek của bạn
export ANTHROPIC_AUTH_TOKEN="YOUR_DEEPSEEK_API_KEY"
# Sử dụng DeepSeek V3.1 làm mô hình chính
export ANTHROPIC_MODEL="deepseek-chat"
# Sử dụng DeepSeek V3.1 làm mô hình nhỏ/nhanh
export ANTHROPIC_SMALL_FAST_MODEL="deepseek-chat"
Lưu ý:
- deepseek-chat = DeepSeek V3.1 (chế độ không suy luận)
- deepseek-reasoner = DeepSeek V3.1 chế độ suy luận (hỗ trợ theo dõi “tư duy” chi tiết, nhưng hạn chế sử dụng công cụ)
Nếu bạn muốn dùng mô hình suy luận, thay deepseek-chat
bằng deepseek-reasoner
.
3. Script khởi động một cú nhấp
Để đơn giản hóa việc sử dụng, bạn có thể tạo một script shell tên là start-claude-deepseek.sh
:
#!/bin/bash
# DeepSeek V3.1 với Claude Code
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="YOUR_DEEPSEEK_API_KEY"
export ANTHROPIC_MODEL="deepseek-chat"
export ANTHROPIC_SMALL_FAST_MODEL="deepseek-chat"
# Khởi chạy Claude Code
claude "$@"
Cấp quyền thực thi cho script:
chmod +x start-claude-deepseek.sh
Bây giờ chạy Claude Code bằng lệnh:
./start-claude-deepseek.sh
4. Cách sử dụng
Đi vào thư mục dự án của bạn và chạy script:
cd your-project
../start-claude-deepseek.sh
Từ đây, Claude Code hoạt động hoàn toàn giống như trước — chỉ khác là bây giờ nó được vận hành bởi DeepSeek V3.1.
5. Khắc phục sự cố
- Lỗi token không hợp lệ → kiểm tra xem
ANTHROPIC_AUTH_TOKEN
đã được đặt đúng khóa API DeepSeek của bạn chưa. - Không có phản hồi → xác nhận
ANTHROPIC_BASE_URL
đúng (https://api.deepseek.com/anthropic
). - Gọi công cụ/hàm → được hỗ trợ trong
deepseek-chat
;deepseek-reasoner
có thể tự động chuyển vềdeepseek-chat
.
✅ Bạn đã sẵn sàng sử dụng Claude Code với DeepSeek V3.1 làm trợ lý lập trình AI của mình.