Codex CLI
インストール完全ガイド
初心者向け手順

この記事で分かること

「Codex インストール」で検索している人が知りたいことは、たぶんコマンドだけではありません。

どのツールを入れるのか。MacとWindowsで何が違うのか。ChatGPT課金中ならそのまま使えるのか。APIキーは必要なのか。エラーが出たらどうすればいいのか。Claude Codeと比べて何が強いのか。

Codexとは？

Codexは、OpenAIが提供しているAIコーディングエージェントです。コードを書くだけではなく、リポジトリを読み、変更案を作り、必要に応じてコマンド実行やテスト確認まで手伝えます。

今のCodexの強さは、ChatGPTを使っている人がその延長で入りやすいことです。すでにChatGPTに課金している人なら、Codexを試す心理的ハードルがかなり低いです。

Claude Codeも強いです。ただ、今の勢いでいうと、OpenAI / ChatGPTの利用者がそのまま流れ込めるCodexはかなり強いです。

ChatGPTが「質問に答えてくれるAI」だとすると、Codexは「ChatGPTの先にある、実作業を進めるAI」です。

たとえば、既存コードの理解、バグ修正、README整理、テスト追加、CSV処理ツール作成、社内管理画面の小さな改善、SNS運用の半自動化、動画制作、AI画像生成、ブログ自動化、note自動化、レポート作成の自動化などを、日本語で相談しながら進められます。

初心者にとって大事なのは、Codexは「プログラミングを全部覚えてから使うツール」ではないということです。むしろ、分からないコードを読み解いたり、どこから直せばいいかを一緒に探すためのツールです。

あわせて読む Claude Codeのインストール方法も見る Claude CodeとCodexを比較したい人は、こちらの記事も合わせて確認できます。

Codexで
できること一覧

Codexでできることは、開発だけではありません。むしろ、ChatGPTで文章や企画を作っていた人が、次に「実際のファイル作成」「自動化」「運用改善」まで進めるための道具としてかなり強いです。

特に、開発者、Web担当者、経営者、SNS運用者、社内の業務改善担当には相性がいいです。

Codexでできることと
Claude Codeでできること

CodexとClaude Codeは、どちらも強いAI作業ツールです。

ただし、見せ方を分けるならこうです。

Codexで
できないこと・危険性

便利ですが、何でも任せればいいわけではありません。

Codexはファイル編集やコマンド実行に関わるため、使い方を間違えると危険です。特に本番DB、決済、顧客情報、環境変数、秘密鍵が絡む作業は、人間が必ず確認してください。

ただし、危険だから使わない方がいいという話ではありません。承認モードを理解し、Gitで差分を確認し、小さい作業から始めれば、かなり強力な実務ツールになります。

Codexは無料？
料金とプランの選び方

CodexはChatGPTプランで使う方法と、CLIでAPIアカウントを使う方法があります。対象プランや利用条件は変わる可能性があるため、最新情報はOpenAI公式ページで確認してください。

ChatGPTプランで使う

OpenAIの公式ヘルプでは、CodexはChatGPT Plus、Pro、Business、Enterprise/Eduなどのプランで利用できる案内があります。時期によって無料プランや一部プランへの提供状況、レート制限、キャンペーンが変わる可能性があります。

初心者は、まずChatGPTアカウントで使える範囲を確認するのが分かりやすいです。すでにChatGPTに課金しているなら、ここがかなり大きいです。新しく別サービスを契約する前に、まずCodexを試す価値があります。

CLIで使う

Codex CLIは、ターミナルから使う方法です。公式ヘルプでは、APIキーを環境変数に入れて使う流れと、codex --login でChatGPTアカウントにサインインする流れが案内されています。

迷ったら、まずChatGPT課金で使える範囲を確認し、そのうえでCLIを入れて、codex を起動し、リポジトリ説明を頼むところから始めればOKです。

Codexの使い方は
3種類ある

Codexは、1つの画面だけで使うツールではありません。

初心者は、まずローカルのCLIから始めるのがおすすめです。動きが見えやすく、何を読んで、何を変えようとしているか確認しやすいからです。

Codexの
インストール前に準備するもの

準備するものはシンプルです。

公式ヘルプでは、Codex CLIはmacOSとLinuxを公式サポートし、Windowsは実験的でWSLが必要になる場合があると案内されています。Windowsの人は、最初からWSLで進める方が詰まりにくいです。

Codexの
インストール方法（Mac）

Macの人はかなりラクです。まずターミナルを開きます。

npm install -g @openai/codex

codex

brew install --cask codex

codex

Codexの
インストール方法
（Windows / WSL）

Windowsの人は、まずWSLを使う前提で考えるのが安全です。

Codex CLIはmacOSとLinuxが公式サポートで、Windowsは実験的な扱いです。Windows単体のPowerShellやCMDで無理に進めるより、WSL上のUbuntuなどで進める方が詰まりにくいです。

node -v

npm -v

npm install -g @openai/codex

codex

Codexの
ログイン方法と初回動作確認

インストールできたら、ターミナルまたはWSLで以下を実行します。

codex

または、明示的にログインする場合は以下です。

codex --login

公式ヘルプでは、ChatGPTアカウントでサインインする流れが案内されています。ブラウザが開いたら、OpenAI / ChatGPTアカウントでログインしてください。

export OPENAI_API_KEY="<YOUR_API_KEY>"

最初のテスト

ログインできたら、まずは日本語で話しかけます。

