Advanced Codex Usage
An advanced operations and extension guide for teams standardizing Codex usage.
Recently Updated Chapters
Use Codex slash commands as an operating surface for sessions, review, models, and status.
Design Codex configuration layers, profiles, and safe defaults for team usage.
Connect Codex to MCP servers with explicit tool, data, and trust boundaries.
Split Codex work across bounded agents while preserving ownership and review.
Standardize Codex installation, updates, identity, and local developer setup.
Codex is useful as an individual coding agent, but its real leverage appears when teams standardize configuration, safety rules, automation, context, and review practices.
This handbook is for senior developers and engineering leads who already use Codex and want to make it reliable in shared repositories and team workflows.
Core View
Codex quality depends on the environment around it: repository instructions, permissions, context packs, verification commands, and review routines.
August 2026 Baseline
Checked against Codex CLI 0.146.0, npm dist-tags, official release notes, and current Codex docs
on 2026-08-03 KST. npm latest, the local CLI, and the latest stable GitHub release are 0.146.0;
npm alpha is 0.147.0-alpha.4.
-
Official slash inventory re-check: stable/latest remains 0.146.0. The current reference lists
/copy,/rename,/pets(/pet), Windows-only/setup-default-sandbox, and/app;/subagentsand/btware documented aliases. The slash-command chapter and Command Master now match it. -
CLI 0.146.0: named
/newand/clearthreads, pinning and side-conversation switching, paginated-history forks, Agent Plugin manifests/workspace publishing, additional Bedrock and Claude Code marketplaces, remote Code Mode hosts, custom-provider web search, executor-provided skills, broader proxy handling, and live MCP/App tool refresh. -
CLI 0.145.0: experimental paginated thread history with names, search, memories, and subagent support; broader Cursor/Claude Code
/import; Bedrock login; audio; stabilized Multi-agent V2; and secure inline visualization links. -
CLI 0.143.0–0.144.0: remote plugins are enabled by default with npm marketplace sources and local/remote versions; system proxy support covers macOS and Windows PAC/WPAD;
codex remote-control pairgenerates manual pairing codes; MCP tool search is default and interactive/session auth is expanded; app approvals add awritesmode; reset credits show type/expiration and support explicit selection; Ultra warns about high multi-agent concurrency. The releases also harden retired-model compaction recovery, Windows writable-root deletion, terminal-control sanitization, and connector auth refresh.
Operating Model
Maturity Model
| Level | State | Common symptom | Promotion condition |
|---|---|---|---|
| L1 Personal | Each developer uses Codex differently | Results depend on individual habits | Shared setup and basic rules exist |
| L2 Standardized | Config and prompts are documented | Safety settings still drift | Approval and sandbox defaults are governed |
| L3 Automated | Repeatable tasks run through exec or agents | CI and review evidence are inconsistent | Verification output is required |
| L4 Governed | Team rollout is measurable | Changes in Codex behavior surprise teams | Changelog, models, and policies are reviewed |
Contents
Ch1. Setup and Login
Standardize installation, updates, identity, and shell integration.
Ch2. Config
Design profiles, defaults, and team policy layers.
Ch3. Memories
Manage persistent context without stale or unsafe facts.