Cài đặt Claude Code: từng bước trên Windows, macOS và Linux, khóa API không cần đăng ký và thanh toán bằng thẻ

Câu trả lời ngắn: Claude Code được cài đặt bằng một dòng duy nhất phù hợp với terminal của bạn. Trên macOS, Linux và WSL, bạn chạy dòng install.sh; trong Windows PowerShell, chạy irm … | iex; trong Command Prompt (CMD), chạy dòng install.cmd; cả ba dòng đều ở ngay bên dưới. Cách này không cần Node.js; nếu muốn cài bằng npm thì cần Node.js 22 trở lên. Sau khi cài đặt, có hai lựa chọn: đăng nhập bằng tài khoản Claude (Pro, Max, Team, Enterprise hoặc Console; gói miễn phí không bao gồm Claude Code) hoặc dùng khóa API mà không cần thuê bao. Với cách dùng khóa, bạn định nghĩa ANTHROPIC_BASE_URL=https://api.kunavo.com (không thêm /v1 ở cuối), ANTHROPIC_AUTH_TOKEN và bốn biến cố định mô hình; /status trong phiên cho biết khóa đã có hiệu lực hay chưa. Chỉ token đã sử dụng mới bị tính phí. Bạn có thể nạp số dư bằng thẻ Visa hoặc Mastercard, Apple Pay, Google Pay hay Link, tối thiểu 10 USD; không có tùy chọn trả góp hoặc Papara.

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

