Có thể dùng Claude Code tại Việt Nam qua API gateway hỗ trợ QR: nạp 99k, đặt `ANTHROPIC_API_KEY` và `ANTHROPIC_BASE_URL`, rồi giữ nguyên base URL, không tự thêm `/v1`. Bài này tập trung vào phần bạn cần để bắt đầu trong terminal: chuẩn bị API key, nạp tiền bằng QR hoặc chuyển khoản, cấu hình hai biến môi trường và kiểm tra request nhỏ trước khi đưa vào dự án. Claude Code làm việc trực tiếp với mã nguồn qua dòng lệnh; gateway đứng giữa công cụ và dịch vụ model, nên endpoint và cách tính phí phải lấy theo tài liệu của nhà cung cấp.

Tóm tắt nhanh

• Mức nạp khởi đầu

được nêu trong brief là 99.000 đồng, phù hợp để thử một tác vụ nhỏ trước.

• Hai biến cần cấu hình là `ANTHROPIC_API_KEY` và `ANTHROPIC_BASE_URL`; tên biến phải đúng với công cụ bạn đang chạy.
• Base URL giữ nguyên như gateway công bố; nối thêm `/v1` có thể khiến request đi vào đường dẫn `404`.

Claude Code là công cụ dòng lệnh chạy trong terminal, nơi bạn có thể yêu cầu AI đọc mã nguồn, sửa file hoặc hỗ trợ kiểm tra lỗi ngay trong thư mục dự án. Điểm cần phân biệt là Claude Code không tự tạo quyền truy cập model: mỗi request phải đi qua một API key do dịch vụ phía sau cấp. Khi dùng tại Việt Nam qua gateway, luồng request có ba phần: Claude Code gửi yêu cầu, gateway xác thực bằng API key rồi định tuyến đến model phù hợp. Chi phí được ghi nhận theo mức sử dụng trên gateway, thay vì lấy trực tiếp từ gói Claude Pro trong tài khoản người dùng. Vì vậy, số dư gateway và trạng thái thuê bao Claude Pro là hai chuyện khác nhau. Cách này được người dùng Việt Nam quan tâm vì một số gateway cho phép nạp tiền bằng cách quét QR hoặc chuyển khoản ngân hàng. Gợi ý trong tài liệu nghiên cứu là nạp 99k để bắt đầu kiểm thử, sau đó cấu hình hai biến môi trường `ANTHROPIC_API_KEY` và `ANTHROPIC_BASE_URL` trong terminal. Đây là mô hình thanh toán qua dịch vụ trung gian, không phải billing trực tiếp với Anthropic bằng thẻ Visa.

Điểm khác so với dùng Claude trực tiếp Với Claude Pro, bạn thường làm việc trong giao diện hoặc quyền truy cập do Anthropic quản lý. Với Claude Code qua gateway, bạn kiểm soát request bằng API key và endpoint do gateway công bố. Base URL phải giữ đúng như tài liệu

của nhà cung cấp; không tự nối thêm `/v1`, vì phần đường dẫn này có thể đã được gateway xử lý sẵn. Nếu URL sai, lỗi `404` có thể xuất hiện dù API key vẫn còn số dư. Mô hình này phù hợp khi bạn cần chạy Claude Code trong terminal nhưng gặp trở ngại với phương thức thanh toán quốc tế. Nó cũng thêm một lớp phụ thuộc: model, định dạng request, số dư và khả năng tương thích đều do gateway quyết định. Vì vậy, “không cần thẻ Visa” không có nghĩa là dùng Claude miễn phí; bạn vẫn cần nạp tiền và theo dõi mức trừ phí theo từng request.

Để dùng Claude Code tại Việt Nam mà không nhập thẻ Visa, bạn cần một tài khoản gateway có hỗ trợ nạp bằng QR, một API key còn hoạt động và số dư ban đầu 99.000 đồng. Đây là phần thanh toán và định tuyến request; Claude Code vẫn chạy trong terminal trên máy của bạn.

