作業の途中でCodexが突然落ちる。さっきまで動いていたのにウィンドウごと消える。ひどいときはPCごと固まる——せっかくの作業が消えたかと青ざめる瞬間です。
でも安心してください。クラッシュには典型的なパターンがあり、どこで落ちているかを見極めれば大半は解決できます。この記事では「何が落ちているのか」の切り分けから、原因別の対処、再発防止までを順に解説します。
この記事でわかること
- ✅ 「落ちる」の3パターンと切り分け方
- ✅ 原因別の対処法（メモリ・バージョン・プロジェクト起因）
- ✅ 作業内容を守るための予防策
- ✅ どうしても直らないときの最終手段
⚠️ 本記事は OpenAI 公式とは無関係の解説記事です。
まず切り分け：「何が」落ちていますか？
同じ「落ちる」でも、レベルによって原因と対処が変わります。
| パターン | 症状 | 主な原因 |
|---|---|---|
| A. アプリだけ落ちる | Codexのウィンドウが突然消える | アプリの不具合・メモリ不足 |
| B. CLIが強制終了する | ターミナルにエラーを残して停止 | Node.js環境・巨大な処理 |
| C. PCごと固まる・落ちる | マウスも動かない・再起動がかかる | メモリ/CPUの限界・他要因 |
なお「落ちてはいないが動かない・応答がない」場合は別の問題です。固まっているだけなら 応答が遅い・固まるときの対処、マシンが重いだけなら 軽量化ガイド へどうぞ。
パターンA：デスクトップアプリが落ちる
まず試すこと（順番に）
- アプリを再起動して再現するか確認
- アプリを最新版にアップデート（アップデート方法）——クラッシュ系の不具合は更新で直っていることが多い
- PCを再起動してメモリをリセット
- エージェントの数を減らす：複数エージェントを並列で走らせている場合、1つに絞って再現するか確認
それでも落ちる場合
- 特定の操作で必ず落ちる → アプリ固有の不具合の可能性。デスクトップアプリ不具合まとめ に既知のパターンと回避策をまとめています
- 大きなプロジェクトを開いた直後に落ちる → 後述の「巨大プロジェクト対策」へ
- 起動すらしなくなった → 起動しないときの対処 へ
パターンB：CLIが強制終了する
ターミナルに残ったエラーメッセージが最大のヒントです。エラー文をそのままコピーして検索、またはCodex自身（Web版など）に貼って「このエラーの意味を教えて」と聞くのが最速です。
よくあるパターン：
「JavaScript heap out of memory」系
Node.jsのメモリ上限に達しています。巨大なファイルやフォルダを読み込んでいるのが典型なので、.codexignore で除外するのが根本対策です（後述）。
突然プロンプトに戻る（エラーなし）
- CLIのバージョンが古い →
npm install -g @openai/codexで更新 - Node.js自体が古い → Node 18以上か
node -vで確認 - それでも再現 → いったんアンインストールしてクリーンに入れ直し（アンインストール手順）
接続断で処理が死ぬ
Wi-Fiの瞬断やVPNの切り替えで、長時間タスクが途中で落ちることがあります。ネットワークエラーの対処 を参考に、安定した回線で再実行してください。
パターンC：PCごと固まる・落ちる
これはCodexの不具合というより、マシンの資源（メモリ・CPU）が限界に達しているサインです。
- 落ちる前の状況を思い出す：エージェントを何個も並列で走らせていなかったか、他の重いアプリ（動画編集・仮想マシン等）と同時に使っていなかったか
- アクティビティモニタ（Mac）／タスクマネージャー（Windows）で確認：Codex関連のプロセスがメモリをどれだけ使っているか
- 同時実行を減らす・他アプリを閉じる
恒常的にメモリ不足なら、軽量化ガイド の対策（エージェント数の整理・Cloudへの外出しなど）が効きます。マシンスペック自体が目安を下回っている場合は 動作環境ガイド で推奨構成を確認してください。
共通の根本対策：巨大プロジェクトを軽くする
パターンA・Bの多くに共通する原因が「読み込ませているものが大きすぎる」です。
プロジェクト直下に .codexignore を作り、不要なフォルダを除外しましょう：
node_modules/
dist/
build/
.next/
*.log
*.zip
.git/
これだけでメモリ消費と処理量が大幅に減り、クラッシュ率が目に見えて下がります。動画・画像素材などの大容量ファイルが混ざっているフォルダも除外対象です。
作業を守る予防策3つ
クラッシュは「起きたときの被害」を小さくする備えも大切です。
- git でこまめにコミット：落ちても直前のコミットまでは無事。これが最強の保険です
- 長いタスクは分割する：一発で大きなタスクを頼むより、段階的に進める ほうがクラッシュ時の損失も小さい
- 重いタスクは Cloud に投げる：手元のマシンで実行しないので、ローカルのクラッシュと無縁になります
どうしても直らないときは
- 完全リセット：アンインストール手順 に従ってクリーンに削除→再インストール
- 障害の可能性を確認：あなたの環境ではなくOpenAI側の問題かもしれません。障害の確認方法 で切り分けを
- 別の入り口で回避：復旧まで Web版 や VS Code拡張 で作業を続ける
よくある質問（FAQ）
Q. 落ちたとき、書きかけの変更は消えますか？
A. ファイルに保存済みの変更は残ります。適用途中だった差分は中途半端になっている可能性があるので、git status で確認してから作業を再開してください。
Q. 毎回同じところで落ちます
A. 再現性があるのは切り分けのチャンスです。直前に読み込んだファイル・頼んだタスクをメモし、.codexignore で大きなフォルダを除外してから再試行してみてください。それでも再現するならアプリの不具合の可能性が高いです（不具合まとめ）。
Q. メモリはどのくらい積んでいれば安心ですか？
A. 用途によりますが、複数エージェントの並列などヘビーに使うなら余裕を持ちたいところです。目安は 動作環境ガイド にまとめています。
Q. クラッシュレポートは送るべきですか？
A. 送って問題ありません。不具合修正の材料になります。ただし送信しても即座に解決するわけではないので、この記事の対処を並行して進めましょう。
Q. 落ちる頻度が最近増えました
A. アプリ・CLIの更新を確認し（アップデート方法）、プロジェクトが育って読み込み量が増えていないか .codexignore を見直してください。それでも改善しなければ環境のクリーンな入れ直しを。
まとめ
「落ちる」ときは、まずアプリだけか・CLIか・PCごとかを切り分け。アプリなら更新と不具合情報の確認、CLIならエラー文とNode環境、PCごとなら資源の限界を疑う——が基本ルートです。共通の根本対策は .codexignore での軽量化と、gitによる保険。
関連記事：起動しないときの対処 / 重いときの軽量化ガイド / トラブル総合ガイド
