Các phần cơ sở kiến thức ▾

Điều hướng

▸ Bắt đầu tại đây Theo vai trò

Danh mục

Công cụ 54
Bảng thuật ngữ 12

Công cụ

Claude Code + DeepSeek V4 Flash: cách kết nối và một tác vụ tốn bao nhiêu

Tóm tắt: Claude Code hoạt động với DeepSeek mà không cần lớp trung gian cục bộ như claude-code-router. Có thể kết nối theo hai cách: qua API chính thức của DeepSeek, vốn có địa chỉ riêng theo định dạng Anthropic, hoặc qua JoinGonka Gateway, nơi DeepSeek V4 Flash mã nguồn mở từ mạng Gonka đảm nhiệm. Trong trường hợp thứ hai, thiết lập chỉ là một lệnh: npx @joingonka/setup --tool claude-code --model deepseek.

Mô hình trong hai trường hợp là khác nhau. Trong API DeepSeek, từ ngày 10 tháng 9 năm 2026, phiên bản kế tiếp đang hoạt động — V4.1 Flash, còn V4 Flash mà mạng Gonka phục vụ đã bị DeepSeek gỡ khỏi API của mình. Dưới đây là cả hai cách thiết lập, chúng khác nhau thế nào khi vận hành và một tác vụ agent tốn bao nhiêu. Theo giá ngày 2 tháng 11 năm 2026, một tác vụ với 30 lượt gọi mô hình tốn ở DeepSeek khoảng $0.09 vào giờ cao điểm và khoảng $0.05 vào thời gian còn lại, qua cổng — khoảng $0.02.

Đây không phải Claude, và chúng tôi sẽ không giả vờ rằng không có sự khác biệt: Anthropic nói thẳng rằng không hỗ trợ Claude Code hoạt động với các mô hình không phải của Claude qua bất kỳ cổng nào. Về mặt kỹ thuật thì mọi thứ đều chạy — chúng tôi đã kiểm tra Claude Code 2.1.316 với cổng vào ngày 2 tháng 11 năm 2026 — nhưng nếu có thắc mắc, hãy liên hệ chúng tôi hoặc DeepSeek, chứ không phải bộ phận hỗ trợ của Anthropic.

Cách 1: API chính thức của DeepSeek

DeepSeek có địa chỉ theo định dạng Anthropic — https://api.deepseek.com/anthropic — cùng hướng dẫn chính thức cho Claude Code. Khóa được tạo trong bảng điều khiển DeepSeek (platform.deepseek.com), số dư cần nạp trước. Các biến từ hướng dẫn của DeepSeek tính đến ngày 2 tháng 11 năm 2026:

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=sk-your-deepseek-key
export ANTHROPIC_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-flash
export CLAUDE_CODE_EFFORT_LEVEL=max
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=786432
claude

Những điều nên biết trước lần chạy đầu tiên:

  • Tên mô hình. Từ ngày 10 tháng 9 năm 2026, deepseek-flash là V4.1 Flash, và từ ngày 17 tháng 10 là bản cập nhật 1017 với mức giá cũ. Tên cũ deepseek-v4-flash hiện vẫn được DeepSeek chấp nhận, nhưng phản hồi bằng đúng V4.1 Flash. Hậu tố [1m] cho Claude Code biết cửa sổ của mô hình là 1 triệu token, còn CLAUDE_CODE_AUTO_COMPACT_WINDOW quy định ngưỡng nén lịch sử.
  • Tên Claude. Nếu để mô hình mang tên Claude trong Claude Code, DeepSeek sẽ thay bằng mô hình của mình: các tên claude-opus chuyển sang V4 Pro và tính theo giá V4 Pro, còn lại chuyển sang deepseek-flash. Vì vậy trong hướng dẫn, mọi alias đều được gán cố định rõ ràng.
  • Giờ cao điểm. Từ ngày 16 tháng 8 năm 2026, DeepSeek tính giá gấp đôi vào các ngày trong tuần từ 01:00 đến 04:00 và từ 06:00 đến 10:00 theo UTC, trừ ngày lễ của Trung Quốc. Theo giờ Bắc Kinh, đó gần như toàn bộ ngày làm việc; ở châu Âu là buổi sáng, ở Mỹ là buổi tối và ban đêm.
  • Tìm kiếm web. Khi Claude Code tìm kiếm trên internet bằng công cụ tích hợp, chính DeepSeek thực hiện tìm kiếm. Từ ngày 31 tháng 10 năm 2026, dịch vụ này tính phí: 0,75 USD cho 1000 truy vấn thành công, cộng thêm token mà mô hình dùng để đọc nội dung tìm được.

