Claude Code 설치: Windows, macOS 및 Linux 명령, 구독 없이 API 키 사용 및 MB WAY 결제

Claude Code는 운영 체제별 공식 명령 하나로 설치합니다. macOS, Linux 및 WSL에서는 curl -fsSL https://claude.ai/install.sh | bash, Windows의 PowerShell에서는 irm https://claude.ai/install.ps1 | iex를 사용합니다(CMD인 명령 프롬프트에서는 아래의 install.cmd 명령줄을 사용합니다). 설치 후 사용하는 방법은 두 가지입니다. 구독을 사용하려면 Pro, Max, Team, Enterprise 또는 Console 계정으로 로그인합니다(Claude.ai 무료 요금제만으로는 Claude Code에 액세스할 수 없습니다). 구독 없이 사용하려면 API 키를 사용합니다. ANTHROPIC_BASE_URL(도메인만 입력하고 /v1는 제외), ANTHROPIC_AUTH_TOKEN 및 네 개의 모델 변수를 설정한 뒤 /status로 확인합니다. Kunavo 잔액은 유로 체크아웃에서 MB WAY로 US$ 10부터 월정액 없이 충전할 수 있습니다.

Comandos e variáveis verificados a 2026년 10월 3일 na Claude Code 공식 설치 문서 e na 환경 변수 문서; preços e meios de pagamento verificados a 2026년 10월 3일. Portugal consta da Anthropic 지원 국가 목록 (consultada a 2026년 10월 3일), tanto para o Claude.ai como para a API. Este guia existe também em inglês: Claude Code 설치.

설치 전에

macOS, Linux 및 WSL: 한 줄

터미널에서(macOS에서는 응용 프로그램 › 유틸리티에 있음) 다음을 실행합니다:

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

권장되는 네이티브 설치 방식입니다. 공식 문서에 따르면 백그라운드에서 자동으로 업데이트되는 독립 실행형 프로그램입니다. claude 명령은 ~/.local/bin에 설치됩니다. 이미 열려 있던 터미널은 새 PATH를 아직 인식하지 못하므로 테스트하기 전에 새 창을 여세요. WSL에서는 WSL 터미널 안에서 실행하는 동일한 명령을 사용합니다.

Windows에 설치

Windows에는 두 가지 명령이 있으며, 선택은 열려 있는 창에 따라 달라집니다. 줄이 PS C:\Users\Nome>로 시작하면 PowerShell이고, PS 없이 C:\Users\Nome>만 표시되면 명령 프롬프트(CMD)입니다. “관리자 권한으로 실행”을 사용할 필요가 없습니다. 일부 포르투갈어 가이드의 권장과 달리 공식 문서가 명시적으로 필요하지 않다고 설명합니다.

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

