OpenAI の公式の説明（下の「公式のページ」）を、内容を足さずに読みやすい日本語に書き直したものです。公式の翻訳ではなく、OpenAI が作ったものでもありません。公式は予告なく変わるので、使う前に公式のページもご覧ください。
このページで分かること
- ChatGPT デスクトップアプリで Codex を使っていて、会話が止まった・ターミナルが動かない・会話が見つからないときに、公式が挙げている確かめ方
- 間違えて取り消した指示の文を取り戻す方法
- 不具合を開発チームに知らせる方法と、記録（ログ）の置き場所
先に知っておく言葉
- 会話（chat）：ChatGPT や Codex とやり取りを保存しておく場所
- プロジェクト：関係する会話と資料をまとめたもの、またはファイルを使う作業のためのパソコンの中のフォルダ
- ターン：会話の中の1回分のやり取り。ふつうは、あなたの指示と、それへの返事と作業をまとめたもの
- Git：ファイルの変更の記録を残し、元に戻せるようにする道具
- ワークツリー：同じリポジトリ（コードの置き場所）を別のフォルダにもう1つ取り出したもの。Codex が変更を手元の作業と分けておくために使います
- ローカル環境（Local environment）：デスクトップアプリで、ワークツリーの準備の手順やよく使う作業を決めておく設定
- review pane：コードの変更（差分）やコメントを見るための、デスクトップアプリの画面
- ログ：アプリが動いた様子を書き残したファイル
会話が止まったように見えるとき
- Codex があなたの許可を待っていないかを見る
- ターミナルを開き、
git statusのような簡単なコマンドを打ってみる - 指示を小さく、的を絞ったものにして、新しい会話で始め直す
ターミナルが動かないとき
- ターミナルの欄を閉じる
- <kbd>Ctrl</kbd>+<kbd>`</kbd> でもう一度開く
pwd（いまいるフォルダを表示する）やgit statusのような簡単なコマンドをもう一度打つ
思ったのと違う動きをするときは、まずターミナルで、いまのフォルダとブランチ（変更の流れの枝）を確かめます。それでも動かないときは、動いている会話が終わるのを待ってから、アプリを起動し直します。
文字の形がおかしいときは、[Settings](codex://settings) の Code font で変えます。このフォントは、ターミナル・review pane など、アプリの中でコードを見せる所すべてに使われます。
指示の文を取り戻したいとき
Local・Worktree・Cloud の行き先を間違えて会話を始めたときや、ワークツリーを作るのを間違えて取り消して指示の文が消えたときは、入力欄で上矢印キーを押すと、前の指示の文が戻ります。行き先を間違えたときは、いまの実行を取り消してから押します。
会話やプロジェクトが見つからないとき
- 一部の会話しか横の一覧に出ない：一覧は、プロジェクトの状態で会話を絞り込めます。Chats の横の絞り込みの印を押し、Chronological を選びます。それでも無ければ、Settings の Archived chats を見ます
- しまった（アーカイブした）会話を探す：Settings にあります。しまうのをやめると、元の位置に戻ります
- プロジェクトを一覧から外す：プロジェクト名にカーソルを合わせ、点3つの印から Remove を選びます。戻すときは、Chats の横の Add new project か <kbd>Cmd</kbd>+<kbd>O</kbd> で、もう一度加えます
思わぬ表示や動きが出るとき
- Codex が触っていないファイルが横の欄に出る：プロジェクトが Git で管理されていると、変更を見る欄は Git の状態をもとに表示するので、Codex 以外の変更も並びます。直前のターンの変更だけを見たいときは、表示を Last turn に切り替えます
- ワークツリーでコードが動かない：ワークツリーは別のフォルダに作られ、初期設定では Git に入っているファイルを受け継ぎます。必要な部品や道具の管理のしかたによっては、ローカル環境で準備の手順を動かすか、Git に入れていない準備用のファイルを
.worktreeincludeで写す必要があります。ふだんのプロジェクトのほうで変更を取り出して確かめることもできます - 仲間と共有したローカル環境が読み込まれない：設定はプロジェクトの一番上の
.codexフォルダに置く必要があります。1つのリポジトリにいくつものプロジェクトがあるときは、.codexフォルダがあるフォルダを開きます - Mac で Apple Music などへのアクセスを求められる：作業によっては Codex がフォルダをたどります。Mac では「ミュージック」「ダウンロード」「デスクトップ」などのフォルダに、あなたの許可が別に要ります。ホームフォルダを読むときに、Mac がこの許可を求めます
- 決まった時刻に動かす作業でワークツリーが増える：頻繁に動かすと、時間とともにワークツリーが増えていきます。要らなくなった実行はアーカイブし、ワークツリーを残すつもりのない実行はピン留めしないようにします
- CLI では動く機能がデスクトップアプリで動かない：デスクトップアプリと Codex CLI は、中の Codex の版が違うことがあり、新しい機能はどちらかに先に届きます。試しの機能は CLI に先に入ることもあります。版は、CLI なら
codex --version、デスクトップアプリに入っている Codex なら/Applications/Codex.app/Contents/Resources/codex --versionで確かめます
不具合を知らせる
- 入力欄に <kbd>/</kbd> を打つと、開発チームに意見を送れます。いまの会話から送るときは、その会話の中身を一緒に渡すかを選べます。送ると会話の番号（session ID）が出るので、それをチームに伝えられます
- GitHub の Codex の置き場所で、同じ不具合がもう報告されていないかを探し、無ければ新しく報告します
- 記録の置き場所：Mac のアプリのログは
~/Library/Logs/com.openai.codex/YYYY/MM/DD、会話の記録は~/.codex/sessions、しまった会話は~/.codex/archived_sessions（どちらも$CODEX_HOMEを決めていなければこの場所） - ログを人に渡す前に、知られて困る情報が入っていないかを自分で確かめます
公式が挙げている使いどころ
公式のページに書いてある向き・使い方だけを並べます。
- 止まったら指示を小さくする：会話が止まったように見えるときの3つ目の手順として、的を絞った短い指示で新しい会話を始める
- ターミナルではまず場所を見る：コマンドが思ったように動かないときは、先にいまのフォルダとブランチを確かめる
- ピン留めは残したいときだけ：決まった時刻に動かす作業では、ワークツリーを残したい実行だけをピン留めする
- ログは見てから渡す：渡す前に、知られて困る情報が入っていないかを確かめる
あわせて読む
公式のページ
- Troubleshooting（困ったとき、英語。公式の日本語版はありません）learn.chatgpt.com ↗
確認メモ：2026年10月1日に、上の公式ページ（英語）を開いて、手順の数と順番、ボタンと設定の名前、キー操作、ログの置き場所を突き合わせました。公式のページに更新日の表示は無いため、この日付は「このサイトが確かめた日」です。ChatGPT Work の会話をほかのパソコンやスマホと同じにする仕組み（Work Cloud と Allow local computer access。ワークスペースの持ち主が設定を確かめるもの）にまつわる3つの項目、管理者向けの設定の自動の更新、review pane で変更の段階（ステージ）を切り替えたり main と比べたりする操作、通信を許した環境で操作が止められるときの設定の優先順位は、管理者向けか、はじめて使うのに要らないため載せていません。「ログ」「ブランチ」「pwd」の言い換えは、公式の用語集に無く、ふつうの意味を一言で添えたものです。「会話」「プロジェクト」「ターン」「ワークツリー」「ローカル環境」「review pane」は、公式の用語集の説明に沿っています。