AI IDE List
AI IDE List
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.