:: Linha de Comandos do Windows (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Windows에서 가장 흔한 문제는 잘못된 창에 명령을 입력하는 것입니다. PowerShell이 The token '&&' is not a valid statement separator로 응답하면 CMD용 명령을 받은 것이고, CMD가 'irm' is not recognized as an internal or external command로 응답하면 PowerShell용 명령을 받은 것입니다. 포르투갈어 Windows에서는 같은 원인으로 두 번째 메시지가 번역되어 표시될 수 있습니다. macOS용 | bash 명령을 PowerShell에 붙여 넣으면 bash을 인식할 수 없다는 오류가 발생합니다. 세 경우 모두 현재 창에 맞는 명령을 사용하면 됩니다.

O Git for Windows é opcional. Com ele, a ferramenta Bash do Claude Code passa a correr no Git Bash, e o PowerShell continua disponível ao lado; sem ele, todos os comandos correm pelo PowerShell. Quando o Git está instalado numa pasta fora do habitual e o Claude Code não dá com o bash.exe, indica-se o caminho em CLAUDE_CODE_GIT_BASH_PATH, dentro do bloco env de ~/.claude/settings.json; o exemplo da documentação é C:\Program Files\Git\bin\bash.exe.

따라서 WSL은 일부 가이드의 설명과 달리 필수 사항이 아니라 선택 사항입니다. WSL을 선택한 경우 macOS/Linux용 명령을 WSL 터미널에서 실행하고 claude도 그 안에서 시작합니다. PowerShell이나 CMD에서 시작하지 않습니다.

Homebrew, WinGet 또는 npm 사용

이 방법도 작동하지만 중요한 차이가 있습니다. 공식 문서에 따르면 Homebrew와 WinGet을 통한 설치는 자동으로 업데이트되지 않습니다. 직접 업데이트해야 합니다. Linux용 서명된 apt, dnf 및 apk 저장소도 있습니다.

# Homebrew
brew install --cask claude-code
brew upgrade claude-code              # não se atualiza sozinho

# WinGet (Windows)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode   # não se atualiza sozinho

npm 패키지에는 Node.js 22 이상이 필요합니다. 일부 가이드에서 여전히 안내하는 Node.js 18이 아닙니다. 이전 버전의 Node.js를 사용하면 npm은 설치에 실패하는 대신 설치 중 EBADENGINE 경고만 표시합니다. sudo npm install -g는 절대 사용하지 마세요. 공식 문서가 명시적으로 권장하지 않습니다. 업데이트하려면 @latest를 사용하고 npm update -g는 사용하지 마세요.

node -v                                           # tem de ser v22 ou posterior
npm install -g @anthropic-ai/claude-code          # nunca com sudo

# para atualizar mais tarde: com @latest, não com npm update -g
npm install -g @anthropic-ai/claude-code@latest

설치 확인

claude --version   # mostra o número da versão, seguido de (Claude Code)
claude doctor      # diagnóstico só de leitura da instalação e das definições, sem abrir sessão

claude doctor는 세션을 시작하지 않고 설치 및 설정 파일의 상태를 표시합니다. 문제가 설치에 있는지 구성에 있는지 파악하는 가장 빠른 방법입니다.

Um command not found: claude (ou, no Windows, a indicação de que claude não é um comando conhecido) quer dizer que o terminal não sabe onde o programa ficou. Muitas vezes basta fechar a janela e abrir outra. Se continuar, falta a pasta no PATH: no macOS e no Linux é ~/.local/bin, a acrescentar no ficheiro de arranque da shell (~/.zshrc ou ~/.bashrc); no Windows é %USERPROFILE%\.local\bin; segundo a 공식 문제 해결 문서, confirma-se e acrescenta-se assim no PowerShell:

# 1. A pasta de instalação já está no PATH?
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Sem resultado? Acrescente-a ao PATH do utilizador e abra uma janela nova
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Na janela nova: dois caminhos significam duas instalações lado a lado
where.exe claude

npm으로 설치한 후 PowerShell이 npm.ps1 cannot be loaded because running scripts is disabled on this system로 응답한다면 PowerShell 실행 정책이 npm 스크립트를 차단하고 있는 것입니다. 네이티브 설치 프로그램을 사용하거나 사용자 계정에 로컬 스크립트를 허용하세요:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Claude Code does not support 32-bit Windows가 표시된다면 “Windows PowerShell (x86)”이 열려 있는 것입니다. Windows에는 두 개의 PowerShell 항목이 있으며 x86 버전은 32비트 프로세스로 실행됩니다. (x86)이 없는 “Windows PowerShell” 항목을 여세요.

첫 사용: 구독 또는 API 키

처음 시작할 때 Claude Code 비용을 지불할 방법을 결정합니다. 방법을 바꾸기 위해 다시 설치할 필요는 없습니다. 키가 설정되어 있는지 여부가 결정합니다.

경로 A — 구독으로 로그인

프로젝트 폴더에서 claude를 실행하고 브라우저에서 로그인합니다. 환경에 이미 ANTHROPIC_API_KEY가 있는 경우 주의하세요. 브라우저를 여는 대신 Claude Code가 해당 키에 대한 한 번의 승인을 요청합니다. 승인을 거부하면 이후 키가 무시되고 질문도 다시 표시되지 않으므로 변수를 읽지 못한 것처럼 보일 수 있습니다. 다시 활성화하려면 /config → Use custom API key로 이동합니다.

경로 B — 구독 없이 API 키 사용

ANTHROPIC_BASE_URL는 Claude Code 자체의 변수로, 프록시 또는 게이트웨이를 통해 요청을 전달하기 위한 것입니다. 따라서 Anthropic Messages API와 호환되는 엔드포인트를 가리키는 것은 플러그인이나 수정된 버전 없이 지원되는 구성입니다. 단계는 다음과 같습니다:

1. Kunavo 계정 만들기.
2. 결제에서 US$ 10부터 잔액을 충전합니다(MB WAY 결제 방법은 아래에 설명되어 있습니다).
3. /app/keys에서 sk-kn-로 시작하는 키를 생성합니다. 키는 한 번만 표시되므로 즉시 저장하는 것이 좋습니다.
4. 변수를 설정합니다. macOS 및 Linux에서는 ~/.zshrc 또는 ~/.bashrc에서 설정합니다:

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # só o domínio, sem /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 창에서 테스트합니다:

# Vale só para esta janela do 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

영구적으로 사용하려면 사용자 설정의 env 블록이 가장 적합합니다: ~/.claude/settings.json(Windows에서는 %USERPROFILE%\.claude\settings.json). 여기의 값은 백그라운드 에이전트를 포함한 모든 프로젝트에 적용됩니다. VS Code 확장은 예외입니다(아래 참조). 셸에서 export한 변수는 해당 셸에서 시작한 프로그램에만 전달됩니다. Dock이나 시작 메뉴에서 연 편집기는 이를 볼 수 없습니다. 파일에 다른 설정이 이미 있다면 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"
  }
}

