Claude Code 설치: Windows 및 macOS 설치 명령, Pro/Max 요금제 없이 API 키 구성, 카드 또는 Link 결제

Pro/Max 요금제를 구매하지 않고 Claude Code를 사용하려면 세 가지를 수행하세요. 바로 아래에 터미널별로 제공된 공식 네이티브 명령으로 설치하고, ANTHROPIC_BASE_URL=https://api.kunavo.com(/v1 제외)와 ANTHROPIC_AUTH_TOKEN 및 모델 고정용 네 개의 변수를 설정한 다음 /status를 입력해 Claude Code가 키로 실행 중인지 확인하세요. 토큰 비용은 선불 잔액에서 차감됩니다. 잔액은 Visa/Mastercard 또는 Link를 사용해 10 USD에서 충전할 수 있으며 MoMo, ZaloPay 및 VNPay는 제공되지 않습니다. npm으로 설치하려면 컴퓨터에 Node.js 22 이상이 필요합니다.

# 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.cmd

Lệnh cài và tên biến trong bài lấy từ tài liệu chính thức của Claude Code, gồm 설치 페이지 và 환경 변수 목록, đọc lại ngày 2026년 10월 3일. Anthropic chưa có bản tiếng Việt của các trang này (đường dẫn /docs/vi/setup báo 404 cùng ngày), nên thông báo lỗi trong bài được giữ nguyên tiếng Anh để bạn tìm cho dễ. Giá và cách thanh toán của Kunavo được kiểm tra ngày 2026년 10월 3일.

현재 열려 있는 터미널에 맞는 설치 명령 선택

모든 설치 방법은 동일한 claude 프로그램을 설치하지만 업데이트를 관리하는 주체가 다릅니다. 공식 문서에서는 “Native Install (Recommended)” 탭에 네이티브 방식을 배치하며, 아무 작업을 하지 않아도 자동으로 최신 버전으로 올라가는 유일한 방법이기도 합니다.

# Homebrew (macOS, Linux) – mặc định không tự cập nhật
brew install --cask claude-code

# WinGet (Windows) – mặc định không tự cập nhật
winget install Anthropic.ClaudeCode

컴퓨터는 다음 조건을 충족해야 합니다(설치 페이지를 2026년 10월 3일에 확인):

• 운영 체제: macOS 13.0 이상, Windows 10 버전 1809 이상 또는 Windows Server 2019 이상, Ubuntu 20.04+, Debian 10+ 또는 Alpine Linux 3.19+.
• 최소 4GB RAM, x64 또는 ARM64 CPU. Windows 32비트는 지원되지 않습니다.
• 셸은 Bash, Zsh, PowerShell 또는 CMD여야 하며 인터넷에 연결되어 있어야 합니다.
• Node.js는 npm으로 설치할 때만 필요하며 버전 22 이상이어야 합니다.

설치가 끝난 후 기존 창에서 바로 claude를 입력하지 마세요. 기존 창에는 새 PATH가 아직 반영되지 않았습니다. 다른 터미널을 열고 다음을 실행하세요:

claude --version   # in ra số phiên bản, kèm chữ (Claude Code)
claude doctor      # chẩn đoán cài đặt và file cấu hình, không mở phiên làm việc

claude --version가 버전 번호를 출력하면 설치가 완료된 것입니다. 이후의 오류는 구성 문제입니다. claude doctor는 설치 상태와 settings 파일을 모두 검사하지만 작업 세션은 열지 않으므로 오류 위치가 확실하지 않을 때 유용합니다.

Windows: 자주 발생하는 다섯 가지 문제

