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

この記事で分かること

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

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

Codexとは？

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

今のCodexの強さは、ChatGPTを使っている人がその延長で入りやすいことです。すでにChatGPTに課金している人なら、追加契約なしで、同じアカウントのままログインして使い始められます。

Claude Codeも強いです。ただCodexは、月20ドルのChatGPT Plusをすでに払っている人がそのまま試せるので、「まず1回動かしてみる」までの距離が短いです。

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は月20ドルのChatGPT Plusをはじめ、Pro、Business、Enterprise/Eduなどのプランで利用できる案内があります。時期によって無料プランや一部プランへの提供状況、レート制限、キャンペーンが変わる可能性があります。

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

CLIで使う

Codex CLIは、ターミナルから使う方法です。公式ドキュメントでは、codex login でChatGPTアカウントにサインインする流れと、APIキーを設定して使う流れが案内されています。

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

Codexの使い方は
3種類ある

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

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

あわせて読む Codexデスクトップ版スマホ連携｜ChatGPT操作手順 Macで動かしたCodexを、スマホのChatGPTアプリから確認・指示する実際の連携手順です。

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

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

公式ドキュメントでは、Codex CLIはmacOS・Windows・Linuxをサポートすると案内されています。以前は「Windowsは実験的でWSL推奨」という扱いでしたが、現在はWindowsのPowerShellでそのまま動かせます。Linux前提のプロジェクトを触る人だけ、WSL2を使えばOKです。

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

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

npm install -g @openai/codex

codex

brew install --cask codex

codex

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

Windowsの人は、PowerShellでそのまま進められます。

以前のCodex CLIは「Windowsは実験的でWSLが必要」という案内でしたが、現在の公式ドキュメントではmacOS・Windows・LinuxすべてがサポートOSです。WindowsはPowerShell上でネイティブに動かせます。

node -v

npm -v

npm install -g @openai/codex

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

codex

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

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

codex

初回はサインインを求められます。明示的にログインする場合は以下です。

codex login

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

export OPENAI_API_KEY="<YOUR_API_KEY>"

最初のテスト

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

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

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

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

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

Codex CLIには、作業をどこまで任せるかを選ぶ「承認モード」があります。

2026年7月時点の公式ドキュメントでは、Read Only、Auto、Full Accessという3段階で案内されています。古い記事や動画に出てくる「Suggest / Auto Edit / Full Auto」は旧バージョンの呼び方です。呼称はバージョンで変わるため、迷ったら画面の表示に従ってください。

Read Only（読み取り専用）

まず様子を見たい時はここからが安全です。ファイルを読んで質問に答えたり、修正の計画を立てたりできますが、実際の編集やコマンド実行のたびに人間の承認を挟みます。

Auto（初期設定）

普段使いの基本モードです。作業フォルダの中なら、ファイルの読み書きやコマンド実行をCodexに任せられます。フォルダの外を触る時や、ネット接続が必要な時は、Codexの方から承認を求めてきます。

Full Access（全部任せる）

サンドボックスの制限を外して、ネット接続まで含めて強く任せるモードです。便利ですが、初心者が最初から使うモードではありません。

モードは、Codexの画面内でスラッシュコマンド（/approvals や /permissions など、バージョンにより表記が変わります）から切り替えられます。

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

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

症状: command not found: codex や「codexは認識されていません」と表示され、起動できない。

原因: npmのグローバルインストール先にPATHが通っていない。インストール後にターミナルを開き直していない。インストール自体が失敗している。

確認すること: ターミナルをいったん閉じて開き直したか。npm prefix -g で表示されるフォルダの中の bin にcodexが入っているか。

対処: ターミナルを開き直して再実行。ダメならnpmのグローバルの場所を確認し、それでもダメならインストールし直します。

npm prefix -g

npm install -g @openai/codex

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

症状: npm install -g の途中で EACCES や permission denied と表示されて止まる。

原因: npmのグローバルフォルダに書き込み権限がない。OS標準の場所にNode.jsを入れていて、管理者権限が必要になっている。

確認すること: エラー文に EACCES が含まれているか。Node.jsをどうやって入れたか（公式インストーラー、Homebrew、nvmなど）。

対処: sudo で無理に進めない方が安全です。Macならnvm（Node.jsの切り替えツール）やHomebrew経由でNode.jsを入れ直してから、もう一度インストールしてください。

ネットワークエラーでインストールが止まる

