Claude Codeをインストール：Windows、macOS、Linux、サブスクリプションなしのAPIキー、Bancontactでの支払い

Claude Codeのインストールは1行で済みますが、場所によって異なります：macOS、Linux、WSLのターミナルではcurl -fsSL https://claude.ai/install.sh | bash、PowerShellではirm https://claude.ai/install.ps1 | iex、Windowsのコマンドプロンプトではinstall.cmdです。本当の問題は初回起動時に現れます。リクエストの料金を誰が支払うのかという点です。Pro、Max、Team、Enterprise、Consoleのアカウントでログインできます（Claude.aiの無料プランにはClaude Codeが含まれません）。サブスクリプションなしでもAPIキーがあれば十分です。/v1を付けないANTHROPIC_BASE_URLとANTHROPIC_AUTH_TOKENを含む6つの変数を設定し、/statusを確認します。Kunavoの残高はカード、Apple Pay、Google Pay、Link、またはベルギーではBancontactで支払え、$10から利用でき、サブスクリプションはありません。

D’où viennent les informations : les commandes et les variables sont reprises de la documentation officielle de Claude Code (インストール, 環境変数, ゲートウェイへの接続), relue le 2026年10月3日 ; les prix Kunavo et les moyens de paiement ont été contrôlés le 2026年10月3日. D’après la Anthropicがサポートする国の一覧 (lue le 2026年10月3日), Claude.ai et l’API sont ouverts en France, en Belgique, en Suisse, au Luxembourg et au Canada, comme au Maroc, en Tunisie, en Algérie, au Sénégal et en Côte d’Ivoire. Le même guide existe 英語 et, pour la Flandre, オランダ語.

入力するコマンド：ウィンドウによって異なります

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

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

