0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

@Hurry_Fox(Hurry Fox)

OpenAI Codex チートシート

0
Posted at

OpenAI Codex チートシート

🚀 クイックスタート

インストール & 認証

# CLI インストール
npm install -g @openai/codex
# または
brew install openai-codex

# 認証
codex login                    # ブラウザでOAuth
codex login --device-code      # ヘッドレス環境用
codex auth status              # 認証状態確認

アップデート

npm update -g @openai/codex    # npm
brew upgrade openai-codex      # Homebrew

📦 4つのインターフェース

インターフェース OS 強み 用途
App macOS 並列開発、Worktree 本格的な開発の本拠地
IDE Extension 全OS Auto Context、エディタ統合 ペアプログラミング
CLI 全OS スクリプト統合、CI/CD ターミナル派、自動化
Cloud ブラウザ リモート実行、並列 バックグラウンド処理

🎯 CLI 基本コマンド

セッション操作

codex                          # インタラクティブモード起動
codex resume                   # セッション一覧から再開
codex resume --last            # 直前のセッションを即再開
codex resume --all             # 他ディレクトリも含めて表示
codex --cd /path/to/project    # 作業ディレクトリ指定

ファイル参照

# @記法でファイル参照（ファジー検索）
> @src/utils/validator.js のバグを修正してください

# 複数ファイル参照
> @file1.js @file2.js この2つのファイルをリファクタリング

非インタラクティブ実行（CI/CD向け）

codex exec "すべてのテストを実行して、失敗したものを修正"
codex exec --full-auto "依存関係を更新"
codex exec --yolo "全テストを修正"  # 完全自動（隔離環境のみ！）

モデル切り替え

codex --model gpt-5.1-codex-mini "このエラーの意味を教えて"
codex --model gpt-5.2-codex "/review"
codex --reasoning-effort high "複雑なバグを調査"

画像・Web検索

codex -i screenshot.png "このUIを再現して"
codex --image mock1.png,mock2.png "この2つの画面を実装"
codex --search "Next.js 15の新しいAPIについて"

⚡ インタラクティブモード中の操作

ターン中の特殊操作（TUI内）

キー 動作
Enter 追加指示を差し込み（Codex実行中）
Tab 次のターン用プロンプトをキューイング
Esc × 2 直前のメッセージを編集
Ctrl+G 外部エディタでプロンプト編集
Ctrl+C 現在のターンを中断
!command シェルコマンド実行（例: !npm test）

🔧 スラッシュコマンド

コマンド 用途 いつ使う？
/review 変更をレビュー コミット前の品質チェック
/plan-mode 計画のみ出力（変更なし） 大きなタスクの前に方針確認
/diff 現在の変更のdiff表示 ターミナルなしで差分確認
/model モデル切り替え タスクに応じた最適化
/fork セッションのフォーク アプローチの分岐点で
/status 使用量・残り枠の確認 枠の残りが気になるとき
/mcp MCPサーバー状態確認 ツール連携の確認
/skills スキル一覧と切り替え スキルの有効/無効管理
/init AGENTS.mdのスキャフォールディング プロジェクト初回設定
/compact コンテキストの手動圧縮 長時間セッション時
/exit セッション終了 終了時

☁️ Codex Cloud 操作

タスク管理

codex cloud                              # ピッカーでタスク選択
codex cloud exec -e ENV_ID "タスク"     # タスクを直接送信
codex cloud list                         # 最近のタスク一覧
codex cloud list --json                  # JSON出力（スクリプト向き）

diff適用

codex apply                              # ピッカーでタスクを選んでdiff適用
codex apply <task-id>                    # 特定タスクのdiffを適用

🎨 Codex App（macOS）

キーボードショートカット

ショートカット 動作
Cmd+J ターミナルの開閉
Cmd+K コマンドパレット
Ctrl+M 音声入力（押しながら話す）
Ctrl+L ターミナルクリア
Enter プロンプト送信 / ターン中の指示差し込み
Tab 次のターン用プロンプトをキューイング
Esc × 2 直前のメッセージを編集

実行モード

モード 説明 用途
Local プロジェクトディレクトリで直接作業 小さな修正、質問
Worktree Git Worktreeで隔離された作業ディレクトリ 並列開発、本格的な作業
Cloud リモート実行 バックグラウンド、長時間タスク

🧩 IDE Extension

基本操作

# VS Code拡張インストール
code --install-extension openai.codex

Auto Context

  • 現在開いているファイル、カーソル位置、選択範囲を自動収集
  • @記法で明示的にファイル参照可能
  • 「Add to Codex Thread」コマンドで選択範囲を追加

承認モード（3段階）

モード 説明
Chat 読み取りと回答のみ（変更なし）
Agent 編集・実行の前に確認あり
Agent Full Access 承認なしで自由に操作

🎛️ よく使うフラグ

# 低摩擦モード（承認: on-request、サンドボックス: workspace-write）
codex --full-auto
codex -f                                 # 短縮形

# 完全自動（隔離環境でのみ！）
codex --yolo

# 推論努力の指定
codex --reasoning-effort high "複雑なバグを調査"
codex --reasoning-effort low "簡単なQ&A"

# 設定値のオーバーライド
codex -c model=gpt-5.1-codex-mini
codex -c features.shell_snapshot=true

# プロファイルの指定
codex --profile deep-review

🧪 モデル選択ガイド

