Claude Code 설치 튜토리얼: Windows 및 macOS 설치 명령, 로그인 없이 API key 구성, Alipay 및 WeChat Pay 충전

Claude Code는 Anthropic 공식 네이티브 설치 명령으로 설치하는 것을 권장합니다. npm은 공식 대체 경로이며 Node.js 22 이상이 필요합니다. Claude 계정에 로그인하지 않아도 Claude Code를 사용할 수 있습니다. ANTHROPIC_BASE_URL(도메인까지만 작성하고 /v1는 추가하지 않음), ANTHROPIC_AUTH_TOKEN 및 네 가지 모델 고정 변수를 설정하면 token 기준으로 과금되는 API key를 사용할 수 있습니다. Kunavo API 잔액은 Alipay 또는 WeChat Pay로 충전할 수 있으며 최소 충전 금액은 $10입니다. 마지막으로 Claude Code에서 /status를 실행하여 연결을 확인하세요.

# 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

命令和环境变量核对于 2026년 10월 3일，依据 Claude Code 공식 설치 문서和 공식 환경 변수 문서；价格和付款方式核对于 2026년 10월 3일。先说明一个事实：Anthropic 지원 국가 및 지역 목록（核对于 2026년 10월 3일）中没有中国大陆、香港和澳门，Claude Code 安装文档的系统要求里也有一行「所在地区：Anthropic 支持的国家」。本页只讲官方文档写明的安装和配置方法，不提供任何绕过地区限制的办法。Kunavo 没有在中国大陆做过网络连通性测试，下面提到的下载地址、npm 源和 api.kunavo.com 能否在你的网络里访问，需要你自己确认。

설치 전 확인

방법 1: 공식 네이티브 설치(권장)

공식 설치 문서는 네이티브 설치를 권장 방법으로 표시합니다. 명령은 이 페이지 앞부분의 세 가지입니다. macOS, Linux 및 WSL은 install.sh 줄, Windows PowerShell은 irm … | iex, Windows CMD는 install.cmd 줄을 사용합니다. 네이티브 설치는 백그라운드에서 최신 버전으로 자동 업데이트됩니다. 공식 문서에는 Homebrew 및 WinGet 설치가 기본적으로 자동 업데이트되지 않는다고도 명시되어 있습니다.

설치 후 새 터미널 창을 여세요(이미 열려 있는 창에서는 새 PATH를 읽지 못함). 그런 다음 확인합니다:

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

claude doctor는 세션을 시작하지 않고 설치 상태와 설정 파일의 진단 정보만 출력하므로 ‘설치가 잘못된 것인지’와 ‘설정이 잘못된 것인지’를 구분하는 데 사용할 수 있습니다.

다운로드 오류가 발생할 때

如果终端里出现 syntax error near unexpected token '<' 或 curl: (22) The requested URL returned error: 403，按 공식 설치 문제 해결 문서（核对于 2026년 10월 3일）的说法，这表示安装地址返回的是一个网页或错误状态码，而不是安装脚本。如果返回的网页写着 App unavailable in region，官方的解释是：Claude Code 在你所在的国家或地区不可用。不带网页内容的 403 也可能来自公司代理或防火墙拦截下载；官方建议，在支持地区内仍然遇到 403 时，先排查网络连接，再考虑其他安装方式。

방법 2: npm 설치(Node.js 22 이상 필요)

npm 仍是官方文档列出的安装方式。官方文档写明 npm 包需要 Node.js 22 或更高版本；版本较旧时 npm 会打印 EBADENGINE 警告但不会失败，安装照样完成，因为这个包下载的是一个运行时不依赖 Node.js 的原生程序。没有 Node.js 的话，从 Node.js 공식 웹사이트安装 22 或更高版本。

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

공식 문서는 sudo npm install -g를 사용하지 말라고 명확히 안내하며, 권한 문제와 보안 위험이 발생할 수 있습니다. 업데이트할 때는 npm install -g @anthropic-ai/claude-code@latest를 사용하고 npm update -g는 사용하지 마세요.

