OpenAI CodexVerificado em 18 de junho de 2026

Cheatsheet do Codex CLI

Uma referência compacta para comandos documentados do Codex CLI, flags comuns, execuções não interativas, MCP, plugins e slash commands integrados.

codex

Trabalho interativo em repositórios locais

codex exec

Scripts e tarefas pontuais

codex cloud

Fluxos de tarefas na Cloud

/permissions

Controle da sessão ao vivo

Começo rápido

Comandos que você provavelmente usará primeiro

Cobre os fluxos mais comuns de trabalho local, automação, Cloud e controle interativo.

Trabalho interativo
codex

Abre a UI de terminal no workspace atual.

Automação pontual
codex exec "fix the failing test"

Executa o Codex sem interação e transmite o resultado.

Continuar trabalho
codex resume --last

Retorna para a sessão interativa mais recente.

Aplicar saída da Cloud
codex apply TASK_ID

Aplica o diff mais recente de uma tarefa do Codex Cloud.

Permissões da sessão
/permissions

Ajusta o que o Codex pode fazer sem perguntar.

Controle de modelo
/model

Escolhe o modelo ativo e o esforço de raciocínio.

Opções globais

codex [OPTIONS] [PROMPT]

Essas opções se aplicam principalmente ao comando codex base. Muitas também são aceitas por subcomandos.

--add-dir

Tipo / Valores

path

Uso

Add another writable directory beside the main workspace.

--ask-for-approval, -a

Tipo / Valores

untrusted | on-request | never

Uso

Choose when Codex asks before running commands.

--cd, -C

Tipo / Valores

path

Uso

Set the working directory before the agent starts.

--config, -c

Tipo / Valores

key=value

Uso

Override configuration values inline.

--dangerously-bypass-approvals-and-sandbox

Tipo / Valores

boolean

Uso

Disable approvals and sandboxing for externally isolated environments.

--yolo

Tipo / Valores

boolean

Uso

Alias for the dangerous bypass mode.

--dangerously-bypass-hook-trust

Tipo / Valores

boolean

Uso

Run enabled hooks without persisted trust for this run.

--disable

Tipo / Valores

feature

Uso

Force-disable a feature flag.

--enable

Tipo / Valores

feature

Uso

Force-enable a feature flag.

--image, -i

Tipo / Valores

path[,path...]

Uso

Attach images to the initial prompt.

--model, -m

Tipo / Valores

string

Uso

Override the configured model.

--no-alt-screen

Tipo / Valores

boolean

Uso

Disable alternate-screen mode in the terminal UI.

--oss

Tipo / Valores

boolean

Uso

Use a local open-source model provider, commonly with Ollama.

--profile, -p

Tipo / Valores

string

Uso

Load a named Codex config profile.

--remote

Tipo / Valores

ws://host:port | wss://host:port | unix:// | unix://PATH

Uso

Connect the TUI to a remote app-server.

--remote-auth-token-env

Tipo / Valores

ENV_VAR

Uso

Read the remote bearer token from an environment variable.

--sandbox, -s

Tipo / Valores

read-only | workspace-write | danger-full-access

Uso

Select the sandbox policy for shell commands.

--search

Tipo / Valores

boolean

Uso

Enable live web search.

--strict-config

Tipo / Valores

boolean

Uso

Error on unknown config fields.

PROMPT

Tipo / Valores

string

Uso

Optional starting instruction.

Use --dangerously-bypass-approvals-and-sandbox ou --yolo apenas quando o ambiente ao redor já tiver isolamento forte.

Visão geral

Comandos de topo documentados

Comandos Stable são voltados ao uso regular. Comandos Experimental podem mudar conforme o Codex evolui.

codexStable

Inicia a UI interativa de terminal.

codex appStable

Abre o aplicativo desktop do Codex.

codex app-serverExperimental

Start the local app server for development or debugging.

codex applyStable

Apply a Codex Cloud task diff locally.

codex aStable

Alias for codex apply.

codex archiveStable

Archive a saved interactive session.

codex cloudExperimental

Browse or run Codex Cloud tasks from the terminal.

codex cloud-tasksExperimental

Alias for codex cloud.

codex completionStable

Generate shell completion scripts.

codex debug app-server send-message-v2Experimental

Send a V2 test message to app-server.

codex debug modelsExperimental

Print the model catalog Codex sees.

codex doctorStable

Create a local diagnostic report.

codex execStable

Executa o Codex em modo não interativo.

codex eStable

Alias for codex exec.

codex execpolicyExperimental

Evaluate command execution policy rules.

codex featuresStable

List or persist feature flag overrides.

codex forkStable

Fork a previous session into a new thread.

codex loginStable

Autentica o Codex.

codex logoutStable

Remove credenciais armazenadas.

codex mcpExperimental

Manage MCP server definitions and auth.

codex mcp-serverExperimental

Run Codex itself as an MCP server.

codex pluginExperimental

