アルアカ - Arcadia Academia

Anthropic社の大規模言語モデル Claude を、Windows上でCLI（コマンドラインインターフェース）から利用する方法を解説します。Anthropicの公式ツール「Claude Code」を使うことで、エンジニアはIDEに頼らずターミナル上でClaudeを操作できます。本記事では、Windowsでのセットアップ手順から実行例、よくあるエラー対処、そしてライセンスや利用上の注意点まで、順を追って説明します。

Claude CodeはAnthropicが提供する公式CLIツールで、ターミナルからClaudeを利用できるようにするものです。特にコードベースの理解や生成、編集などを自然言語コマンドで行えるAIコーディングアシスタントとして設計されています。AnthropicはこのCLIをベータ版として公開しており、エンジニアは自身の開発環境に組み込んで活用できます。

入手方法: Claude Codeはnpm経由で配布されています。Node.js（後述）の環境が整ったら、以下のコマンドでグローバルインストール可能です。

npm install -g @anthropic-ai/claude-code

このコマンドにより、CLI実行ファイルclaude（場合によってはclaude-code）がパスにインストールされます。以降はターミナルでclaudeコマンドを使ってClaudeを操作できます。

公式リソース: AnthropicはClaude Codeの詳細なドキュメントを公開しています。例えば、公式ドキュメントではセットアップ手順やCLIコマンド一覧、設定方法が解説されています。セットアップ中に困った場合は公式のトラブルシューティングガイドも参照できます。最新リリース情報や変更点はGitHub上のCHANGELOGで確認できます（AnthropicはClaude Codeを頻繁に更新しているため、自動アップデート機能も備わっています）。

📝 補足: Claude Codeは2023～2024年頃に登場した比較的新しいツールです。当初はMac/Linuxのみ対応でしたが、2025年7月にWindows正式対応が発表されましたgoddaehee.tistory.com。現在はWindowsユーザも公式にサポートされた手順で利用可能です。

WindowsでClaude Code CLIを使うには、Node.js 18以上の実行環境と、Linux様式のシェル環境が必要です。以下では、セットアップ手順をわかりやすくステップごとに説明します。

Claude CodeはNode.js製のCLIツールです。そのためNode.js (version 18以降) がインストールされている必要があります。公式サイトやNode Version Manager (nvm) を利用して、WindowsにNode.jsを導入してください。インストール後、コマンドプロンプトやPowerShellで以下を実行し、バージョンを確認します（npmはNode.jsに同梱）:

node -v && npm -v

Claude CodeはUNIX系シェルで動作するよう設計されており、WindowsネイティブのコマンドプロンプトやPowerShellでは直接動作しません。「Windows Subsystem for Linux (WSL)」やGit Bashを用いてLinux互換の環境を用意しましょう。

• 方法A: WSLを使用する – WSL1またはWSL2上にUbuntu等のLinuxディストロをインストールし、そのLinuxターミナル内でClaude Codeを実行します。WSLの有効化は管理者権限のPowerShellからwsl --installコマンド一発で可能です。初回セットアップ後、bashやUbuntuターミナルを開き、この中で以降の作業を行います。
• 方法B: Git Bashを使用する – Git for Windowsをインストールすると利用できるGit Bash上でClaude Codeを動かす方法です。Anthropic公式によれば、Git Bashを使う場合はGit for Windowsのインストールが必要であり、ポータブル版を使う場合は環境変数CLAUDE_CODE_GIT_BASH_PATHでbash.exeのパスを指定します。通常はGitをインストールすればパスが通るので、そのまま「Git Bash」ターミナルを起動してください。

🔍 参考: Anthropic公式ドキュメントでも、WindowsでClaude Codeを使うには「Option 1: WSL経由」または「Option 2: Git Bash経由」のどちらかを推奨していますdocs.anthropic.com。以前はWSL必須でしたが、現在はGit Bash（内部的にはMinGWのLinux互換レイヤ）でも動作可能です。

Node.js環境と適切なシェルが準備できたら、前述のnpmグローバルインストールコマンドを実行します。

npm install -g @anthropic-ai/claude-code

インストールが成功すると、claudeというCLIコマンドが使えるようになります。正しくインストールされたかバージョン確認してみましょう:

claude --version

もしバージョン情報が表示されればOKです。command not foundとなる場合は、パスが通っていない可能性があります。もう一度インストールログを確認するか、シェルを再起動してみてください。

⚠️ 注意: インストール時に管理者権限やsudoは使わないでくださいdocs.anthropic.com。sudo npm install -gは権限問題やセキュリティ上のリスクにつながる恐れがあります。権限エラーが出る場合、後述の「トラブルシューティング」で解決策を紹介します。

Claude Codeは現在のディレクトリをワークスペースとして扱います。CLIを起動する前に、作業したいプロジェクトのフォルダに移動しておきましょう。例えば:

cd C:\path\to\your-project  # Windowsパスの場合
# もしくは WSL/Linux 環境なら:
cd /mnt/c/path/to/your-project

このディレクトリ内のコードをClaudeが参照し、内容理解や編集提案などを行います。

準備が整ったら、いよいよCLIを起動します。方法は2通りあります。

• 対話モードで起動: 単にコマンドclaudeと入力すると、対話的なREPLモードが開始します。プロンプトが表示されたら、ユーザとしてClaudeに指示を出して会話する形で利用できます。
• ワンショット実行: コマンドと質問内容を1行で与え、結果を即座に出力させることも可能です。例えば、以下のようにpフラグ（print mode）を使うと対話に入らず一度きりの応答を得られます。
  Copy

  claude -p "Hello, Claude! 今日は調子はどう？"

上記では"Hello, Claude! 今日は調子はどう？"というユーザメッセージを送り、その返答だけを表示して終了します。また、パイプでファイル内容を渡すこともできます (cat foo.txt | claude -p "次の内容を要約して" など)。

✅ この段階までで、Windows上でClaude Code CLIをインストールし起動する環境は整いました。次章では、実際の使用方法や具体例を見てみましょう。

Claude Codeを利用するには、AnthropicのAPIアクセス権限が必要です。大きく分けて以下の認証オプションがあります。

1. Anthropic開発者コンソール経由 (APIキー方式) – Anthropicの開発者用コンソールに登録し、APIキーを発行して利用する方法です。こちらは従量課金制で、利用にはクレジットカード登録等の有効な課金設定が必要です。無料アカウント自体は作成できますが、APIを使うには請求情報の設定が求められます。
2. Claude.ai Pro/Maxプラン – Claudeの有料サブスクリプションプランに加入している場合、そのアカウントでCLIにログインできます。ProまたはMaxプランではWeb版とClaude Codeの両方が使える統合プランとなっており、この方法だと定額内で利用可能です。
3. エンタープライズ向け統合 – AWS BedrockやGoogle Vertex AI経由でClaudeを利用している企業は、それらプラットフォームの資格情報でClaude Codeを動かすこともできます。ただし一般的な開発者向けではないので、本記事では割愛します。

APIキー方式の設定手順:

• Anthropicアカウント登録: まずAnthropicの開発者向けサイト（Anthropic Console）でアカウントを作成します。登録後、ダッシュボードからAPIキーを発行してください。APIキーはユーザごとに一意の文字列です。
• キーの環境変数登録: 発行したAPIキーをシェル環境に設定します。具体的には、環境変数ANTHROPIC_API_KEYにキーを格納します。例えばWSLのbashの場合、以下を実行します。
  Copy

  echo "export ANTHROPIC_API_KEY=<取得したAPIキー>" >> ~/.bashrc
  source ~/.bashrc

  WindowsのGit Bashでも同様に.bashrcや.bash_profileに追加できます。これで、Claude Code CLIは自動的にこの環境変数を読み取り、APIキーを使用してAnthropicのクラウドに認証します。

• 認証確認: 正しく設定できたか、CLIで確認してみましょう。claudeコマンドを実行すると初回起動時にAnthropicアカウントとの接続方法を選ぶプロンプトが表示されることがあります。その際「Use API key」のような選択肢があればそれを選びます。あるいは、claude-code whoamiコマンドを実行すると現在認証中のユーザ情報が表示されます。自分のアカウント名やプランが出れば認証成功です。

ℹ️ メモ: APIキーを環境変数に設定しておけば、CLI起動時にブラウザでOAuth認証する手間が省けます。Anthropic Console経由のOAuthではブラウザでログインしトークンを取得するフローになりますが、環境変数に有効なキーがあれば自動的に認証に使用されます。

APIキー取得における注意点:

• AnthropicのAPI利用には地域制限があります。公式サイトの記載によれば、サービスが利用可能な国に居住している必要があります。
• API利用料はリクエストしたトークン数に応じた従量課金です。無料枠が提供されているか時期によって異なりますが、基本的にはOpenAIのAPI同様、使った分だけ料金が発生します。料金詳細はAnthropicの公式サイトのPricingページを確認してください。
• Claude.aiのPro/Maxプラン経由で使う場合は月額費用内で一定量のトークンが利用できます。大量のコード解析などを行う場合は、この定額プランも検討すると良いでしょう。

それでは、Claude Code CLIを実際に使ってみましょう。ここではいくつか典型的なコマンド例を紹介します。

ターミナル上でclaudeと入力しEnterを押すと、対話モードがスタートします。プロンプト（>など）が表示されたら、そこに自然言語で指示を入力できます。例えば:

> ユーザー: このリポジトリの全体構成を要約してください。