기본 소스 다운로드가 실패하거나 매우 느릴 때: npmmirror

如果从 npm 默认源下载失败或很慢，可以改用 npmmirror。npmmirror 홈페이지（核对于 2026년 10월 3일）说明它是「完整 npmjs.com 镜像」，只读，会「尽量与官方服务实时同步」，并给出了 registry 地址和设置命令。首页没有写明具体同步频率。

# 只在这一次安装时使用 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

미러로 Claude Code를 설치할 때 공식 문제 해결 문서에 근거해 놓치기 쉬운 조건이 두 가지 있습니다:

• 미러는 8개 플랫폼 패키지를 모두 제공해야 합니다. npm 패키지 자체는 외피일 뿐이며 실제 프로그램은 @anthropic-ai/claude-code-* 플랫폼 패키지로 선택적 종속성 형태로 다운로드됩니다. 미러에 플랫폼 패키지가 없으면 설치 후 macOS 또는 Linux에서 claude를 실행할 때 claude native binary not installed가 표시됩니다(Windows에서는 PowerShell 또는 CMD가 이 파일을 실행할 수 없다고 보고함). 2026년 10월 3일 Kunavo가 중국 본토 외부 네트워크에서 확인한 결과, npmmirror의 주 패키지와 Windows x64, macOS ARM64, Linux x64 플랫폼 패키지는 npmjs 최신 버전과 일치했습니다. 나머지 플랫폼 패키지(ARM64 Windows, Intel Mac, ARM64 Linux 및 두 가지 musl 버전)는 확인하지 않았습니다.
• 선택적 종속성을 건너뛰면 안 됩니다. 설치 명령에 --omit=optional를 포함하지 말고, .npmrc에 optional=false가 설정되어 있지 않은지도 확인하세요.

Windows 전용

Windows에는 서로 다른 설치 명령이 두 가지 있으며, 차이는 어떤 터미널을 열었는지뿐입니다. 프롬프트가 PS C:\Users\你的用户名>인 것은 PowerShell이고, PS 없이 C:\Users\你的用户名>만 있는 것은 명령 프롬프트(CMD)입니다. 공식 문서에 따르면 설치에 관리자 권한이 필요하지 않습니다.

Windows에서 흔히 발생하는 오류는 잘못된 터미널의 명령을 붙여 넣는 것입니다. PowerShell에서 CMD 줄을 실행하면 The token '&&' is not a valid statement separator가 표시되고, CMD에서 PowerShell 줄을 실행하면 'irm' is not recognized as an internal or external command이 표시됩니다. 두 경우 모두 해당 터미널에 맞는 줄로 바꾸면 됩니다. 또한 시작 메뉴에는 ‘Windows PowerShell’과 ‘Windows PowerShell (x86)’이라는 두 항목이 있습니다. 후자는 32비트 프로세스이므로 Claude Code does not support 32-bit Windows가 표시됩니다. (x86)이 붙지 않은 항목을 여세요.

Git for Windows 是可选的：装了以后 Claude Code 用它附带的 Git Bash 执行命令；没装时改用 PowerShell 工具执行。装了却找不到 Git Bash 时，在 ~/.claude/settings.json 的 env 里设置 CLAUDE_CODE_GIT_BASH_PATH，指向 bash.exe，官方示例路径是 C:\Program Files\Git\bin\bash.exe。

WSL을 선택했다면 WSL 터미널에서 macOS/Linux 줄을 실행하고 claude도 WSL에서 시작해야 하며, PowerShell이나 CMD에서 실행하면 안 됩니다.

npm 경로에서 실행 정책 오류

PowerShell에서 npm으로 설치하거나 실행할 때 npm.ps1 cannot be loaded because running scripts is disabled on this system가 표시되면 PowerShell 실행 정책이 npm이 생성한 .ps1 시작 스크립트를 차단한 것입니다. 공식 해결 방법은 세 가지입니다. 현재 사용자가 로컬 스크립트를 실행하도록 허용하는 아래 줄을 실행하거나, npm.cmd 및 claude.cmd를 사용하거나, PowerShell 네이티브 설치 명령으로 바꾸세요.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

