Windsurf から移行
Windsurf は、高度にカスタマイズ可能で最小限のセットアップに基づいて構築されており、ユーザーは特定のワークフローに合わせて環境をセットアップできます。
PyCharm は、すぐに使える環境を提供することで、異なる体験を実現します。 組み込みの開発ツールセット、幅広い言語サポート、高度な AI 機能が最初から利用可能で、追加設定の必要性を最小限に抑えます。
PyCharm の主な機能一覧については、 機能の概要ページをご覧ください。
設定のインポート
PyCharm を初めて起動すると、マシン上で見つかった他の IDE の設定のリストが表示された 設定のインポート ダイアログが表示されます。
設定をインポートするには Windsurf を選択します。
インポートする設定を選択し、 設定のインポート をクリックします。
UI テーマ – テーマ設定をインポートするかどうかを選択します。
キーマップ – キーボードショートカットをインポートする場合は選択します。 すべて表示 をクリックすると、インポートされるショートカットのリストが表示されます。
プラグイン – Windsurf で使用した拡張機能をインポートする場合は選択してください。 これらの拡張機能は、 JetBrains マーケットプレイス(英語)の対応するプラグインに置き換えられます。 すべて表示 をクリックすると、インストールされるプラグインのリストが表示されます。
最近のプロジェクト – Windsurf で作業していたプロジェクトをインポートする場合に選択します。
設定が正常にインポートされたことを確認するメッセージが表示されます。
最初のプロジェクトを開くか作成する
PyCharm で作業を開始すると、プロジェクトを開くか作成するように求められます。 このプロジェクトファーストのアプローチにより、IDE はコンテキストをより適切に理解し、より高度なコーディング支援を提供できるようになります。
Windsurf から プロジェクトをインポートした場合は、すぐに開くことができます。
あるいは、次のいずれかのオプションを選択することもできます。
新しい Notebook: Jupyter ノートブックを作成します。
新規スクリプト: Python ファイルを作成します。
新規プロジェクト: 空のプロジェクトを作成するか、既存のテンプレートからプロジェクトを生成します。
オープン: マシンに保存されているプロジェクトを開きます。
リポジトリのクローン: GitHub などの VCS ホスティングサービス上のリモートリポジトリから既存のプロジェクトを取得します。
プロジェクトを開いたら、通常どおりコーディングを開始できます。
拡張のインストール
JetBrains IDE では、拡張機能を プラグインと呼びます。 拡張機能は Windsurf の拡張機能とほぼ同じように機能し、組み込み機能を拡張して IDE をカスタマイズできます。 使用可能なプラグインを調べるには、 Ctrl+Alt+S を押して設定を開き、 に移動します。 使用可能なプラグインは、 マーケットプレース タブにあります。
UI テーマを変更する
PyCharm にはいくつかのプリセットテーマが用意されていますが、様々なカスタムオプションから選択できます。 カスタマイズするには、 Ctrl+Alt+S を押して設定を開き、 プラグイン を選択します。 マーケットプレース タブで Theme を検索してください。
その後、エディターに戻ってインストールしたテーマの見た目を確認できます。 メインメニューから を選択するか、 Ctrl+` を押して を選択してください。 そこから利用可能なすべてのテーマをプレビューできます。
ショートカットの構成
PyCharm や他の JetBrains IDE を使ったことがない場合、新しいショートカットに慣れるのは難しいかもしれません。 ここでは、その場合に役立つヒントをいくつか紹介します。
キーマップを切り替える
初めて PyCharm を起動した際に キーマップ設定をインポートしなかった場合は、手動で切り替えることができます。
一部のキーマップは IDE にデフォルトでバンドルされていない場合があるため、対応するプラグインが事前にインストールされていることを確認してください。 これを行うには、 に移動し、 マーケットプレース タブを選択して、使用したいキーマップの例として VSCode Keymap を検索します。
インストールしたら、 に移動してリストから VSCode を選択して、このキーマップをデフォルトとして設定します。
PyCharm ショートカットを学ぶ
PyCharm のショートカットを覚えておくと、後で他の JetBrains IDE に移行しても役立ちます。ほとんどの IDE でショートカットは同じです。 これらを早く覚えるために役立つことはこちらです：
%instance% の最も普遍的なショートカットを覚える – ダブル Shift または どこでも検索。 これを使って、任意のファイル、アクション、class、シンボルを検索し、すべての一致結果を一か所で確認できます。
Key Promoter X をインストール – この拡張機能は、作業中に重要なショートカットを学習できます。 IDE 内のボタン上でマウスを使用すると、Key Promoter X は代わりに使用できるショートカットを表示します。
%instance% ショートカットのチートシートを使用する – デフォルトの PyCharm をダウンロードし、カードとして印刷できます。
一般的な Windsurf ワークフローを複製する
Windsurf のように動作するようにいくつかの設定を行う方法を見てみましょう。
AI 機能
PyCharm のワークフローを AI 機能で強化したい場合は、IDE にネイティブ統合されている JetBrains AI をご利用いただけます。 JetBrains AI には、インテリジェントなコーディング支援ツールである AI Assistant と、コーディングタスクを独立して実行できる AI コーディングエージェントである Junie の両方が含まれています。
AI Assistant で AI を活用したコーディングエージェントと AI 機能を PyCharm に直接導入できます。 組み込みエージェントと連携したり、外部エージェントを接続したり、追加のツールで拡張したり、ワークフローに合ったモデルやサービスを選択したりできます。 主な機能は以下のとおりです。
コーディングエージェント – コーディングエージェント （例えば Junie、 Claude Agent、 Codex、 GitHub Copilot ）に複数ステップのタスクを任せます。 エージェントは作業を計画し、ファイルの編集、コマンドやテストの実行、進捗の報告を行います。ユーザーは変更の確認・保持・元に戻すことができます。
ACP を利用した外部エージェント – Agent Client Protocol をサポートするエージェントを、厳選されたレジストリーや独自の構成からカスタムインテグレーションなしで接続できます。
MCP ツール – Model Context Protocol を通じて外部ツールやデータソースでエージェントを拡張したり、IDE を MCP サーバーとして公開したりできます。
柔軟なセットアップ – JetBrains AI サブスクリプションで開始し、サードパーティモデルに 独自のキー を持ち込んだり、プロバイダーアカウントで エージェントを認証したり、 ローカルモデルを実行したりできます。 既存の AI サブスクリプションを再利用できます。
コンテキスト認識型 AI チャット – 対応モデルとチャットしてプロジェクトについて質問できます。 ファイル、フォルダー、シンボル、コミットをコンテキストとして追加し、エージェントモードに切り替えてコードベース全体に変更を適用できます。
エディター内コード支援 – コーディングスタイルや命名規則に従って、単一行やコードブロック全体を自動補完します。 次の編集候補が提案され、必要に応じて次の変更箇所へ移動できます。
そして、 その他にもたくさんあります。
Junie は、単独でタスクを実行することも、開発者と連携して作業することもできます。 定型的なタスクは Junie に完全に任せることができ、またより複雑な作業にも役立ちます：
プロジェクトのコンテキストと構造を使用してタスクを実行します。
コードを分析および検索して関連情報を検索します。
IDE インスペクションを使用してコードを編集し、チェックします。
コードとテストを実行して警告とエラーを減らします。
変更後のプロジェクトの状態とテスト結果を確認します。
変更のレビューとガイダンスにより、複雑なタスクでのコラボレーションをサポートします。
その他 多数。
AI 機能は、無料プランを含む新しいサブスクリプションモデルでご利用いただけます。 無料プランでは、コード補完が無制限に利用可能で、ローカルモデルへのアクセスとクラウドベースの機能が制限されています。 さらに機能を追加するには、AI Pro または AI Ultimate プランにアップグレードしてください。
AI Assistant を有効にする
有効な JetBrains アカウント(英語)を使用してログインしていることを確認してください。
AI Assistant ヘルプに記載の手順でライセンスを有効化してください。
PyCharm では GitHub Copilot、Tabnine、その他の AI ツールも使用できます。 マーケットプレース タブで該当するプラグインを 設定 | プラグイン から検索してください。 これらのプラグインは JetBrains によってメンテナンスされていません。
コマンドパレットの使用
どこでも検索は Windsurf の コマンドパレットの代替です。 ファイル、アクション、クラス、シンボルの検索に使用できます。 一致したすべての結果が 1 か所に表示されます。
どこでも検索 ダイアログを開くには、 Shift を 2 回押します。
検索および置換
PyCharm の検索と置換のワークフローは Windsurf のものと少し異なりますが、原則は同じです。 PyCharm を使うと、 特定のファイルと プロジェクト全体の両方で文字列の検索や置換が可能です。
まず、メインメニューで に移動します。 現在のファイル内を検索するには を選択し、プロジェクト全体を検索するには を選択します。 テキスト置換の場合は、同じサブメニューから または を選択します。
実行コード
Windsurf では、ガターからテストを実行できますが、通常のコードは実行できません。 一方、PyCharm ではコード、テスト、その他の構成をガターから直接実行できます。
PyCharm では、 コードを実行するさまざまな方法を提供しています。 内部的には、それらはすべて 実行 / デバッグ構成に依存しています。 カスタム実行 / デバッグ構成を作成することで、最大限の自由度と柔軟性が得られます。 詳しくは 実行 / デバッグ構成 をご覧ください。
プロジェクトビューのデフォルトを変更する
PyCharm には独自の エクスプローラー、 プロジェクト ツールウィンドウがあり、動作がやや異なります。 たとえば、ファイルをエディターで開くには、ファイルをダブルクリックする必要があります。 Windsurf で慣れていた設定に合わせてデフォルトの設定を変更する方法は次のとおりです。
プロジェクト ツールウィンドウの設定に移動し、 振る舞い をクリックして、次のオプションのいずれかまたはすべてを選択できます。
プレビュータブの有効化: エディターの プロジェクト ビューで選択したファイルをプレビューします。
シングルクリックでファイルを開く: ワンクリックでエディターでファイルを開きます。
開いているファイルを常に選択: プロジェクト ビューで現在開いているファイルを自動選択します。
サポートを受ける方法
よくある質問の回答を確認したり、他の PyCharm ユーザーに相談もできます。
また、行き詰まった場合は、いつでもサポートチームに連絡できます。 新しいチケットを送信するには、PyCharm のメインメニューから を選択してください。 バグを報告したり新機能を要求したりする場合は、 こちらで新しい課題を作成してください。