Codex クイックリファレンス
この付録には、コマンドクイックリファレンス、よくある質問、バージョン更新情報が含まれます。
コマンドクイックリファレンス
CLI 基本コマンド
| コマンド | 説明 |
|---|---|
codex | 対話型 TUI を起動 |
codex "任务" | 起動して指定タスクを実行 |
codex exec "任务" | 非対話モードでタスクを実行 |
codex --version | バージョン情報を表示 |
codex --help | ヘルプ情報を表示 |
スラッシュコマンド
| コマンド | 説明 |
|---|---|
/model <name> | モデルを切り替え |
/fast | Fast モードに切り替え |
/plan | プランモードに入る |
/review | コード変更をレビュー |
/new | 新しいセッションを開始 |
/resume | 履歴セッションを復元 |
/fork | 現在のセッションをクローン |
/compact | コンテキストを圧縮 |
/status | セッション状態を表示 |
/clear | 画面をクリア |
/quit | Codex を終了 |
/approval <mode> | 承認モードを切り替え |
CLI パラメータ
| パラメータ | 説明 |
|---|---|
-m <model> | モデルを指定 |
--sandbox <mode> | サンドボックスモードを設定 |
--approval-mode <mode> | 承認モードを設定 |
-i <file> | 画像を添付 |
-o <file> | ファイルに出力(exec) |
--full-auto | 全自動実行 |
--ephemeral | セッションファイルを保存しない |
--reasoning-effort <level> | 推論強度 |
Shell コマンド実行
| 形式 | 説明 |
|---|---|
! <command> | Codex 内で Shell コマンドを実行 |
! git status | Git ステータスを確認 |
! npm test | テストを実行 |
設定ファイルパス
設定ファイルの場所
| ファイル | パス | 用途 |
|---|---|---|
| ユーザー設定 | ~/.codex/config.toml | グローバルデフォルト設定 |
| プロジェクト設定 | .codex/config.toml | プロジェクト固有の設定 |
| プロジェクト指示 | AGENTS.md | プロジェクトの行動規範 |
| ログディレクトリ | ~/.codex/log/ | 実行ログ |
| セッションディレクトリ | ~/.codex/sessions/ | セッション記録 |
スキルディレクトリ
| 場所 | パス |
|---|---|
| プロジェクトレベル | .agents/skills/ |
| ユーザーレベル | ~/.agents/skills/ |
| システムレベル | /etc/codex/skills/ |
ショートカットキー
CLI ショートカットキー
| ショートカットキー | 機能 |
|---|---|
Enter | メッセージを送信 |
Shift+Enter | 改行 |
Ctrl+C | 操作を中断 |
Ctrl+C (两次) | Codex を終了 |
Ctrl+D | 終了(入力が空の場合) |
Ctrl+R | 履歴を検索 |
Up/Down | 履歴を参照 |
Tab | 自動補完 |
Esc Esc | 前のメッセージを編集 |
Ctrl+O | 最後の返信をコピー |
App ショートカットキー
| ショートカットキー | 機能 |
|---|---|
Cmd/Ctrl+N | 新しいセッションを作成 |
Cmd/Ctrl+Shift+N | 新しいウィンドウを作成 |
Cmd/Ctrl+W | ウィンドウ/タブを閉じる |
Cmd/Ctrl+[ | 前のタブ |
Cmd/Ctrl+] | 次のタブ |
よくある質問
インストールと認証
Q: Codex CLI をインストールするには?
npm または Homebrew を使用します:
npm install -g @openai/codex # 或 brew install codex
Q: 初回使用時の認証方法は?
codex コマンドを実行するとブラウザが自動的に開いて認証が行われ、ChatGPT アカウントまたは API Key でログインします。
Q: Windows のサポート状況は?
Windows のネイティブサポートは実験的であり、最適な体験を得るには WSL2 の使用を推奨します。
使用方法の問題
Q: 現在の設定を確認するには?
使用します/statusコマンドで現在のセッションの設定と状態を確認します。
Q: 代替スクリーンを無効にするには?
使用するかcodex --no-alt-screenまたは設定しますalternate_screen = "never"。
Q: コマンドが見つからない場合は?
PATH に npm のグローバルインストールディレクトリが含まれていることを確認するか、Homebrew を使用してインストールしてください。
Q: ログを確認するには?
ログは~/.codex/log/ディレクトリにあります。
機能の問題
Q: exec と対話モードの違いは?
exec は単回実行後に終了し、自動化スクリプトに適しています。対話モードは継続的な会話ができ、日常の開発に適しています。
Q: 履歴セッションを復元するには?
使用するか/resumeコマンドまたはcodex resume --last。
Q: GitHub Action でファイルを変更できますか?
はい、sandbox: workspace-write を設定してください。
Q: CI/CD ではどのように認証しますか?
CODEX_API_KEY 環境変数を Secrets として保存して使用します。
セキュリティの問題
Q: Codex が重要なファイルを削除しないようにするには?
read-only または workspace-write サンドボックスモードを使用し、Rules を設定して危険なコマンドを禁止します。
Q: full-auto モードは安全ですか?
full-auto はファイルの削除を含むすべての操作を自動的に実行するため、注意して使用してください。
Q: 機密データをどのように扱いますか?
Secrets ストレージを使用し、セットアップスクリプト内でのみ利用可能です。
バージョン更新
最近の更新
| バージョン | 日付 | 更新内容 |
|---|---|---|
| v1.5.0 | 2026-04 | GPT-5.4 シリーズモデルのサポートを追加 |
| v1.4.0 | 2026-03 | Worktree 機能を改善 |
| v1.3.0 | 2026-02 | Review Mode を追加 |
| v1.2.0 | 2026-01 | MCP Server サポートを最適化 |
| v1.1.0 | 2025-12 | GitHub 統合を追加 |
| v1.0.0 | 2025-11 | Codex 正式リリース |
CLI の更新
更新コマンド
npm install -g @openai/codex@latest
# Homebrew で更新
brew upgrade codex
# 現在のバージョンを確認
codex --version
関連リソース
公式リソース
| リソース | アドレス |
|---|---|
| 公式ドキュメント | https://developers.openai.com/codex |
| GitHub | https://github.com/openai/codex |
| Codex Web | https://chatgpt.com/codex |
| Discord | https://discord.gg/openai |
チュートリアルシリーズ
| 章 | タイトル | 内容 |
|---|---|---|
| 01 | Codex 入門 | コア機能、プラン比較 |
| 02 | コアコンセプト | Prompt、Thread、Context、Sandbox |
| 03 | デスクトップアプリ | App 機能、Review モード |
| 04 | IDE拡張機能 | VS Code、Cursor、Windsurf |
| 05 | コマンドラインツール | CLI インストール、TUI、Approval |
| 06 | クラウド版 | Web インターフェース、Environments |
| 07 | 統合と接続 | GitHub、Slack、Linear、MCP |
| 08 | 設定とカスタマイズ | Config、Rules、Skills |
| 09 | 自動化と CI/CD | exec、SDK、GitHub Action |
| 10 | ワークフローモード | 開発フロー、リファクタリング、バグ修正 |
| 11 | プロンプトのベストプラクティス | Prompt 構造、タスク分解 |
| 12 | セキュリティとエンタープライズ管理 | サンドボックス、権限、監査ログ |
| 13 | モデル選択 | GPT-5.4 シリーズ、推論強度 |
| 14 | 付録 | コマンドクイックリファレンス、よくある質問 |
用語集
| 用語 | 説明 |
|---|---|
| Agent | Codex の中核となる実行ユニットで、タスクを理解して操作を実行できる |
| Prompt | ユーザーが Codex に送信するタスク指示 |
| Thread | セッションのシーケンスで、完全な会話履歴を含む |
| Context | Codexが利用可能な情報範囲(ファイル、会話、設定を含む) |
| Sandbox | 隔離された実行環境で、Codexの操作範囲を制限 |
| Approval | 承認ポリシーで、操作実行前の確認行動を制御 |
| AGENTS.md | プロジェクト指示ファイルで、Codexの行動規範を定義 |
| Skill | 再利用可能なカスタム機能モジュール |
| Subagent | 複雑なタスクを並行処理するためのサブエージェント |
| Rules | コマンド実行権限を定義するルールエンジン |
| MCP | Model Context Protocol(外部ツールを接続するプロトコル) |
| Worktree | Gitワークツリー(異なるタスクの作業ディレクトリを分離するためのもの) |
フィードバックとサポート
ヘルプの取得
- 使用
/helpコマンドで内蔵ヘルプを表示 - 公式ドキュメントにアクセスして詳細な説明を確認
- Discordコミュニティに参加して交流・議論
問題の報告
- GitHub Issues:バグや機能リクエストを提出
- Codexのフィードバック機能から提案を送信
その他の拡張Codexは継続的に更新・改善されています。公式チャネルで最新情報を入手してください。