AI-FAMING STORE
Tin tức và kiến thức

Nối Claude Code với API riêng: 5 lỗi hay gặp và cách sửa

Kiến thức16/10/2026

Báo 'does not support this model', nhầm tên model, lẫn với tài khoản Claude đang dùng... Các lỗi chúng tôi đã gặp thật khi thử với Claude Code bản mới.

Phần lớn lỗi khi nối Claude Code với một API khác không nằm ở key, mà ở phiên bản và tên model. Dưới đây là các lỗi chúng tôi đã gặp thật khi thử ngày 12/10/2026, kèm cách sửa.

1. "Claude Code 2.1.x does not support this model; version 2.1.280 or newer is required"

Claude Sonnet 5.5 và Opus 5.5 từ chối Claude Code cũ hơn 2.1.280. Máy chủ model đọc phiên bản Claude Code gửi kèm trong mỗi lượt gọi.

Sửa: chạy claude --version để xem bản đang dùng, rồi claude update. Tiện ích Claude Code trong VS Code cập nhật riêng, qua mục Extensions. Lượt bị từ chối kiểu này không bị tính tiền.

2. Viết tên model bằng dấu chấm

claude-sonnet-5.5 và claude-sonnet-5-5 đều gọi được, nhưng Claude Code chỉ nhận ra tên viết gạch ngang. Nhận ra model thì nó mới bật đúng tính năng (mức suy nghĩ, cách gửi ngữ cảnh) cho model đó.

"ANTHROPIC_MODEL": "claude-sonnet-5-5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"

3. Dán cấu hình vào settings chung, cả máy đổi theo

~/.claude/settings.json áp cho mọi phiên Claude Code trên máy, kể cả tiện ích trong VS Code. Nếu bạn vẫn dùng tài khoản Claude riêng cho việc khác, đặt cấu hình theo thư mục dự án:

du-an-cua-ban/
  .claude/
    settings.json   <- khối "env" đặt ở đây

Mở Claude Code trong thư mục đó thì đi qua API riêng; thư mục khác vẫn dùng tài khoản cũ.

4. "Key không đúng hoặc đã bị thu hồi"

  • Kiểm tra key dán vào ANTHROPIC_AUTH_TOKEN có thừa dấu cách, xuống dòng hay dấu nháy không.
  • Vừa bấm Tạo key mới thì key cũ hết hiệu lực ngay: chép lại key mới vào mọi máy.
  • Địa chỉ ANTHROPIC_BASE_URL là https://ai-api.4cctops.org, không thêm /v1 ở cuối với Claude Code.

5. "prompt is too long"

Ngữ cảnh vượt giới hạn của model. Gõ /compact để Claude Code tóm gọn hội thoại rồi làm tiếp, hoặc mở phiên mới cho việc mới. Lượt bị từ chối vì quá dài không bị tính tiền.

Kiểm tra nhanh sau khi cài

Hỏi một câu bất kỳ rồi mở trang Lịch sử dùng: lượt gọi hiện ở đó, đúng model bạn chọn, nghĩa là mọi thứ đã nối đúng.

Bài khác