🎮

Codex アプリで Windows 環境＆非エンジニア向けにもいい感じでツールを配布する

に公開
AI
Windows
OpenAI
lol
Codex
tech

背景

Mac でコーディングエージェント（Claude Code / Codex CLI）を使い、League of Legends のリプレイ動画分析用の CLI ツールを開発していました。Python + ffmpeg で試合を解析し、HTML レポートを出力するツールです。

しかし、実際にゲームをプレイするのは Windows 環境。さらに「うまくできたら何かしらの形で公開したい」と思ったとき、CLI ツールを非エンジニアに渡すハードルの高さが壁になりました。

  • Python と ffmpeg のインストール手順を説明する？
  • uv sync や uv run を叩いてもらう？
  • エラーが出たら Slack で聞いてもらう？
  • そもそも自分も Windows 環境に詳しくない

そんなとき Rebuild.fm #422 で Codex アプリ（デスクトップ版）の存在を知り、しかも最近 Windows 版がリリースされたことを知りました。「これならがんばって Web /スマホのアプリまで作り込まずとも、 GitHub リポジトリを渡すだけで、セットアップのトラブルシューティングも Codex 自身がやってくれるのでは？」と思い、試してみた記録です。

Codex アプリとは

OpenAI が提供するデスクトップアプリケーションで、GitHub リポジトリを指定するとサンドボックス環境でコードを実行・編集できるコーディングエージェントです。

  • Codex デスクトップアプリ（macOS）: 2026年2月リリース。複数エージェントの並列管理が可能に
  • Codex デスクトップアプリ（Windows）: 2026年3月リリース（Microsoft Store からインストール可能）
  • 料金: ChatGPT Plus（$20/月）以上のプランで利用可能。2026年4月現在は期間限定で Free / Go プランでも無料開放中

CLI 版の Codex CLI（ターミナルで codex コマンドを叩くもの）とは異なり、デスクトップアプリ版はリポジトリ単位でタスクを投げるスタイルです。ターミナル操作が不要なので、非エンジニアでも扱いやすいのがポイントです。

紹介記事をみるとそういうユースケースも想定されていそうです。

アプリで新しいスキルを作成すると、Codex はアプリ、CLI、IDE 拡張機能など、どの作業環境でもそのスキルを利用できます。スキルをリポジトリに登録すれば、チーム全体で利用できるようになります。チーム設定を使ったスキル共有については、こちら⁠（新しいウィンドウで開く）をご覧ください。

Codex アプリの Windows 版ダウンロードページ（Microsoft Store）
Microsoft Store から Codex アプリをダウンロードできる

なぜ Codex アプリでツール配布なのか

従来の CLI ツール配布の課題

非エンジニアに Python 製 CLI ツールを使ってもらおうとすると、以下のステップが必要です：

  1. リポジトリの clone（またはダウンロード）
  2. Python のインストール
  3. パッケージマネージャ（pip / uv）のセットアップ
  4. ffmpeg のインストール（動画解析ツールの場合）
  5. 依存関係のインストール
  6. コマンドの実行

どのステップでもつまずく可能性があり、そのたびにサポートが必要になります。

Codex アプリなら

  1. ChatGPT の課金がある（Plus 以上、または期間限定で無料）
  2. Codex アプリをインストール
  3. GitHub リポジトリの URL を渡す
  4. Codex アプリ上でリポジトリを開き、環境セットアップをまかせる
  5. リポジトリに定義されたスキルから自然言語で指示する

つまずいても Codex 自身がトラブルシューティングしてくれるのが最大の利点です。

実際にやってみた：Windows で LoL 分析ツールを動かす

前提

  • リポジトリ: kumewata/lol-tools
  • 機能: Riot API による試合データ取得 + リプレイ動画の AI 分析 + HTML レポート出力
  • 開発環境: macOS（Claude Code + Codex CLI でスキルベース開発）
  • 動作確認環境: Windows 11 Pro

Codex アプリでスキルを利用

Codex アプリを起動し、GitHub リポジトリを指定して環境セットアップの指示やタスクを投げます。今回はリポジトリ内の skills/ ディレクトリに CLI を使うためのスキル定義（分析手順やプロンプト）も用意したので、Codex はそれを読み取って実行してくれます。

Codex 上でスキルを動かしている例
Codex がリポジトリのスキルを読み取り、LoL の試合分析を実行している

エラーが出ても Codex が解決してくれる