するとClaude（AI）がリポジトリ内のファイル構成や内容を分析し、以下のような回答を返します。

AI: 現在のプロジェクトは以下のような構成になっています。
1. src/ ディレクトリ - アプリケーションのソースコードが含まれています。
2. src/api.js - データ取得用の関数fetchData()が定義されています。
3. ...（以下略）...

※上記は回答の一例です。Claude Codeはディレクトリ内のコードを把握した上で回答してくれます。インタラクティブモードでは、追加の質問や指示を続けて入力することで会話の文脈を保ったままAIとやり取りできます。

対話モードではなく、コマンド一発で処理と結果を得たい場合は、先述の-pオプションを使います。例えば、コードの説明や生成を単発で行うには以下のようにします:

claude -p "utils/api.js内のfetchData()関数が何をするか説明してください。"

このコマンドを実行すると、CLIは即座に該当関数の説明を出力して終了します。出力例:

fetchData()関数は指定されたエンドポイントURLからデータを取得し、JSON形式にパースして返す役割を持っています:contentReference[oaicite:35]{index=35}。具体的には内部でJavaScriptのfetch APIを呼び出し、レスポンスをawaitで待ってからJSONに変換しています。

上記のように、Claudeがコードを読んで自然言語で解説してくれます。-pを付けた場合は対話セッションを開始せず一度だけ応答するため、スクリプト等から呼び出す際にも便利です。

💡 ヒント: コマンド実行時に--output-format jsonフラグを付けると、Claudeの応答をJSON構造で受け取ることもできます（スクリプトでパースしたい場合に有用）。

Claude Codeの特徴は、自然言語でコードの生成やリファクタリングを依頼できることです。以下にいくつか例を示します。

• コード自動生成:
  Copy

  claude -p "与えられたJSONデータを読み込みCSVに変換するPythonスクリプトを書いて"

  結果: 指定した要件に沿ったPythonコードを生成して出力します。必要に応じてファイルの書き込み処理等も含めて提案してくれます。

• コードのリファクタリング:
  Copy

  claude -p "src/app.tsの中でコールバックを使っている部分をasync/awaitに書き換えて"

  結果: 指定ファイルを解析し、該当箇所の書き換え提案を行います（場合によっては差分パッチのような形式で出力されます）。

• ユニットテストの生成:
  Copy

  claude -p "ユーザー入力を検証する関数validateInputの単体テストをJestで作成して"

  結果: 関数validateInputに対するJest形式のテストコードを生成します。いくつかの代表的なケース（有効な入力、無効な入力など）を網羅したテストが出力されます。

これらはほんの一例ですが、Claude Codeはリポジトリ内のコンテキストを考慮しながら高度なコード操作を行ってくれます。対話モードではさらに細かい指示（「今の出力をファイルに保存して」といった操作）や修正の依頼も可能です。

📌 参考: 単発のCLIコマンド例として、公式ガイドでは次のような使用方法が紹介されています:

Copy

claude-code "write a python function to calculate the factorial of a number"

上記コマンドでは、与えたプロンプトに対する回答としてPythonの階乗計算関数を生成します。同様に、標準入力にコードをパイプして「このコードに型ヒントを付与して」と指示することもできます。

セットアップや利用時に遭遇しがちなエラーやトラブルと、その対処方法をまとめます。

• エラー: 「Claude Code is not supported on Windows.」と表示される

  原因: WSLやGit Bashではなく、Windowsのネイティブ環境でインストール/実行しようとした可能性があります。Claude Codeは従来Windows非対応であったため、npm経由インストール時にこのエラーが出ることがありました。

  対処: 上述の通り、WSL上のLinuxまたはGit Bash経由でCLIを実行してください。最新バージョンではGit Bashを用いることでWSL無しでも動作しますが、コマンドプロンプトやPowerShell単体では動きません。

• エラー: グローバルインストールで「EACCES: permission denied」権限エラー

  原因: npm install -gで管理者権限がなくインストール先に書き込めない、または誤ってsudoを使ったことでパーミッションがおかしくなった場合に発生します。

  対処: 絶対にsudoを使わないでください。代わりに、npmのグローバルディレクトリをユーザ権限のディレクトリに変更するのが安全です。例えば:

  1. npm config set prefix ~/.npm-globalでグローバルインストール先をホームディレクトリ直下に変更。
  2. シェルの設定ファイルにexport PATH=~/.npm-global/bin:$PATHを追記し、source ~/.bashrcで反映。
  3. 再度npm install -g @anthropic-ai/claude-codeを実行。

     これで権限エラーが解消するはずです。もしくは、Anthropic推奨のclaude migrate-installerコマンドでローカルインストール方式に切り替える方法もあります。

