Tóm lại: cài đặt Claude Code bằng một lệnh chính thức (chọn dòng dành cho macOS/Linux, PowerShell hoặc CMD bên dưới), sau đó kết nối bằng API key thay vì đăng nhập. Chỉ cần sáu biến: ANTHROPIC_BASE_URL=https://api.kunavo.com (không có /v1), ANTHROPIC_AUTH_TOKEN chứa key và bốn biến ghim mô hình. Kiểm tra kết quả bằng /status. Không cần đăng ký Pro hoặc Max; bạn thanh toán token từ số dư trả trước bắt đầu từ $10, nạp bằng thẻ (Visa, Mastercard, v.v.) hoặc Link. QRIS, GoPay, OVO và DANA không khả dụng.
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash# Windows PowerShell
irm https://claude.ai/install.ps1 | iex:: Windows Command Prompt (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdChúng tôi đã đối chiếu tất cả lệnh và tên biến với tài liệu chính thức của Claude Code tại 3 tháng 10, 2026. Tài liệu đó đã có bản tiếng Indonesia, gồm cả trang cài đặt và trang kết nối với cổng LLM, để bạn có thể tự đối chiếu. Giá và phương thức thanh toán của Kunavo đã được kiểm tra vào 10 tháng 10, 2026.
Sáu bước từ con số không đến khi Claude Code chạy
- Đảm bảo laptop đáp ứng yêu cầu và quyết định: đăng nhập tài khoản Claude hay dùng API key.
- Chạy trình cài đặt native phù hợp với terminal của bạn.
- Mở terminal mới, kiểm tra
claude --versionvà sửaPATHnếu cần. - Thiết lập API key và ghim mô hình.
- Mở phiên đầu tiên và xác nhận qua
/statusrằng key của bạn đang được sử dụng. - Nạp số dư bằng thẻ hoặc Link, rồi bắt đầu làm việc.
Bước 1: kiểm tra yêu cầu, rồi chọn đăng nhập hoặc API key
| Các mục cần kiểm tra | Yêu cầu chính thức (được kiểm tra 3 tháng 10, 2026) |
|---|---|
| Hệ điều hành | macOS 13.0+; Windows 10 phiên bản 1809+ hoặc Windows Server 2019+; Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+ |
| Phần cứng | RAM từ 4 GB trở lên; bộ xử lý x64 hoặc ARM64. Windows 32-bit không được hỗ trợ. |
| Thiết bị đầu cuối | Bash, Zsh, PowerShell hoặc CMD |
| Node.js | Không cần cho trình cài đặt native. Chỉ cần nếu cài qua npm và phải là phiên bản 22 trở lên. |
| Quốc gia | Indonesia có trong danh sách quốc gia được Anthropic hỗ trợ, áp dụng cho cả Claude.ai lẫn API. |
Sau khi cài đặt, Claude Code cần biết ai sẽ thanh toán. Cách thứ nhất là đăng nhập bằng tài khoản Claude, yêu cầu gói Pro, Max, Team, Enterprise hoặc tài khoản Console; gói Claude.ai miễn phí không bao gồm Claude Code. Theo trang giá Claude (được kiểm tra vào 3 tháng 10, 2026), Pro có giá $20 mỗi tháng, hoặc $17 mỗi tháng nếu thanh toán theo năm ($200 trả trước), Max có giá từ $100 mỗi tháng và tất cả mức giá chưa bao gồm thuế. Với gói đăng ký mua qua web, Anthropic chỉ chấp nhận thẻ tín dụng hoặc thẻ ghi nợ; gói đăng ký mua qua ứng dụng iOS hoặc Android được thanh toán qua App Store hoặc Google Play (Câu hỏi thường gặp về thanh toán Claude, được kiểm tra vào 3 tháng 10, 2026). Cách đăng nhập được hướng dẫn trên trang xác thực chính thức.
Cách thứ hai, được trình bày đầy đủ trong hướng dẫn này, là dùng API key: không cần đăng ký và không có màn hình đăng nhập. Bạn thanh toán theo số token thực sự được sử dụng, nên trong những tháng ít sử dụng, chi phí cũng thấp. Chỉ thiếu hai tính năng gắn với tài khoản claude.ai là Remote Control và đọc chính tả bằng giọng nói; danh sách đầy đủ các điểm khác biệt có ở bước 5.
Lần đầu mở terminal? Anthropic có hướng dẫn terminal bằng tiếng Indonesia dành cho người mới bắt đầu.
Bước 2: chạy trình cài đặt
macOS, Linux và WSL
Dán dòng install.sh ở đầu trang vào Terminal, nhấn Enter và chờ hoàn tất. Tập lệnh đó được lấy trực tiếp từ claude.ai, cài chương trình vào ~/.local/bin/claude và từ đó Claude Code sẽ tự cập nhật trong nền. Trong tài liệu chính thức, phương pháp này được gắn nhãn “Được khuyến nghị”.
Windows: trước tiên hãy nhận diện terminal của bạn
Nhiều hướng dẫn cũ yêu cầu mở PowerShell bằng “Run as Administrator” và cài WSL trước. Cả hai đều không cần thiết: tài liệu chính thức bằng tiếng Indonesia cho biết cài đặt trên Windows chạy từ terminal thông thường mà không cần quyền Administrator, còn WSL chỉ là tùy chọn. Dấu nhắc hiển thị sẽ quyết định lệnh nào cần dùng:
- Dấu nhắc
PS C:\Users\NamaAnda>có nghĩa là PowerShell. Hãy dùng dòngirm … | iex. - Dấu nhắc
C:\Users\NamaAnda>không cóPScó nghĩa là Command Prompt (CMD). Hãy dùng dònginstall.cmd. - Trong menu Start, chọn “Windows PowerShell”, không chọn “Windows PowerShell (x86)”. Phiên bản x86 chạy ở chế độ 32-bit và kết thúc bằng
Claude Code does not support 32-bit Windows, dù laptop là 64-bit.
Các lệnh bị nhầm terminal có thể nhận ra ngay từ thông báo, chẳng hạn The token '&&' is not a valid statement separator (dòng CMD trong PowerShell) hoặc 'irm' is not recognized as an internal or external command (dòng PowerShell trong CMD). Trên Windows bằng tiếng Indonesia, thông báo có thể hiển thị dưới dạng bản dịch. Danh sách đầy đủ có trong bảng lỗi bên dưới.
Git không bắt buộc. Nếu đã cài Git for Windows, công cụ Bash của Claude Code sẽ dùng Git Bash; nếu không, các lệnh sẽ chạy qua PowerShell. Nếu đã có Git nhưng không tìm thấy Git Bash, hãy điền đường dẫn đến bash.exe vào CLAUDE_CODE_GIT_BASH_PATH trong khối env của ~/.claude/settings.json, chẳng hạn C:\Program Files\Git\bin\bash.exe. Trường hợp nào nên dùng WSL:
| Môi trường | Chuẩn bị | Sandbox | Phù hợp với |
|---|---|---|---|
| Windows trực tiếp | Không có (Git for Windows là tùy chọn) | Không | Các dự án thực sự được thực hiện trên Windows |
| WSL 2 | WSL 2 đã được bật | Có | Các dự án cần công cụ Linux hoặc các lệnh chạy cô lập |
| WSL 1 | WSL 1 đã được bật | Không | Chỉ khi không thể sử dụng WSL 2 |
Chọn WSL? Chạy dòng install.sh bên trong terminal WSL và luôn mở claude cũng từ terminal WSL đó.
Lựa chọn thay thế: Homebrew, WinGet hoặc npm
Homebrew và WinGet cũng là các phương thức chính thức, nhưng theo tài liệu, theo mặc định cả hai không tự động cập nhật. Bạn phải tự cập nhật chúng:
# macOS lewat Homebrew (tidak update otomatis; perbarui dengan brew upgrade)
brew install --cask claude-code
# Windows lewat WinGet (tidak update otomatis; perbarui dengan winget upgrade)
winget install Anthropic.ClaudeCodenpm vẫn được ghi trong tài liệu, với điều kiện dùng Node.js 22 trở lên (tải xuống từ nodejs.org). Với các phiên bản Node.js cũ hơn, npm chỉ đưa ra cảnh báo EBADENGINE rồi vẫn cài đặt, vì gói này thực chất tải xuống một chương trình native không phụ thuộc vào Node.js khi chạy.
node -v # harus v22 ke atas
npm install -g @anthropic-ai/claude-code # jangan pakai sudo
# memperbarui ke versi terbaru
npm install -g @anthropic-ai/claude-code@latestBa thói quen khiến việc cài đặt npm bị hỏng: sử dụng sudo npm install -g (tài liệu nêu đây là nguồn gây ra vấn đề về quyền và rủi ro bảo mật), cập nhật bằng npm update -g thay vì @latest, và tắt các phần phụ thuộc tùy chọn qua --omit=optional hoặc optional=false trong .npmrc. Điều cuối cùng khiến gói @anthropic-ai/claude-code-* dành cho nền tảng của bạn không được tải xuống, vì vậy trên macOS hoặc Linux claude sẽ trả lời claude native binary not installed.
Trong PowerShell, npm đôi khi bị kẹt ở npm.ps1 cannot be loaded because running scripts is disabled on this system. Đó là execution policy đang chặn tập lệnh .ps1. Tài liệu đưa ra ba cách giải quyết: cho phép tập lệnh cục bộ đối với người dùng của bạn bằng lệnh bên dưới, gọi npm.cmd và claude.cmd, hoặc bỏ npm và dùng trình cài đặt native.
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserThêm một cảnh báo: hãy bỏ qua các trình cài đặt .exe của bên thứ ba xuất hiện trong các hướng dẫn, đặc biệt là những trình yêu cầu quyền Administrator. Các lệnh chính thức ở trên là đủ.
Bước 3: đảm bảo Claude Code đã được cài đặt
Đóng terminal nơi bạn đã cài đặt và mở một terminal mới. Cửa sổ cũ vẫn sử dụng PATH trước khi cài đặt, nên tại đó claude thường chưa được nhận diện. Trong terminal mới:
claude --version # muncul nomor versi = instalasi berhasil
claude doctor # cek instalasi dan file pengaturan tanpa membuka sesiclaude doctor hữu ích để phân biệt hai loại vấn đề: nếu báo cáo sạch nhưng Claude Code vẫn không kết nối, nguyên nhân nằm ở cấu hình (bước 4), không phải ở việc cài đặt.
Vẫn gặp command not found: claude hoặc 'claude' is not recognized? Thư mục cài đặt chưa được thêm vào PATH. Trên macOS và Linux, thư mục đó là ~/.local/bin, còn trên Windows là %USERPROFILE%\.local\bin. Đối với Windows, tài liệu cung cấp lệnh PowerShell sau:
# Ada hasilnya? Berarti PATH sudah benar, cukup buka terminal baru.
$env:PATH -split ';' | Select-String '\.local\\bin'
# Tidak ada hasil? Tambahkan folder instalasi ke PATH user:
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
# Tutup PowerShell, buka lagi, lalu:
claude --versionNếu quá trình tải xuống thất bại ngay từ đầu, hãy chú ý đến thông báo. Theo trang khắc phục sự cố cài đặt (được kiểm tra vào 3 tháng 10, 2026), syntax error near unexpected token '<' hoặc curl: (22) The requested URL returned error: 403 có nghĩa là nội dung tải xuống là trang HTML hoặc mã lỗi, chứ không phải tập lệnh. Thông báo App unavailable in region có nghĩa là kết nối của bạn có vẻ xuất phát từ một quốc gia không được hỗ trợ; vì Indonesia được hỗ trợ nên thủ phạm khả dĩ nhất là VPN hoặc proxy. Lỗi 403 không có nội dung cũng thường do proxy của công ty hoặc tường lửa của trường đại học gây ra. Homebrew, WinGet và npm lấy dữ liệu từ cùng một máy chủ, vì vậy hãy thử mạng khác hoặc nhờ quản trị viên mạng mở quyền truy cập trước khi đổi phương thức.
Bước 4: thiết lập API key mà không cần đăng ký
Claude Code có biến tích hợp sẵn ANTHROPIC_BASE_URL để gửi yêu cầu đến gateway ngoài Anthropic và tài liệu chính thức có một trang riêng cho việc này. Vì vậy đây là cấu hình được hỗ trợ, không phải bản sửa đổi hay plugin. Trước tiên hãy lấy key sk-kn-… (xem bước 6 để biết cách lấy và nạp số dư), sau đó chọn một nơi để lưu khóa.
macOS và Linux: thêm sáu dòng này vào cuối ~/.zshrc (Zsh, shell mặc định của macOS) hoặc ~/.bashrc, lưu lại rồi mở terminal mới.
export ANTHROPIC_BASE_URL=https://api.kunavo.com # domain saja, tanpa /v1
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5Windows, để thử trước: điền các biến trong một cửa sổ PowerShell rồi chạy ngay claude.
# Untuk uji coba: hanya berlaku sampai jendela PowerShell ini ditutup
$env:ANTHROPIC_BASE_URL = "https://api.kunavo.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-kn-..."
$env:ANTHROPIC_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5-5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
claudeTất cả hệ điều hành, vĩnh viễn: đặt chúng trong khối env của tệp cài đặt người dùng ~/.claude/settings.json (Windows: %USERPROFILE%\.claude\settings.json). Áp dụng cho tất cả dự án. Nếu tệp đó đã có nội dung, chỉ chèn khối env mà không ghi đè các cài đặt khác.
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.kunavo.com",
"ANTHROPIC_AUTH_TOKEN": "sk-kn-...",
"ANTHROPIC_MODEL": "claude-sonnet-5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
}
}Những điều cần lưu ý về sáu biến trên:
| Biến | Giá trị | Lỗi thường gặp |
|---|---|---|
ANTHROPIC_BASE_URL | https://api.kunavo.com | Thêm /v1. Claude Code tự nối /v1/messages, nên kết quả là /v1/v1/messages và 404. |
ANTHROPIC_AUTH_TOKEN | Khóa sk-kn-… | Kunavo nhận key từ cả header Authorization: Bearer và x-api-key, nên ANTHROPIC_API_KEY cũng có thể dùng. Điểm khác biệt ở phía Claude Code là: ANTHROPIC_AUTH_TOKEN được kích hoạt ngay, còn ANTHROPIC_API_KEY chờ bạn chấp thuận một lần trong chế độ tương tác. Nếu đã vô tình từ chối, key đó sẽ bị bỏ qua âm thầm cho đến khi bạn kích hoạt lại tại /config → Use custom API key. |
ANTHROPIC_MODEL | claude-sonnet-5 (Claude Sonnet 5) | Ghi ID mô hình phiên bản cũ có hậu tố ngày tháng. Tên phải chính xác như trong danh sách mô hình Kunavo. |
ANTHROPIC_DEFAULT_OPUS_MODEL | claude-opus-5-5 (Claude Opus 5.5) | Không điền, khiến bí danh opus chuyển sang mô hình Anthropic mới nhất. Claude Opus 5.5 cần Claude Code v2.1.280 trở lên; các phiên bản cũ hơn được cập nhật bằng claude update. |
ANTHROPIC_DEFAULT_SONNET_MODEL | claude-sonnet-5 (Claude Sonnet 5) | Không điền, khiến bí danh sonnet yêu cầu Sonnet 5.5 không có trên Kunavo: /model sonnet, giai đoạn thực thi opusplan và subagent với model: sonnet sẽ trả về 404. |
ANTHROPIC_DEFAULT_HAIKU_MODEL | claude-haiku-4-5 (Claude Haiku 4.5) | Quên rằng biến này cũng chọn mô hình cho các tác vụ nền, không chỉ bí danh haiku. Nếu không điền, bí danh haiku sẽ yêu cầu một ID không có trên Kunavo (Haiku 5.5 từ v2.1.293): /model haiku và các tác tử con có model: haiku sẽ nhận lỗi 404. |
Vì sao cần cố định mô hình? Theo tài liệu cấu hình mô hình (được kiểm tra vào 3 tháng 10, 2026), với người dùng API, mô hình mặc định và bí danh opus hiện trỏ đến Opus 5.5, còn bí danh sonnet trỏ đến Sonnet 5.5. Các bí danh này thay đổi theo mỗi bản phát hành mới. Tính đến 3 tháng 10, 2026, Kunavo chưa cung cấp Sonnet 5.5 và mô hình tiếp theo có thể chưa khả dụng ngay; yêu cầu đến một mô hình không tồn tại sẽ nhận lỗi 404. Vì vậy, khối ở trên cũng cố định bí danh sonnet bằng ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5: nếu không có thiết lập này, /model sonnet, giai đoạn thực thi của opusplan và các tác tử con dùng mô hình sonnet sẽ nhận lỗi 404. Bí danh opus được cố định vào Claude Opus 5.5 (claude-opus-5-5), yêu cầu Claude Code v2.1.280 trở lên; nếu phiên bản của bạn cũ hơn, hãy chạy claude update.
Mức phí của Kunavo trên mỗi 1 triệu token (đầu vào / đầu ra): Claude Sonnet 5 $1,40 / $7,00 (giá niêm yết của Anthropic: $2,00 / $10,00), Claude Opus 5.5 $2,80 / $14,00, và Claude Haiku 4.5 $0,70 / $3,50.
Hai điều cần tránh nữa. Thứ nhất, tuyệt đối không đưa khóa vào .claude/settings.json của dự án: theo tài liệu cổng kết nối, tệp này được commit và mọi người lấy kho lưu trữ đều sẽ sao chép nó. Thứ hai, nếu cùng một biến có mặt trong shell và khối env của tệp cài đặt, thông thường giá trị trong tệp cài đặt sẽ được ưu tiên; vì vậy, nếu thay đổi trong ~/.zshrc dường như không có tác dụng, hãy kiểm tra tệp cài đặt. Người dùng tiện ích mở rộng VS Code điền cùng biến đó trong claudeCode.environmentVariables ở phần cài đặt người dùng của VS Code.
Bước 5: mở phiên đầu tiên và kiểm tra /status
Đi vào thư mục dự án và nhập claude. Nếu key đã được đọc, phiên sẽ mở ngay mà không có màn hình đăng nhập. Màn hình đăng nhập xuất hiện là dấu hiệu key chưa được truyền đến. Nguyên nhân thường gặp nhất: key chỉ nằm trong .claude/settings.json hoặc .claude/settings.local.json của dự án. Trong chế độ tương tác, khối env từ tệp dự án chỉ được đọc sau trình hướng dẫn ban đầu và câu hỏi liệu thư mục này có đáng tin cậy hay không, vì vậy ở lần khởi chạy đầu tiên Claude Code vẫn yêu cầu đăng nhập. Hãy chuyển key vào shell hoặc vào ~/.claude/settings.json.
Sau khi phiên mở, nhập /status. Cấu hình đúng khi:
- có dòng
Anthropic base URLchứahttps://api.kunavo.com(dòng này chỉ xuất hiện khi gateway được cấu hình; nếu không có nghĩa là không đọc đượcANTHROPIC_BASE_URL), và - có dòng
Auth tokenđề cập đếnANTHROPIC_AUTH_TOKEN. Nếu hiển thịLogin methodvới tài khoản claude.ai, Claude Code vẫn đang dùng thông tin đăng nhập cũ.
Bạn muốn kiểm tra key trước khi mở Claude Code? Tài liệu chính thức sử dụng request chỉ yêu cầu 1 token đầu ra, nên số dư bị trừ rất ít. Lệnh này đọc biến từ shell đang hoạt động; nếu key được lưu trong tệp cài đặt, trước tiên hãy export trong terminal này. Kết quả bắt đầu bằng {"id":"msg_ nghĩa là thành công, còn 401 nghĩa là key bị từ chối.
curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
-H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'Phiên bản PowerShell; thành công khi trường id trong phản hồi bắt đầu bằng msg_:
Invoke-RestMethod -Method Post -Uri "$env:ANTHROPIC_BASE_URL/v1/messages" `
-Headers @{ "Authorization" = "Bearer $env:ANTHROPIC_AUTH_TOKEN"; "anthropic-version" = "2023-06-01" } `
-ContentType "application/json" `
-Body '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'Một số chức năng hoạt động khác khi Claude Code sử dụng API key và gateway:
| Tính năng | Với API key Kunavo | Nguồn (đã kiểm tra 3 tháng 10, 2026) |
|---|---|---|
| Remote Control, đọc chính tả bằng giọng nói | Không khả dụng. Cả hai đều cần danh tính claude.ai, và Remote Control cũng bị tắt khi ANTHROPIC_BASE_URL không phải là máy chủ Anthropic. | Tài liệu gateway |
/fast | Hiển thị là không hoạt động; chỉ với bearer token, Claude Code không hỏi về tính khả dụng của tính năng này. | Tài liệu gateway |
| Tìm kiếm công cụ MCP | Bị tắt theo mặc định, vì vậy các công cụ MCP được tải khi bắt đầu phiên; có thể thay đổi bằng ENABLE_TOOL_SEARCH. | Tài liệu MCP |
Con số trong /context | Ước tính dựa trên số ký tự, vì Kunavo không cung cấp /v1/messages/count_tokens. | Hướng dẫn tương thích gateway |
Đô la trong /usage | Được tính cục bộ từ số token theo giá niêm yết của Anthropic (trừ khi quản trị viên tổ chức cài đặt bảng modelPricing). Thứ thực sự bị trừ là số dư Kunavo trong trang Billing. | Tài liệu chi phí |
Bước 6: nạp số dư bằng thẻ hoặc Link (không có QRIS, GoPay, OVO, DANA)
Khoản bạn thanh toán tại Kunavo là số dư API trả trước, không phải gói đăng ký. Đây là số dư bị Claude Code trừ theo từng token sau khi key được cài đặt. Trình tự như sau:
- Tạo tài khoản Kunavo bằng email hoặc tài khoản Google. Khi đăng ký không cần cung cấp thẻ.
- Mở Billing và chọn mệnh giá. Tối thiểu là $10, không có phí hằng tháng. Mệnh giá lớn hơn có thể được cộng thưởng số dư: thanh toán $100 → số dư $110, thanh toán $1.000 → số dư $1.200 và thanh toán $5.000 → số dư $6.250.
- Trong trang thanh toán Stripe, bạn có thể trả bằng thẻ (Visa, Mastercard, v.v.), Link hoặc Apple Pay/Google Pay nếu thiết bị và trình duyệt của bạn đã được thiết lập để dùng các phương thức này. Link lưu thông tin thanh toán để lần nạp tiếp theo chỉ cần vài cú nhấp.
- Mở API Keys và tạo key. Key bắt đầu bằng
sk-kn-chỉ được hiển thị một lần, vì vậy hãy sao chép ngay vàoANTHROPIC_AUTH_TOKEN.
QRIS, GoPay, OVO, DANA, ShopeePay, tài khoản ảo và chuyển khoản ngân hàng không khả dụng. Nếu không có thẻ có thể giao dịch trực tuyến quốc tế, hiện tại bạn chưa thể nạp tiền vào Kunavo. Thẻ ghi nợ có logo Visa hoặc Mastercard cũng được tính là thẻ; nếu bị từ chối, thường là giao dịch trực tuyến hoặc giao dịch quốc tế chưa được bật trong ứng dụng ngân hàng, và quyết định cuối cùng thuộc về ngân hàng phát hành.
Giá của Kunavo được tính bằng USD. Nếu trang thanh toán hiển thị rupiah, tỷ giá do Stripe xác định và đã bao gồm phí chuyển đổi 2–4% do người mua chịu (tài liệu Adaptive Pricing của Stripe, được kiểm tra vào 3 tháng 10, 2026). Chọn thanh toán bằng USD sẽ tránh khoản phí đó, dù tỷ giá và phí riêng của ngân hàng bạn vẫn được áp dụng.
Số dư không bao giờ hết hạn và các request thất bại không làm giảm số dư. Tự động nạp tiền chỉ hoạt động với thẻ đã lưu hoặc Link. Kunavo không phát hành bất kỳ chứng từ thuế nào. Số dư này cũng không thể dùng để thanh toán Claude Pro hoặc Max. Chi tiết mức giá của tất cả model Claude và cách thanh toán từ Indonesia có tại giá API Claude; phần tính toán giữa gói đăng ký và API key dành riêng cho Claude Code có tại giá Claude Code.
Chi phí ước tính là bao nhiêu?
Mỗi request Claude Code gửi lại ngữ cảnh cuộc trò chuyện, nhưng phần đầu giống nhau giữa các request được tính theo mức giá đọc bộ nhớ đệm rẻ hơn nhiều. Phép tính dưới đây chỉ là số học token dựa trên các giả định được nêu, không phải kết quả đo lường và không phải giới hạn trên:
- một request = 40.000 token đầu vào; 36.000 (90%) được đọc từ bộ nhớ đệm, phần còn lại 4.000 được ghi vào bộ nhớ đệm;
- một request tạo ra 1.000 token đầu ra;
- một phiên = 50 request, chưa bao gồm các lệnh gọi Claude Haiku 4.5 chạy nền;
- mức giá đọc bộ nhớ đệm là 10% và ghi bộ nhớ đệm là 1,25× mức giá đầu vào (tỷ lệ Claude Sonnet 5 tại Kunavo; mỗi model trong bảng sử dụng tỷ lệ riêng).
| Mô hình | Mỗi request | Một phiên (50 request) | Một phiên khi không sử dụng bộ nhớ đệm |
|---|---|---|---|
| Claude Sonnet 5 | $0,019 | $0,95 | $3,15 |
| Claude Opus 5.5 | $0,033 | $1,65 | $6,30 |
Con số thực tế của bạn thay đổi theo độ dài ngữ cảnh, tần suất bộ nhớ đệm được sử dụng, độ dài câu trả lời và việc cuộc trò chuyện có được xóa bằng /clear khi chuyển nhiệm vụ hay không. Theo tài liệu chi phí của Anthropic, các quy trình nền của Claude Code thường dưới 0,04 USD mỗi phiên (đã kiểm tra 3 tháng 10, 2026). Mức giá đầy đủ có tại trang giá, còn để ước tính mô hình sử dụng của riêng bạn, hãy dùng công cụ tính chi phí token Claude (tiếng Anh).
Cách sử dụng Claude Code hằng ngày
cd ~/proyek-saya # Claude Code bekerja di folder tempat ia dijalankan
claude # mulai sesi
claude -c # lanjutkan percakapan terakhir di folder ini- Hãy yêu cầu bằng ngôn ngữ tự nhiên, chẳng hạn “giải thích cấu trúc của dự án này” hoặc “sửa lỗi trên trang đăng nhập”. Claude Code đọc các tệp và hỏi quyền trước khi thay đổi hoặc chạy bất cứ thứ gì.
- Dùng
/clearkhi chuyển nhiệm vụ: lịch sử cũ sẽ không được gửi lại, nên số token trong mỗi request giảm xuống. - Dùng
/modelđể đổi model. Với phần ghim ở bước 4,opus=claude-opus-5-5,sonnet=claude-sonnet-5, vàhaiku=claude-haiku-4-5. - Dùng
/statusđể kiểm tra gateway và key; dùng/usageđể ước tính chi phí (theo giá niêm yết, xem bảng ở bước 5).
Thông báo lỗi và ý nghĩa
| Thông báo | Ý nghĩa và việc cần làm |
|---|---|
The token '&&' is not a valid statement separator | Dòng lệnh CMD được chạy trong PowerShell. Hãy dùng irm … | iex. |
'irm' is not recognized as an internal or external command | Dòng PowerShell được chạy trong CMD. Hãy dùng dòng install.cmd. |
A parameter cannot be found that matches parameter name 'fsSL', 'bash' is not recognized as the name of a cmdlet | Dòng dành cho macOS/Linux được chạy trong PowerShell. Hãy dùng dòng PowerShell. |
Claude Code does not support 32-bit Windows | Đã mở “Windows PowerShell (x86)”. Hãy mở “Windows PowerShell” thông thường. |
syntax error near unexpected token '<', 403 | Thứ được tải xuống là trang HTML hoặc mã lỗi. Kiểm tra VPN, proxy và tường lửa; các phương thức khác sử dụng cùng máy chủ. |
command not found: claude, 'claude' is not recognized | PATH chưa tải thư mục cài đặt. Hãy mở terminal mới; trên Windows, chạy lệnh PATH ở bước 3. |
EBADENGINE (cảnh báo) | Node.js thấp hơn phiên bản 22. Quá trình cài đặt vẫn chạy, nhưng hãy cập nhật Node.js. |
claude native binary not installed (macOS, Linux) | npm đã bỏ qua các phần phụ thuộc tùy chọn (--omit=optional, optional=false) hoặc tập lệnh cài đặt (--ignore-scripts). Hãy xóa cài đặt đó và cài đặt lại. |
npm.ps1 cannot be loaded | Execution policy của PowerShell. Chạy Set-ExecutionPolicy ở bước 2 hoặc sử dụng trình cài đặt native. |
| Màn hình đăng nhập vẫn xuất hiện | Chưa đọc được key. Hãy lưu key trong shell hoặc ~/.claude/settings.json, không chỉ trong cài đặt dự án, rồi mở terminal mới. |
401 | Key bị từ chối. Kiểm tra key sk-kn- đã được sao chép đầy đủ, không có khoảng trắng, chưa bị xóa tại /app/keys và có trong ANTHROPIC_AUTH_TOKEN. |
404 | ANTHROPIC_BASE_URL kết thúc bằng /v1, hoặc model được yêu cầu không có trong Kunavo (thường do biến model chưa được điền). |
Giới hạn
- Chỉ thanh toán bằng thẻ, Link hoặc Apple Pay/Google Pay. Không có QRIS, GoPay, OVO, DANA, ShopeePay, tài khoản ảo hoặc chuyển khoản ngân hàng; tự động nạp tiền chỉ dùng được với thẻ đã lưu hoặc Link.
- Kunavo không phát hành bất kỳ chứng từ thuế nào.
- Đây là API tính phí theo token, không phải gói đăng ký Claude Pro hoặc Max. Với API key, Remote Control và đọc chính tả bằng giọng nói không khả dụng,
/fastbị tắt, và tính năng tìm kiếm công cụ MCP bị tắt theo mặc định. - Tính đến 3 tháng 10, 2026, Sonnet 5.5 chưa có trên Kunavo; nếu không ghim model, alias mặc định có thể dẫn đến lỗi 404.
- Tài liệu Claude Code có sẵn bằng tiếng Indonesia, nhưng tài liệu tích hợp Kunavo và phiên bản tiếng Anh của hướng dẫn này (Install Claude Code) chưa có bằng tiếng Indonesia.
Câu hỏi thường gặp
Lệnh cài đặt Claude Code trên laptop là gì?
Tùy terminal. Trên macOS, Linux hoặc WSL: curl -fsSL https://claude.ai/install.sh | bash. Trên Windows PowerShell: irm https://claude.ai/install.ps1 | iex. Trong Command Prompt (CMD): curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Cả ba đều là trình cài đặt native chính thức, không cần Node.js và tự cập nhật. Sau đó, mở terminal mới và nhập claude --version; nếu xuất hiện số phiên bản thì cài đặt đã hoàn tất.
Cài đặt Claude Code trên Windows có bắt buộc phải thông qua WSL hoặc Run as Administrator không?
Không bắt buộc. Theo tài liệu chính thức bằng tiếng Indonesia, Claude Code chạy trực tiếp trên Windows từ PowerShell hoặc CMD thông thường, không cần quyền Administrator, và Git for Windows chỉ là tùy chọn. WSL 2 chỉ hữu ích nếu dự án của bạn cần công cụ Linux hoặc sandboxing. Một điều thường bị bỏ qua: đừng mở “Windows PowerShell (x86)” từ menu Start, vì đó là tiến trình 32-bit và Claude Code sẽ từ chối chạy.
Claude Code có miễn phí không? Có cần đăng ký Claude Pro không?
Chương trình được cài đặt miễn phí, nhưng sử dụng thì có tính phí. Nếu đăng nhập bằng tài khoản Claude, bạn cần gói Pro, Max, Team, Enterprise hoặc tài khoản Console; gói Claude.ai miễn phí không bao gồm Claude Code. Cách khác là dùng API key: đặt ANTHROPIC_BASE_URL=https://api.kunavo.com và ANTHROPIC_AUTH_TOKEN, khi đó Claude Code hoạt động mà không cần đăng nhập và mỗi token được thanh toán từ số dư trả trước Kunavo, không có phí hàng tháng. Remote Control và đọc chính tả bằng giọng nói không được bao gồm vì cả hai đều cần tài khoản claude.ai.
Có thể dùng Claude Code từ Indonesia không?
Có. Indonesia nằm trong danh sách các quốc gia được Anthropic hỗ trợ, cả cho Claude.ai và API. Nếu trình cài đặt hoặc Claude Code hiển thị “App unavailable in region”, thường là do kết nối của bạn đi qua VPN hoặc proxy ở quốc gia khác; hãy tắt chúng rồi thử lại.
API key của Claude Code được đặt ở đâu và ANTHROPIC_BASE_URL có dùng /v1 không?
Không dùng /v1 vì Claude Code tự thêm /v1/messages; nếu thêm /v1 thì kết quả sẽ là /v1/v1/messages và lỗi 404. Lưu các biến trong ~/.zshrc hoặc ~/.bashrc, trong $PROFILE của PowerShell hoặc trong khối env của tệp ~/.claude/settings.json dành cho người dùng (Windows: %USERPROFILE%\.claude\settings.json). Không đặt trong .claude/settings.json của dự án vì tệp đó sẽ được đưa vào kho lưu trữ. Kunavo nhận key từ cả header Authorization: Bearer và x-api-key. Chúng tôi khuyên dùng ANTHROPIC_AUTH_TOKEN vì được kích hoạt ngay; ANTHROPIC_API_KEY chỉ được dùng sau khi bạn chấp thuận một lần trong chế độ tương tác.
Tại sao phải ghim mô hình bằng ANTHROPIC_MODEL và các biến ANTHROPIC_DEFAULT_OPUS/SONNET/HAIKU_MODEL?
Vì các bí danh tích hợp sẵn của Claude Code thay đổi mỗi khi Anthropic phát hành mô hình mới. Theo tài liệu cấu hình mô hình (được kiểm tra 3 tháng 10, 2026), đối với người dùng API, mô hình mặc định và bí danh opus hiện trỏ đến Opus 5.5, còn bí danh sonnet trỏ đến Sonnet 5.5. Tính đến 3 tháng 10, 2026, Sonnet 5.5 chưa có trên Kunavo, và các mô hình phát hành tiếp theo cũng chưa chắc có ngay, vì vậy yêu cầu không ghim có thể nhận lỗi 404. Khi ghim, phiên chính luôn dùng claude-sonnet-5; opus luôn dùng claude-opus-5-5 (Opus 5.5, cần Claude Code v2.1.280 trở lên; các phiên bản cũ có thể cập nhật bằng claude update); sonnet, bao gồm giai đoạn thực thi opusplan và subagent dùng mô hình sonnet, luôn dùng claude-sonnet-5; còn haiku và các tác vụ nền luôn dùng claude-haiku-4-5. Bạn cũng biết chính xác mức phí nào được áp dụng.
Làm thế nào để đảm bảo Claude Code sử dụng API key thay vì tài khoản claude.ai?
Trong phiên, nhập /status. Nếu đúng, sẽ có dòng “Anthropic base URL” chứa https://api.kunavo.com và dòng “Auth token” đề cập đến ANTHROPIC_AUTH_TOKEN. Nếu lại xuất hiện “Login method” cùng tài khoản claude.ai, các biến chưa được đọc: thoát phiên, mở terminal mới rồi kiểm tra tệp nơi bạn đã lưu chúng.
Có thể nạp tiền bằng QRIS, GoPay, OVO, DANA hoặc chuyển khoản ngân hàng không?
Không thể. Số dư Kunavo chỉ có thể được nạp bằng thẻ (Visa, Mastercard, v.v., bao gồm thẻ ghi nợ mang logo của các mạng đó), Link hoặc Apple Pay/Google Pay nếu thiết bị và trình duyệt của bạn đã thiết lập sẵn. QRIS, GoPay, OVO, DANA, ShopeePay, tài khoản ảo và chuyển khoản ngân hàng không khả dụng. Nếu thẻ bị từ chối, hãy kiểm tra xem giao dịch trực tuyến hoặc quốc tế đã được bật trong ứng dụng ngân hàng chưa; việc giao dịch có được chấp thuận hay không do ngân hàng phát hành thẻ quyết định.
Mức nạp tối thiểu là bao nhiêu? Số dư có hết hạn không? Có hóa đơn thuế không?
Tối thiểu $10, thanh toán một lần không có phí hàng tháng và số dư không bao giờ hết hạn. Yêu cầu thất bại không trừ số dư. Giá tính bằng USD; nếu trang thanh toán hiển thị rupiah, tỷ giá do Stripe cung cấp và đã bao gồm phí chuyển đổi 2–4% do người mua chịu. Tự động nạp tiền chỉ có thể dùng thẻ đã lưu hoặc Link. Kunavo không phát hành bất kỳ chứng từ thuế nào, bao gồm hóa đơn thuế. Số dư này chỉ dùng cho API Kunavo; không thể dùng để thanh toán Claude Pro hoặc Max.