WSL2でVS Codeを使う入門|Remote WSL拡張でLinuxファイルをWindowsから編集する方法

運営:リナックスマスター.JP(代表 宮崎智広)
HOME > Linux技術 リナックスマスター.JP(Linuxマスター.JP) > 【Linux入門】初心者のための基礎知識・講座 > WSL2でVS Codeを使う入門|Remote WSL拡張でLinuxファイルをWindowsから編集する方法
「WSL2をインストールしたのに、コードを書くときどうすればいいのか分からない。」
「ターミナルでvimを使えと言われても、操作が難しすぎる。」

WSL2でLinuxを動かせるようになったら、次の壁はエディタです。
Linuxのターミナル上でvimやnanoを使う方法もありますが、初心者にはハードルが高めです。

そこで使いたいのが、VS CodeのRemote WSL拡張機能です。
これを使えば、WindowsのVS Codeから直接WSL2のLinux上にあるファイルを開いて編集できます。WSL2のターミナルで「code .」と入力するだけで起動するので、設定も最小限で済みます。

この記事では、Remote WSL拡張のインストールから実際の使い方、Git連携(GitHubへのSSH鍵設定を含む)、PythonなどのWSL2側への拡張機能インストール、ポート転送によるローカルサーバーの確認、GitHub Copilotとの組み合わせ、よくあるエラーの対処まで、初心者向けにゼロから解説します。

※動作確認環境: Windows 11 / WSL2(Ubuntu 24.04 LTS)/ VS Code 1.99

この記事のポイント

・「code .」コマンドでWSL2のLinuxファイルをVS Codeで即座に開ける
・Remote Development拡張のインストールは5分もかからない
・Python・Git・ESLintなどの拡張機能はWSL2側にもインストールが必要
・プロジェクトは/home以下に置くと/mnt/cより動作が高速になる
・WSL2でWebサーバーを起動するとVS Codeが自動でポート転送を提案する
・GitHub CopilotはWSL2接続中も動作し、AIの補完を受けながらLinux開発ができる
・VPSやクラウドのサーバーを編集したい場合はRemote SSH拡張を使う(本記事はWSL2向け)
・「code: command not found」は再インストールで解決するケースがほとんど


「このままじゃマズい」と感じていませんか?
参考書を開く気力もない、同年代に取り残される不安——
でも安心してください。プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
姓・名・メールの3つだけ/30秒/解除は3秒 / 詳細はこちら

VS CodeのRemote WSL機能とは何か

VS Codeには「リモート」系の拡張機能が複数あるため、最初に整理しておきます。

拡張機能 接続先 こんな人向け
Remote - WSL(今回の記事) 同じPCのWSL2 Linux Windowsで手軽にLinux環境を使いたい人
Remote - SSH VPS・クラウドなどSSH接続できるサーバー VPSや自宅サーバーのファイルを編集したい人
Dev Containers Dockerコンテナの中 チームで同じ環境を再現したい人
VS Code(Visual Studio Code)はMicrosoftが提供する無料のエディタです。
通常はWindowsのファイルを編集しますが、「Remote WSL」という拡張機能を追加すると、WSL2のLinux環境に直接接続してLinux上のファイルを編集できます。

仕組みとしては、VS Codeの見た目(UI部分)はWindowsで動きながら、裏側でWSL2のLinux上に「VS Code Server」という小さなサーバーを起動しています。
WindowsのVS CodeとLinux上のVS Code Serverがつながることで、あたかもLinux上でVS Codeが動いているかのように使えます。

この方式のメリットを整理すると、こうなります。

・ファイルパスがLinuxネイティブ:/home/user/project のようなLinuxのパスでそのまま作業できる
・ターミナルもLinux:VS Code内蔵ターミナルを開くとWSL2のbashが自動で起動する
・拡張機能もLinux側で動く:PythonやNode.jsの拡張機能がWSL2のインタープリタを正しく認識する
・ファイルアクセスが高速:プロジェクトをWSL2のファイルシステム(/home/以下)に置くと、Windowsの/mnt/c経由より大幅に速くなる

