Comment installer Claude Code [Windows et Mac] — configuration de la clé API sans abonnement et paiement par JCB et Apple Pay

L’installation de Claude Code consiste simplement à exécuter en une ligne l’installateur natif officiel. Sur Mac, Linux et WSL, utilisez install.sh ; sous Windows, install.ps1 dans PowerShell et install.cmd dans CMD (npm fonctionne également, mais nécessite alors Node.js 22 ou une version ultérieure). Normalement, vous vous connectez ensuite avec une offre telle que Pro ou Max ; si vous ne souscrivez pas d’abonnement, définissez ANTHROPIC_BASE_URL=https://api.kunavo.com (sans ajouter /v1), ANTHROPIC_AUTH_TOKEN contenant la clé API et les quatre variables de fixation des modèles pour démarrer sans connexion. Vérifiez le fonctionnement avec /status. Le solde API peut être prépayé avec une carte telle que JCB, Apple Pay, Google Pay ou Link à partir de $10 ; la page de paiement affiche les montants en yens.

# 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

インストール手順の一次情報は、日本語で読める Anthropic の公式ドキュメント（Configuration、Dépannage de l’installation、3 octobre 2026確認）です。このページはその内容をなぞるのではなく、日本語の解説記事で食い違っている点（Node.js のバージョン、Windows の管理者権限と Git）と、公式ドキュメントが扱っていないこと——ログインせずに API キーで動かす設定と、日本からの支払い——を中心にまとめています。料金と決済手段は 3 octobre 2026時点の情報です。日本は Anthropic のListe des pays pris en chargeに、Claude.ai と API の両方で載っています（3 octobre 2026確認）。

À décider d’abord : se connecter avec un abonnement ou utiliser une clé API

L’installation est identique dans les deux cas ; la différence intervient après le premier lancement. Au démarrage, Claude Code demande une authentification. En cas d’hésitation, vous pouvez décider à partir des trois éléments suivants.

• Vous avez déjà souscrit à Pro, Max, Team ou Enterprise, ou vous disposez d’un compte Console : connectez-vous simplement pour commencer. La configuration de clé API de cette page n’est pas nécessaire. L’offre gratuite n’inclut pas Claude Code.
• Vous ne souhaitez pas payer un forfait mensuel et l’écart entre les mois d’utilisation et de non-utilisation est important：API キーで動かし、使ったトークン分だけ払う形が合います。参考までに、Claude のサブスクは Pro が月 $20（年払いは $200 で月 $17 相当）、Max は月 $100 からで、いずれも税別です（Page des tarifs de Claude、3 octobre 2026確認）。どちらが安くなるかの分岐点は Tarifs de Claude Codeで試算しています。
• Vous souhaitez utiliser Remote Control ou la saisie vocale : ces deux fonctions nécessitent un compte claude.ai et ne sont pas disponibles avec une clé API. Choisissez la connexion.

支払い手段も違います。Anthropic の Web サイトで契約するサブスクはクレジットカードかデビットカードのみで、iPhone・Android アプリから契約した場合は App Store・Google Play が決済します（Aide Anthropic、英語版、3 octobre 2026確認）。Kunavo の API 残高は、JCB を含むカード、Apple Pay、Google Pay、Link でチャージします（詳しくは後半の支払いの章）。

Vérifications avant l’installation

Les conditions sont celles de la documentation officielle (vérifiées le 3 octobre 2026). La colonne de droite indique comment les vérifier sur votre machine.

Quelle méthode d’installation choisir

La documentation officielle recommande l’installateur natif. La principale différence avec les autres méthodes concerne la manière dont les mises à jour sont effectuées.

# Homebrew（既定では自動更新されない）
brew install --cask claude-code

# WinGet（Windows・既定では自動更新されない）
winget install Anthropic.ClaudeCode

