Codexを使っていて「動かない」「エラーが出た」「反応しない」と困ったときの 逆引き解決マップ です。あなたの 症状から 原因と対処法をすぐ見つけられるよう整理しました。
まずは下の「症状別クイック診断」から、自分の状況に近いものを選んでください。
⚠️ 本記事は OpenAI 公式とは無関係の解説記事です。
困ったときの基本3原則（まず試す）
ほとんどのトラブルは、この3つで解決します。
- 再起動する（ターミナル・エディタ・アプリを開き直す）
- 再ログインする（
codex logout→codex login） - 少し待つ（サーバー混雑・レート制限は時間で回復）
これで直らないときは、下の症状別ガイドへ。
症状別クイック診断
| こんな症状 | 原因の可能性 | 対処ページ |
|---|---|---|
codex と打っても「見つからない」 |
PATH設定 | command not found |
| ログインできない／認証が切れる | 認証・セッション | ログイン・認証エラー |
| 「制限に達した」と出て止まる | レート制限 | レート制限の対処 |
| 接続できない／タイムアウト | ネットワーク | ネットワークエラー |
| インストールできない | 環境・権限 | インストール失敗 |
| 反応が遅い／固まる | 負荷・混雑 | 応答が遅い・固まる |
| その他いろいろなエラー | 各種 | エラー10選 |
カテゴリ別の詳しい解説
🔧 インストール・起動の問題
「codex: command not found」と出る → PATHが通っていません。ターミナル再起動でほぼ解決。詳細は command not foundの解決。
「インストールが失敗する」 → Node.jsのバージョン、権限、ネット環境を確認。詳細は インストール失敗の対処。
関連：CLIインストール手順 / 動作環境ガイド
🔑 ログイン・認証の問題
「ログインできない」「ブラウザが開かない」
→ codex login --no-browser を試す、キャッシュクリア、別ブラウザ。詳細は ログイン・認証エラー。
「認証が切れる」「Sign in expired」
→ codex logout → codex login で再認証。
⏳ 制限・速度の問題
「Rate limit exceeded」「制限に達しました」 → プランの利用枠超過。時間で回復、またはプランをアップグレード。詳細は レート制限の対処。
「反応が遅い」「固まる」
→ ファイル読み込みすぎ、サーバー混雑。.codexignore で除外。詳細は 応答が遅い・固まる。
🌐 ネットワークの問題
「Network error」「接続できない」 → VPN・プロキシ・ファイアウォールを確認。詳細は ネットワークエラー。
📝 動作・出力の問題
「差分が適用されない」 → ファイルが他で開かれている、読み取り専用。エディタで保存・閉じてから再試行。
「提案されたコードが動かない」 → ライブラリのバージョン違いが多い。使用バージョンを伝えて再依頼。エラー10選参照。
「日本語が文字化けする」（Windows） → Windows Terminal を使う。詳細は Windows版ガイド。
🔐 権限の問題
「Permission denied」 → ファイル権限の問題。macOSなら「フルディスクアクセス」許可も確認。エラー10選参照。
それでも解決しないときは
1. エラーメッセージをCodex自身に貼る
最速の解決法のひとつ。エラー全文をコピーして「このエラーを直して」と頼むと、原因と対処を教えてくれます。
2. 完全リセット（最終手段）
# npm でインストールした場合の例
npm uninstall -g @openai/codex
rm -rf ~/.codex
npm install -g @openai/codex
codex login
3. 公式情報を確認
- OpenAI Status でサービス障害を確認
- Codex公式ドキュメント
- GitHub Issues で同じ症状を検索
トラブルを未然に防ぐ5つの習慣
- AGENTS.mdを整備（ガイド）— プロジェクト前提を伝えて的外れを防ぐ
.codexignoreを最初に書く — node_modules等を除外して軽量化- 小さく試す — 段階的に進めてミスを小さく
- git管理する — 失敗してもすぐ戻せる
- OpenAI Statusをブックマーク — 障害かどうかすぐ判断
初心者の方は 陥りやすい失敗10選 も読んでおくと安心です。
よくある質問（FAQ）
Q. まず何を試せばいい？
A. 「再起動・再ログイン・少し待つ」 の3つ。これでトラブルの大半が解決します。
Q. エラーメッセージの意味が分からない
A. そのままCodexに貼って「これはどういう意味？どう直す？」と聞くのが早いです。用語集も参考に。
Q. サービス障害かどうか知りたい
A. OpenAI Status を確認。赤や黄色の表示があれば、待つのが正解です。
Q. 何度も同じエラーが出る
A. 根本原因（PATH、バージョン、設定）が残っています。該当する個別ページの手順を最後まで実施してください。
Q. どうしても解決しない
A. 完全リセット（再インストール）か、別の入り口（Web版など）で回避。それでもダメなら公式の更新履歴・Issuesを確認。
まとめ
Codexのトラブルは、症状から逆引き すれば多くが素早く解決します。まずは「再起動・再ログイン・少し待つ」、それでもダメなら症状別の個別ページへ。
各エラーの詳しい対処は、上の表のリンク先（command not found / ログイン・認証 / レート制限 / ネットワーク / インストール / 遅い・固まる）で解説しています。このページをブックマークしておくと安心です。