症状: npm install の途中で ETIMEDOUT や ECONNRESET のような表示が出て、ダウンロードが進まない。

原因: 回線が不安定、またはWi-Fiが途中で切れた。会社のネットワークで外部接続が制限されている。

確認すること: ブラウザで普通にWebサイトが開けるか。会社や学校のネットワークを使っていないか。

対処: 回線を確認して同じコマンドを再実行（再実行で通ることが多いです）。会社のネットワークで止まる場合は、自宅回線やスマホのテザリングで試してください。それでも止まる場合は、エラー文をコピーしてAIに相談します（秘密情報は貼らない）。

Node.jsが古くて動かない

症状: インストールや起動の途中で、Node.jsのバージョンに関する警告やエラーが出る。

原因: 何年か前に入れたNode.jsをそのまま使っている。古い32bit環境や古いOSを使っている。

確認すること: node -v で表示されるバージョン。Node.js公式サイトで現在のLTS版（推奨版）のバージョン。

対処: Node.js公式サイトからLTS版を入れ直し、ターミナルを開き直してから、もう一度 npm install -g @openai/codex を実行してください。

ログインできない

症状: ブラウザが開かない、認証後にターミナルへ戻ってこない、アカウント選択で止まる。

原因: Codex CLIが古い。ブラウザ側で別アカウントにログインしている。会社ネットワークやセキュリティソフトが通信を止めている。

確認すること: ブラウザでChatGPTに目的のアカウントでログインできているか。Codex CLIを最新版にしたか。

対処: まずCodex CLIを最新版にして、もう一度ログインします。それでも戻ってこない場合は、ブラウザを一度全部閉じてからやり直してください。

npm install -g @openai/codex

codex login

APIキーで動かない

症状: APIキーを設定したはずなのに、認証エラーになる。

原因: 環境変数名のスペルミス。ターミナルを閉じて設定が消えた。キーそのものが無効化されている。

確認すること: 変数名が OPENAI_API_KEY になっているか（スペルミスが一番多いです）。設定した後に同じターミナルで実行しているか。

対処: 変数名を確認して設定し直します。ターミナルを閉じると設定が消えるため、毎回設定したくない場合はシェル設定ファイルに入れてください。それでもダメなら、OpenAIの管理画面でキーの状態を確認します。

export OPENAI_API_KEY="<YOUR_API_KEY>"

利用上限に達したと表示される

症状: 使っている途中で、利用上限やレート制限のメッセージが出て、返事が返ってこなくなる。

原因: ChatGPTプランごとの利用枠を使い切った。短時間に大きな作業を連続で頼んだ。

確認すること: 表示されたメッセージに、いつ再開できるかの案内が出ていないか。ChatGPTの契約プラン（Plus、Proなど）。

対処: 時間を置いてから再開します（利用枠は一定時間で回復します）。頻繁に上限へ当たるなら、作業を小さく分けるか、プランの見直しを検討してください。利用枠の最新の仕様はOpenAI公式ページで確認できます。

Windowsで起動しない

症状: PowerShellで codex と打っても起動しない。またはエラーで落ちる。

原因: インストールが途中で失敗している。PATHが通っていない。古い情報を見て、WSL前提の手順とPowerShellの手順が混ざっている。

確認すること: npm install -g @openai/codex がエラーなく終わったか。PowerShellを開き直したか。

対処: PowerShellを開き直して再実行。ダメなら公式のWindows用インストーラーで入れ直します。Linux前提のプロジェクトを触る場合だけ、WSLのUbuntu上でインストールし直してください。

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

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の強みは、ChatGPTで考えたことをそのまま作業に変換できること、クラウドに作業を投げて並行で進められること、定型作業をスクリプトにして手放せることです。この3つを軸に、入れたあとの使い方をイメージできるようにしています。

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

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

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

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

あわせて読む Image Generator 2｜画像生成プロンプト30選 SNS投稿、サムネ、LP、広告用の画像素材づくりに、そのままコピペで使えるプロンプト集です。

Codexのよくある質問

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

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

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

更新履歴

• 2026-07-02: 承認モードを現行のRead Only / Auto / Full Accessへ更新。WindowsのPowerShellネイティブ対応を反映。npm bin -g を npm prefix -g へ置換。ログインコマンドを codex login へ更新。エラー対処を8件に増強。実務活用事例をCodexの強みに合わせて刷新。関連記事と用語集を追加。
• 2026-05-08: 記事公開。