Hướng dẫn cài đặt Claude Code: lệnh cài đặt trên Windows, macOS; cấu hình bằng API key mà không cần đăng nhập tài khoản; nạp tiền bằng Alipay, WeChat Pay

Claude Code được khuyến nghị cài đặt bằng lệnh cài đặt native chính thức của Anthropic; npm là phương thức chính thức thay thế và yêu cầu Node.js 22 trở lên. Bạn cũng có thể dùng Claude Code mà không đăng nhập tài khoản Claude: đặt ANTHROPIC_BASE_URL (chỉ ghi đến tên miền, không thêm /v1), ANTHROPIC_AUTH_TOKEN và bốn dòng cố định model để chuyển sang API key tính phí theo token. Số dư API Kunavo có thể được nạp bằng Alipay hoặc WeChat Pay, khoản nạp tối thiểu là $10. Cuối cùng, chạy /status trong Claude Code để xác nhận kết nối.

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

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

:: Windows 命令提示符（CMD）
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Các lệnh và biến môi trường được đối chiếu với 3 tháng 10, 2026, dựa trên tài liệu cài đặt chính thức của Claude Code và tài liệu chính thức về biến môi trường; giá và phương thức thanh toán được đối chiếu với 19 tháng 10, 2026. Trước tiên, cần nêu rõ một thực tế: danh sách quốc gia và khu vực được Anthropic hỗ trợ (đối chiếu với 3 tháng 10, 2026) không có Trung Quốc đại lục, Hồng Kông và Ma Cao; yêu cầu hệ thống trong tài liệu cài đặt Claude Code cũng có dòng “Khu vực của bạn: quốc gia được Anthropic hỗ trợ”. Trang này chỉ trình bày các phương thức cài đặt và cấu hình được ghi trong tài liệu chính thức, không cung cấp cách vượt qua hạn chế khu vực. Kunavo chưa kiểm tra kết nối mạng tại Trung Quốc đại lục; bạn cần tự xác nhận liệu các địa chỉ tải xuống, nguồn npm và api.kunavo.com được đề cập bên dưới có truy cập được qua mạng của mình hay không.

Xác nhận trước khi cài đặt

Phương thức một: Cài đặt native chính thức (khuyến nghị)

Tài liệu cài đặt chính thức đánh dấu cài đặt native là phương thức được khuyến nghị. Các lệnh chính là ba phần ở đầu trang này: macOS, Linux và WSL dùng dòng install.sh, Windows PowerShell dùng irm … | iex, còn Windows CMD dùng dòng install.cmd. Cài đặt native sẽ tự động cập nhật lên phiên bản mới nhất trong nền; tài liệu chính thức đồng thời nêu rằng cài đặt bằng Homebrew và WinGet mặc định không tự động cập nhật.

Sau khi cài đặt, hãy mở một cửa sổ terminal mới (các cửa sổ đã mở không đọc được PATH mới), rồi xác nhận:

claude --version   # 正常会打印版本号，后面跟着 (Claude Code)
claude doctor      # 只读的安装与设置诊断，不会开启会话

claude doctor không khởi chạy phiên, chỉ in trạng thái cài đặt và thông tin chẩn đoán của các tệp cài đặt; có thể dùng để phân biệt “cài đặt bị hỏng” với “cấu hình bị hỏng”.

Khi tải xuống gặp lỗi

Nếu trong terminal xuất hiện syntax error near unexpected token '<' hoặc curl: (22) The requested URL returned error: 403, theo tài liệu chính thức về khắc phục sự cố cài đặt (đối chiếu với 3 tháng 10, 2026), điều đó có nghĩa địa chỉ cài đặt trả về một trang web hoặc mã trạng thái lỗi thay vì tập lệnh cài đặt. Nếu trang trả về ghi App unavailable in region, giải thích chính thức là Claude Code không khả dụng tại quốc gia hoặc khu vực của bạn. Lỗi 403 không kèm nội dung trang web cũng có thể do proxy hoặc tường lửa của công ty chặn tải xuống; hướng dẫn chính thức là nếu vẫn gặp lỗi 403 tại khu vực được hỗ trợ, trước hết hãy kiểm tra kết nối mạng rồi cân nhắc phương thức cài đặt khác.

