Codex CLI のインストールが終わったら、次は 実際に使ってみる ステップです。CLIは Codex の中でも最もパワフルで、長時間タスクの自動化・複数ファイルの一括修正・コマンド実行までこなします。
この記事では、初めての1ターンから、日常的に使えるワークフローまで、実例豊富に 解説します。
インストールがまだの方は、先に Codex CLI のインストール手順 を参照してください。
基本：対話モードと一発実行モード
CLIには大きく2つの使い方があります。
対話モード（よく使う）
codex
引数なしで実行すると、対話モードが起動します。ターミナル上でチャットしながらタスクを進められます。
一発実行モード
codex "READMEを日本語に翻訳して"
引数で指示を渡すと、その1タスクだけ実行して終了します。スクリプトに組み込む際に便利。
最初の3ターン（チュートリアル）
実際にやってみましょう。新しいフォルダを作って試します：
mkdir codex-tutorial && cd codex-tutorial
git init
codex
ターン1：ファイル作成
> hello.py という Python ファイルを作って、「こんにちは、Codex」と表示するコードを書いて
Codex が hello.py の内容を提案します。承認するか聞かれる ので y（はい）で承認。
ターン2：実行
> hello.py を実行してみて
Codex が python hello.py を実行し、出力を確認します。出力結果がそのままターミナルに表示されます。
ターン3：拡張
> 名前を引数で受け取れるようにして
Codex が hello.py を編集して、python hello.py 太郎 のように使える形に修正します。
これで 「指示 → 確認 → 実行」 という Codex CLI の基本フローが体験できました。
承認フローのしくみ
Codex は 「危ない操作は必ず人間に聞く」 という安全設計になっています。
| アクション | 承認が必要か |
|---|---|
| ファイル読み込み | 自動（承認不要） |
| ファイル新規作成 | 承認必要 |
| ファイル編集 | 承認必要（diffを見せる） |
| シェルコマンド実行 | 承認必要 |
| ファイル削除 | 承認必要（警告強め） |
| 外部API呼び出し | 承認必要 |
承認スキップする方法
ヘビーに使う場合、毎回承認するのは面倒です。公式ドキュメントは、手元での作業なら次の組み合わせを勧めています（作業フォルダの中は自由に書き換えてよく、必要なときだけ承認を求める）。
codex --sandbox workspace-write --ask-for-approval on-request
承認も安全な囲い（サンドボックス）も外す --dangerously-bypass-approvals-and-sandbox（別名 --yolo）という指定もありますが、公式は「外部から隔離された環境の中でだけ使う」よう注意しています。普段使いでは避けましょう。
よく使うコマンド一覧
codex # 対話モード起動
codex "タスク内容" # 指示を入れた状態で起動
codex exec "タスク内容" # 対話なしで実行（自動化向け）
codex --model gpt-6.1-sol # モデル指定（-m でも可）
codex resume --last # このフォルダの直前の会話を再開
codex resume # 保存された会話を選んで再開
codex login # ChatGPTにログイン
codex logout # ログアウト
codex --version # バージョン確認
codex --help # ヘルプ表示
会話の中では /new（新しい会話）、/compact（会話を要約して空きを作る）、/model（モデル変更）、/status（使用状況の確認）などのコマンドも使えます（公式のコマンド一覧より）。
プロジェクトに「指示書」を置く：AGENTS.md
Codex は AGENTS.md という特別なファイル をプロジェクトルートに置くと、毎回それを読み込んで作業の前提にします。
AGENTS.md の例
# このプロジェクトについて
Next.js（App Router）+ TypeScript + TailwindCSS のWebアプリです。
Cloudflare Workers にデプロイします。
# ルール
- ファイル末尾は必ず改行
- コメントは日本語で書く
- 新規ライブラリ追加は事前に相談
- テストは `npm test` で実行
これを置くだけで、Codex の応答精度が劇的に上がります。詳細は AGENTS.md ガイド を参照。
実践ワークフロー5選
ワークフロー1：バグ修正
> npm test を実行してエラーを確認して
Codex がテストを実行し、失敗箇所を分析。
> エラー原因を特定して修正して
修正案を提示してくれるので、承認して反映。最後にもう一度 npm test を実行して緑になるまで自動でループしてくれます。
ワークフロー2：新機能追加
> ユーザー登録ページにメール認証機能を追加して。デザインは既存の /login ページと揃えて
Codex が以下を自動で行います：
- 既存の
/loginページを読んで構造を理解 - メール送信ライブラリを追加（事前確認あり）
- 新規ファイル作成・既存ファイル編集
- テストの追加
- README に手順を追記
ワークフロー3：リファクタリング
> src/utils/ にあるファイルを整理して、similar な関数は1つにまとめて
複数ファイルを横断的に読んで、重複を検出して統合してくれます。
ワークフロー4：ドキュメント生成
> /components 配下のすべてのコンポーネントについて、Storybookのストーリーファイルを作って
ファイル数が多くても自動で処理してくれます。長時間タスクなので、別作業をしている間に終わります。
ワークフロー5：コードレビュー
> 直近のコミットの diff を見て、気になる点を指摘して
git diff を Codex が自動実行し、変更内容を分析。バグの可能性・命名の改善案・テスト不足などをレポートしてくれます。
効率を10倍上げる5つのコツ
1. プロジェクトルートで起動する
ファイル参照が相対パスで効くので、必ず プロジェクトのルート で codex を起動します。
2. 見てほしいファイルを @ で指定する
CLIでは @ を打つとファイル名の候補が出て、ファイルを指定して渡せます（公式）。広く「全体を見て」と頼むより、トークン消費も時間も抑えられます。
⚠️ 訂正（2026年10月10日）：当サイトは以前、「
.codexignoreというファイルで読み込むファイルを除外できる」と案内していました。しかし、2026年10月時点の公式ドキュメントとCodexのソースコードには、この仕組みは見当たりませんでした。誤った案内をお詫びし、公式の案内に沿った方法に改めました。
3. 短く具体的に頼む
「全体的に良くして」より「auth.ts の TypeScript エラーを修正して」のほうが正確かつ高速。
4. 段階的に進める
大きいタスクを一気に頼むより、「設計 → 実装 → テスト → リファクタ」 と段階分けすると失敗が少ない。
5. セッションを使い分ける
新しい大きいタスクは /new で新しい会話に分けると、コンテキストが汚染されません。
長時間タスクと Codex Cloud
CLIで「重い」タスクは、Codex Cloud に投げると裏で実行できます。
> [Codex Cloud] 全UIコンポーネントを refactor して、TailwindCSS を v4 構文に揃えて
Cloud に投げると、ローカルを閉じても処理が続き、完了したら通知が来ます。並列で複数タスクを走らせることも可能。
Git との連携
Codex は git の状態を理解して動きます。
git statusを自動実行して未コミット変更を把握git diffで直近の変更を分析- ブランチ作成・コミットも自動化可能（承認は必須）
> feat/auth-update というブランチを作って、認証まわりの変更をコミットして
これだけで、ブランチ切って、ファイル編集して、コミットメッセージも書いてくれます。
トラブルシューティング
codex を打ってもプロンプトが出ない
codex login でログインが必要です。
反応が遅い
サーバー側の混雑か、頼み方が広く大量のファイルを調べています。承認待ちになっていないか確認し、見てほしいファイルを指定して頼み直してください。
ファイル編集が反映されない
承認をスキップしていませんか？y を押したか確認。
モデルを変えたい
会話の中で /model と打って選ぶか、起動時に codex --model gpt-6.1-sol のように指定します。いつも同じモデルを使うなら ~/.codex/config.toml で設定できます。モデルの選び方はモデル選びへ。
ここまでの要点を1枚にまとめました。
利用枠の消費を抑える公式テクニック（/compact・Plan mode・subagents）は トークンを節約する方法 にまとめています。
よくある質問（FAQ）
Q. CLIはオフラインで動きますか？
A. 動きません。OpenAIサーバーとの通信が必須です。
Q. 複数プロジェクトで同時に動かせますか？
A. はい。別のターミナルウィンドウで それぞれ起動すれば並列に動きます。
Q. 出力された差分を一括取り消ししたい
A. git checkout -- . でgit管理下なら戻せます。git管理外なら 取り戻せない ので注意。
Q. Slack や Discord と連携できますか？
A. Slackなどは、プラグインやMCPで連携できます。詳しくは Codexのプラグインとは？ と Slack連携 をどうぞ。
Q. CLIの会話の履歴は保存されますか？
A. はい。公式ドキュメントによると、会話の記録は ~/.codex/sessions に保存されます。codex resume で過去の会話に戻れます。
まとめ
Codex CLI は、「対話して承認するだけ」 で複数ファイルにまたがる開発作業をこなせる強力なエージェントです。AGENTS.md と組み合わせると、プロジェクト固有のルールも守りながら動きます。
次は、より便利に使うための AGENTS.md ガイド と、プロンプト技10選 も読むと、ワークフローが格段に洗練されます。
