Claude Codeのインストール：Windows、macOS、Linuxのコマンド、サブスクリプション不要のAPIキー、MB WAYでの支払い

Claude Codeはシステムごとに公式コマンド1つでインストールします。macOS、Linux、WSLではcurl -fsSL https://claude.ai/install.sh | bash、WindowsのPowerShellではirm https://claude.ai/install.ps1 | iex（コマンドプロンプト、つまりCMDでは、後述するinstall.cmdの行）を使用します。その後、使い方は2つあります。サブスクリプションを使う場合は、Pro、Max、Team、Enterprise、Consoleのアカウントでログインします（Claude.aiの無料プランだけではClaude Codeにアクセスできません）。サブスクリプションなしではAPIキーを使います。ANTHROPIC_BASE_URL（ドメインのみで、/v1なし）、ANTHROPIC_AUTH_TOKEN、4つのモデル変数を設定し、/statusで確認します。Kunavoの残高は、ユーロ建てのチェックアウトでMB WAYを使って、月額料金なしでUS$ 10からチャージできます。

Comandos e variáveis verificados a 2026年10月3日 na Claude Codeの公式インストールドキュメント e na 環境変数のドキュメント; preços e meios de pagamento verificados a 2026年10月3日. Portugal consta da Anthropicがサポートする国の一覧 (consultada a 2026年10月3日), tanto para o Claude.ai como para a API. Este guia existe também em inglês: Claude Codeをインストール.

インストール前に

macOS、Linux、WSL：1行のみ

ターミナル（macOSでは「アプリケーション › ユーティリティ」にあります）で、次を実行します：

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

推奨されるネイティブインストールです。公式ドキュメントによると、単独で動作するプログラムで、バックグラウンドで自動更新されます。claudeコマンドは~/.local/binに配置されます。すでに開いているターミナルは新しいPATHを認識しないため、テスト前に新しいウィンドウを開いてください。WSLでは、WSLターミナル内で実行する行もまったく同じです。

Windowsにインストールする

Windowsには2つの行があり、選択は開いているウィンドウだけで決まります。行がPS C:\Users\Nome>で始まる場合はPowerShellです。C:\Users\Nome>だけが表示され、PSがない場合はコマンドプロンプト（CMD）です。「管理者として実行」を使う必要はありません。一部のポルトガル語ガイドが推奨している内容とは異なり、公式ドキュメントは明確に不要だと説明しています。

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

