Codex Monitorとは？Codex CLIを束ねるGUIの使い方・インストールと公式アプリとの違い【2026年10月】

Codex Monitorは、OpenAIのコーディングエージェント「Codex」のCLIを、複数のプロジェクトにまたがって1つの画面から操作するデスクトップアプリです。iOSアプリ「Ice Cubes」の作者として知られるThomas Ricouard氏がGitHubでMITライセンスのオープンソースとして公開しており、Tauri（Rust＋React）で作られています。ワークスペースごとにCodexとの会話（スレッド）を並べ、Gitのworktreeで作業を分け、差分の確認やGitHubのIssue・PRの参照までを同じ画面で扱えます。

導入前に知っておきたいのは開発の状況です。最新版は2026年3月24日のv0.7.67で、3月26日を最後にコミットが止まっています（2026年10月19日に確認）。この記事では、配布ファイルの中身、2026年10月15日公開のCodex CLI 0.163.0との互換性を実際に確かめた結果、2026年8月にLinux版が出た公式ChatGPTデスクトップアプリとの選び分けを含めて、インストールから使い方までを整理します。

まとめ：Codex Monitorの要点

• 正体：Codex CLIに含まれる codex app-server をワークスペースごとに起動し、その上にスレッド管理・worktree・Git操作の画面をかぶせたGUI。Codex CLIのインストールとログインが前提。
• 料金：アプリは無料（MITライセンス）。Codexの利用枠は自分のChatGPTプランかAPIキーの分を使う。
• 対応OS：配布ビルドはmacOS（Apple Siliconのみ）、Windows（x64）、Linux（AppImageとrpm、x64とARM64）。Intel MacとDebian系の.debは配布されていない。
• 開発の状況：最終リリースは2026年3月24日のv0.7.67。Codex CLI 0.163.0では、初期化と読み取り系9メソッドの成功応答を確認した。会話の開始・生成やGUI全体の動作は未検証。今後のCLI更新で壊れても、修正版が出る見込みは立っていない。
• 使用量メーター：サイドバーはOpenAI側の利用上限の消費率、ホーム画面はローカルのセッションログから数えたトークン数。後者は再開したセッションを二重に数える不具合が報告されている。
• 選び方：業務の標準環境にするなら公式のChatGPTデスクトップアプリ（Codex）。ソースを読んで改造したい、gh連携のGUIが欲しい、自前のサーバーでCodexを動かしたい場合はCodex Monitorが候補になる。

Codex Monitorの仕組み：Codex CLIのapp-serverを束ねるデスクトップGUI

Codex Monitorは、Codexのエージェント本体を持っていません。READMEによると、登録したワークスペースごとに codex app-server を1つずつ子プロセスとして起動し、標準入出力でやり取りします。app-serverは、OpenAIが公式ドキュメントで「VS Code拡張のようなリッチなクライアントを動かすためのインターフェース」と説明しているもので、JSON-RPC 2.0形式のメッセージを1行ずつ送受信します。モデル、承認、認証、会話履歴はCodex CLI側が担い、Codex Monitorは画面とGit・GitHub・ファイルツリーなどの周辺機能を足しています。

• Codex CLIの設定がそのまま効きます。~/.codex/config.toml のモデルや承認モードはCodex Monitorからも使われ、逆にCodex Monitorの設定画面で変えた一部の機能フラグは、config.toml に書き戻されます（READMEの「Notes」に明記）。
• ターミナルで起動したCodex CLIのセッションも、作業フォルダ（cwd）がワークスペースのパスと一致すればスレッド一覧に出ます。実行中の出力は流れず、選ぶとディスクから読み直します。
• モデルはCodexが提供するものだけです。2026年10月19日に手元のCLI 0.163.0から取得したモデル一覧の先頭はGPT-6.1-Solでした。ClaudeなどCodex以外のエージェントは動かせません。

GitHubのスター数は4,347、フォークは414（2026年10月19日時点）。公式サイトは codexmonitor.app です。Codex CLIそのものの導入と料金はCodex CLIとは｜始め方・料金・コードを学習させない設定まで解説にまとめています。

同じ名前の別ツールとの見分け方

「Codex Monitor」という名前のツールは、ほかにもGitHubにあります。「codex monitor hud」「codex meter」のように、トークン数を画面に重ねて表示するものを探している場合は、下の表の2番目が目的のツールかもしれません。

