【完全解決】ChatGPT(Codex) Macアプリのフリーズ＆AppShot不具合を自力で直すデバッグ手順

今回は長時間の作業をコーデックスにさせている途中にアプリのアップデートが来てそれから特定のチャットに入ると必ずフリーズするという現象がまず発生して、不具合ならアップデートが来るだろうとアプリショットなどの便利機能が封印された状態で数日間利用、そしてそれがなかなか治らないなと思っていた所でgpt自身にデバッグして貰えばいいじゃないと思いつきチャットで指示してみたところ見事成功、こういうのって本職の人以外だと結構慌てる事が多いというかこういう事があってITツールを挫折するという経験は昔からあるものです。

なので今回は普通にAI使ってる副業属性やフリーランス属性の方向けにどうやって解決したかを仕分けリストを入れて共有します、サムネはなんだかこのテイストジェミニくんが気に入ってるんですかね・・・？

以下は「図解入り・そのまま保存版」です。Notion、Google Docs、社内Wiki、チャット引き継ぎメモに貼りやすい形にしています。

GPT/Codexアプリ不具合 診断・リカバリー手順

対象：

• ChatGPT / Codex デスクトップアプリ
• 特定チャットのフリーズ
• AppShot / Computer Use / 画面取得機能の不具合
• Web版は正常なのにアプリだけ不安定なケース

全体像

```mermaid
flowchart TD
    A["不具合発生"] --> B{"Web版でも起きる？"}
    B -->|はい| C["OpenAI側・アカウント側・モデル側の可能性"]
    B -->|いいえ| D["アプリ側・ローカル状態の可能性"]

    D --> E{"別チャットでは動く？"}
    E -->|はい| F["特定チャットの肥大化/破損を疑う"]
    E -->|いいえ| G["アプリ全体・プロファイル・権限を疑う"]

    F --> H["危険チャットを開かない"]
    H --> I["新チャットへ作業引き継ぎ"]
    H --> J["巨大セッション/Goal/ログを確認"]

    G --> K{"AppShotだけ使えない？"}
    K -->|はい| L["Computer Use補助アプリを確認"]
    K -->|いいえ| M["クリーンプロファイル起動で切り分け"]
```

第1段階: Web版とアプリ版を分ける

まず最初に確認すること：

確認項目	結果	判断
Web版で同じ作業ができる	できる	アプリ側の問題が濃厚
別チャットで作業できる	できる	特定チャットの問題が濃厚
特定チャットに入るだけで固まる	はい	そのチャットは触らない
AppShotだけ動かない	はい	Computer Use補助アプリ/権限を疑う

クリーン起動で確認する場合：

open -na "/Applications/ChatGPT.app" --args --user-data-dir=/tmp/chatgpt-clean-profile

判定：

クリーン起動で安定
=> 通常プロファイル/キャッシュ/ローカル状態が怪しい

クリーン起動でも不安定
=> アプリ本体・アップデート・OS相性が怪しい

Web版は正常
=> モデル本体よりアプリ側問題の可能性が高い

第2段階: 特定チャットだけ固まる場合

今回のように「特定チャットに入るだけで100%フリーズ」する場合は、そのチャットを開かないのが正解です。

```mermaid
flowchart TD
    A["特定チャットを開く"] --> B["数秒〜数十秒でフリーズ"]
    B --> C["会話履歴・Goal状態・ブラウザ状態を復元"]
    C --> D{"復元対象が巨大/破損？"}
    D -->|はい| E["UIが詰まる"]
    D -->|いいえ| F["通常表示"]

    E --> G["対象チャットを開かない"]
    G --> H["新チャットへ要約で引き継ぐ"]
```

確認コマンド：

du -sh ~/.codex/sessions
find ~/.codex/sessions -type f -size +10M -exec ls -lh {} +

巨大ファイルがある場合の見方：

数十MB以上
=> 長い作業チャットの可能性

100MB超え
=> 復元時に重くなる可能性が高い

200MB超え
=> 特定チャットフリーズの有力候補

安全な対応：

削除しない
まず開かない
必要ならアーカイブ
作業は新チャットへ引き継ぐ
履歴丸ごとコピーは避ける

新チャットへの安全な引き継ぎテンプレート

前のチャットが重くなり、開くとアプリが固まるため、新しいチャットで引き継ぎます。

重要:
- 前のチャットを参照しないでください
- 過去ログの復元を試みないでください
- 現在の成果物ファイルを見て進めてください
- 長時間Goalは使わず、小さな単位で進めてください

目的:
〇〇を完成させる

現在の状態:
- 完了済み: 〇〇
- 未完了: 〇〇
- 対象ファイル: 〇〇
- 対象URL: 〇〇

次にやること:
1. 現在ファイルを確認
2. 問題点を整理
3. 小さく修正
4. 動作確認