설치 후 claude를 찾을 수 없다는 메시지가 표시될 때

command not found: claude 또는 'claude' is not recognized가 표시되면 설치 디렉터리가 PATH에 포함되어 있지 않다는 뜻입니다. 네이티브 설치 시 프로그램은 macOS／Linux에서는 ~/.local/bin/claude에, Windows에서는 %USERPROFILE%\.local\bin\claude.exe에 저장됩니다. 먼저 새 터미널을 열고 다시 시도하세요. Windows에서 여전히 작동하지 않으면 공식 문제 해결 문서에 따라 PowerShell로 확인하고 사용자 PATH에 추가하세요:

# 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

API key 구성: Claude 계정에 로그인하지 않기

ANTHROPIC_BASE_URL는 Claude Code에 기본 제공되는 환경 변수입니다. 공식 문서는 이를 API 엔드포인트를 재정의하여 요청을 프록시 또는 게이트웨이를 거치게 하는 변수로 설명합니다. 따라서 Claude Code를 Anthropic Messages API를 제공하는 엔드포인트로 지정하는 것은 공식 지원 구성 방식이며 플러그인이나 수정된 프로그램이 필요하지 않습니다. macOS/Linux에서는 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

Windows에서 먼저 PowerShell 창 하나로 테스트하려면:

# 只对当前 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

장기간 사용하려면 사용자 수준 설정 파일 ~/.claude/settings.json의 env에 작성하는 것이 좋습니다(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"
  }
}

이 여섯 줄에는 각각 잘못 설정하기 쉬운 부분이 하나씩 있습니다:

• ANTHROPIC_BASE_URL는 도메인까지만 작성합니다. Claude Code가 /v1/messages를 자동으로 추가합니다. /v1를 추가로 작성하면 /v1/v1/messages가 되어 404가 반환됩니다.
• ANTHROPIC_AUTH_TOKEN를 사용하고 ANTHROPIC_API_KEY는 사용하지 마세요. 공식 문서에 따르면 ANTHROPIC_AUTH_TOKEN의 값은 Authorization 헤더로 전송되고 Bearer 접두사가 자동으로 추가되며, 설정 즉시 적용됩니다. 반면 ANTHROPIC_API_KEY은 대화형 모드에서 한 번 확인해야 합니다. 확인할 때 거부하면 이후 이 key는 조용히 무시됩니다(/config의 Use custom API key에서 다시 활성화해야 함).
• ANTHROPIC_MODEL가 주 모델을 결정합니다. 여기서는 Claude Sonnet 5(claude-sonnet-5)로 고정합니다. 모델명은 Kunavo 모델 목록과 완전히 일치해야 하며 날짜 접미사가 붙은 이전 이름은 자동으로 매핑되지 않습니다.
• ANTHROPIC_DEFAULT_OPUS_MODEL가 opus 별칭을 결정합니다.按 공식 모델 구성 문서（核对于 2026년 10월 3일），API 用户的默认模型和 opus 别名指向最新的 Opus（目前是 Opus 5.5），sonnet 别名指向 Sonnet 5.5，而且别名会跟着 Anthropic 的新版本移动。官方文档写明别名「会随时间更新」，要固定版本，就写完整模型名或设置 ANTHROPIC_DEFAULT_OPUS_MODEL 这类变量。Kunavo 目前没有提供 Sonnet 5.5，Anthropic 以后发布新 Opus 时 Kunavo 也不一定已经上架，没上架的模型会返回 404。这就是要把主模型、opus 和 sonnet 别名都固定下来的原因。这里 opus 别名固定为 Claude Opus 5.5（claude-opus-5-5），需要 Claude Code v2.1.280 或更高版本，旧版本先运行 claude update 升级。
• ANTHROPIC_DEFAULT_SONNET_MODEL가 sonnet 별칭을 결정합니다. 공식 문서에 따르면 이 변수는 sonnet 별칭이 가리키는 모델과 계획 모드 외부(실행 단계)에서 opusplan가 사용할 모델을 결정합니다. sonnet 별칭은 기본적으로 Sonnet 5.5를 요청하지만 Kunavo는 현재 이를 제공하지 않습니다. 따라서 이 줄을 설정하지 않으면 /model sonnet, opusplan의 실행 단계 및 model: sonnet을 지정한 하위 에이전트가 모두 404를 반환합니다. 여기서도 Claude Sonnet 5(claude-sonnet-5)로 고정합니다.
• ANTHROPIC_DEFAULT_HAIKU_MODEL도 백그라운드 작업을 관리합니다. 공식 문서에 따르면 이 변수는 haiku 별칭을 결정하며 백그라운드 기능에도 사용됩니다. Claude Haiku 4.5의 Kunavo 가격은 100만 token당 입력 $0.70, 출력 $3.50입니다. 주 모델 Claude Sonnet 5은 $1.40 / $7.00(Anthropic 공식 가격 $2.00 / $10.00)이고, opus 별칭의 Claude Opus 5.5은 $2.80 / $14.00입니다.

