← All commands
THE COMMAND REFERENCE

codex

Work with an AI coding assistant from the terminal.

Last updated

Portable / common

Implementation-level reference; examples are not certified for every installed version.

Overview

codex starts the Codex command-line assistant, an AI tool that reads and changes the code in a project folder at your request, and runs commands with your approval. Run codex in a project for an interactive session, or give it a task as an argument. The text of your task and the files it reads are sent to a service, so the examples that start a task are reviewed only.

Background

codex is the command of the Codex CLI, with its documentation in its repository. The tool tested here is codex-cli 0.164.0. The version and help examples are reviewed only too, because their text changes with each release.

Examples

Print the installed version; reviewed only, because the output changes with each release:

codex --version

Read the help text; reviewed only, because it changes with each release:

codex --help

Give it a task and run it without an interactive session; reviewed only because it sends text to a service and can change files:

codex exec "Add a unit test for the parser"

Start an interactive session in the current project; reviewed only:

codex

Subcommands

codex exec runs one task without the interactive screen. codex alone starts an interactive session. codex --help lists the other commands and options.

Common mistakes

Everything codex reads can leave your machine, so keep secrets out of the folder it works in. It can change files and run commands: read what it proposes before you approve, work in a version-controlled folder, and use its sandbox and approval settings to limit what it may do. Do not run it with approvals switched off in a folder that has anything you cannot lose. The answers can be wrong; test the changes. A session uses your account and may cost money or use a quota.

Portability

The tool changes quickly; check codex --help for your version. The Common examples are reviewed only.

References

Original explanations, with upstream documentation for further reading. FreeBSD references are comparison material, not a claim of Apple version equivalence.