Claude CodeをWindowsで使う(導入とつまずきどころ)
Claude Codeの導入記事はMacを前提にしたものが多く、Windowsで同じとおりに進めると途中で噛み合わなくなります。実際の検索でも「claude code インストール windows ターミナル」「claude code 始め方 windows」「windows mac どっち」といった形で、Windows特有の迷いが繰り返し現れます。ここでは、Windowsで使うときに判断が要る箇所と、詰まりやすい箇所を順に整理しました。手順の丸写しではなく、なぜそこで迷うのかから書いているので、記事どおりに進めて止まってしまった場合にも使えます。
最初の分かれ道は「どのターミナルで動かすか」
Windowsには文字を打ち込んで操作する画面が複数あります。PowerShell、コマンドプロンプト、Windows Terminal、そしてGit Bashなどです。記事によって前提が違うので、ここで食い違うと以降の手順が全部ずれます。
さらに、Windowsの中にLinuxの環境を用意して動かす方法(WSL)もあります。「claude code windows wsl」がよく検索されるのはこのためです。どちらでも使えますが、性格が違います。
WSLを使うと、Mac向けに書かれた記事の手順がほぼそのまま通ります。情報量が多いのは大きな利点です。一方、WSLの中は普段使っているWindowsとは別の場所なので、**デスクトップに置いたファイルをそのまま扱う、という感覚がずれます**。ファイル整理や書類作成が目的なら、ここが毎回引っかかります。
業務のファイルを扱いたいだけなら、まずWindows側でそのまま動かすほうを試してください。開発の記事どおりに進めたい場合や、Windows側でどうしても動かない場合にWSLを検討する、という順番がおすすめです。
MacとWindowsのどちらで使うか迷っている場合
両方持っていて選べるなら、判断材料は3つです。
1つ目は、扱いたいファイルがどちらにあるか。これがいちばん大きいです。整理したいフォルダや、集計したいExcelが入っているほうの端末で使うのが自然です。ファイルを行き来させる手間は、思っているより毎回効いてきます。
2つ目は、記事や情報の探しやすさ。日本語の解説はMac前提のものが多いので、詰まったときに答えが見つかりやすいのはMacです。ただしこのページのように、Windows特有の箇所を扱った情報も増えています。
3つ目は、その端末が会社のものかどうか。会社貸与のWindowsは権限やネットワークに制限がかかっていることが多く、個人のMacより難易度が上がります。これは次の節で扱います。
どちらでも動くので、**迷っている時間のほうがもったいない**です。ファイルがあるほうで始めてください。
会社から貸与されたパソコンでの制約
Windowsでの詰まりのうち、独力でいちばん解決しにくいのがこれです。手順は合っているのに動かないので、自分のやり方を疑ってしまい、そこで時間を使います。
よくあるのは3つです。1つ目は書き込み権限です。決められた場所にしかインストールできない設定になっていると、途中で止まり、しかもエラーが出ないまま中途半端な状態になることがあります。この場合は、個人の領域にインストールし直すと通ることがあります。
2つ目は、社内から外部への通信の制限です。設定が正しくても外部のサービスに届かないので、「なぜか動かない」としか見えません。とくに外部連携の設定で表面化します。
3つ目は、社内の生成AI利用ルールです。技術的に動くかどうかとは別の話なので、先に確認しておいてください。判断がつかない場合は、個人名や取引先名を伏せた状態で試す方法があります。
この3つは症状が似ていて、切り分けには順番があります。原因が環境側にあると気づくまでが長いので、時間をかけすぎないことをおすすめします。
インストールは通ったのにコマンドが見つからない
Windowsで最も多い症状です。インストール自体は終わっているのに、実行しようとすると見つからないと言われます。ここで入れ直す人が多いのですが、たいてい入っています。
原因は、実行ファイルの置き場所がターミナルの検索対象に入っていないことです。ターミナルは決められた場所しか探しに行かないので、そこに含まれていないと存在していても見つかりません。
**まずターミナルを一度閉じて開き直してください。** この検索対象は起動時に読み込まれるので、インストール直後の画面では反映されていないことがあります。これで直る場合がかなりあります。
開き直しても変わらない場合は、前の節の権限の問題を疑ってください。書き込みが許可されていない場所にインストールしようとして、途中で止まっている可能性があります。
パスの区切りと、日本語の文字化け
Windows特有の細かい引っかかりが2つあります。どちらも知っていれば10秒で対処できます。
1つ目はフォルダの区切り文字です。Windowsは円記号(またはバックスラッシュ)で区切りますが、多くの記事はスラッシュで書かれています。**フォルダの場所を伝えるときは、エクスプローラーのアドレス欄からコピーしてそのまま貼るのが確実です。** 手で打ち直すと、途中の記号でつまずきます。フォルダ名に空白が入っている場合も、コピーしたものを引用符で囲めば問題ありません。
2つ目は日本語の文字化けです。Windowsのターミナルは、環境によって古い文字コードで動いていることがあり、日本語のファイル名や出力が読めない記号になることがあります。表示が壊れているだけで処理自体は通っていることも多いので、**まず結果のファイルを開いて確認してください。** 画面表示だけの問題であれば、ターミナル側の設定で直ります。
動き出したあと、Windowsで最初に試すとよい作業
無事に起動できたら、失敗しても困らない作業から始めてください。おすすめはダウンロードフォルダの整理です。Windowsは放っておくとここに数百個のファイルが溜まるので、効果がすぐ目に見えます。
次に効くのは、毎月必ず発生する作業です。経費の集計、定例レポート、請求書の作成など、「今月もこれをやるのか」と思っている作業に当てると、投じた時間が確実に回収できます。
ただし、ファイルを書き換える作業を任せる前に、**対象フォルダのコピーを取っておいてください。** 元に戻せない操作があるためです。実行前に何をするか説明させてから進めるのも有効です。
それでも動かないとき
ここまでで挙げた箇所は、症状と原因が対応しているので自力で直せます。実際、多くはこの範囲で片付きます。
一方、Windowsで独力だと時間がかかりやすいのが、会社貸与のパソコンで権限やネットワークに制限がかかっているケースです。手順どおりにやっても動かないため、何が原因かの切り分けから必要になります。この場合は、画面を見ながら一緒に切り分けたほうが早いです。
また、外部サービスとの連携(MCP)の設定はWindowsとMacで書き方が違い、Mac向けの設定をそのまま持ち込むと動きません。ここは別のガイドで扱っています。
よくある質問
- WindowsとWSLのどちらで使うべきですか?
- 業務のファイル(Excel、PDF、ダウンロードフォルダなど)を扱いたいならWindows側でそのまま動かすほうをおすすめします。WSLの中は普段使っているWindowsとは別の場所なので、デスクトップのファイルを扱う感覚がずれます。Mac前提の記事をそのまま追いたい場合はWSLが有利です。
- MacとWindowsのどちらで使うのがよいですか?
- 扱いたいファイルが入っているほうです。ファイルを行き来させる手間が毎回効いてきます。日本語の解説はMac前提のものが多いので情報は探しやすいですが、どちらでも動くので迷っている時間のほうがもったいないです。
- インストールしたのにコマンドが見つかりません。
- まずターミナルを一度閉じて開き直してください。実行ファイルの検索対象は起動時に読み込まれるので、インストール直後の画面では反映されていないことがあります。これで直らない場合は、書き込み権限の制限でインストールが途中で止まっている可能性があります。
- 日本語が文字化けします。
- Windowsのターミナルが古い文字コードで動いていると、日本語の出力が読めない記号になることがあります。表示だけの問題で処理は通っていることも多いので、まず結果のファイルを開いて確認してください。中身が正しければターミナル側の設定で直ります。
- 会社のパソコンでも使えますか?
- 使える場合と使えない場合があります。書き込み権限の制限でインストールが完了しない、社内から外部への通信が遮断されて連携機能が動かない、といった制約が出ることがあります。あわせて社内の生成AI利用ルールを先に確認してください。
関連する解説ガイド
- Claude Codeでできること(非エンジニア向け):コードを書かない人がClaude Codeで実際に片付けられる作業を、ファイル整理・データ処理・書類作成の順に具体例で紹介します。
- Claude CodeのMCP設定と、つながらないときの切り分け:MCPで外部サービスをつなぐときの設定の考え方と、認識されない・エラーになる場合の原因を切り分け順にまとめました。WindowsとMacで書き方が変わる箇所、鍵の扱い、社内ネットワークでの遮断まで扱います。
- Claude Codeがうまく動かないときに見る8箇所:インストールは終わったのに思った通りに動かない、という状態をほどくためのチェックリストです。作業フォルダ・権限・CLAUDE.md・スキル・MCPの順に、詰まりやすい箇所と直し方をまとめました。
このページで解決しなかったときは
プロンプト大全を運営しているOsaka0114です。ここに載せている内容で解決しなかった場合に備えて、直接ご相談いただける窓口をココナラに用意しています。
30分単位でお受けしています。環境のことでも使い方のことでも、詰まっているところを見せていただければ、その場で一緒に切り分けます。
どんなときに相談したほうが早いかは相談の目安にまとめています。自力で解決できる範囲も書いてあるので、先にそちらをご覧ください。