절대 하지 않음 ponha a chave no .claude/settings.json de um projeto: segundo a 공식 게이트웨이 문서 (consultada a 2026년 10월 3일), esse ficheiro entra nos commits e é partilhado com quem clonar o repositório. E atenção à precedência: quando a shell e um ficheiro de definições definem a mesma variável, prevalece o ficheiro de definições. Se uma alteração na shell não surtir efeito, veja primeiro o settings.json.

VS Code 확장을 사용하는 경우 VS Code 자체의 사용자 설정에서 claudeCode.environmentVariables에 변수를 설정합니다(Preferences: Open User Settings (JSON) 명령). 게이트웨이 문서에 따르면 확장은 시작하기 전에 이 설정에서 자격 증명을 확인합니다. ~/.claude/settings.json의 값은 Claude Code 프로세스에 전달되지만 이 확인에는 사용되지 않습니다:

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.kunavo.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-kn-..." },
    { "name": "ANTHROPIC_MODEL", "value": "claude-sonnet-5" },
    { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "claude-opus-5-5" },
    { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "claude-sonnet-5" },
    { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "claude-haiku-4-5" }
  ]
}

네 가지 모델 변수와 기타 주의 사항

블록의 각 줄에는 주의할 점이 있습니다:

• ANTHROPIC_BASE_URL에는 경로를 포함하지 않습니다. /v1/messages 경로는 Claude Code가 직접 추가합니다. 이미 /v1로 끝나는 주소를 입력하면 /v1/v1/messages가 되어 404를 반환합니다.
• ANTHROPIC_AUTH_TOKEN 또는 ANTHROPIC_API_KEY 중 하나를 사용할 수 있으며 Kunavo는 둘 다 허용합니다. 게이트웨이 문서에 따르면 ANTHROPIC_AUTH_TOKEN는 Authorization: Bearer 헤더로 전달되어 즉시 적용됩니다. ANTHROPIC_API_KEY는 x-api-key 헤더로 전달되며 대화형 모드에서는 적용 전에 한 번 승인해야 합니다(경로 A 참조). 따라서 이 가이드에서는 ANTHROPIC_AUTH_TOKEN를 사용합니다.
• ANTHROPIC_MODEL의 이름은 정확해야 합니다. 여기에 표시된 그대로 복사하세요: claude-sonnet-5.
• ANTHROPIC_DEFAULT_SONNET_MODEL와 ANTHROPIC_DEFAULT_OPUS_MODEL가 없으면 별칭이 자동으로 변경됩니다. Segundo a 모델 구성 문서 (consultada a 2026년 10월 3일), para quem usa a API da Anthropic o alias opus aponta para o Opus 5.5 e o alias sonnet para o Sonnet 5.5, e estes aliases mudam com as novas versões. Fixa-se com o nome completo do modelo ou com variáveis como ANTHROPIC_DEFAULT_OPUS_MODEL. O Kunavo não serve o Sonnet 5.5, e um modelo que não existe devolve 404: sem ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5, falham o /model sonnet, os subagentes com model: sonnet e o passo de execução do opusplan. Já o opus aponta para claude-opus-5-5, que o Kunavo serve, mas só a partir do Claude Code v2.1.280; quem tiver uma versão anterior corre claude update.
• ANTHROPIC_DEFAULT_HAIKU_MODEL도 백그라운드 작업에 적용됩니다. 문서에 따르면 별칭 haiku와 Claude Code 백그라운드 기능의 모델을 설정합니다. Claude Haiku 4.5를 사용하면 이러한 호출은 아래 표에서 가장 저렴한 모델을 사용합니다.

