Troubleshooting

概要

ChatGPT desktop app を中心とした Codex のよくある症状と、ログの場所・復旧手順。

仕様

よくある症状

症状	内容
Codex が編集していないファイルがサイドパネルに出る	プロジェクトが Git リポジトリ内にある場合、レビューパネルは Codex 以外の変更も含めてプロジェクトの Git 状態に基づいて表示する。レビューペインでステージ済み／未ステージの切り替え、main との比較ができる。直近の Codex のターンの変更だけを見るには diff ペインを Last turn 表示にする
プロジェクトをサイドバーから消したい	プロジェクト名にホバーして三点メニューから Remove。戻すには Chats の隣の Add new project か `Cmd+O`
アーカイブしたチャットの場所	Settings にある。アンアーカイブすると元のサイドバー位置に戻る
一部のチャットしか出ない	サイドバーはプロジェクトの状態でチャットを絞り込む。Chats の隣のフィルタアイコンから Chronological を選ぶ。それでも見つからないときは Settings の Archived chats を確認する
worktree でコードが動かない	worktree は別ディレクトリに作られ、既定では Git にチェックインされたファイルだけを引き継ぐ。local environment のセットアップスクリプトを走らせるか、`.worktreeinclude` で ignore されたセットアップファイルをコピーする。あるいは通常のローカルプロジェクトで変更を checkout する
チームメイトが共有した local environment を認識しない	local environment の設定はプロジェクトルートの `.codex` フォルダの中になければならない。複数プロジェクトの monorepo では、`.codex` フォルダを含むディレクトリでプロジェクトを開く
Codex が Apple Music へのアクセスを求める	タスクによってはファイルシステムを辿る必要がある。macOS の Music / Downloads / Desktop などのディレクトリは追加の承認が要る。ホームディレクトリを読む必要があるとき macOS がアクセス承認を求める
scheduled tasks が worktree を大量に作る	頻繁な scheduled task は時間とともに多くの worktree を作る。不要な実行はアーカイブし、worktree を残す意図が無ければ pin しない
対象（Local / Worktree / Cloud）を間違えた	実行をキャンセルし、composer で上矢印キーを押すと前のプロンプトを復元できる
CLI では動く機能が desktop app では動かない	ChatGPT desktop app と Codex CLI は異なる Codex バージョンを含みうるため、機能が片方に先に届くことがある。実験的機能は Codex CLI に先に入ることもある

バージョンの確認:

codex --version

# ChatGPT desktop app にバンドルされた Codex のバージョン
# 互換のために残されている Codex.app のパスを使う
/Applications/Codex.app/Contents/Resources/codex --version

フィードバックとログ

composer に / を打つとフィードバックを送れる。既存チャットから起動した場合、そのセッションを添えるか選べる。送信後にチームと共有できる session ID を受け取る
課題の報告は Codex の GitHub リポジトリの既存 issue を探してから新規 issue を開く

ログの場所:

種類	場所
App logs（macOS）	`~/Library/Logs/com.openai.codex/YYYY/MM/DD`
セッションのトランスクリプト	`$CODEX_HOME/sessions`（既定 `~/.codex/sessions`）
アーカイブしたセッション	`$CODEX_HOME/archived_sessions`（既定 `~/.codex/archived_sessions`）

ログを共有する前に、機微情報が含まれていないか確認する

停止状態からの復旧

チャットが止まって見えるとき:

Codex が承認を待っていないか確認する
ターミナルを開いて git status のような基本コマンドを実行する
より小さく焦点を絞ったプロンプトで新しいチャットを始める

worktree の作成を誤ってキャンセルしてプロンプトを失った場合、composer で上矢印キーを押すと復元できる

ターミナルの問題

ターミナルが止まって見えるとき:

ターミナルパネルを閉じる
`Ctrl+`` で開き直す
pwd や git status のような基本コマンドを再実行する

コマンドの挙動が想定と違う場合、まずターミナルで現在のディレクトリとブランチを確認する
それでも止まったままなら、実行中のチャットが終わるのを待ってアプリを再起動する

フォントが正しく描画されないとき:

レビューペイン、統合ターミナル、アプリ内のコード表示は同じフォントを使う。Settings の Code font で設定する

Troubleshooting

概要

仕様

よくある症状

フィードバックとログ

停止状態からの復旧

ターミナルの問題

関連