Claude Code dùng GLM, DeepSeek, Qwen, Kimi, MiniMax: cấu hình từng hãng và lỗi hay gặp

Chạy Claude Code bằng model không phải Claude là thế nào?

Claude Code gửi request theo giao thức Anthropic Messages. Z.ai (GLM), DeepSeek, Alibaba (Qwen), Moonshot (Kimi) và MiniMax đều mở endpoint nói đúng giao thức này và có trang hướng dẫn Claude Code riêng. Cách làm chung: đặt ANTHROPIC_BASE_URL là địa chỉ của hãng, đặt API key của hãng, rồi gán model của hãng cho từng hạng opus, sonnet, haiku, fable và subagent.

Anthropic nói rõ không hỗ trợ việc chạy Claude Code bằng model không phải Claude qua bất kỳ gateway nào. Tài liệu Claude Code cũng ghi ANTHROPIC_BASE_URL chỉ đổi nơi nhận request, không đổi model trả lời: Claude Code coi endpoint đó là Claude API và không biết phía sau là model gì, nên model của hãng khác có thể vẫn tự giới thiệu là Claude do system prompt của Claude Code.

Khi base URL không phải api.anthropic.com, Claude Code tắt Remote Control và cài đặt quản lý từ máy chủ; đọc chính tả bằng giọng nói không chạy khi dùng API key; công cụ WebSearch chỉ chạy nếu hãng tự làm tìm kiếm phía máy chủ, như DeepSeek và Alibaba.

Base URL, biến key và model id của từng hãng

Theo trang hướng dẫn Claude Code của chính từng hãng (bản quốc tế, đọc ngày 25/10/2026):

• Z.ai (GLM): base URL https://api.z.ai/api/anthropic, key đặt trong ANTHROPIC_AUTH_TOKEN. Trang Claude Code của Z.ai gán opus và sonnet là glm-5.3[1m], haiku là glm-5.3-flash[1m]; trang chuyển model của Z.ai lại khuyên cả ba là glm-5.3-flash[1m]. Có công cụ tự cấu hình npx @z_ai/coding-helper.
• DeepSeek: base URL https://api.deepseek.com/anthropic, key trong ANTHROPIC_AUTH_TOKEN; model chính, opus, sonnet là deepseek-flash[1m], haiku và subagent là deepseek-flash, kèm CLAUDE_CODE_EFFORT_LEVEL=max. Model mạnh hơn là deepseek-v4-pro.
• Alibaba Model Studio (Qwen), gói Coding Plan: base URL https://coding-intl.dashscope.aliyuncs.com/apps/anthropic, key của gói bắt đầu bằng sk-sp-, mọi hạng là qwen3.7-plus. Trả theo token thì dùng địa chỉ theo workspace dạng https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic (địa chỉ cũ https://dashscope-intl.aliyuncs.com/apps/anthropic vẫn chạy), model qwen3.7-max, haiku qwen3.6-flash. Base URL dừng ở /apps/anthropic, không thêm /v1.
• Kimi API Platform (trả theo token): base URL https://api.moonshot.ai/anthropic, key trong ANTHROPIC_AUTH_TOKEN; model chính, opus, sonnet, fable, subagent là kimi-k3[1m], haiku là kimi-k2.7-code.
• Kimi Code (gói thành viên Kimi): base URL https://api.kimi.ai/coding/, key đặt trong ANTHROPIC_API_KEY chứ không phải ANTHROPIC_AUTH_TOKEN; mọi hạng là k3.1-pro, hoặc k3.1-pro[1m] nếu gói có ngữ cảnh 1 triệu token.
• MiniMax: base URL https://api.minimax.io/anthropic, key trong ANTHROPIC_AUTH_TOKEN (với gói M Plan là Subscription Key); mọi hạng là MiniMax-M3.1-Flash[1m], kèm CLAUDE_CODE_AUTO_COMPACT_WINDOW=524288. Có công cụ tự cấu hình npx -y mmx-cli@latest agent setup.

Ví dụ: file settings.json cho DeepSeek

Đặt cấu hình trong ~/.claude/settings.json ở thư mục home để áp cho mọi phiên, kể cả extension VS Code dùng chung file này. Đừng đặt key vào .claude/settings.json của dự án, vì file đó thường được commit. Khi cùng một biến có ở cả shell lẫn khối env của file settings, giá trị trong file settings được dùng; mọi giá trị trong env nên viết dạng chuỗi, kể cả số như "1".

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "<API key DeepSeek của bạn>",
    "ANTHROPIC_MODEL": "deepseek-flash[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-flash[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-flash[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-flash",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "deepseek-flash[1m]",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-flash",
    "CLAUDE_CODE_EFFORT_LEVEL": "max"
  }
}