Tài khoản và số dư Hãy đăng ký tài khoản tại nhà cung cấp API gateway công bố rõ cách nạp QR hoặc chuyển khoản ngân hàng. Sau khi quét mã QR, kiểm tra dashboard đã ghi nhận đủ 99.000 đồng trước khi cấu hình terminal. Đừng mặc định rằng giao dịch thành công đồng nghĩa số dư đã sẵn sàng; một số cổng cần bạn tải lại trang hoặc chờ trạng thái thanh toán cập nhật. API key phải còn hiệu lực, chưa bị thu hồi và không bị giới hạn quyền gọi model. Bạn nên lấy key từ dashboard thay vì dán lại một chuỗi cũ trong ghi chú cá nhân. Khi cấu hình Claude Code, hai tên biến cần có là `ANTHROPIC_API_KEY` và `ANTHROPIC_BASE_URL`; phần giá trị phải đối chiếu với tài liệu

của gateway đang dùng.

Môi trường chạy Claude Code cần

được cài sẵn trong terminal bạn thực sự sử dụng, chẳng hạn macOS hoặc Linux dùng shell, còn Windows có thể dùng PowerShell. Nếu lệnh `claude` chưa chạy được trong terminal, việc nạp 99.000 đồng và tạo API key cũng chưa đủ để kiểm thử. Base URL là chi tiết dễ sai nhất khi gateway hướng dẫn cấu hình riêng. Hãy sao chép đúng địa chỉ nhà cung cấp công bố cho `ANTHROPIC_BASE_URL`, rồi giữ nguyên chuỗi đó; không tự nối thêm `/v1`. Một URL bị thừa `/v1` có thể khiến Claude Code gọi nhầm đường dẫn và trả lỗi `404`, dù API key và số dư đều hợp lệ.

Kiểm tra trước khi bắt đầu Bạn nên có đủ năm thứ: tài khoản gateway, giao dịch QR 99.000 đồng đã ghi nhận, API key còn dùng

được, Claude Code chạy được bằng lệnh `claude`, và base URL chính thức. Chỉ khi đủ năm mục này, việc kiểm tra lỗi `401`, `403` hoặc `404` ở bước cấu hình mới có ý nghĩa.

Một cấu hình sai ở `ANTHROPIC_BASE_URL`, nhất là tự nối thêm `/v1`, có thể khiến Claude Code trả `404` dù API key và số dư đều còn. Quy trình dưới đây đi theo thứ tự: lấy key, nạp QR 99k, đặt đúng hai biến môi trường rồi chạy một tác vụ nhỏ trong terminal.

Sáu bước cần làm

Gateway không thay Anthropic

Khi dùng Claude Code qua gateway, bạn đang gửi request đến nhà cung cấp trung gian; khoản nạp QR 99k và số dư hiển thị trên gateway không phải billing account trực tiếp của Anthropic. Vì vậy, lỗi tài khoản Anthropic, chính sách model hoặc thay đổi quyền truy cập từ hãng không nhất thiết được gateway xử lý thay bạn.

Tương thích không mặc định

Claude Code có thể gửi request theo endpoint, model và định dạng mà gateway phải hỗ trợ đúng. Chỉ cần `ANTHROPIC_BASE_URL` trỏ sai đường dẫn, hoặc bạn tự nối thêm `/v1` khi URL đã có sẵn, request có thể trả `404`. Lỗi `401` thường liên quan API key; `403` có thể là quyền hoặc model; còn lỗi định dạng body phải đối chiếu tài liệu của gateway. Không nên suy ra một model chạy được trong Claude Code chỉ vì model đó có trên bảng giá.

Số dư không quy đổi thành số lượt

Cùng một số dư, tác vụ đọc một file 100 dòng và tác vụ phân tích cả repository sẽ tiêu thụ lượng token khác nhau. Chi phí còn phụ thuộc model, độ dài lịch sử hội thoại và số lần Claude Code gọi API; hãng hoặc gateway chưa công bố một quy đổi cố định kiểu “99k dùng được bao nhiêu phiên”. Hãy thử bằng một task nhỏ, ghi lại số dư trước và sau, rồi đặt ngưỡng chi tiêu riêng.

