要するに、Claude Codeはターミナルで1行を実行するだけでインストールでき、Node.jsも管理者権限も必要ありません。使用する行はウィンドウによって異なります。macOS、Linux、WSLではcurl -fsSL https://claude.ai/install.sh | bash、Windows PowerShellではirm https://claude.ai/install.ps1 | iex、コマンドプロンプト(CMD)では下にある3つ目の行です。Claudeのサブスクリプションがない場合は、その後APIキーでClaude CodeをKunavoに接続します。ANTHROPIC_BASE_URL=https://api.kunavo.com(/v1なし)、ANTHROPIC_AUTH_TOKEN、および4つのモデル変数を設定します。設定が反映されたかどうかは/statusで確認できます。支払いは$10からの残高を使ったトークン単位で、デビットカードまたはクレジットカード(Visa DebitとDebit Mastercardを含む)、Apple Pay、Google Pay、Link、またはオーストリアではEPSでチャージできます。PayPalとSEPAダイレクトデビットは利用できません。
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash# Windows PowerShell
irm https://claude.ai/install.ps1 | iex:: Windows-Eingabeaufforderung (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdAnthropic pflegt die Claude-Code-Dokumentation vollständig auf Deutsch, deshalb verweist diese Anleitung auf die deutschen Seiten. Die Befehle oben sind am 2026年10月3日 mit Claude Codeのセットアップ abgeglichen, die Variablen mit der Liste der 環境変数. Kunavos Preise und Zahlungswege sind auf dem Stand vom 2026年10月3日. Deutschland, Österreich und die Schweiz stehen in Anthropics 国の一覧 sowohl für Claude.ai als auch für die API (Stand 2026年10月3日). Eine englische Fassung gibt es unter Claude Codeをインストール.
手順の概要
- インストール:上記の適切な行を実行し、その後新しいターミナルウィンドウを開きます。
- 確認:
claude --versionでバージョン番号が表示されます。 - 選択:Claudeのサブスクリプションでログインするか、APIキーを使用します(比較は下記)。
- APIキーの場合:残高をチャージし、キーを作成し、6つの環境変数を設定します。
- 確認:セッションで
/statusを入力します。
前提条件:現在の要件
Manche deutschsprachigen Anleitungen beschreiben einen älteren Stand von Claude Code. Die Tabelle stellt verbreitete Angaben neben das, was die 公式セットアップページ am 2026年10月3日 verlangt.
| 項目 | 今でもよく見かける記載 | Anthropicによる要件 |
|---|---|---|
| macOS | macOS 10.15以降 | macOS 13.0以降 |
| Windows | WSL経由のみ | Windows 10 1809以降またはWindows Server 2019でネイティブに動作。WSLは任意であり必須ではありません |
| 権限 | PowerShellを管理者として起動 | 不要 |
| Node.js | Node.js 18以降 | npmインストールの場合のみ必要。その場合はバージョン22以降 |
| npm | 古い情報 | 引き続き公式に記載された方法。ネイティブインストーラーが推奨 |
| Linux | — | Ubuntu 20.04+、Debian 10+、Alpine Linux 3.19+ |
| コンピューターとシェル | — | 最低4 GB RAM、x64またはARM64、32ビットWindowsは不可。Bash、Zsh、PowerShell、またはCMD |
| 所在地 | — | Anthropicがサポートする国。ドイツ、オーストリア、スイスが含まれます |
| アカウント | — | ログインにはPro、Max、Team、Enterprise、またはConsoleが必要。APIキーならサブスクリプションもログインも不要 |
macOS、Linux、WSLへのインストール
ターミナルにinstall.shを含む行を入力します。公式ドキュメントでは、この方法は「Native Installation (Recommended)」タブに記載されています。スクリプトは~/.local/bin/claudeに起動ファイルを配置し、その後インストールをバックグラウンドで自動更新します。WSLでも同じ行をWSLターミナルで実行します。
WindowsへのClaude Codeのインストール
Unter Windows entscheidet das offene Fenster, welche Zeile funktioniert, und ein Blick auf die Eingabezeile genügt: PS C:\Users\Name> ist PowerShell, C:\Users\Name> ohne PS ist die Eingabeaufforderung (CMD). Administratorrechte brauchen Sie laut セットアップページ für keine der beiden Varianten. Der Installer legt claude.exe unter %USERPROFILE%\.local\bin ab.
ウィンドウを間違えると、英語のメッセージが表示されます。ドイツ語版Windowsではドイツ語で表示される場合もあります。PowerShellでCMD用の行を実行するとThe token '&&' is not a valid statement separator、CMDでPowerShell用の行を実行すると'irm' is not recognized as an internal or external commandで終了します。どちらも意味は同じで、ウィンドウが間違っているため、もう一方の行を使用してください。
Lassen Sie im Startmenü den Eintrag „Windows PowerShell (x86)“ links liegen. Laut トラブルシューティング startet er einen 32-Bit-Prozess, und der Installer bricht dann auch auf einem 64-Bit-PC mit Claude Code does not support 32-bit Windows ab. Gibt [Environment]::Is64BitOperatingSystem in diesem Fenster True aus, ist Ihr Windows in Ordnung, und Sie öffnen einfach „Windows PowerShell“ ohne den Zusatz.
Git for Windows müssen Sie nicht installieren. Ist es vorhanden, führt Claude Code Shell-Befehle in der Git Bash aus, sonst in PowerShell. Findet Claude Code eine installierte Git Bash nicht, tragen Sie den Pfad zur bash.exe als CLAUDE_CODE_GIT_BASH_PATH in den env-Block von ~/.claude/settings.json ein, bei einer Standardinstallation C:\Program Files\Git\bin\bash.exe.
ネイティブで実行するかWSLで実行するかは、プロジェクトの場所によって異なります。
| 方式 | 前提条件 | サンドボックス | 適している場合 |
|---|---|---|---|
| ネイティブWindows | なし。Git for Windowsは任意 | いいえ | プロジェクトとツールをWindows上で直接実行する |
| WSL 2 | WSL 2が有効 | はい | Linuxツールが必要、またはサンドボックスでコマンドを実行したい |
| WSL 1 | WSL 1が有効 | いいえ | WSL 2をコンピューターで利用できない |
WSLでは、claudeをPowerShellやCMDではなくWSLターミナルでインストールして起動します。
代替手段:Homebrew、WinGet、npm
パッケージマネージャーでソフトウェアを管理したい場合は、それも可能です。ただし注意点があります。ドキュメントによると、HomebrewとWinGetによるインストールは自動更新されないため、定期的にupgradeを実行する必要があります。Homebrewには2つのCaskがあります。claude-codeは安定版チャンネルに従い、約1週間遅れて更新され、大きなリグレッションを含むバージョンをスキップします。claude-code@latestは各バージョンをすぐに取得します。
# Homebrew (macOS) – stabiler Kanal; claude-code@latest für den neuesten Stand
brew install --cask claude-code
brew upgrade claude-code # aktualisiert sich nicht von selbst
# WinGet (Windows)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode # aktualisiert sich nicht von selbstnpmについて
npmは公式に説明された方法として引き続き利用できます。前提条件はNode.js 22以降です。npmパッケージはインストーラーと同じネイティブバイナリを取得し、実行時にはNode.jsをまったく必要としません。そのため、古いNode.jsでもインストールは中断されず、npmはEBADENGINEで警告するだけです。Node.jsがまだインストールされていない場合は、ネイティブインストーラーの方が短い手順で済みます。
node -v # muss v22 oder neuer zeigen
npm install -g @anthropic-ai/claude-code # niemals mit sudo
# später aktualisieren: mit @latest, nicht mit npm update -g
npm install -g @anthropic-ai/claude-code@latestDrei Regeln aus der セットアップページ: なし sudo npm install -g, weil das Rechteprobleme und Sicherheitsrisiken schafft. Aktualisieren mit @latest, denn npm update -g bleibt im ursprünglichen Versionsbereich hängen. Und optionale Abhängigkeiten nicht abschalten: Die Binärdatei kommt als plattformspezifische optionale Abhängigkeit, mit --omit=optional oder optional=false in der .npmrc fehlt sie, und claude meldet unter macOS und Linux Error: claude native binary not installed.
インストールの確認
そのために新しいターミナルウィンドウを開きます。インストール前から開いていたウィンドウは更新されたPATHをまだ認識していないため、claudeが見つかりません。
claude --version # zeigt eine Versionsnummer wie 2.1.211 (Claude Code)
claude doctor # Diagnose von Installation und Einstellungen, startet keine Sitzungclaude doctorは、問題がある場合に使用するツールです。セッションは開始しませんが、インストール状態、設定ファイルのエラー、解決策の提案を含む警告を一覧表示します。これにより、問題がインストールにあるのか設定にあるのかを確認できます。
インストールで問題が発生した場合
ダウンロード結果がHTMLまたは403になる
Beginnt die Ausgabe mit syntax error near unexpected token '<' oder meldet curl einen 403, kam laut トラブルシューティング (Stand 2026年10月3日) statt des Skripts eine Webseite oder ein Fehlerstatus zurück. Steht auf dieser Seite App unavailable in region, hält Anthropic die Verbindung für eine aus einem nicht unterstützten Land. Aus Deutschland, Österreich oder der Schweiz spricht das für einen VPN- oder Proxy-Ausgang im Ausland. Ein 403 ohne Text kann dieselbe Ursache haben oder von einer Firmen-Firewall kommen. Die Dokumentation rät, zuerst die Netzwerkverbindung zu prüfen, weil die anderen Installationswege dieselben Server ansprechen. Ein anderes Netz oder eine Freigabe durch die IT hilft hier mehr als ein anderer Installer.
「claude」が見つからない
macOSとLinuxでcommand not found: claudeが表示される場合、またはWindowsでclaudeが認識されない場合は、インストールフォルダーがPATHに含まれていません。通常は新しいウィンドウを開くだけで解決します。macOSまたはLinuxで解決しない場合は、~/.local/binを~/.zshrcまたは~/.bashrcに追加します。Windowsでは、トラブルシューティングの説明に従ってフォルダーを確認し、追加します。
# 1. Steht der Installationsordner schon im PATH?
$env:PATH -split ';' | Select-String '\.local\\bin'
# 2. Keine Ausgabe? Ordner zum Benutzer-PATH hinzufügen, dann ein neues Fenster öffnen
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
# 3. Im neuen Fenster
claude --versionPowerShellがnpm.ps1をブロックする
これはnpm方式にのみ関係します。npm.ps1 cannot be loaded because running scripts is disabled on this systemというメッセージは、実行ポリシーがnpmの起動スクリプトをブロックしていることを意味します。ポリシーの対象外であるnpm.cmdとclaude.cmdを実行する、ネイティブインストーラーに切り替える、またはユーザーアカウントでローカルスクリプトを許可することができます。
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserサブスクリプションとAPIキーのどちらを選ぶべきですか?
Beim ersten Start will Claude Code wissen, wer bezahlt. Entweder melden Sie sich mit einem Claude-Konto an, oder Sie geben per Umgebungsvariable einen API-Key mit. Ist ein Key gesetzt, hat er laut ゲートウェイガイド Vorrang: Ein gespeicherter Login bleibt ungenutzt liegen und greift wieder, sobald Sie die Variable entfernen. Neu installieren müssen Sie für den Wechsel nichts.
| Claudeサブスクリプション | KunavoのAPIキー | |
|---|---|---|
| 請求 | monatlich: Pro $20 oder $17 pro Monat bei jährlicher Zahlung ($200 im Voraus), Max ab $100, jeweils ohne etwaige Steuern (claude.com/de/pricing, Stand 2026年10月3日) | プリペイド残高からトークン単位で支払い。チャージは$10から、月額料金なし、失効なし |
| 適している用途 | 毎日、長時間利用する場合 | 利用量が変動する場合。1か月利用しなくても料金はかかりません |
| 支払い方法 | im Web nur Kredit- oder Debitkarte, in den iOS- und Android-Apps über App Store bzw. Google Play (Anthropicの請求に関するFAQ, Stand 2026年10月3日) | デビットカードとクレジットカード(Visa、Mastercard)、Apple Pay、Google Pay、Link。オーストリアではEPS |
| セットアップ | claudeを起動してブラウザでログイン | 6つの環境変数。ログイン不要 |
| 含まれないもの | — | Remote Controlと音声ディクテーション |
ProまたはMaxがキーより割安になる時点については、Claude Codeの料金ガイドをご覧ください。
APIキーの設定(サブスクリプションなし)
Dass Claude Code einen anderen Endpunkt anspricht, ist kein Trick. ANTHROPIC_BASE_URL steht in Anthropics 変数一覧 und ist genau dafür da, Anfragen über einen Proxy oder ein Gateway zu leiten. Ein Plugin oder eine veränderte Claude-Code-Version brauchen Sie nicht.
- Kunavoに登録します。メールアドレスまたはGoogleアカウントを使用できます。
- Billingで最低$10をチャージします(支払い方法は「支払い方法」セクションを参照)。
- API-Keysでキーを作成します。キーは
sk-kn-で始まり、一度しか表示されないため、すぐにコピーしてください。 - 以下の例のとおりに変数を設定します。
~/.zshrcまたは~/.bashrcに設定すると、macOS、Linux、WSLで新しく開くすべてのターミナルに値が適用されます。
export ANTHROPIC_BASE_URL=https://api.kunavo.com # nur die Domain, ohne /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-5PowerShellでは、$env:の代入は開いているウィンドウにのみ適用されるため、最初の試行に適しています。
# Gilt nur für dieses PowerShell-Fenster
$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"
claudeAuf Dauer gehören die Werte in den env-Block von ~/.claude/settings.json (unter Windows %USERPROFILE%\.claude\settings.json). Diese Datei gilt laut ゲートウェイガイド (Stand 2026年10月3日) für alle Ihre Projekte. Gibt es sie schon, ergänzen Sie nur den env-Block:
{
"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"
}
}VS Code拡張機能は、VS Codeのユーザー設定にあるclaudeCode.environmentVariablesから変数を読み込みます(コマンド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" }
]
}各変数の役割
| 変数 | 値 | 効果 | 未設定または誤っている場合 |
|---|---|---|---|
ANTHROPIC_BASE_URL | https://api.kunavo.com | すべてのリクエストをKunavoに転送します。Claude Codeが自動的に/v1/messagesを追加します | 末尾に/v1を付けると、リクエストは/v1/v1/messagesに送られ、404で失敗します。 |
ANTHROPIC_AUTH_TOKEN | 自分のキー(sk-kn-…) | Authorization: Bearerとして送信され、直ちに優先されます | 代わりにANTHROPIC_API_KEY(ヘッダーx-api-key)を設定する場合は、インタラクティブモードでキーを一度確認する必要があります。拒否すると、Claude Codeは再度尋ねることなくキーを無視します。/config → Use custom API keyで再度有効にできます。Kunavoは両方のヘッダーでキーを受け付けます。 |
ANTHROPIC_MODEL | claude-sonnet-5 | 各セッションの起動モデル | これを設定しない場合、セッションはOpusの固定モデル、つまりOpus 5.5で起動します。これもない場合は、Anthropicの現在のデフォルト(現時点では同じくOpus 5.5)になります。 |
ANTHROPIC_DEFAULT_OPUS_MODEL | claude-opus-5-5 | /model opusの対象、およびANTHROPIC_MODELなしでデフォルトが使用するバージョン | これを設定しない場合、エイリアスはAnthropicの指定に従い、現時点では同じくOpus 5.5を指します。新しいOpusが登場すると、Kunavoがまだ提供していないモデルを指す可能性があります。Opus 5.5にはClaude Code 2.1.280以降が必要です。古いバージョンはclaude updateで更新できます。 |
ANTHROPIC_DEFAULT_SONNET_MODEL | claude-sonnet-5 | /model sonnet、opusplanの実行フェーズ、およびmodel: sonnetを使用するSubagentsの対象 | これを設定しない場合、APIユーザー向けのエイリアスはSonnet 5.5を指します。これはKunavoが現在(2026年10月3日時点)提供していないため、404になります。 |
ANTHROPIC_DEFAULT_HAIKU_MODEL | claude-haiku-4-5 | /model haikuの対象およびバックグラウンド機能のモデル | これを設定しない場合、Anthropicのエイリアスが使用するHaikuを決定します。 |
Warum ein festes Startmodell? Laut モデル設定 (Stand 2026年10月3日) ist Opus 5.5 der Standard für API-Nutzer, und Aliase werden im Lauf der Zeit auf neue Versionen umgestellt. Kunavo bietet Opus 5.5 an; ein Start ganz ohne Modellvariablen läuft hier also auf Opus 5.5, das 1トークンあたり、Claude Sonnet 5の2倍の料金がかかる. Mit festen Modellnamen wissen Sie, welches Modell antwortet und zu welchem Tarif. Der Opus-Pin hält den Alias opus auf Claude Opus 5.5 (claude-opus-5-5), auch wenn Anthropic ihn später auf ein neueres Opus umstellt. Opus 5.5 kostet bei Kunavo pro Token 未満 Claude Opus 5 ($2,80 / $14,00 gegenüber $3,50 / $17,50 pro 1 Mio. Input-/Output-Tokens) und setzt Claude Code ab Version 2.1.280 voraus; eine ältere Installation bringt claude update auf den aktuellen Stand. Der Sonnet-Pin ist Pflicht: Der Alias sonnet zeigt für API-Nutzer auf Sonnet 5.5, das Kunavo nicht anbietet, und ohne ANTHROPIC_DEFAULT_SONNET_MODEL enden /model sonnet, die Ausführungsphase von opusplan und Subagents mit model: sonnet mit 404. Claude Haiku 4.5 hält die Hintergrundaufgaben günstig, und mit /model wechseln Sie in der Sitzung jederzeit.
保存場所について2点あります。キーをプロジェクトの.claude/settings.jsonに絶対に入れないでください。ゲートウェイガイドによると、このファイルはコミットされ、リポジトリをクローンした全員の環境に入るためです。また、シェルのexportとenvブロックで同じ変数を設定した場合は、設定ファイルが優先されます。シェルで変数を変更しても何も起きない場合、古い値がsettings.jsonに残っている可能性があります。
Die Modelle im Vergleich, Kunavo-Preise aus dem Katalog, Anthropics Listenpreise nach claude.com/de/pricing (Stand 2026年10月3日), jeweils pro 1 Mio. Tokens:
| モデル | Kunavo(入力/出力) | Anthropicの定価(Input / Output) | 差額 | Claude Codeでの役割 |
|---|---|---|---|---|
claude-haiku-4-5 | $0,70 / $3,50 | $1,00 / $5,00 | 約30%安い | Claude Codeのhaikuエイリアスとバックグラウンドタスク |
claude-sonnet-5 | $1,40 / $7,00 | $2,00 / $10,00 | 約30%安い | 日常業務用のメインモデル(ANTHROPIC_MODEL) |
claude-opus-5-5 | $2,80 / $14,00 | $4,00 / $20,00 | 約30%安い | 上記の固定指定を使用するopusエイリアス(大規模なリファクタリング、計画)。固定指定がない場合はAPIユーザーのデフォルト |
claude-opus-5 | $3,50 / $17,50 | $5,00 / $25,00 | 約30%安い | エイリアスなし。/model claude-opus-5で明示的に指定する場合のみ |
すべてのClaudeモデルと料金はClaude API料金ガイドおよび料金ページに掲載されています。
初回起動:/statusで確認
Wechseln Sie in Ihren Projektordner und starten Sie claude. Mit gesetztem ANTHROPIC_AUTH_TOKEN geht es direkt in die Sitzung, ログイン画面なし. Erscheint er trotzdem, hat Claude Code keinen Key gefunden. Der häufigste Grund laut ゲートウェイガイド: Der Key steht nur in der .claude/settings.json oder .claude/settings.local.json des Projekts. Solche env-Blöcke wertet Claude Code in einer interaktiven Sitzung erst nach dem Einrichtungsassistenten und der Frage aus, ob Sie dem Ordner vertrauen. Legen Sie den Key deshalb in die Shell (export) oder in ~/.claude/settings.json.
セッション内の/statusのStatusタブで、Claude Codeがアドレスと認証情報をどこから取得しているかを確認できます。重要なのは次の2行です。
| 行 | 正しい状態 | 正しくない場合 |
|---|---|---|
Anthropic base URL | https://api.kunavo.com | この行はゲートウェイアドレスが設定されている場合にのみ表示されます。表示されない場合、ANTHROPIC_BASE_URLがセッションに届いていません。 |
Auth token | ANTHROPIC_AUTH_TOKENと表示される | 代わりにLogin methodがclaude.aiアカウントとともに表示される場合、変数が読み込まれておらず、セッションはサブスクリプション経由で実行されています。 |
Claude Codeなしでも、ゲートウェイガイドのリクエストを使って接続をテストできます(ここではモデルをclaude-sonnet-5に設定)。このリクエストはOutputトークンを正確に1つ要求するため、費用もごくわずかです。コマンドはシェル変数を読み込みます。値がsettings.jsonにのみ設定されている場合は、テスト用に追加でexportしてください。
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キー使用時に変わること
ほとんどは従来どおりです。コード編集、ツール、Subagents、MCPサーバー、Hooks、Prompt Cachingは通常どおり機能します。知っておくべき違いは4つあります。
- Remote Controlと音声ディクテーションは利用できません。ゲートウェイガイドによると、どちらもclaude.aiのIDが必要で、
ANTHROPIC_AUTH_TOKENまたはANTHROPIC_API_KEYが有効な間は無効になります。さらにClaude Code 2.1.196以降では、ANTHROPIC_BASE_URLがAnthropic以外のホストを指している場合もRemote Controlが無効になります。 /fastはFast-Modeを利用できないと表示します。Bearerトークンのみの場合、Claude CodeはFast-Modeを無効として扱い、利用可能性の確認リクエストも送信しません。- MCPのツール検索は無効です。 Laut MCPドキュメント (Stand 2026年10月3日) schaltet Claude Code sie ab, sobald
ANTHROPIC_BASE_URLauf einen Drittanbieter zeigt; mitENABLE_TOOL_SEARCHlässt sie sich ausdrücklich einschalten. /contextは推定値を表示します。 Kunavo bietet/v1/messages/count_tokensnicht an. Ohne diesen Endpunkt zählt Claude Code laut ゲートウェイ互換性ガイド (Stand 2026年10月3日) anhand der Zeichen.
統合について詳しくは、Claude Codeの統合ガイド(英語)をご覧ください。
PayPalとSEPAなしで支払う方法
Vorweg eine Abgrenzung: Kunavo verkauft keine Claude-Abos, sondern Guthaben für API-Zugang, von dem Claude Code jeden Token abbucht. Für Pro und Max bei Anthropic gilt: Im Web nur Kredit- oder Debitkarte, in den Apps rechnen App Store bzw. Google Play ab (請求に関するFAQ). PayPal oder Venmo nimmt Anthropic laut dem 拒否されたカードに関するヘルプ記事 nicht an (beides Stand 2026年10月3日).
Kunavo lädt über den Stripe-Checkout auf. Die Preise stehen in US-Dollar; wer aus Deutschland oder Österreich zahlt, sieht den Betrag in Euro. In diesem Kurs steckt laut Adaptive Pricingに関するStripeのドキュメント (Stand 2026年10月3日) eine Umrechnungsgebühr von 2–4 %, die der Käufer trägt. Wählen Sie im Checkout US-Dollar, entfällt sie; dann rechnet Ihre Bank zu ihrem eigenen Kurs um und kann eigene Gebühren verlangen. Der Checkout bietet an:
| 支払い方法 | 利用地域 | 注記 |
|---|---|---|
| カード(Visa、Mastercard、Amex、JCB、UnionPay) | どこでも | クレジットカードとデビットカード。Visa DebitとDebit Mastercardも含みます。純粋なgirocardは不可です |
| Apple Pay | Safari、iPhone、iPad。インドでは利用不可 | Walletに登録されたカード(VisaまたはMastercardのデビットカードも可)。girocardのみのカードは不可 |
| Google Pay | Google Payを設定済みのChromeとAndroid。インドでは利用不可 | Walletに登録されたカード(VisaまたはMastercardのデビットカードも可)。girocardのみのカードは不可 |
| Link | インド以外のどこでも | Stripeの決済サービスで、カードを保存できます。自動チャージも利用できます |
| EPS | オーストリア、ユーロ建てチェックアウト | 銀行のオンラインバンキングへのリダイレクト |
EPS ist laut Stripe ein österreichisches Verfahren, das alle österreichischen Banken unterstützen. Sie werden auf die Seite Ihrer Bank weitergeleitet und bestätigen dort; es funktioniert nur bei Zahlung in Euro. Wer aus der Schweiz zahlt, nimmt Karte, Apple Pay, Google Pay oder Link.
girocard: Eine Karte, die nur girocard ist (früher EC-Karte), wird im Kunavo-Checkout nicht angenommen, weil Stripe girocard nicht unter seinen 対応カードブランド führt (Stand 2026年10月3日). Trägt Ihre Karte zusätzlich das Visa- oder Mastercard-Logo, läuft die Zahlung über dieses Netz, auch in Apple Pay und Google Pay.
利用できない支払い方法:PayPal、SEPAダイレクトデビット、手動銀行振込(前払い)、giropay、Sofort。Klarnaは米国の購入者にのみチェックアウトで提供されます。米国外から米ドルに切り替えても、Klarnaは表示されません。
- アカウントを作成します。Kunavoは登録時にカードを要求しません。
- Billingで$10からチャージ段階を選択します。より大きな段階ではボーナス残高が付与されます:$100 ergeben $110, $1.000 ergeben $1.200, $5.000 ergeben $6.250。
- Stripeのチェックアウトで支払い方法を選択します。確認前にユーロ金額が表示されます。EPSの場合はオンラインバンキングで確認します。
- API-Keysでキーを作成し、
ANTHROPIC_AUTH_TOKENとして設定します。
残高は前払いです。月額料金、失効はなく、失敗したリクエストには課金されません。自動チャージは保存済みカードまたはLinkでのみ利用できます。Apple Pay、Google Pay、EPSでは手動でチャージします。Kunavoは消費税を明記した請求書を発行しません。チャージ履歴はBillingで確認できます。支払い方法と拒否されたカードについて詳しくは、クレジットカードなしでClaudeに支払う方法をご覧ください。
セッションの費用:計算例
APIキーではトークン単位で支払い、Claude Codeは各ステップで、それまでの完全なコンテキストを送信します。ただし、このコンテキスト全体に毎回の通常料金がかかるわけではありません。変更されていない冒頭部分はモデルがキャッシュから読み込み、低いキャッシュ読み取り料金が適用されます。次の表は仮定したパターンを計算したもので、実測値でも上限値でもありません。前提:
- 1リクエストあたり40.000 Inputトークン。そのうち36.000(90%)はキャッシュから読み取られ、4.000は新たにキャッシュへ書き込まれる。
- 1リクエストあたり1.000 Outputトークン。
- 1作業セッションあたりこのようなリクエストを50回。バックグラウンド呼び出しは含まない。
- Cache読み取りはClaude Sonnet 5でInput料金の10 %、Cache書き込みはその1,25倍です。表の各モデルは、それぞれ固有の係数で計算しています。
| モデル | 1リクエスト | 50リクエスト | キャッシュヒットなしの50リクエスト |
|---|---|---|---|
| Claude Sonnet 5 | $0,019 | $0,952 | $3,15 |
| Claude Opus 5 | $0,0476 | $2,38 | $7,88 |
| Claude Opus 5.5 | $0,033 | $1,65 | $6,30 |
実際の支払額は、コンテキストの長さ、キャッシュヒット、回答の長さ、および2つのタスクの間に/clearで新しく開始するかどうかによって異なります。自分の数値については、Claudeトークン計算ツール(英語)をご利用ください。ProとMaxとの比較は、Claude Code料金ガイドで計算できます。
エラーメッセージとその意味
| メッセージ | 意味と対処方法 |
|---|---|
The token '&&' is not a valid statement separator | CMDの行をPowerShellウィンドウに入力しています。そこではirm … | iexを使用してください。 |
'irm' is not recognized as an internal or external command(またはドイツ語で表示された同じメッセージ) | PowerShellの行をCMDに入力しています。そこではinstall.cmdを含む行を使用してください。 |
Claude Code does not support 32-bit Windows | 「Windows PowerShell (x86)」が開いています。(x86)の付いていない項目を選択してください。 |
syntax error near unexpected token '<'または403 | スクリプトの代わりにWebページまたはエラーコードが返されました。VPN、プロキシ、企業ファイアウォールを確認するか、別のネットワークを試してください。 |
App unavailable in region | 接続元がサポート対象外の国である可能性があります。DE、AT、CHでは、通常はVPNまたはプロキシが原因です。 |
command not found: claudeまたはclaudeが認識されません | インストール先フォルダーがPATHに含まれていません。新しいウィンドウを開いてください。Windowsでは、上記のPATHコマンドを使用します。 |
警告 EBADENGINE | Node.jsが22未満です。インストールは完了しますが、それでも更新することをおすすめします。 |
claude native binary not installed(macOS、Linux) | npmがオプションの依存関係をスキップしました(--omit=optional、optional=false)。設定を削除して再インストールしてください。 |
npm.ps1 cannot be loaded | 実行ポリシーによってnpmがブロックされています。npm.cmdを使用するか、Set-ExecutionPolicyの行を実行するか、ネイティブインストーラーを使用してください。 |
| Keyを設定しているのにログイン画面が表示される | Keyがプロジェクト設定にしかありません。exportを使うか、~/.claude/settings.jsonに設定して、新しいターミナルを開いてください。 |
ANTHROPIC_API_KEYを設定したが効果がない | 初回の確認が拒否されました。/config → Use custom API keyで有効にするか、ANTHROPIC_AUTH_TOKENに切り替えてください。 |
401 | Keyが拒否されました。完全な状態で空白なしにコピーされているか、/app/keysにまだ存在するか、ANTHROPIC_AUTH_TOKENに登録されているかを確認してください。 |
404 | ANTHROPIC_BASE_URLが/v1で終わっているか、要求したモデルがKunavoに存在しません。たとえば、Sonnetの固定指定なしで/model sonnetを実行した場合です。 |
この方法の制限
- 料金は定額ではなく、トークン単位で発生します。Claude Codeを毎日何時間も使う場合は、ProまたはMaxの方が安くなることが多いです。利用頻度が変動する場合は、発生した分だけ支払い、利用しない月は料金がかかりません。
- claude.aiアカウントがない場合、Remote Controlと音声入力は利用できません。
/fastは無効として扱われ、MCPのツール検索もデフォルトでは無効です。 - Sonnet 5.5は現在Kunavoでは提供していません。そのため、
/model sonnet、opusplan、Sonnetサブエージェントには、上記の例にあるSonnetの固定指定が必要です。 - Apple Pay、Google Pay、EPSは手動でのチャージにのみ使用できます。自動チャージに対応しているのはカードまたはLinkだけです。ユーロ金額にはStripeの換算手数料が含まれます。
- Kunavoは、付加価値税を明記した請求書を発行していません。
- AnthropicのClaude Codeドキュメントはドイツ語で提供されていますが、Kunavoの統合ガイドは英語のみです。
よくある質問
Claude Codeのインストール方法を教えてください。
ターミナルを開き、お使いのシステム向けの公式コマンドを実行します。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。その後、新しいターミナルウィンドウを開き、claude --versionと入力します。バージョン番号が表示されれば、Claude Codeはインストール済みです。このネイティブインストールはバックグラウンドで自動更新されますが、HomebrewまたはWinGet経由のインストールは手動で更新する必要があります。
WindowsにClaude Codeをインストールする場合、WSLや管理者権限は必要ですか?
どちらも必要ありません。Claude CodeはWindows 10 バージョン1809以降およびWindows Server 2019でネイティブに動作し、Anthropicによるとインストーラーを管理者として実行する必要もありません。Linuxツールやサンドボックスが必要な場合にのみWSL 2が役立ちます。その場合は、WSLターミナルでClaude Codeをインストールして起動します。Git for Windowsは任意です。Gitを使用すると、Claude CodeはPowerShellではなくGit Bashでコマンドを実行します。よくある落とし穴は、PowerShellウィンドウでCMD用の行を実行する(またはその逆)ことと、32ビットプロセスとして終了するスタートメニュー項目「Windows PowerShell (x86)」を起動することです。
Claude CodeにNode.jsは必要ですか?
npm経由でインストールする場合のみ必要で、その場合はNode.js 22以降が必要です。古いガイドではNode.js 18と記載されていることがよくありますが、これは古い情報です。ネイティブインストーラー、Homebrew、WinGetではNode.jsはまったく必要ありません。Node.jsが古すぎる場合、npmはEBADENGINEで警告しますが、それでもインストールは続行します。sudoでは絶対にインストールせず、npm update -gではなくnpm install -g @anthropic-ai/claude-code@latestで更新してください。
サブスクリプションなしでClaude Codeを利用できますか?
はい、APIキーを使用できます。ログインにはPro、Max、Team、Enterprise、またはConsoleアカウントが必要です。無料のClaudeプランにはClaude Codeは含まれません。Kunavoでは、代わりにANTHROPIC_BASE_URL=https://api.kunavo.comとANTHROPIC_AUTH_TOKENを設定すると、ログイン画面なしでClaude Codeが起動します。各トークンの使用分は、$10からチャージできるプリペイド残高から差し引かれます。月額料金はありません。ただし、Remote Controlと音声ディクテーションは利用できません。どちらもclaude.aiアカウントが必要なためです。
Claude CodeでAPIキーを設定するにはどうすればよいですか?
~/.claude/settings.jsonのenvブロック(Windowsでは%USERPROFILE%\.claude\settings.json)に設定するのが最適です。それ以外の場合は、~/.zshrcまたは~/.bashrcにexport行として設定します。必要な値は6つです。ANTHROPIC_BASE_URL=https://api.kunavo.com(/v1は付けません。付けるとリクエストが/v1/v1/messagesに送られ、404で失敗します)、ANTHROPIC_AUTH_TOKENに自分のキー、さらに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です。ANTHROPIC_AUTH_TOKENはすぐに使用されます。ANTHROPIC_API_KEYも使用できます。Kunavoは両方のヘッダーでキーを受け付けますが、インタラクティブモードでは一度確認が必要です。キーをプロジェクトの.claude/settings.jsonに書き込まないでください。このファイルはリポジトリと共有されるためです。
Claude CodeはAPIキー使用時にどのモデルを使いますか?
指定したモデルです。指定しない場合、Anthropicによると(2026年10月3日時点)、APIユーザーのClaude CodeはOpus 5.5で起動します。KunavoではOpus 5.5を提供しており、1トークンあたり、Claude Sonnet 5の2倍の料金がかかる。ANTHROPIC_MODEL=claude-sonnet-5を設定すると、Claude Sonnet 5が起動モデルになります。このページの計算例のリクエストは、その場合約$0,019です。ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5は、/model opusで起動するモデルを決めます。Opus 5.5にはClaude Code 2.1.280以降が必要で、古いインストールではclaude updateによって最新版になります。ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5も設定してください。APIユーザー向けのsonnetエイリアスはSonnet 5.5を指しますが、KunavoはSonnet 5.5を提供していないためです。この行がないと、/model sonnet、opusplanの実行フェーズ、model: sonnetを指定したSubagentsが404で終了します。ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5はバックグラウンドタスクにも適用されます。
/statusでClaude CodeがAPIキーを使用していることを確認するにはどうすればよいですか?
実行中のセッションで/statusを入力し、「Status」タブを確認します。Anthropic base URLの行にhttps://api.kunavo.com、Auth tokenの行にANTHROPIC_AUTH_TOKENと表示される必要があります。Base URLの行がなければ、変数がセッションに届いていません。Login methodにclaude.aiアカウントと表示される場合、セッションはサブスクリプション経由で実行されています。初回起動時からログイン画面が表示される場合、キーはおそらくプロジェクト設定にのみ記載されています。Claude Codeは設定ウィザードの完了後に初めてプロジェクト設定を読み込みます。
Claude Codeの支払いにPayPal、SEPAダイレクトデビット、girocard、EPSは使えますか?
Kunavo残高については、オーストリアからユーロで支払う場合はEPSを利用できます。PayPalとSEPAダイレクトデビットは利用できず、Klarnaは米国の購入者のみ利用できます。Stripeはgirocardをカードブランドとして扱わないため、girocard単体では失敗します。カードにVisaまたはMastercardのロゴもある場合は、そのネットワーク経由で支払えます。Apple PayやGoogle Payも利用できます。クレジットカード、デビットカード、Linkも利用できます。最低額は$10で、月額料金はなく、残高も失効しません。Stripeによると、ユーロ金額には2~4%の換算手数料が含まれます。自動チャージは、保存済みカードまたはLinkでのみ利用できます。Kunavoは消費税を明記した請求書を発行しません。Claude ProまたはMaxのサブスクリプションにはこの方法で支払えません。Anthropic自体もウェブではカードのみ受け付け、PayPalには対応していません。