メインコンテンツへスキップ
見出し画像

【2025年決定版】Windowsで始めるAI開発環境|WSL2, VSCode, Codex, GitHub全部入り完全ガイド #生成AI #バイブコーディング


    はじめに:あなたのWindows PCが、最高のAI開発マシンに変わる

    みなさん、こんにちは。現役IT執行役員のグイグイです。⚡

    え~、遅ればせながら、私もやっと手を出します。。
    バイブコーディング。
    他にもやることがいろいろあって後回しにしてきましたが、とりあえず今の私がぱっと手を出せるところからやっていこうかなと思います。

    そんなわけで今回は、非常に優秀だと噂のOpenAIの「GPT-5-Codex」を使ったバイブコーディング開発環境を構築していきたいと思います。
    この記事がこれからバイブコーディングを始めたいというかたの参考になればと思います。


    画像
    GPT-5-Codex 評判が良い!

    「Windowsを使っているけど、本格的な開発環境をどう作ればいいかわからない…」 「AIがコードを書いてくれる『バイブコーディング』って面白そうだけど、始め方が難しそう…」

    もしあなたが今、そう感じているなら、この記事はまさにあなたのためにあります。(あと僕のための記事です)

    この記事では、お使いのWindows 11 PCを、現代のプロフェッショナルな開発現場で求められるAI開発環境へと進化させるための全手順を、どこよりも詳しく、そして丁寧に解説します。(そうなるといいな。。)

    WSL2でLinux環境を手に入れ、VSCodeで快適にコーディングし、OpenAI CodexにAIアシスタントを任せ、GitHubでコードを管理する。この最強の布陣を、ゼロからあなたの手で構築していきましょう。

    この長い記事を読み終える頃には、あなたのPCは未来の開発を始めるための最高のパートナーになっているはずです。さあ、一緒に新しい開発の世界へ旅立ちましょう!


    画像

    このガイドで構築する「最強の布陣」

    この記事を通じて、以下のコンポーネントを組み合わせた、まさにプロフェッショナルな開発環境を構築します。

    • OS: Windows 11

    • 開発環境: WSL2 (Ubuntu) - Windows上で動作する完全なLinux環境。

    • コードエディタ: Visual Studio Code (VSCode) - 高機能かつ拡張性に優れたエディタ。

    • AIアシスタント: OpenAI Codex (公式拡張機能) - OpenAIが直接提供する、最新モデルを搭載したコーディングAI。

    • ソースコード管理: Git & GitHub - コマンドラインとGUI(GitHub Desktop)の両方に対応。


    準備するもの:冒険の前の持ち物チェック

    本格的な設定に入る前に、以下の条件が満たされているか確認してください。これらが揃っていれば、スムーズに設定を進められます。

    • Windows 11 がインストールされているPC

    • PCの管理者権限

    • OpenAIアカウント (ChatGPT Plus以上のプランで契約済みであること)

    ※重要: OpenAI Codex拡張機能の利用が、ChatGPT Plusの月額料金に含まれるか、別途APIクレジットを消費するかは、利用時点でのOpenAI公式サイトにて必ずご確認ください。

    Windows 11には標準搭載されています。タブ機能などでPowerShellやWSL(Ubuntu)を快適に管理できるため、このガイドでも利用を前提に進めます。


    画像

    そもそも、なぜ「WSL2」を使うのか?

    設定を始める前に、このガイドの根幹である「WSL2」をなぜ使うのか、その圧倒的なメリットを完璧に解説します。

    結論から言えば、WSL2は「Windowsの快適さ」と「Linuxの強力な開発エコシステム」を、妥協なく両立させるための最善のソリューションだからです。

    ①圧倒的なパフォーマンスと互換性 🚀
    WSL2は、軽量な仮想マシン上で「本物のLinuxカーネル」を直接動かします。これにより、以下のメリットが生まれます。

    • 完全な互換性: Dockerをはじめ、Linuxで動くツールやソフトウェアはすべて問題なく動作します。「これは動かないかも…」という心配はもう不要です。

    • ネイティブに近いパフォーマンス: 特にファイルの読み書きが驚くほど高速です。Git操作、パッケージのインストール、ビルドなどがストレスなく完了します。

    例えるなら… 従来の仮想マシンは「外国語の映画を、同時通訳を介して観る」ようなものでした。WSL2は「映画の舞台である国に直接行き、ネイティブ環境で観る」ようなものです。遅延も誤訳もなく、すべてが完璧に機能します。

    ② Windowsとのシームレスな統合 🤝
    WSL2は高性能なだけでなく、Windowsとの連携が驚くほどスムーズです。

    • VSCodeとの完璧な連携: Windows側のVSCodeから、WSL2内のLinuxファイルを遅延なく直接編集・デバッグできます。

    • エクスプローラーからのアクセス: エクスプローラーのアドレスバーに \\wsl$ と入力するだけで、Linux側のファイルに直接アクセスできます。

    ③ バイブコーディングと相性抜群!面倒な「実行許可」が不要に
    AIがコードを自動修正する際、Windows環境(PowerShellなど)では、セキュリティ機能により何度も実行許可を求めるプロンプトが表示され、作業の流れが寸断されてしまいます。

    WSL2内のLinux環境では、このWindows特有の実行ポリシーが適用されません。ファイルの実行はLinuxの権限で管理されるため、確認プロンプトは一切発生せず、AIによるスムーズなコード修正やテスト実行が可能になります。これは、高速なイテレーションが求められるバイブコーディングにおいて計り知れないメリットです。


    画像

    Step 1: WindowsにLinuxを住まわせる (WSL2セットアップ) 🐧

    すべての土台となる、Windows Subsystem for Linux 2 (WSL2) をインストールします。これにより、Windowsの使いやすさを維持したまま、Linuxの強力な開発ツールが使えるようになります。

    ① Windows Terminalを管理者として開く
    スタートボタンを右クリックし、「ターミナル (管理者)」を選択します。

    ② 魔法の呪文を唱える
    開いたターミナルに、以下のコマンドを一行入力してEnterキーを押します。これだけで必要なコンポーネントがすべてインストールされます。

    wsl --install

    ③ PCを再起動
    インストールが完了したら、指示に従ってPCを再起動します。

    ④ Ubuntuの初期設定とアップデート
    再起動後、自動でUbuntuのターミナルが起動します。ここで、新しいLinux環境の初期設定を行います。
    自動で起動しない場合は検索バーで「Ubuntu」を探しましょう。

    • まず、Linux環境で使うユーザー名とパスワードを設定します。(パスワード入力中は画面に何も表示されませんが、ちゃんと入力されていますのでご安心を!)

    • 続けて、以下のコマンドでインストールしたUbuntuを最新の状態に更新しておきましょう。これは新しい環境を作った際の「お作法」です。

    sudo apt update && sudo apt upgrade

    Step 2: 開発言語をインストールする 🛠️

    次に、WSL(Ubuntu)環境に、あなたが使いたいプログラミング言語をインストールします。ここでは代表例としてPythonとNode.jsを挙げます。

    ① Pythonをインストールする場合

    AI開発やデータサイエンスで人気のPythonをインストールします。

    sudo apt install python3 python3-pip python3-venv

    ② Node.jsをインストールする場合 (推奨: nvm経由)

    Web開発で広く使われるNode.jsは、バージョン管理ツールnvm経由でインストールするのがベストプラクティスです。これにより、プロジェクトごとに異なるバージョンを簡単に切り替えられます。

    # nvm(Node Version Manager)をインストール 
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash 
    
    # ターミナルを一度閉じて再度開くか、以下のコマンドでnvmを有効化 
    source ~/.bashrc 
    
    # 最新のLTS(長期サポート)版Node.jsをインストール 
    nvm install --lts

    画像

    Step 3: VSCodeとプロジェクトの初期設定 ✨

    いよいよ、メインで使うコードエディタVSCodeとWSLを接続し、プロジェクトの雛形を作ります。

    ① VSCodeとWSL拡張機能のインストール
    VSCode公式サイトからVSCodeをインストールします。インストール後、VSCodeを起動し、左側の拡張機能アイコン(四角が並んだマーク)をクリックしてマーケットプレイスで WSL を検索し、Microsoft提供のものをインストールします。

    画像
    拡張機能のWSLをインストール

    ② プロジェクトフォルダの作成とWSLへの接続
    UbuntuのWindows Terminalを開き、以下を実行します。

    画像
    # ホームディレクトリにプロジェクト用のフォルダを作成
    mkdir ~/my-project
    
    # 作成したフォルダに移動
    cd ~/my-project
    
    # VSCodeでこのフォルダを開く!
    code . 

    このcode .コマンドが魔法の連携呪文です。VSCodeが起動し、ウィンドウ左下に緑色で「WSL: Ubuntu」と表示されれば成功です。これで、Windows上のVSCodeから、Linux内のファイルを直接編集できる状態になりました。

    画像

    ③ 【Python開発者向け】仮想環境の作成と有効化

    Pythonプロジェクトの場合、この時点でプロジェクトごとに独立した環境(仮想環境)を用意するのが鉄則です。これにより、プロジェクト間のライブラリの衝突を防ぎ、環境の再現性を高めます。

    VSCode内のターミナル(Ctrl + @で開けます。自動的にWSLのターミナルになっています)で以下を実行します。

    # 'venv'という名前の仮想環境を作成
    python3 -m venv venv
    
    # 仮想環境を有効化
    source venv/bin/activate

    ターミナルの入力欄の先頭に (venv) と表示されれば成功です。これ以降、このターミナルでインストールするライブラリは、このプロジェクト専用の環境に保存されます。


    Step 4: AIアシスタント「OpenAI Codex」を相棒にする 🚀

    コーディングの効率を劇的に向上させるAI、OpenAI CodexをVSCodeに導入します。

    ① VSCodeの拡張機能マーケットプレイスで Codex を検索し、公開元(Publisher)がOpenAIとなっている公式拡張機能をインストールします。

    画像
    OpenAIのCodexを選びましょう

    ② インストール後、左側のアクティビティバーに表示されるOpenAIロゴをクリックし、画面の指示に従ってあなたのChatGPTアカウントでサインインします。

    画像

    Step 5: 実践!AIとの対話型開発「バイブコーディング」入門 💻

    準備は整いました。Codexの強力な機能を少しだけ体験してみましょう。これが未来のコーディングスタイルです。

    • チャットでコード生成:
      main.pyなどのファイルを開き、Codexのチャットパネルに「FastAPIを使って、簡単なAPIをこのファイルに書いて」のように、日本語で依頼してみてください。AIが文脈を理解し、適切なコードを提案してくれます。

    • エージェントモードで修正:
      「@workspace このプロジェクトに○○機能を追加して」のように依頼すると、AIがプロジェクト全体を理解して、複数のファイルを横断した修正案を提示してくれます。大規模なリファクタリングや機能追加もお任せです。

    • 画像からコード生成:
      UIデザインのスクリーンショットをチャットに貼り付けて、「このUIをHTMLで再現して」と依頼すれば、画像を解析してコードを生成するという離れ業も可能です。デザインカンプからのコーディングが驚くほど速くなります。

    画像
    左のCodexタブでAIに指示をしてコーディング
    画像
    差分チェックしながらコーディングできます

    少しバイブコーディングしてみた感想として、うまくコーディングするステップとしては、以下の感じかな?と思います。

    ① ざっくり仕様でコーディング指示(細かい仕様で指示しても当然OK)
    ② テストしてみる
    ③ OKならGitコミット
    ④ 追加の指示(機能追加、バグ修正 など)

    指示によってはAIが大幅にソース修正することもあるので、なるべく小さく修正を重ねながら、Gitで履歴管理していくのが安全かなと思います。
    僕も研究中です。


    Step 6: あなたのコードを資産にする (Git & GitHub管理) 📂

    最後に、書いたコードをきちんと管理し、世界に公開もできるようにするためのバージョン管理ツールGitとGitHubを設定します。

    ① Gitの初期設定
    VSCode内のターミナルで、まずGitをインストールし、あなたの情報を登録します。

    sudo apt install git
    git config --global user.name "あなたのGitHubユーザー名"
    git config --global user.email "あなたのGitHubメールアドレス"

    ② プロジェクトのお作法:.gitignoreファイルの作成

    バージョン管理に含めたくないファイル(自動生成ファイル、個人情報、環境ごとの設定など)を指定する.gitignoreファイルを作成するのは、プロジェクト開始時の重要なお作法です。これにより、リポジトリをクリーンに保ちます。

    VSCodeで .gitignore という名前のファイルを新規作成し、内容を記述します。
    (例: Pythonプロジェクトの場合)

    # Python
    __pycache__/
    *.pyc
    venv/
    
    # OS generated files
    .DS_Store

    ③ GitHubへ最初のコードをアップロード
    GitHubサイトでリポジトリを新規作成した後、ターミナルで以下のコマンドを順番に実行し、ローカルのコードを紐づけてアップロードします。

    git init
    git add .
    git commit -m "first commit"
    git branch -M main
    git remote add origin https://github.com/<ユーザー名>/<リポジトリ名>.git
    git push -u origin main

    認証について: git pushの際、認証を求められます。現在GitHubではパスワード認証が廃止されているため、Personal Access Token (PAT) を発行し、パスワードの代わりに入力してください。

    ④ 【Tips】GUIで快適にGitを操作したい方へ (GitHub Desktop)

    コマンドライン操作(黒い画面)が苦手な方や、変更内容を視覚的に確認しながらコミットしたい方には、GitHub公式の無料アプリ「GitHub Desktop」もおすすめです。

    GitHub Desktop公式サイトからインストーラーをダウンロードし、Windows側にインストールします。WSL2内のプロジェクトフォルダも問題なく認識し、コミットやプッシュといった操作をマウスで直感的に行えるようになります。


    次のステップ: VSCodeをさらに強化する「三種の神器」

    これで開発環境は完成しましたが、最後に、あなたの開発体験をさらに向上させるための、ほぼ必須と言えるVSCode拡張機能を紹介します。これらを入れることで、あなたのVSCodeがさらに強力なツールになります。

    • 言語サポート:
      開発言語に合わせた公式拡張機能(例: Python, ESLint)を入れましょう。デバッグや高度なコード補完(IntelliSense)が強力になり、エラーを未然に防ぎます。

    • コードフォーマッター:
      Prettier - Code formatter (Web系全般) や Black Formatter (Python) を入れると、ファイルを保存するたびに、誰が書いても同じ綺麗なスタイルにコードが自動で整います。コードの可読性が格段に向上し、チーム開発での無用な議論を減らします。

    • Git連携強化:
      GitLens を入れると、誰がいつどのコード行を変更したかがエディタ上で一目瞭然になります。コードの意図を理解したり、バグの原因を特定したりする際に絶大な効果を発揮します。

    画像
    GitLensで変更履歴も一目瞭然

    おわりに:新しい冒険の始まり

    本当にお疲れ様でした!🥇

    もしあなたがこの長いガイドのすべてのステップをやり遂げたなら、あなたのWindowsマシンは今、AIと共に未来を創造するための、プロフェッショナルな開発基地へと生まれ変わりました。

    WSL2という強固な土台の上に、VSCodeという高機能なエディタを構え、OpenAI Codexという賢いAIアシスタントを相棒にし、GitHubという確かな資産管理システムを備えました。

    これはゴールではなく、新しい冒険の始まりです。 ぜひ、この最高の環境で、あなたのアイデアを形にしてみてください。素晴らしい開発体験が、あなたを待っています!

    この記事が、あなたの開発者としての一歩を力強く後押しできれば幸いです。


    この記事の音声解説🎙はこちら👇


    あとがきとお願い 💡

    この記事が「ためになった!」と感じたら、♥️スキ・👍フォローで応援いただけると励みになります。
    さらに深く学びたい方は、有料noteやメンバーシップで実践ノウハウを公開中です。

    あわせて他の記事もぜひチェックしてみてください。


    「気になる方はプロフィールや過去記事もぜひどうぞ。」
    私のプロフィールはこちら
    👇

    私のサイトマップはこちら👇

    おすすめ記事はこちら👇
    生成AI時代のスタート地点に立ちたい方に非常におススメです。



     
     
     
    現場でAIを使い倒す実務家|17年の開発経験と執行役員の視点で、生成AI×ビジネスの“本当に使える知見”をnoteで発信中!📘 実務×思考のリアルをお見せします。 各種リンクはこちら(https://lit.link/guigui31279) 最近はAI漫画に注力してます♪

    あなたへのおすすめ