Sử dụng DeepSeek trong Claude Code: Hướng dẫn thiết lập V4 Flash / Pro

Chạy DeepSeek V4 Flash và Pro trong Claude Code thông qua APIMaster. Đặt cổng kết nối và khóa API, chuyển đổi mô hình, xác minh công cụ đọc tệp và sửa lỗi cấu hình.

Claude Code có thể sử dụng DeepSeek không? Các thử nghiệm của chúng tôi với Claude Code 2.1.239 đã sử dụng thành công deepseek-v4-flash và deepseek-v4-pro thông qua điểm cuối Messages của APIMaster. Đặt ANTHROPIC_BASE_URL thành https://apimaster.ai, cung cấp khóa APIMaster và chọn mô hình một cách rõ ràng. Cấu hình này chạy DeepSeek, mặc dù máy khách có tên là Claude Code.

Kiểm tra lần cuối: 2026-09-07, Claude Code 2.1.239, Linux. Cả hai mô hình đều trả về văn bản mong đợi và hoàn thành một vòng lặp công cụ đọc tệp. Tất cả các lần chạy đều thoát với mã 0. CLI in ra unrecognized_model, nhưng các yêu cầu được thử nghiệm đã thành công. Các kiểm tra này không thiết lập hỗ trợ cho mọi tính năng của Claude Code, phiên dài hoặc các bản phát hành trong tương lai. Các lệnh thiết lập Windows / macOS được bao gồm; thử nghiệm được ghi lại đã chạy trên Linux.

1. Chuẩn bị CLI và khóa API

Làm theo hướng dẫn môi trường và hướng dẫn thiết lập Claude Code để cài đặt. Kiểm tra phiên bản của bạn:

claude --version

Nhận khóa API APIMaster có quyền truy cập vào mô hình DeepSeek đã chọn và đủ hạn mức. Sử dụng cài đặt phiên bên dưới cho hướng dẫn này; không cần ghi đè settings.json thông thường của bạn.

2. Đặt cổng kết nối và khóa

Mở một thiết bị đầu cuối mới để giữ các cài đặt này tách biệt với phiên CLI thông thường của bạn.

macOS / Linux:

export ANTHROPIC_BASE_URL='https://apimaster.ai'
export ANTHROPIC_API_KEY='YOUR_APIMASTER_API_KEY'
unset ANTHROPIC_AUTH_TOKEN

Windows PowerShell:

$env:ANTHROPIC_BASE_URL = 'https://apimaster.ai'
$env:ANTHROPIC_API_KEY = 'YOUR_APIMASTER_API_KEY'
Remove-Item Env:ANTHROPIC_AUTH_TOKEN -ErrorAction SilentlyContinue

Sử dụng nguồn gốc trang web ở đây, không có /v1: Claude Code thêm /v1/messages. Khóa API phải đến từ APIMaster. Các lệnh này ảnh hưởng đến thiết bị đầu cuối này và các quy trình con của nó, không ảnh hưởng đến các tệp đăng nhập đã lưu của bạn. Không đặt khóa thực trong tệp cài đặt dùng chung hoặc kho lưu trữ.

3. Gửi yêu cầu kiểm tra tối thiểu

claude --bare --setting-sources "" --no-session-persistence --model deepseek-v4-flash --tools "" --output-format json -p "Reply with exactly: DEEPSEEK_TEST_OK"

Dự kiến: is_error là false, result là DEEPSEEK_TEST_OK và quá trình thoát với mã 0. Thay đổi --model thành deepseek-v4-pro và chạy lại.

Chế độ --bare của phiên bản đã thử nghiệm sử dụng xác thực khóa API rõ ràng và bỏ qua các tích hợp nền thông thường. --setting-sources "" loại trừ các nguồn cài đặt đã lưu, trong khi --tools "" vô hiệu hóa các công cụ cho bài kiểm tra văn bản đơn lẻ này. Đây là các cài đặt chẩn đoán có chủ ý, không phải là yêu cầu để vô hiệu hóa các công cụ trong quá trình sử dụng bình thường. Các phiên bản CLI cũ hơn có thể không chấp nhận tất cả các cờ này.

4. Xác minh công cụ đọc tệp

Tạo probe.txt trong thư mục hiện tại với nội dung này:

TOOL_PROBE_739182

Chạy:

claude --bare --setting-sources "" --no-session-persistence --model deepseek-v4-flash --tools Read --allowedTools Read --output-format json -p "Use the Read tool to read probe.txt in the current directory. Reply with only the exact content. Do not guess."

Dự kiến: CLI đọc tệp và trả về TOOL_PROBE_739182. Lặp lại với deepseek-v4-pro. Điều này kiểm tra rằng mô hình có thể yêu cầu một công cụ, nhận kết quả của nó và sau đó trả lời. Chỉ có công cụ Read được bật cho bài kiểm tra này.

Đối với công việc tương tác thông thường với cùng cài đặt thiết bị đầu cuối:

claude --bare --setting-sources "" --model deepseek-v4-flash

Để bắt đầu với Pro:

claude --bare --setting-sources "" --model deepseek-v4-pro

Các lệnh tương tác bỏ qua --tools "", vì vậy các công cụ mặc định có sẵn. Xem lại các lời nhắc quyền như bình thường. --bare bỏ qua các tiện ích như hook và hướng dẫn dự án tự động; bật cài đặt bình thường của bạn một cách có chủ ý sau khi thiết lập tối thiểu hoạt động và kiểm tra rằng chúng không ghi đè cổng kết nối hoặc mô hình. Đóng thiết bị đầu cuối này khi hoàn tất để rời khỏi môi trường của phiên này.

Xử lý sự cố

Triệu chứng	Điều cần kiểm tra
`unrecognized_model`	Được quan sát cho cả hai ID DeepSeek trong 2.1.239. Nó không ngăn các yêu cầu của chúng tôi hoàn thành. Kiểm tra kết quả cuối cùng thay vì coi cảnh báo một mình là thất bại.
401 hoặc lời nhắc đăng nhập bất ngờ	Xác nhận `ANTHROPIC_API_KEY` được đặt, xóa `ANTHROPIC_AUTH_TOKEN` xung đột trong thiết bị đầu cuối này và thử lại chế độ bare.
404	`ANTHROPIC_BASE_URL` phải là `https://apimaster.ai`, không phải điểm cuối `/v1/messages` đầy đủ hoặc cơ sở kết thúc bằng `/v1`.
Tùy chọn `--bare` không xác định	Kiểm tra phiên bản của bạn so với 2.1.239 đã thử nghiệm. Sử dụng hướng dẫn cài đặt chung để cập nhật nếu thích hợp.
Không thể đọc `probe.txt`	Chạy từ thư mục của tệp. Đối với bài kiểm tra công cụ, bật Read thay vì sử dụng `--tools ""`.
Một mô hình khác được chọn	Truyền ID mô hình đầy đủ với `--model` và kiểm tra cài đặt đã lưu hoặc ghi đè bí danh mô hình trước khi bật chúng.
Giới hạn tốc độ, hạn mức không đủ hoặc lỗi thượng nguồn	Đọc nội dung lỗi, kiểm tra hạn mức và quyền của mô hình, và ghi lại dấu thời gian để hỗ trợ.

Các câu hỏi thường gặp

Điều này có giống với việc sử dụng mô hình Claude không?

Không. Claude Code là máy khách ở đây; mô hình được chọn là DeepSeek. Các tính năng phụ thuộc vào một mô hình Claude cụ thể không tự động được bao phủ bởi thiết lập này.

Tại sao URL cơ sở khác với ví dụ SDK Python?

SDK OpenAI Python sử dụng https://apimaster.ai/v1 và thêm /chat/completions. Claude Code sử dụng https://apimaster.ai và thêm /v1/messages. Sử dụng định dạng cơ sở được ghi lại của từng máy khách.

Tôi có thể sử dụng khóa chính thức của DeepSeek với cổng kết nối này không?

Hướng dẫn này yêu cầu khóa do APIMaster cấp. Khóa cụ thể cho nhà cung cấp phát hành chúng; chỉ thay đổi điểm cuối không chuyển thông tin xác thực hoặc hạn mức.

Việc sử dụng công cụ thực tế đã được thử nghiệm hay chỉ là trả lời văn bản?

Cả hai đều được thử nghiệm cho cả hai mô hình. Bài kiểm tra công cụ đã đọc một tệp cục bộ và trả về nội dung của nó. Nó không thiết lập rằng tất cả các công cụ, tác nhân nền hoặc các tác vụ mã hóa dài được hỗ trợ.