1ポイント
始める前の1ポイント
接続や導入は、使う場所とアカウントを確認してから進めると安心です。
まなぶちゃんどの入口から始めればいい？
GPTガイドくんWeb、App、CLIなど入口が変わることがあります。最新情報を確認しつつ、今使う環境から始めましょう。
GPTガイドくん
Codexの入口はいくつかあります。最初は作業対象と権限を確認し、小さな確認タスクから始めましょう。
まなぶちゃん
インストールやGitHub接続で迷ったら、無理に進めず前提を整理します。
まず全体像
このページで分かること
- Codex Web、App、IDE拡張、CLI、GitHub連携の違い
- 初心者が最初に選びやすい入口
- GitHub接続が必要になる場面
- CLIを使う時に必要になりやすい準備
- 最初に頼みやすい確認タスク
- 秘密情報や権限で注意すること
CodexはWebで使うの？それともCLIをインストールするの？
最初はWebやAppで流れをつかみ、エディタ作業ならIDE拡張、ターミナル作業ならCLIへ進むと分かりやすいです。
Codexはどこから使うのか
Codexの入口は1つではありません。ブラウザで始めるCodex Web、パソコンで使うCodex App、VS Codeなどで使うIDE拡張、ターミナルで使うCodex CLI、GitHubリポジトリと組み合わせる使い方があります。
どれを選ぶかは、今の作業環境で決めます。初心者は、いきなりCLIだけで進めるより、まずWebやAppで「タスクを渡す」「差分を見る」「報告書を読む」流れをつかむと安心です。
| 入口 | 向いている人 | 特徴 | 注意点 |
|---|---|---|---|
| Codex Web / Cloud | ブラウザで始めたい人 | GitHubリポジトリを接続して、クラウド側でタスクを進められる場合があります。 | 環境設定やGitHub接続が必要になることがあります。 |
| Codex App | 専用画面で作業したい人 | プロジェクトフォルダを選び、ローカルやクラウドで作業を進めやすい入口です。 | 対応OS、サインイン方法、対象フォルダを確認します。 |
| IDE拡張 | VS Codeなどで作業する人 | エディタ内でファイルや選択範囲を文脈にしながらCodexを使えます。 | エディタと拡張の設定が必要です。 |
| CLI | ターミナルに慣れている人 | 現在のディレクトリを作業対象にして、コマンドラインからCodexを使います。 | Node.js、npm、シェル操作の知識が必要になる場合があります。 |
| GitHub連携 | リポジトリで作業したい人 | PR、差分確認、レビューと相性がよい使い方です。 | 接続するリポジトリと権限を最小限にします。 |
まず初心者はCodex Webから始めると分かりやすい
Codex Webは、ブラウザからCodexを使う入口です。OpenAIが提供する情報では、Codex CloudでGitHubアカウントを接続し、リポジトリのコードを使ってタスクを進め、Pull Request作成につなげる流れが案内されています。ただし、画面や接続手順は変わる可能性があります。
最初のタスク例
このリポジトリの構成を確認し、どのファイルが何の役割かを説明してください。
修正はまだ行わないでください。Codex Appを使う場合
Codex Appは、パソコン上でCodex作業を進めるための専用アプリとして案内されている入口です。OpenAIが提供する情報では、macOSとWindows向けの案内があり、プロジェクトフォルダを選んで作業する流れが紹介されています。
ローカルファイルを扱う場合は、対象フォルダを間違えないことが重要です。秘密情報が入ったフォルダや、本番環境の設定ファイルが混ざる場所を不用意に選ばないようにします。
Codex Appを使う時は、作業対象フォルダ、Gitの状態、バックアップ、触ってはいけないファイルを確認してから始めます。
IDE拡張を使う場合
IDE拡張は、VS Code系エディタやJetBrains IDEなどの中でCodexを使う方法です。OpenAIが提供する情報では、Codex IDE拡張をインストールし、ChatGPTアカウントまたはAPIキーでサインインして使う流れが説明されています。
IDE拡張は、普段からエディタでコードを見ている人に向いています。開いているファイルや選択範囲を文脈にできる場合がある一方、初心者がいきなり使うと「どのファイルを見せているのか」が分かりにくいこともあります。まずWebやAppで概念を理解してからでも遅くありません。
Codex CLIを使う場合
Codex CLIは、ターミナルからCodexを使う方法です。OpenAIが提供する情報では、npmでインストールし、ターミナルで codex を実行して、ChatGPTアカウントまたはAPIキーでサインインする流れが案内されています。OSごとの対応状況や細かい手順は変わる可能性があるため、最新情報を確認してください。
npmでインストールする例
npm i -g @openai/codex
codexHomebrewでインストールする例
brew install codex
codexnpmで更新する例
npm i -g @openai/codex@latestCLIは便利ですが、現在のディレクトリが作業対象になりやすいため、どのフォルダで起動しているかを必ず確認します。誤って別サイトや本番設定を含む場所で起動しないようにしてください。
GitHub接続が必要になる場面
GitHub接続は、リポジトリのコードをCodexに確認させたい時、PRや差分確認を使いたい時、クラウド側でタスクを進めたい時に関係します。OpenAIが提供する情報では、CodexでGitHubリポジトリを接続し、コードやREADMEなどを扱う流れが案内されています。
ただし、接続しただけで安全になるわけではありません。必要最小限のリポジトリだけを接続し、Secrets、APIキー、SSH鍵、DB情報、FTP情報などを通常ファイルに入れないことが大切です。
接続するリポジトリが分からない、権限範囲が広すぎる、秘密情報が混ざっている可能性がある、mainへ直接変更しそうな場合は、接続や作業を止めて人間が確認します。
Codexを始める前に準備すること
- 自分のプランや利用条件でCodexが使えるか確認する
- 作業対象のサイト、リポジトリ、フォルダを決める
- 秘密情報や認証情報を対象から外す
- GitHub接続が必要か判断する
- 作業ブランチやバックアップを考える
- 最初は修正ではなく確認だけにする
- 報告書を読む時間を確保する
最初に頼むおすすめタスク
最初のCodexタスクは、ファイル修正ではなく「構成確認」「差分確認」「公開前チェック」のような低リスク作業がおすすめです。Codexが何を見て、どう報告するかを確認してから、小さな修正へ進みます。
| 避けたい最初の依頼 | おすすめの最初の依頼 |
|---|---|
| このサイトを全部直して | このリポジトリの構成を説明してください。修正はしないでください。 |
| SEOを全部強化して | 対象ページのtitle、canonical、robots、H1を確認して報告してください。 |
| mainに直接反映して | 作業ブランチまたは差分確認前提で、変更候補だけ報告してください。 |
インストール・接続でつまずきやすい点
どの入口を使うべきか分からない、GitHubリポジトリが見えない、CLIのインストール場所が分からない、対象フォルダを間違える、といった点で止まりやすいです。
古い記事だけで判断せず、正式な情報、現在の画面、対象プラン、OS、接続リポジトリ、権限を順番に確認します。
Codexを始める時の安全チェック
開始前チェックリスト
- どの入口から使うか決めた
- 最新の正式情報を確認した
- 対象フォルダやリポジトリを決めた
- 秘密情報や認証情報を貼っていない
- 必要最小限のGitHub接続にした
- 最初のタスクを小さくした
- 修正ではなく確認から始める
- 報告書を人間が確認する
次に読むページ
このカテゴリの親ページへ戻る
同じカテゴリのページを続けて読む場合は、親ページの一覧から選ぶと迷いにくくなります。
近いテーマの読み分け
Codex全体、導入、基本、スマホ確認、PC作業、並行作業の役割を分けて読むと迷いにくくなります。
Codex導入の次に読むページ
検索や個別ページから入った場合は、親カテゴリや近い実務ページへ進むと全体像をつかみやすくなります。
ニュース導線
関連ニュースも確認する
新機能や仕様変更に関係する話題は、ニュースページでも確認できます。ニュースを見たあと、使い方や注意点をこのページで整理すると判断しやすくなります。