:: Linha de Comandos do Windows (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Windowsでは、最も多い間違いはウィンドウを取り違えることです。PowerShellがThe token '&&' is not a valid statement separatorと返す場合はCMDの行を受け取っています。CMDが'irm' is not recognized as an internal or external commandと返す場合はPowerShellの行を受け取っています。ポルトガル語版Windowsでは、同じ原因でこの2つ目のメッセージが翻訳されて表示されることがあります。また、| bashを含むmacOSの行をPowerShellに貼り付けると、bashが認識されないというエラーになります。3つのケースすべてで、解決策はウィンドウに対応する行を使用することです。

O Git for Windows é opcional. Com ele, a ferramenta Bash do Claude Code passa a correr no Git Bash, e o PowerShell continua disponível ao lado; sem ele, todos os comandos correm pelo PowerShell. Quando o Git está instalado numa pasta fora do habitual e o Claude Code não dá com o bash.exe, indica-se o caminho em CLAUDE_CODE_GIT_BASH_PATH, dentro do bloco env de ~/.claude/settings.json; o exemplo da documentação é C:\Program Files\Git\bin\bash.exe.

したがって、WSLは要件ではなく選択肢です。一部のガイドに書かれている内容とは異なります。WSLを選択する場合は、macOS/Linuxの行をWSLターミナルで実行し、claudeもそこで起動します。PowerShellやCMDからは起動しません。

Homebrew、WinGet、またはnpm経由

これらも機能しますが、重要な違いがあります。公式ドキュメントによると、HomebrewとWinGetによるインストールは自動更新されません。更新は手動で行います。Linux向けには、署名済みのapt、dnf、apkリポジトリもあります。

# Homebrew
brew install --cask claude-code
brew upgrade claude-code              # não se atualiza sozinho

# WinGet (Windows)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode   # não se atualiza sozinho

npmパッケージにはNode.js 22以降が必要です。一部のガイドで今も案内されているNode.js 18ではありません。古いNode.jsを使用すると、npmはインストール中に失敗するのではなく、EBADENGINEという警告だけを表示します。sudo npm install -gは絶対に使用しないでください。公式ドキュメントでも明確に推奨されていません。更新には@latestを使用し、npm update -gは使用しないでください。

node -v                                           # tem de ser v22 ou posterior
npm install -g @anthropic-ai/claude-code          # nunca com sudo

# para atualizar mais tarde: com @latest, não com npm update -g
npm install -g @anthropic-ai/claude-code@latest

インストールを確認する

claude --version   # mostra o número da versão, seguido de (Claude Code)
claude doctor      # diagnóstico só de leitura da instalação e das definições, sem abrir sessão

claude doctorはセッションを開始せず、インストールと設定ファイルの状態を表示します。問題がインストールにあるのか設定にあるのかを確認する最も速い方法です。

Um command not found: claude (ou, no Windows, a indicação de que claude não é um comando conhecido) quer dizer que o terminal não sabe onde o programa ficou. Muitas vezes basta fechar a janela e abrir outra. Se continuar, falta a pasta no PATH: no macOS e no Linux é ~/.local/bin, a acrescentar no ficheiro de arranque da shell (~/.zshrc ou ~/.bashrc); no Windows é %USERPROFILE%\.local\bin; segundo a 公式のトラブルシューティング, confirma-se e acrescenta-se assim no PowerShell:

# 1. A pasta de instalação já está no PATH?
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Sem resultado? Acrescente-a ao PATH do utilizador e abra uma janela nova
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Na janela nova: dois caminhos significam duas instalações lado a lado
where.exe claude

npmでインストールし、PowerShellがnpm.ps1 cannot be loaded because running scripts is disabled on this systemと返す場合は、PowerShellの実行ポリシーがnpmのスクリプトをブロックしています。ネイティブインストーラーを使用するか、ユーザー用にローカルスクリプトを許可してください。

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Claude Code does not support 32-bit Windowsと表示される場合は、「Windows PowerShell (x86)」が開かれています。WindowsにはPowerShellのエントリが2つあり、x86版は32ビットプロセスとして実行されます。「Windows PowerShell」を開き、「(x86)」のない方を選択してください。

初回使用：サブスクリプションまたはAPIキー

初回起動時に、Claude Codeの支払い方法を決めます。切り替えるために再インストールする必要はありません。決め手になるのは、キーが設定されているかどうかです。

ルートA — サブスクリプションでサインイン

プロジェクトフォルダでclaudeを実行し、ブラウザでサインインします。環境にすでにANTHROPIC_API_KEYがある場合は注意してください。ブラウザを開く代わりに、Claude Codeはそのキーを1回だけ承認するよう求めます。この承認を拒否すると、それ以降キーは無視され、質問も再表示されないため、変数が読み取られていないように見えます。再度有効にするには、/config → Use custom API keyを選択します。

ルートB — サブスクリプションなしでAPIキーを使用

ANTHROPIC_BASE_URLはClaude Code自体の変数で、プロキシまたはゲートウェイ経由でリクエストを転送するためのものです。そのため、AnthropicのMessages APIと互換性のあるエンドポイントを指定することは、プラグインや改変版を必要としない、サポートされた設定です。手順は次のとおりです。

1. Kunavoアカウントを作成する。
2. お支払いで、US$ 10から残高をチャージします（MB WAYでの支払いについては下記で説明します）。
3. /app/keysで、sk-kn-で始まるキーを作成します。キーは1度しか表示されないため、すぐに保存してください。
4. 変数を設定します。macOSとLinuxでは、~/.zshrcまたは~/.bashrcに設定します。

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # só o domínio, sem /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では、まずPowerShellのウィンドウでテストします。

# Vale só para esta janela do 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

永続的に使用する場合は、ユーザー設定のenvブロックが最適です：~/.claude/settings.json（Windowsでは%USERPROFILE%\.claude\settings.json）。ここで設定した値は、バックグラウンドエージェントを含むすべてのプロジェクトに適用されます。例外はVS Code拡張機能です（下記参照）。シェルでエクスポートした変数は、そのシェルから起動したプログラムにしか渡りません。Dockやスタートメニューから開いたエディターでは認識されません。ファイルに他の設定がすでにある場合は、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"
  }
}