1. 명령줄을 잘못 붙여 넣음. PowerShell에서 CMD용 줄을 실행하면 The token '&&' is not a valid statement separator가 표시되고, CMD에서 PowerShell용 줄을 실행하면 'irm' is not recognized as an internal or external command가 표시됩니다. 프롬프트를 확인하세요. PS가 있으면 irm 줄을 사용하고, 없으면 install.cmd 줄을 사용하세요.
2. “Windows PowerShell (x86)”를 잘못 엶. 시작 메뉴의 이 항목은 32비트 프로세스이므로 64비트 컴퓨터에서도 Claude Code does not support 32-bit Windows가 표시됩니다. (x86)이 없는 항목을 선택하세요.
3. Administrator 권한으로 실행할 필요가 없음. 문서에서는 이를 요구하지 않으며 네이티브 버전은 사용자의 폴더에 설치됩니다: %USERPROFILE%\.local\bin\claude.exe.
4. claude를 입력하면 “not recognized”가 표시됨. 위의 폴더가 PATH에 아직 추가되지 않았습니다. 먼저 새 터미널을 사용해 보세요. 그래도 오류가 발생하면 아래 PowerShell 코드로 경로를 확인하고 추가하세요. macOS/Linux에서는 이에 해당하는 오류가 command not found: claude이며 프로그램은 ~/.local/bin/claude에 있습니다.
5. npm에서 npm.ps1 cannot be loaded because running scripts is disabled on this system가 표시됨. PowerShell의 실행 정책이 npm이 생성한 .ps1 스크립트를 차단하고 있습니다. 문서에서는 세 가지 해결 방법을 제시합니다. 아래의 Set-ExecutionPolicy 명령으로 현재 사용자가 로컬 스크립트를 실행하도록 허용하거나, .ps1 대신 npm.cmd 및 claude.cmd를 호출하거나, npm을 사용하지 않고 네이티브 명령을 사용하세요.

# 1. Kiểm tra thư mục cài đặt đã có trong PATH chưa
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Không có kết quả nào? Thêm vào PATH của người dùng, rồi đóng và mở lại terminal
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Trong terminal mới
claude --version

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

네이티브 설치와 WSL 중 무엇을 사용해야 하나요? Dự án sống trên Windows thì chạy native là đủ. Lúc đó Git for Windows là tùy chọn: có nó, Claude Code chạy lệnh qua Git Bash; không có, nó dùng PowerShell. Nếu Git đã cài mà Claude Code không thấy Git Bash, khai báo CLAUDE_CODE_GIT_BASH_PATH trong khối env của ~/.claude/settings.json, trỏ tới bash.exe (tài liệu lấy ví dụ C:\Program Files\Git\bin\bash.exe). Chọn WSL 2 khi bạn cần công cụ Linux hoặc muốn lệnh chạy trong sandbox, vì sandbox chỉ có trên WSL 2; Windows native và WSL 1 đều không có. WSL 1 chỉ là phương án khi máy không bật được WSL 2. Đã chọn WSL thì cài bằng dòng install.sh và chạy claude hoàn toàn trong terminal WSL.

npm 설치: 조건 및 세 가지 참고 사항

npm hợp lý khi bạn đã quản lý công cụ dòng lệnh bằng Node, hoặc khi mạng công ty chỉ cho tải gói qua registry npm. Điều kiện là Node.js 22 이상; con số Node 18 trong nhiều bài cũ không còn đúng. Đáng chú ý là Node cũ hơn không làm hỏng việc cài: npm chỉ in cảnh báo EBADENGINE, vì thứ thật sự chạy là một chương trình native mà gói npm tải về, không phụ thuộc Node. Máy chưa có Node thì lấy bản 22+ ở nodejs.org.

node -v                                    # cần v22 trở lên
npm install -g @anthropic-ai/claude-code   # không dùng sudo

# nâng cấp bằng @latest, không dùng npm update -g
npm install -g @anthropic-ai/claude-code@latest

• sudo npm install -g를 사용하지 마세요. 문서에서는 이 방법이 권한 오류를 일으키며 보안 위험이라고 경고합니다.
• npm install -g @anthropic-ai/claude-code@latest로 최신 버전으로 올리세요. npm update -g는 안내된 방법이 아닙니다.
• 네이티브 프로그램은 선택적 종속성에서 제공됩니다(플랫폼에 맞는 @anthropic-ai/claude-code-* 패키지). --omit=optional 플래그, .npmrc의 optional=false 줄 또는 --ignore-scripts를 사용하면 이 종속성이 누락되며 macOS/Linux에서는 claude native binary not installed가 표시됩니다.

VPN이 필요한가요? 설치 스크립트 다운로드 오류

