AI IDE List
AI IDE List
OpenAI Codex최종 확인: 2026년 6월 18일

Codex CLI 치트시트

공식 문서에 있는 Codex CLI 명령, 자주 쓰는 플래그, 비대화형 실행, MCP, 플러그인 관리, 내장 slash commands를 빠르게 확인합니다.

codex

로컬 저장소 대화형 작업

codex exec

스크립트와 단발성 작업

codex cloud

Cloud 작업 워크플로

/permissions

실시간 세션 제어

빠른 시작

먼저 보게 되는 명령

로컬 작업, 자동화, Cloud 작업, 대화형 세션 제어에서 자주 쓰는 흐름입니다.

대화형 작업
codex

현재 워크스페이스에서 터미널 UI를 엽니다.

단발성 자동화
codex exec "fix the failing test"

Codex를 비대화형으로 실행하고 결과를 스트리밍합니다.

작업 이어가기
codex resume --last

가장 최근 대화형 세션으로 돌아갑니다.

Cloud 출력 적용
codex apply TASK_ID

Codex Cloud 작업의 최신 diff를 적용합니다.

세션 권한
/permissions

Codex가 확인 없이 수행할 수 있는 작업을 조정합니다.

모델 제어
/model

활성 모델과 reasoning effort를 선택합니다.

전역 옵션

codex [OPTIONS] [PROMPT]

주로 기본 codex 명령에 적용되는 옵션입니다. 많은 옵션은 하위 명령에서도 사용할 수 있습니다.

--add-dir

타입 / 값

path

용도

Add another writable directory beside the main workspace.

--ask-for-approval, -a

타입 / 값

untrusted | on-request | never

용도

Choose when Codex asks before running commands.

--cd, -C

타입 / 값

path

용도

Set the working directory before the agent starts.

--config, -c

타입 / 값

key=value

용도

Override configuration values inline.

--dangerously-bypass-approvals-and-sandbox

타입 / 값

boolean

용도

Disable approvals and sandboxing for externally isolated environments.

--yolo

타입 / 값

boolean

용도

Alias for the dangerous bypass mode.

--dangerously-bypass-hook-trust

타입 / 값

boolean

용도

Run enabled hooks without persisted trust for this run.

--disable

타입 / 값

feature

용도

Force-disable a feature flag.

--enable

타입 / 값

feature

용도

Force-enable a feature flag.

--image, -i

타입 / 값

path[,path...]

용도

Attach images to the initial prompt.

--model, -m

타입 / 값

string

용도

Override the configured model.

--no-alt-screen

타입 / 값

boolean

용도

Disable alternate-screen mode in the terminal UI.

--oss

타입 / 값

boolean

용도

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

--profile, -p

타입 / 값

string

용도

Load a named Codex config profile.

--remote

타입 / 값

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

용도

Connect the TUI to a remote app-server.

--remote-auth-token-env

타입 / 값

ENV_VAR

용도

Read the remote bearer token from an environment variable.

--sandbox, -s

타입 / 값

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

용도

Select the sandbox policy for shell commands.

--search

타입 / 값

boolean

용도

Enable live web search.

--strict-config

타입 / 값

boolean

용도

Error on unknown config fields.

PROMPT

타입 / 값

string

용도

Optional starting instruction.

--dangerously-bypass-approvals-and-sandbox 또는 --yolo는 주변 환경이 강하게 격리되어 있을 때만 사용하세요.

명령 개요

문서화된 최상위 명령

Stable 명령은 일반 사용을 위한 것이며, Experimental 명령은 Codex 변화에 따라 달라질 수 있습니다.

codexStable

대화형 터미널 UI를 시작합니다.

codex appStable

Codex 데스크톱 앱을 엽니다.

codex app-serverExperimental

개발 또는 디버깅용 로컬 app-server를 시작합니다.

codex applyStable

Codex Cloud 작업 diff를 로컬에 적용합니다.

codex aStable

Alias for codex apply.

codex archiveStable

저장된 대화형 세션을 보관합니다.

codex cloudExperimental

Browse or run Codex Cloud tasks from the terminal.

codex cloud-tasksExperimental

Alias for codex cloud.

codex completionStable

shell 자동완성 스크립트를 생성합니다.

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

로컬 진단 보고서를 만듭니다.

codex execStable

Codex를 비대화형으로 실행합니다.

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

Codex를 인증합니다.

codex logoutStable

저장된 자격 증명을 제거합니다.

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

이전 대화형 세션을 재개합니다.

codex sandboxExperimental

Codex 샌드박스 안에서 명령을 실행합니다.

codex unarchiveStable

Restore an archived session.

codex updateStable

Check for or apply a CLI update when supported.

하위 명령

워크플로별 명령 매트릭스

공식 문서 범위를 유지하면서 빠르게 훑어볼 수 있도록 워크플로별로 정리했습니다.

codex

용도

대화형 터미널 UI를 시작합니다.

codex "PROMPT"

용도

Start the TUI with an initial instruction.

codex --image path

타입 / 값

path[,path...]

용도

Start with one or more image attachments.

codex --remote ENDPOINT

타입 / 값

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

용도

Connect the TUI to a remote app-server.

codex app

용도

Open the desktop app.

codex app PATH

타입 / 값

path

용도

Open a workspace path in Codex Desktop.

codex app --download-url URL

타입 / 값

url

용도

Override the desktop installer download URL.

codex app-server

용도

Start the local app server.

codex app-server --listen VALUE

타입 / 값

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

용도