:: Windows – Komut İstemi (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Chúng tôi lấy các dòng này và tên biến bên dưới từ tài liệu thiết lập và kết nối gateway của Claude Code (3 tháng 10, 2026). Anthropic không phát hành các tài liệu này bằng tiếng Thổ Nhĩ Kỳ; vì vậy, chúng tôi giữ nguyên tiếng Anh trong các thông báo lỗi. Chúng tôi kiểm tra giá và phương thức thanh toán của Kunavo lần gần nhất vào ngày 17 tháng 10, 2026. Bạn không cần tìm VPN hay proxy ở nước ngoài: trang các quốc gia được Anthropic hỗ trợ liệt kê Thổ Nhĩ Kỳ cho cả Claude.ai lẫn API (kiểm tra ngày 3 tháng 10, 2026).

Dòng nào, terminal nào?

Phần lớn người gặp khó khi cài đặt là do nhầm terminal, không phải do lệnh. Bảng dưới đây ghép môi trường của bạn với đúng dòng lệnh. Nếu dùng Windows, phần tiếp theo sẽ giải thích cách nhận biết terminal.

Yêu cầu hệ thống

Các yêu cầu trong tài liệu cài đặt chính thức (tính đến 3 tháng 10, 2026):

• Hệ điều hành: macOS 13.0 hoặc mới hơn; Windows 10 phiên bản 1809 trở lên hoặc Windows Server 2019 trở lên; trên Linux là Ubuntu 20.04, Debian 10 và Alpine Linux 3.19 hoặc mới hơn.
• Phần cứng: tối thiểu 4 GB RAM và bộ xử lý x64 hoặc ARM64. Windows 32 bit không được hỗ trợ.
• Shell: Bash, Zsh, PowerShell hoặc CMD.
• Node.js: không cần cho trình cài đặt native; chỉ cần phiên bản 22 trở lên khi dùng npm.
• Tài khoản: nếu đăng nhập, cần Pro, Max, Team, Enterprise hoặc Console. Với khóa API, không cần thuê bao hay đăng nhập.

Một số hướng dẫn tiếng Thổ Nhĩ Kỳ trên internet vẫn sao chép phiên bản cũ của danh sách này: vẫn còn nơi ghi Node.js 18 cho npm, Ubuntu 18.04 hoặc CentOS 7 cho Linux. Tài liệu hiện tại đưa Node.js 22 và Ubuntu 20.04 làm phiên bản tối thiểu. Cảnh báo “mọi bước sẽ lỗi nếu không có proxy cố định xuất phát từ Hoa Kỳ” cũng không áp dụng cho Thổ Nhĩ Kỳ; ngược lại, thiết lập VPN mở có thể gây lỗi khu vực (xem các lỗi tải xuống trong phần macOS và Linux).

Cài đặt Claude Code trên Windows

Trên Windows, bạn không cần quyền quản trị viên, WSL hay Git. Tài liệu chính thức không yêu cầu mở terminal với quyền quản trị viên; bạn có thể bỏ qua bước “chạy PowerShell với tư cách quản trị viên” trong một số video tiếng Thổ Nhĩ Kỳ. Điều duy nhất cần biết là bạn đang dùng terminal nào:

• Nếu dấu nhắc bắt đầu như PS C:\Users\KullaniciAdi> với PS, bạn đang ở PowerShell: dùng dòng irm … | iex.
• Nếu không có PS ở đầu và chỉ thấy C:\Users\KullaniciAdi>, bạn đang ở Command Prompt: dùng dòng install.cmd.
• Đừng mở mục “Windows PowerShell (x86)” trong menu Start. Vì đây là tiến trình 32 bit, nó cũng trả về lỗi Claude Code does not support 32-bit Windows trên máy tính 64 bit; hãy chọn “Windows PowerShell” không có hậu tố.

Dán dòng lệnh vào sai cửa sổ là một trong những nguyên nhân hàng đầu gây lỗi trên Windows, và thông báo không nói rõ điều đó. Dòng CMD được dán vào PowerShell sẽ trả về The token '&&' is not a valid statement separator. Dòng PowerShell được dán vào CMD sẽ báo trên Windows tiếng Thổ Nhĩ Kỳ: “'irm' không được nhận diện là lệnh nội bộ hoặc bên ngoài, chương trình có thể chạy hoặc tệp batch.” (trên hệ thống tiếng Anh là 'irm' is not recognized as an internal or external command). Nếu thử dòng curl … | bash của macOS trong PowerShell, bạn sẽ thấy A parameter cannot be found that matches parameter name 'fsSL' hoặc 'bash' is not recognized as the name of a cmdlet; trên hệ thống tiếng Thổ Nhĩ Kỳ, các thông báo này có thể xuất hiện bằng tiếng Thổ Nhĩ Kỳ. Trong cả ba trường hợp, cách giải quyết giống nhau: dùng dòng dành cho terminal hiện tại.

Có cần Git for Windows và WSL không?

Cả hai đều không bắt buộc. Nếu đã cài Git for Windows, Claude Code chạy các lệnh shell trong Git Bash đi kèm; nếu không, chương trình chuyển sang công cụ PowerShell. Tài liệu khuyến nghị Git nhưng không bắt buộc phải cài. Nếu Git đã được cài nhưng không tìm thấy Git Bash, hãy đặt đường dẫn đầy đủ đến tệp bash.exe trong biến CLAUDE_CODE_GIT_BASH_PATH thuộc khối env của tệp ~/.claude/settings.json (ví dụ trong tài liệu: C:\Program Files\Git\bin\bash.exe).

Có hai lý do để chọn WSL: cần các công cụ Linux hoặc muốn chạy lệnh trong sandbox. Bản cài đặt Windows native không có sandbox:

Nếu làm việc trong WSL, hãy cài đặt và sử dụng trong terminal WSL: dòng dành cho macOS/Linux hoạt động ở đó và claude cũng được mở từ đó.

Không tìm thấy lệnh “claude”

Nếu sau khi cài đặt xong bạn vẫn thấy 'claude' is not recognized (trên macOS và Linux là command not found: claude), rất có thể bạn đang làm việc trong một cửa sổ đã mở trước khi cài đặt: trình cài đặt cập nhật biến PATH nhưng terminal cũ không thấy thay đổi. Trước tiên hãy đóng terminal rồi mở lại. Trên Windows, chương trình nằm ở %USERPROFILE%\.local\bin\claude.exe, còn trên macOS và Linux nằm ở ~/.local/bin/claude. Nếu cửa sổ mới trên Windows vẫn không hiệu quả, hãy thêm thư mục đó vào biến người dùng PATH bằng các lệnh trong tài liệu:

# 1. Kurulum klasörü PATH içinde mi?
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Sonuç yoksa kullanıcı PATH'ine ekleyin, terminali kapatıp yeniden açın
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Yeni terminalde
claude --version

Không thể tải npm.ps1

Thông báo này chỉ xuất hiện khi dùng npm: npm tạo một trình khởi chạy .ps1 cho PowerShell và chính sách thực thi tập lệnh của hệ thống chặn nó. Tài liệu đưa ra ba cách: chạy lệnh bằng tên npm.cmd và claude.cmd, chuyển sang trình cài đặt native trong PowerShell hoặc chỉ cho phép các tập lệnh cục bộ đối với người dùng của bạn:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Cài đặt trên macOS và Linux

Dòng install.sh ở trên nằm trong tab “Native Install (Recommended)” của tài liệu chính thức và cũng hoạt động nguyên vẹn trong WSL. Claude Code được cài theo cách này sẽ tự tải các phiên bản mới trong nền. Nếu thích dùng trình quản lý gói, Homebrew và WinGet cũng là các lựa chọn chính thức; tuy nhiên theo tài liệu, các bản cài đặt này không tự cập nhật theo mặc định, nên bạn phải lấy phiên bản mới qua trình quản lý gói:

# Homebrew – stable kanalı; varsayılan olarak kendini güncellemez
brew install --cask claude-code

# WinGet (Windows) – varsayılan olarak kendini güncellemez
winget install Anthropic.ClaudeCode

Nếu nhận HTML hoặc 403 thay vì tập lệnh

Thông báo syntax error near unexpected token '<' cho biết một trang HTML đã được gửi tới bash thay vì tập lệnh; còn curl: (22) The requested URL returned error: 403 có nghĩa là máy chủ từ chối tải xuống. Theo tài liệu khắc phục sự cố cài đặt (kiểm tra ngày 3 tháng 10, 2026), cả hai trường hợp đều do địa chỉ tải bộ cài không trả về tập lệnh. Nếu trang hiển thị App unavailable in region, theo tài liệu, yêu cầu dường như đến từ một quốc gia nơi Claude Code không được cung cấp. Vì Thổ Nhĩ Kỳ có trong danh sách, nếu bạn nhận được thông báo này tại Thổ Nhĩ Kỳ thì nhiều khả năng lưu lượng truy cập đang đi qua VPN hoặc proxy và thoát ra từ một quốc gia khác; hãy tắt VPN hoặc proxy rồi thử lại. Lỗi 403 không có nội dung thường đến từ proxy hoặc tường lửa của công ty: hãy thử mạng khác hoặc nhờ bộ phận CNTT cho phép truy cập địa chỉ này.

Cài đặt bằng npm: bắt buộc Node.js 22

Cách cài đặt qua npm vẫn còn và vẫn được mô tả trong tài liệu chính thức, nhưng phiên bản mà gói yêu cầu hiện là Node.js 22 trở lên. Nếu node -v hiển thị phiên bản cũ hơn, npm sẽ không dừng cài đặt mà chỉ in cảnh báo EBADENGINE. Dù vậy, cách tốt nhất là nâng cấp Node.js lên phiên bản 22 trở lên từ nodejs.org.

node -v                                    # v22 veya üstü olmalı
npm install -g @anthropic-ai/claude-code   # sudo kullanmadan

# güncelleme: npm update -g değil, @latest
npm install -g @anthropic-ai/claude-code@latest

Ba thói quen gây ra sự cố trên con đường này là:

• Cài đặt bằng sudo. Tài liệu cảnh báo về vấn đề quyền và rủi ro bảo mật đối với sudo npm install -g.
• Cập nhật bằng npm update -g. Cách đúng là npm install -g @anthropic-ai/claude-code@latest.
• Tắt các phụ thuộc tùy chọn. Tệp thực thi chính được cung cấp dưới dạng phụ thuộc tùy chọn trong gói @anthropic-ai/claude-code-* dành riêng cho nền tảng. Cờ --omit=optional hoặc optional=false trong .npmrc sẽ bỏ qua gói này: quá trình cài đặt kết thúc không lỗi, nhưng trên macOS và Linux, khi mở claude sẽ báo claude native binary not installed.

Cài đặt đã hoạt động chưa?

Dù chọn cách nào, hãy mở một terminal mới và chạy hai lệnh sau:

claude --version   # sürüm numarasını yazar, ör. 2.1.211 (Claude Code)
claude doctor      # oturum açmadan kurulum ve ayar teşhisi

Nếu claude --version in ra một số phiên bản, nghĩa là chương trình đã có mặt. claude doctor liệt kê trạng thái cài đặt và các vấn đề trong tệp cài đặt mà không cần đăng nhập; nếu có sự cố ở bước tiếp theo, bạn có thể phân biệt từ đây vấn đề nằm ở cài đặt hay cấu hình.

Không cần thuê bao: thiết lập khóa API cho Claude Code

claude yêu cầu danh tính khi mở lần đầu. Nếu có gói Claude, bạn đăng nhập để tiếp tục; nếu không có gói hoặc muốn trả theo mức sử dụng thay vì phí cố định hằng tháng, bạn chạy Claude Code bằng khóa API. Khác biệt giữa hai cách:

Cách dùng khóa là một cấu hình được Anthropic dự kiến: ANTHROPIC_BASE_URL là biến tích hợp của Claude Code và tài liệu gateway chính thức mô tả việc chạy Claude Code phía sau proxy hoặc gateway bằng biến này. Bạn không cài plugin, bản vá hoặc client đã sửa đổi. Trên macOS và Linux, hãy thêm sáu dòng vào tệp shell của bạn (~/.zshrc hoặc ~/.bashrc):

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # yalnızca alan adı, /v1 yok
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

Trên Windows, hãy thử trong một phiên PowerShell duy nhất trước khi lưu cài đặt vĩnh viễn; khi đóng cửa sổ, các biến cũng biến mất:

# Yalnızca bu PowerShell penceresinde geçerli – pencereyi kapatınca kaybolur
$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

Nếu muốn có hiệu lực trong mọi terminal, hãy ghi các giá trị tương tự vào khối env của tệp cài đặt người dùng. Theo tài liệu, tệp này áp dụng cho tất cả dự án; trên Windows, vị trí là %USERPROFILE%\.claude\settings.json. %APPDATA%\Claude\settings.json xuất hiện trong một số bản tóm tắt AI không phải là đường dẫn trong tài liệu chính thức. Nếu tệp đã tồn tại, không xóa nội dung bên trong mà chỉ thêm khối 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"
  }
}

