LinuxでClaude Codeを使う方法をお探しですね。

広告

WSL2のUbuntu環境にClaude Codeを入れてみよう！完全ガイド

最近、AIをブラウザだけじゃなくて、ターミナルから直接使える「Claude Code」っていうツールが話題になっています。

「Windowsだから関係ないかな…」と思うかもしれませんが、実はWSL2（Windows Subsystem for Linux）を使えば、Windows上でもバリバリ使えるんです。

「ターミナルとかLinuxって難しそう…」って思いますよね。

でも大丈夫！この記事では、準備からインストール、よくあるトラブルまで、全部まとめて説明します。

手順通りにやれば誰でもできるので、ぜひ最後まで読んでみてください。

1. まずはWSL2とUbuntuの準備から始めよう

WindowsでLinux系のツールを動かすには、まずWSL2とUbuntuをインストールする必要があります。

最初にWindows PowerShellを開いて、今どんな状態なのか確認してみましょう。

まだ入っていない人は、Windowsの「仮想マシンプラットフォーム」という機能を有効にします。

WSL1とWSL2の2種類がありますが、セキュリティ面で強化されているWSL2を選んでおけば間違いないです。

ここで多くの人がつまずくのが、**BIOSの設定変更**です。

これが最初の難関かもしれません。

WSL2をちゃんと動かすには、パソコンのハードウェアレベルで「仮想化」を許可する必要があるんです。

パソコンを起動するときに特定のキー（F2とかDeleteキーとか、機種によって違います）を押すとBIOS画面に入れます。

そこで「Virtualization Technology」とか「VTx」みたいな項目を探して、「Enabled（有効）」にしてください。

普段見ない画面だから不安になるかもですが、これをやらないと先に進めないので、落ち着いて一つずつ確認しましょう。

BIOS設定が終わったら、UbuntuをWSL2としてインストールします。

初めて起動すると、ユーザー名とパスワードを決めてくださいって言われるので、好きなものを設定しましょう。

これで、Windows上に本格的なLinux環境が完成です！Ubuntuのターミナルから「/mnt/c/Users/…」みたいなパスを使えば、Windows側のファイルも普通に触れるようになります。

WindowsとLinuxの壁がなくなる感じで、めちゃくちゃ便利ですよ。

2. Claude Codeを入れてみよう

Ubuntu環境ができたら、いよいよClaude Code本体をインストールします。

前はNode.jsを使ったnpm経由でインストールするのが主流だったんですが、今は**ネイティブインストーラー**を使う方法が公式で推奨されています。

ネイティブ版は動作が速いし、面倒な依存関係の管理も要らないし、勝手に自動更新してくれるしで、いいことづくめです。

特別な理由がなければ、こっちを選びましょう。

インストール方法はすごく簡単です。

Ubuntuのターミナルを開いて、公式が用意してくれているコマンドを実行するだけ。

curlっていうツールでスクリプトをダウンロードして、そのままbashで実行する流れです。

もし前にnpmで「@anthropic-ai/claude-code」を入れたことがある人は、先に古いやつをアンインストールしてから新しいのを入れてください。

新旧が混ざってると、エラーが出たりして面倒なことになります。

インストールするときに、バージョンやリリースチャネルを指定することもできます。

基本的には最新版を入れておけば大丈夫ですが、「安定性重視で！」って人は「stable」チャネルを指定するといいですよ。

ちなみに、普通のUbuntuなら標準ツールで全部対応できますが、Alpine Linuxみたいな軽量版を使ってる人は、必要なライブラリを手動で追加する必要があるかもしれません。

3. アカウント認証とプロジェクトの設定

インストールが終わったら、次は自分のClaudeアカウントとターミナルをつなげる作業です。

ターミナルで初回起動のコマンドを打つと、自動的にブラウザが開くか、ターミナルに認証用のURLが表示されます。

指示に従ってブラウザで認証を済ませれば、Claude Codeがあなたのアカウントで使えるようになります。

この作業自体は数回クリックするだけなので、すぐ終わります。

ここで注意！Claude Codeを使うには、**有料プランが必要**です。

無料のClaude.aiプランでは使えません。

Pro、Max、Teams、Enterpriseのどれか、またはConsoleアカウントが必要になります。

あと、Anthropicの公式API以外にも、Amazon BedrockやGoogle Vertex AIみたいな他のサービス経由でも使えるので、自分の環境に合ったものを選んでください。

認証が終わったら、実際に作業したいプロジェクトのフォルダに移動して、Claude Codeを起動してみましょう。

ターミナルから普通に日本語で指示を出すだけで、AIが自動的にフォルダ内のファイルを読んで、コードを書いたり文章を編集したりしてくれます。

「このフォルダの原稿を読んで、新しい記事を作って」みたいな感じで頼めば、AIが勝手に作業を進めてくれる未来感、すごいですよ。

Windows側のファイルも操作できるから、使い道は無限大です。

4. 動作確認とアップデートの管理

全部の設定が終わったら、最後にちゃんと動いてるか確認しましょう。

バージョン確認のコマンドを打って、バージョン番号が表示されればOKです。

もっと詳しくチェックしたい人は、診断用の専用コマンドもあります。

これを実行すると、設定ファイルのエラーとか潜在的な問題を早めに見つけられるので、トラブル予防になります。

長く使っていくうえで大事なのが、**アップデート管理**です。

ネイティブインストーラーを使ってる場合、基本的には勝手にバックグラウンドで更新されます。

でも、プロジェクトの都合でバージョンを固定したいときもありますよね。

そういうときは、設定ファイルで細かく調整できます。

・**「latest」チャネル**：新機能が出たらすぐ自動で受け取る（デフォルト）
・**「stable」チャネル**：約1週間前のバージョンを使う。

大きなバグがあるリリースをスキップできる
・**自動更新オフ**：環境変数を変えて無効化。

好きなタイミングで手動アップデート

最後に、環境をリセットしたくなったときのために、アンインストール方法も覚えておきましょう。

バイナリファイルや共有フォルダを削除するだけじゃなくて、ホームディレクトリの隠しファイルや設定ファイルも消せば、完全に初期化できます。

WSL2を使ったUbuntu環境の構築は、最初は設定項目が多くて大変かもしれません。

でも、一度作っちゃえば、WindowsとLinuxのいいとこ取りをした最強のAI開発環境になります。

この記事を参考に、ぜひチャレンジしてみてください！

広告