Phương thức hai: Cài đặt bằng npm (cần Node.js 22 trở lên)

npm vẫn là một phương thức cài đặt được liệt kê trong tài liệu chính thức. Tài liệu chính thức nêu rõ gói npm cần Node.js phiên bản 22 trở lên; nếu phiên bản cũ hơn, npm sẽ in cảnh báo EBADENGINE nhưng không báo lỗi, và quá trình cài đặt vẫn hoàn tất vì gói này tải xuống một binary native không phụ thuộc vào Node.js khi chạy. Nếu chưa cài Node.js, hãy cài phiên bản 22 trở lên từ trang web chính thức của Node.js.

node -v                                    # 需要 v22 或更高
npm install -g @anthropic-ai/claude-code   # 不要加 sudo

Tài liệu chính thức nêu rõ không sử dụng sudo npm install -g, vì điều này gây ra vấn đề về quyền và rủi ro bảo mật. Khi nâng cấp, dùng npm install -g @anthropic-ai/claude-code@latest, không dùng npm update -g.

Khi tải từ nguồn mặc định thất bại hoặc rất chậm: npmmirror

Nếu tải xuống từ nguồn npm mặc định thất bại hoặc quá chậm, bạn có thể chuyển sang npmmirror. Trang chủ npmmirror (đối chiếu với 3 tháng 10, 2026) cho biết đây là “bản sao đầy đủ của npmjs.com”, chỉ đọc, sẽ “cố gắng đồng bộ theo thời gian thực với dịch vụ chính thức”, đồng thời cung cấp địa chỉ registry và lệnh thiết lập. Trang chủ không nêu tần suất đồng bộ cụ thể.

# 只在这一次安装时使用 npmmirror
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

# 或者把 npmmirror 设为 npm 的默认源（之后所有 npm 安装都会走它）
npm config set registry https://registry.npmmirror.com

# 以后升级用 @latest，不要用 npm update -g
npm install -g @anthropic-ai/claude-code@latest --registry=https://registry.npmmirror.com

Cài Claude Code bằng mirror có hai điều kiện dễ bị bỏ sót, đều xuất phát từ tài liệu xử lý sự cố chính thức:

• Mirror phải đồng thời cung cấp 8 gói nền tảng. Bản thân gói npm chỉ là lớp vỏ; chương trình thực tế được tải dưới dạng các dependency tùy chọn @anthropic-ai/claude-code-* dành cho từng nền tảng. Nếu mirror thiếu gói nền tảng, sau khi cài đặt, khi chạy claude trên macOS hoặc Linux sẽ hiện claude native binary not installed (trên Windows, PowerShell hoặc CMD sẽ báo không thể chạy tệp này). Ngày 3 tháng 10, 2026, Kunavo kiểm tra từ mạng bên ngoài Trung Quốc đại lục rằng gói chính trên npmmirror và các gói cho Windows x64, macOS ARM64, Linux x64 khớp với phiên bản mới nhất trên npmjs; các gói nền tảng còn lại (Windows ARM64, Mac Intel, Linux ARM64 và hai phiên bản musl) chưa được đối chiếu.
• Không được bỏ qua dependency tùy chọn. Không thêm --omit=optional vào lệnh cài đặt, đồng thời xác nhận rằng .npmrc không đặt optional=false.

Chuyên mục Windows

Windows có hai lệnh cài đặt khác nhau; điểm khác biệt chỉ là bạn mở loại terminal nào. Dấu nhắc có dạng PS C:\Users\你的用户名> là PowerShell; dấu nhắc không có PS mà chỉ có C:\Users\你的用户名> là Command Prompt (CMD). Tài liệu chính thức cho biết cài đặt không cần chạy với quyền quản trị viên.