絶対にしないでください ponha a chave no .claude/settings.json de um projeto: segundo a ゲートウェイの公式ドキュメント (consultada a 2026年10月3日), esse ficheiro entra nos commits e é partilhado com quem clonar o repositório. E atenção à precedência: quando a shell e um ficheiro de definições definem a mesma variável, prevalece o ficheiro de definições. Se uma alteração na shell não surtir efeito, veja primeiro o settings.json.

VS Code拡張機能を使用する場合は、VS Code自体のユーザー設定であるclaudeCode.environmentVariablesに変数を設定します（コマンドPreferences: Open User Settings (JSON)）。ゲートウェイのドキュメントによると、拡張機能は起動前にこの設定で認証情報を確認します。~/.claude/settings.jsonの値はClaude Codeプロセスには渡りますが、この確認には渡りません。

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

4つのモデル変数とその他の注意点

ブロック内の各行には注意点があります。

• ANTHROPIC_BASE_URLにはパスを含めません。/v1/messagesのパスはClaude Code自身が追加します。すでに/v1で終わるアドレスを指定すると、/v1/v1/messagesになり、404が返されます。
• ANTHROPIC_AUTH_TOKENまたはANTHROPIC_API_KEYのどちらでも構いません。Kunavoは両方を受け付けます。ゲートウェイのドキュメントによると、ANTHROPIC_AUTH_TOKENはAuthorization: Bearerヘッダーで送信され、すぐに適用されます。ANTHROPIC_API_KEYはx-api-keyヘッダーで送信され、対話モードでは有効になる前に1回承認する必要があります（ルートA参照）。そのため、このガイドではANTHROPIC_AUTH_TOKENを使用します。
• ANTHROPIC_MODELの名前は正確でなければなりません。ここに表示されているとおりにコピーしてください：claude-sonnet-5。
• ANTHROPIC_DEFAULT_SONNET_MODELとANTHROPIC_DEFAULT_OPUS_MODELを設定しないと、エイリアスが自動的に変わります。 Segundo a モデル設定に関する文書 (consultada a 2026年10月3日), para quem usa a API da Anthropic o alias opus aponta para o Opus 5.5 e o alias sonnet para o Sonnet 5.5, e estes aliases mudam com as novas versões. Fixa-se com o nome completo do modelo ou com variáveis como ANTHROPIC_DEFAULT_OPUS_MODEL. O Kunavo não serve o Sonnet 5.5, e um modelo que não existe devolve 404: sem ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5, falham o /model sonnet, os subagentes com model: sonnet e o passo de execução do opusplan. Já o opus aponta para claude-opus-5-5, que o Kunavo serve, mas só a partir do Claude Code v2.1.280; quem tiver uma versão anterior corre claude update.
• ANTHROPIC_DEFAULT_HAIKU_MODELはバックグラウンドタスクにも適用されます。ドキュメントによると、これはhaikuエイリアスとClaude Codeのバックグラウンド機能用モデルを設定します。Claude Haiku 4.5を使用すると、これらの呼び出しには下表で最も安価なモデルが使われます。

Preços por milhão de tokens, do catálogo do Kunavo; a coluna da Anthropic vem de claude.com/pricing (consultado a 2026年10月3日):

セッション中に/model claude-opus-5-5でモデルを切り替えるか、claude --model claude-opus-5-5ですぐに起動できます。ユーロ建ての料金、月間使用例、サブスクリプションの方が得になる分岐点については、Claude Codeのユーロ価格をご覧ください。個々の使用量はトークンコスト計算ツールで計算できます。すべてのモデルと料金は料金ページに掲載されています。