Cách 2: JoinGonka Gateway — một lệnh duy nhất

Trong mạng lưới Gonka có DeepSeek V4 Flash phiên bản 0731 — trọng số mở theo giấy phép MIT. Cổng kết nối tự tiếp nhận yêu cầu của Claude Code theo định dạng Anthropic (/v1/messages), không cần lớp trung gian nào.

Bước 1. Khóa. Đăng ký tại JoinGonka Gateway — tài khoản mới được tặng 3M token miễn phí — và tạo khóa jg-… trong bảng điều khiển.

Bước 2. Trình cài đặt.

npx @joingonka/setup --tool claude-code --model deepseek

Trình cài đặt sẽ hỏi khóa, lưu bản sao của ~/.claude/settings.json và chỉ ghi vào khối env các biến của riêng nó: địa chỉ cổng kết nối và khóa; mô hình cho phiên hiện tại và phiên mới, cho các alias opus, sonnet, fable và cho các tác nhân phụ; MiniMax M2.7 cho alias haiku, nơi Claude Code chạy các tác vụ nền; giới hạn thực của mô hình — cửa sổ 380 000 token và phản hồi tối đa 32 768. Nó không đụng đến các cài đặt khác của bạn, và đặt quyền 600 cho tệp chứa khóa. Cuối cùng, trình cài đặt sẽ kiểm tra khóa bằng một yêu cầu thực. Cùng trình cài đặt này cũng cấu hình được các chương trình khác — hiện đã có 25, trong đó có Codex CLI và OpenCode.

Bước 3. Kiểm tra. Chạy claude và mở /status: ở đó phải có dòng Anthropic base URL với địa chỉ cổng kết nối và dòng Auth token với ANTHROPIC_AUTH_TOKEN. Sau đó giao một nhiệm vụ về mã nguồn, ví dụ Read calc.py and tell me in one sentence whether it has a bug.

Cấu hình thủ công

Thêm khối env vào ~/.claude/settings.json — giá trị từ tệp này có hiệu lực cao hơn export trong shell:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://gate.joingonka.ai",
    "ANTHROPIC_AUTH_TOKEN": "jg-your-key",
    "ANTHROPIC_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMaxAI/MiniMax-M2.7",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "380000",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32768"
  }
}

Địa chỉ — không có /v1: Claude Code sẽ tự thêm đường dẫn /v1/messages. Tên mô hình — đầy đủ và không có [1m]: với hậu tố này, Claude Code sẽ cho rằng cửa sổ là 1 triệu token, trong khi DeepSeek V4 Flash trong mạng lưới chỉ có 380 000. Hai dòng cuối khai báo cửa sổ thực và mức trần phản hồi. Nếu không ghim mô hình, Claude Code sẽ gửi tên claude-* của mình, và cổng kết nối sẽ phản hồi bằng mô hình mặc định — hiện tại là GLM-5.3 Flash (zai-org/GLM-5.3-Flash).

Mọi phương án cấu hình, kể cả Windows và cấu hình chỉ cho một dự án, đều có trong hướng dẫn về Claude Code.

API DeepSeek và JoinGonka khác nhau thế nào trong Claude Code

API DeepSeekJoinGonka
Mô hìnhV4.1 Flash, phiên bản 1017V4 Flash, phiên bản 0731
Cửa sổ ngữ cảnh1 triệu token380 nghìn token
Phản hồi tối đa384 nghìn token32 768 token
Hình ảnhđọc đượcchỉ văn bản
Suy luận trong phản hồicó, theo khối thinkingkhông
Tìm kiếm web của Claude Coderiêng; từ 31.10.2026 — $0.75 cho 1000 truy vấntìm kiếm qua gateway
Giá mỗi tokengiờ cao điểm đắt gấp đôimột mức giá mọi thời điểm
Cacheđọc từ cache rẻ hơn 50 lần so với đầu vàotoàn bộ đầu vào cùng một mức giá
Các mô hình khác trên cùng keyV4 ProGLM-5.3 Flash, MiniMax M2.7