Preços por milhão de tokens, do catálogo do Kunavo; a coluna da Anthropic vem de claude.com/pricing (consultado a 2026년 10월 3일):

세션 내에서는 /model claude-opus-5-5로 모델을 변경하거나 claude --model claude-opus-5-5로 해당 모델을 바로 시작할 수 있습니다. 유로 기준 비용과 월별 사용 예시, 구독이 더 유리해지는 시점은 유로 기준 Claude Code 가격에서 확인할 수 있습니다. 각자의 사용량은 토큰 비용 계산기로 계산할 수 있습니다. 모든 모델과 가격은 가격 페이지에 나와 있습니다.

/status로 확인

claude를 실행합니다. ANTHROPIC_AUTH_TOKEN가 설정되어 있으면 로그인 화면이 표시되지 않습니다. 변수가 즉시 적용되기 때문입니다. 로그인 화면이 표시되면 Claude Code가 키를 읽지 못한 것입니다. 이 경우 첫 시작 도우미보다 먼저 Claude Code가 읽는 위치에 설정하세요. 셸의 export 또는 ~/.claude/settings.json의 env 블록을 사용합니다. 프로젝트의 .claude/settings.json 또는 .claude/settings.local.json에 있는 env 블록은 대화형 세션에서 첫 시작 도우미와 폴더 신뢰 여부 질문이 끝난 후에만 적용됩니다.

Dentro da sessão, escreva /status e procure duas linhas no separador Status (fonte: a 공식 게이트웨이 문서, consultada a 2026년 10월 3일):

• Anthropic base URL에는 https://api.kunavo.com가 표시되어야 합니다. 이 줄은 게이트웨이 주소가 설정된 경우에만 나타납니다. 주소가 없으면 ANTHROPIC_BASE_URL가 세션에 전달되지 않은 것입니다.
• Auth token 줄에는 ANTHROPIC_AUTH_TOKEN가 표시되어야 합니다. 대신 claude.ai 계정과 함께 Login method가 표시되면 변수를 읽지 못해 세션이 구독을 사용하고 있는 것입니다.

구독으로 이미 로그인한 사용자는 시작할 때 두 개의 자격 증명이 활성화되어 있다는 경고를 볼 수 있습니다(메시지는 auth may not work as expected로 끝납니다). 요청은 키를 통해 전송됩니다. /logout는 이전 로그인을 삭제합니다.

