getdeepseekapi.comHướng dẫn
Cách dùng API DeepSeek trong Claude Code: Các tùy chọn thực tế
Nếu bạn đang tìm cách dùng API DeepSeek trong Claude Code, điều đầu tiên cần biết là Claude Code giao tiếp với các endpoint kiểu Anthropic, trong khi dịch vụ này dùng định dạng OpenAI. Một proxy chuyển đổi nhỏ sẽ lấp khoảng trống này, và trang này hướng dẫn bạn cách thiết lập nó.
Cập nhật
Điểm chính
- Claude Code mong đợi API Messages của Anthropic; dịch vụ này cung cấp /v1/chat/completions tương thích OpenAI.
- Một proxy cục bộ như LiteLLM có thể chuyển đổi giữa hai định dạng này.
- Aider, Continue và Cline chấp nhận base URL tương thích OpenAI trực tiếp, không cần proxy.
- Đây không phải API chính thức của DeepSeek: đây là một mô hình trọng số mở độc lập với ID
uncensored.

Bắt đầu với những gì sẽ và sẽ không hoạt động
Hai điểm làm rõ này giúp bạn tiết kiệm một giờ nhầm lẫn. Thứ nhất, dịch vụ này không phải là API DeepSeek chính thức, và nó không phải là một router cho DeepSeek hay bất kỳ nhà cung cấp nào khác. Nó lưu trữ một mô hình trọng số mở, do một nhà cung cấp độc lập vận hành, với model ID uncensored. Nếu bạn cần các mô hình của chính DeepSeek, hãy truy cập trực tiếp vào DeepSeek. Thứ hai, Claude Code được xây dựng xung quanh Messages API của Anthropic. Bạn có thể thay đổi nơi nó gửi yêu cầu, nhưng những gì nó gửi vẫn là định dạng JSON theo chuẩn của Anthropic.
Dịch vụ này cung cấp POST /v1/chat/completions và GET /v1/models theo định dạng OpenAI. Trỏ thẳng Claude Code vào đây sẽ không hoạt động vì các đường dẫn và payload khác nhau. Giải pháp là một lớp chuyển đổi. Bạn chạy một proxy nhỏ trên máy của mình để chấp nhận các lệnh gọi định dạng Anthropic từ Claude Code và chuyển tiếp chúng dưới dạng các lệnh gọi định dạng OpenAI đến https://api.getdeepseekapi.com/v1. Có các công cụ dành chính xác cho việc này, và phần tiếp theo sẽ thiết lập một công cụ như vậy.
Trước khi bắt đầu, hãy kiểm tra một kỳ vọng. Claude Code dựa rất nhiều vào gọi hàm để đọc tệp, chỉnh sửa chúng và chạy lệnh. API này hỗ trợ gọi hàm, bao gồm cả tool_calls truyền phát, nhưng mức độ hiệu quả của bất kỳ mô hình cụ thể nào trong việc điều khiển một vòng lặp agent dài là điều bạn cần tự kiểm tra trên kho lưu trữ của mình, không phải điều bạn nên mặc định.
Lấy khóa và xác nhận endpoint
Tạo tài khoản với Google hoặc email và mật khẩu, sau đó mở trang khóa API. Người dùng mới có thể nhận $0,50 tín dụng dùng thử miễn phí chỉ với một cú nhấp chuột. Tín dụng này có hiệu lực trong 7 ngày, không cần thông tin thanh toán và đủ để kiểm tra mọi thứ bên dưới. Lưu ý rằng khóa dùng thử cho phép 2 yêu cầu đồng thời và 60 yêu cầu mỗi phút, điều này quan trọng đối với các công cụ agent kích hoạt nhiều lệnh gọi cùng lúc.
export UNCENSORED_API_KEY="paste-your-key-here"
curl https://api.getdeepseekapi.com/v1/chat/completions \
-H "Authorization: Bearer $UNCENSORED_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}]}'
Nếu lệnh đó trả về kết quả hoàn tất, phía upstream đã xong. Mọi việc còn lại là kết nối proxy với nó.
Tùy chọn 1: proxy LiteLLM phía trước Claude Code
LiteLLM là một dự án mã nguồn mở mà máy chủ proxy của nó có thể cung cấp một endpoint tương thích Anthropic và định tuyến đến các backend tương thích OpenAI. Hãy kiểm tra tài liệu của nó để biết bộ tính năng hiện tại, vì phần này của hệ sinh thái thay đổi rất nhanh.
Cài đặt và cấu hình
pip install 'litellm[proxy]'
cat > litellm-config.yaml <<'EOF'
model_list:
- model_name: uncensored
litellm_params:
model: openai/uncensored
api_base: https://api.getdeepseekapi.com/v1
api_key: os.environ/UNCENSORED_API_KEY
EOF
litellm --config litellm-config.yaml --port 4000
Tiền tố openai/ báo cho LiteLLM sử dụng adapter tương thích OpenAI; tên phía sau nó sẽ được gửi đến máy chủ nguồn dưới dạng mô hình. Hãy giữ terminal đang chạy.
Trỏ Claude Code vào proxy
Claude Code đọc endpoint và thông tin xác thực từ các biến môi trường. Trong một terminal thứ hai:
export ANTHROPIC_BASE_URL="http://localhost:4000"
export ANTHROPIC_AUTH_TOKEN="any-local-string"
export ANTHROPIC_MODEL="uncensored"
export ANTHROPIC_SMALL_FAST_MODEL="uncensored"
claude
Token xác thực ở đây chỉ là những gì proxy cục bộ của bạn mong đợi; khóa thực sự vẫn nằm trong môi trường của proxy. Việc đặt mô hình nhỏ, nhanh cũng quan trọng vì Claude Code sử dụng một mô hình thứ hai cho các tác vụ nền nhẹ. Nếu bạn để trống cài đặt này, nó có thể cố gắng gọi tên mô hình Anthropic mà proxy không biết. Các phiên bản mới hơn có thể đặt tên cho cài đặt này khác đi, vì vậy hãy chạy claude --help hoặc đọc tài liệu cài đặt Claude Code hiện tại nếu một biến dường như bị bỏ qua.
Tùy chọn 2: các công cụ chấp nhận base URL OpenAI trực tiếp
Nếu mục tiêu của bạn là một trợ lý lập trình AI thay vì chính Claude Code, một số công cụ bỏ qua proxy vì chúng đã hỗ trợ định dạng OpenAI. Mỗi công cụ cho phép bạn đặt base URL và tên mô hình tùy chỉnh.
- Aider là một trợ lý lập trình cặp (pair programming) chạy trong terminal. Nó đọc
OPENAI_API_BASEvàOPENAI_API_KEY, và bạn thêm tiền tố cho mô hình bằngopenai/. - Continue là một tiện ích mở rộng trình soạn thảo nơi một mục nhập mô hình có thể mang
apiBasevà một nhà cung cấp theo phong cách OpenAI. - Cline cung cấp nhà cung cấp Tương thích OpenAI trong cài đặt của nó với các trường cho base URL, khóa và model ID.
Với Aider, toàn bộ quá trình thiết lập chỉ gồm ba dòng:
export OPENAI_API_BASE="https://api.getdeepseekapi.com/v1"
export OPENAI_API_KEY="$UNCENSORED_API_KEY"
aider --model openai/uncensored
Các công cụ này thay đổi menu của chúng thường xuyên, vì vậy hãy coi các tên trường ở trên là hướng dẫn và làm theo tài liệu hiện tại của từng dự án. Các giá trị bạn cần không bao giờ thay đổi: base URL https://api.getdeepseekapi.com/v1, khóa của bạn và model ID uncensored.
Tự viết vòng lặp agent mỏng
Khi một trợ lý lập trình toàn diện là quá sức, một đoạn mã ngắn với gọi hàm có thể giải quyết nhiều vấn đề. Đoạn mã này cho phép mô hình yêu cầu đọc một tệp, sau đó trả lại tệp đó dưới dạng thông điệp role: "tool".
import json, os
from openai import OpenAI
client = OpenAI(
base_url="https://api.getdeepseekapi.com/v1",
api_key=os.environ["UNCENSORED_API_KEY"],
)
tools = [{
"type": "function",
"function": {
"name": "read_file",
"description": "Read a text file from the project",
"parameters": {
"type": "object",
"properties": {"path": {"type": "string"}},
"required": ["path"],
},
},
}]
messages = [{"role": "user", "content": "What does main.py do? Read it first."}]
for _ in range(5):
r = client.chat.completions.create(model="uncensored", messages=messages, tools=tools)
msg = r.choices[0].message
messages.append(msg)
if not msg.tool_calls:
print(msg.content)
break
for call in msg.tool_calls:
args = json.loads(call.function.arguments)
with open(args["path"]) as f:
result = f.read()
messages.append({"role": "tool", "tool_call_id": call.id, "content": result})
Giới hạn vòng lặp là năm để ngăn mô hình bị nhầm lẫn chạy mãi mãi. Trong một công cụ thực tế, bạn cũng sẽ xác thực các đường dẫn để mô hình không thể đọc các tệp bên ngoài dự án.
Giới hạn tốc độ, chi phí và xử lý lỗi 429
Các công cụ agent gửi rất nhiều yêu cầu. Một nhiệm vụ đơn lẻ có thể kích hoạt hàng chục yêu cầu, mỗi yêu cầu gửi lại ngữ cảnh ngày càng lớn. Với khóa đầy đủ, bạn có 8 yêu cầu đồng thời và 300 yêu cầu mỗi phút. Mã 429 với concurrency có nghĩa là quá nhiều cuộc gọi chồng chéo, và mã 429 với rate_limited có nghĩa là quá nhiều yêu cầu mỗi phút. Trong thời gian quá tải ngắn hạn, bạn sẽ thấy mã 429 với Retry-After: 5. LiteLLM có thể tự động thử lại nếu bạn thêm cài đặt thử lại; hãy kiểm tra tài liệu của nó.
Chi phí khá thấp vì giá là $0,15 cho mỗi 1 triệu token đầu vào và $0,50 cho mỗi 1 triệu token đầu ra. Giả sử một phiên agent thực hiện 40 cuộc gọi, mỗi cuộc gửi 30.000 token ngữ cảnh và nhận lại 600 token. Đầu vào là 1.200.000 token, chi phí là 1,2 x $0,15 = $0,18. Đầu ra là 24.000 token, chi phí là 0,024 x $0,50 = $0,012. Toàn bộ phiên tốn $0,192. Cửa sổ ngữ cảnh là 100.000 token, vì vậy hãy giữ các tệp bạn tải vào tập trung.
Khi tín dụng dùng thử hết hạn, bạn có thể nạp tiền bất kỳ số nguyên nào từ $20 đến $500 bằng tiền mã hóa (USDT trên TRC20, USDC trên Base). Mức thưởng thêm là +5% từ $50, +10% từ $100 và +15% từ $200. Xem trang giá cả và tài liệu để biết chi tiết.
Khắc phục sự cố cấu hình proxy
| Triệu chứng | Nguyên nhân | Những gì cần thử |
|---|---|---|
| Claude Code báo cáo mô hình không xác định | Tên mô hình nền không được ánh xạ | Đặt biến mô hình nhỏ nhanh thành uncensored |
| Kết nối bị từ chối | Proxy không chạy hoặc cổng khác biệt | Khởi động LiteLLM và sử dụng đúng cổng trong ANTHROPIC_BASE_URL |
| Lỗi 401 từ máy chủ nguồn | Sai khóa trong môi trường proxy | Xuất lại UNCENSORED_API_KEY và khởi động lại proxy |
| Gọi hàm thất bại hoặc lặp lại | Mô hình gặp khó khăn với định dạng agent | Giảm nhiệt độ, rút ngắn prompt hoặc dùng Aider thay thế |
| Thường xuyên gặp lỗi 429 | Độ đồng thời của khóa dùng thử là 2 | Nạp tiền để có khóa đầy đủ với 8 khe đồng thời |
Hai thói quen giữ cho thiết lập của bạn an toàn. Chạy proxy chỉ trên localhost, để không ai khác trên mạng của bạn có thể tiêu tốn tín dụng của bạn, và giữ khóa thực sự trong môi trường của proxy thay vì trong tệp dự án, nơi nó có thể bị đưa vào kiểm soát phiên bản. Ngoài ra, hãy theo dõi header phản hồi X-Balance-USD trong phiên dài đầu tiên của bạn, vì các vòng lặp agent có thể sử dụng nhiều token hơn bạn mong đợi. Nếu số dư giảm nhanh hơn ước tính ở trên, hãy rút ngắn các tệp bạn cung cấp hoặc giới hạn số bước.
Các yêu cầu thất bại không bị tính phí, vì vậy việc thử nghiệm rất rẻ. Các prompt không được sử dụng để huấn luyện. Để so sánh với các cổng khác, hãy đọc tổng quan về khóa API của chúng tôi.
Hướng dẫn khác
Hỏi đáp
Claude Code có thể kết nối trực tiếp với API này không?
Không. Claude Code sử dụng định dạng Messages của Anthropic và API này sử dụng định dạng chat completions của OpenAI. Hãy đặt một proxy chuyển đổi như LiteLLM giữa chúng.
Đây có phải là DeepSeek API chính thức không?
Không. Nó lưu trữ một mô hình trọng số mở độc lập với ID uncensored và không liên kết với DeepSeek hoặc bất kỳ nhà cung cấp nào khác.
Những công cụ nào hoạt động mà không cần proxy?
Các công cụ có cài đặt nhà cung cấp tương thích OpenAI, chẳng hạn như Aider, Continue và Cline. Đặt base URL, khóa và ID mô hình uncensored.
Gọi hàm có hoạt động không?
Có, bao gồm cả tool_calls được truyền phát và kết quả được gửi lại dưới dạng tin nhắn có role tool. Hãy kiểm tra quy trình agent của riêng bạn để xem mô hình xử lý nó như thế nào.
Khóa của bạn chỉ cách một biểu mẫu
Tạo tài khoản, sao chép khóa, thay đổi base URL. Đó là toàn bộ thiết lập.