Checking the installed Codex CLI version confirms the local build before troubleshooting unexpected behavior, comparing results across machines, or attaching accurate details to an issue report.

The codex executable prints its version using the standard --version flag. The output is typically a single line containing an identifier (for example, codex-cli) followed by a semantic version (major.minor.patch).

The reported version reflects the CLI binary itself, not the model selected for a session. When multiple installations exist, the version shown may come from a different PATH entry than expected, especially after switching between package managers or manual installs.

Steps to check Codex CLI version:

  1. Open a terminal on the machine where codex is installed.
  2. Print the installed Codex CLI version.
    $ codex --version
    codex-cli 0.87.0

    Pre-release builds may include an extra suffix after the version.

  3. Confirm which codex executable is being used when the version is not the expected one.
    $ command -v codex
    /opt/homebrew/bin/codex

    Multiple codex binaries in PATH can report different versions.

  4. Inspect the resolved binary path to confirm the install location.
    $ ls -l $(command -v codex)
    lrwxr-xr-x  1 user  staff  62 Jan 19 11:22 /opt/homebrew/bin/codex -> /opt/homebrew/Caskroom/codex/0.87.0/codex-aarch64-apple-darwin