codex

Deep code analysis and generation with maximum reasoning power.

When to Use

• Complex code analysis requiring deep understanding
• Large-scale refactoring across multiple files
• Automated code generation with safety controls
• Tasks requiring specialized reasoning models

Default Configuration

• Model: gpt-5.2-codex
• Reasoning: xhigh (maximum thinking depth)

Command Pattern

```bash

codex e -m gpt-5.2-codex -c model_reasoning_effort=xhigh \

--dangerously-bypass-approvals-and-sandbox \

--skip-git-repo-check \

-C \

""

```

Parameters

• (required): Task description, supports @file references
• -m : Override model (e.g., gpt-5.1-codex, gpt-5)
• -c model_reasoning_effort=: Override reasoning (low/medium/high/xhigh)
• -C : Working directory (default: current)

Examples

Basic code analysis:

```bash

codex e -m gpt-5.2-codex -c model_reasoning_effort=xhigh \

--dangerously-bypass-approvals-and-sandbox \

--skip-git-repo-check \

"explain @src/main.ts"

```

Refactoring with custom model:

```bash

codex e -m gpt-5.1-codex -c model_reasoning_effort=high \

--dangerously-bypass-approvals-and-sandbox \

--skip-git-repo-check \

"refactor @src/utils for performance"

```

Multi-file analysis:

```bash

codex e -m gpt-5.2-codex -c model_reasoning_effort=xhigh \

--dangerously-bypass-approvals-and-sandbox \

--skip-git-repo-check \

-C /path/to/project \

"analyze @. and find security issues"

```

---

Online research with web search and page content fetching.

When to Use

• Online research and documentation lookup
• Fetch and summarize specific web pages (GitHub repos, docs, articles)
• Current information retrieval
• API documentation search
• Technology comparison and recommendations

Default Configuration

• Model: gpt-5.1-codex
• Reasoning: high
• Web search: enabled

Command Pattern

```bash

codex e -m gpt-5.1-codex -c model_reasoning_effort=high \

--enable web_search_request \

--dangerously-bypass-approvals-and-sandbox \

--skip-git-repo-check \

""

```

Parameters

• (required): Search query or research task
• -m : Override model
• -c model_reasoning_effort=: Override reasoning (low/medium/high/xhigh)
• --enable web_search_request: Enable web search (required for this capability)

Alternative: Config File

Add to ~/.codex/config.toml:

```toml

[features]

web_search_request = true

```

Examples

Fetch GitHub repo:

```bash

codex e -m gpt-5.1-codex -c model_reasoning_effort=high \

--enable web_search_request \

--dangerously-bypass-approvals-and-sandbox \

--skip-git-repo-check \

"Fetch and summarize https://github.com/user/repo"

```

Documentation search:

```bash

codex e -m gpt-5.1-codex -c model_reasoning_effort=high \

--enable web_search_request \

--dangerously-bypass-approvals-and-sandbox \

--skip-git-repo-check \

"find the latest React 19 hooks documentation"

```

Technology research:

```bash

codex e -m gpt-5.1-codex -c model_reasoning_effort=high \

--enable web_search_request \

--dangerously-bypass-approvals-and-sandbox \

--skip-git-repo-check \

"compare Vite vs Webpack for React projects in 2024"

```

---

Both capabilities support session resumption for multi-turn conversations.

Resume Command

```bash

codex e resume ""

```

Example

```bash

# First session (code generation)

codex e -m gpt-5.2-codex -c model_reasoning_effort=xhigh \

--dangerously-bypass-approvals-and-sandbox \

--skip-git-repo-check \

"add comments to @utils.js"

# Output includes: thread_id in JSON output

# Continue the conversation

codex e resume "now add type hints"

```

---

• Requires Codex CLI installed and authenticated
• @file syntax references files relative to working directory
• @. references entire working directory
• JSON output available with --json flag for programmatic use
• All commands use --dangerously-bypass-approvals-and-sandbox for automation
• Use --skip-git-repo-check to work in any directory