Codex with VS CodeでGPT-6 Astraを使う設定確認の実践ポイント

Codex with VS Codeを今確認する理由

Codex with VS Codeという言葉は、ひとつの固定された拡張機能だけを指すとは限りません。VS CodeのChat viewやAgents windowからCodexの提供元を選んで作業する場合もあれば、統合ターミナルでCodex CLIを起動し、エディターで差分を見る場合もあります。どちらも「コードを書いている場所」と「エージェントが判断して操作する場所」を近づけられますが、モデル一覧、確認画面、セッションの再開方法は同一とは限りません。最初に入口を区別しておくと、Astraが表示されない問題を、VS Codeの問題、Codexの版の問題、提供条件の問題に分けられます。

直近では、OpenAI Codexの公式リリース一覧に0.153.4がLatestとして表示されています。リリース本文は、Astraのモデル選択画面での表示、明示的な設定がない場合の既定値、ツールの利用可能性に応じた非同期質問の扱いを修正点として挙げています。これは、GPT-6 Astraの能力を一方的に宣伝する更新というより、選択画面と確認の前提を整える更新です。VS CodeからCodexを使う人も、まず表示される版とモデル名を確認し、次に実際の小さな作業で結果を見るのが適切です。

0.153.4で変わった表示を読み分ける

0.153.4の公式説明で確実に言えるのは、Astraが同梱モデルの選択画面で見えるようになり、明示的なモデル設定がない場合の既定値になったことです。ここから「すべてのアカウントで直ちに選べる」「VS CodeのCopilot画面にも必ず同じ名前で出る」と広げて解釈しないようにします。Codex CLIやCodexの専用画面での表示と、VS Codeが提供元を切り替える画面は別の層です。公式リリースは0.153.4の変更点を確認する起点にし、手元の画面は自分の版と契約条件を含む実測結果として扱います。

VS CodeのCodex対応を入口として捉える

VS Code公式のエージェント概要では、組み込みの経路だけでなく、Copilot、Claude、Codexなど提供元ごとの経路を選べると説明されています。Chat viewはコードの横で作業し、Agents windowは複数の作業場所を見渡すための画面です。Codexを選択できる環境なら、エディターから依頼、変更確認、追加指示を続けやすくなります。選択肢が見えない環境では、統合ターミナルからCodex CLIを使う方法を検討できます。大切なのは、同じ「VS Codeで使う」という言葉でも、モデルを提供する場所と画面を提供する場所が分かれる場合があると理解することです。出典: VS Code公式のエージェント概要。

先に整理したいCodex・VS Code・Astraの違い

初めて組み合わせると、Codex、VS Code、GPT-6 Astra、GitHub Copilotがすべて同じものに見えやすくなります。実際には、エディター、作業を進めるエージェント、判断を行うモデル、契約や提供経路がそれぞれ別です。ここを分けると、モデルの名前を変えたいのか、ファイルを開きたいのか、確認の段階を増やしたいのかが明確になります。設定を触る前に、何を変えたいのかを一文で書いておくと、原因の切り分けも速くなります。

Codexは開発作業を進める入口

Codexは、コードを読んで、変更案を作り、必要に応じてファイルを編集し、結果を確認するためのAIコーディングエージェントです。VS Codeを使う場合でも、作業の中心はエディターそのものではなく、どのファイルを対象にし、どの確認を人が行うかという依頼の設計にあります。たとえば「ログイン画面を直して」だけでは範囲が広く、対象ファイル、再現条件、期待する表示、実行してよい検査を添えると確認しやすくなります。Codexの公式CLI案内は、導入や基本操作の確認に使えます。出典: OpenAI公式のCodex CLIドキュメント。

VS Codeはコードを読む場所と確認する場所

