Codex を社内に広げると、情シスやヘルプデスクには「急に動かなくなった」「同僚の画面にある機能が自分には出ない」「設定を変えたのに効かない」といった相談が届くようになります。ChatGPT のような画面だけで完結する道具と違い、Codex は社員のパソコンの中でファイルやコマンドを扱うため、原因が端末・設定・ネットワーク・管理者の方針のどこにあるのかを切り分ける手間がかかります。

この記事では、社内のヘルプデスクが Codex の相談を受けるときに何を聞き、何を集め、どこで管理者に回すかを手順の順番に整理します。製品の動きに関わる内容は、2026年11月15日に OpenAI の公式ドキュメント(Troubleshooting・Developer commands・Slash commands in Codex CLI・Configuration Reference・ChatGPT & Codex changelog)で確かめた範囲に絞りました。

結論: 相談を受けたら、まず「使っている画面・OS・バージョン・起きたこと・いつから」の5つを受付票で集めます。次に codex doctor で端末の状態を、/debug-config で効いている設定を確かめてもらいます。個人の設定で直らないもの(管理ポリシー・ワークスペースの権限・ネットワークの方針)は管理者に回し、ログや診断結果は中身を見てから共有します。

なぜ受け方を先に決めておくのか

Codex の相談は、聞き方しだいで解決までの往復の回数が大きく変わります。「動かない」という一言では、デスクトップアプリの話なのか CLI の話なのかも分かりません。

公式のトラブルシューティングには、ヘルプデスクが知っておくと切り分けが早くなる前提がいくつか書かれています。

  • CLI とデスクトップアプリは別のバージョンの Codex を積んでいることがある。CLI では動く機能がアプリでは動かないときは、両方のバージョンを確かめる
  • 管理されたワークスペースでは、組織や端末の方針を個人の設定で上書きできない
  • ネットワークの方針は優先度の高いものが低いものを上書きする。低いほうがより細かく書かれていても上書きされる

(出典: Troubleshooting)

つまり、相談のかなりの部分は「バージョンのずれ」か「管理者の設定」で説明がつきます。この2つを最初に確かめる順番を決めておくだけで、ヘルプデスクが端末を触りに行く回数を減らせます。

手順1: 受付票で5つを集める

最初の返信で、次の項目を書いてもらいます。社内の問い合わせフォームや受付票の項目にしておくと、聞き漏れがなくなります。

項目 書いてもらう内容の例 何に使うか
使っている画面 デスクトップアプリ・CLI・IDE 拡張・Web 調べる場所を決める
OS macOS・Windows・Linux ログの場所や OS ごとの不具合を確かめる
バージョン codex --version の結果(アプリの場合はアプリのバージョン) 画面ごとのずれや修正済みの不具合を確かめる
起きたこと 何をしたら何が起き、本来はどうなるはずだったか 再現のしかたを決める
いつから 昨日から・アップデートの後から・最初から 更新や設定変更との関係を見る

macOS のデスクトップアプリが積んでいる Codex のバージョンは、公式ドキュメントに次のコマンドで確かめる方法が載っています。

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

1行目が CLI、2行目がデスクトップアプリに入っている Codex です。2つの数字が違えば、「CLI では使えるのにアプリでは使えない」という相談の多くはそれで説明がつきます。(出典: Troubleshooting)

CLI のバージョンごとの変更点は公式の changelog に載っています。直近の変更のうち管理者に関係するものはCodex CLI 0.169.0 の記事などで解説しています。

手順2: codex doctor で端末の状態を確かめる

次に、CLI が入っている端末なら codex doctor を実行してもらいます。公式の Developer commands では、インストール・設定・認証・実行環境・Git・端末・アプリサーバー・スレッドの一覧に関わる問題を診断するコマンドとされ、サポートに問い合わせる前や、Codex のインストールが壊れているときに使うよう案内されています。(出典: Developer commands)

よく使うオプションは次のとおりです。

オプション 公式ドキュメントでの説明 ヘルプデスクでの使いどころ
(なし) 人が読む形の詳しい報告 まず全体を見る
--summary まとめた行と最後の件数だけを表示 チャットに貼ってもらう
--network-only 設定・ネットワーク環境・接続先への HTTP 接続・WebSocket 接続に絞って確認 「つながらない」相談
--json 伏せ字処理された機械向けのサポート用報告 記録として保存する・詳しく調べる
--ascii / --no-color 記号や色を使わない表示 受付票やメールに貼るとき文字化けを避ける

