DeepSeek V4 Flash và Pro trong Claude Code: Cài đặt và chuyển đổi mô hình
Thiết lập DeepSeek trong Claude Code bằng APIMaster. Cấu hình settings.json trên Windows, macOS và Linux, khởi chạy claude, chọn mô hình bằng /model và bắt đầu trò chuyện.
Cấu hình APIMaster trong settings.json, chạy claude, sau đó nhập /model MODEL_ID trong cuộc hội thoại để sử dụng DeepSeek. Các ID khả dụng được đề cập trong bài này là deepseek-v4-flash, deepseek-v4-pro. Claude Code là ứng dụng khách; DeepSeek là mô hình trả lời.
Trước khi bắt đầu
Hoàn thành kiểm tra môi trường và thiết lập Claude Code. Lấy một khóa API APIMaster với số dư đủ dùng và quyền truy cập vào các mô hình đã chọn.
claude --version
URL cơ sở của gateway là https://apimaster.ai, không bao gồm /v1. Claude Code tự thêm /v1/messages.
1. Mở thư mục cấu hình
Windows
Nhấn Win + R, nhập đường dẫn sau và nhấn Enter:
%USERPROFILE%\.claude
Tạo thư mục nếu cần. Mở hoặc tạo settings.json. Đảm bảo tệp không có tên settings.json.txt.
macOS / Linux
Trên macOS, trong Finder nhấn Command + Shift + G và nhập:
~/.claude
Trên Linux, mở cùng thư mục đó bằng trình quản lý tệp hoặc trình soạn thảo của bạn. Tạo thư mục nếu cần:
mkdir -p ~/.claude
Mở hoặc tạo settings.json tại đó. Nếu bạn đặt thư mục cấu hình Claude Code tùy chỉnh, hãy sử dụng thư mục đó thay thế.
2. Chỉnh sửa settings.json
Windows, macOS và Linux sử dụng cùng một cấu hình. Thay thế YOUR_APIMASTER_API_KEY bằng khóa APIMaster của bạn:
{
"model": "deepseek-v4-flash",
"env": {
"ANTHROPIC_BASE_URL": "https://apimaster.ai",
"ANTHROPIC_API_KEY": "YOUR_APIMASTER_API_KEY",
"ANTHROPIC_AUTH_TOKEN": "",
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
}
}
Nếu tệp đã tồn tại, hãy sao lưu nó và hợp nhất các trường này vào đối tượng JSON hiện có và đối tượng env. Giữ lại các cài đặt khác mà bạn cần. Không thêm một đối tượng JSON thứ hai hoặc trùng lặp khóa env. JSON không cho phép chú thích hoặc dấu phẩy thừa ở cuối.
Hướng dẫn Claude Code tổng quát hiển thị xác thực bằng token. Hướng dẫn này sử dụng xác thực bằng khóa API đã được kiểm chứng trong các bài kiểm tra tích hợp của chúng tôi. Giữ ANTHROPIC_AUTH_TOKEN trống khi sử dụng ANTHROPIC_API_KEY, và xóa các thông tin xác thực xung đột khỏi các cài đặt khác hoặc terminal của bạn. Sử dụng khóa APIMaster cho gateway này.
Trường model đặt mô hình khởi động. Bạn có thể chọn mô hình khác sau khi khởi chạy. Giữ tệp cài đặt người dùng này ở chế độ riêng tư; không commit khóa thật vào kho lưu trữ dùng chung. Lưu tệp và khởi động lại Claude Code để nạp cấu hình mới.
3. Khởi động Claude Code
Trong một terminal mở tại thư mục dự án của bạn, chạy:
claude
Hoàn thành các lời nhắc chạy lần đầu thông thường và xem xét lời nhắc tin cậy dự án. Mô hình khởi động phải là deepseek-v4-flash. Đây là phiên tương tác bình thường với các công cụ và cài đặt dự án thông thường.
4. Chọn mô hình và bắt đầu trò chuyện
Trong cuộc hội thoại Claude Code, nhập một trong các lệnh sau và nhấn Enter:
/model deepseek-v4-flash
/model deepseek-v4-pro
Chạy từng dòng một, chọn mô hình bạn muốn. Sau khi Claude Code xác nhận việc chuyển đổi, gửi một tin nhắn ngắn:
Reply with exactly OK.
Một câu trả lời văn bản bình thường xác nhận kết nối cơ bản. Sau đó bạn có thể tiếp tục trò chuyện hoặc yêu cầu nó làm việc trên dự án của bạn. Để chuyển đổi lần nữa trong cùng cuộc hội thoại, nhập một lệnh /model MODEL_ID khác.
Chỉ nhập /model sẽ mở trình chọn mô hình. Các ID gateway tùy chỉnh có thể không xuất hiện trong danh sách mặc định của nó. Thay vào đó, hãy nhập đầy đủ ID như hiển thị ở trên. Lệnh slash thuộc về bên trong Claude Code, không phải trong PowerShell hay Bash. Các tên mô hình mô tả các mô hình DeepSeek, không phải Claude Sonnet hay Opus.
Bạn cũng có thể chọn mô hình khi khởi chạy từ terminal. Chạy từng lệnh một:
claude --model deepseek-v4-flash
claude --model deepseek-v4-pro
Để đặt mặc định rõ ràng cho các phiên sau này, hãy chỉnh sửa model trong settings.json. Cờ khởi chạy, biến môi trường ANTHROPIC_MODEL, hoặc cài đặt dự án/quản lý có thể ảnh hưởng đến mô hình được chọn; hãy kiểm tra những mục này nếu mô hình khởi động khác với giá trị bạn đã lưu.
Khắc phục sự cố
| Triệu chứng | Cần kiểm tra |
|---|---|
| 401 / lời nhắc đăng nhập bất thường | Kiểm tra khóa APIMaster, URL cơ sở và các biến xác thực xung đột; khởi động lại CLI sau khi chỉnh sửa cài đặt. |
| 404 | Sử dụng https://apimaster.ai, không có /v1 hay /v1/messages. |
| Cài đặt không có hiệu lực | Kiểm tra vị trí tệp, JSON hợp lệ và các ghi đè từ cài đặt terminal, dự án hoặc quản lý. |
| Không thấy mô hình trong trình chọn | Nhập /model MODEL_ID với ID chính xác, hoặc khởi chạy bằng claude --model MODEL_ID. |
| Mô hình không khả dụng / 403 | Kiểm tra chính tả, các mô hình được phép của khóa, số dư tài khoản và khả dụng của tuyến hiện tại. |
unrecognized_model |
Được ghi nhận với các ID tùy chỉnh trong bài kiểm tra của chúng tôi. Kiểm tra câu trả lời thực tế và kết quả công cụ; các mặc định năng lực Claude tích hợp sẵn chưa được xác minh cho DeepSeek. |
| Tệp hoặc lệnh bị từ chối quyền | Xem xét và phê duyệt thao tác mong muốn qua các lời nhắc quyền thông thường. |
| 429 / 5xx / câu trả lời bị gián đoạn | Lưu lỗi, ID mô hình, phiên bản CLI, giờ UTC và ID yêu cầu nếu có để hỗ trợ. |
Xác thực và chẩn đoán tùy chọn
Các bài kiểm tra tích hợp được ghi nhận: 2026-09-07 UTC, Claude Code 2.1.239, Linux. Tất cả các mô hình được liệt kê tại đây đều trả về văn bản như mong đợi và đọc một tệp cục bộ thông qua công cụ. Các tác vụ lập trình phức tạp nằm ngoài phạm vi kiểm tra đó. Windows và macOS không nằm trong các lượt chạy được ghi nhận đó.
Các kiểm tra tự động trước đó sử dụng chế độ bare để cô lập cấu hình. Việc sử dụng hàng ngày bình thường tuân theo các bước settings.json và tương tác ở trên. Chế độ bare và --setting-sources "" bỏ qua các tích hợp thông thường hoặc cài đặt đã lưu, vì vậy không nên thêm chúng vào lệnh khởi động hàng ngày trong hướng dẫn này.
Để kiểm tra nhanh không tương tác bằng cấu hình đã lưu của bạn:
claude --model deepseek-v4-flash -p "Reply with exactly OK."
Để kiểm tra công cụ, tạo probe.txt chứa FILE_PROBE_739182, khởi động Claude Code trong thư mục đó và yêu cầu nó đọc tệp bằng một công cụ và trả về nội dung chính xác của tệp. Xác nhận rằng công cụ thực sự chạy.
Đây là các kiểm tra tích hợp có giới hạn, không phải cam kết về mọi tính năng của Claude Code, hành vi phiên dài hoặc ngữ cảnh tối đa. Tài liệu gateway của Anthropic không chính thức hỗ trợ định tuyến Claude Code đến các mô hình không phải Claude; hướng dẫn này mô tả tích hợp của APIMaster.
Câu hỏi thường gặp
Gói đăng ký Claude của tôi có trả tiền cho các yêu cầu này không?
Không. Với cấu hình APIMaster này, các yêu cầu sử dụng khóa và số dư APIMaster của bạn.
Tôi có thể tiếp tục trò chuyện sau khi chuyển đổi mô hình không?
Có, sử dụng lệnh chuyển đổi mô hình trong cuộc hội thoại đang mở và đợi xác nhận trước khi gửi tin nhắn tiếp theo. Để so sánh sạch giữa các mô hình, hãy bắt đầu một phiên riêng biệt bằng claude --model MODEL_ID.