API key có nhiều điểm dễ lộ

Lệnh như `export ANTHROPIC_API_KEY=…` có thể nằm trong shell history nếu bạn gõ trực tiếp. Key cũng có thể bị commit cùng `.env`, xuất hiện trong log CI hoặc bị in ra khi debug request. Dùng biến môi trường, thêm `.env` vào `.gitignore`, che header `x-api-key` hoặc `Authorization`, và thu hồi key ngay khi thấy `401` bất thường hoặc phát hiện log chứa giá trị thật.

Kiểm tra trước dự án quan trọng

Trước khi giao repository của khách hàng cho Claude Code, hãy hỏi gateway dữ liệu được lưu bao lâu, có dùng để huấn luyện hay không, uptime được công bố ở đâu và kênh hỗ trợ phản hồi trong bao lâu. Với dự án cần chạy liên tục, bạn nên kiểm thử ngắt kết nối, giới hạn tốc độ và thời gian chờ trước; số dư còn tiền không bảo đảm endpoint luôn sẵn sàng.

Một lần nạp QR 99k có thể là điểm bắt đầu để bạn thử Claude Code trên một thay đổi nhỏ, thay vì giao ngay cả dự án cho công cụ. Giá trị thực tế nằm ở việc đưa yêu cầu vào terminal, xem diff rồi tự quyết định có nhận phần sửa hay không.

Thử Claude Code trên một việc có phạm vi rõ Giả sử bạn có một script Python đọc file CSV nhưng lỗi khi gặp ô trống. Trong terminal, mở đúng thư mục dự án và yêu cầu Claude Code kiểm tra hàm đọc dữ liệu, đề xuất cách xử lý giá trị rỗng, rồi giải thích file nào

sẽ bị sửa. Xem diff trước khi áp dụng; sau đó chạy lại script với một CSV có ô trống để kiểm tra hành vi. Đây là ví dụ minh họa, không phải cam kết rằng model sẽ tìm đúng lỗi ngay lần đầu. Bạn cũng có thể nhờ công cụ đọc thông báo lỗi, phác thảo test cho hàm đang sửa hoặc tạo bản nháp script đổi tên file. Với mỗi việc, hãy chỉ định file liên quan và yêu cầu đầu ra có thể kiểm tra được, chẳng hạn một test chạy bằng lệnh hiện có trong dự án. Nếu kết quả chạm sang file cấu hình hoặc xóa dữ liệu, dừng lại để xem diff thay vì chạy tiếp.

Từ bản nháp nội dung đến video Một creator bán hàng qua mạng có thể bắt đầu bằng đoạn mô tả sản phẩm, biên tập thành lời thoại ngắn, rồi đưa lời thoại sang các bước tạo video, giọng đọc, phụ đề và dubbing. Mỗi bước nên giữ đầu vào và đầu ra riêng: bản thoại đã duyệt, tệp âm thanh, phụ đề và video cuối. Nhờ vậy, khi tên sản phẩm hoặc giá thay đổi, bạn biết cần sửa bản nào. Dùng workflow miễn phí hoặc ít tốn phí để thử một ý tưởng và kiểm tra từng đầu ra trước khi làm hàng loạt. Khi chuyển sang nội dung kinh doanh, ghi lại chi phí theo từng bước và đặt giới hạn chi tiêu; không thể suy ra số video cố định từ khoản nạp 99k vì mức trừ còn tùy dịch vụ và thao tác. Với giọng đọc hoặc phụ đề, nghe và rà lại tên riêng, giá tiền trước khi đăng.

Khi dùng API trong workflow AI, hãy tách cấu hình Claude Code khỏi cấu hình ứng dụng gọi RevidAPI. Đừng chép API key vào mã nguồn: lưu trong biến môi trường hoặc secret manager, rồi đọc key lúc chạy. Nếu hệ thống của bạn hỗ trợ nhiều key, cấp key riêng cho môi trường thử nghiệm và production để có thể thu hồi từng key mà không làm gián đoạn cả hai môi trường.

