npm install で Codex CLI を始めるには
- 1Node.js バージョン確認node -v で18以上を確認。不足なら nvm や fnm で切り替え
- 2グローバルインストールnpm install -g @openai/codex を実行。依存関係ゼロで軽量
- 3起動とサインインcodex で起動。初回は ChatGPT のサインイン画面で Plus/Pro アカウントログイン
- 4バージョン確認codex --version で動作確認
グローバルインストールのコマンド
室谷代表取締役Codex CLI のインストール、一番手軽なのは npm のグローバルインストールですね。コマンド一発で終わります。
テキトー教師.AI認定講師npm install -g @openai/codex ですね。僕も最初にこれを試しました。Homebrew と比べても npm の方が環境を選ばないので便利です。
室谷代表取締役そう。で、このパッケージ、実は依存関係ゼロなんですよね。
軽い。
軽い。
テキトー教師.AI認定講師あ、そこ大事です。
npm install でよくある依存地獄にハマらないので、初心者でも安心して入れられます。Node.js のバージョン要件
室谷代表取締役ただし、Node.js のバージョンは 18 以上じゃないと動かないんですよね。
テキトー教師.AI認定講師そこ、初めて触る人がよく引っかかります。「インストールできたのに起動しない」って。
室谷代表取締役現場で言うと、古い LTS を使ってるプロジェクトほど注意です。
node -v で確認してから進めたほうがいい。テキトー教師.AI認定講師そうですね。もしバージョンが足りなければ、nvm や fnm で切り替えるのが手っ取り早いです。
インストール後の確認方法
室谷代表取締役インストールが終わったら、ターミナルで
codex と打てば起動します。テキトー教師.AI認定講師で、最初に ChatGPT のサインイン画面が出てきますよね。そこで Plus か Pro のアカウントでログインすれば完了です。
室谷代表取締役インストールそのものは数秒で終わるので、つまずくとしたら Node のバージョンぐらい。
テキトー教師.AI認定講師あとは
codex --version でバージョン確認もできるので、正常に動いたら一度確認しておくと安心です。初回起動と ChatGPT アカウント連携
ChatGPT アカウントでサインイン
- 「Sign in with ChatGPT」を選択
- ブラウザが開き認証
- サブスクリプション（Plus/Pro/Business）で利用可能
- 追加課金不要
- 初めての人でも簡単
API キーでの認証
- 環境変数（例: CODEX_API_KEY）を設定
- チーム管理や一括請求に適する
- API 利用とは別の課金体系
- 追加のセットアップが必要
- ドキュメント参照必須
codex コマンドを実行する
室谷代表取締役npm でグローバルインストールしたら、あとはターミナルで
codex と打つだけです。ここで詰まる人はほとんどいないんですけどね。テキトー教師.AI認定講師そうですね。インストールが終わって、いざ
ここで「どうやって認証するの？」って戸惑う人がたまにいます。
codex って叩くと、最初にサインイン画面が出てきます。ここで「どうやって認証するの？」って戸惑う人がたまにいます。
室谷代表取締役あとは ChatGPT のアカウントを持っていれば、Plus でも Pro でも Business でも、そのまま使える。追加のクレジット登録とか不要なんですよ。
テキトー教師.AI認定講師あ、そこ大事です。最初に「これって別途課金が必要なの？」って聞かれますからね。
ChatGPT Plus/Pro でのサインイン
テキトー教師.AI認定講師実際の流れとしては、サインイン画面で「Sign in with ChatGPT」を選んで、ブラウザが開いて認証を通すだけ。特に難しいことはないです。
室谷代表取締役コード生成エージェントが自分のサブスクリプションの範囲で動くっていう設計は、ユーザーにとってシンプルでいいですよね。MYUUU でも「どのプランがおすすめ？」ってよく聞かれるんですが、Plus で十分、よほど大量に使うなら Pro かな、という感じです。
テキトー教師.AI認定講師ただ、最初に認証を通すとき、ブラウザが開かないケースがまれにあって。環境によってはターミナルでリンクが表示されるので、手動でコピペすれば大丈夫です。
室谷代表取締役そういう細かいところは、ドキュメントにきちんと書いてあるんで、困ったら公式を見てほしいですね。
API キーでの認証方法
室谷代表取締役ChatGPT アカウントを使わずに、API キー直接で認証することもできます。ただし、あくまで追加のセットアップが必要な手段です。
テキトー教師.AI認定講師初めて触る人は ChatGPT サインインが断然ラクです。API キー方式は、例えば社内でプロジェクト管理してて、個別の請求にしたいケースとかですかね。
室谷代表取締役そう。シリコンバレーのスタートアップだと、チームの利用を一括管理するときに API キーで運用するパターンもあるみたいです。
ただその場合は環境変数の設定とか、ドキュメントを読む必要がありますね。
ただその場合は環境変数の設定とか、ドキュメントを読む必要がありますね。
テキトー教師.AI認定講師はい、あとは自分で OpenAI の API キーを発行して、
CODEX_API_KEY とかで渡せばいいはずです。ただ、サブスクリプションと API の利用は別の課金体系になるので、そこの認識だけ間違えないようにしてください。npm と Homebrew、どちらでインストールする？
npm グローバルインストール
- Node.js があればすぐ使える
- アップデートが簡単（npm update -g）
- 最新版への追従が早い
- Node.js のバージョン管理（nvm）と相性が悪い場合がある
- CI 環境で使いやすい
brew install --cask codex
- システム全体にインストールされ、Node.js の影響を受けない
- コマンドがどこでも使える
- 更新頻度が npm より遅れることがある
- brew 管理に慣れている開発者に統一ニーズがある
npm グローバルインストールの特徴
テキトー教師.AI認定講師まずは npm のグローバルインストールから。
Node.js が入っていれば誰でも使える手軽さが強みです。
npm install -g @openai/codex で一発ですね。Node.js が入っていれば誰でも使える手軽さが強みです。
室谷代表取締役そうですね。特に普段から npm でパッケージ管理してるエンジニアなら、違和感なく導入できる。
アップデートも
アップデートも
npm update -g @openai/codex で済むし、管理が一元化できる。テキトー教師.AI認定講師ただ、Node.js のバージョン管理と相性が悪い場面もあるんですよ。nvm で切り替えるとグローバルパッケージが使えなくなったりして、最初に戸惑う人が結構います。
室谷代表取締役ああ、それはありますね。チームで導入するときに「Node.js のバージョンが違うから動かない」みたいな話になりがち。
でも個人でサクッと試すなら npm 一択だと思います。
でも個人でサクッと試すなら npm 一択だと思います。
brew install --cask codex の比較
テキトー教師.AI認定講師次に Homebrew。macOS 使いにはおなじみの
これはシステム全体にインストールされるので、Node.js の影響を受けません。
brew install --cask codex です。これはシステム全体にインストールされるので、Node.js の影響を受けません。
室谷代表取締役そこが分かりやすいですね。brew で入れると、あとは
ただ、更新頻度が npm より遅れるケースもあるらしくて、最新版をすぐ使いたい人には npm の方がいいかもしれません。
codex コマンドがどこでも使える。ただ、更新頻度が npm より遅れるケースもあるらしくて、最新版をすぐ使いたい人には npm の方がいいかもしれません。
テキトー教師.AI認定講師実はそうなんですよ。brew の cask 版はリリースから反映までタイムラグがあることがある。
頻繁にアップデートされる CLI ツールだと、npm の方が追従が早い印象です。
頻繁にアップデートされる CLI ツールだと、npm の方が追従が早い印象です。
室谷代表取締役とはいえ、普段から brew で管理している開発者には「brew に統一したい」というニーズも強い。どっちが正解というより、環境に合わせて選べばいい話ですね。
チーム導入時の選択基準
室谷代表取締役チームで導入するなら、管理方法を統一した方がいい。npm で揃えるか、brew で揃えるか。
僕のところは CI/CD との兼ね合いで npm にしてます。
僕のところは CI/CD との兼ね合いで npm にしてます。
テキトー教師.AI認定講師なるほど。CI 環境だと brew が使えないケースもあるので、npm の方が汎用性が高いですよね。
逆に、全員が macOS で brew 管理に慣れているなら brew で統一するのも手。
逆に、全員が macOS で brew 管理に慣れているなら brew で統一するのも手。
室谷代表取締役あと、インストールの手順書を1つにできるのが大きい。「npm でインストールしてください」だけで済むか、「brew の人と npm の人で手順が分かれる」かで、運用負荷が変わります。
テキトー教師.AI認定講師そうです。現場でよく聞くのは「どっちでもいいけど統一してほしい」という声。
最初に決めておけば混乱しない。結局、両方とも公式サポートされているので、迷ったら npm で始めるのが無難ですかね。
最初に決めておけば混乱しない。結局、両方とも公式サポートされているので、迷ったら npm で始めるのが無難ですかね。
バージョン確認とアップデート方法
- 1バージョン確認codex --version で現在のバージョンを表示。Issue報告時に必要。
- 2アップデート実行npm update -g @openai/codex で最新版に更新。@alpha を指定すればalpha版も。
- 3バージョン固定チーム環境やCIでは npm install -g @openai/codex@0.145.0 で固定。npm ls -g で確認。
codex --version でバージョンを確認
室谷代表取締役導入したらまずやるのがバージョン確認。
codex --version 一発で今のバージョンが出ます。テキトー教師.AI認定講師最初に戸惑うのが「どのバージョンが入ってるか分からない」ってところですよね。
codex --version して数字が出ればとりあえず動いてる証拠。室谷代表取締役地味に大事で、Issue 報告するときも「v0.145.0 で再現します」って言えるかどうかで対応速度が変わります。
npm update -g @openai/codex でアップデート
テキトー教師.AI認定講師アップデートは
npm update -g @openai/codex で一発。ただし npm のバージョン管理がグローバルだと少し注意が必要です。室谷代表取締役普段
npm i -g @openai/codex で入れてる人も多いので、同じ感覚で npm update -g で OK。最新の alpha 版に触りたい人は npm install -g @openai/codex@alpha も選択肢に入ります。テキトー教師.AI認定講師現場でよく聞くのが「更新したら設定が変わった」という混乱。設定ファイルは影響受けないので、基本的には気にせず最新にして大丈夫です。
バージョン固定が必要なケース
テキトー教師.AI認定講師逆に、チームで環境を揃えたいときはバージョンを固定したくなります。package.json で管理するか、
npm install -g @openai/codex@0.145.0 のように明示します。室谷代表取締役CI/CD に組み込むなら固定推奨。
無駄なバージョン差でハマるより、最初に決めたほうがコスト低いです。
npm ls -g @openai/codex で今のバージョン確認して、必要ならロックする。無駄なバージョン差でハマるより、最初に決めたほうがコスト低いです。
テキトー教師.AI認定講師あと、
npm update は依存関係もまとめて更新しちゃうので、本番環境では npm outdated で差分を確認してから更新するといいですよ。Codex CLI のアンインストール手順
- 1npm グローバルアンインストールnpm uninstall -g @openai/codex を実行。-g を付け忘れるとローカルにしか効かないので注意。
- 2キャッシュ・設定ファイルの削除rm -rf ~/.codex で削除。事前に ls -la ~ | grep codex で存在確認すると安心。
- 3Homebrew で入れた場合のアンインストールbrew uninstall --cask codex を実行。cask 指定を忘れずに。事前に brew list --cask で確認。設定ファイルの削除は上記と同様に行う。
npm uninstall -g @openai/codex の実行
室谷代表取締役npm で入れた Codex CLI、アンインストール自体は
npm uninstall -g @openai/codex 一発です。プロジェクトごとにローカルにインストールしてるケースはあまりないので、グローバルの削除で十分。テキトー教師.AI認定講師これ、最初に戸惑う人が意外といるんですよ。npm のグローバルパッケージって
-g を付け忘れるとローカルにしか効かないので、codex コマンドが消えないってハマりポイントです。室谷代表取締役たしかに。あと、アンインストール後も設定ファイルが残るので、完全に消したいなら次の手順までやったほうがいいですね。
キャッシュや設定ファイルの削除
テキトー教師.AI認定講師で、キャッシュと設定ファイルです。Codex CLI はホームディレクトリの
.codex あたりにセッション情報とかキャッシュを置いてるみたいなんですよ。室谷代表取締役そこは手動で削除するしかないですね。
MYUUU の現場でも、テスト環境をまっさらにしたいときはよくやります。
rm -rf ~/.codex で消してしまって問題ないです。MYUUU の現場でも、テスト環境をまっさらにしたいときはよくやります。
テキトー教師.AI認定講師設定ファイルの場所は環境によって違うこともあるので、
ls -la ~ | grep codex とかで存在を確認してから消すと安心です。室谷代表取締役そこまでやれば、もう完全に初期状態に戻ります。
brew で入れた場合のアンインストール
室谷代表取締役Homebrew でインストールした場合は
brew uninstall --cask codex で OK です。cask 指定を忘れずに。テキトー教師.AI認定講師そうですね。brew の場合は formula と cask で管理の仕方が違うので、
brew list --cask で確認してからやると間違いないです。室谷代表取締役あと、brew で入れた場合も設定ファイルは残るので、キャッシュ削除は同様にやってください。
テキトー教師.AI認定講師結局どの方法でも、設定ファイルの掃除までは自動でやってくれない。そこを忘れずにやるのが完全アンインストールの肝ですね。
Codex CLI の基本操作と活用術
- 1ChatGPTアカウントと連携OAuth（推奨）またはAPIキーで連携。Plus/Proサブスクリプションがあればそのまま使用可能。
- 2プロジェクトルートで `codex` を実行Git管理が必要（--skipGitRepoCheckで回避可）。スクリプトは一発で終了するものに限定。
- 3エージェントの設定をカスタマイズ環境変数 CODEX_APPEND_ENV_CONTEXT や設定ファイルでフレームワーク、lintルールなどを指定。
ターミナルでの直接操作
室谷代表取締役codex って叩くだけでエージェントが立ち上がる。npm で入れたらそのまま使える手軽さがいいですよね。テキトー教師.AI認定講師最初に ChatGPT アカウントとの連携があるから、そこだけ通せばあとはすぐです。Plus や Pro のサブスクリプションがあればそのまま使える。
室谷代表取締役そう。API キーでもいけるけど、OAuth の方が楽。
時給換算すると、セットアップでつまづく時間がもったいないし。
時給換算すると、セットアップでつまづく時間がもったいないし。
テキトー教師.AI認定講師ただ、ターミナルが真っ黒な画面にプロンプトが出るだけなので、初めての人は「これで合ってる？」って戸惑うかもしれない。
プロジェクト単位の使い方
室谷代表取締役プロジェクトのルートで
codex を実行すると、そのディレクトリが作業対象になる。Git 管理されてないと怒られるから注意。テキトー教師.AI認定講師現場でよく聞くのは、セットアップスクリプトでハマるパターンですね。
npm install --legacy-peer-deps とか書いておくと、インストール後にサーバーが起動しっぱなしになって、エージェントが先に進めない。室谷代表取締役そこは起動コマンドは並列で回せないから、スクリプトは一発で終わるものだけにしろって話。ROI で考えると、その辺のチューニングを最初にやるだけで後々の効率が全然違う。
テキトー教師.AI認定講師あとは
--skipGitRepoCheck で Git チェックを飛ばせるのも知っておくと便利。エージェントとしての振る舞い設定
室谷代表取締役Codex ってデフォルトでも結構賢いけど、環境変数で挙動を変えられる。
CODEX_APPEND_ENV_CONTEXT とかでコンテキストを付与できる。テキトー教師.AI認定講師プロジェクトごとにエージェントに知っておいてほしい情報を設定しておくと、精度が上がる。例えば「使うフレームワークはReact」とか「lintルールはこれ」とか。
室谷代表取締役そういうのはエージェント用の設定ファイルにまとめておくと、毎回の指示が省けて、コスト的にも嬉しい。ついでに言うと、この辺の設計がちゃんとしてるチームは生産性が段違い。
テキトー教師.AI認定講師最初にちょっと時間をかけて設定しておくだけで、後々の開発速度が全然変わりますからね。
開発者向け：Codex SDK の npm パッケージ
CLI (@openai/codex)
- インタラクティブに使用
- プログラム制御不可
- スレッド管理なし
- CI向けではない
SDK (@openai/codex-sdk)
- コードからエージェント制御
- スレッド管理可能
- CIに組み込みやすい
- ストリーミング対応（runStreamed）
- 構造化出力対応（outputSchema）
@openai/codex-sdk のインストール
室谷代表取締役npm install @openai/codex-sdk 一発で入るんですけど、Node.js 18以上が条件ですね。依存関係も最小限で、実用的な設計です。
テキトー教師.AI認定講師たしかに。CLI 版の @openai/codex と別物で、こっちは SDK ですね。
コードからエージェントを制御したい人向けです。
コードからエージェントを制御したい人向けです。
室谷代表取締役そう。CLI がインタラクティブに使うのに対して、SDK はプログラムからスレッド管理できる。
CI に組み込むならこっち一択でしょう。
CI に組み込むならこっち一択でしょう。
テキトー教師.AI認定講師初期化も簡単で、new Codex() するだけ。Node.js プロジェクトならすぐ試せます。
Node.js からのプログラム制御
室谷代表取締役スレッド開始して run() を呼ぶと、エージェントが動作する。会話を継続したいなら同じスレッドで run() を繰り返すだけです。
テキトー教師.AI認定講師あ、これハマるポイントがあって、run() はターンが完了するまでバッファリングするんです。非同期で進捗を見たい場合は runStreamed() を使います。
室谷代表取締役並行処理を考えると、スレッドごとに独立してるからマルチタスクにも使える。運用面で言うと、スレッドは ~/.codex/sessions に永続化されるので、再開も可能です。
テキトー教師.AI認定講師resumeThread() で復帰できるのも地味に効きますね。開発中にプロセスが落ちても続きから再開できます。
ストリーミングや構造化出力の活用
室谷代表取締役runStreamed() はイベントを非同期ジェネレータで返す。ツールコールやファイル変更の通知を逐次処理できるんですよ。
テキトー教師.AI認定講師構造化出力も強力で、outputSchema に JSON スキーマを渡すとエージェントがその形式で応答してくれます。
室谷代表取締役Zod を使ってスキーマ定義して zod-to-json-schema で変換する流れが推奨されてる。型安全にエージェントの応答を扱いたい現場では必須ですね。
テキトー教師.AI認定講師スキーマに additionalProperties: false を付けて厳密にすると、余計なプロパティが混入しない。品質管理の観点でも良いです。
よくある質問
Q1. Codex CLI を使うのに ChatGPT Plus は必要ですか？
室谷代表取締役必須ではないんですけど無料枠だとかなり制限がきついです。US だと Plus 契約が標準になってますね。
テキトー教師.AI認定講師たしかに、無料アカウントでも動くんですが、リクエスト数にすぐ引っかかります。初めて触るなら Plus か Pro をおすすめします。
Q2. Codex CLI と GitHub Copilot CLI、どちらがいいですか？
室谷代表取締役根本的にアプローチが違います。Copilot は補完重視、Codex CLI はタスクの自動実行志向ですね。
テキトー教師.AI認定講師現場感覚で言うと、単体のコマンド生成なら Copilot、複数ステップの処理を任せたいなら Codex CLI の方が向いてます。
Q3. プロキシ環境下でも使えますか？
室谷代表取締役npm のインストールと、CLI の通信が HTTPS 経由なので、プロキシ設定でいけるケースが多いです。ただ環境によっては追加設定が必要です。
テキトー教師.AI認定講師最初にハマる人多いんですよ。npm config set proxy と同時に、Codex CLI 側でプロキシ変数が通ってるか確認するといいです。
Q4. 既存の npm パッケージと競合しませんか？
室谷代表取締役グローバルインストールするので同名パッケージが無い限り問題ないです。ただ package.json でバージョン固定してるプロジェクトでは注意が必要です。
テキトー教師.AI認定講師npx で実行すれば競合は避けられます。チーム開発なら npx 推奨ですね。
Q5. 日本語のプロンプトでも動作しますか？
室谷代表取締役モデルがマルチランゲージ対応してるので日本語でも問題なく動きます。ただし精度は英語の方が上がる傾向です。
テキトー教師.AI認定講師最初に戸惑うのが、コマンド出力が英語で返ってくることくらいですね。プロンプト自体は日本語で大丈夫です。
まとめ
室谷代表取締役結局 Codex CLI は npm で一発入れてすぐ使える、エントリーハードルが低いのが強みですね。
テキトー教師.AI認定講師現場でよく聞かれる「最初の一歩」としては、この記事の手順でほぼカバーできると思います。
室谷代表取締役ただエージェント的な使い方をするなら、API 経由と組み合わせた方がいい。CLI 単体だとやれることに限界があるんで。
テキトー教師.AI認定講師そうですね。まずは CLI で流れを掴んで、慣れたら SDK に移行するのが王道かなと。
室谷代表取締役ともあれ無料で試せるんで、とりあえず npm install してみるのが吉ですよ。