Điều này nghĩa là gì trong công việc:

  • Phiên bản mô hình. V4.1 Flash mới hơn và theo chính bài kiểm tra của DeepSeek thì mạnh hơn: trong Terminal-Bench 2.1, V4.1 Flash đạt 90,6 so với 82,7 của V4 Flash 0731 (theo dữ liệu công bố ngày 10 tháng 9 và 31 tháng 7). Nếu cần hình ảnh, cửa sổ một triệu token hay phiên bản mới nhất — hãy dùng API chính thức của DeepSeek. Nếu quan trọng hơn là giá cho khối lượng công việc lớn và một mức giá mọi thời điểm — hãy thử V4 Flash qua gateway trên chính tác vụ của bạn, có thể bắt đầu bằng token miễn phí.
  • Phiên làm việc dài. Cửa sổ 380 000 token chứa ít lịch sử hơn so với một triệu. Với công việc thông thường thì vẫn đủ: truy vấn trung bình của Claude Code tới DeepSeek V4 Flash qua gateway của chúng tôi vào tháng 10 năm 2026 là khoảng 96 nghìn token.

Chi tiết về chính mô hình này — trong bài viết về DeepSeek V4 Flash trong mạng lưới Gonka.

Một tác vụ Claude Code trên DeepSeek tốn bao nhiêu

Trước tiên là giá cho 1M token tính đến ngày 2 tháng 11 năm 2026 — theo trang giá của DeepSeek và API OpenRouter. Bên cạnh DeepSeek là cùng V4 Flash 0731 từ những nhà cung cấp rẻ nhất trên OpenRouter:

NơiMô hìnhĐầu vàoĐầu vào từ cacheĐầu ra
API DeepSeek, giờ cao điểmV4.1 Flash$0.30$0.006$1.20
API DeepSeek, thời gian còn lạiV4.1 Flash$0.15$0.003$0.60
OpenRouter, DeepInfraV4 Flash 0731$0.06$0.015$0.18
OpenRouter, StreamLakeV4 Flash 0731$0.132$0.0042$0.396
JoinGonka GatewayV4 Flash 0731$0.0062không có mức giá riêng$0.019

Đầu vào thông thường của chúng tôi rẻ hơn DeepSeek 24–49 lần, đầu ra rẻ hơn 32–65 lần. Nhưng đọc từ cache của DeepSeek vào giờ cao điểm tốn xấp xỉ bằng đầu vào của chúng tôi, còn thời gian còn lại thì rẻ hơn một nửa, và Claude Code gần như lúc nào cũng đọc lại cùng một thứ: system prompt, mô tả công cụ và lịch sử phiên. Vì vậy phải so sánh cả tác vụ, chứ không phải giá mỗi token.

Tác vụ. Lấy một tác vụ gồm 30 lượt gọi mô hình — ví dụ tìm lỗi, sửa code và chạy test. Theo dữ liệu gateway của chúng tôi tháng 10 năm 2026, một truy vấn Claude Code tới DeepSeek V4 Flash trung bình khoảng 96 nghìn token đầu vào và 0,9 nghìn token đầu ra. Tổng cộng tác vụ là 2,9 triệu token đầu vào và 27,5 nghìn token đầu ra. Claude Code gửi lại toàn bộ phiên ở mỗi bước, và gần như toàn bộ phiên trùng với truy vấn trước, nên ta giả định rằng ở DeepSeek và OpenRouter 95% đầu vào được đọc từ cache.

NơiTác vụ100 tác vụ như vậy
API DeepSeek, giờ cao điểm~$0.092~$9.20
API DeepSeek, thời gian còn lại~$0.046~$4.60
OpenRouter, StreamLake — nhà cung cấp rẻ nhất cho tác vụ này~$0.041~$4.10
OpenRouter, DeepInfra~$0.054~$5.40
JoinGonka Gateway~$0.018~$1.80

Các con số được tính theo giá ngày 2 tháng 11 năm 2026; giá mỗi token của chúng tôi trên trang này là giá trực tiếp và thay đổi theo tỷ giá GNK. Với tác vụ này, gateway rẻ hơn DeepSeek khoảng 5 lần vào giờ cao điểm, 2,5 lần vào thời gian còn lại và 2,3 lần so với nhà cung cấp rẻ nhất của cùng mô hình trên OpenRouter.

Chênh lệch phụ thuộc vào cache. Nếu 98% đầu vào đọc từ cache, DeepSeek đắt hơn chúng tôi khoảng 1,8 lần ngoài giờ cao điểm và 3,7 lần vào giờ cao điểm. Nếu 90% — thì 3,7 và 7,4 lần. Ở chúng tôi, tỷ lệ cache không ảnh hưởng đến tổng tiền: toàn bộ đầu vào có cùng một mức giá. Tính toán cho một tháng, phương án với GLM-5.3 Flash và giá của chính Claude để tham khảo — trong bài viết «Claude Code rẻ hơn».