Set the transport listener.

codex app-server --stdio

타입 / 값

boolean

용도

Use stdio transport.

codex app-server --analytics-default-enabled

타입 / 값

boolean

용도

Default analytics to enabled for app-server clients.

codex app-server --ws-auth MODE

타입 / 값

capability-token | signed-bearer-token

용도

Choose WebSocket authentication mode.

codex app-server --ws-audience VALUE

타입 / 값

string

용도

Expected JWT audience.

codex app-server --ws-issuer VALUE

타입 / 값

string

용도

Expected JWT issuer.

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

타입 / 값

number

용도

Allow clock skew for token time checks.

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

타입 / 값

absolute path

용도

HMAC secret file for signed bearer tokens.

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

타입 / 값

absolute path

용도

Capability token file.

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

타입 / 값

hex SHA-256

용도

Expected SHA-256 digest for a token.

codex remote-control

용도

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

codex apply TASK_ID

타입 / 값

string

용도

Codex Cloud 작업 diff를 로컬에 적용합니다.

codex a TASK_ID

타입 / 값

string

용도

Alias for codex apply.

codex archive SESSION

타입 / 값

session ID | session name

용도

Archive a saved session by ID or name.

codex unarchive SESSION

타입 / 값

session ID | session name

용도

Restore an archived session by ID or name.

codex archive --remote ENDPOINT SESSION

타입 / 값

endpoint

용도

Connect to remote app-server before changing archive state.

codex cloud

용도

Browse or run Cloud tasks from the terminal.

codex cloud exec QUERY

타입 / 값

string

용도

Submit a Cloud task directly.

codex cloud exec --attempts N

타입 / 값

1-4

용도

Set the number of assistant attempts.

codex cloud exec --env ENV_ID

타입 / 값

ENV_ID

용도

Target a Codex Cloud environment.

codex cloud list

용도

List recent Cloud tasks.

codex cloud list --cursor VALUE

타입 / 값

string

용도

Use a pagination cursor.

codex cloud list --env ENV_ID

타입 / 값

ENV_ID

용도

Filter by environment.

codex cloud list --json

타입 / 값

boolean

용도

Emit JSON output.

codex cloud list --limit N

타입 / 값

1-20

용도

Limit the number of tasks returned.

codex cloud-tasks

용도

Alias for codex cloud.

codex resume

용도

Resume an interactive session.

codex resume SESSION_ID

타입 / 값

uuid

용도

Resume a specific interactive session.

codex resume --all

타입 / 값

boolean

용도

Show sessions outside the current directory.

codex resume --last

타입 / 값

boolean

용도

Resume the most recent session.

codex fork

용도

Fork a previous session into a new thread.

codex fork SESSION_ID

타입 / 값

uuid

용도

Fork a specific session.

codex fork --all

타입 / 값

boolean

용도

Show sessions outside the current directory.

codex fork --last

타입 / 값

boolean

용도

Fork the most recent session.

비대화형 모드

codex exec 옵션

터미널, 스크립트, 자동화에서 Codex를 단발성 명령으로 실행할 때 사용합니다.

--cd, -C

타입 / 값

path

용도

Set the workspace root.

--color

타입 / 값

always | never | auto

용도

Control ANSI color output.

--dangerously-bypass-approvals-and-sandbox

타입 / 값

boolean

용도

Disable approvals and sandboxing.

--yolo

타입 / 값

boolean

용도

Alias for dangerous bypass mode.

--dangerously-bypass-hook-trust

타입 / 값

boolean

용도

Run hooks without persisted trust.

--ephemeral

타입 / 값

boolean

용도

Do not persist session rollout files.

--full-auto

타입 / 값

boolean

용도

Deprecated compatibility option.

--ignore-rules

타입 / 값

boolean

용도

Do not load execpolicy rule files.

--ignore-user-config

타입 / 값

boolean

용도

Do not load user config.

--image, -i

타입 / 값

path[,path...]

용도

Attach images to the first message.

--json

타입 / 값

boolean

용도

Emit NDJSON events.

--experimental-json

타입 / 값

boolean

용도

Older alias for JSON event output.

--model, -m

타입 / 값

string

용도

Override the model.

--oss

타입 / 값

boolean

용도

Use a local OSS model provider.

--output-last-message, -o

타입 / 값

path

용도

Write the final assistant message to a file.

--output-schema

타입 / 값

path

용도

Validate the final output against a JSON Schema.

--profile, -p

타입 / 값

string

용도

Load a config profile.

--sandbox, -s

타입 / 값

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

용도

Choose the sandbox policy.

--skip-git-repo-check

타입 / 값

boolean

용도

Allow running outside a Git repository.

--config, -c

타입 / 값

key=value

용도

Override config inline.

PROMPT

타입 / 값

string | -

용도

Initial instruction. Use - to read from stdin.

대화형 TUI

내장 slash commands

Codex 입력창에서 / 를 입력하면 slash command 팝업이 열립니다.

/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.

자주 쓰는 형태

/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.

로컬 확장

내장 slash commands는 정해져 있지만, 설치된 skills, plugins, MCP servers, 더 이상 권장되지 않는 /prompts:* 파일이 이 장비만의 기능을 추가할 수 있습니다.

출처

공식 문서

명령 이름, 플래그, 성숙도 라벨, slash command 범위는 OpenAI Codex CLI 공식 문서를 기준으로 합니다.

읽는 법

이 페이지는 빠른 참조이며 공식 문서 전체를 옮긴 것이 아닙니다.