Một lỗi phổ biến trên Windows là dán nhầm lệnh vào terminal: chạy dòng CMD trong PowerShell sẽ thấy The token '&&' is not a valid statement separator; chạy dòng PowerShell trong CMD sẽ thấy 'irm' is not recognized as an internal or external command. Chỉ cần chuyển lại sang dòng tương ứng. Ngoài ra, trong menu Start có hai mục “Windows PowerShell” và “Windows PowerShell (x86)”; mục sau là tiến trình 32-bit và sẽ báo Claude Code does not support 32-bit Windows, vì vậy hãy mở mục không có (x86).

Git for Windows là tùy chọn: sau khi cài đặt, Claude Code dùng Git Bash đi kèm để thực thi lệnh; nếu chưa cài, chương trình sẽ dùng công cụ PowerShell để thực thi. Nếu đã cài nhưng không tìm thấy Git Bash, hãy thiết lập CLAUDE_CODE_GIT_BASH_PATH trong ~/.claude/settings.json, mục env, trỏ đến bash.exe; đường dẫn ví dụ chính thức là C:\Program Files\Git\bin\bash.exe.

Nếu chọn WSL, hãy chạy dòng dành cho macOS/Linux trong terminal WSL và cũng khởi động claude trong WSL, không phải trong PowerShell hoặc CMD.

Lỗi chính sách thực thi trong phương thức npm

Khi cài đặt hoặc chạy npm trong PowerShell, nếu thấy npm.ps1 cannot be loaded because running scripts is disabled on this system, nghĩa là chính sách thực thi của PowerShell đã chặn tập lệnh khởi động .ps1 do npm tạo. Tài liệu chính thức đưa ra ba cách xử lý: cho phép người dùng hiện tại chạy tập lệnh cục bộ (dòng bên dưới); chuyển sang npm.cmd, claude.cmd; hoặc dùng lệnh cài đặt native của PowerShell.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Sau khi cài đặt, báo không tìm thấy claude

Nếu xuất hiện command not found: claude hoặc 'claude' is not recognized, nghĩa là thư mục cài đặt không nằm trong PATH. Cài đặt native đặt chương trình tại ~/.local/bin/claude trên macOS/Linux và %USERPROFILE%\.local\bin\claude.exe trên Windows. Trước tiên hãy mở terminal mới rồi thử lại; nếu trên Windows vẫn không được, theo tài liệu xử lý sự cố chính thức, dùng PowerShell để kiểm tra và thêm vào PATH người dùng:

# 1. 检查安装目录是否已在 PATH 里
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. 没有任何输出时，把它加进「用户」PATH，然后关掉终端重新打开
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. 重新打开终端后确认
claude --version

Cấu hình API key: không đăng nhập tài khoản Claude

ANTHROPIC_BASE_URL là biến môi trường tích hợp sẵn của Claude Code. Tài liệu chính thức mô tả nó là biến ghi đè endpoint API để yêu cầu đi qua proxy hoặc gateway. Vì vậy, trỏ Claude Code tới endpoint cung cấp Anthropic Messages API là cách cấu hình được hỗ trợ chính thức, không cần plugin hoặc chương trình đã chỉnh sửa. Trên macOS/Linux, ghi vào tệp cấu hình shell:

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # 只写到域名，不要加 /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

Nếu muốn thử trước trong một cửa sổ PowerShell trên Windows:

# 只对当前 PowerShell 窗口有效，关掉窗口就失效
$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

Để sử dụng lâu dài, nên ghi vào env trong tệp cài đặt cấp người dùng ~/.claude/settings.json (trên Windows là %USERPROFILE%\.claude\settings.json). Viết ở đây giúp mọi terminal và tác vụ nền đều đọc được; nếu tệp đã có các cài đặt khác, hãy hợp nhất env vào đó:

{
  "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 dòng này đều có một điểm dễ đặt sai:

• ANTHROPIC_BASE_URL chỉ ghi đến tên miền. Claude Code tự nối /v1/messages; nếu thêm /v1 sẽ thành /v1/v1/messages và trả về 404.
• Dùng ANTHROPIC_AUTH_TOKEN, không dùng ANTHROPIC_API_KEY. Tài liệu chính thức cho biết giá trị của ANTHROPIC_AUTH_TOKEN sẽ được gửi dưới dạng header Authorization và tự động thêm tiền tố Bearer, có hiệu lực ngay sau khi đặt; còn ANTHROPIC_API_KEY yêu cầu xác nhận một lần trong chế độ tương tác, nếu chọn từ chối khi xác nhận thì key này sẽ bị bỏ qua im lặng về sau (cần bật lại trong Use custom API key của /config).
• ANTHROPIC_MODEL quyết định model chính. Ở đây cố định là Claude Sonnet 5 (claude-sonnet-5). Tên model phải khớp hoàn toàn với danh sách model của Kunavo; tên cũ có hậu tố ngày sẽ không được tự động ánh xạ.
• ANTHROPIC_DEFAULT_OPUS_MODEL quyết định bí danh opus. Theo tài liệu cấu hình mô hình chính thức (đối chiếu với 3 tháng 10, 2026), mô hình mặc định dành cho người dùng API và bí danh opus trỏ đến Opus mới nhất (hiện là Opus 5.5), còn bí danh sonnet trỏ đến Sonnet 5.5; các bí danh sẽ chuyển sang phiên bản mới khi Anthropic cập nhật. Tài liệu chính thức nêu rằng bí danh “được cập nhật theo thời gian”; để cố định phiên bản, hãy ghi đầy đủ tên mô hình hoặc thiết lập biến như ANTHROPIC_DEFAULT_OPUS_MODEL. Hiện Kunavo chưa cung cấp Sonnet 5.5; khi Anthropic phát hành Opus mới, Kunavo cũng có thể chưa niêm yết ngay. Mô hình chưa được niêm yết sẽ trả về lỗi 404. Vì vậy cần cố định mô hình chính cùng các bí danh opus và sonnet. Tại đây, bí danh opus được cố định thành Claude Opus 5.5 (claude-opus-5-5); cần Claude Code v2.1.280 trở lên, còn phiên bản cũ hơn thì hãy chạy claude update để nâng cấp.
• ANTHROPIC_DEFAULT_SONNET_MODEL quyết định bí danh sonnet. Tài liệu chính thức cho biết biến này quyết định bí danh sonnet trỏ tới model nào, đồng thời quyết định model mà opusplan sử dụng ngoài chế độ lập kế hoạch (ở giai đoạn thực thi). Bí danh sonnet mặc định yêu cầu Sonnet 5.5, model Kunavo hiện chưa cung cấp, vì vậy nếu không đặt dòng này, giai đoạn thực thi của /model sonnet, opusplan và các subagent chỉ định model: sonnet đều sẽ trả về 404. Ở đây cũng cố định thành Claude Sonnet 5 (claude-sonnet-5).
• ANTHROPIC_DEFAULT_HAIKU_MODEL quyết định bí danh haiku.Bí danh haiku sẽ yêu cầu một model ID mà Kunavo không cung cấp: từ v2.1.293 là Haiku 5.5, còn ở các phiên bản cũ hơn là tên Haiku 4.5 có hậu tố ngày tháng. Vì vậy, nếu thiếu dòng này, /model haiku và các tác tử con được chỉ định dùng model: haiku (bao gồm cả claude-code-guide do Claude Code tự khởi chạy) đều sẽ trả về 404. Hãy cố định giá trị ở đây thành claude-haiku-4-5.
• ANTHROPIC_DEFAULT_HAIKU_MODEL cũng quản lý các tác vụ nền. Tài liệu chính thức cho biết biến này quyết định bí danh haiku và cũng được dùng cho các tính năng nền. Claude Haiku 4.5 trên Kunavo có giá mỗi một triệu token đầu vào là $0,70, đầu ra là $3,50; model chính Claude Sonnet 5 có giá $1,40 / $7,00(giá chính thức của Anthropic: $2,00 / $10,00); còn model Claude Opus 5.5 tương ứng với bí danh opus có giá $2,80 / $14,00.

Không ghi key vào .claude/settings.json trong dự án: tài liệu chính thức lưu ý rằng tệp này sẽ được commit và chia sẻ với tất cả những người sao chép kho mã. Ngoài ra, cần biết quy tắc ưu tiên sau: khi shell và tệp settings cùng đặt một biến, giá trị trong tệp settings sẽ được ưu tiên. Nếu thay đổi biến trong shell mà không có hiệu lực, hãy kiểm tra tệp settings trước.

Điều gì xảy ra khi chạy lần đầu

Theo tài liệu kết nối cổng chính thức (đối chiếu với 3 tháng 10, 2026), sau khi thiết lập ANTHROPIC_AUTH_TOKEN rồi chạy claude, bạn sẽ vào thẳng phiên làm việc và không thấy trang đăng nhập; biến này có hiệu lực ngay lập tức, không cần xác nhận trước như ANTHROPIC_API_KEY. Nếu thấy trang đăng nhập sau khi mở, tức là Claude Code chưa đọc được thông tin xác thực.

Thông tin xác thực phải được đặt ở nơi Claude Code đọc trước khi thiết lập lần đầu: export trong shell hoặc env của ~/.claude/settings.json cấp người dùng. Tài liệu chính thức cho biết ở chế độ tương tác, env trong .claude/settings.json hoặc .claude/settings.local.json của dự án chỉ có hiệu lực sau trình hướng dẫn thiết lập lần đầu và lời nhắc tin cậy thư mục; vì vậy nếu key được ghi trong cài đặt cấp dự án, lần khởi động đầu tiên vẫn hiển thị trang đăng nhập.

Sau khi vào phiên, chạy /status và xem hai dòng trên trang Status:

• Anthropic base URL: chỉ xuất hiện khi đã đặt địa chỉ gateway và phải hiển thị https://api.kunavo.com. Nếu không có dòng này, nghĩa là ANTHROPIC_BASE_URL chưa được truyền vào phiên này.
• Auth token: hiển thị ANTHROPIC_AUTH_TOKEN nghĩa là đang dùng API key thay vì thông tin đăng nhập claude.ai đã lưu. Nếu thấy Login method cùng một tài khoản claude.ai, nghĩa là biến chưa có hiệu lực.

Nếu muốn kiểm tra riêng địa chỉ và key trước khi mở Claude Code, bạn có thể gửi một yêu cầu chỉ cần 1 output token theo phương pháp trong tài liệu chính thức (sẽ chỉ trừ một lượng số dư rất nhỏ theo token). Lệnh này đọc các biến trong shell, vì vậy ngay cả khi bạn ghi key trong tệp settings, trước tiên vẫn phải chạy export trong terminal hiện tại. JSON bắt đầu bằng {"id":"msg_ cho biết địa chỉ và key đều hoạt động; nếu trả về 401, nghĩa là key chưa được nhận diện.

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

Điều gì khác khi dùng API key

• Remote Control và tính năng nhập bằng giọng nói không dùng được. Tài liệu chính thức cho biết hai tính năng này phụ thuộc vào danh tính claude.ai nên không dùng được khi đặt ANTHROPIC_AUTH_TOKEN; khi ANTHROPIC_BASE_URL trỏ tới địa chỉ không phải Anthropic, Remote Control cũng bị tắt.
• /fast sẽ hiển thị rằng chế độ fast đã bị tắt. Tài liệu chính thức cho biết khi chỉ có bearer token, Claude Code coi chế độ fast là đã tắt và không gửi kiểm tra tính khả dụng.
• Tìm kiếm công cụ MCP mặc định bị tắt. Tài liệu chính thức cho biết khi ANTHROPIC_BASE_URL trỏ tới địa chỉ không phải Anthropic, tìm kiếm công cụ MCP mặc định bị tắt.
• /context hiển thị con số ước tính trên máy.Hiện Kunavo không cung cấp /v1/messages/count_tokens. Theo tài liệu tương thích cổng chính thức (đối chiếu với 3 tháng 10, 2026), khi cổng không có endpoint này, Claude Code sẽ chuyển sang ước tính dựa trên số ký tự; /context hiển thị giá trị gần đúng.

Xem hướng dẫn tích hợp đầy đủ tại tài liệu tích hợp Claude Code.

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC thực sự tắt những gì

Theo tài liệu chính thức về biến môi trường (đối chiếu với 3 tháng 10, 2026), biến này dùng để tắt lưu lượng mạng không thiết yếu của Claude Code. Nội dung được tài liệu chính thức liệt kê gồm:

• cập nhật tự động, telemetry, báo cáo lỗi;
• lệnh /feedback và phản hồi do Claude soạn thảo;
• ghi chú phát hành, kiểm tra huy hiệu trạng thái PR/MR;
• các kiểm tra tính khả dụng như chế độ fast;
• việc tải feature flag, vì vậy Remote Control và các tính năng khác phụ thuộc vào feature flag sẽ không dùng được;
• việc chạy lại trong nền từ nguồn plugin command (đây là lệnh cục bộ, không phải lưu lượng mạng, vì nó có thể kích hoạt cài đặt dependency).

Một số chi tiết khác được nêu rõ trong tài liệu chính thức: đặt thành 0 hoặc false cũng được tính là đã bật; khác với hầu hết biến dạng công tắc, chỉ xóa biến này mới khôi phục. Việc tự động cài đặt từ marketplace plugin chính thức không nằm trong phạm vi của biến này; nó không ảnh hưởng đến việc phát hiện model của gateway. Tài liệu gateway chính thức bổ sung rằng nó không ảnh hưởng đến kiểm tra an toàn tên miền của công cụ WebFetch; kiểm tra này vẫn truy cập api.anthropic.com, và để tắt cần thêm skipWebFetchPreflight: true trong cài đặt. Tài liệu chính thức không mô tả biến này là cài đặt liên quan đến kiểm soát rủi ro tài khoản.

Kunavo không yêu cầu thiết lập biến này, và biến này cũng không ảnh hưởng đến các yêu cầu mô hình gửi đến Kunavo. Tài liệu kết nối cổng chính thức (đối chiếu với 3 tháng 10, 2026) nêu một trường hợp nên bật: ngay cả khi ANTHROPIC_BASE_URL trỏ đến cổng, Claude Code vẫn gửi yêu cầu nền đến Anthropic, GitHub và các bên thứ ba khác để kiểm tra phiên bản, gửi dữ liệu đo lường, tải ghi chú phát hành, v.v. Nếu mạng của bạn chỉ cho phép truy cập địa chỉ cổng, các yêu cầu này sẽ thất bại và có thể xuất hiện trong giám sát lưu lượng đi dưới dạng kết nối bị chặn; cách làm chính thức là thiết lập biến này cùng với biến cổng.

Cái giá phải trả khi bật là không còn tự động cập nhật; tài liệu chính thức khuyến nghị sắp xếp một phương thức cập nhật khác. Nếu cài đặt bằng npm, hãy nâng cấp thủ công bằng @latest (xem dòng cuối của phần npmmirror ở trên).

# 可选：关闭 Claude Code 的非必要网络流量（会同时关闭自动更新）
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

# 想恢复时删掉这个变量；设成 0 或 false 仍然算开启
unset CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC

Nạp tiền bằng Alipay hoặc WeChat Pay và nhận key

Gói đăng ký trên trang web trực tiếp của Anthropic chỉ chấp nhận 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, đối chiếu với 3 tháng 10, 2026). Khi nạp tiền vào Kunavo, bạn có thể dùng Alipay hoặc WeChat Pay. Tóm tắt các bước như sau; xem hướng dẫn đầy đủ tại hướng dẫn nạp tiền vào Claude API bằng Alipay và WeChat Pay:

1. Đăng ký tài khoản Kunavo bằng email hoặc tài khoản Google; khi đăng ký không cần liên kết thẻ.
2. Trong Thanh toán, chọn số tiền nạp; tối thiểu $10, không có phí hàng tháng. Nạp nhiều sẽ được tặng thêm: nạp $100 nhận được $110, nạp $1000 nhận được $1200 và nạp $5000 nhận được $6250.
3. Trên trang thanh toán Stripe, chọn Alipay hoặc WeChat Pay và quét mã để thanh toán. Khi mở tại Trung Quốc đại lục, số tiền được hiển thị bằng nhân dân tệ; hãy lấy con số trên trang thanh toán làm chuẩn.
4. Vào /app/keys để tạo key bắt đầu bằng sk-kn- (chỉ hiển thị một lần, hãy lưu ngay), rồi điền vào ANTHROPIC_AUTH_TOKEN ở trên.

Alipay và WeChat Pay chỉ hỗ trợ nạp thủ công; nạp tiền tự động chỉ có thể dùng thẻ ngân hàng hoặc Link. Kunavo không phát hành hóa đơn VAT của Trung Quốc; lịch sử nạp tiền có thể xem trên trang Billing.

Chi phí khoảng bao nhiêu (tính minh họa)

Claude Code tính phí theo token; mỗi yêu cầu sẽ gửi lại toàn bộ ngữ cảnh cuộc trò chuyện, trong đó phần tiền tố trùng với lần trước có thể được tính theo mức đọc từ bộ nhớ đệm. Dưới đây chỉ là một phép tính token minh họa, không phải hóa đơn thực tế và cũng không phải giới hạn chi phí. Tất cả giả định đều được liệt kê:

• Mỗi yêu cầu có 40.000 token đầu vào, trong đó 36.000 (90%) được tính theo mức đọc từ bộ nhớ đệm, phần còn lại 4.000 được tính theo mức ghi vào bộ nhớ đệm;
• Mỗi yêu cầu có 1.000 token đầu ra;
• Trong một khoảng thời gian làm việc, gửi 50 yêu cầu như vậy; không tính các lệnh gọi nền của Claude Haiku 4.5;
• Giá Kunavo: đọc từ bộ nhớ đệm bằng 10% giá đầu vào, ghi vào bộ nhớ đệm bằng 1,25 lần giá đầu vào (tỷ lệ của Claude Sonnet 5; trong bảng, mỗi model được tính theo tỷ lệ riêng).

Chi phí thực tế tùy thuộc vào độ dài ngữ cảnh, số lần bộ nhớ đệm được sử dụng, độ dài đầu ra và việc bạn có dùng /clear để xóa cuộc trò chuyện giữa các tác vụ hay không. Để tìm hiểu cách chọn giữa thuê bao Claude Code và API cũng như chi phí ước tính hàng tháng, xem giá Claude Code; xem giá đầy đủ của từng mô hình tại giá API Claude và trang giá; nếu muốn ước tính theo mức sử dụng của mình, hãy dùng công cụ tính chi phí token Claude.

Đối chiếu các lỗi thường gặp

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

• Kunavo không phát hành hóa đơn VAT của Trung Quốc.
• Alipay và WeChat Pay chỉ hỗ trợ nạp thủ công; nạp tiền tự động chỉ có thể dùng thẻ ngân hàng hoặc Link.
• Đây là API tính phí theo token, không phải gói đăng ký Claude Pro/Max; khi dùng API key, Remote Control và tính năng nhập bằng giọng nói không dùng được. Xem giá Claude Code để biết nên chọn phương án nào.
• Kunavo chưa kiểm tra khả năng kết nối mạng từ Trung Quốc đại lục. Bạn cần tự xác nhận các địa chỉ cài đặt claude.ai, nguồn npm, npmmirror và api.kunavo.com có thể truy cập từ mạng của mình hay không và tốc độ ra sao.
• Trong danh sách quốc gia và khu vực được Anthropic hỗ trợ (kiểm tra ngày 3 tháng 10, 2026), không có Trung Quốc đại lục, Hồng Kông và Ma Cao; tài liệu cài đặt chính thức của Claude Code liệt kê khu vực của bạn là một trong các yêu cầu hệ thống.

Sau khi cài đặt, nếu gặp lỗi 403 hoặc nhận được thông báo tài khoản đã bị tạm ngưng, hãy xem Lỗi 403 trong Claude Code.

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