「VPSで作業したい」場合はRemote SSHを使う
Remote WSLは「同じPC内のWSL2」に接続するための拡張機能です。ConoHaやAWSなどのVPS・クラウドサーバーに接続したい場合は「Remote - SSH」を使います。Remote SSHを使うとWindowsのVS CodeからVPSのファイルをGUI操作で直接編集でき、Ctrl+Sで保存するとVPS上のファイルが即座に更新されます。公開鍵認証(SSH鍵ペア)が設定済みであれば、コマンドパレットから数クリックで接続できます。接続先が複数ある場合は ~/.ssh/config に接続先ホストを登録しておくと、名前(エイリアス)で呼び出せます。

Remote WSL(ローカルWSL2)とRemote SSH(リモートVPS)の使い分けを一言でまとめると次のとおりです。

比較項目 Remote WSL Remote SSH
接続先 同じPCのWSL2環境 VPS・クラウド・物理サーバー
ネットワーク ローカルの内部接続(インターネット不要) インターネット経由のSSH接続
SSH鍵 不要 公開鍵認証を推奨
主な用途 ローカルLinux開発・学習 本番サーバー・クラウドの作業
接続開始 WSL2ターミナルで code . を実行 コマンドパレットから「Connect to Host」

「チームで全員が同じ環境を使いたい」場合はDev Containersを検討する
Remote WSLは「自分のPC上のWSL2に直接接続する」シンプルな方式です。一人で開発するうちは十分ですが、「npm installしたら自分のPCでは動いたのにチームメンバーのPCではエラーになった」という問題が出てきたら、Dev Containersへのステップアップを検討するタイミングです。Dev Containersは devcontainer.json という設定ファイル1つで、チーム全員が全く同じDockerコンテナ環境を再現できる仕組みです。まずはRemote WSLで慣れてから、必要に応じてDev Containersに移行するのがおすすめの流れです。

VS Code Remote WSLとWSL2の組み合わせでできること(まとめ)
項目 Remote WSL接続なし Remote WSL接続あり
ファイルの編集場所 Windowsのファイルシステム WSL2(Linux)のファイルシステム
内蔵ターミナル WindowsのPowerShell / cmd WSL2のbash(Linuxコマンドが使える)
Python拡張機能 WindowsのPythonを参照 WSL2(Linux)のPythonを参照
Gitコマンド WindowsのGitを使用 WSL2のgitを直接使用

インストールの準備と確認

1. WSL2が動いているか確認する

まずWSL2が正常に動いているか確認します。
Windowsのコマンドプロンプトまたはターミナルで以下を実行してください。

# Windows側のコマンドプロンプトで実行する > wsl --list --verbose NAME STATE VERSION * Ubuntu-24.04 Running 2

「VERSION」の列が「2」になっていればWSL2として動いています。
「Stopped」と表示された場合は、スタートメニューから「Ubuntu」を起動してください。
「1」と表示された場合はWSL1として動作しているため、以下のコマンドでWSL2に変換できます。

# Ubuntu-24.04をWSL2に変換する(ディストリビューション名は環境に合わせる) > wsl --set-version Ubuntu-24.04 2

2. VS Codeをインストールする

