トラブルシューティング¶

よくある質問¶

Codex が編集していないファイルがサイドパネルに表示される¶

プロジェクトが Git リポジトリ内にある場合、レビューパネルには、Codex が行っていない変更も含め、プロジェクトの Git の状態に基づいた変更が自動的に表示されます。

レビューペインでは、ステージ済みの変更と、まだステージされていない変更を切り替えたり、ブランチと main を比較したりできます。

直前の Codex のターンで行われた変更だけを表示するには、差分ペインを Last turn ビューに切り替えます。

サイドバーからプロジェクトを削除する¶

サイドバーからプロジェクトを削除するには、プロジェクト名にカーソルを合わせ、 3 つのドットをクリックして「Remove」を選択します。復元するには、 Chats の横にある Add new project ボタンを使用するか、次の操作でプロジェクトを再度追加します。

Cmd+O.

アーカイブ済みのチャットを見つける¶

アーカイブ済みのチャットは Settings にあります。チャットのアーカイブを解除すると、元のサイドバーの位置に再び表示されます。

サイドバーに一部のチャットしか表示されない¶

サイドバーでは、プロジェクトの状態に基づいてチャットを絞り込めます。チャットが見つからない場合は、Chats の横にあるフィルターアイコンを選択し、 Chronological を選択します。それでもチャットが表示されない場合は、 Settings を開き、Archived chats を確認します。

コードが worktree で実行されない¶

Worktree は別のディレクトリに作成され、デフォルトでは Git にチェックインされたファイルを継承します。プロジェクトの依存関係とツールを管理する方法によっては、ローカル環境を使用して worktree でセットアップスクリプトを実行するか、 .worktreeinclude を使用して無視されたセットアップファイルをコピーする必要があります。または、通常のローカルプロジェクトで変更をチェックアウトできます。詳しくは worktree のドキュメントをご覧ください。

アプリがチームメイトの共有ローカル環境を認識しない¶

ローカル環境の設定は、プロジェクトのルートにある .codex フォルダー内に配置する必要があります。複数のプロジェクトを含むモノレポで作業している場合は、 .codex フォルダーが含まれるディレクトリでプロジェクトを開いていることを確認します。

Codex が Apple Music へのアクセスを要求する¶

タスクによっては、Codex がファイルシステム内を移動する必要があります。macOS 上の Music、Downloads、Desktop などの一部のディレクトリでは、ユーザーによる追加の承認が必要です。Codex がホームディレクトリを読み取る必要がある場合、macOS はこれらのフォルダーへのアクセスを承認するよう求めます。

スケジュール済みタスクによって多数の worktree が作成される¶

スケジュール済みタスクを頻繁に実行すると、時間の経過とともに多数の worktree が作成されることがあります。不要になったスケジュール済みの実行をアーカイブし、 worktree を保持する意図がない限り、実行をピン留めしないでください。

間違ったターゲットを選択した後にプロンプトを復元する¶

誤って間違ったターゲット（Local、Worktree、または Cloud）でチャットを開始した場合は、現在の実行をキャンセルし、コンポーザーで上矢印キーを押して以前のプロンプトを復元できます。

機能が Codex CLI では動作するが ChatGPT デスクトップアプリでは動作しない¶

ChatGPT デスクトップアプリと Codex CLI には異なる Codex バージョンが含まれる場合があるため、一方の環境に先に機能が提供されることがあります。実験的な機能も Codex CLI に先に導入される場合があります。

システム上の Codex CLI のバージョンを取得するには、次を実行します。

codex --version

ChatGPT デスクトップアプリに含まれる Codex のバージョンを取得するには、保持されている Codex.app 互換バンドルパスを使用します。

/Applications/Codex.app/Contents/Resources/codex --version

フィードバックとログ¶

メッセージコンポーザーに / と入力すると、チームにフィードバックを送信できます。既存のチャットでフィードバックを送信する場合は、フィードバックと一緒に既存のセッションを共有することを選択できます。フィードバックを送信すると、チームと共有できるセッション ID が届きます。

問題を報告するには、次の手順を実行します。

Codex GitHub リポジトリで既存の問題を探します。
新しい GitHub issue を開く

その他のログは、次の場所で確認できます。

アプリのログ（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 の作成をキャンセルしてプロンプトを失った場合は、コンポーザーで上矢印キーを押して復元します。

ターミナルの問題¶

ターミナルがハングしているように見える

ターミナルパネルを閉じます。
Ctrl+` で再度開きます。
pwd または git status のような基本的なコマンドを再実行します。

コマンドが予想と異なる動作をする場合は、まずターミナルで現在のディレクトリとブランチを確認してください。

それでもハング状態が続く場合は、アクティブなチャットが完了するまで待ってから、アプリを再起動してください。

フォントが正しく表示されない

Codex は、レビューペイン、統合ターミナル、その他アプリ内に表示されるコードで同じフォントを使用します。フォントは Settings ペインの Code font で設定できます。