Sáu biến và những điều cần lưu ý

ANTHROPIC_AUTH_TOKEN hay ANTHROPIC_API_KEY? Khóa Kunavo chấp nhận cả hai tiêu đề: Authorization: Bearer và x-api-key. Khác biệt nằm ở hành vi của Claude Code. ANTHROPIC_AUTH_TOKEN được gửi trong tiêu đề Bearer và hoạt động mà không hỏi. ANTHROPIC_API_KEY được gửi trong tiêu đề x-api-key và yêu cầu bạn xác nhận lần đầu trong chế độ tương tác; nếu trả lời “không”, khóa sẽ bị bỏ qua mà không cảnh báo, và để bật lại bạn phải vào /config → Use custom API key. Đây là lý do hướng dẫn này dùng ANTHROPIC_AUTH_TOKEN.

Tại sao cần cố định mô hình? Theo tài liệu cấu hình mô hình (kiểm tra ngày 3 tháng 10, 2026), Claude Code dùng API sẽ yêu cầu Opus 5.5 cho mô hình mặc định và bí danh opus, đồng thời yêu cầu Sonnet 5.5 cho bí danh sonnet nếu không có cấu hình nào được đặt; các bí danh này thay đổi khi Anthropic phát hành mô hình mới. Tính đến 3 tháng 10, 2026, Kunavo chưa cung cấp Sonnet 5.5, nên yêu cầu sonnet không được cố định sẽ trả về lỗi 404. Claude Opus 5.5 hoạt động trên Kunavo, nhưng giá của mô hình này ($2,80 / $14,00) cao hơn giá của Claude Sonnet 5 ($1,40 / $7,00); nếu không cố định, bạn có thể vô tình sử dụng mô hình đắt hơn. Vì vậy, khối bên trên có dòng ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5: /model sonnet, giai đoạn thực thi của opusplan và các tác nhân con được đặt thành model: sonnet sẽ chạy với Claude Sonnet 5 thay vì Sonnet 5.5. Chúng tôi cố định bí danh opus vào mô hình Claude Opus 5.5 (claude-opus-5-5); mô hình này yêu cầu Claude Code v2.1.280 trở lên. Nếu đang dùng phiên bản cũ hơn, hãy chạy claude update.