このリポジトリの構成を初心者向けに説明してください。

返事が返ってきたらOKです。さらに実用的なテストをするなら、README整理や小さい修正を頼みます。

READMEを読んで、セットアップ手順で初心者が詰まりそうな場所を教えてください。

Codexの
承認モードと安全な使い方

Codex CLIには、作業をどこまで任せるかを選ぶ考え方があります。

公式ヘルプでは、Suggest、Auto Edit、Full Autoのような承認モードが案内されています。

Suggest

最初はこのモードが安全です。ファイルを読んだり、修正案を出したりできますが、実際の編集やコマンド実行は人間の確認を挟みます。

Auto Edit

ファイル編集をある程度任せるモードです。修正量が多いときには便利ですが、必ず差分を確認してください。

Full Auto

読み取り、書き込み、コマンド実行まで強く任せるモードです。便利ですが、初心者が最初から使うモードではありません。

Codexが
動かない時のエラー対処

codex コマンドが見つからない

npmのグローバルインストール先にPATHが通っていない可能性があります。ターミナルを開き直すか、npmのグローバルbinパスを確認してください。

npm bin -g

npm install -g @openai/codex

権限エラーでインストールできない

npmのグローバルディレクトリに書き込み権限がない可能性があります。sudo で無理に進めるより、Node.jsの管理方法を見直すか、nvmやHomebrewを使う方が安全です。

ログインできない

ブラウザが開かない、認証が戻ってこない、アカウント選択で止まる場合があります。まずCodex CLIを最新版にします。

npm install -g @openai/codex

codex --login

APIキーで動かない

環境変数名が間違っている可能性があります。

export OPENAI_API_KEY="<YOUR_API_KEY>"

Windowsで起動しない

Windowsサポートは実験的です。まずWSL上でインストールし直してください。PowerShellやCMDでうまくいかない場合でも、WSLのUbuntu上では進むことがあります。

Codexを使い始めたいです。
目的:
使っているPC:
OS:
ChatGPTに課金しているか:
インストール用の準備ができているか:
やりたい作業:

ChatGPT上で試す方法、パソコンに入れて使う方法、エディタで使う方法のうち、どれから始めるのがよいか初心者向けに教えてください。

Codexをインストールしている途中で止まりました。
実行したコマンド:
表示されたエラー:
バージョン確認の結果:
使っているOS:

原因候補と、安全に試す順番を教えてください。

Codexのログインで止まっています。
実行したコマンド:
ブラウザが開いたか:
ChatGPTアカウント選択まで進んだか:
表示されたエラー:

ログインできない原因候補と、次に確認することを順番に教えてください。

Codexを秘密のキーで使おうとしています。
設定した項目名:
実行したコマンド:
表示されたエラー:
使っている画面:

秘密のキーそのものは貼りません。設定場所の確認方法と、設定ミスの見つけ方を教えてください。

WindowsでCodexを使いたいです。
今開いている画面:
試したこと:
表示されたエラー:
やりたい作業:

Windowsのどの画面で進めるべきか、初心者向けに判断してください。

Codexをインストールできました。
自分の仕事:
今あるフォルダやプロジェクト:
やりたいこと:
不安なこと:

最初にCodexへ頼むと安全な小さい作業を5つ提案し、それぞれの依頼文も作ってください。

Codexと
Claude Codeの違い

CodexとClaude Codeは、どちらもAIコーディングエージェントです。

どちらが上というより、使い分けるのが現実的です。

ただ、今の勢いでいうとCodexはかなり強いです。理由は、ChatGPTを使っている人が多く、課金ユーザーならそのまま始めやすく、OpenAIアカウント中心でCLI、IDE、クラウド委任へ広げやすいからです。

最初はどちらか1つで大丈夫です。ただ、ChatGPTに課金しているなら、最初のおすすめはCodexです。すでに使っている環境の延長で始められるので、導入のハードルが低いです。

あわせて読む Claude Code インストール方法 Claude Code側の手順も見て、どちらから始めるか比較できます。

Codexの
実務活用事例16選

この記事は、ただのセットアップ手順ではありません。Codexを入れたあと、開発だけでなく、SNS、YouTube、動画制作、AI画像生成、ブログ、note、レポート、経理、社内ツールまでどう自動化できるかをイメージできるようにしています。

AI駆動倶楽部の考え方は「AIで作る / AIでバズる / AIで運営する」。ひとりでもAIチームを作って、開発・SNS・事務・リサーチ・運営を回していく世界観です。運営はhashshnet（はしもとかずや）です。

収益化の入口として、SNS運用代行、投稿下書き生成、YouTube運用補助、動画制作、AI画像生成、ブログ自動化、note自動化、LP制作、業務自動化、簡易アプリ開発、保守改善、社内ツール開発、AI導入支援などは、Codexを使うことで個人でも取り組みやすくなります。

SNS投稿については、Ban対策の責任を取れないため、自動投稿は推奨しません。Codexでは投稿案や素材、CSVを作り、公開前に人間が確認する運用を前提にしてください。

大事なのは「AIを触れる人」で止まらず、「AIを実務に落として成果に変える人」になることです。

Codexのよくある質問

まとめ Codexは、
開発を前に進めるAIです

Codexのインストールは、難しそうに見えますが、やることはシンプルです。

最初から完璧に理解しなくて大丈夫です。まずは起動する。触る。小さい作業を任せる。そこから少しずつ、仕事のやり方が変わっていきます。