• エラー: exec: node: not found と表示されClaudeが起動しない

  原因: WSLを使用している場合に多いトラブルで、WSL内で正しくNode.jsが認識されていないケースです。which nodeコマンドでパスを確認すると、/mnt/c/...とWindows側のNodeパスになっていることがあります。これはWSL内でWindowsのNode実行ファイルを参照している状態です。

  対処: WSL上でLinux用のNode.jsをインストールし直す必要があります。aptやnvmでNodeを導入し、which nodeで/usr/bin/nodeなどLinux側のパスになることを確認してください。既にWindowsにNodeを入れている場合でも、WSL用に別途セットアップが必要です。

• エラー: WSLでnpm install時にOSチェックに失敗する

  原因: npmがWindows用として動作しており、Claude CodeパッケージのOS要件チェックが誤検知している可能性があります。

  対処: インストール前にnpm config set os linuxを実行し、OSをLinuxとして設定します。その後、npm install -g @anthropic-ai/claude-code --force --no-os-checkオプション付きでインストールを試みてください。--no-os-checkによりOS非対応エラーを無視してインストールできます。

• その他トラブル: 初回起動時にブラウザでの認証がうまくいかない場合、環境変数に正しいAPIキーがセットされているか再確認してください。claude-code whoamiで認証状態を確認したり、claude logoutコマンドが用意されている場合は一度ログアウトして再設定するのも手です。また、CLI内で動作する外部ツール（例えばgitコマンドなど）が見つからないと言われた場合、PATHが通っているか、WSLからWindowsコマンドを呼ぶ必要があるケースでは適切に設定されているか確認しましょう。

Claude Codeを利用するにあたり、ライセンスおよび利用制限についても知っておくことが重要です。

• ライセンス: Claude Code自体のソースコードはAnthropicの商用ライセンス下で提供されています。これはオープンソースのApache 2.0ライセンスで公開されているOpenAIのCodex CLIなどとは異なり、改変や再配布に制限があることを意味します。実際、AnthropicはClaude Codeのコードを無断解析・公開しようとした開発者に対してDMCAテイクダウン通知を行った例もあります。要するに、Claude CodeはAnthropicの利用規約に従って使用するもので、ソフトウェア自体を勝手に再利用・再販することは許可されていません。
• 利用目的・制限: AnthropicのCommercial Terms of Serviceによれば、Claude（およびClaude Code）の利用に際してはいくつかの制約があります。例えば、違法行為への利用や、他者のプライバシーを侵害するような用途は禁止されています。また、出力されたコードやテキストの内容についてユーザが責任を持つ必要があります。機密情報を含むコードベースを扱う際には、そのデータがAnthropicのクラウドに送信されることを念頭に置きましょう。
• データの取り扱い: AnthropicはClaude Codeの利用データを一部収集していますが、プライバシーには配慮しています。ユーザがCLI上で行った操作やAIとのやり取りの記録はフィードバックデータとして収集されますが、これらはモデルの再学習には使用しない方針が明言されています。加えて、会話内容等のログは最大30日間のみ保存し、その後は削除されるとされています。企業利用で機密性が求められる場合、AnthropicとZero Data Retention（ZDR）契約を結ぶことでログ保存を行わない運用も可能です。
• 料金と利用制限: 前述の通り、API経由でClaudeを使う場合はトークン数に応じた料金が発生します。Claude Codeは便利な反面、大量のコードを読み書きするとトークン消費も多くなりがちです。開発中は/costコマンド（CLI内で利用可能）で現在のコストを確認したり、Anthropicコンソールで予算アラートを設定すると安心です。なお、無料枠がある場合でも上限を超えるとリクエストが失敗しますので注意してください。
• 出力結果のライセンス: AIが生成したコードの著作権取り扱いは明確に定まっていませんが、一般的には生成物に対するAnthropic自身の主張はなく、利用者が自由に使えるものと考えられます（ただし生成コード中にオープンソースコード片が混入する可能性はゼロではないので、大切なコードに取り入れる前にレビューすることをお勧めします）。
• ベータ版であること: Claude Codeは記事執筆時点でベータリリースと位置付けられています。そのため、予期せぬ不具合や挙動の変更が起こりうる点には留意してください。Anthropicは自動アップデートで機能改善やバグ修正を随時リリースしています。安定性が重要なプロジェクトで使う際は、バージョン固定や事前の検証を行うと良いでしょう。

以上、Windows環境でAnthropic Claude（Claude Code CLI）をセットアップし活用する方法を解説しました。適切な環境構築と認証設定を行えば、強力なAIアシスタントをターミナルから自在に操ることができます。エンジニアの皆さんはぜひ自身のプロジェクトに取り入れて、生産性向上や新しいコーディング体験を試してみてください。Claude Codeがあなたの開発を加速してくれることでしょう！