Không cần. Việt Nam nằm trong Anthropic 지원 국가 목록 cho cả Claude.ai lẫn API (kiểm tra ngày 2026년 10월 3일). Chính VPN mới hay gây chuyện: theo 설치 문제 해결 페이지 (đọc ngày 2026년 10월 3일), khi địa chỉ cài đặt trả về App unavailable in region, Claude Code không khả dụng ở nơi mà kết nối của bạn được nhìn thấy. Ở Việt Nam mà gặp dòng này thì tắt VPN hoặc proxy đặt ở nước khác rồi chạy lại.

나머지 두 오류는 원인이 같습니다. syntax error near unexpected token '<' 또는 curl: (22) The requested URL returned error: 403는 스크립트 대신 HTML 페이지나 오류 코드를 받았다는 뜻입니다. 프록시나 방화벽이 파일 다운로드를 차단하는 회사 네트워크가 첫 번째 의심 대상입니다. Homebrew, WinGet 또는 npm으로 서둘러 바꾸지 마세요. 대체 설치 방법도 동일한 서버에서 다운로드하므로 먼저 네트워크 연결을 확인하라는 것이 문서의 권장 사항입니다. 다른 네트워크를 사용하거나 IT 부서에 차단 해제를 요청하세요.

API 키 구성: Pro/Max 요금제 없이 Claude Code 실행하기

Claude Code는 두 가지 방법 중 하나로 인증합니다. 아래 표에서 빠르게 비교할 수 있으며, 문서의 나머지 부분은 오른쪽 열의 방법을 따릅니다.

Claude Code를 Anthropic이 아닌 다른 서비스로 연결하는 것은 임시방편이 아닙니다. 공식 문서에서는 ANTHROPIC_BASE_URL를 프록시 또는 게이트웨이를 통해 연결할 때 API 엔드포인트를 덮어쓰는 변수로 설명합니다. Kunavo는 Anthropic Messages API와 동일한 프로토콜을 사용하므로 플러그인이나 패치 없이 기본 Claude Code를 사용할 수 있습니다. 정확히 여섯 개의 변수가 필요합니다:

변수를 설정할 위치

장기간 사용하기에 가장 간단한 방법은 사용자 settings 파일의 env 블록인 ~/.claude/settings.json입니다(Windows: %USERPROFILE%\.claude\settings.json). 이 파일은 모든 프로젝트에 적용됩니다. 이미 내용이 있다면 env 블록만 추가하세요:

{
  "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"
  }
}

셸에 저장하려면 ~/.zshrc 또는 ~/.bashrc에 추가하세요. Windows에서는 아래의 두 번째 부분($env: 줄)이 빠른 테스트에 적합하지만 PowerShell 창을 닫는 즉시 변수가 사라집니다.

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # chỉ tên miền, không thêm /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-5

# Chỉ có hiệu lực trong cửa sổ PowerShell này, đóng cửa sổ là mất
$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"
claude

문제가 발생하기 전에 알아야 할 세 가지 사항:

• 프로젝트의 .claude/settings.json에 키를 넣지 마세요. 게이트웨이 연결 문서 nhắc rằng file này được commit, ai clone repo cũng có.
• settings 파일이 셸보다 우선합니다. 동일한 변수가 두 곳에 있으면 settings 파일의 env 블록에 있는 값이 사용됩니다. 셸에서 수정했는데 아무것도 바뀌지 않으면 먼저 settings 파일을 확인하세요.
• 첫 실행에는 사용자 수준의 키가 필요합니다. 대화형 모드에서는 프로젝트의 env 블록이 .claude/settings.json 또는 .claude/settings.local.json에 있어도 초기 설정 마법사와 폴더를 신뢰할지 묻는 질문을 완료한 후에만 적용됩니다. 키가 해당 위치에만 있으면 처음 시작할 때 여전히 로그인 화면이 표시됩니다.

ANTHROPIC_AUTH_TOKEN 또는 ANTHROPIC_API_KEY, 그리고 “403 오류” 문제

Kunavo đọc key ở cả Authorization: Bearer lẫn x-api-key, nên biến nào cũng kết nối được. Khác biệt nằm ở phía Claude Code. Theo 환경 변수 문서 (đọc ngày 2026년 10월 3일), ANTHROPIC_AUTH_TOKEN đi vào header Authorization với tiền tố Bearer và có hiệu lực ngay. ANTHROPIC_API_KEY đi vào header X-Api-Key, và ở chế độ tương tác Claude Code hỏi bạn một lần có dùng key này thay cho gói đăng ký không. Trả lời “không” thì key bị bỏ qua mà không hỏi lại; muốn bật lại thì vào /config, mục 사용자 지정 API 키 사용. Bài này chọn ANTHROPIC_AUTH_TOKEN chỉ để bỏ được bước hỏi đó.

