English
Imidef Blog

Codex/VSCodeのイメージ

最短で「導入→初回セットアップ→安全に使い始める」までを、日本語で丁寧にまとめました。Codex（OpenAIのコーディングエージェント）は、VSCode内でファイルを読み書き・テスト実行・リファクタ・デバッグ支援を行い、必要に応じてクラウド環境にタスクを委譲できます。拡張はChatGPTアカウントでサインインして使うのが基本です。

この記事でわかること

  • VSCode拡張「Codex」のインストールとサインイン手順
  • **モード（Chat / Agent / Agent〔Full Access〕）**の違いと安全な使い分け
  • ローカルで並走する使い方と、クラウドに委譲するワークフローの実例
  • トラブル時の対処（Windowsの注意、WSL推奨など）
  • よくある質問（「GitHubでログイン？」→ChatGPTでサインインが正解 ほか）

1. 前提：Codexとは？

  • OpenAIが提供するコーディング特化エージェント
  • エディタ横での対話に加え、クラウドの隔離サンドボックスにタスクを投げ、PR作成まで支援
  • VSCode拡張でローカルに並走もでき、クラウド委譲との行き来はシームレス
  • ChatGPTアカウントでサインインして使える

2. インストール（VSCode）

  1. VSCodeの拡張ビューを開く（Cmd/Ctrl + Shift + X）
  2. **「Codex – OpenAI’s coding agent」**を検索してインストール
  3. 拡張サイドバーに**「Codex」**パネルが現れる

3. サインインと初期設定

  • CodexパネルからChatGPTアカウントでサインイン（APIキー不要）
  • 作業したいフォルダ（リポジトリ）を開いた状態にしておく

4. モードの選び方（安全第一）

  • Chat
    単なる会話。ファイル編集やコマンド実行なし

  • Agent（既定・推奨）
    作業ディレクトリ内の読み書き・コマンド実行を自動化
    ディレクトリ外やネットワークアクセスは要承認

  • Agent（Full Access）
    ネットワークアクセスや広範な操作も無承認で可能
    → 必要時のみ慎重に利用

5. はじめてのプロンプト（ローカル実行）

例：

  • 「src/配下のTypeScriptの未使用importを削除して、差分をプレビュー」
  • 「Jestが落ちるので失敗テストを修正して。手順と実行ログを示して」
  • 「このコンポーネントをアクセシビリティ改善して」

Codexは差分の提案→実行ログ→テスト結果まで行い、コミットやPRの準備も支援します。

6. クラウドに委譲する

  • Codexパネルから**「Run in the cloud」**を実行
  • ローカル会話の文脈を持ったままクラウドで作業を継続
  • 結果はVSCodeで確認し、必要な変更だけローカルへ反映
  • 隔離サンドボックスで実行、必要に応じてネットワークアクセス有効化も可能

7. CLIも併用すると捗る（上級者向け）

  • インストール

    • npm: npm install -g @openai/codex
    • Homebrew: brew install codex

  • 起動

    • 対話UI: codex
    • 一発実行: codex exec "fix the CI failure"

  • 承認モード

    • Auto / Read Only / Full Access

※ Windowsは実験的サポート。WSL推奨。

8. 実務で役立つプロンプト雛形

  • バグ修正：「tests/が落ちています。失敗しているテストを特定し、最小改修で通してください」
  • リファクタ：「components/Button.tsxをアクセシビリティ準拠にし、差分をプレビュー」
  • 型/リンタ整備：「ESLintとTypeScriptの厳格設定を導入し、既存コードを修正」
  • PR作成：「修正を1コミットにまとめ、PR本文に要約・意図・テスト結果を含めて」

9. 安全運用チェックリスト

  • Agentモードから開始（Full Accessは必要時のみ）
  • 承認プロンプトを必ず確認
  • テストと差分をレビューしてからコミット
  • クラウド委譲は大規模・長時間タスク用に活用

10. トラブルシューティング

  • 拡張が見つからない → 再検索／サイドバー展開
  • サインインできない → ChatGPTアカウントでログイン（GitHub不要）
  • Windowsで不安定 → WSL推奨
  • ネットワークアクセスが必要 → クラウド実行時に設定

11. よくある質問

  • Q. GitHubアカウントでログインしますか？
    A. いいえ、ChatGPTアカウントでサインインします。GitHubはPR作成時に利用。

  • Q. ローカルとクラウド、どちらを使うべき？
    A. 細かな修正はローカル、大規模改修はクラウドへ委譲が快適。

  • Q. Full Accessは常用していい？
    A. いいえ。必要時のみ一時的に利用するのが安全です。

まとめ

  • VSCode拡張＋ChatGPTサインインで簡単に導入可能
  • 日常はAgentモード、大規模作業はクラウド委譲
  • ログ・テスト・差分確認を徹底すれば、Codexは強力な相棒になります

関連記事：
・VSCode × GPT-5「思考モード」の使い分け術

関連記事