key를 프로젝트의 .claude/settings.json에 작성하지 마세요. 공식 문서는 이 파일이 커밋되어 복제된 저장소의 모든 사용자와 공유된다고 경고합니다. 또한 우선순위 규칙이 있습니다. shell과 settings 파일에서 같은 변수를 동시에 설정하면 settings 파일의 값이 우선합니다. shell 변수를 변경했는데 적용되지 않으면 먼저 settings 파일을 확인하세요.

처음 실행하면 어떤 일이 발생하나요?

按官方的 게이트웨이 연결 문서（核对于 2026년 10월 3일），设置了 ANTHROPIC_AUTH_TOKEN 后运行 claude，会直接进入会话，로그인 페이지가 표시되지 않음；这个变量立即生效，不像 ANTHROPIC_API_KEY 那样要先确认一次。如果打开后看到的是登录页，说明 Claude Code 没有读到凭据。

자격 증명은 Claude Code가 최초 설정 전에 읽는 위치에 두어야 합니다. shell의 export 또는 사용자 수준 ~/.claude/settings.json의 env입니다. 공식 문서에 따르면 대화형 모드에서 프로젝트의 .claude/settings.json 또는 .claude/settings.local.json에 있는 env는 최초 설정 마법사와 폴더 신뢰 안내 이후에야 적용됩니다. 따라서 key를 프로젝트 수준 설정에 작성하면 처음 시작할 때 여전히 로그인 페이지가 표시됩니다.

세션에 들어간 후 /status를 실행하고 Status 페이지에서 두 줄을 확인합니다:

• Anthropic base URL: 게이트웨이 주소가 설정된 경우에만 표시되며 https://api.kunavo.com로 나타나야 합니다. 이 줄이 없으면 ANTHROPIC_BASE_URL가 이 세션에 전달되지 않은 것입니다.
• Auth token: ANTHROPIC_AUTH_TOKEN이라고 표시되면 저장된 claude.ai 로그인 대신 API key를 사용 중인 것입니다. Login method와 claude.ai 계정이 표시되면 변수가 적용되지 않은 것입니다.