Quelle que soit la méthode, une fois terminé, rouvrez le terminal avant de vérifier. Les fenêtres ouvertes avant l’installation peuvent ne pas avoir chargé le nouveau PATH. claude doctor affiche uniquement l’état de l’installation et de la configuration sans démarrer de session ; il permet donc d’isoler le problème lorsque Claude Code ne fonctionne pas correctement.

claude --version   # 2.1.211 (Claude Code) のようなバージョン番号が出れば OK
claude doctor      # セッションを開かずに、インストールと設定を診断する

Points d’attention pour l’installation npm

日本語の解説記事では今も「Node.js 18 以上」という記載をよく見かけますが、公式ドキュメントの要件はNode.js 22 ou version ultérieureです（Documentation officielle、3 octobre 2026確認）。古い Node.js でも npm は EBADENGINE の警告を出すだけでインストールを止めず、claude も起動しますが、警告が出たら Node.js を上げておくほうが安全です。nvm や Volta などでバージョンを切り替えている場合は、インストールするシェルで node -v を確かめてください。

node -v                                    # v22 以上であること
npm install -g @anthropic-ai/claude-code   # sudo は付けない

# 更新は @latest で（npm update -g は使わない）
npm install -g @anthropic-ai/claude-code@latest

La documentation officielle indique explicitement de ne pas utiliser sudo npm install -g. De plus, le binaire principal étant installé comme dépendance facultative, si --omit=optional ou optional=false dans .npmrc ignore les dépendances facultatives, claude native binary not installed s’affichera sous Mac et Linux et le programme ne démarrera pas.

Points clés pour l’installation sous Windows

まず、ネットでよく見る 2 つの手順は不要です。「PowerShell を管理者として実行」と「Git for Windows を先に入れる」は、どちらも公式ドキュメントの要件ではありません。Les droits d’administrateur ne sont pas nécessaires, et Git for Windows est facultatifで、入っていなければ Claude Code は PowerShell でコマンドを実行します（Configuration sous Windows、3 octobre 2026確認）。

Ensuite, vérifiez seulement deux points avant de coller la commande.

1. Le terminal actuellement ouvert est-il PowerShell ou CMD ? Si l’invite est PS C:\Users\ユーザー名>, utilisez la ligne PowerShell avec irm ; si elle est PS sans C:\Users\ユーザー名>, utilisez la ligne CMD avec install.cmd. En cas de confusion, PowerShell renvoie une erreur indiquant que && n’est pas reconnu comme séparateur, tandis que CMD renvoie une erreur indiquant que irm n’est pas reconnu (sur une version japonaise de Windows, le message peut s’afficher en japonais).
2. N’avez-vous pas ouvert « Windows PowerShell (x86) » ? La version (x86) affichée dans le menu Démarrer exécute des processus 32 bits : même sur un ordinateur 64 bits, elle s’arrêtera avec Claude Code does not support 32-bit Windows.

Il existe 3 façons d’exécuter Claude Code sous Windows. En cas de doute, vous pouvez commencer en mode natif.

Même si Git for Windows est installé, si Claude Code ne trouve pas Git Bash, indiquez l’emplacement de bash.exe dans CLAUDE_CODE_GIT_BASH_PATH du fichier de configuration utilisateur env.

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Lorsque claude ne fonctionne pas malgré l’installation

'claude' is not recognized (sur Mac/Linux, command not found: claude) signifie que le dossier d’installation ne figure pas dans PATH. L’emplacement de l’installeur natif est %USERPROFILE%\.local\bin\claude.exe sous Windows et ~/.local/bin/claude sous Mac/Linux. Si le problème persiste après avoir rouvert le terminal, vérifiez et ajoutez-le depuis PowerShell en suivant la procédure de la documentation officielle.

# 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

npm で入れた場合に npm.ps1 cannot be loaded because running scripts is disabled on this system （起動時なら claude.ps1）と出るのは、PowerShell の実行ポリシーが npm の .ps1 スクリプトを止めているためです（Documentation officielle、3 octobre 2026確認）。現在のユーザーにだけローカルのスクリプト実行を許可する次のコマンドで解消します。ポリシーを変えたくなければ、npm.cmd・claude.cmd を使うか、PowerShell 用のネイティブインストーラーに切り替えてください。

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Configuration pour utiliser une clé API sans se connecter