KevinKE93/Codex-Monitorは、公式のChatGPTデスクトップアプリ（旧Codexアプリを含む）の画面内に、コンテキストの使用量とトークン消費を読み取り専用で表示するプラグインです。naowalrahman/codex-monitorはnpmパッケージ @naowalrahman/codex-monitor（0.2.0）として配布され、条件が満たされるまでエージェントを待たせるMCPサーバーです。この記事では以降、Dimillian/CodexMonitorを扱います。

Codex Monitorの開発状況：2026年3月26日以降のコミット停止

Codex Monitorは2026年1月11日にリポジトリが作られ、2月から3月にかけてほぼ毎週リリースが出ていました。ところがリリース一覧の最新は3月24日のv0.7.67のままで、mainブランチの最後のコミットは3月26日です。その後もIssueとPRは届いており（10月19日時点でオープンなIssue 77件・PR 17件）、8月の日本語・中国語化や10月の使用量集計の修正のPRはマージされないままです。リポジトリはアーカイブ（読み取り専用化）されておらず、開発終了の告知も見当たりません。

この状態で困るのは、Codex CLI側の変更です。Codex Monitorが接続しているapp-serverについて、OpenAIのドキュメントは「app-serverコマンドとWebSocketトランスポートは実験的で、本番のワークロードには対応しない」と書いています。しかもCodex Monitorは、接続時に experimentalApi を有効にして、互換性の約束がない実験的なメソッドまで使っています（ソースの src-tauri/src/backend/app_server.rs）。Codex CLIの更新で一部の機能が動かなくなる可能性があります。Codex Monitor側の更新再開は確認できないため、採用する場合はCLIのバージョン固定や自前での修正を運用に含めるべきです。

Codex CLI 0.163.0との互換性を確かめた結果

そこで、v0.7.67のソースから、Codex Monitorがapp-serverに送るリクエストを抜き出しました。そのうち副作用のない読み取り系の9つを、2026年10月15日公開のCodex CLI 0.163.0（macOS）に、Codex Monitorと同じ初期化パラメータで送っています（10月19日実施）。

書き込みを伴う thread/start・turn/start・review/start・thread/fork など、残りのメソッドは実行していません。ただし、いずれも0.163.0の codex app-server generate-json-schema --experimental が出力するスキーマに残っていました。使用量メーターが読む usedPercent・windowDurationMins・resetsAt の3項目も、応答の形はCodex Monitorの型定義（src/types.ts）と一致しています。CLIの更新後に調子がおかしいときは、Codexにログイン済みの環境で次のスクリプトを実行すると同じ確認ができます。error が返った場合は、エラーコードとメッセージから、認証・通信・引数の問題か、APIの互換性の問題かを切り分けてください。

import json, subprocess
p = subprocess.Popen(["codex", "app-server"], stdin=subprocess.PIPE,
                     stdout=subprocess.PIPE, text=True)
def call(i, method, params=None):
    msg = {"id": i, "method": method}
    if params is not None:
        msg["params"] = params
    p.stdin.write(json.dumps(msg) + "\n"); p.stdin.flush()
    while True:
        line = p.stdout.readline()
        if not line:
            p.wait()
            raise RuntimeError(f"app-serverが終了しました（終了コード: {p.returncode}）。標準エラー出力を確認してください。")
        r = json.loads(line)
        if r.get("id") == i:
            return json.dumps(r["error"], ensure_ascii=False) if "error" in r else "ok"
print(call(0, "initialize", {"clientInfo": {"name": "probe", "version": "0"},
                             "capabilities": {"experimentalApi": True}}))
p.stdin.write(json.dumps({"method": "initialized"}) + "\n"); p.stdin.flush()
for n, m in enumerate(["thread/list", "model/list", "account/rateLimits/read"], 1):
    print(m, call(n, m, {} if m != "account/rateLimits/read" else None))
p.terminate()

Codex Monitorの主な機能

READMEの「Features」から、作業で使う順に並べます。

