Comment installer Claude Code : commandes officielles pour Windows, macOS et Linux, clé API sans abonnement, vérification avec /status et paiement par carte ou Link

En résumé : installez Claude Code avec une seule commande officielle (choisissez ci-dessous la ligne pour macOS/Linux, PowerShell ou CMD), puis connectez-le à une clé API au lieu de vous connecter. Il suffit de six variables : ANTHROPIC_BASE_URL=https://api.kunavo.com (sans /v1), ANTHROPIC_AUTH_TOKEN contenant la clé et quatre variables qui verrouillent les modèles. Vérifiez le résultat avec /status. Aucun abonnement Pro ou Max n’est nécessaire ; vous payez les tokens depuis un solde prépayé à partir de $10, alimenté par carte (Visa, Mastercard, etc.) ou Link. QRIS, GoPay, OVO et DANA ne sont pas disponibles.

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

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

:: Windows Command Prompt (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Semua perintah dan nama variabel di sini kami samakan dengan dokumentasi resmi Claude Code pada 3 octobre 2026. Dokumentasi itu sudah ada dalam bahasa Indonesia, termasuk page d’installation dan page de connexion à la passerelle LLM, jadi Anda bisa mencocokkan sendiri. Harga dan metode pembayaran Kunavo dicek 3 octobre 2026.

Six étapes pour partir de zéro et faire fonctionner Claude Code

1. Vérifiez que l’ordinateur portable répond aux exigences et choisissez : connexion avec un compte Claude ou clé API.
2. Exécutez l’installateur natif correspondant à votre terminal.
3. Ouvrez un nouveau terminal, vérifiez claude --version et corrigez PATH si nécessaire.
4. Installez la clé API et verrouillez les modèles.
5. Ouvrez la première session et vérifiez avec /status que votre clé est utilisée.
6. Ajoutez des fonds par carte ou avec Link, puis commencez à travailler.

Étape 1 : vérifier les exigences, puis choisir la connexion ou la clé API

Setelah terinstal, Claude Code harus tahu siapa yang membayar. Jalan pertama adalah login akun Claude, yang mensyaratkan paket Pro, Max, Team, Enterprise, atau akun Console; paket gratis Claude.ai tidak mencakup Claude Code. Menurut page des tarifs de Claude (dicek 3 octobre 2026), Pro berharga $20 per bulan, atau $17 per bulan kalau dibayar tahunan ($200 di muka), Max mulai $100 per bulan, dan semua harga belum termasuk pajak. Untuk langganan yang dibeli lewat web, Anthropic hanya menerima kartu kredit atau debit; langganan dari aplikasi iOS atau Android dibayar lewat App Store atau Google Play (FAQ de facturation de Claude, dicek 3 octobre 2026). Cara login dijelaskan di page officielle d’authentification.

La deuxième voie, détaillée dans ce guide, est la clé API : sans abonnement et sans écran de connexion. Vous payez par token réellement utilisé ; les coûts restent donc faibles pendant les mois peu actifs. Les deux seules fonctions absentes sont celles liées au compte claude.ai : Remote Control et la dictée vocale ; la liste complète des différences figure à l’étape 5.

Baru pertama kali membuka terminal? Anthropic menyediakan guide du terminal en indonésien untuk pemula.

Étape 2 : exécuter l’installateur

macOS, Linux et WSL

Collez la ligne install.sh au début de la page dans Terminal, appuyez sur Entrée et attendez la fin. Le script est récupéré directement depuis claude.ai, installe le programme dans ~/.local/bin/claude et, à partir de là, Claude Code se met à jour automatiquement en arrière-plan. Dans la documentation officielle, cette méthode est étiquetée « Recommandée ».

Windows : identifiez d’abord votre terminal

De nombreux anciens tutoriels recommandent d’ouvrir PowerShell avec « Run as Administrator » et d’installer WSL au préalable. Ni l’un ni l’autre n’est nécessaire : la documentation officielle en indonésien indique que l’installation sous Windows s’effectue depuis un terminal standard sans droits d’administrateur, et que WSL est facultatif. La commande à utiliser dépend de l’apparence de l’invite :

• L’invite PS C:\Users\NamaAnda> indique PowerShell. Utilisez la ligne irm … | iex.
• L’invite C:\Users\NamaAnda> sans PS indique l’invite de commandes (CMD). Utilisez la ligne install.cmd.
• Dans le menu Démarrer, sélectionnez « Windows PowerShell », et non « Windows PowerShell (x86) ». La version x86 fonctionne en 32 bits et se termine par Claude Code does not support 32-bit Windows, même si l’ordinateur est en 64 bits.

Une commande destinée au mauvais terminal est immédiatement identifiable à son message, par exemple The token '&&' is not a valid statement separator (ligne CMD dans PowerShell) ou 'irm' is not recognized as an internal or external command (ligne PowerShell dans CMD). Dans un Windows en indonésien, le message peut apparaître traduit. La liste complète se trouve dans le tableau des erreurs ci-dessous.

Git tidak wajib. Kalau Git for Windows terpasang, tool Bash Claude Code memakai Git Bash; kalau tidak, perintah dijalankan lewat PowerShell. Bila Git sudah ada tetapi Git Bash tidak ditemukan, isi CLAUDE_CODE_GIT_BASH_PATH di blok env ~/.claude/settings.json dengan lokasi bash.exe, misalnya C:\Program Files\Git\bin\bash.exe. Kapan WSL layak dipakai:

Vous choisissez WSL ? Exécutez la ligne install.sh dans le terminal WSL et ouvrez toujours claude depuis ce même terminal WSL.

Alternatives : Homebrew, WinGet ou npm

Homebrew et WinGet sont également officiels, mais selon la documentation, aucun des deux ne se met automatiquement à jour par défaut. Vous devez les mettre à jour vous-même :

# macOS lewat Homebrew (tidak update otomatis; perbarui dengan brew upgrade)
brew install --cask claude-code

# Windows lewat WinGet (tidak update otomatis; perbarui dengan winget upgrade)
winget install Anthropic.ClaudeCode

npm masih didokumentasikan, dengan syarat Node.js 22 ou ultérieur (unduh dari nodejs.org). Di Node.js lama npm hanya memberi peringatan EBADENGINE dan tetap memasang, karena paket ini sebenarnya mengunduh program native yang tidak bergantung pada Node.js saat berjalan.

node -v                                    # harus v22 ke atas
npm install -g @anthropic-ai/claude-code   # jangan pakai sudo

# memperbarui ke versi terbaru
npm install -g @anthropic-ai/claude-code@latest

Trois habitudes rendent une installation npm défaillante : utiliser sudo npm install -g (la documentation le présente comme une source de problèmes de permissions et de risques de sécurité), mettre à jour avec npm update -g au lieu de @latest, et désactiver les dépendances facultatives via --omit=optional ou optional=false dans .npmrc. Ce dernier point empêche le téléchargement du paquet @anthropic-ai/claude-code-* pour votre plateforme ; ainsi, sous macOS ou Linux, claude répond claude native binary not installed.

Dans PowerShell, npm se bloque parfois sur npm.ps1 cannot be loaded because running scripts is disabled on this system. Il s’agit de la stratégie d’exécution qui bloque les scripts .ps1. La documentation propose trois solutions : autoriser les scripts locaux pour votre utilisateur avec la commande ci-dessous, appeler npm.cmd et claude.cmd, ou abandonner npm et utiliser l’installateur natif.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Encore un avertissement : ignorez les installateurs .exe tiers diffusés dans les tutoriels, surtout ceux qui demandent des droits d’administrateur. Les commandes officielles ci-dessus suffisent.

Étape 3 : vérifier que Claude Code est installé

Fermez le terminal dans lequel vous avez installé le programme et ouvrez-en un nouveau. L’ancienne fenêtre utilise encore PATH d’avant l’installation ; claude y est donc souvent encore inconnu. Dans le nouveau terminal :

claude --version   # muncul nomor versi = instalasi berhasil
claude doctor      # cek instalasi dan file pengaturan tanpa membuka sesi

claude doctor permet de distinguer deux types de problèmes : si son rapport est propre mais que Claude Code ne se connecte toujours pas, le problème vient de la configuration (étape 4), et non de l’installation.

Toujours command not found: claude ou 'claude' is not recognized ? Le dossier d’installation n’est pas encore dans PATH. Sur macOS et Linux, ce dossier est ~/.local/bin, sous Windows %USERPROFILE%\.local\bin. Sous Windows, la documentation fournit la commande PowerShell suivante :

# Ada hasilnya? Berarti PATH sudah benar, cukup buka terminal baru.
$env:PATH -split ';' | Select-String '\.local\\bin'

# Tidak ada hasil? Tambahkan folder instalasi ke PATH user:
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# Tutup PowerShell, buka lagi, lalu:
claude --version

Kalau unduhan sudah gagal sejak awal, perhatikan pesannya. Menurut page de dépannage de l’installation (dicek 3 octobre 2026), syntax error near unexpected token '<' atau curl: (22) The requested URL returned error: 403 berarti yang terunduh adalah halaman HTML atau kode error, bukan skrip. Tulisan App unavailable in region berarti koneksi Anda terlihat berasal dari negara yang tidak didukung; karena Indonesia didukung, tersangka utamanya VPN atau proxy. 403 tanpa isi juga sering datang dari proxy kantor atau firewall kampus. Homebrew, WinGet, dan npm mengambil dari host yang sama, jadi coba jaringan lain atau minta admin jaringan membuka aksesnya sebelum berganti metode.

Étape 4 : configurer la clé API sans abonnement

Claude Code possède une variable intégrée ANTHROPIC_BASE_URL pour envoyer les requêtes vers une passerelle autre qu’Anthropic, et sa documentation officielle comporte une page dédiée à ce sujet. Il s’agit donc d’une configuration prise en charge, et non d’une modification ou d’un plugin. Obtenez d’abord la clé sk-kn-… (consultez l’étape 6 pour la liste et le rechargement du solde), puis choisissez l’un des emplacements où la stocker.

macOS et Linux : ajoutez ces six lignes à la fin de ~/.zshrc (Zsh, intégré à macOS) ou de ~/.bashrc, enregistrez, puis ouvrez un nouveau terminal.

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # domain saja, tanpa /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, pour commencer : définissez les variables dans une fenêtre PowerShell, puis exécutez immédiatement claude.

# Untuk uji coba: hanya berlaku sampai jendela PowerShell ini ditutup
$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

Tous les systèmes d’exploitation, de façon permanente : placez-les dans le bloc env du fichier de configuration utilisateur ~/.claude/settings.json (Windows : %USERPROFILE%\.claude\settings.json). Cela s’applique à tous les projets. Si le fichier contient déjà des éléments, insérez uniquement le bloc env sans remplacer les autres paramètres.

{
  "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"
  }
}