(出典: Developer commands)

社員への案内は、まず codex doctor --summary を貼ってもらい、つながらない相談なら codex doctor --network-only を追加でお願いする、という2段にしておくと負担が小さくなります。認証の状態だけ確かめたいときは codex login status で今のログイン方式が表示され、ログインしていれば終了コード 0 で終わると説明されています。(出典: Developer commands)

ネットワークの許可範囲そのものの決め方はネットワークアクセスの記事にまとめています。

手順3: 「設定が効かない」は効いている設定から確かめる

「設定ファイルを書き換えたのに変わらない」「同僚にはある機能が自分には出ない」という相談では、ファイルの中身より先に実際に効いている設定を確かめます。

CLI のスラッシュコマンドには、この切り分けに使えるものがあります。

  1. /status: 使っているモデル・承認の方針・書き込みできる場所・トークンの使用量を表示する
  2. /debug-config: 設定の層と要件(requirements)の診断を表示する。層の優先順位と方針の内容が分かり、効いている設定が config.toml と違う理由を説明するのに使える
  3. /warnings: 残っている警告とその詳しい内容を表示する
  4. /mcp verbose: 設定済みの MCP ツールの一覧に、サーバーの詳しい診断を加えて表示する

(出典: Slash commands in Codex CLI)

機能の出る出ないが問題なら、codex features list で機能フラグとその成熟度・実際に効いている状態を一覧できます。また、--strict-config を付けて起動すると、その版の Codex が知らない項目が config.toml にあるときにエラーにしてくれるため、古い版で新しい設定を書いてしまった失敗を見つけられます。(出典: Developer commands)

/debug-config で管理者側の層が効いていると分かったら、ヘルプデスクでは直さずに手順5へ進みます。公式ドキュメントでも、管理されたワークスペースでは個人の設定で組織や端末の方針を上書きできないとされています。(出典: Troubleshooting)

手順4: 止まった・固まったときの一次対応

「途中で止まったまま進まない」という相談には、公式ドキュメントにある順番で一次対応をお願いします。

  1. Codex が承認待ちになっていないかを確かめる
  2. 端末で git status のような簡単なコマンドを実行してみる
  3. 小さく絞った指示で新しいチャットを始め直す
  4. 統合ターミナルが固まって見えるときは、ターミナルの画面を閉じて開き直し、pwd か git status をやり直す。それでも直らなければ、動いているチャットが終わるのを待ってアプリを再起動する

(出典: Troubleshooting)

社員が一番困るのは「承認待ちで止まっていただけ」と気づかずに待ち続けることです。研修の段階で承認の画面を見せておくと、この種の相談は減ります。承認の仕組みはサンドボックスと承認ポリシーの記事で解説しています。

手順5: 管理者に回す相談の目安

次のような相談は、個人の端末では直せないことが多いため、早めに Codex の管理者(ワークスペースの管理者や情シスの担当者)に回します。

相談の例 公式ドキュメントにある原因の候補 管理者が確かめること
「Approve for me」が出ない・押せない 個人の設定で無効になっている・組織が許す権限や承認の方針で出ない 許可している権限プロファイル・サンドボックスの設定・承認の方針
Work の会話がほかの端末に出ない 端末ごとに別のアカウントやワークスペースでログインしている・ワークスペースの権限 「Allow local computer access」の設定・クラウドの方針
特定のサイトやサービスにつながらない 優先度の高いネットワーク方針が上書きしている 実際に効いている方針の比較と、許可・拒否のテスト

(出典: Troubleshooting)

公式ドキュメントでは、ネットワークのテストに失敗したからといって全体の基本方針を広げて回避しないよう注意されています。管理者に回すときは「どの操作が止まったか」を受付票に書いてもらい、方針を広げる前に効いている方針を比べる手順を徹底してください。管理者側の設定の全体像はCodex のセキュリティと統制の記事にまとめています。

手順6: ログと診断結果を共有するときの決めごと

