Hướng dẫn cài Claude Code với API bên thứ ba (9Flare) — 2026

Cập nhật tháng 8/2026 · Đọc trong 5 phút

Claude Code là CLI chính thức của Anthropic — cho phép bạn dùng Claude trực tiếp trong terminal để viết code, debug, refactor, và thậm chí tự động commit. Mặc định Claude Code yêu cầu API key từ Anthropic (thanh toán USD bằng thẻ quốc tế), nhưng bạn hoàn toàn có thể kết nối với API gateway bên thứ ba như 9Flare để dùng cùng model với giá rẻ hơn 13 lần và thanh toán VND.

Yêu cầu trước khi bắt đầu

  • Node.js 18+ (khuyến nghị 20 LTS)
  • Terminal: macOS Terminal, iTerm2, Windows Terminal, hoặc bất kỳ terminal hỗ trợ ANSI
  • Tài khoản 9Flare đã nạp tiền (hoặc dùng 2M token Haiku miễn phí)
  • API Key từ 9Flare (bắt đầu bằng sk-...)

Bước 1: Cài đặt Claude Code

Mở terminal và chạy lệnh sau:

Terminal
npm install -g @anthropic-ai/claude-code

Nếu bạn dùng macOS và gặp lỗi permission, thêm sudo phía trước. Trên Windows, mở terminal với quyền Administrator.

Bước 2: Cấu hình API Key và Base URL

Claude Code hỗ trợ custom API endpoint qua biến môi trường. Bạn cần set 2 biến:

macOS / Linux (thêm vào ~/.bashrc hoặc ~/.zshrc)

export ANTHROPIC_BASE_URL=https://api.9flare.com/v1
export ANTHROPIC_API_KEY=sk-your-key-here

Windows (PowerShell)

$env:ANTHROPIC_BASE_URL = "https://api.9flare.com/v1"
$env:ANTHROPIC_API_KEY = "sk-your-key-here"
Lưu ý: Thay sk-your-key-here bằng API key thật từ dashboard 9Flare. Key bắt đầu bằng sk- và có độ dài 48 ký tự.

Bước 3: Chạy Claude Code

Mở terminal trong thư mục project và gõ:

claude

Claude Code sẽ kết nối qua API 9Flare và bạn có thể bắt đầu chat ngay. Mọi model Claude (Haiku 4.5, Sonnet 5, Opus 5) đều hoạt động bình thường.

Chọn model cho Claude Code

Mặc định Claude Code dùng Sonnet — cân bằng giữa tốc độ và chất lượng. Bạn có thể đổi model bằng flag --model:

# Nhanh, rẻ — chat đơn giản
claude --model claude-haiku-4-5-20251001
# Mạnh nhất — suy luận phức tạp
claude --model claude-opus-5

Mẹo sử dụng hiệu quả

Dùng /compact khi context dài

Claude Code tự nén context khi gần giới hạn, nhưng bạn có thể gõ /compact để nén sớm hơn, tiết kiệm token.

Dùng Haiku cho task đơn giản

Rename biến, thêm comment, sửa typo — Haiku 4.5 làm tốt với giá chỉ $1/1M token.

Kết hợp với VS Code

Cài extension Claude Code trên VS Code để có trải nghiệm tích hợp: highlight code → Ask Claude.

Theo dõi usage

Vào dashboard 9Flare để xem lượng token đã dùng theo từng key, từng model.

Xử lý lỗi thường gặp

401 Unauthorized

API key sai hoặc hết hạn. Kiểm tra lại key trong dashboard, đảm bảo copy đủ 48 ký tự.

429 Too Many Requests

Vượt giới hạn RPM của gói. Gói Spark giới hạn 40 RPM. Nâng cấp gói hoặc đợi 1 phút rồi thử lại.

Connection refused

Kiểm tra ANTHROPIC_BASE_URL đúng là https://api.9flare.com/v1 (có /v1 ở cuối). Đảm bảo không bị firewall chặn.

Model not found

Dùng đúng model ID từ trang /docs. Ví dụ: claude-sonnet-5 chứ không phải sonnet-5.

Bắt đầu dùng Claude Code ngay

Đăng ký 9Flare miễn phí, lấy API key, cài Claude Code trong 3 phút.

Đăng ký miễn phí Xem bảng giá