:: Invite de commandes Windows (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

最初の3行は、Anthropicが推奨するネイティブ版を設定します。これは~/.local/bin（Windowsでは%USERPROFILE%\.local\bin）に配置される自己完結型バイナリで、更新をバックグラウンドでダウンロードし、次回起動時に適用します。インストール完了後はターミナルを閉じて再度開いてください。インストールに使用したターミナルは、まだ新しいPATHを認識していないためです。

Windowsでは、ウィンドウを間違えることが失敗の最大の原因で、メッセージにも明確に表示されます。The token '&&' is not a valid statement separator：CMDの行をPowerShellに貼り付けています。'irm' is not recognized as an internal or external command：その逆です。フランス語版Windowsでは、2つ目のメッセージが翻訳されて表示されることがありますが、原因は変わりません。その他のメッセージは、ガイド末尾のエラー表にあります。

必要条件

Windows：古いチュートリアルの内容と現在の正しい情報

Une bonne partie des tutoriels en français datent des premières versions de Claude Code. Voici leurs consignes les plus répandues, confrontées à la 現在のインストールドキュメント et à la トラブルシューティングページ (lues le 2026年10月3日) :

Si vous installez Git for Windows, Claude Code passe par Git Bash et garde l’outil PowerShell à côté. Il arrive qu’il ne trouve pas bash.exe : indiquez alors son chemin dans la variable CLAUDE_CODE_GIT_BASH_PATH, au sein du bloc env de ~/.claude/settings.json (la documentation donne C:\Program Files\Git\bin\bash.exe en exemple). Dernier piège : le raccourci « Windows PowerShell (x86) » lance une version 32 bits, que Claude Code refuse.

ネイティブ版とWSLのどちらを選ぶかは、プロジェクトの場所によって決まります：

WSL側では、すべてLinuxディストリビューション内で行います。curl … | bashの行を貼り付けるのも、後でclaudeと入力するのもそこです。PowerShellまたはCMDから起動した場合、このインストールは認識されません。

Homebrew、WinGet、apt、またはnpm

パッケージマネージャーは動作しますが、Claude Codeは自動更新されません。HomebrewとWinGetでは、変数CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1によりClaude Code自身が更新を開始するようにできます。設定しない場合は、自分で更新する必要があります：

# Homebrew (macOS)
brew install --cask claude-code
brew upgrade claude-code              # pas de mise à jour automatique

# WinGet (Windows)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode   # pas de mise à jour automatique

Sur Debian, Ubuntu, Fedora, RHEL et Alpine, Anthropic publie aussi des dépôts apt, dnf et apk signés, mis à jour avec le reste du système ; la procédure figure sur la インストールページ.

Node.jsがすでにツールチェーンの一部である場合は、npmが便利です。パッケージにはNode.js 22以上が必要です。古いバージョンでは、npmはEBADENGINE警告を表示するだけで処理を完了します。パッケージが、実行時にNode.jsを必要としない同じネイティブバイナリをインストールするためです。ルールは2つです：sudo npm install -gは使用しないこと、そして@latestで更新することです。npm update -gは元のバージョン範囲内にとどまるため、更新されずに古いままになる可能性があります。

node -v                                       # v22 ou plus récent
npm install -g @anthropic-ai/claude-code      # jamais avec sudo

# mise à jour : avec @latest, pas avec npm update -g
npm install -g @anthropic-ai/claude-code@latest

インストールを確認してPATHを修正する

claude --version   # affiche le numéro de version, suivi de (Claude Code)
claude doctor      # diagnostic de l’installation et des réglages, sans ouvrir de session

バージョン番号が返れば、インストール完了です。claude doctorはセッションを開始せずに、インストール状態、設定ファイルのエラー、最新の更新結果まで確認します。問題がある場合に最初に実行すべきコマンドです。

command not found: claude sur macOS ou Linux, claude « non reconnu » sous Windows : le programme est bien installé, mais le shell ne sait pas où le chercher. Une nouvelle fenêtre suffit le plus souvent. Sinon, ajoutez ~/.local/bin au PATH dans ~/.zshrc ou ~/.bashrc. Sous Windows, la 公式トラブルシューティングページ donne ces trois étapes PowerShell :

# 1. Le dossier d'installation est-il déjà dans le PATH ?
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Aucun résultat ? Ajoutez-le au PATH de l'utilisateur, puis ouvrez une nouvelle fenêtre
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Dans la nouvelle fenêtre : deux chemins = deux installations concurrentes
where.exe claude

npmでインストールし、PowerShellがnpm.ps1 cannot be loadedと応答する場合、実行ポリシーがnpmのスクリプトをブロックしています。ネイティブインストーラーに切り替えるか、自分のアカウントに限ってローカルスクリプトを許可してください：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

リクエストの支払い元：ClaudeのサブスクリプションまたはAPIキー

選択はインストール時ではなく初回起動時に行われ、後から変更できます。環境変数に設定したKeyは、保存済みのclaude.ai接続より優先されます。接続は休止状態になります。変数を削除すると、次回起動時に接続が再び優先されます。

Claudeサブスクリプションの場合

設定は不要です。プロジェクトフォルダーでclaudeを実行し、ブラウザーでログインします。唯一の例外は、環境にANTHROPIC_API_KEYが残っている場合です。その場合Claude Codeは、一度だけそれを使用するか尋ねます。拒否すると記憶され、以後Keyはメッセージなしで無視されるため、変数が読み取られていないように見えます。この選択を変更するには：/config → Use custom API key。

サブスクリプションなし：Kunavo APIキー

Faire pointer Claude Code ailleurs que chez Anthropic n’a rien d’un bricolage. La 環境変数の公式一覧 présente ANTHROPIC_BASE_URL comme le moyen d’envoyer les requêtes vers un proxy ou une passerelle. Kunavo répond au format de l’API Messages d’Anthropic : vous gardez le Claude Code officiel, sans extension ni version modifiée.

1. アカウントを作成します：Kunavoに登録。
2. Billingで残高に$10以上を追加します（支払い方法は下記）。
3. /app/keysでKeyを生成します。sk-kn-で始まり、作成時にしか表示されないため、すぐにコピーしてください。
4. 以下の6つの変数を入力してください。

Pourquoi épingler quatre modèles ? Les alias de Claude Code suivent les sorties d’Anthropic. D’après la モデル設定に関するドキュメント (lue le 2026年10月3日), pour un compte API, le réglage par défaut et opus visent aujourd’hui Opus 5.5, et sonnet vise Sonnet 5.5, que Kunavo ne sert pas : sans ANTHROPIC_DEFAULT_SONNET_MODEL, /model sonnet, la phase d’exécution d’opusplan et les sous-agents réglés sur sonnet tombent sur une 404. L’alias opus est épinglé sur Opus 5.5 (claude-opus-5-5), qui exige Claude Code v2.1.280 ou plus récent ; sur une version plus ancienne, lancez claude update. Un modèle tout juste sorti n’est pas non plus toujours disponible chez Kunavo le jour même. Avec des noms complets, chaque requête part vers un modèle servi, au prix que vous connaissez. La ゲートウェイプロトコルに関するドキュメント (lue le 2026年10月3日) confirme le point sur les tâches de fond : avec Claude Haiku 4.5, elles coûtent peu.

変数を記述する場所

既存のファイル内容がある場合はそれと統合する推奨版（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"
  }
}