Kunavo est une passerelle API indépendante qui fournit un accès prépayé aux API de modèles tels que Claude, et non à Anthropic.Claude Code には送信先を差し替える ANTHROPIC_BASE_URL という変数が公式に用意されていて、公式ドキュメントにも「Connecter Claude Code à une passerelle LLM」というページがあります。プラグインや改造版は使いません。この変数が変えるのは送信先だけで、どのモデルが答えるかは別の変数で決まります（Configuration du modèle、3 octobre 2026確認）。

Les 6 éléments suivants doivent être configurés.

Sur Mac/Linux, ajoutez ces lignes au fichier de configuration du shell (~/.zshrc ou ~/.bashrc) et rouvrez le terminal.

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

Pour tester sous Windows uniquement, exécutez ce qui suit dans une fenêtre PowerShell. Le réglage disparaît lorsque vous fermez la fenêtre.

# このウィンドウの中だけで有効（閉じると消える）
$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

Si vous ne voulez pas les saisir à chaque fois, ajoutez-les à env dans le fichier de configuration utilisateur ~/.claude/settings.json (Windows : %USERPROFILE%\.claude\settings.json). Le réglage s’applique à tous les projets et s’écrit de la même manière sur Mac et Windows. Si le fichier contient déjà d’autres paramètres, ajoutez uniquement le bloc 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"
  }
}

Trois points importants concernant l’emplacement.

• プロジェクトの .claude/settings.json にはNe pas écrire la cléでください。リポジトリにコミットされ、クローンした人全員に渡ります（Documentation officielle）。
• Si la même variable existe dans le shell et dans le fichier de configuration, la valeur du fichier de configuration est utilisée. Si le problème persiste après avoir réexécuté export, consultez le fichier de configuration.
• Pour l’utiliser avec l’extension VS Code, ajoutez les mêmes variables aux paramètres utilisateur de VS Code, dans claudeCode.environmentVariables.

Pourquoi utiliser ANTHROPIC_AUTH_TOKEN

ANTHROPIC_AUTH_TOKEN est envoyé dans l’en-tête Authorization: Bearer et prend effet dès sa configuration. En revanche, ANTHROPIC_API_KEY est envoyé dans l’en-tête x-api-key et, en mode interactif, demande une fois l’autorisation de l’utiliser au premier lancement. Si vous refusez, la clé est ensuite ignorée sans autre indication et ne sera pas utilisée avant d’être réactivée dans /config via Use custom API key. Kunavo accepte les clés envoyées dans les deux en-têtes et fonctionne donc aussi avec ANTHROPIC_API_KEY, mais ANTHROPIC_AUTH_TOKEN est plus fiable puisqu’il évite ce piège. La documentation officielle recommande également d’utiliser ANTHROPIC_AUTH_TOKEN lorsque le type de clé n’est pas précisé.

Pourquoi verrouiller le modèle (au 3 octobre 2026)

Documentation officielle（3 octobre 2026確認）によると、API キーで使う場合、既定モデルと opus エイリアスは Opus 5.5、sonnet エイリアスは Sonnet 5.5 を指します。エイリアスの行き先は新しいモデルが出るたびに変わりますが、Kunavo で同じ日から使えるとは限りません。実際、Kunavo は 3 octobre 2026時点で Sonnet 5.5 を提供していないので、固定せずに /model sonnet を選ぶと 404 になります。opusplan の実行フェーズや、model: sonnet を指定したサブエージェントも同じです。そのため上の設定では ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 で sonnet エイリアスも固定しています。opus エイリアスも、行き先が次の Opus に変わっても困らないよう ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5 で Claude Opus 5.5 に固定しています。Claude Opus 5.5 には Claude Code v2.1.280 以降が必要なので、古い場合は claude update で更新してください。