VS Codeは、ファイル、検索、差分、ターミナル、検査結果を一つの画面で確認できる開発環境です。エージェントが変更を提案しても、採用するかどうかはエディター上の差分と検査結果を見て決めます。Chat viewでは会話と変更の確認を近くに置けるため、修正の意図と実際の差分を照らし合わせやすくなります。既存の作業場所をいきなり広く開くのではなく、まず関係するプロジェクトを一つだけ開き、読み取りの依頼から始めると、不要な変更を減らせます。

GPT-6 Astraはモデルであり、Codexとは別の層

GPT-6 Astraは、Codexが作業の判断に使うモデルのひとつです。モデルを新しくしても、対象ファイルの指定、依頼の明確さ、確認の手順が自動的に整うわけではありません。OpenAIは2026年9月3日の安全性概要で、Astraを広く提供するモデルとして紹介し、Codexのタスクを含む評価結果も説明しています。ただし、評価結果は特定の条件における結果であり、個々のプロジェクトの正しさを保証するものではありません。出典: OpenAI公式「Safety overview: GPT-6 Astra」。

Copilotの画面に出るモデルと混同しない

VS CodeのChat viewにはGitHub Copilotの機能やモデル選択もあります。そこでGPT-6 Astraが見える場合、それはCopilot側の提供条件とモデル一覧を示している可能性があります。一方、Codex 0.153.4のリリースが説明しているのはCodex側の同梱モデル選択です。画面に出た名前だけで同じ経路だと判断せず、上部の提供元、選択中のエージェント、利用中のモデル、アカウント表示を順に確認してください。VS Code公式のChatの概要でも、チャットの入口、エージェントの選択、モデルの選択は別々の操作として説明されています。

Codex with VS Codeを始める前の準備

準備で大事なのは、最新版らしい数字を追うことではなく、実際に起動する経路を確定することです。Windowsでは同じ名前の実行ファイルが複数の場所に残っていることがあり、画面で更新したつもりでも、統合ターミナルでは古い版が動くことがあります。VS Codeの版、Codexの版、開いているフォルダー、選んだモデルを別々に記録しておけば、表示や結果に差が出たときも確認しやすくなります。環境差を先に見つけるための準備です。

Step 1: VS CodeとCodexの版を別々に確認する

まずVS Codeの「ヘルプ」から版を確認し、統合ターミナルでCodexの版を調べます。Windows PowerShellなら次のように実行できます。

code --version
codex --version
Get-Command codex

Get-Command codexで表示された場所と、codex --versionの結果を一緒に残してください。複数の端末やターミナルを使う場合は、同じ確認をそれぞれで行います。Codex 0.153.4の表示を確かめたいのに、実際には0.152系が起動しているというずれを最初に消せます。VS Codeの更新とCodexの更新は別なので、片方だけ新しくなっていても問題ありません。

Step 2: 対象プロジェクトを一つだけ開く

VS Codeで対象のプロジェクトフォルダーを開き、最初の依頼では関係する範囲を一つに絞ります。大きな親フォルダーを開くと、エージェントが参照するファイルの範囲が広がり、似た名前の設定やテストを取り違えやすくなります。既存の変更がある場合は、先に差分を見て、自分が加えた内容とこれから確認する内容を分けます。初回は読み取り、検索、テストの確認から始め、編集が必要になった時点で変更対象を明記すると安全です。

Step 3: Codexを選ぶ入口を決める

VS CodeのChat viewやAgents windowにCodexの選択肢がある場合は、提供元の表示を確認してから選びます。選択肢がない場合は、統合ターミナルでCodex CLIを起動し、VS Codeのエディターでファイルと差分を確認する方法があります。どちらを使うかを途中で変えると、セッションの履歴、確認画面、モデル一覧が変わることがあります。まず一つの経路で短い作業を完了させ、次に別の経路を比較してください。画面の名前だけでなく、どこでモデルを選び、どこで変更を承認するのかを確認するのがポイントです。

VS Code内で依頼を出す基本手順