Install, list, and remove Codex plugins.

codex plugin marketplaceExperimental

Manage plugin marketplace sources.

codex remote-controlExperimental

Ensure app-server remote control support is enabled.

codex resumeStable

Resume a previous interactive session.

codex sandboxExperimental

Run commands inside Codex sandboxes.

codex unarchiveStable

Restore an archived session.

codex updateStable

Check for or apply a CLI update when supported.

Subcomandos

Matriz de comandos por fluxo

Agrupado por workflow para manter a página fácil de escanear sem perder a cobertura documentada.

codex

Uso

Inicia a UI interativa de terminal.

codex "PROMPT"

Uso

Start the TUI with an initial instruction.

codex --image path

Tipo / Valores

path[,path...]

Uso

Start with one or more image attachments.

codex --remote ENDPOINT

Tipo / Valores

ws://, wss://, unix://

Uso

Connect the TUI to a remote app-server.

codex app

Uso

Open the desktop app.

codex app PATH

Tipo / Valores

path

Uso

Open a workspace path in Codex Desktop.

codex app --download-url URL

Tipo / Valores

url

Uso

Override the desktop installer download URL.

codex app-server

Uso

Start the local app server.

codex app-server --listen VALUE

Tipo / Valores

stdio:// | ws://IP:PORT | unix:// | unix://PATH | off

Uso

Set the transport listener.

codex app-server --stdio

Tipo / Valores

boolean

Uso

Use stdio transport.

codex app-server --analytics-default-enabled

Tipo / Valores

boolean

Uso

Default analytics to enabled for app-server clients.

codex app-server --ws-auth MODE

Tipo / Valores

capability-token | signed-bearer-token

Uso

Choose WebSocket authentication mode.

codex app-server --ws-audience VALUE

Tipo / Valores

string

Uso

Expected JWT audience.

codex app-server --ws-issuer VALUE

Tipo / Valores

string

Uso

Expected JWT issuer.

codex app-server --ws-max-clock-skew-seconds N

Tipo / Valores

number

Uso

Allow clock skew for token time checks.

codex app-server --ws-shared-secret-file PATH

Tipo / Valores

absolute path

Uso

HMAC secret file for signed bearer tokens.

codex app-server --ws-token-file PATH

Tipo / Valores

absolute path

Uso

Capability token file.

codex app-server --ws-token-sha256 HEX

Tipo / Valores

hex SHA-256

Uso

Expected SHA-256 digest for a token.

codex remote-control

Uso

Ensure the local app-server daemon is running with remote-control enabled.

codex apply TASK_ID

Tipo / Valores

string

Uso

Apply a Codex Cloud task diff locally.

codex a TASK_ID

Tipo / Valores

string

Uso

Alias for codex apply.

codex archive SESSION

Tipo / Valores

session ID | session name

Uso

Archive a saved session by ID or name.

codex unarchive SESSION

Tipo / Valores

session ID | session name

Uso

Restore an archived session by ID or name.

codex archive --remote ENDPOINT SESSION

Tipo / Valores

endpoint

Uso

Connect to remote app-server before changing archive state.

codex cloud

Uso

Browse or run Cloud tasks from the terminal.

codex cloud exec QUERY

Tipo / Valores

string

Uso

Submit a Cloud task directly.

codex cloud exec --attempts N

Tipo / Valores

1-4

Uso

Set the number of assistant attempts.

codex cloud exec --env ENV_ID

Tipo / Valores

ENV_ID

Uso

Target a Codex Cloud environment.

codex cloud list

Uso

List recent Cloud tasks.

codex cloud list --cursor VALUE

Tipo / Valores

string

Uso

Use a pagination cursor.

codex cloud list --env ENV_ID

Tipo / Valores

ENV_ID

Uso

Filter by environment.

codex cloud list --json

Tipo / Valores

boolean

Uso

Emit JSON output.

codex cloud list --limit N

Tipo / Valores

1-20

Uso

Limit the number of tasks returned.

codex cloud-tasks

Uso

Alias for codex cloud.

codex resume

Uso

Resume an interactive session.

codex resume SESSION_ID

Tipo / Valores

uuid

Uso

Resume a specific interactive session.

codex resume --all

Tipo / Valores

boolean

Uso

Show sessions outside the current directory.

codex resume --last

Tipo / Valores

boolean

Uso

Resume the most recent session.

codex fork

Uso

Fork a previous session into a new thread.

codex fork SESSION_ID

Tipo / Valores

uuid

Uso

Fork a specific session.

codex fork --all

Tipo / Valores

boolean

Uso

Show sessions outside the current directory.

codex fork --last

Tipo / Valores

boolean

Uso

Fork the most recent session.

Modo não interativo

Opções de codex exec

Use estas flags quando o Codex for iniciado como comando pontual no terminal, script ou automação.

--cd, -C

Tipo / Valores

path

Uso

Set the workspace root.

--color

