PyCharm 2026.3 Help

ターミナルエミュレーター

PyCharm には、IDE から直接コマンドラインツールを操作するための組み込みターミナルエミュレーターが含まれています。 専用のターミナルアプリケーションに切り替えることなく、Git リポジトリの管理、ファイル権限の設定、AI コーディングエージェントの操作、その他のコマンドラインタスクの実行に使用します。

ターミナルプラグインを有効化

この機能は、デフォルトで PyCharm にバンドルされ有効になっている ターミナルプラグインに依存しています。 関連機能が利用できない場合は、プラグインが無効になっていないことを確認してください。

  1. Ctrl+Alt+S を押して設定を開き、 プラグイン​ を選択します。

  2. ターミナル プラグインを見つけて、 有効化 をクリックします。

ターミナルは libghostty を利用しています。これは Ghostty プロジェクトのターミナルエミュレーションライブラリです。

最初、ターミナルエミュレーターはデフォルトのシステムシェルで実行されますが、Windows PowerShell、コマンドプロンプト、 sh、 bash、 zsh、 csh など、他の多くのシェルもサポートしています。 シェルの変更の詳細については、 ターミナル設定 を参照してください。 デフォルトのシェルを変更せずに単一のタブで別のシェルを実行するには、 別のシェルでセッションを開始する を参照してください。

ターミナルツールウィンドウにアクセスする

  • 表示 | ツールウィンドウ | ターミナル に移動するか、 Alt+F12 を押します。

  • 任意のファイル(たとえば、 プロジェクト ツールウィンドウ(Alt+1 )内、開いているエディタータブ内)を右クリックして 開く | ターミナル を選択すると、そのファイルのディレクトリで新しいセッションを持つ ターミナル ツールウィンドウが開きます。

ターミナルセッション

ローカルセッション

新しいローカルセッションを開始する

  • 別のタブで新しいセッションを開始するには、ツールバーの 追加ボタン をクリックするか、 Ctrl+Shift+T を押します。

  • タブを閉じるには、ターミナルツールバーの 閉じるボタン​ をクリックするか、 Ctrl+F4 を押します。

  • 実行中のセッションを終了するには、 閉じるボタン​ をクリックしてタブを閉じ、プロセスの終了を確認します。

  • アクティブなタブを切り替えるには、 Alt+Right と Alt+Left を押します。 または、 Alt+Down を押すと、すべてのターミナルタブのリストが表示されます。

  • ターミナル画面をクリアするには、 ⌘ K を押します。

ターミナルは、project または PyCharm を閉じるとタブとセッションを保存します。 タブ名、現在の作業ディレクトリ、さらにはシェル履歴も保持されます。

定義済みセッション

PyCharm は定義済みセッション用の一般的なシェルを自動的に検出し、そのいずれかを新しいタブで実行できます。 選択したシェルは現在のタブにのみ適用され、他のタブには影響しません。 新しく作成されたタブは、 ターミナル設定で指定されたデフォルトのシェルを引き続き使用します。

検出されたシェルでセッションを開始

  1. ターミナルツールバーで、 「新しい定義済みセッション」ボタン新しい定義済みセッション をクリックします。

    検出されたシェルで定義済みセッションを開始
  2. リストからシェルを選択します。 PyCharm はシェルの名前が付いた新しいタブを開き、そのタブでセッションを開始します。

リストには次のシェルが含まれます:

  • Windows の場合: Windows PowerShell、 コマンドプロンプト、 PowerShell、 Git Bash 、およびインストール済みの WSL ディストリビューション。

  • macOS および Linux の場合: bash、 zsh、 fish 、および pwsh は、 /bin 、 /usr/bin 、 /usr/local/bin 、および /opt/homebrew/bin にあります。

これらの場所の外にあるシェルや他の種類のシェルは、自動的に検出されません。 これらを使用するには、 設定 | ツール | ターミナル の シェルパス オプションで実行可能ファイルへのパスを指定します。

検出された複数のシェルの名前が同じ場合、PyCharm は名前にパスを追加します。たとえば、 zsh (/bin/zsh) と zsh (/opt/homebrew/bin/zsh) です。

project が WSL または Dev Container にある場合、リストでは環境ごとにシェルがグループ化されるため、その環境またはホストマシンでセッションを開始できます。

SSH セッション

SSH Remote Run プラグインを有効化