エージェントに渡す依頼は、短ければよいとは限りません。目的、対象、制約、確認方法を一度に詰め込みすぎると、どこまで終わったのか判断しにくくなります。最初は調査を依頼し、結果を読んでから変更を依頼し、最後に検査を依頼する順番が扱いやすいです。VS Code公式も、ファイルやフォルダー、シンボル、ターミナル出力などを文脈として追加できると説明しています。出典: VS Code公式「Add context to chat」。

Step 4: 依頼の目的と対象ファイルを書く

最初の文で、何を変えたいかと、変更してよい範囲を示します。たとえば次のような依頼です。

src/cart にある合計金額の表示を調査してください。
まず関連するファイルと現在の計算経路だけを説明し、編集はまだ行わないでください。
税込み表示が二重になる再現条件と、確認に使うテストも挙げてください。

この依頼では、調査と編集を分けています。ファイル名が分かっている場合は具体的に示し、分からない場合はフォルダーや機能名から探索範囲を限定します。Astraを選んだとしても、対象範囲を広げる理由にはなりません。判断が難しい作業ほど、まず現状の説明を受けてから次の依頼へ進めると、変更の根拠を追いやすくなります。

Step 5: 必要な文脈だけを追加する

関連するファイル、エラーの再現方法、期待する画面、使用する検査コマンドを追加します。プロジェクト全体を一度に渡すより、最初の依頼では入口となるファイルと呼び出し先を示し、足りない場合に追加するほうが、回答の焦点を保ちやすくなります。VS Codeではファイルやフォルダーを文脈として指定できますが、追加したことだけで内容が正しいとは限りません。エージェントが参照したファイル名を応答から確認し、関係のない場所を見ていないかを確かめます。

Step 6: 差分を読んでから次の依頼を出す

編集が行われたら、まず差分を読みます。変更されたファイル、追加された条件、削除された処理、コメントの意図を順番に確認し、依頼した範囲を超えていないかを見ます。差分が大きいときは、いったん要約を求め、ファイルごとに確認します。変更の説明と実際の差分が一致しない場合は、その差を指摘して修正を止めます。VS CodeのChat viewはエージェントの返答と変更を近くで見られるため、会話の印象ではなくコードそのものを基準に判断してください。

Step 7: テストと画面の結果を分けて確認する

検査が通ったことは、仕様を満たしたことと同じではありません。まず既存テストを実行し、次に今回の再現条件を手動で確かめます。表示を直した作業なら、正常な入力、空の入力、境界値をそれぞれ見ます。エージェントが検査を実行した場合でも、実行したコマンド、対象フォルダー、終了結果を確認します。テストの成功、画面の結果、変更の意図を別々に記録すると、後から問題が出たときにどの段階で差が出たかを追えます。

GPT-6 Astraを選ぶときの確認手順

GPT-6 Astraを使う目的は、モデル名を新しくすることではなく、難しい作業を適切な確認付きで進めることです。長い依頼、複数ファイルの関係、原因調査、変更後の検査など、判断の段階が多い仕事では比較する価値があります。一方、単純な文字修正や定型的な整形では、短い依頼と小さな差分のほうが結果を評価しやすい場合があります。作業の難しさと確認のしやすさを先に見て、Astraを使うか決めてください。焦らず記録して比べます。

Step 8: モデル選択画面で表示と版を確認する

Codexのモデル選択画面でGPT-6 Astraが表示されるかを確認します。表示されない場合は、まずcodex --versionが0.153.4か、Codexを起動した経路が意図したものか、画面に示された提供元が何かを見ます。モデル名が見えても、選択した後に別の既定値へ戻っていないかを確認します。画面の表示だけでなく、セッション開始時に示されたモデル名を記録し、後から結果と照合します。Astraの表示に関する根拠は公式リリース本文に限定し、手元の表示を別の事実として扱います。

Step 9: 小さな作業で判断の違いを比べる

