Codexをターミナルで使う基本手順とzshプラグイン連携
Codex を本格的に使う入口は、ブラウザのアプリより先にターミナルになることが多い。コードを読み、差分を当て、テストを流す——この一連をシェルの中で完結できるのが Codex CLI の強みだからだ。折しも 2026 年 6 月 25 日には Codex 本体リポジトリから zsh 向けプラグインの初版 codex-zsh-v0.1.0 が公開され、シェルとの統合が専用コンポーネントとして切り出され始めた。本記事では、Codex をターミナルで動かす準備と基本操作、そして zsh 連携の現在地を、OpenAI の公式情報に沿って整理する（出典: https://github.com/openai/codex/releases/tag/codex-zsh-v0.1.0）。
Codex CLI は、ターミナルからローカルのコードベースを読み、編集し、コマンドを実行できる開発支援ツールだ。ブラウザのアプリやエディタ拡張と違い、シェルという開発者が一日中触れている作業面の中で完結するため、リポジトリの状態確認・依頼・差分レビュー・テスト実行を画面を切り替えずに回せる。導入は npm か Homebrew で入れて codex を起動するだけで、最初の対話セッションまでの距離が短いのが特徴だ（出典: https://developers.openai.com/codex/cli）。
ターミナルで使ううえで押さえるべきは、「インストール → サインイン → 対話セッション」という三段の入口と、依頼の境界をはっきりさせる運用の作法だ。サインインは ChatGPT アカウントで行い、資格情報は ~/.codex/auth.json にキャッシュされて以降は再ログイン不要になる。起動後はターミナル内のテキスト UI で指示を打ち、提案された変更やコマンド実行を承認しながら進める。小さく依頼し、差分を読み、テストで確かめる流れを作ることが、ターミナル運用を安定させる近道になる。
直近では、シェル統合そのものを独立した部品として育てる動きが見え始めている。2026 年 6 月 25 日に Codex 本体リポジトリから公開された zsh プラグインの初版 codex-zsh-v0.1.0 は、本体の rust-v 系列とは別タグで配布された新プロダクトだ。初版のため詳細な変更履歴は未掲載だが、ターミナルという作業面における Codex の存在感が、単なる一コマンドからシェル環境への根付きへと広がりつつある兆しと読める（出典: https://github.com/openai/codex/releases/tag/codex-zsh-v0.1.0）。
目次 (10)
Codexをターミナルで使うとはどういうことか
Codex をターミナルで使うとは、シェルのプロンプトに codex と打って起動する対話的なコーディングエージェント（Codex CLI）を、ローカルの作業ディレクトリの中で動かすことを指す。ブラウザで動く Codex のクラウド版やエディタの拡張機能とは入口が異なり、CLI はターミナルという開発者がもっとも長い時間を過ごす作業面の内側で完結するのが特徴だ。具体的には、リポジトリの中身を読んでファイルを編集し、必要に応じてテストやビルドのコマンドを実行し、その結果を踏まえて次の手を提案する、という流れをすべてシェルの中で進められる。画面をブラウザへ切り替えてコピー＆ペーストで往復する必要がないため、git status で状態を確かめ、依頼を出し、提示された差分を読み、git diff で確認する——という一連の作業を、目線を動かさずに回せる。Codex CLI はローカルのコードベースを読み・編集し・コマンドを実行できる開発支援ツールであり、まずはこの「ターミナルの中で完結する」という性格を押さえておくと、後述の準備や操作の意味が理解しやすくなる（出典: https://developers.openai.com/codex/cli）。
ターミナルで動かすための準備
ターミナルで Codex を起動するまでには、大きく「インストール」と「サインイン」の二つの準備がある。順番に進めれば、初回の対話セッションまで迷わずたどり着ける。
Step 1: Codex CLI をインストールする
Codex CLI は npm 経由のグローバルインストール、または Homebrew で導入できる。Node.js が入っている環境なら、ターミナルで次のコマンドを実行する。配布チャネルやコマンドの最新形は公式ドキュメントで確認しておくと、表示メッセージとのずれを避けられる（出典: https://github.com/openai/codex）。
npm install -g @openai/codex
macOS で Homebrew を使う場合は brew install codex でも導入できる。インストール後は codex --version を打って、バージョンが表示されることを確認する。古いバージョンのままだとフラグ名や画面表示が公式ドキュメントと食い違うことがあるため、導入直後にいちど最新へ更新しておくと安全だ。
Step 2: ChatGPT アカウントでサインインする
インストールが済んだら、作業したいリポジトリのディレクトリへ移動し、codex を起動してサインインする。標準では ChatGPT アカウントでのログインが案内され、ブラウザが開いて承認すると、資格情報が ~/.codex/auth.json にキャッシュされる。以降のコマンドは再サインインなしで動く。SSH 越しのサーバーやコンテナのようにブラウザを開けない環境では、別端末のブラウザを借りるデバイスコード認証で同じサインインを完結できる（出典: https://developers.openai.com/codex/auth）。
Step 3: 作業前にリポジトリの状態を整える
起動の前に、現在のブランチと未コミット差分を確認しておく。自分が触っていない差分が残っていると、Codex の作業差分と混ざって読みにくくなるためだ。
git status --short --branch
不要な変更は git stash で避け、必要なら先にコミットして、依頼前の状態をきれいにしておく。人間側の作業境界をはっきりさせておくほど、後で差分を読むのが楽になる。
ターミナルでの基本操作の流れ
準備が整ったら、codex を起動するとターミナル内にテキストベースの操作画面が立ち上がり、ここに自然言語で指示を打ち込んでいく。最初の依頼は「直して」の一言で終わらせず、対象・意図・制約・確認方法を分けて渡すのが安定運用のコツだ。たとえば「このリポジトリのトップページで CTA 文言を初心者向けに調整してください。対象は index.html と styles.css のみ、記事本文は触らないでください。完了後に差分とリンクを確認してください」のように、対象・制約・完了条件を明示する。Codex はリポジトリを読みながら変更案を組み立て、ファイル編集やコマンド実行を行う前に承認を求めてくる。提案された差分やコマンドを一つずつ確認し、問題なければ承認して進める——この対話のリズムがターミナル運用の中心になる。作業が一段落したら、まず git diff で意図しない変更が混ざっていないかを読み、続いて対象に応じたテストや lint を流し、最後にコミットへ何を変えどう確認したかを残す。この「差分・テスト・コミット」の順序を小さな修正でも守ると、後から追いやすい履歴になる。リポジトリ固有のルール（テストコマンド、編集禁止ファイル、コミットメッセージ規約など）は、毎回プロンプトに書くより AGENTS.md に固定しておくと、ターミナルでのやり取りがさらに短く済む（出典: https://openai.com/codex/）。
zshプラグイン初版が示すシェル統合の方向
ターミナルでの Codex 体験は、いま「一つのコマンドを起動する」段階から「シェル環境そのものに根付く」段階へと広がりつつある。その象徴が、2026 年 6 月 25 日に Codex 本体リポジトリから公開された zsh 向けプラグインの初版 codex-zsh-v0.1.0 だ。これは本体の rust-v 系列とは独立したタグで配布された新プロダクトで、シェル統合を担うコンポーネントと見られる。初版のため詳細な変更履歴は未掲載であり、現時点で確定的な機能を断定はできないが、Codex がターミナルという作業面に対して専用の部品を切り出し始めたという事実そのものに意味がある（出典: https://github.com/openai/codex/releases/tag/codex-zsh-v0.1.0）。zsh は macOS の既定シェルであり、多くの開発者が日常的に使っている。そのシェルへ Codex の機能を寄せていく流れは、エディタや専用アプリへユーザーを連れ出すのではなく、開発者がすでにいる場所へエージェントを届けるという設計思想の表れだと読める。安定版の Codex CLI 自体は本記事執筆時点で小休止の時期にあり、その傍らで周辺コンポーネントの拡充が進む——という構図は、ターミナル中心の開発を続けるユーザーにとって、今後の更新を追う価値が高いことを示している。導入を急ぐ必要はないが、自分のシェル環境と Codex の関わり方が変わりうる地点として、リリース一覧を定期的に確認しておくとよい（出典: https://github.com/openai/codex/releases）。
ターミナル運用でつまずきやすい点
ターミナルから Codex を使うとき、初期につまずきやすいのはサインインと作業境界の二点に集中する。あらかじめ典型的な詰まりどころを知っておくと、復旧が早くなる。サインインが先へ進まない場合は、まずブラウザを開けない環境ではないかを疑う。SSH 接続だけのサーバーや GUI を持たない Linux、コンテナでは通常のログイン経路が成立しないことがあり、その場合はデバイスコード認証へ切り替えると一度だけ対話的にサインインを通せる（出典: https://developers.openai.com/codex/auth）。サインインの状態は codex login status で確認でき、挙動がおかしくなったら codex logout で資格情報を消してから入れ直すのが基本だ。なお ~/.codex/auth.json はパスワードと同等の機密情報なので、リポジトリへコミットしたり共有したりせず、サーバーを破棄するときは確実に消しておく。もう一つのつまずきは作業境界で、依頼の対象範囲を絞らないまま大きな指示を出すと、想定より広いファイルへ変更が及ぶことがある。対象ディレクトリと触ってほしくないファイルを依頼文や AGENTS.md で明示し、作業後は必ず git diff で差分の範囲を確認する習慣をつけておくと、ターミナル運用でも安心して任せられるようになる（出典: https://github.com/openai/codex）。
まとめ — シェルを入口にすると Codex は手に馴染む
Codex をターミナルで使うとは、codex の一コマンドからローカルのコードベースを読み・編集し・コマンドを実行する対話を、シェルの中で完結させることだ。準備はインストールとサインインの二段で、起動前にリポジトリの状態を整え、起動後は小さく依頼して差分・テスト・コミットの順に確認する——この基本の流れを押さえれば、ブラウザを行き来せずに開発を回せる。さらに、2026 年 6 月の zsh プラグイン初版 codex-zsh-v0.1.0 の登場は、ターミナルという作業面に Codex がより深く根付いていく方向を示している。シェルを入口に選ぶほど Codex は手に馴染み、日々の開発の相棒として機能しやすくなる。