Claude Code를 열기 전에 주소와 키를 테스트하려면 문서에서는 출력 토큰 하나만 요청하는 방법을 제안합니다. 잔액의 극히 일부만 사용합니다. 명령은 셸의 변수를 읽으므로, 이미 settings.json에 설정되어 있더라도 여기에도 설정하세요.

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

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

{"id":"msg_로 시작하는 JSON 응답은 주소와 키가 작동한다는 뜻입니다. PowerShell에서는 id가 msg_로 시작하는 형태로 표시됩니다. 401는 키가 인식되지 않았다는 뜻입니다.

API 키를 사용하면 달라지는 점

• Remote Control 및 음성 받아쓰기를 사용할 수 없습니다. 게이트웨이 문서에 따르면 ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN 또는 apiKeyHelper가 활성화되어 있는 동안 사용할 수 없습니다. 또한 ANTHROPIC_BASE_URL가 Anthropic 외부의 주소를 가리키는 동안에는 Remote Control도 비활성화됩니다.
• /fast에는 빠른 모드가 비활성화된 것으로 표시됩니다. bearer token만 사용하면 Claude Code는 빠른 모드를 꺼진 상태로 처리합니다.
• MCP 도구 검색(MCP tool search)은 기본적으로 비활성화됩니다 quando ANTHROPIC_BASE_URL aponta para um endereço fora da Anthropic (환경 변수 문서, consultada a 2026년 10월 3일).
• /context의 수치는 추정치입니다. O Kunavo não serve /v1/messages/count_tokens e, segundo a 게이트웨이 호환성 문서 (consultada a 2026년 10월 3일), sem esse endpoint o Claude Code recorre a uma estimativa baseada em caracteres.

나머지 기능인 코드, 도구, 서브에이전트, MCP 서버, hooks 및 prompt caching은 평소와 같이 작동합니다. 자세한 내용은 Claude Code 통합 문서(영어)와 Claude Code without a subscription(영어)을 참조하세요.

MB WAY로 잔액 결제

Primeiro, a subscrição: uma subscrição Claude comprada no site paga-se só com cartão de crédito ou de débito (유료 요금제에 관한 Anthropic 도움말, consultado a 2026년 10월 3일); numa subscrição feita na aplicação Claude para iOS ou Android, os meios de pagamento são os da App Store ou do Google Play. Os meios de pagamento do Kunavo, MB WAY incluído, não pagam o Claude Pro nem o Max: carregam o saldo da API do Kunavo, que é o que a Rota B usa.

O saldo carrega-se no checkout da Stripe. Os preços estão em dólares americanos; para quem compra em Portugal, a Stripe mostra o valor em euros. Segundo a Adaptive Pricing에 관한 Stripe 문서 (consultada a 2026년 10월 3일), essa conversão inclui uma comissão de 2–4% paga pelo comprador; quem escolhe pagar em dólares (com cartão, Apple Pay, Google Pay ou Link) não paga essa comissão, embora o banco possa aplicar a sua própria taxa de câmbio e comissões. O MB WAY só funciona em euros. No checkout em euros aparecem:

• MB WAY. Escolhe-se MB WAY, introduz-se o número de telemóvel e confirma-se a compra na aplicação MB WAY, através da notificação ou na área de atividade (MB WAY에 관한 Stripe 문서 e 온라인 구매에 관한 MB WAY 문서, consultados a 2026년 10월 3일). Segundo a Stripe, são aceites números internacionais, mas a maioria dos clientes usa um número português, começado por +351.
• 카드(Visa, Mastercard), Apple Pay, Google Pay 및 Link.

Não aparecem: referências Multibanco (pagamento por entidade e referência), PayPal, débito direto SEPA e Klarna, que só aparece a compradores nos Estados Unidos. A conversão para euros vem do Adaptive Pricing da Stripe, e a lista de meios de pagamento que ele disponibiliza inclui o MB WAY mas não o Multibanco. O MB WAY também permite gerar cartões virtuais MB NET para compras online (MB NET에 관한 MB WAY 문서, consultado a 2026년 10월 3일); não está confirmado que o campo do cartão do checkout os aceite, por isso o caminho seguro é escolher MB WAY diretamente.

Stripe가 MB WAY에 대해 문서화한 내용(2026년 10월 3일에서 확인):

• 결제 1건당: 0,50 €~5000 €.
• 하루 기준: 기본값은 1000 €이며 MB WAY 앱에서 최대 10 000 €까지 조정할 수 있습니다. 더 큰 충전은 기본 일일 한도를 초과할 수 있습니다. 이 경우 결제 전에 앱에서 한도를 높이세요. 체크아웃에 표시되는 유로 금액을 이 한도와 비교하세요.
• 반복 결제: 지원되지 않음.
• 명세서에는 거래 금액과 함께 Stripe(Stripe Inc) 이름이 표시됩니다.

1. Kunavo 계정 만들기.
2. 결제에서 US$ 10부터 금액을 선택합니다. 더 큰 충전에는 추가 잔액이 제공됩니다: quem carrega US$ 100 recebe US$ 110; quem carrega US$ 1000 recebe US$ 1200; quem carrega US$ 5000 recebe US$ 6250.
3. Stripe 체크아웃에서 유로 금액으로 MB WAY를 선택하고 휴대전화 번호를 입력한 다음 MB WAY 앱에서 구매를 확인합니다. 유로 금액은 확인 전에 표시됩니다.
4. /app/keys에서 키를 생성하고 ANTHROPIC_AUTH_TOKEN에 입력합니다.

잔액은 선불 방식입니다. 월정액이 없고 잔액은 만료되지 않으며 실패한 요청에는 요금이 부과되지 않습니다. 자동 충전은 저장된 카드나 Link로만 작동합니다. MB WAY는 Stripe에 따르면 반복 결제를 지원하지 않고 향후 결제를 위해 저장되지 않으므로 항상 수동으로 충전해야 합니다. Kunavo는 NIF나 VAT가 포함된 청구서도 발행하지 않습니다. 충전 내역은 Billing에 표시됩니다. 이러한 결제 수단은 Kunavo API 잔액만 충전합니다. 자세한 내용은 MB WAY로 Claude 결제를 참조하세요.

일반적인 오류

설치 후

프로젝트에서 처음 시작할 때 /init를 입력합니다. Claude Code가 저장소를 살펴보고 프로젝트 실행 방법, 변경 사항 테스트 방법, 적용되는 스타일 규칙 등 추론한 내용을 CLAUDE.md에 기록합니다. 이 파일을 검토하고 짧게 유지하세요. 모든 세션에서 로드되기 때문입니다. 서로 독립적인 작업 사이에서는 /clear가 새 대화를 시작합니다. 긴 작업에서는 /compact가 기록을 요약하여 계속 진행합니다.

알아두면 좋은 사항

• 토큰당 과금되는 유료 API이며 Claude Pro 또는 Max 구독이 아닙니다. Claude Code를 매일 여러 시간 사용하는 사람은 일반적으로 구독을 이용하는 편이 더 저렴합니다. 사용량이 불규칙하다면 토큰당 결제가 유리하며, 사용하지 않는 달에는 비용이 들지 않습니다. 유로 기준 비교는 유로 기준 Claude Code 가격에서 확인할 수 있습니다.
• API 키를 사용하는 경우 Remote Control과 음성 받아쓰기를 사용할 수 없습니다.
• Kunavo에서는 공유 용량을 사용하므로 예약된 할당량이나 계약상 보장이 없습니다. 이러한 보장이 필요한 경우 Anthropic과 직접 계약해야 합니다.
• MB WAY는 수동 충전에만 사용할 수 있으며, 자동 충전에는 카드 또는 Link가 필요합니다.
• 결제 화면에 표시되는 유로 금액에는 Stripe의 환전 수수료가 이미 포함되어 있습니다.

자주 묻는 질문