第7章 ターミナルで使う — codex exec一行で整理ツールを確認
選択 必要なときに読んでください。読み飛ばしても、後の章についていけます。一言まとめ: Codex CLIは、ターミナルで使うCodexです。実行したフォルダの
AGENTS.mdとスキルを読みます。codex exec "やること"は一度実行して終わりで、初期設定は読み取り専用です。Claude Codeのclaude -pと似ていますが、この点が違います。
この章は、2026年11月1日に確認したCodexの公式ドキュメントと、macOSのターミナルでCodex CLIを実行した結果[1]をもとに書きました。ターミナルが初めてなら、この章は飛ばしてもかまいません。 ターミナルとは何かは、Claude Code 第10章で説明しました。
インストールして始める
公式ドキュメントのインストールコマンドは、次のとおりです。[2]
# macOS, Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh# Windows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"コマンドを部分ごとに分けると、次のとおりです。
curl -fsSL アドレス: アドレスにあるインストールスクリプト(インストールの手順を書いておいたファイル)をダウンロードします。-fsSLは、「エラーが出たら止まる、進み具合の表示を隠す、エラーは見せる、アドレスが移っていたらたどっていく」という4つのオプションをまとめて書いたものです。|(パイプ): 前のコマンドの結果を、後ろのコマンドに渡します。sh: 受け取ったスクリプトを実行します。- Windowsのほうも同じです。
irmがダウンロードし、iexが実行します。-ExecutionPolicy ByPassは、今回1回だけ、スクリプトの実行制限を外します。
インストールコマンドは、公式ドキュメント(learn.chatgpt.com)に書かれているものと同じかを確認してから実行してください。 インターネットから受け取ったスクリプトをすぐに実行するコマンドだからです。
インストールが終わったら、整理ツールのフォルダに移動してcodexと入力します。最初はSign in with ChatGPTを選びます。[3]
cd ~/hello-ai-practice/organizer
codexターミナルのCodexは、実行したフォルダをその会話のプロジェクトとして見ます。[4] アプリでChoose projectを使ってフォルダを選んでいたことを、cdが代わりにやってくれます。
理解度チェック
ターミナルで Codex CLI のインストールコマンドを実行する前に、必ず確認することはどれでしょうか?
codex exec — 一度聞いて終わらせる
codex execは、会話の画面を開かずに、一度実行して終わる方式です。[5] Claude Code 第10章と同じ質問をしてみました。
cd ~/hello-ai-practice/organizer
codex exec "notesフォルダのファイルの一覧を見せて、各ファイルがどのひな形(templatesのどれ)で書かれたかを一行ずつ教えて。ファイルは書き換えないで。答えは短く、表だけで。"答えだけがすっきりと出ました(全体の出力: ch7-codex-exec-output.txt)。
| notesのファイル | 使われたひな形 |
|---|---|
| study-2026-10-28-prompt-lecture.md | templates/study-notes.md |
| weekly-review-2026-10-26.md | templates/weekly-review.md |
| minutes-2026-10-27-weekly.md | templates/minutes.md |
出典: このガイドの実習結果(2026-11-01)。進行の記録は別に捨てて、最終的な答えだけを残した。
codex execは、進み具合と最終的な答えを別の道に出します。[6]
- 進み具合: 画面の脇道(stderr、スタンダード・エラー)に出ます。
- 最終的な答え: 正式な出力(stdout、スタンダード・アウト)にだけ出ます。
この違いは、結果をファイルで受け取るときに役立ちます。たとえばcodex exec "…" > result.mdと入力してみてください。>は「正式な出力を、画面のかわりにこのファイルに入れて」という記号です。すると、画面には進み具合だけが流れ、result.mdには最終的な答えだけが入ります。同じ名前のファイルがすでにあると、>はその中身を消して新しく書きます。なので、初めて使う新しい名前を選んでください。
codex execは、初期設定が読み取り専用です。 ファイルを書き換えさせたいときは、--sandbox workspace-writeを付けます。[7] このガイドの第2・3・5章の実習も、このオプションを付けて実行しました。
codex exec --sandbox workspace-write '$weekly-review'codex execは、許可の方式をあらかじめ決めておいて動かす方式です。[8] このガイドの第5章の実習では、.agentsフォルダへの書き込みがブロックされたとき、Codexは確認できないまま止まってしまいました。許可が必要な仕事は、アプリや対話型のcodexでやるほうが楽です。
サンドボックスと許可の両方をオフにする危険なオプションもありますが、メモの整理には使わないでください。
古い記事に出てくるオプションと危険なオプション(クリックして開く)
古い記事に出てくる--full-autoオプションは、もうサポートされていません。[9] サンドボックスと許可の両方をオフにする--dangerously-bypass-approvals-and-sandboxのようなオプションもありますが[10]、メモの整理には要りません。
理解度チェック
codex exec でファイルを直させようとしたのに、何も変わりませんでした。いちばん適切な理由はどれでしょうか?
対話型codexの中のコマンド
codexで対話型を開くと、/で始まるコマンドが使えます。
| コマンド | することの内容 |
|---|---|
/permissions | 権限を変える(アプリの権限メニュー) |
/import | Claude CodeやCursorの設定を取り込む |
/resume | 保存した会話を続ける |
/status | 会話の情報と残りの上限を見る |
/skills | スキルの一覧を見る |
出典: Codex公式ドキュメント[11][12][13][14][15]
対話型を終えたあとで外から続けたいときは、codex resumeと入力します。[13:1]
/permissionsと/importは、ターミナル側のコマンドです。アプリでは、入力欄の下の権限メニュー(第4章)と、設定のImportメニュー(第3章)を使います。
理解度チェック
Codex CLI の対話画面で、会話の情報と残りの上限を見るには、どのコマンドを使うでしょうか?
やってみましょう
- 公式ドキュメントのインストールコマンドと上のコマンドが同じかを確認してから、インストールする(すでに入っていれば
codex --version)。 - 整理ツールのフォルダに移動して、上の読み取り専用の
codex execの質問を実行する。 codexで対話型を開いて、/statusを入力してみる。$を入力するか/skillsを実行して、第5章のスキル名が見えるかを確認する。[15:1]
続きの課題: 第8章では、コスト・データ・安全をまとめ、隠れた指示が入ったメモをCodexがどう扱うかを確認します。
まとめ
- ターミナルのCodexは、実行したフォルダをプロジェクトとして見て、そのフォルダの
AGENTS.mdとスキルを読む。 - インストールコマンドは、公式ドキュメントと同じかを確認してから実行する。
codex execは一度実行して終わり、初期設定は読み取り専用。書き換えるなら--sandbox workspace-write。codex execは、許可の方式をあらかじめ決めて動く。許可が必要な仕事は、アプリや対話型で。
用語まとめ
| 用語 | 読み方 | 一言でいうと |
|---|---|---|
| Codex CLI | コーデックス・シーエルアイ | ターミナルで使うCodex |
codex exec | コーデックス・エグゼック | 一度実行して終わらせる方式 |
| stdout / stderr | スタンダード・アウト / スタンダード・エラー | 正式な出力 / 進み具合やエラーが出る脇道 |
この章は読み終わりましたか?
学習の記録はこのブラウザにのみ保存されます。全体の進み具合は 全体目次で確認できます。
次の章: 第8章 コスト・データ・安全、そしてツールの選び方
参考資料(15件)
このガイドが実行したバージョンは、Codex CLI 0.166.0です。 ↩︎
Codex 公式ドキュメント「Codex CLI」。"curl -fsSL chatgpt.com | sh" / "powershell -ExecutionPolicy ByPass -c "irm chatgpt.com | iex"" learn.chatgpt.com (確認日 2026-11-01) ↩︎
Codex 公式ドキュメント「Codex CLI」。"Open a project directory and run
codex. The first time you run Codex, choose Sign in with ChatGPT or another available sign-in method." learn.chatgpt.com (確認日 2026-11-01) ↩︎Codex 公式ドキュメント「Projects and chats」。"Codex CLI treats the directory where you start it as the project for the chat." learn.chatgpt.com (確認日 2026-11-01) ↩︎
Codex 公式ドキュメント「Non-interactive mode」。"Non-interactive mode lets you run Codex from scripts (for example, continuous integration (CI) jobs) without opening the interactive TUI." learn.chatgpt.com (確認日 2026-11-01) ↩︎
Codex 公式ドキュメント「Non-interactive mode」。"While
codex execruns, Codex streams progress tostderrand prints only the final agent message tostdout." learn.chatgpt.com (確認日 2026-11-01) ↩︎Codex 公式ドキュメント「Non-interactive mode」。"By default,
codex execruns in a read-only sandbox." / "Allow edits:codex exec --sandbox workspace-write "<task>"" learn.chatgpt.com (確認日 2026-11-01) ↩︎Codex 公式ドキュメント「Non-interactive mode」。"Run with explicit, pre-set sandbox and approval settings." learn.chatgpt.com (確認日 2026-11-01) ↩︎
Codex 公式ドキュメント「Non-interactive mode」。"
--full-autois no longer supported." learn.chatgpt.com (確認日 2026-11-01) ↩︎Codex 公式ドキュメント「Agent approvals & security」。"
--dangerously-bypass-approvals-and-sandbox(alias:--yolo)" learn.chatgpt.com (確認日 2026-11-01) ↩︎Codex 公式ドキュメント「Permissions」。"In the CLI, enter
/permissions." learn.chatgpt.com (確認日 2026-11-01) ↩︎Codex 公式ドキュメント「Import from another agent」。"Start a local Codex CLI session and type
/import." learn.chatgpt.com (確認日 2026-11-01) ↩︎Codex 公式ドキュメント「Projects and chats」。"Use
/resumewhile Codex is open, or runcodex resume, to continue a saved chat." learn.chatgpt.com (確認日 2026-11-01) ↩︎Codex 公式ドキュメント「Pricing」。"If you want to see your remaining limits during an active Codex CLI session, you can use
/status." learn.chatgpt.com (確認日 2026-11-01) ↩︎Codex 公式ドキュメント「Build skills」。"In Codex CLI or the IDE extension, run
/skillsor type$to mention a skill." learn.chatgpt.com (確認日 2026-11-01) ↩︎