Vài hướng dẫn tiếng Việt viết rằng ANTHROPIC_API_KEY khiến Claude Code phớt lờ ANTHROPIC_BASE_URL, gọi thẳng api.anthropic.com và nhận 403. Cả tài liệu biến môi trường lẫn 게이트웨이 연결 문서 (đọc ngày 2026년 10월 3일) đều không nói vậy: hai biến là hai cách đưa key tới cùng một gateway trong ANTHROPIC_BASE_URL. Nếu bạn thật sự gặp 403 sau khi đổi biến, hãy kiểm tra lại base URL và key thay vì đổi qua đổi lại tên biến.

모델을 고정해야 하는 이유와 모델별 비용

Alias của Claude Code không đứng yên. Theo 모델 구성 문서 (đọc ngày 2026년 10월 3일), với người dùng API, mô hình mặc định và alias opus đang trỏ tới Opus 5.5, alias sonnet trỏ tới Sonnet 5.5; tài liệu cũng nói alias “được cập nhật theo thời gian” và khuyên dùng tên đầy đủ hoặc các biến ANTHROPIC_DEFAULT_*_MODEL khi cần cố định. Tính đến ngày 2026년 10월 3일, Kunavo có Opus 5.5 nhưng không có Sonnet 5.5. Hệ quả nếu bỏ qua bước ghim: phiên mặc định chạy Opus 5.5, đắt hơn Claude Sonnet 5; /model sonnet, giai đoạn thực thi của opusplan và subagent đặt model: sonnet trả về 404; và lần tới alias opus nhảy sang bản Opus mới, bản đó chưa chắc đã có trên Kunavo. Vì vậy đoạn cấu hình ở trên ghim alias sonnet vào claude-sonnet-5 bằng ANTHROPIC_DEFAULT_SONNET_MODEL, và ghim alias opus vào Opus 5.5 (claude-opus-5-5). Opus 5.5 cần Claude Code v2.1.280 trở lên; bản cũ hơn thì chạy claude update.

Kunavo 가격은 토큰 100만 개당(입력 / 출력) 다음과 같습니다: Claude Sonnet 5 1,40 USD / 7,00 USD (Anthropic 가격표: 2,00 USD / 10,00 USD); Claude Opus 5.5 2,80 USD / 14,00 USD; Claude Haiku 4.5 0,70 USD / 3,50 USD.

/status로 확인하기

ANTHROPIC_AUTH_TOKEN를 읽은 상태라면 claude 명령은 로그인 화면 없이 로그인 화면 없이 바로 작업 세션으로 들어갑니다(게이트웨이 연결 문서, 2026년 10월 3일 기준). 첫 실행에는 폴더를 신뢰할지 묻는 질문 등 몇 가지 설정 단계가 여전히 표시됩니다. 로그인 화면이 보인다면 키가 올바른 위치에 전달되지 않은 것입니다. 세션에서 /status를 입력하고 다음을 찾으세요:

• Anthropic base URL: https://api.kunavo.com. 이 줄은 gateway 주소가 있을 때만 표시되며, 표시되지 않으면 ANTHROPIC_BASE_URL가 세션에 진입하지 못했다는 뜻입니다.
• Auth token: ANTHROPIC_AUTH_TOKEN. 해당 위치가 Login method이고 claude.ai 계정이 함께 있으면 세션은 저장된 로그인으로 계속 사용 중입니다.

