cách dùng deepseek với claude code là bạn cấu hình Claude Code để gửi yêu cầu tới endpoint tương thích Anthropic của DeepSeek (https://api.deepseek.com/anthropic) thay vì API của Anthropic. Chỉ cần đặt vài biến môi trường và API key DeepSeek, bạn có thể chạy lệnh claude ngay trong thư mục dự án.
Cập nhật: 31/10/2026
Tóm tắt nhanh
- Claude Code là công cụ lập trình bằng AI chạy trong terminal, và DeepSeek có endpoint tương thích định dạng Anthropic API.
- Để dùng DeepSeek, bạn đặt biến ANTHROPIC_BASE_URL trỏ tới https://api.deepseek.com/anthropic và đặt ANTHROPIC_AUTH_TOKEN bằng API key DeepSeek.
- Cần cài Node.js 18 trở lên, cài Claude Code bằng npm, rồi kiểm tra bằng lệnh claude –version.
- Nếu Claude Code vẫn gọi model Anthropic, nguyên nhân thường là biến môi trường chưa được nạp trong phiên terminal hiện tại.
- Bạn có thể cài thêm skill từ kho skill để mở rộng khả năng của Claude Code mà không cần viết lại prompt.
Yêu cầu hệ thống trước khi bắt đầu
Bạn cần một máy đã cài Node.js phiên bản 18 trở lên, một API key DeepSeek và kết nối internet. Claude Code hỗ trợ macOS 13.0 trở lên, Windows 10 1809 trở lên, Ubuntu 20.04 trở lên và Debian 10 trở lên, cùng với các cấu hình RAM tối thiểu 4 GB. Trên Windows, nên cài Git for Windows để Claude Code dùng được công cụ Bash.
- Node.js 18 trở lên, kiểm tra bằng lệnh node -v.
- API key lấy từ nền tảng DeepSeek Platform.
- Terminal: Bash, Zsh hoặc PowerShell trên Windows.
Cách cài Claude Code trên máy
Bạn cài Claude Code bằng lệnh npm install -g @anthropic-ai/claude-code, sau đó chạy claude –version để xác nhận. Nếu đã có Claude Code, bạn bỏ qua bước này và chỉ cần cấu hình biến môi trường. Hướng dẫn chi tiết hơn cho từng hệ điều hành nằm trong bài cách cài skill cho Claude Code trên blog.
npm install -g @anthropic-ai/claude-code
claude --versionCách cấu hình biến môi trường để dùng DeepSeek trong Claude Code?
Bạn đặt các biến ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN và các biến ANTHROPIC_MODEL tương ứng trong terminal, rồi chạy claude từ thư mục dự án. Cấu hình dưới đây dùng đúng tên model theo tài liệu chính thức của DeepSeek tại thời điểm cập nhật 31/10/2026.
- Mở terminal và đặt endpoint cùng API key:
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN=<your DeepSeek API Key> - Đặt model cho các vai trò chính:
export ANTHROPIC_MODEL=deepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash - Đặt model cho subagent và mức suy luận:
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash export CLAUDE_CODE_EFFORT_LEVEL=max export CLAUDE_CODE_AUTO_COMPACT_WINDOW=786432 - Vào thư mục dự án và khởi động Claude Code:
cd /duong-dan/toi/du-an claude
Trên Windows PowerShell, bạn dùng cú pháp $env:TÊN_BIẾN=”giá trị” thay cho export. Các giá trị vẫn giữ nguyên như trên.
Làm sao kiểm tra Claude Code đang dùng DeepSeek?
Bạn kiểm tra bằng cách gửi một yêu cầu đơn giản trong phiên claude và xem phản hồi có hoạt động bình thường hay không. Nếu Claude Code trả lời được và không báo lỗi xác thực, cấu hình đã đúng với endpoint DeepSeek.
- Trong phiên claude, gõ một câu hỏi ngắn, ví dụ: giải thích file README.md của dự án này.
- Kiểm tra phản hồi có xuất hiện bình thường, không báo lỗi 401 hay lỗi authentication.
- Nếu cần, chạy lệnh env trên Linux/Mac hoặc echo $env:ANTHROPIC_BASE_URL trên PowerShell để xác nhận biến đã được nạp trong phiên này.
Lỗi thường gặp khi dùng DeepSeek với Claude Code và cách sửa
Lỗi phổ biến nhất là biến môi trường không còn hiệu lực sau khi bạn mở terminal mới, hoặc API key bị dán sai. Bảng dưới đây tóm tắt các lỗi hay gặp và cách xử lý.
| Triệu chứng | Nguyên nhân thường gặp | Cách sửa |
|---|---|---|
| Lệnh claude không tìm thấy | Cài đặt chưa xong hoặc thư mục npm chưa có trong PATH | Mở terminal mới, chạy lại claude –version, kiểm tra PATH |
| Lỗi 401 hoặc authentication failed | API key sai hoặc đặt nhầm biến | Kiểm tra lại ANTHROPIC_AUTH_TOKEN, không có khoảng trắng thừa |
| Vẫn chạy model Anthropic | Biến ANTHROPIC_BASE_URL chưa được nạp | Đặt lại biến trong cùng terminal rồi chạy claude |
| Thiếu phản hồi khi dùng công cụ tìm kiếm | Hệ thống thiếu ripgrep | Xem phần xử lý sự cố tìm kiếm trong tài liệu chính thức của Claude Code |
Với Windows, nếu gặp lỗi chạy lệnh irm hoặc && trong terminal, hãy kiểm tra bạn đang dùng PowerShell hay CMD, vì hai shell này có cú pháp khác nhau.
Cách cài và gọi một skill trong Claude Code
Bạn cài skill bằng cách tải gói .tgz từ kho skill và giải nén vào thư mục ~/.claude/skills, sau đó gọi skill bằng lệnh /tên-skill. Ví dụ dưới đây dùng skill expert-prompt-migrator, một công cụ chuẩn hóa prompt chuyên gia để chuyển sang các AI khác, trong đó có DeepSeek.
- Chạy lệnh cài skill:
mkdir -p ~/.claude/skills && curl -fsSL https://skill.dn1nguoi.com/z/expert-prompt-migrator-08311.tgz | tar xz -C ~/.claude/skills - Mở lại Claude Code trong thư mục dự án, rồi gõ /expert-prompt-migrator kèm yêu cầu của bạn.
Nếu muốn tìm thêm skill cho các nhóm tác vụ khác, bạn có thể xem danh mục agent tự động hóa hoặc đọc trang hướng dẫn Claude Code trên kho skill. Bạn cũng có thể tìm hiểu thêm về khái niệm này trong bài skill Claude là gì.
Thử ngay: Kho skill có hơn 4.000 skill miễn phí. Bạn chỉ cần một dòng lệnh để cài skill vào Claude Code, và có thể xem hướng dẫn riêng cho DeepSeek để biết thêm về cấu hình model.
Câu hỏi thường gặp
Có cần tài khoản Anthropic để dùng DeepSeek trong Claude Code không?
Không cần tài khoản Anthropic trong cấu hình này. Bạn chỉ cần API key của DeepSeek và đặt ANTHROPIC_BASE_URL trỏ tới endpoint https://api.deepseek.com/anthropic. Claude Code sẽ gửi yêu cầu tới DeepSeek theo định dạng Anthropic API.
Cách dùng DeepSeek với Claude Code có tốn phí không?
DeepSeek tính phí theo API theo bảng giá chính thức của nhà cung cấp. Bạn nên xem giá và hạn mức hiện hành trên trang chính thức của DeepSeek, vì các con số này thay đổi theo thời gian.
Tại sao sau khi mở terminal mới Claude Code lại dùng model khác?
Biến export chỉ có hiệu lực trong phiên terminal hiện tại. Khi mở terminal mới, bạn cần chạy lại các lệnh export hoặc đặt biến vào file cấu hình shell như ~/.bashrc hoặc ~/.zshrc.
Có dùng được các skill trong kho với DeepSeek không?
Skill được cài vào thư mục skills của công cụ bạn đang dùng, và DeepSeek có công cụ riêng là Deep Code CLI với thư mục ~/.deepcode/skills. Khi dùng Claude Code, skill nằm ở ~/.claude/skills và được gọi bằng /tên-skill.
Có cần cài Git for Windows không?
Trên Windows, nên cài Git for Windows để Claude Code dùng được công cụ Bash. Nếu không cài, Claude Code sẽ dùng PowerShell làm shell thay thế. Bản WSL không cần Git for Windows.
Nguồn tham khảo
- Integrate with Claude Code – DeepSeek API Docs
- Using the Anthropic API – DeepSeek API Docs
- Advanced setup – Claude Code Docs