VS CodeはMicrosoftの公式サイト(https://code.visualstudio.com/)からダウンロードしてインストールします。
インストーラーを実行するときに、「PATHへの追加」オプションにチェックが入っていることを確認してください。
このチェックが外れていると、ターミナルから「code」コマンドを実行できません。

インストール済みの場合はWindowsのコマンドプロンプトでバージョンを確認できます。

# Windowsのコマンドプロンプトで実行する > code --version 1.99.3 b8a78f6b27a244b965fcedca9e25be12f74f1700 x64

3. Remote Development拡張をインストールする

VS Codeを起動して、左サイドバーの「拡張機能」アイコン(Ctrl+Shift+X)をクリックします。
検索ボックスに「Remote Development」と入力して、Microsoftが提供する同名の拡張機能をインストールします。

このパックには以下の3つの拡張が含まれています。

・Remote - WSL(今回使う拡張機能。拡張機能ID: ms-vscode-remote.remote-wsl):WSL2のLinux環境に接続する
・Remote - SSH(拡張機能ID: ms-vscode-remote.remote-ssh):SSH経由でリモートサーバーに接続する
・Dev Containers:Dockerコンテナの中で開発する

3つがまとめてインストールされますが、今回使うのは「Remote - WSL」のみです。
インストール完了後、VS Codeの左下に青い「><」アイコンが表示されます。このアイコンをクリックするとWSL2への接続メニューが開きます。

インストールが完了したか確認したい場合は、Windowsのコマンドプロンプトで以下のコマンドを実行します。

# インストール済みのRemote系拡張を確認する(Windowsのコマンドプロンプトで実行) > code --list-extensions | findstr remote ms-vscode-remote.remote-containers ms-vscode-remote.remote-ssh ms-vscode-remote.remote-ssh-edit ms-vscode-remote.remote-wsl

「ms-vscode-remote.remote-wsl」が表示されればインストール成功です。

WSL2のファイルをVS Codeで開く基本操作

1. WSL2のターミナルから「code .」を実行する

WSL2のUbuntuターミナルを開いて、作業したいディレクトリに移動してから「code .」を実行します。

# ホームディレクトリに練習用フォルダを作成して移動する $ mkdir ~/myproject && cd ~/myproject # VS Codeを開く(「.」は現在のディレクトリを意味する) $ code .

特定のファイルだけ開きたい場合は、ファイル名を直接指定できます。

# 特定ファイルだけVS Codeで開く場合 $ code ~/myproject/hello.sh

2. VS Code Serverのインストールと接続確認

初回は「code .」を実行すると、WSL2の中にVS Code Serverが自動でインストールされます。

$ code . Installing VS Code Server for Linux x64 (b8a78f6b27a244b965fcedca9e25be12f74f1700) Downloading: 100% Unpacking: 100% Starting VS Code Server... Extension host agent listening on 47125.

初回は数十秒ほどかかりますが、完了するとWindowsのVS Codeが自動で起動します。
左下の緑色のエリアに「WSL: Ubuntu-24.04」と表示されていれば、WSL2に正常に接続できています。
2回目以降は「code .」を実行するとほぼ即座にVS Codeが開きます。

接続後にVS Codeの統合ターミナルを開いて、Linuxディストリビューションを確認することもできます。

# 接続後のVS Code統合ターミナルで実行する(出力例) $ cat /etc/os-release NAME="Ubuntu" VERSION="24.04.1 LTS (Noble Numbat)" ID=ubuntu

「Ubuntu」と表示されれば、WSL2のLinux上でターミナルが動いていることが確認できます。

3. ファイルを作成して動作確認する

VS Codeのエクスプローラー(左サイドバー)に「myproject」フォルダが表示されています。
「新しいファイル」ボタンで「hello.sh」を作成し、以下の内容を入力してみましょう。

#!/bin/bash echo "WSL2でVS Codeが使えています"

ファイルを保存(Ctrl+S)したら、VS Code内蔵ターミナル(Ctrl+`)を開いて実行確認します。

# 実行権限を設定して実行する $ chmod +x hello.sh $ ./hello.sh WSL2でVS Codeが使えています

メッセージが表示されれば成功です。Windowsのエディタで作成したファイルがLinux上で動いています。

4. ワークスペースの保存とプロジェクトの再接続

VS Codeのワークスペース情報は「ファイル」→「名前を付けてワークスペースを保存」で .code-workspace ファイルとして保存できます。
次回以降は保存した .code-workspace ファイルをダブルクリックするだけで、WSL2接続済みの状態でプロジェクトが開きます。

また、最近開いたフォルダはVS Codeの「ファイル」→「最近使用したファイルを開く」(Ctrl+R)から素早く再アクセスできます。
WSL2接続のフォルダには「[WSL: Ubuntu-24.04]」のラベルが付いているので、Windowsのフォルダと区別できます。

知っておきたい実践Tips

1. 拡張機能はWSL2側にもインストールする

VS Codeの拡張機能には「Windows側で動くもの」と「WSL2(Linux)側で動くもの」の2種類があります。
Pythonの補完機能やESLintなど、コードに直接関係する拡張機能はWSL2側にインストールする必要があります。

拡張機能の詳細ページを開くと、インストールボタンの横に「WSL: Ubuntu-24.04にインストール」と表示されることがあります。
その場合はそのボタンからWSL2側へインストールしてください。

WSL2側にインストール済みかどうかは、左サイドバーの「拡張機能」を開いて「インストール済みのWSL: Ubuntu-24.04用」セクションで確認できます。

現場でよく使われる拡張機能の参考例は次のとおりです。

・Python:Pythonスクリプトのシンタックスハイライト・補完・デバッグ
・ShellCheck:シェルスクリプトの構文エラーを静的解析で検出
・YAML:Docker ComposeやAnsibleのPlaybookなど設定ファイルの補完と整形
・ESLint:JavaScriptのコードスタイルチェックとエラー検出

2. VS Code内蔵ターミナルでLinuxコマンドを実行する

WSL2接続中にVS Codeのターミナル(Ctrl+`)を開くと、自動でWSL2のbashが起動します。
LinuxコマンドをVS Codeの画面を離れずに実行できるので、エディタとターミナルを行き来する手間が省けます。

# VS Code内蔵ターミナル(WSL2のbash)での確認例(出力例) tomohiro@DESKTOP-XXXXX:~/myproject$ uname -a Linux DESKTOP-XXXXX 5.15.167.4-microsoft-standard-WSL2 #1 SMP Tue Nov 5 00:21:55 UTC 2024 x86_64 GNU/Linux tomohiro@DESKTOP-XXXXX:~/myproject$ ls -la total 8 drwxr-xr-x 2 tomohiro tomohiro 4096 Jul 14 09:00 . drwxr-xr-x 8 tomohiro tomohiro 4096 Jul 14 08:55 .. -rwxr-xr-x 1 tomohiro tomohiro 56 Jul 14 09:00 hello.sh

「microsoft-standard-WSL2」という文字列が出力に含まれていれば、WSL2のLinux上で動いていることが確認できます。

3. 別のプロジェクトを開くときはcode .を使い回す

WSL2上の別のフォルダを開きたいときは、WSL2のターミナルでそのフォルダに移動してから「code .」を実行するのが最もシンプルです。

# 別のプロジェクトに移動してVS Codeで開く $ cd ~/anotherproject $ code .

VS Codeが別ウィンドウで開き、そのフォルダをWSL2接続の状態で編集できます。
既存のウィンドウと並べて使いたい場合は「ファイル」→「新しいウィンドウでフォルダーを開く」を使ってください。

4. Git連携はWSL2側のgitが自動で使われる

WSL2接続中のVS CodeでGitを使うと、VS Code内蔵のソース管理パネル(Ctrl+Shift+G)がWSL2のgitコマンドを直接呼び出します。
Windows側にGitをインストールしていなくても、WSL2にgitさえ入っていれば問題ありません。

# WSL2にgitをインストールする(未インストールの場合) $ sudo apt update && sudo apt install -y git # gitの動作確認 $ git --version git version 2.43.0

gitのインストール後は、VS CodeのGUIからコミット・プッシュ・ブランチ切り替えがすべてWSL2のgit経由で操作できます。
ターミナルでgitコマンドを直接打つのが苦手な方には、特におすすめの使い方です。

GitHubへのSSH接続設定(リモートリポジトリへのpushに必要)
GitHubにSSH経由でpushする場合は、WSL2のLinux内でSSH鍵ペアを生成してGitHubに登録する必要があります。Windows側の鍵とは別に、WSL2専用の鍵を用意するのが管理しやすくなります。

# WSL2のターミナルでSSH鍵ペアを生成する $ ssh-keygen -t ed25519 -C "メモ用の文字列(例: github-wsl2)" # 3回Enterを押すとデフォルト設定で鍵が作成される # 秘密鍵: ~/.ssh/id_ed25519 # 公開鍵: ~/.ssh/id_ed25519.pub # 公開鍵の内容を表示する(この内容をGitHubに登録する) $ cat ~/.ssh/id_ed25519.pub ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAA... github-wsl2

`cat` コマンドで表示された公開鍵をコピーして、GitHubの「Settings → SSH and GPG keys → New SSH key」に登録します。
登録後、WSL2のターミナルで `ssh -T git@github.com` を実行して接続を確認し、その後 `git push` を実行するとSSH経由でGitHubにプッシュできます。

5. Python(conda/venv)仮想環境をVS Codeで切り替える

WSL2でPythonの仮想環境(condaやvenv)を使っている場合、VS CodeのPython拡張機能がその仮想環境を自動で検出します。
VS Codeウィンドウ右下のPythonバージョン表示をクリックするか、コマンドパレット(Ctrl+Shift+P)で「Python: インタープリターを選択」を実行すると、仮想環境を切り替えられます。

# WSL2でconda仮想環境を作成する(Minicondaインストール済みの場合) $ conda create -n myenv python=3.11 $ conda activate myenv # VS CodeのPython拡張機能(WSL2側にインストール済みの場合) # 右下のPythonバージョン表示をクリックすると「myenv」が選択肢に表示される

仮想環境を切り替えると、LinterやデバッガーもそのPython環境のライブラリを参照するようになります。
複数プロジェクトでPythonバージョンや依存パッケージを分けて管理したい場合に役立ちます。

6. プロジェクトはWSL2の/home以下に置く

WSL2でよくある落とし穴として、プロジェクトを「/mnt/c/Users/自分の名前/」のようなWindowsのファイルシステム上に置いてしまうケースがあります。
この場合、ファイルアクセスがWindows↔Linux間の変換レイヤー(Plan 9 Filesystem Protocol)を経由するため、大量のファイルを扱うNode.jsやPythonのプロジェクトで動作が極端に遅くなることがあります。

「npm installが異常に遅い」「pytest実行に時間がかかる」という問題の多くは、プロジェクトを/mnt/c以下に置いていることが原因です。

対策はシンプルで、プロジェクトをWSL2のホームディレクトリ(/home/ユーザー名/)以下に置くだけです。

# 現在の作業場所を確認する(/mnt/cではなく/home以下であることを確認) $ pwd /home/tomohiro/myproject # もし/mnt/c以下にあるなら/homeにコピーして移行する $ cp -r /mnt/c/Users/tomohiro/myproject ~/myproject $ cd ~/myproject $ code .

プロジェクトを/home以下に移すだけでファイル操作が体感できるほど速くなります。
Gitリポジトリも/home以下にcloneするのが運用上の定石です。

※注意:WSL2をアンインストールまたはリセットすると、/home以下のファイルも削除されます。大切なプロジェクトはGitHubやリモートリポジトリにバックアップしておくことを忘れずに。

7. WindowsエクスプローラーでWSL2のファイルをブラウズする

VS Codeを使わずにWindowsエクスプローラーでWSL2内のファイルを確認したい場合は、エクスプローラーのアドレスバーに以下のパスを入力してください。

# WindowsエクスプローラーのアドレスバーにUNCパスを入力する \\wsl$\Ubuntu-24.04\home\tomohiro

「\\wsl$\Ubuntu-24.04」の後にLinuxのパスを続けることで、WSL2内のディレクトリをWindowsのエクスプローラーで直接開けます。
ただし、エクスプローラー経由でのファイル操作はパフォーマンスが下がることがあるため、日常的な編集作業はVS CodeのRemote WSL経由で行うほうが快適です。

8. Dev ContainersとRemote WSLの使い分けを知る

Remote WSLは「自分のPC1台で気軽にLinux開発を始める」には最適な方法です。一方、プロジェクトの規模が大きくなったり、複数の言語バージョンを切り替えたりする場面が増えてくると、Dev Containersへのステップアップを検討するタイミングが来ます。

以下の表を参考に、どちらを使うか判断してください。

状況 Remote WSL Dev Containers
一人でWSL2を使って開発する 最適 オーバースペック気味
チームで同じ環境を再現したい 環境差異が出やすい 設定ファイル1つで全員が同じ環境
プロジェクトごとに言語バージョンを分けたい conda/nvm等の切替ツールが必要 コンテナを切り替えるだけ
本番Linux環境との差異を最小化したい WSL2のUbuntuが基盤 本番と同じDockerイメージを使える
Dockerの知識がない・まずVS Codeに慣れたい 追加知識不要で始められる Docker基礎知識が必要
Dev ContainersはRemote WSLとは排他ではなく、WSL2の上でDockerを動かす形で組み合わせて使います。Remote WSLで基本操作に慣れてから、Dev Containersに移行するのがスムーズです。Dev Containersを動かすには別途Docker Desktopのインストールが必要になります。

9. GitHub CopilotをWSL2接続中に使う

VS CodeのRemote WSL接続中でも、GitHub Copilot拡張機能を追加することでAIによるコード補完が使えます。CopilotはWSL2側の言語環境(PythonのインタープリタやNode.jsのバージョン)を正しく認識した上で補完を提案するので、ローカルのWindows環境で使うよりも精度が高くなるケースがあります。

インストール後、WSL2接続中に拡張機能パネルを開くと「WSL: Ubuntu-24.04にインストール」のボタンが表示される場合があります。その場合はWSL2側へも追加でインストールしてください。

実際の活用場面としては、こういった使い方が効果的です。

・シェルスクリプトを書くとき、コメントで処理の意図を書くとCopilotがコマンドを補完してくれる
・Pythonコードのエラーをコメントとして貼り付けると、Copilotが修正案を提案することがある
・見慣れないLinuxコマンドのオプションや使い方をCopilot Chatに質問しながら手を動かすと習得が早い
・コマンドの実行結果をCopilot Chatに貼り付けて「このエラーの意味は何ですか」と質問すると、原因の見当がつきやすい

「コマンドは分かるけどスクリプト化が苦手」という段階から、AIとペアで作業することでLinuxスキルの習得速度が上がります。

10. WSL2のWebサーバーをWindowsブラウザで確認する(ポート転送)

WSL2でNode.jsやPythonのWebサーバーを起動すると、VS Codeが「ポートをローカルホストに転送しますか?」という通知を自動で表示します。
通知に従って転送を許可すると、WindowsのChromeやEdgeから直接WSL2上の開発サーバーにアクセスできます。

# WSL2のターミナルでPythonの簡易Webサーバーを起動する(出力例) $ python3 -m http.server 8000 Serving HTTP on 0.0.0.0 port 8000 (http://0.0.0.0:8000/) ...

コマンドを実行すると、VS Codeがポート8000を検出してステータスバーに転送の通知を表示します。WindowsのブラウザからURL欄に http://localhost:8000 と入力するとWSL2のサーバーに接続できます。

転送中のポートはVS Codeのターミナルパネル横にある「ポート」タブで一覧確認できます。手動でポートを追加・削除したい場合や、転送の公開範囲(ローカルのみ・パブリック)を変更したい場合もこのタブから操作できます。

VS Codeが自動でポートを検出しない場合は、「ポート」タブを開いて「ポートの転送」ボタン(+アイコン)をクリックし、転送したいポート番号を直接入力することもできます。Node.jsの開発サーバー(npm run dev)はポート3000や5173を使うことが多く、Flaskはデフォルトで5000番を使います。

# Node.jsの開発サーバー起動例(出力例) $ npm run dev VITE v5.0.0 ready in 200 ms ➜ Local: http://localhost:5173/ # → WindowsのブラウザでURL欄に http://localhost:5173 を入力してアクセスできる # Flaskの開発サーバー起動例(出力例) $ flask run * Running on http://127.0.0.1:5000 # → WindowsのブラウザでURL欄に http://localhost:5000 を入力してアクセスできる

Node.jsで npm run dev を使うプロジェクトや、Flaskなどで python3 app.py を実行するプロジェクトも同様に自動で転送されます。WSL2の開発環境でWebアプリを開発するときに便利な機能です。

11. VPSのファイルを編集したい場合はRemote SSH拡張を使う

WSL2でのローカル開発に慣れてきたら、次のステップとしてVPS(ConoHa・さくらVPS・AWSのEC2など)での実サーバー運用に挑戦することがあります。VPS上のファイルをVS Codeで直接編集したい場合は、Remote WSLではなく「Remote - SSH」拡張機能を使います。

Remote SSHの基本的な使い方は次のとおりです。

・VS CodeのコマンドパレットでRemote-SSH: Add New SSH Hostを実行し、ssh ubuntu@VPSのIPアドレス の形式で接続先を登録する
・登録後、「Remote-SSH: Connect to Host」でVPSを選択するとVPS上にVS Code Serverが自動インストールされ接続される
・接続後はローカルのWSL2と同様に、サイドバーでVPSのファイルをツリー表示・編集できる

VPSを複数管理している場合は、Windowsの C:\Users\ユーザー名\.ssh\config(SSH設定ファイル)にホスト情報をまとめておくと便利です。

# C:\Users\ユーザー名\.ssh\config の設定例(複数サーバーの登録) Host webserver HostName 203.0.113.10 User ubuntu IdentityFile ~/.ssh/id_ed25519 Host devserver HostName 198.51.100.20 User centos IdentityFile ~/.ssh/id_ed25519

設定後、「Remote-SSH: Connect to Host」を開くと「webserver」「devserver」が一覧に表示され、ワンクリックで接続できます。本番・開発・ステージングなど役割に合わせた名前にしておくと、サーバーの切り替えがスムーズです。

※注意:VPSでRemote SSHを使うには、VPS側でSSH公開鍵認証が設定済みであることが前提です。ファイアウォールのルールを変更する際はSSHポート(デフォルトTCP 22番)の許可ルールを先に確認してから作業してください。SSH接続が切れた状態でSSHポートを閉じると、コンソール接続以外でVPSにアクセスできなくなるトラブルが起きやすいためです。

「code: command not found」が出た時の対処法

WSL2のターミナルで「code .」を実行したときに、次のエラーが出ることがあります。

$ code . -bash: code: command not found

「codeコマンドが見つからない」というエラーです。以下の順番で確認してください。

・確認1 VS CodeのPATHが通っているか:WSL2のターミナルで以下を実行する

# VS CodeのPATHがWSL2に引き継がれているか確認する $ echo $PATH | tr ':' '\n' | grep -i vscode /mnt/c/Users/YourName/AppData/Local/Programs/Microsoft VS Code/bin

「/mnt/c/...」のパスが表示されれば正常です。表示されない場合は次の確認に進んでください。

・確認2 VS Codeをインストールし直す:VS Codeをアンインストールして公式サイトからインストーラーを再ダウンロードし、「PATHへの追加」にチェックを入れてインストールする

・確認3 WSL2を再起動する:VS Code再インストール後は、WSL2を一度シャットダウンして起動し直す

# Windows側のコマンドプロンプトで実行する > wsl --shutdown # 再度WSL2を起動する > wsl

再起動後に「code .」を再度試してみてください。ほとんどのケースでこれで解決します。

・確認4 /etc/wsl.confの設定を確認する:WSL2のターミナルで以下を実行する

# /etc/wsl.confの内容を確認する(ファイルが存在する場合のみ) $ cat /etc/wsl.conf [interop] appendWindowsPath = false

[interop] セクションに appendWindowsPath = false や enabled = false が設定されている場合、WindowsのPATHがWSL2に引き継がれず、VS CodeのPATHも通りません。
該当の行を削除またはコメントアウトしてからWSL2を再起動してください。

・確認5 Permission deniedでファイルが保存できない:WSL2内で /etc/ 配下のシステムファイルをVS Codeから直接保存しようとすると Permission denied になります。root権限が必要なファイルの場合は、ターミナルで sudo を使う方法が確実です。

# 権限を確認する $ ls -la /etc/hosts -rw-r--r-- 1 root root 224 Jul 14 09:00 /etc/hosts # 一時ファイルに保存してからsudoで配置する方法 # 1) VS Codeでホームディレクトリ配下の ~/hosts.tmp を新規作成して編集・保存 # 2) ターミナルでsudoを使って配置する $ sudo cp /etc/hosts /etc/hosts.bak.$(date +%Y%m%d) $ sudo mv ~/hosts.tmp /etc/hosts

※注意:/etc/配下のシステムファイルを編集するときは、必ず変更前にバックアップを取ること。誤った設定を書き込むとWSL2が起動しなくなる場合があります。

・確認6 Remote WSL拡張機能のバージョンが古い:VS Codeのバージョンと拡張機能のバージョンに大きなズレがある場合、接続後すぐに切断されたり「WSL: Ubuntu-24.04」への接続が途中で止まったりすることがあります。左サイドバーの「拡張機能」を開き、「ms-vscode-remote.remote-wsl」を探して更新ボタンが表示されていればアップデートしてから再接続してください。

・確認7 Windows Terminalを使っているか確認する:Windows 11標準のWindows Terminalから「Ubuntu」タブを開いた場合と、スタートメニューの「Ubuntu」から直接起動した場合では、ターミナルの環境変数の引き継ぎ方が異なることがあります。「code .」が通らない場合は、別の方法でWSL2を開いて再試行してみてください。

本記事のまとめ

WSL2とVS Codeを組み合わせることで、WindowsユーザーでもLinuxの開発環境を快適に使えるようになります。
「WSL2は動かせるようになったけどいまいち使い方が分からない」という方は、今日からVS Codeと一緒に活用してみてください。
やりたいこと 操作方法
WSL2のフォルダをVS Codeで開く WSL2ターミナルで code . を実行
特定のファイルをVS Codeで開く WSL2ターミナルで code ファイル名 を実行
VS Codeのターミナルをbashとして使う Ctrl+` でターミナルを開く(WSL2接続中は自動でbashになる)
拡張機能をWSL2側にインストールする 拡張機能の詳細ページで「WSL: Ubuntu-24.04にインストール」を選択
Git連携をWSL2のgitで行う WSL2にgitをインストールするだけで自動連携される
GitHubにSSH鍵でpushする WSL2内で ssh-keygen -t ed25519 を実行し公開鍵をGitHubに登録する
Python仮想環境を切り替える Ctrl+Shift+P → 「Python: インタープリターを選択」
WSL2のWebサーバーをWindowsブラウザで確認する VS Codeが自動で通知 → 「ポート」タブで転送設定を確認する
GitHub CopilotをWSL2で使う 拡張機能パネルでWSL2側にもCopilotをインストールする
プロジェクトのファイル操作を速くする プロジェクトを/mnt/c以下ではなくWSL2の/home以下に置く
VPSのファイルをVS Codeで編集する Remote - SSH拡張を使いコマンドパレットから「Connect to Host」で接続
「code: command not found」エラーを解消する VS Codeを再インストールしてPATH追加にチェックを入れる
WSL2への接続を切断する VS Code左下の「WSL: Ubuntu-24.04」をクリック → 「接続を閉じる」を選択
チームで同じ環境を再現する Dev Containersに移行してdevcontainer.jsonで環境を定義する

関連記事 ~ 次に身につけるLinuxスキル

WSL2とVS Codeが使えるようになったら、次は実際のLinuxコマンドや設定を深く学んでいきましょう。
以下の7つのテーマで、WSL2・VPS・クラウド環境でそのまま使える実践的なスキルを身につけられます。

・シェルスクリプト:set -xコマンドでシェルスクリプトをデバッグする方法|set -e・set -uとの組み合わせも ~ スクリプトのデバッグを素早く行う
・セキュリティ:fail2banコマンドでブルートフォース攻撃を自動ブロックする方法|SSHの不正アクセス対策も ~ SSHへの不正アクセスを自動でブロックする
・サーバー構築:scpコマンドでファイルを安全に転送する方法|公開鍵認証やディレクトリごとコピーも ~ VPSとWindowsの間でファイルを転送する
・トラブルシューティング:straceコマンドでプロセスのシステムコールを追跡する方法|Permission deniedの原因特定も ~ コマンドが動かない原因を深く調べる
・ネットワーク:nmcliコマンドでネットワーク接続を設定する方法|静的IP・DHCPの切替も ~ VPS・クラウドのネットワーク設定を理解する
・ディスク管理:lsblkコマンドでブロックデバイスを一覧表示する方法|ディスク構成やパーティション確認も ~ WSL2やVPSのストレージ状況を把握する
・現場Tips:watchコマンドで定期的にコマンドを繰り返し実行する方法|変化の検出やログ監視にも ~ コマンドを自動で繰り返して状態変化を監視する
現場で通用する安全なLinuxサーバー構築の「型」を体系的に身につけたい方へ、
無料の「Linuxサーバー構築入門マニュアル(図解60ページ)」をプレゼントしています。
WSL2やVS Codeでの学習をさらに深めたい方は、ぜひ受け取ってみてください。
無料マニュアルを受け取る >>

<PR>手元に置いて学びを深める1冊

Visual Studio Code完全入門 Webクリエイター&エンジニアの作業がはかどる新世代エディターの操り方

まず無料メルマガでLinuxの基礎を学ぶのが第一歩。VS Codeをさらに深く使いこなすには、本書でショートカット・拡張機能・WSL連携の全体像を体系的に身につけるのが近道です。

無料メルマガで学習を続ける

Linuxの実践スキルをメールで毎週お届け。
登録は30秒、解除もいつでも可。

登録無料・いつでも解除できます

暗記不要・1時間後にはサーバーが動く

3,100名以上が実践した「型」を無料で公開中

プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
その「型」を図解60Pにまとめた入門マニュアルを、完全無料でプレゼントしています。

姓・名・メールの3つだけ/30秒/解除は3秒 / 詳細はこちら

Linux無料マニュアル(図解60P) 名前とメールで30秒登録

運営

リナックスマスター.JP(代表 宮崎智広)

株式会社イーネットマーキュリーが運営するLinux教育サイトです。代表の宮崎智広は現役のLinuxサーバー管理者として20年以上の実務経験を持ち、累計3,100名以上のエンジニアを指導してきました。実践型のLinuxセミナーや無料マニュアルの配布を通じてLinux人材の育成に取り組んでいます。