• ワークスペースとスレッド：プロジェクトのフォルダを登録して並べ替え、スレッドはピン留め・名前の変更・アーカイブができ、実行中のターンは止められます。
• worktreeとクローンのエージェント：ブランチごとにGitのworktreeを作り、別のエージェントに作業させます。worktreeの保存先は設定で変更でき、既定ではアプリのデータフォルダ（worktrees/<workspace-id>）に作られ、リポジトリの .gitignore は書き換えません。
• 入力欄：画像の添付、$ でスキル、/prompts: でプロンプト、/review でレビュー、@ でファイルパスを補完します。実行中に追加の指示を送るときは、終わってから渡す「Queue」と、割り込んで方向を変える「Steer」を選べます。
• Git・GitHub：ステージ済みと未ステージの差分、コミットログ、ブランチの作成と切り替え、upstreamとの差を表示します。GitHub CLI（gh）を入れておくと、IssueとPRの一覧・差分・コメントも見られ、「Ask PR」でPRの内容を新しいスレッドに渡せます。
• そのほか：プロンプトライブラリ、ファイルツリー、複数タブのターミナル（実験的）、音声入力（Whisperのモデルをダウンロードしてローカルで認識）、アプリ内アップデート。

使用量メーターは2系統：サイドバーは利用上限、ホームはローカルログの集計

Codexの使用量はCodex Monitorで確認できますが、画面によって数字の出どころが違います。

サイドバーはChatGPTの利用上限の状態を取得します。APIキー利用時のAPI使用量や請求額を表示するメーターではありません。ホームの使用量は、手元の ~/.codex/sessions にあるセッションのログをCodex Monitorが読んで数えたものです（src-tauri/src/shared/local_usage_core.rs）。別のPCで使った分は入りません。2026年4月には公式の統計と日別の棒グラフが合わないという報告（Issue #597）が、10月には再開したセッションの累計を新しい使用量として二重に数えるという報告（Issue #616）が出ていて、どちらも未修正です。上限に近いかどうかの判断はサイドバー側の数字で行い、ホームの棒グラフは目安にとどめてください。

対応OSとダウンロードファイル

v0.7.67の配布ファイルです。署名とアーキテクチャは、ファイルを取得して確かめました。

• macOS：アプリ内の実行ファイル3つ（本体と、リモート用のデーモン2つ）は、どれも lipo -archs の結果が arm64 だけでした。Intel Macでは配布版は動かないので、ソースからビルドします。署名は「Developer ID Application: Thomas Ricouard」で、公証のチケットが添付されています。ただし、公証済みでも初回起動時の確認はあり、Gatekeeperによる起動許可を無条件に保証するものではありません。
• Windows：インストーラー（exe）にはAuthenticodeのコード署名が付いていません。初回にMicrosoft Defender SmartScreenの警告が出ることがあります。READMEには「Windows (opt-in)」とありますが、これはソースから自分でビルドする場合の説明で、配布版のインストーラーはそのまま使えます。
• Linux：.debは配布されていないので、UbuntuやDebianではAppImageを使います。アプリ内アップデートの配信情報（latest.json）に載っているLinux版はAppImageだけで、rpmで入れた場合はdnfで入れ直して更新します。

Codex Monitorのインストールと初期設定の手順

導入の前提：Codex CLIのPATH設定とログイン

Codex Monitorは、PATH上の codex コマンドを呼びます（設定画面で別のバイナリを指定することもできます）。先にCodex CLIを入れ、ターミナルで次の2つが通ることを確認してください。

codex --version
codex login

Git CLIはworktreeに必須で、GitHub CLI（gh）はIssue・PR連携を使う場合だけ必要です。MacでのCodex CLIの入れ方はCodexをMacにインストールする方法｜ChatGPTアプリ・CLI・Intel Mac対応【2026年9月】、WindowsはWindows版Codexの使い方｜アプリとCLIの違い・インストール・プロキシ設定【2026年10月】で手順を説明しています。

macOS（Apple Silicon）版のインストール手順

最新リリースから CodexMonitor_0.7.67_aarch64.dmg を取得し、開いてアプリを「アプリケーション」フォルダへドラッグします。Intel Macの場合は、後述のソースからのビルドに進んでください。

Linux（Ubuntu・Fedora）版のインストール手順

UbuntuなどではAppImageに実行権限を付けて起動します。ARM64の場合は amd64 を aarch64 に読み替えます。

chmod +x Codex.Monitor_0.7.67_amd64.AppImage
./Codex.Monitor_0.7.67_amd64.AppImage

Fedoraではrpmをdnfで入れます。

sudo dnf install ./Codex.Monitor-0.7.67-1.x86_64.rpm

Windows版のインストール手順

Codex.Monitor_0.7.67_x64-setup.exe（またはmsi）を実行します。SmartScreenの警告が出た場合は、公式リポジトリの配布ファイルであることと、リリースページに表示されるSHA-256と、PowerShellの Get-FileHash .\Codex.Monitor_0.7.67_x64-setup.exe の結果が一致するかを確認し、実行を判断してください。「発行元が不明」という表示だけでは配布元を確認できません。社内のPCで未署名のソフトが禁止されている場合は、管理者に相談してください。