Windows 環境で実行すると、macOS では起きなかった問題にぶつかることがあります。今回は uv が管理する Python が Windows のアプリ制御（WDAC）にブロックされるという問題が発生しました。

エラーが発生しても Codex が原因を特定してくれる
unicodedata.pyd がアプリケーション制御ポリシーでブロックされるエラー。Codex が原因を特定し、winget install Python.Python.3.12 で通常版 Python をインストールする解決策を提示

これが Codex アプリでツールを配布する最大のメリットです。ユーザーが自分でエラーメッセージを読み解く必要がなく、Codex が：

  1. エラーの原因を分析
  2. 解決策を提示（この場合は通常版 Python 3.12 のインストール）
  3. 修正コマンドを実行

まで一貫してやってくれます。

解決後、分析が正常に完了
Python を切り替えた後、試合分析が正常に完了し HTML レポートが生成された

実際にぶつかった Windows 固有の問題と解決策

開発過程で判明した Windows 固有の問題をまとめます。これらは Codex が自力で解決したものも含まれます。

問題 原因 解決策
uv 管理の Python がブロックされる Windows App Control (WDAC) 通常版 Python 3.12 を winget でインストールし uv sync -p で明示指定
スキルファイルが認識されない .codex/skills が symlink だった 暫定で実ディレクトリに変更
文字化け PowerShell の UTF-8 設定 $env:PYTHONUTF8='1' を設定
.env ファイルの作成 cp コマンドが Windows にない init コマンドで自動作成する方式に変更

ツール配布側として工夫したこと

Codex アプリで使ってもらうことを前提に、リポジトリ側でいくつか工夫しました。

1. doctor コマンドで依存関係を診断

uv run lol-tools doctor

OS を検出し、ffmpeg / ffprobe の有無をチェックして、不足している場合は OS ごとのインストール手順を表示します。Codex がこの出力を読んで自力で解決できるようにしています。

2. スキルファイルの配置

.codex/skills/ と .claude/skills/ に分析手順をスキルとして定義しています。Codex アプリはリポジトリ内のスキルを認識するので、ユーザーは「最新5試合を分析して」のような自然言語の指示だけで済みます。

3. README にテスト済み PowerShell コマンドを記載

抽象的な手順説明だけでなく、Windows 実機でテスト済みの PowerShell コマンドをそのまま記載しました。Codex が README を参照したときに、そのまま実行できるコマンドがある方が解決率が高くなります。

# Python のパスを明示して uv sync
uv sync -p "C:\Users\<user>\AppData\Local\Programs\Python\Python312\python.exe" --refresh --no-cache

# 試合レビューの実行
uv run lol-tools review --count 5

Codex アプリ配布の向き・不向き

向いているケース

  • ツールの利用者が ChatGPT ユーザー: 追加課金なしで Codex アプリが使える
  • セットアップにトラブルシューティングが発生しやすいツール: Codex が解決してくれる
  • スキルファイルで操作手順を定義できるツール: 自然言語での指示が可能になる
  • 開発者がクロスプラットフォーム対応を完璧にする余裕がない場合: Codex が差分を埋めてくれる

向いていないケース

  • リアルタイム性が求められるツール: Codex のサンドボックス実行にはラグがある
  • 大量のデータを扱うツール: サンドボックスのリソース制約がある
  • オフラインで使いたいツール: Codex アプリはオンライン前提
  • 機密データを扱うツール: リポジトリとデータが OpenAI のサーバーを経由する

まとめ

「Mac で CLI ツールを作ったけど、Windows の非エンジニアにも使ってもらうには？」という課題に対して、Codex アプリはいい線いってそうな感触でした。

ポイントをまとめると：

  • Codex アプリ = GitHub リポジトリベースのツール配布プラットフォーム として使える
  • エラーが出ても Codex が自力で解決してくれる ので、配布側のサポートコストが下がる
  • ただし リポジトリ側の工夫（doctor コマンド、スキルファイル、テスト済みコマンドの記載）で解決率は上がる
  • Windows 固有の問題（WDAC、symlink、UTF-8）は事前に潰しておくとスムーズ

きっかけは Rebuild.fm #422 で Codex アプリの話を聞いたことでした。コーディングエージェントを「開発ツール」としてだけでなく「配布・サポートのインフラ」として捉えると、非エンジニアへのツール配布のハードルがぐっと下がります。

参考リンク

Discussion