🧠 概要：
概要
この記事では、Windows Subsystem for Linux (WSL) を使用して、Windows 環境に Claude Code をセットアップする手順を詳しく解説します。具体的には、インストール方法、起動までのプロセス、一般的なエラーへの対処方法が含まれています。著者は自身の経験を元に情報を提供していますが、内容に誤りがある可能性があるため、公式サイトでの確認を推奨しています。
要約の箇条書き
-
前提条件:
- Windows 環境に WSL がインストール済み。
- WSL 環境に Node.js 18 以上がインストール済み。
- WSL ターミナルの基本操作ができる。
-
インストール手順:
- npm の設定を変更して、グローバルパッケージの権限エラーを回避。
- Claude Code を権限エラーを避けるために –prefix オプションを使用してインストール。
- PATH 環境変数を設定して、インストールした claude コマンドをどこからでも実行可能に。
-
設定の反映:
- シェル設定ファイルを編集し、環境変数を更新する方法を説明。
- 設定の確認方法も提供。
-
Claude Code の起動:
- PATH の設定後、claude コマンドでアプリケーションを起動。
- 初回起動時には利用規約の同意と認証プロセスが必要。
-
トラブルシューティング:
- 権限エラー (EACCES) への対処方法。
- WSL と Windows のファイルシステムの違いに注意すること。
- Node.js や npm の最新バージョンの利用を推奨。
- おすすめのリソース: 公式サイトで最新情報を確認する。
Windows Subsystem for Linux (WSL) を使用して、Windows 環境に Claude Code をセットアップする手順を解説します。インストールから起動まで、そして一般的なエラーへの対処方法も含めて説明します。
僕自身、Windows環境で設定しようとした際にうまくいかず、何度も失敗を繰り返しました。その体験をもとにAIでこの記事を作成していますが、一部に誤りが含まれている可能性があります。
正確な手順や最新情報については、Claude Codeの公式サイトで確認することをおすすめします。
前提条件
Claude Code をインストールする前に、以下の環境が整っていることを確認してください：
-
Windows 環境に WSL がインストールされ、セットアップ済み
-
WSL 環境に Node.js 18 以上がインストール済み
-
WSL ターミナルの基本操作（コマンド実行、ファイル編集など）ができること
インストール手順
npm の設定変更
WSL 環境でグローバルパッケージの権限エラーを回避するため、まず npm の設定を変更します。
-
WSL ターミナルを開きます
-
npm のグローバルパッケージインストール先をユーザーディレクトリに変更します：
-
npm config set prefix ‘~/.npm-global’
-
-
（推奨）過去に EACCES エラーが発生した場合は、npm キャッシュをクリーンアップします：
-
npm cache clean –force
-
Claude Code のインストール
権限エラーを避けるため、–prefix オプションを使用してインストールします。
npm install -g @anthropic-ai/claude-code --prefix='~/.npm-global'インストールが成功すると、added x packages in ys のようなメッセージが表示されます。
PATH 環境変数の設定
インストールした claude コマンドをどこからでも実行できるように、PATH を設定します。
シェル設定ファイルの編集
-
お使いのシェルの設定ファイルを開きます：
-
# Bash を使用している場合 nano ~/.bashrc # Zsh を使用している場合 nano ~/.zshrc
-
-
ファイルの末尾に以下の行を追加します：
-
export PATH=~/.npm-global/bin:$PATH
-
-
ファイルを保存して閉じます（nano の場合）：
-
Ctrl + O で保存
-
Enter で確定
-
Ctrl + X で終了
-
設定の反映
設定を反映させるには、以下のいずれかの方法を実行します：
-
方法1（推奨）: ターミナルを一度閉じて、再度開く
-
方法2: 現在のセッションに設定を読み込む： # Bash の場合source ~/.bashrc# Zsh の場合source ~/.zshrc
PATH の確認
設定が正しく反映されたか確認します：
echo $PATH出力に /home//.npm-global/bin が含まれていることを確認してください。
Claude Code の起動
PATH の設定が完了したら、以下のコマンドで Claude Code を起動します：
claude初回起動時には：
-
利用規約への同意
-
認証プロセス
が表示されます。画面の指示に従って認証を完了させてください。
トラブルシューティング
EACCES 権限エラーへの対処
npm install -g 実行時に /usr/local/lib/node_modules への権限エラーが発生する場合：
-
実行環境の確認
-
npm 設定の確認
-
npm config get prefix
-
出力が ~/.npm-global になっていることを確認
-
-
インストールコマンドの確認
-
キャッシュのクリア
-
npm cache clean –force
-
実行後、再度インストールを試みてください
-
その他の注意点
-
WSL と Windows のファイルシステムは異なるため、必ず WSL 環境内で作業してください
-
Node.js のバージョンが 18 以上であることを確認：node –version
-
npm が最新版であることを推奨：npm install -g npm@latest
これらの手順に従えば、Windows 環境でも WSL を通じて Claude Code を問題なく利用できるようになります。
Views: 0