Có cần claude-code-router không

Claude Code Router (CCR) — dự án mã nguồn mở theo giấy phép MIT: một cổng nội bộ chạy trên máy của bạn, mặc định tại http://127.0.0.1:3456. Claude Code và các agent khác gửi yêu cầu đến nó, còn nó chuyển tiếp đến các nhà cung cấp đã chọn: chuyển đổi yêu cầu giữa các định dạng (Anthropic Messages, OpenAI Chat và Responses, Gemini), phân luồng tác vụ theo mô hình dựa trên quy tắc, tự động chuyển sang mô hình dự phòng khi gặp sự cố và ghi nhật ký yêu cầu kèm số token và ước tính chi phí. Cài đặt dưới dạng ứng dụng cho macOS, Windows và Linux hoặc bằng lệnh npm install -g @musistudio/claude-code-router (cần Node.js 22 trở lên).

Với chỉ một DeepSeek thì không cần đến nó: DeepSeek có địa chỉ riêng theo định dạng Anthropic, và JoinGonka Gateway cũng nhận yêu cầu trực tiếp từ Claude Code. CCR chỉ có ý nghĩa nếu bạn muốn:

  • duy trì nhiều nhà cung cấp và các quy tắc phân luồng tác vụ;
  • tự động chuyển sang mô hình dự phòng khi mô hình chính không phản hồi;
  • xem nhật ký yêu cầu, token và chi phí ở một nơi;
  • kết nối một nhà cung cấp chỉ hiểu định dạng OpenAI.

CCR kết nối địa chỉ riêng (custom endpoint) theo giao thức Anthropic Messages hoặc OpenAI Chat, và cổng này hỗ trợ cả hai: địa chỉ cơ sở https://gate.joingonka.ai cho Anthropic và https://gate.joingonka.ai/v1 cho OpenAI. Chi tiết xem tại tài liệu Gonka API, mục Anthropic Messages.

Nên dùng khóa nào trong Claude Code và cách quay lại Claude

Claude Code lấy khóa của API bên thứ ba từ một trong hai biến:

  • ANTHROPIC_AUTH_TOKEN — khóa được gửi qua header Authorization: Bearer và có hiệu lực ngay. Cả hướng dẫn DeepSeek lẫn trình cài đặt của chúng tôi đều dùng cách này.
  • ANTHROPIC_API_KEY — khóa được gửi qua header x-api-key; ở chế độ tương tác, Claude Code sẽ hỏi một lần xem có dùng nó không.

DeepSeek và JoinGonka đều chấp nhận cả hai header. Khi biến chứa khóa được đặt, gói đăng ký claude.ai sẽ không bị tiêu hao: Claude Code vẫn nhớ thông tin đăng nhập của bạn nhưng không gửi nó đi, và các yêu cầu được thanh toán từ số dư của khóa đó. Nếu chỉ đặt địa chỉ mà không có khóa, Claude Code sẽ gửi thông tin đăng nhập claude.ai của bạn đến địa chỉ mới và yêu cầu sẽ không thành công.

Hãy lưu khóa trong ~/.claude/settings.json hoặc trong .claude/settings.local.json của dự án, nhưng đừng để trong .claude/settings.json chung của repository — vì tệp này thường được commit. Trình cài đặt với cờ --scope local sẽ ghi vào settings.local.json và tự động thêm nó vào .gitignore.

Quay lại Claude — xóa khỏi khối env những dòng trỏ đến DeepSeek hoặc cổng, rồi khởi động lại Claude Code: nó sẽ dùng lại thông tin đăng nhập claude.ai của bạn.

DeepSeek trong Claude Code có thể kết nối theo hai cách: API chính thức của DeepSeek — V4.1 Flash với cửa sổ 1 triệu token và giá gấp đôi vào giờ cao điểm — hoặc JoinGonka Gateway: V4 Flash 0731 mở, chỉ một lệnh cài đặt và một mức giá duy nhất mọi lúc. Không cần claude-code-router cho việc này. Theo giá ngày 2 tháng 11 năm 2026, một tác vụ điển hình với 30 lượt gọi mô hình qua cổng rẻ hơn 2,5–5 lần so với DeepSeek. Đổi lại — cửa sổ 380.000 token, chỉ văn bản và phiên bản mô hình trước đó.

Muốn tìm hiểu thêm?

Khám phá các phần khác hoặc bắt đầu kiếm GNK ngay bây giờ.

Nhận khóa và token miễn phí →