Codex CLI チートシート
公式に文書化された Codex CLI コマンド、よく使うフラグ、非対話実行、MCP、プラグイン管理、組み込み slash commands を素早く確認できます。
codexローカルリポジトリでの対話作業
codex execスクリプトと単発タスク
codex cloudCloud タスクのワークフロー
/permissions実行中セッションの制御
クイックスタート
最初に使うことが多いコマンド
ローカル作業、自動化、Cloud タスク、対話セッション制御でよく使う流れをまとめています。
codex現在のワークスペースでターミナル UI を開きます。
codex exec "fix the failing test"Codex を非対話で実行し、結果をストリーミングします。
codex resume --last直近の対話セッションに戻ります。
codex apply TASK_IDCodex Cloud タスクの最新 diff を適用します。
/permissionsCodex が確認なしに実行できる操作を調整します。
/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. |
--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 の進化に合わせて変わる可能性があります。
| コマンド | 成熟度 | 用途 |
|---|---|---|
codex | Stable | 対話型ターミナル UI を起動します。 |
codex app | Stable | Codex デスクトップアプリを開きます。 |
codex app-server | Experimental | 開発またはデバッグ用のローカル app-server を起動します。 |
codex apply | Stable | Codex Cloud タスクの diff をローカルに適用します。 |
codex a | Stable | codex apply のエイリアスです。 |
codex archive | Stable | 保存済みの対話セッションをアーカイブします。 |
codex cloud | Experimental | ターミナルから Codex Cloud タスクを閲覧または実行します。 |
codex cloud-tasks | Experimental | Alias for codex cloud. |
codex completion | Stable | shell 補完スクリプトを生成します。 |
codex debug app-server send-message-v2 | Experimental | Send a V2 test message to app-server. |
codex debug models | Experimental | Print the model catalog Codex sees. |
codex doctor | Stable | ローカル診断レポートを作成します。 |
codex exec | Stable | Codex を非対話で実行します。 |
codex e | Stable | Alias for codex exec. |
codex execpolicy | Experimental | Evaluate command execution policy rules. |
codex features | Stable | List or persist feature flag overrides. |
codex fork | Stable | Fork a previous session into a new thread. |
codex login | Stable | Codex を認証します。 |
codex logout | Stable | 保存済み認証情報を削除します。 |
codex mcp | Experimental | Manage MCP server definitions and auth. |
codex mcp-server | Experimental | Run Codex itself as an MCP server. |
codex plugin | Experimental | Install, list, and remove Codex plugins. |
codex plugin marketplace | Experimental | Manage plugin marketplace sources. |
codex remote-control | Experimental | Ensure app-server remote control support is enabled. |
codex resume | Stable | 以前の対話セッションを再開します。 |
codex sandbox | Experimental | Codex sandbox 内でコマンドを実行します。 |
codex unarchive | Stable | Restore an archived session. |
codex update | Stable | Check for or apply a CLI update when supported. |
codexStable対話型ターミナル UI を起動します。
codex appStableCodex デスクトップアプリを開きます。
codex app-serverExperimental開発またはデバッグ用のローカル app-server を起動します。
codex applyStableCodex Cloud タスクの diff をローカルに適用します。
codex aStablecodex apply のエイリアスです。
codex archiveStable保存済みの対話セッションをアーカイブします。
codex cloudExperimentalターミナルから Codex Cloud タスクを閲覧または実行します。
codex cloud-tasksExperimentalAlias for codex cloud.
codex completionStableshell 補完スクリプトを生成します。
codex debug app-server send-message-v2ExperimentalSend a V2 test message to app-server.
codex debug modelsExperimentalPrint the model catalog Codex sees.
codex doctorStableローカル診断レポートを作成します。
codex execStableCodex を非対話で実行します。
codex eStableAlias for codex exec.
codex execpolicyExperimentalEvaluate command execution policy rules.
codex featuresStableList or persist feature flag overrides.
codex forkStableFork a previous session into a new thread.
codex loginStableCodex を認証します。
codex logoutStable保存済み認証情報を削除します。
codex mcpExperimentalManage MCP server definitions and auth.
codex mcp-serverExperimentalRun Codex itself as an MCP server.
codex pluginExperimentalInstall, list, and remove Codex plugins.
codex plugin marketplaceExperimentalManage plugin marketplace sources.
codex remote-controlExperimentalEnsure app-server remote control support is enabled.
codex resumeStable以前の対話セッションを再開します。
codex sandboxExperimentalCodex sandbox 内でコマンドを実行します。
codex unarchiveStableRestore an archived session.
codex updateStableCheck 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用途
対話型ターミナル 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 | 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 apply TASK_ID型 / 値
string用途
Codex Cloud タスクの diff をローカルに適用します。
codex a TASK_ID型 / 値
string用途
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. |
--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 のポップアップが開きます。
| 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. |
/permissionsSet what Codex may do without asking.
/ideInclude IDE context such as open files and selection.
/keymapRemap TUI keyboard shortcuts.
/vimToggle Vim mode for the composer.
/sandbox-add-read-dirAdd sandbox read access to a directory on Windows.
/agentSwitch the active agent thread.
/appsBrowse apps or connectors and insert one into the prompt.
/pluginsBrowse installed and discoverable plugins.
/hooksReview lifecycle hooks.
/clearClear the terminal and start a fresh chat.
/archiveArchive the current session and exit Codex.
/compactSummarize visible conversation to free tokens.
/copyCopy the latest completed Codex output.
/diffShow Git diff, including untracked files.
/exitExit the CLI.
/experimentalToggle experimental features.
/approveApprove one retry after an auto-review denial.
/memoriesConfigure memory usage and generation.
/skillsBrowse and use skills.
/feedbackSend logs to Codex maintainers.
/initGenerate an AGENTS.md scaffold.
/logoutSign out of Codex.
/mcpList configured MCP tools.
/mcp verboseShow MCP server details.
/mentionAttach a file or folder to the conversation.
/modelChoose model and reasoning effort.
/fastToggle or inspect the Fast service tier.
/planSwitch to plan mode.
/goalSet, view, pause, resume, or clear a goal.
/personalityChoose communication style.
/psShow experimental background terminals.
/stopStop all background terminals.
/forkFork the current conversation into a new thread.
/sideStart an ephemeral side conversation.
/btwStart a short side conversation.
/rawToggle raw scrollback mode.
/resumeResume a saved conversation.
/newStart a new conversation in the same CLI session.
/quitExit the CLI.
/reviewAsk Codex to review the working tree.
/statusDisplay session config and token usage.
/debug-configPrint config-layer diagnostics.
/statuslineConfigure TUI status-line fields.
/titleConfigure terminal title fields.
/themeChoose syntax-highlighting theme.
よく使う形式
/fast onTurn the Fast tier on.
/fast offTurn the Fast tier off.
/fast statusShow Fast tier status.
/personality friendlyUse the friendly communication style.
/personality pragmaticUse the pragmatic communication style.
/personality noneDisable personality styling.
/goal <objective>Set a task goal.
/goal pausePause the current goal.
/goal resumeResume the current goal.
/goal clearClear 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 公式ドキュメントに基づきます。
読み方
このページはクイックリファレンスです。公式ドキュメント全体の転載ではありません。