フィールドガイド / 10 分
Codex を導入し、toolchain を証明する
特定できる binary、明示的な version、再現可能な診断から始める。
信頼できる Codex workflow は最初の prompt より前に始まります。公式 standalone installer を使い、実際に動く binary と version を確認し、意図的に更新し、config・auth・Git・terminal の問題を codex doctor の evidence で解決します。
検証済みターミナル手順
- $
curl -fsSL https://chatgpt.com/codex/install.sh | sh - $
irm https://chatgpt.com/codex/install.ps1 | iex - $
codex --version - $
codex update - $
codex doctor
作業原則
Executable を特定
Alias や複数 install が別 binary を指すことがあります。command と version を先に記録します。
意図的に update
self-update 対応 release だけ codex update を使い、更新後に version-sensitive behavior を再確認します。
Layer ごとに診断
codex doctor は installation、config、auth、runtime、Git、terminal、app-server、threads を調べます。
フィールド手順
- 01
公式 installer を使う
macOS/Linux の POSIX shell は install.sh、Windows PowerShell は install.ps1 を使い、初回は path change が見える interactive setup にします。
- 02
Version を確認
実際に使う shell で codex --version を実行します。
- 03
Command discovery を確認
見つからない時は再 install 前に terminal と PATH を確認します。
- 04
診断 report を作る
codex doctor の最初の failing layer から直します。
- 05
Baseline を残す
version と正常 report を local setup notes に記録します。
PASS / FAIL
受入チェック
- Installer が OS と active shell に一致。
- codex --version が成功。
- doctor が正しい runtime/repo を表示。
- PATH で意図した binary が優先。
- credential/diagnostic file を commit しない。
WATCH / REJECT
失敗パターン
- POSIX shell で PowerShell installer、またはその逆を実行。
- PATH を見ず再 install。
- 全 release が self-update 対応と仮定。
- sensitive path を確認せず report を共有。