Bảng giá trên Kunavo (đầu vào / đầu ra, trên 1 triệu token): Claude Sonnet 5 $1,40 / $7,00 (Bảng giá Anthropic: $2,00 / $10,00); Claude Opus 5.5 $2,80 / $14,00; Claude Haiku 4.5 đảm nhiệm các tác vụ nền, $0,70 / $3,50.

Không nhập khóa ở đâu, giá trị nào có hiệu lực?

Tệp .claude/settings.json riêng của dự án không phải nơi phù hợp để lưu khóa: tài liệu gateway nhắc rằng tệp này được commit vào kho mã, tức là khóa sẽ được chia sẻ với bất kỳ ai sao chép kho mã. Nếu cùng một biến được khai báo trong shell và trong khối env của tệp cài đặt, thông thường giá trị trong tệp cài đặt sẽ có hiệu lực; nếu thay đổi giá trị trong shell mà không thấy tác dụng, hãy kiểm tra tệp đó trước. Khóa model trong tệp cài đặt là trường hợp ngoại lệ của quy tắc này: biến ANTHROPIC_MODEL được ưu tiên hơn khóa đó, còn model chỉ được dùng khi không có biến. Trong tiện ích mở rộng VS Code, hãy nhập các biến vào trường claudeCode.environmentVariables trong cài đặt người dùng của VS Code.