macOSとLinuxのシェルに同じ値を設定：

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # le domaine seul, sans /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

PowerShellウィンドウで簡単にテストする場合：

# Valable uniquement dans cette fenêtre 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

VS Code拡張機能では、エディターのユーザー設定（コマンドPreferences: Open User Settings (JSON)）に設定します：

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

Claudeデスクトップアプリは例外で、ANTHROPIC_BASE_URLもsettings.jsonも読み取りません。シェルで変更した変数が効かない場合は、まず優先されるsettings.jsonに同じ変数がないか確認してください。

Tarifs par million de tokens tirés du catalogue Kunavo, à côté du prix public d’Anthropic relevé sur claude.com/pricing (lu le 2026年10月3日) :

作業中に一時的にOpusへ切り替えるには、セッション中に/model opusを実行します（claude-opus-5-5に固定されたalias）。または起動時にclaude --model claude-opus-5-5を使用します。利用状況に応じた月額予算と、サブスクリプションの方が有利になるしきい値は、Claude Codeの料金で数値化しています。Claudeのトークンコスト計算ツールでは自分の使用量に基づいて計算でき、料金ページにはすべてのモデルが掲載されています。

/statusで確認

最初の兆候は、/statusより前に現れます。ANTHROPIC_AUTH_TOKENを設定している場合、Claude Codeはログイン画面なしで起動します。この画面が表示される場合、Keyが読み取られていません。多くの場合、プロジェクト設定（.claude/settings.jsonまたは.claude/settings.local.json）にしか存在しないことが原因です。対話セッションでは、このenvブロックは初回起動アシスタントとフォルダーの信頼確認が完了した後にのみ適用されます。Keyをシェルまたは~/.claude/settings.jsonに移動してください。

Une fois dans la session, /status s’ouvre sur l’onglet Status. Voici comment le lire, d’après la ゲートウェイに関するドキュメント (lue le 2026年10月3日) :

すでにサブスクリプションでログインしていましたか？その場合、Claude Codeは起動時に2つの認証ソースが有効であることを、auth may not work as expectedで終わる警告として表示することがあります。リクエストに使われるのはキーです。/logoutを実行すると以前の接続が削除され、警告が消えます。

問題がKunavoにあるのか、設定にあるのかを確認するには、Claude Codeを使わずにテストしてください。ドキュメントには、出力トークンを1つに制限したリクエストがあり、費用は1セント未満のごく一部です。以下の2つのコマンドは、アドレスとキーをシェルから取得します。これらが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と音声入力は利用できなくなります。どちらもclaude.aiアカウントに依存しており、ANTHROPIC_AUTH_TOKENが定義されている間は利用できません。ANTHROPIC_BASE_URLがAnthropic以外のホストを指している場合、Remote Controlも無効になります。
• 高速モード（/fast）は無効として表示されます。検証にはclaude.aiへの接続またはAnthropicキーが必要で、単なるBearerトークンでは不十分だからです。
• MCPツールの検索はデフォルトで無効になります。ANTHROPIC_BASE_URLがAnthropic以外を指している場合です。
• /contextは推定値を表示します。 Kunavo ne propose pas /v1/messages/count_tokens, et dans ce cas Claude Code compte à partir du nombre de caractères (ゲートウェイプロトコルに関するドキュメント).

その他（コードの読み書き、ツール、サブエージェント、MCPサーバー、フック、プロンプトキャッシュ）に変更はありません。技術的な詳細は英語で、Claude Code統合ドキュメントに記載されています。

フランスまたはベルギーから支払う

Deux circuits à ne pas confondre. L’abonnement Claude acheté sur le web se règle uniquement par carte de crédit ou de débit (Anthropicの請求に関するFAQ, lue le 2026年10月3日) ; souscrit dans l’app mobile, il passe par l’App Store ou Google Play. Les montants de claude.com/pricing sont hors taxes.

