Claude CodeをWindowsで使うときの基本環境

はじめに

Windows で Claude Code を使うときは、Unix ベースの環境（Mac / Linux）と異なる点があります。本記事では、Windows 固有の注意点を整理します。

ターミナルの選択

PowerShell vs コマンドプロンプト

推奨：PowerShell
理由：
- より強力なスクリプト機能
- Unix コマンド互換性がある
- 最新の Windows に統合

避けるべき：コマンドプロンプト（cmd.exe）
理由：
- 古い形式
- git コマンドが不安定になることがある

PowerShell 起動

# 方法1：スタートメニューから「PowerShell」
# 方法2：VS Code ターミナル（自動 PowerShell）
# 方法3：Win + X キー → 「PowerShell」

パス（ディレクトリ）の表記

Windows vs Unix の違い

Windows パス：
C:\Users\YourName\Projects\my-app

Unix パス（PowerShell でも同じ）：
/c/Users/YourName/Projects/my-app

Claude Code との相互作用：
内部的には Unix パスを使用
PowerShell でも forward slash (/) で指定可能

作業フォルダの移動

# Windows パス形式（動作）
cd C:\Users\YourName\Projects\my-app

# Unix パス形式（推奨、より確実）
cd /c/Users/YourName/Projects/my-app

# 確認
pwd  # カレントディレクトリ表示

文字コード問題

Windows での日本語

デフォルト問題：
Windows コマンドプロンプト = Shift_JIS
Git / Claude Code = UTF-8
  ↓
文字化けの可能性

対策：
PowerShell で以下を実行
[Console]::OutputEncoding = [Text.UTF8Encoding]::UTF8

ファイル作成時

# UTF-8 で作成（推奨）
"Hello" | Out-File -Encoding utf8 test.txt

# Shift_JIS は避ける
# （Git との連携が複雑になる）

Git 操作の基本

Git インストール確認

# インストール確認
git --version

# 初期設定
git config --global user.name "Your Name"
git config --global user.email "your@example.com"

パス区切りの注意

# 正しい（forward slash）
git status
git add src/main.py

# 間違い（back slash）
git add src\main.py  # Windows 形式はトラブルの原因に

ファイルパーミッション

Windows での実行権限

Unix：ファイルに実行権限がある
Windows：.bat / .exe なら実行可能

対策：
Git で実行権限を追跡しない
git config core.fileMode false

よくある失敗

❌ 失敗例1：パス区切りの混在

# 失敗例
git add src\Components\Button.js
  ↓
Git が混乱することがある

# 成功例
git add src/Components/Button.js

❌ 失敗例2：文字化け

ファイル名に日本語が含まれる
  ↓
Shift_JIS で保存
  ↓
Git / Claude Code で化ける

✅ 改善例

UTF-8 で統一
日本語を避ける（ファイル名）

Windows 環境チェックリスト

□ PowerShell を使用している
□ git --version で Git が確認できる
□ pwd でカレントディレクトリが表示される
□ ls でファイル一覧が表示される
□ git config で user.name / user.email が設定済み
□ UTF-8 エンコーディングで作業している
□ forward slash (/) でパス指定している

まとめ

Windows で Claude Code を使う基本：

ターミナル：PowerShell を使用

パス表記：forward slash (/) を使用

文字コード：UTF-8 に統一

Git 連携：フォーム区切りを統一

Windows 特有の設定を理解することで、Claude Code の効率がぐんと上がります。

Claude Codeを使い始める前に準備しておくことと合わせることで、安定した Windows 開発環境が構築できます。