Hậu tố [1m] và độ dài ngữ cảnh

Hậu tố [1m] sau model id chỉ là tín hiệu cho Claude Code: có nó, Claude Code coi model có cửa sổ ngữ cảnh 1 triệu token và bỏ hậu tố trước khi gửi request. Không có nó, Claude Code coi model lạ là 200K token và hiện cảnh báo “isn't recognized · context assumed to be 200k tokens”, nên tự nén hội thoại sớm hơn cần thiết.

Biến CLAUDE_CODE_AUTO_COMPACT_WINDOW chỉnh lúc tự nén, nhận giá trị từ 100.000 tới 1.000.000. Khi endpoint của hãng báo tràn ngữ cảnh bằng câu chữ riêng, như “Prompt too long” của Z.ai, Claude Code không nhận ra để tự nén; lúc đó gõ /compact rồi hạ giá trị tự nén xuống.

Điền đủ các hạng model, kể cả fable và subagent

Claude Code gọi model theo hạng: phiên chính, opus, sonnet, haiku (cho tác vụ nền), fable và subagent. Hạng nào chưa gán model của hãng thì Claude Code gửi tên model Claude thật, ví dụ alias fable mặc định là claude-fable-5-1, và phần lớn endpoint của hãng sẽ từ chối tên đó. Kimi ghi rõ: điền thiếu biến làm các tình huống tương ứng lỗi mà không báo gì.

Riêng DeepSeek tự đổi tên Claude: tên bắt đầu bằng claude-opus được chuyển sang deepseek-v4-pro và tính theo giá của model này, các tên claude khác chuyển sang deepseek-flash; tên lạ không bắt đầu bằng claude thì bị trả lỗi. Biến cũ ANTHROPIC_SMALL_FAST_MODEL đã bị thay bằng ANTHROPIC_DEFAULT_HAIKU_MODEL.

Key gói thuê bao khác key trả theo token

Mỗi hãng tách key của gói dành cho công cụ lập trình khỏi key API trả theo token. Dùng nhầm loại key, hoặc đúng key nhưng sai base URL, thì bị lỗi 401, hoặc bị trừ vào số dư tài khoản dù đang có gói:

• Z.ai: từ 16/10/2026, key API thường và key GLM Coding Plan được quản lý riêng; với key tạo từ ngày đó, loại key quyết định cách tính tiền.
• Alibaba: gói Coding Plan dùng key bắt đầu bằng sk-sp- cùng base URL riêng của gói; key thường bắt đầu bằng sk-.
• MiniMax: Subscription Key của gói M Plan và key trả theo token không dùng thay nhau được.
• Kimi: key của Kimi Code và key của Kimi API Platform khác nhau, khác cả base URL lẫn biến môi trường.
• DeepSeek không có gói thuê bao, chỉ trả theo token.

Các gói dành cho công cụ lập trình

Bốn hãng có gói thuê bao cho coding agent: GLM Coding Plan (Lite, Pro, Max, hạn mức tính bằng credit theo cửa sổ 5 giờ và theo tuần), Alibaba Coding Plan và Token Plan, Kimi Code trong các gói thành viên Kimi, và MiniMax M Plan (Go, Explore, Build). Theo điều khoản của từng hãng, các gói này dành cho một người dùng tương tác trong công cụ lập trình, không dùng làm API cho ứng dụng, bot hay website của bạn; cần gọi model từ ứng dụng thì dùng API trả theo token. Đặc điểm từng hãng có ở bài GLM là gì, Qwen là gì, DeepSeek là gì và MiniMax là gì.

Không tắt được chế độ suy nghĩ

Một số model luôn suy nghĩ trước khi trả lời và báo lỗi 400 nếu request yêu cầu tắt:

• GLM-5.3 và GLM-5.3-Flash qua API thường báo lỗi khi thinking.type là disabled; gói GLM Coding Plan thì tự đổi “tắt” thành mức suy nghĩ thấp và vẫn chạy.
• MiniMax-M3.1-Flash báo “requires adaptive thinking”; các cách tắt như MAX_THINKING_TOKENS=0 không có tác dụng.
• kimi-k2.7-code báo “invalid thinking: only type=enabled is allowed for this model”, K3.1 Pro của Kimi Code báo không hỗ trợ tắt suy nghĩ; bật lại bằng phím Option+T trên macOS hoặc Alt+T.
• DeepSeek và Qwen vẫn tắt được chế độ suy nghĩ.

Tính năng Anthropic chưa được hỗ trợ đủ

Endpoint của các hãng tương thích phần lớn chứ không trọn vẹn:

• DeepSeek không nhận file PDF; chỉ deepseek-flash đọc được ảnh, deepseek-v4-pro thì không.
• Kimi bỏ qua cache_control trong tin nhắn, chỉ nhận công cụ loại custom, và trả lỗi không tìm thấy với yêu cầu đếm token.
• MiniMax bỏ qua temperature và stop_sequences.
• Z.ai chưa công bố bảng tương thích.
• Từ Claude Code v2.1.304, tính năng tool search bật sẵn khi dùng gateway; nếu gặp lỗi 400 về trường lạ, đặt ENABLE_TOOL_SEARCH=false. Lỗi “Extra inputs are not permitted” thì cập nhật Claude Code hoặc đặt CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1.

Lỗi hay gặp và cách sửa

Đối chiếu thông báo trên màn hình với các trường hợp sau:

• 401 ngay từ request đầu: key nằm sai biến. ANTHROPIC_AUTH_TOKEN gửi key qua header Authorization: Bearer, ANTHROPIC_API_KEY gửi qua x-api-key; endpoint đọc header kia thì báo 401. Đặt cả hai biến cùng lúc, Claude Code cảnh báo “auth may not work as expected”; xoá biến thừa.
• 401 dù key đúng: loại key không khớp base URL, ví dụ key API thường dùng với địa chỉ của gói Coding Plan, hoặc key Kimi Platform dùng với Kimi Code.
• Claude Code vẫn đòi đăng nhập hoặc báo “Unable to connect to Anthropic services”: đặt key ở nơi Claude Code đọc trước bước thiết lập lần đầu (lệnh export trong shell hoặc khối env của ~/.claude/settings.json). Nhiều hãng còn khuyên thêm "hasCompletedOnboarding": true vào ~/.claude.json; đây là cờ nội bộ, tài liệu của Anthropic không nhắc tới.
• “There's an issue with the selected model” hoặc model not found: model id sai, đã bị khai tử, hoặc một hạng chưa được gán; gõ /model để xem hạng đang chạy.
• Danh sách /model chỉ hiện tên Claude: bình thường, vì Claude Code không tự thấy model của hãng; model thật là model bạn gán trong các biến ANTHROPIC_DEFAULT_*.
• Hết hạn mức gói: Z.ai báo “Usage limit reached” kèm giờ đặt lại, Kimi Code báo “You've reached your 5-hour usage limit”; chờ tới giờ đặt lại hoặc chuyển sang key trả theo token.

Kiểm tra đã nối đúng chưa

Mở Claude Code và gõ /status: dòng Anthropic base URL phải hiện địa chỉ của hãng, dòng Auth token hoặc API key cho biết đang dùng key chứ không phải phiên đăng nhập claude.ai, và dòng Model hiện model id bạn đã gán. Nếu chỉ đặt base URL mà quên key, request vẫn đi tới máy chủ của hãng nhưng mang thông tin đăng nhập claude.ai, nên luôn đặt hai biến cùng lúc.

Muốn Claude Code không gửi số liệu sử dụng về Anthropic, đặt CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1; biến này tắt cả tự cập nhật, nên nhớ tự cập nhật Claude Code. Công cụ WebFetch vẫn gửi tên miền tới api.anthropic.com để kiểm tra an toàn.

Model id cũ cần thay trong cấu hình

Nhiều hướng dẫn cũ vẫn ghi các tên đã bị khai tử hoặc thay thế:

• DeepSeek: deepseek-chat và deepseek-reasoner ngừng sau ngày 24/07/2026; dùng deepseek-flash hoặc deepseek-v4-pro.
• GLM: glm-4.6, glm-4.7 và các bản 4.5 đã cũ; trong gói Coding Plan, request gọi GLM-4.7 bị chuyển sang GLM-5.3-Flash mà không báo lỗi.
• Kimi: kimi-k2.5 ngừng từ 31/08/2026 và trả lỗi không tìm thấy model; dòng K2 cũ đã ngừng từ 25/05/2026.
• MiniMax: M2 và M2.1 đã bị bỏ, M2.5 và M2.7 ngừng ngày 18/11/2026.
• Claude Code: gói npm nay cần Node.js 22 trở lên, Anthropic khuyên dùng bộ cài native; xem bài cài đặt Claude Code.

Dùng model Claude bằng API key trả bằng VND

Nếu muốn giữ Claude Code chạy bằng chính model Claude nhưng không có thẻ quốc tế, đặt ANTHROPIC_BASE_URL và key của STEYG Code theo bài dùng Claude Code với API key riêng. Cùng một key STEYG Code còn gọi được DeepSeek, GLM, Qwen trong các công cụ nói chuẩn OpenAI như Cline, OpenCode, Cursor; xem bài API DeepSeek, GLM, Qwen thanh toán bằng VND. Lỗi riêng của Claude Code có ở bài lỗi Claude Code thường gặp.

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