詳しく調べる段階では、ログや会話の記録が必要になることがあります。公式ドキュメントに載っている保存場所は次のとおりです。

  • アプリのログ(macOS): ~/Library/Logs/com.openai.codex/YYYY/MM/DD
  • 会話の記録: $CODEX_HOME/sessions(既定は ~/.codex/sessions)
  • アーカイブした会話: $CODEX_HOME/archived_sessions(既定は ~/.codex/archived_sessions)

(出典: Troubleshooting)

設定リファレンスでは、ログの書き出し先は log_dir で決められ、既定は $CODEX_HOME/log とされています。(出典: Configuration Reference)

会話の記録には、社員が Codex に渡した社内のコードや文書の内容が残っています。公式ドキュメントでも、共有する前にログに機密情報が入っていないか見直すよう案内されています。社内では次の3つを決めておくと安心です。

  1. 誰に送るか: 社内の窓口だけに送るのか、OpenAI への報告まで含めるのか
  2. 何を送ってよいか: codex doctor --summary の結果は送ってよい・会話の記録は担当者が中身を見てから、など段階を分ける
  3. どこに保管するか: 受け取ったログを置く場所と消す時期

/feedback と診断用 ZIP の扱い

CLI の /feedback は、ログや診断情報を Codex の開発元(メンテナー)に送るコマンドです。(出典: Slash commands in Codex CLI)公式のトラブルシューティングでは、チャットの中から送ると今の会話もあわせて共有でき、送ったあとに受け取る会話の ID をチームに伝えられると説明されています。(出典: Troubleshooting)

社外に情報が出る操作なので、社内で使ってよいかを先に決めます。設定リファレンスでは、config.toml の feedback.enabled で /feedback からの送信を有効にするかどうかを決められ、既定は有効とされています。(出典: Configuration Reference)

また、2026年11月13日の Codex CLI 0.169.0 では、端末の不具合報告の画面で Ctrl+S を押すと、送信が無効になっていても診断用の ZIP を手元に保存できるようになりました。(出典: ChatGPT & Codex changelog)社外への送信を止めている会社でも、この ZIP を社内の窓口に渡してもらう運用が組めます。ZIP に何が入るかは changelog に書かれていないため、受け取った担当者が中身を確かめてから扱ってください。

受付から解決までの流れをまとめる

ここまでの手順を、社内の手順書に載せる形にまとめると次のようになります。

段階 社員にお願いすること ヘルプデスクがすること
受付 5つの項目を受付票に書く 画面とバージョンのずれを確かめる
診断 codex doctor --summary を貼る(つながらないときは --network-only も) 失敗している項目を見て原因の場所を絞る
設定の確認 /debug-config と /status の結果を貼る 管理者側の設定が効いているかを見る
一次対応 承認待ちの確認・新しいチャットで試す 再現するかを確かめる
管理者へ 止まった操作を書き足す 管理者に回し、結果を社員に返す
記録 — 相談の内容と解決方法を社内の FAQ に足す

最後の「記録」は省かないでください。同じ相談は何度も届きます。解決した方法を社内の FAQ や研修資料に足していくと、導入が進むほどヘルプデスクの負担が下がっていきます。社員向けの説明資料の作り方は社内利用ガイドラインの記事、研修の組み方は非エンジニア向け研修の記事で紹介しています。

まとめ

Codex の「動かない」相談は、使っている画面とバージョンのずれ、または管理者の設定で説明がつくことが少なくありません。受付票で5つの項目を集め、codex doctor で端末の状態を、/debug-config で効いている設定を確かめるという順番を決めておけば、ヘルプデスクは端末を触りに行かなくても多くの相談を切り分けられます。個人の設定で直らないものは早めに管理者に回し、ログや診断結果は中身を見てから共有するルールを先に決めておきます。

この記事の内容は、2026年11月15日時点の OpenAI 公式ドキュメントの記載に基づいています。コマンドの名前や画面の操作は変わることがあるため、手順書に載せる前に最新の記載をご確認ください。デジライズでは、社内のヘルプデスクの受付票や手順書づくりから、管理者の設定・社員向けの研修までを含めた Codex の法人導入支援のご相談を承っています。「まず情シスの中で相談の受け方をそろえたい」という段階からでもお問い合わせください。