初回起動時のワークスペース登録とスレッド作成

1. サイドバーからワークスペースを追加し、Gitリポジトリのフォルダを選ぶ。
2. Codex CLIの場所が見つからないときは、設定画面でCodexのバイナリのパスを指定する。
3. 新しいスレッドを作り、モデル、推論の強さ（reasoning effort）、アクセスモードを選んで指示を送る。
4. 承認を求められたコマンドを画面で許可し、右側のGitパネルで差分を確認する。

ワークスペースの一覧は workspaces.json、アプリの設定は settings.json として、アプリのデータフォルダに保存されます（アプリのIDは com.dimillian.codexmonitor）。PCを移行するときは、この2つとCodex CLI側の ~/.codex に加え、元のGitリポジトリと各worktreeの作業ファイルも移行します。保存先が変わる場合はワークスペースのパスを更新し、必要に応じて git worktree repair で参照を修復します。

Intel Mac・mainブランチ向けのソースビルド手順

Node.jsとnpm、Rustのstable版、CMakeが必要です。WindowsではさらにLLVM／Clangが要ります。ネイティブ依存のビルドでつまずいたら npm run doctor が原因を表示します。

git clone https://github.com/Dimillian/CodexMonitor.git
cd CodexMonitor
npm install
npm run tauri:build        # Windowsは npm run tauri:build:win

できあがったファイルは src-tauri/target/release/bundle/ の下に出力されます。mainはv0.7.67のタグより4コミット進んでいますが、中身はボタンの角丸、版番号の0.7.68への変更、READMEのバッジ、トレイメニューの整理で、3月26日から先の変更はありません。

Codex Monitorの使い方：並列作業と外部からの接続

worktreeによる作業分離と並列実行

同じリポジトリで2つの修正を同時に進めるときは、スレッドの作成時にworktreeのエージェントを選びます。エージェントごとにフォルダとブランチが分かれるため、作業ファイルの変更を分離できます。ただし、同じポートやデータベースなどを使うビルド・テストは干渉するため、共有リソースも分ける必要があります。結果は差分パネルで確かめ、取り込む変更だけを元のブランチへ反映します。ワークスペースを増やすとapp-serverも同じ数だけ起動し、メモリと開くファイルの数が増えます。

別のマシンのCodexにつなぐリモートバックエンド

設定の「Server」でリモートバックエンドを選ぶと、別のマシンで動かしたデーモン（codex_monitor_daemon）にトークン認証で接続できます。READMEには、Tailscaleで同じネットワークに入れたiPhoneから、デスクトップ側のデーモンにつなぐ手順が載っています。ただしiOS版は「開発中」と明記されていて、App Storeでは配布されておらず、Xcodeで自分でビルドする必要があります。また、リモート先のフォルダをワークスペースとして追加すると、手元のPCのファイルシステムでパスを検証してしまい、追加できないという不具合（Issue #598）が未修正です。WindowsのGUIからWSLのデーモンへつなぐ使い方も、この不具合に当たります。

公式のChatGPTデスクトップアプリとの違いと選び方

Codex Monitorが公開された2026年1月の時点では、Linuxで使えるCodexのGUIがほぼ無く、「Linux向けのCodex GUI」という役割がありました。その後、公式のCodexアプリは2026年7月にChatGPTデスクトップアプリへ統合され（経緯はOpenAIのスーパーアプリとは？ChatGPT・Codex統合デスクトップアプリの中身と構想からの変更点）、8月11日にはLinux版がプレビューとして公開されました。公式のLinux版ガイドが挙げる対応ディストリビューションは、Ubuntu 24.04／26.04 LTS、Debian 13、Fedora 43／44、Arch Linuxで、それぞれx64とARM64があります。公式アプリにもworktreeで並列に作業する機能があるため、Codex Monitorの強みは当初より狭くなっています。

業務の標準環境として何人もに配るなら、公式アプリを選ぶべきです。更新が止まったアプリでは、CLIの更新で動かなくなったときの対処が「CLIを古い版に戻す」か「自分たちで直す」しかありません。Intel Macが混ざる環境や、未署名のインストーラーを配れない環境でも同じ結論です。

Codex Monitorを選ぶ理由が残るのは、次のような場合です。