固定しておくと、費用の見通しも立てやすくなります。何も指定しないと既定モデルが Claude Opus 5.5 になり、Claude Sonnet 5 をメインにした場合より 1 トークンあたりの単価が上がります。Kunavo の単価（1M トークンあたり、入力 / 出力）は、Claude Haiku 4.5 が $0.70 / $3.50、Claude Sonnet 5 が $1.40 / $7.00(Tarifs Anthropic : $2.00 / $10.00)、Claude Opus 5.5 が $2.80 / $14.00 です。ANTHROPIC_DEFAULT_HAIKU_MODEL を設定しないと、ANTHROPIC_AUTH_TOKEN で接続したセッションでは claude --resume 用の会話要約などのバックグラウンド処理もメインのモデルで動きます（Guide de compatibilité des passerelles、3 octobre 2026確認）。なお Anthropic のPage des tarifsでは、メインに固定している Sonnet 5 は「レガシーモデル」の欄に移っています（3 octobre 2026確認）。

Vérification en 3 étapes

1. Avant le lancement, tester uniquement l’URL et la clé

Il s’agit de la même requête que dans la documentation officielle, avec seulement 1 jeton en sortie (un montant infime est déduit du solde). Comme elle lit les variables du shell, si la clé n’est écrite que dans le fichier de configuration, exécutez export dans ce terminal avant de lancer la requête. Si un JSON commençant par {"id":"msg_ et 200 sont renvoyés, l’URL et la clé sont correctes ; 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": "."}]}'

Avec PowerShell, procédez comme suit : si le id renvoyé commence par msg_, la réussite est confirmée.

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

2. Lancer claude et vérifier qu’aucun écran de connexion ne s’affiche

Au premier lancement, l’assistant d’exécution initiale et la confirmation de confiance du dossier s’affichent, mais aucune connexion par navigateur n’est ensuite demandée. Si une connexion est demandée, la clé n’a pas été transmise.

Une cause fréquente est d’avoir écrit la clé uniquement dans .claude/settings.json ou .claude/settings.local.json du projet. En session interactive, le env de la configuration du projet n’est chargé qu’après l’assistant et la confirmation de confiance du dossier : lors du premier lancement, la clé est donc considérée comme absente. Déplacez-la vers export du shell ou vers ~/.claude/settings.json de l’utilisateur.

3. Vérifier les 2 lignes de /status

セッションの中で /status を実行し、Status タブを確認します（Documentation officielle、3 octobre 2026確認）。

• Vérifiez que https://api.kunavo.com apparaît dans Anthropic base URL. Cette ligne n’apparaît que lorsqu’une passerelle est configurée : si elle est absente, ANTHROPIC_BASE_URL n’est pas parvenu jusqu’à la session.
• Vérifiez que ANTHROPIC_AUTH_TOKEN apparaît dans Auth token. Si, à la place, Login method du compte claude.ai apparaît, l’exécution utilise une connexion enregistrée.

Ce qui change avec une clé API

• Remote Control et la saisie vocale ne sont pas disponibles. Comme tous deux nécessitent un identifiant claude.ai, ils sont désactivés tant que des identifiants de passerelle tels que ANTHROPIC_AUTH_TOKEN sont actifs. À partir de v2.1.196, Remote Control est désactivé dès que ANTHROPIC_BASE_URL pointe vers un hôte autre qu’Anthropic.
• /fast s’affiche comme désactivé. Avec une authentification par jeton bearer uniquement, Claude Code le traite comme désactivé sans vérifier si le mode rapide est disponible et affiche Fast mode has been disabled by your organization.
• Le nombre de /context est approximatif.Kunavo は /v1/messages/count_tokens を提供していないため、Claude Code は文字数ベースの推定に切り替えます（Guide de compatibilité des passerelles、3 octobre 2026確認）。

Les paramètres détaillés côté Kunavo se trouvent dans la documentation d’intégration de Claude Code et la documentation d’ANTHROPIC_BASE_URL (toutes deux en anglais).

