メインコンテンツまでスキップ
バージョン: next

Codex CLI をインストールする

Mac で普段 Codex を使っているなら、このページでやることはインストールより確認です。CodexPocketMac が実際に呼び出すのは codex CLI なので、まずターミナルで codex が起動し、必要なサブコマンドも使える状態にしておきます。

1. ターミナルで codex が起動するか確認する​

ターミナルで次を順に実行します。

codex --version
codex

期待する状態は次のとおりです。

  • codex --version でバージョンが表示される
  • codex を実行すると Codex CLI が起動する

起動確認だけなら、画面が開いた時点で Ctrl+C で終了して構いません。

2. CodexPocketMac が必要とするコマンドを確認する​

続けて、CodexPocketMac が利用するコマンドも確認します。

which codex
codex app-server --help

ここで確認したいのは次の 2 点です。

  • which codex で codex の実パスが表示される
  • codex app-server --help がエラーにならない

codex 本体が起動しても codex app-server --help が失敗する場合は、CLI が古いか壊れている可能性があります。

3. 最新版か確認して更新する​

まず、今どこから codex が入っているかを見ます。

which codex

Homebrew で入れている場合でも、which codex は /opt/homebrew/bin/codex や /usr/local/bin/codex のような bin 配下の symlink を返すことがあります。まずそのパスを確認し、symlink ならリンク先も見ます。

CODEX_PATH="$(which codex)"
printf '%s\n' "$CODEX_PATH"
ls -l "$CODEX_PATH"

ls -l のリンク先、または which codex の結果そのものが /opt/homebrew/Caskroom/... や /usr/local/Caskroom/... を指していれば、Homebrew cask で入っている状態です。その場合は次で確認と更新を進めます。

brew update
brew info --cask codex
brew upgrade --cask codex
codex --version
codex app-server --help

確認の見方は次のとおりです。

  • brew info --cask codex でインストール済みバージョンと配布中バージョンを確認する
  • brew upgrade --cask codex で更新する
  • 更新後に codex --version をもう一度実行し、期待したバージョンになっているか確認する
  • 最後に codex app-server --help を実行し、CodexPocketMac が必要とする機能も問題ないことを確かめる

Homebrew 以外で入れている場合は、最初に使ったインストール方法で更新したあと、同じく codex --version と codex app-server --help をやり直します。

うまくいかないとき​

  • which codex が空なら、Codex CLI のインストールや PATH を見直します
  • codex --version は通るのに codex が起動しないなら、シェル設定や実行権限を見直します
  • codex は起動するのに codex app-server --help が失敗するなら、CLI を更新してから再確認します
  • ターミナルでは動くのに Mac アプリでは認識されないときは、Mac アプリが login shell の which -a codex と標準的な standalone / Homebrew / Codex app の場所も確認します。それでも見えない場合は、詳細 の 実行ファイルパス で Codex CLI に which codex の結果または実行ファイルのパスを指定します
  • 状態は 詳細 タブの Codex CLI 行でも確認できます
  • 一般 に Bridge の前提条件を満たしていません と出ているときも、まずここを見ます

この確認が終わるとできること​

  • Bridge を開始できる
  • Project ごとに Thread 一覧を取得できる
  • iPhone から Composer や Fork を使える

Codex App を使っていても、この確認は一度しておくと確実です。CLI が見つからない状態では、iPhone 側の接続までは進めても実作業には入りません。