Points importants concernant les six variables précédentes :

Kenapa model dikunci? Menurut documentation de configuration des modèles (dicek 3 octobre 2026), untuk pengguna API model default dan alias opus saat ini menunjuk Opus 5.5, dan alias sonnet menunjuk Sonnet 5.5. Alias itu bergeser setiap kali ada rilis baru. Per 3 octobre 2026 Sonnet 5.5 belum tersedia di Kunavo, dan model berikutnya belum tentu langsung tersedia; request ke model yang tidak ada dijawab 404. Karena itu blok di atas juga mengunci alias sonnet dengan ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5: tanpa pin itu, /model sonnet, fase eksekusi opusplan, dan subagent bermodel sonnet berakhir 404. Alias opus dikunci ke Claude Opus 5.5 (claude-opus-5-5), yang butuh Claude Code v2.1.280 atau lebih baru; kalau versi Anda lebih lama, jalankan claude update.

Tarifs Kunavo par million de tokens (entrée / sortie) : Claude Sonnet 5 $1,40 / $7,00 (tarif catalogue Anthropic : $2,00 / $10,00), Claude Opus 5.5 $2,80 / $14,00, et Claude Haiku 4.5 $0,70 / $3,50.

Dua jebakan lain. Pertama, key jangan pernah masuk ke .claude/settings.json milik proyek: menurut documentation de la passerelle, file itu di-commit dan ikut ter-clone oleh siapa pun yang mengambil repositori. Kedua, kalau variabel yang sama ada di shell dan di blok env file pengaturan, umumnya nilai dari file pengaturan yang menang; jadi kalau perubahan di ~/.zshrc seperti tidak berefek, periksa file pengaturan. Pengguna ekstensi VS Code mengisi variabel yang sama di claudeCode.environmentVariables pada user settings VS Code.

