# Python SDK の構成

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/idea/llms.txt).

> **Note:**
> [Python プラグイン(英語)](https://plugins.jetbrains.com/plugin/631-python)が [インストールされ、有効になっている](managing-plugins.html)ことを確認してください。 このプラグインは、Python 開発者向けのスタンドアロン IDE である [PyCharm](https://www.jetbrains.com/ja-jp/pycharm/) のすべての機能を実装します。 サポートされている機能の詳細については、 [PyCharm のドキュメント](https://www.jetbrains.com/ja-jp/help/pycharm/)を参照してください。

IntelliJ IDEA で Python スクリプトを開発するには、 [Python(英語)](http://www.python.org/) をダウンロードしてインストールし、少なくとも 1 つの Python SDK を構成します。 Python SDK は、 [Python プロジェクト](creating-empty-python-project.html)の Python インタープリターとして指定できます。

IntelliJ IDEA は以下をサポートしています:

* 標準 [Python インタープリター (英語)](http://python.org/)

* [PyPy(英語)](http://pypy.org/)

使用可能な SDK のリストを表示するには、メインメニュー `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS)) から  `ファイル | プロジェクト構造`  を選択します。 Python SDK は、次のレベルで構成できます。

プラットフォームレベル:
選択した SDK は、すべての Python プロジェクトで使用できます。

![利用可能な Python SDK を表示する](https://resources.jetbrains.com/help/img/idea/2026.3/ij_sdk_packages.png)

プロジェクトレベル:
選択した SDK は、現在のプロジェクトとそのすべてのモジュールで使用されます。

![Python SDK を変更する](https://resources.jetbrains.com/help/img/idea/2026.3/python_plugin_change_sdk.png)

モジュールレベル:
選択した SDK は、現在のプロジェクトモジュールで使用されます。

![Python SDK モジュールの管理](https://resources.jetbrains.com/help/img/idea/2026.3/python_plugin_sdk_module.png)

それらを簡単に区別するには、   名前   フィールドに異なる名前を入力します。 SDK 構成の詳細については、 [SDK](sdk.html)を参照してください。

Python SDK を追加するには、Python インタープリターを構成する必要があります。 レベルに関係なく、ローカルまたはリモート Python インタープリターを構成できます。

## ローカル Python インタープリターを構成する

ローカル Python インタープリターを構成するには、次のいずれかのプロシージャに従ってください:

Procedure: virtualenv 環境を作成する

1. `ファイル | プロジェクト構造`  に移動するか、 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS)) を押します。

2. プロジェクト構造   ダイアログで、   SDK   を   プラットフォーム設定   セクションで選択し、 ![新しい SDK を追加](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして、ポップアップメニューから   ディスクから Python SDK を追加します ...   を選択します。   Python インタープリターの追加   ダイアログが開きます。

![新しい Python SDK の追加](https://resources.jetbrains.com/help/img/idea/2026.3/ij_add_Python_sdk.png)

3. 次のアクションは、新しい仮想環境を生成するか、既存の仮想環境を使用するかによって異なります。

新しい virtualenv 環境
: ![新しい仮想環境を生成する](https://resources.jetbrains.com/help/img/idea/2026.3/ij_new_virtualenv_environment.png)
:
: 1.  環境タイプのリストから   Virtualenv   を選択します。
:
: 2.
:
: リストから基本インタープリターを選択するか、 ![ベースインタープリターを選択](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) をクリックしてファイルシステム内の Python 実行可能ファイルを見つけます。
:
:
:
: 3.    ロケーション   フィールドに新しい仮想環境の場所を指定するか、 ![仮想環境の場所](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) をクリックしてファイルシステム内の場所を参照します。 新しい仮想環境のディレクトリは空である必要があります。
:
: 4.
:
: マシン上のグローバル Python にインストールされているすべてのパッケージを、これから作成する仮想環境に追加する場合は、   ベースインタープリターからパッケージを継承する   チェックボックスを選択します。 このチェックボックスは、 [virtualenv](http://www.virtualenv.org/en/latest/index.html) ツールの  `--system-site-packages`  オプションに対応しています。

既存の virtualenv 環境
: ![既存の仮想環境を選択](https://resources.jetbrains.com/help/img/idea/2026.3/ij_existing_virtualenv_environment.png)
:
: * 環境タイプのリストから Python を選択します。
:
: * リストから必要なインタープリターを選択します。 必要なインタープリターがリストにない場合は、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) をクリックし、必要な Python 実行可能ファイル (たとえば、macOS の場合は `venv/bin/python` 、Windows の場合は `venv\Scripts\python.exe` ) を参照します。
:
:
:
: 選択した仮想環境は、現在のプロジェクトで再利用されます。

4. タスクを完了するには、   OK   をクリックします。

> **Note:**
> IntelliJ IDEA が   無効な環境   警告を表示する場合は、指定された Python バイナリがファイルシステムで見つからないか、Python バージョンが [サポート](python.html#support)されていないことを意味します。 Python パスを確認し、必要に応じ [て新しいバージョンをインストール(英語)](https://www.python.org/downloads/)します。

詳細については、 [PyCharm のドキュメント](https://www.jetbrains.com/ja-jp/help/pycharm/creating-virtual-environment.html)を参照してください。

Procedure: conda 環境を作成する

1. [Anaconda(英語)](https://www.continuum.io/) または [Miniconda(英語)](https://conda.io/en/latest/miniconda.html) がコンピューターにダウンロードされインストールされていること、およびその実行可能ファイルへのパスを認識していることを確認します。

詳細については、 [インストール手順(英語)](https://docs.anaconda.com/anaconda/install/)を参照してください。

2. `ファイル | プロジェクト構造`  に移動するか、 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS)) を押します。

3. プロジェクト構造   ダイアログで、   SDK   を   プラットフォーム設定   セクションで選択し、 ![新しい SDK を追加](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして、ポップアップメニューから   ディスクから Python SDK を追加します ...   を選択します。   Python インタープリターの追加   ダイアログが開きます。

![新しい Python SDK の追加](https://resources.jetbrains.com/help/img/idea/2026.3/ij_add_Python_sdk.png)

4. 次のアクションは、新しい conda 環境を作成するか、既存の環境を使用するかによって異なります。

新しい conda 環境
: ![新しい conda 環境を生成する](https://resources.jetbrains.com/help/img/idea/2026.3/ij_new_conda_environment.png)
:
: 1.  環境タイプのリストから   Conda   を選択します。
:
: 2.  リストから Python のバージョンを選択します。
:
: 3.  環境名を指定します。
:
: 4.
:
: IntelliJ IDEA は conda のインストールを検出します。
:
:
:
: IntelliJ IDEA がインストールを自動的に検出しなかった場合は、conda 実行可能ファイルの場所を指定するか、 ![Conda 実行可能ファイルの場所](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) をクリックして参照します。

既存の conda 環境
: ![既存の conda 環境を選択](https://resources.jetbrains.com/help/img/idea/2026.3/ij_existing_conda_environment.png)
:
: 1.  環境タイプのリストから   Conda   を選択します。
:
: 2.
:
: IntelliJ IDEA は conda のインストールを検出します。
:
:
:
: IntelliJ IDEA がインストールを自動的に検出しなかった場合は、conda 実行可能ファイルの場所を指定するか、 ![閲覧…](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) をクリックして参照します。
:
:
:
: 3.  リストから環境を選択します。
:
:
:
: 選択した conda 環境は、現在のプロジェクトで再利用されます。

5. タスクを完了するには、   OK   をクリックします。

詳細については、 [PyCharm のドキュメント](https://www.jetbrains.com/ja-jp/help/pycharm/conda-support-creating-conda-virtual-environment.html)を参照してください。

Procedure: pipenv 環境を作成する

1. `ファイル | プロジェクト構造`  に移動するか、 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS)) を押します。

2. プロジェクト構造   ダイアログで、   SDK   を   プラットフォーム設定   セクションで選択し、 ![新しい SDK を追加](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして、ポップアップメニューから   ディスクから Python SDK を追加します ...   を選択します。   Python インタープリターの追加   ダイアログが開きます。

![新しい Python SDK の追加](https://resources.jetbrains.com/help/img/idea/2026.3/ij_add_Python_sdk.png)

3. 環境タイプのリストから   Pipenv   を選択します。

![新しい pipenv 環境を生成する](https://resources.jetbrains.com/help/img/idea/2026.3/ij_new_pipenv_environment.png)

4. リストから基本インタープリターを選択するか、 ![閲覧…](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) をクリックしてファイルシステム内の Python 実行可能ファイルを見つけます。

5. ベースバイナリディレクトリを  `PATH`  環境変数に追加した場合、追加のオプションを設定する必要はありません。pipenv 実行可能ファイルへのパスは自動検出されます。

IntelliJ IDEA が pipenv 実行可能ファイルを検出しない場合は、   pip 経由で pipenv をインストールする   をクリックして、IntelliJ IDEA が自動的にインストールできるようにします。

または、 [pipenv のインストール手順](null)に従って実行可能パスを検出し、それをダイアログで指定します。

6. タスクを完了するには、   OK   をクリックします。

> **Note:**
> IntelliJ IDEA が   無効な環境   警告を表示する場合は、指定された Python バイナリがファイルシステムで見つからないか、Python バージョンが [サポート](python.html#support)されていないことを意味します。 Python パスを確認し、必要に応じ [て新しいバージョンをインストール(英語)](https://www.python.org/downloads/)します。

pipenv 仮想環境を Python インタープリターとして設定すると、利用可能なすべてのパッケージが  `[Pipfile](null)`  で定義されたソースから追加されます。 パッケージは、pip ではなく pipenv を通じてパッケージリストにインストール、削除、更新されます。

詳細については、 [PyCharm のドキュメント](https://www.jetbrains.com/ja-jp/help/pycharm/pipenv.html)を参照してください。

Procedure: Poetry 環境を作成する

1. `ファイル | プロジェクト構造`  に移動するか、 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS)) を押します。

2. プロジェクト構造   ダイアログで、   SDK   を   プラットフォーム設定   セクションで選択し、 ![新しい SDK を追加](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして、ポップアップメニューから   ディスクから Python SDK を追加します ...   を選択します。   Python インタープリターの追加   ダイアログが開きます。

![新しい Python SDK の追加](https://resources.jetbrains.com/help/img/idea/2026.3/ij_add_Python_sdk.png)

3. 次のアクションは、新しい Poetry 環境を作成するか、既存の環境を使用するかによって異なります。

新しい Poetry 環境
: ![新しい詩の環境を生み出す](https://resources.jetbrains.com/help/img/idea/2026.3/ij_new_poetry_environment.png)
:
: 1.  環境タイプのリストから   Poetry   を選択します。
:
: 2.
:
: リストから基本インタープリターを選択するか、 ![閲覧…](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) をクリックしてファイルシステム内の Python 実行可能ファイルを見つけます。
:
:
:
: 3.
:
: IntelliJ IDEA は Poetry のインストールを検出します。
:
:
:
: IntelliJ IDEA が Poetry のインストールを検出しない場合は、   pip 経由で詩をインストールする   をクリックして、IntelliJ IDEA が Poetry を自動的にインストールできるようにします。
:
:
:
: または、Poetry 実行可能ファイルの場所を指定するか、 ![閲覧…](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) をクリックして参照します。
:
:
:
: 4.  プロジェクトディレクトリ内に仮想環境を作成するには、   プロジェクト内環境を作成する   チェックボックスを選択します。

既存の Poetry 環境
: ![既存の詩の環境を選択](https://resources.jetbrains.com/help/img/idea/2026.3/ij_existing_poetry_environment.png)
:
: 1.  環境タイプのリストから   Poetry   を選択します。
:
: 2.
:
: IntelliJ IDEA は Poetry のインストールを検出します。
:
:
:
: IntelliJ IDEA がインストールを自動的に検出しなかった場合は、実行可能ファイルの場所を指定するか、 ![閲覧…](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) をクリックして閲覧します。
:
:
:
: 3.
:
: リストから環境を選択します。
:
:
:
: 選択した Poetry 環境は、現在のプロジェクトで再利用されます。

4. タスクを完了するには、   OK   をクリックします。

詳細については、 [PyCharm のドキュメント](https://www.jetbrains.com/ja-jp/help/pycharm/poetry.html)を参照してください。

Procedure: uv 環境を作成する

1. `ファイル | プロジェクト構造`  に移動するか、 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS)) を押します。

2. プロジェクト構造   ダイアログで、   SDK   を   プラットフォーム設定   セクションで選択し、 ![新しい SDK を追加](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして、ポップアップメニューから   ディスクから Python SDK を追加します ...   を選択します。   Python インタープリターの追加   ダイアログが開きます。

![新しい Python SDK の追加](https://resources.jetbrains.com/help/img/idea/2026.3/ij_add_Python_sdk.png)

3. 次のアクションは、新しい仮想環境を生成するか、既存の仮想環境を使用するかによって異なります。

新しい uv 環境
: ![新しい uv 環境を生成する](https://resources.jetbrains.com/help/img/idea/2026.3/ij_new_uv_environment.png)
:
: 1.  環境タイプのリストから   uv   を選択します。
:
: 2.
:
: リストから基本インタープリターを選択するか、 ![ベースインタープリターを選択](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) をクリックしてファイルシステム内の Python 実行可能ファイルを見つけます。
:
:
:
: 3.
:
: IntelliJ IDEA は uv のインストールを検出します。
:
:
:
: IntelliJ IDEA がインストールを自動的に検出しなかった場合は、uv 実行可能ファイルの場所を指定するか、 ![閲覧…](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) をクリックして参照します。

既存の uv 環境
: ![既存の uv 環境を選択](https://resources.jetbrains.com/help/img/idea/2026.3/ij_existing_uv_environment.png)
:
: 1.  環境タイプのリストから   uv   を選択します。
:
: 2.
:
: IntelliJ IDEA は uv のインストールを検出します。
:
:
:
: IntelliJ IDEA がインストールを自動的に検出しなかった場合は、uv 実行可能ファイルの場所を指定するか、 ![閲覧…](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) をクリックして参照します。
:
:
:
: 3.  リストから環境を選択します。
:
:
:
: 選択した uv 環境は、現在のプロジェクトで再利用されます。

4. タスクを完了するには、   OK   をクリックします。

詳細については、 [PyCharm のドキュメント](https://www.jetbrains.com/ja-jp/help/pycharm/uv.html)を参照してください。

Procedure: ハッチ環境を作成する

1. `ファイル | プロジェクト構造`  に移動するか、 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS)) を押します。

2. プロジェクト構造   ダイアログで、   SDK   を   プラットフォーム設定   セクションで選択し、 ![新しい SDK を追加](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして、ポップアップメニューから   ディスクから Python SDK を追加します ...   を選択します。   Python インタープリターの追加   ダイアログが開きます。

![新しい Python SDK の追加](https://resources.jetbrains.com/help/img/idea/2026.3/ij_add_Python_sdk.png)

3. 次のアクションは、新しい仮想環境を生成するか、既存の仮想環境を使用するかによって異なります。

新しい Hatch 環境
: ![新しいハッチ環境を生成する](https://resources.jetbrains.com/help/img/idea/2026.3/ij_new_hatch_environment.png)
:
: 1.  環境タイプのリストから   Hatch   を選択します。
:
: 2.
:
: IntelliJ IDEA は Hatch のインストールを検出します。
:
:
:
: IntelliJ IDEA がインストールを自動的に検出しなかった場合は、Hatch 実行可能ファイルの場所を指定するか、 ![閲覧…](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) をクリックして参照します。
:
:
:
: 3.
:
: 環境を選択します。
:
:
:
: Hatch 環境は、プロジェクト固有の様々なタスク用に設計されたワークスペースです。 環境が明示的に選択されていない場合、Hatch は [デフォルトの環境(英語)](https://hatch.pypa.io/latest/tutorials/environment/basic-usage/)を使用します。
:
:
:
: 4.
:
: リストから基本インタープリターを選択するか、 ![ベースインタープリターを選択](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) をクリックしてファイルシステム内の Python 実行可能ファイルを見つけます。

既存の Hatch 環境
: ![既存のハッチ環境を選択](https://resources.jetbrains.com/help/img/idea/2026.3/ij_existing_hatch_environment.png)
:
: 1.  環境タイプのリストから   Hatch   を選択します。
:
: 2.
:
: IntelliJ IDEA は Hatch のインストールを検出します。
:
:
:
: IntelliJ IDEA がインストールを自動的に検出しなかった場合は、Hatch 実行可能ファイルの場所を指定するか、 ![閲覧…](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) をクリックして参照します。
:
:
:
: 3.  リストから環境を選択します。

4. タスクを完了するには、   OK   をクリックします。

詳細については、 [PyCharm のドキュメント](https://www.jetbrains.com/ja-jp/help/pycharm/hatch.html)を参照してください。

## リモート Python インタープリターの構成

リモート Python インタープリターを構成するには:

Procedure: WSL インタープリターを構成する

1. 画面の左下隅にある Windows ボタンをクリックし、  `System Information`  の入力を開始します。 システムが WSL でうまく動作するように、Windows を最新の使用可能なバージョンにアップグレードしてください。

2. Windows Subsystem for Linux をインストールし、 [WSL インストールガイド](https://docs.microsoft.com/en-us/windows/wsl/install-win10)の説明に従って Linux ディストリビューションを初期化します。

3. Linux ディストリビューションに rsync が付属していない場合は、インストールする必要があります。

Debian:
`sudo apt install rsync`

Arch:
`sudo pacman -S rsync`

> **Note:**
> WSL 2 を使用する場合は、次の既知の WSL 課題に注意してください:
>
>
>
> * [WSL2 ネットワークの Windows ファイアウォールに「許可」ルールを追加する (英語)](https://github.com/microsoft/WSL/issues/4585)
>
> * [stdin は Python プロセスに対して明示的に閉じられます (英語)](https://github.com/microsoft/WSL/issues/4424)
>
> * ファイアウォールが WSL IP 用に開かれていない場合、デバッガーは正しく機能しません。

4. `ファイル | プロジェクト構造`  に移動するか、 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS)) を押します。

5. プロジェクト構造   ダイアログで、   SDK   を   プラットフォーム設定   セクションで選択し、 ![新しい SDK を追加](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして、ポップアップメニューから   ディスクから Python SDK を追加します ...   を選択します。   Python インタープリターの追加   ダイアログが開きます。

![新しい Python SDK の追加](https://resources.jetbrains.com/help/img/idea/2026.3/ij_add_Python_sdk.png)

6. 環境タイプのリストから   WSL   を選択します。

7. 必要な Python インタープリターを含む Linux ディストリビューションを選択します。

8. Python インタープリターパス   フィールドで、Python 実行可能ファイルへのパスを指定します。 デフォルトを受け入れるか、別のパスを入力するか、 ![参照ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) をクリックして閲覧できます。

![WSL を使用してリモートインタープリターを追加する](https://resources.jetbrains.com/help/img/idea/2026.3/py_interpreter_wsl.png)

9. OK   をクリックします。

構成されたリモートインタープリターがリストに追加されます。

Procedure: SSH を使用してインタープリターを構成する

> **Warning:**
> SSH インタープリターを構成するときに、Windows マシンをリモートホストとして使用することはできません。

1. IntelliJ IDEA は ssh-sessions を介してリモートインタープリターを実行するため、リモートホストで SSH サーバーが実行されていることを確認してください。

2. `ファイル | プロジェクト構造`  に移動するか、 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS)) を押します。

3. プロジェクト構造   ダイアログで、   SDK   を   プラットフォーム設定   セクションで選択し、 ![新しい SDK を追加](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして、ポップアップメニューから   ディスクから Python SDK を追加します ...   を選択します。   Python インタープリターの追加   ダイアログが開きます。

![新しい Python SDK の追加](https://resources.jetbrains.com/help/img/idea/2026.3/ij_add_Python_sdk.png)

4. 新規サーバー構成   を選択し、サーバー情報 (ホスト、ポート、ユーザー名) を指定します。

![SSH 経由でインタープリターを追加する](https://resources.jetbrains.com/help/img/idea/2026.3/ij_interpreter_ssh_add.png)

または、   既存サーバー構成   を選択して、使用可能なデプロイ構成をリストから選択することもできます。

![既存構成](https://resources.jetbrains.com/help/img/idea/2026.3/ij_existing_ssh_configuration.png)

必要に応じて、 ![参照ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) をクリックして、選択したデプロイ構成の [接続設定](deployment-connection-tab.html)、 [マッピング](deployment-mappings-tab.html)、 [除外対象パス](deployment-excluded-paths-tab.html)を確認します。 インタープリターの設定を続行するには、   次へ   をクリックします。

5. 次のダイアログウィンドウで、ターゲットサーバーに接続するための認証の詳細を入力します。

![認証の詳細を指定する](https://resources.jetbrains.com/help/img/idea/2026.3/py_ssh_target_2.png)

パスワード   または   鍵ペア (OpenSSH または PuTTY)   を選択し、パスワードまたはパスフレーズを入力します。   鍵ペア (OpenSSH または PuTTY)   を選択した場合は、以下を指定します。

* 秘密鍵 : 秘密鍵を含むファイルの場所

* パスフレーズ : パスワードと同様に、 [秘密鍵を暗号化する](https://www.ssh.com/ssh/passphrase)ために使用します。

続行するには   次へ   をクリックします。

6. 次のダイアログウィンドウで、目的の Python インタープリターへのパスを確認します。 デフォルトを受け入れることも、別の値を指定することもできます。 ローカルプロジェクトとサーバー間のパスマッピングを構成する必要があります。 これを行うには、   フォルダーの同期   フィールドの横にある ![参照ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) をクリックし、ローカルプロジェクトフォルダーへのパスとリモートサーバー上のフォルダーへのパスを入力します。

![SSH マッピングの設定](https://resources.jetbrains.com/help/img/idea/2026.3/py_interpreter_ssh_mappings.png)

チェックボックスを選択して、リモートサーバーへのローカル変更の自動アップロードを有効化することもできます。

7. OK   をクリックします。

構成されたリモートインタープリターがリストに追加されます。

Procedure: Docker を使用してインタープリターを構成する

1. 次の前提条件が満たされていることを確認してください:

* [Docker のドキュメント(英語)](https://docs.docker.com)に従って、Docker がインストールされます。

* 安定したインターネット接続があり、IntelliJ IDEA が `busybox:latest` ( [BusyBox Docker 公式イメージ(英語)](https://hub.docker.com/_/busybox)の最新バージョン) をダウンロードして実行できます。 Docker を使用してインタープリターを正常に構成したら、オフラインにすることができます。

> **Note:**
> Docker ベースのプロジェクトインタープリターに Python パッケージをインストールすることはできません。

2. `ファイル | プロジェクト構造`  に移動するか、 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS)) を押します。

3. プロジェクト構造   ダイアログで、   SDK   を   プラットフォーム設定   セクションで選択し、 ![新しい SDK を追加](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして、ポップアップメニューから   ディスクから Python SDK を追加します ...   を選択します。   Python インタープリターの追加   ダイアログが開きます。

![新しい Python SDK の追加](https://resources.jetbrains.com/help/img/idea/2026.3/ij_add_Python_sdk.png)

4. 環境タイプのリストから   Docker   を選択します。

![Docker を使用して Python インタープリターを追加する](https://resources.jetbrains.com/help/img/idea/2026.3/interpreter_docker_empty.png)

5. Docker サーバー   ドロップダウンで既存の Docker 構成を選択します。

または、   新規   をクリックして次の手順を実行し、新しい Docker 構成を作成します。

Docker 構成を作成
: ![The Add button](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして Docker 構成を追加し、Docker デーモンへの接続方法を指定します。
:
:
:
: 接続設定は、Docker のバージョンとオペレーティングシステムによって異なります。 詳細については、 [Docker 接続設定](settings-docker.html)を参照してください。
:
:
:
: ダイアログの下部に   接続成功   メッセージが表示されます。
:
:
:
: ![インタープリターの Docker 接続設定](https://resources.jetbrains.com/help/img/idea/2026.3/interpreter_docker_config.png)
:
: Windows で Docker または macOS を使用するときに、Docker デーモンを実行している仮想マシンにローカルパスをマッピングする方法の詳細については、 [Windows および macOS ホストの仮想マシンパスマッピング](settings-docker.html#virtual-machine-path)を参照してください。 マッピングされたローカルパスの外部にあるディレクトリに対してボリュームやバインドマウントを使用することはできません。
:
:
:
: このテーブルは、Docker がネイティブに実行され、任意のディレクトリをコンテナーにマウントできる Linux ホストでは使用できません。

6. イメージと Python 実行可能ファイルへのパスを指定します:

![Docker を使用した Python インタープリターの設定](https://resources.jetbrains.com/help/img/idea/2026.3/interpreter_docker_final.png)

7. OK   をクリックします。

構成されたリモートインタープリターがリストに追加されます。

Procedure: Docker Compose を使用してインタープリターを構成する

1. 次の前提条件が満たされていることを確認してください:

* [Docker のドキュメント(英語)](https://docs.docker.com)に従って、Docker がインストールされます。

* 安定したインターネット接続があり、IntelliJ IDEA が `busybox:latest` ( [BusyBox Docker 公式イメージ(英語)](https://hub.docker.com/_/busybox)の最新バージョン) をダウンロードして実行できます。 Docker を使用してインタープリターを正常に構成したら、オフラインにすることができます。

> **Note:**
> Docker ベースのプロジェクトインタープリターに Python パッケージをインストールすることはできません。

2. `ファイル | プロジェクト構造`  に移動するか、 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS)) を押します。

3. プロジェクト構造   ダイアログで、   SDK   を   プラットフォーム設定   セクションで選択し、 ![新しい SDK を追加](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして、ポップアップメニューから   ディスクから Python SDK を追加します ...   を選択します。   Python インタープリターの追加   ダイアログが開きます。

![新しい Python SDK の追加](https://resources.jetbrains.com/help/img/idea/2026.3/ij_add_Python_sdk.png)

4. 環境タイプのリストから   Docker Compose   を選択します。

![Docker Compose を使用して Python インタープリターを追加する](https://resources.jetbrains.com/help/img/idea/2026.3/interpreter_docker_compose_empty.png)

5. サーバー   ドロップダウンで Docker 構成を選択します。

6. 構成ファイル   で  `docker-compose.yml`  ファイルを指定し、サービスを選択します。

![Docker Compose を使用した Python インタープリターの設定](https://resources.jetbrains.com/help/img/idea/2026.3/interpreter_docker_compose_final.png)

必要に応じて、 [環境変数(英語)](https://docs.docker.com/compose/environment-variables/)を指定して [プロジェクト名を作成する(英語)](https://docs.docker.com/reference/cli/docker/compose/#use--p-to-specify-a-project-name)を編集します。

7. 最後に、Python 実行可能ファイルへのパスを指定します:

![Docker Compose を使用した Python インタープリターの設定](https://resources.jetbrains.com/help/img/idea/2026.3/interpreter_docker_compose_final2.png)

8. OK   をクリックします。

構成されたリモートインタープリターがリストに追加されます。

リモート Python インタープリターの詳細については、 [PyCharm のドキュメント](https://www.jetbrains.com/ja-jp/help/pycharm/using-docker-as-a-remote-interpreter.html)を参照してください。

## Python インタープリターを削除する

プロジェクトの Python インタープリターが不要になった場合は、プロジェクト設定から除去できます。

Procedure:

1. `ファイル | プロジェクト構造`  に移動するか、 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS)) を押します。

2. プロジェクト構造   ダイアログで、   プラットフォーム設定   の   SDK   ノードをクリックします。

3. 削除するインタープリターを選択し、 ![インタープリターの除去](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg) をクリックします。

![Python インタープリターを削除する](https://resources.jetbrains.com/help/img/idea/2026.3/ij_remove_python_interpreter.png)

## 非 Python モジュールに Python サポートを追加する

Java や Kotlin モジュールなど、別の種類のモジュールで Python コードを扱うには、個別の Python モジュールを作成する代わりに、このモジュールに Python ファセットを追加します。 ファセットは、選択した Python SDK をモジュール依存関係に、  `<SDK name> interpreter library`  というお名前のライブラリとして追加します。

Python モジュールに Python ファセットを追加することはできません。 Python モジュールのインタープリターを構成するには、モジュールレベルで Python SDK を選択します。

Procedure: モジュールに Python ファセットを追加する

1. メインメニューで、  `ファイル | プロジェクト構造`  ( `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS)) ) に移動します。

2. ファセット   を選択し、 ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして、   Python   を選択します。

3. モジュールの選択   ダイアログで、ファセットを追加するモジュールを選択し、   OK   をクリックします。

4. Python インタープリター   リストで、モジュールの Python SDK を選択します。

5. 変更を適用して、ダイアログを閉じます。

モジュール   ページでもファセットを追加できます: モジュールを選択し、モジュールツリーの上にある ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして、   Python   を   フレームワーク   セクションで選択します。 ファセットの詳細については、 [フレームワークを追加する (ファセット)](adding-support-for-frameworks-and-technologies.html) を参照してください。

## インタープリターのパスを管理する

IntelliJ IDEA を使用すると、選択したインタープリターへのパスを追加できます。 これらのパスは環境変数  `PYTHONPATH`  に追加されます。 IntelliJ IDEA はこれらのパスをインデックス化し、コードのオブジェクト (パッケージのインポートなど) を解決します。

Procedure: インタープリターのパスを表示

1. `ファイル | プロジェクト構造`  に移動するか、 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS)) を押します。

2. プロジェクト構造   ダイアログで、   プラットフォーム設定   の   SDK   ノードをクリックします。

3. インタープリターを選択します。

4. インタープリターパスを   クラスパス   タブで表示します:

![「クラスパス」タブ](https://resources.jetbrains.com/help/img/idea/2026.3/project_structure_python_plugin_sdks.png)

Procedure: インタープリターパスを追加する

1. クラスパス   タブで、 ![追加](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックします。

2. 開いたダイアログでパスを指定します。 特定の Python バージョンへのパスを追加するには、 [https://www.python.org/](https://www.python.org/) からダウンロードしてマシンにインストールする必要があることに注意してください。

Procedure: インタープリターパスを削除する

1. クラスパス   タブで削除するパスを選択します。

2. ![除去](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg) をクリックします。

> **Note:**
> 構成された Python インタープリター（ただし Docker ベース）のいずれかの場合、 [パッケージのインストール、アンインストール、アップグレード](https://www.jetbrains.com/ja-jp/help/pycharm/installing-uninstalling-and-upgrading-packages.html)

