WindowsでAIコーディングを始める際、多くの開発者が慣れ親しんだGit Bashを選択します。しかし、単にAnthropic CLI インストールを行うだけでは、対話モードが動かなかったりパスの指定でエラーが出たりと、Windows特有のトラブルに遭遇しがちです。
この記事では、Git Bash Claude 設定の手順を網羅し、Claude Code 使い方 Windowsでの最適解を解説します。環境変数の永続化からエラー回避のコツまでをマスターし、Windows環境での開発速度を劇的に向上させましょう。
Windows環境にClaude Codeを導入する準備
WindowsでAI開発を始めようとすると、Mac用の解説記事ばかりで戸惑うことはありませんか。特にGit Bashなどのターミナル環境では、特有の動作不良が原因で作業が止まることがよくあります。この記事の設定を済ませれば、Windowsでも迷うことなくAIコーディングを武器にできるようになります。
Node.jsのインストールとバージョン確認
Claude Codeを動かすには、実行環境としてNode.jsが必要です。公式サイトからLTS版（推奨版）のインストーラーをダウンロードし、インストールを完了させてください。
2026年時点では、バージョン18.0.0以上が必須となっています。インストール後、Git Bashで node -v と入力し、数字が正しく表示されるか確認しましょう。古いバージョンでは動作しません。
Git for Windowsのセットアップ
WindowsでUnixライクな操作を行うには、Git for Windowsの導入が不可欠です。すでにGitを使っている場合でも、最新版に更新しておくことをお勧めします。
インストール時のオプションでは、ターミナルとして「MinTTY」を選択してください。これがGit Bashの標準的なウィンドウになります。標準設定のまま進めれば問題ありません。
ターミナルとしてGit Bashを選ぶ理由
Git BashはWindows上でLinuxに近いコマンド操作を提供します。これにより、AIが提案する多くのスクリプトやコマンドを修正なしで実行可能です。
コマンドプロンプトやPowerShellよりも、パスの扱いがAIにとって理解しやすい形式になります。開発効率を優先するなら、Git Bashが最も無難な選択肢です。
Git BashでCLIツールをインストールする手順
インストール自体はコマンド一つで済みますが、Windows特有の「権限」が壁になることがあります。管理者権限が必要な場面や、パッケージの保存場所を間違えると、後でツールが呼び出せなくなるリスクがあります。スムーズに導入を完了させるための、具体的な入力手順を見ていきましょう。
npmコマンドによる一括導入
Git Bashを開き、以下のコマンドをコピーして貼り付けてください。エンターキーを押すとダウンロードが始まります。
npm install -g @anthropic-ai/claude-code
グローバル（-g）を指定することで、どのフォルダからでもAIを呼び出せるようになります。完了まで1分ほど待ちましょう。
グローバルインストールの権限問題
インストール中にエラーが出る場合は、Git Bashを「管理者として実行」してから試してください。Windowsではシステムフォルダへの書き込みが制限されているからです。
右クリックメニューから「管理者として実行」を選びます。これでフォルダ作成の権限が付与され、エラーが解消されます。権限不足はよくある失敗例です。
インストール完了の動作確認方法
コマンドの実行が終わったら、正しく認識されているかテストします。ターミナルに claude --version と入力してください。
数字が表示されれば成功です。もし「command not found」と出る場合は、Node.jsのパスが通っていません。一度ターミナルを再起動してください。
認証を済ませてClaudeを使える状態にする
ツールを導入しただけでは、まだAIと会話することはできません。AnthropicのアカウントとあなたのPCを紐付ける「認証」という工程が必要です。ブラウザを立ち上げてログインするだけの簡単な作業ですが、会社のネットワーク環境などによってはブロックされることもあります。正しい手順で確実に接続を確立させましょう。
claude authコマンドの実行
ターミナルで claude auth と入力します。これが認証を開始するための合言葉です。
実行すると、認証用のURLが表示されます。自動でブラウザが開かない場合は、そのURLをコピーして貼り付けてください。すぐにログイン画面が現れます。
ブラウザ経由でのアカウント承認
ブラウザでAnthropicのアカウントにログインしてください。APIの利用に関する承認を求められるので「許可」を選択します。
承認が終わると、ターミナル側で「Success」というメッセージが表示されます。これで、あなたのPCからClaudeの脳へアクセスできるようになりました。
APIキーを直接入力して接続する手順
ブラウザでの認証がうまくいかない場合は、APIキーを直接使う方法があります。Anthropicのコンソール画面からキーを発行してください。
そのキーを環境変数として設定すれば、ログインなしで利用可能です。セキュリティのため、キーは他人に教えないでください。
環境変数を設定してキーの入力を省略する
毎回キーを入力したり、ログインし直したりするのは非常に面倒です。WindowsのGit Bashには、起動時に自動で設定を読み込む仕組みがあります。ここにAPIキーを登録しておけば、パソコンをつけた瞬間からAIコーディングを開始できるようになります。初心者には少し難しく感じるかもしれませんが、一度設定すればずっと楽になります。
.bashrcファイルの作成と編集
Git Bashの設定ファイルである .bashrc を作成します。ホームディレクトリ（ユーザーのトップフォルダ）に配置するファイルです。
touch ~/.bashrc と入力してファイルを作ります。次に notepad ~/.bashrc でメモ帳を開きましょう。ここに設定を書き込んでいきます。
exportコマンドによるキーの永続化
メモ帳に以下の内容を書き込んでください。鍵の部分は、あなたが取得した実際のキーに置き換えます。
export ANTHROPIC_API_KEY='sk-ant-api03-xxxx'
保存してメモ帳を閉じます。これで、Git Bashは起動するたびにあなたのキーを自動で読み込みます。シングルクォーテーションを忘れないでください。
設定をターミナルに反映させる処理
ファイルを書き換えただけでは、今のターミナルには反映されません。source ~/.bashrc と入力して、設定を読み込ませてください。
これで設定が有効になりました。次回からは、Git Bashを開いて claude と打つだけで会話が始まります。
| 設定ファイル名 | 役割 | 優先度 |
| .bashrc | Git Bash専用の設定 | 高い（推奨） |
| .bash_profile | ログイン時に読み込む | 中 |
| 環境変数(Windows) | OS全体の設定 | 低い（反映が遅い） |
Git Bash特有の動作を安定させる設定
WindowsでGit Bashを使う際、最大の悩みとなるのが「対話モードが固まる」現象です。AIが質問を投げかけてきても、文字が入力できなくなったり、画面が真っ白になったりすることがあります。これはWindowsのコンソール制御が特殊なために起こる問題です。解決策として winpty という仕組みを導入し、動作を安定させましょう。
winptyを用いたインタラクティブモードの確保
Git Bashで対話型プログラムを動かすには winpty をコマンドの頭に付けます。これが橋渡し役となり、入力を正常に伝えます。
winpty claude と入力して起動してください。これで、AIとのやり取りで文字が打てなくなるトラブルが消えます。必須の設定です。
エイリアス設定でコマンドを短縮する
毎回 winpty を打つのは非効率です。短い言葉で済むように「別名（エイリアス）」を登録してしまいましょう。
.bashrc ファイルに alias claude='winpty claude' と追記してください。次からは claude と打つだけで、自動的に winpty が適用されます。
日本語の文字化けを防ぐ文字コード設定
AIからの回答が「????」と化ける場合は、文字コードが合っていません。Git Bashのウィンドウ上部を右クリックし、「Options」を開きます。
「Text」項目で、Character setを「UTF-8」に変更してください。これで日本語が綺麗に表示されるようになります。
ターミナルからAIへ送る実戦的なプロンプト 3つ
環境が整ったら、実際にAIにコードを書かせてみましょう。ターミナル上で動くClaude Codeは、あなたのプロジェクトフォルダの中身をすべて把握しています。「このファイルを読んで」と細かく指定しなくても、文脈を理解して的確な提案をしてくれます。仕事でそのまま使える、高精度な指示の出し方を紹介します。
1. プロジェクトの構造を解析させる命令
初めて触るソースコードの内容を把握するための指示です。
現在のディレクトリにあるすべてのファイルをスキャンし、主要なコンポーネントの依存関係を図解のようなテキストで説明してください。
構造が分かれば、修正すべき場所もすぐに見つかります。全体像を掴むのが効率化のコツです。
2. ファイル横断でコード修正を命じるプロンプト
一箇所の変更に伴い、他のファイルも直させる指示です。
srcフォルダ内のすべてのAPI呼び出し箇所に対し、新しい認証ヘッダーの形式を適用してください。修正後は自動でビルドテストを実行してください。
手動での修正漏れを物理的に防げます。一括修正はAIが最も得意とする作業です。
3. バグの特定と自動修正を依頼する命令
エラーログから原因を探り、直させる指示です。
実行ログにあるエラー文を解析し、原因となっている箇所を特定してください。修正案を提示し、私の承認後にファイルを書き換えてください。
原因調査の時間を大幅に削れます。あなたは提案をチェックするだけで済みます。
スラッシュコマンドで履歴とコストを管理する
AIを使いすぎると、通信量（トークン）が増えて料金がかさみます。また、会話が長くなりすぎると、AIの記憶が混濁して回答の質が落ちることもあります。これを防ぐために、Claude Codeには便利なスラッシュコマンドが用意されています。これらを使いこなして、賢く低コストにAIを運用しましょう。
/compactによるトークン消費の節約
会話が長くなってきたら /compact と入力しましょう。これまでの経緯をAIが要約し、不要なデータを捨てます。
通信量が減るため、1回あたりの利用料金を抑えられます。「動きが重い」と感じた時にも有効なコマンドです。
/configでモデルや動作をカスタマイズする
/config と打つと、現在の設定を確認・変更できます。使用するAIモデルの切り替えもここで行います。
精度を重視するか、速度を重視するかを選べます。自分の作業スタイルに合わせて調整しましょう。
/searchでコードベースを高速検索する
特定のキーワードが使われている場所を /search 検索語 で探せます。grepコマンドよりも直感的です。
「意味」で検索してくれるため、正確な綴りを覚えていなくても見つかります。ファイルを開き直す手間が省けます。
Git連携機能で開発の流れを自動化する
コーディングが終わった後のGit操作も、AIに任せることができます。変更内容をAIが読み取り、適切なメッセージと共にコミットまで完了させます。あなたはブラウザや専用ソフトを開く必要はなく、ターミナル内ですべての工程を完結させられます。作業の中断がなくなるため、集中力を維持したまま開発を進められます。
差分に基づいたコミットメッセージの自動生成
claude "変更をコミットして" と命じるだけで、AIが差分を分析します。
何を変えたのかを正確に説明する文章を自動で書きます。「update」のような適当なメッセージを卒業できます。
ブランチ作成からPR作成までの自動処理
新しい機能を作る際、ブランチの作成からプルリクエスト（PR）の提出まで代行させられます。
「Issue #10 のためのブランチを作って実装し、プッシュして」と伝えましょう。一連のGitコマンドをAIが背後で実行します。
変更箇所のプレビューと承認フロー
AIは勝手にファイルを書き換えるのではなく、必ず「これでいいですか？」と確認を求めます。
ターミナルに表示される差分（Diff）を見て、問題なければ y を押します。最終的な判断は常にあなたが行うため、安心です。
動作が不安定な時の解決策
設定を完璧にしたつもりでも、時々エラーで止まることがあります。特にWindowsでは、パスの形式やネットワークの設定が原因で、AIがファイルを読み込めなくなることがよくあります。トラブルが起きた際に、パニックにならずにチェックすべき項目をまとめました。これらを順番に試せば、ほとんどの不具合は解消します。
パスの区切り文字によるエラーへの対処
Windowsのパス（C:\）とGit Bashのパス（/c/）が混在すると、AIが混乱します。
なるべく相対パス（./src/など）で指示を出すようにしましょう。フォルダ構成をAIに再認識させるには、一度ツールを再起動するのが手っ取り早いです。
通信タイムアウト時のリトライ設定
インターネット環境が不安定な場合、AIの回答が途中で止まることがあります。
この場合は、設定でタイムアウトの時間を長めに取ります。一度ブラウザで公式サイトが開けるか確認し、回線自体に問題がないか調べましょう。
node_modulesの競合を解消する手順
インストールがうまくいかない時は、一度キャッシュを消去します。
npm cache clean --force を実行してから、再インストールを試みてください。古いデータが残っていると不具合の原因になります。
| トラブル内容 | 原因 | 対策 |
| 入力できない | TTYの制御不全 | winptyを付けて実行 |
| command not found | パスが通っていない | ターミナル再起動または.bashrc確認 |
| 401 Unauthorized | APIキーのミス | キーの再設定とsourceコマンド実行 |
| 文字化け | 文字コードの不一致 | OptionsからUTF-8に設定 |
まとめ：WindowsでもAIコーディングを快適に
WindowsのGit Bash環境であっても、適切な設定を行えばClaude Codeを最高のパフォーマンスで動かせます。初期設定に30分かけるだけで、その後の開発速度は数倍に跳ね上がるはずです。
- Node.jsとGit Bashを最新の状態で準備する。
- 環境変数にAPIキーを登録し、毎回の手間を省く。
winptyとエイリアス設定で動作の安定性を確保する。- スラッシュコマンドやGit連携を使い、ターミナルから出ずに作業を完結させる。
煩わしい定型作業はすべてAIに任せましょう。あなたはロジックの設計や、新しい機能のアイデア出しといった、より人間にしかできない創造的な業務に集中できるようになります。