Lần mở đầu tiên và kiểm tra /status

Nếu các biến ở đúng nơi, lệnh claude sẽ mở phiên mà không hiển thị màn hình đăng nhập; tài liệu gateway (kiểm tra: 3 tháng 10, 2026) mô tả hành vi này khi ANTHROPIC_AUTH_TOKEN được đặt. Nếu màn hình đăng nhập xuất hiện, Claude Code chưa nhìn thấy khóa. Nguyên nhân thường gặp là khóa chỉ nằm trong cài đặt dự án: trong chế độ tương tác, khối env trong tệp .claude/settings.json hoặc .claude/settings.local.json của dự án chỉ được đọc sau khi hoàn tất trình hướng dẫn chạy lần đầu và câu hỏi tin cậy thư mục. Khóa phải nằm ở nơi được đọc trước trình hướng dẫn: export trong shell, ~/.claude/settings.json ở cấp người dùng hoặc cài đặt được quản lý (managed settings).

Sau khi mở phiên, hãy nhập /status. Hai dòng cung cấp đủ thông tin:

• Anthropic base URL: chỉ hiển thị khi có địa chỉ tùy chỉnh và phải là https://api.kunavo.com. Nếu không có dòng này, ANTHROPIC_BASE_URL chưa tới được phiên.
• Auth token: nếu bên cạnh có tên ANTHROPIC_AUTH_TOKEN, các yêu cầu đang đi bằng khóa API. Nếu thay vào đó có dòng Login method hiển thị tài khoản claude.ai, Claude Code vẫn đang dùng đăng nhập đã lưu; hãy đăng xuất, mở một terminal mới và kiểm tra nơi bạn đã ghi các biến.

Kiểm tra mà không mở Claude Code

Bạn cũng có thể kiểm tra địa chỉ và khóa độc lập với Claude Code. Phương pháp trong tài liệu chính thức là gửi một yêu cầu với một token đầu ra; số dư sẽ bị trừ một khoản rất nhỏ. Lệnh đọc các biến từ shell hiện tại; nếu khóa chỉ nằm trong tệp cài đặt, trước tiên hãy chạy export trong terminal này. Nếu phản hồi bắt đầu bằng {"id":"msg_, địa chỉ và khóa hợp lệ; 401 cho biết khóa 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": "."}]}'

Bản tương ứng trong PowerShell ở bên dưới; nếu thành công, phản hồi sẽ có trường id 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": "."}]}'

Khóa API làm thay đổi điều gì?