Claude Code를 열기 전에 key와 주소가 올바른지 확인하려면 출력 토큰을 정확히 1개 요청하는 테스트 request를 보내세요(잔액에서 아주 적은 금액이 차감됩니다). 이 명령은 현재 shell에서 변수를 읽으므로 key가 settings 파일에만 있다면 이 터미널에서 먼저 export하세요. {"id":"msg_로 시작하는 결과는 정상이고, 401는 key가 거부되었다는 뜻입니다.

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": "."}]}'

동일한 테스트의 PowerShell 버전입니다. 성공하면 결과의 id 필드가 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": "."}]}'

API key로 실행할 때 포기해야 하는 기능

• Remote Control과 음성 입력에는 claude.ai ID가 필요하므로 ANTHROPIC_AUTH_TOKEN가 적용되면 실행되지 않습니다. 또한 ANTHROPIC_BASE_URL가 api.anthropic.com 이외의 서버를 가리키면 Remote Control도 비활성화됩니다.
• /fast에 Fast mode has been disabled by your organization가 표시됩니다. gateway 연결 문서에 따르면 fast mode 확인 단계에는 claude.ai 로그인 또는 Anthropic API key가 필요하므로, Claude Code는 bearer token 사용 시 이를 비활성화한 것으로 간주하고 서버에 묻지 않습니다.
• MCP tool search는 base URL이 Anthropic의 URL이 아니면 기본적으로 비활성화됩니다.
• /context의 수치 là ước tính: Kunavo không có endpoint /v1/messages/count_tokens, và theo gateway 프로토콜 문서 (đọc ngày 2026년 10월 3일), khi thiếu endpoint này Claude Code đếm token dựa trên số ký tự.

통합 세부 정보는 Claude Code 통합 문서(영문)에 있으며, 영어로 된 해당 글은 Install Claude Code입니다.

베트남에서 충전하기: 카드 또는 Link, 현지 전자지갑은 지원되지 않음

먼저 분명히 말씀드리면, Kunavo는 MoMo, ZaloPay, VNPay 또는 은행 송금을 지원하지 않습니다. Napas 네트워크만 사용하는 국내 ATM 카드도 Visa나 Mastercard가 아니므로 사용할 수 없습니다. Kunavo의 Stripe 결제 페이지에서 베트남 구매자에게 제공되는 옵션은 다음과 같습니다:

• Visa 또는 Mastercard 카드는 국제 신용카드와 직불카드 모두 사용할 수 있습니다.
• Link, ví của Stripe, lưu phương thức thanh toán để lần sau trả nhanh hơn (Link 문서, đọc ngày 2026년 10월 3일).
• Apple Pay 또는 Google Pay, chỉ xuất hiện trên thiết bị và trình duyệt đã thiết lập ví, vì chúng trả bằng thẻ có trong ví. Apple Pay có mặt ở Việt Nam từ 08/08/2023 và dùng được khi mua hàng trực tuyến (Apple Newsroom 베트남, đọc ngày 2026년 10월 3일).

Phía Anthropic cũng vậy: gói Claude mua trên web chỉ nhận thẻ tín dụng hoặc ghi nợ (Claude 결제 FAQ, đọc ngày 2026년 10월 3일), nên ví điện tử Việt Nam không trả trực tiếp được ở đó; gói mua trong ứng dụng iOS hay Android thì đi theo phương thức của App Store hoặc Google Play. Khác ở chỗ, tiền nạp vào Kunavo thành số dư API, và Claude Code trừ dần theo token sau khi bạn cấu hình key như trên.

VND 또는 USD로 결제

Kunavo niêm yết giá bằng USD. Vì Việt Nam nằm trong các thị trường của Stripe Adaptive Pricing (đọc ngày 2026년 10월 3일), trang thanh toán có thể hiện số tiền đã quy đổi sang VND, và con số chính xác luôn hiện ra trước khi bạn bấm xác nhận. Tỷ giá Stripe đưa ra đã cộng phí chuyển đổi 2–4%, người mua chịu. Chọn trả bằng USD thì không có khoản đó, nhưng ngân hàng phát hành thẻ có thể áp tỷ giá và phí của họ.

Trả bằng VND cũng chưa chắc rẻ hơn: một số ngân hàng thu phí khi thẻ thanh toán bằng VND cho đơn vị bán hàng đăng ký ở nước ngoài. Chẳng hạn Techcombank thu “phí giao dịch nội tệ ở nước ngoài” 1,1% số tiền giao dịch (đã gồm VAT) với thẻ ghi nợ Visa, áp dụng từ 13/08/2023 (Techcombank FAQ, đọc ngày 2026년 10월 3일). Đây chỉ là ví dụ của một ngân hàng, và Kunavo chưa xác minh được ngân hàng có xếp giao dịch của mình vào loại này hay không; xem biểu phí thẻ của bạn rồi hãy chọn VND hay USD.

카드가 거부되는 일반적인 이유는 은행 앱에서 온라인 결제 또는 국제 결제를 활성화하지 않았기 때문입니다. 활성화한 후 다시 시도하거나, Link 또는 해당 지갑에서 지원하는 카드로 Apple Pay/Google Pay를 사용해 보세요.

가입부터 key 발급까지

1. 이메일 또는 Google 계정으로 Kunavo에 가입하세요. 이 단계에서는 카드를 요구하지 않습니다.
2. Billing을 열고 충전 금액을 선택하세요(최저 10 USD). 큰 금액에는 다음 추가 혜택이 적용됩니다: nạp 100 USD được 110 USD vào số dư; nạp 1.000 USD được 1.200 USD vào số dư; nạp 5.000 USD được 6.250 USD vào số dư.
3. Stripe 페이지에서 카드, Link 또는 기기에서 사용할 수 있는 지갑을 선택하고 금액을 확인한 뒤 승인하세요.
4. API Keys로 이동해 key sk-kn-…를 생성하세요. key는 한 번만 표시되므로 즉시 ANTHROPIC_AUTH_TOKEN에 복사하세요.

잔액이 낮아질 때 자동 충전하려면 저장된 카드 또는 Link를 사용해야 합니다. 잔액에는 만료 기간이 없으며, 실패한 request에는 요금이 부과되지 않습니다. Kunavo는 베트남 규정에 따른 전자 세금계산서를 포함해 VAT 세금계산서를 발행하지 않습니다. 충전 내역은 Billing에서 확인할 수 있습니다. 이 잔액은 Kunavo API에만 사용할 수 있으며 Claude Pro, Claude Max 또는 ChatGPT Plus 결제에는 사용할 수 없습니다.

한 번의 코딩 세션 비용은 대략 얼마인가요?

각 요청마다 Claude Code는 전체 대화 컨텍스트를 다시 보내므로 비용은 cache에 크게 좌우됩니다. 반복되는 컨텍스트 부분은 훨씬 저렴한 cache 읽기 요금으로 계산됩니다. 다음 표는 명시된 가정을 바탕으로 한 이론적 계산이며, 실제 측정값이나 상한선이 아닙니다:

• 각 request당 입력 토큰 40.000개: cache에서 읽는 36.000개(90%), cache에 기록하는 4.000개;
• 각 request당 출력 토큰 1.000개;
• 한 세션에 50개의 request가 발생하며, 백그라운드에서 실행되는 Claude Haiku 4.5 작업은 제외합니다;
• Kunavo에서 Claude Sonnet 5를 사용할 때 cache 읽기에는 입력 가격의 10%배, cache 쓰기에는 입력 가격의 1,25배가 적용됩니다. 표의 각 모델에는 고유한 비율이 사용됩니다.

마지막 열은 cache가 얼마나 중요한지 보여 줍니다. 긴 컨텍스트, 긴 답변 또는 서로 다른 작업 사이에서 /clear를 잊는 경우 수치가 올라갑니다. 구독과 API를 비교하고 월별로 추정하는 방법은 Claude Code 가격 문서에 있으며, 모델별 가격은 Claude API 가격표 또는 가격 페이지에서 확인할 수 있습니다. 직접 수치를 입력하려면 Claude 토큰 비용 계산기(영문)를 사용하세요.

메시지별 문제 해결

충전 전에

• Visa/Mastercard 카드, Link 및 카드에서 실행되는 지갑만 지원하며 MoMo, ZaloPay, VNPay 또는 은행 송금은 지원하지 않습니다.
• 자동 충전은 저장된 카드 또는 Link로만 작동합니다. Kunavo는 VAT 세금계산서를 발행하지 않습니다.
• 이는 Claude Pro/Max 요금제가 아니라 토큰당 과금되는 API입니다. Remote Control과 음성 입력은 제공되지 않으며, /fast는 비활성화되었다고 표시되고 MCP tool search는 기본적으로 꺼져 있습니다.
• 2026년 10월 3일 기준으로 Kunavo에는 Sonnet 5.5가 없으므로 고정되지 않은 alias sonnet는 404를 반환합니다.
• Claude Code 문서와 Kunavo 통합 문서는 현재 영어로만 제공됩니다.

자주 묻는 질문