「Codexをインストールしたいけれど、CLI・IDE拡張・appのどれを選べばいいのか分からない」「入れた後にログインや料金で詰まらないか不安」という方向けの記事です。この記事を読めば、自分に合った導入形態の選び方、事前に用意するもの、インストールから最初の依頼までの流れ、エラー時の切り分け方まで一通り把握できます。
※Codexとは: OpenAIが提供するコーディングエージェント（コードの読み書き・修正・テスト実行などを自律的に進めるAI）です。ターミナルで動くCLI、エディタに組み込む拡張、デスクトップアプリ、クラウド上で動く版など、複数の入口があります。
ご注意: Codexは更新が速く、インストール手順・対応OS・必要なバージョン・料金体系が変わることがあります。本記事では、変わりやすい具体的なコマンドやバージョン番号は載せず、確認先として公式ドキュメントへのリンクを示します。実行前に必ず最新の公式情報を参照してください。
Codexをインストールする前の前提条件
インストール作業そのものは短時間で終わることが多いものの、事前に次の4点を確認しておくと途中で止まりにくくなります。
必要なものの一覧
| 項目 | 内容 | 確認ポイント |
|---|---|---|
| OS | macOS・Linux・Windowsなど | 対応状況やWindowsでの推奨環境は公式で確認 |
| ターミナル | CLIを使う場合に必須 | macOSの標準ターミナル、Linuxの端末、Windowsの場合は公式案内に従う |
| パッケージ管理ツール | インストール方法によって必要 | npmやHomebrewなど。必要な前提は公式READMEで確認 |
| Git | 変更の確認と巻き戻しに必須級 | 作業するフォルダがGit管理されているか |
| アカウント | ChatGPTアカウントまたはAPIキー | サインイン方法は後述 |
※CLIとは: Command Line Interfaceの略で、文字入力でソフトを操作する方式です。マウス操作の画面ではなく、ターミナルというウィンドウにコマンドを打ちます。
※Gitとは: ファイルの変更履歴を記録する仕組みです。Codexが書き換えた内容を差分で確認したり、元に戻したりするために、導入前に使える状態にしておくと安心です。
料金の考え方：ソフトは無料、モデル利用は別
Codex CLIはオープンソースとして公開されており、ツール本体のダウンロード自体に料金はかかりません。一方で、実際にAIモデルを動かす部分には、次のいずれかが必要になるのが基本です。
- ChatGPTの有料プランに付帯する利用枠を使う
- OpenAI APIのキーを使い、使った分だけ従量課金で支払う
どのプランで何がどこまで使えるか、無料枠が実用的かどうかは時期によって変わります。詳しくはCodexの料金を徹底解説｜無料枠・Plus・Pro・API課金を比較で整理していますので、導入前に目を通しておくと、あとから想定外の課金に気づく事態を避けやすくなります。最新の価格やプラン内容はOpenAI公式の料金ページで確認してください。
※APIキーとは: OpenAIのAPIを利用するための秘密の文字列です。パスワードと同じ扱いで、他人に見せたりGitHubなどに公開したりしてはいけません。
事前に決めておくと良いこと
- 最初に試す題材: 手元の個人用リポジトリや、壊れても困らない検証用フォルダを1つ用意します。業務の本番リポジトリでいきなり試すのは避けましょう。
- 認証方法: ChatGPTアカウントでサインインするか、APIキーを使うか。個人利用ならまずChatGPTアカウント側を検討し、チーム運用や従量課金の管理が必要な場合にAPIキー、という考え方が分かりやすいです。
- 社内ルール: 会社のPCや業務コードで使う場合は、外部AIにコードを送ってよいかを事前に確認してください。
Codexの導入形態を選ぶ：CLI・IDE拡張・app・クラウド版
「インストール」と一口に言っても、Codexには入口が複数あります。先に自分の使い方に合うものを選んでおくと、遠回りしません。
| 形態 | 概要 | 向いている人 | インストールの要否 |
|---|---|---|---|
| Codex CLI | ターミナルで動くオープンソースのエージェント | コマンド操作に抵抗がない人、自動化したい人 | 必要 |
| IDE拡張 | VS Codeなどのエディタ内で使う形態 | エディタから離れず作業したい人 | 拡張の追加が必要 |
| Codex app | デスクトップアプリとして使う形態 | ターミナルが苦手な人、複数タスクを管理したい人 | アプリの導入が必要 |
| クラウド版 | ブラウザ経由でクラウド上の環境で実行 | ローカル環境を汚したくない人、GitHub連携中心の人 | ローカル導入は不要 |
提供形態や対応状況は更新されるため、最新の一覧はCodex公式ドキュメントで確認してください。
どれを選ぶかの目安
- とにかくコードを書き換えながら試したい: CLIまたはIDE拡張から始めるのが一般的です。
- ターミナルが苦手: Codex appが入口として分かりやすい選択肢です。appの機能やCLIとの違いはCodex appとは？機能・料金・始め方・CLIとの違いをOpenAI公式情報ベースで初心者向けに徹底解説で詳しく解説しています。
- 何もインストールしたくない: クラウド版を使えば、ローカルへの導入作業はありません。
なお、これらは排他的ではありません。同じアカウントで複数の形態を併用できる場合があるため、まずは1つ入れて慣れてから広げる進め方で問題ありません。以降の手順は、最も情報が多いCLIを中心に説明します。
基本的な使い方：インストールから最初の操作まで
ここでは、CLIを例に、導入から最初の依頼までの流れを番号付きで示します。具体的なインストールコマンドは更新で変わる可能性があるため、本記事には載せず、公式の記載を参照する形にしています。
- 公式の案内ページを開く: Codex CLIの公式ドキュメントと、GitHubのopenai/codexリポジトリを開きます。システム要件（対応OS、必要な実行環境）を最初に読みます。
- インストール方法を選ぶ: 公式に記載されている方法（npmやHomebrewなどのパッケージマネージャー経由、配布バイナリの利用など、案内されている手段）から、すでに自分のPCにあるツールに合うものを選びます。迷ったら、公式ドキュメントで最初に紹介されている方法を選ぶのが無難です。
- 公式の手順どおりに実行する: 公式ページに載っているコマンドをコピーして、ターミナルで実行します。手打ちよりコピーのほうが打ち間違いを防げます。パッケージ名の似た別物を入れないよう、公式ページ記載のものであることを確認してください。
- インストールできたか確認する: 導入後にバージョンを確認する方法や、起動方法は公式ドキュメントに記載があります。コマンドが見つからない場合は、後述のつまずきポイントを参照してください。
- 作業フォルダへ移動する: Codexを使いたいプロジェクトのフォルダにターミナルで移動します。Codexは、現在いる場所のファイルを対象に作業するのが基本です。ホームフォルダ全体など、広すぎる場所で起動するのは避けます。
- Gitの状態をきれいにしておく: 未コミットの変更がある場合は、先にコミットするか退避します。こうしておくと、Codexの変更だけを差分で確認でき、不要なら破棄もできます。
- Codexを起動してサインインする: 初回起動時に、ChatGPTアカウントでのサインインまたはAPIキーの設定を求められるのが一般的です。画面の案内に従って進めます。APIキーを使う場合は、環境変数など公式が案内する安全な方法で設定し、コード内に直接書かないようにします。
- 最初は読み取り中心の依頼から始める: いきなりファイルの書き換えを頼まず、まず「このリポジトリの構成を説明して」といった質問から試します。承認なしに変更が走らない設定になっているかも、この段階で確認します。
- 変更の提案は必ず差分で確認する: Codexが編集やコマンド実行の許可を求めてきたら、内容を読んでから承認します。実行後は、Gitの差分を確認し、意図どおりなら採用、違えば破棄します。
最初の依頼として、次のようなプロンプトが使いやすいでしょう（あくまで例です）。
このリポジトリの目的と、主要なディレクトリの役割を初心者向けに説明してください。
ファイルは変更せず、読み取りだけで回答してください。ここまで動けば、インストールと初期設定は完了です。基本的な操作の全体像や、プロンプトの書き方の基礎はCodexの使い方を完全解説｜導入から実践・つまずき対策までにもまとめています。
※承認（アプローバル）とは: Codexがファイル編集やコマンド実行を行う前に、人間に確認を求める仕組みです。どこまで自動で許可するかは設定で調整できる場合があり、最初は慎重な設定にしておくのが安全です。
※サンドボックスとは: AIが実行するコマンドの影響範囲を限定する隔離環境のことです。ネットワークアクセスや書き込み範囲を制限し、誤操作による被害を抑えます。仕様は公式ドキュメントで確認してください。
実践的な活用例：導入直後に試したい3つのシナリオ
以下は、導入後に動作確認を兼ねて試しやすい使い方の例です。プロンプトはあくまでひな形なので、ご自身のプロジェクトに合わせて書き換えてください。結果はリポジトリの内容やモデルによって変わります。
例1：初めて見るリポジトリの構造を理解する
新しいプロジェクトに参加したときや、OSSのコードを読みたいときに、全体像を素早くつかむ使い方です。変更を伴わないので、最初の一歩として安全です。
このリポジトリを読み取り専用で調査してください。
1. 使用している言語とフレームワーク
2. エントリーポイントとなるファイル
3. テストの置き場所と実行方法
4. 初めて読む人が最初に見るべきファイル3つ
を、箇条書きでまとめてください。ファイルの変更は不要です。回答に出てきたファイル名を、実際に自分の目で開いて確かめる習慣をつけましょう。AIの説明は間違うことがあるため、根拠となるファイルを確認することが大切です。
例2：小さなバグを修正してテストで確かめる
再現手順がはっきりした小さな不具合は、Codexが得意とする題材の1つです。ポイントは「範囲を絞る」「テストで確認させる」の2点です。
関数 calculate_total で、割引率が0のときに合計金額が不正になるバグがあります。
- 修正対象は該当ファイルのみ。他のファイルは変更しないでください。
- 修正前に、失敗するテストを1つ追加してください。
- 修正後、既存のテストを含めて実行し、結果を報告してください。
- 変更内容を、変更理由とあわせて要約してください。実行後は、Gitの差分で次の点を確認します。
- 変更ファイルが想定の範囲に収まっているか
- 追加されたテストが、バグを本当に再現しているか
- 無関係な整形変更や、テストの削除・無効化が混ざっていないか
例3：READMEのセットアップ手順を実態に合わせて整える
ドキュメントの更新は、コードより影響が小さく、AIに任せやすい作業です。実際の設定ファイルと見比べて、古い記述を洗い出させます。
README.md のセットアップ手順が、現在のリポジトリの内容と合っているか確認してください。
- package管理ファイルや設定ファイルと矛盾する記述を一覧にしてください。
- 一覧を確認するまでは、README.md を書き換えないでください。
- 私が承認した項目だけ修正してください。このように「まず一覧を出させ、承認した分だけ直させる」二段階にすると、意図しない大幅な書き換えを防げます。慣れてきたら、GitHubと連携してPR作成やレビューに広げることもできます。その場合の接続手順と注意点は、Codex GitHub連携の完全ガイド｜リポジトリ接続・PR作成・自動レビューの設定と注意点を詳しく解説を参照してください。
よくあるつまずきポイントと対処法
インストール周辺で起こりやすい問題を、症状別に整理します。個別のエラー文言は環境によって異なるため、最終的には公式ドキュメントとGitHubのIssue（不具合報告の掲示板）で最新情報を確認してください。
| 症状 | 考えられる原因 | 対処の方向性 |
|---|---|---|
| インストール後にコマンドが見つからない | PATH（実行ファイルの検索場所）に入っていない、ターミナルが古い状態のまま | ターミナルを開き直す。公式の案内にあるインストール先がPATHに含まれているか確認 |
| 権限エラーが出る | グローバルな場所への書き込み権限がない | 管理者権限で無理に実行せず、公式が推奨する権限の設定方法を確認 |
| 要件のバージョンが合わない | 実行環境（Node.jsなど）のバージョンが古い | 公式の要件を確認して更新。複数バージョン管理ツールの利用も検討 |
| Windowsでうまく動かない | 対応状況や推奨環境の違い | 公式のWindows向け案内を確認。推奨環境が案内されていればそれに従う |
| サインインが完了しない | ブラウザ認証が開かない、アカウントの契約状態 | 認証URLを手動で開く、別ブラウザで試す、プランの状態を確認 |
| 利用上限に達したと表示される | プランの利用枠を使い切った | 枠のリセット待ち、プラン見直し、API課金への切り替えを検討 |
| 社内ネットワークで接続できない | プロキシやファイアウォールの制限 | 情報システム部門に許可先を確認。公式の要件ページを提示して相談 |
※PATHとは: ターミナルが実行ファイルを探しに行くフォルダの一覧です。ここにCodexの置き場所が含まれていないと、インストールしたのに「見つからない」と表示されます。
管理者権限で無理やり実行しない
権限エラーが出ると、つい管理者権限（sudoなど）を付けて実行したくなります。しかし、これは後々の更新時にさらなる権限トラブルを招いたり、システムのファイルを意図せず変更したりする原因になります。公式が案内している権限まわりの設定方法を確認し、できるだけ一般ユーザーの権限で収まる構成にしておくのが安全です。
ログインできるのに使えない場合
サインイン自体は成功しても、プランの対象外であったり、利用枠が尽きていたりして実行できないことがあります。この場合は、インストールの失敗ではなく契約や利用枠の問題です。自分のプランでCodexが使えるか、残りの枠はどうなっているかを、アカウント画面と公式の説明で確認しましょう。無料で使えるかどうかの境界は、前述の料金解説記事で整理しています。
「入れたのに思ったように動かない」を減らす4つの習慣
- 公式の手順を優先する: 個人ブログやSNSの手順は古い場合があります。本記事も含め、最終判断は公式ドキュメントで行ってください。
- 1つずつ確認する: インストール、起動、サインイン、最初の依頼を段階ごとに確認し、どこで止まったかを特定します。
- エラー文言をそのまま検索する: エラーメッセージの全文をコピーして、公式リポジトリのIssueと照合すると、既知の問題と解決策が見つかることがあります。
- 作業は専用ブランチで: Gitのブランチを分けておけば、失敗しても本流に影響しません。
上級者向けのテクニック
基本の導入に慣れたら、次のような工夫で精度と安全性を高められます。いずれも設定項目や書式は更新されうるため、最新の仕様は公式ドキュメントで確認してください。
AGENTS.mdでプロジェクトのルールを伝える
Codexは、リポジトリ内にAGENTS.mdというファイルを置くと、プロジェクト固有の指示として参照できる仕組みがあります。毎回同じ説明をプロンプトに書く手間が省け、作業の再現性が上がります。書式の仕様はAGENTS.md公式サイトや、Codex公式ドキュメントで確認してください。
※AGENTS.mdとは: AIコーディングエージェント向けの説明書として、リポジトリに置くMarkdownファイルです。ビルドやテストの方法、コーディング規約、触ってはいけない場所などを書きます。
記述例は次のとおりです（内容はプロジェクトに合わせて変更してください）。
# プロジェクトのルール
## 概要
- 社内向け在庫管理ツール。バックエンドはPython、フロントはTypeScript。
## 作業ルール
- 変更は依頼された範囲に限定すること。
- 既存のテストを削除・無効化しないこと。
- 設定ファイルや認証情報（.envなど）は読まない・変更しない。
## 完了条件
- テストが通ること。
- 変更内容と理由を日本語で要約すること。承認とサンドボックスの設定を使い分ける
作業の性質に応じて、AIにどこまで任せるかを調整できます。たとえば次のように考えると整理しやすくなります。
| 作業内容 | 方針の例 |
|---|---|
| 初見のリポジトリ調査 | 読み取り中心。書き込みは承認制 |
| 小規模な修正 | 編集は承認制のまま、差分を見て採用 |
| 検証用の使い捨て環境 | 権限を広げる場合も、本番データや認証情報に触れない環境に限定 |
権限を広げるほど作業は速くなりますが、誤操作の影響も大きくなります。具体的な設定名や選択肢は公式ドキュメントで確認し、「速さ」より「戻せること」を優先して設計してください。
依頼の粒度を設計する
大きな依頼を1回で投げるより、次のように分割したほうが結果を確認しやすくなります。
- 調査（読み取りのみ）で現状と影響範囲を出させる
- 計画を提示させ、人間が承認する
- 小さな単位で実装させ、そのたびにテストを実行させる
- 最後に変更要約とリスクをまとめさせる
この流れにすると、レビューの負担が減り、方向がずれたときに早く気づけます。
設定ファイルで既定値を整える
CLIには、モデルの選択や承認方針などの既定値を設定ファイルで管理できる仕組みがあります。保存場所や記述できる項目はバージョンで変わりうるため、必ず公式ドキュメントの設定の項目を確認してください。個人用の既定値と、プロジェクト単位のルール（AGENTS.md）を分けて考えると、チームで共有しやすくなります。
アップデートと再確認の習慣
Codexは更新頻度が高いツールです。新しいバージョンで操作や設定が変わる可能性があるため、定期的にGitHubのリリース情報や公式ドキュメントの更新内容を確認する習慣をつけましょう。更新後に挙動が変わった場合は、まず公式のリリースノートとIssueを調べるのが近道です。
セキュリティ面の基本
- APIキーや認証情報をリポジトリにコミットしない
.envなどの機密ファイルは、AGENTS.mdで読み取り対象外と明記し、可能なら作業フォルダにも置かない- 会社のコードで使う場合は、データの取り扱いに関する規約と社内ルールを事前に確認する
- 変更は必ず差分レビューを通し、AIの出力をそのまま本番へ反映しない
まとめ
- Codexには、CLI・IDE拡張・Codex app・クラウド版という複数の入口があります。ターミナルに慣れているかどうか、ローカルに入れたいかどうかで選びましょう。
- CLI本体は無料で公開されていますが、モデルの利用にはChatGPTプランまたはAPI課金が基本です。料金や利用枠は変わるため、公式ページで最新情報を確認してください。
- インストール手順やバージョン要件は更新されます。コマンドは公式ドキュメントの記載をそのまま使い、確認なしに古い情報を信用しないことが失敗を防ぎます。
- 最初は「検証用のリポジトリ」「Gitをきれいにした状態」「読み取り中心の依頼」から始め、変更は必ず差分で確認しましょう。
- 慣れたらAGENTS.mdや承認設定、GitHub連携で運用を整え、安全に活用範囲を広げていくのがおすすめです。
よくある質問
Codexのインストールは無料でできますか？
Codex CLI本体はオープンソースとして公開されており、導入自体に料金はかかりません。ただしAIモデルの利用にはChatGPTのプランに含まれる利用枠か、API課金が基本です。最新の条件は公式の料金ページで確認してください。
Codexのインストールにはどんな環境が必要ですか？
CLIの場合はターミナルが使えるPCと、公式が案内する実行環境やパッケージ管理ツールが必要です。加えてChatGPTアカウントまたはAPIキー、Gitがあると安心です。対応OSやバージョン要件は公式ドキュメントで確認してください。
Windowsでもインストールして使えますか？
対応状況や推奨される実行環境は更新されることがあります。Windowsで使う場合は、公式ドキュメントのWindows向け案内を確認し、推奨の環境や手順がある場合はそれに従うのが確実です。
インストール後にコマンドが見つからないと表示されたらどうすればいいですか？
多くはPATHにインストール先が含まれていないか、ターミナルが古い状態のままです。ターミナルを開き直し、公式が案内するインストール先がPATHにあるか確認してください。解決しない場合は公式のIssueを検索しましょう。
CLIとCodex appはどちらから始めるべきですか？
ターミナル操作に慣れているならCLI、苦手ならCodex appが入りやすい選択肢です。同じアカウントで併用できる場合もあるため、まず1つ試して合わなければ切り替えれば問題ありません。