タスク おすすめモデル 推論努力
複雑なリファクタリング GPT-5.3-Codex high
日常的なコーディング GPT-5.3-Codex medium
コードレビュー GPT-5.2-Codex medium〜high
数時間の大規模タスク GPT-5.1-Codex-Max high
簡単なQ&A・軽微な編集 GPT-5.1-Codex-Mini low

推論努力（Reasoning Effort）

  • low — 簡単なQ&A、高速・省トークン
  • medium — 日常のコーディング、速度と品質のバランス
  • high — 複雑な分析、じっくり考える

🔐 承認モードとサンドボックス

承認モード

モード 説明
suggest 各操作の前に確認
auto 承認を求めない（サンドボックス内）
read-only 読み取りのみ（変更・実行なし）

サンドボックス設定

レベル 説明
workspace-write プロジェクト内の読み書きのみ
workspace-exec プロジェクト内で実行可能
user-exec ユーザーディレクトリで実行可能
danger-full-access 制限なし（隔離環境のみ！）

📝 効果的なプロンプティング

原則

  1. 明確で具体的な指示 — 「コードを改善」より「認証ミドルウェアにレート制限追加。100リクエスト/分」
  2. コンテキストの提供 — プロジェクト構造、使用技術、制約を明示
  3. タスクの分割 — 大きなタスクは小さく分ける
  4. 検証ステップの組み込み — 「テストを実行して、全て通ることを確認」

Cloud向けプロンプトのコツ

  • ローカルより詳しく書く（途中で追加指示できないため）
  • スコープを明確に（「src/auth/以下のみ変更」）
  • 成功条件を明示（「全テストが通る」「lintエラーなし」）
  • スタイルガイドを参照（「既存コードのスタイルに合わせる」）

🛠️ トラブルシューティング

よくある問題と対処

認証エラー

codex login              # 再認証
codex auth status        # 認証状態確認

Node.jsバージョンが古い

node --version           # バージョン確認（18以上必要）
nvm install 22           # nvmで更新
nvm use 22

Windows環境

  • WSLの使用を強く推奨
  • WSL内でプロジェクトを管理
  • Git設定：git config --global core.autocrlf input

パフォーマンスが遅い

  • モデルをGPT-5.1-Codex-Miniに切り替え
  • Reasoning Effortをlowに設定
  • Auto Contextをオフにして必要なファイルのみ@で指定

🎯 タスク別最適インターフェース

やりたいこと おすすめ 理由
質問・調査 IDE / CLI コンテキストが近い
小さな修正 IDE Auto Contextで即座に
大きなタスク Cloud / App 並列・バックグラウンド
並列開発 App (Worktree) 隔離された並行作業
CI/CD統合 CLI (codex exec) スクリプト親和性
コードレビュー Cloud / CLI @codex review / /review

🔗 設定ファイル

config.toml の場所

  • グローバル設定: ~/.codex/config.toml
  • プロジェクト設定: <project>/.codex/config.toml

基本設定例

model = "gpt-5.3-codex"
reasoning_effort = "medium"
web_search = "cached"  # または "live" / "disabled"

[features]
shell_snapshot = true
parallel = true
undo = true

AGENTS.md

  • プロジェクトのルートに配置
  • コーディング規約、アーキテクチャガイド、レビュー基準を記述
  • すべてのインターフェースから参照される

📊 コードレビュー

CLIでのレビュー

/review                          # デフォルトレビュー
/review strict                   # 厳格なレビュー
/review security                 # セキュリティレビュー
/review performance              # パフォーマンスレビュー

GitHub PR Review

# PRコメントでメンション
@codex review

# AGENTS.mdでレビューガイドライン設定
# P0/P1問題の自動検出

💡 実践ワークフロー例

1. 日常的なコーディング（IDE Extension）

1. VS Codeでファイルを開く
2. コードを選択 → 右クリック → "Codex: Add to Thread"
3. "このコンポーネントにpropsのバリデーション追加"
4. 変更を確認 → 承認

2. 大規模リファクタリング（Cloud）

1. chatgpt.com/codexでリポジトリ選択
2. プロンプト: "React 16 → React 18に移行。段階的に実施。テスト全て通すこと"
3. バックグラウンドで実行
4. 完了通知 → diffを確認 → PRとして提出

3. 並列開発（App + Worktree）

1. Worktreeモードで複数スレッド作成
2. スレッド1: "バグ修正"
3. スレッド2: "新機能追加"
4. スレッド3: "テストカバレッジ向上"
5. 各スレッドが独立して並行実行
6. レビューパネルで確認 → 個別にコミット/PR

4. CI/CDでの自動修正

# GitHub Actionsなどで
codex exec --yolo --sandbox danger-full-access \
  "全テストを実行して失敗したものを修正"

📚 参考リンク

  • 公式ドキュメント: docs.openai.com/codex
  • GitHub: github.com/openai/codex
  • サポート: help.openai.com

🎓 覚えておくべきベスト5

  1. codex resume --last — 直前のセッションに即復帰（エイリアス推奨）
  2. /plan-mode — 大きなタスクの前に計画だけ出力させる
  3. @記法 — ファイルを明示的に参照（ファジー検索）
  4. Worktreeモード — 並列開発の要。本格的に使うなら必須
  5. Cloud + ローカルの組み合わせ — 計画はローカル、実装はCloud
0
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?