Dùng Claude Code với API key Việt Nam: cấu hình trong 3 bước

Nếu bạn đã từng dùng Claude Code, bạn biết cảm giác đó: giao một việc cho terminal, quay lại thấy code đã được viết, đã được chạy thử. Câu hỏi tiếp theo thường không phải là "có nên dùng không", mà là "trả tiền thế nào cho gọn".

Bài viết này hướng dẫn cấu hình Claude Code dùng API key của MonkeyTech API: trả theo token thực dùng, nạp ví bằng VNĐ, không cần thẻ quốc tế.

Khi nào nên dùng Claude Code qua API key?

• Bạn muốn trả theo đúng lượng dùng thay vì một gói cố định hằng tháng.
• Bạn cần chia chi phí theo dự án hoặc theo máy, mỗi nơi một key riêng.
• Bạn muốn nhìn thấy chi phí từng lượt gọi, không chờ tới cuối tháng.
• Đội của bạn có nhiều người, cần một ví chung nạp bằng VNĐ.

Bước 1: Tạo API key

Đăng ký tại MonkeyTech API, xác thực email, nạp ví qua VietQR rồi tạo API key trong bảng điều khiển. Key có dạng sk-mtk-....

Nên tạo một key riêng cho mỗi máy dùng Claude Code. Khi cần thu hồi một máy, bạn chỉ thu hồi đúng key đó.

Bước 2: Đặt biến môi trường

Claude Code nói chuẩn Anthropic, nên URL gốc là https://api.monkeytech.vn, không có /v1 ở cuối. Đây là chỗ cấu hình sai phổ biến nhất: dán nhầm URL có /v1 sẽ ra lỗi 404.

macOS, Linux:

export ANTHROPIC_BASE_URL="https://api.monkeytech.vn"
export ANTHROPIC_AUTH_TOKEN="sk-mtk-..."

Windows (PowerShell):

setx ANTHROPIC_BASE_URL "https://api.monkeytech.vn"
setx ANTHROPIC_AUTH_TOKEN "sk-mtk-..."

Muốn giữ cấu hình lâu dài trên macOS, Linux, thêm hai dòng export vào ~/.zshrc hoặc ~/.bashrc. Sau đó mở một terminal mới để biến môi trường có hiệu lực.

Bước 3: Mở Claude Code và kiểm tra

Mở terminal mới, chạy claude và giao một việc nhỏ. Mỗi lượt gọi sẽ hiện chi phí trong bảng điều khiển MonkeyTech API ngay sau đó, nên bạn biết chính xác việc vừa làm tốn bao nhiêu.

Từ lúc này, mỗi lần giao việc cho Claude Code, bạn không còn phải đoán chi phí nữa.

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

Hiện tượng	Nguyên nhân	Cách xử lý
Claude Code cứ đòi đăng nhập	Máy còn phiên đăng nhập tài khoản Anthropic cũ	Chạy /logout trong Claude Code, đặt ANTHROPIC_AUTH_TOKEN rồi mở lại terminal
Lỗi 404	Dán URL có /v1	Dùng https://api.monkeytech.vn không có /v1
Biến môi trường không có tác dụng	Terminal cũ vẫn giữ giá trị cũ	Mở terminal mới (Windows: đăng xuất rồi đăng nhập lại)
Lỗi 402	Hết số dư ví	Nạp thêm tại bảng điều khiển
Lỗi 429	Quá nhiều luồng chạy song song	Giảm số luồng, hoặc tách thành nhiều key cho từng máy

Chi phí được tính thế nào?

• Mỗi lượt gọi trừ vào ví theo token thực dùng (đầu vào, đầu ra và cache nếu có) với đơn giá của model bạn chọn.
• Lỗi xác thực, dữ liệu không hợp lệ, lỗi 4xx/5xx không bị trừ tiền.
• Số dư ví VNĐ không hết hạn.

Muốn ước tính trước một phiên làm việc tốn bao nhiêu, xem bài token là gì và cách tính chi phí API AI theo VNĐ.

Tạo API key cho Claude Code