第3段階: AppShotが使えない場合

AppShotは、内部的にComputer Use補助アプリを使って画面情報を取得します。

```mermaid
sequenceDiagram
    participant User as ユーザー
    participant App as ChatGPT/Codexアプリ
    participant CUA as Computer Use補助アプリ
    participant Target as 対象アプリ Chromeなど

    User->>App: AppShot実行
    App->>CUA: キャプチャ開始要求
    CUA->>Target: 画面/AXテキスト取得
    Target-->>CUA: スクリーンショット + UIテキスト
    CUA-->>App: 結果返却
    App-->>User: AppShotとして添付
```

失敗時のログ例：

start_request_failed:os_status:-600
hadAxText=false
hadScreenshot=false
status=failed

成功時のログ例：

status=success
hadAxText=true
hadScreenshot=true

ログ確認：

rg -n "Appshot capture|computer-use-capture|os_status:-600|hadScreenshot|hadAxText" \
~/Library/Logs/com.openai.codex/2026/07/14

今回の原因

```mermaid
flowchart LR
    A["AppShot失敗"] --> B["ログ: os_status:-600"]
    B --> C["Computer Use補助アプリ呼び出し失敗"]
    C --> D["ローカルコピーを確認"]
    D --> E["SkyComputerUseClient.app が欠けていた"]
    E --> F["最新版をコピーし直す"]
    F --> G["AppShot復旧"]
```

壊れていた場所：

~/.codex/computer-use/Codex Computer Use.app

最新版の元：

~/.codex/plugins/cache/openai-bundled/computer-use/<version>/Codex Computer Use.app

復旧方針：

1. 既存の補助アプリをバックアップ
2. 最新プラグインキャッシュからコピーし直す
3. SkyComputerUseClient.app が存在するか確認
4. AppShotを再実行
5. ログで success を確認

macOS権限も確認する

AppShot/Computer Useがうまく動かない時は、ここも見ます。

```mermaid
flowchart TD
    A["システム設定"] --> B["プライバシーとセキュリティ"]
    B --> C["アクセシビリティ"]
    B --> D["画面収録とシステムオーディオ録音"]

    C --> E["ChatGPT"]
    C --> F["Codex Computer Use"]
    C --> G["SkyComputerUseClient"]

    D --> H["ChatGPT"]
    D --> I["Codex Computer Use"]
    D --> J["SkyComputerUseClient"]
```

対応：

許可がOFF
=> ONにする

すでにONだが動かない
=> OFF → ON

項目がない
=> AppShotを再実行して許可ダイアログを出す

それでも出ない
=> 補助アプリのローカルコピー破損を疑う

診断チェックリスト

症状	疑う場所	対応
Web版は正常、アプリだけ固まる	アプリローカル状態	クリーン起動
特定チャットだけ固まる	巨大セッション/Goal復元	開かずに新チャットへ移行
別チャットは動く	問題は局所的	危険チャットを隔離
AppShotだけ失敗	Computer Use補助アプリ	ログ確認、補助アプリ再コピー
os_status:-600	補助アプリ呼び出し失敗	SkyComputerUseClient確認
hadScreenshot=true	画像取得成功	復旧済み
hadAxText=true	UIテキスト取得成功	復旧済み

再発防止ルール

長時間Goalを1チャットで走らせ続けない
重い作業は小さなタスクに分ける
チャットが長くなったら引き継ぎ要約を作る
巨大HTMLやログを丸ごと貼らない
古い危険チャットは開かない
成果物ファイルベースで新チャットに移る

最終まとめ

今回の不具合は2系統でした。

1. 特定チャットのフリーズ
   原因候補:
   - 長時間Goal
   - 巨大セッション
   - ブラウザ/作業状態の復元
   - 過去ワークスペース監視失敗

   対応:
   - そのチャットを開かない
   - 新チャットへ要約で引き継ぐ
   - 必要ならアーカイブ

2. AppShot不能
   原因:
   - Computer Use補助アプリのローカルコピー破損
   - SkyComputerUseClient.app が欠落

   対応:
   - 補助アプリをバックアップ
   - 最新版からコピーし直し
   - AppShot再実行
   - ログで success 確認

今回の復旧成功条件：

AppShot capture settled
status=success
hadAxText=true
hadScreenshot=true

この形で残しておけば、次にアプリ不具合が起きた時も「Web版との差分」「特定チャットかどうか」「AppShot/Computer Use単体かどうか」を順番に見れば、かなり落ち着いて復旧できます。

この通りにやればというかgptが動かない場合、他のツールを使って調べる、対象のチャットを見極めるみたいな所で自分でやろうとしなくてもこの記事を読み込ませれば解決策はAIが出してくれるはず、なので必要な仕事はなんだろうと改めてその辺考えつつ作業に向き合いましょう。

ではまた