この機能は、デフォルトで PyCharm にバンドルされ有効になっている SSH Remote Run プラグインに依存しています。 関連機能が利用できない場合は、プラグインが無効になっていないことを確認してください。

  1. Ctrl+Alt+S を押して設定を開き、 プラグイン​ を選択します。

  2. SSH Remote Run プラグインを見つけて、 有効化 をクリックします。

新しい SSH セッションを開始する

  1. ターミナルツールバーで、 新しい SSH セッションを開始する をクリックし、 新規 SSH セッション を選択します。

    新しい SSH セッションを開始する
  2. 接続するホストのアドレスを入力し、認証データを提供します。

    SSH セッションでのデータ提供ダイアログ

    または、 SSH 構成を設定している場合は、リストからいずれかを選択できます。

接続を終了するには、ターミナルタブで セッションを終了 をクリックします。

ターミナルで作業

  • ターミナルセッションで特定の文字列を検索するには、 Ctrl+F を押します。 これにより、セッション内のすべてのテキスト (プロンプト、コマンド、出力) が検索されます。

デフォルトでは、検索は大文字と小文字を区別しません。 検索フィールドで「Match Case アイコン」(大/小文字を区別する )をクリックすると、大文字と小文字が区別されます。

ターミナルタブの名前を変更する

  • タブを右クリックし、コンテキストメニューから セッション名の変更 を選択します。

ターミナルで補完を使用する

PyCharm は、パス、Git ブランチ、フラグなどのコマンド名、オプション、引数の補完を提供します。

入力すると、 ターミナル ツールウィンドウに自動的に候補が表示されます。 デフォルトでは、PyCharm はパラメーターの候補を表示します。

  • サブコマンド、パラメーター、引数の補完を有効にするには、 設定 | ツール | ターミナル | コマンド補完 に移動し、 入力時に補完ポップアップを表示するオプションに 常に を選択します。

  • 補完ポップアップを手動で呼び出すには、 Ctrl+Space を押します。

  • 提案を受け入れるには、リストで提案を選択し、 Enter を押します。

ターミナルでのコマンドの補完

ターミナルは、ファイルやフォルダーへの絶対パスと相対パスを認識してハイライトします。 マウスカーソルを重ねると、ハイパーリンクとして表示されます。 これにより、コンパイルメッセージ、ビルドエラー、AI コーディングエージェントの応答で参照されている場所にすばやく移動できます。

  • Ctrl キーを押しながらターミナルでファイル名をクリックすると、エディターでファイルが開きます。

  • Ctrl キーを押しながらターミナルでフォルダー名を含むリンクをクリックすると、 プロジェクト ツールウィンドウにそのフォルダーが表示されます。 フォルダーが現在のプロジェクト外にある場合、PyCharm はデフォルトのファイルシステムエクスプローラーを開きます。

  • または、ファイル名またはフォルダー名をクリックし、ツールチップに表示される オープン リンクを使用してください。

ファイルやフォルダーをターミナルにドラッグ&ドロップする

プロジェクト ツールウィンドウやシステムファイルマネージャから ターミナル ツールウィンドウにファイルやフォルダーをドラッグできます(Alt+1)。 どこにドロップするかによって結果が変わります。

  • ファイルまたはフォルダーをターミナルの出力エリア(1)にドロップすると、そのパスが現在のセッションのプロンプトに貼り付けられます。

    これは、CLI コーディングエージェントにファイルコンテキストを送信する場合や、パスを引数として受け取るコマンドを実行する場合に便利です。

  • ファイルまたはフォルダーをターミナルのタブエリア(2)にドロップすると、作業ディレクトリがドロップしたフォルダー、またはファイルの親フォルダーに設定された新しいタブが開きます。

ファイルをターミナルツールウィンドウにドラッグする

ターミナルレイアウトのカスタマイズ

ワークフローに合わせてターミナルタブを配置できます。複数のセッションを並べて表示したり、エディター領域でセッションを開いたり、 ターミナル ツールウィンドウをメインウィンドウから切り離したりできます。

ターミナルタブの分割

ターミナル ツールウィンドウを複数のタブグループに分割し、複数のセッションを同時に操作できます。 たとえば、一方のグループで CLI コーディングエージェントを実行し、もう一方のグループで他のシェルコマンドを実行します。 分割アクションで開いた新しいタブでは、元のタブの作業ディレクトリでセッションが開始されます。

