Codex CLI / IDE / app

Codex CLI初心者は何から始める?

初心者導線ページとして、CLI、IDE、app、GitHub、doctor診断の違いを初心者向けに整理します。公式仕様は変わる可能性があるため、ここでは実務で迷いにくい考え方を中心に扱います。

このページはOpenAIやCodexの公式リファレンスではありません。機能、料金、提供状況は変わる可能性があるため、重要な判断では提供元の最新情報も確認してください。
beginner-map.yml
cli: command
ide: editor
app: screen
doctor: check

まず画面で見る

画面でいうと、このあたりの話です

名前より先に、やりたい作業から選びます

初心者はCLIやIDEの名前から覚えるより、「状態確認をしたい」「コードを見たい」「差分を見たい」のように作業から入口を選ぶと迷いにくくなります。

  1. Codexで何をしたいか決める
  2. 状態確認なら doctor
  3. 文字で動かすなら CLI
  4. コードを見るなら IDE
  5. 差分を見るなら GitHub
  6. 報告を整理するなら GPT

見て分かる対応表

やりたいこと使う入口
Codexの状態を確認したいdoctor
コマンドで作業したいCLI
コードを見ながら直したいIDE
変更差分を見たいGitHub
報告を整理したいGPT

これは公式画面の再現ではなく、初心者が作業場所をイメージするための概念図です。実際の画面や機能は変わることがあるため、重要な判断では公式情報も確認してください。

名前ではなく、やりたいことから選ぶ

最初につまずくのは、似た名前が並んでいて、どれを使えばよいか分からないことです。名前の違いを覚えるより、何をしたいかから選ぶほうが速く進みます。

やりたいこと選ぶもの
手元のファイルをまとめて直したいコマンドで使う形
コードを見ながら編集したい編集画面(IDE)で使う形
相談だけしたいブラウザやアプリで足りる
外出先から短く指示したいスマホから使う形

最初の3日で覚えること

全部を覚える必要はありません。次の3つで作業は始められます。

  1. 作業する場所を指定する — どのフォルダで作業するか
  2. やってほしいことを1文で伝える — 対象・動詞・範囲
  3. 結果を確認する — 何が変わったかを見る

この3つが回れば、あとは必要になった時に足せば済みます。最初から機能を網羅しようとすると、そこで止まります。

初心者が混同しやすいところ

  • 相談と実行の区別 — 相談しただけでファイルは変わりません
  • 作業する場所 — 今どのフォルダにいるかで、対象が変わります
  • 提案と完了の区別 — 「こうすればよい」と言われただけの場合があります
  • 元に戻せるかどうか — 変更前の状態を残しているか

4番目が最初に効いてきます。始める前に、戻す方法を確認しておいてください。

最初につまずく場所と抜け方

つまずき原因抜け方
何も起きない作業する場所が違う今いるフォルダを確認する
関係ないファイルが変わった範囲を指定していない触ってよい範囲を書く
指示が伝わらない対象が曖昧ファイル名を明示する
戻し方が分からない変更前を残していない始める前に確認する

最初にやらないほうがよいこと

  • いきなり本番のファイルを触る
  • 複数の作業を同時に頼む
  • 意味が分からないまま設定を変える
  • 認証に関わる情報をやり取りに貼る
  • 削除を伴う作業

実践ログから分かったこと

最初に時間を無駄にしたのは、名前の違いを調べていた時間でした。何ができるかを比べても、自分がやりたいことに結び付きません。「ファイルを直したいのか、相談したいのか」で選んだら、すぐ決まりました。

もう1つ、作業する場所を確認していなかったため、何も起きないと思っていたことがあります。実際は別のフォルダで動いていました。最初に確認する項目に入れています。

FAQ

何から始めればよいですか?

作業する場所の指定、1文での指示、結果の確認の3つです。これが回れば作業は始められます。

名前が似ていて選べません

名前ではなく、やりたいことから選んでください。ファイルを直すのか、相談するのかで決まります。

何も起きません

作業する場所(フォルダ)が想定と違う可能性があります。今どこにいるか確認してください。

元に戻せますか?

始める前に戻す方法を確認しておいてください。変更前の状態が残っていないと戻せません。