0. はじめに
今回はCodex CliとIDE拡張機能について「Windows」での動かし方(サインイン/API)を自分用にメモしてきたまとめを自分の参照用も兼ねて公開したものです。
対象読者はCodex cliに興味があり、windowsで使いたい、かつWSLは使いたくない人向けです。初心者も読めるように書いたつもりですのでもしご質問あればコメントしてください
なお、バージョンアップで内容は随時更新します
(codex cliはバージョンが頻繁に変化してますので本記事の記載内容で最新モデルでは動かないこともありますのでご留意ください)
- 動作環境
・ OS : Windows11 pro(Windows server 2025)
・ Node.js : v22.14.0
・ codex-cli : 0.42.0 (2025/9/29確認)
・ uv : 0.6.14
1. codex-cliをWindowsに導入する
現時点でOpenAI公式によれば「Windows上でCodexを直接実行することは可能ですが、公式にはサポートされていません。Windows Subsystem for Linux（WSL2）の使用をお勧めします。」としています。
https://github.com/openai/codex/blob/main/docs/faq.md
が、codex-cliのバージョン0.23.0以降から、Windowsでの動作確認をしていますので、私はWSL経由の利用をやめて、Windowsから今は利用しています
1-1. Node.jsを導入する
もしまだNode.jsを入れていない方は、以下から入手してWindows用の最新バージョンを入れてください（導入は道なりでOK）
1-2. codex-cliの導入
cmdを開いて、以下を実行
npm install -g @openai/codex
1-3. codex-cliが動くか？を確認する
その後、以下のコマンドを実行し、「codex-cli 0.27.0」のようにバージョンが出れば導入OK
codex --version
もしここで万が一何も出力されない場合は、Visual C++ 再頒布可能パッケージ（vcruntime140.dll系）が入ってない可能性がありますので以下を実施してみてください
まずは以下のコマンドをcmdで打って何かPathが出るか？を確認し、もし出ない場合は以下のURL「Latest Microsoft Visual C++ Redistributable version」からダウンロード＋インストールしてください。
その後、今一度codex --versionでバージョンが出るか確認してください
※Windos serverで試したらここでハマりました
where vcruntime140.dll
where msvcp140.dll
2. codex-cli(OpenAI)へのログイン
これには2種類ありますが、全パターンで動かした経験がありますので解説します
2-1.OpenAIアカウントでサインインするケース
これは正直難しいことはない。
codexを実行したいプロジェクト(path)までcdで移動した後、codexコマンドでcodexを起動する。
初めて起動する際に、以下の様にauth経由でのログインを促されるので、使用しているOpenAIのログインをブラウザ経由で実施するだけである。
無事にサインインできると、以下の様に出るので、エンターキーを押せばOKです
2-2.APIで利用するケース
最近の更新で以下のように起動時オプションにapiキーを入れることで、公式のOpenAIのAPIでは使えるそうです
codex login --api-key "your-api-key-here"
よって、以下はAzureのケースになります
何もしないままcodexと打ち込んでも永遠にサインイン画面が出るだけで一向に使用できないので、少し準備が必要である。
2-2-1.APIキーを環境変数へ登録する
発行したAPIキーをcmdからの場合は以下のコマンドで環境変数に登録しておく(Azureも同様にkeyを設定)
setx OPENAI_API_KEY "sk-XXXXXXXXXXXXXXXX"
2-2-2.config.tomlの記載
まずすでに下図のUsersフォルダの中に.codexというフォルダができているはずであるので、その中にconfig.tomlというtomlファイルを新規作成する
で、それをエディタで開いて以下の様に記述する（中はAPIとAzureで書き方が異なるので注意）
``v1 Responses APIが採用されているgpt-5-codexからは仕様が変わったので
## 以下は以前は動いていましたが、最新モデルでは変わったようです
- ## 以下は必須（API/Azureで内容を変更すること）
- model_provider = "openai" # OpenAI を利用(Azure OpenAIなら azure)
- model = "gpt-5" # 使いたいモデル（Azure OpenAIならAI Foundryのモデルデプロイ名）
- preferred_auth_method = "apikey" # API キー認証のみを優先（これでログイン画面を回避できる）
- ## 以下はAzureのみ必要でAPIでは記載不要
- [model_providers.azure]
- name = "Azure"
- # base_url ※AI Foundryに記載があります
- base_url = "https://<RESOURCE名>.openai.azure.com/openai/deployments/gpt-5(デプロイ名)"
- wire_api = "chat" # responceでないと動かないという噂もあるが私はchatで動いた
- requires_openai_auth = false
- # APIバージョン
- query_params = { "api-version" = "2025-04-01-preview" }
- # 以下は必要なケースもある（$AZURE_OPENAI_API_KEYがNGならkeyベタ打ち）
- env_http_headers = { "api-key" = "$OPENAI_API_KEY","Ocp-Apim-Subscription-Key" = -"$OPENAI_API_KEY" }
## 以下はAzureにおける公式の書き方で動作を確認しています（ + 記号は削除してください）
+ model = "gpt-5-codex" # モデル名
+ model_provider = "azure"
+ model_reasoning_effort = "medium" # reasoningレベルをここで設定する
+ [model_providers.azure]
+ name = "Azure OpenAI"
+ base_url = "https://<RESOURCE名>.openai.azure.com/openai/v1" # モデル名等は不要に
+ env_key = "OPENAI_API_KEY" # Azure OpenAI Foundryに記載されているAPIキー（環境変数で指定 or べた書き）
+ wire_api = "responses" # gpt-5-codexはchatではなくresponsesが公式の使用方法
2-2-3.codexの起動
後は使用したいpathへ移動してからcodexで起動すればOK。
ログイン画面が出ないでいきなりチャットが打てるはずである。
3. codex-cliのスラッシュコマンド集
スラッシュコマンドとは、よく使うコマンドをcodex側が事前に準備してくれたものである。
3-1. codex-cliのスラッシュコマンド集
codexは日々進化しているので、私も自分用のメモとして気づいたら更新するが、古い可能性もあります
※コマンド一覧は以下に記載されている
https://github.com/openai/codex/blob/c6a52d611cd50fa2031e1ff89c81076a46e193dd/codex-rs/tui/src/slash_command.rs
| コマンド | 効果 |
|---|---|
| /init | Codex 用の AGENTS.md 雛形を作成 |
| /model | モデルと reasoning effort を選択 |
| /status | 現在のセッション設定やトークン使用状況 |
| /diff | git diff（未追跡ファイル含む）を表示 |
| /approvals | ユーザーの承認なしに行える操作を選択 |
| /review | 現在の変更内容をレビューし、問題を特定する |
| /compact | 会話を要約してコンテキスト制限に達するのを防ぐ |
| /mention | 特定のファイルを会話に明示的に言及 |
| /new | 会話中に新しいチャットを開始する |
| /mcp | 設定されている MCP ツールを一覧表示 |
| /logout | Codex からログアウト |
| /quit | Codex を終了 |
なお、/modelは以下の様にgpt-5の場合はreasoningを選べるが、デフォルトはmedium
となっている※ver0.36.0から選択すればgpt-5-codex mediumがデフォルトに変更
これがいちいち面倒なら以下の様にデフォルトでhighにもできる
①codexの起動時にcodex -m gpt-5 -c model_reasoning_effort="high"で実行
※gpt-5-codexを使用する場合はcodex -m gpt-5-codex -c model_reasoning_effort="high"
②config.tomlの共通部にmodel_reasoning_effort="high"と記載する（これはアカウントログインでも有効）
3-2. カスタムスラッシュコマンドの実装と実行
最新バージョンでは自分でよく使うスラッシュコマンドを作成できるようになった。
.codexフォルダの中にpromptsフォルダを作成し、その中に/で呼び出したい名前の.mdファイルを作成すれよい。~/.codex/prompts/<command>.md
今回はgreet.mdを作成してみた
こんにちは！元気ですか？
こんな感じでよく使うパターンを/で指定できるようになるので、自分だけのスラッシュコマンドを作ってみればいいと思う
4. VSCodeでもcodexを使用する（IDE拡張）
ここでは、この便利なcodexをVSCodeで使うための設定を解説する
(VSCode以外のエディタもおおむね同じだと思う)
4-1. codex拡張機能の導入
拡張機能から探して入れるだけ。紛らわしいのもあるが、公式アイコンが目印
4-2. ケース別の利用方法
4-2-1. サインインでの利用
このまま拡張機能をクリックして、普通にサインインすればOK。何も難しくはない
4-2-2. API(/Azure)での利用
こちらは少し設定が必要。
拡張機能のインストールした部分からCodexをクリックし、Settingをクリック、Configの場所のsetting.jsonを編集するを押す。
前までは設定が必要でしたが、最新バージョンでは設定不要になりました。config.tomlに従ってくれるみたいです
4-3. その他Tipsや事例
ここら辺も頻繁に変化すると思うので簡単にしか書かない
4-3-1. 承認モード
以下の3種類から選べます
バージョン0.30以降で、ついにAgent(full access)を指定することで、承認なしで最後まで作業してくれることを確認できました！
| モード | 効果 |
|---|---|
| Chat | ただチャットしたいだけの場合、または始める前に計画を立てたい場合 |
| Agent | 作業ディレクトリ内でファイルの読み取り、編集、コマンドの実行を自動的に行う ※作業ディレクトリ外での作業やネットワークへのアクセスには、Codex の承認が必要 |
| Agent(full access) | ファイルの読み取り、編集、ネットワークアクセスによるコマンド実行を承認なしで実行する |
4-3-2. 拡張機能の表示場所の変更
デフォルトでは左側だが、拡張機能を右クリックして設定すればセカンダリーサイドバーに移動できる
(これでClaude Code拡張機能と同じような感じになる)
4-3-3. (事例)Excelの中身を読ませてみた
uv環境のプロジェクトにExcelを配置し、中を読ませてみたが、uv環境にあるpandasとopenpyxlを自動で使用して図の様に中身を読むことができた。
※＠で対象のファイルを指定することもできる
5. 追加された機能を雑多書き
codexでは毎週色々な追加があるので、気になったものはここに随時追記することにしました。根幹をなすものは↑に書いていますが量も多いので
中断したところからセッションを再開
codex resumeの起動オプションで実行すると、前回の続きから再開できます
6. さいごに
codexが発表された時の感想は「全く使い物にならない」というものだったが、GPT-5が出てから急激に発展してきているので、Claudecode等と使い分けながらいいVibe生活を送っていきましょう！
参考
Azure OpenAIでcodexを使うガイド
codexのアップデート詳細