Tipo / Valores

always | never | auto

Uso

Control ANSI color output.

--dangerously-bypass-approvals-and-sandbox

Tipo / Valores

boolean

Uso

Disable approvals and sandboxing.

--yolo

Tipo / Valores

boolean

Uso

Alias for dangerous bypass mode.

--dangerously-bypass-hook-trust

Tipo / Valores

boolean

Uso

Run hooks without persisted trust.

--ephemeral

Tipo / Valores

boolean

Uso

Do not persist session rollout files.

--full-auto

Tipo / Valores

boolean

Uso

Deprecated compatibility option.

--ignore-rules

Tipo / Valores

boolean

Uso

Do not load execpolicy rule files.

--ignore-user-config

Tipo / Valores

boolean

Uso

Do not load user config.

--image, -i

Tipo / Valores

path[,path...]

Uso

Attach images to the first message.

--json

Tipo / Valores

boolean

Uso

Emit NDJSON events.

--experimental-json

Tipo / Valores

boolean

Uso

Older alias for JSON event output.

--model, -m

Tipo / Valores

string

Uso

Override the model.

--oss

Tipo / Valores

boolean

Uso

Use a local OSS model provider.

--output-last-message, -o

Tipo / Valores

path

Uso

Write the final assistant message to a file.

--output-schema

Tipo / Valores

path

Uso

Validate the final output against a JSON Schema.

--profile, -p

Tipo / Valores

string

Uso

Load a config profile.

--sandbox, -s

Tipo / Valores

read-only | workspace-write | danger-full-access

Uso

Choose the sandbox policy.

--skip-git-repo-check

Tipo / Valores

boolean

Uso

Allow running outside a Git repository.

--config, -c

Tipo / Valores

key=value

Uso

Override config inline.

PROMPT

Tipo / Valores

string | -

Uso

Initial instruction. Use - to read from stdin.

TUI interativa

Slash commands integrados

Digite / no composer do Codex para abrir o popup de slash commands.

/permissions

Set what Codex may do without asking.

/ide

Include IDE context such as open files and selection.

/keymap

Remap TUI keyboard shortcuts.

/vim

Toggle Vim mode for the composer.

/sandbox-add-read-dir

Add sandbox read access to a directory on Windows.

/agent

Switch the active agent thread.

/apps

Browse apps or connectors and insert one into the prompt.

/plugins

Browse installed and discoverable plugins.

/hooks

Review lifecycle hooks.

/clear

Clear the terminal and start a fresh chat.

/archive

Archive the current session and exit Codex.

/compact

Summarize visible conversation to free tokens.

/copy

Copy the latest completed Codex output.

/diff

Show Git diff, including untracked files.

/exit

Exit the CLI.

/experimental

Toggle experimental features.

/approve

Approve one retry after an auto-review denial.

/memories

Configure memory usage and generation.

/skills

Browse and use skills.

/feedback

Send logs to Codex maintainers.

/init

Generate an AGENTS.md scaffold.

/logout

Sign out of Codex.

/mcp

List configured MCP tools.

/mcp verbose

Show MCP server details.

/mention

Attach a file or folder to the conversation.

/model

Choose model and reasoning effort.

/fast

Toggle or inspect the Fast service tier.

/plan

Switch to plan mode.

/goal

Set, view, pause, resume, or clear a goal.

/personality

Choose communication style.

/ps

Show experimental background terminals.

/stop

Stop all background terminals.

/fork

Fork the current conversation into a new thread.

/side

Start an ephemeral side conversation.

/btw

Start a short side conversation.

/raw

Toggle raw scrollback mode.

/resume

Resume a saved conversation.

/new

Start a new conversation in the same CLI session.

/quit

Exit the CLI.

/review

Ask Codex to review the working tree.

/status

Display session config and token usage.

/debug-config

Print config-layer diagnostics.

/statusline

Configure TUI status-line fields.

/title

Configure terminal title fields.

/theme

Choose syntax-highlighting theme.

Formas comuns

/fast on

Turn the Fast tier on.

/fast off

Turn the Fast tier off.

/fast status

Show Fast tier status.

/personality friendly

Use the friendly communication style.

/personality pragmatic

Use the pragmatic communication style.

/personality none

Disable personality styling.

/goal <objective>

Set a task goal.

/goal pause

Pause the current goal.

/goal resume

Resume the current goal.

/goal clear

Clear the current goal.

/prompts:<name>

Run a local custom prompt. Custom prompts are deprecated in favor of skills.

Extensões locais

Os slash commands integrados são finitos, mas skills, plugins, MCP servers e arquivos /prompts:* obsoletos podem adicionar capacidades locais.

Fontes

Documentação oficial

Nomes de comandos, flags, maturidade e cobertura de slash commands seguem as páginas oficiais do OpenAI Codex CLI.

Nota de leitura

Esta página é uma referência rápida, não uma reprodução completa da documentação oficial.