/statusで確認する

claudeを実行します。ANTHROPIC_AUTH_TOKENが設定されている場合、サインイン画面は表示されません。変数はすぐに適用されます。サインイン画面が表示される場合、Claude Codeはキーを読み取れていません。その場合は、初回起動アシスタントより前にClaude Codeが読み取る場所で設定してください。シェルのexport、または~/.claude/settings.jsonのenvブロックです。プロジェクトの.claude/settings.jsonまたは.claude/settings.local.jsonにあるenvブロックは、対話セッションでは、初回起動アシスタントとフォルダを信頼するかどうかの質問の後にのみ適用されます。

Dentro da sessão, escreva /status e procure duas linhas no separador Status (fonte: a ゲートウェイの公式ドキュメント, consultada a 2026年10月3日):

• Anthropic base URLにはhttps://api.kunavo.comが表示されるはずです。この行はゲートウェイアドレスが設定されている場合にのみ表示されます。ない場合、ANTHROPIC_BASE_URLはセッションに渡されていません。
• Auth token行にはANTHROPIC_AUTH_TOKENが表示されるはずです。代わりにclaude.aiアカウントでLogin methodが表示される場合、変数が読み取られておらず、セッションはサブスクリプションを使用しています。

サブスクリプションですでにサインインしていた場合、起動時に2つの認証情報が有効であるという警告が表示されることがあります（メッセージはauth may not work as expectedで終わります）。リクエストはキー経由で送信されます。/logoutで古いサインインを消去できます。

Claude Codeを開く前にアドレスとキーをテストするため、ドキュメントでは出力トークン1つだけのリクエストを推奨しています。残高のごくわずかな一部しか消費しません。コマンドはシェルの変数を読み取るため、すでに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と音声ディクテーションは利用できません。ゲートウェイのドキュメントによると、ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN、またはapiKeyHelperが有効な間は利用できません。さらに、ANTHROPIC_BASE_URLがAnthropic以外のアドレスを指している間はRemote Controlも無効になります。
• /fastは高速モードを無効として表示します。ベアラートークンのみの場合、Claude Codeは高速モードを無効として扱います。
• MCPツール検索（MCP tool search）はデフォルトで無効です quando ANTHROPIC_BASE_URL aponta para um endereço fora da Anthropic (環境変数のドキュメント, consultada a 2026年10月3日).
• /contextの数値は推定値です。 O Kunavo não serve /v1/messages/count_tokens e, segundo a ゲートウェイの互換性ドキュメント (consultada a 2026年10月3日), sem esse endpoint o Claude Code recorre a uma estimativa baseada em caracteres.

その他の機能 — コード、ツール、サブエージェント、MCPサーバー、フック、プロンプトキャッシュ — は従来どおり動作します。詳細はClaude Code統合ドキュメント（英語）とClaude Code without a subscription（英語）をご覧ください。

MB WAYで残高を支払う

Primeiro, a subscrição: uma subscrição Claude comprada no site paga-se só com cartão de crédito ou de débito (Anthropicの有料プランに関するヘルプ記事, consultado a 2026年10月3日); numa subscrição feita na aplicação Claude para iOS ou Android, os meios de pagamento são os da App Store ou do Google Play. Os meios de pagamento do Kunavo, MB WAY incluído, não pagam o Claude Pro nem o Max: carregam o saldo da API do Kunavo, que é o que a Rota B usa.

O saldo carrega-se no checkout da Stripe. Os preços estão em dólares americanos; para quem compra em Portugal, a Stripe mostra o valor em euros. Segundo a Adaptive Pricingに関するStripeのドキュメント (consultada a 2026年10月3日), essa conversão inclui uma comissão de 2–4% paga pelo comprador; quem escolhe pagar em dólares (com cartão, Apple Pay, Google Pay ou Link) não paga essa comissão, embora o banco possa aplicar a sua própria taxa de câmbio e comissões. O MB WAY só funciona em euros. No checkout em euros aparecem:

• MB WAY。 Escolhe-se MB WAY, introduz-se o número de telemóvel e confirma-se a compra na aplicação MB WAY, através da notificação ou na área de atividade (MB WAYに関するStripeの説明 e オンライン購入に関するMB WAYの説明, consultados a 2026年10月3日). Segundo a Stripe, são aceites números internacionais, mas a maioria dos clientes usa um número português, começado por +351.
• カード（Visa、Mastercard）、Apple Pay、Google Pay、Link。

Não aparecem: referências Multibanco (pagamento por entidade e referência), PayPal, débito direto SEPA e Klarna, que só aparece a compradores nos Estados Unidos. A conversão para euros vem do Adaptive Pricing da Stripe, e a lista de meios de pagamento que ele disponibiliza inclui o MB WAY mas não o Multibanco. O MB WAY também permite gerar cartões virtuais MB NET para compras online (MB NETに関するMB WAYの説明, consultado a 2026年10月3日); não está confirmado que o campo do cartão do checkout os aceite, por isso o caminho seguro é escolher MB WAY diretamente.

StripeがMB WAYについて文書化している内容（2026年10月3日に確認）：

• 1回の支払い：0.50 €～5000 €。
• 1日あたり：デフォルトでは1000 €、MB WAYアプリで最大10 000 €まで変更可能です。高額なチャージはデフォルトの日次上限を超える場合があります。その場合は、支払う前にアプリで上限を引き上げてください。チェックアウトに表示されるユーロ金額と、これらの上限を比較してください。
• 継続支払い：サポートされていません。
• 明細には、取引金額とともにStripeの名前（Stripe Inc）が表示されます。

1. Kunavoアカウントを作成する。
2. お支払いで、US$ 10以上の金額を選択します。高額なチャージには追加残高が付与されます：quem carrega US$ 100 recebe US$ 110; quem carrega US$ 1000 recebe US$ 1200; quem carrega US$ 5000 recebe US$ 6250。
3. Stripeのチェックアウトでユーロ金額を確認し、MB WAYを選択して携帯電話番号を入力し、MB WAYアプリで購入を確認します。確認前にユーロ金額が表示されます。
4. /app/keysでキーを作成し、ANTHROPIC_AUTH_TOKENに設定します。

残高は前払いです。月額料金はなく、残高に有効期限はなく、失敗したリクエストには課金されません。自動チャージは、保存済みのカードまたはLinkでのみ機能します。MB WAYでは、Stripeによると継続支払いに対応しておらず、今後の支払い用に保存されることもないため、毎回手動でチャージします。Kunavoは、納税者番号（NIF）またはVAT番号の有無にかかわらず、請求書を発行しません。チャージ履歴はBillingに保存されます。これらの支払い方法でチャージできるのはKunavo APIの残高のみです。詳細はMB WAYでClaudeの料金を支払うをご覧ください。

よくあるエラー

インストール後

プロジェクトでの初回起動時に/initと入力します。Claude Codeはリポジトリを調べ、推測した内容をCLAUDE.mdに書き込みます。プロジェクトの実行方法、変更のテスト方法、従うスタイル規則などです。このファイルを確認し、短く保ってください。すべてのセッションで読み込まれるためです。独立したタスクの間では/clearで新しい会話を開始し、長いタスクでは/compactで履歴を要約して続行します。

知っておくとよいこと

• トークン単位で支払うAPIであり、Claude ProまたはMaxのサブスクリプションではありません。毎日何時間もClaude Codeを使用する人は、通常サブスクリプションの方が安くなります。不定期な使用ではトークン単位の方が得で、使用しない月は費用がかかりません。ユーロでの比較はClaude Codeのユーロ価格をご覧ください。
• APIキーを使用する場合、Remote Controlと音声ディクテーションは利用できません。
• Kunavo経由では、予約済みクォータや契約上の保証のない共有キャパシティを使用します。それらが必要な場合は、Anthropicと直接契約してください。
• MB WAYは手動チャージ専用です。自動チャージにはカードまたはLinkが必要です。
• チェックアウトに表示されるユーロ金額には、Stripeの換算手数料がすでに含まれています。

よくある質問