Skip to main content
reopt Handbook
reopt Handbook
Advanced Codex Usage

Foundation

Setup and LoginConfigMemories

Safety and Operations

ApprovalsSecurity

Workflow

Slash CommandsPrompts and SkillsExec and AutomationThread LifecycleCloud TasksMulti-Agent Workflows

Extensions and IDE

Codex App and IDEMCP IntegrationModels and ReasoningGovernance and Rollout

Verification

VerificationUpdates
Handbook›Advanced Codex Usage›Verification
한국어English

Verification

A checklist for validating advanced Codex team operations.

September 12, 2026 release refresh

Updated for Codex CLI 0.154.0 (September 9). npm latest=0.154.0 and alpha=0.155.0-alpha.3.10 were checked on September 12, 2026 KST.

  • Sessions: experimental --worktree and /worktree create isolated checkouts for new or forked sessions, with browse/resume support. Inline questions accept choices or free text while work continues.
  • Extensions and approvals: existing sessions refresh installed plugin tools, skills, and hooks. Failed MCP OAuth refreshes surface sign-in without replaying rejected calls. Resume/fork preserve permissions, and new user instructions invalidate stale automatic approvals.
  • Compatibility: codex mcp-server and the standalone codex-mcp-server were removed. External MCP connections through codex mcp remain supported. Evaluate migration to experimental codex app-server; the official documentation does not support production workloads on that command.
  • Editing: /copy preserves formatting and supports status output; Vim gains R replace mode. Windows gains a shared background server and daemon management.

Sources: official changelog, npm dist-tags.

This refresh compares official release text with npm channels. It does not claim local CLI execution or live feature testing. Tables below retain prior dated checks; the channel values above supersede them.

Use this checklist before treating Codex as a team-standard development tool.

Source Baseline

  • Checked date: 2026-09-05 KST
  • Codex CLI stable/latest baseline: codex-cli 0.153.4
  • npm dist-tags checked: latest=0.153.4, alpha=0.154.0-alpha.3
  • Model baseline: GPT-6 Astra (gpt-6-astra) as the top model, with GPT-5.6 Sol for the hardest GPT-5.6 work, Terra for everyday work, and Luna for explicit repeated work.
  • Retirement checked: GPT-5.4 and GPT-5.4 mini left ChatGPT-sign-in Codex on 2026-08-31; API/API-key availability is separate.
  • Key deltas checked: GPT-6 Astra availability from 0.153.0 and the 0.153.4 bundled-default change, the 0.153.3 Bedrock Mantle/Runtime pickers, the 0.152.0 planning-tool default, tui.auto_recap, tui.disable_paste_burst, features.context_management.experimental_mode, MCP output_token_limit and naming rules, the optional-MCP discovery grace period, and Guardian review-history persistence.

2026-09-05 Cross-Checks

Documentation URLs moved (checked 2026-09-05)

The official Codex documentation moved from developers.openai.com/codex/* to learn.chatgpt.com/docs/*. Existing links still resolve through 308 permanent redirects, so none are broken, but the path structure did not change uniformly (/codex/models → /docs/models, /codex/cli → /docs/codex/cli, /codex/config-reference → /docs/config-file/config-reference). A blanket find-and-replace would produce wrong URLs, so this round only used the new domain in newly written passages. The 479 remaining old links (49 unique) across both Codex handbooks will be migrated path by path in the next round.

ItemHandbookOfficial sourceMatch
Astra release date2026-09-03GPT-6 Astra announcementYes
Astra model IDgpt-6-astraAPI models pageYes
Astra context / output1,050,000 / 128,000 tokensAPI models pageYes
Astra pricing$10 input · $1 cached input · $50 output per 1MAPI models pageYes
Astra knowledge cutoffApril 30, 2026API models pageYes
Astra reasoning effortlow, medium, high, xhigh, maxAPI models pageYes
Astra minimum CLI0.153.0 or later0.153.x release notesYes
Astra default changeBundled default from 0.153.4 when no model is configured0.153.4 release notesYes
Astra on BedrockAdded to Mantle and Runtime pickers in 0.153.3Official changelogYes
Astra safety classFirst model at Critical cybersecurity capabilityGPT-6 Astra announcementYes
Planning tool defaultDisabled from 0.152.0; enable with tools.update_plan.enabled0.152.0 release notesYes
Guardian historySurvives compaction, restarts, and forks (0.153.0)0.153.0 release notesYes

Setup

CheckPass condition
InstallSupported install path is documented
AuthLogin and token rules are clear
ConfigProfiles and safety defaults are versioned
ContextRepository instructions and skills are maintained

Safety

CheckPass condition
ApprovalsHigh-risk actions require human approval
SandboxDefault mode limits unintended access
SecretsSecret handling rules are documented and enforced
MCPTool allowlists and audit trail exist

Operations

CheckPass condition
AutomationExec workflows produce structured output
Multi-agentDelegated tasks have scoped ownership
ModelsModel and reasoning defaults are tied to task risk
GovernanceRollout metrics and changelog review exist

Related docs

Models and Reasoning

Choose GPT-6 Astra, GPT-5.6 Sol, Terra, Luna, and reasoning levels by task risk, cost, and latency.

Cmd. /model

Codex Command Master · Switch among GPT-6 Astra, GPT-5.6 Sol, Terra, Luna, and supported reasoning effort levels.

Ch3. Project Layout and Discovery

Enterprise Eve Agent Development · How Eve turns agent directory slots into a source manifest, and why path-derived identity is an operations contract.

Updates

Change log for the Advanced Codex Usage handbook.

Earlier verification records

Codex Command Master · Codex CLI: Earlier review dates, version baselines, and findings, with a link to the current verification scope.

Governance and Rollout

Roll out Codex across teams with ownership, policy, training, and upgrade discipline.

Updates

Change log for the Advanced Codex Usage handbook.

On this page

September 12, 2026 release refreshSource Baseline2026-09-05 Cross-ChecksSetupSafetyOperations