いきなり重要な機能の大改修で比較せず、読み取り、テストの追加、限定された関数の修正など、結果を確認しやすい課題を選びます。同じ依頼、同じファイル、同じ検査条件でモデルだけを変えると、差を見やすくなります。比較する項目は、最初の理解が合っているか、変更範囲が守られたか、検査の提案が妥当か、説明が差分と一致するかです。速度だけを基準にすると、確認に必要な時間や修正の手戻りを見落とします。

Step 10: 非同期の確認質問が出る条件を理解する

0.153.4では、Astraの案内が、利用できるツールがあるセッションでだけ非同期の確認質問を使うよう調整されています。これは質問が必ず表示されるという意味でも、表示されないと機能が壊れたという意味でもありません。依頼の種類、選んだ入口、利用できるツール、アカウントの条件によって画面は変わります。確認質問が出たら、対象、目的、実行範囲を読んでから答えます。出ない場合は、同じ作業を短く再現し、モデル名と版を記録してから判断してください。

Step 11: 提供条件と利用枠を別に確認する

GPT-6 Astraの提供は、モデルの公開と同じ日に全利用者へ同じ形で反映されるとは限りません。OpenAI Help Centerでも、Plus、Pro、Business、Enterpriseへの段階的な提供が案内されています。VS Codeの画面に出ない場合は、版の問題だけでなく、アカウント、契約、地域、選んだ提供経路を確認します。利用枠の表示があっても、長い作業を無制限に続けられるという意味ではありません。現在の条件はOpenAI Help CenterのCodexに関する案内を確認し、記事や古い画面の記憶だけで決めないでください。

うまく使えないときの切り分け

Codex with VS Codeがうまく動かないときは、最初から設定を増やすより、どの層で止まっているかを確認します。起動できない、モデルが選べない、依頼は送れるが変更が違う、変更後の検査が失敗する、という症状は原因が異なります。画面のスクリーンショットだけでなく、VS Codeの版、Codexの版、選んだ入口、モデル名、対象フォルダー、エラーの全文を一つの記録にまとめると、再現条件が見えます。記録があるほど、同じ問題を再現できます。

Step 12: モデル一覧にGPT-6 Astraがない場合

まずCodexの版を確認し、0.153.4より前なら公式の更新案内に従って更新します。0.153.4でも見えない場合は、Codexのモデル選択画面なのか、VS Code内の別の提供元の画面なのかを確認します。次に、明示的なモデル設定が残っていないか、選択中の経路がAstraを提供する条件に合っているかを調べます。表示されない状態で設定ファイルを何度も書き換えると、元の状態が分からなくなります。変更前の版と画面を記録し、ひとつずつ条件を変えてください。

Step 13: VS CodeにCodexの選択肢がない場合

VS Codeの版と、利用しているエージェント機能の提供範囲を確認します。公式のエージェント概要では、Codexを含む提供元ごとの経路が案内されていますが、すべての環境で同じ選択肢が同じ位置に表示されるとは限りません。まずChat viewとAgents windowの両方で提供元を確認し、必要なら統合ターミナルでCodex CLIを起動します。CLIで起動できるなら、VS Codeとの接続だけに問題がある可能性があります。CLIでも起動できないなら、Codexの導入、サインイン、版、実行ファイルの場所を順に調べます。

Step 14: 変更が依頼と違う場合

最初にモデルを変えるのではなく、差分と依頼を並べて読みます。対象ファイルの指定が足りなかった、既存の仕様を説明していなかった、修正と検査を一つの依頼にまとめた、といった入力側の要因が見つかることがあります。差分の一部だけを示し、「この行を変えた理由と、依頼した条件との関係を説明してください」と聞くと、確認すべき点が絞れます。修正を続ける前に、不要な変更を戻し、再現条件を一つにしてから改めて依頼します。

Step 15: 検査が通らない場合

エージェントが実行した検査の場所と、手元で実行した検査の場所が同じか確認します。VS Codeで開いているフォルダーとターミナルの現在位置が違うと、別の設定や別の依存関係を参照することがあります。エラーの最初の原因を一つ選び、関連ファイルと再現コマンドを限定して依頼します。複数のエラーを一度に直そうとすると、変更の因果関係が見えにくくなります。検査結果が通った後も、差分を読み、必要な画面操作を確かめるところまでを完了とします。

