【2025年5月版】たった10分でできる！VS Code×Jupyter Notebook完全導入ガイド

# はじめに

APIを実行してその動作を確認したい場面では、Jupyter Notebookが非常によく活用されます。
しかしながら、導入方法が複数あったり、考慮すべき点も多いため、「どこから手をつければよいか分からない…」と戸惑ってしまう方も少なくありません。

本記事では、以下の3点をゴールとして、初心者の方でもスムーズにJupyter Notebookを使い始められることを目指しています。

- Windows環境のVS Code上で、Jupyter Notebookを最短10分で実行可能に

- Pythonを仮想環境で実行することで、他のソフトに影響しない安全な開発環境を構築

- コマンドはすべてコピー＆ペーストで実行可能、値の書き換えも不要なので安心

この記事を参考に、ぜひJupyter Notebookを活用してみてください。

# 手順1：Pythonのインストール（所要時間：約2分）

**Python がインストール済みであれば本手順はスキップしてかまいません。**

1. 下記リンクを開き、[Download Python *****]をクリックしインストーラをダウンロードします。   
   ※ ***** にはその時点の最新安定版のバージョン番号が入ります
   
   [Download Python | Python.org](https://www.python.org/downloads/)

   ![1.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1833876/5258cdaa-1fed-4555-af17-ed5de2cfaa56.png)

   
   ※ クリックしてもダウンロードされない場合は、遷移したページの[Files]欄まで移動し、[Windows installer (64-bit)]をクリックしダウンロードします

2. ダウンロードしたインストーラーを実行します

3. [Install Python *****(64-Bit)]画面が表示されたら、[Add python.exe to PATH]にチェックを入れ、[Install Now]をクリックします
    ![2.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1833876/b9d54dea-4047-4491-9ce3-f717a8b11229.png)
   
   **※ [Add python.exe to PATH]にチェックが入っていない場合、コマンドが実行できなくなりますので、必ずチェックを入れてください**

4. [Setup was successful]画面が表示されたら、[Close]をクリックします
    ![3.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1833876/c7aa2807-7127-425c-af46-aa3d7606b228.png)

# 手順2：VS Codeのインストール（所要時間：約2分）

**VS Codeがインストール済みであれば本手順はスキップしてかまいません。**

1. 下記リンクを開き、[Download for Windows]をクリックし、VS Codeのインストーラーをダウンロードします
   
   [Visual Studio Code - Code Editing. Redefined](https://code.visualstudio.com/)
   ![4.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1833876/d28554d6-ef10-4677-ad5d-368ba11baa12.png)


2. ダウンロードしたインストーラーを実行します

3. [使用許諾契約書の同意]画面が表示されたら[同意する]を選択し、[次へ]をクリックします
    ![5.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1833876/dbb69fe3-88bb-49ff-9d0f-455530f0d2dc.png)


4. [インストール先の指定]画面が表示されたら、[次へ]をクリックします
    ![6.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1833876/34f65253-53ec-433c-bc05-ba300a338d49.png)


5. [スタートメニューフォルダの指定]画面が表示されたら、[次へ]をクリックします
   ![7.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1833876/28ed0db6-3a53-42b8-9242-749f7024c434.png)


6. [追加タスクの選択]画面が表示されたら、[次へ]をクリックします
    ![8.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1833876/7dbe363e-6521-4219-9ac4-6e8cf20f998c.png)

7. [インストール準備完了]画面が表示されたら、[インストール]をクリックします
    ![9.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1833876/203c9d4e-9512-46be-b8c1-531b8382c4c0.png)

8. [Visual Studio Codeセットアップウィザードの完了]画面が表示されたら、[完了]をクリックします
    ![10.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1833876/4aff3eb9-a6f9-4d87-afbf-931eebfbad49.png)

9. VS Codeが起動することを確認します

10. 画面下部の[Mark Done]をクリックします
    ![11.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1833876/b551c137-751a-4ddd-b006-a53bae4d5144.png)

11. 画面下部の[Show welcome page on startup]のチェックを外し、[welcome]を閉じます
    ![12.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1833876/149b3173-e8b4-419c-a229-84b8a3b6fd38.png)

# 手順3：VS Codeへ拡張機能のインストール（所要時間：約2分）

1. 画面左側の[Extensions]アイコン（四角が4つ並んだマーク）をクリックします
    ![13.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1833876/f29c9c33-bf4b-426f-ae43-bbbac11dd6e3.png)

2. 検索欄に「Python」と入力します

3. 表示された Python（作成者がMicrosoft）欄の[Install]をクリックします
    ![14.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1833876/e93e5d0a-c66f-4716-af9b-f38d5e7cda6b.png)

4. インストールが完了するまで待ちます

5. 検索欄に「Jupyter」と入力します

6. 表示された Jupyter（作成者がMicrosoft）欄の[Install]をクリックします
        ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1833876/b094756d-aa9f-41ec-bca1-7d07681e2e5c.png)


7. インストールが完了するまで待ちます

8. インストールが完了したらVS Codeを一度終了します

**※ このタイミングでVS Codeを再起動しないと後続の操作ができない場合があります。**

# 手順4：Pythonの仮想環境の構築（所要時間：約3分）

Pythonはさまざまなソフトやツールで使われています。それらに影響を与えないように、Pythonの仮想環境（venv）を構築し、その中にJupyter Notebookの実行に必要なパッケージをインストールします。

1. VS Codeを起動します

2. メニューから[Terminal] → [New Terminal]の順に選択します
    ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1833876/b4e9569e-32b7-4343-a4e5-72c9891222f2.png)