• ソースを読んで、自分たちの運用に合わせて改造したい（MITなので、フォークして社内版を保守できる）。
• GitHubのIssueとPRの一覧・コメントを、ghと連携した同じ画面で見ながらエージェントを回したい。
• Codexを自前のLinuxサーバーで動かし、手元のGUIからデーモン経由で操作したい。ただし、Issue #598のワークスペース追加不具合への対処を自分で行える場合に限る。
• 公式アプリが正式には対応していないディストリビューション（Linux Mintなど）でGUIを使いたい。公式ガイドは、対応外のディストリビューションについて「動く場合があるが正式には対応しない」としています。

Codex以外のエージェントもまとめて並列に動かしたいなら、ターミナル上で複数のエージェントを管理するherdrとは？AIコーディングエージェントを並列で動かす使い方・インストール・Windows/WSL対応【v0.9対応】も選択肢になります。

Codex Monitorの起動・承認・履歴操作のトラブル対処

• 「Codex app-server did not respond to initialize」と出る：Codex Monitorは初期化の応答を15秒待って打ち切ります。ターミナルで codex app-server を起動できるか、codex login が済んでいるか、Codex Monitorが別の古い codex を掴んでいないかを確かめます。
• macOSで「Too many open files」が出る：開けるファイル数の上限（ulimit -n）が256の環境で、ワークスペースを5つ登録すると、本体が約105、app-serverが約95、画面のWebKitが約59のファイルを開いていたという報告があります（Issue #583）。使わないワークスペースを外すと負荷が下がります。
• ブラウザ系のMCPツールで止まったように見える：Playwrightなどのブラウザ系MCPツールが承認を求めても、Codex Monitorには承認の画面が出ず、セッションが止まったように見えるという報告があります（Issue #612）。その作業だけはCodex CLIのターミナルで行います。
• アーカイブしたスレッドを戻せない：v0.7.67は、アーカイブの解除（thread/unarchive）を呼ぶ機能を持っていません。戻す方法は次のFAQを参照してください。

よくある質問

Codex Monitorは無料ですか？オープンソースですか？

無料で、MITライセンスのオープンソースです。ただし、Codexを動かす分の利用枠は、Codex CLIにログインしたChatGPTのプラン（またはAPIキー）から消費されます。Codex Monitorを使っても、利用枠が増えたり別料金がかかったりはしません。

Codex MonitorはWindowsやLinuxでも使えますか？

使えます。Windowsはx64のインストーラー（exeとmsi）、LinuxはAppImageとrpm（x64とARM64）が配布されています。macOSの配布版はApple Silicon専用で、Intel Macではソースからのビルドが必要です。

Codex Monitorで使用量やトークンの消費状況を確認できますか？

確認できます。サイドバーのメーターはOpenAI側の利用上限の消費率とリセット時刻、ホーム画面は手元のセッションログから数えた日別のトークン数です。ホームの集計は、ほかのPCでの利用を含まず、再開したセッションを二重に数える不具合も報告されているので、上限の判断にはサイドバーの数字を使ってください。

Codex Monitorの利用にOpenAI Codex CLIは必要ですか？

必要です。Codex Monitorは codex app-server を起動して動くGUIで、エージェント本体を持っていません。Codex CLIを入れてPATHに通し、codex login を済ませてから起動します。

アーカイブしたスレッドを元に戻すにはどうすればいいですか？

Codex Monitorの画面からは戻せません。アーカイブはCodex CLIの機能で、セッションのファイルは ~/.codex/archived_sessions に移されています。CLIでは codex unarchive にセッションのIDか名前を渡して解除できます。VS Code拡張での手順や保存場所の詳細はCodexのアーカイブを戻す方法｜保存場所・unarchive・VS Code対応とCodex Viewerで履歴を見る手順で説明しています。解除すると、作業フォルダが一致するワークスペースのスレッド一覧に再び表示されます。

関連記事

• Codexとは？OpenAIの自律型AIコーディングエージェントの使い方・料金・モデルを解説【2026年最新】
• Codex CLIとは｜始め方・料金・コードを学習させない設定まで解説
• Windows版Codexの使い方｜アプリとCLIの違い・インストール・プロキシ設定【2026年10月】
• Codexのアーカイブを戻す方法｜保存場所・unarchive・VS Code対応とCodex Viewerで履歴を見る手順
• herdrとは？AIコーディングエージェントを並列で動かす使い方・インストール・Windows/WSL対応【v0.9対応】