Paiement du solde API : JCB, Apple Pay, Google Pay, Link

Voici d’abord les points fréquemment demandés pour les paiements depuis le Japon.

La procédure comporte 4 étapes. Commencez par créer un compte Kunavo (adresse e-mail ou compte Google : aucune carte n’est demandée à l’inscription). Ensuite, choisissez le montant à recharger dans Billing du tableau de bord. Le minimum est $10, il n’y a pas de frais mensuels et les montants élevés bénéficient d’un bonus ($100 で残高 $110、$1,000 で残高 $1,200、$5,000 で残高 $6,250). Après avoir choisi l’un des moyens ci-dessus sur la page de paiement Stripe et payé, créez enfin une clé commençant par sk-kn- dans API Keys et saisissez-la dans ANTHROPIC_AUTH_TOKEN. La clé ne s’affiche qu’une seule fois lors de sa création : copiez-la immédiatement.

Le solde n’a pas de date d’expiration et les requêtes échouées ne sont pas facturées. Les moyens disponibles au Japon pour payer un abonnement Claude (y compris via l’App Store et Google Play) sont récapitulés avec leurs sources dans Modes de paiement de Claude.

Estimation des coûts

Claude Code utilisé avec une clé API est facturé à l’usage, selon les jetons. À chaque requête, Claude Code envoie l’ensemble du contexte de la conversation, mais la partie initiale identique à la précédente peut être facturée au tarif de lecture du cache. Le tableau ci-dessous suppose que l’entrée d’une requête contient 40,000 jetons (dont 36,000 = 90% en lecture du cache et les 4,000 restants en écriture du cache), que la sortie contient 1,000 jetons et qu’une tâche comporte 50 requêtes. Les appels Claude Haiku 4.5 en arrière-plan ne sont pas inclus. Chez Kunavo, pour Claude Sonnet 5, la lecture coûte 10% du tarif d’entrée et l’écriture 1.25 fois ce tarif (chaque modèle du tableau est calculé selon son propre ratio). Il ne s’agit ni de mesures réelles ni d’un plafond.

Le montant réel varie selon la longueur du contexte, l’efficacité du cache, la longueur de la réponse et l’utilisation ou non de /clear pour chaque tâche. Les tarifs de tous les modèles sont disponibles sur la page des tarifs, l’estimation selon votre usage dans la calculatrice du coût des jetons de Claude (en anglais), et les tarifs API par modèle dans les tarifs de l’API Claude.

Erreurs fréquentes et solutions

Cas où cette méthode ne convient pas

• Une facture conforme est indispensable pour le remboursement des frais. Le checkout Kunavo n’émet ni facture ni facture conforme avec numéro d’enregistrement.
• Vous souhaitez payer en supérette ou avec PayPay. Ni l’un ni l’autre, pas plus que les virements bancaires ou les paiements par opérateur, ne sont pris en charge. La recharge automatique ne fonctionne qu’avec une carte enregistrée ou Link.
• Vous utilisez Remote Control ou la saisie vocale. Ces fonctions ne sont pas disponibles avec une clé API et /fast s’affiche également comme désactivé. Connectez-vous avec un abonnement.
• Vous souhaitez utiliser Sonnet 5.5. Kunavo ne le propose pas au 3 octobre 2026.
• Vous souhaitez effectuer toute la configuration uniquement à partir de documentation japonaise. La documentation officielle du logiciel Claude Code est disponible en japonais, mais la documentation d’intégration de Kunavo est uniquement en anglais.

À faire ensuite

Après avoir vérifié avec /status, lancez claude dans le répertoire du projet sur lequel vous travaillez, puis créez d’abord CLAUDE.md avec /init. La documentation Utiliser Claude Code explique successivement quoi écrire dans CLAUDE.md, comment réduire les boîtes de dialogue de confirmation et comment créer des commandes personnalisées.

Questions fréquentes