トラブルシューティング

よくある質問

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

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

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

直前の Codex ターンによる変更だけを確認するには、差分ペインを 直前のターン 表示に切り替えます。

レビューペインの使い方について詳しく見る。

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

サイドバーからプロジェクトを削除するには、プロジェクト名にカーソルを合わせ、三点メニューを選択して、削除 を選びます。復元するには、 チャット の横にある新しいプロジェクトを追加 ボタンを使ってプロジェクトを再追加するか、次のショートカットを使います。

Cmd+O を使用してプロジェクトを再度追加します。

アーカイブ済みチャットを探す

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

Work の会話が別のデバイスに表示されない

• 各デバイスで、ChatGPT を使って同じアカウントとワークスペースにサインインしていることを確認してください。
• ワークスペースの所有者に、Work Cloud とローカルコンピューターへのアクセスを許可 が有効になっているか確認してもらってください。いずれかのクラウドポリシーで enforce_residency が有効になっている場合、Work と dots の両方でローカルコンピューターへのアクセスを許可 が無効になります。この保護措置は、ワークスペースのデータレジデンシーを設定するものではなく、それ自体で Work Cloud や dots を無効にするものでもありません。
• タスクが作成された時期を確認してください。同期は、有効化後に新しく作成されたタスクに適用されます。プロジェクト内のタスクを含む既存のタスクは移行されず、ローカルのみで動作するか、ローカルファイルにアクセスせずにクラウドで動作するという元の動作を維持します。

企業向けでは、提供開始時点でアプリ内のローカル/クラウド切り替えとそのデフォルト設定は変更されません。切り替えの状態やデフォルトモードだけでは、会話を同期できるかどうかは判断できません。Work の会話を探す際は、Codex の履歴と区別してください。設定方法については Work Cloud と dots のローカルコンピューターアクセス、よくある質問については Work 管理者向け FAQを参照してください。

同期されたタスクでコンピューターのファイルやツールを使用できない

コンピューターをオンラインにし、接続を維持してください。新しいターンの開始時にコンピューターを利用できない場合、対象となる同期済みタスクは、コンピューターのファイルやツールにアクセスせずにクラウドコンテナーで続行できます。実行中のターンがコンピューターからクラウドへ自動的に移動することはありません。

Work Cloud でのローカルコンピューターアクセスをオフにした後、ターンが停止した

Work Cloud でのローカルコンピューターアクセスをオフにすると、実行中のターンが中断されます。引き続き Work へのアクセス権がある場合は、新しいメッセージを送信して別のターンを開始してください。既存のクラウド上の会話では、そのターンはローカルファイルにアクセスせずに、自動的に Work Cloud を使用します。

自動化されたポリシー更新が反映されない

Global 設定を管理するには、ポリシー API を使用してください。Local または Codex Cloud の設定を管理するには、Agent Security UI を使用してください。既存の Global API ワークフローは、移行後も引き続き利用できます。スクリプトと Terraform 連携をテストし、ポリシーの割り当てと順序が変わっていないことを確認してください。

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

サイドバーでは、プロジェクトの状態に基づいてチャットを絞り込めます。チャットが見つからない場合は、チャット の横にあるフィルターアイコンを選択し、 時系列順 を選択します。それでもチャットが表示されない場合は、 設定を開いて アーカイブ済みチャット を確認してください。

ワークツリーでコードが実行されない

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

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

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

Codex が Apple Music へのアクセスを求める

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

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

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

誤った対象を選択した後にプロンプトを復元する

誤って不適切な対象（ローカル、ワークツリー、クラウド）でチャットを開始した場合は、現在の実行をキャンセルし、入力欄で上矢印キーを押すと以前のプロンプトを復元できます。

「承認を任せる」が表示されない、または無効になっている

自動レビューを使用するには、入力欄の下にある権限コントロールから 承認を任せる を選択します。このモードが表示されない、または無効になっている場合は、次の手順を確認してください。

1. デスクトップアプリを更新し、自動レビューを使用したいチャットの権限メニューを確認します。選択できる項目は、ローカル環境とクラウド環境で異なる場合があります。
2. Codex をローカルで実行する場合は、実際に適用されている設定に features.guardian_approval = false が明示的に指定されていないか確認し、設定されている権限プロファイル、承認ポリシー、承認レビュアーを確認します。設定の優先順位については、設定の基本を参照してください。ローカル設定は、管理対象のクラウドランタイムには適用されません。
3. 管理対象のワークスペースでモードが無効になっている、または表示されない場合は、許可されている権限プロファイル、サンドボックスモード、承認ポリシー、承認レビュアーを確認するよう管理者に依頼してください。組織やデバイスのポリシーにより、これらの選択肢が制限されることがあります。ローカル設定でその制限を上書きすることはできません。

それでもモードを利用できず、原因が不明な場合は、アプリのバージョン、オペレーティングシステム、実行環境、および選択肢が表示されないのか無効になっているのかをフィードバックに記載してください。

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

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

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

codex --version

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

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

フィードバックとログ

メッセージ入力欄に / と入力すると、チームにフィードバックを送信できます。既存のチャットでフィードバックを開始した場合は、フィードバックとともに既存のセッションを共有するかどうかを選択できます。フィードバックを送信すると、チームと共有できるセッション ID が発行されます。

問題を報告するには、次の手順に従います。

1. Codex の GitHub リポジトリで既存の Issueを探します。
2. 新しい GitHub Issue を作成します

その他のログは、次の場所にあります。

• アプリログ（macOS）：~/Library/Logs/com.openai.codex/YYYY/MM/DD
• セッショントランスクリプト：$CODEX_HOME/sessions（デフォルト：~/.codex/sessions）
• アーカイブ済みセッション：$CODEX_HOME/archived_sessions（デフォルト：~/.codex/archived_sessions）

ログを共有する場合は、機密情報が含まれていないことを事前に確認してください。

停止状態と復旧方法

チャットが停止しているように見える場合は、次を試してください。

1. Codex が承認を待っていないか確認します。
2. ターミナルを開き、git status などの基本的なコマンドを実行します。
3. より小さく焦点を絞ったプロンプトで新しいチャットを開始します。

誤ってワークツリーの作成をキャンセルしてプロンプトを失った場合は、入力欄で上矢印キーを押すと復元できます。

ターミナルの問題

ターミナルが停止しているように見える

1. ターミナルパネルを閉じます。
2. Ctrl+` で再度開きます。
3. pwd や git status などの基本的なコマンドを再実行します。

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

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

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

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

環境でネットワークアクセスが許可されているのにアクションがブロックされる

個々の設定を比較する前に、ポリシーの優先順位を確認してください。優先順位の低いポリシーのほうが具体的であっても、優先順位の高いポリシーが優先されます。1 つのポリシー内では、OS 固有の環境オーバーライドが全 OS 共通の環境オーバーライドより優先され、その次に Global が適用されます。

ネットワーク要件の一部には、フィールド固有のマージルールとランタイムの制限があります。管理対象の HTTP/SOCKS リスナーポートと、ループバック以外のプロキシリスナーは、クラウドランタイムではサポートされません。ソケットルールのサポートは実行経路によって異なります。ローカル実行時のマージ動作は別に定められています。

実際に適用されるポリシーを比較し、想定どおりにアクションが許可またはブロックされるかをテストしてください。詳しいケースについては、管理対象の設定を参照してください。テストの失敗を回避するために、グローバルな基準設定の許可範囲を広げないでください。