「右に分割」で二つのタブグループに分割されたターミナルツールウィンドウ
  • 現在のタブの隣に新しいタブを開くには、タブを右クリックして 右に分割 または 下に分割 を選択します。

  • タブを別のグループに移動するには、タブを右クリックして 分割して右に移動 または 分割して下に移動 を選択します。 これらのオプションは、グループに複数のタブが含まれている場合に利用できます。

  • または、タブを ターミナル ツールウィンドウの任意の端にドラッグします。 PyCharm は、新しいグループが表示される領域をハイライトします。 タブを既存のグループに移動するには、そのグループのタブヘッダーにドラッグします。

  • グループ間でフォーカスを移動するには、グループをクリックするか、 ウィンドウ | アクティブなツールウィンドウ | 次のスプリッターに移動 (⌥ ⇥) または 前の分割に移動 (⌥ ⇧ ⇥) に移動します。

  • 分割されたタブグループをマージするには、タブを右クリックして 分割しない を選択します。 以前にツールウィンドウを複数回分割している場合は、各分割に対してこのアクションを繰り返します。 または、グループ内のすべてのタブを別のグループのタブヘッダーにドラッグします。 グループ内の最後のタブを閉じるか移動すると、そのグループは自動的に削除されます。

エディターでターミナルタブを開く

ターミナル ツールウィンドウからエディター領域にタブを移動し、通常のエディタータブとして使用できます。

  • ターミナル ツールウィンドウのタブを右クリックし、 エディタータブとして開く (Alt+Shift+Enter) を選択するか、タブをエディター領域にドラッグします。

    ツールウィンドウ内の最後のタブを移動すると、 ターミナル ツールウィンドウは自動的に非表示になります。

  • タブを元に戻すには、エディターでタブを右クリックして ツールウィンドウに戻る を選択するか、 ターミナル ツールウィンドウにドラッグします。

これにより、セッションでエディター領域の高さいっぱいを使用できるため、長時間実行されるコマンドの出力を確認する場合や CLI コーディングエージェントを使用する場合に役立ちます。 タブの移動中もセッションは実行され続けるため、コマンド履歴と出力は保持されます。

ターミナル ツールウィンドウを IDE 上にフロート表示するか別のウィンドウに移動するには、 表示モードを変更します。

ターミナルエンジン

現在、PyCharm では次のターミナルエンジンが利用可能です:

  • 再設計版 (デフォルト)。 バージョン 2025.2 以降、PyCharm のデフォルトのターミナルエンジンです。 クラシックエミュレータの安定性と、パフォーマンス、互換性、最新の機能強化を組み合わせるように設計されています。

  • クラシック。 これは、 JediTerm(英語) ライブラリに基づいて構築された、前世代の標準的なターミナルエミュレーターであり、ユーザー入力 (コマンドとキーストローク) は基盤となるシェルに直接送信されます。

実験的 2024 (非推奨) ターミナルエンジン、PyCharm 2024.* では New Terminal とも呼ばれていましたが、互換性の問題により非推奨となりました。 このターミナルエンジンを選択するオプションは、PyCharm 2024.* で有効にしていたユーザーのみ利用可能です。 このエンジンのドキュメントは、 以前のバージョンの PyCharm ヘルプに記載されています。

ターミナルエンジンを選択

  1. ターミナル ツールウィンドウを開きます: 表示 | ツールウィンドウ | ターミナル。

  2. ツールウィンドウのヘッダーで、 オプション をクリックし、ターミナルエンジンを選択します。

    ターミナル選択エンジン

    または、IDE 設定 (Ctrl+Alt+S) を開いて、 ツール | ターミナル | ターミナルエンジン に移動します。

ターミナルを設定

ターミナルエミュレータを設定する

  • Ctrl+Alt+S を押して設定を開き、 ツール | ターミナル を選択します。

  • または、ターミナルツールバーの をクリックし、 設定 を選択します。

詳細については、 ターミナル設定 を参照してください。

実行されたコマンド間の区切りを設定する

コマンドの開始と終了をより明確に区別するために、ターミナルでセパレーターを有効にすることができます。

  1. Ctrl+Alt+S を押して設定を開き、 ツール | ターミナル を選択します。

  2. セパレーターを有効または無効にするには、 実行されたコマンド間にセパレーターを表示する オプションを使用します。

    コマンドセパレータが有効になっています
    コマンドセパレーターは無効です
  3. 変更を保存するには、 適用 をクリックします。

2026 年 10 月 30 日