OpenAI Codex: Terminal and Cloud AI Coding Agent

Official Sources

What Codex Is

OpenAI Codex is an AI coding agent that can work from the terminal, cloud tasks, IDEs, GitHub, Slack, and Linear. You give it a scoped task, it reads the codebase, edits files, runs commands, and returns a reviewable diff or branch depending on the workflow.

For model-selection context, compare this with Codex vs Claude Code in April 2026: Which Agent for Which Job and OpenAI vs Anthropic in 2026 - Models, Tools, and Developer Experience; model quality matters most when it is tied to a concrete coding workflow. If you are asking whether Codex can do more than code, read Codex as a general-purpose AI agent.

It is not an autocomplete tool. It is not inline suggestions. Codex operates as a full agent: reading files, running commands, installing dependencies, executing tests, and iterating on failures. In the CLI, that happens in your local checkout. In Codex cloud tasks, it happens in a configured environment.

The CLI is the fastest interface for local developer work. You install it via npm, authenticate with your OpenAI account, and run codex exec "your prompt" from within a repository. Codex reads your project structure, understands the codebase, and executes against it.

Local and Cloud Execution

Codex has two practical execution modes. The CLI runs locally in the directory you choose. Cloud tasks run in an isolated environment connected to your repository and integrations.

Cloud execution has clear advantages for issue backlogs, code review follow-ups, and PR-style work. Your local machine stays clean, the branch is the checkpoint, and the task can keep running while you do something else.

The tradeoff is environment fidelity. Local CLI work can reach your local dev server, test database, and running services. Cloud tasks need those dependencies represented in the configured environment.

Treat network access as an explicit policy choice. Cloud tasks should only receive the internet, secrets, and service access they actually need.

GitHub Integration

Codex connects directly to your GitHub repositories. You can trigger tasks from the CLI, from the ChatGPT web interface, or by tagging Codex in a GitHub issue or pull request.

The most practical workflow for TypeScript projects:

1. Open an issue describing a bug or feature
2. Tag Codex in a comment
3. Codex clones the repo, creates a branch, implements the change, and opens a PR
4. You review the diff and merge

This works well for contained tasks: fixing a type error, adding a utility function, writing tests for an existing module, updating dependencies. The PR includes the full diff and a summary of what the agent did and why.

For larger features, you can scope the work with an agent.md file in your repository root. This file acts as persistent instructions, similar to a CLAUDE.md for Claude Code. You define coding standards, architectural preferences, and constraints. Codex reads this file before starting any task.

TypeScript Workflow

Codex handles TypeScript projects well. It reads tsconfig.json, respects your compiler options, and runs tsc to validate its output. If type errors surface, the agent iterates until the build passes.

A typical TypeScript workflow with Codex:

# Install the CLI
npm install -g @openai/codex

# Authenticate
codex auth

# Run a task against your current repo
codex exec "Add input validation to the createUser function in src/api/users.ts. Use zod schemas. Add tests."

Codex reads the existing code, identifies the function signature and its callers, generates a zod schema matching the expected input shape, wraps the function with validation, and writes test cases. It runs the test suite to confirm nothing breaks.

For monorepos with multiple tsconfig files, Codex navigates the project references correctly. It understands workspace configurations for pnpm, npm, and yarn workspaces.

Where it falls short: Codex sometimes generates overly verbose TypeScript. Extra type annotations where inference would suffice, unnecessary generics, redundant null checks. You will want to review and tighten the output.

Pricing

Codex pricing now spans ChatGPT Free, Go, Plus, Pro, Business, Edu, Enterprise, and API-key usage.

For heavy CLI usage, token consumption matters. A typical Codex task can read many files, implement a feature, run tests, and iterate. For automation-heavy setups, API-key usage is billed at standard API rates.

If you want the cheapest interactive starting point, compare the current Plus plan against API-key usage. If you run Codex all day, compare higher ChatGPT plans against direct API billing.

Codex vs Claude Code

Both are agentic coding tools. Both read your codebase, make changes, and iterate on errors. The core differences come down to architecture, workflow, and where each tool excels.

Execution model. Codex can run locally through the CLI or remotely through cloud tasks. Claude Code runs locally on your machine. Use local agents when immediate access to databases, servers, browsers, and logs matters. Use cloud tasks when branch isolation and async completion matter more.

Context. Claude Code operates inside your terminal session. It sees your working directory, your git state, your running processes. Codex CLI sees the selected local checkout, while cloud tasks see the repository and configured environment. Claude Code can chain commands, install tools, and interact with MCP servers.

TypeScript tooling. Both handle TypeScript well. Claude Code benefits from being able to run your dev server locally and verify changes in real time. Codex validates against your build configuration but cannot render a page or hit a local API.

Autonomy. Codex is designed for fire-and-forget tasks. Hand it an issue, walk away, review the PR later. Claude Code is better for interactive development where you steer the agent with follow-up prompts, review intermediate output, and adjust direction mid-task.

Integration surface. Claude Code connects to MCP servers, giving it access to browsers, databases, external APIs, and custom tools. Codex integrates tightly with GitHub but has a narrower integration surface.

For a deeper look at model capabilities across these tools, see the model comparison on SubAgent.

When to Use Each

Use Codex when you want hands-off task execution: bug fixes from issues, test generation, dependency updates, code review automation. The GitHub integration makes it natural for teams that manage work through issues and PRs.

Use Claude Code when you want interactive, iterative development: building features with real-time feedback, debugging with access to logs and local services, working across multiple files with full project context.

The tools are not mutually exclusive. Running both on the same codebase is a valid workflow. Codex handles the backlog of well-defined tasks while Claude Code drives the exploratory, high-context work.

If you want to practice that workflow step by step, the Agentic Coding course walks through Claude Code, Codex CLI, decomposition, and real agentic development patterns.

Frequently Asked Questions

What is OpenAI Codex?

OpenAI Codex is an AI coding agent for terminal, cloud, IDE, GitHub, Slack, and Linear workflows. It reads a codebase, edits files, runs commands, and returns a reviewable diff, branch, or pull request depending on how you start the task. It is an agentic tool, not an autocomplete engine.

How much does OpenAI Codex cost?

Codex pricing includes ChatGPT Free, Go, Plus, Pro, Business, Edu, Enterprise, and API-key options. Plus starts at $20/month, Pro starts at $100/month for higher usage limits, and API-key usage is billed separately at standard API rates.

What is the difference between Codex and Claude Code?

Codex can run locally through the CLI or remotely through cloud tasks, with GitHub support for fire-and-forget tasks like bug fixes and PR generation. Claude Code runs locally on your machine with direct filesystem access, MCP server support, and interactive development capabilities. Codex is best for terminal and async task delegation; Claude Code is best for iterative, high-context work.

Can Codex work with TypeScript projects?

Yes. Codex reads your tsconfig.json, respects compiler options, runs tsc to validate output, and iterates until the build passes. It handles monorepos with multiple tsconfig files and understands pnpm, npm, and yarn workspace configurations.