• Không có Remote Control và nhập liệu bằng giọng nói. Theo tài liệu, cả hai đều yêu cầu danh tính claude.ai và không hoạt động khi ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN hoặc apiKeyHelper đang bật. Kể từ v2.1.196, Remote Control cũng bị tắt khi ANTHROPIC_BASE_URL trỏ tới một máy chủ bên ngoài Anthropic.
• /fast sẽ hiển thị là tắt. Theo tài liệu, khi chỉ có bearer token được đặt, Claude Code không hỏi trạng thái chế độ nhanh (fast mode) và mặc định coi chế độ này là tắt.
• Tìm kiếm công cụ MCP mặc định bị tắt. Theo tài liệu MCP (kiểm tra ngày 3 tháng 10, 2026), một cấu hình tùy chỉnh ANTHROPIC_BASE_URL nằm trong số các cấu hình không sử dụng tính năng tìm kiếm công cụ.
• Các con số của /context chỉ là ước tính. Kunavo không cung cấp endpoint /v1/messages/count_tokens; trong trường hợp này, theo tài liệu về khả năng tương thích của gateway (kiểm tra ngày 3 tháng 10, 2026), Claude Code ước tính mức sử dụng ngữ cảnh dựa trên số ký tự.

Chi tiết kỹ thuật của tích hợp nằm trong tài liệu tích hợp Claude Code bằng tiếng Anh; phiên bản tiếng Anh của hướng dẫn này là Install Claude Code.

Thanh toán từ Thổ Nhĩ Kỳ: thẻ, Apple Pay, Google Pay, Link

Khoản thanh toán ở đây không phải phí đăng ký mà là số dư API trả trước, được Claude Code tiêu thụ theo từng token. Pro và Max mua trên trang web của Anthropic chỉ có thể thanh toán bằng thẻ tín dụng hoặc thẻ ghi nợ (Câu hỏi thường gặp về thanh toán gói trả phí Claude, kiểm tra ngày 3 tháng 10, 2026). Khoản nạp vào Kunavo không thay thế hay thanh toán cho các gói đó. Các bước:

1. Đăng ký Kunavo. Chỉ cần địa chỉ email hoặc tài khoản Google; khi đăng ký không yêu cầu thông tin thẻ.
2. Chọn số tiền trên trang Billing. Mức tối thiểu là 10 USD; không có thuê bao hoặc phí hằng tháng. Với số tiền lớn, tiền thưởng sẽ được cộng thêm: Nạp 100 USD để nhận số dư 110 USD, Nạp 1.000 USD để nhận số dư 1.200 USD và Nạp 5.000 USD để nhận số dư 6.250 USD.
3. Trang thanh toán Stripe sẽ mở. Chọn một trong các phương thức: thẻ (Visa, Mastercard), Apple Pay, Google Pay hoặc Link; Apple Pay và Google Pay chỉ được liệt kê trên các thiết bị và trình duyệt hỗ trợ chúng.
4. Sau đó, trên trang API Keys, hãy tạo một khóa bắt đầu bằng sk-kn-. Khóa chỉ được hiển thị một lần; hãy sao chép và nhập ngay vào giá trị ANTHROPIC_AUTH_TOKEN.

Số tiền hiển thị bằng TL hay đô la?

Giá Kunavo được niêm yết bằng đô la; Stripe quyết định đơn vị tiền tệ hiển thị trên trang thanh toán và số tiền có thể được hiển thị bằng lira Thổ Nhĩ Kỳ. Tài liệu Adaptive Pricing của Stripe (kiểm tra ngày 3 tháng 10, 2026) liệt kê Thổ Nhĩ Kỳ trong các thị trường được hỗ trợ và cho biết trong quá trình chuyển đổi này, một khoản phí 2–4% do người mua chịu được cộng vào tỷ giá. Nếu chọn thanh toán bằng đô la, bạn sẽ không phải trả khoản phí này; khi đó, ngân hàng phát hành thẻ sẽ áp dụng tỷ giá riêng và mọi phí giao dịch quốc tế nếu có. Dù sử dụng đơn vị tiền tệ nào, bạn sẽ thấy số tiền chính xác trên trang thanh toán trước khi xác nhận.

Trả góp, Papara, chuyển khoản ngân hàng và Troy

• Không có trả góp, khoản thanh toán được thu một lần. Các khoản chi tiêu bằng thẻ Thổ Nhĩ Kỳ trên các trang web nước ngoài cũng không thể chuyển sang trả góp sau đó (enuygunfinans.com, kiểm tra ngày 3 tháng 10, 2026).
• Không có Papara, chuyển khoản ngân hàng/EFT và PayPal. Các tùy chọn này sẽ không xuất hiện trên trang thanh toán.
• Troy: Troy không xuất hiện trên trang các thương hiệu thẻ được hỗ trợ của Stripe (kiểm tra ngày 3 tháng 10, 2026). Hãy thanh toán bằng thẻ có logo Visa hoặc Mastercard.
• Không có hóa đơn. Kunavo không phát hành bất kỳ hóa đơn nào, kể cả hóa đơn điện tử e-Arşiv; bảng kê các lần nạp tiền của bạn có trên trang Billing.