Étape 5 : ouvrir la première session et vérifier /status

Accédez au dossier du projet et saisissez claude. Si la clé est bien détectée, la session s’ouvre directement sans écran de connexion. L’écran de connexion qui apparaît indique que la clé n’a pas été transmise. La cause la plus fréquente est que la clé se trouve uniquement dans .claude/settings.json ou .claude/settings.local.json du projet. En mode interactif, le bloc env du fichier du projet n’est lu qu’après l’assistant initial et la question demandant si le dossier est fiable ; lors du premier lancement, Claude Code demande donc toujours une connexion. Déplacez la clé dans le shell ou dans ~/.claude/settings.json.

Une fois la session ouverte, saisissez /status. La configuration est correcte si :

• une ligne Anthropic base URL contient https://api.kunavo.com (cette ligne n’apparaît que si une passerelle est configurée ; son absence signifie que ANTHROPIC_BASE_URL n’a pas été détecté), et
• une ligne Auth token mentionne ANTHROPIC_AUTH_TOKEN. Si Login method s’affiche avec un compte claude.ai, Claude Code utilise encore l’ancienne connexion.

Vous voulez tester la clé avant d’ouvrir Claude Code ? La documentation officielle utilise une requête qui ne demande qu’un seul token de sortie, de sorte que le solde débité est très faible. La commande lit les variables du shell actuellement actif ; si votre clé est enregistrée dans un fichier de configuration, exécutez d’abord export dans ce terminal. Un résultat commençant par {"id":"msg_ signifie que tout fonctionne ; 401 signifie que la clé a été refusée.

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

Voici la version PowerShell ; elle réussit si le champ id de la réponse commence par 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": "."}]}'

Certaines fonctionnalités se comportent différemment lorsque Claude Code utilise une clé API et une passerelle :

Étape 6 : recharger le solde par carte ou avec Link (sans QRIS, GoPay, OVO, DANA)

Ce que vous payez dans Kunavo est un solde API prépayé, et non un abonnement. C’est ce solde que Claude Code débite par token une fois la clé configurée. Procédez comme suit :

1. Créez un compte Kunavo avec une adresse e-mail ou un compte Google. Aucune carte n’est demandée lors de l’inscription.
2. Ouvrez Billing et choisissez un montant. Minimum $10, sans frais mensuels. Les montants plus élevés peuvent bénéficier d’un bonus de solde : bayar $100 → saldo $110, bayar $1.000 → saldo $1.200, bayar $5.000 → saldo $6.250.
3. Di checkout Stripe, bayar dengan kartu (Visa, Mastercard, dll.), Link, atau Apple Pay/Google Pay kalau perangkat dan browser Anda sudah menyiapkannya. Link menyimpan data pembayaran sehingga top-up berikutnya cukup beberapa klik.
4. Ouvrez API Keys et créez une clé. Une clé commençant par sk-kn- n’est affichée qu’une seule fois ; copiez-la donc immédiatement dans ANTHROPIC_AUTH_TOKEN.

QRIS, GoPay, OVO, DANA, ShopeePay, les comptes virtuels et les virements bancaires ne sont pas disponibles. Sans carte permettant les transactions en ligne internationales, vous ne pouvez actuellement pas recharger votre compte Kunavo. Les cartes de débit portant le logo Visa ou Mastercard sont également acceptées ; si elles sont refusées, les transactions en ligne ou internationales n’ont généralement pas encore été activées dans l’application bancaire, et la décision finale appartient à la banque émettrice.

Harga Kunavo dalam USD. Kalau checkout menampilkan rupiah, kursnya ditentukan Stripe dan sudah memuat biaya konversi 2–4% yang ditanggung pembeli (documentation Stripe sur Adaptive Pricing, dicek 3 octobre 2026). Memilih bayar dalam USD menghindari biaya itu, meski kurs dan biaya dari bank Anda sendiri tetap berlaku.

Le solde n’expire jamais et les requêtes échouées ne le diminuent pas. Le rechargement automatique ne fonctionne qu’avec une carte enregistrée ou Link. Kunavo ne délivre aucun document fiscal. Ce solde ne peut pas non plus servir à payer Claude Pro ou Max. Le détail des tarifs de tous les modèles Claude et des modes de paiement depuis l’Indonésie se trouve dans prix de l’API Claude ; la comparaison entre abonnement et clé API, spécifique à Claude Code, se trouve dans prix de Claude Code.

Combien cela coûte-t-il environ ?

Chaque requête Claude Code renvoie le contexte de la conversation, mais la partie initiale identique d’une requête à l’autre est facturée au tarif de lecture du cache, beaucoup moins élevé. Les calculs ci-dessous sont de simples calculs arithmétiques de tokens fondés sur les hypothèses indiquées, et non des mesures ni une limite supérieure :

• une requête = 40.000 tokens d’entrée ; 36.000 (90 %) sont lus depuis le cache, et les 4.000 restants sont écrits dans le cache ;
• une requête produit 1.000 tokens de sortie ;
• une session = 50 requêtes, sans compter les appels Claude Haiku 4.5 en arrière-plan ;
• tarif de lecture du cache 10% et d’écriture du cache 1,25 × le tarif d’entrée (proportion Claude Sonnet 5 dans Kunavo ; chaque modèle du tableau utilise sa propre proportion).

Vos chiffres réels varient selon la longueur du contexte, la fréquence d’utilisation du cache, la longueur des réponses et le fait que la conversation soit effacée avec /clear lors du changement de tâche. D’après la documentation tarifaire Anthropic, les processus Claude Code en arrière-plan coûtent généralement moins de 0,04 $ par session (vérifié le 3 octobre 2026). Les tarifs complets sont disponibles sur la page des prix, et le calculateur de coût des tokens Claude (en anglais) permet d’estimer votre propre mode d’utilisation.

Utiliser Claude Code au quotidien

cd ~/proyek-saya   # Claude Code bekerja di folder tempat ia dijalankan
claude              # mulai sesi
claude -c           # lanjutkan percakapan terakhir di folder ini

• Demandez-le en langage courant, par exemple « explique la structure de ce projet » ou « corrige l’erreur de la page de connexion ». Claude Code lit les fichiers et demande votre autorisation avant de modifier ou d’exécuter quoi que ce soit.
• /clear lors d’un changement de tâche : l’historique précédent n’est plus envoyé, ce qui réduit le nombre de tokens par requête.
• /model pour changer de modèle. Avec le verrouillage défini à l’étape 4, opus = claude-opus-5-5, sonnet = claude-sonnet-5, et haiku = claude-haiku-4-5.
• /status pour vérifier la passerelle et la clé ; /usage pour estimer les coûts (avec les tarifs affichés, voir le tableau de l’étape 5).

Messages d’erreur et leur signification

Limites

• Paiement uniquement par carte, Link ou Apple Pay/Google Pay. QRIS, GoPay, OVO, DANA, ShopeePay, les comptes virtuels et les virements bancaires ne sont pas disponibles ; le rechargement automatique ne fonctionne qu’avec une carte enregistrée ou Link.
• Kunavo ne délivre aucun document fiscal.
• Il s’agit d’une API payée au token, et non d’un abonnement Claude Pro ou Max. Avec une clé API, Remote Control et la dictée vocale ne sont pas disponibles, /fast est désactivé, et la recherche d’outils MCP est désactivée par défaut.
• À la date du 3 octobre 2026, Sonnet 5.5 n’est pas encore disponible dans Kunavo ; sans verrouillage du modèle, l’alias intégré peut aboutir à une erreur 404.
• La documentation de Claude Code est disponible en indonésien, mais la documentation d’intégration de Kunavo et la version anglaise de ce guide (Install Claude Code) ne sont pas encore disponibles en indonésien.

Questions fréquentes