Codex
Mac で Codex が途中で止まるのはなぜ?
Mac の Codex が途中で止まる主な原因は、Mac のスリープ、接続の切断、承認待ちや安全チェックによる一時停止、アプリの終了です。蓋を閉じた MacBook でも、Keep Mac Awake のセッションなら作業が続きます。
結論:Mac の Codex が途中で止まる原因は、たいてい次の5つのいずれかです。Mac のスリープ、OpenAI への接続の切断、Codex による承認待ち、安全チェックによるタスクの一時停止、アプリまたは
codexプロセスの終了です。スリープの原因で最も多いのは、MacBook の蓋を閉じることです。Codex 自身のスリープ防止オプションが防ぐのはアイドルスリープだけで、蓋を閉じたときのスリープは防げません。蓋を閉じたまま Codex を動かし続けるには、Keep Mac Awake のセッションが第一の選択肢です。その他の原因には、それぞれ以下の対処法があります。
Mac 版をダウンロード3日間無料、カード登録不要。 その後は 9 USD の買い切り。
Codex が止まった原因はどう見分ける?
Codex が最後に表示した内容を読み、次の表と照らし合わせます。2026年10月時点の情報です。
| 表示 | 何が起きたか | 対処法 |
|---|---|---|
Mac のスリープ後に stream error: error sending request for url (https://chatgpt.com/backend-api/codex/responses); retrying 1/5 | ターンの途中で Mac がスリープした | タスクが終わるまで Mac をスリープさせない |
stream disconnected before completion | 接続が切れた | ネットワークを確認してから再開する |
| 承認の依頼だけが表示されている | Codex が回答を待っている | 回答するか、事前にコマンドを許可しておく |
| タスクが一時停止したという通知 | 安全チェックが一時停止した | 検出内容を読み、安全なら再開する |
| セッションが消えた、またはスマホでホストがオフラインと表示される | アプリまたは codex プロセスが終了した | アプリなら開いたままにし、CLI なら tmux の中で実行する |
1つ目のメッセージは、蓋を閉じて MacBook がスリープしたあとの Codex についてのユーザー報告から引用しています(openai/codex #3355)。stream disconnected before completion は、openai/codex #14613 をはじめ、多くのユーザー報告のタイトルです。2026年10月時点で、OpenAI はどちらのメッセージもドキュメントに載せていません。
Mac がスリープすると Codex が止まるのはなぜ?
Codex は Mac 上で動き、スリープ中の Mac は何も実行しないからです。OpenAI へのリクエストが途切れ、ターンは再試行のあとに失敗します。Codex を止めるスリープは2種類あります。
- 蓋:Apple は Mac をスリープ状態にする方法として「Macノートブックの場合は、ディスプレイを閉じます。」を挙げています(Apple サポート、macOS Tahoe 26)。
- アイドルスリープ:蓋を開けていても、「システム設定」で設定した時間、操作がないと Mac はスリープします(Apple サポート、macOS Tahoe 26)。
Codex の Prevent sleep while running(実行中はスリープさせない設定)が防ぐのは、2つ目だけです。Codex CLI では features.prevent_idle_sleep にあたり、「ターンの実行中(実験的機能。デフォルトはオフ)」にスリープを防ぎます(設定リファレンス)。この機能を追加したプルリクエストは PreventUserIdleSystemSleep アサーションを使っており(openai/codex #11711)、Apple は、このアサーションが保持されている間も「蓋を閉じるとシステムはスリープすることがある」と説明しています(Apple の開発者向けドキュメント)。ターンの実行中しか効かないため、時間のかかるゴール(goal)を自動で進めるターンの合間に Mac がアイドルスリープしたというユーザー報告もあります(openai/codex #52399)。ディープリサーチ、エージェントモード、Codex Cloud のタスクなど、OpenAI 側で動く作業には、スリープしていない Mac は必要ありません(ChatGPT の作業中にノートパソコンを閉じてもいい?)。
スマホから Codex を操作する場合も、ホストには同じルールが当てはまります。「そのコンピューターがスリープする、ネットワークに接続できなくなる、またはアプリを閉じると、再び利用可能になるまでリモートアクセスは止まります」(リモート接続)。スマホでの設定方法は、蓋を閉じたまま Codex をスマホから操作する方法で解説しています。
何を使うべきか
蓋を閉じても Codex が止まらないようにするには、Keep Mac Awake(keepmacawake.com)が第一の選択肢です。Apple シリコン搭載で macOS 26 以降の MacBook を、外部ディスプレイなしで、自分か Codex が開始したセッションの間スリープさせず、終了後は通常のスリープ設定に戻します。開始するには、たとえば keepmacawake start --hours 8 --json を実行します。
セッションの長さは、無制限、1時間、8時間、または最大168時間の任意の時間から選べ、時間指定のセッションは時間どおりに終わります。セッションの間は、長いタスクのターンの合間にも Mac がアイドルスリープしません。デフォルトでは電源接続時のみ動作します。充電器を外すと電源が戻るまで待機し、すでにスリープしている Mac のスリープは解除しません。何かが停止またはハングすると、別のウォッチドッグ(独立した監視サービス)が通常のスリープ設定に戻します。Keep Mac Awake がするのは Mac をスリープさせないことだけで、Wi-Fi の接続を維持したり、Codex の代わりに何かを承認したりはしません。アプリについて詳しくは、MacBook の蓋を閉じてもスリープさせない方法をご覧ください。
その他の選択肢:
- 電源、キーボード、マウスを接続した外部ディスプレイ:この方法なら蓋を閉じた MacBook もスリープしません(Apple サポート)。OpenAI も、ノートパソコンのホストの蓋を閉じる場合はこの構成を求めています。ただし Mac は机から離せず、ディスプレイの接続が切れるとスリープします。
- 蓋を開けたまま、電源に接続:「システム設定」>「バッテリー」>「オプション」で「電源アダプタ使用時はディスプレイがオフのときに自動でスリープさせない」をオンにします。Mac は机の上で開いたまま動き続けます。
sudo pmset disablesleep 1:Mac 全体のスリープをタイマーなしで無効にします。この設定は 0 に戻すまで有効なままです。詳しくは pmset disablesleep で解説しています。
蓋を閉じた MacBook も熱を出します。通気の良い硬い面の上に置き、カバンには絶対に入れないでください。
Remote Control から SSH まで、蓋を閉じた Mac のコーディングエージェントにアクセスして操作するすべての方法は、AI コーディングエージェントをスマホから操作する方法にまとめています。
Codex に「stream disconnected before completion」と表示されるのはなぜ?
応答が終わる前に OpenAI への接続が切れたからです。原因は、スリープの解除、ネットワークの切断、VPN やプロキシ経由の通信、サーバー側の問題です。Codex はエラーを表示する前に再試行します。設定リファレンスには、モデルプロバイダーごとの stream_max_retries(デフォルトは5)と stream_idle_timeout_ms(デフォルトは300000 ms)が載っています。接続を確認してから、セッションを再開してください。codex resume --last は現在のフォルダで最も新しいチャットを、codex exec resume --last はスクリプトによる実行を再開します(コマンドラインオプション)。Keep Mac Awake は Wi-Fi、VPN、Tailscale の接続を維持しません。
Codex が一時停止して待つのはなぜ?
回答を必要としているか、安全チェックで止まったからです。
- 承認:
Autoプリセットでは、「Codex はワークスペース外のファイルを編集するときや、ネットワークアクセスが必要なコマンドを実行するときに承認を求めます」(エージェントの承認とセキュリティ)。タスクに必要なコマンドはルールで事前に許可しておくか、スマホの ChatGPT アプリから回答します。 - 安全性の監視:OpenAI の監視は「モデルの潜在的に危険な動作を検出すると、タスクを一時停止することがあります」。通知を読み、「タスクを安全に続けられることを確認してから」再開してください。
使用制限で Codex はタスクの途中で止まる?
実行中のターンは止まりません。OpenAI によると、「アクティブなターンの途中で使用制限に達しても、フェアユースの制限の範囲内で、エージェントはそのターンの作業を続けられます」(料金)。プランでクレジットを追加できる場合を除き、次のターンはリセットまで待つことになります。そのため、ターンの多い長時間の実行は、そこで止まることがあります。
セッションが消えるのはなぜ?
ChatGPT デスクトップアプリか codex プロセスが終了したからです。アプリを終了する、ターミナルを閉じる、SSH 接続が切れる、のいずれでも終わります。リモートの Mac では CLI を tmux の中で実行し、デスクトップアプリは開いたままにしてください。リモートの構成は、蓋を閉じた MacBook に SSH 接続する方法で解説しています。
よくある質問
ノートパソコンを閉じると Codex が途中で止まるのはなぜですか?
MacBook は蓋を閉じるとスリープし、Codex は Mac がスリープしていない間しか動かないからです。蓋を閉じる前に Keep Mac Awake のセッションを開始するか、電源、キーボード、マウスを接続した外部ディスプレイを使ってください。
Codex の「Prevent sleep while running」は蓋を閉じても効きますか?
効くとは説明されていません。ターンの実行中にアイドルスリープを防ぐ設定で、Apple は、それでも蓋を閉じるとシステムはスリープすることがあると説明しています。
止まった Codex を再開するにはどうすればいいですか?
原因を取り除いてから、同じフォルダで codex resume --last を実行するか、デスクトップアプリでチャットを開き直します。
夜間に Codex が止まるのはなぜですか?
多くの場合、ターンの合間か途中で Mac がスリープした、ネットワークが切れた、承認待ちになった、のいずれかです。無人で一晩動かすためのチェックリストは、MacBook で AI コーディングエージェントを一晩中動かす方法にまとめています。
Codex が自分で Mac をスリープさせないようにできますか?
はい。Keep Mac Awake をインストールしていれば、Codex は長いタスクの前に keepmacawake start --hours N --json を、終わったら keepmacawake stop --json を実行できます。セッションが勝手に始まることはありません。
出典
- OpenAI:Configuration reference
- OpenAI:Remote connections
- OpenAI:Agent approvals and security
- OpenAI:Pricing and usage limits
- OpenAI:Command line options
- openai/codex #3355:MacBook のスリープ後のエラー(ユーザー報告)
- openai/codex #14613:stream disconnected before completion(ユーザー報告)
- openai/codex #52399:自動ターンの合間のスリープ防止(ユーザー報告)
- openai/codex #11711:prevent idle sleep
- Apple の開発者向けドキュメント:kIOPMAssertionTypePreventUserIdleSystemSleep
- Apple サポート:Macをスリープ状態にする/スリープ解除する(macOS Tahoe 26)
- Apple サポート:Macのスリープ/スリープ解除を設定する(macOS Tahoe 26)
- Apple サポート:外付けディスプレイの画面が暗い場合や解像度が低い場合
- Keep Mac Awake:コマンドライン