普段からUbuntuのターミナルで利用しているCodex CLI。今回、Codex CLI自身がアップデートを実行したあと、起動できなくなってしまいました。
自分でnpmの更新コマンドを実行したわけではなく、Codex側のアップデートがきっかけです。通常の再インストールでも直らず、最終的にLinux x64向けパッケージを直接インストールすることで復旧できたので、その記録を残します。
発生したエラー
起動時に表示されたのは、Linux用の依存パッケージが見つからないというエラーです。
Missing optional dependency @openai/codex-linux-x64
Codex CLIはnpmでインストールしています。OSやCPUアーキテクチャに応じたパッケージが、npmのoptionalDependenciesを使って扱われています。
環境を確認
Ubuntuのデスクトップ環境で、バージョンは次のとおりです。
Node.js : v24.11.1
npm : 11.17.0
Codex : 0.170.0(復旧後)
まずは、インストール状況とnpmの設定を確認しました。
# Codex CLIのインストール状態
npm list -g @openai/codex
# npmレジストリの設定
npm config get registry
# 依存パッケージを省略する設定
npm config get omit
@openai/codex@0.170.0がインストールされており、レジストリはhttps://registry.npmjs.org/、omitはnullでした。Codex本体は存在しますが、これだけでは起動できない原因は特定できません。
通常の再インストールでは改善せず
まず普通の再インストールを試しました。
npm install -g @openai/codex
改善しなかったため、optionalDependenciesを明示的に含める指定でも試しました。
# optionalDependenciesを含めてインストール
npm install -g @openai/codex --include=optional
こちらも起動時のエラーは解消しませんでした。
Linux x64向けパッケージを直接インストール
今回必要なのはLinux x64向けのパッケージです。復旧時のCodex CLIとバージョンを合わせ、npmのエイリアス指定で直接導入してみました。
# Linux x64向けのCodex CLI 0.170.0を直接導入
npm install -g '@openai/codex-linux-x64@npm:@openai/codex@0.170.0-linux-x64'
実行結果はこちら。
added 1 package in 34s
続いてバージョン確認を実行しました。
codex --version
# codex-cli 0.170.0
無事にバージョンが表示され、今回の環境ではCodex CLIを再び使える状態に戻せました。
原因について
確認できたのは、Codex CLI自身によるアップデート後、Linux x64向けの依存パッケージが見つからず起動できなくなり、対応パッケージを直接導入すると復旧したということです。
ただし、アップデート時になぜ依存パッケージが正常に導入・参照されなかったのか、根本原因までは特定していません。npmの依存関係の解決やインストール状態などが関係している可能性はありますが、今回は断定しません。
また、今回のコマンドはLinux x64・Codex CLI 0.170.0向けです。他のOSやバージョンにそのまま適用できるとは限らない点にも注意してください。
まとめ
Codex CLI自身のアップデート後にMissing optional dependency @openai/codex-linux-x64が発生。通常の再インストールでは直りませんでしたが、Linux x64向けのnpmパッケージを直接導入することで復旧しました。
普段は当たり前に動いている開発ツールも、アップデートをきっかけに止まることがあります。同じエラーが出たときの参考になれば幸いです。

コメント