Codexデスクトップアプリは初心者に最もおすすめの使い方ですが、アプリならではの不具合もあります。この記事では、デスクトップアプリ固有のよくある症状10個と解決方法を、症状別にまとめました。
この記事でわかること
- ✅ アプリ固有の不具合10症状の対処（起動・ログイン・通知・権限ほか）
- ✅ Mac／Windowsそれぞれの注意ポイント
- ✅ 直らないときのリセット手順と回避ルート
⚠️ 本記事は OpenAI 公式とは無関係の解説記事です。障害情報は OpenAI Status を確認してください。
1. アプリが起動しない・すぐ落ちる
最頻出の症状。完全終了→再起動→OS再起動が基本で、セキュリティ許可（Macの「開発元確認」／WindowsのSmartScreen）や再インストールで解決します。
→ 詳しい手順は専用記事で：起動しない場合のチェックリスト（本サイト内「起動しない」記事）※未読なら トラブル総合ガイド からどうぞ
2. ログイン画面がループする
サインインしても同じ画面に戻る場合：
- アプリを完全終了して再起動
- 既定ブラウザのキャッシュ・Cookieをクリア
- 別ブラウザを既定にして再試行
- それでもダメなら
~/.codexを退避して再ログイン
→ 認証系の詳細は ログイン・認証エラーの対処
3. 通知が来ない（タスク完了に気づけない）
並列運用の要である通知が来ないと不便です。
- Mac：システム設定 → 通知 → Codex → 通知を許可
- Windows：設定 → システム → 通知 → Codex をオン
- OSの集中モード／応答不可がオンになっていないかも確認
- アプリ内の通知設定も別途あるため、両方オンに
4. エージェントが「考え中」のまま固まる
- まず数分待つ（重いタスクは時間がかかる。異常ではないことが多い）
- 5分以上無反応なら、そのエージェントだけ停止して再実行
- 大きなプロジェクトを開いている場合は
.codexignoreで除外を（遅い・固まるの対処） - 複数エージェント並列中はリソース枯渇の可能性。並列数を減らす（複数エージェント管理）
5. 「権限がありません」系のエラー（Mac）
Appshots・Computer Use などアプリの目玉機能は、macOSの権限が必要です。
- システム設定 → プライバシーとセキュリティ
- 画面収録 → Codex を許可
- アクセシビリティ → Codex を許可
- 許可後、アプリを再起動（再起動しないと反映されないことが多い）
→ 機能の詳細は Appshots・Computer Use
6. プロジェクトフォルダが開けない・読み込めない
- フォルダのアクセス権を確認（外付けドライブ・クラウド同期フォルダは要注意）
- OneDrive/iCloud等の「オンラインのみ」ファイルは実体がなく読めないことがある → 「常にこのデバイスに保持」に変更
- パスに特殊文字が多い場合はシンプルな場所（例：
~/projects/）に移して試す
7. 差分（diff）が適用されない
- 対象ファイルがエディタで未保存のまま開かれている → 保存 or 閉じて再試行
- ファイルが読み取り専用になっていないか
- 提案が古くなった場合は「もう一度提案して」で新しいdiffを生成
8. タブ・エージェントを増やすと重くなる
- 使い終わったタブは閉じる（バックグラウンドでもメモリを使う）
- 並列は2〜3個からが安全圏
- PCのメモリ使用率を確認（アクティビティモニタ／タスクマネージャー）
9. アップデート後に調子が悪い
新バージョン直後に稀にあります。
- 再ログイン（これでほぼ解決）
- 設定リセット（
~/.codex退避 → 再ログイン） - 既知の不具合なら次の更新で直ることが多い。数日待つのも手
10. Windows特有：WSL連携がうまくいかない
- WSL2が最新か確認：
wsl --update - WSL側のパス指定（
\\wsl$\...）が正しいか - WSLを再起動：
wsl --shutdown→ 再度開く
→ Windows環境の詳細は Windows版ガイド
最終手段：アプリの完全リセット
どうしても直らないときの「工場出荷状態」手順です。
- アプリを完全終了
- アプリ本体をアンインストール
- 設定フォルダを削除（Mac:
~/Library/Application Support/Codexと~/.codex／ Windows:%APPDATA%\Codexと%USERPROFILE%\.codex） - PC再起動 → 最新版を入れ直し → ログイン
作業を止めたくない間は Web版 で回避できます（同じアカウントで連携）。
よくある質問（FAQ）
Q. 不具合の報告はどこにすればいい？
A. アプリ内のフィードバック機能、または公式のヘルプから。バージョン番号（Aboutで確認）を添えると伝わりやすいです。
Q. Mac版とWindows版で不具合の傾向は違いますか？
A. 共通が大半ですが、Macは権限（画面収録・アクセシビリティ）、WindowsはSmartScreenとWSL連携が固有のつまずきポイントです。
Q. アプリが不安定なのでCLIに移るべき？
A. 移行は簡単ですが（同じアカウント）、まず本記事のリセット手順を。安定後は併用が最強です（使い分けガイド）。
Q. 複数エージェントの1つだけ様子がおかしい
A. そのエージェント（タブ）だけ閉じて開き直せばOK。全体を再起動する必要はありません。
Q. 会社のPCでだけ不具合が出ます
A. プロキシ・セキュリティソフト・権限制限が原因のことが多いです。ネットワークエラーの対処 で切り分けを。
まとめ
デスクトップアプリの不具合は、完全終了→再起動・再ログイン・OS権限の許可の3点でほとんどが解決します。直らないときは完全リセット、急ぎは Web版 で回避を。
アプリの基本や活用術は デスクトップアプリ完全ガイド・活用術 を、他の症状は トラブルシューティング総合ガイド をどうぞ。