Nếu thẻ bị từ chối, trước tiên hãy kiểm tra ứng dụng di động của ngân hàng: thẻ phải được bật cho giao dịch mua sắm trực tuyến và giao dịch quốc tế. Chỉ có thể thiết lập nạp tiền tự động bằng thẻ đã lưu hoặc Link. Số dư không có ngày hết hạn và các yêu cầu thất bại không bị tính phí. Biểu phí của tất cả model có trong hướng dẫn giá Claude API.

Một phiên làm việc có giá bao nhiêu?

Trên lộ trình khóa API, chi phí hoàn toàn phụ thuộc vào số lượng token. Claude Code gửi lại toàn bộ ngữ cảnh cuộc trò chuyện trong mỗi yêu cầu; khi phần đầu không thay đổi của ngữ cảnh được đọc từ bộ nhớ đệm, phần này được tính theo mức giá thấp hơn nhiều. Bảng dưới đây là phép tính dựa trên các giả định rõ ràng, không phải một phép đo; cũng không nên được xem là giới hạn trên. Các giả định:

• 40.000 token đầu vào cho mỗi yêu cầu; trong đó 36.000 (90%) được đọc từ bộ nhớ đệm, còn 4.000 được ghi vào bộ nhớ đệm;
• 1.000 token đầu ra cho mỗi yêu cầu;
• 50 yêu cầu trong mỗi phiên; không tính các lệnh gọi Claude Haiku 4.5 chạy ở chế độ nền;
• Đối với Claude Sonnet 5, việc đọc từ bộ nhớ đệm có giá bằng 10% mức giá đầu vào, còn việc ghi vào bộ nhớ đệm có giá bằng 1,25 lần mức đó. Mỗi model trong bảng được tính theo mức giá riêng.

Số tiền thực tế phụ thuộc vào độ dài ngữ cảnh, tỷ lệ truy cập bộ nhớ đệm, độ dài câu trả lời và việc bạn có xóa cuộc trò chuyện khi đổi chủ đề hay không. Tài liệu chính thức về chi phí (kiểm tra ngày 3 tháng 10, 2026) bổ sung hai chi tiết: Claude Code vẫn tiêu thụ một lượng nhỏ token ở chế độ nền ngay cả khi bạn không nhập gì, thường dưới 0,04 đô la mỗi phiên; với khóa API, thời gian lưu bộ nhớ đệm mặc định là năm phút, nên tin nhắn đầu tiên sau khoảng nghỉ dài hơn sẽ không truy cập được bộ nhớ đệm và toàn bộ ngữ cảnh sẽ được xử lý lại. Khi đổi chủ đề, dùng /clear; trong các phiên dài, dùng /compact để giảm chi phí này.

Tất cả biểu phí có trên trang giá. Bạn có thể ước tính mức sử dụng của mình bằng công cụ tính chi phí token Claude (tiếng Anh). Hướng dẫn giá Claude Code phân tích câu hỏi nên dùng gói đăng ký hay API.

Thông báo lỗi và cách khắc phục

Các giới hạn cần biết

• Kunavo không phát hành hóa đơn; cũng không có e-Arşiv.
• Thanh toán một lần: không có trả góp, Papara và chuyển khoản ngân hàng/EFT. Cần có thẻ đã lưu hoặc Link để nạp tiền tự động.
• Đây không phải là gói đăng ký Claude Pro hay Max mà là API trả phí theo token. Trên lộ trình khóa, Remote Control và đọc chính tả bằng giọng nói không hoạt động, /fast hiển thị là đã tắt và tính năng tìm kiếm công cụ MCP bị tắt theo mặc định.
• Kunavo không cung cấp Sonnet 5.5 kể từ 3 tháng 10, 2026; nếu không cố định model, bí danh sonnet sẽ trả về 404.
• Tài liệu chính thức của Claude Code và tài liệu tích hợp Kunavo chỉ có bằng tiếng Anh (kiểm tra: 3 tháng 10, 2026).

Câu hỏi thường gặp