Hướng dẫn cài đặt APIVN

Tạo tài khoản miễn phí Đã có tài khoản? Đăng nhập

1. Đăng ký tài khoản

Mở apivn.vn và đăng ký bằng email. Ngay sau đó, vào mục Tài khoản bật xác thực hai lớp (2FA): số dư của bạn là tiền thật, đáng được bảo vệ thêm một lớp.

2. Nạp số dư

Trong Bảng điều khiển chọn Ví, chọn số tiền, rồi quét mã VietQR bằng ứng dụng ngân hàng. Giữ nguyên nội dung chuyển khoản để hệ thống nhận diện; số dư thường được cộng trong vòng một phút. Đừng quét bằng MoMo, ShopeePay hay ZaloPay: các ví này ghi đè nội dung chuyển khoản nên tiền không tự cộng được. Mức nạp tối thiểu hiển thị ngay trong trang Ví. Chi tiết xem hướng dẫn nạp tiền.

3. Lấy khoá API

Đăng ký xong là đã có sẵn một khoá trong mục Khóa API, không phải tự tạo. Khoá này thuộc nhóm Tự động: một khoá dùng được mọi mô hình của bảy nhóm Claude, GPT, Gemini, Grok, DeepSeek, China và Image (tạo ảnh), mỗi mô hình tính đúng giá nhóm của nó. Muốn tách chi phí từng dự án thì vào Khóa API → Tạo Khóa API để có thêm khoá. Tuyệt đối không nhúng khoá vào mã chạy trên trình duyệt, đường dẫn URL, ảnh chụp màn hình hay kho mã công khai.

4. Cài vào công cụ của bạn

Nhanh nhất: cài bằng 1 lệnh

Máy đã có Claude Code, Codex hoặc OpenCode? Lệnh apivn đăng nhập giúp bạn và tự điền cấu hình cho cả ba, không phải chép khoá hay sửa tệp nào bằng tay. Lệnh này không cài các công cụ đó; chưa có thì cài theo các mục bên dưới trước.

macOS / Linux (Terminal):

curl -fsSL https://apivn.vn/cli/install.sh | sh

Windows (PowerShell):

irm https://apivn.vn/cli/install.ps1 | iex

Sau khi bấm Enter:

1. Lệnh tải đúng bản cho máy bạn, đối chiếu mã SHA-256 (lệch là dừng, không cài), đặt vào ~/.apivn/bin và thêm thư mục đó vào PATH.
2. Trình duyệt tự mở trang xác nhận trên apivn.vn (chưa đăng nhập thì đăng nhập trước). Terminal hiện một mã dạng XXXX-XXXX; mã trên trang phải trùng mã đó.
3. Nhóm chọn sẵn là Tự động: một khoá gọi được mọi mô hình. Muốn Claude Code hay Codex chạy nhóm khác thì bấm Tự chọn nhóm.
4. Bấm Đồng ý. Lệnh nhận khoá mới (nằm ở trang Khoá API, tên bắt đầu bằng APIVN CLI), ghi cấu hình cho Claude Code (~/.claude/settings.json), Codex (~/.codex/config.toml, máy đã có Codex thì hỏi trước; đang đăng nhập ChatGPT thì mặc định giữ nguyên) và OpenCode (~/.config/opencode/opencode.json), rồi gọi thử một lượt để báo khoá đã chạy.

Hoàn tác: apivn restore trả các tệp cấu hình về như trước lần chạy gần nhất (gõ thêm lần nữa thì lùi tiếp). Khoá đã tạo vẫn nằm ở trang Khoá API, không dùng nữa thì xoá ở đó.

Lệnh hay dùng: apivn status xem công cụ đang trỏ vào đâu · apivn list các hồ sơ theo nhóm · apivn use <nhóm> đổi nhóm cho lệnh claude (thêm --codex để đổi cho Codex) · apivn kiem-tra soát lỗi cấu hình · apivn cap-nhat nạp mô hình mới mà không đăng nhập lại.

Hoặc làm theo video (qua CC Switch, không cần gõ lệnh)

5. Chọn cách dùng khác

Bảng dưới xếp theo việc bạn muốn làm. Khoá mặc định ở nhóm Tự động nên dùng được hết, không phải bận tâm chọn nhóm.