事象

Codex 起動時に次のエラーが発生し、Code Mode が fail closed になる。

Code Mode is unavailable because failed to spawn code-mode host ...
codex-code-mode-host: host executable was not found.

環境

OS: Ubuntu Linux x86_64
aqua: 2.59.0
Codex CLI: 0.153.2
導入方法: aqua の openai/codex 標準レジストリ定義

原因

aqua 標準レジストリの openai/codex は、公式 codex-package からbin/codex だけを展開する。
Code Mode は本体と同じ bin/ ディレクトリにある
codex-code-mode-host を起動するため、Host が見つからない。

対策

ローカル aqua レジストリで openai/codex を再定義し、公式
codex-package-<arch>-<os>.tar.gz から次の両方を展開する。

bin/codex
bin/codex-code-mode-host

aqua.yaml にローカルレジストリと Codex の参照先を追加する。

registries:
- type: standard
  ref: v4.524.1
- name: codex-complete
  type: local
  path: aqua-code-mode-host-registry.yaml

packages:
- name: openai/codex@rust-v0.153.2
  registry: codex-complete

aqua-code-mode-host-registry.yaml を作成する。

packages:
- type: github_release
  name: openai/codex
  repo_owner: openai
  repo_name: codex
  version_prefix: rust-
  version_constraint: "true"
  asset: codex-package-{{.Arch}}-{{.OS}}.{{.Format}}
  format: tar.gz
  files:
  - name: codex
    src: bin/codex
  - name: codex-code-mode-host
    src: bin/codex-code-mode-host
  replacements:
    amd64: x86_64
    arm64: aarch64
    darwin: apple-darwin
    linux: unknown-linux-musl
    windows: pc-windows-msvc

aqua-policy.yaml でローカルレジストリを許可する。

registries:
- type: standard
  ref: semver(">= 3.0.0")
- name: codex-complete
  type: local
  path: aqua-code-mode-host-registry.yaml

packages:
- registry: standard
- registry: codex-complete

導入・更新後は次で確認する。

aqua policy allow ./aqua-policy.yaml
aqua install
aqua which codex
codex doctor

参考情報