3. 画面下部に表示されたターミナルで以下のコマンドをコピー＆ペーストして実行し、仮想環境を作成します

   ```
   python -m venv venv
   ```
   ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1833876/6ab59b39-19d6-49a3-ac88-4790a142f414.png)

   **[補足]**
   本記事ではコマンドをコピペで実行するだけでを構築できることを優先し上記コマンドで、`c:\users\ユーザー名` 配下に `venv` フォルダが作成し、そちらに仮想環境用のファイルが保存しています。
   仮想環境のフォルダは、プロジェクトごとに作成するのがおすすめです。もし任意のフォルダに保存したい場合には、下記のようにパスを指定して仮想環境を作成し、以降の手順においても作成したパスを指定して実行をして下ください。

   ```
   python -m venv C:\PythonProjects\MyNotebook
   ```
  
4. 次に、以下のコマンドをコピー＆ペーストして実行し、仮想環境のアクティブ化スクリプトが実行可能な状態にします

   ```
   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
   ```

5. 続いて、以下のコマンドをコピー＆ペーストして実行し、仮想環境を有効にします

   ```
   .\venv\Scripts\activate.ps1
   ```
   
6. ターミナルのプロンプトの先頭に `(venv)` と表示されたことを確認します。これは仮想環境が有効になった証拠です。
    ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1833876/ef6bbc09-0722-4eb4-aba1-fbd555f873be.png)


7. 以下のコマンドをコピー＆ペーストして実行し、Jupyter Notebookの実行に必要な `ipykernel` と `jupyter` のパッケージをインストールします

   ```
   pip install ipykernel jupyter notebook
   ```

   ※ パッケージのインストール中に「pip の更新が推奨される」というメッセージが表示された場合は、表示されたコマンド（`python.exe -m pip install --upgrade pip`）を実行して pip を更新してください。
    ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1833876/0825292c-6bfa-4ac5-8420-f111acd24beb.png)



8. 以下のコマンドをコピー＆ペーストして実行し、Jupyter用のカーネルを登録します

   ```
   python -m ipykernel install --user --name=venv
   ```

9. `Installed kernelspec venv in c:\user･･･` というメッセージが表示されたことを確認します
    ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1833876/94f6a105-97cb-4d91-b5ad-9f550b2694a4.png)

10. `exit` と入力してEnterキーを押し、ターミナルを閉じます

11. VS Codeを一度終了します

**※ このタイミングでVS Codeを再起動しないと後続の操作ができない場合があります。**

# 手順5：Jupyter Notebookでのカーネルの選択（所要時間：約1分）

1. VS Codeを再度起動します

2. メニューから[File] → [New File]の順に選択します

3. [Jupyter Notebook .ipynb Support]をクリックします
    ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1833876/5729d7f5-4d5f-4cd5-b75a-092c1957101d.png)

4. [Select Kernel]をクリックします
    ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1833876/d5020560-c35d-4a8e-a3a0-dceaa853f410.png)

5. [Jupyter Kernel]をクリックします
    ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1833876/aa6608a2-df56-4799-93b6-9b6921d72dbb.png)

6. [venv(Python バージョン)]を選択します
    ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1833876/2ce273ff-1a27-4f83-bba5-06379b7d2889.png)

7. [Windows セキュリティ]画面が表示されましたら[許可]をクリックします
    ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1833876/96073f0d-fb77-402a-83e9-ad9ef04afc5d.png)

8. 選択したカーネルが画面右上に表示されたことを確認します
    ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1833876/3100a09a-bce6-4b53-8bd8-aa6ec9beac06.png)

# 手順6：動作確認（Hello World）（所要時間：約30秒）

動作確認として簡単なコードを実行してみましょう。

1. 表示されたセルに以下のコードを入力します

   ```python
   print('Hello World')
   ```
2. セルの左側にある[Execute Cell]ボタン（右向き三角印）をクリックし、セルを実行します
    ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1833876/78acc944-6572-491b-bc16-5778e99fc993.png)

3. セルの下に「Hello World」と出力されれば、VS CodeでJupyter Notebookの実行環境の構築は完了です！
    ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1833876/f6c03ac5-7e7a-419e-9d60-a6c90dc2fcdc.png)

# まとめ

画面の指示に従い必要なコマンドをコピー＆ペーストで実行するだけで、簡単にVS Code上でJupyter Notebookが使える環境を構築できました。

この環境をベースに、日本語化や他の便利な拡張機能の追加も自由にできます。ぜひご自身の好みに合わせてカスタマイズしてください。

# お願い

本記事は2025年5月時点の情報に基づいています。VS CodeやPythonのバージョンアップにより、画面や手順が変わる場合があります。もし手順と異なる点があれば、ぜひコメントやお知らせください。随時記事の更新を行います。