Installer Claude Code — une commande et deux blocages ensuite

L’installation de Claude Code tient en une seule commande ; les vrais blocages arrivent ensuite. La plupart des articles consacrés à l’installation s’arrêtent à « installation terminée », mais en Corée du Sud, deux obstacles supplémentaires se dressent avant l’exécution — les permissions d’installation globale et la connexion et le paiement. Cet article présente les trois étapes dans l’ordre, avec la solution à chaque blocage.

Étape 1 — Installation (une seule commande)

Le seul prérequis est Node.js 18 ou version ultérieure. macOS, Windows (WSL) et Linux utilisent la même commande.

# Node.js 18 이상이 필요합니다. 먼저 확인하세요.
node --version

# 설치
npm install -g @anthropic-ai/claude-code

# 확인 — 버전이 출력되면 설치 자체는 끝난 것입니다
claude --version

claude --versionSi cette version s’affiche, l’installation est terminée. Si le processus s’arrête ici, vous êtes concerné par l’une des deux sections suivantes.

Étape 2 — Erreurs de permissions et de chemin

Voici les deux erreurs les plus fréquentes pendant l’installation.

Ajouter EACCES à sudo n’est pas recommandé. L’installation réussira sur le moment, mais le même problème se répétera à chaque mise à jour et le propriétaire du répertoire global deviendra root, ce qui compliquera davantage la situation. Déplacer le chemin vers le répertoire personnel est plus propre.

# npm 전역 설치에서 EACCES가 나면 sudo를 붙이지 말고
# 전역 경로를 홈 디렉터리로 옮기는 편이 안전합니다.
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global

# 셸 설정에 추가한 뒤 새 터미널을 엽니다
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc

Sous Windows, installez-le dans WSL. Les fichiers du projet doivent également se trouver dans le système de fichiers WSL afin que la surveillance des fichiers et la gestion des chemins fonctionnent correctement.

Étape 3 — Connexion et paiement (le vrai point de blocage en Corée du Sud)

Une fois l’installation terminée, l’exécution de claude demande une connexion. C’est là que le blocage est le plus fréquent en Corée du Sud, et la cause n’a rien à voir avec l’installation.

• Carte dont les paiements internationaux sont bloqués — le paiement de l’abonnement échoue. Autoriser les paiements internationaux dans l’application ou sur le site de l’émetteur résout généralement le problème.
• KakaoPay et Toss — ne sont pas pris en charge pour les paiements Web de claude.ai (ils sont disponibles uniquement comme moyens de paiement en magasin pour les abonnements mobiles). Si vous tentez d’utiliser un moyen de paiement local, vous serez bloqué à cette étape.
• Si vous n’avez aucune carte autorisant les paiements internationaux — vous ne pouvez pas utiliser le parcours d’abonnement web. L’authentification par clé ci-dessous utilise un solde Kunavo rechargé ; lorsque le paiement affiche des wons, KakaoPay, Naver Pay, PAYCO, Samsung Pay et les cartes nationales (dont les paiements internationaux ne sont pas activés) sont proposés comme moyens de paiement, ce qui permet de recharger sans carte autorisant les paiements internationaux (Toss n’est pas pris en charge).

Ce qui fonctionne et ce qui ne fonctionne pas selon le moyen de paiement est récapitulé dans Modes de paiement Claude.

Lorsque le paiement de l’abonnement est bloqué — exécuter avec une clé sans réinstaller

En plus de la connexion par abonnement, Claude Code prend également en charge l’authentification par clé API. Si les deux variables d’environnement ci-dessous sont définies, l’exécution contourne l’écran de connexion ; supprimez-les pour revenir au fonctionnement normal. Aucune réinstallation n’est nécessaire.

# 구독 결제가 막혔을 때 설치한 클로드 코드를 그대로 쓰는 방법.
# 이 두 줄이 있으면 로그인 대신 키로 인증하고, 지우면 원래대로 돌아갑니다.
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...

# 클로드 코드의 기본 모델과 opus·sonnet 별칭은 Anthropic의 최신 모델을 따라가므로,
# Kunavo가 제공하는 모델로 고정해 404를 막습니다. sonnet 별칭은 Kunavo가 제공하지
# 않는 Sonnet 5.5를 요청하므로, 고정하지 않으면 /model sonnet, opusplan의 실행 단계,
# sonnet 서브에이전트가 404로 실패합니다. opus는 Opus 5.5로 고정하며,
# 클로드 코드 v2.1.280 이상이 필요합니다(이전 버전은 claude update).
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

claude

Avec cette méthode, vous payez les tokens réellement utilisés au lieu d’un forfait mensuel ; aucun coût n’est donc généré pendant les mois sans activité. La procédure d’obtention d’une clé est décrite dans Obtenir une clé API Claude, et vous trouverez dans Tarifs de Claude Code lequel de l’abonnement ou du paiement à l’usage revient moins cher.

Première exécution après l’installation — vérification en 3 minutes

Une fois le programme lancé, placez-vous dans le répertoire du projet, lancez claude et exécutez /init une fois. Le dépôt sera lu et CLAUDE.md sera créé ; il sera ensuite lu automatiquement dans toutes les sessions. L’utilisation à partir de là — rédaction des règles, configuration des permissions et commandes personnalisées — est expliquée dans Comment utiliser Claude Code.

Les erreurs qui surviennent après le lancement (401·429·529) ont des causes totalement différentes de celles des erreurs d’installation. La méthode pour les distinguer est présentée séparément dans Guide des erreurs de Claude Code.

Questions fréquentes