Step 16: セッションを再開できない場合

VS Codeのエージェントセッションと、統合ターミナルで起動したCodexの会話は、同じ作業場所を見ていても履歴の持ち方が異なる場合があります。再開できないときは、元の依頼、変更されたファイル、検査結果、残っている課題を短くまとめ、新しいセッションへ渡します。VS Code公式は、Codexを含む別の経路で作成されたセッションを検出できる場合があると説明していますが、版や設定によって表示は変わります。履歴が見えないことと、ファイル変更が失われたことを混同せず、まずディスク上の差分を確認してください。出典: VS Code公式「Build with agents in VS Code」。

Codex with VS Codeで確認しやすい依頼の書き方

モデルの性能を引き出そうとして、依頼を抽象的に大きくする必要はありません。むしろ、作業場所、目的、変更してよい範囲、完了の条件を明記すると、Astraを含むどのモデルでも結果を比べやすくなります。特にVS Codeでは、エディターに開いているファイルがそのまま作業対象だと考えず、対象を依頼文で明示することが重要です。画面に見えている範囲と、エージェントが参照できる範囲が一致しない場合があるためです。依頼文を一つの確認基準にできます。

調査だけを頼む文と変更を頼む文を分ける

「原因を説明してください」と「原因を直してください」は別の依頼にします。前者では対象ファイル、再現条件、調べてほしい観点を指定し、後者では変更範囲、守る既存仕様、検査方法を指定します。調査の返答で見つかったファイルが想定と違う場合は、変更へ進まず、まず対象を修正します。この分け方なら、モデルの判断を読み、必要な部分だけを採用できます。VS CodeのChat viewで会話を続ける場合も、次の依頼の目的を一文で区切ると履歴が読みやすくなります。

完了条件を人が確認できる形にする

「きれいに直す」ではなく、「税込みの合計が一度だけ表示され、既存テストが通り、空のカートでは0円になる」のように書きます。画面の見た目なら、対象の画面、入力値、期待する表示を示します。検査なら、実行するコマンドと成功条件を示します。完了条件が具体的だと、エージェントの返答、差分、テスト結果を同じ基準で見られます。Astraを使うときも、判断をモデルに委ね切らず、人が確認できる出口を先に作ることが大切です。

変更の大きさを段階的に増やす

最初の変更は一つの関数、一つの画面、一つのテストなど、結果が追える範囲にします。うまくいったら関連するファイルを追加し、次の変更へ進みます。複数の機能を一度に頼むと、正しい部分と修正が必要な部分を分けにくくなります。VS Codeでは差分を見ながら依頼を追加できるため、段階ごとに保存しておくと戻りやすくなります。速く終わらせることより、どの変更がどの結果につながったか分かることを優先してください。

まとめ：Codex with VS Codeの選び方

Codex with VS Codeを始めるときは、まずVS Code、Codex、GPT-6 Astra、GitHub Copilotの役割を分け、どの入口で作業するかを決めます。Codex 0.153.4ではAstraのモデル選択画面と既定値が調整されましたが、表示や利用条件は版、アカウント、提供経路によって変わります。画面のモデル名だけで結論を出さず、版番号、対象フォルダー、依頼文、差分、検査結果を順番に確認してください。

VS CodeのChat viewやAgents windowでCodexを選べる場合は、依頼と差分を同じ画面で確認できます。選択肢がない場合も、統合ターミナルでCodex CLIを使う方法が残ります。最初は読み取り、小さな変更、検査という順番で進め、モデルを変えるときは同じ課題で結果を比べます。OpenAIの公式リリースと、VS Codeの公式エージェント概要を基準にすれば、表示の違いと実際の作業結果を落ち着いて切り分けられます。