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
한국어KOEnglishEN

Verification

A checklist for validating advanced Codex team operations.

Written and reviewed by Eric Han · Co-founder & CTO, reopt

Rechecked 2026-10-23 · Codex CLI 0.163.0

CheckResult
Release and npm0.163.0; latest=0.163.0, alpha=0.164.0-alpha.12
Reference tables57 / 29 rows (slash / CLI overview)
Guidance updatedSettings search, instant steering, leader, Daybreak, resume permissions, GPT-5.5 retirement
BoundaryOfficial-source, shared-catalog, and bilingual static review; new features were not executed on an installed CLI

Detailed changes and primary sources. Earlier checks below retain their original baselines.

October 10, 2026 verification

Baseline: Codex CLI 0.162.1 (October 9). npm latest=0.162.1 and alpha=0.163.0-alpha.5 were checked on October 10, 2026 KST. GitHub release text, pull-request descriptions, Developer Commands, the config reference, the non-interactive docs, the models page, and the bundled model catalog were compared; new features were not run on an installed CLI. The official changelog page was restructured into a combined ChatGPT and Codex changelog that no longer lists Codex CLI version numbers, so from this review CLI versions are tracked through GitHub releases and npm.

ItemHandbook valueSourceResult
Stable releases0.161.0 (10-07), 0.162.0 (10-08), 0.162.1 (10-09)GitHub releases rust-v0.161.0–rust-v0.162.1Pass
npm dist-tagslatest=0.162.1, alpha=0.163.0-alpha.5npm view @openai/codex dist-tagsPass
Official changelog structureRestructured into a combined changelog; no Codex CLI version numberslearn.chatgpt.com/docs/changelogStructure change recorded
Official command tablesNo key or value changes since the October 7 reviewDeveloper CommandsPass
Bundled default modelGPT-6.1 Sol from 0.159.1 through 0.162.1gpt-6.1-sol priority 1 in codex-rs/models-manager/models.jsonPass (source)
Bedrock catalog defaultGPT-6.1 Sol. 0.159.1 backported it to the Mantle and Runtime catalogs, and the 0.161.0 release notes restate itReleases rust-v0.159.1 (#49342), rust-v0.161.0 (#49339)Release-tracked
Bedrock multi-agent V2, Ultra reasoning, GovCloud0.161.0; compatible models only, GovCloud for Bedrock MantleRelease notes, PRs #49345, #49813Release-tracked
GPT-5.5 retirement2026-10-14, unchangedModels pagePass
GPT-6.1 Sol speedStandard and Fast; Ultrafast on Pro $500 and eligible Enterprise and Edu plansModels pagePass
Daybreak opt-in--enable cli_daybreak, features.cli_daybreak (0.161.0); what is hidden while off and what routing requiresRelease notes, PR #51207Release-tracked
--cyber-access-program, cyberAccessProgram0.161.0; values standard, daybreak_blue, daybreak_redRelease notes, PR #49939. Not in the official non-interactive docsRelease-tracked
Permission behavior fixesEscalation write scope, background-task permissions, launch permissions kept (0.161.0)Release notes, PRs #49353, #49880, #49809Release-tracked
tui.mouse_scroll_speed0.162.0; positive multiplier, one row per wheel event by defaultRelease notes, PR #50209Release-tracked
Custom provider capabilitiesexternal_web_access and remote_compaction under model_providers.<id>.capabilities (0.162.0)Release notes, PR #50459Release-tracked
Signed PowerShell installer0.162.0Release notes, PR #51158Release-tracked
Config referenceNew keys above not listedlearn.chatgpt.com/docs/config-file/config-referenceNot verified

October 7, 2026 verification

Baseline: Codex CLI 0.160.1 (October 5). npm latest=0.160.1 and alpha=0.162.0-alpha.18 were checked on October 7, 2026 KST. Official release text, pull-request descriptions, the models page, API model pages, and the bundled model catalog were compared; new features were not run on an installed CLI.

ItemHandbook valueSourceResult
Stable releases0.158.0 (09-28), 0.159.0 (09-29), 0.159.1 (09-29), 0.159.2 (09-29), 0.159.3 (09-30), 0.160.0 (10-01), 0.160.1 (10-05)GitHub releases rust-v0.158.0–rust-v0.160.1, official changelogPass
npm dist-tagslatest=0.160.1, alpha=0.162.0-alpha.18npm view @openai/codex dist-tagsPass
GPT-6.1 Sol launchRollout from 2026-09-29; Plus, Pro, Business, Enterprise, and Edu (not Free or Go); Enterprise/Edu admins enable; Standard and Fast modesChangelog 2026-09-29, models pagePass
GPT-6.1 Sol API specs1,050,000 context, 128K output, $2 / $0.10 / $10 (cache writes $2.50), cutoff 2026-04-30, effort low–max, default medium (none and minimal unsupported)developers.openai.com/api/docs/models/gpt-6.1-solPass
Bundled default modelGPT-6.1 Sol from 0.159.1 (Astra before)Release rust-v0.159.1. codex-rs/models-manager/models.json at rust-v0.159.0: Astra priority 1; at rust-v0.159.1 and rust-v0.160.1: GPT-6.1 Sol priority 1, Astra 2Pass (source)
GPT-6.1 Sol minimum CLINot stated in the official docs. The bundled catalog's minimal_client_version is 0.153.0, and the model is bundled from 0.159.1Models page, same catalogNot in official docs
Status of earlier modelsGPT-6 Sol, Luna, and the GPT-5.6 family remain available. GPT-5.6 and GPT-5.5 still migrate to GPT-6 Sol and Luna. GPT-5.4 left the bundled catalogs (0.158.0)Models page, same catalog's upgrade fields, PR #47932Pass (source)
GPT-5.5 retirement2026-10-14, unchanged; replacement guidance still paid → GPT-6 Sol, Free/Go → GPT-6 LunaModels pagePass
Official --model and /model rowsExamples now use gpt-6.1-sol and gpt-6-luna; command and option sets unchangedDeveloper CommandsPass
tui.copy_on_select, tui.right_click_pasteAdded in 0.158.0; accepted values and auto defaultsRelease notes, PRs #47639, #48118, #48469Release-tracked
instant_interrupt, write_stdin_approvalOpt-in feature flag (0.159.0); stable and on by default (0.158.0)Release notes, PRs #48135, #48141, #47799Release-tracked
tui.prompt_suggestions, plugin-creatorRemoved in 0.159.0Release notes, PRs #48621, #48604Release-tracked
MCP OAuth client secretcodex mcp add --oauth-client-secret, oauth.client_secret (0.158.0)Release notes, PR #47891. The official codex mcp add table lists only --oauth-client-idMismatch recorded
.aws protection, projectless sessions, opt-in Guardian capabilities0.159.0 and 0.160.0Release notes, PRs #48176, #49160, #49036, #49057Release-tracked
Config referenceNew keys above not listed; the model example is gpt-6.1-sollearn.chatgpt.com/docs/config-file/config-referenceNot verified

September 26, 2026 verification

Baseline: Codex CLI 0.157.1 (September 26). npm latest=0.157.1 and alpha=0.159.0-alpha.4 were checked on September 26, 2026 KST. Official release text, the models page, API model pages, and the bundled model catalog were compared; new features were not run on an installed CLI.

ItemHandbook valueSourceResult
Stable releases0.155.0 (09-17), 0.155.1 (09-18), 0.156.0 (09-22), 0.156.1 (09-23), 0.157.0 (09-25), 0.157.1 (09-26)GitHub releases rust-v0.155.0–rust-v0.157.1, official changelogPass
npm dist-tagslatest=0.157.1, alpha=0.159.0-alpha.4npm view @openai/codex dist-tagsPass
GPT-6 Sol and Luna launchRollout from 2026-09-22; Work and Codex only (not Chat); Enterprise/Edu admins enableChangelog 2026-09-22, models pagePass
Picker availabilityCLI 0.156.1; Bedrock and migration prompts in 0.157.0Releases rust-v0.156.1, rust-v0.157.0Pass
GPT-6 Sol API specs1,050,000 context, 128K output, $2 / $0.20 / $10, cutoff 2026-04-20, effort none–max, default mediumdevelopers.openai.com/api/docs/models/gpt-6-solPass
GPT-6 Luna API specs1,050,000 context, 128K output, $0.10 / $0.01 / $0.50, cutoff 2026-05-18developers.openai.com/api/docs/models/gpt-6-lunaPass
Suggested starting effortSol Medium, Luna High (up to Max, no Ultra), Astra Light (low)Models page, "Pick a reasoning effort"Pass
Bundled default modelGPT-6 Astra unchangedcodex-rs/models-manager/models.json at rust-v0.157.1: Astra priority 1Pass (source)
GPT-5.6 migration promptsSol/Terra → GPT-6 Sol, Luna → GPT-6 LunaSame catalog, upgrade fieldsPass (source)
GPT-5.5 retirementChatGPT-sign-in Codex on 2026-10-14; API unaffected; paid → GPT-6 Sol, Free/Go → GPT-6 LunaChangelog 2026-09-14, models pagePass
GPT-5.3-Codex-SparkDeprecated 2026-09-14Changelog 2026-09-14Pass
Worktrees and background serverWorktrees on by default (0.156.0), automatic background server (0.157.0), --no-daemon, /daemonRelease notesPass
/voice, /tui, /usageExperimental in 0.155.0 → default in 0.156.0; fullscreen transcripts default (0.157.0); analytics dashboardRelease notes (not yet in the official slash table)Release-tracked
PersonalityTUI selection removed; friendly/pragmatic no longer change style0.156.0 (#44935, #45809); the official slash table still lists /personalityMismatch recorded
Config referenceNew voice/daemon keys not listedlearn.chatgpt.com/docs/config-file/config-referenceNot verified
Old URL migrationdevelopers.openai.com/codex/* links replaced per redirect targetcurl -sIL final URL and statusPass

September 12, 2026 verification

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-6.1 Sol, GPT-6 Luna, and reasoning levels by task risk, cost, and latency, and plan the GPT-5.6 and GPT-5.5 transitions.

Cmd. /model

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

Updates

Change log for the Advanced Codex Usage handbook.

Release coverage history

Codex Command Master · Codex CLI: Dated release coverage and handbook update decisions, preserved separately from current instructions.

Handbook updates

Codex Command Master · Codex CLI: Recent handbook structure improvements with links to dated release coverage and audit records.

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

Rechecked 2026-10-23 · Codex CLI 0.163.0October 10, 2026 verificationOctober 7, 2026 verificationSeptember 26, 2026 verificationSeptember 12, 2026 verificationSource Baseline2026-09-05 Cross-ChecksSetupSafetyOperations