Kiểm tra endpoint và chi phí trước khi tích hợp Đối với request chat, endpoint thật là `https://revidapi.com/v1/chat/completions`. Base URL

của SDK OpenAI tương thích là `https://revidapi.com/v1`; đừng nối thêm `/v1` vào URL endpoint đầy đủ, nếu không đường dẫn request sẽ sai. Có thể xem danh sách model và giá theo token bằng `GET https://revidapi.com/v1/chat/models`; giá phụ thuộc model, nên kiểm tra trước khi chọn model cho tác vụ chạy lặp.

curl https://revidapi.com/v1/chat/completions \ -H "x-api-key: $REVIDAPI_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"Viết test cho hàm này"}]}'

Nếu gọi bằng Python, SDK OpenAI nhận base URL ở cấu hình client. Thay `YOUR_API_KEY` bằng biến môi trường trong ứng dụng thật, không để chuỗi key cố định trong file đã đưa lên Git.

import os
from openai import OpenAI client = OpenAI( base_url="https://revidapi.com/v1", api_key=os.environ["REVIDAPI_API_KEY"],
)
response = client.chat.completions.create( model="claude-sonnet-5", messages=[{"role": "user", "content": "Xin chào"}],
)
print(response.choices[0].message.content)

Quản lý key và kiểm tra request Lấy hoặc quản lý key tại dashboard RevidAPI. Trước khi đưa request vào workflow, xác nhận model tồn tại qua endpoint danh sách model và kiểm tra key

được truyền bằng header `x-api-key` hoặc `Authorization: Bearer`. Một request chat qua RevidAPI dùng chung điểm gọi API cho ứng dụng

của bạn; nó không tự cấu hình Claude Code hay thay thế các biến môi trường riêng của Claude Code.

Có cần thẻ Visa để dùng Claude Code không?

Không nhất thiết. Claude Code có thể gửi request qua API key

của gateway; một số nhà cung cấp tại Việt Nam cho phép nạp bằng QR hoặc chuyển khoản. Đây là billing của gateway, không phải thanh toán trực tiếp cho Anthropic, nên hãy kiểm tra đơn vị cung cấp và điều kiện sử dụng trước khi nạp.

Nạp QR 99k có dùng

được ngay không? Điều đó tùy gateway và trạng thái giao dịch. Sau khi quét QR, kiểm tra dashboard xem giao dịch đã ghi nhận và số dư đã cập nhật chưa; nếu chưa, đừng nạp lần hai ngay mà hãy đối chiếu mã giao dịch với hướng dẫn hỗ trợ

của nhà cung cấp. Mức 99k là số tiền cần xác nhận trên trang nạp, không phải mức giá chung của mọi gateway.

Claude Code cần đặt hai biến môi trường nào?

Cấu hình thường dùng `ANTHROPIC_API_KEY` để chứa key và `ANTHROPIC_BASE_URL` để trỏ đến gateway. Tên biến có thể thay đổi theo phiên bản Claude Code hoặc hướng dẫn

của gateway, nên kiểm tra tài liệu hiện hành trước khi chạy; tránh ghi key trực tiếp vào mã nguồn hoặc đưa vào Git.

Có tự thêm `/v1` vào base URL không?

Không tự nối thêm. Dùng nguyên base URL gateway công bố: nếu URL đã chứa `/v1`, thêm lần nữa có thể tạo đường dẫn sai và gây lỗi `404`. Khi gặp lỗi, so sánh URL cấu hình với tài liệu của nhà cung cấp.

Tôi bắt đầu với RevidAPI ở đâu?

Tạo hoặc kiểm tra API key tại dashboard RevidAPI. Với Claude Code, hãy xác nhận endpoint tương thích và cách đặt base URL trong tài liệu trước khi dùng; danh sách model có thể thay đổi theo nhà cung cấp.

Khám phá workflow miễn phí tại AI Tạo ảnh & Video và lấy API key tại API Marketplace RevidAPI.