AIエージェントで書く・実行する開発フローをVS Codeだけで完結

---

🎯はじめに

GitHub Copilot Chat の次に来る開発体験――
それが Codex for VS Code。

Codex は VS Code に「実行可能なAIエージェント」を組み込み、

• コード生成
• ファイル追加／編集
• 依存関係管理
• 実行・検証
• 自動的な修正ループ

まで IDEだけで完結して実施します。

この記事では、自分が導入して詰まりまくったポイントも含めて
✔設定手順
✔ハマり所と対策
を完全に公開します。

---

🛠環境

項目	内容
OS	Windows 11 + WSL2（Ubuntu）
IDE	Visual Studio Code（最新版）
Codex拡張	OpenAI公式
ChatGPTアカウント	Plus以上（推奨）

※APIキー不要
Sign in with ChatGPT方式が最も安定

---

1️⃣ Codex 拡張のインストール

VS Code 左側メニューの
Extensions → “Codex – OpenAI’s coding agent” を検索

→ Install

インストール後、
右側に Codex パネル（CHAT）が表示されます。

---

2️⃣ ChatGPTアカウントと連携（重要🟥）

Codexパネル内に出てくる：

Sign in with ChatGPT

→ブラウザでログイン
→VS Codeに戻る

🌟これをやらないと
401 Unauthorized が出て動きません。

---

3️⃣ パネル位置を右側へ移動（推奨UI）

Codexタブを タブドラッグ → 右端へ
（本家ドキュメントでも右側推奨）

---

4️⃣ Auto Context を OFFにする（最重要⚠）

Codexはデフォルトだと

• 開いている別プロジェクトのファイルまで勝手に参照
• 書き換える
• 依存関係をクラウド実行

という“過保護すぎる挙動”があります。

👉 Chat入力欄下の

Auto context

→ OFF（グレー表示）

▼OFFの効果
✔勝手に別プロジェクト触らない
✔意図通りのフォルダだけ作業
✔事故防止

🔺ONしたままだと…
突然、ChatBotプロジェクトが破壊されたりします（実体験）

---

5️⃣ モード選択（使い方の肝）

画面下で選びます👇

モード	機能	推奨用途
Chat	返答のみ（安全）	まずはここから
Agent	編集＋提案＋一部実行	普段使い
Agent (Full Access)	コマンド実行も自動	PoCやゼロ構築に最強

最初は Chat → Agentへ
Full Accessはトラスト後でOK

---

6️⃣ Hello World で動作確認

Codexチャットに入力：

「hello world の pythonコード書いて
現フォルダに保存して、実行して」

Codex が自動で

1. hello.py 生成
2. 実行コマンド提案
3. 出力表示

まで完了！

VS Code内にAIの実行ロボを飼う感覚です。

---

⚡Codexの強み

比較	GitHub Copilot Chat	Codex
完全自動編集	△	◎
パッケージ・依存解決	✕	◎
システムコマンド実行	✕	◎
クラウドタスク（長時間処理）	✕	◎
PoC速度	△	🚀

つまり、

作る → 実行 → 失敗 → 修正 →再実行
をすべてAIに任せられる

---

❗注意点と対策

課題	原因	解決策
別フォルダを勝手に触る	Auto context	OFF
長時間クラウド実行	Agentモード設定不当	Chatで十分
エラーで止まらない	Cloudタスク継続	Stop / Reset Session
WSLでキー認識せず	APIキーで未検証	Sign in with ChatGPT方式採用

---

📌自分の運用ベストプラクティス

タスク内容	推奨設定
既存プロジェクト編集	Auto context OFF + Agent
小規模自動構築	Agent (Full Access) + Git管理
危険な操作	Patch確認 + 手で適用

---

🧠まとめ

Codex = AIソフトウェアエンジニア

VS Code に
書いて動かせるAIを住まわせる体験は
間違いなく開発の未来です。

✔ファイル生成
✔依存解決
✔実行検証
✔自動修正
が1チャット内で閉じる世界。