Le solde Kunavo, lui, se recharge sur une page de paiement Stripe. Le tarif est fixé en dollars américains, mais depuis la France ou la Belgique Stripe vous montre le montant en euros, à un taux garanti 24 heures qui intègre 2 à 4 % de frais de conversion à votre charge (Adaptive Pricingに関するStripeのドキュメント, lue le 2026年10月3日). Vous pouvez payer en dollars pour éviter ces frais, mais votre banque applique alors son propre change, et Bancontact n’est proposé qu’en euros. Les moyens de paiement disponibles :

• フランスのCBカード？ Selon la Cartes Bancairesに関するStripeのドキュメント (lue le 2026年10月3日), plus de 95 % des cartes CB sont co-badgées Visa ou Mastercard. Elles passent donc au checkout en tant que Visa ou Mastercard, et une simple carte de débit fait l’affaire.
• Bancontact est proposé aux acheteurs situés en Belgique. Stripe vous envoie sur le site ou l’app Bancontact pour valider, et le résultat est connu immédiatement (Bancontactに関するStripeのドキュメント, lue le 2026年10月3日).
• Pay by Bank, le paiement depuis votre banque en ligne, n’est pas proposé depuis la France ni la Belgique : le checkout ne l’affiche qu’aux acheteurs situés au Royaume-Uni, en Irlande et en Finlande. La Pay by Bankに関するStripeのドキュメント (lue le 2026年10月3日) le classe en préversion privée pour la France et ne mentionne pas la Belgique.
• スイスまたはカナダからの場合、金額はスイスフランまたはカナダドルで表示されます。カードとLinkに加え、カードを基盤とするApple PayおよびGoogle Payを利用できます。

提供なし：PayPal、SEPA口座振替、Klarna。Klarnaは米国に所在する購入者に限定されます（ドルで支払うだけでは不十分です）。

1. Kunavoに登録してください。この段階でカードは要求されません。
2. Billingで金額を選択します。最低額は$10です。より高い金額にはボーナス（$100 payés, $110 crédités ; $1 000 payés, $1 200 crédités ; $5 000 payés, $6 250 crédités）が付与されます。
3. Stripeのページで支払い方法を選択します。確認前にユーロ建ての金額が表示されます。Bancontactを使用する場合は、アプリまたはカードで確認してください。
4. /app/keysでキーを作成し、ANTHROPIC_AUTH_TOKENに設定します。

残高は前払い式です。月額料金や有効期限はなく、失敗したリクエストには課金されません。自動チャージには登録済みカードまたはLinkが必要です。BancontactはStripeで継続支払いに対応していないため、Bancontactによるチャージは毎回手動で開始します。Kunavoはフランス、ベルギー、その他いずれの国のVAT請求書も発行しません。チャージ履歴はBillingで確認できます。なお、これらの支払い方法はKunavoのAPI残高専用であり、Claude ProまたはMaxのサブスクリプションの支払いには使えません。App StoreやGoogle Playを含むその他の方法は、クレジットカードなしでClaudeに支払うで確認しています。

よくあるエラー

プロジェクトでの最初の手順

Claude Codeが検出するリポジトリでは、まず/initを実行します。コードを調査し、検出したテストコマンドや規約を記録したCLAUDE.mdを作成します。このファイルは毎回のセッションで再読み込みされるため、内容を確認して整理してください。話題を変えるには/clearで空の会話を開始し、長いタスクを続けるには/compactで履歴を要約します。

APIキーの制限

• Claude ProまたはMaxの定額プランではなく、従量課金です。毎日数時間Claude Codeを使う場合は、サブスクリプションのほうが有利なことが多く、不定期利用ではトークン単位の支払いのほうが柔軟で、利用の少ない月は費用がかかりません。数値はClaude Codeの料金に記載しています。
• キーが有効な間はRemote Controlも音声入力も利用できません。
• Kunavoの容量は共有で、予約済みクォータや契約上のコミットメントはありません。必要な場合はAnthropicと直接契約してください。
• Bancontactでは手動チャージのみ可能です。自動チャージには登録済みカードまたはLinkを使用します。
• ユーロ建ての金額にはStripeの換算手数料が含まれており、KunavoはVAT請求書を発行しません。

よくある質問