Claude Code를 열기 전에 주소와 key를 별도로 테스트하려면 공식 문서의 방법으로 출력 token이 1개만 필요한 요청을 보낼 수 있습니다(token에 따라 매우 적은 잔액이 차감됨). 이 명령은 shell 변수를 읽으므로 key를 settings 파일에 작성했더라도 현재 터미널에서 먼저 export를 실행해야 합니다. {"id":"msg_로 시작하는 JSON이 반환되면 주소와 key가 모두 정상이고, 401가 반환되면 key를 인식하지 못한 것입니다.

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

API key를 사용할 때 달라지는 점

• Remote Control과 음성 입력은 사용할 수 없습니다. 공식 문서에 따르면 이 두 기능은 claude.ai 인증에 의존하므로 ANTHROPIC_AUTH_TOKEN을 설정하면 사용할 수 없습니다. ANTHROPIC_BASE_URL가 Anthropic이 아닌 주소를 가리키면 Remote Control도 비활성화됩니다.
• /fast에는 fast 모드가 꺼졌다고 표시됩니다. 공식 문서에 따르면 bearer token만 있는 경우 Claude Code는 fast 모드를 직접 꺼진 상태로 처리하고 사용 가능성 확인을 보내지 않습니다.
• MCP 도구 검색은 기본적으로 꺼져 있습니다. 공식 문서에 따르면 ANTHROPIC_BASE_URL가 Anthropic이 아닌 주소를 가리킬 때 MCP tool search는 기본적으로 비활성화됩니다.
• /context의 숫자는 로컬 추정치입니다.Kunavo 目前不提供 /v1/messages/count_tokens。按 공식 게이트웨이 호환성 문서（核对于 2026년 10월 3일），网关没有这个端点时，Claude Code 改用按字符估算，/context 显示的是近似值。

전체 연결 방법은 Claude Code 연결 문서(영문)를 참조하세요.

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC이 정확히 차단하는 것

按 공식 환경 변수 문서（核对于 2026년 10월 3일），它的作用是关闭 Claude Code 的非必要网络流量，官方列出的内容是：

• 자동 업데이트, 텔레메트리, 오류 보고;
• /feedback 명령과 Claude가 작성한 피드백;
• 릴리스 노트, PR/MR 상태 배지 확인;
• fast 모드 등의 사용 가능성 확인;
• 기능 플래그(feature flag) 가져오기. 따라서 Remote Control 및 기능 플래그에 의존하는 기타 기능을 사용할 수 없음;
• 플러그인 command 소스의 백그라운드 재실행(의존성 설치를 유발할 수 있는 로컬 명령이며 네트워크 트래픽은 아님).

공식 문서에 명시된 세부 사항이 더 있습니다. 0 또는 false로 설정해도 활성화로 간주되며 대부분의 스위치 변수와 달리 변수를 삭제해야만 복구됩니다. 공식 플러그인 마켓의 자동 설치는 이 변수의 범위에 포함되지 않으며 게이트웨이 모델 탐색에도 영향을 주지 않습니다. 공식 게이트웨이 문서는 WebFetch 도구의 도메인 보안 검사에도 영향을 주지 않는다고 덧붙입니다. 이 검사는 계속 api.anthropic.com에 접속하며, 끄려면 설정에 skipWebFetchPreflight: true를 별도로 추가해야 합니다. 공식 문서는 이 변수를 계정 위험 관리와 관련된 설정으로 설명하지 않습니다.

Kunavo 不要求设置它，它也不影响发往 Kunavo 的模型请求。什么时候值得开启，官方 게이트웨이 연결 문서（核对于 2026년 10월 3일）给了一个场景：即使 ANTHROPIC_BASE_URL 指向网关，Claude Code 仍会向 Anthropic 和 GitHub 等第三方发送版本检查、遥测、发布说明之类的后台请求；如果你的网络只允许访问网关地址，这些请求会失败，并可能在出站监控里显示为被拦截的连接，官方的做法就是和网关变量一起设置这个变量。

활성화하면 더 이상 자동 업데이트되지 않는 것이 대가입니다. 공식 문서는 별도의 업데이트 경로를 마련할 것을 권장합니다. npm 설치라면 @latest로 수동 업그레이드하세요(위 npmmirror 부분의 마지막 줄 참조).

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

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

Alipay 또는 WeChat Pay로 충전하여 key 받기

Anthropic 官方的网页订阅只收信用卡或借记卡（Claude 유료 요금제 청구 FAQ，核对于 2026년 10월 3일）。在 Kunavo 充值可以用支付宝或微信支付，步骤概要如下，完整步骤见 Claude API Alipay·WeChat Pay 충전 안내：

1. Kunavo 계정을 등록하세요. 이메일 또는 Google 계정을 사용할 수 있으며 등록 시 카드 연결은 필요하지 않습니다.
2. 결제에서 충전 금액을 선택합니다. 최소 $10이며 월 요금은 없습니다. 많이 충전하면 보너스가 제공됩니다: 充 $100 到账 $110、充 $1000 到账 $1200、充 $5000 到账 $6250.
3. Stripe 결제 페이지에서 Alipay 또는 WeChat Pay를 선택하고 QR 코드를 스캔하여 결제합니다. 중국 본토에서 열면 금액은 위안화로 표시되며 결제 페이지의 숫자를 기준으로 합니다.
4. /app/keys에서 sk-kn-로 시작하는 key를 생성하세요(한 번만 표시되므로 즉시 저장). 그런 다음 위의 ANTHROPIC_AUTH_TOKEN에 입력합니다.

Alipay와 WeChat Pay는 수동 충전만 가능합니다. 자동 충전은 은행 카드 또는 Link만 연결할 수 있습니다. Kunavo는 중국 부가가치세 세금계산서를 발행하지 않으며 충전 기록은 Billing 페이지에서 확인할 수 있습니다.

대략적인 비용(예시 계산)

Claude Code는 token 기준으로 과금되며, 각 요청마다 대화 컨텍스트가 다시 전송됩니다. 이전 요청과 동일한 접두사는 캐시 읽기 요금으로 계산할 수 있습니다. 아래는 예시적인 token 산술일 뿐 실제 청구서나 비용 상한이 아닙니다. 가정 조건은 모두 다음과 같습니다:

• 각 요청의 입력은 40,000 token이며, 그중 36,000(90%)는 캐시 읽기 요금으로, 나머지 4,000는 캐시 쓰기 요금으로 계산합니다;
• 각 요청의 출력은 1,000 token입니다;
• 작업 시간 동안 이러한 요청을 50회 보냅니다. Claude Haiku 4.5의 백그라운드 호출은 계산하지 않습니다;
• Kunavo 가격: 캐시 읽기는 입력 가격의 10%, 캐시 쓰기는 입력 가격의 1.25배입니다(Claude Sonnet 5의 비율이며 표의 각 모델은 자체 비율로 계산).

실제 비용은 컨텍스트 길이, 캐시 적중량, 출력 길이, 그리고 작업 사이에 /clear를 사용하여 대화를 지우는지에 따라 달라집니다. Claude Code 구독과 API 중 무엇을 선택할지 및 한 달 예상 비용은 Claude Code 가격을, 각 모델의 전체 가격은 Claude API 가격과 가격 페이지를 참조하세요. 자신의 사용량으로 추정하려면 Claude token 비용 계산기(영문)를 사용할 수 있습니다.

일반 오류 비교

알아야 할 제한 사항

• Kunavo는 중국 부가가치세 세금계산서를 발행하지 않습니다.
• Alipay와 WeChat Pay는 수동 충전만 가능합니다. 자동 충전은 은행 카드 또는 Link만 연결할 수 있습니다.
• 이는 Claude Pro/Max 구독이 아니라 token 기준으로 과금되는 API입니다. API key 사용 시 Remote Control과 음성 입력은 사용할 수 없습니다. 두 방식 중 선택하는 방법은 Claude Code 가격을 참조하세요.
• Kunavo는 중국 본토에서 네트워크 연결성 테스트를 수행하지 않았습니다. claude.ai 설치 주소, npm 소스, npmmirror 및 api.kunavo.com에 사용 중인 네트워크로 접속할 수 있는지와 속도는 직접 확인해야 합니다.
• Anthropic 지원 국가 및 지역 목록(2026년 10월 3일 확인)에는 중국 본토, 홍콩 및 마카오가 없으며, Claude Code 공식 설치 문서는 지역을 시스템 요구 사항 중 하나로 명시합니다.

자주 묻는 질문